@chenzy-design/svelte 0.2.1 → 0.3.1

package/dist/components.json

@@ -1,8 +1,8 @@
 {
   "version": "1",
   "generatedFrom": "@chenzy-design/svelte component meta.ts files",
-  "generatedAt": "2026-06-27T14:57:18.183Z",
-  "count": 69,
+  "generatedAt": "2026-07-01T07:34:43.032Z",
+  "count": 70,
   "components": {
     "Button": {
       "name": "Button",
@@ -12,32 +12,56 @@
         {
           "name": "type",
           "type": "'primary'|'secondary'|'tertiary'|'warning'|'danger'",
-          "default": "secondary"
+          "default": "secondary",
+          "desc": "语义类型"
         },
         {
           "name": "theme",
           "type": "'solid'|'borderless'|'light'|'outline'",
-          "default": "light"
+          "default": "light",
+          "desc": "视觉变体：有背景/无背景/浅背景/边框"
         },
         {
           "name": "size",
           "type": "'small'|'default'|'large'",
-          "default": "default"
+          "default": "default",
+          "desc": "尺寸"
         },
         {
           "name": "block",
           "type": "boolean",
-          "default": "false"
+          "default": "false",
+          "desc": "撑满容器宽度"
         },
         {
           "name": "disabled",
           "type": "boolean",
-          "default": "false"
+          "default": "false",
+          "desc": "禁用状态"
         },
         {
           "name": "loading",
           "type": "boolean",
-          "default": "false"
+          "default": "false",
+          "desc": "加载态（带 Spin，禁用点击）"
+        },
+        {
+          "name": "colorful",
+          "type": "boolean",
+          "default": "false",
+          "desc": "AI 多彩按钮：所有 theme 下品牌蓝→紫渐变；type 仅 primary/tertiary 有意义"
+        },
+        {
+          "name": "htmlType",
+          "type": "'button'|'submit'|'reset'",
+          "default": "button",
+          "desc": "原生 button 的 type 值"
+        },
+        {
+          "name": "icon",
+          "type": "Snippet",
+          "default": "undefined",
+          "desc": "图标插槽；纯图标按钮需提供 ariaLabel"
         },
         {
           "name": "iconPosition",
@@ -46,16 +70,34 @@
           "desc": "图标相对文字位置"
         },
         {
-          "name": "href",
+          "name": "noHorizontalPadding",
+          "type": "boolean|'left'|'right'|('left'|'right')[]",
+          "default": "false",
+          "desc": "仅设置 icon 时去单/双侧水平内距"
+        },
+        {
+          "name": "ariaLabel",
           "type": "string",
           "default": "undefined",
-          "desc": "提供则渲染为链接"
+          "desc": "无障碍名；纯图标按钮必填"
         },
         {
-          "name": "ariaLabel",
+          "name": "class",
+          "type": "string",
+          "default": "undefined",
+          "desc": "根元素自定义类名"
+        },
+        {
+          "name": "style",
+          "type": "string",
+          "default": "undefined",
+          "desc": "根元素自定义内联样式"
+        },
+        {
+          "name": "contentClassName",
           "type": "string",
           "default": "undefined",
-          "desc": "仅图标按钮必填"
+          "desc": "内容区自定义类名"
         }
       ],
       "events": [
@@ -63,6 +105,21 @@
           "name": "onclick",
           "payload": "MouseEvent",
           "desc": "disabled/loading 时不触发"
+        },
+        {
+          "name": "onmousedown",
+          "payload": "MouseEvent",
+          "desc": "鼠标按下"
+        },
+        {
+          "name": "onmouseenter",
+          "payload": "MouseEvent",
+          "desc": "鼠标移入"
+        },
+        {
+          "name": "onmouseleave",
+          "payload": "MouseEvent",
+          "desc": "鼠标移出"
         }
       ],
       "slots": [
@@ -75,6 +132,154 @@
           "desc": "图标"
         }
       ],
+      "subComponents": [
+        {
+          "name": "ButtonGroup",
+          "usage": "<ButtonGroup> 包裹多个 <Button>，组级默认经 context 透传",
+          "desc": "横向拼接多个 Button；组级 size/type/theme/disabled/colorful 经 context 透传，组内 Button 显式 prop 始终优先。",
+          "props": [
+            {
+              "name": "type",
+              "type": "'primary'|'secondary'|'tertiary'|'warning'|'danger'",
+              "default": "undefined",
+              "desc": "组级语义类型"
+            },
+            {
+              "name": "theme",
+              "type": "'solid'|'borderless'|'light'|'outline'",
+              "default": "undefined",
+              "desc": "组级视觉变体"
+            },
+            {
+              "name": "size",
+              "type": "'small'|'default'|'large'",
+              "default": "undefined",
+              "desc": "组级尺寸"
+            },
+            {
+              "name": "disabled",
+              "type": "boolean",
+              "default": "undefined",
+              "desc": "组级禁用，整组一并禁用"
+            },
+            {
+              "name": "colorful",
+              "type": "boolean",
+              "default": "undefined",
+              "desc": "组级多彩，透传给组内 Button"
+            },
+            {
+              "name": "ariaLabel",
+              "type": "string",
+              "default": "undefined",
+              "desc": "按钮组语义标签（aria-label）"
+            },
+            {
+              "name": "class",
+              "type": "string",
+              "default": "undefined",
+              "desc": "根元素自定义类名"
+            },
+            {
+              "name": "style",
+              "type": "string",
+              "default": "undefined",
+              "desc": "根元素自定义内联样式"
+            }
+          ]
+        },
+        {
+          "name": "SplitButtonGroup",
+          "usage": "<SplitButtonGroup items={...}>，左侧主操作 + 右侧箭头触发下拉",
+          "desc": "分裂按钮：左侧主 Button + 右侧箭头按钮，点击箭头弹出 Dropdown（复用 items API 或 menu snippet）。",
+          "props": [
+            {
+              "name": "type",
+              "type": "'primary'|'secondary'|'tertiary'|'warning'|'danger'",
+              "default": "primary",
+              "desc": "两侧按钮语义类型"
+            },
+            {
+              "name": "theme",
+              "type": "'solid'|'borderless'|'light'|'outline'",
+              "default": "solid",
+              "desc": "两侧按钮视觉变体"
+            },
+            {
+              "name": "size",
+              "type": "'small'|'default'|'large'",
+              "default": "default",
+              "desc": "两侧按钮尺寸"
+            },
+            {
+              "name": "disabled",
+              "type": "boolean",
+              "default": "false",
+              "desc": "禁用整个分裂按钮"
+            },
+            {
+              "name": "loading",
+              "type": "boolean",
+              "default": "false",
+              "desc": "主按钮加载态"
+            },
+            {
+              "name": "items",
+              "type": "DropdownItem[]",
+              "default": "[]",
+              "desc": "下拉菜单数据项（透传给 Dropdown.items）"
+            },
+            {
+              "name": "position",
+              "type": "Placement",
+              "default": "bottomEnd",
+              "desc": "下拉浮层位置"
+            },
+            {
+              "name": "triggerAriaLabel",
+              "type": "string",
+              "default": "更多操作",
+              "desc": "下拉箭头按钮的 aria-label"
+            },
+            {
+              "name": "onSelect",
+              "type": "(key: string|number) => void",
+              "default": "undefined",
+              "desc": "选中下拉项回调"
+            },
+            {
+              "name": "onclick",
+              "type": "(e: MouseEvent) => void",
+              "default": "undefined",
+              "desc": "主按钮点击回调"
+            },
+            {
+              "name": "menu",
+              "type": "Snippet",
+              "default": "undefined",
+              "desc": "自定义下拉菜单体（替代 items）"
+            },
+            {
+              "name": "ariaLabel",
+              "type": "string",
+              "default": "undefined",
+              "desc": "分裂按钮组语义标签（root aria-label）"
+            },
+            {
+              "name": "class",
+              "type": "string",
+              "default": "undefined",
+              "desc": "根元素自定义类名"
+            },
+            {
+              "name": "style",
+              "type": "string",
+              "default": "undefined",
+              "desc": "根元素自定义内联样式"
+            }
+          ]
+        }
+      ],
       "a11y": {
         "role": "button",
         "keyboard": [
@@ -868,17 +1073,19 @@
         "--cd-typography-color",
         "--cd-typography-color-secondary",
         "--cd-typography-color-tertiary",
+        "--cd-typography-color-quaternary",
         "--cd-typography-color-link",
         "--cd-typography-color-link-hover",
         "--cd-typography-mark-bg",
         "--cd-typography-code-bg",
+        "--cd-typography-code-color",
         "--cd-typography-code-font-size",
         "--cd-typography-font-size-small",
         "--cd-typography-font-size-default",
         "--cd-typography-font-size-large",
         "--cd-typography-action-color",
         "--cd-typography-action-color-hover",
-        "--cd-font-size-1..6"
+        "--cd-font-size-small..6"
       ],
       "relatedComponents": [
         "Tooltip",
@@ -1059,7 +1266,26 @@
             {
               "name": "class",
               "type": "string",
-              "default": "''"
+              "default": "''",
+              "desc": "根元素自定义类名"
+            },
+            {
+              "name": "style",
+              "type": "string",
+              "default": "undefined",
+              "desc": "根元素自定义内联样式"
+            },
+            {
+              "name": "ariaLabel",
+              "type": "string",
+              "default": "undefined",
+              "desc": "可访问性标签"
+            },
+            {
+              "name": "role",
+              "type": "string",
+              "default": "undefined",
+              "desc": "可访问性 role"
             }
           ]
         },
@@ -1082,7 +1308,26 @@
             {
               "name": "class",
               "type": "string",
-              "default": "''"
+              "default": "''",
+              "desc": "根元素自定义类名"
+            },
+            {
+              "name": "style",
+              "type": "string",
+              "default": "undefined",
+              "desc": "根元素自定义内联样式"
+            },
+            {
+              "name": "ariaLabel",
+              "type": "string",
+              "default": "undefined",
+              "desc": "可访问性标签"
+            },
+            {
+              "name": "role",
+              "type": "string",
+              "default": "undefined",
+              "desc": "可访问性 role"
             }
           ]
         },
@@ -1104,7 +1349,26 @@
             {
               "name": "class",
               "type": "string",
-              "default": "''"
+              "default": "''",
+              "desc": "根元素自定义类名"
+            },
+            {
+              "name": "style",
+              "type": "string",
+              "default": "undefined",
+              "desc": "根元素自定义内联样式"
+            },
+            {
+              "name": "ariaLabel",
+              "type": "string",
+              "default": "undefined",
+              "desc": "可访问性标签"
+            },
+            {
+              "name": "role",
+              "type": "string",
+              "default": "undefined",
+              "desc": "可访问性 role"
             }
           ]
         },
@@ -1121,7 +1385,26 @@
             {
               "name": "class",
               "type": "string",
-              "default": "''"
+              "default": "''",
+              "desc": "根元素自定义类名"
+            },
+            {
+              "name": "style",
+              "type": "string",
+              "default": "undefined",
+              "desc": "根元素自定义内联样式"
+            },
+            {
+              "name": "ariaLabel",
+              "type": "string",
+              "default": "undefined",
+              "desc": "可访问性标签"
+            },
+            {
+              "name": "role",
+              "type": "string",
+              "default": "undefined",
+              "desc": "可访问性 role"
             }
           ]
         },
@@ -1178,13 +1461,38 @@
             {
               "name": "class",
               "type": "string",
-              "default": "''"
+              "default": "''",
+              "desc": "根元素自定义类名"
+            },
+            {
+              "name": "style",
+              "type": "string",
+              "default": "undefined",
+              "desc": "根元素自定义内联样式"
+            },
+            {
+              "name": "ariaLabel",
+              "type": "string",
+              "default": "undefined",
+              "desc": "可访问性标签，描述该 Sider 作用"
+            },
+            {
+              "name": "role",
+              "type": "string",
+              "default": "undefined",
+              "desc": "可访问性 role"
             },
             {
               "name": "onCollapse",
               "type": "(collapsed, trigger:'click'|'breakpoint')=>void",
               "default": "undefined"
             },
+            {
+              "name": "onBreakpoint",
+              "type": "(matched: boolean, breakpoint) => void",
+              "default": "undefined",
+              "desc": "命中响应式断点时回调"
+            },
             {
               "name": "trigger",
               "type": "Snippet<[{collapsed,toggle}]>",
@@ -1198,6 +1506,10 @@
         {
           "name": "onCollapse",
           "desc": "Sider 收起状态变化，第二参数区分 click / breakpoint 触发来源"
+        },
+        {
+          "name": "onBreakpoint",
+          "desc": "Sider 命中响应式断点时触发，(matched, breakpoint)"
         }
       ],
       "slots": [
@@ -1756,7 +2068,7 @@
         "--cd-switch-*",
         "--cd-focus-ring",
         "--cd-motion-*",
-        "--cd-radius-full"
+        "--cd-border-radius-full"
       ]
     },
     "Checkbox": {
@@ -1825,6 +2137,24 @@
           "type": "string",
           "default": "useId()"
         },
+        {
+          "name": "addonId",
+          "type": "string",
+          "default": "undefined",
+          "desc": "标签内容容器 id，经 aria-labelledby 关联为可访问名"
+        },
+        {
+          "name": "extraId",
+          "type": "string",
+          "default": "undefined",
+          "desc": "辅助说明 id，未提供则由内部生成"
+        },
+        {
+          "name": "preventScroll",
+          "type": "boolean",
+          "default": "undefined",
+          "desc": "autoFocus 聚焦时是否阻止滚动（对齐 Semi）"
+        },
         {
           "name": "onChange",
           "type": "(checked: boolean) => void",
@@ -1995,41 +2325,105 @@
           "name": "onChange",
           "type": "(checked: boolean) => void",
           "default": "undefined"
-        }
-      ],
-      "group": {
-        "name": "RadioGroup",
-        "props": [
-          {
-            "name": "value",
-            "type": "string | number | boolean",
-            "default": "undefined",
-            "desc": "受控选中值"
-          },
-          {
-            "name": "defaultValue",
-            "type": "string | number | boolean",
-            "default": "undefined"
-          },
-          {
-            "name": "name",
-            "type": "string",
-            "default": "useId()"
-          },
-          {
-            "name": "options",
-            "type": "Array<{label,value,disabled?,extra?}>",
-            "default": "undefined"
-          },
-          {
-            "name": "disabled",
-            "type": "boolean",
-            "default": "false"
-          },
-          {
-            "name": "size",
-            "type": "'small'|'default'|'large'",
-            "default": "default"
+        },
+        {
+          "name": "addonId",
+          "type": "string",
+          "default": "undefined",
+          "desc": "内容容器 id，用作 input 的 aria-labelledby"
+        },
+        {
+          "name": "addonClassName",
+          "type": "string",
+          "default": "undefined",
+          "desc": "内容容器附加 class"
+        },
+        {
+          "name": "addonStyle",
+          "type": "string",
+          "default": "undefined",
+          "desc": "内容容器内联样式"
+        },
+        {
+          "name": "autoFocus",
+          "type": "boolean",
+          "default": "false",
+          "desc": "挂载时自动聚焦"
+        },
+        {
+          "name": "extraId",
+          "type": "string",
+          "default": "undefined",
+          "desc": "自定义 extra 元素 id（默认由 fieldId 派生）"
+        },
+        {
+          "name": "mode",
+          "type": "'advanced'|''",
+          "default": "''",
+          "desc": "advanced：再次点击选中项可取消（onChange(false)）"
+        },
+        {
+          "name": "style",
+          "type": "string",
+          "default": "undefined",
+          "desc": "根元素内联样式"
+        },
+        {
+          "name": "onMouseEnter",
+          "type": "(e: MouseEvent) => void",
+          "default": "undefined"
+        },
+        {
+          "name": "onMouseLeave",
+          "type": "(e: MouseEvent) => void",
+          "default": "undefined"
+        },
+        {
+          "name": "ariaLabel",
+          "type": "string",
+          "default": "undefined",
+          "desc": "无障碍标签"
+        },
+        {
+          "name": "preventScroll",
+          "type": "boolean",
+          "default": "false",
+          "desc": "autoFocus 时阻止滚动"
+        }
+      ],
+      "group": {
+        "name": "RadioGroup",
+        "props": [
+          {
+            "name": "value",
+            "type": "string | number | boolean",
+            "default": "undefined",
+            "desc": "受控选中值"
+          },
+          {
+            "name": "defaultValue",
+            "type": "string | number | boolean",
+            "default": "undefined"
+          },
+          {
+            "name": "name",
+            "type": "string",
+            "default": "useId()"
+          },
+          {
+            "name": "options",
+            "type": "Array<{label,value,disabled?,extra?}>",
+            "default": "undefined"
+          },
+          {
+            "name": "disabled",
+            "type": "boolean",
+            "default": "false"
+          },
+          {
+            "name": "size",
+            "type": "'small'|'default'|'large'",
+            "default": "default"
           },
           {
             "name": "status",
@@ -2097,7 +2491,7 @@
         "--cd-focus-ring",
         "--cd-motion-*",
         "--cd-spacing-*",
-        "--cd-radius-full"
+        "--cd-border-radius-full"
       ]
     },
     "InputNumber": {
@@ -2425,6 +2819,18 @@
           "default": "i18n 默认",
           "desc": "无可视标签时的辅助名"
         },
+        {
+          "name": "style",
+          "type": "string",
+          "default": "undefined",
+          "desc": "根元素内联样式，与内部 token 样式合并"
+        },
+        {
+          "name": "preventScroll",
+          "type": "boolean",
+          "default": "undefined",
+          "desc": "autoFocus 聚焦时是否阻止滚动"
+        },
         {
           "name": "onChange",
           "type": "(v: number) => void",
@@ -2435,6 +2841,24 @@
           "type": "(v: number) => void",
           "default": "undefined",
           "desc": "悬停预览值变化；移出时为当前 value"
+        },
+        {
+          "name": "onFocus",
+          "type": "() => void",
+          "default": "undefined",
+          "desc": "根元素获得焦点"
+        },
+        {
+          "name": "onBlur",
+          "type": "() => void",
+          "default": "undefined",
+          "desc": "根元素失去焦点"
+        },
+        {
+          "name": "onKeyDown",
+          "type": "(e: KeyboardEvent) => void",
+          "default": "undefined",
+          "desc": "按键事件（内部处理后透传）"
         }
       ],
       "i18nKeys": [
@@ -2646,6 +3070,48 @@
           "type": "(detail: { index: number }) => void",
           "default": "undefined",
           "desc": "手柄失焦，附带手柄索引"
+        },
+        {
+          "name": "showBoundary",
+          "type": "boolean",
+          "default": "false",
+          "desc": "显示轨道两端边界值标签"
+        },
+        {
+          "name": "showArrow",
+          "type": "boolean",
+          "default": "true",
+          "desc": "tooltip 是否显示箭头"
+        },
+        {
+          "name": "showMarkLabel",
+          "type": "boolean",
+          "default": "true",
+          "desc": "显示标记文本标签"
+        },
+        {
+          "name": "tooltipOnMark",
+          "type": "boolean",
+          "default": "false",
+          "desc": "tooltip 跟随标记位置"
+        },
+        {
+          "name": "handleDot",
+          "type": "{ color: string; size: string } | { color: string; size: string }[]",
+          "default": "undefined",
+          "desc": "自定义手柄圆点样式，range 时为数组"
+        },
+        {
+          "name": "onMouseUp",
+          "type": "(e: MouseEvent) => void",
+          "default": "undefined",
+          "desc": "pointerup 时触发"
+        },
+        {
+          "name": "ariaValuetext",
+          "type": "string",
+          "default": "undefined",
+          "desc": "覆盖 getAriaValueText 的 aria-valuetext 文案"
         }
       ],
       "a11y": {
@@ -2672,8 +3138,8 @@
         "--cd-slider-*",
         "--cd-color-text-3",
         "--cd-spacing-*",
-        "--cd-radius-full",
-        "--cd-shadow-1",
+        "--cd-border-radius-full",
+        "--cd-shadow-elevated",
         "--cd-focus-ring",
         "--cd-motion-*"
       ]
@@ -3636,6 +4102,42 @@
           "default": "false",
           "desc": "内联渲染面板，不使用 trigger 浮层"
         },
+        {
+          "name": "usePopover",
+          "type": "boolean",
+          "default": "false",
+          "desc": "等价于 !inline，显式启用 trigger 浮层（覆盖 inline）"
+        },
+        {
+          "name": "topSlot",
+          "type": "Snippet",
+          "default": "undefined",
+          "desc": "面板顶部 slot"
+        },
+        {
+          "name": "bottomSlot",
+          "type": "Snippet",
+          "default": "undefined",
+          "desc": "面板底部 slot"
+        },
+        {
+          "name": "style",
+          "type": "string",
+          "default": "undefined",
+          "desc": "根元素内联样式"
+        },
+        {
+          "name": "height",
+          "type": "number",
+          "default": "280",
+          "desc": "面板高度 px"
+        },
+        {
+          "name": "width",
+          "type": "number",
+          "default": "280",
+          "desc": "面板宽度 px"
+        },
         {
           "name": "eyeDropper",
           "type": "boolean",
@@ -5214,7 +5716,7 @@
         "--cd-breadcrumb-item-max-width",
         "--cd-focus-ring",
         "--cd-font-size-*",
-        "--cd-radius-1"
+        "--cd-border-radius-small"
       ]
     },
     "Pagination": {
@@ -5521,9 +6023,9 @@
       "tokens": [
         "--cd-steps-*",
         "--cd-focus-ring",
-        "--cd-radius-full",
+        "--cd-border-radius-full",
         "--cd-spacing-*",
-        "--cd-font-size-1"
+        "--cd-font-size-small"
       ]
     },
     "Tabs": {
@@ -5730,7 +6232,7 @@
       "tokens": [
         "--cd-tabs-*",
         "--cd-focus-ring",
-        "--cd-radius-1",
+        "--cd-border-radius-small",
         "--cd-spacing-*"
       ]
     },
@@ -5897,7 +6399,7 @@
       "tokens": [
         "--cd-dropdown-*",
         "--cd-focus-ring",
-        "--cd-radius-1",
+        "--cd-border-radius-small",
         "--cd-spacing-*",
         "--cd-color-danger"
       ]
@@ -5952,6 +6454,30 @@
           "default": "24",
           "desc": "子级缩进像素"
         },
+        {
+          "name": "limitIndent",
+          "type": "boolean",
+          "default": "true",
+          "desc": "仅一级缩进；false 时逐级缩进"
+        },
+        {
+          "name": "toggleIconPosition",
+          "type": "'left'|'right'",
+          "default": "'right'",
+          "desc": "inline 子菜单箭头位置"
+        },
+        {
+          "name": "expandIcon",
+          "type": "Snippet",
+          "default": "undefined",
+          "desc": "自定义展开箭头图标"
+        },
+        {
+          "name": "motion",
+          "type": "boolean",
+          "default": "true",
+          "desc": "子菜单展开动画开关"
+        },
         {
           "name": "inlineCollapsed",
           "type": "boolean",
@@ -6063,17 +6589,389 @@
         "--cd-menu-bg",
         "--cd-menu-item-height",
         "--cd-menu-item-padding",
+        "--cd-menu-item-radius",
         "--cd-menu-item-color",
         "--cd-menu-item-color-selected",
+        "--cd-menu-item-icon-color-selected",
         "--cd-menu-item-color-disabled",
         "--cd-menu-item-bg-hover",
         "--cd-menu-item-bg-selected",
-        "--cd-menu-item-indicator",
         "--cd-menu-submenu-arrow-color",
         "--cd-focus-ring",
         "--cd-motion-*"
       ]
     },
+    "Nav": {
+      "name": "Nav",
+      "category": "navigation",
+      "description": "站点导航菜单（对齐 Semi Navigation）。支持垂直/水平模式、子导航、logo 头部、折叠按钮。字段对齐 Semi（itemKey/text/icon/items），内部委托 Menu 渲染导航体。",
+      "props": [
+        {
+          "name": "items",
+          "type": "NavItemDef[]",
+          "default": "[]",
+          "desc": "导航项列表，字段对齐 Semi：itemKey/text/icon/items（含 items 即子导航）"
+        },
+        {
+          "name": "mode",
+          "type": "'vertical'|'horizontal'",
+          "default": "'vertical'",
+          "desc": "导航方向：侧边/顶部"
+        },
+        {
+          "name": "selectedKeys",
+          "type": "NavKey[]",
+          "default": "undefined",
+          "desc": "受控选中项 key 数组"
+        },
+        {
+          "name": "defaultSelectedKeys",
+          "type": "NavKey[]",
+          "default": "undefined",
+          "desc": "默认选中项 key 数组"
+        },
+        {
+          "name": "openKeys",
+          "type": "NavKey[]",
+          "default": "undefined",
+          "desc": "受控展开子导航 key（vertical 且未折叠有效）"
+        },
+        {
+          "name": "defaultOpenKeys",
+          "type": "NavKey[]",
+          "default": "undefined",
+          "desc": "默认展开子导航 key"
+        },
+        {
+          "name": "isCollapsed",
+          "type": "boolean",
+          "default": "undefined",
+          "desc": "受控折叠态（仅 vertical 有效）"
+        },
+        {
+          "name": "defaultIsCollapsed",
+          "type": "boolean",
+          "default": "false",
+          "desc": "默认折叠态（仅 vertical 有效）"
+        },
+        {
+          "name": "header",
+          "type": "{ logo?: Snippet; text?: string }",
+          "default": "undefined",
+          "desc": "头部配置（logo + 文案）"
+        },
+        {
+          "name": "footer",
+          "type": "{ collapseButton?: boolean }",
+          "default": "undefined",
+          "desc": "底部配置（收起按钮，仅 vertical）"
+        },
+        {
+          "name": "disabled",
+          "type": "boolean",
+          "default": "false",
+          "desc": "整体禁用"
+        },
+        {
+          "name": "inlineIndent",
+          "type": "number",
+          "default": "24",
+          "desc": "子级缩进像素（透传 Menu）"
+        },
+        {
+          "name": "limitIndent",
+          "type": "boolean",
+          "default": "true",
+          "desc": "仅一级缩进；false 时逐级缩进"
+        },
+        {
+          "name": "toggleIconPosition",
+          "type": "'left'|'right'",
+          "default": "'right'",
+          "desc": "子导航展开箭头位置"
+        },
+        {
+          "name": "expandIcon",
+          "type": "Snippet",
+          "default": "undefined",
+          "desc": "自定义展开箭头图标"
+        },
+        {
+          "name": "subNavMotion",
+          "type": "boolean",
+          "default": "true",
+          "desc": "子导航展开动画开关"
+        },
+        {
+          "name": "subNavOpenDelay",
+          "type": "number",
+          "default": "undefined",
+          "desc": "浮层子导航展开延迟 ms"
+        },
+        {
+          "name": "subNavCloseDelay",
+          "type": "number",
+          "default": "undefined",
+          "desc": "浮层子导航关闭延迟 ms"
+        },
+        {
+          "name": "getPopupContainer",
+          "type": "() => HTMLElement",
+          "default": "undefined",
+          "desc": "浮层挂载容器"
+        },
+        {
+          "name": "renderWrapper",
+          "type": "Snippet",
+          "default": "undefined",
+          "desc": "自定义导航项外层包裹"
+        },
+        {
+          "name": "class",
+          "type": "string",
+          "default": "undefined",
+          "desc": "根元素自定义类名"
+        },
+        {
+          "name": "style",
+          "type": "string",
+          "default": "undefined",
+          "desc": "根元素自定义内联样式"
+        },
+        {
+          "name": "bodyStyle",
+          "type": "string",
+          "default": "undefined",
+          "desc": "导航项列表容器样式（对齐 Semi bodyStyle）"
+        },
+        {
+          "name": "ariaLabel",
+          "type": "string",
+          "default": "undefined",
+          "desc": "可访问性标签"
+        }
+      ],
+      "events": [
+        {
+          "name": "onSelect",
+          "payload": "NavKey",
+          "desc": "选中导航项时触发"
+        },
+        {
+          "name": "onClick",
+          "payload": "NavKey",
+          "desc": "点击任意导航项时触发"
+        },
+        {
+          "name": "onOpenChange",
+          "payload": "NavKey[]",
+          "desc": "展开/收起子导航时触发"
+        },
+        {
+          "name": "onCollapseChange",
+          "payload": "boolean",
+          "desc": "折叠态变化时触发"
+        }
+      ],
+      "slots": [
+        {
+          "name": "headerSlot",
+          "desc": "自定义头部（覆盖 header 配置对象）"
+        },
+        {
+          "name": "footerSlot",
+          "desc": "自定义底部（覆盖 footer 配置对象）"
+        },
+        {
+          "name": "children",
+          "desc": "声明式子项（<Nav.Item>/<Nav.Sub>），与 items 二选一"
+        }
+      ],
+      "subComponents": [
+        {
+          "name": "Nav.Header",
+          "element": "div",
+          "props": [
+            {
+              "name": "logo",
+              "type": "Snippet",
+              "default": "undefined",
+              "desc": "Logo 节点"
+            },
+            {
+              "name": "text",
+              "type": "string",
+              "default": "undefined",
+              "desc": "Logo 文案"
+            },
+            {
+              "name": "class",
+              "type": "string",
+              "default": "undefined",
+              "desc": "自定义类名"
+            },
+            {
+              "name": "style",
+              "type": "string",
+              "default": "undefined",
+              "desc": "自定义内联样式"
+            }
+          ]
+        },
+        {
+          "name": "Nav.Footer",
+          "element": "div",
+          "props": [
+            {
+              "name": "collapseButton",
+              "type": "boolean",
+              "default": "false",
+              "desc": "收起按钮（仅 vertical 生效）"
+            },
+            {
+              "name": "class",
+              "type": "string",
+              "default": "undefined",
+              "desc": "自定义类名"
+            },
+            {
+              "name": "style",
+              "type": "string",
+              "default": "undefined",
+              "desc": "自定义内联样式"
+            }
+          ]
+        },
+        {
+          "name": "Nav.Item",
+          "element": "—",
+          "props": [
+            {
+              "name": "itemKey",
+              "type": "NavKey",
+              "default": "—",
+              "desc": "导航项唯一标识（必填）"
+            },
+            {
+              "name": "text",
+              "type": "string",
+              "default": "—",
+              "desc": "导航项文案"
+            },
+            {
+              "name": "icon",
+              "type": "Snippet",
+              "default": "undefined",
+              "desc": "项前置图标"
+            },
+            {
+              "name": "disabled",
+              "type": "boolean",
+              "default": "undefined",
+              "desc": "是否禁用"
+            },
+            {
+              "name": "link",
+              "type": "string",
+              "default": "undefined",
+              "desc": "链接地址（渲染原生 <a>）"
+            },
+            {
+              "name": "target",
+              "type": "string",
+              "default": "undefined",
+              "desc": "链接 target"
+            },
+            {
+              "name": "rel",
+              "type": "string",
+              "default": "undefined",
+              "desc": "链接 rel"
+            },
+            {
+              "name": "onClick",
+              "type": "(e: MouseEvent) => void",
+              "default": "undefined",
+              "desc": "项级点击回调"
+            },
+            {
+              "name": "onMouseEnter",
+              "type": "(e: MouseEvent) => void",
+              "default": "undefined",
+              "desc": "鼠标移入"
+            },
+            {
+              "name": "onMouseLeave",
+              "type": "(e: MouseEvent) => void",
+              "default": "undefined",
+              "desc": "鼠标移出"
+            }
+          ]
+        },
+        {
+          "name": "Nav.Sub",
+          "element": "—",
+          "props": [
+            {
+              "name": "itemKey",
+              "type": "NavKey",
+              "default": "—",
+              "desc": "子导航唯一标识（必填）"
+            },
+            {
+              "name": "text",
+              "type": "string",
+              "default": "—",
+              "desc": "子导航标题文案"
+            },
+            {
+              "name": "icon",
+              "type": "Snippet",
+              "default": "undefined",
+              "desc": "标题前置图标"
+            },
+            {
+              "name": "disabled",
+              "type": "boolean",
+              "default": "undefined",
+              "desc": "是否禁用"
+            },
+            {
+              "name": "children",
+              "type": "Snippet",
+              "default": "undefined",
+              "desc": "内嵌 Nav.Item / Nav.Sub"
+            }
+          ]
+        }
+      ],
+      "a11y": {
+        "role": "navigation",
+        "keyboard": [
+          "Tab",
+          "Shift+Tab",
+          "Enter"
+        ],
+        "notes": [
+          "委托 Menu purpose=navigation：渲染 <nav> landmark + 含 link 的叶子为原生 <a>",
+          "选中项 aria-current=page；折叠按钮原生 button + aria-expanded + aria-label"
+        ]
+      },
+      "tokens": [
+        "--cd-nav-*"
+      ],
+      "aiHints": [
+        "侧边导航用 mode=vertical + footer={{collapseButton:true}}；顶部导航用 mode=horizontal。",
+        "items 字段对齐 Semi：itemKey/text/icon/items（非 Menu 的 key/label）。",
+        "配合 Layout：<Layout.Sider><Nav mode=vertical/></Layout.Sider> 或 <Layout.Header><Nav mode=horizontal/></Layout.Header>。"
+      ],
+      "examples": [
+        {
+          "title": "侧边导航",
+          "code": "<Nav mode=\"vertical\" items={items} header={{logo, text:\"后台\"}} footer={{collapseButton:true}} />"
+        }
+      ]
+    },
     "Anchor": {
       "name": "Anchor",
       "category": "navigation",
@@ -6185,7 +7083,7 @@
         "--cd-anchor-ink-color",
         "--cd-anchor-ink-width",
         "--cd-focus-ring",
-        "--cd-radius-1",
+        "--cd-border-radius-small",
         "--cd-motion-*"
       ]
     },
@@ -6359,6 +7257,8 @@
         "--cd-tag-height-small",
         "--cd-tag-height-large",
         "--cd-tag-padding-x",
+        "--cd-tag-padding-y",
+        "--cd-tag-padding-y-large",
         "--cd-tag-radius",
         "--cd-tag-font-size",
         "--cd-tag-gap"
@@ -6412,7 +7312,7 @@
         },
         {
           "name": "size",
-          "type": "'extra-small'|'small'|'default'|'large'|'extra-large'|number",
+          "type": "'extra-small'|'small'|'default'|'medium'|'large'|'extra-large'|number",
           "default": "'default'",
           "desc": "枚举映射 token，number 内联 px"
         },
@@ -6492,10 +7392,12 @@
         "--cd-avatar-size-extra-small",
         "--cd-avatar-size-small",
         "--cd-avatar-size-default",
+        "--cd-avatar-size-medium",
         "--cd-avatar-size-large",
         "--cd-avatar-size-extra-large",
         "--cd-avatar-bg",
         "--cd-avatar-color",
+        "--cd-avatar-border",
         "--cd-avatar-radius"
       ],
       "responsive": false,
@@ -6819,6 +7721,10 @@
         "--cd-card-padding-small",
         "--cd-card-header-border",
         "--cd-card-title-color",
+        "--cd-card-title-weight",
+        "--cd-card-title-size",
+        "--cd-card-desc-color",
+        "--cd-card-body-color",
         "--cd-card-shadow",
         "--cd-card-shadow-hover"
       ],
@@ -7481,8 +8387,8 @@
       "tokens": [
         "--cd-collapse-*",
         "--cd-focus-ring",
-        "--cd-radius-1",
-        "--cd-spacing-2",
+        "--cd-border-radius-small",
+        "--cd-spacing-tight",
         "--cd-motion-ease-standard",
         "--cd-color-text-3"
       ]
@@ -7653,9 +8559,9 @@
       },
       "tokens": [
         "--cd-timeline-*",
-        "--cd-radius-full",
-        "--cd-spacing-1",
-        "--cd-font-size-1"
+        "--cd-border-radius-full",
+        "--cd-spacing-extra-tight",
+        "--cd-font-size-small"
       ]
     },
     "List": {
@@ -7890,8 +8796,8 @@
         "--cd-list-split-color",
         "--cd-list-header-color",
         "--cd-list-item-color",
-        "--cd-radius-full",
-        "--cd-radius-small",
+        "--cd-border-radius-full",
+        "--cd-border-radius-small",
         "--cd-color-primary"
       ],
       "examples": [
@@ -8095,7 +9001,7 @@
         "--cd-image-preview-overlay",
         "--cd-image-preview-z",
         "--cd-focus-ring",
-        "--cd-radius-full",
+        "--cd-border-radius-full",
         "--cd-motion-duration-fast"
       ],
       "examples": [
@@ -8246,7 +9152,8 @@
       "tokens": [
         "--cd-highlight-bg",
         "--cd-highlight-color",
-        "--cd-radius-small"
+        "--cd-highlight-weight",
+        "--cd-border-radius-small"
       ],
       "examples": [
         {
@@ -8553,11 +9460,11 @@
         "--cd-carousel-arrow-bg",
         "--cd-carousel-arrow-color",
         "--cd-carousel-arrow-size",
-        "--cd-radius-full",
+        "--cd-border-radius-full",
         "--cd-focus-ring",
         "--cd-motion-duration-fast",
         "--cd-motion-ease-standard",
-        "--cd-spacing-2"
+        "--cd-spacing-tight"
       ],
       "examples": [
         {
@@ -10956,6 +11863,7 @@
         "--cd-popconfirm-icon-color-info",
         "--cd-popconfirm-title-color",
         "--cd-popconfirm-title-size",
+        "--cd-popconfirm-title-weight",
         "--cd-popconfirm-content-size",
         "--cd-popconfirm-max-width",
         "--cd-popconfirm-z",
@@ -11600,6 +12508,7 @@
         "--cd-toast-padding",
         "--cd-toast-gap",
         "--cd-toast-font-size",
+        "--cd-toast-font-weight",
         "--cd-toast-max-width",
         "--cd-toast-min-width",
         "--cd-toast-stack-gap",
@@ -11759,6 +12668,7 @@
         "--cd-notification-close-color",
         "--cd-notification-close-color-hover",
         "--cd-notification-title-size",
+        "--cd-notification-title-weight",
         "--cd-notification-content-size",
         "--cd-notification-z",
         "--cd-notification-offset",