@chenzy-design/svelte 0.3.0 → 0.4.1

package/dist/descriptions/DescriptionsItem.svelte

@@ -1,43 +1,73 @@
 <!--
-  Descriptions.Item — 声明式单项，与 data 模式渲染同一套 .cd-descriptions__item 结构，
-  从而复用父 Descriptions 的 grid 布局、bordered/方向样式。span 跨列由 grid-column: span 自排，
-  span 钳制（不超过父 column 列数）经 context 读取父 column 完成——父级无需预先收集 children。
+  Descriptions.Item — 镜像 Semi descriptions/item.tsx。
+  三种单元格形态：
+    - plain（align==='plain'）：单个 <td.item colspan={span}>，key 后内联冒号，key 与 value 同排。
+    - 非 plain：<th.item.item-th>（key）+ <td.item.item-td colspan={span?span*2-1:1}>（value）成对。
+  外层包裹：
+    - layout==='vertical'：每个 Item 自成一行 <tr>。
+    - layout==='horizontal'：不包 tr（由父 Descriptions 的行分组循环提供 <tr>），只渲裸单元格。
+  hidden 为 true 时不渲染（对齐 Semi）。
 -->
 <script lang="ts">
   import type { Snippet } from 'svelte';
   import { getDescriptionsContext } from './context.js';
 
   interface Props {
-    /** 字段标签。 */
-    label: string;
-    /** 跨列数（钳制到父 column 列数，默认 1）。 */
-    span?: number;
+    /** 键值（label）。 */
+    itemKey?: string | undefined;
+    /** 是否隐藏不展示。 */
+    hidden?: boolean;
+    /** Item 外层 wrapper(tr) 的类名（仅 vertical 有 tr 时生效）。 */
+    class?: string | undefined;
+    /** Item 外层 wrapper(tr) 的内联样式。 */
+    style?: string | undefined;
+    /** 跨列数。 */
+    span?: number | undefined;
+    /** key 的自定义样式（宽度、对齐等）。 */
+    keyStyle?: string | undefined;
     children?: Snippet;
   }
 
-  let { label, span, children }: Props = $props();
+  let {
+    itemKey,
+    hidden = false,
+    class: className,
+    style,
+    span,
+    keyStyle,
+    children,
+  }: Props = $props();
 
   const ctx = getDescriptionsContext();
+  const align = $derived(ctx?.getAlign() ?? 'center');
+  const layout = $derived(ctx?.getLayout() ?? 'vertical');
+</script>
 
-  const direction = $derived(ctx?.getDirection() ?? 'horizontal');
-  const colon = $derived(ctx?.getColon() ?? true);
-
-  const clampedSpan = $derived.by(() => {
-    const column = ctx?.getColumn() ?? 1;
-    if (!span || span < 1) return 1;
-    return Math.min(span, column);
-  });
+{#if !hidden}
+  {#snippet plainCell()}
+    <td class="cd-descriptions-item" colspan={span || 1}>
+      <span class="cd-descriptions-key" style={keyStyle}>{itemKey}:</span>
+      <span class="cd-descriptions-value">{@render children?.()}</span>
+    </td>
+  {/snippet}
 
-  // children 为空时回退到父 emptyText 占位（与 data 模式 displayValue 一致）。
-  const emptyText = $derived(ctx?.getEmptyText() ?? '-');
-</script>
+  {#snippet alignCell()}
+    <th class="cd-descriptions-item cd-descriptions-item-th">
+      <span class="cd-descriptions-key" style={keyStyle}>{itemKey}</span>
+    </th>
+    <td
+      class="cd-descriptions-item cd-descriptions-item-td"
+      colspan={span ? span * 2 - 1 : 1}
+    >
+      <span class="cd-descriptions-value">{@render children?.()}</span>
+    </td>
+  {/snippet}
 
-<div class="cd-descriptions__item" style="grid-column: span {clampedSpan};">
-  <dt class="cd-descriptions__label">
-    {label}{#if colon && direction === 'horizontal'}<span
-        class="cd-descriptions__colon"
-        aria-hidden="true">:</span
-      >{/if}
-  </dt>
-  <dd class="cd-descriptions__value">{#if children}{@render children()}{:else}{emptyText}{/if}</dd>
-</div>
+  {#if layout === 'horizontal'}
+    {#if align === 'plain'}{@render plainCell()}{:else}{@render alignCell()}{/if}
+  {:else}
+    <tr class={className} {style}>
+      {#if align === 'plain'}{@render plainCell()}{:else}{@render alignCell()}{/if}
+    </tr>
+  {/if}
+{/if}

package/dist/descriptions/DescriptionsItem.svelte.d.ts

@@ -1,9 +1,17 @@
 import type { Snippet } from 'svelte';
 interface Props {
-    /** 字段标签。 */
-    label: string;
-    /** 跨列数（钳制到父 column 列数，默认 1）。 */
-    span?: number;
+    /** 键值（label）。 */
+    itemKey?: string | undefined;
+    /** 是否隐藏不展示。 */
+    hidden?: boolean;
+    /** Item 外层 wrapper(tr) 的类名（仅 vertical 有 tr 时生效）。 */
+    class?: string | undefined;
+    /** Item 外层 wrapper(tr) 的内联样式。 */
+    style?: string | undefined;
+    /** 跨列数。 */
+    span?: number | undefined;
+    /** key 的自定义样式（宽度、对齐等）。 */
+    keyStyle?: string | undefined;
     children?: Snippet;
 }
 declare const DescriptionsItem: import("svelte").Component<Props, {}, "">;

package/dist/descriptions/DescriptionsItem.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DescriptionsItem.svelte.d.ts","sourceRoot":"","sources":["../../src/descriptions/DescriptionsItem.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAIpC,UAAU,KAAK;IACb,YAAY;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAiCH,QAAA,MAAM,gBAAgB,2CAAwC,CAAC;AAC/D,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC5D,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"DescriptionsItem.svelte.d.ts","sourceRoot":"","sources":["../../src/descriptions/DescriptionsItem.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAIpC,UAAU,KAAK;IACb,iBAAiB;IACjB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,eAAe;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAkDH,QAAA,MAAM,gBAAgB,2CAAwC,CAAC;AAC/D,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC5D,eAAe,gBAAgB,CAAC"}

package/dist/descriptions/context.d.ts

@@ -1,9 +1,13 @@
-export type DescriptionsDirection = 'horizontal' | 'vertical';
+export type DescriptionsAlign = 'center' | 'justify' | 'left' | 'plain';
+export type DescriptionsLayout = 'horizontal' | 'vertical';
+/**
+ * 镜像 Semi DescriptionsContext：仅暴露 align + layout，供 <Descriptions.Item>
+ * 决定渲染成 plain（单 td）还是 th/td 对，以及 horizontal 下是否包裹 tr。
+ * getter 保持对父 prop 变化的响应性。
+ */
 export interface DescriptionsContext {
-    getColumn: () => number;
-    getDirection: () => DescriptionsDirection;
-    getColon: () => boolean;
-    getEmptyText: () => string;
+    getAlign: () => DescriptionsAlign;
+    getLayout: () => DescriptionsLayout;
 }
 export declare function setDescriptionsContext(ctx: DescriptionsContext): void;
 export declare function getDescriptionsContext(): DescriptionsContext | undefined;

package/dist/descriptions/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/descriptions/context.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,qBAAqB,GAAG,YAAY,GAAG,UAAU,CAAC;AAE9D,MAAM,WAAW,mBAAmB;IAElC,SAAS,EAAE,MAAM,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,qBAAqB,CAAC;IAC1C,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB,YAAY,EAAE,MAAM,MAAM,CAAC;CAC5B;AAID,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI,CAErE;AAED,wBAAgB,sBAAsB,IAAI,mBAAmB,GAAG,SAAS,CAExE"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/descriptions/context.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AACxE,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,UAAU,CAAC;AAE3D;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,iBAAiB,CAAC;IAClC,SAAS,EAAE,MAAM,kBAAkB,CAAC;CACrC;AAID,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI,CAErE;AAED,wBAAgB,sBAAsB,IAAI,mBAAmB,GAAG,SAAS,CAExE"}

package/dist/descriptions/index.d.ts

@@ -5,6 +5,6 @@ export declare const Descriptions: typeof Descriptions_ & {
 };
 export { DescriptionsItem };
 export { meta as descriptionsMeta } from './meta.js';
-export type { DescriptionItem } from './types.js';
-export { getDescriptionsContext, setDescriptionsContext, type DescriptionsContext, type DescriptionsDirection, } from './context.js';
+export type { DescriptionData } from './types.js';
+export { getDescriptionsContext, setDescriptionsContext, type DescriptionsContext, type DescriptionsAlign, type DescriptionsLayout, } from './context.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/descriptions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/descriptions/index.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,uBAAuB,CAAC;AAClD,OAAO,gBAAgB,MAAM,2BAA2B,CAAC;AAEzD,eAAO,MAAM,YAAY,EAAE,OAAO,aAAa,GAAG;IAChD,IAAI,EAAE,OAAO,gBAAgB,CAAC;CAC4B,CAAC;AAE7D,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAC5B,OAAO,EAAE,IAAI,IAAI,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,GAC3B,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/descriptions/index.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,uBAAuB,CAAC;AAClD,OAAO,gBAAgB,MAAM,2BAA2B,CAAC;AAEzD,eAAO,MAAM,YAAY,EAAE,OAAO,aAAa,GAAG;IAChD,IAAI,EAAE,OAAO,gBAAgB,CAAC;CAC4B,CAAC;AAE7D,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAC5B,OAAO,EAAE,IAAI,IAAI,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,cAAc,CAAC"}

package/dist/descriptions/meta.d.ts

@@ -5,60 +5,45 @@
 export declare const meta: {
     readonly name: "Descriptions";
     readonly category: "show";
-    readonly description: "描述列表，成组展示只读字段。支持 data 数据驱动与 <Descriptions.Item> 声明式两种用法、inline/row 布局、column 列数（含响应式断点对象）、bordered 边框、colon 冒号、水平/垂直方向与 align/justify 对齐。";
+    readonly description: "描述列表，用于键值对的成组呈现。镜像 Semi Design：table 语义结构，data 数据驱动与 <Descriptions.Item> 声明式两种用法；align（center/justify/left/plain）四种对齐；layout（vertical/horizontal）+ column 每行列数；row 双行显示（small/medium/large）；keyStyle 自定义 key 样式；value 支持字符串或富内容 Snippet。";
     readonly props: readonly [{
-        readonly name: "data";
-        readonly type: "DescriptionItem[]";
-        readonly default: "[]";
-        readonly desc: "描述项数据（不传时渲染 children 内的 Descriptions.Item）";
-    }, {
-        readonly name: "layout";
-        readonly type: "'inline'|'row'";
-        readonly default: "inline";
-    }, {
-        readonly name: "direction";
-        readonly type: "'horizontal'|'vertical'";
-        readonly default: "horizontal";
-    }, {
-        readonly name: "column";
-        readonly type: "number | Partial<Record<Breakpoint, number>>";
-        readonly default: "3";
-        readonly desc: "列数；可传断点对象 { xs?, sm?, md?, lg?, xl?, xxl? } 按视口宽响应（mobile-first 向下级联）";
-    }, {
-        readonly name: "size";
-        readonly type: "'small'|'default'|'large'";
-        readonly default: "default";
+        readonly name: "align";
+        readonly type: "'center'|'justify'|'left'|'plain'";
+        readonly default: "'center'";
+        readonly desc: "对齐方式（row=true 时失效）";
     }, {
-        readonly name: "bordered";
+        readonly name: "row";
         readonly type: "boolean";
         readonly default: "false";
+        readonly desc: "是否双行显示";
     }, {
-        readonly name: "colon";
-        readonly type: "boolean";
-        readonly default: "true";
-    }, {
-        readonly name: "align";
-        readonly type: "'left'|'center'|'right'";
-        readonly default: "left";
-        readonly desc: "内容（value）水平对齐";
+        readonly name: "size";
+        readonly type: "'small'|'medium'|'large'";
+        readonly default: "'medium'";
+        readonly desc: "双行显示时的大小";
     }, {
-        readonly name: "justify";
-        readonly type: "'start'|'center'|'end'|'between'";
-        readonly default: "start";
-        readonly desc: "每个 item 内 label 与 value 的排布对齐";
+        readonly name: "data";
+        readonly type: "DescriptionData[]";
+        readonly default: "[]";
+        readonly desc: "列表数据（不传时渲染 children 内的 Descriptions.Item）";
     }, {
-        readonly name: "title";
-        readonly type: "string";
-        readonly default: "undefined";
+        readonly name: "layout";
+        readonly type: "'vertical'|'horizontal'";
+        readonly default: "'vertical'";
+        readonly desc: "布局模式";
     }, {
-        readonly name: "emptyText";
-        readonly type: "string";
-        readonly default: "'-'";
-        readonly desc: "空值占位";
+        readonly name: "column";
+        readonly type: "number";
+        readonly default: "3";
+        readonly desc: "horizontal 布局下每行的总列数";
     }, {
         readonly name: "class";
         readonly type: "string";
         readonly default: "''";
+    }, {
+        readonly name: "style";
+        readonly type: "string";
+        readonly default: "undefined";
     }, {
         readonly name: "children";
         readonly type: "Snippet";
@@ -67,26 +52,43 @@ export declare const meta: {
     }];
     readonly subComponents: readonly [{
         readonly name: "Descriptions.Item";
-        readonly desc: "声明式描述项，label 标签 + children 内容，span 跨列经 context 读取父 column 钳制；与 data 模式渲染同一套结构，复用父级 grid/bordered/方向布局。";
+        readonly desc: "声明式描述项，itemKey 键值 + children 内容；渲染成 tr（vertical）或裸单元格（horizontal）。";
         readonly props: readonly [{
-            readonly name: "label";
+            readonly name: "itemKey";
             readonly type: "string";
-            readonly desc: "字段标签";
+            readonly desc: "键值（label）";
+        }, {
+            readonly name: "hidden";
+            readonly type: "boolean";
+            readonly default: "false";
+            readonly desc: "是否隐藏不展示";
         }, {
             readonly name: "span";
             readonly type: "number";
             readonly default: "1";
-            readonly desc: "跨列数（钳制到父 column）";
+            readonly desc: "跨列数";
+        }, {
+            readonly name: "keyStyle";
+            readonly type: "string";
+            readonly desc: "key 的自定义样式";
+        }, {
+            readonly name: "class";
+            readonly type: "string";
+            readonly desc: "外层 tr 的类名";
+        }, {
+            readonly name: "style";
+            readonly type: "string";
+            readonly desc: "外层 tr 的内联样式";
         }, {
             readonly name: "children";
             readonly type: "Snippet";
-            readonly desc: "描述内容（为空回退父 emptyText）";
+            readonly desc: "描述内容";
         }];
     }];
     readonly a11y: {
         readonly role: "description list";
-        readonly notes: readonly ["dl/dt/dd 语义结构", "冒号用 aria-hidden 装饰", "空值显示 emptyText 占位"];
+        readonly notes: readonly ["table 语义结构（th 为 key、td 为 value）", "plain/横向布局下 key 与 value 同排，key 后内联冒号", "hidden 项不渲染"];
     };
-    readonly tokens: readonly ["--cd-descriptions-*", "--cd-spacing-*"];
+    readonly tokens: readonly ["--cd-font-descriptions-lineheight", "--cd-font-descriptions-value-fontweight", "--cd-spacing-descriptions-th-paddingright", "--cd-spacing-descriptions-item-paddingbottom", "--cd-spacing-descriptions-item-small-paddingright", "--cd-spacing-descriptions-item-medium-paddingright", "--cd-spacing-descriptions-item-large-paddingright", "--cd-spacing-descriptions-key-medium-paddingbottom", "--cd-spacing-descriptions-key-large-paddingbottom", "--cd-color-descriptions-key-text-default", "--cd-color-descriptions-value-text-default", "--cd-spacing-descriptions-value-plain-paddingleft", "--cd-spacing-descriptions-item-double-padding", "--cd-font-descriptions-key-small-fontsize", "--cd-font-descriptions-value-small-fontsize", "--cd-font-descriptions-key-medium-fontsize", "--cd-font-descriptions-value-medium-fontsize", "--cd-font-descriptions-key-large-fontsize", "--cd-font-descriptions-value-large-fontsize"];
 };
 //# sourceMappingURL=meta.d.ts.map

package/dist/descriptions/meta.d.ts.map

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

package/dist/descriptions/meta.js

@@ -5,40 +5,61 @@
 export const meta = {
     name: 'Descriptions',
     category: 'show',
-    description: '描述列表，成组展示只读字段。支持 data 数据驱动与 <Descriptions.Item> 声明式两种用法、inline/row 布局、column 列数（含响应式断点对象）、bordered 边框、colon 冒号、水平/垂直方向与 align/justify 对齐。',
+    description: '描述列表，用于键值对的成组呈现。镜像 Semi Design：table 语义结构，data 数据驱动与 <Descriptions.Item> 声明式两种用法；align（center/justify/left/plain）四种对齐；layout（vertical/horizontal）+ column 每行列数；row 双行显示（small/medium/large）；keyStyle 自定义 key 样式；value 支持字符串或富内容 Snippet。',
     props: [
-        { name: 'data', type: 'DescriptionItem[]', default: '[]', desc: '描述项数据（不传时渲染 children 内的 Descriptions.Item）' },
-        { name: 'layout', type: "'inline'|'row'", default: 'inline' },
-        { name: 'direction', type: "'horizontal'|'vertical'", default: 'horizontal' },
-        { name: 'column', type: 'number | Partial<Record<Breakpoint, number>>', default: '3', desc: '列数；可传断点对象 { xs?, sm?, md?, lg?, xl?, xxl? } 按视口宽响应（mobile-first 向下级联）' },
-        { name: 'size', type: "'small'|'default'|'large'", default: 'default' },
-        { name: 'bordered', type: 'boolean', default: 'false' },
-        { name: 'colon', type: 'boolean', default: 'true' },
-        { name: 'align', type: "'left'|'center'|'right'", default: 'left', desc: '内容（value）水平对齐' },
-        { name: 'justify', type: "'start'|'center'|'end'|'between'", default: 'start', desc: '每个 item 内 label 与 value 的排布对齐' },
-        { name: 'title', type: 'string', default: 'undefined' },
-        { name: 'emptyText', type: 'string', default: "'-'", desc: '空值占位' },
+        { name: 'align', type: "'center'|'justify'|'left'|'plain'", default: "'center'", desc: '对齐方式（row=true 时失效）' },
+        { name: 'row', type: 'boolean', default: 'false', desc: '是否双行显示' },
+        { name: 'size', type: "'small'|'medium'|'large'", default: "'medium'", desc: '双行显示时的大小' },
+        { name: 'data', type: 'DescriptionData[]', default: '[]', desc: '列表数据（不传时渲染 children 内的 Descriptions.Item）' },
+        { name: 'layout', type: "'vertical'|'horizontal'", default: "'vertical'", desc: '布局模式' },
+        { name: 'column', type: 'number', default: '3', desc: 'horizontal 布局下每行的总列数' },
         { name: 'class', type: 'string', default: "''" },
+        { name: 'style', type: 'string', default: 'undefined' },
         { name: 'children', type: 'Snippet', default: 'undefined', desc: '声明式用法：内嵌 <Descriptions.Item>（不传 data 时生效）' },
     ],
     subComponents: [
         {
             name: 'Descriptions.Item',
-            desc: '声明式描述项，label 标签 + children 内容，span 跨列经 context 读取父 column 钳制；与 data 模式渲染同一套结构，复用父级 grid/bordered/方向布局。',
+            desc: '声明式描述项，itemKey 键值 + children 内容；渲染成 tr（vertical）或裸单元格（horizontal）。',
             props: [
-                { name: 'label', type: 'string', desc: '字段标签' },
-                { name: 'span', type: 'number', default: '1', desc: '跨列数（钳制到父 column）' },
-                { name: 'children', type: 'Snippet', desc: '描述内容（为空回退父 emptyText）' },
+                { name: 'itemKey', type: 'string', desc: '键值（label）' },
+                { name: 'hidden', type: 'boolean', default: 'false', desc: '是否隐藏不展示' },
+                { name: 'span', type: 'number', default: '1', desc: '跨列数' },
+                { name: 'keyStyle', type: 'string', desc: 'key 的自定义样式' },
+                { name: 'class', type: 'string', desc: '外层 tr 的类名' },
+                { name: 'style', type: 'string', desc: '外层 tr 的内联样式' },
+                { name: 'children', type: 'Snippet', desc: '描述内容' },
             ],
         },
     ],
     a11y: {
         role: 'description list',
         notes: [
-            'dl/dt/dd 语义结构',
-            '冒号用 aria-hidden 装饰',
-            '空值显示 emptyText 占位',
+            'table 语义结构（th 为 key、td 为 value）',
+            'plain/横向布局下 key 与 value 同排，key 后内联冒号',
+            'hidden 项不渲染',
         ],
     },
-    tokens: ['--cd-descriptions-*', '--cd-spacing-*'],
+    tokens: [
+        // Semi descriptions/variables.scss 全量对齐（19），组件直接消费原始层
+        '--cd-font-descriptions-lineheight',
+        '--cd-font-descriptions-value-fontweight',
+        '--cd-spacing-descriptions-th-paddingright',
+        '--cd-spacing-descriptions-item-paddingbottom',
+        '--cd-spacing-descriptions-item-small-paddingright',
+        '--cd-spacing-descriptions-item-medium-paddingright',
+        '--cd-spacing-descriptions-item-large-paddingright',
+        '--cd-spacing-descriptions-key-medium-paddingbottom',
+        '--cd-spacing-descriptions-key-large-paddingbottom',
+        '--cd-color-descriptions-key-text-default',
+        '--cd-color-descriptions-value-text-default',
+        '--cd-spacing-descriptions-value-plain-paddingleft',
+        '--cd-spacing-descriptions-item-double-padding',
+        '--cd-font-descriptions-key-small-fontsize',
+        '--cd-font-descriptions-value-small-fontsize',
+        '--cd-font-descriptions-key-medium-fontsize',
+        '--cd-font-descriptions-value-medium-fontsize',
+        '--cd-font-descriptions-key-large-fontsize',
+        '--cd-font-descriptions-value-large-fontsize',
+    ],
 };

package/dist/descriptions/types.d.ts

@@ -1,7 +1,17 @@
-export interface DescriptionItem {
+import type { Snippet } from 'svelte';
+/**
+ * Descriptions 数据项，镜像 Semi `Data`：key/value/hidden/span/keyStyle。
+ */
+export interface DescriptionData {
+    /** 键值（label）。 */
     key?: string;
-    label: string;
-    value: unknown;
+    /** 属性值；字符串/数字直渲，Snippet 渲染富内容（对齐 Semi value?: () => ReactNode）。 */
+    value?: unknown | Snippet;
+    /** 该数据是否隐藏不展示。 */
+    hidden?: boolean;
+    /** 单元格跨越的列数（horizontal 布局下生效）。 */
     span?: number;
+    /** key 的自定义样式（宽度、对齐等）。 */
+    keyStyle?: string;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/descriptions/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/descriptions/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/descriptions/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iBAAiB;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC1B,kBAAkB;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}