@incremark/core 0.2.6 → 0.2.7

package/dist/index-CfgnWMWh.d.ts

@@ -0,0 +1,225 @@
+import { Parent, RootContent, Root, Definition, FootnoteDefinition } from 'mdast';
+import { Extension } from 'micromark-util-types';
+import { Extension as Extension$1 } from 'mdast-util-from-markdown';
+
+declare module 'mdast' {
+    interface RootContentMap {
+        htmlElement: HtmlElementNode;
+    }
+    interface PhrasingContentMap {
+        htmlElement: HtmlElementNode;
+    }
+}
+/**
+ * 自定义 HTML 元素节点类型
+ */
+interface HtmlElementNode extends Parent {
+    type: 'htmlElement';
+    tagName: string;
+    attrs: Record<string, string>;
+    children: RootContent[];
+    data?: {
+        rawHtml?: string;
+        parsed?: boolean;
+        originalType?: string;
+    };
+}
+/**
+ * HTML 树扩展配置
+ */
+interface HtmlTreeExtensionOptions {
+    /**
+     * 标签黑名单 - 这些标签会被过滤掉（XSS 防护）
+     * 默认包含危险标签：script, style, iframe, object, embed, form, input, button, textarea, select
+     */
+    tagBlacklist?: string[];
+    /**
+     * 属性黑名单 - 这些属性会被过滤掉（XSS 防护）
+     * 默认包含所有 on* 事件属性和 javascript: 协议
+     */
+    attrBlacklist?: string[];
+    /**
+     * 协议黑名单 - URL 属性中禁止的协议
+     * 默认包含 javascript:, vbscript:, data: (允许 data:image/)
+     */
+    protocolBlacklist?: string[];
+    /**
+     * 是否保留原始 HTML 在 data 中
+     * 默认为 true
+     */
+    preserveRawHtml?: boolean;
+    /**
+     * 自定义标签处理器
+     * 可以对特定标签进行自定义处理
+     */
+    tagHandlers?: Record<string, (node: HtmlElementNode) => HtmlElementNode | null>;
+}
+
+/**
+ * Definition 映射类型
+ */
+interface DefinitionMap {
+    [identifier: string]: Definition;
+}
+interface FootnoteDefinitionMap {
+    [identifier: string]: FootnoteDefinition;
+}
+/**
+ * 解析块的状态
+ */
+type BlockStatus = 'pending' | 'completed';
+/**
+ * AST 节点的通用接口（用于遍历）
+ * 统一定义，避免各模块重复声明
+ */
+interface AstNode {
+    type: string;
+    value?: string;
+    children?: AstNode[];
+    [key: string]: unknown;
+}
+/**
+ * 解析出的块
+ */
+interface ParsedBlock {
+    /** 块的唯一 ID */
+    id: string;
+    /** 块状态 */
+    status: BlockStatus;
+    /** AST 节点 */
+    node: RootContent;
+    /** 原始文本起始位置（相对于完整文档） */
+    startOffset: number;
+    /** 原始文本结束位置 */
+    endOffset: number;
+    /** 原始文本内容 */
+    rawText: string;
+}
+/**
+ * 增量更新事件
+ */
+interface IncrementalUpdate {
+    /** 新完成的块 */
+    completed: ParsedBlock[];
+    /** 更新的块（内容变化） */
+    updated: ParsedBlock[];
+    /** 当前正在解析中的块（可能不完整） */
+    pending: ParsedBlock[];
+    /** 完整的 AST（包含所有已解析的内容） */
+    ast: Root;
+    /** Definition 映射表（用于引用式图片和链接） */
+    definitions: DefinitionMap;
+    /** Footnote Definition 映射表 */
+    footnoteDefinitions: FootnoteDefinitionMap;
+    /** 脚注引用的出现顺序（用于渲染时排序） */
+    footnoteReferenceOrder: string[];
+}
+/**
+ * 容器语法配置
+ */
+interface ContainerConfig {
+    /** 容器标记字符，默认 ':' */
+    marker?: string;
+    /** 最小标记长度，默认 3 */
+    minMarkerLength?: number;
+    /** 允许的容器名称（如 ['warning', 'info', 'youtube']），undefined 表示允许所有 */
+    allowedNames?: string[];
+}
+/**
+ * 解析器状态变化事件
+ */
+interface ParserState {
+    /** 已完成的块 */
+    completedBlocks: ParsedBlock[];
+    /** 待处理的块 */
+    pendingBlocks: ParsedBlock[];
+    /** 完整的 Markdown 内容 */
+    markdown: string;
+    /** 完整的 AST */
+    ast: Root;
+    definitions: DefinitionMap;
+    footnoteDefinitions: FootnoteDefinitionMap;
+}
+/**
+ * 解析器配置
+ */
+interface ParserOptions {
+    /** 启用 GFM 扩展（表格、任务列表等） */
+    gfm?: boolean;
+    /**
+     * 启用数学公式支持（$..$ 行内公式和 $$...$$ 块级公式）
+     * - false/undefined: 禁用（默认）
+     * - true: 启用数学公式解析
+     */
+    math?: boolean;
+    /**
+     * 启用 ::: 容器语法支持（用于边界检测）
+     * - false: 禁用（默认）
+     * - true: 使用默认配置启用
+     * - ContainerConfig: 使用自定义配置启用
+     */
+    containers?: boolean | ContainerConfig;
+    /**
+     * 启用 HTML 树转换
+     * - false/undefined: 禁用（默认），HTML 节点保持原始 type: 'html' 格式
+     * - true: 使用默认配置启用，将 HTML 节点转换为结构化的 htmlElement 节点
+     * - HtmlTreeExtensionOptions: 使用自定义配置启用（可配置黑名单等）
+     */
+    htmlTree?: boolean | HtmlTreeExtensionOptions;
+    /** 自定义块边界检测函数 */
+    blockBoundaryDetector?: (content: string, position: number) => boolean;
+    /** 自定义 micromark 扩展（如 directive） */
+    extensions?: Extension[];
+    /** 自定义 mdast 扩展（如 directiveFromMarkdown） */
+    mdastExtensions?: Extension$1[];
+    /** 状态变化回调 */
+    onChange?: (state: ParserState) => void;
+}
+/**
+ * 块上下文
+ */
+interface BlockContext {
+    /** 当前是否在代码块中 */
+    inFencedCode: boolean;
+    /** 代码块的 fence 字符（` 或 ~） */
+    fenceChar?: string;
+    /** 代码块的 fence 长度 */
+    fenceLength?: number;
+    /** 当前列表嵌套深度 */
+    listDepth: number;
+    /** 当前引用嵌套深度 */
+    blockquoteDepth: number;
+    /** 当前是否在容器块中 */
+    inContainer: boolean;
+    /** 容器的标记长度 */
+    containerMarkerLength?: number;
+    /** 容器名称 */
+    containerName?: string;
+    /** 容器嵌套深度（支持嵌套容器） */
+    containerDepth: number;
+    /** 当前是否在列表中 */
+    inList: boolean;
+    /** 当前列表是否是有序列表 */
+    listOrdered?: boolean;
+    /** 当前列表的基础缩进 */
+    listIndent?: number;
+    /** 遇到空行后，列表可能结束（等待下一行确认） */
+    listMayEnd?: boolean;
+    /** 当前是否在脚注定义中 */
+    inFootnote?: boolean;
+    /** 脚注标识符 */
+    footnoteIdentifier?: string;
+}
+/**
+ * 容器检测结果
+ */
+interface ContainerMatch {
+    /** 容器名称 */
+    name: string;
+    /** 标记长度（冒号数量） */
+    markerLength: number;
+    /** 是否是结束标记 */
+    isEnd: boolean;
+}
+
+export type { AstNode as A, BlockStatus as B, ContainerConfig as C, DefinitionMap as D, FootnoteDefinitionMap as F, IncrementalUpdate as I, ParserOptions as P, ParsedBlock as a, ParserState as b, BlockContext as c, ContainerMatch as d };

package/dist/index.d.ts

@@ -1,8 +1,7 @@
-import { P as ParserOptions, I as IncrementalUpdate, a as ParsedBlock, D as DefinitionMap, F as FootnoteDefinitionMap, b as ParserState, B as BlockStatus } from './index-BMUkM7mT.js';
-export { A as AstNode, c as BlockContext, e as BlockTypeInfo, C as ContainerConfig, d as ContainerMatch, J as HTML_ATTR_BLACKLIST, K as HTML_PROTOCOL_BLACKLIST, H as HTML_TAG_BLACKLIST, N as HtmlAttrInfo, R as HtmlContentType, M as HtmlElementNode, Q as HtmlTreeExtensionOptions, O as ParsedHtmlTag, s as createHtmlTreeTransformer, r as createInitialContext, o as detectContainer, p as detectContainerEnd, g as detectFenceEnd, f as detectFenceStart, x as detectHtmlContentType, E as findHtmlElementsByTag, G as htmlElementToString, L as htmlTreeExtension, q as isBlockBoundary, l as isBlockquoteStart, i as isEmptyLine, h as isHeading, m as isHtmlBlock, y as isHtmlElementNode, k as isListItemStart, n as isTableDelimiter, j as isThematicBreak, w as parseHtmlFragment, v as parseHtmlTag, t as transformHtmlNodes, u as updateContext, z as walkHtmlElements } from './index-BMUkM7mT.js';
+import { P as ParserOptions, I as IncrementalUpdate, a as ParsedBlock, D as DefinitionMap, F as FootnoteDefinitionMap, b as ParserState, B as BlockStatus } from './index-CfgnWMWh.js';
+export { A as AstNode } from './index-CfgnWMWh.js';
 import { Root, RootContent, Text } from 'mdast';
 export { Root, RootContent } from 'mdast';
-export { calculateLineOffset, generateId, joinLines, resetIdCounter, splitLines } from './utils/index.js';
 import 'micromark-util-types';
 import 'mdast-util-from-markdown';
 
@@ -16,33 +15,22 @@ declare class IncremarkParser {
     private blockIdCounter;
     private context;
     private options;
-    /** 缓存的容器配置，避免重复计算 */
-    private readonly containerConfig;
-    /** 缓存的 HTML 树配置，避免重复计算 */
-    private readonly htmlTreeConfig;
+    /** 边界检测器 */
+    private readonly boundaryDetector;
+    /** AST 构建器 */
+    private readonly astBuilder;
+    /** Definition 管理器 */
+    private readonly definitionManager;
+    /** Footnote 管理器 */
+    private readonly footnoteManager;
     /** 上次 append 返回的 pending blocks，用于 getAst 复用 */
     private lastPendingBlocks;
-    /** Definition 映射表（用于引用式图片和链接） */
-    private definitionMap;
-    /** Footnote Definition 映射表 */
-    private footnoteDefinitionMap;
-    /** Footnote Reference 出现顺序（按引用在文档中的顺序） */
-    private footnoteReferenceOrder;
     constructor(options?: ParserOptions);
     private generateBlockId;
-    private computeContainerConfig;
-    private computeHtmlTreeConfig;
     /**
-     * 将 HTML 节点转换为纯文本
-     * 递归处理 AST 中所有 html 类型的节点
-     * - 块级 HTML 节点 → 转换为 paragraph 包含 text
-     * - 内联 HTML 节点（在段落内部）→ 转换为 text 节点
+     * 更新已完成的 blocks 中的 definitions 和 footnote definitions
      */
-    private convertHtmlToText;
-    private parse;
     private updateDefinitionsFromCompletedBlocks;
-    private findDefinition;
-    private findFootnoteDefinition;
     /**
      * 收集 AST 中的脚注引用（按出现顺序）
      * 用于确定脚注的显示顺序
@@ -62,23 +50,6 @@ declare class IncremarkParser {
      * 返回稳定边界行号和该行对应的上下文（用于后续更新，避免重复计算）
      */
     private findStableBoundary;
-    private checkStability;
-    /**
-     * 从指定行向上查找脚注定义的起始行
-     *
-     * @param fromLine 开始查找的行索引
-     * @returns 脚注起始行索引，如果不属于脚注返回 -1
-     *
-     * @example
-     * // 假设 lines 为:
-     * // 0: "[^1]: 第一行"
-     * // 1: "    第二行"
-     * // 2: "    第三行"
-     * findFootnoteStart(2) // 返回 0
-     * findFootnoteStart(1) // 返回 0
-     */
-    private findFootnoteStart;
-    private nodesToBlocks;
     /**
      * 追加新的 chunk 并返回增量更新
      */