@teamix-evo/ui 0.4.0 → 0.5.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 (511) hide show
  1. package/README.md +46 -50
  2. package/manifest.json +406 -653
  3. package/package.json +15 -34
  4. package/src/_design-system/theme-tokens/stories.tsx +1474 -0
  5. package/src/components/accordion/index.tsx +139 -0
  6. package/src/components/accordion/meta.md +162 -0
  7. package/src/components/accordion/stories.tsx +145 -0
  8. package/src/components/affix/index.tsx +149 -0
  9. package/src/components/affix/meta.md +23 -0
  10. package/src/components/affix/stories.tsx +70 -0
  11. package/src/components/alert/index.tsx +220 -0
  12. package/src/components/alert/meta.md +133 -0
  13. package/src/components/alert/stories.tsx +126 -0
  14. package/src/components/alert-dialog/index.tsx +282 -0
  15. package/src/components/alert-dialog/meta.md +86 -0
  16. package/src/components/alert-dialog/stories.tsx +163 -0
  17. package/src/components/avatar/index.tsx +159 -0
  18. package/src/components/avatar/meta.md +242 -0
  19. package/src/components/avatar/stories.tsx +241 -0
  20. package/src/components/badge/index.tsx +299 -0
  21. package/src/components/badge/meta.md +237 -0
  22. package/src/components/badge/stories.tsx +275 -0
  23. package/src/components/breadcrumb/index.tsx +137 -0
  24. package/src/components/breadcrumb/meta.md +64 -0
  25. package/src/components/breadcrumb/stories.tsx +86 -0
  26. package/src/components/button/index.tsx +202 -0
  27. package/src/components/button/meta.md +209 -0
  28. package/src/components/button/stories.tsx +215 -0
  29. package/src/components/button-group/index.tsx +211 -0
  30. package/src/components/button-group/meta.md +190 -0
  31. package/src/components/button-group/stories.tsx +182 -0
  32. package/src/components/calendar/index.tsx +240 -0
  33. package/src/components/calendar/meta.md +36 -0
  34. package/src/components/calendar/stories.tsx +36 -0
  35. package/src/components/card/index.tsx +262 -0
  36. package/src/components/card/meta.md +194 -0
  37. package/src/components/card/stories.tsx +202 -0
  38. package/src/components/carousel/index.tsx +481 -0
  39. package/src/components/carousel/meta.md +208 -0
  40. package/src/components/carousel/stories.tsx +271 -0
  41. package/src/components/cascader-select/index.tsx +308 -0
  42. package/src/components/cascader-select/meta.md +28 -0
  43. package/src/components/cascader-select/stories.tsx +118 -0
  44. package/src/components/checkbox/index.tsx +208 -0
  45. package/src/components/checkbox/meta.md +166 -0
  46. package/src/components/checkbox/stories.tsx +206 -0
  47. package/src/components/collapsible/index.tsx +72 -0
  48. package/src/components/collapsible/meta.md +87 -0
  49. package/src/components/collapsible/stories.tsx +97 -0
  50. package/src/components/color-picker/index.tsx +677 -0
  51. package/src/components/color-picker/meta.md +83 -0
  52. package/src/components/color-picker/stories.tsx +172 -0
  53. package/src/components/combobox/index.tsx +687 -0
  54. package/src/components/combobox/meta.md +83 -0
  55. package/src/components/combobox/stories.tsx +179 -0
  56. package/src/components/command/index.tsx +238 -0
  57. package/src/components/command/meta.md +48 -0
  58. package/src/components/command/stories.tsx +83 -0
  59. package/src/components/data-table/index.tsx +1537 -0
  60. package/src/components/data-table/meta.md +107 -0
  61. package/src/components/data-table/stories.tsx +1234 -0
  62. package/src/components/date-picker/index.tsx +1492 -0
  63. package/src/components/date-picker/meta.md +103 -0
  64. package/src/components/date-picker/stories.tsx +125 -0
  65. package/src/components/descriptions/index.tsx +535 -0
  66. package/src/components/descriptions/meta.md +104 -0
  67. package/src/components/descriptions/stories.tsx +389 -0
  68. package/src/components/dialog/index.tsx +255 -0
  69. package/src/components/dialog/meta.md +244 -0
  70. package/src/components/dialog/stories.tsx +330 -0
  71. package/src/components/dropdown-menu/index.tsx +301 -0
  72. package/src/components/dropdown-menu/meta.md +93 -0
  73. package/src/components/dropdown-menu/stories.tsx +124 -0
  74. package/src/components/empty/index.tsx +431 -0
  75. package/src/components/empty/meta.md +274 -0
  76. package/src/components/empty/stories.tsx +278 -0
  77. package/src/components/field/index.tsx +374 -0
  78. package/src/components/field/meta.md +283 -0
  79. package/src/components/field/stories.tsx +327 -0
  80. package/src/components/filter-bar/index.tsx +976 -0
  81. package/src/components/filter-bar/meta.md +57 -0
  82. package/src/components/filter-bar/stories.tsx +496 -0
  83. package/src/components/float-button/index.tsx +163 -0
  84. package/src/components/float-button/meta.md +73 -0
  85. package/src/components/float-button/stories.tsx +68 -0
  86. package/src/components/form/index.tsx +218 -0
  87. package/src/components/form/meta.md +16 -0
  88. package/src/components/form/stories.tsx +301 -0
  89. package/src/components/hover-card/index.tsx +103 -0
  90. package/src/components/hover-card/meta.md +71 -0
  91. package/src/components/hover-card/stories.tsx +107 -0
  92. package/src/components/icon/index.tsx +225 -0
  93. package/src/components/icon/meta.md +102 -0
  94. package/src/components/icon/stories.tsx +127 -0
  95. package/src/components/image/index.tsx +147 -0
  96. package/src/components/image/meta.md +55 -0
  97. package/src/components/image/stories.tsx +48 -0
  98. package/src/components/input/index.tsx +63 -0
  99. package/src/components/input/meta.md +57 -0
  100. package/src/components/input/stories.tsx +66 -0
  101. package/src/components/input-group/index.tsx +292 -0
  102. package/src/components/input-group/meta.md +108 -0
  103. package/src/components/input-group/stories.tsx +258 -0
  104. package/src/components/input-ip/index.tsx +288 -0
  105. package/src/components/input-ip/meta.md +48 -0
  106. package/src/components/input-ip/stories.tsx +69 -0
  107. package/src/components/input-number/index.tsx +360 -0
  108. package/src/components/input-number/meta.md +156 -0
  109. package/src/components/input-number/stories.tsx +187 -0
  110. package/src/components/item/index.tsx +368 -0
  111. package/src/components/item/meta.md +395 -0
  112. package/src/components/item/stories.tsx +432 -0
  113. package/src/components/label/index.tsx +44 -0
  114. package/src/components/label/meta.md +68 -0
  115. package/src/components/label/stories.tsx +64 -0
  116. package/src/components/mentions/index.tsx +369 -0
  117. package/src/components/mentions/meta.md +118 -0
  118. package/src/components/mentions/stories.tsx +153 -0
  119. package/src/components/menubar/index.tsx +313 -0
  120. package/src/components/menubar/meta.md +52 -0
  121. package/src/components/menubar/stories.tsx +99 -0
  122. package/src/components/navigation-menu/index.tsx +216 -0
  123. package/src/components/navigation-menu/meta.md +66 -0
  124. package/src/components/navigation-menu/stories.tsx +137 -0
  125. package/src/components/page-header/index.tsx +218 -0
  126. package/src/components/page-header/meta.md +211 -0
  127. package/src/components/page-header/stories.tsx +290 -0
  128. package/src/components/page-shell/index.tsx +119 -0
  129. package/src/components/page-shell/meta.md +115 -0
  130. package/src/components/page-shell/stories.tsx +154 -0
  131. package/src/components/pagination/index.tsx +580 -0
  132. package/src/components/pagination/meta.md +39 -0
  133. package/src/components/pagination/stories.tsx +319 -0
  134. package/src/components/popconfirm/index.tsx +477 -0
  135. package/src/components/popconfirm/meta.md +164 -0
  136. package/src/components/popconfirm/stories.tsx +231 -0
  137. package/src/components/popover/index.tsx +181 -0
  138. package/src/components/popover/meta.md +97 -0
  139. package/src/components/popover/stories.tsx +169 -0
  140. package/src/components/progress/index.tsx +176 -0
  141. package/src/components/progress/meta.md +95 -0
  142. package/src/components/progress/stories.tsx +115 -0
  143. package/src/components/radio-group/index.tsx +78 -0
  144. package/src/components/radio-group/meta.md +137 -0
  145. package/src/components/radio-group/stories.tsx +285 -0
  146. package/src/components/rate/index.tsx +284 -0
  147. package/src/components/rate/meta.md +63 -0
  148. package/src/components/rate/stories.tsx +107 -0
  149. package/src/components/resizable/index.tsx +122 -0
  150. package/src/components/resizable/meta.md +142 -0
  151. package/src/components/resizable/stories.tsx +105 -0
  152. package/src/components/scroll-area/index.tsx +83 -0
  153. package/src/components/scroll-area/meta.md +85 -0
  154. package/src/components/scroll-area/stories.tsx +82 -0
  155. package/src/components/select/index.tsx +325 -0
  156. package/src/components/select/meta.md +183 -0
  157. package/src/components/select/stories.tsx +210 -0
  158. package/src/components/separator/index.tsx +51 -0
  159. package/src/components/separator/meta.md +68 -0
  160. package/src/components/separator/stories.tsx +53 -0
  161. package/src/components/sheet/index.tsx +293 -0
  162. package/src/components/sheet/meta.md +226 -0
  163. package/src/components/sheet/stories.tsx +405 -0
  164. package/src/components/sidebar/index.tsx +715 -0
  165. package/src/components/sidebar/meta.md +14 -0
  166. package/src/components/sidebar/{sidebar.stories.tsx → stories.tsx} +250 -330
  167. package/src/components/skeleton/index.tsx +415 -0
  168. package/src/components/skeleton/meta.md +210 -0
  169. package/src/components/skeleton/stories.tsx +197 -0
  170. package/src/components/slider/index.tsx +222 -0
  171. package/src/components/slider/meta.md +125 -0
  172. package/src/components/slider/stories.tsx +109 -0
  173. package/src/components/sonner/index.tsx +149 -0
  174. package/src/components/sonner/meta.md +156 -0
  175. package/src/components/sonner/stories.tsx +285 -0
  176. package/src/components/spinner/index.tsx +335 -0
  177. package/src/components/spinner/meta.md +172 -0
  178. package/src/components/spinner/stories.tsx +197 -0
  179. package/src/components/statistic/{statistic.tsx → index.tsx} +25 -26
  180. package/src/components/statistic/meta.md +94 -0
  181. package/src/components/statistic/stories.tsx +85 -0
  182. package/src/components/steps/index.tsx +500 -0
  183. package/src/components/steps/meta.md +245 -0
  184. package/src/components/steps/stories.tsx +287 -0
  185. package/src/components/switch/index.tsx +175 -0
  186. package/src/components/switch/meta.md +107 -0
  187. package/src/components/switch/stories.tsx +154 -0
  188. package/src/components/table/index.tsx +350 -0
  189. package/src/components/table/meta.md +148 -0
  190. package/src/components/table/stories.tsx +189 -0
  191. package/src/components/tabs/index.tsx +379 -0
  192. package/src/components/tabs/meta.md +244 -0
  193. package/src/components/tabs/stories.tsx +312 -0
  194. package/src/components/tag/index.tsx +774 -0
  195. package/src/components/tag/meta.md +256 -0
  196. package/src/components/tag/stories.tsx +431 -0
  197. package/src/components/textarea/index.tsx +62 -0
  198. package/src/components/textarea/meta.md +77 -0
  199. package/src/components/textarea/stories.tsx +112 -0
  200. package/src/components/time-picker/index.tsx +887 -0
  201. package/src/components/time-picker/meta.md +102 -0
  202. package/src/components/time-picker/stories.tsx +125 -0
  203. package/src/components/timeline/index.tsx +422 -0
  204. package/src/components/timeline/meta.md +352 -0
  205. package/src/components/timeline/stories.tsx +369 -0
  206. package/src/components/toggle/index.tsx +74 -0
  207. package/src/components/toggle/meta.md +76 -0
  208. package/src/components/toggle/stories.tsx +66 -0
  209. package/src/components/toggle-group/index.tsx +167 -0
  210. package/src/components/toggle-group/meta.md +141 -0
  211. package/src/components/toggle-group/stories.tsx +124 -0
  212. package/src/components/tooltip/index.tsx +144 -0
  213. package/src/components/tooltip/meta.md +186 -0
  214. package/src/components/tooltip/stories.tsx +212 -0
  215. package/src/components/transfer/index.tsx +639 -0
  216. package/src/components/transfer/meta.md +76 -0
  217. package/src/components/transfer/stories.tsx +221 -0
  218. package/src/components/tree/index.tsx +764 -0
  219. package/src/components/tree/meta.md +96 -0
  220. package/src/components/tree/stories.tsx +385 -0
  221. package/src/components/tree/utils.ts +269 -0
  222. package/src/components/tree-select/index.tsx +400 -0
  223. package/src/components/tree-select/meta.md +78 -0
  224. package/src/components/tree-select/stories.tsx +234 -0
  225. package/src/components/typography/index.tsx +290 -0
  226. package/src/components/typography/meta.md +151 -0
  227. package/src/components/typography/stories.tsx +151 -0
  228. package/src/components/upload/index.tsx +858 -0
  229. package/src/components/upload/meta.md +122 -0
  230. package/src/components/upload/stories.tsx +261 -0
  231. package/src/components/watermark/index.tsx +152 -0
  232. package/src/components/watermark/meta.md +67 -0
  233. package/src/components/watermark/stories.tsx +59 -0
  234. package/src/hooks/use-mobile.ts +9 -11
  235. package/src/lib/color.ts +243 -0
  236. package/src/{utils/cn.ts → lib/utils.ts} +1 -1
  237. package/src/components/accordion/accordion.meta.md +0 -88
  238. package/src/components/accordion/accordion.stories.tsx +0 -72
  239. package/src/components/accordion/accordion.tsx +0 -154
  240. package/src/components/affix/affix.meta.md +0 -98
  241. package/src/components/affix/affix.stories.tsx +0 -134
  242. package/src/components/affix/affix.tsx +0 -167
  243. package/src/components/alert/alert.meta.md +0 -132
  244. package/src/components/alert/alert.stories.tsx +0 -138
  245. package/src/components/alert/alert.tsx +0 -179
  246. package/src/components/alert-dialog/alert-dialog.meta.md +0 -152
  247. package/src/components/alert-dialog/alert-dialog.stories.tsx +0 -223
  248. package/src/components/alert-dialog/alert-dialog.tsx +0 -183
  249. package/src/components/anchor/anchor.meta.md +0 -92
  250. package/src/components/anchor/anchor.stories.tsx +0 -74
  251. package/src/components/anchor/anchor.tsx +0 -130
  252. package/src/components/app/app.meta.md +0 -91
  253. package/src/components/app/app.stories.tsx +0 -64
  254. package/src/components/app/app.tsx +0 -58
  255. package/src/components/aspect-ratio/aspect-ratio.meta.md +0 -82
  256. package/src/components/aspect-ratio/aspect-ratio.stories.tsx +0 -59
  257. package/src/components/aspect-ratio/aspect-ratio.tsx +0 -22
  258. package/src/components/auto-complete/auto-complete.meta.md +0 -110
  259. package/src/components/auto-complete/auto-complete.stories.tsx +0 -136
  260. package/src/components/auto-complete/auto-complete.tsx +0 -253
  261. package/src/components/avatar/avatar.meta.md +0 -93
  262. package/src/components/avatar/avatar.stories.tsx +0 -98
  263. package/src/components/avatar/avatar.tsx +0 -127
  264. package/src/components/badge/badge.meta.md +0 -120
  265. package/src/components/badge/badge.stories.tsx +0 -153
  266. package/src/components/badge/badge.tsx +0 -204
  267. package/src/components/breadcrumb/breadcrumb.meta.md +0 -127
  268. package/src/components/breadcrumb/breadcrumb.stories.tsx +0 -207
  269. package/src/components/breadcrumb/breadcrumb.tsx +0 -136
  270. package/src/components/button/button.meta.md +0 -335
  271. package/src/components/button/button.stories.tsx +0 -743
  272. package/src/components/button/button.tsx +0 -466
  273. package/src/components/calendar/calendar.meta.md +0 -128
  274. package/src/components/calendar/calendar.stories.tsx +0 -68
  275. package/src/components/calendar/calendar.tsx +0 -172
  276. package/src/components/card/card.meta.md +0 -139
  277. package/src/components/card/card.stories.tsx +0 -151
  278. package/src/components/card/card.tsx +0 -306
  279. package/src/components/carousel/carousel.meta.md +0 -118
  280. package/src/components/carousel/carousel.stories.tsx +0 -89
  281. package/src/components/carousel/carousel.tsx +0 -224
  282. package/src/components/cascader/cascader.meta.md +0 -140
  283. package/src/components/cascader/cascader.stories.tsx +0 -120
  284. package/src/components/cascader/cascader.tsx +0 -548
  285. package/src/components/checkbox/checkbox.meta.md +0 -167
  286. package/src/components/checkbox/checkbox.stories.tsx +0 -288
  287. package/src/components/checkbox/checkbox.tsx +0 -195
  288. package/src/components/collapsible/collapsible.meta.md +0 -88
  289. package/src/components/collapsible/collapsible.stories.tsx +0 -43
  290. package/src/components/collapsible/collapsible.tsx +0 -105
  291. package/src/components/color-picker/color-picker.meta.md +0 -89
  292. package/src/components/color-picker/color-picker.stories.tsx +0 -159
  293. package/src/components/color-picker/color-picker.tsx +0 -171
  294. package/src/components/command/command.meta.md +0 -120
  295. package/src/components/command/command.stories.tsx +0 -59
  296. package/src/components/command/command.tsx +0 -158
  297. package/src/components/context-menu/context-menu.meta.md +0 -93
  298. package/src/components/context-menu/context-menu.stories.tsx +0 -54
  299. package/src/components/context-menu/context-menu.tsx +0 -204
  300. package/src/components/data-table/data-table.meta.md +0 -150
  301. package/src/components/data-table/data-table.stories.tsx +0 -132
  302. package/src/components/data-table/data-table.tsx +0 -185
  303. package/src/components/date-picker/date-picker.meta.md +0 -175
  304. package/src/components/date-picker/date-picker.stories.tsx +0 -108
  305. package/src/components/date-picker/date-picker.tsx +0 -1554
  306. package/src/components/descriptions/descriptions.meta.md +0 -83
  307. package/src/components/descriptions/descriptions.stories.tsx +0 -60
  308. package/src/components/descriptions/descriptions.tsx +0 -137
  309. package/src/components/dialog/dialog.meta.md +0 -168
  310. package/src/components/dialog/dialog.stories.tsx +0 -255
  311. package/src/components/dialog/dialog.tsx +0 -180
  312. package/src/components/dialog/imperative.tsx +0 -252
  313. package/src/components/drawer/drawer.meta.md +0 -95
  314. package/src/components/drawer/drawer.stories.tsx +0 -71
  315. package/src/components/drawer/drawer.tsx +0 -23
  316. package/src/components/dropdown-menu/dropdown-menu.meta.md +0 -171
  317. package/src/components/dropdown-menu/dropdown-menu.stories.tsx +0 -198
  318. package/src/components/dropdown-menu/dropdown-menu.tsx +0 -209
  319. package/src/components/ellipsis/ellipsis.meta.md +0 -87
  320. package/src/components/ellipsis/ellipsis.stories.tsx +0 -72
  321. package/src/components/ellipsis/ellipsis.tsx +0 -153
  322. package/src/components/empty/empty.meta.md +0 -86
  323. package/src/components/empty/empty.stories.tsx +0 -46
  324. package/src/components/empty/empty.tsx +0 -54
  325. package/src/components/field/field.meta.md +0 -154
  326. package/src/components/field/field.stories.tsx +0 -497
  327. package/src/components/field/field.tsx +0 -392
  328. package/src/components/filter-bar/filter-bar.meta.md +0 -92
  329. package/src/components/filter-bar/filter-bar.stories.tsx +0 -1086
  330. package/src/components/filter-bar/filter-bar.tsx +0 -568
  331. package/src/components/flex/flex.meta.md +0 -142
  332. package/src/components/flex/flex.stories.tsx +0 -199
  333. package/src/components/flex/flex.tsx +0 -145
  334. package/src/components/float-button/float-button.meta.md +0 -92
  335. package/src/components/float-button/float-button.stories.tsx +0 -80
  336. package/src/components/float-button/float-button.tsx +0 -143
  337. package/src/components/form/form.meta.md +0 -153
  338. package/src/components/form/form.stories.tsx +0 -472
  339. package/src/components/form/form.tsx +0 -260
  340. package/src/components/grid/grid.meta.md +0 -92
  341. package/src/components/grid/grid.stories.tsx +0 -101
  342. package/src/components/grid/grid.tsx +0 -130
  343. package/src/components/hover-card/hover-card.meta.md +0 -103
  344. package/src/components/hover-card/hover-card.stories.tsx +0 -97
  345. package/src/components/hover-card/hover-card.tsx +0 -67
  346. package/src/components/icon/DEVELOPMENT.md +0 -809
  347. package/src/components/icon/icon.meta.md +0 -170
  348. package/src/components/icon/icon.stories.tsx +0 -344
  349. package/src/components/icon/icon.tsx +0 -248
  350. package/src/components/image/image.meta.md +0 -99
  351. package/src/components/image/image.stories.tsx +0 -55
  352. package/src/components/image/image.tsx +0 -140
  353. package/src/components/input/input.meta.md +0 -115
  354. package/src/components/input/input.stories.tsx +0 -144
  355. package/src/components/input/input.tsx +0 -212
  356. package/src/components/input-group/input-group.meta.md +0 -124
  357. package/src/components/input-group/input-group.stories.tsx +0 -121
  358. package/src/components/input-group/input-group.tsx +0 -143
  359. package/src/components/input-number/input-number.meta.md +0 -148
  360. package/src/components/input-number/input-number.stories.tsx +0 -125
  361. package/src/components/input-number/input-number.tsx +0 -283
  362. package/src/components/input-otp/input-otp.meta.md +0 -106
  363. package/src/components/input-otp/input-otp.stories.tsx +0 -65
  364. package/src/components/input-otp/input-otp.tsx +0 -97
  365. package/src/components/item/item.meta.md +0 -121
  366. package/src/components/item/item.stories.tsx +0 -116
  367. package/src/components/item/item.tsx +0 -172
  368. package/src/components/kbd/kbd.meta.md +0 -94
  369. package/src/components/kbd/kbd.stories.tsx +0 -70
  370. package/src/components/kbd/kbd.tsx +0 -86
  371. package/src/components/label/label.meta.md +0 -99
  372. package/src/components/label/label.stories.tsx +0 -145
  373. package/src/components/label/label.tsx +0 -138
  374. package/src/components/masonry/masonry.meta.md +0 -90
  375. package/src/components/masonry/masonry.stories.tsx +0 -68
  376. package/src/components/masonry/masonry.tsx +0 -60
  377. package/src/components/mentions/mentions.meta.md +0 -119
  378. package/src/components/mentions/mentions.stories.tsx +0 -189
  379. package/src/components/mentions/mentions.tsx +0 -243
  380. package/src/components/menubar/menubar.meta.md +0 -118
  381. package/src/components/menubar/menubar.stories.tsx +0 -141
  382. package/src/components/menubar/menubar.tsx +0 -232
  383. package/src/components/native-select/native-select.meta.md +0 -93
  384. package/src/components/native-select/native-select.stories.tsx +0 -83
  385. package/src/components/native-select/native-select.tsx +0 -54
  386. package/src/components/navigation-menu/navigation-menu.meta.md +0 -118
  387. package/src/components/navigation-menu/navigation-menu.stories.tsx +0 -215
  388. package/src/components/navigation-menu/navigation-menu.tsx +0 -129
  389. package/src/components/notification/notification.meta.md +0 -133
  390. package/src/components/notification/notification.stories.tsx +0 -98
  391. package/src/components/notification/notification.tsx +0 -99
  392. package/src/components/page-header/DEVELOPMENT.md +0 -842
  393. package/src/components/page-header/page-header.meta.md +0 -210
  394. package/src/components/page-header/page-header.stories.tsx +0 -428
  395. package/src/components/page-header/page-header.tsx +0 -284
  396. package/src/components/page-shell/page-shell.meta.md +0 -116
  397. package/src/components/page-shell/page-shell.stories.tsx +0 -149
  398. package/src/components/page-shell/page-shell.tsx +0 -115
  399. package/src/components/pagination/pagination.meta.md +0 -230
  400. package/src/components/pagination/pagination.stories.tsx +0 -284
  401. package/src/components/pagination/pagination.tsx +0 -567
  402. package/src/components/popconfirm/popconfirm.meta.md +0 -114
  403. package/src/components/popconfirm/popconfirm.stories.tsx +0 -75
  404. package/src/components/popconfirm/popconfirm.tsx +0 -134
  405. package/src/components/popover/popover.meta.md +0 -154
  406. package/src/components/popover/popover.stories.tsx +0 -158
  407. package/src/components/popover/popover.tsx +0 -104
  408. package/src/components/progress/progress.meta.md +0 -118
  409. package/src/components/progress/progress.stories.tsx +0 -75
  410. package/src/components/progress/progress.tsx +0 -203
  411. package/src/components/radio-group/radio-group.meta.md +0 -175
  412. package/src/components/radio-group/radio-group.stories.tsx +0 -113
  413. package/src/components/radio-group/radio-group.tsx +0 -209
  414. package/src/components/rate/rate.meta.md +0 -118
  415. package/src/components/rate/rate.stories.tsx +0 -89
  416. package/src/components/rate/rate.tsx +0 -180
  417. package/src/components/resizable/resizable.meta.md +0 -95
  418. package/src/components/resizable/resizable.stories.tsx +0 -104
  419. package/src/components/resizable/resizable.tsx +0 -56
  420. package/src/components/result/result.meta.md +0 -95
  421. package/src/components/result/result.stories.tsx +0 -67
  422. package/src/components/result/result.tsx +0 -100
  423. package/src/components/scroll-area/scroll-area.meta.md +0 -85
  424. package/src/components/scroll-area/scroll-area.stories.tsx +0 -49
  425. package/src/components/scroll-area/scroll-area.tsx +0 -51
  426. package/src/components/segmented/segmented.meta.md +0 -106
  427. package/src/components/segmented/segmented.stories.tsx +0 -130
  428. package/src/components/segmented/segmented.tsx +0 -146
  429. package/src/components/select/select.meta.md +0 -255
  430. package/src/components/select/select.stories.tsx +0 -275
  431. package/src/components/select/select.tsx +0 -735
  432. package/src/components/separator/separator.meta.md +0 -75
  433. package/src/components/separator/separator.stories.tsx +0 -71
  434. package/src/components/separator/separator.tsx +0 -100
  435. package/src/components/sheet/sheet.meta.md +0 -113
  436. package/src/components/sheet/sheet.stories.tsx +0 -188
  437. package/src/components/sheet/sheet.tsx +0 -226
  438. package/src/components/sidebar/sidebar.meta.md +0 -151
  439. package/src/components/sidebar/sidebar.tsx +0 -853
  440. package/src/components/skeleton/skeleton.meta.md +0 -94
  441. package/src/components/skeleton/skeleton.stories.tsx +0 -79
  442. package/src/components/skeleton/skeleton.tsx +0 -144
  443. package/src/components/slider/slider.meta.md +0 -146
  444. package/src/components/slider/slider.stories.tsx +0 -121
  445. package/src/components/slider/slider.tsx +0 -227
  446. package/src/components/sonner/sonner.meta.md +0 -147
  447. package/src/components/sonner/sonner.stories.tsx +0 -164
  448. package/src/components/sonner/sonner.tsx +0 -169
  449. package/src/components/spinner/spinner.meta.md +0 -125
  450. package/src/components/spinner/spinner.stories.tsx +0 -123
  451. package/src/components/spinner/spinner.tsx +0 -166
  452. package/src/components/statistic/statistic.meta.md +0 -104
  453. package/src/components/statistic/statistic.stories.tsx +0 -67
  454. package/src/components/steps/steps.meta.md +0 -116
  455. package/src/components/steps/steps.stories.tsx +0 -115
  456. package/src/components/steps/steps.tsx +0 -173
  457. package/src/components/switch/switch.meta.md +0 -138
  458. package/src/components/switch/switch.stories.tsx +0 -75
  459. package/src/components/switch/switch.tsx +0 -169
  460. package/src/components/table/table.meta.md +0 -106
  461. package/src/components/table/table.stories.tsx +0 -80
  462. package/src/components/table/table.tsx +0 -124
  463. package/src/components/tabs/tabs.meta.md +0 -111
  464. package/src/components/tabs/tabs.stories.tsx +0 -156
  465. package/src/components/tabs/tabs.tsx +0 -190
  466. package/src/components/tag/tag.meta.md +0 -159
  467. package/src/components/tag/tag.stories.tsx +0 -250
  468. package/src/components/tag/tag.tsx +0 -386
  469. package/src/components/textarea/textarea.meta.md +0 -99
  470. package/src/components/textarea/textarea.stories.tsx +0 -89
  471. package/src/components/textarea/textarea.tsx +0 -137
  472. package/src/components/time-picker/time-picker.meta.md +0 -175
  473. package/src/components/time-picker/time-picker.stories.tsx +0 -129
  474. package/src/components/time-picker/time-picker.tsx +0 -946
  475. package/src/components/timeline/timeline.meta.md +0 -110
  476. package/src/components/timeline/timeline.stories.tsx +0 -134
  477. package/src/components/timeline/timeline.tsx +0 -168
  478. package/src/components/toggle/toggle.meta.md +0 -89
  479. package/src/components/toggle/toggle.stories.tsx +0 -66
  480. package/src/components/toggle/toggle.tsx +0 -54
  481. package/src/components/toggle-group/toggle-group.meta.md +0 -91
  482. package/src/components/toggle-group/toggle-group.stories.tsx +0 -83
  483. package/src/components/toggle-group/toggle-group.tsx +0 -78
  484. package/src/components/tooltip/tooltip.meta.md +0 -149
  485. package/src/components/tooltip/tooltip.stories.tsx +0 -108
  486. package/src/components/tooltip/tooltip.tsx +0 -153
  487. package/src/components/tour/tour.meta.md +0 -121
  488. package/src/components/tour/tour.stories.tsx +0 -66
  489. package/src/components/tour/tour.tsx +0 -242
  490. package/src/components/transfer/transfer.meta.md +0 -95
  491. package/src/components/transfer/transfer.stories.tsx +0 -64
  492. package/src/components/transfer/transfer.tsx +0 -258
  493. package/src/components/tree/tree.meta.md +0 -169
  494. package/src/components/tree/tree.stories.tsx +0 -128
  495. package/src/components/tree/tree.tsx +0 -368
  496. package/src/components/tree-select/tree-select.meta.md +0 -151
  497. package/src/components/tree-select/tree-select.stories.tsx +0 -80
  498. package/src/components/tree-select/tree-select.tsx +0 -206
  499. package/src/components/typography/typography.meta.md +0 -149
  500. package/src/components/typography/typography.stories.tsx +0 -116
  501. package/src/components/typography/typography.tsx +0 -260
  502. package/src/components/upload/upload.meta.md +0 -156
  503. package/src/components/upload/upload.stories.tsx +0 -135
  504. package/src/components/upload/upload.tsx +0 -398
  505. package/src/components/watermark/watermark.meta.md +0 -100
  506. package/src/components/watermark/watermark.stories.tsx +0 -170
  507. package/src/components/watermark/watermark.tsx +0 -166
  508. package/src/hooks/use-breakpoint.ts +0 -117
  509. package/src/hooks/use-debounce-callback.ts +0 -52
  510. package/src/stories/theme-tokens.stories.tsx +0 -747
  511. package/src/utils/trigger-input.ts +0 -57
@@ -0,0 +1,379 @@
1
+ /**
2
+ * 选项卡 Tabs
3
+ *
4
+ * 将内容组织到不同面板中,每次只展示一个面板的内容;提供平级区域将大块内容收纳与展现。
5
+ *
6
+ * @when
7
+ * - 内容可按主题/类别分组,且同时只需关注一个分组(页面级主导航首选 line)
8
+ * - 紧凑互斥单选场景(视图切换 / 时间区间 / 主题档),用 capsule 取代 Segmented
9
+ * - 弱视觉的次级切换(仅靠颜色区分),用 text
10
+ * - 包裹型 card 切换(页面局部分块),用 wrapped
11
+ *
12
+ * 组合结构:Tabs > TabsList (+extra) > TabsTrigger / TabsContent
13
+ */
14
+
15
+ 'use client';
16
+
17
+ import * as React from 'react';
18
+ import { cva, type VariantProps } from 'class-variance-authority';
19
+ import { Tabs as TabsPrimitive } from 'radix-ui';
20
+ import { ChevronLeftIcon, ChevronRightIcon, XIcon } from 'lucide-react';
21
+
22
+ import { cn } from '@/lib/utils';
23
+
24
+ // ─── Context ────────────────────────────────────────────────────────────────
25
+
26
+ type TabsVariant = 'line' | 'capsule' | 'text' | 'wrapped';
27
+ type TabsSize = 'sm' | 'default';
28
+
29
+ const TabsListContext = React.createContext<{
30
+ variant: TabsVariant;
31
+ size: TabsSize;
32
+ }>({ variant: 'line', size: 'default' });
33
+
34
+ // ─── Tabs Root ──────────────────────────────────────────────────────────────
35
+
36
+ /** 选项卡根容器,管理激活状态与方向。 */
37
+ export interface TabsProps
38
+ extends Omit<
39
+ React.ComponentProps<typeof TabsPrimitive.Root>,
40
+ | 'value'
41
+ | 'defaultValue'
42
+ | 'onValueChange'
43
+ | 'orientation'
44
+ | 'dir'
45
+ | 'activationMode'
46
+ > {
47
+ /** 受控激活项的 value。 */
48
+ value?: string;
49
+ /** 非受控初始激活项的 value。 */
50
+ defaultValue?: string;
51
+ /**
52
+ * 激活项变化回调。
53
+ * @param value 当前激活项的 value
54
+ */
55
+ onValueChange?: (value: string) => void;
56
+ /** 选项卡方向。 @default 'horizontal' */
57
+ orientation?: 'horizontal' | 'vertical';
58
+ /** 文字方向。 */
59
+ dir?: 'ltr' | 'rtl';
60
+ /**
61
+ * 激活项触发方式。
62
+ * - `automatic`(默认):键盘导航时自动激活
63
+ * - `manual`:键盘导航时需手动 Enter / Space 才激活
64
+ * @default 'automatic'
65
+ */
66
+ activationMode?: 'automatic' | 'manual';
67
+ }
68
+
69
+ /** 选项卡根容器,管理激活状态与方向。 */
70
+ function Tabs({ className, orientation = 'horizontal', ...props }: TabsProps) {
71
+ return (
72
+ <TabsPrimitive.Root
73
+ data-slot="tabs"
74
+ data-orientation={orientation}
75
+ orientation={orientation}
76
+ className={cn(
77
+ 'group/tabs flex data-[orientation=horizontal]:flex-col data-[orientation=horizontal]:gap-0 data-[orientation=vertical]:gap-3',
78
+ className,
79
+ )}
80
+ {...props}
81
+ />
82
+ );
83
+ }
84
+
85
+ // ─── TabsList ───────────────────────────────────────────────────────────────
86
+
87
+ const tabsListVariants = cva(
88
+ 'group/tabs-list inline-flex items-center group-data-[orientation=vertical]/tabs:flex-col group-data-[orientation=vertical]/tabs:items-stretch',
89
+ {
90
+ variants: {
91
+ variant: {
92
+ // 下划线型(默认,等价 cd `pure`):底线/右线由 wrapper span 绘制(固定不随滚动)
93
+ line: 'w-full justify-start gap-4 bg-transparent text-muted-foreground group-data-[orientation=vertical]/tabs:w-fit group-data-[orientation=vertical]/tabs:gap-1',
94
+ // 胶囊型:muted 底容器 + 圆角 + 选中白底 shadow(紧凑互斥单选)
95
+ capsule:
96
+ 'w-fit justify-center gap-1 rounded-md bg-muted p-0.5 text-muted-foreground',
97
+ // 文本型:纯文本切换,trigger 间 ::after 竖线分隔
98
+ text: 'w-fit justify-start gap-0 bg-transparent text-muted-foreground',
99
+ // 包裹型:每个 trigger 完整边框,相邻共边(-ml-px),选中蓝色 outline
100
+ wrapped: 'w-full justify-start bg-transparent text-muted-foreground',
101
+ },
102
+ size: {
103
+ sm: '',
104
+ default: '',
105
+ },
106
+ },
107
+ compoundVariants: [
108
+ { variant: 'capsule', size: 'sm', class: 'h-9' },
109
+ { variant: 'capsule', size: 'default', class: 'h-10' },
110
+ ],
111
+ defaultVariants: { variant: 'line', size: 'default' },
112
+ },
113
+ );
114
+
115
+ export interface TabsListProps
116
+ extends Omit<React.ComponentProps<typeof TabsPrimitive.List>, 'children'>,
117
+ VariantProps<typeof tabsListVariants> {
118
+ /**
119
+ * 视觉风格。
120
+ * - `line`:下划线型(默认),页面级主导航 / 大区块切换首选
121
+ * - `capsule`:胶囊型,muted 底色 + 选中白底,取代 Segmented
122
+ * - `text`:纯文本切换,弱视觉次级导航
123
+ * - `wrapped`:包裹型 card,页面局部分块
124
+ * @default 'line'
125
+ */
126
+ variant?: TabsVariant;
127
+ /**
128
+ * 尺寸档位。
129
+ * @default 'default'
130
+ */
131
+ size?: TabsSize;
132
+ /** 右侧附加内容(仅 `variant='line'` 视觉对齐,常见于刷新/新建按钮)。 */
133
+ extra?: React.ReactNode;
134
+ children?: React.ReactNode;
135
+ }
136
+
137
+ /**
138
+ * 选项卡标签列表容器;通过 Context 把 variant/size 透传给 TabsTrigger。
139
+ * 溢出时自动显示左右箭头滚动。
140
+ *
141
+ * 架构说明(line variant):
142
+ * - wrapper (relative isolate) 的 ::after 画底线 — 固定不随滚动
143
+ * - list (overflow-x-auto pb-px) 做横向滚动容器
144
+ * - trigger (-mb-px border-b-2) 选中线覆盖底线(z 层级 > after:-z-10)
145
+ */
146
+ function TabsList({
147
+ className,
148
+ variant = 'line',
149
+ size = 'default',
150
+ extra,
151
+ children,
152
+ ...props
153
+ }: TabsListProps) {
154
+ const scrollRef = React.useRef<HTMLDivElement>(null);
155
+ const [overflow, setOverflow] = React.useState({ left: false, right: false });
156
+
157
+ const checkOverflow = React.useCallback(() => {
158
+ const el = scrollRef.current;
159
+ if (!el) return;
160
+ const { scrollLeft, scrollWidth, clientWidth } = el;
161
+ setOverflow({
162
+ left: scrollLeft > 1,
163
+ right: scrollLeft < scrollWidth - clientWidth - 1,
164
+ });
165
+ }, []);
166
+
167
+ React.useEffect(() => {
168
+ const el = scrollRef.current;
169
+ if (!el) return;
170
+ checkOverflow();
171
+ el.addEventListener('scroll', checkOverflow, { passive: true });
172
+ const ro = new ResizeObserver(checkOverflow);
173
+ ro.observe(el);
174
+ return () => {
175
+ el.removeEventListener('scroll', checkOverflow);
176
+ ro.disconnect();
177
+ };
178
+ }, [checkOverflow]);
179
+
180
+ const scroll = (dir: 'left' | 'right') => {
181
+ scrollRef.current?.scrollBy({
182
+ left: dir === 'left' ? -200 : 200,
183
+ behavior: 'smooth',
184
+ });
185
+ };
186
+
187
+ const hasOverflow = overflow.left || overflow.right;
188
+
189
+ return (
190
+ <div
191
+ data-slot="tabs-list-wrapper"
192
+ className={cn(
193
+ 'relative isolate flex items-center',
194
+ 'mb-3 group-data-[orientation=vertical]/tabs:mb-0',
195
+ )}
196
+ >
197
+ {/* line variant: 固定参考线(不随滚动),z:-10 在 trigger 内容层之下
198
+ horizontal: 底线(h-px, bottom-0, inset-x-0)
199
+ vertical: 右线(w-px, right-0, inset-y-0) */}
200
+ {variant === 'line' && (
201
+ <span
202
+ aria-hidden
203
+ className="pointer-events-none absolute -z-10 bg-border bottom-0 left-0 right-0 h-px group-data-[orientation=vertical]/tabs:top-0 group-data-[orientation=vertical]/tabs:left-auto group-data-[orientation=vertical]/tabs:h-auto group-data-[orientation=vertical]/tabs:w-px"
204
+ />
205
+ )}
206
+ <TabsPrimitive.List
207
+ ref={scrollRef as React.Ref<HTMLDivElement>}
208
+ data-slot="tabs-list"
209
+ data-variant={variant}
210
+ data-size={size}
211
+ className={cn(
212
+ tabsListVariants({ variant, size }),
213
+ // line/wrapped: 占满,capsule/text: 自适应
214
+ (variant === 'line' || variant === 'wrapped') &&
215
+ 'min-w-0 flex-1 overflow-x-auto scrollbar-none group-data-[orientation=vertical]/tabs:min-w-fit group-data-[orientation=vertical]/tabs:flex-none group-data-[orientation=vertical]/tabs:overflow-x-visible',
216
+ // overflow 隐式 clip → 加 pb-px/pr-px 给 1px 余量让 active border 完整可见
217
+ variant === 'line' &&
218
+ 'pb-px group-data-[orientation=vertical]/tabs:pb-0 group-data-[orientation=vertical]/tabs:pr-px',
219
+ className,
220
+ )}
221
+ {...props}
222
+ >
223
+ <TabsListContext.Provider value={{ variant, size }}>
224
+ {children}
225
+ </TabsListContext.Provider>
226
+ </TabsPrimitive.List>
227
+ {/* 左右箭头:始终渲染同一 DOM 位置,通过 hidden 控制显隐 */}
228
+ <button
229
+ type="button"
230
+ data-slot="tabs-nav-prev"
231
+ aria-label="向左滚动"
232
+ tabIndex={-1}
233
+ disabled={!overflow.left}
234
+ onClick={() => scroll('left')}
235
+ className={cn(
236
+ 'inline-flex size-7 shrink-0 cursor-pointer items-center justify-center text-muted-foreground transition-colors hover:text-foreground disabled:cursor-default disabled:opacity-30',
237
+ !hasOverflow && 'hidden',
238
+ )}
239
+ >
240
+ <ChevronLeftIcon className="size-4" />
241
+ </button>
242
+ <button
243
+ type="button"
244
+ data-slot="tabs-nav-next"
245
+ aria-label="向右滚动"
246
+ tabIndex={-1}
247
+ disabled={!overflow.right}
248
+ onClick={() => scroll('right')}
249
+ className={cn(
250
+ 'inline-flex size-7 shrink-0 cursor-pointer items-center justify-center text-muted-foreground transition-colors hover:text-foreground disabled:cursor-default disabled:opacity-30',
251
+ !hasOverflow && 'hidden',
252
+ )}
253
+ >
254
+ <ChevronRightIcon className="size-4" />
255
+ </button>
256
+ {extra && (
257
+ <div data-slot="tabs-extra" className="shrink-0">
258
+ {extra}
259
+ </div>
260
+ )}
261
+ </div>
262
+ );
263
+ }
264
+
265
+ // ─── TabsTrigger ────────────────────────────────────────────────────────────
266
+
267
+ const tabsTriggerVariants = cva(
268
+ 'group/tabs-trigger relative inline-flex shrink-0 cursor-pointer items-center justify-center gap-1.5 whitespace-nowrap font-normal outline-none transition-all hover:text-foreground focus-visible:ring-1 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50 data-[state=active]:font-semibold [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*=size-])]:size-3.5',
269
+ {
270
+ variants: {
271
+ variant: {
272
+ line: '-mb-px border-b-2 border-transparent text-muted-foreground data-[state=active]:border-primary data-[state=active]:text-foreground group-data-[orientation=vertical]/tabs:mb-0 group-data-[orientation=vertical]/tabs:-mr-px group-data-[orientation=vertical]/tabs:border-b-0 group-data-[orientation=vertical]/tabs:border-r-2 group-data-[orientation=vertical]/tabs:justify-start',
273
+ capsule:
274
+ 'rounded-md text-muted-foreground data-[state=active]:bg-background data-[state=active]:text-foreground data-[state=active]:shadow-sm',
275
+ // text 模式:trigger 间 ::after 竖线分隔(8px 高、1px 宽、垂直居中、border 色)
276
+ text: 'text-muted-foreground after:absolute after:right-0 after:top-1/2 after:-translate-y-1/2 after:h-2 after:w-px after:bg-border last:after:hidden data-[state=active]:text-primary',
277
+ wrapped:
278
+ '-ml-px first:ml-0 first:rounded-l-sm last:rounded-r-sm border border-border text-muted-foreground data-[state=active]:z-10 data-[state=active]:border-primary data-[state=active]:text-foreground',
279
+ },
280
+ size: {
281
+ sm: 'h-9 px-4 text-xs',
282
+ default: 'h-10 px-4 text-sm',
283
+ },
284
+ },
285
+ compoundVariants: [
286
+ { variant: 'capsule', size: 'sm', class: 'h-8' },
287
+ { variant: 'capsule', size: 'default', class: 'h-9' },
288
+ { variant: 'text', size: 'sm', class: 'h-9 px-4' },
289
+ { variant: 'text', size: 'default', class: 'h-10 px-4' },
290
+ ],
291
+ defaultVariants: { variant: 'line', size: 'default' },
292
+ },
293
+ );
294
+
295
+ export interface TabsTriggerProps
296
+ extends React.ComponentProps<typeof TabsPrimitive.Trigger> {
297
+ /** 显式覆盖来自 TabsList 的 variant(罕用)。 */
298
+ variant?: TabsVariant;
299
+ /** 显式覆盖来自 TabsList 的 size(罕用)。 */
300
+ size?: TabsSize;
301
+ /** 单个选项卡是否可关闭(在 trigger 内显示 X 关闭图标)。 @default false */
302
+ closable?: boolean;
303
+ /** 关闭回调(点击 X 时触发,参数为当前 trigger 的 value)。 */
304
+ onClose?: (value: string) => void;
305
+ }
306
+
307
+ /** 单个选项卡触发器(标签)。 */
308
+ function TabsTrigger({
309
+ className,
310
+ variant,
311
+ size,
312
+ closable,
313
+ onClose,
314
+ value,
315
+ children,
316
+ ...props
317
+ }: TabsTriggerProps) {
318
+ const ctx = React.useContext(TabsListContext);
319
+ const v = variant ?? ctx.variant;
320
+ const s = size ?? ctx.size;
321
+ return (
322
+ <TabsPrimitive.Trigger
323
+ data-slot="tabs-trigger"
324
+ data-variant={v}
325
+ data-size={s}
326
+ value={value}
327
+ className={cn(tabsTriggerVariants({ variant: v, size: s }), className)}
328
+ {...props}
329
+ >
330
+ {children}
331
+ {closable && (
332
+ <span
333
+ role="button"
334
+ aria-label="关闭"
335
+ tabIndex={-1}
336
+ onClick={(e) => {
337
+ e.stopPropagation();
338
+ onClose?.(value as string);
339
+ }}
340
+ onKeyDown={(e) => {
341
+ if (e.key === 'Enter' || e.key === ' ') {
342
+ e.preventDefault();
343
+ e.stopPropagation();
344
+ onClose?.(value as string);
345
+ }
346
+ }}
347
+ className="-mr-1 ml-1 inline-flex size-4 cursor-pointer items-center justify-center rounded-sm text-muted-foreground hover:bg-muted hover:text-foreground"
348
+ >
349
+ <XIcon className="size-3" />
350
+ </span>
351
+ )}
352
+ </TabsPrimitive.Trigger>
353
+ );
354
+ }
355
+
356
+ // ─── TabsContent ────────────────────────────────────────────────────────────
357
+
358
+ /** 选项卡面板内容区。 */
359
+ function TabsContent({
360
+ className,
361
+ ...props
362
+ }: React.ComponentProps<typeof TabsPrimitive.Content>) {
363
+ return (
364
+ <TabsPrimitive.Content
365
+ data-slot="tabs-content"
366
+ className={cn('flex-1 text-xs outline-none', className)}
367
+ {...props}
368
+ />
369
+ );
370
+ }
371
+
372
+ export {
373
+ Tabs,
374
+ TabsList,
375
+ TabsTrigger,
376
+ TabsContent,
377
+ tabsListVariants,
378
+ tabsTriggerVariants,
379
+ };
@@ -0,0 +1,244 @@
1
+ # Tabs
2
+
3
+ > 本文件由 `pnpm gen:meta` 自动生成,**请勿手动编辑**。
4
+
5
+ ## 描述
6
+
7
+ 选项卡 Tabs
8
+ 将内容组织到不同面板中,每次只展示一个面板的内容;提供平级区域将大块内容收纳与展现。
9
+
10
+ ## 使用场景
11
+
12
+ - 内容可按主题/类别分组,且同时只需关注一个分组(页面级主导航首选 line)
13
+ - 紧凑互斥单选场景(视图切换 / 时间区间 / 主题档),用 capsule 取代 Segmented
14
+ - 弱视觉的次级切换(仅靠颜色区分),用 text
15
+ - 包裹型 card 切换(页面局部分块),用 wrapped
16
+ - 组合结构:Tabs > TabsList (+extra) > TabsTrigger / TabsContent
17
+
18
+ ## Props
19
+
20
+ | 名称 | 类型 | 默认值 | 必填 | 说明 |
21
+ | --- | --- | --- | --- | --- |
22
+ | `value` | `string` | – | – | 受控激活项的 value。 |
23
+ | `defaultValue` | `string` | – | – | 非受控初始激活项的 value。 |
24
+ | `onValueChange` | `(value: string) => void` | – | – | 激活项变化回调。 |
25
+ | `orientation` | `'horizontal' \| 'vertical'` | `'horizontal'` | – | 选项卡方向。 |
26
+ | `dir` | `'ltr' \| 'rtl'` | – | – | 文字方向。 |
27
+ | `activationMode` | `'automatic' \| 'manual'` | `'automatic'` | – | 激活项触发方式。 - `automatic`(默认):键盘导航时自动激活 - `manual`:键盘导航时需手动 Enter / Space 才激活 |
28
+ | `variant` | `TabsVariant` | `'line'` | – | 视觉风格。 - `line`:下划线型(默认),页面级主导航 / 大区块切换首选 - `capsule`:胶囊型,muted 底色 + 选中白底,取代 Segmented - `text`:纯文本切换,弱视觉次级导航 - `wrapped`:包裹型 card,页面局部分块 |
29
+ | `size` | `TabsSize` | `'default'` | – | 尺寸档位。 |
30
+ | `extra` | `React.ReactNode` | – | – | 右侧附加内容(仅 `variant='line'` 视觉对齐,常见于刷新/新建按钮)。 |
31
+ | `children` | `React.ReactNode` | – | – | – |
32
+ | `variant` | `TabsVariant` | – | – | 显式覆盖来自 TabsList 的 variant(罕用)。 |
33
+ | `size` | `TabsSize` | – | – | 显式覆盖来自 TabsList 的 size(罕用)。 |
34
+ | `closable` | `boolean` | `false` | – | 单个选项卡是否可关闭(在 trigger 内显示 X 关闭图标)。 |
35
+ | `onClose` | `(value: string) => void` | – | – | 关闭回调(点击 X 时触发,参数为当前 trigger 的 value)。 |
36
+
37
+ ## 示例
38
+
39
+ ### Capsule
40
+
41
+ 胶囊型(capsule variant):muted 底色容器 + 选中白底,紧凑互斥单选场景。
42
+
43
+ ```tsx
44
+ <Tabs defaultValue="day">
45
+ <TabsList variant="capsule">
46
+ <TabsTrigger value="day">今日</TabsTrigger>
47
+ <TabsTrigger value="week">本周</TabsTrigger>
48
+ <TabsTrigger value="month">本月</TabsTrigger>
49
+ </TabsList>
50
+ <TabsContent value="day">
51
+ <p className="text-muted-foreground">今日数据汇总。</p>
52
+ </TabsContent>
53
+ <TabsContent value="week">
54
+ <p className="text-muted-foreground">本周数据汇总。</p>
55
+ </TabsContent>
56
+ <TabsContent value="month">
57
+ <p className="text-muted-foreground">本月数据汇总。</p>
58
+ </TabsContent>
59
+ </Tabs>
60
+ ```
61
+
62
+ ### Text
63
+
64
+ 文本型(text variant):纯文本切换,无背景无下划线,仅颜色变化。
65
+
66
+ ```tsx
67
+ <Tabs defaultValue="overview">
68
+ <TabsList variant="text">
69
+ <TabsTrigger value="overview">概览</TabsTrigger>
70
+ <TabsTrigger value="analytics">分析</TabsTrigger>
71
+ <TabsTrigger value="reports">报告</TabsTrigger>
72
+ </TabsList>
73
+ <TabsContent value="overview">
74
+ <p className="text-muted-foreground">系统运行概览。</p>
75
+ </TabsContent>
76
+ <TabsContent value="analytics">
77
+ <p className="text-muted-foreground">详细分析图表。</p>
78
+ </TabsContent>
79
+ <TabsContent value="reports">
80
+ <p className="text-muted-foreground">定期生成的报告。</p>
81
+ </TabsContent>
82
+ </Tabs>
83
+ ```
84
+
85
+ ### Wrapped
86
+
87
+ 包裹型(wrapped variant):每项是独立 card,选中态蓝色 outline。
88
+
89
+ ```tsx
90
+ <Tabs defaultValue="general">
91
+ <TabsList variant="wrapped">
92
+ <TabsTrigger value="general">通用</TabsTrigger>
93
+ <TabsTrigger value="advanced">高级</TabsTrigger>
94
+ <TabsTrigger value="experimental">实验</TabsTrigger>
95
+ </TabsList>
96
+ <TabsContent value="general">
97
+ <p className="text-muted-foreground">通用设置项。</p>
98
+ </TabsContent>
99
+ <TabsContent value="advanced">
100
+ <p className="text-muted-foreground">高级配置选项。</p>
101
+ </TabsContent>
102
+ <TabsContent value="experimental">
103
+ <p className="text-muted-foreground">实验性功能开关。</p>
104
+ </TabsContent>
105
+ </Tabs>
106
+ ```
107
+
108
+ ### Sizes
109
+
110
+ 尺寸档位 sm / default。
111
+
112
+ ```tsx
113
+ <div className="flex flex-col gap-6">
114
+ <Tabs defaultValue="a">
115
+ <TabsList size="sm">
116
+ <TabsTrigger value="a">小尺寸 A</TabsTrigger>
117
+ <TabsTrigger value="b">小尺寸 B</TabsTrigger>
118
+ </TabsList>
119
+ </Tabs>
120
+ <Tabs defaultValue="a">
121
+ <TabsList size="default">
122
+ <TabsTrigger value="a">默认 A</TabsTrigger>
123
+ <TabsTrigger value="b">默认 B</TabsTrigger>
124
+ </TabsList>
125
+ </Tabs>
126
+ <Tabs defaultValue="a">
127
+ <TabsList variant="capsule" size="sm">
128
+ <TabsTrigger value="a">小</TabsTrigger>
129
+ <TabsTrigger value="b">中</TabsTrigger>
130
+ </TabsList>
131
+ </Tabs>
132
+ <Tabs defaultValue="a">
133
+ <TabsList variant="capsule" size="default">
134
+ <TabsTrigger value="a">小</TabsTrigger>
135
+ <TabsTrigger value="b">中</TabsTrigger>
136
+ </TabsList>
137
+ </Tabs>
138
+ </div>
139
+ ```
140
+
141
+ ### WithExtra
142
+
143
+ 右侧附加内容(extra prop),常见于刷新/新建等操作入口。
144
+
145
+ ```tsx
146
+ <Tabs defaultValue="all">
147
+ <TabsList
148
+ extra={
149
+ <div className="flex gap-3 text-sm">
150
+ <a href="#" className="text-muted-foreground hover:text-foreground">
151
+ 刷新
152
+ </a>
153
+ <a href="#" className="text-primary hover:text-primary/80">
154
+ 新建
155
+ </a>
156
+ </div>
157
+ }
158
+ >
159
+ <TabsTrigger value="all">全部</TabsTrigger>
160
+ <TabsTrigger value="active">运行中</TabsTrigger>
161
+ <TabsTrigger value="archived">已归档</TabsTrigger>
162
+ </TabsList>
163
+ <TabsContent value="all">
164
+ <p className="text-muted-foreground">全部任务列表。</p>
165
+ </TabsContent>
166
+ <TabsContent value="active">
167
+ <p className="text-muted-foreground">运行中的任务。</p>
168
+ </TabsContent>
169
+ <TabsContent value="archived">
170
+ <p className="text-muted-foreground">已归档的任务。</p>
171
+ </TabsContent>
172
+ </Tabs>
173
+ ```
174
+
175
+ ### Disabled
176
+
177
+ 禁用某个选项卡。
178
+
179
+ ```tsx
180
+ <Tabs defaultValue="general">
181
+ <TabsList>
182
+ <TabsTrigger value="general">通用</TabsTrigger>
183
+ <TabsTrigger value="advanced" disabled>
184
+ 高级(禁用)
185
+ </TabsTrigger>
186
+ <TabsTrigger value="other">其他</TabsTrigger>
187
+ </TabsList>
188
+ <TabsContent value="general">
189
+ <p className="text-muted-foreground">通用设置。</p>
190
+ </TabsContent>
191
+ <TabsContent value="other">
192
+ <p className="text-muted-foreground">其他选项。</p>
193
+ </TabsContent>
194
+ </Tabs>
195
+ ```
196
+
197
+ ### Vertical
198
+
199
+ 垂直方向选项卡。
200
+
201
+ ```tsx
202
+ <Tabs defaultValue="profile" orientation="vertical">
203
+ <TabsList>
204
+ <TabsTrigger value="profile">个人资料</TabsTrigger>
205
+ <TabsTrigger value="security">安全</TabsTrigger>
206
+ <TabsTrigger value="billing">账单</TabsTrigger>
207
+ </TabsList>
208
+ <TabsContent value="profile">
209
+ <p className="text-muted-foreground">管理你的公开个人资料信息。</p>
210
+ </TabsContent>
211
+ <TabsContent value="security">
212
+ <p className="text-muted-foreground">两步验证、登录设备管理。</p>
213
+ </TabsContent>
214
+ <TabsContent value="billing">
215
+ <p className="text-muted-foreground">查看和管理订阅计划。</p>
216
+ </TabsContent>
217
+ </Tabs>
218
+ ```
219
+
220
+ ### Overflow
221
+
222
+ 溢出滑动:当选项卡超出容器宽度时,显示左右箭头进行滑动。
223
+
224
+ ```tsx
225
+ <Tabs defaultValue="tab-1" className="max-w-80">
226
+ <TabsList>
227
+ <TabsTrigger value="tab-1">概览</TabsTrigger>
228
+ <TabsTrigger value="tab-2">详细信息</TabsTrigger>
229
+ <TabsTrigger value="tab-3">配置管理</TabsTrigger>
230
+ <TabsTrigger value="tab-4">操作日志</TabsTrigger>
231
+ <TabsTrigger value="tab-5">关联资源</TabsTrigger>
232
+ <TabsTrigger value="tab-6">监控告警</TabsTrigger>
233
+ <TabsTrigger value="tab-7">权限管理</TabsTrigger>
234
+ </TabsList>
235
+ <TabsContent value="tab-1">
236
+ <p className="text-muted-foreground">
237
+ 概览内容,尝试缩小宽度查看溢出滚动效果。
238
+ </p>
239
+ </TabsContent>
240
+ <TabsContent value="tab-2">
241
+ <p className="text-muted-foreground">详细信息内容。</p>
242
+ </TabsContent>
243
+ </Tabs>
244
+ ```