@chenzy-design/svelte 0.3.1 → 0.4.1

package/dist/tree-select/meta.js

@@ -5,60 +5,114 @@
 export const meta = {
     name: 'TreeSelect',
     category: 'input',
-    description: '树形选择器，单面板可展开/收起的树，单选叶子或任意节点。',
+    description: '树形选择器，单面板可展开/收起的树，单选叶子或任意节点；支持 multiple 多选（checkbox + 父子联动 + 多 tag 回显）、可搜索过滤（本地/远程 + 命中高亮）、异步加载子节点、虚拟滚动大数据树、keyMaps 自定义字段映射与节点/tag/触发器渲染。严格对齐 Semi。',
     props: [
         { name: 'value', type: 'TreeKey|TreeKey[]|null', default: 'undefined' },
         { name: 'defaultValue', type: 'TreeKey|TreeKey[]|null', default: 'null' },
-        { name: 'treeData', type: 'TreeNode[]', default: '[]', desc: '树数据源；字段名可经 fieldNames 自定义' },
-        {
-            name: 'fieldNames',
-            type: '{ key?: string; label?: string; children?: string }',
-            default: "{ key:'key', label:'label', children:'children' }",
-            desc: '自定义节点字段名映射，适配任意后端数据（如 { key:\'id\', label:\'name\', children:\'sub\' }）。派生只读映射；onChange 回传的 key 即原始字段值',
-        },
-        { name: 'open', type: 'boolean', default: 'undefined' },
+        { name: 'treeData', type: 'TreeNode[]', default: '[]', desc: '树数据源；字段名可经 keyMaps 自定义' },
         { name: 'defaultOpen', type: 'boolean', default: 'false' },
         { name: 'multiple', type: 'boolean', default: 'false', desc: 'checkbox 多选 + 父子联动，多 tag 回显' },
-        { name: 'checkStrictly', type: 'boolean', default: 'false', desc: '多选时父子勾选互不影响（向后兼容，等价 checkRelation=unRelated）' },
-        { name: 'checkRelation', type: "'related'|'unRelated'", default: "'related'", desc: '多选父子是否级联联动；unRelated 互不影响。checkStrictly=true 强制 unRelated' },
-        { name: 'showCheckedStrategy', type: "'all'|'parent'|'child'", default: "'all'", desc: '回填值/Tag 收敛策略：all 全部勾选节点；parent 折叠为父；child 仅叶子。仅 related 生效' },
+        { name: 'checkRelation', type: "'related'|'unRelated'", default: "'related'", desc: '多选父子是否级联联动；unRelated 互不影响（对齐 Semi）' },
         { name: 'maxTagCount', type: 'number', default: 'undefined', desc: '多选回填 Tag 最大展示数，超出折叠为 +N（仅影响显示）' },
         { name: 'placeholder', type: 'string', default: "'请选择'" },
         { name: 'size', type: "'small'|'default'|'large'", default: 'default' },
         { name: 'status', type: "'default'|'warning'|'error'", default: 'default' },
         { name: 'disabled', type: 'boolean', default: 'false' },
-        { name: 'clearable', type: 'boolean', default: 'false' },
+        { name: 'showClear', type: 'boolean', default: 'false', desc: '值不为空时 trigger 展示清除按钮（对齐 Semi）' },
         { name: 'leafOnly', type: 'boolean', default: 'false' },
         { name: 'defaultExpandAll', type: 'boolean', default: 'false' },
-        { name: 'treeDefaultExpandedKeys', type: 'TreeKey[]', default: '[]', desc: '默认展开的节点 key（非受控初始展开集，与 defaultExpandAll 取并集）' },
+        { name: 'defaultExpandedKeys', type: 'TreeKey[]', default: '[]', desc: '默认展开的节点 key（非受控初始展开集，与 defaultExpandAll 取并集；对齐 Semi）' },
         { name: 'filterable', type: 'boolean', default: 'false', desc: '面板搜索框过滤节点 + 高亮命中' },
-        { name: 'remote', type: 'boolean', default: 'false', desc: '远程搜索：输入防抖后仅触发 onSearch，不本地过滤（外部更新 treeData）' },
-        { name: 'searchDebounce', type: 'number', default: '300', desc: 'onSearch 防抖毫秒（remote 时生效）' },
-        { name: 'onSearch', type: '(query: string) => void', default: 'undefined', desc: '远程搜索输入回调（防抖后）' },
-        { name: 'showIcon', type: 'boolean', default: 'true', desc: '是否预留节点图标位（icon 提供时渲染在 label 前），与 Tree 对齐' },
+        { name: 'filterTreeNode', type: 'boolean | ((inputValue: string, treeNodeString: string, data?: TreeNode) => boolean)', default: 'undefined', desc: '按输入筛选节点（对齐 Semi）：true 开启搜索并默认按 treeNodeFilterProp 包含匹配；函数则自定义匹配谓词。与 filterable 其一为真即显示搜索框' },
+        { name: 'remote', type: 'boolean', default: 'false', desc: '远程搜索：输入仅触发 onSearch，不本地过滤（外部更新 treeData）' },
+        { name: 'onSearch', type: '(input: string, filteredExpandedKeys: TreeKey[], filteredNodes: TreeNode[]) => void', default: 'undefined', desc: '搜索输入回调（对齐 Semi 三入参）：入参为当前输入、过滤后应展开的节点 keys、命中节点数组' },
         {
             name: 'loadData',
             type: '(node: TreeNode) => Promise<TreeNode[]>',
             default: 'undefined',
             desc: '异步加载子节点：展开未加载的非叶子节点时调用，返回该节点子节点数组（加载中显示 spinner，竞态去重，不写回 treeData）。与 Tree 的 loadData 对齐',
         },
-        { name: 'virtualized', type: 'boolean', default: 'false', desc: '虚拟滚动：仅渲染视口内可见行，适合大数据树。复用 Tree 范式（core fixedRange），保持 role=tree/treeitem 语义' },
-        { name: 'height', type: 'number', default: '224', desc: '虚拟滚动视口高度（px），virtualized 时生效' },
-        { name: 'itemHeight', type: 'number', default: '32', desc: '虚拟滚动行高（px），virtualized 时生效' },
+        { name: 'virtualize', type: '{ height?: number; width?: number | string; itemSize?: number }', default: 'undefined', desc: '列表虚拟化（对齐 Semi）：传入对象即开启，仅渲染视口内可见行；height 视口高（默认 224）、itemSize 行高（默认 32）。复用 Tree 范式（core fixedRange），保持 role=tree/treeitem 语义' },
         {
-            name: 'icon',
-            type: 'Snippet<[{ node: TreeNode; expanded: boolean; level: number }]>',
+            name: 'triggerRender',
+            type: 'Snippet<[{ value: TreeKey|TreeKey[]|null|undefined; placeholder: string; isOpen: boolean; disabled: boolean }]>',
             default: 'undefined',
-            desc: '自定义节点图标，showIcon 为真时渲染在 label 前；参数含节点与展开态，与 Tree 的 icon API 对齐',
+            desc: '完全自定义触发器渲染（替换默认选择框）；参数含当前 value/placeholder/isOpen/disabled，与 Cascader.triggerRender 对齐',
         },
+        { name: 'insetLabel', type: 'Snippet | string', default: 'undefined', desc: '触发器内嵌标签，渲染在回填值/占位符之前（对齐 Semi insetLabel），消费 --cd-color/font-tree-select-label token' },
+        { name: 'insetLabelId', type: 'string', default: 'undefined', desc: '内嵌标签的 id（a11y 关联用），对齐 Semi insetLabelId' },
+        { name: 'motion', type: 'boolean', default: 'true', desc: '下拉浮层开合动画（淡入）；与 Cascader/Dropdown 的 motion 对齐。reduced-motion 退化' },
         {
             name: 'onChange',
             type: '(value: TreeKey|TreeKey[]|null) => void',
             default: 'undefined',
             desc: '多选返回 checked 全集数组，单选返回单 key',
         },
-        { name: 'onOpenChange', type: '(open: boolean) => void', default: 'undefined' },
         { name: 'ariaLabel', type: 'string', default: 'undefined' },
+        { name: 'ariaLabelledby', type: 'string', default: 'undefined', desc: 'aria-labelledby：关联外部 label 元素（Form.Field 透传 labelId，对齐 Semi）' },
+        { name: 'ariaDescribedby', type: 'string', default: 'undefined', desc: 'aria-describedby：关联 helpText / extraText（Form.Field 透传）' },
+        { name: 'ariaErrormessage', type: 'string', default: 'undefined', desc: 'aria-errormessage：error 态关联错误信息容器（Form.Field 透传）' },
+        { name: 'ariaRequired', type: 'boolean', default: 'undefined', desc: 'aria-required：必填语义（Form.Field required 透传）' },
+        { name: 'position', type: 'string', default: "'bottomLeft'", desc: '浮层弹出位置（对齐 Semi，参考 Tooltip position）；映射到 use:floating placement' },
+        { name: 'dropdownMatchSelectWidth', type: 'boolean', default: 'true', desc: '浮层宽度对齐触发器（min-inline-size = 触发器宽）' },
+        { name: 'getPopupContainer', type: '() => HTMLElement | null | undefined', default: 'undefined', desc: '浮层挂载容器，缺省 ConfigProvider 全局值再回退 document.body' },
+        { name: 'stopPropagation', type: 'boolean', default: 'true', desc: '触发器点击是否阻止事件冒泡（对齐 Semi）' },
+        { name: 'borderless', type: 'boolean', default: 'false', desc: '无边框模式：trigger 边框透明' },
+        { name: 'prefix', type: 'Snippet | string', default: 'undefined', desc: 'trigger 前缀' },
+        { name: 'suffix', type: 'Snippet | string', default: 'undefined', desc: 'trigger 后缀' },
+        { name: 'clearIcon', type: 'Snippet', default: 'undefined', desc: '自定义清除按钮图标' },
+        { name: 'expandIcon', type: 'Snippet<[{ node: TreeNode; expanded: boolean; level: number }]>', default: 'undefined', desc: '自定义展开图标；也可传无参 Snippet 统一渲染' },
+        { name: 'arrowIcon', type: 'Snippet', default: 'undefined', desc: '自定义右侧下拉箭头（expandIcon 的别名）' },
+        { name: 'showLine', type: 'boolean', default: 'false', desc: '显示节点连接线（垂直导引线）' },
+        { name: 'labelEllipsis', type: 'boolean', default: 'true', desc: '节点 label 单行省略截断，可关闭以允许换行' },
+        { name: 'style', type: 'string', default: 'undefined', desc: '选择框样式' },
+        { name: 'autoAdjustOverflow', type: 'boolean', default: 'true', desc: '浮层遮挡时自动调整方向' },
+        { name: 'validateStatus', type: "'default'|'error'|'warning'", default: 'undefined', desc: 'status 的别名（优先于 status）' },
+        { name: 'onBlur', type: '(e: FocusEvent) => void', default: 'undefined', desc: '失焦回调' },
+        { name: 'onFocus', type: '(e: FocusEvent) => void', default: 'undefined', desc: '聚焦回调' },
+        { name: 'preventScroll', type: 'boolean', default: 'false', desc: '聚焦时阻止滚动' },
+        { name: 'outerTopSlot', type: 'Snippet', default: 'undefined', desc: '面板顶部外层 slot（在搜索框之上）' },
+        { name: 'outerBottomSlot', type: 'Snippet', default: 'undefined', desc: '面板底部外层 slot（在树之下）' },
+        { name: 'searchAutoFocus', type: 'boolean', default: 'false', desc: '面板打开时搜索框自动获焦' },
+        { name: 'searchPosition', type: "'dropdown'|'trigger'", default: "'dropdown'", desc: "搜索框位置：'dropdown' 面板内；'trigger' trigger 内" },
+        { name: 'searchPlaceholder', type: 'string', default: 'undefined', desc: '搜索框占位文字' },
+        { name: 'treeNodeFilterProp', type: 'string', default: "'label'", desc: '搜索过滤属性' },
+        { name: 'showSearchClear', type: 'boolean', default: 'true', desc: '搜索框右侧显示清除按钮（有内容时）' },
+        { name: 'showFilteredOnly', type: 'boolean', default: 'false', desc: '搜索激活时仅显示命中节点，不显示祖先链' },
+        { name: 'emptyContent', type: 'string | Snippet', default: 'undefined', desc: '无匹配/无数据占位内容（对齐 Semi emptyContent）；未传回退 i18n TreeSelect.emptyText' },
+        { name: 'searchRender', type: 'boolean | Snippet<[{ value: string; onInput: (v: string) => void; onKeydown: (e: KeyboardEvent) => void; placeholder: string }]>', default: 'undefined', desc: '自定义搜索框渲染：false 隐藏内置搜索框；Snippet 完全接管渲染（回调回填输入）' },
+        { name: 'expandedKeys', type: 'TreeKey[]', default: 'undefined', desc: '受控展开的节点 keys' },
+        { name: 'expandAll', type: 'boolean', default: 'false', desc: '动态全部展开（受控/动态，区别于 defaultExpandAll）' },
+        { name: 'expandAction', type: "false | 'click' | 'doubleClick'", default: 'false', desc: "行点击展开方式：false 仅展开按钮；'click' 单击行；'doubleClick' 双击行" },
+        { name: 'autoExpandParent', type: 'boolean', default: 'false', desc: '展开节点时自动展开其所有祖先链' },
+        { name: 'motionExpand', type: 'boolean', default: 'true', desc: '展开/折叠动画' },
+        { name: 'onExpand', type: '(expandedKeys: TreeKey[], info: { expanded: boolean; node: unknown }) => void', default: 'undefined', desc: '节点展开回调' },
+        { name: 'autoMergeValue', type: 'boolean', default: 'true', desc: '自动合并值：父节点全选时 value 折叠为父不含后代（对齐 Semi）；leafOnly 时改为仅叶子' },
+        { name: 'onChangeWithObject', type: 'boolean', default: 'false', desc: 'onChange 回调携带完整节点对象而非仅 key' },
+        { name: 'showRestTagsPopover', type: 'boolean', default: 'false', desc: '多选 maxTagCount 折叠出 +N 时，hover +N 用 Popover 浮层展示折叠掉的剩余全部 Tag' },
+        { name: 'restTagsPopoverProps', type: 'Record<string, unknown>', default: 'undefined', desc: '透传给剩余 Tag Popover 浮层的额外 props（在默认 trigger=hover/position=top 之后展开，可覆盖）' },
+        { name: 'triggerTagWrap', type: 'boolean', default: 'false', desc: 'trigger 多选 tags 换行显示（默认单行截断折叠）' },
+        { name: 'renderLabel', type: 'Snippet<[{ label: string; data: TreeNode; searchWord: string }]>', default: 'undefined', desc: '自定义节点 label 渲染（仅替换文字部分）' },
+        { name: 'renderFullLabel', type: 'Snippet<[{ node: TreeNode; expanded: boolean; level: number; checked: boolean; halfChecked: boolean; selected: boolean }]>', default: 'undefined', desc: '完全自定义节点行渲染（替换整行内容）' },
+        { name: 'renderSelectedItem', type: 'Snippet<[{ node: TreeNode; onRemove: () => void }]>', default: 'undefined', desc: '自定义 trigger 已选 tag 渲染（多选时每个 tag 独立渲染）' },
+        { name: 'treeNodeLabelProp', type: 'string', default: "'label'", desc: '节点数据中用作显示 label 的字段名' },
+        { name: 'keyMaps', type: '{ key?: string; label?: string; value?: string; children?: string }', default: 'undefined', desc: '自定义节点字段名映射（对齐 Semi keyMaps）：适配任意后端数据结构，如 { key:\'id\', label:\'name\', children:\'sub\' }' },
+        { name: 'optionListStyle', type: 'string | Record<string, string>', default: 'undefined', desc: '选项列表容器的内联 style' },
+        { name: 'loadedKeys', type: 'Set<TreeKey>', default: 'undefined', desc: '受控已加载的节点 keys' },
+        { name: 'clickToHide', type: 'boolean', default: 'true', desc: '单选选中后自动关闭面板' },
+        { name: 'clickTriggerToHide', type: 'boolean', default: 'true', desc: '面板开启时点击 trigger 关闭面板' },
+        { name: 'disableStrictly', type: 'boolean', default: 'false', desc: '严格禁用：disabled 节点不因父节点联动而影响，禁用态独立' },
+        { name: 'dropdownMargin', type: 'number | { marginTop?: number; marginBottom?: number; marginLeft?: number; marginRight?: number }', default: 'undefined', desc: '浮层与 trigger 的额外间距（px）；数字映射到浮层 offset，对象取 marginTop' },
+        { name: 'dropdownClassName', type: 'string', default: 'undefined', desc: '追加到浮层根节点的自定义类名（与内置类名并存）' },
+        { name: 'dropdownStyle', type: 'string | Record<string, string>', default: 'undefined', desc: '合并进浮层根节点的内联样式（不覆盖内置定位样式）' },
+        { name: 'zIndex', type: 'number', default: 'undefined', desc: '浮层层级（z-index），未传由 CSS 控制' },
+        { name: 'onClear', type: '(e: MouseEvent) => void', default: 'undefined', desc: '点击清除按钮回调' },
+        { name: 'onSelect', type: '(selectedKey: TreeKey, selected: boolean, node: unknown) => void', default: 'undefined', desc: '节点选中回调' },
+        { name: 'onLoad', type: '(loadedKeys: TreeKey[], treeNode: TreeNode) => void', default: 'undefined', desc: '异步加载完成回调（含已加载 key 集合与当前节点）' },
+        { name: 'onVisibleChange', type: '(isVisible: boolean) => void', default: 'undefined', desc: '面板可见性变化回调（对齐 Semi onVisibleChange）' },
+    ],
+    methods: [
+        { name: 'search(sugInput)', desc: '命令式搜索：把值置给内部搜索态并触发过滤（对齐 Semi，用于外部自定义搜索框）' },
     ],
     a11y: {
         role: 'combobox',
@@ -69,5 +123,5 @@ export const meta = {
             'leafOnly 时非叶子节点仅切换展开，不可选',
         ],
     },
-    tokens: ['--cd-select-*', '--cd-tree-*', '--cd-focus-ring'],
+    tokens: ['--cd-tree-select-*', '--cd-color-tree-select-label', '--cd-font-tree-select-label', '--cd-dropdown-motion-*', '--cd-select-*', '--cd-tree-*', '--cd-focus-ring'],
 };

package/dist/tree-select/types.d.ts

@@ -6,6 +6,8 @@ export interface TreeNode {
     label: string;
     disabled?: boolean;
     isLeaf?: boolean;
+    /** 节点图标（渲染在 label 前，对齐 Semi 由节点数据 icon 字段驱动，无组件级开关）。 */
+    icon?: string;
     children?: TreeNode[];
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/tree-select/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tree-select/types.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEtC,2BAA2B;AAC3B,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;CACvB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tree-select/types.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEtC,2BAA2B;AAC3B,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;CACvB"}

package/dist/typography/Numeral.svelte

@@ -0,0 +1,117 @@
+<!--
+  Typography.Numeral — 数值格式化文本，对齐 Semi Typography.Numeral。
+  在 Text 样式（复用 TypographyBase）基础上，遍历渲染后 children 的文本节点，
+  按 rule / precision / truncate / parser 格式化其中数字。格式化引擎来自
+  @chenzy-design/core formatNumeral（框架无关、可测，逻辑对齐 Semi formatNumeral）。
+-->
+<script lang="ts">
+  import type { Snippet } from 'svelte';
+  import { formatNumeral, type NumeralRule, type NumeralTruncate } from '@chenzy-design/core';
+  import TypographyBase, {
+    type TypoType,
+    type TypoSize,
+    type EllipsisConfig,
+    type CopyableConfig,
+  } from './TypographyBase.svelte';
+
+  interface Props {
+    /** 解析规则（对齐 Semi）。 */
+    rule?: NumeralRule;
+    /** 保留小数位数。 */
+    precision?: number;
+    /** 小数截断取整方式。 */
+    truncate?: NumeralTruncate;
+    /** 自定义解析函数（优先于 rule）。 */
+    parser?: (raw: string) => string;
+    component?: string;
+    /** 链接（对齐 Semi Numeral link）。 */
+    link?: boolean | Record<string, unknown>;
+    /** 前置图标（对齐 Semi icon）。 */
+    icon?: Snippet;
+    // —— 复用 Text 的样式 props ——
+    type?: TypoType;
+    size?: TypoSize;
+    strong?: boolean;
+    mark?: boolean;
+    underline?: boolean;
+    delete?: boolean;
+    code?: boolean;
+    disabled?: boolean;
+    ellipsis?: boolean | EllipsisConfig;
+    copyable?: boolean | CopyableConfig;
+    class?: string;
+    style?: string;
+    children?: Snippet;
+  }
+
+  let {
+    rule = 'text',
+    precision = 0,
+    truncate = 'round',
+    parser,
+    component = 'span',
+    link = false,
+    icon,
+    type = 'primary',
+    size = 'normal',
+    strong = false,
+    mark = false,
+    underline = false,
+    delete: del = false,
+    code = false,
+    disabled = false,
+    ellipsis = false,
+    copyable = false,
+    class: className = '',
+    style,
+    children,
+  }: Props = $props();
+
+  let hostEl = $state<HTMLElement | undefined>();
+
+  // 遍历 host 下所有文本节点，按 numeral 规则格式化（对齐 Semi formatNodeDFS 语义）。
+  // 渲染后 + 规则变化时重跑。
+  $effect(() => {
+    const el = hostEl;
+    if (!el) return;
+    // 依赖收集：规则变化触发重算
+    void rule;
+    void precision;
+    void truncate;
+    void parser;
+    const walker = document.createTreeWalker(el, NodeFilter.SHOW_TEXT);
+    const nodes: Text[] = [];
+    let n = walker.nextNode();
+    while (n) {
+      nodes.push(n as Text);
+      n = walker.nextNode();
+    }
+    for (const node of nodes) {
+      const raw = node.nodeValue ?? '';
+      if (!raw.trim()) continue;
+      const formatted = formatNumeral(raw, { rule, precision, truncate, ...(parser ? { parser } : {}) });
+      if (formatted !== raw) node.nodeValue = formatted;
+    }
+  });
+</script>
+
+<TypographyBase
+  element={component}
+  hostRef={(el) => (hostEl = el)}
+  {type}
+  {size}
+  {strong}
+  {mark}
+  {underline}
+  delete={del}
+  {code}
+  {disabled}
+  {icon}
+  {link}
+  {ellipsis}
+  {copyable}
+  class={className}
+  {style}
+>
+  {@render children?.()}
+</TypographyBase>

package/dist/typography/Numeral.svelte.d.ts

@@ -0,0 +1,35 @@
+import type { Snippet } from 'svelte';
+import { type NumeralRule, type NumeralTruncate } from '@chenzy-design/core';
+import { type TypoType, type TypoSize, type EllipsisConfig, type CopyableConfig } from './TypographyBase.svelte';
+interface Props {
+    /** 解析规则（对齐 Semi）。 */
+    rule?: NumeralRule;
+    /** 保留小数位数。 */
+    precision?: number;
+    /** 小数截断取整方式。 */
+    truncate?: NumeralTruncate;
+    /** 自定义解析函数（优先于 rule）。 */
+    parser?: (raw: string) => string;
+    component?: string;
+    /** 链接（对齐 Semi Numeral link）。 */
+    link?: boolean | Record<string, unknown>;
+    /** 前置图标（对齐 Semi icon）。 */
+    icon?: Snippet;
+    type?: TypoType;
+    size?: TypoSize;
+    strong?: boolean;
+    mark?: boolean;
+    underline?: boolean;
+    delete?: boolean;
+    code?: boolean;
+    disabled?: boolean;
+    ellipsis?: boolean | EllipsisConfig;
+    copyable?: boolean | CopyableConfig;
+    class?: string;
+    style?: string;
+    children?: Snippet;
+}
+declare const Numeral: import("svelte").Component<Props, {}, "">;
+type Numeral = ReturnType<typeof Numeral>;
+export default Numeral;
+//# sourceMappingURL=Numeral.svelte.d.ts.map

package/dist/typography/Numeral.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Numeral.svelte.d.ts","sourceRoot":"","sources":["../../src/typography/Numeral.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAiB,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC5F,OAAuB,EACnB,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,yBAAyB,CAAC;AAGjC,UAAU,KAAK;IACb,qBAAqB;IACrB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,cAAc;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,yBAAyB;IACzB,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,0BAA0B;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;IACpC,QAAQ,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAiEH,QAAA,MAAM,OAAO,2CAAwC,CAAC;AACtD,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;AAC1C,eAAe,OAAO,CAAC"}

package/dist/typography/Paragraph.svelte

@@ -1,91 +1,77 @@
 <!--
-  Typography.Paragraph — see specs/components/basic/Typography.spec.md
-  Renders a <p>. ellipsis / copyable / editable 经 TypographyBase 组合 core 原语。
+  Typography.Paragraph — 渲染 <p>，对齐 Semi Typography.Paragraph。
+  拼 cd-typography-paragraph 类；spacing=extended 走宽松行距。
 -->
 <script lang="ts">
   import type { Snippet } from 'svelte';
   import TypographyBase, {
+    type TypoType,
+    type TypoSize,
     type EllipsisConfig,
     type CopyableConfig,
-    type EditableConfig,
   } from './TypographyBase.svelte';
 
-  type TypoType = 'default' | 'secondary' | 'tertiary' | 'warning' | 'danger' | 'success';
-  type TypoWeight = number | 'regular' | 'medium' | 'semibold' | 'bold';
-  type TypoSize = 'small' | 'default' | 'large';
-
   interface Props {
     type?: TypoType;
-    /** 字号档 small/default/large。spec §4.1 L60 */
+    /** 字号档 normal / small（对齐 Semi）。 */
     size?: TypoSize;
     strong?: boolean;
-    weight?: TypoWeight;
     disabled?: boolean;
     mark?: boolean;
     underline?: boolean;
     delete?: boolean;
     code?: boolean;
+    /** 行距：normal / extended（对齐 Semi spacing）。 */
+    spacing?: 'normal' | 'extended';
+    /** 链接（对齐 Semi link）。 */
+    link?: boolean | Record<string, unknown>;
     component?: string;
     ellipsis?: boolean | EllipsisConfig;
     copyable?: boolean | CopyableConfig;
-    editable?: boolean | EditableConfig;
-    value?: string;
-    onChange?: (value: string) => void;
-    onCopy?: (content: string) => void;
-    onEditStart?: () => void;
-    onEditCancel?: () => void;
-    onExpand?: (expanded: boolean) => void;
+    onExpand?: (expanded: boolean, e: MouseEvent) => void;
     class?: string;
+    style?: string;
     children?: Snippet;
   }
 
   let {
-    type = 'default',
-    size = 'default',
+    type = 'primary',
+    size = 'normal',
     strong = false,
-    weight,
     disabled = false,
     mark = false,
     underline = false,
     delete: del = false,
     code = false,
+    spacing = 'normal',
+    link = false,
     component = 'p',
     ellipsis = false,
     copyable = false,
-    editable = false,
-    value,
-    onChange,
-    onCopy,
-    onEditStart,
-    onEditCancel,
     onExpand,
     class: className = '',
+    style,
     children,
   }: Props = $props();
 </script>
 
 <TypographyBase
   element={component}
-  baseClass="cd-typography"
-  extraClass="cd-typography--paragraph"
+  extraClass="cd-typography-paragraph"
   {type}
   {size}
   {strong}
-  {weight}
   {disabled}
   {mark}
   {underline}
   delete={del}
   {code}
+  {spacing}
+  {link}
   class={className}
+  {style}
   {ellipsis}
   {copyable}
-  {editable}
-  {value}
-  {onChange}
-  {onCopy}
-  {onEditStart}
-  {onEditCancel}
   {onExpand}
 >
   {@render children?.()}

package/dist/typography/Paragraph.svelte.d.ts

@@ -1,30 +1,25 @@
 import type { Snippet } from 'svelte';
-import { type EllipsisConfig, type CopyableConfig, type EditableConfig } from './TypographyBase.svelte';
-type TypoType = 'default' | 'secondary' | 'tertiary' | 'warning' | 'danger' | 'success';
-type TypoWeight = number | 'regular' | 'medium' | 'semibold' | 'bold';
-type TypoSize = 'small' | 'default' | 'large';
+import { type TypoType, type TypoSize, type EllipsisConfig, type CopyableConfig } from './TypographyBase.svelte';
 interface Props {
     type?: TypoType;
-    /** 字号档 small/default/large。spec §4.1 L60 */
+    /** 字号档 normal / small（对齐 Semi）。 */
     size?: TypoSize;
     strong?: boolean;
-    weight?: TypoWeight;
     disabled?: boolean;
     mark?: boolean;
     underline?: boolean;
     delete?: boolean;
     code?: boolean;
+    /** 行距：normal / extended（对齐 Semi spacing）。 */
+    spacing?: 'normal' | 'extended';
+    /** 链接（对齐 Semi link）。 */
+    link?: boolean | Record<string, unknown>;
     component?: string;
     ellipsis?: boolean | EllipsisConfig;
     copyable?: boolean | CopyableConfig;
-    editable?: boolean | EditableConfig;
-    value?: string;
-    onChange?: (value: string) => void;
-    onCopy?: (content: string) => void;
-    onEditStart?: () => void;
-    onEditCancel?: () => void;
-    onExpand?: (expanded: boolean) => void;
+    onExpand?: (expanded: boolean, e: MouseEvent) => void;
     class?: string;
+    style?: string;
     children?: Snippet;
 }
 declare const Paragraph: import("svelte").Component<Props, {}, "">;

package/dist/typography/Paragraph.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Paragraph.svelte.d.ts","sourceRoot":"","sources":["../../src/typography/Paragraph.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAuB,EACnB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,yBAAyB,CAAC;AAGjC,KAAK,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AACxF,KAAK,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AACtE,KAAK,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AAE9C,UAAU,KAAK;IACb,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;IACpC,QAAQ,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;IACpC,QAAQ,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAyCH,QAAA,MAAM,SAAS,2CAAwC,CAAC;AACxD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9C,eAAe,SAAS,CAAC"}
+{"version":3,"file":"Paragraph.svelte.d.ts","sourceRoot":"","sources":["../../src/typography/Paragraph.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAuB,EACnB,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,yBAAyB,CAAC;AAGjC,UAAU,KAAK;IACb,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,mCAAmC;IACnC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,6CAA6C;IAC7C,OAAO,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IAChC,wBAAwB;IACxB,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;IACpC,QAAQ,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;IACpC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAkCH,QAAA,MAAM,SAAS,2CAAwC,CAAC;AACxD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9C,eAAe,SAAS,CAAC"}

package/dist/typography/Text.svelte

@@ -1,48 +1,45 @@
 <!--
-  Typography.Text — see specs/components/basic/Typography.spec.md
-  Renders a <span>. Shares the cd-typography base style class.
-  ellipsis / copyable / editable 交互经 TypographyBase 组合 @chenzy-design/core 原语。
+  Typography.Text — 渲染 <span>，对齐 Semi Typography.Text。
+  共享 cd-typography 基础样式，ellipsis / copyable 交互经 TypographyBase 组合 core 原语。
 -->
 <script lang="ts">
   import type { Snippet } from 'svelte';
   import TypographyBase, {
+    type TypoType,
+    type TypoSize,
     type EllipsisConfig,
     type CopyableConfig,
-    type EditableConfig,
   } from './TypographyBase.svelte';
 
-  type TypoType = 'default' | 'secondary' | 'tertiary' | 'warning' | 'danger' | 'success';
-  type TypoWeight = number | 'regular' | 'medium' | 'semibold' | 'bold';
-  type TypoSize = 'small' | 'default' | 'large';
-
   interface Props {
     type?: TypoType;
-    /** 字号档 small/default/large。spec §4.1 L60 */
+    /** 字号档 normal / small / inherit（对齐 Semi）。 */
     size?: TypoSize;
     strong?: boolean;
-    weight?: TypoWeight;
+    /** 字重（数字，对齐 Semi Text weight: number）。 */
+    weight?: number;
     disabled?: boolean;
     mark?: boolean;
     underline?: boolean;
     delete?: boolean;
     code?: boolean;
+    /** 前置图标（对齐 Semi icon）。 */
+    icon?: Snippet;
+    /** 链接（对齐 Semi link）：true 或透传给 <a> 的属性对象。 */
+    link?: boolean | Record<string, unknown>;
     component?: string;
     ellipsis?: boolean | EllipsisConfig;
     copyable?: boolean | CopyableConfig;
-    editable?: boolean | EditableConfig;
-    value?: string;
-    onChange?: (value: string) => void;
-    onCopy?: (content: string) => void;
-    onEditStart?: () => void;
-    onEditCancel?: () => void;
-    onExpand?: (expanded: boolean) => void;
+    onExpand?: (expanded: boolean, e: MouseEvent) => void;
     class?: string;
+    /** 自定义内联样式（对齐 Semi Typography style）。 */
+    style?: string;
     children?: Snippet;
   }
 
   let {
-    type = 'default',
-    size = 'default',
+    type = 'primary',
+    size = 'normal',
     strong = false,
     weight,
     disabled = false,
@@ -50,25 +47,20 @@
     underline = false,
     delete: del = false,
     code = false,
+    icon,
+    link = false,
     component = 'span',
     ellipsis = false,
     copyable = false,
-    editable = false,
-    value,
-    onChange,
-    onCopy,
-    onEditStart,
-    onEditCancel,
     onExpand,
     class: className = '',
+    style,
     children,
   }: Props = $props();
 </script>
 
 <TypographyBase
   element={component}
-  baseClass="cd-typography"
-  extraClass="cd-typography--text"
   {type}
   {size}
   {strong}
@@ -78,15 +70,12 @@
   {underline}
   delete={del}
   {code}
+  {icon}
+  {link}
   class={className}
+  {style}
   {ellipsis}
   {copyable}
-  {editable}
-  {value}
-  {onChange}
-  {onCopy}
-  {onEditStart}
-  {onEditCancel}
   {onExpand}
 >
   {@render children?.()}

package/dist/typography/Text.svelte.d.ts

@@ -1,30 +1,28 @@
 import type { Snippet } from 'svelte';
-import { type EllipsisConfig, type CopyableConfig, type EditableConfig } from './TypographyBase.svelte';
-type TypoType = 'default' | 'secondary' | 'tertiary' | 'warning' | 'danger' | 'success';
-type TypoWeight = number | 'regular' | 'medium' | 'semibold' | 'bold';
-type TypoSize = 'small' | 'default' | 'large';
+import { type TypoType, type TypoSize, type EllipsisConfig, type CopyableConfig } from './TypographyBase.svelte';
 interface Props {
     type?: TypoType;
-    /** 字号档 small/default/large。spec §4.1 L60 */
+    /** 字号档 normal / small / inherit（对齐 Semi）。 */
     size?: TypoSize;
     strong?: boolean;
-    weight?: TypoWeight;
+    /** 字重（数字，对齐 Semi Text weight: number）。 */
+    weight?: number;
     disabled?: boolean;
     mark?: boolean;
     underline?: boolean;
     delete?: boolean;
     code?: boolean;
+    /** 前置图标（对齐 Semi icon）。 */
+    icon?: Snippet;
+    /** 链接（对齐 Semi link）：true 或透传给 <a> 的属性对象。 */
+    link?: boolean | Record<string, unknown>;
     component?: string;
     ellipsis?: boolean | EllipsisConfig;
     copyable?: boolean | CopyableConfig;
-    editable?: boolean | EditableConfig;
-    value?: string;
-    onChange?: (value: string) => void;
-    onCopy?: (content: string) => void;
-    onEditStart?: () => void;
-    onEditCancel?: () => void;
-    onExpand?: (expanded: boolean) => void;
+    onExpand?: (expanded: boolean, e: MouseEvent) => void;
     class?: string;
+    /** 自定义内联样式（对齐 Semi Typography style）。 */
+    style?: string;
     children?: Snippet;
 }
 declare const Text: import("svelte").Component<Props, {}, "">;