Display.h

#pragma once

#include <Arduino.h>  // For String, uint8_t types
#include "GlobalState.h"

#ifdef ENABLE_DISPLAY

// Must be called once in setup() BEFORE any display function.
// Creates the recursive FreeRTOS mutex that serializes all SPI/TFT access
// across Core 0 (Task1 button callbacks) and Core 1 (main loop).
void initDisplayMutex();

void initDisplay();
void startupScreen();
void btctickerScreen();
void updateBtctickerValues(); // Partial update - only values, no full redraw
void initializationScreen();
void bootUpScreen();
void configModeScreen();
void errorReportScreen(uint8_t wifiCount, uint8_t internetCount, uint8_t serverCount, uint8_t websocketCount);
void wifiReconnectScreen();
void internetReconnectScreen();
void serverReconnectScreen();
void websocketReconnectScreen();
void stepOneScreen();
void stepTwoScreen();
void stepThreeScreen();
void actionTimeScreen();
void updateActionTimeCountdown(int remainingSecs);
void identityTriggerScreen();
void nfcPendingScreen();
void nfcNoLuckScreen();
void nfcNotSupportedScreen();
void nfcErrorDetailScreen(const char* detail);
void thankYouScreen();
void productBlockedScreen();
void supplyBinEmptyScreen();
void drawQRCode();
void showQRScreen();
void showThresholdQRScreen();
void showProductQRScreen(String label, int pin);
void showBoltCardScreen(String label, int pin);
void showMobilePhoneScreen(String label, int pin);
void productSelectionScreen();
void activateScreensaver(String mode);
void deactivateScreensaver();
bool isScreensaverActive();
void prepareDeepSleep();
void setupDeepSleepWakeup(String mode);
bool isDeepSleepActive();

// NFC Hardware Test (ENABLE_NFC=1 + ENABLE_NFC_TEST=1)
void nfcTestScreen(String lnurlw);

// PIN pad for BoltCard PIN entry (LUD pinLimit)
void showPinPadScreen(const PinPadState &state);
// Returns: 0-9=digit, 10=backspace, 11=clear, 12=cancel, -1=no hit
int  pinPadHitTest(uint16_t x, uint16_t y);

// Auth / Identity screens: implemented on both T-Display-S3 and Touch 3.5".
// Touch 3.5": CANCEL button on teach screen; tap-driven tab switch for dual-page.
// T-Display-S3: simplified teach screen; NEXT button drives dual-page navigation.
void showAuthTeachScreen(String label, int pin);
void showAuthToast(const String &msg, bool isError);
void showAuthIdentityScreen(String label, int pin);
void showAuthPayScreen(String label, int pin);
void authIdentityDisabledScreen();

// Board-specific: Touch 3.5" has real implementations; T-Display-S3 uses stubs.
#ifdef BOARD_JC3248W535C
// Mini-PoS amount entry, invoice QR, paid confirmation (Touch 3.5 only)
void showMiniPosInputScreen();
int  miniPosHitTest(uint16_t x, uint16_t y);
void showMiniPosQRScreen();
bool miniPosQrCancelHit(uint16_t x, uint16_t y);
void miniPosPaidScreen();
// Numerical product selection (Touch 3.5 multi-channel only)
void showProductSelectScreen();
void updateProductSelectBlockHeight();
int  productSelectHitTest(uint16_t x, uint16_t y);
void showProductSelectQRScreen(String label, int pin);
bool productSelectQrCancelHit(uint16_t x, uint16_t y);
// Mode selection screen (Touch 3.5 only)
void showModeSelectionScreen();
int  modeSelectHitTest(uint16_t x, uint16_t y);
// PIN failure overlay and touch-based cancel/tab hit tests (Touch 3.5 only)
void showAuthPinError(const String &l1, const String &l2, const String &l3);
bool authTeachCancelHit(uint16_t x, uint16_t y);
bool authTabHit(uint16_t x, uint16_t y);
#else
// T-Display-S3: these touch-only functions are not needed
inline void showMiniPosInputScreen() {}
inline int  miniPosHitTest(uint16_t, uint16_t) { return -1; }
inline void showMiniPosQRScreen() {}
inline bool miniPosQrCancelHit(uint16_t, uint16_t) { return false; }
inline void miniPosPaidScreen() {}
inline void showProductSelectScreen() {}
inline void updateProductSelectBlockHeight() {}
inline int  productSelectHitTest(uint16_t, uint16_t) { return -1; }
inline void showProductSelectQRScreen(String, int) {}
inline bool productSelectQrCancelHit(uint16_t, uint16_t) { return false; }
inline void showModeSelectionScreen() {}
inline int  modeSelectHitTest(uint16_t, uint16_t) { return -1; }
inline void showAuthPinError(const String &, const String &, const String &) {}
inline bool authTeachCancelHit(uint16_t, uint16_t) { return false; }
inline bool authTabHit(uint16_t, uint16_t)         { return false; }
#endif // BOARD_JC3248W535C

#else // !ENABLE_DISPLAY

// Headless mode - stub implementations (no display)
inline void initDisplayMutex() {}
inline void initDisplay() {}
inline void startupScreen() {}
inline void btctickerScreen() {}
inline void updateBtctickerValues() {}
inline void initializationScreen() {}
inline void bootUpScreen() {}
inline void configModeScreen() {}
inline void errorReportScreen(uint8_t, uint8_t, uint8_t, uint8_t) {}
inline void wifiReconnectScreen() {}
inline void internetReconnectScreen() {}
inline void serverReconnectScreen() {}
inline void websocketReconnectScreen() {}
inline void stepOneScreen() {}
inline void stepTwoScreen() {}
inline void stepThreeScreen() {}
inline void actionTimeScreen() {}
inline void identityTriggerScreen() {}
inline void updateActionTimeCountdown(int) {}
inline void nfcPendingScreen() {}
inline void nfcNoLuckScreen() {}
inline void nfcNotSupportedScreen() {}
inline void nfcErrorDetailScreen(const char*) {}
inline void thankYouScreen() {}
inline void productBlockedScreen() {}
inline void supplyBinEmptyScreen() {}
inline void drawQRCode() {}
inline void showQRScreen() {}
inline void showThresholdQRScreen() {}
inline void showProductQRScreen(String, int) {}
inline void showBoltCardScreen(String, int) {}
inline void showMobilePhoneScreen(String, int) {}
inline void productSelectionScreen() {}
inline void activateScreensaver(String) {}
inline void deactivateScreensaver() {}
inline bool isScreensaverActive() { return false; }
inline void prepareDeepSleep() {}
inline void setupDeepSleepWakeup(String) {}
inline bool isDeepSleepActive() { return false; }
inline void nfcTestScreen(String) {}
inline void showPinPadScreen(const PinPadState &) {}
inline int  pinPadHitTest(uint16_t, uint16_t) { return -1; }
inline void showModeSelectionScreen() {}
inline int  modeSelectHitTest(uint16_t, uint16_t) { return -1; }
inline void showMiniPosInputScreen() {}
inline int  miniPosHitTest(uint16_t, uint16_t) { return -1; }
inline void showMiniPosQRScreen() {}
inline bool miniPosQrCancelHit(uint16_t, uint16_t) { return false; }
inline void miniPosPaidScreen() {}
inline void showProductSelectScreen() {}
inline void updateProductSelectBlockHeight() {}
inline int  productSelectHitTest(uint16_t, uint16_t) { return -1; }
inline void showProductSelectQRScreen(String, int) {}
inline bool productSelectQrCancelHit(uint16_t, uint16_t) { return false; }
inline void showAuthTeachScreen(String, int) {}
inline void showAuthPinError(const String &, const String &, const String &) {}
inline void showAuthToast(const String &, bool) {}
inline bool authTeachCancelHit(uint16_t, uint16_t) { return false; }
inline void showAuthIdentityScreen(String, int) {}
inline void showAuthPayScreen(String, int) {}
inline bool authTabHit(uint16_t, uint16_t) { return false; }
inline void authIdentityDisabledScreen() {}

#endif // ENABLE_DISPLAY