@teamix-evo/ui 0.1.1 → 0.2.0

package/src/components/collapsible/collapsible.meta.md

@@ -4,10 +4,11 @@ name: Collapsible
 type: component
 category: navigation
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
+displayName: 折叠面板
 ---
 
-# Collapsible
+# Collapsible 折叠面板
 
 单区域展开收起 — Radix Collapsible 薄包装。**shadcn-only**(antd Collapse 单 item 也可以模拟,但语义粗糙)。
 
@@ -27,7 +28,9 @@ package: "@teamix-evo/ui"
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成。`Collapsible` 是 `CollapsibleRoot` 别名,接受 Radix 的 `open / defaultOpen / onOpenChange / disabled`。
 
 <!-- auto:props:begin -->
+
 _(组件无 `<Name>Props` interface — props 详见 [`collapsible.tsx`](./collapsible.tsx))_
+
 <!-- auto:props:end -->
 
 ## 依赖
@@ -35,6 +38,7 @@ _(组件无 `<Name>Props` interface — props 详见 [`collapsible.tsx`](./colla
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成,数据源是 [`manifest.json`](../../../manifest.json)。**手工编辑 marker 之间的内容会在下次生成时被覆盖**。
 
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 _无 — 本组件不依赖其他 ui entry。_
@@ -46,6 +50,7 @@ _无 — 本组件不依赖其他 ui entry。_
 ```bash
 pnpm add @radix-ui/react-collapsible@^1.1.0
 ```
+
 <!-- auto:deps:end -->
 
 > 子组件:`Collapsible` / `CollapsibleTrigger`(触发器)/ `CollapsibleContent`(可折叠内容)。
@@ -60,7 +65,9 @@ pnpm add @radix-ui/react-collapsible@^1.1.0
 
 ```tsx
 import {
-  Collapsible, CollapsibleTrigger, CollapsibleContent,
+  Collapsible,
+  CollapsibleTrigger,
+  CollapsibleContent,
 } from '@/components/ui/collapsible';
 import { Button } from '@/components/ui/button';
 import { ChevronsUpDown } from 'lucide-react';
@@ -76,5 +83,5 @@ import { ChevronsUpDown } from 'lucide-react';
     <p className="text-sm text-muted-foreground">高级配置 1</p>
     <p className="text-sm text-muted-foreground">高级配置 2</p>
   </CollapsibleContent>
-</Collapsible>
+</Collapsible>;
 ```

package/src/components/collapsible/collapsible.stories.tsx

@@ -11,6 +11,14 @@ const meta: Meta<typeof Collapsible> = {
   title: '导航 · Navigation/Collapsible',
   component: Collapsible,
   tags: ['autodocs'],
+  parameters: {
+    docs: {
+      description: {
+        component:
+          '折叠面板 — 单区域展开收起，常用于“查看更多 / 收起”、表单高级选项开关等场景。Radix Collapsible 实现，shadcn 专有（antd Collapse 单 item 可模拟但语义粗糙）。',
+      },
+    },
+  },
 };
 
 export default meta;

package/src/components/color-picker/color-picker.meta.md

@@ -1,13 +1,14 @@
 ---
 id: color-picker
 name: ColorPicker
+displayName: 颜色选择
 type: component
 category: form
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
 ---
 
-# ColorPicker
+# ColorPicker 颜色选择
 
 颜色选择 — antd 独有补足。**等价 antd `ColorPicker`**(v5.5+)。基于原生 `<input type="color">` + alpha 滑块 + hex 文本输入 + 预设色块,提供"触发器(色块)→ 弹出面板"的标准交互。可选透明度(8 位 hex)。
 
@@ -24,38 +25,46 @@ package: "@teamix-evo/ui"
 - 渐变 / 多色阶 → 当前不支持,需配合第三方 picker
 - HSL / RGB 各通道独立调节 → 当前仅 hex + alpha,复杂场景建议引入专业 picker
 
+## Props
+
 <!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `value` | `string` | – | – | 受控值 — `#RRGGBB` 或 `#RRGGBBAA`(开 `allowAlpha` 时)。 |
-| `defaultValue` | `string` | `"#000000"` | – | uncontrolled 初值。 |
-| `onChange` | `(value: string) => void` | – | – | 值变化回调。 |
-| `allowAlpha` | `boolean` | `false` | – | 是否允许透明度(antd `format=hex8` 类似行为) — 启用后展示 alpha 滑块,value 变为 8 位 hex。 |
-| `presets` | `string[]` | – | – | 预设色块(antd `presets` 并集) — 一组常用颜色快捷选择。 |
-| `disabled` | `boolean` | – | – | 整体禁用。 |
-| `size` | `'sm' \| 'default' \| 'lg'` | `"default"` | – | 触发器尺寸。 |
-| `className` | `string` | – | – | 触发器 className。 |
+
+| 名称           | 类型                        | 默认值      | 必填 | 说明                                                                                      |
+| -------------- | --------------------------- | ----------- | ---- | ----------------------------------------------------------------------------------------- |
+| `value`        | `string`                    | –           | –    | 受控值 — `#RRGGBB` 或 `#RRGGBBAA`(开 `allowAlpha` 时)。                                   |
+| `defaultValue` | `string`                    | `"#000000"` | –    | uncontrolled 初值。                                                                       |
+| `onChange`     | `(value: string) => void`   | –           | –    | 值变化回调。                                                                              |
+| `allowAlpha`   | `boolean`                   | `false`     | –    | 是否允许透明度(antd `format=hex8` 类似行为) — 启用后展示 alpha 滑块,value 变为 8 位 hex。 |
+| `presets`      | `string[]`                  | –           | –    | 预设色块(antd `presets` 并集) — 一组常用颜色快捷选择。                                    |
+| `disabled`     | `boolean`                   | –           | –    | 整体禁用。                                                                                |
+| `size`         | `'sm' \| 'default' \| 'lg'` | `"default"` | –    | 触发器尺寸。                                                                              |
+| `className`    | `string`                    | –           | –    | 触发器 className。                                                                        |
+
 <!-- auto:props:end -->
 
+## 依赖
+
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add color-picker` 时,以下 entry 会被自动连带安装(无需手动 add)。
 
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
-| `input` | component | 文本输入 — shadcn 简洁基底 + antd prefix/suffix/clearable/showCount/addonBefore/addonAfter/size |
-| `popover` | component | 可交互浮层 — Radix Popover + antd arrow 并集 |
+| Entry     | 类型      | 描述                                                                                            |
+| --------- | --------- | ----------------------------------------------------------------------------------------------- |
+| `cn`      | util      | Tailwind className 合并工具(clsx + tailwind-merge)                                              |
+| `input`   | component | 文本输入 — shadcn 简洁基底 + antd prefix/suffix/clearable/showCount/addonBefore/addonAfter/size |
+| `popover` | component | 可交互浮层 — Radix Popover + antd arrow 并集                                                    |
 
 ### npm 依赖
 
 _无 — 本组件不依赖任何 npm 包。_
+
 <!-- auto:deps:end -->
 
 ## AI 生成纪律
 
-- **value 必须是 `#RRGGBB`(6位)或 `#RRGGBBAA`(8位 + 透明度)** — 不接受 `rgb()` / `hsl()` / 命名色
+- **value 必须是 `#RRGGBB`(6 位)或 `#RRGGBBAA`(8 位 + 透明度)** — 不接受 `rgb()` / `hsl()` / 命名色
 - **`allowAlpha=true`** 时 value 自动变为 8 位 hex;关闭时即使有 alpha 也会被截断到 6 位
 - **`presets`** 应是品牌色板而非随手凑数 — 6-12 个 stable 颜色为佳,避免视觉混乱
 - **`disabled`** 是只读语义 — 配 value 展示当前选中色;**不要**用做"暂时锁定"等业务态(用 form-level 控制)

package/src/components/color-picker/color-picker.stories.tsx

@@ -10,7 +10,7 @@ const meta: Meta<typeof ColorPicker> = {
     docs: {
       description: {
         component:
-          '颜色选择 — 触发器色块 → Popover 面板(原生 color input + alpha + hex 输入 + 预设色板)。可选 8 位 hex(含透明度)。等价 antd `ColorPicker`(v5.5+)。视觉走 OpenTrek tokens,所有样式来自 `@teamix-evo/design`,无 mock。',
+          '颜色选择 — 触发器色块 → Popover 面板（原生 color input + alpha + hex 输入 + 预设色板）。可选 8 位 hex（含透明度）。等价 antd `ColorPicker`（v5.5+）。',
       },
     },
   },

package/src/components/color-picker/color-picker.tsx

@@ -48,6 +48,7 @@ const ColorPicker = React.forwardRef<HTMLButtonElement, ColorPickerProps>(
   (
     {
       value,
+      // eslint-disable-next-line teamix-evo/no-color-literal -- ColorPicker default value is a hex literal by API contract (antd parity); not a styling decision.
       defaultValue = '#000000',
       onChange,
       allowAlpha = false,

package/src/components/combobox/combobox.meta.md

@@ -4,10 +4,11 @@ name: Combobox
 type: component
 category: form
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
+displayName: 组合框
 ---
 
-# Combobox
+# Combobox 组合框
 
 可搜索单选下拉 — `Command + Popover` 复合,等价 antd `AutoComplete` / `Select showSearch` 的核心场景。
 **单选**(刻意不做多选,保持语义简单);多选请直接用 `Command` + 自管 selected 数组。
@@ -23,31 +24,38 @@ package: "@teamix-evo/ui"
 - 多选 → `Command` 自定义,或 `CheckboxGroup`
 - 自由文本输入 → `Input` + 自定义 suggestion(超出本组件范围)
 
+## Props
+
 <!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `options` | `ComboboxOption[]` | – | ✓ | 选项列表(antd `AutoComplete.options` 并集)。 |
-| `value` | `string` | – | – | 受控 value(单选)。 |
-| `onChange` | `(value: string) => void` | – | – | value 变化回调。 |
-| `placeholder` | `string` | `"请选择..."` | – | 触发器占位文本(未选)。 |
-| `searchPlaceholder` | `string` | `"搜索..."` | – | 搜索框占位文本。 |
-| `emptyText` | `string` | `"无匹配项"` | – | 无匹配时的提示文本。 |
-| `className` | `string` | `"w-[200px]"` | – | 触发器宽度。 |
-| `disabled` | `boolean` | – | – | 是否禁用。 |
-| `size` | `'sm' \| 'default' \| 'lg'` | `"default"` | – | 触发器尺寸。 |
+
+| 名称                | 类型                        | 默认值        | 必填 | 说明                                         |
+| ------------------- | --------------------------- | ------------- | ---- | -------------------------------------------- |
+| `options`           | `ComboboxOption[]`          | –             | ✓    | 选项列表(antd `AutoComplete.options` 并集)。 |
+| `value`             | `string`                    | –             | –    | 受控 value(单选)。                           |
+| `onChange`          | `(value: string) => void`   | –             | –    | value 变化回调。                             |
+| `placeholder`       | `string`                    | `"请选择..."` | –    | 触发器占位文本(未选)。                       |
+| `searchPlaceholder` | `string`                    | `"搜索..."`   | –    | 搜索框占位文本。                             |
+| `emptyText`         | `string`                    | `"无匹配项"`  | –    | 无匹配时的提示文本。                         |
+| `className`         | `string`                    | `"w-[200px]"` | –    | 触发器宽度。                                 |
+| `disabled`          | `boolean`                   | –             | –    | 是否禁用。                                   |
+| `size`              | `'sm' \| 'default' \| 'lg'` | `"default"`   | –    | 触发器尺寸。                                 |
+
 <!-- auto:props:end -->
 
+## 依赖
+
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add combobox` 时,以下 entry 会被自动连带安装(无需手动 add)。
 
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
-| `button` | component | 通用按钮 — shadcn 实现 + antd 功能扩展(loading / icon / shape / block / dashed variant) |
-| `command` | component | 命令面板 — cmdk(Linear / Raycast 风格),全局搜索 / 命令执行;Combobox 的底座 |
-| `popover` | component | 可交互浮层 — Radix Popover + antd arrow 并集 |
+| Entry     | 类型      | 描述                                                                                    |
+| --------- | --------- | --------------------------------------------------------------------------------------- |
+| `cn`      | util      | Tailwind className 合并工具(clsx + tailwind-merge)                                      |
+| `button`  | component | 通用按钮 — shadcn 实现 + antd 功能扩展(loading / icon / shape / block / dashed variant) |
+| `command` | component | 命令面板 — cmdk(Linear / Raycast 风格),全局搜索 / 命令执行;Combobox 的底座              |
+| `popover` | component | 可交互浮层 — Radix Popover + antd arrow 并集                                            |
 
 ### npm 依赖
 
@@ -56,6 +64,7 @@ package: "@teamix-evo/ui"
 ```bash
 pnpm add lucide-react@^0.460.0
 ```
+
 <!-- auto:deps:end -->
 
 > 选项类型 `ComboboxOption`:`{ value: string; label: ReactNode; disabled?: boolean }`。
@@ -89,5 +98,5 @@ const [v, setV] = React.useState('');
   onChange={setV}
   placeholder="选择框架"
   searchPlaceholder="搜索框架..."
-/>
+/>;
 ```

package/src/components/combobox/combobox.stories.tsx

@@ -10,7 +10,7 @@ const meta: Meta<typeof Combobox> = {
     docs: {
       description: {
         component:
-          '可搜索单选下拉 — Command + Popover 复合,对标 antd AutoComplete / Select showSearch。键盘可达、模糊搜索、空态、再次选中清空,适合选项数 > 7 的单选场景。OpenTrek tokens 适配。',
+          '可搜索单选下拉 — Command + Popover 复合，对标 antd AutoComplete / Select showSearch。键盘可达、模糊搜索、空态、再次选中清空，适合选项数 > 7 的单选场景。',
       },
     },
   },

package/src/components/combobox/combobox.tsx

@@ -39,7 +39,7 @@ export interface ComboboxProps {
   searchPlaceholder?: string;
   /** 无匹配时的提示文本。 @default "无匹配项" */
   emptyText?: string;
-  /** 触发器宽度。 @default "w-[200px]" */
+  /** 触发器宽度。 @default "w-panel-sm" */
   className?: string;
   /** 是否禁用。 */
   disabled?: boolean;
@@ -83,7 +83,7 @@ const Combobox = React.forwardRef<HTMLButtonElement, ComboboxProps>(
             role="combobox"
             aria-expanded={open}
             className={cn(
-              'w-[200px] justify-between font-normal',
+              'w-panel-sm justify-between font-normal',
               !value && 'text-muted-foreground',
               className,
             )}
@@ -92,7 +92,7 @@ const Combobox = React.forwardRef<HTMLButtonElement, ComboboxProps>(
             <ChevronsUpDown className="ml-2 size-4 shrink-0 opacity-50" />
           </Button>
         </PopoverTrigger>
-        <PopoverContent className="w-[200px] p-0">
+        <PopoverContent className="w-panel-sm p-0">
           <Command>
             <CommandInput placeholder={searchPlaceholder} />
             <CommandList>

package/src/components/command/command.meta.md

@@ -4,10 +4,11 @@ name: Command
 type: component
 category: shell
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
+displayName: 命令面板
 ---
 
-# Command
+# Command 命令面板
 
 命令面板 — 基于 [`cmdk`](https://cmdk.paco.me/),提供"按 ⌘K 打开"的全局搜索 / 命令执行体验(Linear / Raycast / Vercel 风格)。
 **shadcn-only**(antd 无对标)。是 `Combobox` 的底座(Combobox = Command + Popover)。
@@ -26,18 +27,25 @@ package: "@teamix-evo/ui"
 - 静态菜单 → `DropdownMenu`
 - 需要表单语义 → `Combobox`(基于本组件)
 
+## Props
+
 <!-- auto:props:begin -->
+
 _(no props)_
+
 <!-- auto:props:end -->
 
+## 依赖
+
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add command` 时,以下 entry 会被自动连带安装(无需手动 add)。
 
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
+| Entry    | 类型      | 描述                                                                                |
+| -------- | --------- | ----------------------------------------------------------------------------------- |
+| `cn`     | util      | Tailwind className 合并工具(clsx + tailwind-merge)                                  |
 | `dialog` | component | 模态对话框 — Radix Dialog + antd Modal 并集(组合式 Header/Footer/Title/Description) |
 
 ### npm 依赖
@@ -47,6 +55,7 @@ _(no props)_
 ```bash
 pnpm add cmdk@^1.0.0 lucide-react@^0.460.0
 ```
+
 <!-- auto:deps:end -->
 
 > 子组件:`Command`(Root 容器)/ `CommandDialog`(模态版,内部组合 Dialog)/ `CommandInput`(自带搜索图标)/ `CommandList`(可滚动列表)/ `CommandEmpty`(无匹配空态)/ `CommandGroup`(分组,带 heading)/ `CommandItem`(选项,支持 `onSelect`)/ `CommandSeparator` / `CommandShortcut`(右对齐快捷键)。
@@ -63,8 +72,13 @@ pnpm add cmdk@^1.0.0 lucide-react@^0.460.0
 
 ```tsx
 import {
-  Command, CommandInput, CommandList, CommandEmpty,
-  CommandGroup, CommandItem, CommandShortcut,
+  Command,
+  CommandInput,
+  CommandList,
+  CommandEmpty,
+  CommandGroup,
+  CommandItem,
+  CommandShortcut,
 } from '@/components/ui/command';
 import { Calendar, Mail, User } from 'lucide-react';
 
@@ -74,14 +88,20 @@ import { Calendar, Mail, User } from 'lucide-react';
   <CommandList>
     <CommandEmpty>无结果。</CommandEmpty>
     <CommandGroup heading="建议">
-      <CommandItem><Calendar /> 日历 <CommandShortcut>⌘K</CommandShortcut></CommandItem>
-      <CommandItem><Mail /> 邮件</CommandItem>
+      <CommandItem>
+        <Calendar /> 日历 <CommandShortcut>⌘K</CommandShortcut>
+      </CommandItem>
+      <CommandItem>
+        <Mail /> 邮件
+      </CommandItem>
     </CommandGroup>
     <CommandGroup heading="设置">
-      <CommandItem><User /> 个人资料</CommandItem>
+      <CommandItem>
+        <User /> 个人资料
+      </CommandItem>
     </CommandGroup>
   </CommandList>
-</Command>
+</Command>;
 
 // 模态(全局 ⌘K)
 import { CommandDialog } from '@/components/ui/command';
@@ -100,5 +120,5 @@ React.useEffect(() => {
 <CommandDialog open={open} onOpenChange={setOpen}>
   <CommandInput placeholder="..." />
   <CommandList>...</CommandList>
-</CommandDialog>
+</CommandDialog>;
 ```

package/src/components/command/command.stories.tsx

@@ -19,7 +19,7 @@ const meta: Meta<typeof Command> = {
     docs: {
       description: {
         component:
-          '命令面板 — 全局搜索 / 命令执行(Linear / Raycast / Vercel 风格)。基于 cmdk,提供键盘导航、模糊搜索、分组、空态、快捷键提示;模态版用 CommandDialog 监听 ⌘K 全局触发。OpenTrek tokens 适配,无 mock。',
+          '命令面板 — 全局搜索 / 命令执行（Linear / Raycast / Vercel 风格）。基于 cmdk，提供键盘导航、模糊搜索、分组、空态、快捷键提示；模态版用 CommandDialog 监听 ⌘K 全局触发。',
       },
     },
   },

package/src/components/command/command.tsx

@@ -60,7 +60,7 @@ const CommandList = React.forwardRef<
 >(({ className, ...props }, ref) => (
   <CommandPrimitive.List
     ref={ref}
-    className={cn('max-h-[300px] overflow-y-auto overflow-x-hidden', className)}
+    className={cn('max-h-listbox overflow-y-auto overflow-x-hidden', className)}
     {...props}
   />
 ));

package/src/components/context-menu/context-menu.meta.md

@@ -4,10 +4,11 @@ name: ContextMenu
 type: component
 category: navigation
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
+displayName: 右键菜单
 ---
 
-# ContextMenu
+# ContextMenu 右键菜单
 
 右键菜单 — Radix ContextMenu 完整实现。**与 DropdownMenu 形态一致**(Item / CheckboxItem / RadioItem / Sub / Label / Separator / Shortcut),仅触发方式不同(右键 vs click)。
 shadcn 显式版,antd 用 Dropdown 模拟同样可达。
@@ -29,7 +30,25 @@ shadcn 显式版,antd 用 Dropdown 模拟同样可达。
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成。下表是 `ContextMenuContent` 的 props。
 
 <!-- auto:props:begin -->
-_(组件无 `<Name>Props` interface — props 详见 [`context-menu.tsx`](./context-menu.tsx))_
+
+#### ContextMenuSubTrigger
+
+| 名称    | 类型      | 默认值  | 必填 | 说明                                        |
+| ------- | --------- | ------- | ---- | ------------------------------------------- |
+| `inset` | `boolean` | `false` | –    | 左侧留出 icon 宽度的缩进,对齐同级 icon 项。 |
+
+#### ContextMenuItem
+
+| 名称    | 类型      | 默认值  | 必填 | 说明                                        |
+| ------- | --------- | ------- | ---- | ------------------------------------------- |
+| `inset` | `boolean` | `false` | –    | 左侧留出 icon 宽度的缩进,对齐同级 icon 项。 |
+
+#### ContextMenuLabel
+
+| 名称    | 类型      | 默认值  | 必填 | 说明                                        |
+| ------- | --------- | ------- | ---- | ------------------------------------------- |
+| `inset` | `boolean` | `false` | –    | 左侧留出 icon 宽度的缩进,对齐同级 icon 项。 |
+
 <!-- auto:props:end -->
 
 ## 依赖
@@ -37,13 +56,14 @@ _(组件无 `<Name>Props` interface — props 详见 [`context-menu.tsx`](./cont
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成,数据源是 [`manifest.json`](../../../manifest.json)。**手工编辑 marker 之间的内容会在下次生成时被覆盖**。
 
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add context-menu` 时,以下 entry 会被自动连带安装(无需手动 add)。
 
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
+| Entry | 类型 | 描述                                               |
+| ----- | ---- | -------------------------------------------------- |
+| `cn`  | util | Tailwind className 合并工具(clsx + tailwind-merge) |
 
 ### npm 依赖
 
@@ -52,9 +72,8 @@ _(组件无 `<Name>Props` interface — props 详见 [`context-menu.tsx`](./cont
 ```bash
 pnpm add @radix-ui/react-context-menu@^2.2.0 lucide-react@^0.460.0
 ```
-<!-- auto:deps:end -->
 
-> 子组件与 DropdownMenu 完全一致(只差名称前缀):`ContextMenu / Trigger / Content / Item / CheckboxItem / RadioItem / Label / Separator / Shortcut / Sub / SubTrigger / SubContent / Group / RadioGroup / Portal`。
+<!-- auto:deps:end -->
 
 ## AI 生成纪律
 
@@ -67,8 +86,12 @@ pnpm add @radix-ui/react-context-menu@^2.2.0 lucide-react@^0.460.0
 
 ```tsx
 import {
-  ContextMenu, ContextMenuTrigger, ContextMenuContent,
-  ContextMenuItem, ContextMenuSeparator, ContextMenuShortcut,
+  ContextMenu,
+  ContextMenuTrigger,
+  ContextMenuContent,
+  ContextMenuItem,
+  ContextMenuSeparator,
+  ContextMenuShortcut,
 } from '@/components/ui/context-menu';
 
 <ContextMenu>
@@ -86,5 +109,5 @@ import {
       删除 <ContextMenuShortcut>⌫</ContextMenuShortcut>
     </ContextMenuItem>
   </ContextMenuContent>
-</ContextMenu>
+</ContextMenu>;
 ```

package/src/components/context-menu/context-menu.stories.tsx

@@ -12,6 +12,14 @@ const meta: Meta<typeof ContextMenuContent> = {
   title: '导航 · Navigation/ContextMenu',
   component: ContextMenuContent,
   tags: ['autodocs'],
+  parameters: {
+    docs: {
+      description: {
+        component:
+          '右键菜单 — 右键触发的操作菜单，与 DropdownMenu 形态一致（Item / CheckboxItem / RadioItem / Sub），仅触发方式不同。Radix ContextMenu 实现，shadcn 显式版，antd 用 Dropdown 模拟同样可达。',
+      },
+    },
+  },
 };
 
 export default meta;

package/src/components/context-menu/context-menu.tsx

@@ -39,7 +39,7 @@ const ContextMenuSubContent = React.forwardRef<
   <ContextMenuPrimitive.SubContent
     ref={ref}
     className={cn(
-      'z-50 min-w-[8rem] overflow-hidden rounded-md border bg-popover p-1 text-popover-foreground shadow-lg data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95',
+      'z-50 min-w-menu overflow-hidden rounded-md border bg-popover p-1 text-popover-foreground shadow-lg data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95',
       className,
     )}
     {...props}
@@ -55,7 +55,7 @@ const ContextMenuContent = React.forwardRef<
     <ContextMenuPrimitive.Content
       ref={ref}
       className={cn(
-        'z-50 min-w-[8rem] overflow-hidden rounded-md border bg-popover p-1 text-popover-foreground shadow-md animate-in fade-in-80 data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95',
+        'z-50 min-w-menu overflow-hidden rounded-md border bg-popover p-1 text-popover-foreground shadow-md animate-in fade-in-80 data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95',
         className,
       )}
       {...props}

package/src/components/data-table/data-table.meta.md

@@ -1,13 +1,14 @@
 ---
 id: data-table
 name: DataTable
+displayName: 数据表格
 type: component
 category: data-display
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
 ---
 
-# DataTable
+# DataTable 数据表格
 
 数据表 — 基于 [`@tanstack/react-table`](https://tanstack.com/table) + 基础 `Table` primitives + `SimplePagination`。
 **等价 antd `Table` 的核心交互合集**:`sorter` + `filter` + `pagination` + `rowSelection`,声明式 `columns + data` 即可。
@@ -29,16 +30,18 @@ package: "@teamix-evo/ui"
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成。
 
 <!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `columns` | `ColumnDef<TData, TValue>[]` | – | ✓ | 列定义(TanStack ColumnDef)。 |
-| `data` | `TData[]` | – | ✓ | 行数据。 |
-| `pagination` | `boolean \| { pageSize?: number; siblingCount?: number }` | `true` | – | 是否启用分页(antd `pagination` 并集)。 传 `true` 用默认配置;传对象自定义 pageSize / siblingCount。 |
-| `sorting` | `boolean` | `true` | – | 是否启用排序(列定义里的 `enableSorting` 也要打开;默认列已开)。 |
-| `filtering` | `boolean` | `true` | – | 是否启用列过滤(每列 `header` 配 input 单独使用;此 flag 控制 columnFilters 状态)。 |
-| `onRowSelectionChange` | `(selectedRows: TData[]) => void` | – | – | 行选择回调(antd `rowSelection.onChange` 并集)。传入即启用 selection。 Selected rows 的原始 data 通过 `getRowId(row)` 推断,默认是 row.index。 |
-| `emptyText` | `React.ReactNode` | – | – | 空数据时显示的内容。 |
-| `className` | `string` | – | – | 容器 className。 |
+
+| 名称                   | 类型                                                      | 默认值 | 必填 | 说明                                                                                                                                         |
+| ---------------------- | --------------------------------------------------------- | ------ | ---- | -------------------------------------------------------------------------------------------------------------------------------------------- |
+| `columns`              | `ColumnDef<TData, TValue>[]`                              | –      | ✓    | 列定义(TanStack ColumnDef)。                                                                                                                 |
+| `data`                 | `TData[]`                                                 | –      | ✓    | 行数据。                                                                                                                                     |
+| `pagination`           | `boolean \| { pageSize?: number; siblingCount?: number }` | `true` | –    | 是否启用分页(antd `pagination` 并集)。 传 `true` 用默认配置;传对象自定义 pageSize / siblingCount。                                           |
+| `sorting`              | `boolean`                                                 | `true` | –    | 是否启用排序(列定义里的 `enableSorting` 也要打开;默认列已开)。                                                                               |
+| `filtering`            | `boolean`                                                 | `true` | –    | 是否启用列过滤(每列 `header` 配 input 单独使用;此 flag 控制 columnFilters 状态)。                                                            |
+| `onRowSelectionChange` | `(selectedRows: TData[]) => void`                         | –      | –    | 行选择回调(antd `rowSelection.onChange` 并集)。传入即启用 selection。 Selected rows 的原始 data 通过 `getRowId(row)` 推断,默认是 row.index。 |
+| `emptyText`            | `React.ReactNode`                                         | –      | –    | 空数据时显示的内容。                                                                                                                         |
+| `className`            | `string`                                                  | –      | –    | 容器 className。                                                                                                                             |
+
 <!-- auto:props:end -->
 
 ## 依赖
@@ -46,14 +49,15 @@ package: "@teamix-evo/ui"
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成,数据源是 [`manifest.json`](../../../manifest.json)。**手工编辑 marker 之间的内容会在下次生成时被覆盖**。
 
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add data-table` 时,以下 entry 会被自动连带安装(无需手动 add)。
 
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
-| `table` | component | 基础表格 — 原生 HTML 元素薄包装(视觉骨架,无交互,交互见 DataTable) |
+| Entry        | 类型      | 描述                                                                                                            |
+| ------------ | --------- | --------------------------------------------------------------------------------------------------------------- |
+| `cn`         | util      | Tailwind className 合并工具(clsx + tailwind-merge)                                                              |
+| `table`      | component | 基础表格 — 原生 HTML 元素薄包装(视觉骨架,无交互,交互见 DataTable)                                               |
 | `pagination` | component | 分页 — shadcn primitives + 高阶 SimplePagination(antd 风格 total/pageSize/current/onChange,自动页码窗口 + 折叠) |
 
 ### npm 依赖
@@ -63,6 +67,7 @@ package: "@teamix-evo/ui"
 ```bash
 pnpm add @tanstack/react-table@^8.0.0
 ```
+
 <!-- auto:deps:end -->
 
 > 透传 TanStack Table 的核心能力。需要更精细控制(可控 state、virtualizer、column visibility / resizing 等),请直接用 `useReactTable` + 基础 `Table` primitives 自行拼装。
@@ -102,8 +107,8 @@ const columns: ColumnDef<User>[] = [
           table.getIsAllPageRowsSelected()
             ? true
             : table.getIsSomePageRowsSelected()
-              ? 'indeterminate'
-              : false
+            ? 'indeterminate'
+            : false
         }
         onCheckedChange={(v) => table.toggleAllPageRowsSelected(!!v)}
       />
@@ -145,5 +150,5 @@ const columns: ColumnDef<User>[] = [
   data={users}
   pagination={{ pageSize: 10 }}
   onRowSelectionChange={(selected) => console.log(selected)}
-/>
+/>;
 ```