@incremark/core 0.2.6 → 0.3.0

package/dist/types-C_EW5vfp.d.ts

@@ -0,0 +1,123 @@
+import { Root, RootContent } from 'mdast';
+import { Extension } from 'micromark-util-types';
+import { Extension as Extension$1 } from 'mdast-util-from-markdown';
+import { MarkedExtension } from 'marked';
+import { b as ParserOptions, C as ContainerConfig, B as BlockStatus, P as ParsedBlock } from './index-mZ7yCqNH.js';
+
+/**
+ * AST 构建器统一接口和类型定义
+ *
+ * 支持两种引擎：
+ * - marked: 极速模式，速度更快
+ * - micromark: 稳定模式，更可靠，支持 div 内嵌 markdown
+ */
+
+/**
+ * 引擎类型
+ */
+type EngineType = 'marked' | 'micromark';
+/**
+ * AST 构建器接口
+ * 所有引擎实现必须遵循此接口
+ */
+interface IAstBuilder {
+    /** 容器配置（用于边界检测） */
+    readonly containerConfig: ContainerConfig | undefined;
+    /**
+     * 解析文本为 AST
+     * @param text Markdown 文本
+     * @returns AST
+     */
+    parse(text: string): Root;
+    /**
+     * 将 AST 节点转换为 ParsedBlock
+     */
+    nodesToBlocks(nodes: RootContent[], startOffset: number, rawText: string, status: BlockStatus, generateBlockId: () => string): ParsedBlock[];
+}
+/**
+ * Marked 引擎扩展配置
+ */
+interface MarkedEngineExtension {
+    /** marked 扩展列表 */
+    extensions: MarkedExtension[];
+}
+/**
+ * Micromark 引擎扩展配置
+ */
+interface MicromarkEngineExtension {
+    /** micromark 语法扩展 */
+    extensions: Extension[];
+    /** mdast 转换扩展 */
+    mdastExtensions: Extension$1[];
+}
+/**
+ * 统一插件格式
+ *
+ * 插件可以同时支持多个引擎，运行时会根据当前引擎选择对应配置
+ *
+ * @example
+ * ```ts
+ * const myPlugin: IncremarkPlugin = {
+ *   name: 'my-plugin',
+ *   type: 'both', // 支持两种引擎
+ *   marked: {
+ *     extensions: [myMarkedExtension]
+ *   },
+ *   micromark: {
+ *     extensions: [myMicromarkExt],
+ *     mdastExtensions: [myMdastExt]
+ *   }
+ * }
+ * ```
+ */
+interface IncremarkPlugin {
+    /** 插件名称 */
+    name: string;
+    /**
+     * 插件支持的引擎类型
+     * - 'marked': 仅支持 marked 引擎
+     * - 'micromark': 仅支持 micromark 引擎
+     * - 'both': 同时支持两种引擎
+     */
+    type: 'marked' | 'micromark' | 'both';
+    /**
+     * Marked 引擎配置
+     * 当 type 为 'marked' 或 'both' 时必须提供
+     */
+    marked?: MarkedEngineExtension;
+    /**
+     * Micromark 引擎配置
+     * 当 type 为 'micromark' 或 'both' 时必须提供
+     */
+    micromark?: MicromarkEngineExtension;
+}
+/**
+ * 引擎特定的解析器选项
+ *
+ * 注意：不再包含 engine 选项，引擎切换通过注入 astBuilder 类实现
+ * 这样可以确保 tree-shaking 正常工作
+ */
+interface EngineParserOptions extends Omit<ParserOptions, 'extensions' | 'mdastExtensions'> {
+    /**
+     * 统一插件列表
+     * 插件会根据当前引擎自动选择对应的扩展配置
+     */
+    plugins?: IncremarkPlugin[];
+    /**
+     * Micromark 扩展（仅 micromark 引擎使用）
+     * @deprecated 建议使用 plugins 统一配置
+     */
+    extensions?: Extension[];
+    /**
+     * Mdast 扩展（仅 micromark 引擎使用）
+     * @deprecated 建议使用 plugins 统一配置
+     */
+    mdastExtensions?: Extension$1[];
+    /**
+     * Marked 扩展（仅 marked 引擎使用）
+     * @deprecated 建议使用 plugins 统一配置
+     */
+    markedExtensions?: MarkedExtension[];
+}
+
+export type { EngineParserOptions as E, IAstBuilder as I, MarkedEngineExtension as M, EngineType as a, IncremarkPlugin as b, MicromarkEngineExtension as c };

package/dist/utils/index.d.ts

@@ -23,5 +23,21 @@ declare function splitLines(text: string): string[];
 declare function joinLines(lines: string[], start: number, end: number): string;
 declare function isDefinitionNode(node: RootContent): node is Definition;
 declare function isFootnoteDefinitionNode(node: RootContent): node is FootnoteDefinition;
+/**
+ * AST 节点遍历器
+ * 深度优先遍历 AST 节点
+ *
+ * @param node 起始节点
+ * @param visitor 访问者函数，返回 true 可以提前终止遍历
+ */
+declare function traverseAst(node: RootContent, visitor: (node: RootContent) => boolean | void): void;
+/**
+ * 从 AST 节点中收集指定类型的节点
+ *
+ * @param node 起始节点
+ * @param predicate 匹配谓词
+ * @returns 匹配的节点列表
+ */
+declare function collectAstNodes<T extends RootContent>(node: RootContent, predicate: (node: RootContent) => node is T): T[];
 
-export { calculateLineOffset, generateId, isDefinitionNode, isFootnoteDefinitionNode, joinLines, resetIdCounter, splitLines };
+export { calculateLineOffset, collectAstNodes, generateId, isDefinitionNode, isFootnoteDefinitionNode, joinLines, resetIdCounter, splitLines, traverseAst };

package/dist/utils/index.js

@@ -25,7 +25,27 @@ function isDefinitionNode(node) {
 function isFootnoteDefinitionNode(node) {
   return node.type === "footnoteDefinition";
 }
+function traverseAst(node, visitor) {
+  const stopEarly = visitor(node);
+  if (stopEarly === true) {
+    return;
+  }
+  if ("children" in node && Array.isArray(node.children)) {
+    for (const child of node.children) {
+      traverseAst(child, visitor);
+    }
+  }
+}
+function collectAstNodes(node, predicate) {
+  const results = [];
+  traverseAst(node, (node2) => {
+    if (predicate(node2)) {
+      results.push(node2);
+    }
+  });
+  return results;
+}
 
-export { calculateLineOffset, generateId, isDefinitionNode, isFootnoteDefinitionNode, joinLines, resetIdCounter, splitLines };
+export { calculateLineOffset, collectAstNodes, generateId, isDefinitionNode, isFootnoteDefinitionNode, joinLines, resetIdCounter, splitLines, traverseAst };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/index.ts"],"names":[],"mappings":";AASA,IAAI,SAAA,GAAY,CAAA;AACT,SAAS,UAAA,CAAW,SAAS,OAAA,EAAiB;AACnD,EAAA,OAAO,CAAA,EAAG,MAAM,CAAA,CAAA,EAAI,EAAE,SAAS,CAAA,CAAA;AACjC;AAKO,SAAS,cAAA,GAAuB;AACrC,EAAA,SAAA,GAAY,CAAA;AACd;AAKO,SAAS,mBAAA,CAAoB,OAAiB,SAAA,EAA2B;AAC9E,EAAA,IAAI,MAAA,GAAS,CAAA;AACb,EAAA,KAAA,IAAS,IAAI,CAAA,EAAG,CAAA,GAAI,aAAa,CAAA,GAAI,KAAA,CAAM,QAAQ,CAAA,EAAA,EAAK;AACtD,IAAA,MAAA,IAAU,KAAA,CAAM,CAAC,CAAA,CAAE,MAAA,GAAS,CAAA;AAAA,EAC9B;AACA,EAAA,OAAO,MAAA;AACT;AAKO,SAAS,WAAW,IAAA,EAAwB;AACjD,EAAA,OAAO,IAAA,CAAK,MAAM,IAAI,CAAA;AACxB;AAKO,SAAS,SAAA,CAAU,KAAA,EAAiB,KAAA,EAAe,GAAA,EAAqB;AAC7E,EAAA,OAAO,MAAM,KAAA,CAAM,KAAA,EAAO,MAAM,CAAC,CAAA,CAAE,KAAK,IAAI,CAAA;AAC9C;AAEO,SAAS,iBAAiB,IAAA,EAAuC;AACtE,EAAA,OAAO,KAAK,IAAA,KAAS,YAAA;AACvB;AAEO,SAAS,yBAAyB,IAAA,EAA+C;AACtF,EAAA,OAAO,KAAK,IAAA,KAAS,oBAAA;AACvB","file":"index.js","sourcesContent":["/**\n * 工具函数\n */\n\nimport type { Definition, FootnoteDefinition, RootContent } from \"mdast\"\n\n/**\n * 生成唯一 ID\n */\nlet idCounter = 0\nexport function generateId(prefix = 'block'): string {\n  return `${prefix}-${++idCounter}`\n}\n\n/**\n * 重置 ID 计数器（用于测试）\n */\nexport function resetIdCounter(): void {\n  idCounter = 0\n}\n\n/**\n * 计算行的偏移量\n */\nexport function calculateLineOffset(lines: string[], lineIndex: number): number {\n  let offset = 0\n  for (let i = 0; i < lineIndex && i < lines.length; i++) {\n    offset += lines[i].length + 1 // +1 for newline\n  }\n  return offset\n}\n\n/**\n * 将文本按行分割\n */\nexport function splitLines(text: string): string[] {\n  return text.split('\\n')\n}\n\n/**\n * 合并行为文本\n */\nexport function joinLines(lines: string[], start: number, end: number): string {\n  return lines.slice(start, end + 1).join('\\n')\n}\n\nexport function isDefinitionNode(node: RootContent): node is Definition {\n  return node.type === 'definition'\n}\n\nexport function isFootnoteDefinitionNode(node: RootContent): node is FootnoteDefinition {\n  return node.type === 'footnoteDefinition'\n}"]}
+{"version":3,"sources":["../../src/utils/index.ts"],"names":["node"],"mappings":";AASA,IAAI,SAAA,GAAY,CAAA;AACT,SAAS,UAAA,CAAW,SAAS,OAAA,EAAiB;AACnD,EAAA,OAAO,CAAA,EAAG,MAAM,CAAA,CAAA,EAAI,EAAE,SAAS,CAAA,CAAA;AACjC;AAKO,SAAS,cAAA,GAAuB;AACrC,EAAA,SAAA,GAAY,CAAA;AACd;AAKO,SAAS,mBAAA,CAAoB,OAAiB,SAAA,EAA2B;AAC9E,EAAA,IAAI,MAAA,GAAS,CAAA;AACb,EAAA,KAAA,IAAS,IAAI,CAAA,EAAG,CAAA,GAAI,aAAa,CAAA,GAAI,KAAA,CAAM,QAAQ,CAAA,EAAA,EAAK;AACtD,IAAA,MAAA,IAAU,KAAA,CAAM,CAAC,CAAA,CAAE,MAAA,GAAS,CAAA;AAAA,EAC9B;AACA,EAAA,OAAO,MAAA;AACT;AAKO,SAAS,WAAW,IAAA,EAAwB;AACjD,EAAA,OAAO,IAAA,CAAK,MAAM,IAAI,CAAA;AACxB;AAKO,SAAS,SAAA,CAAU,KAAA,EAAiB,KAAA,EAAe,GAAA,EAAqB;AAC7E,EAAA,OAAO,MAAM,KAAA,CAAM,KAAA,EAAO,MAAM,CAAC,CAAA,CAAE,KAAK,IAAI,CAAA;AAC9C;AAEO,SAAS,iBAAiB,IAAA,EAAuC;AACtE,EAAA,OAAO,KAAK,IAAA,KAAS,YAAA;AACvB;AAEO,SAAS,yBAAyB,IAAA,EAA+C;AACtF,EAAA,OAAO,KAAK,IAAA,KAAS,oBAAA;AACvB;AASO,SAAS,WAAA,CACd,MACA,OAAA,EACM;AAEN,EAAA,MAAM,SAAA,GAAY,QAAQ,IAAI,CAAA;AAC9B,EAAA,IAAI,cAAc,IAAA,EAAM;AACtB,IAAA;AAAA,EACF;AAGA,EAAA,IAAI,cAAc,IAAA,IAAQ,KAAA,CAAM,OAAA,CAAQ,IAAA,CAAK,QAAQ,CAAA,EAAG;AACtD,IAAA,KAAA,MAAW,KAAA,IAAS,KAAK,QAAA,EAAU;AACjC,MAAA,WAAA,CAAY,OAAsB,OAAO,CAAA;AAAA,IAC3C;AAAA,EACF;AACF;AASO,SAAS,eAAA,CACd,MACA,SAAA,EACK;AACL,EAAA,MAAM,UAAe,EAAC;AAEtB,EAAA,WAAA,CAAY,IAAA,EAAM,CAACA,KAAAA,KAAS;AAC1B,IAAA,IAAI,SAAA,CAAUA,KAAI,CAAA,EAAG;AACnB,MAAA,OAAA,CAAQ,KAAKA,KAAI,CAAA;AAAA,IACnB;AAAA,EACF,CAAC,CAAA;AAED,EAAA,OAAO,OAAA;AACT","file":"index.js","sourcesContent":["/**\n * 工具函数\n */\n\nimport type { Definition, FootnoteDefinition, RootContent } from \"mdast\"\n\n/**\n * 生成唯一 ID\n */\nlet idCounter = 0\nexport function generateId(prefix = 'block'): string {\n  return `${prefix}-${++idCounter}`\n}\n\n/**\n * 重置 ID 计数器（用于测试）\n */\nexport function resetIdCounter(): void {\n  idCounter = 0\n}\n\n/**\n * 计算行的偏移量\n */\nexport function calculateLineOffset(lines: string[], lineIndex: number): number {\n  let offset = 0\n  for (let i = 0; i < lineIndex && i < lines.length; i++) {\n    offset += lines[i].length + 1 // +1 for newline\n  }\n  return offset\n}\n\n/**\n * 将文本按行分割\n */\nexport function splitLines(text: string): string[] {\n  return text.split('\\n')\n}\n\n/**\n * 合并行为文本\n */\nexport function joinLines(lines: string[], start: number, end: number): string {\n  return lines.slice(start, end + 1).join('\\n')\n}\n\nexport function isDefinitionNode(node: RootContent): node is Definition {\n  return node.type === 'definition'\n}\n\nexport function isFootnoteDefinitionNode(node: RootContent): node is FootnoteDefinition {\n  return node.type === 'footnoteDefinition'\n}\n\n/**\n * AST 节点遍历器\n * 深度优先遍历 AST 节点\n *\n * @param node 起始节点\n * @param visitor 访问者函数，返回 true 可以提前终止遍历\n */\nexport function traverseAst(\n  node: RootContent,\n  visitor: (node: RootContent) => boolean | void\n): void {\n  // 访问当前节点\n  const stopEarly = visitor(node)\n  if (stopEarly === true) {\n    return\n  }\n\n  // 递归遍历子节点\n  if ('children' in node && Array.isArray(node.children)) {\n    for (const child of node.children) {\n      traverseAst(child as RootContent, visitor)\n    }\n  }\n}\n\n/**\n * 从 AST 节点中收集指定类型的节点\n *\n * @param node 起始节点\n * @param predicate 匹配谓词\n * @returns 匹配的节点列表\n */\nexport function collectAstNodes<T extends RootContent>(\n  node: RootContent,\n  predicate: (node: RootContent) => node is T\n): T[] {\n  const results: T[] = []\n\n  traverseAst(node, (node) => {\n    if (predicate(node)) {\n      results.push(node)\n    }\n  })\n\n  return results\n}"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@incremark/core",
-  "version": "0.2.6",
-  "description": "增量式 Markdown 解析器核心库",
+  "version": "0.3.0",
+  "description": "High-performance incremental markdown parser specifically designed for AI streaming output scenarios.",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -18,6 +18,14 @@
     "./utils": {
       "types": "./dist/utils/index.d.ts",
       "import": "./dist/utils/index.js"
+    },
+    "./engines/marked": {
+      "types": "./dist/engines/marked/index.d.ts",
+      "import": "./dist/engines/marked/index.js"
+    },
+    "./engines/micromark": {
+      "types": "./dist/engines/micromark/index.d.ts",
+      "import": "./dist/engines/micromark/index.js"
     }
   },
   "files": [
@@ -27,6 +35,7 @@
     "@types/lodash-es": "^4.17.12",
     "@types/mdast": "^4.0.0",
     "lodash-es": "^4.17.22",
+    "marked": "^17.0.1",
     "mdast-util-directive": "^3.0.0",
     "mdast-util-from-markdown": "^2.0.0",
     "mdast-util-gfm": "^3.0.0",
@@ -55,8 +64,13 @@
     "incremental",
     "streaming",
     "ai",
+    "chatgpt",
+    "llm",
     "mdast",
-    "unified"
+    "high-performance",
+    "typewriter",
+    "micromark",
+    "marked"
   ],
   "license": "MIT",
   "repository": {
@@ -70,6 +84,7 @@
     "dev": "tsup --watch",
     "test": "vitest",
     "test:run": "vitest run",
+    "test:coverage": "vitest run -- --coverage",
     "benchmark": "npx tsx src/benchmark/run.ts"
   }
 }

package/dist/index-BMUkM7mT.d.ts

@@ -1,422 +0,0 @@
-import { Parent, RootContent, Root, Definition, FootnoteDefinition } from 'mdast';
-import { Extension as Extension$1 } from 'micromark-util-types';
-import { Extension } 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 HtmlAttrInfo {
-    name: string;
-    value: string;
-}
-/**
- * 解析后的 HTML 标签信息
- */
-interface ParsedHtmlTag {
-    tagName: string;
-    attrs: Record<string, string>;
-    isClosing: boolean;
-    isSelfClosing: boolean;
-    rawHtml: 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>;
-}
-/**
- * 危险标签黑名单（XSS 防护）
- */
-declare const DEFAULT_TAG_BLACKLIST: string[];
-/**
- * 危险属性黑名单（XSS 防护）
- * 包含所有 on* 事件属性
- */
-declare const DEFAULT_ATTR_BLACKLIST: string[];
-/**
- * 危险协议黑名单
- */
-declare const DEFAULT_PROTOCOL_BLACKLIST: string[];
-/**
- * HTML 内容类型
- */
-type HtmlContentType = 'opening' | 'closing' | 'self-closing' | 'fragment' | 'unknown';
-/**
- * 判断 HTML 内容的类型
- * - opening: 单个开标签，如 <span class="foo">
- * - closing: 单个闭标签，如 </span>
- * - self-closing: 自闭合标签，如 <br /> 或 <img src="...">
- * - fragment: 完整的 HTML 片段，包含多个标签
- * - unknown: 无法识别
- */
-declare function detectHtmlContentType(html: string): HtmlContentType;
-/**
- * 解析单个 HTML 标签（开标签、闭标签或自闭合标签）
- * 只处理单个标签，不处理完整的 HTML 片段
- */
-declare function parseHtmlTag(html: string): ParsedHtmlTag | null;
-/**
- * 解析完整的 HTML 片段为 AST
- */
-declare function parseHtmlFragment(html: string, options?: HtmlTreeExtensionOptions): HtmlElementNode[];
-/**
- * 转换整个 AST，处理所有 HTML 节点
- */
-declare function transformHtmlNodes(ast: Root, options?: HtmlTreeExtensionOptions): Root;
-/**
- * 创建 HTML 树转换器
- * 这是一个 unified 兼容的转换器
- */
-declare function createHtmlTreeTransformer(options?: HtmlTreeExtensionOptions): (tree: Root) => Root;
-/**
- * mdast-util-from-markdown 扩展
- * 注意：此扩展主要用于类型声明，实际转换在后处理阶段完成
- */
-declare const htmlTreeExtension: Extension;
-/**
- * 判断节点是否是 HtmlElementNode
- */
-declare function isHtmlElementNode(node: RootContent): node is HtmlElementNode;
-/**
- * 遍历所有 HTML 元素节点
- */
-declare function walkHtmlElements(node: RootContent | Root, callback: (node: HtmlElementNode, parent: Parent | Root | null) => void, parent?: Parent | Root | null): void;
-/**
- * 查找特定标签的所有节点
- */
-declare function findHtmlElementsByTag(root: Root, tagName: string): HtmlElementNode[];
-/**
- * 将 HtmlElementNode 转回 HTML 字符串
- */
-declare function htmlElementToString(node: HtmlElementNode): string;
-
-/**
- * Definition 映射类型
- */
-interface DefinitionMap {
-    [identifier: string]: Definition;
-}
-interface FootnoteDefinitionMap {
-    [identifier: string]: FootnoteDefinition;
-}
-/**
- * 解析块的状态
- */
-type BlockStatus = 'pending' | 'stable' | '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$1[];
-    /** 自定义 mdast 扩展（如 directiveFromMarkdown） */
-    mdastExtensions?: Extension[];
-    /** 状态变化回调 */
-    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;
-}
-/**
- * 块类型检测结果
- */
-interface BlockTypeInfo {
-    type: string;
-    /** 是否是容器节点（可以包含其他块） */
-    isContainer: boolean;
-    /** 是否需要显式关闭（如代码块） */
-    requiresClosing: boolean;
-    /** 关闭模式 */
-    closingPattern?: RegExp;
-}
-
-/**
- * 块类型检测与边界判断
- *
- * Markdown 块级元素的识别规则
- */
-
-/**
- * 检测行是否是代码块 fence 开始
- */
-declare function detectFenceStart(line: string): {
-    char: string;
-    length: number;
-} | null;
-/**
- * 检测行是否是代码块 fence 结束
- */
-declare function detectFenceEnd(line: string, context: BlockContext): boolean;
-/**
- * 检测是否是空行或仅包含空白字符
- */
-declare function isEmptyLine(line: string): boolean;
-/**
- * 检测是否是标题行
- */
-declare function isHeading(line: string): boolean;
-/**
- * 检测是否是 thematic break（水平线）
- */
-declare function isThematicBreak(line: string): boolean;
-/**
- * 检测是否是列表项开始
- *
- * CommonMark 规范：列表项可以是以下形式：
- * - `- text`（无缩进）
- * - `1. text`（有序列表）
- * - `    - text`（缩进4个空格，作为上一个列表项的延续）
- *
- * 注意：`    - text` 这种形式，虽然 `-` 后面没有空格，
- * 但因为前面有4个空格的缩进，所以是列表项的有效形式。
- */
-declare function isListItemStart(line: string): {
-    ordered: boolean;
-    indent: number;
-} | null;
-/**
- * 检测是否是引用块开始
- */
-declare function isBlockquoteStart(line: string): boolean;
-/**
- * 检测是否是 HTML 块
- */
-declare function isHtmlBlock(line: string): boolean;
-/**
- * 检测表格分隔行
- */
-declare function isTableDelimiter(line: string): boolean;
-/**
- * 检测是否是脚注定义的起始行
- * 格式: [^id]: content
- *
- * @example
- * isFootnoteDefinitionStart('[^1]: 脚注内容') // true
- * isFootnoteDefinitionStart('[^note]: 内容') // true
- * isFootnoteDefinitionStart('    缩进内容')   // false
- */
-declare function isFootnoteDefinitionStart(line: string): boolean;
-/**
- * 检测是否是脚注定义的延续行（缩进行）
- * 至少4个空格或1个tab
- *
- * @example
- * isFootnoteContinuation('    第二行')  // true
- * isFootnoteContinuation('\t第二行')    // true
- * isFootnoteContinuation('  两个空格')   // false
- */
-declare function isFootnoteContinuation(line: string): boolean;
-/**
- * 检测容器开始或结束
- *
- * 支持格式：
- * - ::: name      开始
- * - ::: name attr 开始（带属性）
- * - :::           结束
- * - :::::: name   开始（更长的标记，用于嵌套）
- */
-declare function detectContainer(line: string, config?: ContainerConfig): ContainerMatch | null;
-/**
- * 检测容器结束
- */
-declare function detectContainerEnd(line: string, context: BlockContext, config?: ContainerConfig): boolean;
-/**
- * 判断两行之间是否构成块边界
- */
-declare function isBlockBoundary(prevLine: string, currentLine: string, context: BlockContext): boolean;
-/**
- * 创建初始上下文
- */
-declare function createInitialContext(): BlockContext;
-/**
- * 更新上下文（处理一行后）
- */
-declare function updateContext(line: string, context: BlockContext, containerConfig?: ContainerConfig | boolean): BlockContext;
-
-export { type AstNode as A, type BlockStatus as B, type ContainerConfig as C, type DefinitionMap as D, findHtmlElementsByTag as E, type FootnoteDefinitionMap as F, htmlElementToString as G, DEFAULT_TAG_BLACKLIST as H, type IncrementalUpdate as I, DEFAULT_ATTR_BLACKLIST as J, DEFAULT_PROTOCOL_BLACKLIST as K, htmlTreeExtension as L, type HtmlElementNode as M, type HtmlAttrInfo as N, type ParsedHtmlTag as O, type ParserOptions as P, type HtmlTreeExtensionOptions as Q, type HtmlContentType as R, isFootnoteDefinitionStart as S, isFootnoteContinuation as T, type ParsedBlock as a, type ParserState as b, type BlockContext as c, type ContainerMatch as d, type BlockTypeInfo as e, detectFenceStart as f, detectFenceEnd as g, isHeading as h, isEmptyLine as i, isThematicBreak as j, isListItemStart as k, isBlockquoteStart as l, isHtmlBlock as m, isTableDelimiter as n, detectContainer as o, detectContainerEnd as p, isBlockBoundary as q, createInitialContext as r, createHtmlTreeTransformer as s, transformHtmlNodes as t, updateContext as u, parseHtmlTag as v, parseHtmlFragment as w, detectHtmlContentType as x, isHtmlElementNode as y, walkHtmlElements as z };