@teamix-evo/ui 0.2.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (296) hide show
  1. package/README.md +184 -184
  2. package/manifest.json +695 -487
  3. package/package.json +16 -10
  4. package/src/components/accordion/accordion.meta.md +5 -9
  5. package/src/components/accordion/accordion.stories.tsx +3 -3
  6. package/src/components/accordion/accordion.tsx +104 -8
  7. package/src/components/affix/affix.meta.md +21 -12
  8. package/src/components/affix/affix.stories.tsx +101 -26
  9. package/src/components/affix/affix.tsx +79 -9
  10. package/src/components/alert/alert.meta.md +52 -26
  11. package/src/components/alert/alert.stories.tsx +66 -21
  12. package/src/components/alert/alert.tsx +81 -34
  13. package/src/components/alert-dialog/alert-dialog.meta.md +48 -16
  14. package/src/components/alert-dialog/alert-dialog.stories.tsx +145 -3
  15. package/src/components/alert-dialog/alert-dialog.tsx +60 -13
  16. package/src/components/anchor/anchor.meta.md +10 -14
  17. package/src/components/anchor/anchor.stories.tsx +3 -3
  18. package/src/components/anchor/anchor.tsx +2 -2
  19. package/src/components/app/app.meta.md +10 -14
  20. package/src/components/app/app.stories.tsx +6 -6
  21. package/src/components/aspect-ratio/aspect-ratio.meta.md +4 -8
  22. package/src/components/aspect-ratio/aspect-ratio.stories.tsx +3 -3
  23. package/src/components/auto-complete/auto-complete.meta.md +19 -20
  24. package/src/components/auto-complete/auto-complete.stories.tsx +44 -3
  25. package/src/components/auto-complete/auto-complete.tsx +119 -71
  26. package/src/components/avatar/avatar.meta.md +9 -22
  27. package/src/components/avatar/avatar.stories.tsx +21 -3
  28. package/src/components/avatar/avatar.tsx +24 -23
  29. package/src/components/badge/badge.meta.md +14 -18
  30. package/src/components/badge/badge.stories.tsx +2 -2
  31. package/src/components/badge/badge.tsx +2 -2
  32. package/src/components/breadcrumb/breadcrumb.meta.md +29 -20
  33. package/src/components/breadcrumb/breadcrumb.stories.tsx +120 -5
  34. package/src/components/breadcrumb/breadcrumb.tsx +22 -8
  35. package/src/components/button/button.meta.md +261 -29
  36. package/src/components/button/button.stories.tsx +549 -41
  37. package/src/components/button/button.tsx +341 -35
  38. package/src/components/calendar/calendar.meta.md +19 -14
  39. package/src/components/calendar/calendar.stories.tsx +5 -5
  40. package/src/components/calendar/calendar.tsx +73 -8
  41. package/src/components/card/card.meta.md +31 -34
  42. package/src/components/card/card.stories.tsx +34 -3
  43. package/src/components/card/card.tsx +147 -63
  44. package/src/components/carousel/carousel.meta.md +10 -14
  45. package/src/components/carousel/carousel.stories.tsx +1 -1
  46. package/src/components/cascader/cascader.meta.md +43 -22
  47. package/src/components/cascader/cascader.stories.tsx +13 -2
  48. package/src/components/cascader/cascader.tsx +439 -89
  49. package/src/components/checkbox/checkbox.meta.md +74 -24
  50. package/src/components/checkbox/checkbox.stories.tsx +160 -2
  51. package/src/components/checkbox/checkbox.tsx +79 -9
  52. package/src/components/collapsible/collapsible.meta.md +7 -6
  53. package/src/components/collapsible/collapsible.stories.tsx +2 -2
  54. package/src/components/collapsible/collapsible.tsx +93 -6
  55. package/src/components/color-picker/color-picker.meta.md +16 -20
  56. package/src/components/color-picker/color-picker.stories.tsx +86 -7
  57. package/src/components/color-picker/color-picker.tsx +19 -9
  58. package/src/components/command/command.meta.md +7 -11
  59. package/src/components/command/command.stories.tsx +4 -4
  60. package/src/components/command/command.tsx +18 -7
  61. package/src/components/context-menu/context-menu.meta.md +5 -25
  62. package/src/components/context-menu/context-menu.stories.tsx +4 -4
  63. package/src/components/context-menu/context-menu.tsx +21 -8
  64. package/src/components/data-table/data-table.meta.md +14 -18
  65. package/src/components/data-table/data-table.stories.tsx +1 -1
  66. package/src/components/data-table/data-table.tsx +2 -2
  67. package/src/components/date-picker/date-picker.meta.md +90 -41
  68. package/src/components/date-picker/date-picker.stories.tsx +55 -5
  69. package/src/components/date-picker/date-picker.tsx +1489 -91
  70. package/src/components/descriptions/descriptions.meta.md +12 -16
  71. package/src/components/descriptions/descriptions.stories.tsx +2 -2
  72. package/src/components/descriptions/descriptions.tsx +22 -14
  73. package/src/components/dialog/dialog.meta.md +67 -17
  74. package/src/components/dialog/dialog.stories.tsx +182 -20
  75. package/src/components/dialog/dialog.tsx +67 -15
  76. package/src/components/dialog/imperative.tsx +252 -0
  77. package/src/components/drawer/drawer.meta.md +27 -39
  78. package/src/components/drawer/drawer.stories.tsx +29 -12
  79. package/src/components/drawer/drawer.tsx +22 -114
  80. package/src/components/dropdown-menu/dropdown-menu.meta.md +64 -24
  81. package/src/components/dropdown-menu/dropdown-menu.stories.tsx +81 -3
  82. package/src/components/dropdown-menu/dropdown-menu.tsx +24 -10
  83. package/src/components/ellipsis/ellipsis.meta.md +87 -0
  84. package/src/components/ellipsis/ellipsis.stories.tsx +72 -0
  85. package/src/components/ellipsis/ellipsis.tsx +153 -0
  86. package/src/components/empty/empty.meta.md +10 -14
  87. package/src/components/empty/empty.stories.tsx +3 -3
  88. package/src/components/empty/empty.tsx +10 -3
  89. package/src/components/field/field.meta.md +46 -25
  90. package/src/components/field/field.stories.tsx +380 -3
  91. package/src/components/field/field.tsx +263 -35
  92. package/src/components/filter-bar/filter-bar.meta.md +92 -0
  93. package/src/components/filter-bar/filter-bar.stories.tsx +1086 -0
  94. package/src/components/filter-bar/filter-bar.tsx +568 -0
  95. package/src/components/flex/flex.meta.md +59 -20
  96. package/src/components/flex/flex.stories.tsx +65 -10
  97. package/src/components/flex/flex.tsx +27 -4
  98. package/src/components/float-button/float-button.meta.md +10 -29
  99. package/src/components/float-button/float-button.stories.tsx +6 -6
  100. package/src/components/form/form.meta.md +31 -52
  101. package/src/components/form/form.stories.tsx +354 -4
  102. package/src/components/form/form.tsx +101 -35
  103. package/src/components/grid/grid.meta.md +4 -24
  104. package/src/components/grid/grid.stories.tsx +2 -2
  105. package/src/components/hover-card/hover-card.meta.md +9 -10
  106. package/src/components/hover-card/hover-card.stories.tsx +29 -4
  107. package/src/components/hover-card/hover-card.tsx +51 -13
  108. package/src/components/icon/DEVELOPMENT.md +809 -0
  109. package/src/components/icon/icon.meta.md +170 -0
  110. package/src/components/icon/icon.stories.tsx +344 -0
  111. package/src/components/icon/icon.tsx +248 -0
  112. package/src/components/image/image.meta.md +14 -18
  113. package/src/components/image/image.stories.tsx +3 -3
  114. package/src/components/image/image.tsx +2 -0
  115. package/src/components/input/input.meta.md +44 -43
  116. package/src/components/input/input.stories.tsx +62 -35
  117. package/src/components/input/input.tsx +96 -101
  118. package/src/components/input-group/input-group.meta.md +53 -39
  119. package/src/components/input-group/input-group.stories.tsx +49 -16
  120. package/src/components/input-group/input-group.tsx +45 -10
  121. package/src/components/input-number/input-number.meta.md +68 -20
  122. package/src/components/input-number/input-number.stories.tsx +33 -6
  123. package/src/components/input-number/input-number.tsx +81 -22
  124. package/src/components/input-otp/input-otp.meta.md +8 -20
  125. package/src/components/input-otp/input-otp.stories.tsx +3 -3
  126. package/src/components/input-otp/input-otp.tsx +1 -1
  127. package/src/components/item/item.meta.md +8 -26
  128. package/src/components/item/item.stories.tsx +3 -3
  129. package/src/components/item/item.tsx +7 -6
  130. package/src/components/kbd/kbd.meta.md +7 -19
  131. package/src/components/kbd/kbd.stories.tsx +4 -4
  132. package/src/components/kbd/kbd.tsx +8 -4
  133. package/src/components/label/label.meta.md +21 -18
  134. package/src/components/label/label.stories.tsx +64 -6
  135. package/src/components/label/label.tsx +91 -19
  136. package/src/components/masonry/masonry.meta.md +8 -12
  137. package/src/components/masonry/masonry.stories.tsx +4 -4
  138. package/src/components/mentions/mentions.meta.md +42 -21
  139. package/src/components/mentions/mentions.stories.tsx +120 -6
  140. package/src/components/mentions/mentions.tsx +10 -5
  141. package/src/components/menubar/menubar.meta.md +4 -8
  142. package/src/components/menubar/menubar.stories.tsx +55 -3
  143. package/src/components/menubar/menubar.tsx +9 -9
  144. package/src/components/native-select/native-select.meta.md +7 -11
  145. package/src/components/native-select/native-select.stories.tsx +4 -4
  146. package/src/components/native-select/native-select.tsx +2 -2
  147. package/src/components/navigation-menu/navigation-menu.meta.md +4 -8
  148. package/src/components/navigation-menu/navigation-menu.stories.tsx +106 -3
  149. package/src/components/navigation-menu/navigation-menu.tsx +6 -3
  150. package/src/components/notification/notification.meta.md +41 -8
  151. package/src/components/notification/notification.stories.tsx +9 -9
  152. package/src/components/notification/notification.tsx +34 -19
  153. package/src/components/page-header/DEVELOPMENT.md +842 -0
  154. package/src/components/page-header/page-header.meta.md +210 -0
  155. package/src/components/page-header/page-header.stories.tsx +428 -0
  156. package/src/components/page-header/page-header.tsx +284 -0
  157. package/src/components/page-shell/page-shell.meta.md +116 -0
  158. package/src/components/page-shell/page-shell.stories.tsx +149 -0
  159. package/src/components/page-shell/page-shell.tsx +115 -0
  160. package/src/components/pagination/pagination.meta.md +122 -50
  161. package/src/components/pagination/pagination.stories.tsx +227 -11
  162. package/src/components/pagination/pagination.tsx +345 -63
  163. package/src/components/popconfirm/popconfirm.meta.md +19 -23
  164. package/src/components/popconfirm/popconfirm.stories.tsx +2 -2
  165. package/src/components/popconfirm/popconfirm.tsx +1 -1
  166. package/src/components/popover/popover.meta.md +64 -12
  167. package/src/components/popover/popover.stories.tsx +83 -7
  168. package/src/components/popover/popover.tsx +77 -28
  169. package/src/components/progress/progress.meta.md +43 -26
  170. package/src/components/progress/progress.stories.tsx +2 -2
  171. package/src/components/progress/progress.tsx +19 -11
  172. package/src/components/radio-group/radio-group.meta.md +78 -11
  173. package/src/components/radio-group/radio-group.stories.tsx +38 -2
  174. package/src/components/radio-group/radio-group.tsx +149 -18
  175. package/src/components/rate/rate.meta.md +41 -19
  176. package/src/components/rate/rate.stories.tsx +2 -2
  177. package/src/components/rate/rate.tsx +37 -10
  178. package/src/components/resizable/resizable.meta.md +4 -12
  179. package/src/components/resizable/resizable.stories.tsx +5 -5
  180. package/src/components/resizable/resizable.tsx +1 -1
  181. package/src/components/result/result.meta.md +10 -14
  182. package/src/components/result/result.stories.tsx +2 -2
  183. package/src/components/result/result.tsx +21 -12
  184. package/src/components/scroll-area/scroll-area.meta.md +4 -8
  185. package/src/components/scroll-area/scroll-area.stories.tsx +5 -5
  186. package/src/components/segmented/segmented.meta.md +15 -17
  187. package/src/components/segmented/segmented.stories.tsx +3 -3
  188. package/src/components/segmented/segmented.tsx +16 -8
  189. package/src/components/select/select.meta.md +199 -67
  190. package/src/components/select/select.stories.tsx +238 -63
  191. package/src/components/select/select.tsx +718 -171
  192. package/src/components/separator/separator.meta.md +10 -14
  193. package/src/components/separator/separator.stories.tsx +2 -2
  194. package/src/components/separator/separator.tsx +3 -7
  195. package/src/components/sheet/sheet.meta.md +26 -21
  196. package/src/components/sheet/sheet.stories.tsx +116 -10
  197. package/src/components/sheet/sheet.tsx +116 -29
  198. package/src/components/sidebar/sidebar.meta.md +29 -38
  199. package/src/components/sidebar/sidebar.stories.tsx +696 -29
  200. package/src/components/sidebar/sidebar.tsx +643 -141
  201. package/src/components/skeleton/skeleton.meta.md +7 -31
  202. package/src/components/skeleton/skeleton.stories.tsx +3 -3
  203. package/src/components/skeleton/skeleton.tsx +7 -7
  204. package/src/components/slider/slider.meta.md +60 -13
  205. package/src/components/slider/slider.stories.tsx +58 -6
  206. package/src/components/slider/slider.tsx +154 -13
  207. package/src/components/sonner/sonner.meta.md +54 -8
  208. package/src/components/sonner/sonner.stories.tsx +79 -11
  209. package/src/components/sonner/sonner.tsx +137 -8
  210. package/src/components/spinner/spinner.meta.md +57 -21
  211. package/src/components/spinner/spinner.stories.tsx +66 -14
  212. package/src/components/spinner/spinner.tsx +111 -9
  213. package/src/components/statistic/statistic.meta.md +14 -30
  214. package/src/components/statistic/statistic.stories.tsx +1 -1
  215. package/src/components/statistic/statistic.tsx +4 -5
  216. package/src/components/steps/steps.meta.md +20 -15
  217. package/src/components/steps/steps.stories.tsx +37 -2
  218. package/src/components/steps/steps.tsx +15 -12
  219. package/src/components/switch/switch.meta.md +56 -15
  220. package/src/components/switch/switch.stories.tsx +5 -5
  221. package/src/components/switch/switch.tsx +59 -13
  222. package/src/components/table/table.meta.md +3 -7
  223. package/src/components/table/table.stories.tsx +1 -1
  224. package/src/components/table/table.tsx +8 -6
  225. package/src/components/tabs/tabs.meta.md +40 -32
  226. package/src/components/tabs/tabs.stories.tsx +104 -26
  227. package/src/components/tabs/tabs.tsx +125 -54
  228. package/src/components/tag/tag.meta.md +104 -68
  229. package/src/components/tag/tag.stories.tsx +183 -15
  230. package/src/components/tag/tag.tsx +222 -21
  231. package/src/components/textarea/textarea.meta.md +42 -31
  232. package/src/components/textarea/textarea.stories.tsx +32 -6
  233. package/src/components/textarea/textarea.tsx +32 -8
  234. package/src/components/time-picker/time-picker.meta.md +119 -50
  235. package/src/components/time-picker/time-picker.stories.tsx +65 -33
  236. package/src/components/time-picker/time-picker.tsx +889 -101
  237. package/src/components/timeline/timeline.meta.md +16 -17
  238. package/src/components/timeline/timeline.stories.tsx +24 -4
  239. package/src/components/timeline/timeline.tsx +32 -12
  240. package/src/components/toggle/toggle.meta.md +8 -12
  241. package/src/components/toggle/toggle.stories.tsx +4 -4
  242. package/src/components/toggle/toggle.tsx +4 -3
  243. package/src/components/toggle-group/toggle-group.meta.md +10 -14
  244. package/src/components/toggle-group/toggle-group.stories.tsx +3 -3
  245. package/src/components/toggle-group/toggle-group.tsx +2 -2
  246. package/src/components/tooltip/tooltip.meta.md +63 -18
  247. package/src/components/tooltip/tooltip.stories.tsx +42 -5
  248. package/src/components/tooltip/tooltip.tsx +81 -21
  249. package/src/components/tour/tour.meta.md +16 -20
  250. package/src/components/tour/tour.stories.tsx +3 -3
  251. package/src/components/tour/tour.tsx +3 -3
  252. package/src/components/transfer/transfer.meta.md +18 -22
  253. package/src/components/transfer/transfer.stories.tsx +2 -2
  254. package/src/components/transfer/transfer.tsx +28 -21
  255. package/src/components/tree/tree.meta.md +67 -22
  256. package/src/components/tree/tree.stories.tsx +1 -1
  257. package/src/components/tree/tree.tsx +9 -8
  258. package/src/components/tree-select/tree-select.meta.md +59 -23
  259. package/src/components/tree-select/tree-select.stories.tsx +2 -2
  260. package/src/components/tree-select/tree-select.tsx +42 -7
  261. package/src/components/typography/typography.meta.md +61 -39
  262. package/src/components/typography/typography.stories.tsx +14 -9
  263. package/src/components/typography/typography.tsx +38 -25
  264. package/src/components/upload/upload.meta.md +61 -25
  265. package/src/components/upload/upload.stories.tsx +69 -3
  266. package/src/components/upload/upload.tsx +170 -37
  267. package/src/components/watermark/watermark.meta.md +15 -19
  268. package/src/components/watermark/watermark.stories.tsx +98 -8
  269. package/src/hooks/use-breakpoint.ts +117 -0
  270. package/src/hooks/use-debounce-callback.ts +52 -0
  271. package/src/hooks/use-mobile.ts +23 -0
  272. package/src/stories/theme-tokens.stories.tsx +747 -0
  273. package/src/utils/trigger-input.ts +57 -0
  274. package/src/components/button/demo/as-child.tsx +0 -24
  275. package/src/components/button/demo/basic.tsx +0 -8
  276. package/src/components/button/demo/block.tsx +0 -16
  277. package/src/components/button/demo/loading.tsx +0 -19
  278. package/src/components/button/demo/shapes.tsx +0 -18
  279. package/src/components/button/demo/sizes.tsx +0 -19
  280. package/src/components/button/demo/variants.tsx +0 -19
  281. package/src/components/button/demo/with-icon.tsx +0 -20
  282. package/src/components/button-group/button-group.meta.md +0 -101
  283. package/src/components/button-group/button-group.stories.tsx +0 -93
  284. package/src/components/button-group/button-group.tsx +0 -75
  285. package/src/components/combobox/combobox.meta.md +0 -102
  286. package/src/components/combobox/combobox.stories.tsx +0 -55
  287. package/src/components/combobox/combobox.tsx +0 -130
  288. package/src/components/input/demo/addon.tsx +0 -15
  289. package/src/components/input/demo/basic.tsx +0 -12
  290. package/src/components/input/demo/clearable.tsx +0 -21
  291. package/src/components/input/demo/show-count.tsx +0 -18
  292. package/src/components/input/demo/sizes.tsx +0 -15
  293. package/src/components/input/demo/with-prefix-suffix.tsx +0 -19
  294. package/src/components/space/space.meta.md +0 -103
  295. package/src/components/space/space.stories.tsx +0 -108
  296. package/src/components/space/space.tsx +0 -106
@@ -4,50 +4,186 @@ import { cva, type VariantProps } from 'class-variance-authority';
4
4
  import { Loader2 } from 'lucide-react';
5
5
 
6
6
  import { cn } from '@/utils/cn';
7
+ import { Tooltip } from '@/components/tooltip/tooltip';
7
8
 
9
+ // ─── Button cva ──────────────────────────────────────────────────────────────
10
+
11
+ /**
12
+ * Button cva 配置 — 视觉与交互的全部档位均落在 OpenTrek tokens 上:
13
+ * - 圆角 `rounded-md` 直接消费 Tailwind v4 标准 namespace token `--radius-md`,
14
+ * uni-manager 主题下 = 2px(对齐 cd corner.1 锐利风格);
15
+ * opentrek 主题下 = Tailwind v4 默认 0.375rem = 6px。
16
+ * 注:不使用自定义 `--radius-button` 组件级别名,因 Tailwind v4 在多包 @import
17
+ * 场景下不会为非标准 namespace token 自动派生 utility(实测 .rounded-button
18
+ * 不生成);用标准档对齐主题语义即可,避免无谓的 @utility 注册。
19
+ * - 高度 `h-6 / h-8 / h-9` 对应 24/32/36px(与 Input / Select 同档)
20
+ * - 字重 `font-normal`(400)— cd hybridcloud Button 字重
21
+ * - 颜色 `bg-primary / bg-destructive / ...` 全部走 design semantic tokens
22
+ * - ghost / link 仅收紧左右 padding(ghost px-1 / link px-0),高度跟随主 size 档(h-6/h-8/h-9)
23
+ * 与 cd hybridcloud text 按钮实际表现一致(高度不追加独立紧凑档,只去背景/边框)
24
+ */
8
25
  const buttonVariants = cva(
9
- 'inline-flex items-center justify-center gap-2 whitespace-nowrap text-sm font-medium transition-colors focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:size-4 [&_svg]:shrink-0',
26
+ 'inline-flex cursor-pointer items-center justify-center gap-1 whitespace-nowrap font-normal rounded-md transition-colors focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:size-4 [&_svg]:shrink-0',
10
27
  {
11
28
  variants: {
12
29
  variant: {
30
+ // shadow 由 variant scoped CSS 提供(opentrek 默认无 / uni-manager 有 shadow + hover 浮起,
31
+ // 见 packages/tokens/variants/uni-manager/theme.css 末尾 [data-slot='button'] 规则)
13
32
  default:
14
- 'bg-primary text-primary-foreground shadow hover:bg-primary/90',
33
+ 'bg-primary text-primary-foreground transition-shadow duration-150 hover:bg-primary/90',
15
34
  secondary:
16
- 'bg-secondary text-secondary-foreground shadow-sm hover:bg-secondary/80',
35
+ 'bg-secondary text-secondary-foreground transition-shadow duration-150 hover:bg-secondary/80',
17
36
  destructive:
18
- 'bg-destructive text-destructive-foreground shadow-sm hover:bg-destructive/90',
37
+ 'bg-destructive text-destructive-foreground transition-shadow duration-150 hover:bg-destructive/90',
19
38
  outline:
20
- 'border border-input bg-background shadow-sm hover:bg-accent hover:text-accent-foreground',
39
+ 'border border-input bg-card transition-shadow duration-150 hover:bg-muted hover:text-foreground',
21
40
  dashed:
22
- 'border border-dashed border-input bg-background shadow-sm hover:bg-accent hover:text-accent-foreground',
41
+ 'border border-dashed border-input bg-card transition-shadow duration-150 hover:bg-muted hover:text-foreground',
23
42
  ghost: 'hover:bg-accent hover:text-accent-foreground',
24
- link: 'text-primary underline-offset-4 hover:underline',
43
+ link: 'text-primary underline-offset-4',
44
+ },
45
+ // ADR 0021 语义色 — 与 `variant` 双 prop 组合,覆盖语义而非视觉骨架。
46
+ // 典型组合: `variant="outline" color="destructive"` ⇒ 旧库 warning + outline 形态。
47
+ color: {
48
+ default: '',
49
+ primary: '',
50
+ destructive: '',
25
51
  },
26
52
  size: {
27
- sm: 'h-8 px-3 text-xs',
28
- default: 'h-9 px-4 py-2',
29
- lg: 'h-10 px-8',
30
- icon: 'h-9 w-9',
53
+ // 24px 紧凑场景(表格行内、密集工具条),对齐 cd small
54
+ sm: 'h-6 px-[var(--btn-padding-x-sm)] text-xs',
55
+ // 32px — 默认 / 表单基线;`md` 与 `default` 等价(向后兼容旧 API)
56
+ // 字号对齐 cd hybridcloud --form-element-medium-font-size: 12px(ADR 0027)
57
+ md: 'h-8 px-[var(--btn-padding-x-sm)] text-xs',
58
+ default: 'h-8 px-[var(--btn-padding-x-sm)] text-xs',
59
+ // 36px — 强调主操作 / 落地页;水平 padding 走 OpenTrek v4.1 标准 16px
60
+ lg: 'h-9 px-[var(--btn-padding-x)] text-sm',
61
+ // 32px 正方形 — 纯图标按钮(配合 shape="circle" / "square")
62
+ icon: 'h-8 w-8',
31
63
  },
32
64
  shape: {
33
- default: 'rounded-md',
65
+ default: '',
66
+ // antd 兼容:`round` = 全圆角矩形
34
67
  round: 'rounded-full',
68
+ // 等宽等高圆形 — 独立使用时常配 size="icon";SplitButton trigger 可省略 size 继承 group
35
69
  circle: 'rounded-full aspect-square p-0',
70
+ // 等宽等高方形 — 独立使用时常配 size="icon";SplitButton trigger 可省略 size 继承 group
71
+ square: 'aspect-square p-0',
36
72
  },
37
73
  block: {
38
74
  true: 'w-full',
39
75
  false: '',
40
76
  },
77
+ // 仅 icon、无 children 时收紧水平 padding,避免视觉过宽
78
+ iconOnly: {
79
+ true: 'px-0',
80
+ false: '',
81
+ },
41
82
  },
83
+ compoundVariants: [
84
+ // size=icon 时强制方形,无需手动 px
85
+ { size: 'icon', className: 'p-0' },
86
+
87
+ // ─── color × variant 语义覆盖(ADR 0021) ────────────────────────────
88
+ // outline + destructive ⇒ 旧库 warning+outline:边线 / 文字红,背景透明
89
+ {
90
+ variant: 'outline',
91
+ color: 'destructive',
92
+ className:
93
+ 'border-destructive text-destructive hover:bg-destructive/10 hover:text-destructive',
94
+ },
95
+ // ghost + destructive ⇒ 删除类危险操作的轻量按钮(hover 背景走中性灰,对齐 cd hybridcloud)
96
+ {
97
+ variant: 'ghost',
98
+ color: 'destructive',
99
+ className: 'text-destructive hover:bg-muted',
100
+ },
101
+ // link + destructive ⇒ 链接式危险操作
102
+ {
103
+ variant: 'link',
104
+ color: 'destructive',
105
+ className: 'text-destructive',
106
+ },
107
+
108
+ // text 形态(ghost / link) 水平 padding 收紧;高度跟随主 size 档(h-6/h-8/h-9),
109
+ // 与 cd hybridcloud text 按钮实际表现一致(早期版本曾加独立 18/20px 紧凑档,D1 决策删除)
110
+ {
111
+ variant: 'ghost',
112
+ size: 'sm',
113
+ className: 'px-1',
114
+ },
115
+ {
116
+ variant: 'ghost',
117
+ size: 'md',
118
+ className: 'px-1',
119
+ },
120
+ {
121
+ variant: 'ghost',
122
+ size: 'default',
123
+ className: 'px-1',
124
+ },
125
+ {
126
+ variant: 'ghost',
127
+ size: 'lg',
128
+ className: 'px-1',
129
+ },
130
+ {
131
+ variant: 'link',
132
+ size: 'sm',
133
+ className: 'px-0',
134
+ },
135
+ {
136
+ variant: 'link',
137
+ size: 'md',
138
+ className: 'px-0',
139
+ },
140
+ {
141
+ variant: 'link',
142
+ size: 'default',
143
+ className: 'px-0',
144
+ },
145
+ {
146
+ variant: 'link',
147
+ size: 'lg',
148
+ className: 'px-0',
149
+ },
150
+ ],
42
151
  defaultVariants: {
43
152
  variant: 'default',
153
+ color: 'default',
44
154
  size: 'default',
45
155
  shape: 'default',
46
156
  block: false,
157
+ iconOnly: false,
47
158
  },
48
159
  },
49
160
  );
50
161
 
162
+ export type ButtonVariant =
163
+ | 'default'
164
+ | 'secondary'
165
+ | 'destructive'
166
+ | 'outline'
167
+ | 'dashed'
168
+ | 'ghost'
169
+ | 'link';
170
+ export type ButtonColor = 'default' | 'primary' | 'destructive';
171
+ export type ButtonSize = 'sm' | 'md' | 'default' | 'lg' | 'icon';
172
+ export type ButtonShape = 'default' | 'round' | 'circle' | 'square';
173
+
174
+ // ─── ButtonGroup Context — 把 size 自顶向下注入子 Button ─────────────────────
175
+
176
+ interface ButtonGroupContextValue {
177
+ /** 由 `<ButtonGroup size>` 注入,子 Button 未显式传 size 时回退到此值。 */
178
+ size?: ButtonSize;
179
+ }
180
+
181
+ const ButtonGroupContext = React.createContext<ButtonGroupContextValue | null>(
182
+ null,
183
+ );
184
+
185
+ // ─── Button ──────────────────────────────────────────────────────────────────
186
+
51
187
  export interface ButtonProps
52
188
  extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'children'>,
53
189
  VariantProps<typeof buttonVariants> {
@@ -55,48 +191,60 @@ export interface ButtonProps
55
191
  * 视觉风格,语义按 design token 走。
56
192
  * @default "default"
57
193
  */
58
- variant?:
59
- | 'default'
60
- | 'secondary'
61
- | 'destructive'
62
- | 'outline'
63
- | 'dashed'
64
- | 'ghost'
65
- | 'link';
194
+ variant?: ButtonVariant;
66
195
  /**
67
- * 尺寸,`icon` 为正方形纯图标按钮。
196
+ * 语义色(ADR 0021)。与 `variant` 双 prop 组合表达"语义 × 视觉"两个维度,
197
+ * 例:`variant="outline" color="destructive"` 实现旧库 warning+outline 形态;
198
+ * `variant="ghost" color="destructive"` 实现轻量危险删除按钮。
68
199
  * @default "default"
69
200
  */
70
- size?: 'sm' | 'default' | 'lg' | 'icon';
201
+ color?: ButtonColor;
71
202
  /**
72
- * 形状,`circle` `size="icon"` 得圆形按钮。
203
+ * 尺寸。`md` `default` 等价,`icon` 为正方形纯图标按钮。
204
+ * 若包在 `<ButtonGroup size="..">` 中且本地未显式传值,自动继承 group 的 size。
73
205
  * @default "default"
74
206
  */
75
- shape?: 'default' | 'round' | 'circle';
207
+ size?: ButtonSize;
208
+ /**
209
+ * 形状。`circle` / `square` 必须配 `size="icon"`。
210
+ * @default "default"
211
+ */
212
+ shape?: ButtonShape;
76
213
  /**
77
214
  * `true` 时撑满父容器宽度。
78
215
  * @default false
79
216
  */
80
217
  block?: boolean;
81
218
  /**
82
- * 用 Radix Slot 模式渲染为子元素;此时 `loading` / `icon` 被忽略。
219
+ * 用 Radix Slot 模式渲染为子元素;此时 `loading` / `icon` / `iconRight` 被忽略。
83
220
  * @default false
84
221
  */
85
222
  asChild?: boolean;
86
223
  /**
87
- * 显示自旋 spinner,自动 disabled,保留视觉宽度。
224
+ * 显示自旋 spinner,自动 `disabled` + `aria-busy=true`,保留视觉宽度。
88
225
  * @default false
89
226
  */
90
227
  loading?: boolean;
91
228
  /**
92
- * 前置 / 后置图标(来自 `lucide-react`)。loading 时被 spinner 替换。
229
+ * 文本左侧图标。推荐 `lucide-react`。loading 时被 spinner 替换。
93
230
  */
94
231
  icon?: React.ReactNode;
95
232
  /**
96
- * 图标 / spinner 相对文本的位置。
233
+ * 文本右侧图标。推荐 `lucide-react`。
234
+ */
235
+ iconRight?: React.ReactNode;
236
+ /**
237
+ * 兼容旧 API:`icon` 相对文本的位置;新代码请直接使用 `icon` / `iconRight` 双 slot。
97
238
  * @default "start"
239
+ * @deprecated 使用 `icon` 与 `iconRight` 双 slot。
98
240
  */
99
241
  iconPosition?: 'start' | 'end';
242
+ /**
243
+ * `disabled=true` 时的禁用解释文本。仅在 `disabled` 同时存在时生效:
244
+ * 内部包一层 `cursor-not-allowed` wrapper + Tooltip,把 button pointer-events 关闭后由 wrapper 拾取 hover。
245
+ * 不传则保持原生 disabled 行为。
246
+ */
247
+ disabledTooltip?: React.ReactNode;
100
248
  /** 按钮文本 / 内容。 */
101
249
  children?: React.ReactNode;
102
250
  }
@@ -106,21 +254,47 @@ const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
106
254
  {
107
255
  className,
108
256
  variant,
257
+ color,
109
258
  size,
110
259
  shape,
111
260
  block,
112
261
  asChild = false,
113
262
  loading = false,
114
263
  icon,
264
+ iconRight,
115
265
  iconPosition = 'start',
116
266
  disabled,
267
+ disabledTooltip,
117
268
  children,
118
269
  ...props
119
270
  },
120
271
  ref,
121
272
  ) => {
273
+ // ButtonGroup 注入的 size 在本地未显式传值时生效
274
+ const groupCtx = React.useContext(ButtonGroupContext);
275
+ const resolvedSize = size ?? groupCtx?.size;
276
+
277
+ // 兼容旧 API:iconPosition="end" 时把 icon 视作 iconRight(若 iconRight 未显式传)
278
+ const resolvedIcon =
279
+ iconPosition === 'end' && !iconRight ? undefined : icon;
280
+ const resolvedIconRight =
281
+ iconPosition === 'end' && !iconRight ? icon : iconRight;
282
+
283
+ // icon-only 检测:无 children + 至少一个 icon slot,适合收紧 padding
284
+ const isIconOnly =
285
+ (children == null || children === false || children === '') &&
286
+ (resolvedIcon != null || resolvedIconRight != null || loading);
287
+
122
288
  const composedClassName = cn(
123
- buttonVariants({ variant, size, shape, block, className }),
289
+ buttonVariants({
290
+ variant,
291
+ color,
292
+ size: resolvedSize,
293
+ shape,
294
+ block,
295
+ iconOnly: isIconOnly,
296
+ className,
297
+ }),
124
298
  );
125
299
 
126
300
  if (asChild) {
@@ -131,30 +305,162 @@ const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
131
305
  );
132
306
  }
133
307
 
134
- const leading = loading ? (
308
+ const leadingNode = loading ? (
135
309
  <Loader2
136
310
  className="animate-spin motion-reduce:animate-none"
137
311
  aria-hidden="true"
138
312
  />
139
313
  ) : (
140
- icon
314
+ resolvedIcon
141
315
  );
142
316
 
143
- return (
317
+ const buttonEl = (
144
318
  <button
145
319
  ref={ref}
320
+ data-slot="button"
321
+ data-variant={variant}
146
322
  className={composedClassName}
147
323
  disabled={disabled || loading}
148
324
  aria-busy={loading || undefined}
149
325
  {...props}
150
326
  >
151
- {iconPosition === 'start' && leading}
327
+ {leadingNode}
152
328
  {children}
153
- {iconPosition === 'end' && leading}
329
+ {resolvedIconRight}
154
330
  </button>
155
331
  );
332
+
333
+ // 禁用 + 提示文案 ⇒ 用 cursor-not-allowed wrapper 拾取 hover,关闭 button pointer-events
334
+ if (disabled && disabledTooltip != null) {
335
+ return (
336
+ <Tooltip title={disabledTooltip} withProvider>
337
+ <span className="inline-block cursor-not-allowed">
338
+ {React.cloneElement(buttonEl, {
339
+ className: cn(composedClassName, 'pointer-events-none'),
340
+ })}
341
+ </span>
342
+ </Tooltip>
343
+ );
344
+ }
345
+
346
+ return buttonEl;
156
347
  },
157
348
  );
158
349
  Button.displayName = 'Button';
159
350
 
160
- export { Button, buttonVariants };
351
+ // ─── ButtonGroup ─────────────────────────────────────────────────────────────
352
+
353
+ const buttonGroupVariants = cva('inline-flex isolate', {
354
+ variants: {
355
+ orientation: {
356
+ horizontal:
357
+ 'flex-row [&>*:not(:first-child)]:rounded-l-none [&>*:not(:last-child)]:rounded-r-none [&>*:not(:first-child)]:-ml-px hover:[&>*]:z-10 focus-visible:[&>*]:z-10',
358
+ vertical:
359
+ 'flex-col [&>*:not(:first-child)]:rounded-t-none [&>*:not(:last-child)]:rounded-b-none [&>*:not(:first-child)]:-mt-px hover:[&>*]:z-10 focus-visible:[&>*]:z-10',
360
+ },
361
+ attached: {
362
+ true: '',
363
+ false: 'gap-2',
364
+ },
365
+ },
366
+ defaultVariants: { orientation: 'horizontal', attached: true },
367
+ });
368
+
369
+ export interface ButtonGroupProps
370
+ extends React.HTMLAttributes<HTMLDivElement>,
371
+ VariantProps<typeof buttonGroupVariants> {
372
+ /**
373
+ * 排列方向。
374
+ * @default "horizontal"
375
+ */
376
+ orientation?: 'horizontal' | 'vertical';
377
+ /**
378
+ * 是否把按钮"粘"在一起去除边距(antd `Space.Compact` 等价行为)— `false` 时按钮间留 8px gap。
379
+ * @default true
380
+ */
381
+ attached?: boolean;
382
+ /**
383
+ * 统一下发给子 Button 的尺寸;子 Button 若显式传了 `size` 则以子值优先。
384
+ * 通过 React.Context 注入,跨 Slot 透传无效(asChild 自定义渲染不会拿到)。
385
+ */
386
+ size?: ButtonSize;
387
+ }
388
+
389
+ /**
390
+ * 按钮组容器 — 语义类似 antd `Space.Compact`(v6 替代旧 `Button.Group`):
391
+ * 把多个 `Button` / `Input` 包在一起共享边线,典型场景:
392
+ * - Split button(左主操作 + 右下拉箭头)
393
+ * - Toolbar(同语义按钮集合)
394
+ * - Input + 按钮拼装(`<Input/><Button>搜索</Button>`)
395
+ *
396
+ * 通过 `size` prop + React.Context 把尺寸自顶向下注入未显式传 size 的子 Button。
397
+ */
398
+ const ButtonGroup = React.forwardRef<HTMLDivElement, ButtonGroupProps>(
399
+ ({ orientation, attached, size, className, children, ...props }, ref) => {
400
+ const ctxValue = React.useMemo<ButtonGroupContextValue>(
401
+ () => ({ size }),
402
+ [size],
403
+ );
404
+
405
+ return (
406
+ <ButtonGroupContext.Provider value={ctxValue}>
407
+ <div
408
+ ref={ref}
409
+ role="group"
410
+ className={cn(
411
+ buttonGroupVariants({ orientation, attached }),
412
+ className,
413
+ )}
414
+ {...props}
415
+ >
416
+ {children}
417
+ </div>
418
+ </ButtonGroupContext.Provider>
419
+ );
420
+ },
421
+ );
422
+ ButtonGroup.displayName = 'ButtonGroup';
423
+
424
+ // ─── ButtonGroupText(antd-style addon text)─────────────────────────────────
425
+
426
+ /**
427
+ * ButtonGroupText 的高度走与 Button 一致的 size 档,通过 ButtonGroupContext 读取;
428
+ * 不在 Group 内时回退到 default(32px),不再写死 `h-9`(36px),修复跟 Button 默认尺寸不齐的 bug。
429
+ */
430
+ const buttonGroupTextSizeClassMap: Record<ButtonSize, string> = {
431
+ sm: 'h-6 text-xs',
432
+ md: 'h-8 text-xs',
433
+ default: 'h-8 text-xs',
434
+ lg: 'h-9 text-sm',
435
+ // icon 在 addon 文本场景无意义,回退到 default
436
+ icon: 'h-8 text-xs',
437
+ };
438
+
439
+ const ButtonGroupText = React.forwardRef<
440
+ HTMLSpanElement,
441
+ React.HTMLAttributes<HTMLSpanElement>
442
+ >(({ className, ...props }, ref) => {
443
+ const groupCtx = React.useContext(ButtonGroupContext);
444
+ const sizeCls = buttonGroupTextSizeClassMap[groupCtx?.size ?? 'default'];
445
+ return (
446
+ <span
447
+ ref={ref}
448
+ className={cn(
449
+ 'inline-flex select-none items-center border border-input bg-muted px-3 text-muted-foreground',
450
+ sizeCls,
451
+ className,
452
+ )}
453
+ {...props}
454
+ />
455
+ );
456
+ });
457
+ ButtonGroupText.displayName = 'ButtonGroupText';
458
+
459
+ export {
460
+ Button,
461
+ ButtonGroup,
462
+ ButtonGroupText,
463
+ ButtonGroupContext,
464
+ buttonVariants,
465
+ buttonGroupVariants,
466
+ };
@@ -3,7 +3,7 @@ id: calendar
3
3
  name: Calendar
4
4
  displayName: 日历
5
5
  type: component
6
- category: form
6
+ category: data-display
7
7
  since: 0.1.0
8
8
  package: '@teamix-evo/ui'
9
9
  ---
@@ -33,13 +33,20 @@ package: '@teamix-evo/ui'
33
33
  > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成。
34
34
 
35
35
  <!-- auto:props:begin -->
36
-
37
- | 名称 | 类型 | 默认值 | 必填 | 说明 |
38
- | ----------------- | ------------------------------ | ------ | ---- | ------------------------------------------------------------------------------- |
39
- | `className` | `string` | – | – | 容器 className。组件内部默认带 `p-3`,会与传入值自动 merge |
40
- | `classNames` | `DayPickerProps['classNames']` | | – | 覆盖底层 react-day-picker 的 classNames slots(深度自定义日格 / 表头 / 导航等)。 |
41
- | `showOutsideDays` | `boolean` | `true` | – | 是否显示当月范围外的日期(灰色填充,占位补齐周表格)。 |
42
-
36
+ | 名称 | 类型 | 默认值 | 必填 | 说明 |
37
+ | --- | --- | --- | --- | --- |
38
+ | `className` | `string` | | | 容器 className。组件内部默认带 `p-3`,会与传入值自动 merge。 |
39
+ | `classNames` | `DayPickerProps['classNames']` | – | – | 覆盖底层 react-day-picker 的 classNames slots(深度自定义日格 / 表头 / 导航等) |
40
+ | `showOutsideDays` | `boolean` | `true` | – | 是否显示当月范围外的日期(灰色填充,占位补齐周表格)。 |
41
+ | `mode` | `DayPickerProps['mode']` | `"single"` | – | 选择模式 — `'single'` 单选(`selected: Date`)/ `'multiple'` 多选(`selected: Date[]`) / `'range'` 范围(`selected: DateRange`) |
42
+ | `numberOfMonths` | `number` | `1` | – | 受控已选值 — 类型随 `mode` 变化: - `single` → `Date \| undefined` - `multiple` → `Date[]` - `range` → `{ from?: Date; to?: Date } \| undefined` 详细类型由底层 react-day-picker 判别联合保证;此处仅展示业务侧期望形态。 同时显示几个月历(对齐 antd `numberOfMonths`)。 |
43
+ | `disabled` | `DayPickerProps['disabled']` | – | – | 不可选日期匹配器 — 支持 `Date` / `Date[]` / `DateRange` / 函数 `(date) => boolean` / 复合数组。 |
44
+ | `defaultMonth` | `Date` | – | – | 默认显示的月份(uncontrolled — 仅初始生效)。 不传时使用 `selected` 的月份,均无则当前月。 |
45
+ | `month` | `Date` | – | – | 受控当前显示的月份(配 `onMonthChange` 使用)。 |
46
+ | `onMonthChange` | `(month: Date) => void` | – | – | 月份切换回调。 |
47
+ | `weekStartsOn` | `DayPickerProps['weekStartsOn']` | `0` | – | 一周起始日 — `0` 周日 / `1` 周一 / ... / `6` 周六(对齐 ISO 8601 / antd `firstDayOfWeek`)。 |
48
+ | `captionLayout` | `DayPickerProps['captionLayout']` | – | – | 标题布局 — 控制是否显示年 / 月下拉: - `'label'`(默认)— 仅标签文字 - `'dropdown'` — 月 + 年下拉 - `'dropdown-months'` — 仅月份下拉 - `'dropdown-years'` — 仅年份下拉 |
49
+ | `locale` | `DayPickerProps['locale']` | – | – | date-fns Locale 对象,用于本地化星期 / 月份名 / RTL 等(默认 en-US)。 |
43
50
  <!-- auto:props:end -->
44
51
 
45
52
  ## 依赖
@@ -47,15 +54,14 @@ package: '@teamix-evo/ui'
47
54
  > 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成,数据源是 [`manifest.json`](../../../manifest.json)。**手工编辑 marker 之间的内容会在下次生成时被覆盖**。
48
55
 
49
56
  <!-- auto:deps:begin -->
50
-
51
57
  ### 同库依赖
52
58
 
53
59
  > `teamix-evo ui add calendar` 时,以下 entry 会被自动连带安装(无需手动 add)。
54
60
 
55
- | Entry | 类型 | 描述 |
56
- | -------- | --------- | --------------------------------------------------------------------------------------- |
57
- | `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
58
- | `button` | component | 通用按钮 — shadcn 实现 + antd 功能扩展(loading / icon / shape / block / dashed variant) |
61
+ | Entry | 类型 | 描述 |
62
+ | --- | --- | --- |
63
+ | `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
64
+ | `button` | component | 通用按钮 — shadcn 实现 + cloud-design 能力并集(loading / icon / shape / block / dashed variant / color 语义双 prop / disabledTooltip)。同文件合一导出 ButtonGroup + ButtonGroupText(等价 antd Space.Compact + cd SplitButton)。 |
59
65
 
60
66
  ### npm 依赖
61
67
 
@@ -64,7 +70,6 @@ package: '@teamix-evo/ui'
64
70
  ```bash
65
71
  pnpm add react-day-picker@^9.0.0 lucide-react@^0.460.0
66
72
  ```
67
-
68
73
  <!-- auto:deps:end -->
69
74
 
70
75
  > 透传所有 react-day-picker `<DayPicker>` props(`mode` / `selected` / `onSelect` / `disabled` / `fromYear` / `toYear` / `numberOfMonths` 等)。完整 API:[react-day-picker.js.org](https://react-day-picker.js.org/)。
@@ -1,10 +1,10 @@
1
1
  import * as React from 'react';
2
- import type { Meta, StoryObj } from '@storybook/react';
2
+ import type { Meta, StoryObj } from '@storybook/react-vite';
3
3
  import type { DateRange } from 'react-day-picker';
4
4
  import { Calendar } from './calendar';
5
5
 
6
6
  const meta: Meta<typeof Calendar> = {
7
- title: '表单与输入 · Form/Calendar',
7
+ title: '数据展示 · Data Display/Calendar',
8
8
  component: Calendar,
9
9
  tags: ['autodocs'],
10
10
  parameters: {
@@ -29,7 +29,7 @@ export const Single: Story = {
29
29
  mode="single"
30
30
  selected={date}
31
31
  onSelect={setDate}
32
- className="rounded-md border"
32
+ className="rounded-md border border-border"
33
33
  />
34
34
  );
35
35
  },
@@ -43,7 +43,7 @@ export const Multiple: Story = {
43
43
  mode="multiple"
44
44
  selected={days}
45
45
  onSelect={setDays}
46
- className="rounded-md border"
46
+ className="rounded-md border border-border"
47
47
  />
48
48
  );
49
49
  },
@@ -61,7 +61,7 @@ export const Range: Story = {
61
61
  selected={range}
62
62
  onSelect={setRange}
63
63
  numberOfMonths={2}
64
- className="rounded-md border"
64
+ className="rounded-md border border-border"
65
65
  />
66
66
  );
67
67
  },