@teamix-evo/ui 0.1.1 → 0.2.0

package/src/components/tree/tree.meta.md

@@ -1,13 +1,14 @@
 ---
 id: tree
 name: Tree
+displayName: 树形控件
 type: component
 category: data-display
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
 ---
 
-# Tree
+# Tree 树形控件
 
 树形控件 — antd 独有补足。递归层级展示(组织架构、文件系统、分类目录),支持**可展开 / 可单选 / 可勾选(父子级联 + 半选)**,受控与非受控并存。Radix 未提供 tree primitive — 本组件自实现递归 + 受控逻辑。
 
@@ -23,32 +24,39 @@ package: "@teamix-evo/ui"
 - 大数据量(> 1000 节点)— 本组件不做虚拟化,业务侧请自做分页 / 懒加载子节点
 - 拖拽排序场景 → 需配合 `react-dnd` 等库自行扩展,本组件不内置
 
+## Props
+
 <!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `data` | `TreeNode[]` | – | ✓ | 树数据(antd `treeData` 并集)。 |
-| `checkable` | `boolean` | `false` | – | 是否启用勾选 checkbox(antd `checkable` 并集) — 父子级联,半选状态自动计算。 |
-| `selectable` | `boolean` | `true` | – | 是否启用单击高亮选择(antd `selectable` 并集)。 |
-| `checkedKeys` | `string[]` | – | – | 受控已勾选 key 集合(checkable 时生效)。 |
-| `defaultCheckedKeys` | `string[]` | – | – | uncontrolled 初值。 |
-| `onCheck` | `(next: string[]) => void` | – | – | 勾选变化回调。 |
-| `selectedKeys` | `string[]` | – | – | 受控已选中 key 集合(selectable 时生效;通常单选,数组形式与 antd 对齐)。 |
-| `defaultSelectedKeys` | `string[]` | – | – | uncontrolled 初值。 |
-| `onSelect` | `(next: string[]) => void` | – | – | 选中变化回调。 |
-| `expandedKeys` | `string[]` | – | – | 受控已展开 key 集合。 |
-| `defaultExpandedKeys` | `string[]` | – | – | uncontrolled 初值。 |
-| `defaultExpandAll` | `boolean` | `false` | – | 默认展开全部(antd `defaultExpandAll` 并集) — 仅 uncontrolled 模式生效。 |
-| `onExpand` | `(next: string[]) => void` | – | – | 展开变化回调。 |
+
+| 名称                  | 类型                       | 默认值  | 必填 | 说明                                                                       |
+| --------------------- | -------------------------- | ------- | ---- | -------------------------------------------------------------------------- |
+| `data`                | `TreeNode[]`               | –       | ✓    | 树数据(antd `treeData` 并集)。                                             |
+| `checkable`           | `boolean`                  | `false` | –    | 是否启用勾选 checkbox(antd `checkable` 并集) — 父子级联,半选状态自动计算。 |
+| `selectable`          | `boolean`                  | `true`  | –    | 是否启用单击高亮选择(antd `selectable` 并集)。                             |
+| `checkedKeys`         | `string[]`                 | –       | –    | 受控已勾选 key 集合(checkable 时生效)。                                    |
+| `defaultCheckedKeys`  | `string[]`                 | –       | –    | uncontrolled 初值。                                                        |
+| `onCheck`             | `(next: string[]) => void` | –       | –    | 勾选变化回调。                                                             |
+| `selectedKeys`        | `string[]`                 | –       | –    | 受控已选中 key 集合(selectable 时生效;通常单选,数组形式与 antd 对齐)。     |
+| `defaultSelectedKeys` | `string[]`                 | –       | –    | uncontrolled 初值。                                                        |
+| `onSelect`            | `(next: string[]) => void` | –       | –    | 选中变化回调。                                                             |
+| `expandedKeys`        | `string[]`                 | –       | –    | 受控已展开 key 集合。                                                      |
+| `defaultExpandedKeys` | `string[]`                 | –       | –    | uncontrolled 初值。                                                        |
+| `defaultExpandAll`    | `boolean`                  | `false` | –    | 默认展开全部(antd `defaultExpandAll` 并集) — 仅 uncontrolled 模式生效。    |
+| `onExpand`            | `(next: string[]) => void` | –       | –    | 展开变化回调。                                                             |
+
 <!-- auto:props:end -->
 
+## 依赖
+
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add tree` 时,以下 entry 会被自动连带安装(无需手动 add)。
 
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
+| Entry      | 类型      | 描述                                                                               |
+| ---------- | --------- | ---------------------------------------------------------------------------------- |
+| `cn`       | util      | Tailwind className 合并工具(clsx + tailwind-merge)                                 |
 | `checkbox` | component | 复选框 — Radix Checkbox(原生 indeterminate)+ antd Checkbox.Group(options 数组驱动) |
 
 ### npm 依赖
@@ -58,6 +66,7 @@ package: "@teamix-evo/ui"
 ```bash
 pnpm add lucide-react@^0.460.0
 ```
+
 <!-- auto:deps:end -->
 
 ## AI 生成纪律
@@ -82,7 +91,11 @@ const data: TreeNode[] = [
     title: 'src',
     icon: <Folder className="size-3.5" />,
     children: [
-      { key: 'src/index.ts', title: 'index.ts', icon: <File className="size-3.5" /> },
+      {
+        key: 'src/index.ts',
+        title: 'index.ts',
+        icon: <File className="size-3.5" />,
+      },
       {
         key: 'src/components',
         title: 'components',
@@ -97,7 +110,7 @@ const data: TreeNode[] = [
 ];
 
 // 默认展开 + 选择
-<Tree data={data} defaultExpandAll />
+<Tree data={data} defaultExpandAll />;
 
 // 可勾选(受控)
 const [checked, setChecked] = React.useState<string[]>([]);
@@ -107,5 +120,5 @@ const [checked, setChecked] = React.useState<string[]>([]);
   defaultExpandAll
   checkedKeys={checked}
   onCheck={setChecked}
-/>
+/>;
 ```

package/src/components/tree/tree.stories.tsx

@@ -11,7 +11,7 @@ const meta: Meta<typeof Tree> = {
     docs: {
       description: {
         component:
-          '树形控件 — 递归层级展示(目录、组织、分类)。支持展开 / 单选 / 父子级联勾选(自动半选),受控与非受控并存。Radix 未提供 tree primitive,本组件自实现递归与级联。视觉走 OpenTrek tokens,等价 antd `Tree`,所有样式来自 `@teamix-evo/design`,无 mock。',
+          '树形控件 — 递归层级展示（目录、组织、分类）。支持展开 / 单选 / 父子级联勾选（自动半选），受控与非受控并存。Radix 未提供 tree primitive，本组件自实现递归与级联。等价 antd `Tree`。',
       },
     },
   },
@@ -26,22 +26,45 @@ const fileTree: TreeNode[] = [
     title: 'src',
     icon: <Folder className="size-3.5" />,
     children: [
-      { key: 'src/index.ts', title: 'index.ts', icon: <File className="size-3.5" /> },
+      {
+        key: 'src/index.ts',
+        title: 'index.ts',
+        icon: <File className="size-3.5" />,
+      },
       {
         key: 'src/components',
         title: 'components',
         icon: <Folder className="size-3.5" />,
         children: [
-          { key: 'src/components/Button.tsx', title: 'Button.tsx', icon: <File className="size-3.5" /> },
-          { key: 'src/components/Input.tsx', title: 'Input.tsx', icon: <File className="size-3.5" /> },
-          { key: 'src/components/Dialog.tsx', title: 'Dialog.tsx', icon: <File className="size-3.5" />, disabled: true },
+          {
+            key: 'src/components/Button.tsx',
+            title: 'Button.tsx',
+            icon: <File className="size-3.5" />,
+          },
+          {
+            key: 'src/components/Input.tsx',
+            title: 'Input.tsx',
+            icon: <File className="size-3.5" />,
+          },
+          {
+            key: 'src/components/Dialog.tsx',
+            title: 'Dialog.tsx',
+            icon: <File className="size-3.5" />,
+            disabled: true,
+          },
         ],
       },
       {
         key: 'src/utils',
         title: 'utils',
         icon: <Folder className="size-3.5" />,
-        children: [{ key: 'src/utils/cn.ts', title: 'cn.ts', icon: <File className="size-3.5" /> }],
+        children: [
+          {
+            key: 'src/utils/cn.ts',
+            title: 'cn.ts',
+            icon: <File className="size-3.5" />,
+          },
+        ],
       },
     ],
   },
@@ -99,11 +122,7 @@ export const ControlledExpand: Story = {
   render: () => {
     const [expanded, setExpanded] = React.useState<string[]>(['src']);
     return (
-      <Tree
-        data={fileTree}
-        expandedKeys={expanded}
-        onExpand={setExpanded}
-      />
+      <Tree data={fileTree} expandedKeys={expanded} onExpand={setExpanded} />
     );
   },
 };

package/src/components/tree-select/tree-select.meta.md

@@ -1,13 +1,14 @@
 ---
 id: tree-select
 name: TreeSelect
+displayName: 树选择
 type: component
 category: form
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
 ---
 
-# TreeSelect
+# TreeSelect 树选择
 
 树形下拉选择 — antd 独有补足。**等价 antd `TreeSelect`**。把 `Tree` 嵌入 Popover,提供**单选**(selectable)或**多选**(checkable)两种模式 — 组织架构 / 分类树形选择 / 文件夹路径选择常用。
 
@@ -23,32 +24,39 @@ package: "@teamix-evo/ui"
 - 严格级联(每层必选一个,不可跨层) → `Cascader`
 - 树形浏览(不需要"选中"语义) → `Tree`
 
+## Props
+
 <!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `data` | `TreeNode[]` | – | ✓ | 树形数据(antd `treeData` 并集)。 |
-| `multiple` | `boolean` | `false` | – | 多选模式 — 启用后下拉内的 Tree 变为 checkable;value 是 key 数组。 |
-| `value` | `string \| string[]` | – | – | 受控 value: - `multiple=false`:`string`(单 key)/ `undefined`(未选) - `multiple=true`:`string[]` |
-| `defaultValue` | `string \| string[]` | – | – | uncontrolled 初值。 |
-| `onChange` | `(value: string \| string[]) => void` | – | – | value 变化回调。 |
-| `defaultExpandAll` | `boolean` | `false` | – | 默认展开全部节点(antd `treeDefaultExpandAll` 并集)。 |
-| `placeholder` | `string` | `"请选择"` | – | 占位文本。 |
-| `disabled` | `boolean` | – | – | 整体禁用。 |
-| `className` | `string` | – | – | 触发器 className。 |
-| `size` | `'sm' \| 'default' \| 'lg'` | `"default"` | – | 触发器尺寸。 |
+
+| 名称               | 类型                                  | 默认值      | 必填 | 说明                                                                                            |
+| ------------------ | ------------------------------------- | ----------- | ---- | ----------------------------------------------------------------------------------------------- |
+| `data`             | `TreeNode[]`                          | –           | ✓    | 树形数据(antd `treeData` 并集)。                                                                |
+| `multiple`         | `boolean`                             | `false`     | –    | 多选模式 — 启用后下拉内的 Tree 变为 checkable;value 是 key 数组。                               |
+| `value`            | `string \| string[]`                  | –           | –    | 受控 value: - `multiple=false`:`string`(单 key)/ `undefined`(未选) - `multiple=true`:`string[]` |
+| `defaultValue`     | `string \| string[]`                  | –           | –    | uncontrolled 初值。                                                                             |
+| `onChange`         | `(value: string \| string[]) => void` | –           | –    | value 变化回调。                                                                                |
+| `defaultExpandAll` | `boolean`                             | `false`     | –    | 默认展开全部节点(antd `treeDefaultExpandAll` 并集)。                                            |
+| `placeholder`      | `string`                              | `"请选择"`  | –    | 占位文本。                                                                                      |
+| `disabled`         | `boolean`                             | –           | –    | 整体禁用。                                                                                      |
+| `className`        | `string`                              | –           | –    | 触发器 className。                                                                              |
+| `size`             | `'sm' \| 'default' \| 'lg'`           | `"default"` | –    | 触发器尺寸。                                                                                    |
+
 <!-- auto:props:end -->
 
+## 依赖
+
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add tree-select` 时,以下 entry 会被自动连带安装(无需手动 add)。
 
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
-| `button` | component | 通用按钮 — shadcn 实现 + antd 功能扩展(loading / icon / shape / block / dashed variant) |
-| `popover` | component | 可交互浮层 — Radix Popover + antd arrow 并集 |
-| `tree` | component | 树形控件 — antd 独有补足。递归层级展示(目录、组织、分类),可展开 / 可选 / 可勾选(父子级联 + 半选),受控与非受控并存 |
+| Entry     | 类型      | 描述                                                                                                              |
+| --------- | --------- | ----------------------------------------------------------------------------------------------------------------- |
+| `cn`      | util      | Tailwind className 合并工具(clsx + tailwind-merge)                                                                |
+| `button`  | component | 通用按钮 — shadcn 实现 + antd 功能扩展(loading / icon / shape / block / dashed variant)                           |
+| `popover` | component | 可交互浮层 — Radix Popover + antd arrow 并集                                                                      |
+| `tree`    | component | 树形控件 — antd 独有补足。递归层级展示(目录、组织、分类),可展开 / 可选 / 可勾选(父子级联 + 半选),受控与非受控并存 |
 
 ### npm 依赖
 
@@ -57,6 +65,7 @@ package: "@teamix-evo/ui"
 ```bash
 pnpm add lucide-react@^0.460.0
 ```
+
 <!-- auto:deps:end -->
 
 ## AI 生成纪律
@@ -92,9 +101,15 @@ const data = [
 ];
 
 // 单选
-<TreeSelect data={data} defaultExpandAll />
+<TreeSelect data={data} defaultExpandAll />;
 
 // 多选 + 受控
 const [v, setV] = React.useState<string[]>(['fe', 'be']);
-<TreeSelect data={data} multiple defaultExpandAll value={v} onChange={(next) => setV(next as string[])} />
+<TreeSelect
+  data={data}
+  multiple
+  defaultExpandAll
+  value={v}
+  onChange={(next) => setV(next as string[])}
+/>;
 ```

package/src/components/tree-select/tree-select.stories.tsx

@@ -10,7 +10,7 @@ const meta: Meta<typeof TreeSelect> = {
     docs: {
       description: {
         component:
-          '树形下拉 — Tree 嵌入 Popover,单选(selectable)或多选(checkable)两种模式。组织架构 / 分类树形选择 / 文件夹路径选择常用。等价 antd `TreeSelect`。视觉走 OpenTrek tokens,所有样式来自 `@teamix-evo/design`,无 mock。',
+          '树形下拉 — Tree 嵌入 Popover，单选（selectable）或多选（checkable）两种模式。组织架构 / 分类树形选择 / 文件夹路径选择常用。等价 antd `TreeSelect`。',
       },
     },
   },

package/src/components/tree-select/tree-select.tsx

@@ -126,7 +126,7 @@ const TreeSelect = React.forwardRef<HTMLButtonElement, TreeSelectProps>(
             size={size}
             disabled={disabled}
             className={cn(
-              'min-w-[200px] justify-between font-normal',
+              'min-w-panel-sm justify-between font-normal',
               !display && 'text-muted-foreground',
               className,
             )}

package/src/components/typography/typography.meta.md

@@ -1,13 +1,14 @@
 ---
 id: typography
 name: Typography
+displayName: 排版
 type: component
 category: data-display
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
 ---
 
-# Typography
+# Typography 排版
 
 排版组件 — `Prose`(富文本容器)+ shadcn 风格 `Title / Paragraph / Text / Link` + antd `Text` 的 `type / strong / delete / disabled / code / ellipsis / copyable` 并集。
 
@@ -27,26 +28,51 @@ package: "@teamix-evo/ui"
 - 单一颜色文本 → 直接 `<span className="text-...">`,无需包装
 - 多行 ellipsis(2 行 / 3 行) → 自行 `line-clamp-N`(本组件 ellipsis 仅单行)
 
+## Props
+
+> 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成，数据源是 [`typography.tsx`](./typography.tsx) 的 `TextProps` interface JSDoc。
+
 <!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `type` | `TextType` | `"default"` | – | 语义色(antd `type` 并集)。 |
-| `delete` | `boolean` | `false` | – | 删除线。 |
-| `disabled` | `boolean` | `false` | – | 不可用(灰色 + 不可选)。 |
-| `strong` | `boolean` | `false` | – | 加粗。 |
-| `code` | `boolean` | `false` | – | 行内代码样式(`code`)。 |
-| `ellipsis` | `boolean` | `false` | – | 单行省略(antd `ellipsis` 简化版 — 只支持 boolean,行数 / suffix 留 v0.x)。 |
-| `copyable` | `boolean \| { text: string; tooltips?: [string, string] }` | `false` | – | 可复制(antd `copyable` 并集)— 末尾追加复制图标按钮。 传对象时可指定要复制的文本(默认是 children 的纯文本);传 `true` 用 children。 |
+
+#### Text
+
+| 名称       | 类型                                                       | 默认值      | 必填 | 说明                                                                                                                              |
+| ---------- | ---------------------------------------------------------- | ----------- | ---- | --------------------------------------------------------------------------------------------------------------------------------- |
+| `type`     | `TextType`                                                 | `"default"` | –    | 语义色(antd `type` 并集)。                                                                                                        |
+| `delete`   | `boolean`                                                  | `false`     | –    | 删除线。                                                                                                                          |
+| `disabled` | `boolean`                                                  | `false`     | –    | 不可用(灰色 + 不可选)。                                                                                                           |
+| `strong`   | `boolean`                                                  | `false`     | –    | 加粗。                                                                                                                            |
+| `code`     | `boolean`                                                  | `false`     | –    | 行内代码样式(`code`)。                                                                                                            |
+| `ellipsis` | `boolean`                                                  | `false`     | –    | 单行省略(antd `ellipsis` 简化版 — 只支持 boolean,行数 / suffix 留 v0.x)。                                                         |
+| `copyable` | `boolean \| { text: string; tooltips?: [string, string] }` | `false`     | –    | 可复制(antd `copyable` 并集)— 末尾追加复制图标按钮。 传对象时可指定要复制的文本(默认是 children 的纯文本);传 `true` 用 children。 |
+
+#### Title
+
+| 名称    | 类型                    | 默认值 | 必填 | 说明                                                    |
+| ------- | ----------------------- | ------ | ---- | ------------------------------------------------------- |
+| `level` | `1 \| 2 \| 3 \| 4 \| 5` | `1`    | –    | 层级(1~5),决定字号 / 粗细;同时映射为 `<h1>~<h5>` 标签。 |
+
+#### Link
+
+| 名称   | 类型       | 默认值      | 必填 | 说明                      |
+| ------ | ---------- | ----------- | ---- | ------------------------- |
+| `type` | `TextType` | `"default"` | –    | 语义色(同 Text 的 type)。 |
+
 <!-- auto:props:end -->
 
+## 依赖
+
+> 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成，数据源是 [`manifest.json`](../../../manifest.json)。**手工编辑 marker 之间的内容会在下次生成时被覆盖**。
+
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add typography` 时,以下 entry 会被自动连带安装(无需手动 add)。
 
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
+| Entry | 类型 | 描述                                               |
+| ----- | ---- | -------------------------------------------------- |
+| `cn`  | util | Tailwind className 合并工具(clsx + tailwind-merge) |
 
 ### npm 依赖
 
@@ -55,9 +81,8 @@ package: "@teamix-evo/ui"
 ```bash
 pnpm add lucide-react@^0.460.0
 ```
-<!-- auto:deps:end -->
 
-> 子组件:`Prose` / `Title`(level 1~5)/ `Paragraph` / `Text`(type / strong / delete / disabled / code / ellipsis / copyable)/ `Link`。各自的 props 详见 [`typography.tsx`](./typography.tsx)。
+<!-- auto:deps:end -->
 
 ## AI 生成纪律
 

package/src/components/typography/typography.stories.tsx

@@ -9,7 +9,7 @@ const meta: Meta<typeof Text> = {
     docs: {
       description: {
         component:
-          '排版组件 — Prose 富文本容器 + Title/Paragraph/Text/Link,合并 antd 的 type/strong/delete/disabled/code/ellipsis/copyable 能力。OpenTrek tokens 适配,无 mock。',
+          '排版组件 — Prose 富文本容器 + Title / Paragraph / Text / Link，合并 antd 的 `type` / `strong` / `delete` / `disabled` / `code` / `ellipsis` / `copyable` 能力。',
       },
     },
   },
@@ -76,11 +76,7 @@ export const Links: Story = {
       <Link href="#docs" onClick={(e) => e.preventDefault()}>
         文档
       </Link>
-      <Link
-        href="#delete"
-        type="danger"
-        onClick={(e) => e.preventDefault()}
-      >
+      <Link href="#delete" type="danger" onClick={(e) => e.preventDefault()}>
         危险操作链接
       </Link>
     </div>
@@ -98,8 +94,8 @@ export const ProseDemo: Story = {
       </p>
       <h2>子标题</h2>
       <p>
-        访问 <a href="#">链接</a> 查看更多。<strong>强调</strong>{' '}
-        <em>斜体</em> <code>inline-code</code>。
+        访问 <a href="#">链接</a> 查看更多。<strong>强调</strong> <em>斜体</em>{' '}
+        <code>inline-code</code>。
       </p>
       <ul>
         <li>列表项 1</li>

package/src/components/typography/typography.tsx

@@ -35,6 +35,7 @@ const Prose = React.forwardRef<HTMLDivElement, ProseProps>(
         '[&_strong]:font-semibold',
         '[&_em]:italic',
         // code
+        // eslint-disable-next-line teamix-evo/no-arbitrary-tw-value -- inline `<code>` uses em-relative size to scale with surrounding text; not tokenizable since it depends on parent context.
         '[&_code]:rounded [&_code]:bg-muted [&_code]:px-1.5 [&_code]:py-0.5 [&_code]:font-mono [&_code]:text-[0.875em]',
         '[&_pre]:my-4 [&_pre]:overflow-x-auto [&_pre]:rounded-md [&_pre]:bg-muted [&_pre]:p-4',
         '[&_pre_code]:bg-transparent [&_pre_code]:p-0',
@@ -143,8 +144,8 @@ export interface TextProps extends React.HTMLAttributes<HTMLSpanElement> {
 const typeColor: Record<TextType, string> = {
   default: 'text-foreground',
   secondary: 'text-muted-foreground',
-  success: 'text-emerald-600',
-  warning: 'text-amber-600',
+  success: 'text-success',
+  warning: 'text-warning',
   danger: 'text-destructive',
 };
 
@@ -185,6 +186,7 @@ const Text = React.forwardRef<HTMLSpanElement, TextProps>(
       disabled && 'cursor-not-allowed select-none opacity-50',
       ellipsis && 'inline-block max-w-full truncate align-bottom',
       code &&
+        // eslint-disable-next-line teamix-evo/no-arbitrary-tw-value -- inline `<code>` uses em-relative size to scale with surrounding text; not tokenizable.
         'rounded bg-muted px-1.5 py-0.5 font-mono text-[0.875em]',
       className,
     );
@@ -202,7 +204,7 @@ const Text = React.forwardRef<HTMLSpanElement, TextProps>(
             className="rounded-sm p-0.5 text-muted-foreground transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring"
           >
             {copied ? (
-              <Check className="size-3.5 text-emerald-600" />
+              <Check className="size-3.5 text-success" />
             ) : (
               <Copy className="size-3.5" />
             )}

package/src/components/upload/upload.meta.md

@@ -1,13 +1,14 @@
 ---
 id: upload
 name: Upload
+displayName: 上传
 type: component
 category: form
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
 ---
 
-# Upload
+# Upload 上传
 
 文件上传 — antd 独有补足。支持**点击 + 拖拽**双模式(`dragger`)、多文件、accept 过滤、`maxCount` / `maxSize` 校验、内置文件列表(显示文件名 / 进度 / 移除按钮)。**只负责前端选择与列表呈现 — 实际上传请求由消费方在 `onChange` 中发起**(组件不内置 XHR)。
 
@@ -22,34 +23,41 @@ package: "@teamix-evo/ui"
 - 仅需读取本地图片用于客户端预览 → 直接用 `<input type="file">`
 - 服务端推送式同步 → 不在本组件职责内
 
+## Props
+
 <!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `fileList` | `UploadFileItem[]` | – | – | 已上传文件列表(受控)— 不传则组件内部维护本地列表(限制少,通常配 onChange)。 |
-| `accept` | `string` | – | – | 文件接受类型(等价 input.accept) — e.g. `image/*`, `.pdf,.docx`。 |
-| `multiple` | `boolean` | `false` | – | 是否支持多文件选择(antd `multiple` 并集)。 |
-| `maxCount` | `number` | – | – | 最大文件数(超出则忽略,触发 `onExceed`)。 |
-| `maxSize` | `number` | – | – | 单文件最大字节数(超出则忽略,触发 `onExceed`)。 |
-| `dragger` | `boolean` | `false` | – | 启用拖拽上传(antd `Dragger` 并集) — 显示大块虚线区,可点击亦可拖拽。 |
-| `disabled` | `boolean` | – | – | 禁用上传(已选文件不可删除)。 |
-| `showFileList` | `boolean` | `true` | – | 是否显示文件列表(antd `showUploadList` 并集)。 |
-| `onChange` | `(next: UploadFileItem[]) => void` | – | – | 文件被添加(用户选择 / 拖入)时的回调 — 返回更新后的列表。 |
-| `onRemove` | `(file: UploadFileItem) => void` | – | – | 文件被移除时的回调。 |
-| `onExceed` | `(rejected: File[], reason: 'count' \| 'size') => void` | – | – | 超出 maxCount / maxSize 时的回调。 |
-| `children` | `React.ReactNode` | – | – | 触发器自定义内容(非 dragger 模式下渲染于 Button 内)。 |
-| `className` | `string` | – | – | – |
+
+| 名称           | 类型                                                    | 默认值  | 必填 | 说明                                                                       |
+| -------------- | ------------------------------------------------------- | ------- | ---- | -------------------------------------------------------------------------- |
+| `fileList`     | `UploadFileItem[]`                                      | –       | –    | 已上传文件列表(受控)— 不传则组件内部维护本地列表(限制少,通常配 onChange)。 |
+| `accept`       | `string`                                                | –       | –    | 文件接受类型(等价 input.accept) — e.g. `image/*`, `.pdf,.docx`。           |
+| `multiple`     | `boolean`                                               | `false` | –    | 是否支持多文件选择(antd `multiple` 并集)。                                 |
+| `maxCount`     | `number`                                                | –       | –    | 最大文件数(超出则忽略,触发 `onExceed`)。                                   |
+| `maxSize`      | `number`                                                | –       | –    | 单文件最大字节数(超出则忽略,触发 `onExceed`)。                             |
+| `dragger`      | `boolean`                                               | `false` | –    | 启用拖拽上传(antd `Dragger` 并集) — 显示大块虚线区,可点击亦可拖拽。        |
+| `disabled`     | `boolean`                                               | –       | –    | 禁用上传(已选文件不可删除)。                                               |
+| `showFileList` | `boolean`                                               | `true`  | –    | 是否显示文件列表(antd `showUploadList` 并集)。                             |
+| `onChange`     | `(next: UploadFileItem[]) => void`                      | –       | –    | 文件被添加(用户选择 / 拖入)时的回调 — 返回更新后的列表。                   |
+| `onRemove`     | `(file: UploadFileItem) => void`                        | –       | –    | 文件被移除时的回调。                                                       |
+| `onExceed`     | `(rejected: File[], reason: 'count' \| 'size') => void` | –       | –    | 超出 maxCount / maxSize 时的回调。                                         |
+| `children`     | `React.ReactNode`                                       | –       | –    | 触发器自定义内容(非 dragger 模式下渲染于 Button 内)。                      |
+| `className`    | `string`                                                | –       | –    | –                                                                          |
+
 <!-- auto:props:end -->
 
+## 依赖
+
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add upload` 时,以下 entry 会被自动连带安装(无需手动 add)。
 
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
-| `button` | component | 通用按钮 — shadcn 实现 + antd 功能扩展(loading / icon / shape / block / dashed variant) |
-| `progress` | component | 进度条 — Radix 线性 + antd 的 status / showInfo / size 并集 + 配套 ProgressCircle 环形 |
+| Entry      | 类型      | 描述                                                                                    |
+| ---------- | --------- | --------------------------------------------------------------------------------------- |
+| `cn`       | util      | Tailwind className 合并工具(clsx + tailwind-merge)                                      |
+| `button`   | component | 通用按钮 — shadcn 实现 + antd 功能扩展(loading / icon / shape / block / dashed variant) |
+| `progress` | component | 进度条 — Radix 线性 + antd 的 status / showInfo / size 并集 + 配套 ProgressCircle 环形  |
 
 ### npm 依赖
 
@@ -58,6 +66,7 @@ package: "@teamix-evo/ui"
 ```bash
 pnpm add lucide-react@^0.460.0
 ```
+
 <!-- auto:deps:end -->
 
 ## AI 生成纪律

package/src/components/upload/upload.stories.tsx

@@ -10,7 +10,7 @@ const meta: Meta<typeof Upload> = {
     docs: {
       description: {
         component:
-          '文件上传 — 支持点击 + 拖拽双模式(Dragger),内置 maxCount / maxSize 校验、文件列表、进度条。组件只负责前端选择与列表呈现,真实上传请求由消费方在 onChange 中发起。视觉走 OpenTrek tokens,等价 antd `Upload` + `Upload.Dragger`,所有样式来自 `@teamix-evo/design`,无 mock。',
+          '文件上传 — 支持点击 + 拖拽双模式（Dragger），内置 maxCount / maxSize 校验、文件列表、进度条。组件只负责前端选择与列表呈现，真实上传请求由消费方在 onChange 中发起。等价 antd `Upload` + `Upload.Dragger`。',
       },
     },
   },
@@ -30,9 +30,7 @@ export const Playground: Story = {};
 
 export const Dragger: Story = {
   parameters: { controls: { disable: true } },
-  render: () => (
-    <Upload dragger multiple accept=".csv,.xlsx,.json" />
-  ),
+  render: () => <Upload dragger multiple accept=".csv,.xlsx,.json" />,
 };
 
 export const WithLimits: Story = {
@@ -43,8 +41,11 @@ export const WithLimits: Story = {
       maxCount={3}
       maxSize={2 * 1024 * 1024}
       onExceed={(rej, reason) =>
-        // eslint-disable-next-line no-alert
-        alert(`${reason === 'count' ? '超出最大文件数' : '超出最大文件大小'}: ${rej.map((f) => f.name).join(', ')}`)
+        alert(
+          `${reason === 'count' ? '超出最大文件数' : '超出最大文件大小'}: ${rej
+            .map((f) => f.name)
+            .join(', ')}`,
+        )
       }
     />
   ),
@@ -58,14 +59,7 @@ export const ControlledProgress: Story = {
       { uid: 'demo-2', name: 'cover.png', status: 'done' },
       { uid: 'demo-3', name: 'broken.zip', status: 'error' },
     ]);
-    return (
-      <Upload
-        dragger
-        multiple
-        fileList={files}
-        onChange={setFiles}
-      />
-    );
+    return <Upload dragger multiple fileList={files} onChange={setFiles} />;
   },
 };