@teamix-evo/ui 0.3.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 (520) hide show
  1. package/README.md +46 -50
  2. package/manifest.json +420 -647
  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 -462
  273. package/src/components/button/demo/as-child.tsx +0 -24
  274. package/src/components/button/demo/basic.tsx +0 -8
  275. package/src/components/button/demo/block.tsx +0 -16
  276. package/src/components/button/demo/loading.tsx +0 -19
  277. package/src/components/button/demo/shapes.tsx +0 -18
  278. package/src/components/button/demo/sizes.tsx +0 -19
  279. package/src/components/button/demo/variants.tsx +0 -19
  280. package/src/components/button/demo/with-icon.tsx +0 -20
  281. package/src/components/calendar/calendar.meta.md +0 -128
  282. package/src/components/calendar/calendar.stories.tsx +0 -68
  283. package/src/components/calendar/calendar.tsx +0 -172
  284. package/src/components/card/card.meta.md +0 -139
  285. package/src/components/card/card.stories.tsx +0 -151
  286. package/src/components/card/card.tsx +0 -305
  287. package/src/components/carousel/carousel.meta.md +0 -118
  288. package/src/components/carousel/carousel.stories.tsx +0 -89
  289. package/src/components/carousel/carousel.tsx +0 -224
  290. package/src/components/cascader/cascader.meta.md +0 -140
  291. package/src/components/cascader/cascader.stories.tsx +0 -120
  292. package/src/components/cascader/cascader.tsx +0 -541
  293. package/src/components/checkbox/checkbox.meta.md +0 -167
  294. package/src/components/checkbox/checkbox.stories.tsx +0 -288
  295. package/src/components/checkbox/checkbox.tsx +0 -193
  296. package/src/components/collapsible/collapsible.meta.md +0 -88
  297. package/src/components/collapsible/collapsible.stories.tsx +0 -43
  298. package/src/components/collapsible/collapsible.tsx +0 -105
  299. package/src/components/color-picker/color-picker.meta.md +0 -89
  300. package/src/components/color-picker/color-picker.stories.tsx +0 -159
  301. package/src/components/color-picker/color-picker.tsx +0 -171
  302. package/src/components/command/command.meta.md +0 -120
  303. package/src/components/command/command.stories.tsx +0 -59
  304. package/src/components/command/command.tsx +0 -158
  305. package/src/components/context-menu/context-menu.meta.md +0 -93
  306. package/src/components/context-menu/context-menu.stories.tsx +0 -54
  307. package/src/components/context-menu/context-menu.tsx +0 -204
  308. package/src/components/data-table/data-table.meta.md +0 -150
  309. package/src/components/data-table/data-table.stories.tsx +0 -132
  310. package/src/components/data-table/data-table.tsx +0 -185
  311. package/src/components/date-picker/date-picker.meta.md +0 -175
  312. package/src/components/date-picker/date-picker.stories.tsx +0 -108
  313. package/src/components/date-picker/date-picker.tsx +0 -1554
  314. package/src/components/descriptions/descriptions.meta.md +0 -83
  315. package/src/components/descriptions/descriptions.stories.tsx +0 -60
  316. package/src/components/descriptions/descriptions.tsx +0 -137
  317. package/src/components/dialog/dialog.meta.md +0 -168
  318. package/src/components/dialog/dialog.stories.tsx +0 -255
  319. package/src/components/dialog/dialog.tsx +0 -180
  320. package/src/components/dialog/imperative.tsx +0 -252
  321. package/src/components/drawer/drawer.meta.md +0 -95
  322. package/src/components/drawer/drawer.stories.tsx +0 -71
  323. package/src/components/drawer/drawer.tsx +0 -23
  324. package/src/components/dropdown-menu/dropdown-menu.meta.md +0 -171
  325. package/src/components/dropdown-menu/dropdown-menu.stories.tsx +0 -198
  326. package/src/components/dropdown-menu/dropdown-menu.tsx +0 -209
  327. package/src/components/ellipsis/ellipsis.meta.md +0 -87
  328. package/src/components/ellipsis/ellipsis.stories.tsx +0 -72
  329. package/src/components/ellipsis/ellipsis.tsx +0 -153
  330. package/src/components/empty/empty.meta.md +0 -86
  331. package/src/components/empty/empty.stories.tsx +0 -46
  332. package/src/components/empty/empty.tsx +0 -54
  333. package/src/components/field/field.meta.md +0 -154
  334. package/src/components/field/field.stories.tsx +0 -497
  335. package/src/components/field/field.tsx +0 -392
  336. package/src/components/filter-bar/filter-bar.meta.md +0 -92
  337. package/src/components/filter-bar/filter-bar.stories.tsx +0 -1083
  338. package/src/components/filter-bar/filter-bar.tsx +0 -568
  339. package/src/components/flex/flex.meta.md +0 -142
  340. package/src/components/flex/flex.stories.tsx +0 -199
  341. package/src/components/flex/flex.tsx +0 -145
  342. package/src/components/float-button/float-button.meta.md +0 -92
  343. package/src/components/float-button/float-button.stories.tsx +0 -80
  344. package/src/components/float-button/float-button.tsx +0 -143
  345. package/src/components/form/form.meta.md +0 -153
  346. package/src/components/form/form.stories.tsx +0 -469
  347. package/src/components/form/form.tsx +0 -260
  348. package/src/components/grid/grid.meta.md +0 -92
  349. package/src/components/grid/grid.stories.tsx +0 -101
  350. package/src/components/grid/grid.tsx +0 -130
  351. package/src/components/hover-card/hover-card.meta.md +0 -103
  352. package/src/components/hover-card/hover-card.stories.tsx +0 -97
  353. package/src/components/hover-card/hover-card.tsx +0 -67
  354. package/src/components/icon/DEVELOPMENT.md +0 -809
  355. package/src/components/icon/icon.meta.md +0 -170
  356. package/src/components/icon/icon.stories.tsx +0 -344
  357. package/src/components/icon/icon.tsx +0 -248
  358. package/src/components/image/image.meta.md +0 -99
  359. package/src/components/image/image.stories.tsx +0 -55
  360. package/src/components/image/image.tsx +0 -140
  361. package/src/components/input/demo/basic.tsx +0 -12
  362. package/src/components/input/demo/clearable.tsx +0 -21
  363. package/src/components/input/demo/show-count.tsx +0 -18
  364. package/src/components/input/demo/sizes.tsx +0 -15
  365. package/src/components/input/input.meta.md +0 -115
  366. package/src/components/input/input.stories.tsx +0 -144
  367. package/src/components/input/input.tsx +0 -212
  368. package/src/components/input-group/input-group.meta.md +0 -124
  369. package/src/components/input-group/input-group.stories.tsx +0 -121
  370. package/src/components/input-group/input-group.tsx +0 -143
  371. package/src/components/input-number/input-number.meta.md +0 -148
  372. package/src/components/input-number/input-number.stories.tsx +0 -125
  373. package/src/components/input-number/input-number.tsx +0 -283
  374. package/src/components/input-otp/input-otp.meta.md +0 -106
  375. package/src/components/input-otp/input-otp.stories.tsx +0 -65
  376. package/src/components/input-otp/input-otp.tsx +0 -97
  377. package/src/components/item/item.meta.md +0 -121
  378. package/src/components/item/item.stories.tsx +0 -116
  379. package/src/components/item/item.tsx +0 -172
  380. package/src/components/kbd/kbd.meta.md +0 -94
  381. package/src/components/kbd/kbd.stories.tsx +0 -70
  382. package/src/components/kbd/kbd.tsx +0 -86
  383. package/src/components/label/label.meta.md +0 -99
  384. package/src/components/label/label.stories.tsx +0 -145
  385. package/src/components/label/label.tsx +0 -138
  386. package/src/components/masonry/masonry.meta.md +0 -90
  387. package/src/components/masonry/masonry.stories.tsx +0 -68
  388. package/src/components/masonry/masonry.tsx +0 -60
  389. package/src/components/mentions/mentions.meta.md +0 -119
  390. package/src/components/mentions/mentions.stories.tsx +0 -189
  391. package/src/components/mentions/mentions.tsx +0 -243
  392. package/src/components/menubar/menubar.meta.md +0 -118
  393. package/src/components/menubar/menubar.stories.tsx +0 -141
  394. package/src/components/menubar/menubar.tsx +0 -232
  395. package/src/components/native-select/native-select.meta.md +0 -93
  396. package/src/components/native-select/native-select.stories.tsx +0 -83
  397. package/src/components/native-select/native-select.tsx +0 -54
  398. package/src/components/navigation-menu/navigation-menu.meta.md +0 -118
  399. package/src/components/navigation-menu/navigation-menu.stories.tsx +0 -215
  400. package/src/components/navigation-menu/navigation-menu.tsx +0 -129
  401. package/src/components/notification/notification.meta.md +0 -133
  402. package/src/components/notification/notification.stories.tsx +0 -98
  403. package/src/components/notification/notification.tsx +0 -99
  404. package/src/components/page-header/DEVELOPMENT.md +0 -842
  405. package/src/components/page-header/page-header.meta.md +0 -208
  406. package/src/components/page-header/page-header.stories.tsx +0 -421
  407. package/src/components/page-header/page-header.tsx +0 -281
  408. package/src/components/pagination/pagination.meta.md +0 -230
  409. package/src/components/pagination/pagination.stories.tsx +0 -284
  410. package/src/components/pagination/pagination.tsx +0 -577
  411. package/src/components/popconfirm/popconfirm.meta.md +0 -114
  412. package/src/components/popconfirm/popconfirm.stories.tsx +0 -75
  413. package/src/components/popconfirm/popconfirm.tsx +0 -134
  414. package/src/components/popover/popover.meta.md +0 -154
  415. package/src/components/popover/popover.stories.tsx +0 -158
  416. package/src/components/popover/popover.tsx +0 -104
  417. package/src/components/progress/progress.meta.md +0 -118
  418. package/src/components/progress/progress.stories.tsx +0 -75
  419. package/src/components/progress/progress.tsx +0 -203
  420. package/src/components/radio-group/radio-group.meta.md +0 -175
  421. package/src/components/radio-group/radio-group.stories.tsx +0 -113
  422. package/src/components/radio-group/radio-group.tsx +0 -209
  423. package/src/components/rate/rate.meta.md +0 -118
  424. package/src/components/rate/rate.stories.tsx +0 -89
  425. package/src/components/rate/rate.tsx +0 -180
  426. package/src/components/resizable/resizable.meta.md +0 -95
  427. package/src/components/resizable/resizable.stories.tsx +0 -104
  428. package/src/components/resizable/resizable.tsx +0 -56
  429. package/src/components/result/result.meta.md +0 -95
  430. package/src/components/result/result.stories.tsx +0 -67
  431. package/src/components/result/result.tsx +0 -100
  432. package/src/components/scroll-area/scroll-area.meta.md +0 -85
  433. package/src/components/scroll-area/scroll-area.stories.tsx +0 -49
  434. package/src/components/scroll-area/scroll-area.tsx +0 -51
  435. package/src/components/segmented/segmented.meta.md +0 -106
  436. package/src/components/segmented/segmented.stories.tsx +0 -130
  437. package/src/components/segmented/segmented.tsx +0 -146
  438. package/src/components/select/select.meta.md +0 -255
  439. package/src/components/select/select.stories.tsx +0 -275
  440. package/src/components/select/select.tsx +0 -735
  441. package/src/components/separator/separator.meta.md +0 -75
  442. package/src/components/separator/separator.stories.tsx +0 -71
  443. package/src/components/separator/separator.tsx +0 -100
  444. package/src/components/sheet/sheet.meta.md +0 -113
  445. package/src/components/sheet/sheet.stories.tsx +0 -188
  446. package/src/components/sheet/sheet.tsx +0 -226
  447. package/src/components/sidebar/sidebar.meta.md +0 -150
  448. package/src/components/sidebar/sidebar.tsx +0 -824
  449. package/src/components/skeleton/skeleton.meta.md +0 -94
  450. package/src/components/skeleton/skeleton.stories.tsx +0 -79
  451. package/src/components/skeleton/skeleton.tsx +0 -144
  452. package/src/components/slider/slider.meta.md +0 -146
  453. package/src/components/slider/slider.stories.tsx +0 -121
  454. package/src/components/slider/slider.tsx +0 -227
  455. package/src/components/sonner/sonner.meta.md +0 -147
  456. package/src/components/sonner/sonner.stories.tsx +0 -164
  457. package/src/components/sonner/sonner.tsx +0 -169
  458. package/src/components/spinner/spinner.meta.md +0 -125
  459. package/src/components/spinner/spinner.stories.tsx +0 -123
  460. package/src/components/spinner/spinner.tsx +0 -166
  461. package/src/components/statistic/statistic.meta.md +0 -104
  462. package/src/components/statistic/statistic.stories.tsx +0 -67
  463. package/src/components/steps/steps.meta.md +0 -116
  464. package/src/components/steps/steps.stories.tsx +0 -115
  465. package/src/components/steps/steps.tsx +0 -173
  466. package/src/components/switch/switch.meta.md +0 -138
  467. package/src/components/switch/switch.stories.tsx +0 -75
  468. package/src/components/switch/switch.tsx +0 -169
  469. package/src/components/table/table.meta.md +0 -106
  470. package/src/components/table/table.stories.tsx +0 -80
  471. package/src/components/table/table.tsx +0 -122
  472. package/src/components/tabs/tabs.meta.md +0 -111
  473. package/src/components/tabs/tabs.stories.tsx +0 -156
  474. package/src/components/tabs/tabs.tsx +0 -190
  475. package/src/components/tag/tag.meta.md +0 -159
  476. package/src/components/tag/tag.stories.tsx +0 -250
  477. package/src/components/tag/tag.tsx +0 -386
  478. package/src/components/textarea/textarea.meta.md +0 -99
  479. package/src/components/textarea/textarea.stories.tsx +0 -89
  480. package/src/components/textarea/textarea.tsx +0 -137
  481. package/src/components/time-picker/time-picker.meta.md +0 -175
  482. package/src/components/time-picker/time-picker.stories.tsx +0 -129
  483. package/src/components/time-picker/time-picker.tsx +0 -946
  484. package/src/components/timeline/timeline.meta.md +0 -110
  485. package/src/components/timeline/timeline.stories.tsx +0 -134
  486. package/src/components/timeline/timeline.tsx +0 -168
  487. package/src/components/toggle/toggle.meta.md +0 -89
  488. package/src/components/toggle/toggle.stories.tsx +0 -66
  489. package/src/components/toggle/toggle.tsx +0 -54
  490. package/src/components/toggle-group/toggle-group.meta.md +0 -91
  491. package/src/components/toggle-group/toggle-group.stories.tsx +0 -83
  492. package/src/components/toggle-group/toggle-group.tsx +0 -78
  493. package/src/components/tooltip/tooltip.meta.md +0 -149
  494. package/src/components/tooltip/tooltip.stories.tsx +0 -108
  495. package/src/components/tooltip/tooltip.tsx +0 -153
  496. package/src/components/tour/tour.meta.md +0 -121
  497. package/src/components/tour/tour.stories.tsx +0 -66
  498. package/src/components/tour/tour.tsx +0 -242
  499. package/src/components/transfer/transfer.meta.md +0 -95
  500. package/src/components/transfer/transfer.stories.tsx +0 -64
  501. package/src/components/transfer/transfer.tsx +0 -258
  502. package/src/components/tree/tree.meta.md +0 -169
  503. package/src/components/tree/tree.stories.tsx +0 -128
  504. package/src/components/tree/tree.tsx +0 -368
  505. package/src/components/tree-select/tree-select.meta.md +0 -151
  506. package/src/components/tree-select/tree-select.stories.tsx +0 -80
  507. package/src/components/tree-select/tree-select.tsx +0 -206
  508. package/src/components/typography/typography.meta.md +0 -149
  509. package/src/components/typography/typography.stories.tsx +0 -116
  510. package/src/components/typography/typography.tsx +0 -260
  511. package/src/components/upload/upload.meta.md +0 -156
  512. package/src/components/upload/upload.stories.tsx +0 -135
  513. package/src/components/upload/upload.tsx +0 -398
  514. package/src/components/watermark/watermark.meta.md +0 -100
  515. package/src/components/watermark/watermark.stories.tsx +0 -170
  516. package/src/components/watermark/watermark.tsx +0 -166
  517. package/src/hooks/use-breakpoint.ts +0 -117
  518. package/src/hooks/use-debounce-callback.ts +0 -52
  519. package/src/stories/theme-tokens.stories.tsx +0 -747
  520. package/src/utils/trigger-input.ts +0 -53
@@ -0,0 +1,335 @@
1
+ /**
2
+ * 加载指示器 Spinner
3
+ *
4
+ * shadcn v4 composable 套件:原子 Spinner + SpinnerTip 文案 + SpinnerOverlay 包裹遮罩 + SpinnerFullscreen 全屏遮罩。
5
+ * 对齐 cloud-design Loading 的能力(visible / tip / tipAlign / indicator / inline / 100ms 防闪 / fullScreen / Esc 关闭)。
6
+ *
7
+ * @when
8
+ * - 按钮 / Trigger / 单元格内的行内 loading 反馈
9
+ * - 局部内容区在异步加载时的遮罩态(包裹模式 + 100ms 防闪)
10
+ * - 关键操作(提交、保存)时的全屏阻断态(带 Esc 关闭)
11
+ *
12
+ * 组合结构:SpinnerOverlay > children + SpinnerOverlayMask > Spinner + SpinnerTip
13
+ */
14
+
15
+ import * as React from 'react';
16
+ import { createPortal } from 'react-dom';
17
+ import { cva, type VariantProps } from 'class-variance-authority';
18
+ import { Loader2Icon } from 'lucide-react';
19
+
20
+ import { cn } from '@/lib/utils';
21
+
22
+ /* ────────────────────────────────────────────────────────────────────────── */
23
+ /* Spinner(原子) */
24
+ /* ────────────────────────────────────────────────────────────────────────── */
25
+
26
+ const spinnerVariants = cva('shrink-0 animate-spin', {
27
+ variants: {
28
+ size: {
29
+ xs: 'size-3',
30
+ sm: 'size-3.5',
31
+ md: 'size-4',
32
+ lg: 'size-5',
33
+ },
34
+ tone: {
35
+ default: 'text-current',
36
+ primary: 'text-primary',
37
+ inverse: 'text-primary-foreground',
38
+ muted: 'text-muted-foreground',
39
+ },
40
+ },
41
+ defaultVariants: {
42
+ tone: 'default',
43
+ },
44
+ });
45
+
46
+ export interface SpinnerProps
47
+ extends Omit<React.ComponentProps<'svg'>, 'children'>,
48
+ VariantProps<typeof spinnerVariants> {
49
+ /** sr-only 读屏文本,默认 `加载中`;如父级已有可见 tip 可置空 */
50
+ label?: string;
51
+ }
52
+
53
+ /**
54
+ * 原子旋转指示符。size 不传时由父级 svg utility 决定(兼容 Button `[&_svg]:size-4` 链路)。
55
+ */
56
+ function Spinner({
57
+ className,
58
+ size,
59
+ tone,
60
+ label = '加载中',
61
+ ...props
62
+ }: SpinnerProps) {
63
+ return (
64
+ <span
65
+ data-slot="spinner-root"
66
+ role="status"
67
+ aria-live="polite"
68
+ className="inline-flex shrink-0 items-center justify-center"
69
+ >
70
+ <Loader2Icon
71
+ data-slot="spinner"
72
+ data-size={size}
73
+ data-tone={tone ?? 'default'}
74
+ aria-hidden="true"
75
+ className={cn(spinnerVariants({ size, tone }), className)}
76
+ {...props}
77
+ />
78
+ {label ? <span className="sr-only">{label}</span> : null}
79
+ </span>
80
+ );
81
+ }
82
+
83
+ /* ────────────────────────────────────────────────────────────────────────── */
84
+ /* SpinnerTip(文案) */
85
+ /* ────────────────────────────────────────────────────────────────────────── */
86
+
87
+ /**
88
+ * Spinner 的文字提示,常与原子 Spinner 同行展示,或作为 SpinnerOverlay/Fullscreen 的内置 tip 节点。
89
+ */
90
+ function SpinnerTip({ className, ...props }: React.ComponentProps<'span'>) {
91
+ return (
92
+ <span
93
+ data-slot="spinner-tip"
94
+ className={cn('text-xs text-muted-foreground', className)}
95
+ {...props}
96
+ />
97
+ );
98
+ }
99
+
100
+ /* ────────────────────────────────────────────────────────────────────────── */
101
+ /* visibility hook(100ms 防闪) */
102
+ /* ────────────────────────────────────────────────────────────────────────── */
103
+
104
+ function useDelayedVisible(visible: boolean, delay: number): boolean {
105
+ const [shown, setShown] = React.useState(visible && delay <= 0);
106
+ const timerRef = React.useRef<ReturnType<typeof setTimeout> | null>(null);
107
+
108
+ React.useEffect(() => {
109
+ if (timerRef.current) {
110
+ clearTimeout(timerRef.current);
111
+ timerRef.current = null;
112
+ }
113
+ if (!visible) {
114
+ setShown(false);
115
+ return;
116
+ }
117
+ if (delay <= 0) {
118
+ setShown(true);
119
+ return;
120
+ }
121
+ timerRef.current = setTimeout(() => {
122
+ setShown(true);
123
+ timerRef.current = null;
124
+ }, delay);
125
+ return () => {
126
+ if (timerRef.current) {
127
+ clearTimeout(timerRef.current);
128
+ timerRef.current = null;
129
+ }
130
+ };
131
+ }, [visible, delay]);
132
+
133
+ return shown;
134
+ }
135
+
136
+ /* ────────────────────────────────────────────────────────────────────────── */
137
+ /* SpinnerOverlay(包裹模式) */
138
+ /* ────────────────────────────────────────────────────────────────────────── */
139
+
140
+ const OVERLAY_INDICATOR_SIZE: Record<
141
+ NonNullable<SpinnerOverlayProps['size']>,
142
+ NonNullable<SpinnerProps['size']>
143
+ > = {
144
+ sm: 'sm',
145
+ md: 'md',
146
+ lg: 'lg',
147
+ };
148
+
149
+ export interface SpinnerOverlayProps extends React.ComponentProps<'div'> {
150
+ /** loading 状态,默认 true。从 false→true 切换会延迟 `delay` 毫秒后显示,避免短任务闪烁 */
151
+ visible?: boolean;
152
+ /** 显示延迟(ms),默认 100;设为 0 关闭防闪 */
153
+ delay?: number;
154
+ /** 文字提示,与 indicator 一起展示在遮罩中央 */
155
+ tip?: React.ReactNode;
156
+ /** tip 与 indicator 的相对位置,默认 `bottom` */
157
+ tipAlign?: 'right' | 'bottom';
158
+ /** 自定义 indicator,默认 `<Spinner size={size} tone="primary" />` */
159
+ indicator?: React.ReactNode;
160
+ /** 默认 indicator 的尺寸(仅在未传 indicator 时生效),默认 `lg` */
161
+ size?: 'sm' | 'md' | 'lg';
162
+ /** 容器布局:`true` 为 inline-block,`false` 为 block 通栏,默认 `true` */
163
+ inline?: boolean;
164
+ /** 遮罩生效时是否对 children 做模糊处理,默认 `true`(对齐 cloud-design hybridcloud blur 视觉) */
165
+ blur?: boolean;
166
+ }
167
+
168
+ /**
169
+ * 包裹子内容的 loading 遮罩。`visible` 为 true 时叠加半透明遮罩 + 内容模糊 + 指示符;
170
+ * 内置 100ms 显示防闪与 `aria-busy` 同步。
171
+ */
172
+ function SpinnerOverlay({
173
+ visible = true,
174
+ delay = 100,
175
+ tip,
176
+ tipAlign = 'bottom',
177
+ indicator,
178
+ size = 'lg',
179
+ inline = true,
180
+ blur = true,
181
+ className,
182
+ children,
183
+ ...props
184
+ }: SpinnerOverlayProps) {
185
+ const shown = useDelayedVisible(visible, delay);
186
+
187
+ return (
188
+ <div
189
+ data-slot="spinner-overlay"
190
+ data-visible={shown || undefined}
191
+ data-tip-align={tipAlign}
192
+ data-inline={inline || undefined}
193
+ aria-busy={shown || undefined}
194
+ className={cn('relative', inline ? 'inline-block' : 'block', className)}
195
+ {...props}
196
+ >
197
+ <div
198
+ data-slot="spinner-overlay-content"
199
+ className={cn(
200
+ 'transition-[filter] duration-200',
201
+ shown && blur && 'blur-[2px]',
202
+ shown && 'pointer-events-none select-none',
203
+ )}
204
+ >
205
+ {children}
206
+ </div>
207
+ {shown ? (
208
+ <SpinnerOverlayMask tipAlign={tipAlign}>
209
+ {indicator ?? (
210
+ <Spinner size={OVERLAY_INDICATOR_SIZE[size]} tone="primary" />
211
+ )}
212
+ {tip != null && tip !== false ? <SpinnerTip>{tip}</SpinnerTip> : null}
213
+ </SpinnerOverlayMask>
214
+ ) : null}
215
+ </div>
216
+ );
217
+ }
218
+
219
+ /**
220
+ * SpinnerOverlay 的内部遮罩层,覆盖父容器并居中渲染 indicator + tip。
221
+ * 通常无需直接使用;如需完全自定义遮罩内容,可自行组合 Spinner + SpinnerTip。
222
+ */
223
+ function SpinnerOverlayMask({
224
+ tipAlign = 'bottom',
225
+ className,
226
+ children,
227
+ ...props
228
+ }: React.ComponentProps<'div'> & { tipAlign?: 'right' | 'bottom' }) {
229
+ return (
230
+ <div
231
+ data-slot="spinner-overlay-mask"
232
+ data-tip-align={tipAlign}
233
+ className={cn(
234
+ 'absolute inset-0 z-10 flex items-center justify-center bg-background/60 backdrop-blur-sm',
235
+ className,
236
+ )}
237
+ {...props}
238
+ >
239
+ <div
240
+ data-slot="spinner-overlay-indicator"
241
+ className={cn(
242
+ 'flex items-center justify-center',
243
+ tipAlign === 'right' ? 'flex-row gap-2' : 'flex-col gap-2',
244
+ )}
245
+ >
246
+ {children}
247
+ </div>
248
+ </div>
249
+ );
250
+ }
251
+
252
+ /* ────────────────────────────────────────────────────────────────────────── */
253
+ /* SpinnerFullscreen(全屏 + Portal + Esc 关闭) */
254
+ /* ────────────────────────────────────────────────────────────────────────── */
255
+
256
+ export interface SpinnerFullscreenProps {
257
+ /** loading 状态 */
258
+ visible?: boolean;
259
+ /** 显示延迟(ms),默认 100 */
260
+ delay?: number;
261
+ /** 文字提示 */
262
+ tip?: React.ReactNode;
263
+ /** tip 与 indicator 的相对位置,默认 `bottom` */
264
+ tipAlign?: 'right' | 'bottom';
265
+ /** 自定义 indicator,默认 `<Spinner size="lg" tone="primary" />` */
266
+ indicator?: React.ReactNode;
267
+ /** Portal 投放容器,默认 `document.body` */
268
+ container?: HTMLElement | null;
269
+ /** 用户按下 Esc 时回调,建议在此处把 `visible` 置 false */
270
+ onVisibleChange?: (visible: boolean) => void;
271
+ }
272
+
273
+ /**
274
+ * 全屏遮罩 loading。通过 Portal 投放到 `container`(默认 body),
275
+ * 监听 Esc 键并调用 `onVisibleChange(false)` 让上层关闭。
276
+ */
277
+ function SpinnerFullscreen({
278
+ visible = false,
279
+ delay = 100,
280
+ tip,
281
+ tipAlign = 'bottom',
282
+ indicator,
283
+ container,
284
+ onVisibleChange,
285
+ }: SpinnerFullscreenProps) {
286
+ const shown = useDelayedVisible(visible, delay);
287
+
288
+ React.useEffect(() => {
289
+ if (!shown) return;
290
+ const handler = (e: KeyboardEvent) => {
291
+ if (e.key === 'Escape') {
292
+ onVisibleChange?.(false);
293
+ }
294
+ };
295
+ document.addEventListener('keydown', handler);
296
+ return () => document.removeEventListener('keydown', handler);
297
+ }, [shown, onVisibleChange]);
298
+
299
+ if (!shown) return null;
300
+ if (typeof document === 'undefined') return null;
301
+
302
+ const target = container ?? document.body;
303
+
304
+ return createPortal(
305
+ <div
306
+ data-slot="spinner-fullscreen"
307
+ data-tip-align={tipAlign}
308
+ role="alertdialog"
309
+ aria-modal="true"
310
+ aria-busy="true"
311
+ className="fixed inset-0 z-50 flex items-center justify-center bg-background/60 backdrop-blur-sm"
312
+ >
313
+ <div
314
+ data-slot="spinner-fullscreen-indicator"
315
+ className={cn(
316
+ 'flex items-center justify-center',
317
+ tipAlign === 'right' ? 'flex-row gap-2' : 'flex-col gap-2',
318
+ )}
319
+ >
320
+ {indicator ?? <Spinner size="lg" tone="primary" />}
321
+ {tip != null && tip !== false ? <SpinnerTip>{tip}</SpinnerTip> : null}
322
+ </div>
323
+ </div>,
324
+ target,
325
+ );
326
+ }
327
+
328
+ export {
329
+ Spinner,
330
+ SpinnerTip,
331
+ SpinnerOverlay,
332
+ SpinnerOverlayMask,
333
+ SpinnerFullscreen,
334
+ spinnerVariants,
335
+ };
@@ -0,0 +1,172 @@
1
+ # Spinner
2
+
3
+ > 本文件由 `pnpm gen:meta` 自动生成,**请勿手动编辑**。
4
+
5
+ ## 描述
6
+
7
+ 加载指示器 Spinner
8
+ shadcn v4 composable 套件:原子 Spinner + SpinnerTip 文案 + SpinnerOverlay 包裹遮罩 + SpinnerFullscreen 全屏遮罩。
9
+ 对齐 cloud-design Loading 的能力(visible / tip / tipAlign / indicator / inline / 100ms 防闪 / fullScreen / Esc 关闭)。
10
+
11
+ ## 使用场景
12
+
13
+ - 按钮 / Trigger / 单元格内的行内 loading 反馈
14
+ - 局部内容区在异步加载时的遮罩态(包裹模式 + 100ms 防闪)
15
+ - 关键操作(提交、保存)时的全屏阻断态(带 Esc 关闭)
16
+ - 组合结构:SpinnerOverlay > children + SpinnerOverlayMask > Spinner + SpinnerTip
17
+
18
+ ## Props
19
+
20
+ | 名称 | 类型 | 默认值 | 必填 | 说明 |
21
+ | --- | --- | --- | --- | --- |
22
+ | `size` | `"xs" \| "sm" \| "md" \| "lg"` | – | – | – |
23
+ | `tone` | `"default" \| "primary" \| "inverse" \| "muted"` | `"default"` | – | – |
24
+ | `label` | `string` | – | – | sr-only 读屏文本,默认 `加载中`;如父级已有可见 tip 可置空 |
25
+ | `visible` | `boolean` | – | – | loading 状态,默认 true。从 false→true 切换会延迟 `delay` 毫秒后显示,避免短任务闪烁 |
26
+ | `delay` | `number` | – | – | 显示延迟(ms),默认 100;设为 0 关闭防闪 |
27
+ | `tip` | `React.ReactNode` | – | – | 文字提示,与 indicator 一起展示在遮罩中央 |
28
+ | `tipAlign` | `'right' \| 'bottom'` | – | – | tip 与 indicator 的相对位置,默认 `bottom` |
29
+ | `indicator` | `React.ReactNode` | – | – | 自定义 indicator,默认 `<Spinner size={size} tone="primary" />` |
30
+ | `size` | `'sm' \| 'md' \| 'lg'` | – | – | 默认 indicator 的尺寸(仅在未传 indicator 时生效),默认 `lg` |
31
+ | `inline` | `boolean` | – | – | 容器布局:`true` 为 inline-block,`false` 为 block 通栏,默认 `true` |
32
+ | `blur` | `boolean` | – | – | 遮罩生效时是否对 children 做模糊处理,默认 `true`(对齐 cloud-design hybridcloud blur 视觉) |
33
+ | `visible` | `boolean` | – | – | loading 状态 |
34
+ | `delay` | `number` | – | – | 显示延迟(ms),默认 100 |
35
+ | `tip` | `React.ReactNode` | – | – | 文字提示 |
36
+ | `tipAlign` | `'right' \| 'bottom'` | – | – | tip 与 indicator 的相对位置,默认 `bottom` |
37
+ | `indicator` | `React.ReactNode` | – | – | 自定义 indicator,默认 `<Spinner size="lg" tone="primary" />` |
38
+ | `container` | `HTMLElement \| null` | – | – | Portal 投放容器,默认 `document.body` |
39
+ | `onVisibleChange` | `(visible: boolean) => void` | – | – | 用户按下 Esc 时回调,建议在此处把 `visible` 置 false |
40
+
41
+ ## 示例
42
+
43
+ ### Sizes
44
+
45
+ 四档显式尺寸:xs(12) / sm(14) / md(16) / lg(20)。
46
+
47
+ ```tsx
48
+ <div className="flex items-center gap-4">
49
+ <Spinner size="xs" />
50
+ <Spinner size="sm" />
51
+ <Spinner size="md" />
52
+ <Spinner size="lg" />
53
+ </div>
54
+ ```
55
+
56
+ ### Tones
57
+
58
+ 四档语义色调:default(继承) / primary / inverse(深色背景) / muted。
59
+
60
+ ```tsx
61
+ <div className="flex items-center gap-4">
62
+ <Spinner size="md" tone="default" />
63
+ <Spinner size="md" tone="primary" />
64
+ <span className="inline-flex items-center justify-center rounded bg-primary p-2">
65
+ <Spinner size="md" tone="inverse" />
66
+ </span>
67
+ <Spinner size="md" tone="muted" />
68
+ </div>
69
+ ```
70
+
71
+ ### WithTip
72
+
73
+ 原子 Spinner 搭配 SpinnerTip 行内展示文字提示。
74
+
75
+ ```tsx
76
+ <div className="flex items-center gap-2">
77
+ <Spinner size="md" tone="primary" />
78
+ <SpinnerTip>加载中...</SpinnerTip>
79
+ </div>
80
+ ```
81
+
82
+ ### OverlayBasic
83
+
84
+ 包裹模式基础用法:遮罩 + 居中 Spinner + tip。
85
+
86
+ ```tsx
87
+ <SpinnerOverlay tip="加载中...">
88
+ <div className="h-20 w-48 rounded border border-border p-4 text-xs">
89
+ 包裹内容区
90
+ </div>
91
+ </SpinnerOverlay>
92
+ ```
93
+
94
+ ### OverlaySizes
95
+
96
+ 包裹模式三档 indicator 尺寸。
97
+
98
+ ```tsx
99
+ <div className="flex gap-6">
100
+ <SpinnerOverlay size="sm" tip="sm">
101
+ <div className="h-20 w-32 rounded border border-border p-4 text-xs">
102
+
103
+ </div>
104
+ </SpinnerOverlay>
105
+ <SpinnerOverlay size="md" tip="md">
106
+ <div className="h-20 w-32 rounded border border-border p-4 text-xs">
107
+
108
+ </div>
109
+ </SpinnerOverlay>
110
+ <SpinnerOverlay size="lg" tip="lg">
111
+ <div className="h-20 w-32 rounded border border-border p-4 text-xs">
112
+
113
+ </div>
114
+ </SpinnerOverlay>
115
+ </div>
116
+ ```
117
+
118
+ ### OverlayTipAlign
119
+
120
+ tip 位置:right(行内) 与 bottom(堆叠)。
121
+
122
+ ```tsx
123
+ <div className="flex gap-6">
124
+ <SpinnerOverlay tip="bottom(默认)" tipAlign="bottom">
125
+ <div className="h-24 w-40 rounded border border-border p-4 text-xs">
126
+ tipAlign=bottom
127
+ </div>
128
+ </SpinnerOverlay>
129
+ <SpinnerOverlay tip="right" tipAlign="right">
130
+ <div className="h-24 w-40 rounded border border-border p-4 text-xs">
131
+ tipAlign=right
132
+ </div>
133
+ </SpinnerOverlay>
134
+ </div>
135
+ ```
136
+
137
+ ### OverlayCustomIndicator
138
+
139
+ 自定义 indicator 替换默认 Spinner。
140
+
141
+ ```tsx
142
+ <SpinnerOverlay indicator={<span>⏳</span>} tip="自定义动画">
143
+ <div className="h-20 w-48 rounded border border-border p-4 text-xs">
144
+ 内容
145
+ </div>
146
+ </SpinnerOverlay>
147
+ ```
148
+
149
+ ### InlineVsBlock
150
+
151
+ inline(默认)与 block 通栏模式对比。
152
+
153
+ ```tsx
154
+ <div className="flex flex-col gap-4">
155
+ <div>
156
+ <span className="mr-2 text-muted-foreground">inline:</span>
157
+ <SpinnerOverlay inline tip="inline">
158
+ <span className="rounded border border-border px-4 py-2 text-xs">
159
+ 行内内容
160
+ </span>
161
+ </SpinnerOverlay>
162
+ </div>
163
+ <div>
164
+ <span className="mb-1 block text-muted-foreground">block:</span>
165
+ <SpinnerOverlay inline={false} tip="block">
166
+ <div className="rounded border border-border px-4 py-2 text-xs">
167
+ 通栏内容
168
+ </div>
169
+ </SpinnerOverlay>
170
+ </div>
171
+ </div>
172
+ ```
@@ -0,0 +1,197 @@
1
+ import type { Meta, StoryObj } from '@storybook/react';
2
+ import * as React from 'react';
3
+ import {
4
+ Spinner,
5
+ SpinnerTip,
6
+ SpinnerOverlay,
7
+ SpinnerFullscreen,
8
+ } from './index';
9
+ import { Button } from '@/components/button';
10
+
11
+ const meta: Meta<typeof Spinner> = {
12
+ title: '反馈 · Feedback/Spinner 加载指示器',
13
+ component: Spinner,
14
+ tags: ['autodocs'],
15
+ };
16
+ export default meta;
17
+
18
+ type Story = StoryObj<typeof meta>;
19
+
20
+ /** 默认旋转加载指示器,无显式 size 时由父级决定。 */
21
+ export const Default: Story = {
22
+ render: () => <Spinner />,
23
+ };
24
+
25
+ /** 四档显式尺寸:xs(12) / sm(14) / md(16) / lg(20)。 */
26
+ export const Sizes: Story = {
27
+ render: () => (
28
+ <div className="flex items-center gap-4">
29
+ <Spinner size="xs" />
30
+ <Spinner size="sm" />
31
+ <Spinner size="md" />
32
+ <Spinner size="lg" />
33
+ </div>
34
+ ),
35
+ };
36
+
37
+ /** 四档语义色调:default(继承) / primary / inverse(深色背景) / muted。 */
38
+ export const Tones: Story = {
39
+ render: () => (
40
+ <div className="flex items-center gap-4">
41
+ <Spinner size="md" tone="default" />
42
+ <Spinner size="md" tone="primary" />
43
+ <span className="inline-flex items-center justify-center rounded bg-primary p-2">
44
+ <Spinner size="md" tone="inverse" />
45
+ </span>
46
+ <Spinner size="md" tone="muted" />
47
+ </div>
48
+ ),
49
+ };
50
+
51
+ /** 原子 Spinner 搭配 SpinnerTip 行内展示文字提示。 */
52
+ export const WithTip: Story = {
53
+ render: () => (
54
+ <div className="flex items-center gap-2">
55
+ <Spinner size="md" tone="primary" />
56
+ <SpinnerTip>加载中...</SpinnerTip>
57
+ </div>
58
+ ),
59
+ };
60
+
61
+ /** 包裹模式基础用法:遮罩 + 居中 Spinner + tip。 */
62
+ export const OverlayBasic: Story = {
63
+ render: () => (
64
+ <SpinnerOverlay tip="加载中...">
65
+ <div className="h-20 w-48 rounded border border-border p-4 text-xs">
66
+ 包裹内容区
67
+ </div>
68
+ </SpinnerOverlay>
69
+ ),
70
+ };
71
+
72
+ /** 包裹模式三档 indicator 尺寸。 */
73
+ export const OverlaySizes: Story = {
74
+ render: () => (
75
+ <div className="flex gap-6">
76
+ <SpinnerOverlay size="sm" tip="sm">
77
+ <div className="h-20 w-32 rounded border border-border p-4 text-xs">
78
+
79
+ </div>
80
+ </SpinnerOverlay>
81
+ <SpinnerOverlay size="md" tip="md">
82
+ <div className="h-20 w-32 rounded border border-border p-4 text-xs">
83
+
84
+ </div>
85
+ </SpinnerOverlay>
86
+ <SpinnerOverlay size="lg" tip="lg">
87
+ <div className="h-20 w-32 rounded border border-border p-4 text-xs">
88
+
89
+ </div>
90
+ </SpinnerOverlay>
91
+ </div>
92
+ ),
93
+ };
94
+
95
+ /** tip 位置:right(行内) 与 bottom(堆叠)。 */
96
+ export const OverlayTipAlign: Story = {
97
+ render: () => (
98
+ <div className="flex gap-6">
99
+ <SpinnerOverlay tip="bottom(默认)" tipAlign="bottom">
100
+ <div className="h-24 w-40 rounded border border-border p-4 text-xs">
101
+ tipAlign=bottom
102
+ </div>
103
+ </SpinnerOverlay>
104
+ <SpinnerOverlay tip="right" tipAlign="right">
105
+ <div className="h-24 w-40 rounded border border-border p-4 text-xs">
106
+ tipAlign=right
107
+ </div>
108
+ </SpinnerOverlay>
109
+ </div>
110
+ ),
111
+ };
112
+
113
+ /** 受控 visible + 100ms 防闪:短任务 (800ms) 不闪烁,长任务 (2000ms) 正常展示。 */
114
+ export const OverlayControlled: Story = {
115
+ render: function OverlayControlledRender() {
116
+ const [visible1, setVisible1] = React.useState(false);
117
+ const [visible2, setVisible2] = React.useState(false);
118
+ return (
119
+ <div className="flex flex-col gap-4">
120
+ <Button
121
+ onClick={() => {
122
+ setVisible1(true);
123
+ setVisible2(true);
124
+ setTimeout(() => setVisible1(false), 800);
125
+ setTimeout(() => setVisible2(false), 2000);
126
+ }}
127
+ >
128
+ 开始加载
129
+ </Button>
130
+ <div className="flex gap-6">
131
+ <SpinnerOverlay visible={visible1} tip="800ms 快任务">
132
+ <div className="h-20 w-40 rounded border border-border p-4 text-xs">
133
+ 面板 1
134
+ </div>
135
+ </SpinnerOverlay>
136
+ <SpinnerOverlay visible={visible2} tip="2000ms 慢任务">
137
+ <div className="h-20 w-40 rounded border border-border p-4 text-xs">
138
+ 面板 2
139
+ </div>
140
+ </SpinnerOverlay>
141
+ </div>
142
+ </div>
143
+ );
144
+ },
145
+ };
146
+
147
+ /** 自定义 indicator 替换默认 Spinner。 */
148
+ export const OverlayCustomIndicator: Story = {
149
+ render: () => (
150
+ <SpinnerOverlay indicator={<span>⏳</span>} tip="自定义动画">
151
+ <div className="h-20 w-48 rounded border border-border p-4 text-xs">
152
+ 内容
153
+ </div>
154
+ </SpinnerOverlay>
155
+ ),
156
+ };
157
+
158
+ /** 全屏遮罩 + Portal 投放 + Esc 关闭。 */
159
+ export const Fullscreen: Story = {
160
+ render: function FullscreenRender() {
161
+ const [visible, setVisible] = React.useState(false);
162
+ return (
163
+ <div>
164
+ <Button onClick={() => setVisible(true)}>打开全屏 Loading</Button>
165
+ <SpinnerFullscreen
166
+ visible={visible}
167
+ tip="加载中,按 Esc 关闭"
168
+ onVisibleChange={setVisible}
169
+ />
170
+ </div>
171
+ );
172
+ },
173
+ };
174
+
175
+ /** inline(默认)与 block 通栏模式对比。 */
176
+ export const InlineVsBlock: Story = {
177
+ render: () => (
178
+ <div className="flex flex-col gap-4">
179
+ <div>
180
+ <span className="mr-2 text-muted-foreground">inline:</span>
181
+ <SpinnerOverlay inline tip="inline">
182
+ <span className="rounded border border-border px-4 py-2 text-xs">
183
+ 行内内容
184
+ </span>
185
+ </SpinnerOverlay>
186
+ </div>
187
+ <div>
188
+ <span className="mb-1 block text-muted-foreground">block:</span>
189
+ <SpinnerOverlay inline={false} tip="block">
190
+ <div className="rounded border border-border px-4 py-2 text-xs">
191
+ 通栏内容
192
+ </div>
193
+ </SpinnerOverlay>
194
+ </div>
195
+ </div>
196
+ ),
197
+ };