crosspoint-reader/src/activities/home/HomeActivity.h

#pragma once
#include <freertos/FreeRTOS.h>
#include <freertos/semphr.h>
#include <freertos/task.h>

#include <functional>

#include "../Activity.h"

class HomeActivity final : public Activity {
  TaskHandle_t displayTaskHandle = nullptr;
  SemaphoreHandle_t renderingMutex = nullptr;
  int selectorIndex = 0;
  bool updateRequired = false;
  bool hasContinueReading = false;
  bool hasOpdsUrl = false;
  bool hasCoverImage = false;

  // Static cover buffer - persists across activity changes to avoid reloading from SD
  static bool coverRendered;       // Track if cover has been rendered once
  static bool coverBufferStored;   // Track if cover buffer is stored
  static uint8_t* coverBuffer;     // HomeActivity's own buffer for cover image
  static std::string cachedCoverPath;  // Path of the cached cover (to detect book changes)

  std::string lastBookTitle;
  std::string lastBookAuthor;
  std::string coverBmpPath;
  const std::function<void()> onContinueReading;
  const std::function<void()> onListsOpen;  // Goes to pinned list or lists tab
  const std::function<void()> onMyLibraryOpen;
  const std::function<void()> onSettingsOpen;
  const std::function<void()> onFileTransferOpen;
  const std::function<void()> onOpdsBrowserOpen;

  static void taskTrampoline(void* param);
  [[noreturn]] void displayTaskLoop();
  void render();
  int getMenuItemCount() const;
  bool storeCoverBuffer();    // Store frame buffer for cover image
  bool restoreCoverBuffer();  // Restore frame buffer from stored cover
  void freeCoverBuffer();     // Free the stored cover buffer

 public:
  // Free cover buffer from external activities (e.g., when entering reader to reclaim memory)
  static void freeCoverBufferIfAllocated();
  
  // Preload cover buffer from external activities (e.g., MyLibraryActivity) for instant Home screen
  // Returns true if cover was successfully preloaded or already cached
  static bool preloadCoverBuffer();
  explicit HomeActivity(GfxRenderer& renderer, MappedInputManager& mappedInput,
                        const std::function<void()>& onContinueReading, const std::function<void()>& onListsOpen,
                        const std::function<void()>& onMyLibraryOpen, const std::function<void()>& onSettingsOpen,
                        const std::function<void()>& onFileTransferOpen,
                        const std::function<void()>& onOpdsBrowserOpen)
      : Activity("Home", renderer, mappedInput),
        onContinueReading(onContinueReading),
        onListsOpen(onListsOpen),
        onMyLibraryOpen(onMyLibraryOpen),
        onSettingsOpen(onSettingsOpen),
        onFileTransferOpen(onFileTransferOpen),
        onOpdsBrowserOpen(onOpdsBrowserOpen) {}
  void onEnter() override;
  void onExit() override;
  void loop() override;
};