pd-markdown 2.0.3 → 2.0.4-1

package/README.md

@@ -10,6 +10,7 @@
 - 📋 **Frontmatter** - 支持 YAML frontmatter 解析
 - ⚛️ **React 组件** - 提供开箱即用的 React 渲染组件
 - 🎨 **可定制** - 支持自定义组件覆盖（Heading, Code, Table 等）
+- 🚀 **RSC & SSG 友好** - 完美支持 React Server Components，零水和 (Zero Hydration) 成本
 - 🔗 **自动锚点** - 标题自动生成 slug 锚点
 - 📦 **Tree-shakable** - 基于 ESM 设计，支持按需加载，最小化打包体积
 - 🛠️ **现代兼容性** - 完美支持 Subpath Exports，确保在 Next.js、Vite 等现代开发环境下无缝解析
@@ -54,8 +55,36 @@ This is a **markdown** document.
 }
 ```
 
+### 在 Next.js Server Components (RSC) 中使用
+
+`pd-markdown` 深度优化了服务端渲染场景。`MarkdownRenderer` 是一个 **Shared Component**，可以直接在服务端运行，生成纯 HTML，浏览器端**零 JS 负担**。
+
+```tsx
+// app/page.tsx (Next.js Server Component)
+import { getMarkdownAst } from './lib/markdown'
+import { MarkdownRenderer } from 'pd-markdown/web'
+
+export default async function Page() {
+  // 1. 服务端解析 Markdown 为 AST
+  const ast = await getMarkdownAst(content)
+
+  // 2. 服务端直接渲染为静态 HTML
+  return (
+    <main>
+      <MarkdownRenderer ast={ast} />
+    </main>
+  )
+}
+```
+
+> [!TIP]
+> 这种模式完美支持 **SSG (静态站点生成)**，搜索引擎优化 (SEO) 友好且交互响应极快。
+
 ### 流式渲染 (AI 场景)
 
+> [!NOTE]
+> 流式渲染组件 (`StreamMarkdownRenderer`) 需要在客户端运行，已内置 `'use client'` 指令。
+
 ```tsx
 import { StreamMarkdownRenderer, useStreamMarkdown } from 'pd-markdown/web'
 
@@ -164,6 +193,13 @@ import { traverseAst, findNodes, slugify } from 'pd-markdown/utils'
 const headings = findNodes(ast, 'heading')
 ```
 
+## 示例 (Demos)
+
+你可以参考 `examples` 目录下的项目：
+
+- **[web-demo](./examples/web-demo)**: 基础的 Vite/React 客户端渲染示例。
+- **[nextjs-demo](./examples/nextjs-demo)**: 基于 Next.js 15 App Router 的 **Server Components (RSC)** 与 **SSG** 最佳实践示例。
+
 ## 开发
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pd-markdown",
-  "version": "2.0.3",
+  "version": "2.0.4-1",
   "type": "module",
   "main": "./packages/web/dist/index.cjs",
   "module": "./packages/web/dist/index.mjs",
@@ -9,6 +9,7 @@
   "exports": {
     ".": {
       "types": "./packages/web/dist/index.d.ts",
+      "react-server": "./packages/web/dist/server.mjs",
       "import": "./packages/web/dist/index.mjs",
       "require": "./packages/web/dist/index.cjs"
     },
@@ -24,6 +25,7 @@
     },
     "./web": {
       "types": "./packages/web/dist/index.d.ts",
+      "react-server": "./packages/web/dist/server.mjs",
       "import": "./packages/web/dist/index.mjs",
       "require": "./packages/web/dist/index.cjs"
     }
@@ -65,7 +67,10 @@
     "remark-parse": "^11.0.0",
     "unified": "^11.0.5",
     "unist-util-visit": "^5.0.0",
-    "yaml": "^2.7.0"
+    "yaml": "^2.7.0",
+    "pd-markdown-parser": "0.1.0",
+    "pd-markdown-web": "0.1.0",
+    "pd-markdown-utils": "0.1.0"
   },
   "devDependencies": {
     "@rollup/plugin-commonjs": "^28.0.2",
@@ -96,11 +101,13 @@
   },
   "sideEffects": false,
   "scripts": {
-    "build": "pnpm -r run build",
+    "build": "pnpm -r --filter \"./packages/*\" run build",
+    "build:examples": "pnpm -r --filter \"./examples/*\" run build",
+    "build:all": "pnpm -r run build",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --noEmit",
-    "clean": "pnpm -r run clean"
+    "clean": "pnpm -r --filter \"./packages/*\" run clean"
   }
 }

package/packages/parser/dist/index.cjs

@@ -6,7 +6,7 @@ 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');
+var pdMarkdownUtils = require('pd-markdown-utils');
 
 /**
  * Extract text content from phrasing content nodes

package/packages/parser/dist/index.mjs

@@ -1,185 +1,5 @@
-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 };
+export { createParser, definePlugin } from './processor.mjs';
+export { transformHeading } from './plugins/transform/heading.mjs';
+export { transformList } from './plugins/transform/list.mjs';
+export { transformTable } from './plugins/transform/table.mjs';
 //# sourceMappingURL=index.mjs.map

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

@@ -1 +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":"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"}
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;"}

package/packages/parser/dist/plugins/transform/heading.mjs

@@ -0,0 +1,39 @@
+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
+ */
+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;
+    });
+}
+
+export { transformHeading };
+//# sourceMappingURL=heading.mjs.map

package/packages/parser/dist/plugins/transform/heading.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading.mjs","sources":["../../../src/plugins/transform/heading.ts"],"sourcesContent":[null],"names":[],"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;;;;"}

package/packages/parser/dist/plugins/transform/list.mjs

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

package/packages/parser/dist/plugins/transform/list.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.mjs","sources":["../../../src/plugins/transform/list.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAYA;;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;;;;"}

package/packages/parser/dist/plugins/transform/table.mjs

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

package/packages/parser/dist/plugins/transform/table.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.mjs","sources":["../../../src/plugins/transform/table.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAwBA;;;;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;;;;"}

package/packages/parser/dist/processor.mjs

@@ -0,0 +1,100 @@
+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 { transformHeading } from './plugins/transform/heading.mjs';
+import { transformList } from './plugins/transform/list.mjs';
+import { transformTable } from './plugins/transform/table.mjs';
+
+/**
+ * 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 };
+//# sourceMappingURL=processor.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"processor.mjs","sources":["../src/processor.ts"],"sourcesContent":[null],"names":["parseYaml"],"mappings":";;;;;;;;;;AAYA;;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;;;;"}

package/packages/web/dist/MarkdownRenderer-CflS5zy_.js

@@ -0,0 +1,43 @@
+'use strict';
+
+var jsxRuntime = require('react/jsx-runtime');
+var pdMarkdownParser = require('pd-markdown-parser');
+var NodeRenderer = require('./NodeRenderer-DTR-8m1G.js');
+
+// Singleton parser for client-side use
+let defaultParser = null;
+function getParser(options) {
+    if (options) {
+        return pdMarkdownParser.createParser(options);
+    }
+    if (!defaultParser) {
+        defaultParser = pdMarkdownParser.createParser();
+    }
+    return defaultParser;
+}
+/**
+ * Main markdown renderer component
+ *
+ * Supports both client-side and server-side rendering:
+ * - Pass `source` for automatic parsing
+ * - Pass `ast` for pre-parsed content (SSR optimization)
+ */
+const MarkdownRenderer = ({ source, ast, components = {}, className, style, parserOptions, }) => {
+    // Use provided AST or parse source
+    let tree;
+    if (ast) {
+        tree = ast;
+    }
+    else if (source) {
+        const parser = getParser(parserOptions);
+        tree = parser.parse(source);
+    }
+    else {
+        // No content provided
+        return null;
+    }
+    return (jsxRuntime.jsx("div", { className: className, style: style, children: jsxRuntime.jsx(NodeRenderer.NodeRenderer, { node: tree, components: components }) }));
+};
+
+exports.MarkdownRenderer = MarkdownRenderer;
+//# sourceMappingURL=MarkdownRenderer-CflS5zy_.js.map

package/packages/web/dist/MarkdownRenderer-CflS5zy_.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownRenderer-CflS5zy_.js","sources":["../src/components/MarkdownRenderer.tsx"],"sourcesContent":[null],"names":["createParser","_jsx","NodeRenderer"],"mappings":";;;;;;AAqBA;AACA,IAAI,aAAa,GAA2C,IAAI;AAEhE,SAAS,SAAS,CAAC,OAAuB,EAAA;IACxC,IAAI,OAAO,EAAE;AACX,QAAA,OAAOA,6BAAY,CAAC,OAAO,CAAC;IAC9B;IACA,IAAI,CAAC,aAAa,EAAE;QAClB,aAAa,GAAGA,6BAAY,EAAE;IAChC;AACA,IAAA,OAAO,aAAa;AACtB;AAEA;;;;;;AAMG;MACU,gBAAgB,GAA8B,CAAC,EAC1D,MAAM,EACN,GAAG,EACH,UAAU,GAAG,EAAE,EACf,SAAS,EACT,KAAK,EACL,aAAa,GACd,KAAI;;AAEH,IAAA,IAAI,IAAU;IACd,IAAI,GAAG,EAAE;QACP,IAAI,GAAG,GAAG;IACZ;SAAO,IAAI,MAAM,EAAE;AACjB,QAAA,MAAM,MAAM,GAAG,SAAS,CAAC,aAAa,CAAC;AACvC,QAAA,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;IAC7B;SAAO;;AAEL,QAAA,OAAO,IAAI;IACb;IAEA,QACEC,wBAAK,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAA,QAAA,EACrCA,cAAA,CAACC,yBAAY,EAAA,EAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAA,CAAI,EAAA,CAChD;AAEV;;;;"}