@teamix-evo/ui 0.3.0 → 0.5.0

package/manifest.json

@@ -14,9 +14,9 @@
       "description": "Tailwind className 合并工具(clsx + tailwind-merge)",
       "files": [
         {
-          "source": "src/utils/cn.ts",
-          "targetAlias": "utils",
-          "targetName": "cn.ts"
+          "source": "src/lib/utils.ts",
+          "targetAlias": "lib",
+          "targetName": "utils.ts"
         }
       ],
       "dependencies": {
@@ -25,23 +25,74 @@
       },
       "updateStrategy": "frozen"
     },
+    {
+      "id": "color",
+      "name": "Color",
+      "type": "util",
+      "description": "颜色工具类 — 提供 hex/rgb/hsb/hsva 互转、alpha 处理、相等判断",
+      "files": [
+        {
+          "source": "src/lib/color.ts",
+          "targetAlias": "lib",
+          "targetName": "color.ts"
+        }
+      ],
+      "updateStrategy": "frozen"
+    },
+    {
+      "id": "icon",
+      "name": "Icon",
+      "type": "util",
+      "description": "面性状态图标集合 — 9 档语义状态（success/warning/error/info/help/processing/pause/mention/default）面性 SVG，外圈 fill-current 由上层 text-* 控色，内字符白色。不含 loading（请用 lucide Loader2 + animate-spin）。",
+      "files": [
+        {
+          "source": "src/components/icon/index.tsx",
+          "targetAlias": "components",
+          "targetName": "icon.tsx"
+        }
+      ],
+      "meta": "src/components/icon/meta.md",
+      "registryDependencies": ["cn"],
+      "updateStrategy": "frozen",
+      "category": "feedback"
+    },
     {
       "id": "button",
       "name": "Button",
       "type": "component",
-      "description": "通用按钮 — shadcn 实现 + cloud-design 能力并集(loading / icon / shape / block / dashed variant / color 语义双 prop / disabledTooltip)。同文件合一导出 ButtonGroup + ButtonGroupText(等价 antd Space.Compact + cd SplitButton)。",
+      "description": "通用按钮 — shadcn 实现 + cloud-design 能力并集(loading / icon / shape / block / dashed variant / color 语义双 prop / disabledTooltip)。ButtonGroup 已拆为独立组件。",
       "files": [
         {
-          "source": "src/components/button/button.tsx",
+          "source": "src/components/button/index.tsx",
           "targetAlias": "components",
           "targetName": "button.tsx"
         }
       ],
-      "meta": "src/components/button/button.meta.md",
-      "registryDependencies": ["cn", "tooltip"],
+      "meta": "src/components/button/meta.md",
+      "registryDependencies": ["cn", "spinner"],
+      "dependencies": {
+        "radix-ui": "^1.4.3",
+        "class-variance-authority": "^0.7.0",
+        "lucide-react": "^0.460.0"
+      },
+      "updateStrategy": "frozen",
+      "category": "general"
+    },
+    {
+      "id": "button-group",
+      "name": "ButtonGroup",
+      "type": "component",
+      "description": "按钮组容器 — 对齐 shadcn ButtonGroup + antd Space.Compact,支持 SplitButton / Toolbar / Input addon 拼装,Context 统一注入 size。提供 ButtonGroupOverflow 子组件封装操作列 ⋯ 下拉折叠。",
+      "files": [
+        {
+          "source": "src/components/button-group/index.tsx",
+          "targetAlias": "components",
+          "targetName": "button-group.tsx"
+        }
+      ],
+      "meta": "src/components/button-group/meta.md",
+      "registryDependencies": ["cn", "button", "dropdown-menu", "separator"],
       "dependencies": {
-        "@radix-ui/react-slot": "^1.1.0",
-        "@radix-ui/react-tooltip": "^1.1.0",
         "class-variance-authority": "^0.7.0",
         "lucide-react": "^0.460.0"
       },
@@ -55,15 +106,15 @@
       "description": "表单字段标签 — Radix Label 包装,补 antd Form.Item 风格的 required / disabled 显式视觉",
       "files": [
         {
-          "source": "src/components/label/label.tsx",
+          "source": "src/components/label/index.tsx",
           "targetAlias": "components",
           "targetName": "label.tsx"
         }
       ],
-      "meta": "src/components/label/label.meta.md",
+      "meta": "src/components/label/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
-        "@radix-ui/react-label": "^2.1.0",
+        "radix-ui": "^1.4.3",
         "class-variance-authority": "^0.7.0"
       },
       "updateStrategy": "frozen",
@@ -76,14 +127,15 @@
       "description": "徽标 — shadcn 文本徽标 + antd 数字 / 红点 / 状态点合集,单组件四种形态(text / wrapped / standalone numeric / status)",
       "files": [
         {
-          "source": "src/components/badge/badge.tsx",
+          "source": "src/components/badge/index.tsx",
           "targetAlias": "components",
           "targetName": "badge.tsx"
         }
       ],
-      "meta": "src/components/badge/badge.meta.md",
+      "meta": "src/components/badge/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
+        "radix-ui": "^1.4.3",
         "class-variance-authority": "^0.7.0"
       },
       "updateStrategy": "frozen",
@@ -96,15 +148,15 @@
       "description": "分隔线 — Radix Separator + antd Divider 的 dashed / 中间装饰文本",
       "files": [
         {
-          "source": "src/components/separator/separator.tsx",
+          "source": "src/components/separator/index.tsx",
           "targetAlias": "components",
           "targetName": "separator.tsx"
         }
       ],
-      "meta": "src/components/separator/separator.meta.md",
+      "meta": "src/components/separator/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
-        "@radix-ui/react-separator": "^1.1.0"
+        "radix-ui": "^1.4.3"
       },
       "updateStrategy": "frozen",
       "category": "layout"
@@ -113,18 +165,20 @@
       "id": "skeleton",
       "name": "Skeleton",
       "type": "component",
-      "description": "骨架屏 — shadcn pulse 单元素 + antd Avatar/Image/Button/Input/Paragraph 子家族,自动 motion-reduce",
+      "description": "骨架屏 — shadcn v4 base Skeleton (variant/animation/loading/asChild) + 6 子家族 (Avatar/Image/Button/Input/Title/Paragraph),自动 motion-reduce",
       "files": [
         {
-          "source": "src/components/skeleton/skeleton.tsx",
+          "source": "src/components/skeleton/index.tsx",
           "targetAlias": "components",
           "targetName": "skeleton.tsx"
         }
       ],
-      "meta": "src/components/skeleton/skeleton.meta.md",
+      "meta": "src/components/skeleton/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
-        "class-variance-authority": "^0.7.0"
+        "radix-ui": "^1.4.3",
+        "class-variance-authority": "^0.7.0",
+        "lucide-react": "^0.460.0"
       },
       "updateStrategy": "frozen",
       "category": "feedback"
@@ -133,18 +187,18 @@
       "id": "avatar",
       "name": "Avatar",
       "type": "component",
-      "description": "头像 — Radix Avatar(自动 fallback)+ antd 的 size / shape / Avatar.Group",
+      "description": "头像 — Radix Avatar(自动 fallback)+ shadcn v4 风格 size / shape + AvatarBadge / AvatarGroup",
       "files": [
         {
-          "source": "src/components/avatar/avatar.tsx",
+          "source": "src/components/avatar/index.tsx",
           "targetAlias": "components",
           "targetName": "avatar.tsx"
         }
       ],
-      "meta": "src/components/avatar/avatar.meta.md",
+      "meta": "src/components/avatar/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
-        "@radix-ui/react-avatar": "^1.1.0",
+        "radix-ui": "^1.4.3",
         "class-variance-authority": "^0.7.0",
         "lucide-react": "^0.460.0"
       },
@@ -155,18 +209,18 @@
       "id": "progress",
       "name": "Progress",
       "type": "component",
-      "description": "进度条 — Radix 线性 + antd 的 status / showInfo / size 并集 + 配套 ProgressCircle 环形",
+      "description": "进度条 — shadcn v4 线性进度（Radix Root/Indicator）；提供 size / 语义色 color (default/success/warning/destructive，ADR 0021) / progressive 渐进色 / showInfo / format 自定义文本，并保留 value=null 不确定态",
       "files": [
         {
-          "source": "src/components/progress/progress.tsx",
+          "source": "src/components/progress/index.tsx",
           "targetAlias": "components",
           "targetName": "progress.tsx"
         }
       ],
-      "meta": "src/components/progress/progress.meta.md",
+      "meta": "src/components/progress/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
-        "@radix-ui/react-progress": "^1.1.0"
+        "radix-ui": "^1.4.3"
       },
       "updateStrategy": "frozen",
       "category": "feedback"
@@ -175,18 +229,18 @@
       "id": "switch",
       "name": "Switch",
       "type": "component",
-      "description": "开关 — Radix Switch + antd 的 loading / checkedChildren / unCheckedChildren / size",
+      "description": "开关 — 在两态间切换；支持 size / loading / checkedChildren / unCheckedChildren，内文宽度自适应。",
       "files": [
         {
-          "source": "src/components/switch/switch.tsx",
+          "source": "src/components/switch/index.tsx",
           "targetAlias": "components",
           "targetName": "switch.tsx"
         }
       ],
-      "meta": "src/components/switch/switch.meta.md",
+      "meta": "src/components/switch/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
-        "@radix-ui/react-switch": "^1.1.0",
+        "radix-ui": "^1.4.3",
         "lucide-react": "^0.460.0"
       },
       "updateStrategy": "frozen",
@@ -196,18 +250,18 @@
       "id": "slider",
       "name": "Slider",
       "type": "component",
-      "description": "滑块 — Radix Slider(原生支持单/双滑块)+ antd marks 刻度",
+      "description": "滑块 — Radix Slider 原生单/双滑块 + marks 刻度 + tooltip + reverse",
       "files": [
         {
-          "source": "src/components/slider/slider.tsx",
+          "source": "src/components/slider/index.tsx",
           "targetAlias": "components",
           "targetName": "slider.tsx"
         }
       ],
-      "meta": "src/components/slider/slider.meta.md",
-      "registryDependencies": ["cn"],
+      "meta": "src/components/slider/meta.md",
+      "registryDependencies": ["cn", "tooltip"],
       "dependencies": {
-        "@radix-ui/react-slider": "^1.2.0"
+        "radix-ui": "^1.4.3"
       },
       "updateStrategy": "frozen",
       "category": "data-entry"
@@ -216,15 +270,15 @@
       "id": "input",
       "name": "Input",
       "type": "component",
-      "description": "单行文本输入 — clearable / showCount / size(sm 24 / md 32 / lg 36,与 Button 同档)/ error 四档内建能力。前缀/后缀/addon 等复合形态已拆出独立 InputGroup;多行已拆出独立 Textarea",
+      "description": "单行文本输入 — 极薄的原生 input 包装，size 三档(sm 24 / default 32 / lg 36，与 Button 同档) + aria-invalid 错误态。前后缀 / 清除 / 密码切换 / 字符计数等装饰能力全部走 InputGroup;多行已拆出独立 Textarea",
       "files": [
         {
-          "source": "src/components/input/input.tsx",
+          "source": "src/components/input/index.tsx",
           "targetAlias": "components",
           "targetName": "input.tsx"
         }
       ],
-      "meta": "src/components/input/input.meta.md",
+      "meta": "src/components/input/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
         "lucide-react": "^0.460.0"
@@ -236,15 +290,15 @@
       "id": "textarea",
       "name": "Textarea",
       "type": "component",
-      "description": "多行文本输入 — autoSize(布尔或 minRows/maxRows)+ showCount + size 三档字号,与 Input 同档对齐;高度由 rows / autoSize 控制",
+      "description": "多行文本输入 — size 三档字号与 Input 对齐,高度自适应由 CSS field-sizing-content 原生提供(无 minRows/maxRows props)。字符计数 / 前后缀插槽走 InputGroup + InputGroupTextarea",
       "files": [
         {
-          "source": "src/components/textarea/textarea.tsx",
+          "source": "src/components/textarea/index.tsx",
           "targetAlias": "components",
           "targetName": "textarea.tsx"
         }
       ],
-      "meta": "src/components/textarea/textarea.meta.md",
+      "meta": "src/components/textarea/meta.md",
       "registryDependencies": ["cn"],
       "updateStrategy": "frozen",
       "category": "data-entry"
@@ -253,15 +307,15 @@
       "id": "input-group",
       "name": "InputGroup",
       "type": "component",
-      "description": "复合输入容器 — shadcn 2025-10 新增,等价 antd Input 的 prefix/suffix/addonBefore/addonAfter 集合;通过 InputGroupAddon(position=before|after) + InputGroupInput / InputGroupTextarea 复合插槽组合图标 / 按钮 / 文本",
+      "description": "复合输入容器 — shadcn 2025-10 新增,等价 antd Input 的 prefix/suffix/addonBefore/addonAfter 集合;通过 InputGroupAddon(align=inline-start|inline-end|block-start|block-end) + InputGroupInput / InputGroupTextarea 复合插槽组合图标 / 按钮 / 文本;配套 helper 原子 InputGroupClear / InputGroupPasswordToggle / InputGroupShowCount 覆盖清除 / 密码切换 / 字符计数高频场景",
       "files": [
         {
-          "source": "src/components/input-group/input-group.tsx",
+          "source": "src/components/input-group/index.tsx",
           "targetAlias": "components",
           "targetName": "input-group.tsx"
         }
       ],
-      "meta": "src/components/input-group/input-group.meta.md",
+      "meta": "src/components/input-group/meta.md",
       "registryDependencies": ["cn"],
       "updateStrategy": "frozen",
       "category": "data-entry"
@@ -273,15 +327,15 @@
       "description": "复选框 — Radix Checkbox(原生 indeterminate)+ antd Checkbox.Group(options 数组驱动)",
       "files": [
         {
-          "source": "src/components/checkbox/checkbox.tsx",
+          "source": "src/components/checkbox/index.tsx",
           "targetAlias": "components",
           "targetName": "checkbox.tsx"
         }
       ],
-      "meta": "src/components/checkbox/checkbox.meta.md",
+      "meta": "src/components/checkbox/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
-        "@radix-ui/react-checkbox": "^1.1.0",
+        "radix-ui": "^1.4.3",
         "lucide-react": "^0.460.0"
       },
       "updateStrategy": "frozen",
@@ -291,18 +345,18 @@
       "id": "radio-group",
       "name": "RadioGroup",
       "type": "component",
-      "description": "单选组 — Radix RadioGroup + antd Radio.Button 形态(variant=button)",
+      "description": "单选组 — Radix RadioGroup + shadcn v4 dot 形态（按钮形态请使用 ToggleGroup type=\"single\"）",
       "files": [
         {
-          "source": "src/components/radio-group/radio-group.tsx",
+          "source": "src/components/radio-group/index.tsx",
           "targetAlias": "components",
           "targetName": "radio-group.tsx"
         }
       ],
-      "meta": "src/components/radio-group/radio-group.meta.md",
+      "meta": "src/components/radio-group/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
-        "@radix-ui/react-radio-group": "^1.2.0",
+        "radix-ui": "^1.4.3",
         "lucide-react": "^0.460.0"
       },
       "updateStrategy": "frozen",
@@ -312,16 +366,16 @@
       "id": "alert",
       "name": "Alert",
       "type": "component",
-      "description": "静态提示条 — shadcn 视觉 + antd type/showIcon/closable/banner 并集,六档语义色(primary/info/success/warning/destructive/neutral),无边框 + 面性状态图标",
+      "description": "静态反馈条 — shadcn v4 composable + 五档语义色（info 默认 / success / warning / destructive / help）+ closable + AlertIcon 自动/自定义图标，不含弹出（由 Sonner 接管）",
       "files": [
         {
-          "source": "src/components/alert/alert.tsx",
+          "source": "src/components/alert/index.tsx",
           "targetAlias": "components",
           "targetName": "alert.tsx"
         }
       ],
-      "meta": "src/components/alert/alert.meta.md",
-      "registryDependencies": ["cn"],
+      "meta": "src/components/alert/meta.md",
+      "registryDependencies": ["cn", "icon"],
       "dependencies": {
         "class-variance-authority": "^0.7.0",
         "lucide-react": "^0.460.0"
@@ -333,18 +387,18 @@
       "id": "tooltip",
       "name": "Tooltip",
       "type": "component",
-      "description": "文字提示气泡 — Radix Tooltip + antd arrow/placement(side) 并集 + cloud-design Balloon 双变体(default 深底 / light 白底) + 一行 wrapper API",
+      "description": "文字提示气泡 — Radix Tooltip + cva 双变体(default 亮底 / inverse 反色) + 可选 TooltipArrow + container 透传",
       "files": [
         {
-          "source": "src/components/tooltip/tooltip.tsx",
+          "source": "src/components/tooltip/index.tsx",
           "targetAlias": "components",
           "targetName": "tooltip.tsx"
         }
       ],
-      "meta": "src/components/tooltip/tooltip.meta.md",
+      "meta": "src/components/tooltip/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
-        "@radix-ui/react-tooltip": "^1.1.0",
+        "radix-ui": "^1.4.3",
         "class-variance-authority": "^0.7.0"
       },
       "updateStrategy": "frozen",
@@ -354,59 +408,88 @@
       "id": "popover",
       "name": "Popover",
       "type": "component",
-      "description": "可交互浮层 — Radix Popover + antd arrow 并集,使用 showArrow 控制尖角(与 Tooltip / HoverCard 命名统一)",
+      "description": "可交互浮层 — Radix Popover + Header/Title/Description 语义子组件 + 可选 PopoverClose / PopoverArrow + container 透传",
       "files": [
         {
-          "source": "src/components/popover/popover.tsx",
+          "source": "src/components/popover/index.tsx",
           "targetAlias": "components",
           "targetName": "popover.tsx"
         }
       ],
-      "meta": "src/components/popover/popover.meta.md",
+      "meta": "src/components/popover/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
-        "@radix-ui/react-popover": "^1.1.0"
+        "radix-ui": "^1.4.3",
+        "lucide-react": "^0.460.0"
       },
       "updateStrategy": "frozen",
-      "category": "feedback"
+      "category": "data-display"
     },
     {
       "id": "command",
       "name": "Command",
       "type": "component",
-      "description": "命令面板 / 下拉底座 — cmdk(Linear / Raycast 风格)提供过滤 / 键盘导航 / a11y;同时为 Combobox / Select / AutoComplete 提供同源下拉内核",
+      "description": "命令面板 / 下拉底座 — cmdk(Linear / Raycast 风格)提供过滤 / 键盘导航 / a11y;同时为 Select / AutoComplete 提供同源下拉内核",
       "files": [
         {
-          "source": "src/components/command/command.tsx",
+          "source": "src/components/command/index.tsx",
           "targetAlias": "components",
           "targetName": "command.tsx"
         }
       ],
-      "meta": "src/components/command/command.meta.md",
+      "meta": "src/components/command/meta.md",
       "registryDependencies": ["cn", "dialog"],
       "dependencies": {
         "cmdk": "^1.0.0",
         "lucide-react": "^0.460.0"
       },
       "updateStrategy": "frozen",
-      "category": "feedback"
+      "category": "data-entry"
+    },
+    {
+      "id": "combobox",
+      "name": "Combobox",
+      "type": "component",
+      "description": "组合选择器 — Popover + Command + Tag 的 shadcn 风格 composable；支持单选与多选，多选触发区以可关闭 Tag 展示选中项，超出 maxTagCount 折叠为 +N",
+      "files": [
+        {
+          "source": "src/components/combobox/index.tsx",
+          "targetAlias": "components",
+          "targetName": "combobox.tsx"
+        }
+      ],
+      "meta": "src/components/combobox/meta.md",
+      "registryDependencies": [
+        "cn",
+        "command",
+        "popover",
+        "tag",
+        "input-group"
+      ],
+      "dependencies": {
+        "radix-ui": "^1.4.3",
+        "cmdk": "^1.0.0",
+        "lucide-react": "^0.460.0"
+      },
+      "updateStrategy": "frozen",
+      "category": "data-entry"
     },
     {
       "id": "hover-card",
       "name": "HoverCard",
       "type": "component",
-      "description": "悬浮富内容卡 — Radix HoverCard,shadcn-only(@username 卡片 / 链接预览 / 资源卡),使用 showArrow 与 Tooltip/Popover 对齐",
+      "description": "悬浮富内容卡 — Radix HoverCard(@username 卡片 / 链接预览 / 资源卡) + 自定义 openDelay/closeDelay + 可选 HoverCardArrow + container 透传",
       "files": [
         {
-          "source": "src/components/hover-card/hover-card.tsx",
+          "source": "src/components/hover-card/index.tsx",
           "targetAlias": "components",
           "targetName": "hover-card.tsx"
         }
       ],
-      "meta": "src/components/hover-card/hover-card.meta.md",
+      "meta": "src/components/hover-card/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
-        "@radix-ui/react-hover-card": "^1.1.0"
+        "radix-ui": "^1.4.3"
       },
       "updateStrategy": "frozen",
       "category": "data-display"
@@ -418,20 +501,15 @@
       "description": "模态对话框 — Radix Dialog + antd Modal 并集(组合式 Header/Footer/Title/Description,size sm/md/lg/xl 绑定 layout-dialog tokens,圆角 radius-dialog 16px,无 border)",
       "files": [
         {
-          "source": "src/components/dialog/dialog.tsx",
+          "source": "src/components/dialog/index.tsx",
           "targetAlias": "components",
           "targetName": "dialog.tsx"
-        },
-        {
-          "source": "src/components/dialog/imperative.tsx",
-          "targetAlias": "components",
-          "targetName": "dialog-imperative.tsx"
         }
       ],
-      "meta": "src/components/dialog/dialog.meta.md",
+      "meta": "src/components/dialog/meta.md",
       "registryDependencies": ["cn", "button"],
       "dependencies": {
-        "@radix-ui/react-dialog": "^1.1.0",
+        "radix-ui": "^1.4.3",
         "class-variance-authority": "^0.7.0",
         "lucide-react": "^0.460.0",
         "react-dom": ">=18"
@@ -446,15 +524,15 @@
       "description": "阻断式确认对话框 — Radix AlertDialog + antd Modal.confirm 并集(Action / Cancel,size sm/md/lg/xl,圆角与无 border 同 Dialog)",
       "files": [
         {
-          "source": "src/components/alert-dialog/alert-dialog.tsx",
+          "source": "src/components/alert-dialog/index.tsx",
           "targetAlias": "components",
           "targetName": "alert-dialog.tsx"
         }
       ],
-      "meta": "src/components/alert-dialog/alert-dialog.meta.md",
+      "meta": "src/components/alert-dialog/meta.md",
       "registryDependencies": ["cn", "button"],
       "dependencies": {
-        "@radix-ui/react-alert-dialog": "^1.1.0",
+        "radix-ui": "^1.4.3",
         "class-variance-authority": "^0.7.0"
       },
       "updateStrategy": "frozen",
@@ -467,53 +545,34 @@
       "description": "侧边面板 — Radix Dialog + side(left/right/top/bottom) + size(sm/md/lg/xl) + --radius-dialog 圆角,对齐 antd Drawer 全能力集",
       "files": [
         {
-          "source": "src/components/sheet/sheet.tsx",
+          "source": "src/components/sheet/index.tsx",
           "targetAlias": "components",
           "targetName": "sheet.tsx"
         }
       ],
-      "meta": "src/components/sheet/sheet.meta.md",
+      "meta": "src/components/sheet/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
-        "@radix-ui/react-dialog": "^1.1.0",
+        "radix-ui": "^1.4.3",
         "class-variance-authority": "^0.7.0",
         "lucide-react": "^0.460.0"
       },
       "updateStrategy": "frozen",
       "category": "feedback"
     },
-    {
-      "id": "drawer",
-      "name": "Drawer",
-      "type": "component",
-      "description": "抽屉（Sheet 别名）— re-export sheet,向后兼容已有 Drawer 导入",
-      "alias": "sheet",
-      "files": [
-        {
-          "source": "src/components/drawer/drawer.tsx",
-          "targetAlias": "components",
-          "targetName": "drawer.tsx"
-        }
-      ],
-      "meta": "src/components/drawer/drawer.meta.md",
-      "registryDependencies": ["sheet", "cn"],
-      "dependencies": {},
-      "updateStrategy": "frozen",
-      "category": "feedback"
-    },
     {
       "id": "sonner",
       "name": "Toaster",
       "type": "component",
-      "description": "Toast 通知 — sonner 包装,等价 antd message + notification 并集(toast() 函数式 API + Toaster 容器,面性 5 状态图标 + 无边框)",
+      "description": "Toast 通知 — sonner 包装，等价 cloud-design Notification + Message 弹窗便捷用法（toast() 函数式 API + 5+1 状态 success/info/warning/error/help/loading + placement/duration/maxToasts/action/cancel/promise/custom/按 id 更新与关闭，主题 token 化）",
       "files": [
         {
-          "source": "src/components/sonner/sonner.tsx",
+          "source": "src/components/sonner/index.tsx",
           "targetAlias": "components",
           "targetName": "sonner.tsx"
         }
       ],
-      "meta": "src/components/sonner/sonner.meta.md",
+      "meta": "src/components/sonner/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
         "sonner": "^1.5.0",
@@ -526,15 +585,15 @@
       "id": "select",
       "name": "Select",
       "type": "component",
-      "description": "下拉选择 — 单组件覆盖 cd Select 全部模式:单选 / 多选(multiple) / 搜索(searchable) / 标签创建(creatable) / 远程异步(onSearch) / 虚拟滚动(virtual) / 弹层容器(container)。基于 Popover + cmdk Command,size 三档对齐 Button/Input(24/32/36)。原 Combobox 已合并入此组件",
+      "description": "下拉选择 — 单组件覆盖 cd Select 全部模式:单选 / 多选(multiple) / 搜索(searchable) / 标签创建(creatable) / 远程异步(onSearch) / 虚拟滚动(virtual) / 弹层容器(container)。基于 Popover + cmdk Command,size 三档对齐 Button/Input(24/32/36)",
       "files": [
         {
-          "source": "src/components/select/select.tsx",
+          "source": "src/components/select/index.tsx",
           "targetAlias": "components",
           "targetName": "select.tsx"
         }
       ],
-      "meta": "src/components/select/select.meta.md",
+      "meta": "src/components/select/meta.md",
       "registryDependencies": ["cn", "command", "popover"],
       "dependencies": {
         "@tanstack/react-virtual": "^3.0.0",
@@ -550,12 +609,12 @@
       "description": "日期选择面板 — react-day-picker,mode=single|multiple|range,与 design tokens 对齐",
       "files": [
         {
-          "source": "src/components/calendar/calendar.tsx",
+          "source": "src/components/calendar/index.tsx",
           "targetAlias": "components",
           "targetName": "calendar.tsx"
         }
       ],
-      "meta": "src/components/calendar/calendar.meta.md",
+      "meta": "src/components/calendar/meta.md",
       "registryDependencies": ["cn", "button"],
       "dependencies": {
         "react-day-picker": "^9.0.0",
@@ -571,12 +630,12 @@
       "description": "日期 / 范围选择器 — Calendar + Popover 复合,可选 showTime 追加 TimePickerPanel(对齐 antd DatePicker / RangePicker / showTime)",
       "files": [
         {
-          "source": "src/components/date-picker/date-picker.tsx",
+          "source": "src/components/date-picker/index.tsx",
           "targetAlias": "components",
           "targetName": "date-picker.tsx"
         }
       ],
-      "meta": "src/components/date-picker/date-picker.meta.md",
+      "meta": "src/components/date-picker/meta.md",
       "registryDependencies": [
         "cn",
         "button",
@@ -599,18 +658,18 @@
       "description": "表单 — react-hook-form + shadcn 7 件套(FormField/FormItem/Label/Control/Description/Message),配 zod 做 schema 校验",
       "files": [
         {
-          "source": "src/components/form/form.tsx",
+          "source": "src/components/form/index.tsx",
           "targetAlias": "components",
           "targetName": "form.tsx"
         }
       ],
-      "meta": "src/components/form/form.meta.md",
+      "meta": "src/components/form/meta.md",
       "registryDependencies": ["cn", "field"],
       "dependencies": {
         "react-hook-form": "^7.50.0",
         "@hookform/resolvers": "^3.0.0",
         "zod": "^3.22.0",
-        "@radix-ui/react-slot": "^1.1.0"
+        "radix-ui": "^1.4.3"
       },
       "updateStrategy": "frozen",
       "category": "data-entry"
@@ -622,19 +681,19 @@
       "description": "标签页 — Radix Tabs + shadcn ∪ antd 并集,吸收 Segmented 胶囊视觉(variant=line|capsule + size=sm|md|lg + extra)",
       "files": [
         {
-          "source": "src/components/tabs/tabs.tsx",
+          "source": "src/components/tabs/index.tsx",
           "targetAlias": "components",
           "targetName": "tabs.tsx"
         }
       ],
-      "meta": "src/components/tabs/tabs.meta.md",
+      "meta": "src/components/tabs/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
-        "@radix-ui/react-tabs": "^1.1.0",
+        "radix-ui": "^1.4.3",
         "class-variance-authority": "^0.7.0"
       },
       "updateStrategy": "frozen",
-      "category": "data-display"
+      "category": "navigation"
     },
     {
       "id": "accordion",
@@ -643,15 +702,15 @@
       "description": "折叠面板 — Radix Accordion + antd Collapse 的 accordion 模式(单/多展开)",
       "files": [
         {
-          "source": "src/components/accordion/accordion.tsx",
+          "source": "src/components/accordion/index.tsx",
           "targetAlias": "components",
           "targetName": "accordion.tsx"
         }
       ],
-      "meta": "src/components/accordion/accordion.meta.md",
+      "meta": "src/components/accordion/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
-        "@radix-ui/react-accordion": "^1.2.0",
+        "radix-ui": "^1.4.3",
         "lucide-react": "^0.460.0"
       },
       "updateStrategy": "frozen",
@@ -664,14 +723,14 @@
       "description": "单区域展开收起 — Radix Collapsible 薄包装(shadcn-only)",
       "files": [
         {
-          "source": "src/components/collapsible/collapsible.tsx",
+          "source": "src/components/collapsible/index.tsx",
           "targetAlias": "components",
           "targetName": "collapsible.tsx"
         }
       ],
-      "meta": "src/components/collapsible/collapsible.meta.md",
+      "meta": "src/components/collapsible/meta.md",
       "dependencies": {
-        "@radix-ui/react-collapsible": "^1.1.0"
+        "radix-ui": "^1.4.3"
       },
       "updateStrategy": "frozen",
       "category": "data-display"
@@ -683,15 +742,15 @@
       "description": "面包屑 — 纯组合 + antd separator/itemRender(asChild 配 React Router/Next.js Link)",
       "files": [
         {
-          "source": "src/components/breadcrumb/breadcrumb.tsx",
+          "source": "src/components/breadcrumb/index.tsx",
           "targetAlias": "components",
           "targetName": "breadcrumb.tsx"
         }
       ],
-      "meta": "src/components/breadcrumb/breadcrumb.meta.md",
+      "meta": "src/components/breadcrumb/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
-        "@radix-ui/react-slot": "^1.1.0",
+        "radix-ui": "^1.4.3",
         "lucide-react": "^0.460.0"
       },
       "updateStrategy": "frozen",
@@ -704,12 +763,12 @@
       "description": "分页 — shadcn primitives + 高阶 SimplePagination(antd 风格 total/pageSize/current/onChange,自动页码窗口 + 折叠)",
       "files": [
         {
-          "source": "src/components/pagination/pagination.tsx",
+          "source": "src/components/pagination/index.tsx",
           "targetAlias": "components",
           "targetName": "pagination.tsx"
         }
       ],
-      "meta": "src/components/pagination/pagination.meta.md",
+      "meta": "src/components/pagination/meta.md",
       "registryDependencies": ["cn", "button"],
       "dependencies": {
         "class-variance-authority": "^0.7.0",
@@ -725,15 +784,15 @@
       "description": "下拉菜单 — Radix DropdownMenu 完整(Item/CheckboxItem/RadioItem/Sub/Label/Separator/Shortcut),对应 antd Dropdown",
       "files": [
         {
-          "source": "src/components/dropdown-menu/dropdown-menu.tsx",
+          "source": "src/components/dropdown-menu/index.tsx",
           "targetAlias": "components",
           "targetName": "dropdown-menu.tsx"
         }
       ],
-      "meta": "src/components/dropdown-menu/dropdown-menu.meta.md",
+      "meta": "src/components/dropdown-menu/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
-        "@radix-ui/react-dropdown-menu": "^2.1.0",
+        "radix-ui": "^1.4.3",
         "lucide-react": "^0.460.0"
       },
       "updateStrategy": "frozen",
@@ -760,12 +819,12 @@
       "description": "侧边导航栏 — shadcn 完整版 25 primitives 复合(Provider + Sidebar + Header/Footer/Content + Group/GroupAction/GroupContent + Menu/MenuItem/MenuButton/MenuSub/MenuAction/MenuBadge/MenuSkeleton + Rail + Inset + Input + Trigger + variant=sidebar|floating|inset),含 mobile Sheet 切换 / cookie 持久化 / Cmd+B 快捷键 / 折叠态自动 Tooltip。对应 antd Layout.Sider + Menu + 移动端 Drawer",
       "files": [
         {
-          "source": "src/components/sidebar/sidebar.tsx",
+          "source": "src/components/sidebar/index.tsx",
           "targetAlias": "components",
           "targetName": "sidebar.tsx"
         }
       ],
-      "meta": "src/components/sidebar/sidebar.meta.md",
+      "meta": "src/components/sidebar/meta.md",
       "registryDependencies": [
         "cn",
         "button",
@@ -777,12 +836,12 @@
         "use-mobile"
       ],
       "dependencies": {
-        "@radix-ui/react-slot": "^1.1.0",
+        "radix-ui": "^1.4.3",
         "class-variance-authority": "^0.7.0",
         "lucide-react": "^0.460.0"
       },
       "updateStrategy": "frozen",
-      "category": "layout"
+      "category": "navigation"
     },
     {
       "id": "page-header",
@@ -791,32 +850,49 @@
       "description": "页头容器 — 承接 teamix-pro ProPageHeader 视觉规范的 shadcn 复合组件(PageHeader + Nav/Content/Heading/Description/Actions/Data/DataItem/Footer/Skeleton 共 10 个子组件)。纯排版骨架,不接受配置对象;面包屑/标签/操作/图标/数据概览全用原子组件自由组合。含 goBack 返回按钮、backgroundImage 装饰图、PageHeaderDataItem 6 档数据色、整体替换式骨架屏。对应 antd PageHeader / teamix-pro ProPageHeader",
       "files": [
         {
-          "source": "src/components/page-header/page-header.tsx",
+          "source": "src/components/page-header/index.tsx",
           "targetAlias": "components",
           "targetName": "page-header.tsx"
         }
       ],
-      "meta": "src/components/page-header/page-header.meta.md",
+      "meta": "src/components/page-header/meta.md",
       "registryDependencies": ["cn", "skeleton"],
       "dependencies": {
         "lucide-react": "^0.460.0"
       },
       "updateStrategy": "frozen",
+      "category": "navigation"
+    },
+    {
+      "id": "page-shell",
+      "name": "PageShell",
+      "type": "component",
+      "description": "页面三明治壳 — header + sidebar + children 三 slot 任意组合,覆盖全屏/仅顶部/仅左导/顶部+左导四种页面形态。background prop 走 shadcn 语义槽枚举(background/muted/card/sidebar/accent),亮暗模式由 token 文件自动管。内部为传入的 ui Sidebar 注入 scoped CSS 覆盖默认 fixed 定位,让 sidebar 跟 header 共存而不被撑到 viewport 顶端。",
+      "files": [
+        {
+          "source": "src/components/page-shell/index.tsx",
+          "targetAlias": "components",
+          "targetName": "page-shell.tsx"
+        }
+      ],
+      "meta": "src/components/page-shell/meta.md",
+      "registryDependencies": ["cn", "sidebar"],
+      "updateStrategy": "frozen",
       "category": "layout"
     },
     {
       "id": "card",
       "name": "Card",
       "type": "component",
-      "description": "卡片容器 — shadcn 组合式 + antd hoverable/loading/Cover/Actions/Meta/extra 并集",
+      "description": "卡片容器 — shadcn v4 组合式 (Header/Title/Description/Action/Content/Footer/Media/Divider) + variant/interactive/asChild/loading",
       "files": [
         {
-          "source": "src/components/card/card.tsx",
+          "source": "src/components/card/index.tsx",
           "targetAlias": "components",
           "targetName": "card.tsx"
         }
       ],
-      "meta": "src/components/card/card.meta.md",
+      "meta": "src/components/card/meta.md",
       "registryDependencies": ["cn", "skeleton"],
       "updateStrategy": "frozen",
       "category": "data-display"
@@ -825,16 +901,20 @@
       "id": "table",
       "name": "Table",
       "type": "component",
-      "description": "基础表格 — 原生 HTML 元素薄包装(视觉骨架,无交互,交互见 DataTable)",
+      "description": "基础表格 — shadcn 极薄 composable，提供 size / bordered / striped / stickyHeader / hoverable / crossline / loading / empty / maxBodyHeight 等视觉与状态能力（交互逻辑见 DataTable）",
       "files": [
         {
-          "source": "src/components/table/table.tsx",
+          "source": "src/components/table/index.tsx",
           "targetAlias": "components",
           "targetName": "table.tsx"
         }
       ],
-      "meta": "src/components/table/table.meta.md",
+      "meta": "src/components/table/meta.md",
       "registryDependencies": ["cn"],
+      "dependencies": {
+        "class-variance-authority": "^0.7.0",
+        "lucide-react": "^0.460.0"
+      },
       "updateStrategy": "frozen",
       "category": "data-display"
     },
@@ -842,18 +922,31 @@
       "id": "data-table",
       "name": "DataTable",
       "type": "component",
-      "description": "高阶数据表 — TanStack Table + Table primitives + SimplePagination(等价 antd Table 的 sorter/filter/pagination/rowSelection)",
+      "description": "高阶数据表 — 基于 @tanstack/react-table v8 + Table primitives + Pagination，提供排序 / 列过滤 / 分页 / 行选择（单/多） / 行展开 / 锁列 / 列宽拖拽 / 树形 / 虚拟滚动 / 多级表头 / 合并单元格 / 可编辑单元格 / 行拖拽排序 等交互；API 名采用业界主流（columns / data / accessorKey / header / cell）同时保留 cd / antd 老字段兼容（dataSource / dataIndex / title / sortable / render / fixed / width）",
       "files": [
         {
-          "source": "src/components/data-table/data-table.tsx",
+          "source": "src/components/data-table/index.tsx",
           "targetAlias": "components",
           "targetName": "data-table.tsx"
         }
       ],
-      "meta": "src/components/data-table/data-table.meta.md",
-      "registryDependencies": ["cn", "table", "pagination"],
+      "meta": "src/components/data-table/meta.md",
+      "registryDependencies": [
+        "cn",
+        "table",
+        "pagination",
+        "checkbox",
+        "radio-group",
+        "button",
+        "popover"
+      ],
       "dependencies": {
-        "@tanstack/react-table": "^8.0.0"
+        "@tanstack/react-table": "^8.0.0",
+        "@tanstack/react-virtual": "^3.0.0",
+        "@dnd-kit/core": "^6.0.0",
+        "@dnd-kit/sortable": "^8.0.0",
+        "@dnd-kit/utilities": "^3.0.0",
+        "lucide-react": "^0.460.0"
       },
       "updateStrategy": "frozen",
       "category": "data-display"
@@ -862,18 +955,20 @@
       "id": "carousel",
       "name": "Carousel",
       "type": "component",
-      "description": "走马灯 — embla-carousel-react,支持单页/多页/循环/垂直/触屏拖动,对应 antd Carousel",
+      "description": "轮播 — embla-carousel-react，支持单页/多页/无穷循环/垂直/触屏拖动；新增 autoplay（含悬浮暂停）/ fade / 受控 activeIndex / 内置 CarouselDots 与 inner-outer 箭头位置",
       "files": [
         {
-          "source": "src/components/carousel/carousel.tsx",
+          "source": "src/components/carousel/index.tsx",
           "targetAlias": "components",
           "targetName": "carousel.tsx"
         }
       ],
-      "meta": "src/components/carousel/carousel.meta.md",
+      "meta": "src/components/carousel/meta.md",
       "registryDependencies": ["cn", "button"],
       "dependencies": {
         "embla-carousel-react": "^8.0.0",
+        "embla-carousel-autoplay": "^8.0.0",
+        "embla-carousel-fade": "^8.0.0",
         "lucide-react": "^0.460.0"
       },
       "updateStrategy": "frozen",
@@ -886,15 +981,15 @@
       "description": "可拖拽分栏 — react-resizable-panels(VS Code / Figma 风格),横/纵向 + 嵌套 + min/max 限制。等价 antd `Splitter`(v5.21+)",
       "files": [
         {
-          "source": "src/components/resizable/resizable.tsx",
+          "source": "src/components/resizable/index.tsx",
           "targetAlias": "components",
           "targetName": "resizable.tsx"
         }
       ],
-      "meta": "src/components/resizable/resizable.meta.md",
+      "meta": "src/components/resizable/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
-        "react-resizable-panels": "^2.0.0",
+        "react-resizable-panels": "^4.0.0",
         "lucide-react": "^0.460.0"
       },
       "updateStrategy": "frozen",
@@ -907,12 +1002,12 @@
       "description": "排版组件 — Prose 富文本容器 + Title/Paragraph/Text/Link + antd type/strong/delete/disabled/code/ellipsis/copyable",
       "files": [
         {
-          "source": "src/components/typography/typography.tsx",
+          "source": "src/components/typography/index.tsx",
           "targetAlias": "components",
           "targetName": "typography.tsx"
         }
       ],
-      "meta": "src/components/typography/typography.meta.md",
+      "meta": "src/components/typography/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
         "lucide-react": "^0.460.0"
@@ -927,12 +1022,12 @@
       "description": "数字展示 — antd 独有补足。仪表板 KPI(标题 / 值 / 前后缀 / 趋势 / 千分位 / 精度)",
       "files": [
         {
-          "source": "src/components/statistic/statistic.tsx",
+          "source": "src/components/statistic/index.tsx",
           "targetAlias": "components",
           "targetName": "statistic.tsx"
         }
       ],
-      "meta": "src/components/statistic/statistic.meta.md",
+      "meta": "src/components/statistic/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
         "lucide-react": "^0.460.0"
@@ -947,12 +1042,12 @@
       "description": "步骤条 — antd 独有补足。多步流程引导(注册 / 下单 / 部署),状态自动推导(wait/process/finish/error)",
       "files": [
         {
-          "source": "src/components/steps/steps.tsx",
+          "source": "src/components/steps/index.tsx",
           "targetAlias": "components",
           "targetName": "steps.tsx"
         }
       ],
-      "meta": "src/components/steps/steps.meta.md",
+      "meta": "src/components/steps/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
         "lucide-react": "^0.460.0"
@@ -960,41 +1055,22 @@
       "updateStrategy": "frozen",
       "category": "navigation"
     },
-    {
-      "id": "result",
-      "name": "Result",
-      "type": "component",
-      "description": "结果页 — antd 独有补足。整页级反馈(成功 / 失败 / 404 / 403 / 500)",
-      "files": [
-        {
-          "source": "src/components/result/result.tsx",
-          "targetAlias": "components",
-          "targetName": "result.tsx"
-        }
-      ],
-      "meta": "src/components/result/result.meta.md",
-      "registryDependencies": ["cn"],
-      "dependencies": {
-        "lucide-react": "^0.460.0"
-      },
-      "updateStrategy": "frozen",
-      "category": "feedback"
-    },
     {
       "id": "empty",
       "name": "Empty",
       "type": "component",
-      "description": "空状态 — antd 独有补足。列表 / 表格 / 搜索结果为空时的占位 + 引导操作",
+      "description": "空状态 / 结果页 — 复合组件 + status 预设(403/404/500/noData/noSearch/noNetwork/browserError/createSuccess/createError/import/success/error/info/warning),覆盖容器内空态与页面级异常,支持 vertical/horizontal 布局",
       "files": [
         {
-          "source": "src/components/empty/empty.tsx",
+          "source": "src/components/empty/index.tsx",
           "targetAlias": "components",
           "targetName": "empty.tsx"
         }
       ],
-      "meta": "src/components/empty/empty.meta.md",
+      "meta": "src/components/empty/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
+        "class-variance-authority": "^0.7.0",
         "lucide-react": "^0.460.0"
       },
       "updateStrategy": "frozen",
@@ -1004,16 +1080,21 @@
       "id": "descriptions",
       "name": "Descriptions",
       "type": "component",
-      "description": "描述列表 — antd 独有补足。键值对详情(items 数组驱动,横/纵布局,bordered,span 跨列)",
+      "description": "描述列表 — shadcn v4 纯 composable slot。Descriptions 根、DescriptionsHeader/Title/Extra、DescriptionsBody、DescriptionsItem/Label/Content 全量 data-slot 子组件，不提供 items / dataSource / dataIndex / render / hidden / tooltip / extra 等 data-driven 快捷 prop——label 与 content 都是 ReactNode 槽位，label 需要 tooltip 图标请在 `<DescriptionsLabel>` 子树内拼 `<Tooltip>`。能力保留：响应式 column(number | { xs/sm/md/lg/xl/2xl })、layout(horizontal/vertical)、bordered 矩阵(gap-px + bg-border 避免与 header 叠边)、size(sm/default)、colon(默认 false)、labelWidth、labelStyle/contentStyle、item.span(兼容 colSpan) + align、collapsible(受控/非受控) + asChild。不内置请求 / 行内编辑能力。",
       "files": [
         {
-          "source": "src/components/descriptions/descriptions.tsx",
+          "source": "src/components/descriptions/index.tsx",
           "targetAlias": "components",
           "targetName": "descriptions.tsx"
         }
       ],
-      "meta": "src/components/descriptions/descriptions.meta.md",
-      "registryDependencies": ["cn"],
+      "meta": "src/components/descriptions/meta.md",
+      "registryDependencies": ["cn", "tooltip"],
+      "dependencies": {
+        "radix-ui": "^1.4.3",
+        "class-variance-authority": "^0.7.0",
+        "lucide-react": "^0.460.0"
+      },
       "updateStrategy": "frozen",
       "category": "data-display"
     },
@@ -1021,17 +1102,18 @@
       "id": "tag",
       "name": "Tag",
       "type": "component",
-      "description": "标签 — antd ∪ cloud-design 并集。形态(solid/outline/ghost) × 语义色(ADR 0021,5 档) × 多彩分类(9 预设 + 任意 CSS 值) × size × icon × closable,以及 CheckableTag/Group(与 Badge 互补)",
+      "description": "标签 — shadcn v4 工程模式 + antd v6 / cloud-design 能力并集。Tag(形态 solid/outline/ghost/status × 语义色 ADR 0021 5 档 × 多彩 palette 9 预设 + 任意 CSS × size × icon × asChild × disabled × 关闭路径:closable boolean|object + closeIcon + closeArea + visible/defaultVisible 受控可见性 + onClose 可 preventDefault + afterClose) + TagGroup(wrap/gap)+ CheckableTag + CheckableTagGroup(multiple 多选/单选)",
       "files": [
         {
-          "source": "src/components/tag/tag.tsx",
+          "source": "src/components/tag/index.tsx",
           "targetAlias": "components",
           "targetName": "tag.tsx"
         }
       ],
-      "meta": "src/components/tag/tag.meta.md",
-      "registryDependencies": ["cn"],
+      "meta": "src/components/tag/meta.md",
+      "registryDependencies": ["cn", "icon"],
       "dependencies": {
+        "radix-ui": "^1.4.3",
         "class-variance-authority": "^0.7.0",
         "lucide-react": "^0.460.0"
       },
@@ -1042,15 +1124,15 @@
       "id": "upload",
       "name": "Upload",
       "type": "component",
-      "description": "文件上传 — antd 独有补足。点击 + 拖拽双模式(Dragger),内置 accept / multiple / maxCount / maxSize 校验、文件列表与进度条;真实上传由消费方在 onChange 中发起",
+      "description": "文件上传 — shadcn v4 工程模式。Upload(按钮触发) + UploadDragger(拖拽触发) 双导出,共享上传状态机;listType 支持 text / image,内置 accept / multiple / maxCount / maxSize / beforeUpload / onPreview / itemRender 等业界主流 props,真实上传通过回调式 customRequest({ file, onProgress, onSuccess, onError }) => { abort } 接入,支持进度、abort 与失败重试",
       "files": [
         {
-          "source": "src/components/upload/upload.tsx",
+          "source": "src/components/upload/index.tsx",
           "targetAlias": "components",
           "targetName": "upload.tsx"
         }
       ],
-      "meta": "src/components/upload/upload.meta.md",
+      "meta": "src/components/upload/meta.md",
       "registryDependencies": ["cn", "button", "progress"],
       "dependencies": {
         "lucide-react": "^0.460.0"
@@ -1065,12 +1147,12 @@
       "description": "树形控件 — antd 独有补足。递归层级展示(目录、组织、分类),可展开 / 可选 / 可勾选(父子级联 + 半选),受控与非受控并存",
       "files": [
         {
-          "source": "src/components/tree/tree.tsx",
+          "source": "src/components/tree/index.tsx",
           "targetAlias": "components",
           "targetName": "tree.tsx"
         }
       ],
-      "meta": "src/components/tree/tree.meta.md",
+      "meta": "src/components/tree/meta.md",
       "registryDependencies": ["cn", "checkbox"],
       "dependencies": {
         "lucide-react": "^0.460.0"
@@ -1082,17 +1164,18 @@
       "id": "transfer",
       "name": "Transfer",
       "type": "component",
-      "description": "穿梭框 — antd 独有补足。双侧勾选 + 移动的批量分配交互(权限分配 / 字段映射 / 收件人),受控 targetKeys 单一真值,内置全选 / 半选 / 可选搜索 / 禁用项跳过",
+      "description": "穿梭框 — 双栏勾选 + 移动的批量分配交互(权限分配 / 字段映射 / 收件人)。对齐 antd v5 schema(key / title / description),内置 size 三档 / normal & simple 模式 / oneWay 单向 / 双侧搜索 / filterOption / 自定义 render / locale 文案 / 自定义按钮 operations,以及面板列表 children render-prop(可承接树穿梭 / 表格穿梭)",
       "files": [
         {
-          "source": "src/components/transfer/transfer.tsx",
+          "source": "src/components/transfer/index.tsx",
           "targetAlias": "components",
           "targetName": "transfer.tsx"
         }
       ],
-      "meta": "src/components/transfer/transfer.meta.md",
+      "meta": "src/components/transfer/meta.md",
       "registryDependencies": ["cn", "button", "checkbox", "input"],
       "dependencies": {
+        "class-variance-authority": "^0.7.0",
         "lucide-react": "^0.460.0"
       },
       "updateStrategy": "frozen",
@@ -1102,59 +1185,38 @@
       "id": "spinner",
       "name": "Spinner",
       "type": "component",
-      "description": "加载指示器 — shadcn 2025-10 新增,等价 antd `Spin` 并集。核心 `Spinner` 是行内 / 局部旋转指示(4 档尺寸 + 4 档语义配色,自带 role=status 与 sr-only 读屏文本);配套 `SpinnerOverlay` 实现包裹子元遮罩形态(可选 tip / blur)。",
+      "description": "加载指示器 — shadcn v4 composable 套件。原子 Spinner(4 档尺寸 + 4 档语义配色 + role=status + sr-only) + SpinnerTip(文案) + SpinnerOverlay(包裹遮罩 + tip + tipAlign + 100ms 防闪 + blur) + SpinnerFullscreen(全屏 Portal + Esc 关闭)",
       "files": [
         {
-          "source": "src/components/spinner/spinner.tsx",
+          "source": "src/components/spinner/index.tsx",
           "targetAlias": "components",
           "targetName": "spinner.tsx"
         }
       ],
-      "meta": "src/components/spinner/spinner.meta.md",
+      "meta": "src/components/spinner/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
         "class-variance-authority": "^0.7.0",
-        "lucide-react": "^0.460.0"
+        "lucide-react": "^0.460.0",
+        "react-dom": ">=18"
       },
       "updateStrategy": "frozen",
       "category": "feedback"
     },
-    {
-      "id": "icon",
-      "name": "Icon",
-      "type": "component",
-      "description": "图标容器 — 基于 lucide-react 的统一封装。5 档尺寸 + 6 档语义 color + spin/rotate + Slot + 背景容器(circle/square × 5 档 bgColor) + 装饰/非装饰无障碍。承接 cloud-design Icon 的 iconBackgroundType/Color 能力,iconfont 工厂 v0.2 接入但 API 已稳定",
-      "files": [
-        {
-          "source": "src/components/icon/icon.tsx",
-          "targetAlias": "components",
-          "targetName": "icon.tsx"
-        }
-      ],
-      "meta": "src/components/icon/icon.meta.md",
-      "registryDependencies": ["cn"],
-      "dependencies": {
-        "@radix-ui/react-slot": "^1.1.0",
-        "class-variance-authority": "^0.7.0",
-        "lucide-react": "^0.460.0"
-      },
-      "updateStrategy": "frozen",
-      "category": "general"
-    },
     {
       "id": "item",
       "name": "Item",
       "type": "component",
-      "description": "通用列表项 / 卡片项 — shadcn 2025-10 新增,取代旧 List.Item(antd v6 已废弃 List)。5 个语义槽:ItemMedia / ItemContent / ItemTitle / ItemDescription / ItemActions + ItemGroup 纵向排列",
+      "description": "通用列表项 / 卡片项 — composable 架构,支持 vertical/horizontal 布局、bordered/divider 容器、separated actions 自动分隔。13 个语义槽：ItemGroup + ItemGroupHeader/Footer + Item + ItemMedia(icon/image/cover) + ItemContent + ItemTitle + ItemDescription + ItemExtra + ItemActions + ItemHeader/Footer + ItemSeparator",
       "files": [
         {
-          "source": "src/components/item/item.tsx",
+          "source": "src/components/item/index.tsx",
           "targetAlias": "components",
           "targetName": "item.tsx"
         }
       ],
-      "meta": "src/components/item/item.meta.md",
-      "registryDependencies": ["cn"],
+      "meta": "src/components/item/meta.md",
+      "registryDependencies": ["cn", "separator"],
       "dependencies": {
         "class-variance-authority": "^0.7.0"
       },
@@ -1168,66 +1230,32 @@
       "description": "通用表单字段抽象 — shadcn 2025-10 新增。Field / FieldLabel / FieldDescription / FieldError / FieldGroup / FieldSet / FieldLegend 7 个语义槽,跟任何状态管理(Server Actions / RHF / TanStack Form)都能搭,与 form 共存",
       "files": [
         {
-          "source": "src/components/field/field.tsx",
+          "source": "src/components/field/index.tsx",
           "targetAlias": "components",
           "targetName": "field.tsx"
         }
       ],
-      "meta": "src/components/field/field.meta.md",
-      "registryDependencies": ["cn", "label", "use-breakpoint"],
+      "meta": "src/components/field/meta.md",
+      "registryDependencies": ["cn", "label"],
       "dependencies": {
         "class-variance-authority": "^0.7.0"
       },
       "updateStrategy": "frozen",
       "category": "data-entry"
     },
-    {
-      "id": "flex",
-      "name": "Flex",
-      "type": "component",
-      "description": "Flex 弹性布局 — antd 独有补足。等价 antd `Flex`(v5.10+) ∪ antd `Space`——一个原子覆盖完整布局容器与 inline 小集合两类场景。支持 direction / gap / align / justify / wrap / inline / as / split",
-      "files": [
-        {
-          "source": "src/components/flex/flex.tsx",
-          "targetAlias": "components",
-          "targetName": "flex.tsx"
-        }
-      ],
-      "meta": "src/components/flex/flex.meta.md",
-      "registryDependencies": ["cn"],
-      "updateStrategy": "frozen",
-      "category": "layout"
-    },
-    {
-      "id": "grid",
-      "name": "Grid",
-      "type": "component",
-      "description": "24 栅格(Row + Col) — antd 独有补足。等价 antd Row + Col,基于 CSS Grid 的 24 列容器,支持 span / offset / order / flex / gutter / justify / align",
-      "files": [
-        {
-          "source": "src/components/grid/grid.tsx",
-          "targetAlias": "components",
-          "targetName": "grid.tsx"
-        }
-      ],
-      "meta": "src/components/grid/grid.meta.md",
-      "registryDependencies": ["cn"],
-      "updateStrategy": "frozen",
-      "category": "layout"
-    },
     {
       "id": "rate",
       "name": "Rate",
       "type": "component",
-      "description": "星级评分 — antd 独有补足。等价 antd `Rate`,支持半星 / 再次点击清零 / 自定义图标 / 只读展示",
+      "description": "星级评分 — shadcn 风格 API,支持半星、键盘无障碍、自定义图标、只读 / 禁用区分",
       "files": [
         {
-          "source": "src/components/rate/rate.tsx",
+          "source": "src/components/rate/index.tsx",
           "targetAlias": "components",
           "targetName": "rate.tsx"
         }
       ],
-      "meta": "src/components/rate/rate.meta.md",
+      "meta": "src/components/rate/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
         "lucide-react": "^0.460.0"
@@ -1239,15 +1267,15 @@
       "id": "timeline",
       "name": "Timeline",
       "type": "component",
-      "description": "时间轴 — antd 独有补足。等价 antd `Timeline`,垂直时间流(历史 / 物流 / 进度),3 种布局 + 5 种圆点色 + 自定义 dot + pending 进行中占位",
+      "description": "时间轴 — 垂直时间流 (历史 / 物流 / 进度),composable 子组件 + 4 种状态语义色 (done/process/error/success) + 自定义 dot (asChild) + 左/右/交替布局",
       "files": [
         {
-          "source": "src/components/timeline/timeline.tsx",
+          "source": "src/components/timeline/index.tsx",
           "targetAlias": "components",
           "targetName": "timeline.tsx"
         }
       ],
-      "meta": "src/components/timeline/timeline.meta.md",
+      "meta": "src/components/timeline/meta.md",
       "registryDependencies": ["cn"],
       "updateStrategy": "frozen",
       "category": "data-display"
@@ -1256,15 +1284,15 @@
       "id": "popconfirm",
       "name": "Popconfirm",
       "type": "component",
-      "description": "轻量级确认弹层 — antd 独有补足。等价 antd `Popconfirm`,小风险操作二次确认,onConfirm 支持 Promise 自动 loading,与 AlertDialog 互补(更轻、不阻塞)",
+      "description": "气泡确认 — shadcn v4 composable 套件（Popconfirm / PopconfirmRoot / Trigger / Content / Header / Icon / Title / Description / Footer / Cancel / Action / Arrow），另外保留单体便捷 props（title / description / intent / okText / cancelText / okButtonProps / cancelButtonProps / onConfirm / loading / showArrow）。onConfirm 返回 Promise 自动 loading + 完成后关闭；antd 独有补足，与 AlertDialog 互补（更轻、不阻塞）。",
       "files": [
         {
-          "source": "src/components/popconfirm/popconfirm.tsx",
+          "source": "src/components/popconfirm/index.tsx",
           "targetAlias": "components",
           "targetName": "popconfirm.tsx"
         }
       ],
-      "meta": "src/components/popconfirm/popconfirm.meta.md",
+      "meta": "src/components/popconfirm/meta.md",
       "registryDependencies": ["cn", "button", "popover"],
       "dependencies": {
         "lucide-react": "^0.460.0"
@@ -1276,15 +1304,15 @@
       "id": "input-number",
       "name": "InputNumber",
       "type": "component",
-      "description": "数字输入 — antd 独有补足。等价 antd `InputNumber`,步进按钮 + min/max 自动夹紧 + precision + 千分位展示 + 键盘 ↑↓ 步进 + null 空状态",
+      "description": "数字输入框 — 步进按钮 + min/max 夹紧 + precision 精度 + formatter/parser 双向格式化 + readOnly + changeOnBlur/changeOnWheel/keyboard 输入流控制 + onPressEnter + null 空状态。default/inline 两种 variant。",
       "files": [
         {
-          "source": "src/components/input-number/input-number.tsx",
+          "source": "src/components/input-number/index.tsx",
           "targetAlias": "components",
           "targetName": "input-number.tsx"
         }
       ],
-      "meta": "src/components/input-number/input-number.meta.md",
+      "meta": "src/components/input-number/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
         "lucide-react": "^0.460.0"
@@ -1293,56 +1321,38 @@
       "category": "data-entry"
     },
     {
-      "id": "time-picker",
-      "name": "TimePicker",
+      "id": "input-ip",
+      "name": "InputIP",
       "type": "component",
-      "description": "时间选择 — Popover + 滚动列(TimeColumn)面板,含 TimePicker / TimeRangePicker / TimePickerPanel(对齐 antd TimePicker / TimePicker.RangePicker)",
+      "description": "IP 地址输入 — 分段式 IPv4 地址输入框,自动跳段 + 范围校验(0-255) + 粘贴解析 + 可选 CIDR 前缀选择",
       "files": [
         {
-          "source": "src/components/time-picker/time-picker.tsx",
+          "source": "src/components/input-ip/index.tsx",
           "targetAlias": "components",
-          "targetName": "time-picker.tsx"
+          "targetName": "input-ip.tsx"
         }
       ],
-      "meta": "src/components/time-picker/time-picker.meta.md",
-      "registryDependencies": ["cn", "popover", "button"],
+      "registryDependencies": ["cn"],
       "dependencies": {
-        "lucide-react": "^0.460.0"
+        "class-variance-authority": "^0.7.0"
       },
       "updateStrategy": "frozen",
       "category": "data-entry"
     },
     {
-      "id": "auto-complete",
-      "name": "AutoComplete",
-      "type": "component",
-      "description": "输入即建议 — antd 独有补足。等价 antd `AutoComplete`,键入触发候选下拉,最终 value 可以是任意字符串(与 Combobox 必选互补),配 onSearch 实现异步建议",
-      "files": [
-        {
-          "source": "src/components/auto-complete/auto-complete.tsx",
-          "targetAlias": "components",
-          "targetName": "auto-complete.tsx"
-        }
-      ],
-      "meta": "src/components/auto-complete/auto-complete.meta.md",
-      "registryDependencies": ["cn", "input", "popover", "command"],
-      "updateStrategy": "frozen",
-      "category": "data-entry"
-    },
-    {
-      "id": "cascader",
-      "name": "Cascader",
+      "id": "time-picker",
+      "name": "TimePicker",
       "type": "component",
-      "description": "级联选择 — antd 独有补足。等价 antd `Cascader`,多级联动(地区 / 分类 / 文件夹路径),多列面板,叶子触发 onChange(可改 changeOnSelect 为每级触发)",
+      "description": "时间选择 — Popover + 滚动列(TimeColumn)面板,含 TimePicker / TimeRangePicker / TimePickerPanel(对齐 antd TimePicker / TimePicker.RangePicker)",
       "files": [
         {
-          "source": "src/components/cascader/cascader.tsx",
+          "source": "src/components/time-picker/index.tsx",
           "targetAlias": "components",
-          "targetName": "cascader.tsx"
+          "targetName": "time-picker.tsx"
         }
       ],
-      "meta": "src/components/cascader/cascader.meta.md",
-      "registryDependencies": ["cn", "button", "popover"],
+      "meta": "src/components/time-picker/meta.md",
+      "registryDependencies": ["cn", "popover", "button"],
       "dependencies": {
         "lucide-react": "^0.460.0"
       },
@@ -1353,43 +1363,23 @@
       "id": "tree-select",
       "name": "TreeSelect",
       "type": "component",
-      "description": "树形下拉 — antd 独有补足。等价 antd `TreeSelect`,Tree 嵌入 Popover 提供单选 / 多选(父子级联勾选)两种模式,组织架构 / 分类树形选择常用",
+      "description": "树形下拉选择 — 树形结构数据的下拉选择,支持单选、多选(父子联动 / 独立)、搜索与受控开合,基于 Popover + 内嵌 Tree 渲染",
       "files": [
         {
-          "source": "src/components/tree-select/tree-select.tsx",
+          "source": "src/components/tree-select/index.tsx",
           "targetAlias": "components",
           "targetName": "tree-select.tsx"
         }
       ],
-      "meta": "src/components/tree-select/tree-select.meta.md",
-      "registryDependencies": ["cn", "button", "popover", "tree"],
+      "meta": "src/components/tree-select/meta.md",
+      "registryDependencies": ["cn", "popover", "checkbox"],
       "dependencies": {
-        "lucide-react": "^0.460.0"
+        "lucide-react": "^0.460.0",
+        "class-variance-authority": "^0.7.1"
       },
       "updateStrategy": "frozen",
       "category": "data-entry"
     },
-    {
-      "id": "notification",
-      "name": "notification",
-      "type": "component",
-      "description": "卡片式通知 — antd 独有补足。等价 antd `Notification`,基于 sonner toast.custom 二次封装,提供 title + description + 状态图标卡片化 API,与 toast(message)互补,共用 Toaster 容器",
-      "files": [
-        {
-          "source": "src/components/notification/notification.tsx",
-          "targetAlias": "components",
-          "targetName": "notification.tsx"
-        }
-      ],
-      "meta": "src/components/notification/notification.meta.md",
-      "registryDependencies": ["cn", "sonner"],
-      "dependencies": {
-        "sonner": "^1.5.0",
-        "lucide-react": "^0.460.0"
-      },
-      "updateStrategy": "frozen",
-      "category": "feedback"
-    },
     {
       "id": "affix",
       "name": "Affix",
@@ -1397,30 +1387,35 @@
       "description": "滚动吸顶 / 吸底 — antd 独有补足。等价 antd `Affix`,滚出指定偏移时切为 position: fixed,保留原占位避免页面跳动,基于 scroll + getBoundingClientRect",
       "files": [
         {
-          "source": "src/components/affix/affix.tsx",
+          "source": "src/components/affix/index.tsx",
           "targetAlias": "components",
           "targetName": "affix.tsx"
         }
       ],
-      "meta": "src/components/affix/affix.meta.md",
+      "meta": "src/components/affix/meta.md",
       "registryDependencies": ["cn"],
       "updateStrategy": "frozen",
-      "category": "navigation"
+      "category": "layout"
     },
     {
       "id": "color-picker",
       "name": "ColorPicker",
       "type": "component",
-      "description": "颜色选择 — antd 独有补足。等价 antd `ColorPicker`(v5.5+),触发器色块 + Popover 面板(原生 color input + alpha 滑块 + hex 输入 + 预设色板),支持 8 位 hex(含透明度)",
+      "description": "颜色选择 — 完整的颜色选取器(色相/饱和度/明度面板 + 色相/透明度滑条 + 格式切换 hex/rgb/hsb + 预设色板分组),支持受控/非受控、拖拽完成回调、自定义触发器",
       "files": [
         {
-          "source": "src/components/color-picker/color-picker.tsx",
+          "source": "src/components/color-picker/index.tsx",
           "targetAlias": "components",
           "targetName": "color-picker.tsx"
         }
       ],
-      "meta": "src/components/color-picker/color-picker.meta.md",
-      "registryDependencies": ["cn", "input", "popover"],
+      "meta": "src/components/color-picker/meta.md",
+      "registryDependencies": ["cn", "popover", "collapsible"],
+      "dependencies": {
+        "react-colorful": "^5.6.1",
+        "class-variance-authority": "^0.7.0",
+        "lucide-react": "^0.460.0"
+      },
       "updateStrategy": "frozen",
       "category": "data-entry"
     },
@@ -1431,60 +1426,15 @@
       "description": "水印 — antd 独有补足。等价 antd `Watermark`(v5.1+),容器内重复平铺的 SVG 文字 / 图片水印(内部敏感页面 / 文档预览 / demo 录屏)。仅前端视觉,不作安全防护",
       "files": [
         {
-          "source": "src/components/watermark/watermark.tsx",
+          "source": "src/components/watermark/index.tsx",
           "targetAlias": "components",
           "targetName": "watermark.tsx"
         }
       ],
-      "meta": "src/components/watermark/watermark.meta.md",
+      "meta": "src/components/watermark/meta.md",
       "registryDependencies": ["cn"],
       "updateStrategy": "frozen",
-      "category": "feedback"
-    },
-    {
-      "id": "ellipsis",
-      "name": "Ellipsis",
-      "type": "component",
-      "description": "单行/多行文本截断 + 渐变遮罩 + 溢出时自动 hover tooltip — 对齐《Teamix UI 表单设计规范》§八 '截断 + 渐变遮罩 + hover tooltip 三件套'",
-      "files": [
-        {
-          "source": "src/components/ellipsis/ellipsis.tsx",
-          "targetAlias": "components",
-          "targetName": "ellipsis.tsx"
-        }
-      ],
-      "meta": "src/components/ellipsis/ellipsis.meta.md",
-      "registryDependencies": ["cn", "tooltip"],
-      "updateStrategy": "frozen",
-      "category": "data-display"
-    },
-    {
-      "id": "use-debounce-callback",
-      "name": "useDebounceCallback",
-      "type": "hook",
-      "description": "防抖回调 hook — 返回一个防抖包装后的函数，在指定 delay 毫秒内连续调用只执行最后一次",
-      "files": [
-        {
-          "source": "src/hooks/use-debounce-callback.ts",
-          "targetAlias": "hooks",
-          "targetName": "use-debounce-callback.ts"
-        }
-      ],
-      "updateStrategy": "frozen"
-    },
-    {
-      "id": "use-breakpoint",
-      "name": "useBreakpoint",
-      "type": "hook",
-      "description": "响应式断点 hook + pickByBreakpoint 工具 — 5 档断点(432/672/944/1200/1600,对齐《Teamix UI 表单设计规范》§4.1),给 Field 响应式 orientation / FilterBarPanel 响应式列数共用",
-      "files": [
-        {
-          "source": "src/hooks/use-breakpoint.ts",
-          "targetAlias": "hooks",
-          "targetName": "use-breakpoint.ts"
-        }
-      ],
-      "updateStrategy": "frozen"
+      "category": "layout"
     },
     {
       "id": "filter-bar",
@@ -1493,384 +1443,207 @@
       "description": "筛选栏 — 面向 Table/List 的筛选表单变体，支持行内实时筛选 + 可折叠高级面板栅格。混合式架构：复合子组件(FilterBar/FilterBarSearch/FilterBarTrigger/FilterBarPanel/FilterBarActions) + FilterBarPreset 开箱即用",
       "files": [
         {
-          "source": "src/components/filter-bar/filter-bar.tsx",
+          "source": "src/components/filter-bar/index.tsx",
           "targetAlias": "components",
           "targetName": "filter-bar.tsx"
         }
       ],
-      "meta": "src/components/filter-bar/filter-bar.meta.md",
-      "registryDependencies": [
-        "cn",
-        "button",
-        "form",
-        "grid",
-        "collapsible",
-        "use-debounce-callback",
-        "use-breakpoint"
-      ],
+      "meta": "src/components/filter-bar/meta.md",
+      "registryDependencies": ["cn", "button", "form", "collapsible"],
       "dependencies": {
         "lucide-react": "^0.460.0",
         "class-variance-authority": "^0.7.0",
-        "@radix-ui/react-collapsible": "^1.1.0"
+        "radix-ui": "^1.4.3"
       },
       "updateStrategy": "frozen",
       "category": "data-entry"
-    }
-  ],
-  "deprecatedEntries": [
-    {
-      "id": "aspect-ratio",
-      "name": "AspectRatio",
-      "type": "component",
-      "description": "容器保持宽高比 — Radix AspectRatio,无 layout shift",
-      "files": [
-        {
-          "source": "src/components/aspect-ratio/aspect-ratio.tsx",
-          "targetAlias": "components",
-          "targetName": "aspect-ratio.tsx"
-        }
-      ],
-      "meta": "src/components/aspect-ratio/aspect-ratio.meta.md",
-      "dependencies": {
-        "@radix-ui/react-aspect-ratio": "^1.1.0"
-      },
-      "updateStrategy": "frozen",
-      "category": "deprecated"
     },
     {
-      "id": "toggle",
-      "name": "Toggle",
+      "id": "cascader-select",
+      "name": "CascaderSelect",
       "type": "component",
-      "description": "二元状态按钮 — Radix Toggle 包装,工具栏图标级开关",
+      "description": "级联选择 — 多层级数据的逐级选择,适合省/市/区、分类目录等场景",
       "files": [
         {
-          "source": "src/components/toggle/toggle.tsx",
+          "source": "src/components/cascader-select/index.tsx",
           "targetAlias": "components",
-          "targetName": "toggle.tsx"
+          "targetName": "cascader-select.tsx"
         }
       ],
-      "meta": "src/components/toggle/toggle.meta.md",
+      "meta": "src/components/cascader-select/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
-        "@radix-ui/react-toggle": "^1.1.0",
-        "class-variance-authority": "^0.7.0"
+        "lucide-react": "^0.460.0"
       },
       "updateStrategy": "frozen",
-      "category": "deprecated"
+      "category": "data-entry"
     },
     {
-      "id": "toggle-group",
-      "name": "ToggleGroup",
+      "id": "float-button",
+      "name": "FloatButton",
       "type": "component",
-      "description": "切换按钮组 — Radix ToggleGroup,type=single|multiple,复用 Toggle variant/size",
+      "description": "悬浮按钮 — 固定在视口角落的操作按钮,用于回到顶部、客服入口、新建等高频操作",
       "files": [
         {
-          "source": "src/components/toggle-group/toggle-group.tsx",
+          "source": "src/components/float-button/index.tsx",
           "targetAlias": "components",
-          "targetName": "toggle-group.tsx"
+          "targetName": "float-button.tsx"
         }
       ],
-      "meta": "src/components/toggle-group/toggle-group.meta.md",
-      "registryDependencies": ["cn", "toggle"],
+      "meta": "src/components/float-button/meta.md",
+      "registryDependencies": ["cn"],
       "dependencies": {
-        "@radix-ui/react-toggle-group": "^1.1.0",
+        "lucide-react": "^0.460.0",
         "class-variance-authority": "^0.7.0"
       },
       "updateStrategy": "frozen",
-      "category": "deprecated"
+      "category": "general"
     },
     {
-      "id": "input-otp",
-      "name": "InputOTP",
+      "id": "image",
+      "name": "Image",
       "type": "component",
-      "description": "OTP 验证码输入 — 基于 input-otp,shadcn-only(短验证码场景:登录、二步验证、PIN)",
+      "description": "图片 — 带加载占位、错误兜底和点击预览的增强图片组件",
       "files": [
         {
-          "source": "src/components/input-otp/input-otp.tsx",
+          "source": "src/components/image/index.tsx",
           "targetAlias": "components",
-          "targetName": "input-otp.tsx"
+          "targetName": "image.tsx"
         }
       ],
-      "meta": "src/components/input-otp/input-otp.meta.md",
-      "registryDependencies": ["cn"],
+      "meta": "src/components/image/meta.md",
+      "registryDependencies": ["cn", "skeleton", "dialog"],
       "dependencies": {
-        "input-otp": "^1.2.0",
         "lucide-react": "^0.460.0"
       },
       "updateStrategy": "frozen",
-      "category": "deprecated"
+      "category": "data-display"
     },
     {
-      "id": "context-menu",
-      "name": "ContextMenu",
+      "id": "mentions",
+      "name": "Mentions",
       "type": "component",
-      "description": "右键菜单 — Radix ContextMenu(与 DropdownMenu 形态一致,触发为右键)",
+      "description": "提及 — 在文本输入中通过特定前缀触发候选列表,选中后将提及插入文本",
       "files": [
         {
-          "source": "src/components/context-menu/context-menu.tsx",
+          "source": "src/components/mentions/index.tsx",
           "targetAlias": "components",
-          "targetName": "context-menu.tsx"
+          "targetName": "mentions.tsx"
         }
       ],
-      "meta": "src/components/context-menu/context-menu.meta.md",
-      "registryDependencies": ["cn"],
+      "meta": "src/components/mentions/meta.md",
+      "registryDependencies": ["cn", "textarea"],
       "dependencies": {
-        "@radix-ui/react-context-menu": "^2.2.0",
         "lucide-react": "^0.460.0"
       },
       "updateStrategy": "frozen",
-      "category": "deprecated"
+      "category": "data-entry"
     },
     {
       "id": "menubar",
       "name": "Menubar",
       "type": "component",
-      "description": "应用顶部菜单栏 — Radix Menubar(macOS 风格:文件/编辑/视图/帮助)",
+      "description": "菜单栏 — 水平菜单栏,支持子菜单、快捷键、复选和单选项,基于 Radix Menubar 原语",
       "files": [
         {
-          "source": "src/components/menubar/menubar.tsx",
+          "source": "src/components/menubar/index.tsx",
           "targetAlias": "components",
           "targetName": "menubar.tsx"
         }
       ],
-      "meta": "src/components/menubar/menubar.meta.md",
+      "meta": "src/components/menubar/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
-        "@radix-ui/react-menubar": "^1.1.0",
+        "radix-ui": "^1.4.3",
         "lucide-react": "^0.460.0"
       },
       "updateStrategy": "frozen",
-      "category": "deprecated"
+      "category": "navigation"
     },
     {
       "id": "navigation-menu",
       "name": "NavigationMenu",
       "type": "component",
-      "description": "网站主导航 — Radix NavigationMenu(支持富 Content 面板)",
+      "description": "导航菜单 — 水平导航栏,支持嵌套菜单、多列布局和快捷链接展示,基于 Radix NavigationMenu 原语",
       "files": [
         {
-          "source": "src/components/navigation-menu/navigation-menu.tsx",
+          "source": "src/components/navigation-menu/index.tsx",
           "targetAlias": "components",
           "targetName": "navigation-menu.tsx"
         }
       ],
-      "meta": "src/components/navigation-menu/navigation-menu.meta.md",
+      "meta": "src/components/navigation-menu/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
-        "@radix-ui/react-navigation-menu": "^1.2.0",
+        "radix-ui": "^1.4.3",
         "class-variance-authority": "^0.7.0",
         "lucide-react": "^0.460.0"
       },
       "updateStrategy": "frozen",
-      "category": "deprecated"
+      "category": "navigation"
     },
     {
       "id": "scroll-area",
       "name": "ScrollArea",
       "type": "component",
-      "description": "自定义滚动容器 — Radix ScrollArea(跨浏览器一致的滚动条,触屏友好,自动隐藏 thumb)",
+      "description": "滚动区域 — 自定义滚动条的滚动容器,基于 Radix ScrollArea 原语",
       "files": [
         {
-          "source": "src/components/scroll-area/scroll-area.tsx",
+          "source": "src/components/scroll-area/index.tsx",
           "targetAlias": "components",
           "targetName": "scroll-area.tsx"
         }
       ],
-      "meta": "src/components/scroll-area/scroll-area.meta.md",
+      "meta": "src/components/scroll-area/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
-        "@radix-ui/react-scroll-area": "^1.2.0"
-      },
-      "updateStrategy": "frozen",
-      "category": "deprecated"
-    },
-    {
-      "id": "image",
-      "name": "Image",
-      "type": "component",
-      "description": "图片 — antd 独有补足。自动加载占位 + 失败占位 + 点击预览(Dialog 模态原图)",
-      "files": [
-        {
-          "source": "src/components/image/image.tsx",
-          "targetAlias": "components",
-          "targetName": "image.tsx"
-        }
-      ],
-      "meta": "src/components/image/image.meta.md",
-      "registryDependencies": ["cn", "dialog", "skeleton"],
-      "dependencies": {
-        "lucide-react": "^0.460.0"
+        "radix-ui": "^1.4.3"
       },
       "updateStrategy": "frozen",
-      "category": "deprecated"
-    },
-    {
-      "id": "mentions",
-      "name": "Mentions",
-      "type": "component",
-      "description": "@提及输入 — antd 独有补足。Textarea + @ 触发候选下拉(评论 @ 同事 / # 话题),键盘 ↑↓ 切换 + Enter/Tab 选中 + Esc 关闭,异步候选用 onSearch 刷新 options",
-      "files": [
-        {
-          "source": "src/components/mentions/mentions.tsx",
-          "targetAlias": "components",
-          "targetName": "mentions.tsx"
-        }
-      ],
-      "meta": "src/components/mentions/mentions.meta.md",
-      "registryDependencies": ["cn", "input"],
-      "updateStrategy": "frozen",
-      "category": "deprecated"
+      "category": "layout"
     },
     {
-      "id": "kbd",
-      "name": "Kbd",
+      "id": "toggle",
+      "name": "Toggle",
       "type": "component",
-      "description": "键位展示 — shadcn 2025-10 新增。语义化 `<kbd>` 元素 + `KbdGroup` 组合容器,用于标注快捷键(⌘K / Ctrl + Enter)",
+      "description": "切换按钮 — 可切换开关状态的按钮,支持多种变体和尺寸,基于 Radix Toggle 原语",
       "files": [
         {
-          "source": "src/components/kbd/kbd.tsx",
+          "source": "src/components/toggle/index.tsx",
           "targetAlias": "components",
-          "targetName": "kbd.tsx"
+          "targetName": "toggle.tsx"
         }
       ],
-      "meta": "src/components/kbd/kbd.meta.md",
+      "meta": "src/components/toggle/meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
+        "radix-ui": "^1.4.3",
         "class-variance-authority": "^0.7.0"
       },
       "updateStrategy": "frozen",
-      "category": "deprecated"
-    },
-    {
-      "id": "native-select",
-      "name": "NativeSelect",
-      "type": "component",
-      "description": "原生 `<select>` 样式封装 — shadcn 2025-10 新增。零 JS 开销,移动端弹起系统 picker,直接参与 form submit。与 Radix Select 互补",
-      "files": [
-        {
-          "source": "src/components/native-select/native-select.tsx",
-          "targetAlias": "components",
-          "targetName": "native-select.tsx"
-        }
-      ],
-      "meta": "src/components/native-select/native-select.meta.md",
-      "registryDependencies": ["cn"],
-      "dependencies": {
-        "lucide-react": "^0.460.0"
-      },
-      "updateStrategy": "frozen",
-      "category": "deprecated"
+      "category": "general"
     },
     {
-      "id": "segmented",
-      "name": "Segmented",
+      "id": "toggle-group",
+      "name": "ToggleGroup",
       "type": "component",
-      "description": "分段控制器 — antd 独有补足。等价 antd `Segmented`(v5.0+),iOS / macOS 风格紧凑互斥单选(视图切换 / 时间区间 / 主题档)",
+      "description": "切换按钮组 — 一组互斥或多选的切换按钮,基于 Radix ToggleGroup 原语,复用 toggle 的 cva 变体",
       "files": [
         {
-          "source": "src/components/segmented/segmented.tsx",
+          "source": "src/components/toggle-group/index.tsx",
           "targetAlias": "components",
-          "targetName": "segmented.tsx"
+          "targetName": "toggle-group.tsx"
         }
       ],
-      "meta": "src/components/segmented/segmented.meta.md",
-      "registryDependencies": ["cn"],
+      "meta": "src/components/toggle-group/meta.md",
+      "registryDependencies": ["cn", "toggle"],
       "dependencies": {
+        "radix-ui": "^1.4.3",
         "class-variance-authority": "^0.7.0"
       },
       "updateStrategy": "frozen",
-      "category": "deprecated"
-    },
-    {
-      "id": "app",
-      "name": "App",
-      "type": "component",
-      "description": "应用根容器 — antd 独有补足。对标 antd `App`,挂全局 Toaster + 设置 dir / lang + 根级 className 承载;不接管主题(主题靠 design tokens),不收敛 useApp() hook",
-      "files": [
-        {
-          "source": "src/components/app/app.tsx",
-          "targetAlias": "components",
-          "targetName": "app.tsx"
-        }
-      ],
-      "meta": "src/components/app/app.meta.md",
-      "registryDependencies": ["cn", "sonner"],
-      "updateStrategy": "frozen",
-      "category": "deprecated"
-    },
-    {
-      "id": "anchor",
-      "name": "Anchor",
-      "type": "component",
-      "description": "锚点导航 — antd 独有补足。等价 antd `Anchor`,长文档 / 详情页侧边目录,点击滚动到 id 节点,滚动时 IntersectionObserver 自动高亮,支持嵌套两层缩进",
-      "files": [
-        {
-          "source": "src/components/anchor/anchor.tsx",
-          "targetAlias": "components",
-          "targetName": "anchor.tsx"
-        }
-      ],
-      "meta": "src/components/anchor/anchor.meta.md",
-      "registryDependencies": ["cn"],
-      "updateStrategy": "frozen",
-      "category": "deprecated"
-    },
-    {
-      "id": "float-button",
-      "name": "FloatButton",
-      "type": "component",
-      "description": "悬浮按钮 — antd 独有补足。等价 antd `FloatButton`(v5.0,替代旧 BackTop)。固定右下角强主张操作,配 FloatButtonGroup 堆叠多个,FloatButtonBackTop 预置回到顶部",
-      "files": [
-        {
-          "source": "src/components/float-button/float-button.tsx",
-          "targetAlias": "components",
-          "targetName": "float-button.tsx"
-        }
-      ],
-      "meta": "src/components/float-button/float-button.meta.md",
-      "registryDependencies": ["cn"],
-      "dependencies": {
-        "lucide-react": "^0.460.0"
-      },
-      "updateStrategy": "frozen",
-      "category": "deprecated"
-    },
-    {
-      "id": "tour",
-      "name": "Tour",
-      "type": "component",
-      "description": "新手引导 — antd 独有补足。等价 antd `Tour`(v5.0+),多步骤 spotlight + 卡片 + 步进按钮 + 可关闭,业务侧自管首次访问标记",
-      "files": [
-        {
-          "source": "src/components/tour/tour.tsx",
-          "targetAlias": "components",
-          "targetName": "tour.tsx"
-        }
-      ],
-      "meta": "src/components/tour/tour.meta.md",
-      "registryDependencies": ["cn", "button"],
-      "dependencies": {
-        "lucide-react": "^0.460.0"
-      },
-      "updateStrategy": "frozen",
-      "category": "deprecated"
-    },
-    {
-      "id": "masonry",
-      "name": "Masonry",
-      "type": "component",
-      "description": "瀑布流 — antd 独有补足。等价 antd `Masonry`(v6.0 新),CSS column-count + break-inside: avoid 的 0 JS 实现,SSR 友好(图片墙 / 资讯卡片 / Dashboard 卡片墙)",
-      "files": [
-        {
-          "source": "src/components/masonry/masonry.tsx",
-          "targetAlias": "components",
-          "targetName": "masonry.tsx"
-        }
-      ],
-      "meta": "src/components/masonry/masonry.meta.md",
-      "registryDependencies": ["cn"],
-      "updateStrategy": "frozen",
-      "category": "deprecated"
+      "category": "general"
     }
-  ]
+  ],
+  "deprecatedEntries": []
 }