@incremark/core 0.0.1

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 wangyishuai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,99 @@
+# @incremark/core
+
+增量式 Markdown 解析器核心库。
+
+## 特性
+
+- 🚀 **增量解析** - 只解析新增内容，已完成的块不再重复处理
+- 🔄 **流式友好** - 专为 AI 流式输出场景设计
+- 🎯 **智能边界检测** - 准确识别 Markdown 块边界
+- 📦 **框架无关** - 可与任何前端框架配合使用
+
+## 安装
+
+```bash
+pnpm add @incremark/core
+```
+
+## 快速开始
+
+```ts
+import { createIncremarkParser } from '@incremark/core'
+
+const parser = createIncremarkParser({ gfm: true })
+
+// 模拟流式输入
+parser.append('# Hello\n')
+parser.append('\nWorld')
+parser.finalize()
+
+// 获取结果
+console.log(parser.getCompletedBlocks())
+console.log(parser.getAst())
+```
+
+## API
+
+### createIncremarkParser(options)
+
+创建解析器实例。
+
+```ts
+interface ParserOptions {
+  gfm?: boolean              // 启用 GFM
+  containers?: boolean       // 启用 ::: 容器
+  extensions?: Extension[]   // micromark 扩展
+  mdastExtensions?: Extension[]  // mdast 扩展
+}
+```
+
+### parser.append(chunk)
+
+追加内容，返回增量更新。
+
+### parser.finalize()
+
+完成解析。
+
+### parser.reset()
+
+重置状态。
+
+### parser.getBuffer()
+
+获取当前缓冲区内容。
+
+### parser.getCompletedBlocks()
+
+获取已完成的块。
+
+### parser.getPendingBlocks()
+
+获取待处理的块。
+
+### parser.getAst()
+
+获取完整 AST。
+
+## 类型定义
+
+```ts
+interface ParsedBlock {
+  id: string
+  status: 'pending' | 'stable' | 'completed'
+  node: RootContent
+  startOffset: number
+  endOffset: number
+  rawText: string
+}
+```
+
+## 与框架集成
+
+- Vue: [@incremark/vue](../vue)
+- React: [@incremark/react](../react)
+
+## License
+
+MIT
+

package/dist/detector/index.d.ts

@@ -0,0 +1,4 @@
+export { r as createInitialContext, o as detectContainer, p as detectContainerEnd, g as detectFenceEnd, f as detectFenceStart, q as isBlockBoundary, l as isBlockquoteStart, i as isEmptyLine, h as isHeading, m as isHtmlBlock, k as isListItemStart, n as isTableDelimiter, j as isThematicBreak, u as updateContext } from '../index-i_qABRHQ.js';
+import 'mdast';
+import 'micromark-util-types';
+import 'mdast-util-from-markdown';

package/dist/detector/index.js

@@ -0,0 +1,155 @@
+// src/detector/index.ts
+function detectFenceStart(line) {
+  const match = line.match(/^(\s*)((`{3,})|(~{3,}))/);
+  if (match) {
+    const fence = match[2];
+    const char = fence[0];
+    return { char, length: fence.length };
+  }
+  return null;
+}
+function detectFenceEnd(line, context) {
+  if (!context.inFencedCode || !context.fenceChar || !context.fenceLength) {
+    return false;
+  }
+  const pattern = new RegExp(`^\\s{0,3}${context.fenceChar}{${context.fenceLength},}\\s*$`);
+  return pattern.test(line);
+}
+function isEmptyLine(line) {
+  return /^\s*$/.test(line);
+}
+function isHeading(line) {
+  return /^#{1,6}\s/.test(line);
+}
+function isThematicBreak(line) {
+  return /^(\*{3,}|-{3,}|_{3,})\s*$/.test(line.trim());
+}
+function isListItemStart(line) {
+  const unordered = line.match(/^(\s*)([-*+])\s/);
+  if (unordered) {
+    return { ordered: false, indent: unordered[1].length };
+  }
+  const ordered = line.match(/^(\s*)(\d{1,9})[.)]\s/);
+  if (ordered) {
+    return { ordered: true, indent: ordered[1].length };
+  }
+  return null;
+}
+function isBlockquoteStart(line) {
+  return /^\s{0,3}>/.test(line);
+}
+function isHtmlBlock(line) {
+  return /^\s{0,3}<(script|pre|style|textarea|!--|!DOCTYPE|\?|!\[CDATA\[)/i.test(line) || /^\s{0,3}<\/?[a-zA-Z][a-zA-Z0-9-]*(\s|>|$)/.test(line);
+}
+function isTableDelimiter(line) {
+  return /^\|?\s*:?-{3,}:?\s*(\|\s*:?-{3,}:?\s*)*\|?$/.test(line.trim());
+}
+function detectContainer(line, config) {
+  const marker = config?.marker || ":";
+  const minLength = config?.minMarkerLength || 3;
+  const escapedMarker = marker.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const pattern = new RegExp(
+    `^(\\s*)(${escapedMarker}{${minLength},})(?:\\s+(\\w[\\w-]*))?(?:\\s+(.*))?\\s*$`
+  );
+  const match = line.match(pattern);
+  if (!match) {
+    return null;
+  }
+  const markerLength = match[2].length;
+  const name = match[3] || "";
+  const isEnd = !name && !match[4];
+  if (!isEnd && config?.allowedNames && config.allowedNames.length > 0) {
+    if (!config.allowedNames.includes(name)) {
+      return null;
+    }
+  }
+  return { name, markerLength, isEnd };
+}
+function detectContainerEnd(line, context, config) {
+  if (!context.inContainer || !context.containerMarkerLength) {
+    return false;
+  }
+  const result = detectContainer(line, config);
+  if (!result) {
+    return false;
+  }
+  return result.isEnd && result.markerLength >= context.containerMarkerLength;
+}
+function isBlockBoundary(prevLine, currentLine, context) {
+  if (context.inFencedCode) {
+    return detectFenceEnd(currentLine, context);
+  }
+  if (isEmptyLine(prevLine) && !isEmptyLine(currentLine)) {
+    return true;
+  }
+  if (isHeading(currentLine) && !isEmptyLine(prevLine)) {
+    return true;
+  }
+  if (isThematicBreak(currentLine)) {
+    return true;
+  }
+  if (detectFenceStart(currentLine)) {
+    return true;
+  }
+  return false;
+}
+function createInitialContext() {
+  return {
+    inFencedCode: false,
+    listDepth: 0,
+    blockquoteDepth: 0,
+    inContainer: false,
+    containerDepth: 0
+  };
+}
+function updateContext(line, context, containerConfig) {
+  const newContext = { ...context };
+  const containerCfg = containerConfig === true ? {} : containerConfig === false ? void 0 : containerConfig;
+  if (context.inFencedCode) {
+    if (detectFenceEnd(line, context)) {
+      newContext.inFencedCode = false;
+      newContext.fenceChar = void 0;
+      newContext.fenceLength = void 0;
+    }
+    return newContext;
+  }
+  const fence = detectFenceStart(line);
+  if (fence) {
+    newContext.inFencedCode = true;
+    newContext.fenceChar = fence.char;
+    newContext.fenceLength = fence.length;
+    return newContext;
+  }
+  if (containerCfg !== void 0) {
+    if (context.inContainer) {
+      if (detectContainerEnd(line, context, containerCfg)) {
+        newContext.containerDepth = context.containerDepth - 1;
+        if (newContext.containerDepth === 0) {
+          newContext.inContainer = false;
+          newContext.containerMarkerLength = void 0;
+          newContext.containerName = void 0;
+        }
+        return newContext;
+      }
+      const nested = detectContainer(line, containerCfg);
+      if (nested && !nested.isEnd) {
+        newContext.containerDepth = context.containerDepth + 1;
+        return newContext;
+      }
+    } else {
+      const container = detectContainer(line, containerCfg);
+      if (container && !container.isEnd) {
+        newContext.inContainer = true;
+        newContext.containerMarkerLength = container.markerLength;
+        newContext.containerName = container.name;
+        newContext.containerDepth = 1;
+        return newContext;
+      }
+    }
+  }
+  return newContext;
+}
+
+export { createInitialContext, detectContainer, detectContainerEnd, detectFenceEnd, detectFenceStart, isBlockBoundary, isBlockquoteStart, isEmptyLine, isHeading, isHtmlBlock, isListItemStart, isTableDelimiter, isThematicBreak, updateContext };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/detector/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/detector/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * 块类型检测与边界判断\n *\n * Markdown 块级元素的识别规则\n */\n\nimport type { BlockContext, ContainerConfig, ContainerMatch } from '../types'\n\n// ============ 代码块检测 ============\n\n/**\n * 检测行是否是代码块 fence 开始\n */\nexport function detectFenceStart(line: string): { char: string; length: number } | null {\n  const match = line.match(/^(\\s*)((`{3,})|(~{3,}))/)\n  if (match) {\n    const fence = match[2]\n    const char = fence[0]\n    return { char, length: fence.length }\n  }\n  return null\n}\n\n/**\n * 检测行是否是代码块 fence 结束\n */\nexport function detectFenceEnd(line: string, context: BlockContext): boolean {\n  if (!context.inFencedCode || !context.fenceChar || !context.fenceLength) {\n    return false\n  }\n\n  const pattern = new RegExp(`^\\\\s{0,3}${context.fenceChar}{${context.fenceLength},}\\\\s*$`)\n  return pattern.test(line)\n}\n\n// ============ 行类型检测 ============\n\n/**\n * 检测是否是空行或仅包含空白字符\n */\nexport function isEmptyLine(line: string): boolean {\n  return /^\\s*$/.test(line)\n}\n\n/**\n * 检测是否是标题行\n */\nexport function isHeading(line: string): boolean {\n  return /^#{1,6}\\s/.test(line)\n}\n\n/**\n * 检测是否是 thematic break（水平线）\n */\nexport function isThematicBreak(line: string): boolean {\n  return /^(\\*{3,}|-{3,}|_{3,})\\s*$/.test(line.trim())\n}\n\n/**\n * 检测是否是列表项开始\n */\nexport function isListItemStart(line: string): { ordered: boolean; indent: number } | null {\n  // 无序列表: - * +\n  const unordered = line.match(/^(\\s*)([-*+])\\s/)\n  if (unordered) {\n    return { ordered: false, indent: unordered[1].length }\n  }\n\n  // 有序列表: 1. 2) 等\n  const ordered = line.match(/^(\\s*)(\\d{1,9})[.)]\\s/)\n  if (ordered) {\n    return { ordered: true, indent: ordered[1].length }\n  }\n\n  return null\n}\n\n/**\n * 检测是否是引用块开始\n */\nexport function isBlockquoteStart(line: string): boolean {\n  return /^\\s{0,3}>/.test(line)\n}\n\n/**\n * 检测是否是 HTML 块\n */\nexport function isHtmlBlock(line: string): boolean {\n  return (\n    /^\\s{0,3}<(script|pre|style|textarea|!--|!DOCTYPE|\\?|!\\[CDATA\\[)/i.test(line) ||\n    /^\\s{0,3}<\\/?[a-zA-Z][a-zA-Z0-9-]*(\\s|>|$)/.test(line)\n  )\n}\n\n/**\n * 检测表格分隔行\n */\nexport function isTableDelimiter(line: string): boolean {\n  return /^\\|?\\s*:?-{3,}:?\\s*(\\|\\s*:?-{3,}:?\\s*)*\\|?$/.test(line.trim())\n}\n\n// ============ 容器检测 ============\n\n/**\n * 检测容器开始或结束\n *\n * 支持格式：\n * - ::: name      开始\n * - ::: name attr 开始（带属性）\n * - :::           结束\n * - :::::: name   开始（更长的标记，用于嵌套）\n */\nexport function detectContainer(line: string, config?: ContainerConfig): ContainerMatch | null {\n  const marker = config?.marker || ':'\n  const minLength = config?.minMarkerLength || 3\n\n  const escapedMarker = marker.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n  const pattern = new RegExp(\n    `^(\\\\s*)(${escapedMarker}{${minLength},})(?:\\\\s+(\\\\w[\\\\w-]*))?(?:\\\\s+(.*))?\\\\s*$`\n  )\n\n  const match = line.match(pattern)\n  if (!match) {\n    return null\n  }\n\n  const markerLength = match[2].length\n  const name = match[3] || ''\n  const isEnd = !name && !match[4]\n\n  if (!isEnd && config?.allowedNames && config.allowedNames.length > 0) {\n    if (!config.allowedNames.includes(name)) {\n      return null\n    }\n  }\n\n  return { name, markerLength, isEnd }\n}\n\n/**\n * 检测容器结束\n */\nexport function detectContainerEnd(\n  line: string,\n  context: BlockContext,\n  config?: ContainerConfig\n): boolean {\n  if (!context.inContainer || !context.containerMarkerLength) {\n    return false\n  }\n\n  const result = detectContainer(line, config)\n  if (!result) {\n    return false\n  }\n\n  return result.isEnd && result.markerLength >= context.containerMarkerLength\n}\n\n// ============ 边界检测 ============\n\n/**\n * 判断两行之间是否构成块边界\n */\nexport function isBlockBoundary(\n  prevLine: string,\n  currentLine: string,\n  context: BlockContext\n): boolean {\n  if (context.inFencedCode) {\n    return detectFenceEnd(currentLine, context)\n  }\n\n  if (isEmptyLine(prevLine) && !isEmptyLine(currentLine)) {\n    return true\n  }\n\n  if (isHeading(currentLine) && !isEmptyLine(prevLine)) {\n    return true\n  }\n\n  if (isThematicBreak(currentLine)) {\n    return true\n  }\n\n  if (detectFenceStart(currentLine)) {\n    return true\n  }\n\n  return false\n}\n\n// ============ 上下文管理 ============\n\n/**\n * 创建初始上下文\n */\nexport function createInitialContext(): BlockContext {\n  return {\n    inFencedCode: false,\n    listDepth: 0,\n    blockquoteDepth: 0,\n    inContainer: false,\n    containerDepth: 0\n  }\n}\n\n/**\n * 更新上下文（处理一行后）\n */\nexport function updateContext(\n  line: string,\n  context: BlockContext,\n  containerConfig?: ContainerConfig | boolean\n): BlockContext {\n  const newContext = { ...context }\n\n  const containerCfg =\n    containerConfig === true ? {} : containerConfig === false ? undefined : containerConfig\n\n  // 代码块优先级最高\n  if (context.inFencedCode) {\n    if (detectFenceEnd(line, context)) {\n      newContext.inFencedCode = false\n      newContext.fenceChar = undefined\n      newContext.fenceLength = undefined\n    }\n    return newContext\n  }\n\n  const fence = detectFenceStart(line)\n  if (fence) {\n    newContext.inFencedCode = true\n    newContext.fenceChar = fence.char\n    newContext.fenceLength = fence.length\n    return newContext\n  }\n\n  // 容器处理\n  if (containerCfg !== undefined) {\n    if (context.inContainer) {\n      if (detectContainerEnd(line, context, containerCfg)) {\n        newContext.containerDepth = context.containerDepth - 1\n        if (newContext.containerDepth === 0) {\n          newContext.inContainer = false\n          newContext.containerMarkerLength = undefined\n          newContext.containerName = undefined\n        }\n        return newContext\n      }\n\n      const nested = detectContainer(line, containerCfg)\n      if (nested && !nested.isEnd) {\n        newContext.containerDepth = context.containerDepth + 1\n        return newContext\n      }\n    } else {\n      const container = detectContainer(line, containerCfg)\n      if (container && !container.isEnd) {\n        newContext.inContainer = true\n        newContext.containerMarkerLength = container.markerLength\n        newContext.containerName = container.name\n        newContext.containerDepth = 1\n        return newContext\n      }\n    }\n  }\n\n  return newContext\n}\n\n"]}

package/dist/index-i_qABRHQ.d.ts

@@ -0,0 +1,207 @@
+import { RootContent, Root } from 'mdast';
+import { Extension } from 'micromark-util-types';
+import { Extension as Extension$1 } from 'mdast-util-from-markdown';
+
+/**
+ * 解析块的状态
+ */
+type BlockStatus = 'pending' | 'stable' | 'completed';
+/**
+ * 解析出的块
+ */
+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;
+}
+/**
+ * 容器语法配置
+ */
+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;
+}
+/**
+ * 解析器配置
+ */
+interface ParserOptions {
+    /** 启用 GFM 扩展（表格、任务列表等） */
+    gfm?: boolean;
+    /**
+     * 启用 ::: 容器语法支持（用于边界检测）
+     * - false: 禁用（默认）
+     * - true: 使用默认配置启用
+     * - ContainerConfig: 使用自定义配置启用
+     */
+    containers?: boolean | ContainerConfig;
+    /** 自定义块边界检测函数 */
+    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;
+}
+/**
+ * 容器检测结果
+ */
+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;
+/**
+ * 检测是否是列表项开始
+ */
+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;
+/**
+ * 检测容器开始或结束
+ *
+ * 支持格式：
+ * - ::: 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 BlockStatus as B, type ContainerConfig as C, type IncrementalUpdate as I, type ParserOptions as P, 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, updateContext as u };

package/dist/index.d.ts

@@ -0,0 +1,89 @@
+import { P as ParserOptions, I as IncrementalUpdate, a as ParsedBlock, b as ParserState } from './index-i_qABRHQ.js';
+export { c as BlockContext, B as BlockStatus, e as BlockTypeInfo, C as ContainerConfig, d as ContainerMatch, r as createInitialContext, o as detectContainer, p as detectContainerEnd, g as detectFenceEnd, f as detectFenceStart, q as isBlockBoundary, l as isBlockquoteStart, i as isEmptyLine, h as isHeading, m as isHtmlBlock, k as isListItemStart, n as isTableDelimiter, j as isThematicBreak, u as updateContext } from './index-i_qABRHQ.js';
+import { Root } 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';
+
+declare class IncremarkParser {
+    private buffer;
+    private lines;
+    /** 行偏移量前缀和：lineOffsets[i] = 第i行起始位置的偏移量 */
+    private lineOffsets;
+    private completedBlocks;
+    private pendingStartLine;
+    private blockIdCounter;
+    private context;
+    private options;
+    /** 缓存的容器配置，避免重复计算 */
+    private cachedContainerConfig;
+    /** 上次 append 返回的 pending blocks，用于 getAst 复用 */
+    private lastPendingBlocks;
+    constructor(options?: ParserOptions);
+    private generateBlockId;
+    private computeContainerConfig;
+    private getContainerConfig;
+    private parse;
+    /**
+     * 增量更新 lines 和 lineOffsets
+     * 只处理新增的内容，避免全量 split
+     */
+    private updateLines;
+    /**
+     * O(1) 获取行偏移量
+     */
+    private getLineOffset;
+    /**
+     * 查找稳定边界
+     * 返回稳定边界行号和该行对应的上下文（用于后续更新，避免重复计算）
+     */
+    private findStableBoundary;
+    private checkStability;
+    private nodesToBlocks;
+    /**
+     * 追加新的 chunk 并返回增量更新
+     */
+    append(chunk: string): IncrementalUpdate;
+    /**
+     * 触发状态变化回调
+     */
+    private emitChange;
+    /**
+     * 标记解析完成，处理剩余内容
+     * 也可用于强制中断时（如用户点击停止），将 pending 内容标记为 completed
+     */
+    finalize(): IncrementalUpdate;
+    /**
+     * 强制中断解析，将所有待处理内容标记为完成
+     * 语义上等同于 finalize()，但名称更清晰
+     */
+    abort(): IncrementalUpdate;
+    /**
+     * 获取当前完整的 AST
+     * 复用上次 append 的 pending 结果，避免重复解析
+     */
+    getAst(): Root;
+    /**
+     * 获取所有已完成的块
+     */
+    getCompletedBlocks(): ParsedBlock[];
+    /**
+     * 获取当前缓冲区内容
+     */
+    getBuffer(): string;
+    /**
+     * 设置状态变化回调（用于 DevTools 等）
+     */
+    setOnChange(callback: ((state: ParserState) => void) | undefined): void;
+    /**
+     * 重置解析器状态
+     */
+    reset(): void;
+}
+/**
+ * 创建 Incremark 解析器实例
+ */
+declare function createIncremarkParser(options?: ParserOptions): IncremarkParser;
+
+export { IncremarkParser, IncrementalUpdate, ParsedBlock, ParserOptions, ParserState, createIncremarkParser };