@teamix-evo/ui 0.1.1 → 0.2.0

package/src/components/button/demo/variants.tsx

@@ -0,0 +1,19 @@
+import { Button } from '@/components/ui/button';
+
+/**
+ * 七种 variant：default / secondary / destructive / outline / dashed / ghost / link。
+ * 视觉差异由 OpenTrek semantic tokens 决定，无任何 mock 值。
+ */
+export default function Demo() {
+  return (
+    <div className="flex flex-wrap items-center gap-3">
+      <Button>Default</Button>
+      <Button variant="secondary">Secondary</Button>
+      <Button variant="destructive">Destructive</Button>
+      <Button variant="outline">Outline</Button>
+      <Button variant="dashed">Dashed</Button>
+      <Button variant="ghost">Ghost</Button>
+      <Button variant="link">Link</Button>
+    </div>
+  );
+}

package/src/components/button/demo/with-icon.tsx

@@ -0,0 +1,20 @@
+import { ChevronRight, Download } from 'lucide-react';
+import { Button } from '@/components/ui/button';
+
+/**
+ * 带图标按钮：通过 `icon` prop 传入 lucide-react 节点；
+ * 用 `iconPosition` 切换图标位置（默认 start）。
+ */
+export default function Demo() {
+  return (
+    <div className="flex flex-wrap items-center gap-3">
+      <Button icon={<Download />}>下载</Button>
+      <Button icon={<ChevronRight />} iconPosition="end">
+        下一步
+      </Button>
+      <Button variant="outline" icon={<Download />}>
+        Outline + Icon
+      </Button>
+    </div>
+  );
+}

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

@@ -4,10 +4,11 @@ name: ButtonGroup
 type: component
 category: form
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
+displayName: 按钮组
 ---
 
-# ButtonGroup
+# ButtonGroup 按钮组
 
 按钮组 — shadcn 2025-10 新增,**等价 antd `Space.Compact`**(v6 替代旧 `Button.Group`)。把多个按钮 / 输入框"粘"在一起共享边线,用于 Split Button、Toolbar、Input + Button 拼装等场景。配 `ButtonGroupText` 渲染只读 addon 文本。
 
@@ -23,21 +24,28 @@ package: "@teamix-evo/ui"
 - 互斥单选切换 → `ToggleGroup`(语义更强)
 - 不相干的按钮 → 普通 `Button` + flex gap
 
+## Props
+
 <!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `orientation` | `'horizontal' \| 'vertical'` | `"horizontal"` | – | 排列方向。 |
-| `attached` | `boolean` | `true` | – | 是否把按钮"粘"在一起去除边距(antd `Space.Compact` 等价行为)— `false` 时按钮间留 8px gap。 |
+
+| 名称          | 类型                         | 默认值         | 必填 | 说明                                                                                      |
+| ------------- | ---------------------------- | -------------- | ---- | ----------------------------------------------------------------------------------------- |
+| `orientation` | `'horizontal' \| 'vertical'` | `"horizontal"` | –    | 排列方向。                                                                                |
+| `attached`    | `boolean`                    | `true`         | –    | 是否把按钮"粘"在一起去除边距(antd `Space.Compact` 等价行为)— `false` 时按钮间留 8px gap。 |
+
 <!-- auto:props:end -->
 
+## 依赖
+
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add button-group` 时,以下 entry 会被自动连带安装(无需手动 add)。
 
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
+| Entry | 类型 | 描述                                               |
+| ----- | ---- | -------------------------------------------------- |
+| `cn`  | util | Tailwind className 合并工具(clsx + tailwind-merge) |
 
 ### npm 依赖
 
@@ -46,6 +54,7 @@ package: "@teamix-evo/ui"
 ```bash
 pnpm add class-variance-authority@^0.7.0
 ```
+
 <!-- auto:deps:end -->
 
 ## AI 生成纪律

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

@@ -12,12 +12,15 @@ const meta: Meta<typeof ButtonGroup> = {
     docs: {
       description: {
         component:
-          '按钮组 — 把多个按钮 / 输入框粘在一起共享边线(Split Button、Toolbar、Input + Button 拼装)。配 ButtonGroupText 渲染只读 addon。shadcn 2025-10 新增,等价 antd `Space.Compact`(v6 替代旧 `Button.Group`)。视觉走 OpenTrek tokens,所有样式来自 `@teamix-evo/design`,无 mock。',
+          '按钮组 — 把多个按钮 / 输入框粘在一起共享边线（Split Button、Toolbar、Input + Button 拼装）。配 ButtonGroupText 渲染只读 addon。shadcn 2025-10 新增，等价 antd `Space.Compact`（v6 替代旧 `Button.Group`）。',
       },
     },
   },
   argTypes: {
-    orientation: { control: 'inline-radio', options: ['horizontal', 'vertical'] },
+    orientation: {
+      control: 'inline-radio',
+      options: ['horizontal', 'vertical'],
+    },
     attached: { control: 'boolean' },
   },
   args: { orientation: 'horizontal', attached: true },

package/src/components/calendar/calendar.meta.md

@@ -1,13 +1,14 @@
 ---
 id: calendar
 name: Calendar
+displayName: 日历
 type: component
 category: form
 since: 0.1.0
 package: '@teamix-evo/ui'
 ---
 
-# Calendar
+# Calendar 日历
 
 日期选择面板 — 基于 [`react-day-picker`](https://react-day-picker.js.org/),与 design tokens 对齐。
 **两种用法**:
@@ -32,11 +33,13 @@ package: '@teamix-evo/ui'
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成。
 
 <!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `className` | `string` | – | – | 容器 className。组件内部默认带 `p-3`,会与传入值自动 merge。 |
-| `classNames` | `DayPickerProps['classNames']` | – | – | 覆盖底层 react-day-picker 的 classNames slots(深度自定义日格 / 表头 / 导航等)。 |
-| `showOutsideDays` | `boolean` | `true` | – | 是否显示当月范围外的日期(灰色填充,占位补齐周表格)。 |
+
+| 名称              | 类型                           | 默认值 | 必填 | 说明                                                                            |
+| ----------------- | ------------------------------ | ------ | ---- | ------------------------------------------------------------------------------- |
+| `className`       | `string`                       | –      | –    | 容器 className。组件内部默认带 `p-3`,会与传入值自动 merge。                     |
+| `classNames`      | `DayPickerProps['classNames']` | –      | –    | 覆盖底层 react-day-picker 的 classNames slots(深度自定义日格 / 表头 / 导航等)。 |
+| `showOutsideDays` | `boolean`                      | `true` | –    | 是否显示当月范围外的日期(灰色填充,占位补齐周表格)。                             |
+
 <!-- auto:props:end -->
 
 ## 依赖
@@ -44,13 +47,14 @@ package: '@teamix-evo/ui'
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成,数据源是 [`manifest.json`](../../../manifest.json)。**手工编辑 marker 之间的内容会在下次生成时被覆盖**。
 
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add calendar` 时,以下 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 依赖
@@ -60,6 +64,7 @@ package: '@teamix-evo/ui'
 ```bash
 pnpm add react-day-picker@^9.0.0 lucide-react@^0.460.0
 ```
+
 <!-- auto:deps:end -->
 
 > 透传所有 react-day-picker `<DayPicker>` props(`mode` / `selected` / `onSelect` / `disabled` / `fromYear` / `toYear` / `numberOfMonths` 等)。完整 API:[react-day-picker.js.org](https://react-day-picker.js.org/)。

package/src/components/calendar/calendar.stories.tsx

@@ -12,7 +12,7 @@ const meta: Meta<typeof Calendar> = {
     docs: {
       description: {
         component:
-          '日历 — 内联日期选择面板。基于 [`react-day-picker@9`](https://daypicker.dev/) + design tokens，支持 `mode="single" | "multiple" | "range"` 三种选择模式、年份 / 月份导航、`disabled` 函数式禁用、`numberOfMonths` 多月并排；通常配 `Popover` 包装为 `DatePicker`。视觉走 OpenTrek semantic tokens，所有样式来自 `@teamix-evo/design`，无 mock。',
+          '日历 — 内联日期选择面板。基于 react-day-picker@9 + design tokens，支持 `mode="single" | "multiple" | "range"` 三种选择模式、年份 / 月份导航、`disabled` 函数式禁用、`numberOfMonths` 多月并排；通常配 `Popover` 包装为 `DatePicker`。',
       },
     },
   },

package/src/components/calendar/calendar.tsx

@@ -59,7 +59,7 @@ function Calendar({
         month_grid: 'w-full border-collapse',
         weekdays: 'flex',
         weekday:
-          'text-muted-foreground rounded-md w-8 font-normal text-[0.8rem]',
+          'text-muted-foreground rounded-md w-8 font-normal text-xs-cal',
         week: 'flex w-full mt-2',
         day: cn(
           'relative p-0 text-center text-sm focus-within:relative focus-within:z-20',

package/src/components/card/card.meta.md

@@ -1,13 +1,14 @@
 ---
 id: card
 name: Card
+displayName: 卡片
 type: component
 category: layout
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
 ---
 
-# Card
+# Card 卡片
 
 卡片容器 — shadcn 组合式(`Card / Header / Title / Description / Content / Footer`)+ antd 并集(`hoverable / loading / Cover / Actions / Meta / extra`)。
 **单卡覆盖列表项 / 详情卡 / 资源卡 / 媒体卡多种形态**。
@@ -30,10 +31,34 @@ package: "@teamix-evo/ui"
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成。
 
 <!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `hoverable` | `boolean` | `false` | – | 鼠标 hover 时的视觉反馈(antd `hoverable` 并集) — 阴影升级 + 微交互。 |
-| `loading` | `boolean` | `false` | – | 加载态(antd `loading` 并集) — 整卡渲染为骨架屏占位,不展示 children。 |
+
+#### Card
+
+| 名称        | 类型      | 默认值  | 必填 | 说明                                                                 |
+| ----------- | --------- | ------- | ---- | -------------------------------------------------------------------- |
+| `hoverable` | `boolean` | `false` | –    | 鼠标 hover 时的视觉反馈(antd `hoverable` 并集) — 阴影升级 + 微交互。 |
+| `loading`   | `boolean` | `false` | –    | 加载态(antd `loading` 并集) — 整卡渲染为骨架屏占位,不展示 children。 |
+
+#### CardHeader
+
+| 名称    | 类型              | 默认值 | 必填 | 说明                                                                       |
+| ------- | ----------------- | ------ | ---- | -------------------------------------------------------------------------- |
+| `extra` | `React.ReactNode` | –      | –    | 右侧附加内容(antd `extra` 并集) — 用 flex 撑开,与 title/description 同行。 |
+
+#### CardActions
+
+| 名称    | 类型                | 默认值 | 必填 | 说明                                                        |
+| ------- | ------------------- | ------ | ---- | ----------------------------------------------------------- |
+| `items` | `React.ReactNode[]` | –      | ✓    | 操作项数组(antd `actions` 并集) — 自动均分等宽,中间分隔线。 |
+
+#### CardMeta
+
+| 名称          | 类型              | 默认值 | 必填 | 说明                                     |
+| ------------- | ----------------- | ------ | ---- | ---------------------------------------- |
+| `avatar`      | `React.ReactNode` | –      | –    | 头像槽(antd `Card.Meta` `avatar` 并集)。 |
+| `title`       | `React.ReactNode` | –      | –    | 标题(粗体)。                             |
+| `description` | `React.ReactNode` | –      | –    | 描述。                                   |
+
 <!-- auto:props:end -->
 
 ## 依赖
@@ -41,21 +66,21 @@ package: "@teamix-evo/ui"
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成,数据源是 [`manifest.json`](../../../manifest.json)。**手工编辑 marker 之间的内容会在下次生成时被覆盖**。
 
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add card` 时,以下 entry 会被自动连带安装(无需手动 add)。
 
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
+| Entry      | 类型      | 描述                                                                                              |
+| ---------- | --------- | ------------------------------------------------------------------------------------------------- |
+| `cn`       | util      | Tailwind className 合并工具(clsx + tailwind-merge)                                                |
 | `skeleton` | component | 骨架屏 — shadcn pulse 单元素 + antd Avatar/Image/Button/Input/Paragraph 子家族,自动 motion-reduce |
 
 ### npm 依赖
 
 _无 — 本组件不依赖任何 npm 包。_
-<!-- auto:deps:end -->
 
-> 子组件:`Card`(主容器)/ `CardHeader`(支持 `extra`)/ `CardTitle` / `CardDescription` / `CardContent` / `CardFooter` / `CardCover`(顶部封面)/ `CardActions`(底部分隔操作栏)/ `CardMeta`(avatar + title + description 行)。
+<!-- auto:deps:end -->
 
 ## AI 生成纪律
 

package/src/components/card/card.stories.tsx

@@ -22,6 +22,14 @@ const meta: Meta<typeof Card> = {
   title: '布局与容器 · Layout/Card',
   component: Card,
   tags: ['autodocs'],
+  parameters: {
+    docs: {
+      description: {
+        component:
+          '卡片容器 — shadcn 组合式(Card / Header / Title / Description / Content / Footer) + antd 并集(hoverable / loading / Cover / Actions / Meta / extra)。单卡覆盖列表项 / 详情卡 / 资源卡 / 媒体卡多种形态。',
+      },
+    },
+  },
   argTypes: {
     hoverable: { control: 'boolean' },
     loading: { control: 'boolean' },

package/src/components/carousel/carousel.meta.md

@@ -1,13 +1,14 @@
 ---
 id: carousel
 name: Carousel
+displayName: 走马灯
 type: component
 category: data-display
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
 ---
 
-# Carousel
+# Carousel 走马灯
 
 走马灯 — 基于 [`embla-carousel-react`](https://www.embla-carousel.com/),性能与可访问性出色。
 对应 antd `Carousel` 的核心场景。
@@ -30,12 +31,14 @@ package: "@teamix-evo/ui"
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成。
 
 <!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `opts` | `CarouselOptions` | – | – | embla 选项透传(`loop / align / startIndex / dragFree` 等)。 |
-| `plugins` | `CarouselPlugin` | – | – | embla 插件数组(`autoplay`、`fade` 等)。 |
-| `orientation` | `'horizontal' \| 'vertical'` | `"horizontal"` | – | 滚动方向。 |
-| `setApi` | `(api: CarouselApi) => void` | – | – | 提供 embla API 的回调,用于业务侧自行控制(scrollNext / scrollTo 等)。 |
+
+| 名称          | 类型                         | 默认值         | 必填 | 说明                                                                 |
+| ------------- | ---------------------------- | -------------- | ---- | -------------------------------------------------------------------- |
+| `opts`        | `CarouselOptions`            | –              | –    | embla 选项透传(`loop / align / startIndex / dragFree` 等)。          |
+| `plugins`     | `CarouselPlugin`             | –              | –    | embla 插件数组(`autoplay`、`fade` 等)。                              |
+| `orientation` | `'horizontal' \| 'vertical'` | `"horizontal"` | –    | 滚动方向。                                                           |
+| `setApi`      | `(api: CarouselApi) => void` | –              | –    | 提供 embla API 的回调,用于业务侧自行控制(scrollNext / scrollTo 等)。 |
+
 <!-- 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 carousel` 时,以下 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 依赖
@@ -59,6 +63,7 @@ package: "@teamix-evo/ui"
 ```bash
 pnpm add embla-carousel-react@^8.0.0 lucide-react@^0.460.0
 ```
+
 <!-- auto:deps:end -->
 
 > 子组件:`Carousel`(主容器,内置 embla)/ `CarouselContent`(可滚动 wrapper)/ `CarouselItem`(单页)/ `CarouselPrevious` + `CarouselNext`(导航按钮)+ `useCarousel()` 内部 hook。

package/src/components/carousel/carousel.stories.tsx

@@ -12,7 +12,15 @@ const meta: Meta<typeof Carousel> = {
   title: '数据展示 · Data Display/Carousel',
   component: Carousel,
   tags: ['autodocs'],
-  parameters: { layout: 'centered' },
+  parameters: {
+    layout: 'centered',
+    docs: {
+      description: {
+        component:
+          '走马灯 — 基于 embla-carousel-react，支持单页 / 多页 / 循环 / 拖拽 / 自动播放插件。对应 antd `Carousel` 的核心场景。',
+      },
+    },
+  },
 };
 
 export default meta;
@@ -41,10 +49,7 @@ export const Single: Story = {
 export const ThreePerView: Story = {
   parameters: { controls: { disable: true } },
   render: () => (
-    <Carousel
-      opts={{ align: 'start' }}
-      className="w-full max-w-2xl"
-    >
+    <Carousel opts={{ align: 'start' }} className="w-full max-w-2xl">
       <CarouselContent>
         {Array.from({ length: 8 }).map((_, i) => (
           <CarouselItem key={i} className="md:basis-1/3">

package/src/components/cascader/cascader.meta.md

@@ -1,13 +1,14 @@
 ---
 id: cascader
 name: Cascader
+displayName: 级联选择
 type: component
 category: form
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
 ---
 
-# Cascader
+# Cascader 级联选择
 
 级联选择 — antd 独有补足。**等价 antd `Cascader`**。多级联动选择(地区 / 分类 / 组织架构 / 文件夹路径),选项树由 `options.children` 表达;点击触发器弹出多列面板,**叶子触发 onChange**(可改 `changeOnSelect` 为每级触发)。
 
@@ -23,31 +24,38 @@ package: "@teamix-evo/ui"
 - 树形多选 → `TreeSelect`(可勾选)
 - 离散级别独立选择 → 多个 `Select` 并排(级联弱)
 
+## Props
+
 <!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `options` | `CascaderOption[]` | – | ✓ | 级联选项树(antd `options` 并集)。 |
-| `value` | `string[]` | – | – | 受控值(每层 value 数组)。 |
-| `defaultValue` | `string[]` | – | – | uncontrolled 初值。 |
-| `onChange` | `(value: string[], selectedOptions: CascaderOption[]) => void` | – | – | 值变化回调 — 触发条件:点选叶子节点或显式 changeOnSelect。 |
-| `changeOnSelect` | `boolean` | `false` | – | 每选中一级即触发 onChange(antd `changeOnSelect` 并集) — 默认仅选叶子触发。 |
-| `placeholder` | `string` | `"请选择"` | – | 占位文本。 |
-| `separator` | `string` | `" / "` | – | 路径展示的分隔符。 |
-| `disabled` | `boolean` | – | – | 整体禁用。 |
-| `className` | `string` | – | – | 触发器 className(给外层 Button)。 |
-| `size` | `'sm' \| 'default' \| 'lg'` | `"default"` | – | 触发器尺寸。 |
+
+| 名称             | 类型                                                           | 默认值      | 必填 | 说明                                                                       |
+| ---------------- | -------------------------------------------------------------- | ----------- | ---- | -------------------------------------------------------------------------- |
+| `options`        | `CascaderOption[]`                                             | –           | ✓    | 级联选项树(antd `options` 并集)。                                          |
+| `value`          | `string[]`                                                     | –           | –    | 受控值(每层 value 数组)。                                                  |
+| `defaultValue`   | `string[]`                                                     | –           | –    | uncontrolled 初值。                                                        |
+| `onChange`       | `(value: string[], selectedOptions: CascaderOption[]) => void` | –           | –    | 值变化回调 — 触发条件:点选叶子节点或显式 changeOnSelect。                  |
+| `changeOnSelect` | `boolean`                                                      | `false`     | –    | 每选中一级即触发 onChange(antd `changeOnSelect` 并集) — 默认仅选叶子触发。 |
+| `placeholder`    | `string`                                                       | `"请选择"`  | –    | 占位文本。                                                                 |
+| `separator`      | `string`                                                       | `" / "`     | –    | 路径展示的分隔符。                                                         |
+| `disabled`       | `boolean`                                                      | –           | –    | 整体禁用。                                                                 |
+| `className`      | `string`                                                       | –           | –    | 触发器 className(给外层 Button)。                                          |
+| `size`           | `'sm' \| 'default' \| 'lg'`                                    | `"default"` | –    | 触发器尺寸。                                                               |
+
 <!-- auto:props:end -->
 
+## 依赖
+
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add cascader` 时,以下 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 依赖
 
@@ -56,6 +64,7 @@ package: "@teamix-evo/ui"
 ```bash
 pnpm add lucide-react@^0.460.0
 ```
+
 <!-- auto:deps:end -->
 
 ## AI 生成纪律

package/src/components/cascader/cascader.stories.tsx

@@ -10,7 +10,7 @@ const meta: Meta<typeof Cascader> = {
     docs: {
       description: {
         component:
-          '级联选择 — 多级联动(地区 / 分类 / 文件夹路径),多列面板,叶子触发 onChange(可改 changeOnSelect 为每级触发)。等价 antd `Cascader`。视觉走 OpenTrek tokens,所有样式来自 `@teamix-evo/design`,无 mock。',
+          '级联选择 — 多级联动（地区 / 分类 / 文件夹路径），多列面板，叶子触发 onChange（可改 changeOnSelect 为每级触发）。等价 antd `Cascader`。',
       },
     },
   },
@@ -52,7 +52,13 @@ const regions: CascaderOption[] = [
   {
     value: 'us',
     label: '美国',
-    children: [{ value: 'ca', label: '加州', children: [{ value: 'sf', label: '旧金山' }] }],
+    children: [
+      {
+        value: 'ca',
+        label: '加州',
+        children: [{ value: 'sf', label: '旧金山' }],
+      },
+    ],
   },
 ];
 
@@ -67,12 +73,7 @@ export const ChangeOnSelect: Story = {
     const [v, setV] = React.useState<string[]>([]);
     return (
       <div className="flex flex-col gap-2">
-        <Cascader
-          options={regions}
-          changeOnSelect
-          value={v}
-          onChange={setV}
-        />
+        <Cascader options={regions} changeOnSelect value={v} onChange={setV} />
         <div className="text-xs text-muted-foreground">
           value: {v.length ? v.join(' / ') : '(空)'}
         </div>

package/src/components/cascader/cascader.tsx

@@ -144,7 +144,7 @@ const Cascader = React.forwardRef<HTMLButtonElement, CascaderProps>(
             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,
             )}
@@ -159,7 +159,7 @@ const Cascader = React.forwardRef<HTMLButtonElement, CascaderProps>(
               key={level}
               role="listbox"
               className={cn(
-                'min-w-[160px] max-h-72 overflow-auto py-1 text-sm',
+                'min-w-submenu max-h-72 overflow-auto py-1 text-sm',
                 level > 0 && 'border-l',
               )}
             >

package/src/components/checkbox/checkbox.meta.md

@@ -4,10 +4,11 @@ name: Checkbox
 type: component
 category: form
 since: 0.1.0
-package: "@teamix-evo/ui"
+package: '@teamix-evo/ui'
+displayName: 复选框
 ---
 
-# Checkbox
+# Checkbox 复选框
 
 复选框 — Radix Checkbox(原生支持 indeterminate)+ antd `Checkbox.Group`(`options` 数组驱动)。
 
@@ -28,7 +29,23 @@ package: "@teamix-evo/ui"
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成。
 
 <!-- auto:props:begin -->
-_(no props)_
+
+#### Checkbox
+
+_透传 Radix Checkbox.Root 所有 props（`checked` / `defaultChecked` / `onCheckedChange` / `disabled` / `required` / `name` / `value` 等），无自定义扩展 props。_
+
+#### CheckboxGroup
+
+| 名称           | 类型                         | 默认值         | 必填 | 说明                                           |
+| -------------- | ---------------------------- | -------------- | ---- | ---------------------------------------------- |
+| `options`      | `CheckboxGroupOption[]`      | –              | ✔    | 选项数据。                                     |
+| `value`        | `string[]`                   | –              | –    | 受控值；`string[]` 表示当前选中的 value 集合。 |
+| `defaultValue` | `string[]`                   | –              | –    | uncontrolled 初值。                            |
+| `disabled`     | `boolean`                    | –              | –    | 整组禁用。                                     |
+| `name`         | `string`                     | –              | –    | 整组的 name（submitted form 用）。             |
+| `orientation`  | `'horizontal' \| 'vertical'` | `"horizontal"` | –    | 排列方向。                                     |
+| `onChange`     | `(next: string[]) => void`   | –              | –    | 选中变化回调。                                 |
+
 <!-- auto:props:end -->
 
 ## 依赖
@@ -36,13 +53,14 @@ _(no props)_
 > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成,数据源是 [`manifest.json`](../../../manifest.json)。**手工编辑 marker 之间的内容会在下次生成时被覆盖**。
 
 <!-- auto:deps:begin -->
+
 ### 同库依赖
 
 > `teamix-evo ui add checkbox` 时,以下 entry 会被自动连带安装(无需手动 add)。
 
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
+| Entry | 类型 | 描述                                               |
+| ----- | ---- | -------------------------------------------------- |
+| `cn`  | util | Tailwind className 合并工具(clsx + tailwind-merge) |
 
 ### npm 依赖
 
@@ -51,10 +69,10 @@ _(no props)_
 ```bash
 pnpm add @radix-ui/react-checkbox@^1.1.0 lucide-react@^0.460.0
 ```
+
 <!-- auto:deps:end -->
 
-> 透传 Radix Checkbox.Root 所有 props(`checked` / `defaultChecked` / `onCheckedChange` / `disabled` / `required` / `name` / `value` 等)。
-> 子组件 `CheckboxGroup` 的 props 详见 [`checkbox.tsx`](./checkbox.tsx) 的 `CheckboxGroupProps`。
+> 透传 Radix Checkbox.Root 所有 props（`checked` / `defaultChecked` / `onCheckedChange` / `disabled` / `required` / `name` / `value` 等）。
 
 ## AI 生成纪律
 

package/src/components/checkbox/checkbox.stories.tsx

@@ -10,7 +10,7 @@ const meta: Meta<typeof Checkbox> = {
     docs: {
       description: {
         component:
-          '复选框 — 在一组选项中进行多选，或单独切换某个布尔状态。基于 Radix Checkbox(原生可访问 + indeterminate 三态) + antd `Checkbox.Group` 批量管理；支持受控 / 非受控、`disabled`、中间态。视觉走 OpenTrek semantic tokens，所有样式来自 `@teamix-evo/design`，无 mock。',
+          '复选框 — 在一组选项中进行多选，或单独切换某个布尔状态。基于 Radix Checkbox（原生可访问 + indeterminate 三态）+ antd `Checkbox.Group` 批量管理；支持受控 / 非受控、`disabled`、中间态。',
       },
     },
   },