@teamix-evo/ui 0.2.0 → 0.4.0

package/manifest.json

@@ -29,7 +29,7 @@
       "id": "button",
       "name": "Button",
       "type": "component",
-      "description": "通用按钮 — shadcn 实现 + antd 功能扩展(loading / icon / shape / block / dashed variant)",
+      "description": "通用按钮 — shadcn 实现 + cloud-design 能力并集(loading / icon / shape / block / dashed variant / color 语义双 prop / disabledTooltip)。同文件合一导出 ButtonGroup + ButtonGroupText(等价 antd Space.Compact + cd SplitButton)。",
       "files": [
         {
           "source": "src/components/button/button.tsx",
@@ -38,13 +38,15 @@
         }
       ],
       "meta": "src/components/button/button.meta.md",
-      "registryDependencies": ["cn"],
+      "registryDependencies": ["cn", "tooltip"],
       "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"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "general"
     },
     {
       "id": "label",
@@ -64,7 +66,8 @@
         "@radix-ui/react-label": "^2.1.0",
         "class-variance-authority": "^0.7.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-entry"
     },
     {
       "id": "badge",
@@ -83,7 +86,8 @@
       "dependencies": {
         "class-variance-authority": "^0.7.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-display"
     },
     {
       "id": "separator",
@@ -102,7 +106,8 @@
       "dependencies": {
         "@radix-ui/react-separator": "^1.1.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "layout"
     },
     {
       "id": "skeleton",
@@ -121,25 +126,8 @@
       "dependencies": {
         "class-variance-authority": "^0.7.0"
       },
-      "updateStrategy": "frozen"
-    },
-    {
-      "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"
+      "updateStrategy": "frozen",
+      "category": "feedback"
     },
     {
       "id": "avatar",
@@ -157,9 +145,11 @@
       "registryDependencies": ["cn"],
       "dependencies": {
         "@radix-ui/react-avatar": "^1.1.0",
-        "class-variance-authority": "^0.7.0"
+        "class-variance-authority": "^0.7.0",
+        "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-display"
     },
     {
       "id": "progress",
@@ -178,7 +168,8 @@
       "dependencies": {
         "@radix-ui/react-progress": "^1.1.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "feedback"
     },
     {
       "id": "switch",
@@ -198,7 +189,8 @@
         "@radix-ui/react-switch": "^1.1.0",
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-entry"
     },
     {
       "id": "slider",
@@ -217,33 +209,14 @@
       "dependencies": {
         "@radix-ui/react-slider": "^1.2.0"
       },
-      "updateStrategy": "frozen"
-    },
-    {
-      "id": "toggle",
-      "name": "Toggle",
-      "type": "component",
-      "description": "二元状态按钮 — Radix Toggle 包装,工具栏图标级开关",
-      "files": [
-        {
-          "source": "src/components/toggle/toggle.tsx",
-          "targetAlias": "components",
-          "targetName": "toggle.tsx"
-        }
-      ],
-      "meta": "src/components/toggle/toggle.meta.md",
-      "registryDependencies": ["cn"],
-      "dependencies": {
-        "@radix-ui/react-toggle": "^1.1.0",
-        "class-variance-authority": "^0.7.0"
-      },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-entry"
     },
     {
       "id": "input",
       "name": "Input",
       "type": "component",
-      "description": "文本输入 — shadcn 简洁基底 + antd prefix/suffix/clearable/showCount/addonBefore/addonAfter/size",
+      "description": "单行文本输入 — clearable / showCount / size(sm 24 / md 32 / lg 36,与 Button 同档)/ error 四档内建能力。前缀/后缀/addon 等复合形态已拆出独立 InputGroup;多行已拆出独立 Textarea",
       "files": [
         {
           "source": "src/components/input/input.tsx",
@@ -256,13 +229,14 @@
       "dependencies": {
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-entry"
     },
     {
       "id": "textarea",
       "name": "Textarea",
       "type": "component",
-      "description": "多行文本输入 — shadcn 基底 + antd autoSize / showCount",
+      "description": "多行文本输入 — autoSize(布尔或 minRows/maxRows)+ showCount + size 三档字号,与 Input 同档对齐;高度由 rows / autoSize 控制",
       "files": [
         {
           "source": "src/components/textarea/textarea.tsx",
@@ -272,7 +246,25 @@
       ],
       "meta": "src/components/textarea/textarea.meta.md",
       "registryDependencies": ["cn"],
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-entry"
+    },
+    {
+      "id": "input-group",
+      "name": "InputGroup",
+      "type": "component",
+      "description": "复合输入容器 — shadcn 2025-10 新增,等价 antd Input 的 prefix/suffix/addonBefore/addonAfter 集合;通过 InputGroupAddon(position=before|after) + InputGroupInput / InputGroupTextarea 复合插槽组合图标 / 按钮 / 文本",
+      "files": [
+        {
+          "source": "src/components/input-group/input-group.tsx",
+          "targetAlias": "components",
+          "targetName": "input-group.tsx"
+        }
+      ],
+      "meta": "src/components/input-group/input-group.meta.md",
+      "registryDependencies": ["cn"],
+      "updateStrategy": "frozen",
+      "category": "data-entry"
     },
     {
       "id": "checkbox",
@@ -292,7 +284,8 @@
         "@radix-ui/react-checkbox": "^1.1.0",
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-entry"
     },
     {
       "id": "radio-group",
@@ -312,13 +305,14 @@
         "@radix-ui/react-radio-group": "^1.2.0",
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-entry"
     },
     {
       "id": "alert",
       "name": "Alert",
       "type": "component",
-      "description": "静态提示条 — shadcn 视觉 + antd type/showIcon/closable/banner 并集",
+      "description": "静态提示条 — shadcn 视觉 + antd type/showIcon/closable/banner 并集,六档语义色(primary/info/success/warning/destructive/neutral),无边框 + 面性状态图标",
       "files": [
         {
           "source": "src/components/alert/alert.tsx",
@@ -332,13 +326,14 @@
         "class-variance-authority": "^0.7.0",
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "feedback"
     },
     {
       "id": "tooltip",
       "name": "Tooltip",
       "type": "component",
-      "description": "文字提示气泡 — Radix Tooltip + antd arrow/placement(side) 并集 + 一行 wrapper API",
+      "description": "文字提示气泡 — Radix Tooltip + antd arrow/placement(side) 并集 + cloud-design Balloon 双变体(default 深底 / light 白底) + 一行 wrapper API",
       "files": [
         {
           "source": "src/components/tooltip/tooltip.tsx",
@@ -349,15 +344,17 @@
       "meta": "src/components/tooltip/tooltip.meta.md",
       "registryDependencies": ["cn"],
       "dependencies": {
-        "@radix-ui/react-tooltip": "^1.1.0"
+        "@radix-ui/react-tooltip": "^1.1.0",
+        "class-variance-authority": "^0.7.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-display"
     },
     {
       "id": "popover",
       "name": "Popover",
       "type": "component",
-      "description": "可交互浮层 — Radix Popover + antd arrow 并集",
+      "description": "可交互浮层 — Radix Popover + antd arrow 并集,使用 showArrow 控制尖角(与 Tooltip / HoverCard 命名统一)",
       "files": [
         {
           "source": "src/components/popover/popover.tsx",
@@ -370,13 +367,35 @@
       "dependencies": {
         "@radix-ui/react-popover": "^1.1.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "feedback"
+    },
+    {
+      "id": "command",
+      "name": "Command",
+      "type": "component",
+      "description": "命令面板 / 下拉底座 — cmdk(Linear / Raycast 风格)提供过滤 / 键盘导航 / a11y;同时为 Combobox / Select / AutoComplete 提供同源下拉内核",
+      "files": [
+        {
+          "source": "src/components/command/command.tsx",
+          "targetAlias": "components",
+          "targetName": "command.tsx"
+        }
+      ],
+      "meta": "src/components/command/command.meta.md",
+      "registryDependencies": ["cn", "dialog"],
+      "dependencies": {
+        "cmdk": "^1.0.0",
+        "lucide-react": "^0.460.0"
+      },
+      "updateStrategy": "frozen",
+      "category": "feedback"
     },
     {
       "id": "hover-card",
       "name": "HoverCard",
       "type": "component",
-      "description": "悬浮富内容卡 — Radix HoverCard,shadcn-only(@username 卡片 / 链接预览)",
+      "description": "悬浮富内容卡 — Radix HoverCard,shadcn-only(@username 卡片 / 链接预览 / 资源卡),使用 showArrow 与 Tooltip/Popover 对齐",
       "files": [
         {
           "source": "src/components/hover-card/hover-card.tsx",
@@ -389,33 +408,42 @@
       "dependencies": {
         "@radix-ui/react-hover-card": "^1.1.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-display"
     },
     {
       "id": "dialog",
       "name": "Dialog",
       "type": "component",
-      "description": "模态对话框 — Radix Dialog + antd Modal 并集(组合式 Header/Footer/Title/Description)",
+      "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",
           "targetAlias": "components",
           "targetName": "dialog.tsx"
+        },
+        {
+          "source": "src/components/dialog/imperative.tsx",
+          "targetAlias": "components",
+          "targetName": "dialog-imperative.tsx"
         }
       ],
       "meta": "src/components/dialog/dialog.meta.md",
-      "registryDependencies": ["cn"],
+      "registryDependencies": ["cn", "button"],
       "dependencies": {
         "@radix-ui/react-dialog": "^1.1.0",
-        "lucide-react": "^0.460.0"
+        "class-variance-authority": "^0.7.0",
+        "lucide-react": "^0.460.0",
+        "react-dom": ">=18"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "feedback"
     },
     {
       "id": "alert-dialog",
       "name": "AlertDialog",
       "type": "component",
-      "description": "阻断式确认对话框 — Radix AlertDialog + antd Modal.confirm 并集(Action / Cancel)",
+      "description": "阻断式确认对话框 — Radix AlertDialog + antd Modal.confirm 并集(Action / Cancel,size sm/md/lg/xl,圆角与无 border 同 Dialog)",
       "files": [
         {
           "source": "src/components/alert-dialog/alert-dialog.tsx",
@@ -426,15 +454,17 @@
       "meta": "src/components/alert-dialog/alert-dialog.meta.md",
       "registryDependencies": ["cn", "button"],
       "dependencies": {
-        "@radix-ui/react-alert-dialog": "^1.1.0"
+        "@radix-ui/react-alert-dialog": "^1.1.0",
+        "class-variance-authority": "^0.7.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "feedback"
     },
     {
       "id": "sheet",
       "name": "Sheet",
       "type": "component",
-      "description": "侧边滑出面板 — Radix Dialog + side(left/right/top/bottom),与 antd Drawer placement 对齐",
+      "description": "侧边面板 — Radix Dialog + side(left/right/top/bottom) + size(sm/md/lg/xl) + --radius-dialog 圆角,对齐 antd Drawer 全能力集",
       "files": [
         {
           "source": "src/components/sheet/sheet.tsx",
@@ -449,13 +479,15 @@
         "class-variance-authority": "^0.7.0",
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "feedback"
     },
     {
       "id": "drawer",
       "name": "Drawer",
       "type": "component",
-      "description": "底部可拖拽抽屉 — vaul,iOS 风格,移动端体验最佳(与 Sheet 互补)",
+      "description": "抽屉（Sheet 别名）— re-export sheet,向后兼容已有 Drawer 导入",
+      "alias": "sheet",
       "files": [
         {
           "source": "src/components/drawer/drawer.tsx",
@@ -464,17 +496,16 @@
         }
       ],
       "meta": "src/components/drawer/drawer.meta.md",
-      "registryDependencies": ["cn"],
-      "dependencies": {
-        "vaul": "^1.0.0"
-      },
-      "updateStrategy": "frozen"
+      "registryDependencies": ["sheet", "cn"],
+      "dependencies": {},
+      "updateStrategy": "frozen",
+      "category": "feedback"
     },
     {
       "id": "sonner",
       "name": "Toaster",
       "type": "component",
-      "description": "Toast 通知 — sonner 包装,等价 antd message + notification 并集(toast() 函数式 API + Toaster 容器)",
+      "description": "Toast 通知 — sonner 包装,等价 antd message + notification 并集(toast() 函数式 API + Toaster 容器,面性 5 状态图标 + 无边框)",
       "files": [
         {
           "source": "src/components/sonner/sonner.tsx",
@@ -483,16 +514,19 @@
         }
       ],
       "meta": "src/components/sonner/sonner.meta.md",
+      "registryDependencies": ["cn"],
       "dependencies": {
-        "sonner": "^1.5.0"
+        "sonner": "^1.5.0",
+        "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "feedback"
     },
     {
       "id": "select",
       "name": "Select",
       "type": "component",
-      "description": "下拉选择 — Radix Select 标准(单选;多选/搜索请用 Combobox v0.x)",
+      "description": "下拉选择 — 单组件覆盖 cd Select 全部模式:单选 / 多选(multiple) / 搜索(searchable) / 标签创建(creatable) / 远程异步(onSearch) / 虚拟滚动(virtual) / 弹层容器(container)。基于 Popover + cmdk Command,size 三档对齐 Button/Input(24/32/36)。原 Combobox 已合并入此组件",
       "files": [
         {
           "source": "src/components/select/select.tsx",
@@ -501,32 +535,13 @@
         }
       ],
       "meta": "src/components/select/select.meta.md",
-      "registryDependencies": ["cn"],
+      "registryDependencies": ["cn", "command", "popover"],
       "dependencies": {
-        "@radix-ui/react-select": "^2.1.0",
+        "@tanstack/react-virtual": "^3.0.0",
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
-    },
-    {
-      "id": "toggle-group",
-      "name": "ToggleGroup",
-      "type": "component",
-      "description": "切换按钮组 — Radix ToggleGroup,type=single|multiple,复用 Toggle variant/size",
-      "files": [
-        {
-          "source": "src/components/toggle-group/toggle-group.tsx",
-          "targetAlias": "components",
-          "targetName": "toggle-group.tsx"
-        }
-      ],
-      "meta": "src/components/toggle-group/toggle-group.meta.md",
-      "registryDependencies": ["cn", "toggle"],
-      "dependencies": {
-        "@radix-ui/react-toggle-group": "^1.1.0",
-        "class-variance-authority": "^0.7.0"
-      },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-entry"
     },
     {
       "id": "calendar",
@@ -546,13 +561,14 @@
         "react-day-picker": "^9.0.0",
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-display"
     },
     {
       "id": "date-picker",
       "name": "DatePicker",
       "type": "component",
-      "description": "日期 / 范围选择器 — Calendar + Popover 复合,date-fns 格式化(对应 antd DatePicker + RangePicker)",
+      "description": "日期 / 范围选择器 — Calendar + Popover 复合,可选 showTime 追加 TimePickerPanel(对齐 antd DatePicker / RangePicker / showTime)",
       "files": [
         {
           "source": "src/components/date-picker/date-picker.tsx",
@@ -561,33 +577,20 @@
         }
       ],
       "meta": "src/components/date-picker/date-picker.meta.md",
-      "registryDependencies": ["cn", "button", "calendar", "popover"],
+      "registryDependencies": [
+        "cn",
+        "button",
+        "calendar",
+        "popover",
+        "time-picker"
+      ],
       "dependencies": {
         "date-fns": "^3.0.0",
         "react-day-picker": "^9.0.0",
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
-    },
-    {
-      "id": "input-otp",
-      "name": "InputOTP",
-      "type": "component",
-      "description": "OTP 验证码输入 — 基于 input-otp,shadcn-only(短验证码场景:登录、二步验证、PIN)",
-      "files": [
-        {
-          "source": "src/components/input-otp/input-otp.tsx",
-          "targetAlias": "components",
-          "targetName": "input-otp.tsx"
-        }
-      ],
-      "meta": "src/components/input-otp/input-otp.meta.md",
-      "registryDependencies": ["cn"],
-      "dependencies": {
-        "input-otp": "^1.2.0",
-        "lucide-react": "^0.460.0"
-      },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-entry"
     },
     {
       "id": "form",
@@ -602,21 +605,21 @@
         }
       ],
       "meta": "src/components/form/form.meta.md",
-      "registryDependencies": ["cn", "label"],
+      "registryDependencies": ["cn", "field"],
       "dependencies": {
         "react-hook-form": "^7.50.0",
         "@hookform/resolvers": "^3.0.0",
         "zod": "^3.22.0",
-        "@radix-ui/react-label": "^2.1.0",
         "@radix-ui/react-slot": "^1.1.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-entry"
     },
     {
       "id": "tabs",
       "name": "Tabs",
       "type": "component",
-      "description": "标签页 — Radix Tabs + antd type(line/card) + tabBarExtraContent(extra)并集",
+      "description": "标签页 — Radix Tabs + shadcn ∪ antd 并集,吸收 Segmented 胶囊视觉(variant=line|capsule + size=sm|md|lg + extra)",
       "files": [
         {
           "source": "src/components/tabs/tabs.tsx",
@@ -630,7 +633,8 @@
         "@radix-ui/react-tabs": "^1.1.0",
         "class-variance-authority": "^0.7.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-display"
     },
     {
       "id": "accordion",
@@ -650,7 +654,8 @@
         "@radix-ui/react-accordion": "^1.2.0",
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-display"
     },
     {
       "id": "collapsible",
@@ -668,7 +673,8 @@
       "dependencies": {
         "@radix-ui/react-collapsible": "^1.1.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-display"
     },
     {
       "id": "breadcrumb",
@@ -688,7 +694,8 @@
         "@radix-ui/react-slot": "^1.1.0",
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "navigation"
     },
     {
       "id": "pagination",
@@ -705,9 +712,11 @@
       "meta": "src/components/pagination/pagination.meta.md",
       "registryDependencies": ["cn", "button"],
       "dependencies": {
+        "class-variance-authority": "^0.7.0",
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "navigation"
     },
     {
       "id": "dropdown-menu",
@@ -727,89 +736,90 @@
         "@radix-ui/react-dropdown-menu": "^2.1.0",
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "navigation"
     },
     {
-      "id": "context-menu",
-      "name": "ContextMenu",
-      "type": "component",
-      "description": "右键菜单 — Radix ContextMenu(与 DropdownMenu 形态一致,触发为右键)",
+      "id": "use-mobile",
+      "name": "useIsMobile",
+      "type": "hook",
+      "description": "检测视口是否为移动尺寸(< 768px) — Sidebar 在 mobile 视口切 Sheet 抽屉的判定依据",
       "files": [
         {
-          "source": "src/components/context-menu/context-menu.tsx",
-          "targetAlias": "components",
-          "targetName": "context-menu.tsx"
+          "source": "src/hooks/use-mobile.ts",
+          "targetAlias": "hooks",
+          "targetName": "use-mobile.ts"
         }
       ],
-      "meta": "src/components/context-menu/context-menu.meta.md",
-      "registryDependencies": ["cn"],
-      "dependencies": {
-        "@radix-ui/react-context-menu": "^2.2.0",
-        "lucide-react": "^0.460.0"
-      },
       "updateStrategy": "frozen"
     },
     {
-      "id": "menubar",
-      "name": "Menubar",
+      "id": "sidebar",
+      "name": "Sidebar",
       "type": "component",
-      "description": "应用顶部菜单栏 — Radix Menubar(macOS 风格:文件/编辑/视图/帮助)",
+      "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/menubar/menubar.tsx",
+          "source": "src/components/sidebar/sidebar.tsx",
           "targetAlias": "components",
-          "targetName": "menubar.tsx"
+          "targetName": "sidebar.tsx"
         }
       ],
-      "meta": "src/components/menubar/menubar.meta.md",
-      "registryDependencies": ["cn"],
+      "meta": "src/components/sidebar/sidebar.meta.md",
+      "registryDependencies": [
+        "cn",
+        "button",
+        "separator",
+        "sheet",
+        "tooltip",
+        "skeleton",
+        "input",
+        "use-mobile"
+      ],
       "dependencies": {
-        "@radix-ui/react-menubar": "^1.1.0",
+        "@radix-ui/react-slot": "^1.1.0",
+        "class-variance-authority": "^0.7.0",
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "layout"
     },
     {
-      "id": "navigation-menu",
-      "name": "NavigationMenu",
+      "id": "page-header",
+      "name": "PageHeader",
       "type": "component",
-      "description": "网站主导航 — Radix NavigationMenu(支持富 Content 面板)",
+      "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/navigation-menu/navigation-menu.tsx",
+          "source": "src/components/page-header/page-header.tsx",
           "targetAlias": "components",
-          "targetName": "navigation-menu.tsx"
+          "targetName": "page-header.tsx"
         }
       ],
-      "meta": "src/components/navigation-menu/navigation-menu.meta.md",
-      "registryDependencies": ["cn"],
+      "meta": "src/components/page-header/page-header.meta.md",
+      "registryDependencies": ["cn", "skeleton"],
       "dependencies": {
-        "@radix-ui/react-navigation-menu": "^1.2.0",
-        "class-variance-authority": "^0.7.0",
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "layout"
     },
     {
-      "id": "sidebar",
-      "name": "Sidebar",
+      "id": "page-shell",
+      "name": "PageShell",
       "type": "component",
-      "description": "侧边导航栏 — shadcn 复合(Provider + Sidebar + Header/Footer/Content + Menu + Trigger),对应 antd Layout.Sider + Menu",
+      "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/sidebar/sidebar.tsx",
+          "source": "src/components/page-shell/page-shell.tsx",
           "targetAlias": "components",
-          "targetName": "sidebar.tsx"
+          "targetName": "page-shell.tsx"
         }
       ],
-      "meta": "src/components/sidebar/sidebar.meta.md",
-      "registryDependencies": ["cn", "button", "separator"],
-      "dependencies": {
-        "@radix-ui/react-slot": "^1.1.0",
-        "class-variance-authority": "^0.7.0",
-        "lucide-react": "^0.460.0"
-      },
-      "updateStrategy": "frozen"
+      "meta": "src/components/page-shell/page-shell.meta.md",
+      "registryDependencies": ["cn", "sidebar"],
+      "updateStrategy": "frozen",
+      "category": "layout"
     },
     {
       "id": "card",
@@ -825,26 +835,8 @@
       ],
       "meta": "src/components/card/card.meta.md",
       "registryDependencies": ["cn", "skeleton"],
-      "updateStrategy": "frozen"
-    },
-    {
-      "id": "scroll-area",
-      "name": "ScrollArea",
-      "type": "component",
-      "description": "自定义滚动容器 — Radix ScrollArea(跨浏览器一致的滚动条,触屏友好,自动隐藏 thumb)",
-      "files": [
-        {
-          "source": "src/components/scroll-area/scroll-area.tsx",
-          "targetAlias": "components",
-          "targetName": "scroll-area.tsx"
-        }
-      ],
-      "meta": "src/components/scroll-area/scroll-area.meta.md",
-      "registryDependencies": ["cn"],
-      "dependencies": {
-        "@radix-ui/react-scroll-area": "^1.2.0"
-      },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-display"
     },
     {
       "id": "table",
@@ -860,7 +852,8 @@
       ],
       "meta": "src/components/table/table.meta.md",
       "registryDependencies": ["cn"],
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-display"
     },
     {
       "id": "data-table",
@@ -879,7 +872,8 @@
       "dependencies": {
         "@tanstack/react-table": "^8.0.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-display"
     },
     {
       "id": "carousel",
@@ -899,66 +893,29 @@
         "embla-carousel-react": "^8.0.0",
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-display"
     },
     {
-      "id": "command",
-      "name": "Command",
+      "id": "resizable",
+      "name": "Resizable",
       "type": "component",
-      "description": "命令面板 — cmdk(Linear / Raycast 风格),全局搜索 / 命令执行;Combobox 的底座",
+      "description": "可拖拽分栏 — react-resizable-panels(VS Code / Figma 风格),横/纵向 + 嵌套 + min/max 限制。等价 antd `Splitter`(v5.21+)",
       "files": [
         {
-          "source": "src/components/command/command.tsx",
+          "source": "src/components/resizable/resizable.tsx",
           "targetAlias": "components",
-          "targetName": "command.tsx"
+          "targetName": "resizable.tsx"
         }
       ],
-      "meta": "src/components/command/command.meta.md",
-      "registryDependencies": ["cn", "dialog"],
+      "meta": "src/components/resizable/resizable.meta.md",
+      "registryDependencies": ["cn"],
       "dependencies": {
-        "cmdk": "^1.0.0",
+        "react-resizable-panels": "^2.0.0",
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
-    },
-    {
-      "id": "combobox",
-      "name": "Combobox",
-      "type": "component",
-      "description": "可搜索单选下拉 — Command + Popover 复合,等价 antd AutoComplete / Select showSearch",
-      "files": [
-        {
-          "source": "src/components/combobox/combobox.tsx",
-          "targetAlias": "components",
-          "targetName": "combobox.tsx"
-        }
-      ],
-      "meta": "src/components/combobox/combobox.meta.md",
-      "registryDependencies": ["cn", "button", "command", "popover"],
-      "dependencies": {
-        "lucide-react": "^0.460.0"
-      },
-      "updateStrategy": "frozen"
-    },
-    {
-      "id": "resizable",
-      "name": "Resizable",
-      "type": "component",
-      "description": "可拖拽分栏 — react-resizable-panels(VS Code / Figma 风格),横/纵向 + 嵌套 + min/max 限制。等价 antd `Splitter`(v5.21+)",
-      "files": [
-        {
-          "source": "src/components/resizable/resizable.tsx",
-          "targetAlias": "components",
-          "targetName": "resizable.tsx"
-        }
-      ],
-      "meta": "src/components/resizable/resizable.meta.md",
-      "registryDependencies": ["cn"],
-      "dependencies": {
-        "react-resizable-panels": "^2.0.0",
-        "lucide-react": "^0.460.0"
-      },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "layout"
     },
     {
       "id": "typography",
@@ -977,7 +934,8 @@
       "dependencies": {
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "general"
     },
     {
       "id": "statistic",
@@ -996,7 +954,8 @@
       "dependencies": {
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-display"
     },
     {
       "id": "steps",
@@ -1015,7 +974,8 @@
       "dependencies": {
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "navigation"
     },
     {
       "id": "result",
@@ -1034,7 +994,8 @@
       "dependencies": {
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "feedback"
     },
     {
       "id": "empty",
@@ -1053,7 +1014,8 @@
       "dependencies": {
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-display"
     },
     {
       "id": "descriptions",
@@ -1069,13 +1031,14 @@
       ],
       "meta": "src/components/descriptions/descriptions.meta.md",
       "registryDependencies": ["cn"],
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-display"
     },
     {
       "id": "tag",
       "name": "Tag",
       "type": "component",
-      "description": "标签 — antd 独有补足。用户可关闭的关键词标签(分类 / 筛选条件),6 种语义色 + closable(与 Badge 互补)",
+      "description": "标签 — antd ∪ cloud-design 并集。形态(solid/outline/ghost) × 语义色(ADR 0021,5 档) × 多彩分类(9 预设 + 任意 CSS 值) × size × icon × closable,以及 CheckableTag/Group(与 Badge 互补)",
       "files": [
         {
           "source": "src/components/tag/tag.tsx",
@@ -1089,26 +1052,8 @@
         "class-variance-authority": "^0.7.0",
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
-    },
-    {
-      "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"
-      },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-display"
     },
     {
       "id": "upload",
@@ -1127,7 +1072,8 @@
       "dependencies": {
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-entry"
     },
     {
       "id": "tree",
@@ -1146,23 +1092,8 @@
       "dependencies": {
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
-    },
-    {
-      "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", "textarea"],
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-display"
     },
     {
       "id": "transfer",
@@ -1181,13 +1112,14 @@
       "dependencies": {
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-entry"
     },
     {
       "id": "spinner",
       "name": "Spinner",
       "type": "component",
-      "description": "旋转加载指示器 — shadcn 2025-10 新增,等价 antd `Spin`(无遮罩版)。4 档尺寸 + 4 档语义配色,自带 role=status 与 sr-only 读屏文本",
+      "description": "加载指示器 — shadcn 2025-10 新增,等价 antd `Spin` 并集。核心 `Spinner` 是行内 / 局部旋转指示(4 档尺寸 + 4 档语义配色,自带 role=status 与 sr-only 读屏文本);配套 `SpinnerOverlay` 实现包裹子元遮罩形态(可选 tip / blur)。",
       "files": [
         {
           "source": "src/components/spinner/spinner.tsx",
@@ -1201,80 +1133,30 @@
         "class-variance-authority": "^0.7.0",
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
-    },
-    {
-      "id": "kbd",
-      "name": "Kbd",
-      "type": "component",
-      "description": "键位展示 — shadcn 2025-10 新增。语义化 `<kbd>` 元素 + `KbdGroup` 组合容器,用于标注快捷键(⌘K / Ctrl + Enter)",
-      "files": [
-        {
-          "source": "src/components/kbd/kbd.tsx",
-          "targetAlias": "components",
-          "targetName": "kbd.tsx"
-        }
-      ],
-      "meta": "src/components/kbd/kbd.meta.md",
-      "registryDependencies": ["cn"],
-      "dependencies": {
-        "class-variance-authority": "^0.7.0"
-      },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "feedback"
     },
     {
-      "id": "native-select",
-      "name": "NativeSelect",
+      "id": "icon",
+      "name": "Icon",
       "type": "component",
-      "description": "原生 `<select>` 样式封装 — shadcn 2025-10 新增。零 JS 开销,移动端弹起系统 picker,直接参与 form submit。与 Radix Select 互补",
+      "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/native-select/native-select.tsx",
+          "source": "src/components/icon/icon.tsx",
           "targetAlias": "components",
-          "targetName": "native-select.tsx"
+          "targetName": "icon.tsx"
         }
       ],
-      "meta": "src/components/native-select/native-select.meta.md",
+      "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"
-    },
-    {
-      "id": "button-group",
-      "name": "ButtonGroup",
-      "type": "component",
-      "description": "按钮组 — shadcn 2025-10 新增,等价 antd `Space.Compact`(v6 替代旧 Button.Group)。把多个按钮 / 输入框粘在一起共享边线(Split Button / Toolbar / Input + Button 拼装)",
-      "files": [
-        {
-          "source": "src/components/button-group/button-group.tsx",
-          "targetAlias": "components",
-          "targetName": "button-group.tsx"
-        }
-      ],
-      "meta": "src/components/button-group/button-group.meta.md",
-      "registryDependencies": ["cn"],
-      "dependencies": {
-        "class-variance-authority": "^0.7.0"
-      },
-      "updateStrategy": "frozen"
-    },
-    {
-      "id": "input-group",
-      "name": "InputGroup",
-      "type": "component",
-      "description": "输入框 + addon 统一容器 — shadcn 2025-10 新增。复合插槽 InputGroupAddon(图标 / 文本 / 按钮)+ InputGroupInput / InputGroupTextarea,等价 antd Input 的 prefix/suffix/addonBefore/addonAfter 集合",
-      "files": [
-        {
-          "source": "src/components/input-group/input-group.tsx",
-          "targetAlias": "components",
-          "targetName": "input-group.tsx"
-        }
-      ],
-      "meta": "src/components/input-group/input-group.meta.md",
-      "registryDependencies": ["cn"],
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "general"
     },
     {
       "id": "item",
@@ -1293,7 +1175,8 @@
       "dependencies": {
         "class-variance-authority": "^0.7.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-display"
     },
     {
       "id": "field",
@@ -1308,36 +1191,18 @@
         }
       ],
       "meta": "src/components/field/field.meta.md",
-      "registryDependencies": ["cn", "label"],
-      "dependencies": {
-        "class-variance-authority": "^0.7.0"
-      },
-      "updateStrategy": "frozen"
-    },
-    {
-      "id": "space",
-      "name": "Space",
-      "type": "component",
-      "description": "间距容器 — antd 独有补足。等价 antd `Space`,把同语义并排子项统一间距 / 对齐 / 换行,可选 split(常用 Separator)。与 Flex 互补:Space 偏 inline 小集合",
-      "files": [
-        {
-          "source": "src/components/space/space.tsx",
-          "targetAlias": "components",
-          "targetName": "space.tsx"
-        }
-      ],
-      "meta": "src/components/space/space.meta.md",
-      "registryDependencies": ["cn"],
+      "registryDependencies": ["cn", "label", "use-breakpoint"],
       "dependencies": {
         "class-variance-authority": "^0.7.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-entry"
     },
     {
       "id": "flex",
       "name": "Flex",
       "type": "component",
-      "description": "Flex 布局容器 — antd 独有补足。等价 antd `Flex`(v5.10+),把 Tailwind flex 的常用配置(对齐 / 间距 / 换行 / 方向 / 渲染元素)收敛为枚举",
+      "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",
@@ -1347,7 +1212,8 @@
       ],
       "meta": "src/components/flex/flex.meta.md",
       "registryDependencies": ["cn"],
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "layout"
     },
     {
       "id": "grid",
@@ -1363,26 +1229,8 @@
       ],
       "meta": "src/components/grid/grid.meta.md",
       "registryDependencies": ["cn"],
-      "updateStrategy": "frozen"
-    },
-    {
-      "id": "segmented",
-      "name": "Segmented",
-      "type": "component",
-      "description": "分段控制器 — antd 独有补足。等价 antd `Segmented`(v5.0+),iOS / macOS 风格紧凑互斥单选(视图切换 / 时间区间 / 主题档)",
-      "files": [
-        {
-          "source": "src/components/segmented/segmented.tsx",
-          "targetAlias": "components",
-          "targetName": "segmented.tsx"
-        }
-      ],
-      "meta": "src/components/segmented/segmented.meta.md",
-      "registryDependencies": ["cn"],
-      "dependencies": {
-        "class-variance-authority": "^0.7.0"
-      },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "layout"
     },
     {
       "id": "rate",
@@ -1401,7 +1249,8 @@
       "dependencies": {
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-entry"
     },
     {
       "id": "timeline",
@@ -1417,7 +1266,8 @@
       ],
       "meta": "src/components/timeline/timeline.meta.md",
       "registryDependencies": ["cn"],
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-display"
     },
     {
       "id": "popconfirm",
@@ -1436,7 +1286,8 @@
       "dependencies": {
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "feedback"
     },
     {
       "id": "input-number",
@@ -1455,13 +1306,14 @@
       "dependencies": {
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-entry"
     },
     {
       "id": "time-picker",
       "name": "TimePicker",
       "type": "component",
-      "description": "时间选择 — antd 独有补足。等价 antd `TimePicker` 基础能力,基于原生 input[type=time] 样式封装(零 JS、移动端友好、SSR safe)",
+      "description": "时间选择 — Popover + 滚动列(TimeColumn)面板,含 TimePicker / TimeRangePicker / TimePickerPanel(对齐 antd TimePicker / TimePicker.RangePicker)",
       "files": [
         {
           "source": "src/components/time-picker/time-picker.tsx",
@@ -1470,11 +1322,12 @@
         }
       ],
       "meta": "src/components/time-picker/time-picker.meta.md",
-      "registryDependencies": ["cn"],
+      "registryDependencies": ["cn", "popover", "button"],
       "dependencies": {
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-entry"
     },
     {
       "id": "auto-complete",
@@ -1489,8 +1342,9 @@
         }
       ],
       "meta": "src/components/auto-complete/auto-complete.meta.md",
-      "registryDependencies": ["cn", "input"],
-      "updateStrategy": "frozen"
+      "registryDependencies": ["cn", "input", "popover", "command"],
+      "updateStrategy": "frozen",
+      "category": "data-entry"
     },
     {
       "id": "cascader",
@@ -1509,7 +1363,8 @@
       "dependencies": {
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-entry"
     },
     {
       "id": "tree-select",
@@ -1528,7 +1383,8 @@
       "dependencies": {
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "data-entry"
     },
     {
       "id": "notification",
@@ -1548,23 +1404,8 @@
         "sonner": "^1.5.0",
         "lucide-react": "^0.460.0"
       },
-      "updateStrategy": "frozen"
-    },
-    {
-      "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"
+      "updateStrategy": "frozen",
+      "category": "feedback"
     },
     {
       "id": "affix",
@@ -1580,94 +1421,460 @@
       ],
       "meta": "src/components/affix/affix.meta.md",
       "registryDependencies": ["cn"],
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "navigation"
     },
     {
-      "id": "anchor",
-      "name": "Anchor",
+      "id": "color-picker",
+      "name": "ColorPicker",
       "type": "component",
-      "description": "锚点导航 — antd 独有补足。等价 antd `Anchor`,长文档 / 详情页侧边目录,点击滚动到 id 节点,滚动时 IntersectionObserver 自动高亮,支持嵌套两层缩进",
+      "description": "颜色选择 — antd 独有补足。等价 antd `ColorPicker`(v5.5+),触发器色块 + Popover 面板(原生 color input + alpha 滑块 + hex 输入 + 预设色板),支持 8 位 hex(含透明度)",
       "files": [
         {
-          "source": "src/components/anchor/anchor.tsx",
+          "source": "src/components/color-picker/color-picker.tsx",
           "targetAlias": "components",
-          "targetName": "anchor.tsx"
+          "targetName": "color-picker.tsx"
         }
       ],
-      "meta": "src/components/anchor/anchor.meta.md",
-      "registryDependencies": ["cn"],
-      "updateStrategy": "frozen"
+      "meta": "src/components/color-picker/color-picker.meta.md",
+      "registryDependencies": ["cn", "input", "popover"],
+      "updateStrategy": "frozen",
+      "category": "data-entry"
     },
     {
-      "id": "float-button",
-      "name": "FloatButton",
+      "id": "watermark",
+      "name": "Watermark",
       "type": "component",
-      "description": "悬浮按钮 — antd 独有补足。等价 antd `FloatButton`(v5.0,替代旧 BackTop)。固定右下角强主张操作,配 FloatButtonGroup 堆叠多个,FloatButtonBackTop 预置回到顶部",
+      "description": "水印 — antd 独有补足。等价 antd `Watermark`(v5.1+),容器内重复平铺的 SVG 文字 / 图片水印(内部敏感页面 / 文档预览 / demo 录屏)。仅前端视觉,不作安全防护",
       "files": [
         {
-          "source": "src/components/float-button/float-button.tsx",
+          "source": "src/components/watermark/watermark.tsx",
           "targetAlias": "components",
-          "targetName": "float-button.tsx"
+          "targetName": "watermark.tsx"
         }
       ],
-      "meta": "src/components/float-button/float-button.meta.md",
+      "meta": "src/components/watermark/watermark.meta.md",
       "registryDependencies": ["cn"],
-      "dependencies": {
-        "lucide-react": "^0.460.0"
-      },
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "feedback"
     },
     {
-      "id": "color-picker",
-      "name": "ColorPicker",
+      "id": "ellipsis",
+      "name": "Ellipsis",
       "type": "component",
-      "description": "颜色选择 — antd 独有补足。等价 antd `ColorPicker`(v5.5+),触发器色块 + Popover 面板(原生 color input + alpha 滑块 + hex 输入 + 预设色板),支持 8 位 hex(含透明度)",
+      "description": "单行/多行文本截断 + 渐变遮罩 + 溢出时自动 hover tooltip — 对齐《Teamix UI 表单设计规范》§八 '截断 + 渐变遮罩 + hover tooltip 三件套'",
       "files": [
         {
-          "source": "src/components/color-picker/color-picker.tsx",
+          "source": "src/components/ellipsis/ellipsis.tsx",
           "targetAlias": "components",
-          "targetName": "color-picker.tsx"
+          "targetName": "ellipsis.tsx"
         }
       ],
-      "meta": "src/components/color-picker/color-picker.meta.md",
-      "registryDependencies": ["cn", "input", "popover"],
-      "updateStrategy": "frozen"
+      "meta": "src/components/ellipsis/ellipsis.meta.md",
+      "registryDependencies": ["cn", "tooltip"],
+      "updateStrategy": "frozen",
+      "category": "data-display"
     },
     {
-      "id": "tour",
-      "name": "Tour",
-      "type": "component",
-      "description": "新手引导 — antd 独有补足。等价 antd `Tour`(v5.0+),多步骤 spotlight + 卡片 + 步进按钮 + 可关闭,业务侧自管首次访问标记",
+      "id": "use-debounce-callback",
+      "name": "useDebounceCallback",
+      "type": "hook",
+      "description": "防抖回调 hook — 返回一个防抖包装后的函数，在指定 delay 毫秒内连续调用只执行最后一次",
       "files": [
         {
-          "source": "src/components/tour/tour.tsx",
-          "targetAlias": "components",
-          "targetName": "tour.tsx"
+          "source": "src/hooks/use-debounce-callback.ts",
+          "targetAlias": "hooks",
+          "targetName": "use-debounce-callback.ts"
         }
       ],
-      "meta": "src/components/tour/tour.meta.md",
-      "registryDependencies": ["cn", "button"],
-      "dependencies": {
-        "lucide-react": "^0.460.0"
-      },
       "updateStrategy": "frozen"
     },
     {
-      "id": "watermark",
-      "name": "Watermark",
-      "type": "component",
-      "description": "水印 — antd 独有补足。等价 antd `Watermark`(v5.1+),容器内重复平铺的 SVG 文字 / 图片水印(内部敏感页面 / 文档预览 / demo 录屏)。仅前端视觉,不作安全防护",
+      "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/components/watermark/watermark.tsx",
-          "targetAlias": "components",
-          "targetName": "watermark.tsx"
+          "source": "src/hooks/use-breakpoint.ts",
+          "targetAlias": "hooks",
+          "targetName": "use-breakpoint.ts"
         }
       ],
-      "meta": "src/components/watermark/watermark.meta.md",
-      "registryDependencies": ["cn"],
       "updateStrategy": "frozen"
     },
+    {
+      "id": "filter-bar",
+      "name": "FilterBar",
+      "type": "component",
+      "description": "筛选栏 — 面向 Table/List 的筛选表单变体，支持行内实时筛选 + 可折叠高级面板栅格。混合式架构：复合子组件(FilterBar/FilterBarSearch/FilterBarTrigger/FilterBarPanel/FilterBarActions) + FilterBarPreset 开箱即用",
+      "files": [
+        {
+          "source": "src/components/filter-bar/filter-bar.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"
+      ],
+      "dependencies": {
+        "lucide-react": "^0.460.0",
+        "class-variance-authority": "^0.7.0",
+        "@radix-ui/react-collapsible": "^1.1.0"
+      },
+      "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",
+      "type": "component",
+      "description": "二元状态按钮 — Radix Toggle 包装,工具栏图标级开关",
+      "files": [
+        {
+          "source": "src/components/toggle/toggle.tsx",
+          "targetAlias": "components",
+          "targetName": "toggle.tsx"
+        }
+      ],
+      "meta": "src/components/toggle/toggle.meta.md",
+      "registryDependencies": ["cn"],
+      "dependencies": {
+        "@radix-ui/react-toggle": "^1.1.0",
+        "class-variance-authority": "^0.7.0"
+      },
+      "updateStrategy": "frozen",
+      "category": "deprecated"
+    },
+    {
+      "id": "toggle-group",
+      "name": "ToggleGroup",
+      "type": "component",
+      "description": "切换按钮组 — Radix ToggleGroup,type=single|multiple,复用 Toggle variant/size",
+      "files": [
+        {
+          "source": "src/components/toggle-group/toggle-group.tsx",
+          "targetAlias": "components",
+          "targetName": "toggle-group.tsx"
+        }
+      ],
+      "meta": "src/components/toggle-group/toggle-group.meta.md",
+      "registryDependencies": ["cn", "toggle"],
+      "dependencies": {
+        "@radix-ui/react-toggle-group": "^1.1.0",
+        "class-variance-authority": "^0.7.0"
+      },
+      "updateStrategy": "frozen",
+      "status": "deprecated",
+      "deprecatedReason": "单选场景由 RadioGroup variant=\"button\" 替代；多选切换场景由 Checkbox variant=\"button\" 替代",
+      "replacedBy": "radio-group",
+      "category": "deprecated"
+    },
+    {
+      "id": "input-otp",
+      "name": "InputOTP",
+      "type": "component",
+      "description": "OTP 验证码输入 — 基于 input-otp,shadcn-only(短验证码场景:登录、二步验证、PIN)",
+      "files": [
+        {
+          "source": "src/components/input-otp/input-otp.tsx",
+          "targetAlias": "components",
+          "targetName": "input-otp.tsx"
+        }
+      ],
+      "meta": "src/components/input-otp/input-otp.meta.md",
+      "registryDependencies": ["cn"],
+      "dependencies": {
+        "input-otp": "^1.2.0",
+        "lucide-react": "^0.460.0"
+      },
+      "updateStrategy": "frozen",
+      "category": "deprecated"
+    },
+    {
+      "id": "context-menu",
+      "name": "ContextMenu",
+      "type": "component",
+      "description": "右键菜单 — Radix ContextMenu(与 DropdownMenu 形态一致,触发为右键)",
+      "files": [
+        {
+          "source": "src/components/context-menu/context-menu.tsx",
+          "targetAlias": "components",
+          "targetName": "context-menu.tsx"
+        }
+      ],
+      "meta": "src/components/context-menu/context-menu.meta.md",
+      "registryDependencies": ["cn"],
+      "dependencies": {
+        "@radix-ui/react-context-menu": "^2.2.0",
+        "lucide-react": "^0.460.0"
+      },
+      "updateStrategy": "frozen",
+      "category": "deprecated"
+    },
+    {
+      "id": "menubar",
+      "name": "Menubar",
+      "type": "component",
+      "description": "应用顶部菜单栏 — Radix Menubar(macOS 风格:文件/编辑/视图/帮助)",
+      "files": [
+        {
+          "source": "src/components/menubar/menubar.tsx",
+          "targetAlias": "components",
+          "targetName": "menubar.tsx"
+        }
+      ],
+      "meta": "src/components/menubar/menubar.meta.md",
+      "registryDependencies": ["cn"],
+      "dependencies": {
+        "@radix-ui/react-menubar": "^1.1.0",
+        "lucide-react": "^0.460.0"
+      },
+      "updateStrategy": "frozen",
+      "category": "deprecated"
+    },
+    {
+      "id": "navigation-menu",
+      "name": "NavigationMenu",
+      "type": "component",
+      "description": "网站主导航 — Radix NavigationMenu(支持富 Content 面板)",
+      "files": [
+        {
+          "source": "src/components/navigation-menu/navigation-menu.tsx",
+          "targetAlias": "components",
+          "targetName": "navigation-menu.tsx"
+        }
+      ],
+      "meta": "src/components/navigation-menu/navigation-menu.meta.md",
+      "registryDependencies": ["cn"],
+      "dependencies": {
+        "@radix-ui/react-navigation-menu": "^1.2.0",
+        "class-variance-authority": "^0.7.0",
+        "lucide-react": "^0.460.0"
+      },
+      "updateStrategy": "frozen",
+      "category": "deprecated"
+    },
+    {
+      "id": "scroll-area",
+      "name": "ScrollArea",
+      "type": "component",
+      "description": "自定义滚动容器 — Radix ScrollArea(跨浏览器一致的滚动条,触屏友好,自动隐藏 thumb)",
+      "files": [
+        {
+          "source": "src/components/scroll-area/scroll-area.tsx",
+          "targetAlias": "components",
+          "targetName": "scroll-area.tsx"
+        }
+      ],
+      "meta": "src/components/scroll-area/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"
+      },
+      "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"
+    },
+    {
+      "id": "kbd",
+      "name": "Kbd",
+      "type": "component",
+      "description": "键位展示 — shadcn 2025-10 新增。语义化 `<kbd>` 元素 + `KbdGroup` 组合容器,用于标注快捷键(⌘K / Ctrl + Enter)",
+      "files": [
+        {
+          "source": "src/components/kbd/kbd.tsx",
+          "targetAlias": "components",
+          "targetName": "kbd.tsx"
+        }
+      ],
+      "meta": "src/components/kbd/kbd.meta.md",
+      "registryDependencies": ["cn"],
+      "dependencies": {
+        "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"
+    },
+    {
+      "id": "segmented",
+      "name": "Segmented",
+      "type": "component",
+      "description": "分段控制器 — antd 独有补足。等价 antd `Segmented`(v5.0+),iOS / macOS 风格紧凑互斥单选(视图切换 / 时间区间 / 主题档)",
+      "files": [
+        {
+          "source": "src/components/segmented/segmented.tsx",
+          "targetAlias": "components",
+          "targetName": "segmented.tsx"
+        }
+      ],
+      "meta": "src/components/segmented/segmented.meta.md",
+      "registryDependencies": ["cn"],
+      "dependencies": {
+        "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",
@@ -1682,7 +1889,8 @@
       ],
       "meta": "src/components/masonry/masonry.meta.md",
       "registryDependencies": ["cn"],
-      "updateStrategy": "frozen"
+      "updateStrategy": "frozen",
+      "category": "deprecated"
     }
   ]
 }