MarkdownANSI.hpp

浏览该文件的文档.

 
 
#pragma once
 
#include "AstGlobal.h"
#include "AstUtil/StringView.hpp"
#include "MarkdownSax.hpp"
#include <string>
#include <vector>
 
AST_NAMESPACE_BEGIN
 
class AST_UTIL_API MarkdownANSI final : public MarkdownSax
{
public:
    MarkdownANSI() = default;
    ~MarkdownANSI() override = default;
 
    // 文档生命周期
    void startDocument() override;
    void endDocument() override;
 
    // 块级元素
    void startHeading(int level) override;
    void endHeading(int level) override;
 
    void startParagraph() override;
    void endParagraph() override;
 
    void startCodeBlock(StringView language) override;
    void codeLine(StringView line) override;  // 代码行
    void endCodeBlock() override;
 
    void startList(bool ordered) override;   // true: 有序, false: 无序
    void startListItem() override;
    void endListItem() override;
    void endList() override;
 
    void startBlockquote() override;
    void endBlockquote() override;
 
    void horizontalRule() override;
 
    // void newline(bool force = false) override;
 
    // 表格
    void startTable() override;
    void startTableHead() override;
    void endTableHead() override;
    void startTableBody() override;
    void endTableBody() override;
    void startTableRow() override;
    void endTableRow() override;
    void startTableCell(ETableAlign align) override;
    void endTableCell() override;
    void endTable() override;
 
    // 行内元素
    void text(StringView txt) override;
    void startEmphasis() override;     // 斜体
    void endEmphasis() override;
    void startStrong() override;       // 粗体
    void endStrong() override;
    void startDelete() override;         // 删除线
    void endDelete() override;
    void codeSpan(StringView code) override;
    void startLink(StringView url) override;
    void endLink() override;
    void image(StringView alt, StringView url) override;
 
public:
    std::string& output() { return output_; }
    const std::string& output() const { return output_; }
    void clearOutput() { output_.clear(); }
 
    void setTableTruncate(bool enable) { truncateCells_ = enable; }
    bool isTableTruncate() const { return truncateCells_; }
 
private:
    // ---- ANSI 辅助 ----
    void emitActiveStyles();
    void emitStyleTransition(int oldStyles, int newStyles);
    void emitBlockPrefix();
    void outputCodeBlockGutter(int lineNum);
 
    std::string& curBuf() { return inCell_ ? cellContent_ : output_; }
 
    A_DISABLE_COPY(MarkdownANSI);
 
    // ---- 行内样式位掩码 ----
    enum InlineStyle : int
    {
        STYLE_NONE   = 0,
        STYLE_BOLD   = 1 << 0,  
        STYLE_ITALIC = 1 << 1,  
        STYLE_LINK   = 1 << 2,  
        STYLE_DELETE = 1 << 3,  
    };
 
    // ---- 块级元素帧（仅用于块引用嵌套跟踪） ----
    struct BlockFrame
    {
        enum Type { QUOTE };
        BlockFrame() = default;
        BlockFrame(Type type) : type(type) {}
        Type type = QUOTE;
    };
 
    // ---- 输出缓冲 ----
    std::string output_;
 
    // ---- 行内状态 ----
    int activeStyles_ = STYLE_NONE;
 
    // ---- 块级状态 ----
    std::vector<BlockFrame> blockStack_;
 
    struct ListFrame
    {
        bool ordered;       
        int  itemNumber;    
    };
    std::vector<ListFrame> listStack_;
 
    bool inCodeBlock_    = false;
    int  codeLineNumber_ = 0;
 
    // ---- 表格缓冲 ----
    struct CellData
    {
        std::string rendered;   
        int         width = 0;  
        ETableAlign align = ETableAlign::eDefault;
    };
    struct RowData
    {
        std::vector<CellData> cells;
        bool isHeader = false;
    };
 
    bool   inTable_       = false;   
    bool   inTableHead_   = false;   
    bool   inCell_        = false;   
    ETableAlign cellAlign_ = ETableAlign::eDefault;  
    std::string cellContent_;        
    bool   truncateCells_ = true;     
    RowData currentRow_;             
    std::vector<RowData> tableRows_; 
 
    // ---- 链接状态 ----
    std::string linkUrl_;
};
 
AST_NAMESPACE_END