@teamix-evo/ui 0.1.1 → 0.2.0

package/src/components/pagination/pagination.meta.md

@@ -1,15 +1,17 @@
 ---
 id: pagination
 name: Pagination
+displayName: 分页
 type: component
 category: navigation
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
 ---
 
-# Pagination
+# Pagination 分页
 
 分页 — 两套 API:
+
 1. **shadcn primitives**(`Pagination / Content / Item / Link / Previous / Next / Ellipsis`)— 完全可组合,适合自定义复杂分页布局
 2. **`SimplePagination`**(antd 风格 props 化高阶包装)— `total / pageSize / current / onChange` 即用,**自动计算页码窗口 + 折叠 ellipsis + 显示总数**
 
@@ -26,20 +28,30 @@ package: "@teamix-evo/ui"
 
 ## Props
 
-> 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成。下表是 `SimplePagination` 的 props(高阶 API);primitives 的 props 详见 [`pagination.tsx`](./pagination.tsx)。
+> 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成。
 
 <!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `current` | `number` | – | – | 当前页(1-based)。 |
-| `onChange` | `(page: number) => void` | – | – | 受控变化回调。 |
-| `total` | `number` | – | ✓ | 总条数。 |
-| `pageSize` | `number` | `10` | – | 每页大小。 |
-| `showFirstLast` | `boolean` | `false` | – | 是否显示首末页快捷按钮。 |
-| `showTotal` | `boolean` | `true` | – | 是否显示总数文本(antd `showTotal` 并集,简化版)。 |
-| `totalRender` | `(total: number, range: [number, number]) => React.ReactNode` | – | – | 自定义总数渲染。返回字符串或 ReactNode。 |
-| `siblingCount` | `number` | `5` | – | 显示页号窗口大小(中间显示几个页号)。 |
-| `className` | `string` | – | – | 容器 className。 |
+
+#### SimplePagination
+
+| 名称            | 类型                                                          | 默认值  | 必填 | 说明                                             |
+| --------------- | ------------------------------------------------------------- | ------- | ---- | ------------------------------------------------ |
+| `current`       | `number`                                                      | –       | –    | 当前页(1-based)。                                |
+| `onChange`      | `(page: number) => void`                                      | –       | –    | 受控变化回调。                                   |
+| `total`         | `number`                                                      | –       | ✓    | 总条数。                                         |
+| `pageSize`      | `number`                                                      | `10`    | –    | 每页大小。                                       |
+| `showFirstLast` | `boolean`                                                     | `false` | –    | 是否显示首末页快捷按钮。                         |
+| `showTotal`     | `boolean`                                                     | `true`  | –    | 是否显示总数文本(antd `showTotal` 并集,简化版)。 |
+| `totalRender`   | `(total: number, range: [number, number]) => React.ReactNode` | –       | –    | 自定义总数渲染。返回字符串或 ReactNode。         |
+| `siblingCount`  | `number`                                                      | `5`     | –    | 显示页号窗口大小(中间显示几个页号)。             |
+| `className`     | `string`                                                      | –       | –    | 容器 className。                                 |
+
+#### PaginationLink
+
+| 名称       | 类型      | 默认值 | 必填 | 说明                 |
+| ---------- | --------- | ------ | ---- | -------------------- |
+| `isActive` | `boolean` | –      | –    | 当前激活状态(高亮)。 |
+
 <!-- auto:props:end -->
 
 ## 依赖
@@ -47,13 +59,14 @@ package: "@teamix-evo/ui"
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成,数据源是 [`manifest.json`](../../../manifest.json)。**手工编辑 marker 之间的内容会在下次生成时被覆盖**。
 
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add pagination` 时,以下 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 依赖
@@ -63,9 +76,8 @@ package: "@teamix-evo/ui"
 ```bash
 pnpm add lucide-react@^0.460.0
 ```
-<!-- auto:deps:end -->
 
-> 子组件(primitives):`Pagination`(nav)/ `PaginationContent`(ul)/ `PaginationItem`(li)/ `PaginationLink`(支持 `isActive`)/ `PaginationPrevious` / `PaginationNext` / `PaginationEllipsis`。
+<!-- auto:deps:end -->
 
 ## AI 生成纪律
 
@@ -110,18 +122,37 @@ const [page, setPage] = React.useState(1);
 ```tsx
 // 自由组合(primitives)
 import {
-  Pagination, PaginationContent, PaginationItem, PaginationLink,
-  PaginationPrevious, PaginationNext, PaginationEllipsis,
+  Pagination,
+  PaginationContent,
+  PaginationItem,
+  PaginationLink,
+  PaginationPrevious,
+  PaginationNext,
+  PaginationEllipsis,
 } from '@/components/ui/pagination';
 
 <Pagination>
   <PaginationContent>
-    <PaginationItem><PaginationPrevious href="#" /></PaginationItem>
-    <PaginationItem><PaginationLink href="#">1</PaginationLink></PaginationItem>
-    <PaginationItem><PaginationLink href="#" isActive>2</PaginationLink></PaginationItem>
-    <PaginationItem><PaginationLink href="#">3</PaginationLink></PaginationItem>
-    <PaginationItem><PaginationEllipsis /></PaginationItem>
-    <PaginationItem><PaginationNext href="#" /></PaginationItem>
+    <PaginationItem>
+      <PaginationPrevious href="#" />
+    </PaginationItem>
+    <PaginationItem>
+      <PaginationLink href="#">1</PaginationLink>
+    </PaginationItem>
+    <PaginationItem>
+      <PaginationLink href="#" isActive>
+        2
+      </PaginationLink>
+    </PaginationItem>
+    <PaginationItem>
+      <PaginationLink href="#">3</PaginationLink>
+    </PaginationItem>
+    <PaginationItem>
+      <PaginationEllipsis />
+    </PaginationItem>
+    <PaginationItem>
+      <PaginationNext href="#" />
+    </PaginationItem>
   </PaginationContent>
-</Pagination>
+</Pagination>;
 ```

package/src/components/pagination/pagination.stories.tsx

@@ -6,6 +6,14 @@ const meta: Meta<typeof SimplePagination> = {
   title: '导航 · Navigation/Pagination',
   component: SimplePagination,
   tags: ['autodocs'],
+  parameters: {
+    docs: {
+      description: {
+        component:
+          '分页 — 两套 API:SimplePagination(antd 风格 props 化,total / pageSize / current / onChange 即用) + shadcn primitives(完全可组合)。自动计算页码窗口 + 折叠 ellipsis + 显示总数。',
+      },
+    },
+  },
   argTypes: {
     total: { control: 'number' },
     pageSize: { control: 'number' },
@@ -23,9 +31,7 @@ type Story = StoryObj<typeof SimplePagination>;
 export const Playground: Story = {
   render: (args) => {
     const [page, setPage] = React.useState(args.current ?? 1);
-    return (
-      <SimplePagination {...args} current={page} onChange={setPage} />
-    );
+    return <SimplePagination {...args} current={page} onChange={setPage} />;
   },
 };
 

package/src/components/popconfirm/popconfirm.meta.md

@@ -4,10 +4,11 @@ name: Popconfirm
 type: component
 category: feedback
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
+displayName: 气泡确认
 ---
 
-# Popconfirm
+# Popconfirm 气泡确认
 
 轻量级确认弹层 — antd 独有补足。**等价 antd `Popconfirm`**。用于"小风险"操作的二次确认(删除一行、忽略某条通知),视觉比 `AlertDialog` 更轻、不阻塞页面;`onConfirm` 支持返回 Promise(等待时按钮自动 loading)。
 
@@ -23,33 +24,40 @@ package: "@teamix-evo/ui"
 - 无后果的纯展示 → `Tooltip` / `Popover`
 - 长决策路径(需要填写理由)→ `Dialog` / `Drawer`
 
+## Props
+
 <!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `children` | `React.ReactElement` | – | ✓ | 触发节点(通常是 Button / a)。 |
-| `title` | `React.ReactNode` | – | ✓ | 主标题(antd `title` 并集)。 |
-| `description` | `React.ReactNode` | – | – | 副描述(antd `description` 并集) — 解释操作后果。 |
-| `icon` | `React.ReactNode` | – | – | 触发图标(antd `icon` 并集) — 默认警示图标。 |
-| `okText` | `string` | `"确定"` | – | 确认按钮文本(antd `okText` 并集)。 |
-| `cancelText` | `string` | `"取消"` | – | 取消按钮文本(antd `cancelText` 并集)。 |
-| `okType` | `'default' \| 'destructive'` | `"default"` | – | 确认按钮 variant(antd `okType` 并集) — 危险操作请用 `destructive`。 |
-| `onConfirm` | `() => void \| Promise<void>` | – | – | 确认回调。 |
-| `onCancel` | `() => void` | – | – | 取消回调。 |
-| `open` | `boolean` | – | – | 受控 open(antd `open` 并集) — 不传时本组件自管 open 状态。 |
-| `onOpenChange` | `(next: boolean) => void` | – | – | open 变化回调。 |
-| `disabled` | `boolean` | – | – | 禁用(子节点点击不弹出)。 |
+
+| 名称           | 类型                          | 默认值      | 必填 | 说明                                                                |
+| -------------- | ----------------------------- | ----------- | ---- | ------------------------------------------------------------------- |
+| `children`     | `React.ReactElement`          | –           | ✓    | 触发节点(通常是 Button / a)。                                       |
+| `title`        | `React.ReactNode`             | –           | ✓    | 主标题(antd `title` 并集)。                                         |
+| `description`  | `React.ReactNode`             | –           | –    | 副描述(antd `description` 并集) — 解释操作后果。                    |
+| `icon`         | `React.ReactNode`             | –           | –    | 触发图标(antd `icon` 并集) — 默认警示图标。                         |
+| `okText`       | `string`                      | `"确定"`    | –    | 确认按钮文本(antd `okText` 并集)。                                  |
+| `cancelText`   | `string`                      | `"取消"`    | –    | 取消按钮文本(antd `cancelText` 并集)。                              |
+| `okType`       | `'default' \| 'destructive'`  | `"default"` | –    | 确认按钮 variant(antd `okType` 并集) — 危险操作请用 `destructive`。 |
+| `onConfirm`    | `() => void \| Promise<void>` | –           | –    | 确认回调。                                                          |
+| `onCancel`     | `() => void`                  | –           | –    | 取消回调。                                                          |
+| `open`         | `boolean`                     | –           | –    | 受控 open(antd `open` 并集) — 不传时本组件自管 open 状态。          |
+| `onOpenChange` | `(next: boolean) => void`     | –           | –    | open 变化回调。                                                     |
+| `disabled`     | `boolean`                     | –           | –    | 禁用(子节点点击不弹出)。                                            |
+
 <!-- auto:props:end -->
 
+## 依赖
+
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add popconfirm` 时,以下 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 并集 |
+| Entry     | 类型      | 描述                                                                                    |
+| --------- | --------- | --------------------------------------------------------------------------------------- |
+| `cn`      | util      | Tailwind className 合并工具(clsx + tailwind-merge)                                      |
+| `button`  | component | 通用按钮 — shadcn 实现 + antd 功能扩展(loading / icon / shape / block / dashed variant) |
+| `popover` | component | 可交互浮层 — Radix Popover + antd arrow 并集                                            |
 
 ### npm 依赖
 
@@ -58,6 +66,7 @@ package: "@teamix-evo/ui"
 ```bash
 pnpm add lucide-react@^0.460.0
 ```
+
 <!-- auto:deps:end -->
 
 ## AI 生成纪律

package/src/components/popconfirm/popconfirm.stories.tsx

@@ -11,7 +11,7 @@ const meta: Meta<typeof Popconfirm> = {
     docs: {
       description: {
         component:
-          '轻量级确认弹层 — 小风险操作的二次确认(删除一行 / 忽略一条通知)。视觉比 AlertDialog 更轻、不阻塞页面;onConfirm 支持 Promise(等待时按钮自动 loading)。等价 antd `Popconfirm`。视觉走 OpenTrek tokens,所有样式来自 `@teamix-evo/design`,无 mock。',
+          '轻量级确认弹层 — 小风险操作的二次确认（删除一行 / 忽略一条通知）。视觉比 AlertDialog 更轻、不阻塞页面；onConfirm 支持 Promise（等待时按钮自动 loading）。等价 antd `Popconfirm`。',
       },
     },
   },
@@ -57,7 +57,6 @@ export const CustomIcon: Story = {
       title="重置所有筛选条件?"
       icon={<RefreshCcw className="size-4 text-primary" />}
       onConfirm={() => {
-        // eslint-disable-next-line no-alert
         alert('已重置');
       }}
     >

package/src/components/popconfirm/popconfirm.tsx

@@ -94,7 +94,7 @@ const Popconfirm: React.FC<PopconfirmProps> = ({
       <PopoverTrigger asChild>{children}</PopoverTrigger>
       <PopoverContent className="w-72 p-3" align="start">
         <div className="flex items-start gap-2">
-          <span className="mt-0.5 text-amber-500">
+          <span className="mt-0.5 text-warning">
             {icon ?? <AlertCircle className="size-4" />}
           </span>
           <div className="min-w-0 flex-1">

package/src/components/popover/popover.meta.md

@@ -4,10 +4,11 @@ name: Popover
 type: component
 category: feedback
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
+displayName: 气泡卡片
 ---
 
-# Popover
+# Popover 气泡卡片
 
 可交互浮层 — Radix Popover + antd `arrow` 并集。
 **与 Tooltip 区别**:Popover 内可放任意交互元素(button / form / link),触发方式为 click(默认),不是 hover。
@@ -30,9 +31,11 @@ package: "@teamix-evo/ui"
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成。下表是 `PopoverContent` 的 props;`Popover`(Root)透传 Radix 的 `open / defaultOpen / onOpenChange / modal`。
 
 <!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `arrow` | `boolean` | `false` | – | 是否显示三角形箭头(antd `arrow` 并集)。 |
+
+| 名称    | 类型      | 默认值  | 必填 | 说明                                    |
+| ------- | --------- | ------- | ---- | --------------------------------------- |
+| `arrow` | `boolean` | `false` | –    | 是否显示三角形箭头(antd `arrow` 并集)。 |
+
 <!-- auto:props:end -->
 
 ## 依赖
@@ -40,13 +43,14 @@ package: "@teamix-evo/ui"
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成,数据源是 [`manifest.json`](../../../manifest.json)。**手工编辑 marker 之间的内容会在下次生成时被覆盖**。
 
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add popover` 时,以下 entry 会被自动连带安装(无需手动 add)。
 
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
+| Entry | 类型 | 描述                                               |
+| ----- | ---- | -------------------------------------------------- |
+| `cn`  | util | Tailwind className 合并工具(clsx + tailwind-merge) |
 
 ### npm 依赖
 
@@ -55,6 +59,7 @@ package: "@teamix-evo/ui"
 ```bash
 pnpm add @radix-ui/react-popover@^1.1.0
 ```
+
 <!-- auto:deps:end -->
 
 > 子组件:`Popover`(Root)/ `PopoverTrigger`(触发器,通常 asChild)/ `PopoverContent`(浮层内容)/ `PopoverClose`(关闭按钮)/ `PopoverAnchor`(独立锚点)。

package/src/components/popover/popover.stories.tsx

@@ -12,7 +12,7 @@ const meta: Meta<typeof PopoverContent> = {
     docs: {
       description: {
         component:
-          '气泡卡片 — 由 trigger 触发，在 portal 中展示富内容（表单、菜单、说明等）。Radix Popover 实现 + antd Popover 的语义并集：相比 Tooltip 仅承载纯文本提示，Popover 可承载任意交互内容；通过 `side` / `align` 控制方位，`arrow` 控制是否带尖角。视觉走 OpenTrek semantic tokens，所有样式来自 `@teamix-evo/design`，无 mock。',
+          '气泡卡片 — 由 trigger 触发，在 portal 中展示富内容（表单、菜单、说明等）。Radix Popover 实现 + antd Popover 的语义并集：相比 Tooltip 仅承载纯文本提示，Popover 可承载任意交互内容；通过 `side` / `align` 控制方位，`arrow` 控制是否带尖角。',
       },
     },
   },

package/src/components/progress/progress.meta.md

@@ -4,10 +4,11 @@ name: Progress
 type: component
 category: foundation
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
+displayName: 进度条
 ---
 
-# Progress
+# Progress 进度条
 
 进度条 — Radix Progress + antd 的 `status / showInfo / Progress.Circle` 并集。
 
@@ -28,12 +29,26 @@ package: "@teamix-evo/ui"
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成。
 
 <!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `value` | `number` | `0` | – | 当前百分比(0~100)。 |
-| `status` | `ProgressStatus` | `"normal"` | – | 状态色,自动优先级:`exception > warning > success > normal`。 |
-| `showInfo` | `boolean` | `false` | – | 是否在右侧显示百分比文字(antd showInfo 并集)。 |
-| `size` | `'sm' \| 'default' \| 'lg'` | `"default"` | – | 进度条尺寸。 |
+
+#### Progress
+
+| 名称       | 类型                        | 默认值      | 必填 | 说明                                                         |
+| ---------- | --------------------------- | ----------- | ---- | ------------------------------------------------------------ |
+| `value`    | `number`                    | `0`         | –    | 当前百分比(0~100)。                                          |
+| `status`   | `ProgressStatus`            | `"normal"`  | –    | 状态色,自动优先级:`exception > warning > success > normal`。 |
+| `showInfo` | `boolean`                   | `false`     | –    | 是否在右侧显示百分比文字(antd showInfo 并集)。               |
+| `size`     | `'sm' \| 'default' \| 'lg'` | `"default"` | –    | 进度条尺寸。                                                 |
+
+#### ProgressCircle
+
+| 名称          | 类型             | 默认值     | 必填 | 说明                       |
+| ------------- | ---------------- | ---------- | ---- | -------------------------- |
+| `value`       | `number`         | `0`        | –    | 当前百分比(0~100)。        |
+| `status`      | `ProgressStatus` | `"normal"` | –    | 状态色。                   |
+| `size`        | `number`         | `80`       | –    | 圆环直径(px)。             |
+| `strokeWidth` | `number`         | `6`        | –    | 圆环描边宽度(px)。         |
+| `showInfo`    | `boolean`        | `true`     | –    | 是否在圆心显示百分比文字。 |
+
 <!-- auto:props:end -->
 
 ## 依赖
@@ -41,13 +56,14 @@ package: "@teamix-evo/ui"
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成,数据源是 [`manifest.json`](../../../manifest.json)。**手工编辑 marker 之间的内容会在下次生成时被覆盖**。
 
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add progress` 时,以下 entry 会被自动连带安装(无需手动 add)。
 
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
+| Entry | 类型 | 描述                                               |
+| ----- | ---- | -------------------------------------------------- |
+| `cn`  | util | Tailwind className 合并工具(clsx + tailwind-merge) |
 
 ### npm 依赖
 
@@ -56,9 +72,8 @@ package: "@teamix-evo/ui"
 ```bash
 pnpm add @radix-ui/react-progress@^1.1.0
 ```
-<!-- auto:deps:end -->
 
-> `ProgressCircle` 的 props 详见 [`progress.tsx`](./progress.tsx) 的 `ProgressCircleProps` interface。
+<!-- auto:deps:end -->
 
 ## AI 生成纪律
 

package/src/components/progress/progress.stories.tsx

@@ -9,7 +9,7 @@ const meta: Meta<typeof Progress> = {
     docs: {
       description: {
         component:
-          '进度条 — 展示一个任务的完成进度，访问友好的状态反馈。Radix Progress 实现 + antd Progress 的能力并集：除默认线形（`Progress`）外还提供环形 `ProgressCircle`，支持 `status`（normal / success / warning / exception）、`size`、`showInfo` 以及任意 `format` 提示。视觉走 OpenTrek semantic tokens，所有样式来自 `@teamix-evo/design`，无 mock。',
+          '进度条 — 展示一个任务的完成进度，访问友好的状态反馈。Radix Progress 实现 + antd Progress 的能力并集：除默认线形（`Progress`）外还提供环形 `ProgressCircle`，支持 `status`（normal / success / warning / exception）、`size`、`showInfo` 以及任意 `format` 提示。',
       },
     },
   },

package/src/components/progress/progress.tsx

@@ -7,15 +7,15 @@ export type ProgressStatus = 'normal' | 'success' | 'warning' | 'exception';
 
 const statusBarColor: Record<ProgressStatus, string> = {
   normal: 'bg-primary',
-  success: 'bg-emerald-500',
-  warning: 'bg-amber-500',
+  success: 'bg-success',
+  warning: 'bg-warning',
   exception: 'bg-destructive',
 };
 
 const statusTextColor: Record<ProgressStatus, string> = {
   normal: 'text-foreground',
-  success: 'text-emerald-600',
-  warning: 'text-amber-600',
+  success: 'text-success',
+  warning: 'text-warning',
   exception: 'text-destructive',
 };
 
@@ -167,9 +167,9 @@ const ProgressCircle = React.forwardRef<HTMLDivElement, ProgressCircleProps>(
             className={cn(
               'fill-none transition-all',
               status === 'success'
-                ? 'stroke-emerald-500'
+                ? 'stroke-success'
                 : status === 'warning'
-                  ? 'stroke-amber-500'
+                  ? 'stroke-warning'
                   : status === 'exception'
                     ? 'stroke-destructive'
                     : 'stroke-primary',

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

@@ -1,20 +1,21 @@
 ---
 id: radio-group
 name: RadioGroup
+displayName: 单选组
 type: component
 category: form
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
 ---
 
-# RadioGroup
+# RadioGroup 单选组
 
 单选组 — Radix RadioGroup,**两种渲染**:
 
-| variant | 形态 | 适用 |
-| --- | --- | --- |
-| `default` | 圆点 + 文字(shadcn 风格) | 表单 / 设置面板 |
-| `button` | 按钮组(antd Radio.Button 并集) | 视图切换 / 时间区间切换 / 紧凑工具栏 |
+| variant   | 形态                           | 适用                                 |
+| --------- | ------------------------------ | ------------------------------------ |
+| `default` | 圆点 + 文字(shadcn 风格)       | 表单 / 设置面板                      |
+| `button`  | 按钮组(antd Radio.Button 并集) | 视图切换 / 时间区间切换 / 紧凑工具栏 |
 
 ## When to use
 
@@ -33,9 +34,11 @@ package: "@teamix-evo/ui"
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成。
 
 <!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `variant` | `'default' \| 'button'` | `"default"` | – | 渲染样式 — `default` 经典圆点;`button` 渲染为按钮组(antd `Radio.Button` 并集)。 |
+
+| 名称      | 类型                    | 默认值      | 必填 | 说明                                                                            |
+| --------- | ----------------------- | ----------- | ---- | ------------------------------------------------------------------------------- |
+| `variant` | `'default' \| 'button'` | `"default"` | –    | 渲染样式 — `default` 经典圆点;`button` 渲染为按钮组(antd `Radio.Button` 并集)。 |
+
 <!-- auto:props:end -->
 
 ## 依赖
@@ -43,13 +46,14 @@ package: "@teamix-evo/ui"
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成,数据源是 [`manifest.json`](../../../manifest.json)。**手工编辑 marker 之间的内容会在下次生成时被覆盖**。
 
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add radio-group` 时,以下 entry 会被自动连带安装(无需手动 add)。
 
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
+| Entry | 类型 | 描述                                               |
+| ----- | ---- | -------------------------------------------------- |
+| `cn`  | util | Tailwind className 合并工具(clsx + tailwind-merge) |
 
 ### npm 依赖
 
@@ -58,6 +62,7 @@ package: "@teamix-evo/ui"
 ```bash
 pnpm add @radix-ui/react-radio-group@^1.2.0 lucide-react@^0.460.0
 ```
+
 <!-- auto:deps:end -->
 
 > 子组件 `RadioGroupItem`(默认形态)/ `RadioGroupButton`(按钮形态)各自的 props 见 [`radio-group.tsx`](./radio-group.tsx)。

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

@@ -9,7 +9,7 @@ const meta: Meta<typeof RadioGroup> = {
     docs: {
       description: {
         component:
-          '单选组 — 在一组互斥选项中选中唯一一个。Radix RadioGroup 实现 + antd Radio 的并集能力：同时提供默认的点选型 `RadioGroupItem` 与按钮型 `RadioGroupButton`（对齐 antd `Radio.Button`），通过 `variant` prop 切换。视觉走 OpenTrek semantic tokens，所有样式来自 `@teamix-evo/design`，无 mock。',
+          '单选组 — 在一组互斥选项中选中唯一一个。Radix RadioGroup 实现 + antd Radio 的并集能力：同时提供默认的点选型 `RadioGroupItem` 与按钮型 `RadioGroupButton`（对齐 antd `Radio.Button`），通过 `variant` prop 切换。',
       },
     },
   },

package/src/components/rate/rate.meta.md

@@ -1,13 +1,14 @@
 ---
 id: rate
 name: Rate
+displayName: 评分
 type: component
 category: form
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
 ---
 
-# Rate
+# Rate 评分
 
 星级评分 — antd 独有补足。**等价 antd `Rate`**。支持半星(`allowHalf`)、再次点击清零(`allowClear`)、自定义图标(`character`)、只读展示(`disabled`)。
 
@@ -22,28 +23,35 @@ package: "@teamix-evo/ui"
 - 二元选择(喜欢 / 不喜欢)→ `Toggle` / `Button` 配 icon
 - 多档定量评分(0~100)→ `Slider`
 
+## Props
+
 <!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `count` | `number` | `5` | – | 总星数(antd `count` 并集)。 |
-| `value` | `number` | – | – | 受控值。 |
-| `defaultValue` | `number` | – | – | uncontrolled 初值。 |
-| `allowHalf` | `boolean` | `false` | – | 允许半星(antd `allowHalf` 并集) — 启用后单星可点击左半 / 右半。 |
-| `allowClear` | `boolean` | `true` | – | 允许再次点击同值清零(antd `allowClear` 并集)。 |
-| `disabled` | `boolean` | – | – | 禁用(只展示)。 |
-| `size` | `'sm' \| 'default' \| 'lg'` | `"default"` | – | 尺寸(影响星图大小)。 |
-| `character` | `React.ReactNode` | – | – | 自定义图标(antd `character` 并集) — 默认 `lucide-react` 的 `Star`。 |
-| `onChange` | `(value: number) => void` | – | – | value 变化回调。 |
+
+| 名称           | 类型                        | 默认值      | 必填 | 说明                                                                |
+| -------------- | --------------------------- | ----------- | ---- | ------------------------------------------------------------------- |
+| `count`        | `number`                    | `5`         | –    | 总星数(antd `count` 并集)。                                         |
+| `value`        | `number`                    | –           | –    | 受控值。                                                            |
+| `defaultValue` | `number`                    | –           | –    | uncontrolled 初值。                                                 |
+| `allowHalf`    | `boolean`                   | `false`     | –    | 允许半星(antd `allowHalf` 并集) — 启用后单星可点击左半 / 右半。     |
+| `allowClear`   | `boolean`                   | `true`      | –    | 允许再次点击同值清零(antd `allowClear` 并集)。                      |
+| `disabled`     | `boolean`                   | –           | –    | 禁用(只展示)。                                                      |
+| `size`         | `'sm' \| 'default' \| 'lg'` | `"default"` | –    | 尺寸(影响星图大小)。                                                |
+| `character`    | `React.ReactNode`           | –           | –    | 自定义图标(antd `character` 并集) — 默认 `lucide-react` 的 `Star`。 |
+| `onChange`     | `(value: number) => void`   | –           | –    | value 变化回调。                                                    |
+
 <!-- auto:props:end -->
 
+## 依赖
+
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add rate` 时,以下 entry 会被自动连带安装(无需手动 add)。
 
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
+| Entry | 类型 | 描述                                               |
+| ----- | ---- | -------------------------------------------------- |
+| `cn`  | util | Tailwind className 合并工具(clsx + tailwind-merge) |
 
 ### npm 依赖
 
@@ -52,6 +60,7 @@ package: "@teamix-evo/ui"
 ```bash
 pnpm add lucide-react@^0.460.0
 ```
+
 <!-- auto:deps:end -->
 
 ## AI 生成纪律