pd-markdown 1.0.0

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "pd-markdown",
+  "version": "1.0.0",
+  "type": "module",
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^28.0.2",
+    "@rollup/plugin-node-resolve": "^16.0.0",
+    "@rollup/plugin-typescript": "^12.1.2",
+    "@rollup/rollup-darwin-arm64": "^4.57.1",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@types/node": "^22.13.5",
+    "rollup": "^4.34.8",
+    "rollup-plugin-dts": "^6.1.1",
+    "tslib": "^2.8.1",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.7"
+  },
+  "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/.rollup.cache/Users/pidan/Work/Learn/pd-markdown/packages/parser/dist/index.d.ts

@@ -0,0 +1,4 @@
+export type { Parser, ParserOptions, ParserPlugin, PluginConfig, FrontmatterData, FileData, } from './types';
+export { createParser, definePlugin } from './processor';
+export { transformHeading, transformList, transformTable } from './plugins';
+//# sourceMappingURL=index.d.ts.map

package/packages/parser/.rollup.cache/Users/pidan/Work/Learn/pd-markdown/packages/parser/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,MAAM,EACN,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,QAAQ,GACT,MAAM,SAAS,CAAA;AAGhB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAGxD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA"}

package/packages/parser/.rollup.cache/Users/pidan/Work/Learn/pd-markdown/packages/parser/dist/index.js

@@ -0,0 +1,5 @@
+// Core
+export { createParser, definePlugin } from './processor';
+// Transform plugins (for advanced usage)
+export { transformHeading, transformList, transformTable } from './plugins';
+//# sourceMappingURL=index.js.map

package/packages/parser/.rollup.cache/Users/pidan/Work/Learn/pd-markdown/packages/parser/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,OAAO;AACP,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAExD,yCAAyC;AACzC,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA"}

package/packages/parser/.rollup.cache/Users/pidan/Work/Learn/pd-markdown/packages/parser/dist/plugins/index.d.ts

@@ -0,0 +1,4 @@
+export { transformHeading } from './transform/heading';
+export { transformList } from './transform/list';
+export { transformTable } from './transform/table';
+//# sourceMappingURL=index.d.ts.map

package/packages/parser/.rollup.cache/Users/pidan/Work/Learn/pd-markdown/packages/parser/dist/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA"}

package/packages/parser/.rollup.cache/Users/pidan/Work/Learn/pd-markdown/packages/parser/dist/plugins/index.js

@@ -0,0 +1,4 @@
+export { transformHeading } from './transform/heading';
+export { transformList } from './transform/list';
+export { transformTable } from './transform/table';
+//# sourceMappingURL=index.js.map

package/packages/parser/.rollup.cache/Users/pidan/Work/Learn/pd-markdown/packages/parser/dist/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA"}

package/packages/parser/.rollup.cache/Users/pidan/Work/Learn/pd-markdown/packages/parser/dist/plugins/transform/heading.d.ts

@@ -0,0 +1,6 @@
+import type { Root } from 'mdast';
+/**
+ * Transform plugin that adds slug IDs to headings
+ */
+export declare function transformHeading(tree: Root): void;
+//# sourceMappingURL=heading.d.ts.map

package/packages/parser/.rollup.cache/Users/pidan/Work/Learn/pd-markdown/packages/parser/dist/plugins/transform/heading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading.d.ts","sourceRoot":"","sources":["../../../src/plugins/transform/heading.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAA4B,MAAM,OAAO,CAAA;AAqB3D;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAejD"}

package/packages/parser/.rollup.cache/Users/pidan/Work/Learn/pd-markdown/packages/parser/dist/plugins/transform/heading.js

@@ -0,0 +1,36 @@
+import { visit } from 'unist-util-visit';
+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
+ */
+export 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;
+    });
+}
+//# sourceMappingURL=heading.js.map

package/packages/parser/.rollup.cache/Users/pidan/Work/Learn/pd-markdown/packages/parser/dist/plugins/transform/heading.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading.js","sourceRoot":"","sources":["../../../src/plugins/transform/heading.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD;;GAEG;AACH,SAAS,WAAW,CAAC,KAAwB;IAC3C,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,KAAK,CAAA;QACnB,CAAC;QACD,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;YACvB,OAAO,WAAW,CAAC,IAAI,CAAC,QAA6B,CAAC,CAAA;QACxD,CAAC;QACD,OAAO,EAAE,CAAA;IACX,CAAC,CAAC;SACD,IAAI,CAAC,EAAE,CAAC,CAAA;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAU;IACzC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAA;IAE/B,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,IAAa,EAAE,EAAE;QACvC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACvC,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QAEvC,kCAAkC;QAClC,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAA;QACzD,IAAI,CAAC,EAAE,GAAG,IAAI,CAAA;QACd,MAAM,WAAW,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAA2B,CAAA;QACtE,WAAW,CAAC,EAAE,GAAG,IAAI,CAAA;QACrB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/packages/parser/.rollup.cache/Users/pidan/Work/Learn/pd-markdown/packages/parser/dist/plugins/transform/list.d.ts

@@ -0,0 +1,14 @@
+import type { Root } from 'mdast';
+/**
+ * Extended list item with index
+ */
+declare module 'mdast' {
+    interface ListItemData {
+        index?: number;
+    }
+}
+/**
+ * Transform plugin that adds index to list items
+ */
+export declare function transformList(tree: Root): void;
+//# sourceMappingURL=list.d.ts.map

package/packages/parser/.rollup.cache/Users/pidan/Work/Learn/pd-markdown/packages/parser/dist/plugins/transform/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/plugins/transform/list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAkB,MAAM,OAAO,CAAA;AAGjD;;GAEG;AACH,OAAO,QAAQ,OAAO,CAAC;IACrB,UAAU,YAAY;QACpB,KAAK,CAAC,EAAE,MAAM,CAAA;KACf;CACF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAa9C"}

package/packages/parser/.rollup.cache/Users/pidan/Work/Learn/pd-markdown/packages/parser/dist/plugins/transform/list.js

@@ -0,0 +1,18 @@
+import { visit } from 'unist-util-visit';
+/**
+ * Transform plugin that adds index to list items
+ */
+export 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;
+            }
+        });
+    });
+}
+//# sourceMappingURL=list.js.map

package/packages/parser/.rollup.cache/Users/pidan/Work/Learn/pd-markdown/packages/parser/dist/plugins/transform/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/plugins/transform/list.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAWxC;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAU;IACtC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,IAAU,EAAE,EAAE;QACjC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAc,EAAE,KAAa,EAAE,EAAE;YACtD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAA;YAC3B,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;YAEvB,kDAAkD;YAClD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAA;gBAC7B,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,GAAG,KAAK,CAAA;YACjC,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/packages/parser/.rollup.cache/Users/pidan/Work/Learn/pd-markdown/packages/parser/dist/plugins/transform/table.d.ts

@@ -0,0 +1,27 @@
+import type { Root } from 'mdast';
+/**
+ * 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
+ */
+export declare function transformTable(tree: Root): void;
+//# sourceMappingURL=table.d.ts.map

package/packages/parser/.rollup.cache/Users/pidan/Work/Learn/pd-markdown/packages/parser/dist/plugins/transform/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../src/plugins/transform/table.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAoB,MAAM,OAAO,CAAA;AAGnD;;GAEG;AACH,OAAO,QAAQ,OAAO,CAAC;IACrB,UAAU,SAAS;QACjB,iBAAiB;QACjB,MAAM,CAAC,EAAE,QAAQ,CAAA;QACjB,gBAAgB;QAChB,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAA;KAClB;IAED,UAAU,aAAa;QACrB,qCAAqC;QACrC,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,uBAAuB;QACvB,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAA;QAC1C,mBAAmB;QACnB,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB;CACF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAgC/C"}

package/packages/parser/.rollup.cache/Users/pidan/Work/Learn/pd-markdown/packages/parser/dist/plugins/transform/table.js

@@ -0,0 +1,37 @@
+import { visit } from 'unist-util-visit';
+/**
+ * Transform plugin that enhances table structure
+ * - Separates header and body rows
+ * - Adds alignment and index info to cells
+ */
+export 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;
+    });
+}
+//# sourceMappingURL=table.js.map

package/packages/parser/.rollup.cache/Users/pidan/Work/Learn/pd-markdown/packages/parser/dist/plugins/transform/table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.js","sourceRoot":"","sources":["../../../src/plugins/transform/table.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAuBxC;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAU;IACvC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,IAAW,EAAE,EAAE;QACnC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QAEtC,MAAM,CAAC,SAAS,EAAE,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAA;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAA;QAE9B,4BAA4B;QAC5B,IAAI,SAAS,EAAE,CAAC;YACd,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAe,EAAE,KAAa,EAAE,EAAE;gBAC5D,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAA;gBAC3B,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;gBACzB,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,CAAA;gBACtC,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,KAAK,CAAA;YAC/B,CAAC,CAAC,CAAA;QACJ,CAAC;QAED,kBAAkB;QAClB,QAAQ,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YACvB,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAe,EAAE,KAAa,EAAE,EAAE;gBACtD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAA;gBAC3B,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAA;gBAC1B,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,CAAA;gBACtC,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,KAAK,CAAA;YAC/B,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;QAEF,sCAAsC;QACtC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAA;QAC3B,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,SAAS,CAAA;QAC5B,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAA;IAC3B,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/packages/parser/.rollup.cache/Users/pidan/Work/Learn/pd-markdown/packages/parser/dist/processor.d.ts

@@ -0,0 +1,22 @@
+import type { Root } from 'mdast';
+import type { VFile } from 'vfile';
+import type { Parser, ParserOptions, ParserPlugin } from './types';
+/**
+ * Create a markdown parser with the specified options
+ *
+ * @param options - Parser configuration options
+ * @returns Parser instance with parse method
+ */
+export declare function createParser(options?: ParserOptions): Parser;
+/**
+ * Type-safe helper to define a parser plugin
+ *
+ * @param config - Plugin configuration
+ * @returns Parser plugin
+ */
+export declare function definePlugin<T = void>(config: {
+    name: string;
+    phase: 'before' | 'after';
+    transform: (options?: T) => (tree: Root, file: VFile) => void;
+}, options?: T): ParserPlugin;
+//# sourceMappingURL=processor.d.ts.map

package/packages/parser/.rollup.cache/Users/pidan/Work/Learn/pd-markdown/packages/parser/dist/processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor.d.ts","sourceRoot":"","sources":["../src/processor.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,IAAI,EAAQ,MAAM,OAAO,CAAA;AACvC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAElC,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAY,MAAM,SAAS,CAAA;AA2B5E;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM,CAuDhE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,IAAI,EACnC,MAAM,EAAE;IACN,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAA;IACzB,SAAS,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,KAAK,IAAI,CAAA;CAC9D,EACD,OAAO,CAAC,EAAE,CAAC,GACV,YAAY,CAMd"}

package/packages/parser/.rollup.cache/Users/pidan/Work/Learn/pd-markdown/packages/parser/dist/processor.js

@@ -0,0 +1,95 @@
+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 as parseYaml } from 'yaml';
+import { transformHeading, transformList, transformTable } from './plugins';
+/**
+ * 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 = parseYaml(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
+ */
+export 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
+ */
+export function definePlugin(config, options) {
+    return {
+        name: config.name,
+        phase: config.phase,
+        transform: config.transform(options),
+    };
+}
+//# sourceMappingURL=processor.js.map

package/packages/parser/.rollup.cache/Users/pidan/Work/Learn/pd-markdown/packages/parser/dist/processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor.js","sourceRoot":"","sources":["../src/processor.ts"],"names":[],"mappings":"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"}

package/packages/parser/.rollup.cache/Users/pidan/Work/Learn/pd-markdown/packages/parser/dist/types/index.d.ts

@@ -0,0 +1,55 @@
+import type { Root } from 'mdast';
+import type { VFile } from 'vfile';
+/**
+ * Parser plugin configuration
+ */
+export 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
+ */
+export interface ParserOptions {
+    /** Custom plugins to add */
+    plugins?: ParserPlugin[];
+    /** Enable GFM syntax (default: true) */
+    gfm?: boolean;
+    /** Enable frontmatter parsing (default: true) */
+    frontmatter?: boolean;
+}
+/**
+ * Parser instance
+ */
+export interface Parser {
+    /** Parse markdown string to AST */
+    parse(content: string): Root;
+}
+/**
+ * Plugin definition helper config
+ */
+export 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
+ */
+export interface FrontmatterData {
+    [key: string]: unknown;
+}
+/**
+ * Extended file data with frontmatter
+ */
+export interface FileData {
+    frontmatter?: FrontmatterData;
+}
+//# sourceMappingURL=index.d.ts.map

package/packages/parser/.rollup.cache/Users/pidan/Work/Learn/pd-markdown/packages/parser/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AACjC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAElC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,uDAAuD;IACvD,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAA;IACzB,yBAAyB;IACzB,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,KAAK,IAAI,CAAA;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,4BAA4B;IAC5B,OAAO,CAAC,EAAE,YAAY,EAAE,CAAA;IACxB,wCAAwC;IACxC,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,iDAAiD;IACjD,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,mCAAmC;IACnC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,kBAAkB;IAClB,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAA;IACzB,iCAAiC;IACjC,SAAS,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,KAAK,IAAI,CAAA;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,WAAW,CAAC,EAAE,eAAe,CAAA;CAC9B"}

package/packages/parser/.rollup.cache/Users/pidan/Work/Learn/pd-markdown/packages/parser/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/packages/parser/.rollup.cache/Users/pidan/Work/Learn/pd-markdown/packages/parser/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/packages/parser/__tests__/frontmatter.test.ts

@@ -0,0 +1,69 @@
+import { describe, it, expect } from 'vitest'
+import { createParser } from '../src/processor'
+import type { Yaml } from 'mdast'
+
+describe('Frontmatter support', () => {
+  describe('YAML frontmatter', () => {
+    it('should parse YAML frontmatter block', () => {
+      const parser = createParser({ frontmatter: true })
+      const ast = parser.parse(`---
+title: My Article
+author: John Doe
+date: 2024-01-01
+---
+
+# Content here`)
+
+      expect(ast.children[0].type).toBe('yaml')
+      const yaml = ast.children[0] as Yaml
+      expect(yaml.value).toContain('title: My Article')
+    })
+
+    it('should parse nested YAML values', () => {
+      const parser = createParser({ frontmatter: true })
+      const ast = parser.parse(`---
+meta:
+  keywords:
+    - markdown
+    - parser
+  category: tech
+---
+
+Content`)
+
+      const yaml = ast.children[0] as Yaml
+      expect(yaml.value).toContain('keywords:')
+    })
+
+    it('should handle empty frontmatter', () => {
+      const parser = createParser({ frontmatter: true })
+      const ast = parser.parse(`---
+---
+
+Content`)
+
+      expect(ast.children[0].type).toBe('yaml')
+    })
+  })
+
+  describe('without frontmatter', () => {
+    it('should not parse frontmatter when disabled', () => {
+      const parser = createParser({ frontmatter: false })
+      const ast = parser.parse(`---
+title: Test
+---
+
+Content`)
+
+      // First child should be thematicBreak, not yaml
+      expect(ast.children[0].type).toBe('thematicBreak')
+    })
+
+    it('should parse content without frontmatter', () => {
+      const parser = createParser({ frontmatter: true })
+      const ast = parser.parse('# Just a heading\n\nSome content')
+
+      expect(ast.children[0].type).toBe('heading')
+    })
+  })
+})

package/packages/parser/__tests__/gfm.test.ts

@@ -0,0 +1,83 @@
+import { describe, it, expect } from 'vitest'
+import { createParser } from '../src/processor'
+import type { Table, List, ListItem } from 'mdast'
+
+describe('GFM syntax support', () => {
+  const parser = createParser({ gfm: true })
+
+  describe('tables', () => {
+    it('should parse basic table', () => {
+      const ast = parser.parse(`
+| Header 1 | Header 2 |
+|----------|----------|
+| Cell 1   | Cell 2   |
+| Cell 3   | Cell 4   |
+      `.trim())
+
+      const table = ast.children[0] as Table
+      expect(table.type).toBe('table')
+      expect(table.children).toHaveLength(3) // 1 header + 2 body rows
+    })
+
+    it('should parse table with alignment', () => {
+      const ast = parser.parse(`
+| Left | Center | Right |
+|:-----|:------:|------:|
+| L    | C      | R     |
+      `.trim())
+
+      const table = ast.children[0] as Table
+      expect(table.align).toEqual(['left', 'center', 'right'])
+    })
+  })
+
+  describe('task lists', () => {
+    it('should parse checked items', () => {
+      const ast = parser.parse('- [x] Completed task')
+
+      const list = ast.children[0] as List
+      const item = list.children[0] as ListItem
+      expect(item.checked).toBe(true)
+    })
+
+    it('should parse unchecked items', () => {
+      const ast = parser.parse('- [ ] Pending task')
+
+      const list = ast.children[0] as List
+      const item = list.children[0] as ListItem
+      expect(item.checked).toBe(false)
+    })
+
+    it('should parse mixed task list', () => {
+      const ast = parser.parse(`
+- [x] Done
+- [ ] Not done
+- Regular item
+      `.trim())
+
+      const list = ast.children[0] as List
+      expect(list.children[0].checked).toBe(true)
+      expect(list.children[1].checked).toBe(false)
+      expect(list.children[2].checked).toBeNull()
+    })
+  })
+
+  describe('strikethrough', () => {
+    it('should parse strikethrough text', () => {
+      const ast = parser.parse('~~deleted text~~')
+
+      const paragraph = ast.children[0]
+      expect(paragraph.type).toBe('paragraph')
+      expect((paragraph as any).children[0].type).toBe('delete')
+    })
+  })
+
+  describe('autolinks', () => {
+    it('should parse URL autolinks', () => {
+      const ast = parser.parse('Visit https://example.com for more')
+
+      const paragraph = ast.children[0]
+      expect((paragraph as any).children[1].type).toBe('link')
+    })
+  })
+})