@incremark/core 0.2.6 → 0.3.0

package/dist/index.d.ts

@@ -1,13 +1,39 @@
-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 { I as IncrementalUpdate, P as ParsedBlock, D as DefinitionMap, F as FootnoteDefinitionMap, a as ParserState, B as BlockStatus } from './index-mZ7yCqNH.js';
+export { A as AstNode, b as ParserOptions } from './index-mZ7yCqNH.js';
+import { E as EngineParserOptions, I as IAstBuilder } from './types-C_EW5vfp.js';
+export { a as EngineType, b as IncremarkPlugin, M as MarkedEngineExtension, c as MicromarkEngineExtension } from './types-C_EW5vfp.js';
 import { Root, RootContent, Text } from 'mdast';
 export { Root, RootContent } from 'mdast';
-export { calculateLineOffset, generateId, joinLines, resetIdCounter, splitLines } from './utils/index.js';
+export { M as MarkedAstBuilder } from './MarkedAstBuildter-BsjxZko_.js';
 import 'micromark-util-types';
 import 'mdast-util-from-markdown';
+import 'marked';
 
+/**
+ * AST 构建器类型（用于注入）
+ */
+type AstBuilderClass = new (options: EngineParserOptions) => IAstBuilder;
+/**
+ * 扩展的解析器选项（支持注入自定义 AstBuilder）
+ */
+interface IncremarkParserOptions extends EngineParserOptions {
+    /**
+     * 自定义 AST 构建器类
+     *
+     * 用于注入不同的引擎实现，实现 tree-shaking
+     *
+     * @example
+     * ```ts
+     * // 使用 micromark 引擎
+     * import { MicromarkAstBuilder } from '@incremark/core/engines/micromark'
+     * const parser = createIncremarkParser({
+     *   astBuilder: MicromarkAstBuilder
+     * })
+     * ```
+     */
+    astBuilder?: AstBuilderClass;
+}
 declare class IncremarkParser {
-    private buffer;
     private lines;
     /** 行偏移量前缀和：lineOffsets[i] = 第i行起始位置的偏移量 */
     private lineOffsets;
@@ -16,41 +42,25 @@ 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);
+    constructor(options?: IncremarkParserOptions);
     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 中的脚注引用（按出现顺序）
-     * 用于确定脚注的显示顺序
-     */
-    private collectFootnoteReferences;
     /**
      * 增量更新 lines 和 lineOffsets
-     * 只处理新增的内容，避免全量 split
+     * 优化策略：只 split 新增的 chunk，不拼接旧字符串，避免长行性能劣化
      */
     private updateLines;
     /**
@@ -62,23 +72,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 并返回增量更新
      */
@@ -139,8 +132,25 @@ declare class IncremarkParser {
 }
 /**
  * 创建 Incremark 解析器实例
+ *
+ * @param options 解析器配置
+ * @param options.astBuilder 自定义 AST 构建器类（用于切换引擎）
+ * @param options.plugins 统一插件列表
+ *
+ * @example
+ * ```ts
+ * // 使用默认的 marked 引擎（极速模式）
+ * const parser = createIncremarkParser({ gfm: true, math: true })
+ *
+ * // 使用 micromark 引擎（需要单独导入，支持 tree-shaking）
+ * import { MicromarkAstBuilder } from '@incremark/core/engines/micromark'
+ * const parser = createIncremarkParser({
+ *   astBuilder: MicromarkAstBuilder,
+ *   gfm: true
+ * })
+ * ```
  */
-declare function createIncremarkParser(options?: ParserOptions): IncremarkParser;
+declare function createIncremarkParser(options?: IncremarkParserOptions): IncremarkParser;
 
 /**
  * 源 Block 类型（来自解析器）
@@ -452,15 +462,19 @@ interface AccumulatedChunks {
 /**
  * 截断 AST 节点，只保留前 maxChars 个字符
  * 支持 chunks（用于渐入动画）
- * 支持增量模式：跳过已处理的字符，只处理新增部分
  *
- * @param node 原始节点
+ * 性能说明：
+ * - 此函数每次调用都会从头遍历 AST 节点
+ * - 但由于 BlockTransformer 是按 block 处理的，每次只遍历单个 block 的 AST
+ * - 单个 block（如一个段落、一个代码块）通常只有几百个字符，性能开销很小
+ * - 对于整个文档的渲染，已完成的 blocks 不会重新遍历
+ *
+ * @param node 原始节点（单个 block 的 AST）
  * @param maxChars 最大字符数
  * @param accumulatedChunks 累积的 chunks 信息（用于渐入动画）
- * @param skipChars 跳过前 N 个字符（已处理的部分，用于增量追加）
  * @returns 截断后的节点，如果 maxChars <= 0 返回 null
  */
-declare function sliceAst(node: RootContent, maxChars: number, accumulatedChunks?: AccumulatedChunks, skipChars?: number): RootContent | null;
+declare function sliceAst(node: RootContent, maxChars: number, accumulatedChunks?: AccumulatedChunks): RootContent | null;
 /**
  * 深拷贝 AST 节点
  * 使用递归浅拷贝实现，比 JSON.parse/stringify 更高效
@@ -520,4 +534,4 @@ declare const allPlugins: TransformerPlugin[];
  */
 declare function createPlugin(name: string, matcher: (node: RootContent) => boolean, options?: Partial<Omit<TransformerPlugin, 'name' | 'match'>>): TransformerPlugin;
 
-export { type AnimationEffect, BlockStatus, BlockTransformer, type DisplayBlock, IncremarkParser, IncrementalUpdate, ParsedBlock, ParserOptions, ParserState, type SourceBlock, type TextChunk, type TextNodeWithChunks, type TransformerOptions, type TransformerPlugin, type TransformerState, allPlugins, cloneNode, codeBlockPlugin, countChars, createBlockTransformer, createIncremarkParser, createPlugin, defaultPlugins, imagePlugin, mathPlugin, mermaidPlugin, sliceAst, thematicBreakPlugin };
+export { type AnimationEffect, type AstBuilderClass, BlockStatus, BlockTransformer, type DisplayBlock, EngineParserOptions, IAstBuilder, IncremarkParser, type IncremarkParserOptions, IncrementalUpdate, ParsedBlock, ParserState, type SourceBlock, type TextChunk, type TextNodeWithChunks, type TransformerOptions, type TransformerPlugin, type TransformerState, allPlugins, cloneNode, codeBlockPlugin, countChars, createBlockTransformer, createIncremarkParser, createPlugin, defaultPlugins, imagePlugin, mathPlugin, mermaidPlugin, sliceAst, thematicBreakPlugin };