@teamix-evo/ui 0.1.1 → 0.2.0

package/src/components/data-table/data-table.stories.tsx

@@ -19,8 +19,7 @@ const data: User[] = Array.from({ length: 35 }).map((_, i) => ({
   name: ['Alice', 'Bob', 'Carol', 'David', 'Eve'][i % 5] + ' ' + (i + 1),
   email: `user${i + 1}@example.com`,
   status:
-    (['active', 'invited', 'disabled'] as const)[i % 3] ??
-    ('active' as const),
+    (['active', 'invited', 'disabled'] as const)[i % 3] ?? ('active' as const),
   amount: Math.round(Math.random() * 1000),
 }));
 
@@ -33,8 +32,8 @@ const columns: ColumnDef<User>[] = [
           table.getIsAllPageRowsSelected()
             ? true
             : table.getIsSomePageRowsSelected()
-              ? 'indeterminate'
-              : false
+            ? 'indeterminate'
+            : false
         }
         onCheckedChange={(v) => table.toggleAllPageRowsSelected(!!v)}
         aria-label="全选"
@@ -99,7 +98,15 @@ const meta: Meta<typeof DataTable<User, unknown>> = {
   title: '数据展示 · Data Display/DataTable',
   component: DataTable,
   tags: ['autodocs'],
-  parameters: { layout: 'fullscreen' },
+  parameters: {
+    layout: 'fullscreen',
+    docs: {
+      description: {
+        component:
+          '数据表 — 基于 TanStack Table + 基础 Table 原语 + SimplePagination。声明式 columns + data 即可实现排序 / 筛选 / 分页 / 多选，等价 antd `Table` 的核心交互合集。',
+      },
+    },
+  },
 };
 
 export default meta;

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

@@ -1,15 +1,17 @@
 ---
 id: date-picker
 name: DatePicker
+displayName: 日期选择
 type: component
 category: form
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
 ---
 
-# DatePicker
+# DatePicker 日期选择
 
 日期选择器 — `Calendar + Popover` 复合,提供两种形态:
+
 - `<DatePicker />` — 单日(对应 antd `DatePicker`)
 - `<DateRangePicker />` — 范围(对应 antd `DatePicker.RangePicker`)
 
@@ -32,16 +34,34 @@ package: "@teamix-evo/ui"
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成。
 
 <!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `value` | `Date` | – | – | 受控值 — 当前选中日期。 |
-| `onChange` | `(value: Date \| undefined) => void` | – | – | 选中日期变化回调。 |
-| `placeholder` | `string` | `"选择日期"` | – | 占位文本(未选时)。 |
-| `format` | `string` | `"yyyy-MM-dd"` | – | date-fns format 字符串。 |
-| `size` | `'sm' \| 'default' \| 'lg'` | – | – | 触发器尺寸。 |
-| `className` | `string` | – | – | 触发器 className(传给底层 Button)。 |
-| `disabled` | `boolean` | – | – | 触发器是否禁用。 |
-| `disabledDates` | `(date: Date) => boolean` | – | – | 不可选日期 predicate(透传到 Calendar `disabled`)。 |
+
+#### DatePicker
+
+| 名称            | 类型                                 | 默认值         | 必填 | 说明                                                 |
+| --------------- | ------------------------------------ | -------------- | ---- | ---------------------------------------------------- |
+| `value`         | `Date`                               | –              | –    | 受控值 — 当前选中日期。                              |
+| `onChange`      | `(value: Date \| undefined) => void` | –              | –    | 选中日期变化回调。                                   |
+| `placeholder`   | `string`                             | `"选择日期"`   | –    | 占位文本（未选时）。                                 |
+| `format`        | `string`                             | `"yyyy-MM-dd"` | –    | date-fns format 字符串。                             |
+| `size`          | `'sm' \| 'default' \| 'lg'`          | –              | –    | 触发器尺寸。                                         |
+| `className`     | `string`                             | –              | –    | 触发器 className（传给底层 Button）。                |
+| `disabled`      | `boolean`                            | –              | –    | 触发器是否禁用。                                     |
+| `disabledDates` | `(date: Date) => boolean`            | –              | –    | 不可选日期 predicate（透传到 Calendar `disabled`）。 |
+
+#### DateRangePicker
+
+| 名称             | 类型                                      | 默认值           | 必填 | 说明                     |
+| ---------------- | ----------------------------------------- | ---------------- | ---- | ------------------------ |
+| `value`          | `DateRange`                               | –                | –    | 受控值 — 当前选中范围。  |
+| `onChange`       | `(value: DateRange \| undefined) => void` | –                | –    | 范围变化回调。           |
+| `placeholder`    | `string`                                  | `"选择日期范围"` | –    | 占位文本。               |
+| `format`         | `string`                                  | `"yyyy-MM-dd"`   | –    | date-fns format 字符串。 |
+| `size`           | `'sm' \| 'default' \| 'lg'`               | –                | –    | 触发器尺寸。             |
+| `className`      | `string`                                  | –                | –    | 触发器 className。       |
+| `disabled`       | `boolean`                                 | –                | –    | 是否禁用。               |
+| `disabledDates`  | `(date: Date) => boolean`                 | –                | –    | 不可选日期 predicate。   |
+| `numberOfMonths` | `number`                                  | `2`              | –    | 同时显示几个月历。       |
+
 <!-- auto:props:end -->
 
 ## 依赖
@@ -49,16 +69,17 @@ package: "@teamix-evo/ui"
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成,数据源是 [`manifest.json`](../../../manifest.json)。**手工编辑 marker 之间的内容会在下次生成时被覆盖**。
 
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add date-picker` 时,以下 entry 会被自动连带安装(无需手动 add)。
 
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
-| `button` | component | 通用按钮 — shadcn 实现 + antd 功能扩展(loading / icon / shape / block / dashed variant) |
-| `calendar` | component | 日期选择面板 — react-day-picker,mode=single|multiple|range,与 design tokens 对齐 |
-| `popover` | component | 可交互浮层 — Radix Popover + antd arrow 并集 |
+| Entry      | 类型      | 描述                                                                                    |
+| ---------- | --------- | --------------------------------------------------------------------------------------- | -------- | --------------------------- |
+| `cn`       | util      | Tailwind className 合并工具(clsx + tailwind-merge)                                      |
+| `button`   | component | 通用按钮 — shadcn 实现 + antd 功能扩展(loading / icon / shape / block / dashed variant) |
+| `calendar` | component | 日期选择面板 — react-day-picker,mode=single                                             | multiple | range,与 design tokens 对齐 |
+| `popover`  | component | 可交互浮层 — Radix Popover + antd arrow 并集                                            |
 
 ### npm 依赖
 
@@ -67,9 +88,8 @@ package: "@teamix-evo/ui"
 ```bash
 pnpm add date-fns@^3.0.0 react-day-picker@^9.0.0 lucide-react@^0.460.0
 ```
-<!-- auto:deps:end -->
 
-> `DateRangePicker` 的 props 详见 [`date-picker.tsx`](./date-picker.tsx) 的 `DateRangePickerProps` interface。
+<!-- auto:deps:end -->
 
 ## AI 生成纪律
 

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

@@ -11,7 +11,7 @@ const meta: Meta<typeof DatePicker> = {
     docs: {
       description: {
         component:
-          '日期选择器 — 输入框式触发器 + 弹层日历的组合，支持单日(`DatePicker`)和范围(`DateRangePicker`)两种模式。Popover + Calendar(react-day-picker v9)封装，日期格式由 `format` 控制(date-fns 语法)，`size` 三档对齐 Input。能力对齐 antd DatePicker，视觉走 OpenTrek semantic tokens，所有样式来自 `@teamix-evo/design`，无 mock。',
+          '日期选择器 — 输入框式触发器 + 弹层日历的组合，支持单日(`DatePicker`)和范围(`DateRangePicker`)两种模式。Popover + Calendar(react-day-picker v9)封装，日期格式由 `format` 控制(date-fns 语法)，`size` 三档对齐 Input。能力对齐 antd DatePicker。',
       },
     },
   },

package/src/components/descriptions/descriptions.meta.md

@@ -1,13 +1,14 @@
 ---
 id: descriptions
 name: Descriptions
+displayName: 描述列表
 type: component
 category: layout
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
 ---
 
-# Descriptions
+# Descriptions 描述列表
 
 描述列表 — antd 独有补足。**键值对详情**(资源详情 / 用户信息 / 配置预览),声明式 `items` 数组驱动,自动布局到等分列。
 
@@ -23,29 +24,37 @@ package: "@teamix-evo/ui"
 - 表格(行 = 同质对象)→ `Table`
 - 富文本 → `Prose`
 
+## Props
+
 <!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `title` | `React.ReactNode` | – | – | 顶部标题。 |
-| `items` | `DescriptionsItem[]` | – | ✓ | 字段列表。 |
-| `column` | `1 \| 2 \| 3 \| 4` | `3` | – | 列数(antd `column` 并集) — 等分。响应式可在容器侧加 className 处理。 |
-| `layout` | `'horizontal' \| 'vertical'` | `"horizontal"` | – | 布局方向。`horizontal`(默认):label 在左,value 在右;`vertical`:label 在上,value 在下。 |
-| `bordered` | `boolean` | `false` | – | 带边框(每项独立单元格)。 |
-| `size` | `'sm' \| 'default'` | `"default"` | – | 尺寸。 |
+
+| 名称       | 类型                         | 默认值         | 必填 | 说明                                                                                  |
+| ---------- | ---------------------------- | -------------- | ---- | ------------------------------------------------------------------------------------- |
+| `title`    | `React.ReactNode`            | –              | –    | 顶部标题。                                                                            |
+| `items`    | `DescriptionsItem[]`         | –              | ✓    | 字段列表。                                                                            |
+| `column`   | `1 \| 2 \| 3 \| 4`           | `3`            | –    | 列数(antd `column` 并集) — 等分。响应式可在容器侧加 className 处理。                  |
+| `layout`   | `'horizontal' \| 'vertical'` | `"horizontal"` | –    | 布局方向。`horizontal`(默认):label 在左,value 在右;`vertical`:label 在上,value 在下。 |
+| `bordered` | `boolean`                    | `false`        | –    | 带边框(每项独立单元格)。                                                              |
+| `size`     | `'sm' \| 'default'`          | `"default"`    | –    | 尺寸。                                                                                |
+
 <!-- auto:props:end -->
 
+## 依赖
+
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add descriptions` 时,以下 entry 会被自动连带安装(无需手动 add)。
 
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
+| Entry | 类型 | 描述                                               |
+| ----- | ---- | -------------------------------------------------- |
+| `cn`  | util | Tailwind className 合并工具(clsx + tailwind-merge) |
 
 ### npm 依赖
 
 _无 — 本组件不依赖任何 npm 包。_
+
 <!-- auto:deps:end -->
 
 > `DescriptionsItem`:`{ label; value; span?: number }`(`span > 1` 让该项跨多列)。
@@ -74,5 +83,5 @@ import { Badge } from '@/components/ui/badge';
     { label: '创建时间', value: '2024-12-01' },
     { label: '描述', value: '中后台运营管理系统', span: 3 },
   ]}
-/>
+/>;
 ```

package/src/components/descriptions/descriptions.stories.tsx

@@ -10,7 +10,7 @@ const meta: Meta<typeof Descriptions> = {
     docs: {
       description: {
         component:
-          '描述列表 — 键值对详情(资源详情 / 用户信息 / 配置预览)。声明式 items 数组驱动,自动布局,支持横/纵布局、bordered、span 跨列。OpenTrek tokens 适配,等价 antd Descriptions。',
+          '描述列表 — 键值对详情（资源详情 / 用户信息 / 配置预览）。声明式 items 数组驱动，自动布局，支持横/纵布局、bordered、span 跨列。等价 antd Descriptions。',
       },
     },
   },

package/src/components/dialog/dialog.meta.md

@@ -1,13 +1,14 @@
 ---
 id: dialog
 name: Dialog
+displayName: 对话框
 type: component
 category: feedback
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
 ---
 
-# Dialog
+# Dialog 对话框
 
 模态对话框 — Radix Dialog + antd Modal 并集。**组合式 API**(shadcn 风格,非 antd 的 props 配置式),通过 `DialogHeader` / `DialogFooter` / `DialogTitle` / `DialogDescription` 子组件灵活组装内容。
 
@@ -32,9 +33,11 @@ package: "@teamix-evo/ui"
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成。下表是 `DialogContent` 的 props;`Dialog`(Root)透传 Radix `open / defaultOpen / onOpenChange / modal`。
 
 <!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `showClose` | `boolean` | `true` | – | 是否在右上角显示默认关闭按钮(antd Modal 默认行为)。 |
+
+| 名称        | 类型      | 默认值 | 必填 | 说明                                                |
+| ----------- | --------- | ------ | ---- | --------------------------------------------------- |
+| `showClose` | `boolean` | `true` | –    | 是否在右上角显示默认关闭按钮(antd Modal 默认行为)。 |
+
 <!-- auto:props:end -->
 
 ## 依赖
@@ -42,13 +45,14 @@ package: "@teamix-evo/ui"
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成,数据源是 [`manifest.json`](../../../manifest.json)。**手工编辑 marker 之间的内容会在下次生成时被覆盖**。
 
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add dialog` 时,以下 entry 会被自动连带安装(无需手动 add)。
 
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
+| Entry | 类型 | 描述                                               |
+| ----- | ---- | -------------------------------------------------- |
+| `cn`  | util | Tailwind className 合并工具(clsx + tailwind-merge) |
 
 ### npm 依赖
 
@@ -57,6 +61,7 @@ package: "@teamix-evo/ui"
 ```bash
 pnpm add @radix-ui/react-dialog@^1.1.0 lucide-react@^0.460.0
 ```
+
 <!-- auto:deps:end -->
 
 > 子组件:`Dialog`(Root)/ `DialogTrigger` / `DialogContent` / `DialogHeader` / `DialogFooter` / `DialogTitle` / `DialogDescription` / `DialogClose` / `DialogOverlay` / `DialogPortal`。
@@ -74,8 +79,14 @@ pnpm add @radix-ui/react-dialog@^1.1.0 lucide-react@^0.460.0
 
 ```tsx
 import {
-  Dialog, DialogTrigger, DialogContent, DialogHeader,
-  DialogFooter, DialogTitle, DialogDescription, DialogClose,
+  Dialog,
+  DialogTrigger,
+  DialogContent,
+  DialogHeader,
+  DialogFooter,
+  DialogTitle,
+  DialogDescription,
+  DialogClose,
 } from '@/components/ui/dialog';
 import { Button } from '@/components/ui/button';
 
@@ -97,9 +108,11 @@ import { Button } from '@/components/ui/button';
       <Button>保存</Button>
     </DialogFooter>
   </DialogContent>
-</Dialog>
+</Dialog>;
 
 // 受控
 const [open, setOpen] = React.useState(false);
-<Dialog open={open} onOpenChange={setOpen}>...</Dialog>
+<Dialog open={open} onOpenChange={setOpen}>
+  ...
+</Dialog>;
 ```

package/src/components/dialog/dialog.stories.tsx

@@ -21,7 +21,7 @@ const meta: Meta<typeof DialogContent> = {
     docs: {
       description: {
         component:
-          '模态对话框 — 用于承载需要用户聚焦完成的任务(表单 / 确认 / 查看详情)。基于 Radix Dialog(焦点管理、ESC 关闭、`aria-modal` 自动) + antd Modal 范式(`DialogHeader` / `DialogFooter` / `DialogTitle` / `DialogDescription` 子组件组合)。视觉走 OpenTrek semantic tokens，所有样式来自 `@teamix-evo/design`，无 mock。',
+          '模态对话框 — 用于承载需要用户聚焦完成的任务(表单 / 确认 / 查看详情)。基于 Radix Dialog(焦点管理、ESC 关闭、aria-modal 自动) + antd Modal 范式(DialogHeader / DialogFooter 子组件组合)。',
       },
     },
   },

package/src/components/dialog/dialog.tsx

@@ -42,7 +42,7 @@ const DialogContent = React.forwardRef<
     <DialogPrimitive.Content
       ref={ref}
       className={cn(
-        'fixed left-[50%] top-[50%] z-50 grid w-full max-w-lg translate-x-[-50%] translate-y-[-50%] gap-4 border bg-background p-6 shadow-lg duration-200 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 sm:rounded-lg',
+        'fixed left-1/2 top-1/2 z-50 grid w-full max-w-lg translate-x-[-50%] translate-y-[-50%] gap-4 border bg-background p-6 shadow-lg duration-200 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 sm:rounded-lg',
         className,
       )}
       {...props}

package/src/components/drawer/drawer.meta.md

@@ -1,13 +1,14 @@
 ---
 id: drawer
 name: Drawer
+displayName: 抽屉
 type: component
 category: feedback
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
 ---
 
-# Drawer
+# Drawer 抽屉
 
 底部可拖拽抽屉 — 基于 [`vaul`](https://github.com/emilkowalski/vaul),iOS 风格,**移动端体验最佳**。
 **与 Sheet 区别**:Sheet 模态阻断 + 边缘滑入(桌面端);Drawer 底部 + 可向下拖拽 dismiss(移动端 / 触屏)。
@@ -31,7 +32,9 @@ package: "@teamix-evo/ui"
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成。下表是 `DrawerContent` 的 props;`Drawer`(Root)透传 vaul `open / defaultOpen / onOpenChange / shouldScaleBackground / dismissible / snapPoints / onClose`。
 
 <!-- auto:props:begin -->
+
 _(no props)_
+
 <!-- auto:props:end -->
 
 ## 依赖
@@ -39,13 +42,14 @@ _(no props)_
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成,数据源是 [`manifest.json`](../../../manifest.json)。**手工编辑 marker 之间的内容会在下次生成时被覆盖**。
 
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add drawer` 时,以下 entry 会被自动连带安装(无需手动 add)。
 
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
+| Entry | 类型 | 描述                                               |
+| ----- | ---- | -------------------------------------------------- |
+| `cn`  | util | Tailwind className 合并工具(clsx + tailwind-merge) |
 
 ### npm 依赖
 
@@ -54,6 +58,7 @@ _(no props)_
 ```bash
 pnpm add vaul@^1.0.0
 ```
+
 <!-- auto:deps:end -->
 
 > 子组件:`Drawer` / `DrawerTrigger` / `DrawerContent` / `DrawerHeader` / `DrawerFooter` / `DrawerTitle` / `DrawerDescription` / `DrawerClose`。
@@ -70,8 +75,14 @@ pnpm add vaul@^1.0.0
 
 ```tsx
 import {
-  Drawer, DrawerTrigger, DrawerContent, DrawerHeader,
-  DrawerTitle, DrawerDescription, DrawerFooter, DrawerClose,
+  Drawer,
+  DrawerTrigger,
+  DrawerContent,
+  DrawerHeader,
+  DrawerTitle,
+  DrawerDescription,
+  DrawerFooter,
+  DrawerClose,
 } from '@/components/ui/drawer';
 import { Button } from '@/components/ui/button';
 
@@ -92,5 +103,5 @@ import { Button } from '@/components/ui/button';
       </DrawerClose>
     </DrawerFooter>
   </DrawerContent>
-</Drawer>
+</Drawer>;
 ```

package/src/components/drawer/drawer.stories.tsx

@@ -19,7 +19,7 @@ const meta: Meta<typeof DrawerContent> = {
     docs: {
       description: {
         component:
-          '抽屉(移动优先) — 从屏幕边缘滑入的浮层容器，常用于移动端表单 / 详情 / 导航等中等复杂度的二级界面。基于 [Vaul](https://vaul.emilkowal.ski/) 实现，提供原生手势 + 拖拽关闭 + 顶部把手；桌面端可视为 `Sheet` 的移动友好版本(能力对齐 antd Drawer)。视觉走 OpenTrek semantic tokens，所有样式来自 `@teamix-evo/design`，无 mock。',
+          '抽屉(移动优先) — 从屏幕边缘滑入的浮层容器,常用于移动端表单 / 详情 / 导航。基于 Vaul 实现,提供原生手势 + 拖拽关闭 + 顶部把手。能力对齐 antd Drawer。',
       },
     },
   },

package/src/components/drawer/drawer.tsx

@@ -47,6 +47,7 @@ const DrawerContent = React.forwardRef<
       )}
       {...props}
     >
+      {/* eslint-disable-next-line teamix-evo/no-arbitrary-tw-value -- drawer drag handle pill: 100px is a deliberate visual constant, not a layout size to tokenize. */}
       <div className="mx-auto mt-4 h-2 w-[100px] rounded-full bg-muted" />
       {children}
     </DrawerPrimitive.Content>

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

@@ -4,10 +4,11 @@ name: DropdownMenu
 type: component
 category: navigation
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
+displayName: 下拉菜单
 ---
 
-# DropdownMenu
+# DropdownMenu 下拉菜单
 
 下拉菜单 — Radix DropdownMenu 完整实现:Item / CheckboxItem / RadioItem / Label / Separator / Shortcut / Sub(子菜单)。
 对应 antd `Dropdown`,但本组件是**完整 menu primitives**(antd Dropdown 主要走 children 自由排版,本组件提供语义化每一种 item)。
@@ -31,7 +32,25 @@ package: "@teamix-evo/ui"
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成。下表是 `DropdownMenuContent` 的 props;`DropdownMenu`(Root)透传 Radix `open / defaultOpen / onOpenChange / modal`。
 
 <!-- auto:props:begin -->
-_(组件无 `<Name>Props` interface — props 详见 [`dropdown-menu.tsx`](./dropdown-menu.tsx))_
+
+#### DropdownMenuSubTrigger
+
+| 名称    | 类型      | 默认值  | 必填 | 说明                                        |
+| ------- | --------- | ------- | ---- | ------------------------------------------- |
+| `inset` | `boolean` | `false` | –    | 左侧留出 icon 宽度的缩进,对齐同级 icon 项。 |
+
+#### DropdownMenuItem
+
+| 名称    | 类型      | 默认值  | 必填 | 说明                                        |
+| ------- | --------- | ------- | ---- | ------------------------------------------- |
+| `inset` | `boolean` | `false` | –    | 左侧留出 icon 宽度的缩进,对齐同级 icon 项。 |
+
+#### DropdownMenuLabel
+
+| 名称    | 类型      | 默认值  | 必填 | 说明                                        |
+| ------- | --------- | ------- | ---- | ------------------------------------------- |
+| `inset` | `boolean` | `false` | –    | 左侧留出 icon 宽度的缩进,对齐同级 icon 项。 |
+
 <!-- auto:props:end -->
 
 ## 依赖
@@ -39,13 +58,14 @@ _(组件无 `<Name>Props` interface — props 详见 [`dropdown-menu.tsx`](./dro
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成,数据源是 [`manifest.json`](../../../manifest.json)。**手工编辑 marker 之间的内容会在下次生成时被覆盖**。
 
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add dropdown-menu` 时,以下 entry 会被自动连带安装(无需手动 add)。
 
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
+| Entry | 类型 | 描述                                               |
+| ----- | ---- | -------------------------------------------------- |
+| `cn`  | util | Tailwind className 合并工具(clsx + tailwind-merge) |
 
 ### npm 依赖
 
@@ -54,9 +74,8 @@ _(组件无 `<Name>Props` interface — props 详见 [`dropdown-menu.tsx`](./dro
 ```bash
 pnpm add @radix-ui/react-dropdown-menu@^2.1.0 lucide-react@^0.460.0
 ```
-<!-- auto:deps:end -->
 
-> 完整子组件:`DropdownMenu` / `DropdownMenuTrigger` / `DropdownMenuContent` / `DropdownMenuItem`(支持 `inset`)/ `DropdownMenuCheckboxItem` / `DropdownMenuRadioItem` / `DropdownMenuLabel` / `DropdownMenuSeparator` / `DropdownMenuShortcut` / `DropdownMenuGroup` / `DropdownMenuRadioGroup` / `DropdownMenuSub`(嵌套)/ `DropdownMenuSubTrigger` / `DropdownMenuSubContent`。
+<!-- auto:deps:end -->
 
 ## AI 生成纪律
 
@@ -70,11 +89,20 @@ pnpm add @radix-ui/react-dropdown-menu@^2.1.0 lucide-react@^0.460.0
 
 ```tsx
 import {
-  DropdownMenu, DropdownMenuTrigger, DropdownMenuContent,
-  DropdownMenuItem, DropdownMenuCheckboxItem, DropdownMenuRadioItem,
-  DropdownMenuRadioGroup, DropdownMenuLabel, DropdownMenuSeparator,
-  DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubTrigger,
-  DropdownMenuSubContent, DropdownMenuPortal,
+  DropdownMenu,
+  DropdownMenuTrigger,
+  DropdownMenuContent,
+  DropdownMenuItem,
+  DropdownMenuCheckboxItem,
+  DropdownMenuRadioItem,
+  DropdownMenuRadioGroup,
+  DropdownMenuLabel,
+  DropdownMenuSeparator,
+  DropdownMenuShortcut,
+  DropdownMenuSub,
+  DropdownMenuSubTrigger,
+  DropdownMenuSubContent,
+  DropdownMenuPortal,
 } from '@/components/ui/dropdown-menu';
 import { Button } from '@/components/ui/button';
 import { User, Settings, LogOut } from 'lucide-react';
@@ -99,5 +127,5 @@ import { User, Settings, LogOut } from 'lucide-react';
       <LogOut /> 退出
     </DropdownMenuItem>
   </DropdownMenuContent>
-</DropdownMenu>
+</DropdownMenu>;
 ```

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

@@ -19,6 +19,14 @@ const meta: Meta<typeof DropdownMenuContent> = {
   title: '导航 · Navigation/DropdownMenu',
   component: DropdownMenuContent,
   tags: ['autodocs'],
+  parameters: {
+    docs: {
+      description: {
+        component:
+          '下拉菜单 — 行内动作菜单（更多操作 / 用户头像下拉 / 工具栏溢出），支持 Item / CheckboxItem / RadioItem / Sub 子菜单。Radix DropdownMenu 实现，对应 antd `Dropdown`，但提供完整语义化原语。',
+      },
+    },
+  },
 };
 
 export default meta;

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

@@ -40,7 +40,7 @@ const DropdownMenuSubContent = React.forwardRef<
   <DropdownMenuPrimitive.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}
@@ -58,7 +58,7 @@ const DropdownMenuContent = React.forwardRef<
       ref={ref}
       sideOffset={sideOffset}
       className={cn(
-        'z-50 min-w-[8rem] overflow-hidden rounded-md border bg-popover p-1 text-popover-foreground shadow-md 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 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2',
+        'z-50 min-w-menu overflow-hidden rounded-md border bg-popover p-1 text-popover-foreground shadow-md 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 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2',
         className,
       )}
       {...props}

package/src/components/empty/empty.meta.md

@@ -4,10 +4,11 @@ name: Empty
 type: component
 category: feedback
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
+displayName: 空状态
 ---
 
-# Empty
+# Empty 空状态
 
 空状态 — antd 独有补足。**列表 / 表格 / 搜索结果为空**时的占位提示,提供引导动作鼓励用户创建首条数据。
 
@@ -23,23 +24,30 @@ package: "@teamix-evo/ui"
 - 错误 / 失败 → `Result` 或 `Alert`
 - 表单字段空 → 直接 placeholder
 
+## Props
+
 <!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `image` | `React.ReactNode` | – | – | 自定义图标(覆盖默认 Inbox)。 |
-| `description` | `React.ReactNode` | `"暂无数据"` | – | 描述文本。 |
-| `extra` | `React.ReactNode` | – | – | 操作区(放 Button 引导用户创建首条数据)。 |
-| `size` | `'sm' \| 'default'` | `"default"` | – | 尺寸 — `sm` 用于卡片内 / 表格空态;`default` 用于整区。 |
+
+| 名称          | 类型                | 默认值       | 必填 | 说明                                                   |
+| ------------- | ------------------- | ------------ | ---- | ------------------------------------------------------ |
+| `image`       | `React.ReactNode`   | –            | –    | 自定义图标(覆盖默认 Inbox)。                           |
+| `description` | `React.ReactNode`   | `"暂无数据"` | –    | 描述文本。                                             |
+| `extra`       | `React.ReactNode`   | –            | –    | 操作区(放 Button 引导用户创建首条数据)。               |
+| `size`        | `'sm' \| 'default'` | `"default"`  | –    | 尺寸 — `sm` 用于卡片内 / 表格空态;`default` 用于整区。 |
+
 <!-- auto:props:end -->
 
+## 依赖
+
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add empty` 时,以下 entry 会被自动连带安装(无需手动 add)。
 
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
+| Entry | 类型 | 描述                                               |
+| ----- | ---- | -------------------------------------------------- |
+| `cn`  | util | Tailwind className 合并工具(clsx + tailwind-merge) |
 
 ### npm 依赖
 
@@ -48,6 +56,7 @@ package: "@teamix-evo/ui"
 ```bash
 pnpm add lucide-react@^0.460.0
 ```
+
 <!-- auto:deps:end -->
 
 ## AI 生成纪律

package/src/components/empty/empty.stories.tsx

@@ -11,7 +11,7 @@ const meta: Meta<typeof Empty> = {
     docs: {
       description: {
         component:
-          '空状态 — 列表 / 表格 / 搜索结果为空时的占位提示。提供 description 引导文案 + extra 主操作,鼓励用户创建首条数据。OpenTrek tokens 适配,等价 antd Empty。',
+          '空状态 — 列表 / 表格 / 搜索结果为空时的占位提示。提供 description 引导文案 + extra 主操作，鼓励用户创建首条数据。等价 antd Empty。',
       },
     },
   },