pd-markdown 2.0.1 → 2.0.3

package/README.md

@@ -11,7 +11,9 @@
 - ⚛️ **React 组件** - 提供开箱即用的 React 渲染组件
 - 🎨 **可定制** - 支持自定义组件覆盖（Heading, Code, Table 等）
 - 🔗 **自动锚点** - 标题自动生成 slug 锚点
-- 📦 **Tree-shakable** - 支持 ESM，优化打包体积
+- 📦 **Tree-shakable** - 基于 ESM 设计，支持按需加载，最小化打包体积
+- 🛠️ **现代兼容性** - 完美支持 Subpath Exports，确保在 Next.js、Vite 等现代开发环境下无缝解析
+- 🛡️ **类型友好** - 完整的 TypeScript 定义，提供极致的开发体验
 
 ## 安装
 
@@ -29,10 +31,10 @@ yarn add pd-markdown
 ## 模块结构
 
 | 模块路径 | 描述 |
-| --- | --- |
-| `pd-markdown/parser` | Markdown 解析器，将 Markdown 转换为 AST |
-| `pd-markdown/web` | React 组件和 Hooks，用于渲染 Markdown 和处理流式内容 |
-| `pd-markdown/utils` | 工具函数库，提供 AST 操作和字符串处理 |
+| :--- | :--- |
+| `pd-markdown/parser` | **核心解析器**：将 Markdown 转换为标准 AST |
+| `pd-markdown/web` | **React 渲染层**：包含渲染组件与流式处理 Hooks |
+| `pd-markdown/utils` | **通用工具**：提供 AST 遍历、Slug 生成及字符串处理 |
 
 ## 快速开始
 

package/package.json

@@ -1,9 +1,17 @@
 {
   "name": "pd-markdown",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "type": "module",
+  "main": "./packages/web/dist/index.cjs",
+  "module": "./packages/web/dist/index.mjs",
+  "types": "./packages/web/dist/index.d.ts",
   "description": "A modular markdown parsing and rendering library",
   "exports": {
+    ".": {
+      "types": "./packages/web/dist/index.d.ts",
+      "import": "./packages/web/dist/index.mjs",
+      "require": "./packages/web/dist/index.cjs"
+    },
     "./parser": {
       "types": "./packages/parser/dist/index.d.ts",
       "import": "./packages/parser/dist/index.mjs",
@@ -22,6 +30,9 @@
   },
   "typesVersions": {
     "*": {
+      ".": [
+        "./packages/web/dist/index.d.ts"
+      ],
       "parser": [
         "./packages/parser/dist/index.d.ts"
       ],
@@ -36,15 +47,6 @@
   "files": [
     "packages/*/dist"
   ],
-  "scripts": {
-    "build": "pnpm -r run build",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "typecheck": "tsc --noEmit",
-    "clean": "pnpm -r run clean",
-    "prepublishOnly": "pnpm run build"
-  },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0"
@@ -72,6 +74,7 @@
     "@rollup/rollup-darwin-arm64": "^4.57.1",
     "@testing-library/jest-dom": "^6.9.1",
     "@types/node": "^22.13.5",
+    "@vitest/coverage-v8": "3.2.4",
     "rollup": "^4.34.8",
     "rollup-plugin-dts": "^6.1.1",
     "tslib": "^2.8.1",
@@ -91,5 +94,13 @@
     "type": "git",
     "url": "https://github.com/LaoChen1994/pd-markdown"
   },
-  "sideEffects": false
-}
+  "sideEffects": false,
+  "scripts": {
+    "build": "pnpm -r run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "clean": "pnpm -r run clean"
+  }
+}

package/packages/parser/dist/index.cjs

@@ -0,0 +1,191 @@
+'use strict';
+
+var unified = require('unified');
+var remarkParse = require('remark-parse');
+var remarkGfm = require('remark-gfm');
+var remarkFrontmatter = require('remark-frontmatter');
+var unistUtilVisit = require('unist-util-visit');
+var yaml = require('yaml');
+var pdMarkdownUtils = require('pd-markdown/utils');
+
+/**
+ * Extract text content from phrasing content nodes
+ */
+function extractText(nodes) {
+    return nodes
+        .map((node) => {
+        if (node.type === 'text') {
+            return node.value;
+        }
+        if ('children' in node) {
+            return extractText(node.children);
+        }
+        return '';
+    })
+        .join('');
+}
+/**
+ * Transform plugin that adds slug IDs to headings
+ */
+function transformHeading(tree) {
+    const slugs = new Set();
+    unistUtilVisit.visit(tree, 'heading', (node) => {
+        const text = extractText(node.children);
+        const slug = pdMarkdownUtils.uniqueSlugify(text, slugs);
+        // Add data.id to the heading node
+        const data = (node.data || {});
+        data.id = slug;
+        const hProperties = (data.hProperties || {});
+        hProperties.id = slug;
+        data.hProperties = hProperties;
+        node.data = data;
+    });
+}
+
+/**
+ * Transform plugin that adds index to list items
+ */
+function transformList(tree) {
+    unistUtilVisit.visit(tree, 'list', (node) => {
+        node.children.forEach((item, index) => {
+            item.data = item.data || {};
+            item.data.index = index;
+            // For ordered lists, also store the actual number
+            if (node.ordered) {
+                const start = node.start ?? 1;
+                item.data.index = start + index;
+            }
+        });
+    });
+}
+
+/**
+ * Transform plugin that enhances table structure
+ * - Separates header and body rows
+ * - Adds alignment and index info to cells
+ */
+function transformTable(tree) {
+    unistUtilVisit.visit(tree, 'table', (node) => {
+        if (node.children.length === 0)
+            return;
+        const [headerRow, ...bodyRows] = node.children;
+        const align = node.align || [];
+        // Mark header row and cells
+        if (headerRow) {
+            headerRow.children.forEach((cell, index) => {
+                cell.data = cell.data || {};
+                cell.data.isHeader = true;
+                cell.data.align = align[index] || null;
+                cell.data.columnIndex = index;
+            });
+        }
+        // Mark body cells
+        bodyRows.forEach((row) => {
+            row.children.forEach((cell, index) => {
+                cell.data = cell.data || {};
+                cell.data.isHeader = false;
+                cell.data.align = align[index] || null;
+                cell.data.columnIndex = index;
+            });
+        });
+        // Store structured data on table node
+        node.data = node.data || {};
+        node.data.header = headerRow;
+        node.data.body = bodyRows;
+    });
+}
+
+/**
+ * Default parser options
+ */
+const DEFAULT_OPTIONS = {
+    gfm: true,
+    frontmatter: true,
+};
+/**
+ * Create frontmatter extraction plugin
+ */
+function extractFrontmatter() {
+    return (tree, file) => {
+        unistUtilVisit.visit(tree, 'yaml', (node) => {
+            try {
+                const data = yaml.parse(node.value);
+                file.data.frontmatter = data;
+            }
+            catch {
+                // Invalid YAML, ignore
+            }
+        });
+    };
+}
+/**
+ * Create a markdown parser with the specified options
+ *
+ * @param options - Parser configuration options
+ * @returns Parser instance with parse method
+ */
+function createParser(options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    const customPlugins = options.plugins || [];
+    // Build processor (使用 any 绕过复杂的类型检查)
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let processor = unified.unified().use(remarkParse);
+    // Add GFM support
+    if (opts.gfm) {
+        processor = processor.use(remarkGfm);
+    }
+    // Add frontmatter support
+    if (opts.frontmatter) {
+        processor = processor.use(remarkFrontmatter, ['yaml']);
+    }
+    // Run custom "before" plugins
+    const beforePlugins = customPlugins.filter((p) => p.phase === 'before');
+    for (const plugin of beforePlugins) {
+        processor = processor.use(() => plugin.transform);
+    }
+    // Add frontmatter extraction
+    if (opts.frontmatter) {
+        processor = processor.use(extractFrontmatter);
+    }
+    // Add built-in transform plugins
+    processor = processor
+        .use(() => transformHeading)
+        .use(() => transformList)
+        .use(() => transformTable);
+    // Run custom "after" plugins
+    const afterPlugins = customPlugins.filter((p) => p.phase === 'after');
+    for (const plugin of afterPlugins) {
+        processor = processor.use(() => plugin.transform);
+    }
+    // Freeze processor
+    processor.freeze();
+    return {
+        parse(content) {
+            // Parse markdown to AST
+            const tree = processor.parse(content);
+            // Run all transform plugins
+            processor.runSync(tree);
+            return tree;
+        },
+    };
+}
+/**
+ * Type-safe helper to define a parser plugin
+ *
+ * @param config - Plugin configuration
+ * @returns Parser plugin
+ */
+function definePlugin(config, options) {
+    return {
+        name: config.name,
+        phase: config.phase,
+        transform: config.transform(options),
+    };
+}
+
+exports.createParser = createParser;
+exports.definePlugin = definePlugin;
+exports.transformHeading = transformHeading;
+exports.transformList = transformList;
+exports.transformTable = transformTable;
+//# sourceMappingURL=index.cjs.map

package/packages/parser/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/plugins/transform/heading.ts","../src/plugins/transform/list.ts","../src/plugins/transform/table.ts","../src/processor.ts"],"sourcesContent":[null,null,null,null],"names":["visit","uniqueSlugify","parseYaml","unified"],"mappings":";;;;;;;;;;AAIA;;AAEG;AACH,SAAS,WAAW,CAAC,KAAwB,EAAA;AAC3C,IAAA,OAAO;AACJ,SAAA,GAAG,CAAC,CAAC,IAAI,KAAI;AACZ,QAAA,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE;YACxB,OAAO,IAAI,CAAC,KAAK;QACnB;AACA,QAAA,IAAI,UAAU,IAAI,IAAI,EAAE;AACtB,YAAA,OAAO,WAAW,CAAC,IAAI,CAAC,QAA6B,CAAC;QACxD;AACA,QAAA,OAAO,EAAE;AACX,IAAA,CAAC;SACA,IAAI,CAAC,EAAE,CAAC;AACb;AAEA;;AAEG;AACG,SAAU,gBAAgB,CAAC,IAAU,EAAA;AACzC,IAAA,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU;IAE/BA,oBAAK,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,IAAa,KAAI;QACvC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC;QACvC,MAAM,IAAI,GAAGC,6BAAa,CAAC,IAAI,EAAE,KAAK,CAAC;;QAGvC,MAAM,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE,CAA4B;AACzD,QAAA,IAAI,CAAC,EAAE,GAAG,IAAI;QACd,MAAM,WAAW,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE,CAA2B;AACtE,QAAA,WAAW,CAAC,EAAE,GAAG,IAAI;AACrB,QAAA,IAAI,CAAC,WAAW,GAAG,WAAW;AAC9B,QAAA,IAAI,CAAC,IAAI,GAAG,IAAI;AAClB,IAAA,CAAC,CAAC;AACJ;;AC3BA;;AAEG;AACG,SAAU,aAAa,CAAC,IAAU,EAAA;IACtCD,oBAAK,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,IAAU,KAAI;QACjC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAc,EAAE,KAAa,KAAI;YACtD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE;AAC3B,YAAA,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK;;AAGvB,YAAA,IAAI,IAAI,CAAC,OAAO,EAAE;AAChB,gBAAA,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC;gBAC7B,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,GAAG,KAAK;YACjC;AACF,QAAA,CAAC,CAAC;AACJ,IAAA,CAAC,CAAC;AACJ;;ACJA;;;;AAIG;AACG,SAAU,cAAc,CAAC,IAAU,EAAA;IACvCA,oBAAK,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,IAAW,KAAI;AACnC,QAAA,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE;QAEhC,MAAM,CAAC,SAAS,EAAE,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC,QAAQ;AAC9C,QAAA,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE;;QAG9B,IAAI,SAAS,EAAE;YACb,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAe,EAAE,KAAa,KAAI;gBAC5D,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE;AAC3B,gBAAA,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI;gBACzB,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI;AACtC,gBAAA,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,KAAK;AAC/B,YAAA,CAAC,CAAC;QACJ;;AAGA,QAAA,QAAQ,CAAC,OAAO,CAAC,CAAC,GAAG,KAAI;YACvB,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAe,EAAE,KAAa,KAAI;gBACtD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE;AAC3B,gBAAA,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,KAAK;gBAC1B,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI;AACtC,gBAAA,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,KAAK;AAC/B,YAAA,CAAC,CAAC;AACJ,QAAA,CAAC,CAAC;;QAGF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE;AAC3B,QAAA,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,SAAS;AAC5B,QAAA,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,QAAQ;AAC3B,IAAA,CAAC,CAAC;AACJ;;ACjDA;;AAEG;AACH,MAAM,eAAe,GAA6C;AAChE,IAAA,GAAG,EAAE,IAAI;AACT,IAAA,WAAW,EAAE,IAAI;CAClB;AAED;;AAEG;AACH,SAAS,kBAAkB,GAAA;AACzB,IAAA,OAAO,CAAC,IAAU,EAAE,IAAW,KAAI;QACjCA,oBAAK,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,IAAU,KAAI;AACjC,YAAA,IAAI;gBACF,MAAM,IAAI,GAAGE,UAAS,CAAC,IAAI,CAAC,KAAK,CAA4B;AAC3D,gBAAA,IAAI,CAAC,IAAiB,CAAC,WAAW,GAAG,IAAI;YAC7C;AAAE,YAAA,MAAM;;YAER;AACF,QAAA,CAAC,CAAC;AACJ,IAAA,CAAC;AACH;AAEA;;;;;AAKG;AACG,SAAU,YAAY,CAAC,OAAA,GAAyB,EAAE,EAAA;IACtD,MAAM,IAAI,GAAG,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,EAAE;AAC/C,IAAA,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE;;;IAI3C,IAAI,SAAS,GAAQC,eAAO,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC;;AAG/C,IAAA,IAAI,IAAI,CAAC,GAAG,EAAE;AACZ,QAAA,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC;IACtC;;AAGA,IAAA,IAAI,IAAI,CAAC,WAAW,EAAE;QACpB,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC,MAAM,CAAC,CAAC;IACxD;;AAGA,IAAA,MAAM,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC;AACvE,IAAA,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE;AAClC,QAAA,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC;IACnD;;AAGA,IAAA,IAAI,IAAI,CAAC,WAAW,EAAE;AACpB,QAAA,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAC/C;;AAGA,IAAA,SAAS,GAAG;AACT,SAAA,GAAG,CAAC,MAAM,gBAAgB;AAC1B,SAAA,GAAG,CAAC,MAAM,aAAa;AACvB,SAAA,GAAG,CAAC,MAAM,cAAc,CAAC;;AAG5B,IAAA,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC;AACrE,IAAA,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE;AACjC,QAAA,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC;IACnD;;IAGA,SAAS,CAAC,MAAM,EAAE;IAElB,OAAO;AACL,QAAA,KAAK,CAAC,OAAe,EAAA;;YAEnB,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAS;;AAG7C,YAAA,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;AAEvB,YAAA,OAAO,IAAI;QACb,CAAC;KACF;AACH;AAEA;;;;;AAKG;AACG,SAAU,YAAY,CAC1B,MAIC,EACD,OAAW,EAAA;IAEX,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;AACnB,QAAA,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC;KACrC;AACH;;;;;;;;"}

package/packages/parser/dist/index.d.ts

@@ -0,0 +1,121 @@
+import { Root } from 'mdast';
+import { VFile } from 'vfile';
+
+/**
+ * Parser plugin configuration
+ */
+interface ParserPlugin {
+    /** Unique plugin name */
+    name: string;
+    /** When to run: before or after built-in transforms */
+    phase: 'before' | 'after';
+    /** Transform function */
+    transform: (tree: Root, file: VFile) => void;
+}
+/**
+ * Parser options
+ */
+interface ParserOptions {
+    /** Custom plugins to add */
+    plugins?: ParserPlugin[];
+    /** Enable GFM syntax (default: true) */
+    gfm?: boolean;
+    /** Enable frontmatter parsing (default: true) */
+    frontmatter?: boolean;
+}
+/**
+ * Parser instance
+ */
+interface Parser {
+    /** Parse markdown string to AST */
+    parse(content: string): Root;
+}
+/**
+ * Plugin definition helper config
+ */
+interface PluginConfig<T = unknown> {
+    /** Plugin name */
+    name: string;
+    /** When to run */
+    phase: 'before' | 'after';
+    /** Transform function factory */
+    transform: (options?: T) => (tree: Root, file: VFile) => void;
+}
+/**
+ * Frontmatter data extracted from markdown
+ */
+interface FrontmatterData {
+    [key: string]: unknown;
+}
+/**
+ * Extended file data with frontmatter
+ */
+interface FileData {
+    frontmatter?: FrontmatterData;
+}
+
+/**
+ * Create a markdown parser with the specified options
+ *
+ * @param options - Parser configuration options
+ * @returns Parser instance with parse method
+ */
+declare function createParser(options?: ParserOptions): Parser;
+/**
+ * Type-safe helper to define a parser plugin
+ *
+ * @param config - Plugin configuration
+ * @returns Parser plugin
+ */
+declare function definePlugin<T = void>(config: {
+    name: string;
+    phase: 'before' | 'after';
+    transform: (options?: T) => (tree: Root, file: VFile) => void;
+}, options?: T): ParserPlugin;
+
+/**
+ * Transform plugin that adds slug IDs to headings
+ */
+declare function transformHeading(tree: Root): void;
+
+/**
+ * Extended list item with index
+ */
+declare module 'mdast' {
+    interface ListItemData {
+        index?: number;
+    }
+}
+/**
+ * Transform plugin that adds index to list items
+ */
+declare function transformList(tree: Root): void;
+
+/**
+ * Extended table data
+ */
+declare module 'mdast' {
+    interface TableData {
+        /** Header row */
+        header?: TableRow;
+        /** Body rows */
+        body?: TableRow[];
+    }
+    interface TableCellData {
+        /** Whether this cell is in header */
+        isHeader?: boolean;
+        /** Column alignment */
+        align?: 'left' | 'center' | 'right' | null;
+        /** Column index */
+        columnIndex?: number;
+    }
+}
+/**
+ * Transform plugin that enhances table structure
+ * - Separates header and body rows
+ * - Adds alignment and index info to cells
+ */
+declare function transformTable(tree: Root): void;
+
+export { createParser, definePlugin, transformHeading, transformList, transformTable };
+export type { FileData, FrontmatterData, Parser, ParserOptions, ParserPlugin, PluginConfig };

package/packages/parser/dist/index.mjs

@@ -0,0 +1,185 @@
+import { unified } from 'unified';
+import remarkParse from 'remark-parse';
+import remarkGfm from 'remark-gfm';
+import remarkFrontmatter from 'remark-frontmatter';
+import { visit } from 'unist-util-visit';
+import { parse } from 'yaml';
+import { uniqueSlugify } from 'pd-markdown/utils';
+
+/**
+ * Extract text content from phrasing content nodes
+ */
+function extractText(nodes) {
+    return nodes
+        .map((node) => {
+        if (node.type === 'text') {
+            return node.value;
+        }
+        if ('children' in node) {
+            return extractText(node.children);
+        }
+        return '';
+    })
+        .join('');
+}
+/**
+ * Transform plugin that adds slug IDs to headings
+ */
+function transformHeading(tree) {
+    const slugs = new Set();
+    visit(tree, 'heading', (node) => {
+        const text = extractText(node.children);
+        const slug = uniqueSlugify(text, slugs);
+        // Add data.id to the heading node
+        const data = (node.data || {});
+        data.id = slug;
+        const hProperties = (data.hProperties || {});
+        hProperties.id = slug;
+        data.hProperties = hProperties;
+        node.data = data;
+    });
+}
+
+/**
+ * Transform plugin that adds index to list items
+ */
+function transformList(tree) {
+    visit(tree, 'list', (node) => {
+        node.children.forEach((item, index) => {
+            item.data = item.data || {};
+            item.data.index = index;
+            // For ordered lists, also store the actual number
+            if (node.ordered) {
+                const start = node.start ?? 1;
+                item.data.index = start + index;
+            }
+        });
+    });
+}
+
+/**
+ * Transform plugin that enhances table structure
+ * - Separates header and body rows
+ * - Adds alignment and index info to cells
+ */
+function transformTable(tree) {
+    visit(tree, 'table', (node) => {
+        if (node.children.length === 0)
+            return;
+        const [headerRow, ...bodyRows] = node.children;
+        const align = node.align || [];
+        // Mark header row and cells
+        if (headerRow) {
+            headerRow.children.forEach((cell, index) => {
+                cell.data = cell.data || {};
+                cell.data.isHeader = true;
+                cell.data.align = align[index] || null;
+                cell.data.columnIndex = index;
+            });
+        }
+        // Mark body cells
+        bodyRows.forEach((row) => {
+            row.children.forEach((cell, index) => {
+                cell.data = cell.data || {};
+                cell.data.isHeader = false;
+                cell.data.align = align[index] || null;
+                cell.data.columnIndex = index;
+            });
+        });
+        // Store structured data on table node
+        node.data = node.data || {};
+        node.data.header = headerRow;
+        node.data.body = bodyRows;
+    });
+}
+
+/**
+ * Default parser options
+ */
+const DEFAULT_OPTIONS = {
+    gfm: true,
+    frontmatter: true,
+};
+/**
+ * Create frontmatter extraction plugin
+ */
+function extractFrontmatter() {
+    return (tree, file) => {
+        visit(tree, 'yaml', (node) => {
+            try {
+                const data = parse(node.value);
+                file.data.frontmatter = data;
+            }
+            catch {
+                // Invalid YAML, ignore
+            }
+        });
+    };
+}
+/**
+ * Create a markdown parser with the specified options
+ *
+ * @param options - Parser configuration options
+ * @returns Parser instance with parse method
+ */
+function createParser(options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    const customPlugins = options.plugins || [];
+    // Build processor (使用 any 绕过复杂的类型检查)
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let processor = unified().use(remarkParse);
+    // Add GFM support
+    if (opts.gfm) {
+        processor = processor.use(remarkGfm);
+    }
+    // Add frontmatter support
+    if (opts.frontmatter) {
+        processor = processor.use(remarkFrontmatter, ['yaml']);
+    }
+    // Run custom "before" plugins
+    const beforePlugins = customPlugins.filter((p) => p.phase === 'before');
+    for (const plugin of beforePlugins) {
+        processor = processor.use(() => plugin.transform);
+    }
+    // Add frontmatter extraction
+    if (opts.frontmatter) {
+        processor = processor.use(extractFrontmatter);
+    }
+    // Add built-in transform plugins
+    processor = processor
+        .use(() => transformHeading)
+        .use(() => transformList)
+        .use(() => transformTable);
+    // Run custom "after" plugins
+    const afterPlugins = customPlugins.filter((p) => p.phase === 'after');
+    for (const plugin of afterPlugins) {
+        processor = processor.use(() => plugin.transform);
+    }
+    // Freeze processor
+    processor.freeze();
+    return {
+        parse(content) {
+            // Parse markdown to AST
+            const tree = processor.parse(content);
+            // Run all transform plugins
+            processor.runSync(tree);
+            return tree;
+        },
+    };
+}
+/**
+ * Type-safe helper to define a parser plugin
+ *
+ * @param config - Plugin configuration
+ * @returns Parser plugin
+ */
+function definePlugin(config, options) {
+    return {
+        name: config.name,
+        phase: config.phase,
+        transform: config.transform(options),
+    };
+}
+
+export { createParser, definePlugin, transformHeading, transformList, transformTable };
+//# sourceMappingURL=index.mjs.map

package/packages/parser/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../src/plugins/transform/heading.ts","../src/plugins/transform/list.ts","../src/plugins/transform/table.ts","../src/processor.ts"],"sourcesContent":[null,null,null,null],"names":["parseYaml"],"mappings":";;;;;;;;AAIA;;AAEG;AACH,SAAS,WAAW,CAAC,KAAwB,EAAA;AAC3C,IAAA,OAAO;AACJ,SAAA,GAAG,CAAC,CAAC,IAAI,KAAI;AACZ,QAAA,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE;YACxB,OAAO,IAAI,CAAC,KAAK;QACnB;AACA,QAAA,IAAI,UAAU,IAAI,IAAI,EAAE;AACtB,YAAA,OAAO,WAAW,CAAC,IAAI,CAAC,QAA6B,CAAC;QACxD;AACA,QAAA,OAAO,EAAE;AACX,IAAA,CAAC;SACA,IAAI,CAAC,EAAE,CAAC;AACb;AAEA;;AAEG;AACG,SAAU,gBAAgB,CAAC,IAAU,EAAA;AACzC,IAAA,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU;IAE/B,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,IAAa,KAAI;QACvC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC;QACvC,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC;;QAGvC,MAAM,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE,CAA4B;AACzD,QAAA,IAAI,CAAC,EAAE,GAAG,IAAI;QACd,MAAM,WAAW,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE,CAA2B;AACtE,QAAA,WAAW,CAAC,EAAE,GAAG,IAAI;AACrB,QAAA,IAAI,CAAC,WAAW,GAAG,WAAW;AAC9B,QAAA,IAAI,CAAC,IAAI,GAAG,IAAI;AAClB,IAAA,CAAC,CAAC;AACJ;;AC3BA;;AAEG;AACG,SAAU,aAAa,CAAC,IAAU,EAAA;IACtC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,IAAU,KAAI;QACjC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAc,EAAE,KAAa,KAAI;YACtD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE;AAC3B,YAAA,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK;;AAGvB,YAAA,IAAI,IAAI,CAAC,OAAO,EAAE;AAChB,gBAAA,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC;gBAC7B,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,GAAG,KAAK;YACjC;AACF,QAAA,CAAC,CAAC;AACJ,IAAA,CAAC,CAAC;AACJ;;ACJA;;;;AAIG;AACG,SAAU,cAAc,CAAC,IAAU,EAAA;IACvC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,IAAW,KAAI;AACnC,QAAA,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE;QAEhC,MAAM,CAAC,SAAS,EAAE,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC,QAAQ;AAC9C,QAAA,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE;;QAG9B,IAAI,SAAS,EAAE;YACb,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAe,EAAE,KAAa,KAAI;gBAC5D,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE;AAC3B,gBAAA,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI;gBACzB,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI;AACtC,gBAAA,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,KAAK;AAC/B,YAAA,CAAC,CAAC;QACJ;;AAGA,QAAA,QAAQ,CAAC,OAAO,CAAC,CAAC,GAAG,KAAI;YACvB,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAe,EAAE,KAAa,KAAI;gBACtD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE;AAC3B,gBAAA,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,KAAK;gBAC1B,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI;AACtC,gBAAA,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,KAAK;AAC/B,YAAA,CAAC,CAAC;AACJ,QAAA,CAAC,CAAC;;QAGF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE;AAC3B,QAAA,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,SAAS;AAC5B,QAAA,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,QAAQ;AAC3B,IAAA,CAAC,CAAC;AACJ;;ACjDA;;AAEG;AACH,MAAM,eAAe,GAA6C;AAChE,IAAA,GAAG,EAAE,IAAI;AACT,IAAA,WAAW,EAAE,IAAI;CAClB;AAED;;AAEG;AACH,SAAS,kBAAkB,GAAA;AACzB,IAAA,OAAO,CAAC,IAAU,EAAE,IAAW,KAAI;QACjC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,IAAU,KAAI;AACjC,YAAA,IAAI;gBACF,MAAM,IAAI,GAAGA,KAAS,CAAC,IAAI,CAAC,KAAK,CAA4B;AAC3D,gBAAA,IAAI,CAAC,IAAiB,CAAC,WAAW,GAAG,IAAI;YAC7C;AAAE,YAAA,MAAM;;YAER;AACF,QAAA,CAAC,CAAC;AACJ,IAAA,CAAC;AACH;AAEA;;;;;AAKG;AACG,SAAU,YAAY,CAAC,OAAA,GAAyB,EAAE,EAAA;IACtD,MAAM,IAAI,GAAG,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,EAAE;AAC/C,IAAA,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE;;;IAI3C,IAAI,SAAS,GAAQ,OAAO,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC;;AAG/C,IAAA,IAAI,IAAI,CAAC,GAAG,EAAE;AACZ,QAAA,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC;IACtC;;AAGA,IAAA,IAAI,IAAI,CAAC,WAAW,EAAE;QACpB,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC,MAAM,CAAC,CAAC;IACxD;;AAGA,IAAA,MAAM,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC;AACvE,IAAA,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE;AAClC,QAAA,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC;IACnD;;AAGA,IAAA,IAAI,IAAI,CAAC,WAAW,EAAE;AACpB,QAAA,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAC/C;;AAGA,IAAA,SAAS,GAAG;AACT,SAAA,GAAG,CAAC,MAAM,gBAAgB;AAC1B,SAAA,GAAG,CAAC,MAAM,aAAa;AACvB,SAAA,GAAG,CAAC,MAAM,cAAc,CAAC;;AAG5B,IAAA,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC;AACrE,IAAA,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE;AACjC,QAAA,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC;IACnD;;IAGA,SAAS,CAAC,MAAM,EAAE;IAElB,OAAO;AACL,QAAA,KAAK,CAAC,OAAe,EAAA;;YAEnB,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAS;;AAG7C,YAAA,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;AAEvB,YAAA,OAAO,IAAI;QACb,CAAC;KACF;AACH;AAEA;;;;;AAKG;AACG,SAAU,YAAY,CAC1B,MAIC,EACD,OAAW,EAAA;IAEX,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;AACnB,QAAA,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC;KACrC;AACH;;;;"}