@incremark/core 0.3.0 → 0.3.1

package/dist/{index-mZ7yCqNH.d.ts → index-CWuosVAK.d.ts}

@@ -140,6 +140,30 @@ interface ParserState {
     definitions: DefinitionMap;
     footnoteDefinitions: FootnoteDefinitionMap;
 }
+/**
+ * 数学公式配置选项
+ */
+interface MathOptions {
+    /**
+     * 启用 TeX 风格的公式分隔符 (default: `false`)
+     *
+     * 开启后同时支持：
+     * - 行内公式：\(...\)
+     * - 块级公式：\[...\]
+     *
+     * 这是 LaTeX/TeX 原生语法，MathJax 和 KaTeX 都支持。
+     * 开启此选项可以兼容从 LaTeX 文档或学术 AI 工具输出的内容。
+     *
+     * @example
+     * ```ts
+     * // 启用 TeX 风格分隔符
+     * const parser = createIncremarkParser({
+     *   math: { tex: true }
+     * })
+     * ```
+     */
+    tex?: boolean;
+}
 /**
  * 解析器配置
  */
@@ -147,11 +171,12 @@ interface ParserOptions {
     /** 启用 GFM 扩展（表格、任务列表等） */
     gfm?: boolean;
     /**
-     * 启用数学公式支持（$..$ 行内公式和 $$...$$ 块级公式）
+     * 启用数学公式支持
      * - false/undefined: 禁用（默认）
-     * - true: 启用数学公式解析
+     * - true: 启用数学公式解析（仅支持 $...$ 和 $$...$$ 语法）
+     * - MathOptions: 启用并配置额外选项（如 LaTeX 风格的 \(...\) 和 \[...\] 语法）
      */
-    math?: boolean;
+    math?: boolean | MathOptions;
     /**
      * 启用 ::: 容器语法支持（用于边界检测）
      * - false: 禁用（默认）
@@ -222,4 +247,4 @@ interface ContainerMatch {
     isEnd: boolean;
 }
 
-export type { AstNode as A, BlockStatus as B, ContainerConfig as C, DefinitionMap as D, FootnoteDefinitionMap as F, HtmlTreeExtensionOptions as H, IncrementalUpdate as I, ParsedBlock as P, ParserState as a, ParserOptions as b, BlockContext as c, ContainerMatch as d };
+export type { AstNode as A, BlockStatus as B, ContainerConfig as C, DefinitionMap as D, FootnoteDefinitionMap as F, HtmlTreeExtensionOptions as H, IncrementalUpdate as I, MathOptions as M, ParsedBlock as P, ParserState as a, ParserOptions as b, BlockContext as c, ContainerMatch as d };

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-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 { I as IncrementalUpdate, P as ParsedBlock, D as DefinitionMap, F as FootnoteDefinitionMap, a as ParserState, B as BlockStatus } from './index-CWuosVAK.js';
+export { A as AstNode, M as MathOptions, b as ParserOptions } from './index-CWuosVAK.js';
+import { E as EngineParserOptions, I as IAstBuilder } from './types-N1b99kYB.js';
+export { a as EngineType, b as IncremarkPlugin, M as MarkedEngineExtension, c as MicromarkEngineExtension } from './types-N1b99kYB.js';
 import { Root, RootContent, Text } from 'mdast';
 export { Root, RootContent } from 'mdast';
-export { M as MarkedAstBuilder } from './MarkedAstBuildter-BsjxZko_.js';
+export { M as MarkedAstBuilder } from './MarkedAstBuildter-DDP1An5M.js';
 import 'micromark-util-types';
 import 'mdast-util-from-markdown';
 import 'marked';
@@ -45,7 +45,7 @@ declare class IncremarkParser {
     /** 边界检测器 */
     private readonly boundaryDetector;
     /** AST 构建器 */
-    private readonly astBuilder;
+    private astBuilder;
     /** Definition 管理器 */
     private readonly definitionManager;
     /** Footnote 管理器 */
@@ -129,6 +129,27 @@ declare class IncremarkParser {
      * @returns 解析结果
      */
     render(content: string): IncrementalUpdate;
+    /**
+     * 更新解析器配置（动态更新，不需要重建 parser 实例）
+     *
+     * 注意：更新配置后会自动调用 reset() 重置状态
+     *
+     * @param options 部分配置选项
+     *
+     * @example
+     * ```ts
+     * // 动态启用 TeX 数学公式语法
+     * parser.updateOptions({ math: { tex: true } })
+     *
+     * // 禁用 GFM
+     * parser.updateOptions({ gfm: false })
+     *
+     * // 切换引擎
+     * import { MicromarkAstBuilder } from '@incremark/core/engines/micromark'
+     * parser.updateOptions({ astBuilder: MicromarkAstBuilder })
+     * ```
+     */
+    updateOptions(options: Partial<IncremarkParserOptions>): void;
 }
 /**
  * 创建 Incremark 解析器实例

package/dist/index.js

@@ -1351,24 +1351,48 @@ function createOptimisticReferenceExtension() {
 }
 
 // src/extensions/marked-extensions/mathExtension.ts
-function createBlockMathExtension() {
+function resolveOptions(options) {
+  return {
+    tex: options?.tex ?? false
+  };
+}
+function createBlockMathExtension(options) {
+  const resolved = resolveOptions(options);
   return {
     name: "blockMath",
     level: "block",
     start(src) {
-      const match = src.match(/^ {0,3}\$\$/m);
-      return match?.index;
+      const dollarMatch = src.match(/^ {0,3}\$\$/m);
+      let bracketMatch = null;
+      if (resolved.tex) {
+        bracketMatch = src.match(/^ {0,3}\\\[/m);
+      }
+      if (dollarMatch && bracketMatch) {
+        return Math.min(dollarMatch.index, bracketMatch.index);
+      }
+      return dollarMatch?.index ?? bracketMatch?.index;
     },
     tokenizer(src) {
-      const rule = /^ {0,3}\$\$([\s\S]*?)\$\$ *(?:\n+|$)/;
-      const match = rule.exec(src);
-      if (match) {
+      const dollarRule = /^ {0,3}\$\$([\s\S]*?)\$\$ *(?:\n+|$)/;
+      const dollarMatch = dollarRule.exec(src);
+      if (dollarMatch) {
         return {
           type: "blockMath",
-          raw: match[0],
-          text: match[1].trim()
+          raw: dollarMatch[0],
+          text: dollarMatch[1].trim()
         };
       }
+      if (resolved.tex) {
+        const bracketRule = /^ {0,3}\\\[([\s\S]*?)\\\] *(?:\n+|$)/;
+        const bracketMatch = bracketRule.exec(src);
+        if (bracketMatch) {
+          return {
+            type: "blockMath",
+            raw: bracketMatch[0],
+            text: bracketMatch[1].trim()
+          };
+        }
+      }
       return void 0;
     },
     renderer() {
@@ -1376,26 +1400,46 @@ function createBlockMathExtension() {
     }
   };
 }
-function createInlineMathExtension() {
+function createInlineMathExtension(options) {
+  const resolved = resolveOptions(options);
   return {
     name: "inlineMath",
     level: "inline",
     start(src) {
-      const index = src.indexOf("$");
-      if (index === -1) return void 0;
-      if (src[index + 1] === "$") return void 0;
-      return index;
+      const dollarIndex = src.indexOf("$");
+      const validDollarIndex = dollarIndex !== -1 && src[dollarIndex + 1] !== "$" ? dollarIndex : -1;
+      let parenIndex = -1;
+      if (resolved.tex) {
+        parenIndex = src.indexOf("\\(");
+      }
+      if (validDollarIndex !== -1 && parenIndex !== -1) {
+        return Math.min(validDollarIndex, parenIndex);
+      }
+      if (validDollarIndex !== -1) return validDollarIndex;
+      if (parenIndex !== -1) return parenIndex;
+      return void 0;
     },
     tokenizer(src) {
-      const rule = /^\$(?!\$)((?:\\.|[^\\\n$])+?)\$(?!\d)/;
-      const match = rule.exec(src);
-      if (match) {
+      const dollarRule = /^\$(?!\$)((?:\\.|[^\\\n$])+?)\$(?!\d)/;
+      const dollarMatch = dollarRule.exec(src);
+      if (dollarMatch) {
         return {
           type: "inlineMath",
-          raw: match[0],
-          text: match[1].trim()
+          raw: dollarMatch[0],
+          text: dollarMatch[1].trim()
         };
       }
+      if (resolved.tex) {
+        const parenRule = /^\\\(([\s\S]*?)\\\)/;
+        const parenMatch = parenRule.exec(src);
+        if (parenMatch) {
+          return {
+            type: "inlineMath",
+            raw: parenMatch[0],
+            text: parenMatch[1].trim()
+          };
+        }
+      }
       return void 0;
     },
     renderer() {
@@ -2053,8 +2097,9 @@ var MarkedAstBuilder = class {
     const inlineExts = [optimisticRefExt.tokenizer, ...userInlineExts];
     const inlineStartExts = [optimisticRefExt.start, ...userInlineStartExts];
     if (this.options.math) {
-      const blockMathExt = createBlockMathExtension();
-      const inlineMathExt = createInlineMathExtension();
+      const mathOptions = typeof this.options.math === "object" ? this.options.math : {};
+      const blockMathExt = createBlockMathExtension(mathOptions);
+      const inlineMathExt = createInlineMathExtension(mathOptions);
       blockExts.unshift(blockMathExt.tokenizer);
       blockStartExts.unshift(blockMathExt.start);
       inlineExts.unshift(inlineMathExt.tokenizer);
@@ -2280,6 +2325,28 @@ var MarkedAstBuilder = class {
     }
     return blocks;
   }
+  /**
+   * 更新配置选项
+   * @param options 部分配置选项
+   */
+  updateOptions(options) {
+    Object.assign(this.options, options);
+    if ("containers" in options) {
+      this.containerConfig = typeof options.containers === "object" ? options.containers : options.containers === true ? {} : void 0;
+    }
+    if ("htmlTree" in options) {
+      this.htmlTreeOptions = typeof options.htmlTree === "object" ? options.htmlTree : options.htmlTree === true ? {} : void 0;
+    }
+    if (options.plugins || options.markedExtensions) {
+      this.userExtensions.length = 0;
+      if (options.plugins) {
+        this.userExtensions.push(...extractMarkedExtensions(options.plugins));
+      }
+      if (options.markedExtensions) {
+        this.userExtensions.push(...options.markedExtensions);
+      }
+    }
+  }
 };
 
 // src/parser/IncremarkParser.ts
@@ -2569,6 +2636,40 @@ var IncremarkParser = class {
     this.append(content);
     return this.finalize();
   }
+  /**
+   * 更新解析器配置（动态更新，不需要重建 parser 实例）
+   *
+   * 注意：更新配置后会自动调用 reset() 重置状态
+   *
+   * @param options 部分配置选项
+   *
+   * @example
+   * ```ts
+   * // 动态启用 TeX 数学公式语法
+   * parser.updateOptions({ math: { tex: true } })
+   *
+   * // 禁用 GFM
+   * parser.updateOptions({ gfm: false })
+   *
+   * // 切换引擎
+   * import { MicromarkAstBuilder } from '@incremark/core/engines/micromark'
+   * parser.updateOptions({ astBuilder: MicromarkAstBuilder })
+   * ```
+   */
+  updateOptions(options) {
+    this.reset();
+    Object.assign(this.options, options);
+    if (options.astBuilder) {
+      const BuilderClass = options.astBuilder;
+      if (!(this.astBuilder instanceof BuilderClass)) {
+        this.astBuilder = new BuilderClass(this.options);
+      } else {
+        this.astBuilder.updateOptions(options);
+      }
+    } else {
+      this.astBuilder.updateOptions(options);
+    }
+  }
 };
 function createIncremarkParser(options) {
   return new IncremarkParser(options);