@chenzy-design/svelte 0.3.0 → 0.4.1

package/dist/markdown-render/components/MdLink.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MdLink.svelte.d.ts","sourceRoot":"","sources":["../../../src/markdown-render/components/MdLink.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAIpC,UAAU,KAAK;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AA4BH,QAAA,MAAM,MAAM,2CAAwC,CAAC;AACrD,KAAK,MAAM,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,CAAC;AACxC,eAAe,MAAM,CAAC"}

package/dist/markdown-render/components/MdParagraph.svelte

@@ -0,0 +1,19 @@
+<!--
+  MdParagraph — MarkdownRender 默认 p 覆盖（严格对齐 Semi markdownRender components/p.tsx）。
+  Semi：<Typography.Paragraph className="semi-markdownRender-component-p" />。
+-->
+<script lang="ts">
+  import type { Snippet } from 'svelte';
+  import { Paragraph } from '../../typography/index.js';
+
+  interface Props {
+    children?: Snippet;
+    [key: string]: unknown;
+  }
+
+  let { children }: Props = $props();
+</script>
+
+<Paragraph class="cd-markdown-render-component-p">
+  {#if children}{@render children()}{/if}
+</Paragraph>

package/dist/markdown-render/components/MdParagraph.svelte.d.ts

@@ -0,0 +1,9 @@
+import type { Snippet } from 'svelte';
+interface Props {
+    children?: Snippet;
+    [key: string]: unknown;
+}
+declare const MdParagraph: import("svelte").Component<Props, {}, "">;
+type MdParagraph = ReturnType<typeof MdParagraph>;
+export default MdParagraph;
+//# sourceMappingURL=MdParagraph.svelte.d.ts.map

package/dist/markdown-render/components/MdParagraph.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MdParagraph.svelte.d.ts","sourceRoot":"","sources":["../../../src/markdown-render/components/MdParagraph.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAIpC,UAAU,KAAK;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAgBH,QAAA,MAAM,WAAW,2CAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}

package/dist/markdown-render/components/MdPre.svelte

@@ -0,0 +1,48 @@
+<!--
+  MdPre — MarkdownRender 围栏代码块覆盖（对齐 Semi code.tsx 有语言分支）。
+  拦截 pre 键：从 pre > code 提取纯文本与 language-<lang> 类名。
+  - 有语言 → <CodeHighlight code language lineNumber />（对齐链 chat→markdown→codeHighlight，
+    lineNumber=true / defaultTheme 取 CodeHighlight 默认 true，与 Semi 一致）。
+  - 无语言 → 纯 <pre><code>（保留结构，无高亮）。
+  注：Semi 靠 MDX 把 fenced code 扁平成 code 元素后注册 code 键；本库标准 remark-rehype
+  产出 pre>code，故拦截 pre 键达到同样「CodeHighlight 作为块级、无嵌套」的结果。
+-->
+<script lang="ts">
+  import type { Element, ElementContent } from 'hast';
+  import { CodeHighlight } from '../../code-highlight/index.js';
+
+  interface Props {
+    node?: Element;
+    [key: string]: unknown;
+  }
+
+  let { node }: Props = $props();
+
+  const codeEl = $derived(
+    node?.children?.find(
+      (c: ElementContent): c is Element => c.type === 'element' && c.tagName === 'code',
+    ),
+  );
+
+  function extractText(el: ElementContent): string {
+    if (el.type === 'text') return el.value;
+    if (el.type === 'element' && el.children) {
+      return el.children.map((c: ElementContent) => extractText(c)).join('');
+    }
+    return '';
+  }
+  const code = $derived(codeEl ? extractText(codeEl) : '');
+
+  const language = $derived.by(() => {
+    const cn = codeEl?.properties?.className;
+    const classes = Array.isArray(cn) ? cn.map(String) : cn ? [String(cn)] : [];
+    const langClass = classes.find((c) => c.startsWith('language-'));
+    return langClass ? langClass.slice('language-'.length) : undefined;
+  });
+</script>
+
+{#if language}
+  <CodeHighlight {code} {language} lineNumber />
+{:else}
+  <pre><code>{code}</code></pre>
+{/if}

package/dist/markdown-render/components/MdPre.svelte.d.ts

@@ -0,0 +1,9 @@
+import type { Element } from 'hast';
+interface Props {
+    node?: Element;
+    [key: string]: unknown;
+}
+declare const MdPre: import("svelte").Component<Props, {}, "">;
+type MdPre = ReturnType<typeof MdPre>;
+export default MdPre;
+//# sourceMappingURL=MdPre.svelte.d.ts.map

package/dist/markdown-render/components/MdPre.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MdPre.svelte.d.ts","sourceRoot":"","sources":["../../../src/markdown-render/components/MdPre.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAkB,MAAM,MAAM,CAAC;AAIlD,UAAU,KAAK;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAwCH,QAAA,MAAM,KAAK,2CAAwC,CAAC;AACpD,KAAK,KAAK,GAAG,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC;AACtC,eAAe,KAAK,CAAC"}

package/dist/markdown-render/components/MdTable.svelte

@@ -0,0 +1,53 @@
+<!--
+  MdTable — MarkdownRender 默认 table 覆盖（严格对齐 Semi markdownRender components/table.tsx）。
+  Semi 把 thead/tbody 解析成 Semi Table 的 columns/dataSource。这里从 hast table 节点
+  （table > thead > tr > th / tbody > tr > td）解析等价结构，渲染本库 Table。
+-->
+<script lang="ts">
+  import type { Element, ElementContent } from 'hast';
+  import Table from '../../table/Table.svelte';
+
+  interface Props {
+    node?: Element;
+    [key: string]: unknown;
+  }
+
+  let { node }: Props = $props();
+
+  function isEl(c: ElementContent, tag?: string): c is Element {
+    return c.type === 'element' && (!tag || c.tagName === tag);
+  }
+  function childEls(el: Element | undefined, tag?: string): Element[] {
+    if (!el?.children) return [];
+    return el.children.filter((c): c is Element => isEl(c, tag));
+  }
+  function text(el: ElementContent): string {
+    if (el.type === 'text') return el.value;
+    if (el.type === 'element' && el.children) return el.children.map(text).join('');
+    return '';
+  }
+
+  const thead = $derived(childEls(node, 'thead')[0]);
+  const tbody = $derived(childEls(node, 'tbody')[0]);
+
+  // 表头：thead > tr > th → columns（dataIndex 用列序号，对齐 Semi）。
+  const columns = $derived.by(() => {
+    const headTr = childEls(thead, 'tr')[0];
+    const ths = childEls(headTr).filter((c) => c.tagName === 'th' || c.tagName === 'td');
+    return ths.map((th, i) => ({ dataIndex: String(i), title: text(th) }));
+  });
+
+  // 数据行：tbody > tr → dataSource（每行 td 按列序号存）。
+  const dataSource = $derived.by(() => {
+    const rows = childEls(tbody, 'tr');
+    return rows.map((tr, ri) => {
+      const item: Record<string, string> = { key: String(ri) };
+      childEls(tr).forEach((td, ci) => {
+        item[String(ci)] = text(td);
+      });
+      return item;
+    });
+  });
+</script>
+
+<Table {columns} {dataSource} />

package/dist/markdown-render/components/MdTable.svelte.d.ts

@@ -0,0 +1,9 @@
+import type { Element } from 'hast';
+interface Props {
+    node?: Element;
+    [key: string]: unknown;
+}
+declare const MdTable: import("svelte").Component<Props, {}, "">;
+type MdTable = ReturnType<typeof MdTable>;
+export default MdTable;
+//# sourceMappingURL=MdTable.svelte.d.ts.map

package/dist/markdown-render/components/MdTable.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MdTable.svelte.d.ts","sourceRoot":"","sources":["../../../src/markdown-render/components/MdTable.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAkB,MAAM,MAAM,CAAC;AAIlD,UAAU,KAAK;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAiDH,QAAA,MAAM,OAAO,2CAAwC,CAAC;AACtD,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;AAC1C,eAAe,OAAO,CAAC"}

package/dist/markdown-render/components/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * MarkdownRender 默认组件映射（严格对齐 Semi markdownRender/components/index.tsx）。
+ * Semi 注册 11 键：h1-h6 / p / a / img / table / code。逐一映射到本库组件：
+ *  - h1-h6 → Typography.Title（MdHeading 按 tagName 推 heading 级别）
+ *  - p     → Typography.Paragraph（MdParagraph）
+ *  - a     → Typography.Text link（MdLink）
+ *  - img   → div > Image + alt（MdImage）
+ *  - table → 本库 Table（MdTable，从 hast 解析 columns/dataSource）
+ *  - code  → 有语言 CodeHighlight / 无语言 span.simple-code（MdCode）
+ */
+import type { Component } from 'svelte';
+import MdHeading from './MdHeading.svelte';
+import MdParagraph from './MdParagraph.svelte';
+import MdLink from './MdLink.svelte';
+import MdImage from './MdImage.svelte';
+import MdTable from './MdTable.svelte';
+import MdCode from './MdCode.svelte';
+import MdPre from './MdPre.svelte';
+export { MdHeading, MdParagraph, MdLink, MdImage, MdTable, MdCode, MdPre };
+/**
+ * 默认可覆盖元素集合（对齐 Semi SemiMarkdownComponents 的 11 键 h1-h6/p/a/img/table/code）。
+ * 本库标准 remark-rehype 产出 pre>code，故围栏代码块用 pre 键（MdPre）拦截整块渲染
+ * CodeHighlight，code 键（MdCode）只处理行内 code——最终 DOM 与 Semi 一致（无 pre 嵌套）。
+ */
+export declare const defaultComponents: Record<string, Component<Record<string, unknown>>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/markdown-render/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/markdown-render/components/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,SAAS,MAAM,oBAAoB,CAAC;AAC3C,OAAO,WAAW,MAAM,sBAAsB,CAAC;AAC/C,OAAO,MAAM,MAAM,iBAAiB,CAAC;AACrC,OAAO,OAAO,MAAM,kBAAkB,CAAC;AACvC,OAAO,OAAO,MAAM,kBAAkB,CAAC;AACvC,OAAO,MAAM,MAAM,iBAAiB,CAAC;AACrC,OAAO,KAAK,MAAM,gBAAgB,CAAC;AAEnC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAE3E;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAahF,CAAC"}

package/dist/markdown-render/components/index.js

@@ -0,0 +1,27 @@
+import MdHeading from './MdHeading.svelte';
+import MdParagraph from './MdParagraph.svelte';
+import MdLink from './MdLink.svelte';
+import MdImage from './MdImage.svelte';
+import MdTable from './MdTable.svelte';
+import MdCode from './MdCode.svelte';
+import MdPre from './MdPre.svelte';
+export { MdHeading, MdParagraph, MdLink, MdImage, MdTable, MdCode, MdPre };
+/**
+ * 默认可覆盖元素集合（对齐 Semi SemiMarkdownComponents 的 11 键 h1-h6/p/a/img/table/code）。
+ * 本库标准 remark-rehype 产出 pre>code，故围栏代码块用 pre 键（MdPre）拦截整块渲染
+ * CodeHighlight，code 键（MdCode）只处理行内 code——最终 DOM 与 Semi 一致（无 pre 嵌套）。
+ */
+export const defaultComponents = {
+    h1: MdHeading,
+    h2: MdHeading,
+    h3: MdHeading,
+    h4: MdHeading,
+    h5: MdHeading,
+    h6: MdHeading,
+    p: MdParagraph,
+    a: MdLink,
+    img: MdImage,
+    table: MdTable,
+    code: MdCode,
+    pre: MdPre,
+};

package/dist/markdown-render/index.d.ts

@@ -0,0 +1,4 @@
+export { default as MarkdownRender, defaultComponents } from './MarkdownRender.svelte';
+export { meta as markdownRenderMeta } from './meta.js';
+export type { HastRoot, CompileToHastOptions, UnifiedPluginEntry, } from '@chenzy-design/core';
+//# sourceMappingURL=index.d.ts.map

package/dist/markdown-render/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/markdown-render/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACvF,OAAO,EAAE,IAAI,IAAI,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACvD,YAAY,EACV,QAAQ,EACR,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC"}

package/dist/markdown-render/index.js

@@ -0,0 +1,2 @@
+export { default as MarkdownRender, defaultComponents } from './MarkdownRender.svelte';
+export { meta as markdownRenderMeta } from './meta.js';

package/dist/markdown-render/meta.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * MarkdownRender — 对标 Semi Design MarkdownRender，用 unified 管线（remark/rehype）替代 MDX。
+ */
+export declare const meta: {
+    readonly name: "MarkdownRender";
+    readonly category: "plus";
+    readonly description: "Markdown 渲染组件（严格对齐 Semi markdownRender，用 unified 管线替代 MDX）：remark-parse + 条件 remark-gfm + remark-rehype + 透传 remark/rehype 插件把 raw 编译成 hast，再由 Svelte 递归渲染。默认组件映射对齐 Semi 11 键：h1-h6→Typography.Title（cd-markdown-render-component-header）、p→Typography.Paragraph（-component-p）、a→Typography.Text link、img→div.-component-image>Image+alt、table→Table、行内 code→span.-simple-code、围栏代码块→CodeHighlight(lineNumber)。标题字号/行高/颜色由 Typography 承担（Semi 亦然），组件只补 Semi 定义的 margin/simpleCode/image 样式（20 token 镜像 Semi variables.scss）。支持 components 覆盖；默认剥离 raw HTML（对齐 Semi format=md，保留需自传 rehype-raw 自负 XSS）。不支持 md 正文里任意 JSX 表达式求值（Semi format=mdx 深度能力，Svelte 无 jsx-runtime，运行时模型硬不兼容）。";
+    readonly exports: readonly ["MarkdownRender", "defaultComponents"];
+    readonly props: readonly [{
+        readonly name: "raw";
+        readonly type: "string";
+        readonly default: "''";
+        readonly desc: "Markdown 源码";
+    }, {
+        readonly name: "components";
+        readonly type: "Record<string, Component | string>";
+        readonly default: "undefined";
+        readonly desc: "元素覆盖 / 自定义标签注册；浅合并覆盖 defaultComponents（值为 string 时别名到另一原生标签）";
+    }, {
+        readonly name: "format";
+        readonly type: "'md'";
+        readonly default: "'md'";
+        readonly desc: "仅支持 md（unified 管线）；mdx 不支持（Svelte 无 JSX runtime）";
+    }, {
+        readonly name: "remarkGfm";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "启用 GitHub Flavored Markdown（表格 / 任务列表 / 删除线 / 自动链接）";
+    }, {
+        readonly name: "remarkPlugins";
+        readonly type: "UnifiedPluginEntry[]";
+        readonly default: "undefined";
+        readonly desc: "透传 remark 插件（mdast 阶段），支持 plugin 或 [plugin, options] 元组";
+    }, {
+        readonly name: "rehypePlugins";
+        readonly type: "UnifiedPluginEntry[]";
+        readonly default: "undefined";
+        readonly desc: "透传 rehype 插件（hast 阶段）；传 rehype-raw 可保留 raw HTML（自负 XSS）";
+    }, {
+        readonly name: "class";
+        readonly type: "string";
+        readonly default: "''";
+        readonly desc: "根容器附加类名";
+    }, {
+        readonly name: "style";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "根容器内联样式";
+    }];
+    readonly events: readonly [];
+    readonly slots: readonly [];
+    readonly a11y: {
+        readonly hasRole: false;
+        readonly focusable: false;
+        readonly note: "渲染语义化 HTML（标题 / 列表 / 表格 / 链接等）保留原生可访问性；外链自动补 rel=noopener noreferrer + target=_blank；默认剥离 raw HTML 规避注入；图片 alt 由 Markdown 源码 `![alt](url)` 提供。";
+    };
+    readonly overridableTags: readonly ["h1", "h2", "h3", "h4", "h5", "h6", "p", "a", "img", "table", "code", "pre"];
+    readonly tokens: readonly ["--cd-markdown-render-image-margin-left", "--cd-markdown-render-image-margin-right", "--cd-markdown-render-image-margin-top", "--cd-markdown-render-image-margin-bottom", "--cd-markdown-render-image-max-width", "--cd-markdown-render-image-max-height", "--cd-markdown-render-image-alt-margin-top", "--cd-markdown-render-image-alt-color", "--cd-markdown-render-header1-margin-top", "--cd-markdown-render-header1-margin-bottom", "--cd-markdown-render-header2-margin-top", "--cd-markdown-render-header2-margin-bottom", "--cd-markdown-render-header3-margin-top", "--cd-markdown-render-header3-margin-bottom", "--cd-markdown-render-header4-margin-top", "--cd-markdown-render-header4-margin-bottom", "--cd-markdown-render-header5-margin-top", "--cd-markdown-render-header5-margin-bottom", "--cd-markdown-render-simple-code-bg", "--cd-markdown-render-simple-code-text", "--cd-markdown-render-list-color"];
+    readonly responsive: false;
+    readonly examples: readonly [{
+        readonly title: "基础渲染";
+        readonly code: "<MarkdownRender raw={`# 标题\\n\\n正文 **加粗** 与 [链接](https://example.com)。`} />";
+    }, {
+        readonly title: "GFM 表格 / 任务列表";
+        readonly code: "<MarkdownRender raw={`| a | b |\\n| - | - |\\n| 1 | 2 |\\n\\n- [x] done\\n- [ ] todo`} />";
+    }, {
+        readonly title: "覆盖 h1 为自定义 Svelte 组件";
+        readonly code: "<MarkdownRender raw=\"# 你好\" components={{ h1: MyHeading }} />";
+    }, {
+        readonly title: "注册自定义标签（配合 remark 插件产出的节点）";
+        readonly code: "<MarkdownRender raw={md} components={{ callout: Callout }} remarkPlugins={[myDirectivePlugin]} />";
+    }, {
+        readonly title: "保留 raw HTML（自负 XSS）";
+        readonly code: "import rehypeRaw from 'rehype-raw';\n<MarkdownRender raw={htmlMd} rehypePlugins={[rehypeRaw]} />";
+    }, {
+        readonly title: "关闭 GFM";
+        readonly code: "<MarkdownRender raw={md} remarkGfm={false} />";
+    }];
+};
+//# sourceMappingURL=meta.d.ts.map

package/dist/markdown-render/meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/markdown-render/meta.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqGP,CAAC"}

package/dist/markdown-render/meta.js

@@ -0,0 +1,105 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * MarkdownRender — 对标 Semi Design MarkdownRender，用 unified 管线（remark/rehype）替代 MDX。
+ */
+export const meta = {
+    name: 'MarkdownRender',
+    category: 'plus',
+    description: 'Markdown 渲染组件（严格对齐 Semi markdownRender，用 unified 管线替代 MDX）：remark-parse + 条件 remark-gfm + remark-rehype + 透传 remark/rehype 插件把 raw 编译成 hast，再由 Svelte 递归渲染。默认组件映射对齐 Semi 11 键：h1-h6→Typography.Title（cd-markdown-render-component-header）、p→Typography.Paragraph（-component-p）、a→Typography.Text link、img→div.-component-image>Image+alt、table→Table、行内 code→span.-simple-code、围栏代码块→CodeHighlight(lineNumber)。标题字号/行高/颜色由 Typography 承担（Semi 亦然），组件只补 Semi 定义的 margin/simpleCode/image 样式（20 token 镜像 Semi variables.scss）。支持 components 覆盖；默认剥离 raw HTML（对齐 Semi format=md，保留需自传 rehype-raw 自负 XSS）。不支持 md 正文里任意 JSX 表达式求值（Semi format=mdx 深度能力，Svelte 无 jsx-runtime，运行时模型硬不兼容）。',
+    exports: ['MarkdownRender', 'defaultComponents'],
+    props: [
+        { name: 'raw', type: 'string', default: "''", desc: 'Markdown 源码' },
+        {
+            name: 'components',
+            type: 'Record<string, Component | string>',
+            default: 'undefined',
+            desc: '元素覆盖 / 自定义标签注册；浅合并覆盖 defaultComponents（值为 string 时别名到另一原生标签）',
+        },
+        {
+            name: 'format',
+            type: "'md'",
+            default: "'md'",
+            desc: '仅支持 md（unified 管线）；mdx 不支持（Svelte 无 JSX runtime）',
+        },
+        {
+            name: 'remarkGfm',
+            type: 'boolean',
+            default: 'true',
+            desc: '启用 GitHub Flavored Markdown（表格 / 任务列表 / 删除线 / 自动链接）',
+        },
+        {
+            name: 'remarkPlugins',
+            type: 'UnifiedPluginEntry[]',
+            default: 'undefined',
+            desc: '透传 remark 插件（mdast 阶段），支持 plugin 或 [plugin, options] 元组',
+        },
+        {
+            name: 'rehypePlugins',
+            type: 'UnifiedPluginEntry[]',
+            default: 'undefined',
+            desc: '透传 rehype 插件（hast 阶段）；传 rehype-raw 可保留 raw HTML（自负 XSS）',
+        },
+        { name: 'class', type: 'string', default: "''", desc: '根容器附加类名' },
+        { name: 'style', type: 'string', default: 'undefined', desc: '根容器内联样式' },
+    ],
+    events: [],
+    slots: [],
+    a11y: {
+        hasRole: false,
+        focusable: false,
+        note: '渲染语义化 HTML（标题 / 列表 / 表格 / 链接等）保留原生可访问性；外链自动补 rel=noopener noreferrer + target=_blank；默认剥离 raw HTML 规避注入；图片 alt 由 Markdown 源码 `![alt](url)` 提供。',
+    },
+    // 默认覆盖元素（对齐 Semi SemiMarkdownComponents 11 键）；其余标签走原生渲染，可由使用方 components 注册。
+    overridableTags: ['h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'p', 'a', 'img', 'table', 'code', 'pre'],
+    // token 严格镜像 Semi variables.scss（20 条）；排版由 Typography 承担，无自造 h*-size/quote/table/hr 等。
+    tokens: [
+        '--cd-markdown-render-image-margin-left',
+        '--cd-markdown-render-image-margin-right',
+        '--cd-markdown-render-image-margin-top',
+        '--cd-markdown-render-image-margin-bottom',
+        '--cd-markdown-render-image-max-width',
+        '--cd-markdown-render-image-max-height',
+        '--cd-markdown-render-image-alt-margin-top',
+        '--cd-markdown-render-image-alt-color',
+        '--cd-markdown-render-header1-margin-top',
+        '--cd-markdown-render-header1-margin-bottom',
+        '--cd-markdown-render-header2-margin-top',
+        '--cd-markdown-render-header2-margin-bottom',
+        '--cd-markdown-render-header3-margin-top',
+        '--cd-markdown-render-header3-margin-bottom',
+        '--cd-markdown-render-header4-margin-top',
+        '--cd-markdown-render-header4-margin-bottom',
+        '--cd-markdown-render-header5-margin-top',
+        '--cd-markdown-render-header5-margin-bottom',
+        '--cd-markdown-render-simple-code-bg',
+        '--cd-markdown-render-simple-code-text',
+        '--cd-markdown-render-list-color',
+    ],
+    responsive: false,
+    examples: [
+        {
+            title: '基础渲染',
+            code: '<MarkdownRender raw={`# 标题\\n\\n正文 **加粗** 与 [链接](https://example.com)。`} />',
+        },
+        {
+            title: 'GFM 表格 / 任务列表',
+            code: '<MarkdownRender raw={`| a | b |\\n| - | - |\\n| 1 | 2 |\\n\\n- [x] done\\n- [ ] todo`} />',
+        },
+        {
+            title: '覆盖 h1 为自定义 Svelte 组件',
+            code: '<MarkdownRender raw="# 你好" components={{ h1: MyHeading }} />',
+        },
+        {
+            title: '注册自定义标签（配合 remark 插件产出的节点）',
+            code: '<MarkdownRender raw={md} components={{ callout: Callout }} remarkPlugins={[myDirectivePlugin]} />',
+        },
+        {
+            title: '保留 raw HTML（自负 XSS）',
+            code: "import rehypeRaw from 'rehype-raw';\n<MarkdownRender raw={htmlMd} rehypePlugins={[rehypeRaw]} />",
+        },
+        {
+            title: '关闭 GFM',
+            code: '<MarkdownRender raw={md} remarkGfm={false} />',
+        },
+    ],
+};

package/dist/markdown-render/props.d.ts

@@ -0,0 +1,15 @@
+/**
+ * hast properties → 原生 HTML 属性归一化。
+ *
+ * hast（`@types/hast`）的 properties 采用 DOM property 命名：
+ * - `className: string[]` → `class: "a b"`
+ * - camelCase 属性（`colSpan`/`rowSpan`/`htmlFor`/`ariaLabel`…）→ 对应 HTML attribute（kebab / 特例）
+ * - 布尔属性值 `true` → 保留裸属性，`false` → 省略
+ * - 数组值（非 className）→ 空格连接
+ * - 其余原样透传
+ *
+ * 仅处理渲染原生标签时需要的常见映射；自定义 Svelte 组件分支不走此函数（透传原始 properties）。
+ */
+import type { Properties } from 'hast';
+export declare function hastPropsToAttrs(properties: Properties | undefined): Record<string, string | number | boolean | undefined>;
+//# sourceMappingURL=props.d.ts.map

package/dist/markdown-render/props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../src/markdown-render/props.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAgCvC,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,UAAU,GAAG,SAAS,GACjC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAmBvD"}

package/dist/markdown-render/props.js

@@ -0,0 +1,51 @@
+/** DOM property 名 → HTML attribute 名的特例映射（其余按 camelCase→kebab 规则）。 */
+const NAME_MAP = {
+    className: 'class',
+    htmlFor: 'for',
+    httpEquiv: 'http-equiv',
+    acceptCharset: 'accept-charset',
+    colSpan: 'colspan',
+    rowSpan: 'rowspan',
+    tabIndex: 'tabindex',
+    crossOrigin: 'crossorigin',
+    autoComplete: 'autocomplete',
+    readOnly: 'readonly',
+    maxLength: 'maxlength',
+    minLength: 'minlength',
+};
+function toAttrName(key) {
+    const mapped = NAME_MAP[key];
+    if (mapped !== undefined)
+        return mapped;
+    // aria-* / data-* 已是连字符形式；ariaLabel 之类 camelCase → kebab
+    const fifth = key[4];
+    if (fifth !== undefined && key.startsWith('aria') && fifth === fifth.toUpperCase()) {
+        return 'aria-' + key.slice(4).toLowerCase();
+    }
+    if (fifth !== undefined && key.startsWith('data') && fifth === fifth.toUpperCase()) {
+        return 'data-' + key.slice(4).toLowerCase();
+    }
+    return key;
+}
+export function hastPropsToAttrs(properties) {
+    const out = {};
+    if (!properties)
+        return out;
+    for (const [key, value] of Object.entries(properties)) {
+        if (value === undefined || value === null || value === false)
+            continue;
+        const name = toAttrName(key);
+        if (Array.isArray(value)) {
+            // className 与其它空格分隔 token 列表
+            out[name] = value.join(' ');
+        }
+        else if (value === true) {
+            // 布尔属性：裸属性
+            out[name] = '';
+        }
+        else {
+            out[name] = value;
+        }
+    }
+    return out;
+}