@incremark/core 0.2.7 → 0.3.1

package/dist/types-N1b99kYB.d.ts

@@ -0,0 +1,128 @@
+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-CWuosVAK.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[];
+    /**
+     * 更新配置选项（动态更新，不需要重建实例）
+     * @param options 部分配置选项
+     */
+    updateOptions(options: Partial<EngineParserOptions>): void;
+}
+/**
+ * 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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@incremark/core",
-  "version": "0.2.7",
-  "description": "增量式 Markdown 解析器核心库",
+  "version": "0.3.1",
+  "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",
@@ -38,6 +47,7 @@
     "micromark-extension-math": "^3.0.0",
     "micromark-factory-destination": "^2.0.0",
     "micromark-factory-label": "^2.0.0",
+    "micromark-factory-space": "^2.0.0",
     "micromark-factory-title": "^2.0.0",
     "micromark-factory-whitespace": "^2.0.0",
     "micromark-util-character": "^2.0.0",
@@ -55,8 +65,13 @@
     "incremental",
     "streaming",
     "ai",
+    "chatgpt",
+    "llm",
     "mdast",
-    "unified"
+    "high-performance",
+    "typewriter",
+    "micromark",
+    "marked"
   ],
   "license": "MIT",
   "repository": {