MarkdownView.h

Go to the documentation of this file.

#pragma once
 
#include <cstddef>
#include <cstdint>
 
#include "cdc_core/Raii.h"
#include "cdc_ui/IView.h"
#include "cdc_views/MarkdownModel.h"
 
namespace cdc::ui {

class MarkdownView : public ViewBase {
public:
    static constexpr uint32_t MAX_SOURCE = 64u * 1024u;  
    static constexpr uint16_t MAX_ROWS = 600;            

    void init(const char* title, const char* src, size_t len);

    void initPlain(const char* title, const char* src, size_t len);

    void appendParsed(const StyledLine& line);
 
    void render(bool partial) override;
    InputResult onKey(char key) override;
    InputResult onLongPress(char key) override;
    void onExit() override;
    const char* getName() const override { return "MarkdownView"; }
    const char* getFooterHint() const override;

    void selectMarker(uint16_t linkNum);

    enum class Interact : uint8_t { Link, Check, Submit, Image };

    struct InteractRef {
        uint16_t row;     
        Interact kind;
        uint16_t id;      
        uint32_t srcOff;  
    };

    void cycleInteractive(int dir);

    void clearSelection() { interactSel_ = -1; highlightRow_ = -1; dirty_ = true; }

    uint16_t interactiveCount() const { return interactCount_; }

    using CheckSaveFn = void (*)(void* ud, const char* cp437Source, size_t len);
    void setCheckSave(CheckSaveFn fn, void* ud) { checkSave_ = fn; checkSaveUd_ = ud; }
 
protected:
    virtual void rebuildInteractive();

    virtual void activateSelected();
 
    // Helpers for subclasses (avoid exposing the private Row type).
    uint16_t mdRowCount() const { return rowCount_; }
    void     mdRowInfo(uint16_t i, const char*& text, uint16_t& len, bool& first,
                       uint32_t& srcOff) const;
    void     addInteract(uint16_t row, Interact kind, uint16_t id, uint32_t srcOff);
    void     clearInteract() { interactCount_ = 0; interactSel_ = -1; }
    const InteractRef* selectedRef() const;
    bool     flipCheckChar(uint32_t srcOff);
    void     fireCheckSave();
 
private:
    static constexpr uint16_t MAX_TITLE_LEN = 64;
    static constexpr uint16_t MAX_INTERACT = 256;
    static constexpr size_t   kLinkPoolCap = 8192;  
 
    struct Row {
        const char* text;  
        uint16_t len;
        uint8_t font;    
        uint8_t indent;  
        MdLineKind kind;
        bool inverted;
        bool first;  
    };
 
    char titleBuf_[MAX_TITLE_LEN];
    cdc::core::PsramUniquePtr<char> srcBuf_;
    cdc::core::PsramUniquePtr<Row> rows_;
    uint16_t rowCount_ = 0;
    uint16_t scrollRow_ = 0;
    bool truncated_ = false;
    bool plain_ = false;     
    int textAreaWidth_ = 0;
    int highlightRow_ = -1;  
 
    cdc::core::PsramUniquePtr<InteractRef> interact_;
    uint16_t interactCount_ = 0;
    int interactSel_ = -1;
    CheckSaveFn checkSave_ = nullptr;
    void* checkSaveUd_ = nullptr;
 
    // Markdown inline-link targets: the rewrite replaces "[text](url)" with the
    // delimited form "\x10text\x11" and records each url here, indexed by the
    // delimiter's document order (matches the ordinal scanned in rebuildInteractive).
    cdc::core::PsramUniquePtr<char>     linkPool_;     
    cdc::core::PsramUniquePtr<uint16_t> linkUrlOff_;   
    uint16_t linkPoolLen_ = 0;
    uint16_t inlineLinkCount_ = 0;
 
    void addRow(const char* text, uint16_t len, uint8_t font, uint8_t indent,
                MdLineKind kind, bool inverted, bool first);
    uint16_t visibleRowCount() const;
    void rewriteInlineLinks();  
    void drawStyledRow(void* gfx, const char* text, uint16_t len, int x, int yTop,
                       uint16_t fg);  
};

MarkdownView* showMarkdown(const char* title, const char* src, size_t len);

MarkdownView* showPlainText(const char* title, const char* src, size_t len);
 
} // namespace cdc::ui