@teamix-evo/ui 0.1.1 → 0.2.0

package/src/components/timeline/timeline.meta.md

@@ -1,13 +1,14 @@
 ---
 id: timeline
 name: Timeline
+displayName: 时间轴
 type: component
 category: data-display
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
 ---
 
-# Timeline
+# Timeline 时间轴
 
 时间轴 — antd 独有补足。**等价 antd `Timeline`**。垂直时间流(操作历史 / 物流轨迹 / 进度记录),支持 `left` / `right` / `alternate` 三种布局、5 种圆点颜色、自定义圆点节点、反向、尾部 `pending` 占位(配 Spinner 表示进行中)。
 
@@ -24,27 +25,35 @@ package: "@teamix-evo/ui"
 - 数据表 → `Table` / `DataTable`
 - 不带时间属性的事件列表 → `List` / `Item` + `ItemGroup`
 
+## Props
+
 <!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `items` | `TimelineItem[]` | – | ✓ | 节点列表。 |
-| `mode` | `'left' \| 'right' \| 'alternate'` | `"left"` | – | 布局模式 — `left`(默认 antd `mode`)左侧时间轴;`right` 右侧;`alternate` 两侧交替。 |
-| `reverse` | `boolean` | `false` | – | 反向(antd `reverse` 并集) — 最新条目排在最上。 |
-| `pending` | `React.ReactNode` | – | – | 在尾部追加一个"未结束"占位(antd `pending` 并集) — 通常配 `<Spinner>` 显示加载中。 |
+
+| 名称      | 类型                               | 默认值   | 必填 | 说明                                                                              |
+| --------- | ---------------------------------- | -------- | ---- | --------------------------------------------------------------------------------- |
+| `items`   | `TimelineItem[]`                   | –        | ✓    | 节点列表。                                                                        |
+| `mode`    | `'left' \| 'right' \| 'alternate'` | `"left"` | –    | 布局模式 — `left`(默认 antd `mode`)左侧时间轴;`right` 右侧;`alternate` 两侧交替。 |
+| `reverse` | `boolean`                          | `false`  | –    | 反向(antd `reverse` 并集) — 最新条目排在最上。                                    |
+| `pending` | `React.ReactNode`                  | –        | –    | 在尾部追加一个"未结束"占位(antd `pending` 并集) — 通常配 `<Spinner>` 显示加载中。 |
+
 <!-- auto:props:end -->
 
+## 依赖
+
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add timeline` 时,以下 entry 会被自动连带安装(无需手动 add)。
 
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
+| Entry | 类型 | 描述                                               |
+| ----- | ---- | -------------------------------------------------- |
+| `cn`  | util | Tailwind className 合并工具(clsx + tailwind-merge) |
 
 ### npm 依赖
 
 _无 — 本组件不依赖任何 npm 包。_
+
 <!-- auto:deps:end -->
 
 ## AI 生成纪律

package/src/components/timeline/timeline.stories.tsx

@@ -11,7 +11,7 @@ const meta: Meta<typeof Timeline> = {
     docs: {
       description: {
         component:
-          '时间轴 — 垂直时间流(操作历史 / 物流轨迹 / 进度记录)。3 种布局(left / right / alternate)+ 5 种圆点语义色 + 自定义 dot + pending 进行中占位。等价 antd `Timeline`。视觉走 OpenTrek tokens,所有样式来自 `@teamix-evo/design`,无 mock。',
+          '时间轴 — 垂直时间流（操作历史 / 物流轨迹 / 进度记录）。3 种布局（left / right / alternate）+ 5 种圆点语义色 + 自定义 dot + pending 进行中占位。等价 antd `Timeline`。',
       },
     },
   },
@@ -61,8 +61,14 @@ export const CustomDots: Story = {
     <div className="w-96">
       <Timeline
         items={[
-          { children: '部署到 staging 成功', dot: <CheckCircle2 className="size-3 text-emerald-500" /> },
-          { children: 'staging 验证通过', dot: <CheckCircle2 className="size-3 text-emerald-500" /> },
+          {
+            children: '部署到 staging 成功',
+            dot: <CheckCircle2 className="size-3 text-emerald-500" />,
+          },
+          {
+            children: 'staging 验证通过',
+            dot: <CheckCircle2 className="size-3 text-emerald-500" />,
+          },
           { children: '回滚到 v1.2', color: 'error' },
         ]}
       />
@@ -94,7 +100,11 @@ export const Reverse: Story = {
       <Timeline
         reverse
         items={[
-          { children: '订单已创建', label: '2026-05-01 10:00', color: 'default' },
+          {
+            children: '订单已创建',
+            label: '2026-05-01 10:00',
+            color: 'default',
+          },
           { children: '已发货', label: '2026-05-02 14:30', color: 'primary' },
           { children: '已签收', label: '2026-05-04 09:15', color: 'success' },
         ]}

package/src/components/timeline/timeline.tsx

@@ -12,8 +12,8 @@ export type TimelineDotColor =
 const dotColorMap: Record<TimelineDotColor, string> = {
   default: 'bg-muted-foreground',
   primary: 'bg-primary',
-  success: 'bg-emerald-500',
-  warning: 'bg-amber-500',
+  success: 'bg-success',
+  warning: 'bg-warning',
   error: 'bg-destructive',
 };
 
@@ -107,6 +107,7 @@ const Timeline = React.forwardRef<HTMLOListElement, TimelineProps>(
                 {!isLast ? (
                   <span
                     aria-hidden="true"
+                    // eslint-disable-next-line teamix-evo/no-arbitrary-tw-value -- timeline connector extends to next item; calc(100% + 1.5rem) bridges the inter-item gap, not tokenizable.
                     className="absolute top-3 h-[calc(100%+1.5rem)] w-px bg-border"
                   />
                 ) : null}

package/src/components/toggle/toggle.meta.md

@@ -4,10 +4,11 @@ name: Toggle
 type: component
 category: form
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
+displayName: 切换按钮
 ---
 
-# Toggle
+# Toggle 切换按钮
 
 二元状态按钮 — Radix Toggle 包装。**shadcn-only**(antd 无独立对标,与 Switch 形态不同)。
 
@@ -30,10 +31,12 @@ package: "@teamix-evo/ui"
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成。
 
 <!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `variant` | `'default' \| 'outline'` | `"default"` | – | 视觉风格。 |
-| `size` | `'sm' \| 'default' \| 'lg'` | `"default"` | – | 尺寸。 |
+
+| 名称      | 类型                        | 默认值      | 必填 | 说明       |
+| --------- | --------------------------- | ----------- | ---- | ---------- |
+| `variant` | `'default' \| 'outline'`    | `"default"` | –    | 视觉风格。 |
+| `size`    | `'sm' \| 'default' \| 'lg'` | `"default"` | –    | 尺寸。     |
+
 <!-- auto:props:end -->
 
 ## 依赖
@@ -41,13 +44,14 @@ package: "@teamix-evo/ui"
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成,数据源是 [`manifest.json`](../../../manifest.json)。**手工编辑 marker 之间的内容会在下次生成时被覆盖**。
 
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add toggle` 时,以下 entry 会被自动连带安装(无需手动 add)。
 
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
+| Entry | 类型 | 描述                                               |
+| ----- | ---- | -------------------------------------------------- |
+| `cn`  | util | Tailwind className 合并工具(clsx + tailwind-merge) |
 
 ### npm 依赖
 
@@ -56,6 +60,7 @@ package: "@teamix-evo/ui"
 ```bash
 pnpm add @radix-ui/react-toggle@^1.1.0 class-variance-authority@^0.7.0
 ```
+
 <!-- auto:deps:end -->
 
 > 透传所有 Radix Toggle.Root props(`pressed` / `defaultPressed` / `onPressedChange` / `disabled` 等)。

package/src/components/toggle/toggle.stories.tsx

@@ -10,7 +10,7 @@ const meta: Meta<typeof Toggle> = {
     docs: {
       description: {
         component:
-          '切换按钮 — 二状态 (开 / 关) 按钮，常用于富文本编辑器工具栏 (加粗 / 斜体 / 下划线) 等场景。Radix Toggle 实现， shadcn 专有（antd 未提供对应原子组件，antd 逻辑上以 Radio.Button + Switch 组合表达）。支持 `variant`（default / outline）与 `size`（sm / default / lg）。视觉走 OpenTrek semantic tokens，所有样式来自 `@teamix-evo/design`，无 mock。',
+          '切换按钮 — 二状态 (开 / 关) 按钮，常用于富文本编辑器工具栏 (加粗 / 斜体 / 下划线) 等场景。Radix Toggle 实现， shadcn 专有（antd 未提供对应原子组件，antd 逻辑上以 Radio.Button + Switch 组合表达）。支持 `variant`（default / outline）与 `size`（sm / default / lg）。',
       },
     },
   },

package/src/components/toggle-group/toggle-group.meta.md

@@ -4,10 +4,11 @@ name: ToggleGroup
 type: component
 category: form
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
+displayName: 切换按钮组
 ---
 
-# ToggleGroup
+# ToggleGroup 切换按钮组
 
 切换按钮组 — Radix ToggleGroup,**单选(`type="single"`)+ 多选(`type="multiple"`)**。复用 Toggle 的 cva variants(default / outline)与 size。
 
@@ -28,11 +29,13 @@ package: "@teamix-evo/ui"
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成。
 
 <!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `variant` | `'default' \| 'outline'` | `"default"` | – | 视觉风格,与同源的 [`Toggle`](../toggle/toggle.tsx) 保持一致。 |
-| `size` | `'sm' \| 'default' \| 'lg'` | `"default"` | – | 尺寸,与同源的 [`Toggle`](../toggle/toggle.tsx) 保持一致。 |
-| `className` | `string` | – | – | 容器 className,会与默认布局类合并。 |
+
+| 名称        | 类型                        | 默认值      | 必填 | 说明                                                          |
+| ----------- | --------------------------- | ----------- | ---- | ------------------------------------------------------------- |
+| `variant`   | `'default' \| 'outline'`    | `"default"` | –    | 视觉风格,与同源的 [`Toggle`](../toggle/toggle.tsx) 保持一致。 |
+| `size`      | `'sm' \| 'default' \| 'lg'` | `"default"` | –    | 尺寸,与同源的 [`Toggle`](../toggle/toggle.tsx) 保持一致。     |
+| `className` | `string`                    | –           | –    | 容器 className,会与默认布局类合并。                           |
+
 <!-- auto:props:end -->
 
 ## 依赖
@@ -40,14 +43,15 @@ package: "@teamix-evo/ui"
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成,数据源是 [`manifest.json`](../../../manifest.json)。**手工编辑 marker 之间的内容会在下次生成时被覆盖**。
 
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add toggle-group` 时,以下 entry 会被自动连带安装(无需手动 add)。
 
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
-| `toggle` | component | 二元状态按钮 — Radix Toggle 包装,工具栏图标级开关 |
+| Entry    | 类型      | 描述                                               |
+| -------- | --------- | -------------------------------------------------- |
+| `cn`     | util      | Tailwind className 合并工具(clsx + tailwind-merge) |
+| `toggle` | component | 二元状态按钮 — Radix Toggle 包装,工具栏图标级开关  |
 
 ### npm 依赖
 
@@ -56,6 +60,7 @@ package: "@teamix-evo/ui"
 ```bash
 pnpm add @radix-ui/react-toggle-group@^1.1.0 class-variance-authority@^0.7.0
 ```
+
 <!-- auto:deps:end -->
 
 > 透传 Radix ToggleGroup.Root 所有 props(`type` / `value` / `defaultValue` / `onValueChange` / `disabled` / `loop` / `orientation` 等)。

package/src/components/toggle-group/toggle-group.stories.tsx

@@ -18,7 +18,7 @@ const meta: Meta<typeof ToggleGroup> = {
     docs: {
       description: {
         component:
-          '切换按钮组 — 一组二状态按钮的集合，可选单选 (`type="single"`) 或多选 (`type="multiple"`)，常用于对齐方式 / 字体样式等工具栏场景。Radix ToggleGroup 实现，shadcn 专有（antd 以 `Radio.Group` + `Radio.Button` 表达单选、以菜单多选表达多选）；`variant` / `size` 与 `Toggle` 保持一致。视觉走 OpenTrek semantic tokens，所有样式来自 `@teamix-evo/design`，无 mock。',
+          '切换按钮组 — 一组二状态按钮的集合，可选单选 (`type="single"`) 或多选 (`type="multiple"`)，常用于对齐方式 / 字体样式等工具栏场景。Radix ToggleGroup 实现，shadcn 专有（antd 以 `Radio.Group` + `Radio.Button` 表达单选、以菜单多选表达多选）；`variant` / `size` 与 `Toggle` 保持一致。',
       },
     },
   },

package/src/components/tooltip/tooltip.meta.md

@@ -4,10 +4,11 @@ name: Tooltip
 type: component
 category: feedback
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
+displayName: 文字提示
 ---
 
-# Tooltip
+# Tooltip 文字提示
 
 文字提示气泡 — Radix Tooltip + antd `arrow / placement(side)` 并集。
 **两种用法**:`<Tooltip title="...">{trigger}</Tooltip>` 一行包装,或拆分原子组件(`TooltipRoot/Trigger/Content`)精细控制。
@@ -31,14 +32,16 @@ package: "@teamix-evo/ui"
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成。
 
 <!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `children` | `React.ReactElement` | – | ✓ | 触发器(单个 ReactElement,asChild 透传)。 |
-| `title` | `React.ReactNode` | – | ✓ | 提示内容。 |
-| `side` | `'top' \| 'right' \| 'bottom' \| 'left'` | `"top"` | – | 弹出方向。 |
-| `arrow` | `boolean` | `true` | – | 是否显示三角形箭头。 |
-| `delayDuration` | `number` | – | – | 显示延迟(ms),默认沿用 Provider 的 delayDuration。 |
-| `withProvider` | `boolean` | – | – | 强制传给 Provider 的 delayDuration(便于不挂 Provider 的场景)。 |
+
+| 名称            | 类型                                     | 默认值  | 必填 | 说明                                                           |
+| --------------- | ---------------------------------------- | ------- | ---- | -------------------------------------------------------------- |
+| `children`      | `React.ReactElement`                     | –       | ✓    | 触发器(单个 ReactElement,asChild 透传)。                       |
+| `title`         | `React.ReactNode`                        | –       | ✓    | 提示内容。                                                     |
+| `side`          | `'top' \| 'right' \| 'bottom' \| 'left'` | `"top"` | –    | 弹出方向。                                                     |
+| `arrow`         | `boolean`                                | `true`  | –    | 是否显示三角形箭头。                                           |
+| `delayDuration` | `number`                                 | –       | –    | 显示延迟(ms),默认沿用 Provider 的 delayDuration。              |
+| `withProvider`  | `boolean`                                | –       | –    | 强制传给 Provider 的 delayDuration(便于不挂 Provider 的场景)。 |
+
 <!-- auto:props:end -->
 
 ## 依赖
@@ -46,13 +49,14 @@ package: "@teamix-evo/ui"
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成,数据源是 [`manifest.json`](../../../manifest.json)。**手工编辑 marker 之间的内容会在下次生成时被覆盖**。
 
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add tooltip` 时,以下 entry 会被自动连带安装(无需手动 add)。
 
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
+| Entry | 类型 | 描述                                               |
+| ----- | ---- | -------------------------------------------------- |
+| `cn`  | util | Tailwind className 合并工具(clsx + tailwind-merge) |
 
 ### npm 依赖
 
@@ -61,6 +65,7 @@ package: "@teamix-evo/ui"
 ```bash
 pnpm add @radix-ui/react-tooltip@^1.1.0
 ```
+
 <!-- auto:deps:end -->
 
 > 子组件 `TooltipProvider / TooltipRoot / TooltipTrigger / TooltipContent` 用于精细控制,见 [`tooltip.tsx`](./tooltip.tsx)。

package/src/components/tooltip/tooltip.stories.tsx

@@ -11,7 +11,7 @@ const meta: Meta<typeof Tooltip> = {
     docs: {
       description: {
         component:
-          '文字气泡提示 — 鼠标悬停或键盘聚焦元素时弹出的简短提示。Radix Tooltip 实现 + antd Tooltip 的并集能力：需 `TooltipProvider` 包裹（可设 `delayDuration`），通过 `side` / `arrow` / `title` 调整方位与尖角；适用于纯文本辅助说明，丰富交互请选 `Popover`。视觉走 OpenTrek semantic tokens，所有样式来自 `@teamix-evo/design`，无 mock。',
+          '文字气泡提示 — 鼠标悬停或键盘聚焦元素时弹出的简短提示。Radix Tooltip 实现 + antd Tooltip 的并集能力：需 `TooltipProvider` 包裹（可设 `delayDuration`），通过 `side` / `arrow` / `title` 调整方位与尖角；适用于纯文本辅助说明，丰富交互请选 `Popover`。',
       },
     },
   },

package/src/components/tour/tour.meta.md

@@ -4,10 +4,11 @@ name: Tour
 type: component
 category: feedback
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
+displayName: 新手引导
 ---
 
-# Tour
+# Tour 新手引导
 
 新手引导 — antd 独有补足。**等价 antd `Tour`**(v5.0+)。多步骤引导(spotlight + 卡片 + 步进按钮 + 可关闭),帮助新用户首次进入页面时了解关键功能位置。
 
@@ -24,28 +25,35 @@ package: "@teamix-evo/ui"
 - 表单字段说明 → `FieldDescription`
 - 错误反馈 → `Alert` / `notification`
 
+## Props
+
 <!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `steps` | `TourStep[]` | – | ✓ | 步骤列表(antd `steps` 并集)。 |
-| `open` | `boolean` | – | – | 受控 open 状态。 |
-| `defaultOpen` | `boolean` | `false` | – | uncontrolled 初值。 |
-| `onOpenChange` | `(open: boolean) => void` | – | – | open 变化回调。 |
-| `current` | `number` | – | – | 当前步骤索引(受控)。 |
-| `onChange` | `(current: number) => void` | – | – | 步骤变化回调。 |
-| `onFinish` | `() => void` | – | – | 完成时回调(走到最后一步且点击"完成")。 |
-| `onClose` | `() => void` | – | – | 关闭回调(任意时刻点 X / mask)。 |
-| `mask` | `boolean` | `true` | – | 是否显示遮罩(antd `mask` 并集)。 |
+
+| 名称           | 类型                        | 默认值  | 必填 | 说明                                   |
+| -------------- | --------------------------- | ------- | ---- | -------------------------------------- |
+| `steps`        | `TourStep[]`                | –       | ✓    | 步骤列表(antd `steps` 并集)。          |
+| `open`         | `boolean`                   | –       | –    | 受控 open 状态。                       |
+| `defaultOpen`  | `boolean`                   | `false` | –    | uncontrolled 初值。                    |
+| `onOpenChange` | `(open: boolean) => void`   | –       | –    | open 变化回调。                        |
+| `current`      | `number`                    | –       | –    | 当前步骤索引(受控)。                   |
+| `onChange`     | `(current: number) => void` | –       | –    | 步骤变化回调。                         |
+| `onFinish`     | `() => void`                | –       | –    | 完成时回调(走到最后一步且点击"完成")。 |
+| `onClose`      | `() => void`                | –       | –    | 关闭回调(任意时刻点 X / mask)。        |
+| `mask`         | `boolean`                   | `true`  | –    | 是否显示遮罩(antd `mask` 并集)。       |
+
 <!-- auto:props:end -->
 
+## 依赖
+
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add tour` 时,以下 entry 会被自动连带安装(无需手动 add)。
 
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
+| Entry    | 类型      | 描述                                                                                    |
+| -------- | --------- | --------------------------------------------------------------------------------------- |
+| `cn`     | util      | Tailwind className 合并工具(clsx + tailwind-merge)                                      |
 | `button` | component | 通用按钮 — shadcn 实现 + antd 功能扩展(loading / icon / shape / block / dashed variant) |
 
 ### npm 依赖
@@ -55,6 +63,7 @@ package: "@teamix-evo/ui"
 ```bash
 pnpm add lucide-react@^0.460.0
 ```
+
 <!-- auto:deps:end -->
 
 ## AI 生成纪律

package/src/components/tour/tour.stories.tsx

@@ -11,7 +11,7 @@ const meta: Meta<typeof Tour> = {
     docs: {
       description: {
         component:
-          '新手引导 — 多步骤 spotlight + 卡片 + 步进按钮。帮助新用户首次进入页面时了解关键功能位置。等价 antd `Tour`(v5.0+)。业务侧自管"是否首次访问"。视觉走 OpenTrek tokens,所有样式来自 `@teamix-evo/design`,无 mock。',
+          '新手引导 — 多步骤 spotlight + 卡片 + 步进按钮。帮助新用户首次进入页面时了解关键功能位置。等价 antd `Tour`（v5.0+）。业务侧自管“是否首次访问”。',
       },
     },
   },

package/src/components/tour/tour.tsx

@@ -176,7 +176,7 @@ const Tour: React.FC<TourProps> = ({
             <rect
               width="100%"
               height="100%"
-              fill="rgba(0,0,0,0.5)"
+              fill="var(--overlay-scrim)"
               mask="url(#tour-mask)"
             />
           </svg>

package/src/components/transfer/transfer.meta.md

@@ -1,13 +1,14 @@
 ---
 id: transfer
 name: Transfer
+displayName: 穿梭框
 type: component
 category: data-display
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
 ---
 
-# Transfer
+# Transfer 穿梭框
 
 穿梭框 — antd 独有补足。**双侧勾选 + 移动**的批量分配交互(权限分配、字段映射、收件人选择)。受控 `targetKeys` + `onChange` 单一真值,内置全选 / 半选 / 可选搜索 / 禁用项。
 
@@ -22,31 +23,38 @@ package: "@teamix-evo/ui"
 - 单纯多选 → `Select multiple` / `CheckboxGroup`(轻量)
 - 选项 > 500 — 本组件未做虚拟化,建议改用 `Table` + 行选 + bulk action 模式
 
+## Props
+
 <!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `dataSource` | `TransferItem[]` | – | ✓ | 全部数据源(左+右合集)。 |
-| `targetKeys` | `string[]` | – | ✓ | 受控:已"穿梭到右侧"的 key 集合(antd `targetKeys` 并集)。 |
-| `onChange` | `(next: string[]) => void` | – | – | 右侧集合变化回调。 |
-| `titles` | `[React.ReactNode, React.ReactNode]` | `["源", "目标"]` | – | 两侧标题(antd `titles` 并集) — `[左, 右]`。 |
-| `showSearch` | `boolean` | `false` | – | 启用搜索(antd `showSearch` 并集) — 两侧各一个输入框。 |
-| `render` | `(item: TransferItem) => React.ReactNode` | – | – | 自定义渲染单项(antd `render` 并集) — 默认渲染 `item.title`。 |
-| `disabled` | `boolean` | – | – | 整体禁用。 |
-| `listHeight` | `number` | `280` | – | 单侧高度(像素)。 |
-| `className` | `string` | – | – | – |
+
+| 名称         | 类型                                      | 默认值           | 必填 | 说明                                                         |
+| ------------ | ----------------------------------------- | ---------------- | ---- | ------------------------------------------------------------ |
+| `dataSource` | `TransferItem[]`                          | –                | ✓    | 全部数据源(左+右合集)。                                      |
+| `targetKeys` | `string[]`                                | –                | ✓    | 受控:已"穿梭到右侧"的 key 集合(antd `targetKeys` 并集)。     |
+| `onChange`   | `(next: string[]) => void`                | –                | –    | 右侧集合变化回调。                                           |
+| `titles`     | `[React.ReactNode, React.ReactNode]`      | `["源", "目标"]` | –    | 两侧标题(antd `titles` 并集) — `[左, 右]`。                  |
+| `showSearch` | `boolean`                                 | `false`          | –    | 启用搜索(antd `showSearch` 并集) — 两侧各一个输入框。        |
+| `render`     | `(item: TransferItem) => React.ReactNode` | –                | –    | 自定义渲染单项(antd `render` 并集) — 默认渲染 `item.title`。 |
+| `disabled`   | `boolean`                                 | –                | –    | 整体禁用。                                                   |
+| `listHeight` | `number`                                  | `280`            | –    | 单侧高度(像素)。                                             |
+| `className`  | `string`                                  | –                | –    | –                                                            |
+
 <!-- auto:props:end -->
 
+## 依赖
+
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add transfer` 时,以下 entry 会被自动连带安装(无需手动 add)。
 
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
-| `button` | component | 通用按钮 — shadcn 实现 + antd 功能扩展(loading / icon / shape / block / dashed variant) |
-| `checkbox` | component | 复选框 — Radix Checkbox(原生 indeterminate)+ antd Checkbox.Group(options 数组驱动) |
-| `input` | component | 文本输入 — shadcn 简洁基底 + antd prefix/suffix/clearable/showCount/addonBefore/addonAfter/size |
+| Entry      | 类型      | 描述                                                                                            |
+| ---------- | --------- | ----------------------------------------------------------------------------------------------- |
+| `cn`       | util      | Tailwind className 合并工具(clsx + tailwind-merge)                                              |
+| `button`   | component | 通用按钮 — shadcn 实现 + antd 功能扩展(loading / icon / shape / block / dashed variant)         |
+| `checkbox` | component | 复选框 — Radix Checkbox(原生 indeterminate)+ antd Checkbox.Group(options 数组驱动)              |
+| `input`    | component | 文本输入 — shadcn 简洁基底 + antd prefix/suffix/clearable/showCount/addonBefore/addonAfter/size |
 
 ### npm 依赖
 
@@ -55,6 +63,7 @@ package: "@teamix-evo/ui"
 ```bash
 pnpm add lucide-react@^0.460.0
 ```
+
 <!-- auto:deps:end -->
 
 ## AI 生成纪律
@@ -86,5 +95,5 @@ const [target, setTarget] = React.useState<string[]>(['2', '4']);
   onChange={setTarget}
   titles={['全部成员', '已授权']}
   showSearch
-/>
+/>;
 ```

package/src/components/transfer/transfer.stories.tsx

@@ -10,7 +10,7 @@ const meta: Meta<typeof Transfer> = {
     docs: {
       description: {
         component:
-          '穿梭框 — 双侧勾选 + 移动的批量分配交互(权限分配、字段映射、收件人选择)。受控 targetKeys 单一真值,内置全选 / 半选 / 可选搜索 / 禁用项跳过。视觉走 OpenTrek tokens,等价 antd `Transfer`,所有样式来自 `@teamix-evo/design`,无 mock。',
+          '穿梭框 — 双侧勾选 + 移动的批量分配交互（权限分配、字段映射、收件人选择）。受控 targetKeys 单一真值，内置全选 / 半选 / 可选搜索 / 禁用项跳过。等价 antd `Transfer`。',
       },
     },
   },
@@ -30,11 +30,7 @@ export const Playground: Story = {
   render: () => {
     const [target, setTarget] = React.useState<string[]>(['2', '4']);
     return (
-      <Transfer
-        dataSource={data}
-        targetKeys={target}
-        onChange={setTarget}
-      />
+      <Transfer dataSource={data} targetKeys={target} onChange={setTarget} />
     );
   },
 };