nbgl_use_case_nanos.c

Go to the documentation of this file.

 
#ifdef NBGL_USE_CASE
#ifndef HAVE_SE_TOUCH
/*********************
 *      INCLUDES
 *********************/
#include <string.h>
#include <stdio.h>
#include "nbgl_debug.h"
#include "nbgl_use_case.h"
#include "glyphs.h"
#include "os_pic.h"
#include "os_print.h"
#include "os_helpers.h"
#include "ux.h"
 
/*********************
 *      DEFINES
 *********************/
 
/**********************
 *      TYPEDEFS
 **********************/
 
typedef struct ReviewContext_s {
    nbgl_choiceCallback_t             onChoice;
    const nbgl_contentTagValueList_t *tagValueList;
    const nbgl_icon_details_t        *icon;
    const char                       *reviewTitle;
    const char                       *reviewSubTitle;
    const char                       *finishTitle;
    const char                       *address;       // for address confirmation review
    nbgl_callback_t                   skipCallback;  // callback provided by used
    uint8_t nbDataSets;     // number of sets of data received by StreamingContinue
    bool    skipDisplay;    // if set to true, means that we are displaying the skip page
    uint8_t dataDirection;  // used to know whether the skip page is reached from back or forward
    uint8_t currentTagValueIndex;
    uint8_t currentExtensionPage;
    uint8_t nbExtensionPages;
    const nbgl_contentValueExt_t *extension;
    nbgl_step_t                   extensionStepCtx;
 
} ReviewContext_t;
 
typedef struct ChoiceContext_s {
    const nbgl_icon_details_t   *icon;
    const char                  *title;  
    const char                  *message;
    const char                  *subMessage;
    const char                  *confirmText;
    const char                  *cancelText;
    nbgl_choiceCallback_t        onChoice;
    const nbgl_genericDetails_t *details;
} ChoiceContext_t;
 
typedef struct ConfirmContext_s {
    const char     *message;
    const char     *subMessage;
    const char     *confirmText;
    const char     *cancelText;
    nbgl_callback_t onConfirm;
    nbgl_step_t     currentStep;
} ConfirmContext_t;
 
typedef struct ContentContext_s {
    const char                *title;  // For CHOICES_LIST /BARS_LIST
    nbgl_genericContents_t     genericContents;
    const char                *rejectText;
    nbgl_layoutTouchCallback_t controlsCallback;
    nbgl_navCallback_t         navCallback;
    nbgl_callback_t            quitCallback;
} ContentContext_t;
 
typedef struct HomeContext_s {
    const char                   *appName;
    const nbgl_icon_details_t    *appIcon;
    const char                   *tagline;
    const nbgl_genericContents_t *settingContents;
    const nbgl_contentInfoList_t *infosList;
    const nbgl_homeAction_t      *homeAction;
    nbgl_callback_t               quitCallback;
} HomeContext_t;
 
typedef struct ActionContext_s {
    nbgl_callback_t actionCallback;
} ActionContext_t;
 
#ifdef NBGL_KEYPAD
typedef struct KeypadContext_s {
    uint8_t                 pinEntry[8];
    uint8_t                 pinLen;
    uint8_t                 pinMinDigits;
    uint8_t                 pinMaxDigits;
    nbgl_layout_t          *layoutCtx;
    bool                    hidden;
    uint8_t                 keypadIndex;
    nbgl_pinValidCallback_t validatePin;
    nbgl_callback_t         backCallback;
} KeypadContext_t;
#endif
 
#ifdef NBGL_KEYBOARD
typedef struct KeyboardContext_s {
    nbgl_layoutKeyboardContent_t   content;
    char                          *entryBuffer;
    uint16_t                       entryMaxLen;
    nbgl_layout_t                 *layoutCtx;
    uint8_t                        keyboardIndex;
    uint8_t                        textIndex;
    nbgl_callback_t                actionCallback;
    nbgl_callback_t                backCallback;
    nbgl_keyboardButtonsCallback_t getSuggestButtons;
    nbgl_layoutTouchCallback_t     onButtonCallback;
} KeyboardContext_t;
#endif
 
typedef enum {
    NONE_USE_CASE,
    SPINNER_USE_CASE,
    REVIEW_USE_CASE,
    GENERIC_REVIEW_USE_CASE,
    ADDRESS_REVIEW_USE_CASE,
    STREAMING_START_REVIEW_USE_CASE,
    STREAMING_CONTINUE_REVIEW_USE_CASE,
    STREAMING_FINISH_REVIEW_USE_CASE,
    CHOICE_USE_CASE,
    STATUS_USE_CASE,
    CONFIRM_USE_CASE,
    KEYPAD_USE_CASE,
    KEYBOARD_USE_CASE,
    HOME_USE_CASE,
    INFO_USE_CASE,
    SETTINGS_USE_CASE,
    GENERIC_SETTINGS,
    CONTENT_USE_CASE,
    ACTION_USE_CASE
} ContextType_t;
 
typedef struct UseCaseContext_s {
    ContextType_t        type;
    nbgl_operationType_t operationType;
    uint8_t              nbPages;
    uint8_t              currentPage;
    uint8_t              firstPairPage;
    bool                 forceAction;
    nbgl_stepCallback_t
        stepCallback;  
    union {
        ReviewContext_t  review;
        ChoiceContext_t  choice;
        ConfirmContext_t confirm;
        HomeContext_t    home;
        ContentContext_t content;
#ifdef NBGL_KEYPAD
        KeypadContext_t keypad;
#endif
#ifdef NBGL_KEYBOARD
        KeyboardContext_t keyboard;
#endif
        ActionContext_t action;
    };
} UseCaseContext_t;
 
typedef struct PageContent_s {
    bool                          isSwitch;
    const char                   *text;
    const char                   *subText;
    const nbgl_icon_details_t    *icon;
    const nbgl_contentValueExt_t *extension;
    nbgl_state_t                  state;
    bool                          isCenteredInfo;
    bool                          isAction;
    bool                          bottomIcon;  
} PageContent_t;
 
typedef struct ReviewWithWarningContext_s {
    ContextType_t                     type;
    nbgl_operationType_t              operationType;
    const nbgl_contentTagValueList_t *tagValueList;
    const nbgl_icon_details_t        *icon;
    const char                       *reviewTitle;
    const char                       *reviewSubTitle;
    const char                       *finishTitle;
    const nbgl_warning_t             *warning;
    nbgl_choiceCallback_t             choiceCallback;
    uint8_t                           securityReportLevel;  // level 1 is the first level of menus
    bool                              isIntro;  // set to true during intro (before actual review)
    uint8_t                           warningPage;
    uint8_t                           nbWarningPages;
    uint8_t                           firstWarningPage;
    uint8_t                           barDetailIdx;  // index of the bar whose detail is displayed
} ReviewWithWarningContext_t;
 
typedef enum {
    NO_FORCED_TYPE = 0,
    FORCE_BUTTON,
    FORCE_CENTERED_INFO
} ForcedType_t;
 
/**********************
 *  STATIC VARIABLES
 **********************/
static UseCaseContext_t context;
 
static ReviewWithWarningContext_t reviewWithWarnCtx;
// configuration of warning when using @ref nbgl_useCaseReviewBlindSigning()
static const nbgl_warning_t blindSigningWarning = {.predefinedSet = (1 << BLIND_SIGNING_WARN)};
 
// Operation type for streaming (because the one in 'context' is reset at each streaming API call)
nbgl_operationType_t streamingOpType;
 
/**********************
 *  STATIC FUNCTIONS
 **********************/
static void displayReviewPage(nbgl_stepPosition_t pos);
static void displayStreamingReviewPage(nbgl_stepPosition_t pos);
static void displayHomePage(nbgl_stepPosition_t pos);
static void displayInfoPage(nbgl_stepPosition_t pos);
static void displaySettingsPage(nbgl_stepPosition_t pos, bool toogle_state);
static void displayChoicePage(nbgl_stepPosition_t pos);
static void displayConfirm(nbgl_stepPosition_t pos);
static void displayContent(nbgl_stepPosition_t pos, bool toogle_state);
static void displaySpinner(const char *text);
 
static void startUseCaseHome(void);
static void startUseCaseInfo(void);
static void startUseCaseSettings(void);
static void startUseCaseSettingsAtPage(uint8_t initSettingPage);
static void startUseCaseContent(void);
 
static void statusTickerCallback(void);
 
static void displayExtensionStep(nbgl_stepPosition_t pos);
static void displayWarningStep(void);
 
// Simple helper to get the number of elements inside a nbgl_content_t
static uint8_t getContentNbElement(const nbgl_content_t *content)
{
    switch (content->type) {
        case CENTERED_INFO:
            return 1;
        case INFO_BUTTON:
            return 1;
        case TAG_VALUE_LIST:
            return content->content.tagValueList.nbPairs;
        case TAG_VALUE_CONFIRM:
            // last element is for Confirm page
            return content->content.tagValueConfirm.tagValueList.nbPairs + 1;
        case SWITCHES_LIST:
            return content->content.switchesList.nbSwitches;
        case INFOS_LIST:
            return content->content.infosList.nbInfos;
        case CHOICES_LIST:
            return content->content.choicesList.nbChoices;
        case BARS_LIST:
            return content->content.barsList.nbBars;
        default:
            return 0;
    }
}
 
// Helper to retrieve the content inside a nbgl_genericContents_t using
// either the contentsList or using the contentGetterCallback
static const nbgl_content_t *getContentAtIdx(const nbgl_genericContents_t *genericContents,
                                             uint8_t                       contentIdx,
                                             nbgl_content_t               *content)
{
    nbgl_pageContent_t pageContent = {0};
    if (contentIdx >= genericContents->nbContents) {
        LOG_DEBUG(USE_CASE_LOGGER, "No content available at %d\n", contentIdx);
        return NULL;
    }
 
    if (genericContents->callbackCallNeeded) {
        if (content == NULL) {
            LOG_DEBUG(USE_CASE_LOGGER, "Invalid content variable\n");
            return NULL;
        }
        // Retrieve content through callback, but first memset the content.
        memset(content, 0, sizeof(nbgl_content_t));
        if (context.content.navCallback) {
            if (context.content.navCallback(contentIdx, &pageContent) == true) {
                // Copy the Page Content to the Content variable
                content->type = pageContent.type;
                switch (content->type) {
                    case CENTERED_INFO:
                        content->content.centeredInfo = pageContent.centeredInfo;
                        break;
                    case INFO_BUTTON:
                        content->content.infoButton = pageContent.infoButton;
                        break;
                    case TAG_VALUE_LIST:
                        content->content.tagValueList = pageContent.tagValueList;
                        break;
                    case TAG_VALUE_CONFIRM:
                        content->content.tagValueConfirm = pageContent.tagValueConfirm;
                        break;
                    case SWITCHES_LIST:
                        content->content.switchesList = pageContent.switchesList;
                        break;
                    case INFOS_LIST:
                        content->content.infosList = pageContent.infosList;
                        break;
                    case CHOICES_LIST:
                        content->content.choicesList = pageContent.choicesList;
                        break;
                    case BARS_LIST:
                        content->content.barsList = pageContent.barsList;
                        break;
                    default:
                        LOG_DEBUG(USE_CASE_LOGGER, "Invalid content type\n");
                        return NULL;
                }
            }
            else {
                LOG_DEBUG(USE_CASE_LOGGER, "Error getting page content\n");
                return NULL;
            }
        }
        else {
            genericContents->contentGetterCallback(contentIdx, content);
        }
        return content;
    }
    else {
        // Retrieve content through list
        return PIC(&genericContents->contentsList[contentIdx]);
    }
}
 
// Helper to retrieve the content inside a nbgl_genericContents_t using
// either the contentsList or using the contentGetterCallback
static const nbgl_content_t *getContentElemAtIdx(uint8_t         elemIdx,
                                                 uint8_t        *elemContentIdx,
                                                 nbgl_content_t *content)
{
    const nbgl_genericContents_t *genericContents = NULL;
    const nbgl_content_t         *p_content       = NULL;
    uint8_t                       nbPages         = 0;
    uint8_t                       elemNbPages     = 0;
 
    switch (context.type) {
        case SETTINGS_USE_CASE:
        case HOME_USE_CASE:
        case GENERIC_SETTINGS:
            genericContents = context.home.settingContents;
            break;
        case CONTENT_USE_CASE:
        case GENERIC_REVIEW_USE_CASE:
            genericContents = &context.content.genericContents;
            break;
        default:
            return NULL;
    }
    for (unsigned int i = 0; i < genericContents->nbContents; i++) {
        p_content   = getContentAtIdx(genericContents, i, content);
        elemNbPages = getContentNbElement(p_content);
        if (nbPages + elemNbPages > elemIdx) {
            *elemContentIdx = context.currentPage - nbPages;
            break;
        }
        nbPages += elemNbPages;
    }
 
    return p_content;
}
 
static const char *getChoiceName(uint8_t choiceIndex)
{
    uint8_t                    elemIdx;
    uint8_t                    nbValues;
    const nbgl_content_t      *p_content      = NULL;
    nbgl_content_t             content        = {0};
    nbgl_contentRadioChoice_t *contentChoices = NULL;
    nbgl_contentBarsList_t    *contentBars    = NULL;
    char                     **names          = NULL;
 
    p_content = getContentElemAtIdx(context.currentPage, &elemIdx, &content);
    if (p_content == NULL) {
        LOG_WARN(USE_CASE_LOGGER,
                 "getChoiceName(): p_content is NULL for page %d\n",
                 context.currentPage);
        return NULL;
    }
    switch (p_content->type) {
        case CHOICES_LIST:
            contentChoices = (nbgl_contentRadioChoice_t *) PIC(&p_content->content.choicesList);
            names          = (char **) PIC(contentChoices->names);
            nbValues       = contentChoices->nbChoices;
            break;
        case BARS_LIST:
            contentBars = ((nbgl_contentBarsList_t *) PIC(&p_content->content.barsList));
            names       = (char **) PIC(contentBars->barTexts);
            nbValues    = contentBars->nbBars;
            break;
        default:
            // Not supported as vertical MenuList
            return NULL;
    }
    if (choiceIndex >= nbValues) {
        // Last item is always "Back" button
        return "Back";
    }
    return (const char *) PIC(names[choiceIndex]);
}
 
static void onChoiceSelected(uint8_t choiceIndex)
{
    uint8_t                    elemIdx;
    uint8_t                    token          = 255;
    const nbgl_content_t      *p_content      = NULL;
    nbgl_content_t             content        = {0};
    nbgl_contentRadioChoice_t *contentChoices = NULL;
    nbgl_contentBarsList_t    *contentBars    = NULL;
 
    p_content = getContentElemAtIdx(context.currentPage, &elemIdx, &content);
    if (p_content == NULL) {
        LOG_WARN(USE_CASE_LOGGER,
                 "onChoiceSelected(): p_content is NULL for page %d\n",
                 context.currentPage);
        return;
    }
    switch (p_content->type) {
        case CHOICES_LIST:
            contentChoices = (nbgl_contentRadioChoice_t *) PIC(&p_content->content.choicesList);
            if (choiceIndex < contentChoices->nbChoices) {
                token = contentChoices->token;
            }
            break;
        case BARS_LIST:
            contentBars = ((nbgl_contentBarsList_t *) PIC(&p_content->content.barsList));
            if (choiceIndex < contentBars->nbBars) {
                token = ((const uint8_t *) PIC(contentBars->tokens))[choiceIndex];
            }
            break;
        default:
            // Not supported as vertical MenuList
            break;
    }
    if (token != 255) {
        // Prefer the per-content action callback (used by settings/content
        // flows). Forward both the choice index and the absolute page so the
        // app can react identically to the horizontal flow.
        if (p_content->contentActionCallback != NULL) {
            nbgl_contentActionCallback_t actionCallback = PIC(p_content->contentActionCallback);
            actionCallback(token, choiceIndex, context.currentPage);
            return;
        }
        if (context.content.controlsCallback != NULL) {
            context.content.controlsCallback(token, choiceIndex);
            return;
        }
    }
    // Back entry (the extra item appended by drawStep at index nbChoices) or
    // unknown selection: mirror the horizontal-flow Back behaviour in
    // displaySettingsPage so SETTINGS_USE_CASE / GENERIC_SETTINGS / content
    // callers all exit consistently.
    if ((context.type == GENERIC_SETTINGS) && (context.home.quitCallback != NULL)) {
        context.home.quitCallback();
        return;
    }
    if (context.type == SETTINGS_USE_CASE) {
        startUseCaseHome();
        return;
    }
    if (context.content.quitCallback != NULL) {
        context.content.quitCallback();
    }
}
 
static void getPairData(const nbgl_contentTagValueList_t *tagValueList,
                        uint8_t                           index,
                        const char                      **item,
                        const char                      **value,
                        const nbgl_contentValueExt_t    **extension,
                        const nbgl_icon_details_t       **icon,
                        bool                             *isCenteredInfo)
{
    const nbgl_contentTagValue_t *pair;
 
    if (tagValueList->pairs != NULL) {
        pair = PIC(&tagValueList->pairs[index]);
    }
    else {
        pair = PIC(tagValueList->callback(index));
    }
    *item  = pair->item;
    *value = pair->value;
    if (pair->aliasValue) {
        *extension = pair->extension;
    }
    else if (pair->centeredInfo) {
        *isCenteredInfo = true;
        *icon           = pair->valueIcon;
    }
    else {
        *extension = NULL;
    }
}
 
static void onReviewAccept(void)
{
    if (context.review.onChoice) {
        context.review.onChoice(true);
    }
}
 
static void onReviewReject(void)
{
    if (context.review.onChoice) {
        context.review.onChoice(false);
    }
}
 
static void onChoiceAccept(void)
{
    if (context.choice.onChoice) {
        context.choice.onChoice(true);
    }
}
 
static void onChoiceReject(void)
{
    if (context.choice.onChoice) {
        context.choice.onChoice(false);
    }
}
 
static void onConfirmAccept(void)
{
    if (context.confirm.currentStep) {
        nbgl_stepRelease(context.confirm.currentStep);
    }
    if (context.confirm.onConfirm) {
        context.confirm.onConfirm();
    }
}
 
static void onConfirmReject(void)
{
    if (context.confirm.currentStep) {
        nbgl_stepRelease(context.confirm.currentStep);
        nbgl_screenRedraw();
        nbgl_refresh();
    }
}
 
static void onSwitchAction(void)
{
    const nbgl_contentSwitch_t *contentSwitch = NULL;
    const nbgl_content_t       *p_content     = NULL;
    nbgl_content_t              content       = {0};
    uint8_t                     elemIdx;
 
    p_content = getContentElemAtIdx(context.currentPage, &elemIdx, &content);
    if ((p_content == NULL) || (p_content->type != SWITCHES_LIST)) {
        LOG_WARN(USE_CASE_LOGGER,
                 "onSwitchAction(): p_content is NULL or not a switches list for page %d\n",
                 context.currentPage);
        return;
    }
    contentSwitch
        = &((const nbgl_contentSwitch_t *) PIC(p_content->content.switchesList.switches))[elemIdx];
    switch (context.type) {
        case SETTINGS_USE_CASE:
        case HOME_USE_CASE:
        case GENERIC_SETTINGS:
            displaySettingsPage(FORWARD_DIRECTION, true);
            break;
        case CONTENT_USE_CASE:
        case GENERIC_REVIEW_USE_CASE:
            displayContent(FORWARD_DIRECTION, true);
            break;
        default:
            break;
    }
    if (p_content->contentActionCallback != NULL) {
        nbgl_contentActionCallback_t actionCallback = PIC(p_content->contentActionCallback);
        actionCallback(contentSwitch->token,
                       (contentSwitch->initState == ON_STATE) ? OFF_STATE : ON_STATE,
                       context.currentPage);
    }
    else if (context.content.controlsCallback != NULL) {
        context.content.controlsCallback(contentSwitch->token, 0);
    }
}
 
static void drawStep(nbgl_stepPosition_t        pos,
                     const nbgl_icon_details_t *icon,
                     const char                *txt,
                     const char                *subTxt,
                     nbgl_stepButtonCallback_t  onActionCallback,
                     bool                       modal,
                     ForcedType_t               forcedType,
                     bool                       bottomIcon)
{
    uint8_t                           elemIdx;
    nbgl_step_t                       newStep        = NULL;
    const nbgl_content_t             *p_content      = NULL;
    nbgl_content_t                    content        = {0};
    nbgl_contentRadioChoice_t        *contentChoices = NULL;
    nbgl_contentBarsList_t           *contentBars    = NULL;
    nbgl_screenTickerConfiguration_t *p_ticker       = NULL;
    nbgl_layoutMenuList_t             list           = {0};
    nbgl_screenTickerConfiguration_t  ticker         = {.tickerCallback  = PIC(statusTickerCallback),
                                                        .tickerIntervale = 0,  // not periodic
                                                        .tickerValue     = STATUS_SCREEN_DURATION};
 
    pos |= GET_POS_OF_STEP(context.currentPage, context.nbPages);
    // if we are in streaming+skip case, enable going backward even for first tag/value of the set
    // (except the first set) because the set starts with a "skip" page
    if ((context.type == STREAMING_CONTINUE_REVIEW_USE_CASE)
        && (context.review.skipCallback != NULL) && (context.review.nbDataSets > 1)) {
        pos |= LAST_STEP;
    }
    if ((context.type == STATUS_USE_CASE) || (context.type == SPINNER_USE_CASE)) {
        p_ticker = &ticker;
    }
    if ((context.type == CONFIRM_USE_CASE) && (context.confirm.currentStep != NULL)) {
        nbgl_stepRelease(context.confirm.currentStep);
    }
 
    if (txt == NULL) {
        p_content = getContentElemAtIdx(context.currentPage, &elemIdx, &content);
        if (p_content) {
            switch (p_content->type) {
                case CHOICES_LIST:
                    contentChoices
                        = ((nbgl_contentRadioChoice_t *) PIC(&p_content->content.choicesList));
                    list.nbChoices      = contentChoices->nbChoices + 1;  // For Back button
                    list.selectedChoice = contentChoices->initChoice;
                    list.callback       = getChoiceName;
                    newStep = nbgl_stepDrawMenuList(onChoiceSelected, p_ticker, &list, modal);
                    break;
                case BARS_LIST:
                    contentBars    = ((nbgl_contentBarsList_t *) PIC(&p_content->content.barsList));
                    list.nbChoices = contentBars->nbBars + 1;  // For Back button
                    list.selectedChoice = 0;
                    list.callback       = getChoiceName;
                    newStep = nbgl_stepDrawMenuList(onChoiceSelected, p_ticker, &list, modal);
                    break;
                default:
                    // Not supported as vertical MenuList
                    break;
            }
        }
    }
    else if ((icon == NULL) && (forcedType != FORCE_CENTERED_INFO)) {
        nbgl_contentCenteredInfoStyle_t style;
        if (subTxt != NULL) {
            style = (forcedType == FORCE_BUTTON) ? BUTTON_INFO : BOLD_TEXT1_INFO;
        }
        else {
            style = REGULAR_INFO;
        }
        newStep = nbgl_stepDrawText(pos, onActionCallback, p_ticker, txt, subTxt, style, modal);
    }
    else {
        nbgl_layoutCenteredInfo_t info = {0};
        info.icon                      = icon;
        info.text1                     = txt;
        info.text2                     = subTxt;
        info.bottomIcon                = bottomIcon;
        if ((subTxt != NULL) || (context.stepCallback != NULL) || context.forceAction) {
            info.style = BOLD_TEXT1_INFO;
        }
        else {
            info.style = REGULAR_INFO;
        }
        newStep = nbgl_stepDrawCenteredInfo(pos, onActionCallback, p_ticker, &info, modal);
    }
    if (context.type == CONFIRM_USE_CASE) {
        context.confirm.currentStep = newStep;
    }
}
 
static void drawSwitchStep(nbgl_stepPosition_t       pos,
                           const char               *title,
                           const char               *description,
                           bool                      state,
                           nbgl_stepButtonCallback_t onActionCallback,
                           bool                      modal)
{
    nbgl_layoutSwitch_t switchInfo = {0};
 
    pos |= GET_POS_OF_STEP(context.currentPage, context.nbPages);
    switchInfo.initState = state;
    switchInfo.text      = title;
    switchInfo.subText   = description;
    nbgl_stepDrawSwitch(pos, onActionCallback, NULL, &switchInfo, modal);
}
 
static bool buttonGenericCallback(nbgl_buttonEvent_t event, nbgl_stepPosition_t *pos)
{
    uint8_t               elemIdx;
    uint8_t               token     = 0;
    uint8_t               index     = 0;
    const nbgl_content_t *p_content = NULL;
    nbgl_content_t        content   = {0};
 
    if (event == BUTTON_LEFT_PRESSED) {
        if (context.currentPage > 0) {
            context.currentPage--;
        }
        // in streaming+skip case, it is allowed to go backward at the first tag/value, except for
        // the first set
        else if ((context.type != STREAMING_CONTINUE_REVIEW_USE_CASE)
                 || (context.review.skipCallback == NULL) || (context.review.nbDataSets == 1)) {
            // Drop the event
            return false;
        }
        *pos = BACKWARD_DIRECTION;
    }
    else if (event == BUTTON_RIGHT_PRESSED) {
        if (context.currentPage < (int) (context.nbPages - 1)) {
            context.currentPage++;
        }
        else {
            // Drop the event
            return false;
        }
        *pos = FORWARD_DIRECTION;
    }
    else {
        if (event == BUTTON_BOTH_PRESSED) {
            if (context.stepCallback != NULL) {
                context.stepCallback();
            }
            else if ((context.type == CONTENT_USE_CASE) || (context.type == SETTINGS_USE_CASE)
                     || (context.type == GENERIC_SETTINGS)
                     || (context.type == GENERIC_REVIEW_USE_CASE)) {
                p_content = getContentElemAtIdx(context.currentPage, &elemIdx, &content);
                if (p_content != NULL) {
                    switch (p_content->type) {
                        case CENTERED_INFO:
                            // No associated callback
                            return false;
                        case INFO_BUTTON:
                            token = p_content->content.infoButton.buttonToken;
                            break;
                        case SWITCHES_LIST:
                            token = p_content->content.switchesList.switches->token;
                            break;
                        case BARS_LIST:
                            if (elemIdx >= p_content->content.barsList.nbBars) {
                                return false;
                            }
                            token = ((const uint8_t *) PIC(
                                p_content->content.barsList.tokens))[elemIdx];
                            index = elemIdx;
                            break;
                        case CHOICES_LIST:
                            token = p_content->content.choicesList.token;
                            index = elemIdx;
                            break;
                        case TAG_VALUE_LIST:
                            return false;
                        case TAG_VALUE_CONFIRM:
                            if (elemIdx < p_content->content.tagValueConfirm.tagValueList.nbPairs) {
                                return false;
                            }
                            token = p_content->content.tagValueConfirm.confirmationToken;
                            break;
                        default:
                            break;
                    }
 
                    bool used_action_callback
                        = (p_content != NULL) && (p_content->contentActionCallback != NULL);
                    ContextType_t prev_type = context.type;
                    if (used_action_callback) {
                        nbgl_contentActionCallback_t actionCallback
                            = (nbgl_contentActionCallback_t) PIC(p_content->contentActionCallback);
                        actionCallback(token, index, context.currentPage);
                    }
                    else if (context.content.controlsCallback != NULL) {
                        context.content.controlsCallback(token, index);
                    }
                    // If the callback swapped the use case (e.g. by entering
                    // a new screen via display_home_page / nbgl_useCaseXxx),
                    // the global context has already been reset — leave it
                    // alone, do not try to redraw the previous layout.
                    if (context.type != prev_type) {
                        return false;
                    }
                    // After a CHOICES_LIST or BARS_LIST selection that went
                    // through the per-content action callback (settings-style
                    // flows), request a redraw of the current page so any
                    // visual side effect of the pick (e.g. the selectionIcon
                    // moving below the new initChoice) becomes visible.
                    // The controlsCallback path (navigable content, generic
                    // review, ...) is excluded because such callbacks
                    // commonly route to a brand-new use case (review,
                    // warning, ...) that owns the screen without resetting
                    // context.type — forcing a redraw there would clobber it.
                    if (used_action_callback
                        && ((p_content->type == CHOICES_LIST) || (p_content->type == BARS_LIST))) {
                        *pos = FORWARD_DIRECTION;
                        return true;
                    }
                }
            }
        }
        return false;
    }
    return true;
}
 
static void reviewCallback(nbgl_step_t stepCtx, nbgl_buttonEvent_t event)
{
    UNUSED(stepCtx);
    nbgl_stepPosition_t pos;
 
    if (!buttonGenericCallback(event, &pos)) {
        return;
    }
    else {
        // memorize last direction
        context.review.dataDirection = pos;
    }
    displayReviewPage(pos);
}
 
// this is the callback used when button action on the "skip" page
static void buttonSkipCallback(nbgl_step_t stepCtx, nbgl_buttonEvent_t event)
{
    UNUSED(stepCtx);
    nbgl_stepPosition_t pos;
 
    if (event == BUTTON_LEFT_PRESSED) {
        // only decrement page if we are going backward but coming from forward (back & forth)
        if ((context.review.dataDirection == FORWARD_DIRECTION)
            && (context.currentPage > context.firstPairPage)) {
            context.currentPage--;
        }
        pos = BACKWARD_DIRECTION;
    }
    else if (event == BUTTON_RIGHT_PRESSED) {
        // only increment page if we are going forward but coming from backward (back & forth)
        if ((context.review.dataDirection == BACKWARD_DIRECTION)
            && (context.currentPage < (int) (context.nbPages - 1))
            && (context.currentPage > context.firstPairPage)) {
            context.currentPage++;
        }
        pos = FORWARD_DIRECTION;
    }
    else if (event == BUTTON_BOTH_PRESSED) {
        // the first tag/value page is at page 0 only in streaming case
        if (context.firstPairPage == 0) {
            // in streaming, we have to call the provided callback
            context.review.skipCallback();
        }
        else {
            // if not in streaming, go directly to the "approve" page
            context.currentPage = context.nbPages - 2;
            displayReviewPage(FORWARD_DIRECTION);
        }
        return;
    }
    else {
        return;
    }
    // the first tag/value page is at page 0 only in streaming case
    if (context.firstPairPage == 0) {
        displayStreamingReviewPage(pos);
    }
    else {
        displayReviewPage(pos);
    }
}
 
// this is the callback used when buttons in "Action" use case are pressed
static void useCaseActionCallback(nbgl_step_t stepCtx, nbgl_buttonEvent_t event)
{
    UNUSED(stepCtx);
 
    if (event == BUTTON_BOTH_PRESSED) {
        context.action.actionCallback();
    }
}
 
static void streamingReviewCallback(nbgl_step_t stepCtx, nbgl_buttonEvent_t event)
{
    nbgl_stepPosition_t pos;
    UNUSED(stepCtx);
 
    if (!buttonGenericCallback(event, &pos)) {
        return;
    }
    else {
        // memorize last direction
        context.review.dataDirection = pos;
    }
 
    displayStreamingReviewPage(pos);
}
 
static void settingsCallback(nbgl_step_t stepCtx, nbgl_buttonEvent_t event)
{
    UNUSED(stepCtx);
    nbgl_stepPosition_t pos;
 
    if (!buttonGenericCallback(event, &pos)) {
        return;
    }
 
    displaySettingsPage(pos, false);
}
 
static void infoCallback(nbgl_step_t stepCtx, nbgl_buttonEvent_t event)
{
    UNUSED(stepCtx);
    nbgl_stepPosition_t pos;
 
    if (!buttonGenericCallback(event, &pos)) {
        return;
    }
 
    displayInfoPage(pos);
}
 
static void homeCallback(nbgl_step_t stepCtx, nbgl_buttonEvent_t event)
{
    UNUSED(stepCtx);
    nbgl_stepPosition_t pos;
 
    if (!buttonGenericCallback(event, &pos)) {
        return;
    }
 
    displayHomePage(pos);
}
 
static void genericChoiceCallback(nbgl_step_t stepCtx, nbgl_buttonEvent_t event)
{
    UNUSED(stepCtx);
    nbgl_stepPosition_t pos;
 
    if (!buttonGenericCallback(event, &pos)) {
        return;
    }
 
    displayChoicePage(pos);
}
 
static void genericConfirmCallback(nbgl_step_t stepCtx, nbgl_buttonEvent_t event)
{
    UNUSED(stepCtx);
    nbgl_stepPosition_t pos;
 
    if (!buttonGenericCallback(event, &pos)) {
        return;
    }
 
    displayConfirm(pos);
}
 
static void statusButtonCallback(nbgl_step_t stepCtx, nbgl_buttonEvent_t event)
{
    UNUSED(stepCtx);
    // any button press should dismiss the status screen
    if ((event == BUTTON_BOTH_PRESSED) || (event == BUTTON_LEFT_PRESSED)
        || (event == BUTTON_RIGHT_PRESSED)) {
        if (context.stepCallback != NULL) {
            context.stepCallback();
        }
    }
}
 
static void contentCallback(nbgl_step_t stepCtx, nbgl_buttonEvent_t event)
{
    UNUSED(stepCtx);
    nbgl_stepPosition_t pos;
 
    if (!buttonGenericCallback(event, &pos)) {
        return;
    }
 
    displayContent(pos, false);
}
 
// callback used for timeout
static void statusTickerCallback(void)
{
    if (context.stepCallback != NULL) {
        context.stepCallback();
    }
}
 
// this is the callback used when navigating in extension pages
static void extensionNavigate(nbgl_step_t stepCtx, nbgl_buttonEvent_t event)
{
    nbgl_stepPosition_t pos;
    UNUSED(stepCtx);
 
    if (event == BUTTON_LEFT_PRESSED) {
        // only decrement page if we are not at the first page
        if (context.review.currentExtensionPage > 0) {
            context.review.currentExtensionPage--;
        }
        pos = BACKWARD_DIRECTION;
    }
    else if (event == BUTTON_RIGHT_PRESSED) {
        // only increment page if not at last page
        if (context.review.currentExtensionPage < (context.review.nbExtensionPages - 1)) {
            context.review.currentExtensionPage++;
        }
        pos = FORWARD_DIRECTION;
    }
    else if (event == BUTTON_BOTH_PRESSED) {
        // if at last page, leave modal context
        if (context.review.currentExtensionPage == (context.review.nbExtensionPages - 1)) {
            nbgl_stepRelease(context.review.extensionStepCtx);
            nbgl_screenRedraw();
            nbgl_refresh();
        }
        return;
    }
    else {
        return;
    }
    displayExtensionStep(pos);
}
 
// function used to display the extension pages
static void displayExtensionStep(nbgl_stepPosition_t pos)
{
    nbgl_layoutCenteredInfo_t         info         = {0};
    const nbgl_contentTagValueList_t *tagValueList = NULL;
    const nbgl_contentInfoList_t     *infoList     = NULL;
    const char                       *text         = NULL;
    const char                       *subText      = NULL;
 
    if (context.review.extensionStepCtx != NULL) {
        nbgl_stepRelease(context.review.extensionStepCtx);
    }
    if (context.review.currentExtensionPage < (context.review.nbExtensionPages - 1)) {
        if (context.review.currentExtensionPage == 0) {
            pos |= FIRST_STEP;
        }
        else {
            pos |= NEITHER_FIRST_NOR_LAST_STEP;
        }
 
        switch (context.review.extension->aliasType) {
            case ENS_ALIAS:
                text    = context.review.extension->title;
                subText = context.review.extension->fullValue;
                break;
            case ADDRESS_BOOK_ALIAS: {
                bool    has_scope = (context.review.extension->aliasSubName != NULL);
                bool    has_tn    = (context.review.extension->explanation != NULL);
                uint8_t page      = context.review.currentExtensionPage;
                if (page == 0) {
                    text    = context.review.extension->title;
                    subText = has_scope ? context.review.extension->aliasSubName
                                        : context.review.extension->fullValue;
                }
                else if (has_scope && page == 1) {
                    text    = context.review.extension->title;
                    subText = context.review.extension->fullValue;
                }
                else if (has_tn) {
                    text = context.review.extension->explanation;
                }
                break;
            }
            case INFO_LIST_ALIAS:
                infoList = context.review.extension->infolist;
                text     = PIC(infoList->infoTypes[context.review.currentExtensionPage]);
                subText  = PIC(infoList->infoContents[context.review.currentExtensionPage]);
                break;
            case TAG_VALUE_LIST_ALIAS:
                tagValueList = context.review.extension->tagValuelist;
                text         = PIC(tagValueList->pairs[context.review.currentExtensionPage].item);
                subText      = PIC(tagValueList->pairs[context.review.currentExtensionPage].value);
                break;
            default:
                break;
        }
        if (text != NULL) {
            context.review.extensionStepCtx = nbgl_stepDrawText(
                pos, extensionNavigate, NULL, text, subText, BOLD_TEXT1_INFO, true);
        }
    }
    else if (context.review.currentExtensionPage == (context.review.nbExtensionPages - 1)) {
        // draw the back page
        info.icon  = &C_icon_back_x;
        info.text1 = "Back";
        info.style = BOLD_TEXT1_INFO;
        pos |= LAST_STEP;
        context.review.extensionStepCtx
            = nbgl_stepDrawCenteredInfo(pos, extensionNavigate, NULL, &info, true);
    }
    nbgl_refresh();
}
 
static void displayAliasFullValue(void)
{
    const char                *text    = NULL;
    const char                *subText = NULL;
    const nbgl_icon_details_t *icon;
    bool                       isCenteredInfo;
 
    getPairData(context.review.tagValueList,
                context.review.currentTagValueIndex,
                &text,
                &subText,
                &context.review.extension,
                &icon,
                &isCenteredInfo);
    if (context.review.extension == NULL) {
        // probably an error
        LOG_WARN(USE_CASE_LOGGER,
                 "displayAliasFullValue: extension nor found for pair %d\n",
                 context.review.currentTagValueIndex);
        return;
    }
    context.review.currentExtensionPage = 0;
    context.review.extensionStepCtx     = NULL;
    // create a modal flow to display this extension
    switch (context.review.extension->aliasType) {
        case ENS_ALIAS:
            context.review.nbExtensionPages = 2;
            break;
        case ADDRESS_BOOK_ALIAS:
            context.review.nbExtensionPages
                = 2 + ((context.review.extension->aliasSubName != NULL) ? 1 : 0)
                  + ((context.review.extension->explanation != NULL) ? 1 : 0);
            break;
        case INFO_LIST_ALIAS:
            context.review.nbExtensionPages = context.review.extension->infolist->nbInfos + 1;
            break;
        case TAG_VALUE_LIST_ALIAS:
            context.review.nbExtensionPages = context.review.extension->tagValuelist->nbPairs + 1;
            break;
        default:
            LOG_WARN(USE_CASE_LOGGER,
                     "displayAliasFullValue: unsupported alias type %d\n",
                     context.review.extension->aliasType);
            return;
    }
    displayExtensionStep(FORWARD_DIRECTION);
}
 
static void getLastPageInfo(bool approve, const nbgl_icon_details_t **icon, const char **text)
{
    if (approve) {
        // Approve page
        *icon = &C_icon_validate_14;
        if (context.operationType & ADDRESS_BOOK_OPERATION) {
            if ((context.type == REVIEW_USE_CASE) && (context.review.finishTitle != NULL)) {
                *text = context.review.finishTitle;
            }
            else {
                *text = "Confirm contact details";
            }
        }
        else if (context.type == ADDRESS_REVIEW_USE_CASE) {
            *text = "Confirm";
        }
        else {
            // if finish title is provided, use it
            if (context.review.finishTitle != NULL) {
                *text = context.review.finishTitle;
            }
            else {
                switch (context.operationType & REAL_TYPE_MASK) {
                    case TYPE_TRANSACTION:
                        if (context.operationType & RISKY_OPERATION) {
                            *text = "Accept risk and sign transaction";
                        }
                        else {
                            *text = "Sign transaction";
                        }
                        break;
                    case TYPE_MESSAGE:
                        if (context.operationType & RISKY_OPERATION) {
                            *text = "Accept risk and sign message";
                        }
                        else {
                            *text = "Sign message";
                        }
                        break;
                    default:
                        if (context.operationType & RISKY_OPERATION) {
                            *text = "Accept risk and sign operation";
                        }
                        else {
                            *text = "Sign operation";
                        }
                        break;
                }
            }
        }
        context.stepCallback = onReviewAccept;
    }
    else {
        // Reject page
        *icon = &C_icon_crossmark;
        if ((context.type == ADDRESS_REVIEW_USE_CASE)
            || (context.operationType & ADDRESS_BOOK_OPERATION)) {
            *text = "Cancel";
        }
        else if ((context.operationType & REAL_TYPE_MASK) == TYPE_TRANSACTION) {
            *text = "Reject transaction";
        }
        else if ((context.operationType & REAL_TYPE_MASK) == TYPE_MESSAGE) {
            *text = "Reject message";
        }
        else {
            *text = "Reject operation";
        }
        context.stepCallback = onReviewReject;
    }
}
 
// function used to display the current page in review
static void displayReviewPage(nbgl_stepPosition_t pos)
{
    uint8_t                       reviewPages  = 0;
    uint8_t                       finalPages   = 0;
    uint8_t                       pairIndex    = 0;
    const char                   *text         = NULL;
    const char                   *subText      = NULL;
    const nbgl_icon_details_t    *icon         = NULL;
    uint8_t                       currentIndex = 0;
    uint8_t                       titleIndex   = 255;
    uint8_t                       subIndex     = 255;
    uint8_t                       approveIndex = 255;
    uint8_t                       rejectIndex  = 255;
    const nbgl_contentValueExt_t *extension    = NULL;
    ForcedType_t                  forcedType   = NO_FORCED_TYPE;
 
    context.stepCallback = NULL;
 
    // Determine the 1st page to display tag/values
    // Title page to display
    titleIndex = currentIndex++;
    reviewPages++;
    if (context.review.reviewSubTitle) {
        // subtitle page to display
        subIndex = currentIndex++;
        reviewPages++;
    }
    approveIndex = context.nbPages - 2;
    rejectIndex  = context.nbPages - 1;
    finalPages   = approveIndex;
 
    // Determine which page to display
    if (context.currentPage >= finalPages) {
        if (context.currentPage == approveIndex) {
            // Approve page
            getLastPageInfo(true, &icon, &text);
        }
        else if (context.currentPage == rejectIndex) {
            // Reject page
            getLastPageInfo(false, &icon, &text);
        }
    }
    else if (context.currentPage < reviewPages) {
        if (context.currentPage == titleIndex) {
            // Title page
            icon = context.review.icon;
            text = context.review.reviewTitle;
        }
        else if (context.currentPage == subIndex) {
            // SubTitle page
            text = context.review.reviewSubTitle;
        }
    }
    else if ((context.review.address != NULL) && (context.currentPage == reviewPages)) {
        // address confirmation and 2nd page
        text    = "Address";
        subText = context.review.address;
    }
    else {
        // if there is a skip, and we are not already displaying the "skip" page
        // and we are not at the first tag/value of the first set of data (except if going
        // backward) then display the "skip" page
        if ((context.operationType & SKIPPABLE_OPERATION) && (context.review.skipDisplay == false)
            && ((context.currentPage > reviewPages)
                || (context.review.dataDirection == BACKWARD_DIRECTION))) {
            nbgl_stepPosition_t       directions = (pos & BACKWARD_DIRECTION) | FIRST_STEP;
            nbgl_layoutCenteredInfo_t info       = {0};
            if ((context.review.nbDataSets == 1) || (context.currentPage > 0)) {
                directions |= LAST_STEP;
            }
            info.icon  = &C_Information_circle_14px;
            info.text1 = "Press right button to continue message or \bpress both to skip\b";
            nbgl_stepDrawCenteredInfo(directions, buttonSkipCallback, NULL, &info, false);
            nbgl_refresh();
            context.review.skipDisplay = true;
            context.firstPairPage      = reviewPages;
            return;
        }
        context.review.skipDisplay = false;
        bool isCenteredInfo        = false;
        pairIndex                  = context.currentPage - reviewPages;
        if (context.review.address != NULL) {
            pairIndex--;
        }
        getPairData(context.review.tagValueList,
                    pairIndex,
                    &text,
                    &subText,
                    &extension,
                    &icon,
                    &isCenteredInfo);
        if (extension != NULL) {
            context.stepCallback                = displayAliasFullValue;
            context.review.currentTagValueIndex = pairIndex;
            forcedType                          = FORCE_BUTTON;
        }
        else {
            if (isCenteredInfo) {
                forcedType = FORCE_CENTERED_INFO;
            }
        }
    }
 
    drawStep(pos, icon, text, subText, reviewCallback, false, forcedType, false);
    nbgl_refresh();
}
 
// function used to display the current page in review
static void displayStreamingReviewPage(nbgl_stepPosition_t pos)
{
    const char                   *text        = NULL;
    const char                   *subText     = NULL;
    const nbgl_icon_details_t    *icon        = NULL;
    uint8_t                       reviewPages = 0;
    uint8_t                       titleIndex  = 255;
    uint8_t                       subIndex    = 255;
    const nbgl_contentValueExt_t *extension   = NULL;
    ForcedType_t                  forcedType  = NO_FORCED_TYPE;
 
    context.stepCallback = NULL;
    switch (context.type) {
        case STREAMING_START_REVIEW_USE_CASE:
            // Title page to display
            titleIndex = reviewPages++;
            if (context.review.reviewSubTitle) {
                // subtitle page to display
                subIndex = reviewPages++;
            }
            // Determine which page to display
            if (context.currentPage >= reviewPages) {
                onReviewAccept();
                return;
            }
            // header page(s)
            if (context.currentPage == titleIndex) {
                // title page
                icon = context.review.icon;
                text = context.review.reviewTitle;
            }
            else if (context.currentPage == subIndex) {
                // subtitle page
                text = context.review.reviewSubTitle;
            }
            break;
 
        case STREAMING_CONTINUE_REVIEW_USE_CASE:
            if (context.currentPage >= context.review.tagValueList->nbPairs) {
                onReviewAccept();
                return;
            }
            // if there is a skip, and we are not already displaying the "skip" page
            // and we are not at the first tag/value of the first set of data (except if going
            // backward) then display the "skip" page
            if ((context.review.skipCallback != NULL) && (context.review.skipDisplay == false)
                && ((context.review.nbDataSets > 1) || (context.currentPage > 0)
                    || (context.review.dataDirection == BACKWARD_DIRECTION))) {
                nbgl_stepPosition_t       directions = (pos & BACKWARD_DIRECTION) | FIRST_STEP;
                nbgl_layoutCenteredInfo_t info       = {0};
                if ((context.review.nbDataSets == 1) || (context.currentPage > 0)) {
                    directions |= LAST_STEP;
                }
                info.icon  = &C_Information_circle_14px;
                info.text1 = "Press right button to continue message or \bpress both to skip\b";
                nbgl_stepDrawCenteredInfo(directions, buttonSkipCallback, NULL, &info, false);
                nbgl_refresh();
                context.review.skipDisplay = true;
                return;
            }
            context.review.skipDisplay = false;
            bool isCenteredInfo        = false;
            getPairData(context.review.tagValueList,
                        context.currentPage,
                        &text,
                        &subText,
                        &extension,
                        &icon,
                        &isCenteredInfo);
            if (extension != NULL) {
                forcedType = FORCE_BUTTON;
            }
            else {
                if (isCenteredInfo) {
                    forcedType = FORCE_CENTERED_INFO;
                }
            }
            break;
 
        case STREAMING_FINISH_REVIEW_USE_CASE:
        default:
            if (context.currentPage == 0) {
                // accept page
                getLastPageInfo(true, &icon, &text);
            }
            else {
                // reject page
                getLastPageInfo(false, &icon, &text);
            }
            break;
    }
 
    drawStep(pos, icon, text, subText, streamingReviewCallback, false, forcedType, false);
    nbgl_refresh();
}
 
// function used to display the current page in info
static void displayInfoPage(nbgl_stepPosition_t pos)
{
    const char                *text    = NULL;
    const char                *subText = NULL;
    const nbgl_icon_details_t *icon    = NULL;
 
    context.stepCallback = NULL;
 
    if (context.currentPage < (context.nbPages - 1)) {
        text = PIC(
            ((const char *const *) PIC(context.home.infosList->infoTypes))[context.currentPage]);
        subText = PIC(
            ((const char *const *) PIC(context.home.infosList->infoContents))[context.currentPage]);
    }
    else {
        icon                 = &C_icon_back_x;
        text                 = "Back";
        context.stepCallback = startUseCaseHome;
    }
 
    drawStep(pos, icon, text, subText, infoCallback, false, FORCE_CENTERED_INFO, false);
    nbgl_refresh();
}
 
// function used to get the current page content
static void getContentPage(bool toogle_state, PageContent_t *contentPage)
{
    uint8_t                    elemIdx        = 0;
    const nbgl_content_t      *p_content      = NULL;
    nbgl_content_t             content        = {0};
    nbgl_contentSwitch_t      *contentSwitch  = NULL;
    nbgl_contentRadioChoice_t *contentChoices = NULL;
    char                     **names          = NULL;
    nbgl_contentBarsList_t    *contentBars    = NULL;
    char                     **texts          = NULL;
    p_content = getContentElemAtIdx(context.currentPage, &elemIdx, &content);
    if (p_content == NULL) {
        LOG_WARN(USE_CASE_LOGGER,
                 "getContentPage(): p_content is NULL for page %d\n",
                 context.currentPage);
        return;
    }
    switch (p_content->type) {
        case CENTERED_INFO:
            contentPage->text       = PIC(p_content->content.centeredInfo.text1);
            contentPage->subText    = PIC(p_content->content.centeredInfo.text2);
            contentPage->icon       = PIC(p_content->content.centeredInfo.icon);
            contentPage->bottomIcon = p_content->content.centeredInfo.bottomIcon;
            break;
        case INFO_BUTTON:
            contentPage->icon       = PIC(p_content->content.infoButton.icon);
            contentPage->text       = PIC(p_content->content.infoButton.text);
            contentPage->subText    = PIC(p_content->content.infoButton.buttonText);
            contentPage->bottomIcon = p_content->content.infoButton.bottomIcon;
            break;
        case TAG_VALUE_LIST:
            getPairData(&p_content->content.tagValueList,
                        elemIdx,
                        &contentPage->text,
                        &contentPage->subText,
                        &contentPage->extension,
                        &contentPage->icon,
                        &contentPage->isCenteredInfo);
            break;
        case TAG_VALUE_CONFIRM:
            if (elemIdx < p_content->content.tagValueConfirm.tagValueList.nbPairs) {
                getPairData(&p_content->content.tagValueConfirm.tagValueList,
                            elemIdx,
                            &contentPage->text,
                            &contentPage->subText,
                            &contentPage->extension,
                            &contentPage->icon,
                            &contentPage->isCenteredInfo);
            }
            else {
                contentPage->text     = p_content->content.tagValueConfirm.confirmationText;
                contentPage->icon     = &C_icon_validate_14;
                contentPage->isAction = true;
            }
            break;
        case SWITCHES_LIST:
            contentPage->isSwitch = true;
            contentSwitch         = &(
                (nbgl_contentSwitch_t *) PIC(p_content->content.switchesList.switches))[elemIdx];
            contentPage->text  = contentSwitch->text;
            contentPage->state = contentSwitch->initState;
            if (toogle_state) {
                contentPage->state = (contentPage->state == ON_STATE) ? OFF_STATE : ON_STATE;
            }
            context.stepCallback = onSwitchAction;
            contentPage->subText = contentSwitch->subText;
            break;
        case INFOS_LIST:
            contentPage->text
                = ((const char *const *) PIC(p_content->content.infosList.infoTypes))[elemIdx];
            contentPage->subText
                = ((const char *const *) PIC(p_content->content.infosList.infoContents))[elemIdx];
            break;
        case CHOICES_LIST:
            contentChoices = (nbgl_contentRadioChoice_t *) PIC(&p_content->content.choicesList);
            // When the content opts into the vertical layout, leave
            // contentPage->text NULL so drawStep falls through to the menu-list
            // rendering (all choices visible, with a radio button on
            // initChoice). Default is the horizontal one-page-per-choice flow.
            if (contentChoices->vertical) {
                break;
            }
            names = (char **) PIC(contentChoices->names);
            // The caller-provided per-content title wins over the contextual
            // fallback (app name / use case title).
            if (contentChoices->title != NULL) {
                contentPage->text    = PIC(contentChoices->title);
                contentPage->subText = (const char *) PIC(names[elemIdx]);
            }
            else if ((context.type == CONTENT_USE_CASE) && (context.content.title != NULL)) {
                contentPage->text    = PIC(context.content.title);
                contentPage->subText = (const char *) PIC(names[elemIdx]);
            }
            else if (((context.type == GENERIC_SETTINGS) || (context.type == SETTINGS_USE_CASE))
                     && (context.home.appName != NULL)) {
                // Both nbgl_useCaseGenericSettings (GENERIC_SETTINGS) and
                // nbgl_useCaseHomeAndSettings -> Settings (SETTINGS_USE_CASE)
                // populate context.home.appName, so use it as the page title
                // for the latter too -- otherwise a horizontally-paged
                // CHOICES_LIST would render the choice name only with no
                // contextual header at all.
                contentPage->text    = PIC(context.home.appName);
                contentPage->subText = (const char *) PIC(names[elemIdx]);
            }
            else {
                contentPage->text = (const char *) PIC(names[elemIdx]);
            }
            // Mark the currently-selected choice with the caller-provided icon
            // placed at the bottom of the screen (see contentCenteredInfo
            // bottomIcon handling in nbgl_layoutAddCenteredInfo). Skipped when
            // the caller did not opt in.
            if ((contentChoices->selectionIcon != NULL)
                && (elemIdx == contentChoices->initChoice)) {
                contentPage->icon       = PIC(contentChoices->selectionIcon);
                contentPage->bottomIcon = true;
            }
            break;
        case BARS_LIST:
            contentBars = (nbgl_contentBarsList_t *) PIC(&p_content->content.barsList);
            if (contentBars->vertical) {
                break;  // see CHOICES_LIST comment above
            }
            texts = (char **) PIC(contentBars->barTexts);
            // Same precedence as CHOICES_LIST: caller-provided title overrides
            // the contextual fallback.
            if (contentBars->title != NULL) {
                contentPage->text    = PIC(contentBars->title);
                contentPage->subText = PIC(texts[elemIdx]);
            }
            else if ((context.type == CONTENT_USE_CASE) && (context.content.title != NULL)) {
                contentPage->text    = PIC(context.content.title);
                contentPage->subText = PIC(texts[elemIdx]);
            }
            else if ((context.type == GENERIC_SETTINGS) && (context.home.appName != NULL)) {
                contentPage->text    = PIC(context.home.appName);
                contentPage->subText = PIC(texts[elemIdx]);
            }
            else {
                contentPage->text = PIC(texts[elemIdx]);
            }
            // Sub-menu indicator: always pinned at the bottom of every bar's
            // page. Mirrors the hardcoded PUSH_ICON ('>') that Stax/Flex draw
            // on the right of touchable bars (see nbgl_page.c). On Nano the
            // right button is reserved for navigation, so we pick a downward
            // chevron and place it at the screen bottom via the centeredInfo
            // bottomIcon path.
            contentPage->icon       = &C_icon_down;
            contentPage->bottomIcon = true;
            break;
        default:
            break;
    }
}
 
// function used to display the current page in settings
static void displaySettingsPage(nbgl_stepPosition_t pos, bool toogle_state)
{
    PageContent_t contentPage = {0};
 
    context.stepCallback = NULL;
 
    if (context.currentPage < (context.nbPages - 1)) {
        getContentPage(toogle_state, &contentPage);
    }
    else {  // last page is for quit
        contentPage.icon = &C_icon_back_x;
        contentPage.text = "Back";
        if (context.type == GENERIC_SETTINGS) {
            context.stepCallback = context.home.quitCallback;
        }
        else {
            context.stepCallback = startUseCaseHome;
        }
    }
 
    if (contentPage.isSwitch) {
        drawSwitchStep(
            pos, contentPage.text, contentPage.subText, contentPage.state, settingsCallback, false);
    }
    else {
        drawStep(pos,
                 contentPage.icon,
                 contentPage.text,
                 contentPage.subText,
                 settingsCallback,
                 false,
                 NO_FORCED_TYPE,
                 contentPage.bottomIcon);
    }
 
    nbgl_refresh();
}
 
static void startUseCaseHome(void)
{
    switch (context.type) {
        case SETTINGS_USE_CASE:
            // Settings page index
            context.currentPage = 1;
            if (context.home.homeAction) {
                // Action page is before Settings page
                context.currentPage++;
            }
            break;
        case INFO_USE_CASE:
            // Info page index
            context.currentPage = 1;
            if (context.home.homeAction) {
                // Action page is before Settings and Info pages
                context.currentPage++;
            }
            if (context.home.settingContents) {
                // Settings page is before Info pages
                context.currentPage++;
            }
            break;
        default:
            // Home page index
            context.currentPage = 0;
            break;
    }
 
    context.type    = HOME_USE_CASE;
    context.nbPages = 2;  // Home + Quit
    if (context.home.settingContents) {
        context.nbPages++;
    }
    if (context.home.infosList) {
        context.nbPages++;
    }
    if (context.home.homeAction) {
        context.nbPages++;
    }
    displayHomePage(FORWARD_DIRECTION);
}
 
static void startUseCaseInfo(void)
{
    context.type        = INFO_USE_CASE;
    context.nbPages     = context.home.infosList->nbInfos + 1;  // For back screen
    context.currentPage = 0;
 
    displayInfoPage(FORWARD_DIRECTION);
}
 
static void startUseCaseSettingsAtPage(uint8_t initSettingPage)
{
    nbgl_content_t        content   = {0};
    const nbgl_content_t *p_content = NULL;
 
    // if not coming from GENERIC_SETTINGS, force to SETTINGS_USE_CASE
    if (context.type != GENERIC_SETTINGS) {
        context.type = SETTINGS_USE_CASE;
    }
 
    context.nbPages = 1;  // For back screen
    for (unsigned int i = 0; i < context.home.settingContents->nbContents; i++) {
        p_content = getContentAtIdx(context.home.settingContents, i, &content);
        context.nbPages += getContentNbElement(p_content);
    }
    context.currentPage = initSettingPage;
 
    displaySettingsPage(FORWARD_DIRECTION, false);
}
 
static void startUseCaseSettings(void)
{
    startUseCaseSettingsAtPage(0);
}
 
static void startUseCaseContent(void)
{
    uint8_t               contentIdx = 0;
    const nbgl_content_t *p_content  = NULL;
    nbgl_content_t        content    = {0};
 
    context.nbPages = 1;  // Quit
 
    for (contentIdx = 0; contentIdx < context.content.genericContents.nbContents; contentIdx++) {
        p_content = getContentAtIdx(&context.content.genericContents, contentIdx, &content);
        context.nbPages += getContentNbElement(p_content);
    }
 
    // Ensure currentPage is valid
    if (context.currentPage >= context.nbPages) {
        return;
    }
 
    displayContent(FORWARD_DIRECTION, false);
}
 
// function used to display the current page in home
static void displayHomePage(nbgl_stepPosition_t pos)
{
    const char                *text          = NULL;
    const char                *subText       = NULL;
    const nbgl_icon_details_t *icon          = NULL;
    uint8_t                    currentIndex  = 0;
    uint8_t                    homeIndex     = 255;
    uint8_t                    actionIndex   = 255;
    uint8_t                    settingsIndex = 255;
    uint8_t                    infoIndex     = 255;
 
    context.stepCallback = NULL;
 
    // Determine which pages are present
    homeIndex = currentIndex++;
    if (context.home.homeAction) {
        actionIndex = currentIndex++;
    }
    if (context.home.settingContents) {
        settingsIndex = currentIndex++;
    }
    if (context.home.infosList) {
        infoIndex = currentIndex++;
    }
 
    if (context.currentPage == homeIndex) {
        // Home page
        icon = context.home.appIcon;
        if (context.home.tagline != NULL) {
            text = context.home.tagline;
        }
        else {
            text    = context.home.appName;
            subText = "app is ready";
        }
    }
    else if (context.currentPage == actionIndex) {
        // Action page
        icon                 = context.home.homeAction->icon;
        text                 = PIC(context.home.homeAction->text);
        context.stepCallback = context.home.homeAction->callback;
    }
    else if (context.currentPage == settingsIndex) {
        // Settings page
        icon                 = &C_icon_coggle;
        text                 = "App settings";
        context.stepCallback = startUseCaseSettings;
    }
    else if (context.currentPage == infoIndex) {
        // About page
        icon                 = &C_Information_circle_14px;
        text                 = "App info";
        context.stepCallback = startUseCaseInfo;
    }
    else {
        icon                 = &C_Quit_14px;
        text                 = "Quit app";
        context.stepCallback = context.home.quitCallback;
    }
 
    drawStep(pos, icon, text, subText, homeCallback, false, NO_FORCED_TYPE, false);
    nbgl_refresh();
}
 
// An intro page of a choice flow displays the header text and, below it, at most one other
// element, as a step cannot hold more. Those elements take one page each, in this order:
//   1. the icon, if any
//   2. the message, when the advanced flow uses the title as header text
//   3. the subMessage, if any
// The header text is the title of the advanced flow, or the message of the basic one, in which
// case only the subMessage is left below it.
 
// Number of pages displayed before the (optional) detail pages and the confirm/cancel ones.
static uint8_t getChoiceNbIntroPages(void)
{
    uint8_t nbPages = 0;
 
    // no intro at all without a header text
    if ((context.choice.title == NULL) && (context.choice.message == NULL)) {
        return 0;
    }
    if (context.choice.icon != NULL) {
        nbPages++;
    }
    if ((context.choice.title != NULL) && (context.choice.message != NULL)) {
        nbPages++;
    }
    if (context.choice.subMessage != NULL) {
        nbPages++;
    }
    // the header text still needs a page of its own when nothing goes below it
    return (nbPages > 0) ? nbPages : 1;
}
 
// Text to display under the header text on the given (0-based) intro page, NULL if this page
// displays the icon instead, or if nothing is left to display below the header.
static const char *getChoiceIntroSubText(uint8_t page)
{
    // Page holding the element being examined. The elements are walked in display order and each
    // one that is given takes a page, pushing the following ones one page further: when elemPage
    // reaches the requested page, the element examined at that point is the one to display.
    uint8_t elemPage = 0;
 
    if (context.choice.icon != NULL) {
        if (page == elemPage) {
            // the icon takes the whole page next to the header text
            return NULL;
        }
        elemPage++;
    }
    if ((context.choice.title != NULL) && (context.choice.message != NULL)) {
        // in the advanced flow the header text is the title, so the message goes below it
        if (page == elemPage) {
            return context.choice.message;
        }
        elemPage++;
    }
    // the subMessage closes the intro, on the last page
    return (page == elemPage) ? context.choice.subMessage : NULL;
}
 
// function used to display the current page in choice
static void displayChoicePage(nbgl_stepPosition_t pos)
{
    const char                *text    = NULL;
    const char                *subText = NULL;
    const nbgl_icon_details_t *icon    = NULL;
    // acceptPage = number of intro pages, see getChoiceNbIntroPages()
    uint8_t acceptPage = getChoiceNbIntroPages();
    // nbDetailPages = number of BAR_LIST bar pages shown before confirm/cancel (0 if none)
    // Page order: intro(s) | bar pages | confirm | cancel
    uint8_t nbDetailPages = 0;
 
    if ((context.choice.details != NULL) && (context.choice.details->type == BAR_LIST_WARNING)) {
        nbDetailPages = context.choice.details->barList.nbBars;
    }
    context.stepCallback = NULL;
 
    if (context.currentPage < acceptPage) {
        // the header text is repeated on every intro page, the icon (if any) is on the first one
        // and each remaining text gets a page of its own, see getChoiceIntroSubText()
        text = (context.choice.title != NULL) ? context.choice.title : context.choice.message;
        if (context.currentPage == 0) {
            icon = context.choice.icon;
        }
        subText = getChoiceIntroSubText(context.currentPage);
    }
    else if (context.currentPage < (acceptPage + nbDetailPages)) {
        // BAR_LIST detail pages, shown before confirm/cancel (one page per bar)
        uint8_t idx = context.currentPage - acceptPage;
        text        = (context.choice.details->barList.texts != NULL)
                          ? context.choice.details->barList.texts[idx]
                          : NULL;
        subText     = (context.choice.details->barList.subTexts != NULL)
                          ? context.choice.details->barList.subTexts[idx]
                          : NULL;
    }
    else if (context.currentPage == (acceptPage + nbDetailPages)) {  // confirm page
        icon                 = &C_icon_validate_14;
        text                 = context.choice.confirmText;
        context.stepCallback = onChoiceAccept;
    }
    else {  // cancel page (last page)
        icon                 = &C_icon_crossmark;
        text                 = context.choice.cancelText;
        context.stepCallback = onChoiceReject;
    }
    // other detail types (non-BAR_LIST) are not navigated on Nano
 
    drawStep(pos, icon, text, subText, genericChoiceCallback, false, NO_FORCED_TYPE, false);
    nbgl_refresh();
}
 
// function used to display the Confirm page
static void displayConfirm(nbgl_stepPosition_t pos)
{
    const char                *text    = NULL;
    const char                *subText = NULL;
    const nbgl_icon_details_t *icon    = NULL;
 
    context.stepCallback = NULL;
    switch (context.currentPage) {
        case 0:
            // title page
            text    = context.confirm.message;
            subText = context.confirm.subMessage;
            break;
        case 1:
            // confirm page
            icon                 = &C_icon_validate_14;
            text                 = context.confirm.confirmText;
            context.stepCallback = onConfirmAccept;
            break;
        case 2:
            // cancel page
            icon                 = &C_icon_crossmark;
            text                 = context.confirm.cancelText;
            context.stepCallback = onConfirmReject;
            break;
    }
 
    drawStep(pos, icon, text, subText, genericConfirmCallback, true, NO_FORCED_TYPE, false);
    nbgl_refresh();
}
 
// function used to display the current navigable content
static void displayContent(nbgl_stepPosition_t pos, bool toogle_state)
{
    PageContent_t contentPage = {0};
    ForcedType_t  forcedType  = NO_FORCED_TYPE;
 
    context.stepCallback = NULL;
 
    if (context.currentPage < (context.nbPages - 1)) {
        getContentPage(toogle_state, &contentPage);
        if (contentPage.isCenteredInfo) {
            forcedType = FORCE_CENTERED_INFO;
        }
        context.forceAction = contentPage.isAction;
    }
    else {  // last page is for quit
        if (context.content.rejectText) {
            contentPage.text = context.content.rejectText;
        }
        else {
            contentPage.text = "Back";
        }
        if (context.type == GENERIC_REVIEW_USE_CASE) {
            contentPage.icon = &C_icon_crossmark;
        }
        else {
            contentPage.icon = &C_icon_back_x;
        }
        context.stepCallback = context.content.quitCallback;
    }
 
    if (contentPage.isSwitch) {
        drawSwitchStep(
            pos, contentPage.text, contentPage.subText, contentPage.state, contentCallback, false);
    }
    else {
        drawStep(pos,
                 contentPage.icon,
                 contentPage.text,
                 contentPage.subText,
                 contentCallback,
                 false,
                 forcedType,
                 contentPage.bottomIcon);
    }
    context.forceAction = false;
    nbgl_refresh();
}
 
static void displaySpinner(const char *text)
{
    drawStep(SINGLE_STEP, &C_icon_processing, text, NULL, NULL, false, NO_FORCED_TYPE, false);
    nbgl_refresh();
}
 
// function to factorize code for all simple reviews
static void useCaseReview(ContextType_t                     type,
                          nbgl_operationType_t              operationType,
                          const nbgl_contentTagValueList_t *tagValueList,
                          const nbgl_icon_details_t        *icon,
                          const char                       *reviewTitle,
                          const char                       *reviewSubTitle,
                          const char                       *finishTitle,
                          nbgl_choiceCallback_t             choiceCallback)
{
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.type                  = type;
    context.operationType         = operationType;
    context.review.tagValueList   = tagValueList;
    context.review.reviewTitle    = reviewTitle;
    context.review.reviewSubTitle = reviewSubTitle;
    context.review.finishTitle    = finishTitle;
    context.review.icon           = icon;
    context.review.onChoice       = choiceCallback;
    context.currentPage           = 0;
    // 1 page for title and 2 pages at the end for accept/reject
    context.nbPages = tagValueList->nbPairs + 3;
    if (reviewSubTitle) {
        context.nbPages++;  // 1 page for subtitle page
    }
 
    displayReviewPage(FORWARD_DIRECTION);
}
 
#ifdef NBGL_KEYPAD
static void setPinCodeText(void)
{
    bool enableValidate  = false;
    bool enableBackspace = true;
 
    // pin can be validated when min digits is entered
    enableValidate = (context.keypad.pinLen >= context.keypad.pinMinDigits);
    // backspace is disabled when no digit is entered and back vallback is not provided
    enableBackspace = (context.keypad.pinLen > 0) || (context.keypad.backCallback != NULL);
    nbgl_layoutUpdateKeypadContent(context.keypad.layoutCtx,
                                   context.keypad.hidden,
                                   context.keypad.pinLen,
                                   (const char *) context.keypad.pinEntry);
    nbgl_layoutUpdateKeypad(
        context.keypad.layoutCtx, context.keypad.keypadIndex, enableValidate, enableBackspace);
    nbgl_layoutDraw(context.keypad.layoutCtx);
    nbgl_refresh();
}
 
// called when a key is touched on the keypad
static void keypadCallback(char touchedKey)
{
    switch (touchedKey) {
        case BACKSPACE_KEY:
            if (context.keypad.pinLen > 0) {
                context.keypad.pinLen--;
                context.keypad.pinEntry[context.keypad.pinLen] = 0;
            }
            else if (context.keypad.backCallback != NULL) {
                context.keypad.backCallback();
                break;
            }
            setPinCodeText();
            break;
 
        case VALIDATE_KEY:
            context.keypad.validatePin(context.keypad.pinEntry, context.keypad.pinLen);
            break;
 
        default:
            if ((touchedKey >= 0x30) && (touchedKey < 0x40)) {
                if (context.keypad.pinLen < context.keypad.pinMaxDigits) {
                    context.keypad.pinEntry[context.keypad.pinLen] = touchedKey;
                    context.keypad.pinLen++;
                }
                setPinCodeText();
            }
            break;
    }
}
#endif  // NBGL_KEYPAD
 
#ifdef NBGL_KEYBOARD
// Saved keyboard context for suggestion selection
// (needed because switching to CONTENT_USE_CASE overwrites the union context)
static struct {
    const char               **buttons;
    int                        firstButtonToken;
    uint8_t                    nbUsedButtons;
    nbgl_layoutTouchCallback_t onButtonCallback;
    nbgl_callback_t            backCallback;
    char                       title[KEYBOARD_MAX_TITLE];
} savedKeyboardContext;
 
// Navigation callback to fill the suggestion choices page
static bool suggestionNavCallback(uint8_t page, nbgl_pageContent_t *content)
{
    UNUSED(page);
    content->type                   = CHOICES_LIST;
    content->choicesList.names      = savedKeyboardContext.buttons;
    content->choicesList.token      = savedKeyboardContext.firstButtonToken;
    content->choicesList.initChoice = 0;
    content->choicesList.nbChoices  = savedKeyboardContext.nbUsedButtons;
    return true;
}
 
// Display suggestion selection page
static void displaySuggestionSelection(void)
{
    // Save keyboard context before it gets overwritten
    savedKeyboardContext.buttons = context.keyboard.content.suggestionButtons.buttons;
    savedKeyboardContext.firstButtonToken
        = context.keyboard.content.suggestionButtons.firstButtonToken;
    savedKeyboardContext.nbUsedButtons = context.keyboard.content.suggestionButtons.nbUsedButtons;
    savedKeyboardContext.onButtonCallback = context.keyboard.onButtonCallback;
    savedKeyboardContext.backCallback     = context.keyboard.backCallback;
 
    // Release the keyboard layout
    nbgl_layoutRelease(context.keyboard.layoutCtx);
    context.keyboard.layoutCtx = NULL;
 
    snprintf(savedKeyboardContext.title,
             sizeof(savedKeyboardContext.title),
             "Select word #%d",
             context.keyboard.content.number);
    nbgl_useCaseNavigableContent(savedKeyboardContext.title,
                                 0,
                                 1,
                                 savedKeyboardContext.backCallback,
                                 suggestionNavCallback,
                                 savedKeyboardContext.onButtonCallback);
}
 
// called when a key is touched on the keyboard
static void keyboardCallback(char touchedKey)
{
    uint32_t mask    = 0;
    size_t   textLen = strlen(context.keyboard.entryBuffer);
    PRINTF("[keyboardCallback] touchedKey: '%c'\n", touchedKey);
    if (touchedKey == BACKSPACE_KEY) {
        if (textLen == 0) {
            // Used to exit the keyboard when backspace is pressed on an empty entry
            context.keyboard.backCallback();
            return;
        }
        context.keyboard.entryBuffer[--textLen] = '\0';
    }
    else if (touchedKey == VALIDATE_KEY) {
        context.keyboard.actionCallback();
        return;
    }
    else {
        context.keyboard.entryBuffer[textLen]   = touchedKey;
        context.keyboard.entryBuffer[++textLen] = '\0';
    }
    // Set the keyMask to disable some keys
    if (context.keyboard.content.type == KEYBOARD_WITH_SUGGESTIONS) {
        // if suggestions are displayed, we update them at each key press
        context.keyboard.getSuggestButtons(&context.keyboard.content, &mask);
        const nbgl_layoutSuggestionButtons_t *suggestions
            = &context.keyboard.content.suggestionButtons;
        // On Nano, when all the matching candidates can be displayed, switch to a selection page
        // instead of continuing with keyboard entry. When the caller provides the real number of
        // candidates (nbCandidates != 0), rely on it: this lets a fully-typed word that is also
        // the prefix of other words (e.g. "can") be selected even though the displayed buttons are
        // capped at NB_MAX_SUGGESTION_BUTTONS. Otherwise fall back to the legacy heuristic based on
        // the number of displayed buttons.
        bool allCandidatesFit;
        if (suggestions->nbCandidates != 0) {
            allCandidatesFit = (suggestions->nbCandidates <= NB_MAX_SUGGESTION_BUTTONS);
        }
        else {
            allCandidatesFit = (suggestions->nbUsedButtons < NB_MAX_SUGGESTION_BUTTONS);
        }
        if ((suggestions->nbUsedButtons > 0) && allCandidatesFit) {
            displaySuggestionSelection();
            return;  // Don't update keyboard, we're in suggestion mode
        }
    }
    else if (textLen >= context.keyboard.entryMaxLen) {
        // entry length can't be greater, so we mask every characters
        mask = -1;
    }
    nbgl_layoutUpdateKeyboard(context.keyboard.layoutCtx, context.keyboard.keyboardIndex, mask);
    nbgl_layoutUpdateEnteredText(
        context.keyboard.layoutCtx, context.keyboard.textIndex, context.keyboard.entryBuffer);
    nbgl_refresh();
}
#endif
 
// this is the function called to start the actual review, from the initial warning pages
static void launchReviewAfterWarning(void)
{
    if (reviewWithWarnCtx.type == REVIEW_USE_CASE) {
        useCaseReview(reviewWithWarnCtx.type,
                      reviewWithWarnCtx.operationType,
                      reviewWithWarnCtx.tagValueList,
                      reviewWithWarnCtx.icon,
                      reviewWithWarnCtx.reviewTitle,
                      reviewWithWarnCtx.reviewSubTitle,
                      reviewWithWarnCtx.finishTitle,
                      reviewWithWarnCtx.choiceCallback);
    }
    else if (reviewWithWarnCtx.type == STREAMING_START_REVIEW_USE_CASE) {
        displayStreamingReviewPage(FORWARD_DIRECTION);
    }
}
 
// callback used when navigating in a bar detail sub-page
static void barDetailNavigate(nbgl_step_t stepCtx, nbgl_buttonEvent_t event)
{
    UNUSED(stepCtx);
    if (event == BUTTON_LEFT_PRESSED) {
        displayWarningStep();
    }
}
 
// display a bar detail sub-page (CENTERED_INFO_WARNING type)
static void displayBarDetailStep(void)
{
    const nbgl_genericDetails_t *detail
        = &reviewWithWarnCtx.warning->introDetails->barList.details[reviewWithWarnCtx.barDetailIdx];
 
    if (detail->type == CENTERED_INFO_WARNING) {
        nbgl_layoutCenteredInfo_t info = {0};
        info.icon                      = detail->centeredInfo.icon;
        info.text1                     = detail->centeredInfo.title;
        info.text2                     = detail->centeredInfo.description;
        info.style                     = BOLD_TEXT1_INFO;
        // LAST_STEP: only left arrow shown, pressing LEFT goes back via barDetailNavigate
        nbgl_stepDrawCenteredInfo(
            LAST_STEP | BACKWARD_DIRECTION, barDetailNavigate, NULL, &info, false);
        nbgl_refresh();
    }
}
 
// this is the callback used when navigating in warning pages
static void warningNavigate(nbgl_step_t stepCtx, nbgl_buttonEvent_t event)
{
    UNUSED(stepCtx);
    uint8_t barIdx = 0;
 
    if (event == BUTTON_LEFT_PRESSED) {
        // only decrement page if we are not at the first page
        if (reviewWithWarnCtx.warningPage > 0) {
            reviewWithWarnCtx.warningPage--;
        }
    }
    else if (event == BUTTON_RIGHT_PRESSED) {
        // only increment page if not at last page
        if (reviewWithWarnCtx.warningPage < (reviewWithWarnCtx.nbWarningPages - 1)) {
            reviewWithWarnCtx.warningPage++;
        }
        else if ((reviewWithWarnCtx.warning->predefinedSet == 0)
                 && (reviewWithWarnCtx.warning->info != NULL)) {
            launchReviewAfterWarning();
            return;
        }
    }
    else if ((event == BUTTON_BOTH_PRESSED)
             && (reviewWithWarnCtx.warning->predefinedSet & (1 << BLIND_SIGNING_WARN))) {
        // if at first page, double press leads to start of review
        if (reviewWithWarnCtx.warningPage == reviewWithWarnCtx.firstWarningPage) {
            launchReviewAfterWarning();
        }
        // if at last page, reject operation
        else if (reviewWithWarnCtx.warningPage == (reviewWithWarnCtx.nbWarningPages - 1)) {
            reviewWithWarnCtx.choiceCallback(false);
        }
        return;
    }
    else if ((event == BUTTON_BOTH_PRESSED) && (reviewWithWarnCtx.warning->introDetails != NULL)
             && (reviewWithWarnCtx.warning->introDetails->type == BAR_LIST_WARNING)
             && (reviewWithWarnCtx.warningPage > reviewWithWarnCtx.firstWarningPage)) {
        // enter the detail sub-page for the current bar (if it has one)
        barIdx = reviewWithWarnCtx.warningPage - reviewWithWarnCtx.firstWarningPage - 1;
        if ((reviewWithWarnCtx.warning->introDetails->barList.details != NULL)
            && (reviewWithWarnCtx.warning->introDetails->barList.details[barIdx].type
                != NO_TYPE_WARNING)) {
            reviewWithWarnCtx.barDetailIdx = barIdx;
            displayBarDetailStep();
        }
        return;
    }
    else {
        return;
    }
    displayWarningStep();
}
 
// function used to display the initial warning pages when starting a "review with warning"
static void displayWarningStep(void)
{
    nbgl_layoutCenteredInfo_t info   = {0};
    nbgl_stepPosition_t       pos    = 0;
    uint8_t                   barIdx = 0;
    if ((reviewWithWarnCtx.warning->prelude) && (reviewWithWarnCtx.warningPage == 0)) {
        // for prelude, only draw text as a single step
        nbgl_stepDrawText(FIRST_STEP | FORWARD_DIRECTION,
                          warningNavigate,
                          NULL,
                          reviewWithWarnCtx.warning->prelude->title,
                          reviewWithWarnCtx.warning->prelude->description,
                          REGULAR_INFO,
                          false);
        nbgl_refresh();
        return;
    }
    else if (reviewWithWarnCtx.warning->predefinedSet & (1 << BLIND_SIGNING_WARN)) {
        if (reviewWithWarnCtx.warningPage == reviewWithWarnCtx.firstWarningPage) {
            // draw the main warning page
            info.icon  = &C_icon_warning;
            info.text1 = "Blind signing ahead";
            info.text2 = "To accept risk, press both buttons";
            pos        = (reviewWithWarnCtx.firstWarningPage == 0) ? FIRST_STEP
                                                                   : NEITHER_FIRST_NOR_LAST_STEP;
            pos |= FORWARD_DIRECTION;
        }
        else if (reviewWithWarnCtx.warningPage == (reviewWithWarnCtx.nbWarningPages - 1)) {
            getLastPageInfo(false, &info.icon, &info.text1);
            pos = LAST_STEP | BACKWARD_DIRECTION;
        }
    }
    else if ((reviewWithWarnCtx.warning->predefinedSet == 0)
             && (reviewWithWarnCtx.warning->info != NULL)) {
        if (reviewWithWarnCtx.warningPage == reviewWithWarnCtx.firstWarningPage) {
            info.icon  = reviewWithWarnCtx.warning->info->icon;
            info.text1 = reviewWithWarnCtx.warning->info->title;
            info.text2 = reviewWithWarnCtx.warning->info->description;
            pos        = (reviewWithWarnCtx.firstWarningPage == 0) ? FIRST_STEP
                                                                   : NEITHER_FIRST_NOR_LAST_STEP;
            pos |= FORWARD_DIRECTION;
        }
        else if ((reviewWithWarnCtx.warning->introDetails != NULL)
                 && (reviewWithWarnCtx.warning->introDetails->type == BAR_LIST_WARNING)) {
            // intermediate or last bar page
            barIdx = reviewWithWarnCtx.warningPage - reviewWithWarnCtx.firstWarningPage - 1;
            if (reviewWithWarnCtx.warning->introDetails->barList.icons) {
                info.icon = reviewWithWarnCtx.warning->introDetails->barList.icons[barIdx];
            }
            info.text1 = reviewWithWarnCtx.warning->introDetails->barList.texts[barIdx];
            if (reviewWithWarnCtx.warning->introDetails->barList.subTexts) {
                info.text2 = reviewWithWarnCtx.warning->introDetails->barList.subTexts[barIdx];
            }
            pos = NEITHER_FIRST_NOR_LAST_STEP;
        }
        else if (reviewWithWarnCtx.warningPage == (reviewWithWarnCtx.nbWarningPages - 1)) {
            if ((reviewWithWarnCtx.warning->introDetails != NULL)
                && (reviewWithWarnCtx.warning->introDetails->type == CENTERED_INFO_WARNING)) {
                info.icon  = reviewWithWarnCtx.warning->introDetails->centeredInfo.icon;
                info.text1 = reviewWithWarnCtx.warning->introDetails->centeredInfo.title;
                info.text2 = reviewWithWarnCtx.warning->introDetails->centeredInfo.description;
                pos        = NEITHER_FIRST_NOR_LAST_STEP;
            }
            else {
                // not supported
                return;
            }
        }
    }
    else {
        // not supported
        return;
    }
    info.style = BOLD_TEXT1_INFO;
    nbgl_stepDrawCenteredInfo(pos, warningNavigate, NULL, &info, false);
    nbgl_refresh();
}
 
// function used to display the initial warning page when starting a "review with warning"
static void displayInitialWarning(void)
{
    // draw the main warning page
    reviewWithWarnCtx.warningPage = 0;
    if ((reviewWithWarnCtx.warning->predefinedSet & (1 << BLIND_SIGNING_WARN))
        || ((reviewWithWarnCtx.warning->introDetails)
            && (reviewWithWarnCtx.warning->introDetails->type == CENTERED_INFO_WARNING))) {
        reviewWithWarnCtx.nbWarningPages = 2;
    }
    else if ((reviewWithWarnCtx.warning->introDetails)
             && (reviewWithWarnCtx.warning->introDetails->type == BAR_LIST_WARNING)) {
        reviewWithWarnCtx.nbWarningPages
            = reviewWithWarnCtx.warning->introDetails->barList.nbBars + 1;
    }
    else {
        // if no intro details and not Blind Signing warning, only one page
        reviewWithWarnCtx.nbWarningPages = 1;
    }
 
    reviewWithWarnCtx.firstWarningPage = 0;
    displayWarningStep();
}
 
// function used to display the prelude page when starting a "review with warning"
static void displayPrelude(void)
{
    // draw the main warning page
    reviewWithWarnCtx.warningPage = 0;
    if ((reviewWithWarnCtx.warning->predefinedSet & (1 << BLIND_SIGNING_WARN))
        || ((reviewWithWarnCtx.warning->introDetails)
            && (reviewWithWarnCtx.warning->introDetails->type == CENTERED_INFO_WARNING))) {
        reviewWithWarnCtx.nbWarningPages = 3;
    }
    else {
        // if no intro details and not Blind Signing warning, only 2 pages
        reviewWithWarnCtx.nbWarningPages = 2;
    }
    reviewWithWarnCtx.firstWarningPage = 1;
    displayWarningStep();
}
 
/**********************
 *  GLOBAL FUNCTIONS
 **********************/
 
uint8_t nbgl_useCaseGetNbTagValuesInPage(uint8_t                           nbPairs,
                                         const nbgl_contentTagValueList_t *tagValueList,
                                         uint8_t                           startIndex,
                                         bool                             *requireSpecificDisplay)
{
    UNUSED(nbPairs);
    UNUSED(tagValueList);
    UNUSED(startIndex);
    *requireSpecificDisplay = true;
    return 1;
}
 
uint8_t nbgl_useCaseGetNbChoicesInPage(uint8_t                          nbChoices,
                                       const nbgl_contentRadioChoice_t *choicesList,
                                       uint8_t                          startIndex,
                                       bool                             withNav)
{
    UNUSED(nbChoices);
    UNUSED(choicesList);
    UNUSED(startIndex);
    UNUSED(withNav);
    return 1;
}
 
void nbgl_useCaseNavigableContent(const char                *title,
                                  uint8_t                    initPage,
                                  uint8_t                    nbPages,
                                  nbgl_callback_t            quitCallback,
                                  nbgl_navCallback_t         navCallback,
                                  nbgl_layoutTouchCallback_t controlsCallback)
{
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.type                                       = CONTENT_USE_CASE;
    context.currentPage                                = initPage;
    context.content.title                              = title;
    context.content.quitCallback                       = quitCallback;
    context.content.navCallback                        = navCallback;
    context.content.controlsCallback                   = controlsCallback;
    context.content.genericContents.callbackCallNeeded = true;
    context.content.genericContents.nbContents         = nbPages;
 
    startUseCaseContent();
}
 
void nbgl_useCaseHomeAndSettings(const char                   *appName,
                                 const nbgl_icon_details_t    *appIcon,
                                 const char                   *tagline,
                                 const uint8_t                 initSettingPage,
                                 const nbgl_genericContents_t *settingContents,
                                 const nbgl_contentInfoList_t *infosList,
                                 const nbgl_homeAction_t      *action,
                                 nbgl_callback_t               quitCallback)
{
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.home.appName         = appName;
    context.home.appIcon         = appIcon;
    context.home.tagline         = tagline;
    context.home.settingContents = PIC(settingContents);
    context.home.infosList       = PIC(infosList);
    context.home.homeAction      = action;
    context.home.quitCallback    = quitCallback;
 
    if ((initSettingPage != INIT_HOME_PAGE) && (settingContents != NULL)) {
        startUseCaseSettingsAtPage(initSettingPage);
    }
    else {
        startUseCaseHome();
    }
}
 
void nbgl_useCaseGenericSettings(const char                   *appName,
                                 uint8_t                       initPage,
                                 const nbgl_genericContents_t *settingContents,
                                 const nbgl_contentInfoList_t *infosList,
                                 nbgl_callback_t               quitCallback)
{
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.type                 = GENERIC_SETTINGS;
    context.home.appName         = appName;
    context.home.settingContents = PIC(settingContents);
    context.home.infosList       = PIC(infosList);
    context.home.quitCallback    = quitCallback;
 
    startUseCaseSettingsAtPage(initPage);
}
 
void nbgl_useCaseGenericConfiguration(const char                   *title,
                                      uint8_t                       initPage,
                                      const nbgl_genericContents_t *contents,
                                      nbgl_callback_t               quitCallback)
{
    nbgl_useCaseGenericSettings(title, initPage, contents, NULL, quitCallback);
}
 
void nbgl_useCaseReview(nbgl_operationType_t              operationType,
                        const nbgl_contentTagValueList_t *tagValueList,
                        const nbgl_icon_details_t        *icon,
                        const char                       *reviewTitle,
                        const char                       *reviewSubTitle,
                        const char                       *finishTitle,
                        nbgl_choiceCallback_t             choiceCallback)
{
    useCaseReview(REVIEW_USE_CASE,
                  operationType,
                  tagValueList,
                  icon,
                  reviewTitle,
                  reviewSubTitle,
                  finishTitle,
                  choiceCallback);
}
 
void nbgl_useCaseAdvancedReview(nbgl_operationType_t              operationType,
                                const nbgl_contentTagValueList_t *tagValueList,
                                const nbgl_icon_details_t        *icon,
                                const char                       *reviewTitle,
                                const char                       *reviewSubTitle,
                                const char                       *finishTitle,
                                const nbgl_tipBox_t              *tipBox,
                                const nbgl_warning_t             *warning,
                                nbgl_choiceCallback_t             choiceCallback)
{
    UNUSED(tipBox);
    ContextType_t type = REVIEW_USE_CASE;
 
    // if no warning at all, it's a simple review
    if ((warning == NULL)
        || ((warning->predefinedSet == 0) && (warning->info == NULL)
            && (warning->reviewDetails == NULL) && (warning->prelude == NULL))) {
        useCaseReview(type,
                      operationType,
                      tagValueList,
                      icon,
                      reviewTitle,
                      reviewSubTitle,
                      finishTitle,
                      choiceCallback);
        return;
    }
    if (warning->predefinedSet == (1 << W3C_NO_THREAT_WARN)) {
        operationType |= NO_THREAT_OPERATION;
    }
    else if (warning->predefinedSet != 0) {
        operationType |= RISKY_OPERATION;
    }
 
    memset(&reviewWithWarnCtx, 0, sizeof(reviewWithWarnCtx));
    reviewWithWarnCtx.type           = type;
    reviewWithWarnCtx.operationType  = operationType;
    reviewWithWarnCtx.tagValueList   = tagValueList;
    reviewWithWarnCtx.icon           = icon;
    reviewWithWarnCtx.reviewTitle    = reviewTitle;
    reviewWithWarnCtx.reviewSubTitle = reviewSubTitle;
    reviewWithWarnCtx.finishTitle    = finishTitle;
    reviewWithWarnCtx.warning        = warning;
    reviewWithWarnCtx.choiceCallback = choiceCallback;
 
    // if the warning contains a prelude, display it first
    if (reviewWithWarnCtx.warning->prelude) {
        displayPrelude();
    }
    // display the initial warning only of a risk/threat or blind signing or prelude
    else if (HAS_INITIAL_WARNING(warning)) {
        displayInitialWarning();
    }
    else {
        useCaseReview(type,
                      operationType,
                      tagValueList,
                      icon,
                      reviewTitle,
                      reviewSubTitle,
                      finishTitle,
                      choiceCallback);
    }
}
 
void nbgl_useCaseReviewBlindSigning(nbgl_operationType_t              operationType,
                                    const nbgl_contentTagValueList_t *tagValueList,
                                    const nbgl_icon_details_t        *icon,
                                    const char                       *reviewTitle,
                                    const char                       *reviewSubTitle,
                                    const char                       *finishTitle,
                                    const nbgl_tipBox_t              *dummy,
                                    nbgl_choiceCallback_t             choiceCallback)
{
    nbgl_useCaseAdvancedReview(operationType,
                               tagValueList,
                               icon,
                               reviewTitle,
                               reviewSubTitle,
                               finishTitle,
                               dummy,
                               &blindSigningWarning,
                               choiceCallback);
}
 
void nbgl_useCaseReviewLight(nbgl_operationType_t              operationType,
                             const nbgl_contentTagValueList_t *tagValueList,
                             const nbgl_icon_details_t        *icon,
                             const char                       *reviewTitle,
                             const char                       *reviewSubTitle,
                             const char                       *finishTitle,
                             nbgl_choiceCallback_t             choiceCallback)
{
    nbgl_useCaseReview(operationType,
                       tagValueList,
                       icon,
                       reviewTitle,
                       reviewSubTitle,
                       finishTitle,
                       choiceCallback);
}
 
void nbgl_useCaseAddressReview(const char                       *address,
                               const nbgl_contentTagValueList_t *additionalTagValueList,
                               const nbgl_icon_details_t        *icon,
                               const char                       *reviewTitle,
                               const char                       *reviewSubTitle,
                               nbgl_choiceCallback_t             choiceCallback)
{
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.type                  = ADDRESS_REVIEW_USE_CASE;
    context.review.address        = address;
    context.review.reviewTitle    = reviewTitle;
    context.review.reviewSubTitle = reviewSubTitle;
    context.review.icon           = icon;
    context.review.onChoice       = choiceCallback;
    context.currentPage           = 0;
    // + 4 because 1 page for title, 1 for address and 2 pages at the end for approve/reject
    // + 1 if sub Title
    context.nbPages = reviewSubTitle ? 5 : 4;
    if (additionalTagValueList) {
        context.review.tagValueList = PIC(additionalTagValueList);
        context.nbPages += additionalTagValueList->nbPairs;
    }
 
    displayReviewPage(FORWARD_DIRECTION);
}
 
void nbgl_useCaseGenericReview(const nbgl_genericContents_t *contents,
                               const char                   *rejectText,
                               nbgl_callback_t               rejectCallback)
{
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.type                                       = GENERIC_REVIEW_USE_CASE;
    context.content.rejectText                         = rejectText;
    context.content.quitCallback                       = rejectCallback;
    context.content.genericContents.nbContents         = contents->nbContents;
    context.content.genericContents.callbackCallNeeded = contents->callbackCallNeeded;
    if (contents->callbackCallNeeded) {
        context.content.genericContents.contentGetterCallback = contents->contentGetterCallback;
    }
    else {
        context.content.genericContents.contentsList = PIC(contents->contentsList);
    }
 
    startUseCaseContent();
}
 
void nbgl_useCaseStatus(const char *message, bool isSuccess, nbgl_callback_t quitCallback)
{
    UNUSED(isSuccess);
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.type         = STATUS_USE_CASE;
    context.stepCallback = quitCallback;
    context.currentPage  = 0;
    context.nbPages      = 1;
 
    drawStep(SINGLE_STEP | ACTION_ON_ANY_BUTTON,
             NULL,
             message,
             NULL,
             statusButtonCallback,
             false,
             NO_FORCED_TYPE,
             false);
}
 
void nbgl_useCaseReviewStatus(nbgl_reviewStatusType_t reviewStatusType,
                              nbgl_callback_t         quitCallback)
{
    const char *msg;
    bool        isSuccess;
    switch (reviewStatusType) {
        case STATUS_TYPE_OPERATION_SIGNED:
            msg       = "Operation signed";
            isSuccess = true;
            break;
        case STATUS_TYPE_OPERATION_REJECTED:
            msg       = "Operation rejected";
            isSuccess = false;
            break;
        case STATUS_TYPE_TRANSACTION_SIGNED:
            msg       = "Transaction signed";
            isSuccess = true;
            break;
        case STATUS_TYPE_TRANSACTION_REJECTED:
            msg       = "Transaction rejected";
            isSuccess = false;
            break;
        case STATUS_TYPE_MESSAGE_SIGNED:
            msg       = "Message signed";
            isSuccess = true;
            break;
        case STATUS_TYPE_MESSAGE_REJECTED:
            msg       = "Message rejected";
            isSuccess = false;
            break;
        case STATUS_TYPE_ADDRESS_VERIFIED:
            msg       = "Address verified";
            isSuccess = true;
            break;
        case STATUS_TYPE_ADDRESS_REJECTED:
            msg       = "Address verification cancelled";
            isSuccess = false;
            break;
        default:
            return;
    }
    nbgl_useCaseStatus(msg, isSuccess, quitCallback);
}
 
void nbgl_useCaseReviewStreamingStart(nbgl_operationType_t       operationType,
                                      const nbgl_icon_details_t *icon,
                                      const char                *reviewTitle,
                                      const char                *reviewSubTitle,
                                      nbgl_choiceCallback_t      choiceCallback)
{
    // memorize streaming operation type for future API calls
    streamingOpType = operationType;
 
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.type                  = STREAMING_START_REVIEW_USE_CASE;
    context.operationType         = operationType;
    context.review.reviewTitle    = reviewTitle;
    context.review.reviewSubTitle = reviewSubTitle;
    context.review.icon           = icon;
    context.review.onChoice       = choiceCallback;
    context.currentPage           = 0;
    context.nbPages = reviewSubTitle ? 3 : 2;  // Start page(s) + trick for review continue
 
    displayStreamingReviewPage(FORWARD_DIRECTION);
}
 
void nbgl_useCaseReviewStreamingBlindSigningStart(nbgl_operationType_t       operationType,
                                                  const nbgl_icon_details_t *icon,
                                                  const char                *reviewTitle,
                                                  const char                *reviewSubTitle,
                                                  nbgl_choiceCallback_t      choiceCallback)
{
    nbgl_useCaseAdvancedReviewStreamingStart(
        operationType, icon, reviewTitle, reviewSubTitle, &blindSigningWarning, choiceCallback);
}
 
void nbgl_useCaseAdvancedReviewStreamingStart(nbgl_operationType_t       operationType,
                                              const nbgl_icon_details_t *icon,
                                              const char                *reviewTitle,
                                              const char                *reviewSubTitle,
                                              const nbgl_warning_t      *warning,
                                              nbgl_choiceCallback_t      choiceCallback)
{
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.type                  = STREAMING_START_REVIEW_USE_CASE;
    context.operationType         = operationType;
    context.review.reviewTitle    = reviewTitle;
    context.review.reviewSubTitle = reviewSubTitle;
    context.review.icon           = icon;
    context.review.onChoice       = choiceCallback;
    context.currentPage           = 0;
    context.nbPages = reviewSubTitle ? 3 : 2;  // Start page(s) + trick for review continue
 
    // memorize streaming operation type for future API calls
    streamingOpType = operationType;
 
    // if no warning at all, it's a simple review
    if ((warning == NULL)
        || ((warning->predefinedSet == 0) && (warning->info == NULL)
            && (warning->reviewDetails == NULL) && (warning->prelude == NULL))) {
        displayStreamingReviewPage(FORWARD_DIRECTION);
        return;
    }
    if (warning->predefinedSet == (1 << W3C_NO_THREAT_WARN)) {
        operationType |= NO_THREAT_OPERATION;
    }
    else if (warning->predefinedSet != 0) {
        operationType |= RISKY_OPERATION;
    }
    memset(&reviewWithWarnCtx, 0, sizeof(reviewWithWarnCtx));
 
    reviewWithWarnCtx.type           = context.type;
    reviewWithWarnCtx.operationType  = operationType;
    reviewWithWarnCtx.icon           = icon;
    reviewWithWarnCtx.reviewTitle    = reviewTitle;
    reviewWithWarnCtx.reviewSubTitle = reviewSubTitle;
    reviewWithWarnCtx.choiceCallback = choiceCallback;
    reviewWithWarnCtx.warning        = warning;
 
    // if the warning contains a prelude, display it first
    if (reviewWithWarnCtx.warning->prelude) {
        displayPrelude();
    }
    // display the initial warning only of a risk/threat or blind signing or prelude
    else if (HAS_INITIAL_WARNING(warning)) {
        displayInitialWarning();
    }
    else {
        displayStreamingReviewPage(FORWARD_DIRECTION);
    }
}
 
void nbgl_useCaseReviewStreamingContinueExt(const nbgl_contentTagValueList_t *tagValueList,
                                            nbgl_choiceCallback_t             choiceCallback,
                                            nbgl_callback_t                   skipCallback)
{
    uint8_t curNbDataSets = context.review.nbDataSets;
 
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.type                = STREAMING_CONTINUE_REVIEW_USE_CASE;
    context.operationType       = streamingOpType;
    context.review.tagValueList = tagValueList;
    context.review.onChoice     = choiceCallback;
    context.currentPage         = 0;
    context.nbPages             = tagValueList->nbPairs + 1;  // data + trick for review continue
    context.review.skipCallback = skipCallback;
    context.review.nbDataSets   = curNbDataSets + 1;
 
    displayStreamingReviewPage(FORWARD_DIRECTION);
}
 
void nbgl_useCaseReviewStreamingContinue(const nbgl_contentTagValueList_t *tagValueList,
                                         nbgl_choiceCallback_t             choiceCallback)
{
    nbgl_useCaseReviewStreamingContinueExt(tagValueList, choiceCallback, NULL);
}
 
void nbgl_useCaseReviewStreamingFinish(const char           *finishTitle,
                                       nbgl_choiceCallback_t choiceCallback)
{
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.type               = STREAMING_FINISH_REVIEW_USE_CASE;
    context.operationType      = streamingOpType;
    context.review.onChoice    = choiceCallback;
    context.review.finishTitle = finishTitle;
    context.currentPage        = 0;
    context.nbPages            = 2;  // 2 pages at the end for accept/reject
 
    displayStreamingReviewPage(FORWARD_DIRECTION);
}
 
void nbgl_useCaseSpinner(const char *text)
{
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.type        = SPINNER_USE_CASE;
    context.currentPage = 0;
    context.nbPages     = 1;
 
    displaySpinner(text);
}
 
void nbgl_useCaseChoice(const nbgl_icon_details_t *icon,
                        const char                *message,
                        const char                *subMessage,
                        const char                *confirmText,
                        const char                *cancelText,
                        nbgl_choiceCallback_t      callback)
{
    nbgl_useCaseChoiceWithDetails(
        icon, message, subMessage, confirmText, cancelText, NULL, callback);
};
 
// Common implementation of the choice flows. title is NULL for the basic ones, in which case
// message and subMessage share the same page.
static void startChoice(const nbgl_icon_details_t *icon,
                        const char                *title,
                        const char                *message,
                        const char                *subMessage,
                        const char                *confirmText,
                        const char                *cancelText,
                        nbgl_genericDetails_t     *details,
                        nbgl_choiceCallback_t      callback)
{
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.type               = CHOICE_USE_CASE;
    context.choice.icon        = icon;
    context.choice.title       = title;
    context.choice.message     = message;
    context.choice.subMessage  = subMessage;
    context.choice.confirmText = confirmText;
    context.choice.cancelText  = cancelText;
    context.choice.onChoice    = callback;
    context.choice.details     = details;
    context.currentPage        = 0;
    context.nbPages            = 2 + getChoiceNbIntroPages();  // 2 pages for confirm/cancel
    if (details != NULL) {
        // only the first level of details and BAR_LIST type are supported
        if (details->type == BAR_LIST_WARNING) {
            context.nbPages += details->barList.nbBars;
        }
    }
 
    displayChoicePage(FORWARD_DIRECTION);
}
 
void nbgl_useCaseChoiceWithDetails(const nbgl_icon_details_t *icon,
                                   const char                *message,
                                   const char                *subMessage,
                                   const char                *confirmText,
                                   const char                *cancelText,
                                   nbgl_genericDetails_t     *details,
                                   nbgl_choiceCallback_t      callback)
{
    startChoice(icon, NULL, message, subMessage, confirmText, cancelText, details, callback);
};
 
// On Nano, the three texts of the advanced variant are spread over one page each, the title
// being kept as the first line of all of them. headerIcon is ignored (no top-right button).
void nbgl_useCaseAdvancedChoiceWithDetails(const nbgl_icon_details_t *centerIcon,
                                           const nbgl_icon_details_t *headerIcon,
                                           const char                *title,
                                           const char                *message,
                                           const char                *subMessage,
                                           const char                *confirmText,
                                           const char                *cancelText,
                                           nbgl_genericDetails_t     *details,
                                           nbgl_choiceCallback_t      callback)
{
    UNUSED(headerIcon);
    startChoice(centerIcon, title, message, subMessage, confirmText, cancelText, details, callback);
}
 
void nbgl_useCaseConfirm(const char     *message,
                         const char     *subMessage,
                         const char     *confirmText,
                         const char     *cancelText,
                         nbgl_callback_t callback)
{
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.type                = CONFIRM_USE_CASE;
    context.confirm.message     = message;
    context.confirm.subMessage  = subMessage;
    context.confirm.confirmText = confirmText;
    context.confirm.cancelText  = cancelText;
    context.confirm.onConfirm   = callback;
    context.currentPage         = 0;
    context.nbPages             = 1 + 2;  // 2 pages at the end for confirm/cancel
 
    displayConfirm(FORWARD_DIRECTION);
}
 
void nbgl_useCaseAction(const nbgl_icon_details_t *icon,
                        const char                *message,
                        const char                *actionText,
                        nbgl_callback_t            callback)
{
    nbgl_layoutCenteredInfo_t centeredInfo = {0};
 
    UNUSED(actionText);
 
    // memorize callback in context
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.type                  = ACTION_USE_CASE;
    context.action.actionCallback = callback;
 
    centeredInfo.icon  = icon;
    centeredInfo.text1 = message;
    centeredInfo.style = BOLD_TEXT1_INFO;
    nbgl_stepDrawCenteredInfo(0, useCaseActionCallback, NULL, &centeredInfo, false);
}
 
#ifdef NBGL_KEYPAD
void nbgl_useCaseKeypad(const char             *title,
                        uint8_t                 minDigits,
                        uint8_t                 maxDigits,
                        bool                    shuffled,
                        bool                    hidden,
                        nbgl_pinValidCallback_t validatePinCallback,
                        nbgl_callback_t         backCallback)
{
    nbgl_layoutDescription_t layoutDescription = {0};
    int                      status            = -1;
 
    // reset the keypad context
    memset(&context, 0, sizeof(KeypadContext_t));
    context.type                = KEYPAD_USE_CASE;
    context.currentPage         = 0;
    context.nbPages             = 1;
    context.keypad.validatePin  = validatePinCallback;
    context.keypad.backCallback = backCallback;
    context.keypad.pinMinDigits = minDigits;
    context.keypad.pinMaxDigits = maxDigits;
    context.keypad.hidden       = hidden;
    context.keypad.layoutCtx    = nbgl_layoutGet(&layoutDescription);
 
    // add keypad
    status = nbgl_layoutAddKeypad(context.keypad.layoutCtx, keypadCallback, title, shuffled);
    if (status < 0) {
        LOG_WARN(
            USE_CASE_LOGGER, "nbgl_useCaseKeypad(): layout setup failed (status=%d)\n", status);
        return;
    }
    context.keypad.keypadIndex = status;
    // add digits
    status = nbgl_layoutAddKeypadContent(context.keypad.layoutCtx, hidden, maxDigits, "");
    if (status < 0) {
        LOG_WARN(
            USE_CASE_LOGGER, "nbgl_useCaseKeypad(): layout setup failed (status=%d)\n", status);
        return;
    }
 
    nbgl_layoutDraw(context.keypad.layoutCtx);
    if (context.keypad.backCallback != NULL) {
        // force backspace to be visible at first digit, to be used as quit
        nbgl_layoutUpdateKeypad(context.keypad.layoutCtx, context.keypad.keypadIndex, false, true);
    }
    nbgl_refresh();
}
#endif  // NBGL_KEYPAD
 
#ifdef NBGL_KEYBOARD
void nbgl_useCaseKeyboard(const nbgl_keyboardParams_t *params, nbgl_callback_t backCallback)
{
    // clang-format off
    nbgl_layoutDescription_t  layoutDescription = {0};
    nbgl_layoutCenteredInfo_t centeredInfo      = {.text1 = params->title,
                                                   .onTop = true};
    nbgl_layoutNavigation_t   navInfo           = {.direction = HORIZONTAL_NAV,
                                                   .indication = LEFT_ARROW | RIGHT_ARROW};
    nbgl_layoutKbd_t          kbdInfo           = {.callback = &keyboardCallback,
                                                   .mode = params->mode,
                                                   .lettersOnly = params->lettersOnly};
    int status = -1;
    // clang-format on
 
    // reset the keypad context
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.type                    = KEYBOARD_USE_CASE;
    context.currentPage             = 0;
    context.nbPages                 = 1;
    context.keyboard.entryBuffer    = PIC(params->entryBuffer);
    context.keyboard.entryMaxLen    = params->entryMaxLen;
    context.keyboard.entryBuffer[0] = '\0';
 
    context.keyboard.content.type = params->type;
 
    // memorize context
    context.keyboard.backCallback = PIC(backCallback);
 
    switch (params->type) {
        case KEYBOARD_WITH_BUTTON:
            context.keyboard.actionCallback = PIC(params->confirmationParams.onButtonCallback);
            break;
        case KEYBOARD_WITH_SUGGESTIONS:
            // No need for 'Validate' or 'Case switch' buttons
            kbdInfo.keyMask = (1 << VALIDATE_INDEX) | (1 << SHIFT_KEY_INDEX);
            context.keyboard.getSuggestButtons
                = PIC(params->suggestionParams.updateButtonsCallback);
            context.keyboard.onButtonCallback = PIC(params->suggestionParams.onButtonCallback);
            context.keyboard.content.suggestionButtons = (nbgl_layoutSuggestionButtons_t){
                .buttons          = PIC(params->suggestionParams.buttons),
                .firstButtonToken = params->suggestionParams.firstButtonToken,
            };
            break;
        default:
            return;
    }
 
    // get a layout
    context.keyboard.layoutCtx = nbgl_layoutGet(&layoutDescription);
 
    // add description
    nbgl_layoutAddCenteredInfo(context.keyboard.layoutCtx, &centeredInfo);
 
    // Add keyboard
    status = nbgl_layoutAddKeyboard(context.keyboard.layoutCtx, &kbdInfo);
    if (status < 0) {
        LOG_WARN(
            USE_CASE_LOGGER, "nbgl_useCaseKeyboard(): layout setup failed (status=%d)\n", status);
        return;
    }
    context.keyboard.keyboardIndex = status;
 
    // add empty entered text
    status = nbgl_layoutAddEnteredText(context.keyboard.layoutCtx, "", true);
    if (status < 0) {
        LOG_WARN(
            USE_CASE_LOGGER, "nbgl_useCaseKeyboard(): layout setup failed (status=%d)\n", status);
        return;
    }
    context.keyboard.textIndex = status;
 
    nbgl_layoutAddNavigation(context.keyboard.layoutCtx, &navInfo);
 
    nbgl_layoutDraw(context.keyboard.layoutCtx);
    nbgl_refresh();
}
#endif  // NBGL_KEYBOARD
 
#endif  // HAVE_SE_TOUCH
#endif  // NBGL_USE_CASE