@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,764 @@
1
+ /**
2
+ * 树 Tree
3
+ *
4
+ * 多层级结构数据展示,支持展开收起、选中、勾选(父子联动 / 独立)、回填策略、
5
+ * 节点占满整行、自定义图标、异步加载、过滤高亮、虚拟滚动等业界主流能力。
6
+ *
7
+ * @when
8
+ * - 文件目录 / 组织架构 / 分类层级浏览
9
+ * - 需要勾选 / 单选 / 多选层级数据
10
+ * - 大数据量树(开启 `virtual`)
11
+ * - 异步分级加载(`loadData`)
12
+ */
13
+ 'use client';
14
+
15
+ import * as React from 'react';
16
+ import { useVirtualizer } from '@tanstack/react-virtual';
17
+ import { cva, type VariantProps } from 'class-variance-authority';
18
+ import {
19
+ ChevronRightIcon,
20
+ FileIcon,
21
+ FolderIcon,
22
+ Loader2Icon,
23
+ } from 'lucide-react';
24
+
25
+ import { cn } from '@/lib/utils';
26
+ import { Checkbox } from '@/components/checkbox';
27
+
28
+ import {
29
+ applyCheckedStrategy,
30
+ collectIndeterminateKeys,
31
+ expandWithParents,
32
+ findNode,
33
+ flattenVisible,
34
+ getAllKeys,
35
+ isFullyChecked,
36
+ isIndeterminate,
37
+ toggleWithCascade,
38
+ type FlatTreeNode,
39
+ type TreeNodeBase,
40
+ } from './utils';
41
+
42
+ // ─── Variants ────────────────────────────────────────────────────────────────
43
+
44
+ const treeNodeVariants = cva(
45
+ 'group/tree-node relative flex items-center gap-1 rounded-sm text-xs select-none transition-colors data-[disabled=true]:pointer-events-none data-[disabled=true]:opacity-50 data-[selected=true]:bg-accent data-[selected=true]:text-accent-foreground',
46
+ {
47
+ variants: {
48
+ size: {
49
+ sm: 'h-6 px-1',
50
+ default: 'h-7 px-1',
51
+ },
52
+ block: {
53
+ true: 'w-full',
54
+ false: 'w-fit',
55
+ },
56
+ selectable: {
57
+ true: 'cursor-pointer hover:data-[selected=false]:bg-accent/50',
58
+ false: 'cursor-default',
59
+ },
60
+ },
61
+ defaultVariants: { size: 'default', block: false, selectable: true },
62
+ },
63
+ );
64
+
65
+ const INDENT_PER_LEVEL = 16;
66
+ const NODE_BASE_PADDING_LEFT = 4;
67
+
68
+ // ─── Types ───────────────────────────────────────────────────────────────────
69
+
70
+ /** 树节点。 */
71
+ export interface TreeNode extends TreeNodeBase {
72
+ /** 唯一标识。 */
73
+ key: string;
74
+ /** 显示文本。 */
75
+ label: React.ReactNode;
76
+ /** 子节点。 */
77
+ children?: TreeNode[];
78
+ /** 节点图标,覆盖默认 Folder / File。 */
79
+ icon?: React.ReactNode;
80
+ /** 节点级覆盖 `Tree.selectable`。 */
81
+ selectable?: boolean;
82
+ /** 节点级覆盖 `Tree.checkable`。 */
83
+ checkable?: boolean;
84
+ }
85
+
86
+ /** Tree 组件 Props。 */
87
+ export interface TreeProps
88
+ extends Omit<React.ComponentProps<'div'>, 'onSelect'>,
89
+ VariantProps<typeof treeNodeVariants> {
90
+ /** 树形数据源。 */
91
+ treeData: TreeNode[];
92
+
93
+ // ── 选中态(节点点击高亮)──────────────────────────────────────────────
94
+ /** 是否支持节点选中。@default true */
95
+ selectable?: boolean;
96
+ /** 是否支持多选选中。@default false */
97
+ multiple?: boolean;
98
+ /** 受控选中节点 key 列表。 */
99
+ selectedKeys?: string[];
100
+ /** 默认选中节点 key 列表。 */
101
+ defaultSelectedKeys?: string[];
102
+ /** 选中变化回调。 */
103
+ onSelect?: (
104
+ selectedKeys: string[],
105
+ info: { node: TreeNode; selected: boolean; selectedNodes: TreeNode[] },
106
+ ) => void;
107
+
108
+ // ── 勾选态(checkbox)─────────────────────────────────────────────────
109
+ /** 是否显示复选框。@default false */
110
+ checkable?: boolean;
111
+ /** 受控勾选 key 列表。 */
112
+ checkedKeys?: string[];
113
+ /** 默认勾选 key 列表。 */
114
+ defaultCheckedKeys?: string[];
115
+ /** 父子勾选独立(不联动)。@default false */
116
+ checkStrictly?: boolean;
117
+ /**
118
+ * 勾选回填策略:
119
+ * - 'all' 全量返回(默认,与 cloud-design 一致)
120
+ * - 'parent' 父级 fully checked 时仅返回父级
121
+ * - 'child' 仅返回叶子节点
122
+ * 仅在 `checkStrictly=false` 时生效。
123
+ * @default 'all'
124
+ */
125
+ checkedStrategy?: 'all' | 'parent' | 'child';
126
+ /** 勾选变化回调。 */
127
+ onCheck?: (
128
+ checkedKeys: string[],
129
+ info: {
130
+ node: TreeNode;
131
+ checked: boolean;
132
+ checkedNodes: TreeNode[];
133
+ indeterminateKeys: string[];
134
+ },
135
+ ) => void;
136
+
137
+ // ── 展开态 ───────────────────────────────────────────────────────────
138
+ /** 受控展开 key 列表。 */
139
+ expandedKeys?: string[];
140
+ /** 默认展开 key 列表。 */
141
+ defaultExpandedKeys?: string[];
142
+ /** 默认展开全部节点。@default false */
143
+ defaultExpandAll?: boolean;
144
+ /**
145
+ * 自动展开父节点;搜索高亮场景下建议设为 false 由外部控制。
146
+ * @default true
147
+ */
148
+ autoExpandParent?: boolean;
149
+ /** 展开/收起回调。 */
150
+ onExpand?: (
151
+ expandedKeys: string[],
152
+ info: { node: TreeNode; expanded: boolean },
153
+ ) => void;
154
+
155
+ // ── 视觉 ─────────────────────────────────────────────────────────────
156
+ /** 是否显示连接线。@default false */
157
+ showLine?: boolean;
158
+ /**
159
+ * 是否显示节点图标(默认 File / Folder,可由 node.icon 覆盖)。
160
+ * @default false(与 antd v5 一致)
161
+ */
162
+ showIcon?: boolean;
163
+ /** 节点占满整行(替代 cloud-design 的 isLabelBlock / isNodeBlock)。@default false */
164
+ blockNode?: boolean;
165
+ /** 节点行高档位。@default 'default' */
166
+ size?: 'sm' | 'default';
167
+
168
+ // ── 数据 / 渲染 ──────────────────────────────────────────────────────
169
+ /**
170
+ * 异步加载子节点:点击展开非 isLeaf 且 children 未提供的节点时调用。
171
+ * 业务侧应在 resolve 前更新 treeData 引用,组件不直接持有 children 状态。
172
+ */
173
+ loadData?: (node: TreeNode) => Promise<void> | void;
174
+ /**
175
+ * 节点过滤回调;返回 true 的节点 label 会被高亮(不影响节点显隐,
176
+ * 业务侧可配合 expandedKeys 做搜索体验)。
177
+ */
178
+ filterTreeNode?: (node: TreeNode) => boolean;
179
+ /** 自定义节点 label 渲染(替代 cloud-design 的 renderChildNodes)。 */
180
+ titleRender?: (node: TreeNode) => React.ReactNode;
181
+
182
+ // ── 虚拟滚动 ─────────────────────────────────────────────────────────
183
+ /**
184
+ * 虚拟滚动;启用且展平后可见节点 ≥ threshold 时启用 react-virtual。
185
+ * - `true` 等价 `{ threshold: 200 }`
186
+ * - 启用时容器需固定高度,默认 `max-h-96 overflow-auto`,可通过 className 覆盖。
187
+ */
188
+ virtual?: boolean | { threshold?: number; itemHeight?: number };
189
+ }
190
+
191
+ // ─── 内部上下文(避免跨层级 prop drilling)──────────────────────────────────
192
+
193
+ interface TreeRuntimeContextValue {
194
+ size: 'sm' | 'default';
195
+ blockNode: boolean;
196
+ showLine: boolean;
197
+ showIcon: boolean;
198
+ selectable: boolean;
199
+ multiple: boolean;
200
+ checkable: boolean;
201
+ checkStrictly: boolean;
202
+ selectedSet: Set<string>;
203
+ checkedSet: Set<string>;
204
+ expandedSet: Set<string>;
205
+ loadingSet: Set<string>;
206
+ filterTreeNode?: (node: TreeNode) => boolean;
207
+ titleRender?: (node: TreeNode) => React.ReactNode;
208
+ onToggleExpand: (node: TreeNode) => void;
209
+ onSelect: (node: TreeNode) => void;
210
+ onCheck: (node: TreeNode, nextChecked: boolean) => void;
211
+ }
212
+
213
+ const TreeRuntimeContext = React.createContext<TreeRuntimeContextValue | null>(
214
+ null,
215
+ );
216
+
217
+ function useTreeRuntime() {
218
+ const ctx = React.useContext(TreeRuntimeContext);
219
+ if (!ctx) throw new Error('TreeNodeRow must be used within Tree');
220
+ return ctx;
221
+ }
222
+
223
+ const getKey = (n: TreeNode) => n.key;
224
+
225
+ // ─── Tree ────────────────────────────────────────────────────────────────────
226
+
227
+ function Tree({
228
+ treeData,
229
+ // 选中
230
+ selectable = true,
231
+ multiple = false,
232
+ selectedKeys: controlledSelected,
233
+ defaultSelectedKeys,
234
+ onSelect,
235
+ // 勾选
236
+ checkable = false,
237
+ checkedKeys: controlledChecked,
238
+ defaultCheckedKeys,
239
+ checkStrictly = false,
240
+ checkedStrategy = 'all',
241
+ onCheck,
242
+ // 展开
243
+ expandedKeys: controlledExpanded,
244
+ defaultExpandedKeys,
245
+ defaultExpandAll = false,
246
+ autoExpandParent = true,
247
+ onExpand,
248
+ // 视觉
249
+ showLine = false,
250
+ showIcon = false,
251
+ blockNode = false,
252
+ size = 'default',
253
+ // 数据
254
+ loadData,
255
+ filterTreeNode,
256
+ titleRender,
257
+ // 虚拟化
258
+ virtual = false,
259
+ className,
260
+ ...divProps
261
+ }: TreeProps) {
262
+ // ── 状态 ──────────────────────────────────────────────────────────────
263
+ const [internalSelected, setInternalSelected] = React.useState<string[]>(
264
+ defaultSelectedKeys ?? [],
265
+ );
266
+ const [internalChecked, setInternalChecked] = React.useState<string[]>(
267
+ defaultCheckedKeys ?? [],
268
+ );
269
+ const [internalExpanded, setInternalExpanded] = React.useState<string[]>(
270
+ () => {
271
+ if (defaultExpandAll) return getAllKeys(treeData, getKey);
272
+ return defaultExpandedKeys ?? [];
273
+ },
274
+ );
275
+ const [loadingKeys, setLoadingKeys] = React.useState<Set<string>>(
276
+ () => new Set(),
277
+ );
278
+
279
+ const selectedFromProp = controlledSelected ?? internalSelected;
280
+ const checkedFromProp = controlledChecked ?? internalChecked;
281
+ const expandedFromProp = controlledExpanded ?? internalExpanded;
282
+
283
+ // 多选 + 父子联动场景:外部传入的 checkedKeys 可能是策略压缩后的,
284
+ // 这里展开为完整勾选集,保证 isFullyChecked / cascade 正确。
285
+ const checkedSet = React.useMemo(() => {
286
+ if (!checkable || checkStrictly) return new Set(checkedFromProp);
287
+ const expanded = new Set<string>(checkedFromProp);
288
+ for (const k of checkedFromProp) {
289
+ const node = findNode(treeData, k, getKey);
290
+ if (node) {
291
+ const walk = (n: TreeNode) => {
292
+ if (n.disabled || n.disableCheckbox) return;
293
+ expanded.add(n.key);
294
+ n.children?.forEach(walk);
295
+ };
296
+ walk(node);
297
+ }
298
+ }
299
+ return expanded;
300
+ }, [checkable, checkStrictly, checkedFromProp, treeData]);
301
+
302
+ const selectedSet = React.useMemo(
303
+ () => new Set(selectedFromProp),
304
+ [selectedFromProp],
305
+ );
306
+
307
+ const expandedSet = React.useMemo(() => {
308
+ if (autoExpandParent) {
309
+ return new Set(expandWithParents(treeData, expandedFromProp, getKey));
310
+ }
311
+ return new Set(expandedFromProp);
312
+ }, [expandedFromProp, autoExpandParent, treeData]);
313
+
314
+ // ── 处理函数 ──────────────────────────────────────────────────────────
315
+ const handleToggleExpand = React.useCallback(
316
+ (node: TreeNode) => {
317
+ const nextExpanded = !expandedSet.has(node.key);
318
+ const next = new Set(expandedSet);
319
+ if (nextExpanded) next.add(node.key);
320
+ else next.delete(node.key);
321
+ const nextKeys = Array.from(next);
322
+
323
+ if (controlledExpanded === undefined) setInternalExpanded(nextKeys);
324
+ onExpand?.(nextKeys, { node, expanded: nextExpanded });
325
+
326
+ // 异步加载:展开 + 非叶子 + 无 children + loadData 提供
327
+ const hasChildren = !!(node.children && node.children.length > 0);
328
+ const isLeafFlag = node.isLeaf ?? !hasChildren;
329
+ if (
330
+ nextExpanded &&
331
+ loadData &&
332
+ !isLeafFlag &&
333
+ !hasChildren &&
334
+ !loadingKeys.has(node.key)
335
+ ) {
336
+ setLoadingKeys((prev) => {
337
+ const s = new Set(prev);
338
+ s.add(node.key);
339
+ return s;
340
+ });
341
+ Promise.resolve(loadData(node)).finally(() => {
342
+ setLoadingKeys((prev) => {
343
+ const s = new Set(prev);
344
+ s.delete(node.key);
345
+ return s;
346
+ });
347
+ });
348
+ }
349
+ },
350
+ [expandedSet, controlledExpanded, onExpand, loadData, loadingKeys],
351
+ );
352
+
353
+ const handleSelect = React.useCallback(
354
+ (node: TreeNode) => {
355
+ if (node.disabled) return;
356
+ const nodeSelectable = node.selectable ?? selectable;
357
+ if (!nodeSelectable) return;
358
+
359
+ const isCurrentlySelected = selectedSet.has(node.key);
360
+ let nextKeys: string[];
361
+ let nextSelected: boolean;
362
+
363
+ if (multiple) {
364
+ if (isCurrentlySelected) {
365
+ nextKeys = selectedFromProp.filter((k) => k !== node.key);
366
+ nextSelected = false;
367
+ } else {
368
+ nextKeys = [...selectedFromProp, node.key];
369
+ nextSelected = true;
370
+ }
371
+ } else {
372
+ if (isCurrentlySelected) {
373
+ nextKeys = [];
374
+ nextSelected = false;
375
+ } else {
376
+ nextKeys = [node.key];
377
+ nextSelected = true;
378
+ }
379
+ }
380
+
381
+ if (controlledSelected === undefined) setInternalSelected(nextKeys);
382
+ const selectedNodes = nextKeys
383
+ .map((k) => findNode(treeData, k, getKey))
384
+ .filter(Boolean) as TreeNode[];
385
+ onSelect?.(nextKeys, { node, selected: nextSelected, selectedNodes });
386
+ },
387
+ [
388
+ selectable,
389
+ multiple,
390
+ selectedSet,
391
+ selectedFromProp,
392
+ controlledSelected,
393
+ treeData,
394
+ onSelect,
395
+ ],
396
+ );
397
+
398
+ const handleCheck = React.useCallback(
399
+ (node: TreeNode, nextChecked: boolean) => {
400
+ if (node.disabled || node.disableCheckbox) return;
401
+
402
+ let nextSet: Set<string>;
403
+ if (checkStrictly) {
404
+ nextSet = new Set(checkedSet);
405
+ if (nextChecked) nextSet.add(node.key);
406
+ else nextSet.delete(node.key);
407
+ } else {
408
+ nextSet = toggleWithCascade(
409
+ treeData,
410
+ checkedSet,
411
+ node,
412
+ nextChecked,
413
+ getKey,
414
+ );
415
+ }
416
+
417
+ const outputKeys = checkStrictly
418
+ ? Array.from(nextSet)
419
+ : applyCheckedStrategy(treeData, nextSet, checkedStrategy, getKey);
420
+
421
+ if (controlledChecked === undefined) setInternalChecked(outputKeys);
422
+
423
+ const checkedNodes = Array.from(nextSet)
424
+ .map((k) => findNode(treeData, k, getKey))
425
+ .filter(Boolean) as TreeNode[];
426
+ const indeterminateKeys = checkStrictly
427
+ ? []
428
+ : collectIndeterminateKeys(treeData, nextSet, getKey);
429
+
430
+ onCheck?.(outputKeys, {
431
+ node,
432
+ checked: nextChecked,
433
+ checkedNodes,
434
+ indeterminateKeys,
435
+ });
436
+ },
437
+ [
438
+ checkStrictly,
439
+ checkedSet,
440
+ treeData,
441
+ checkedStrategy,
442
+ controlledChecked,
443
+ onCheck,
444
+ ],
445
+ );
446
+
447
+ // ── 上下文 ────────────────────────────────────────────────────────────
448
+ const runtime = React.useMemo<TreeRuntimeContextValue>(
449
+ () => ({
450
+ size: size ?? 'default',
451
+ blockNode,
452
+ showLine,
453
+ showIcon,
454
+ selectable,
455
+ multiple,
456
+ checkable,
457
+ checkStrictly,
458
+ selectedSet,
459
+ checkedSet,
460
+ expandedSet,
461
+ loadingSet: loadingKeys,
462
+ filterTreeNode,
463
+ titleRender,
464
+ onToggleExpand: handleToggleExpand,
465
+ onSelect: handleSelect,
466
+ onCheck: handleCheck,
467
+ }),
468
+ [
469
+ size,
470
+ blockNode,
471
+ showLine,
472
+ showIcon,
473
+ selectable,
474
+ multiple,
475
+ checkable,
476
+ checkStrictly,
477
+ selectedSet,
478
+ checkedSet,
479
+ expandedSet,
480
+ loadingKeys,
481
+ filterTreeNode,
482
+ titleRender,
483
+ handleToggleExpand,
484
+ handleSelect,
485
+ handleCheck,
486
+ ],
487
+ );
488
+
489
+ // ── 虚拟化判定 ────────────────────────────────────────────────────────
490
+ const virtualConfig = React.useMemo(() => {
491
+ if (!virtual) return null;
492
+ const opts = virtual === true ? {} : virtual;
493
+ const itemHeight = opts.itemHeight ?? (size === 'sm' ? 24 : 28);
494
+ const threshold = opts.threshold ?? 200;
495
+ return { itemHeight, threshold };
496
+ }, [virtual, size]);
497
+
498
+ const flat = React.useMemo<FlatTreeNode<TreeNode>[]>(() => {
499
+ if (!virtualConfig) return [];
500
+ return flattenVisible(treeData, expandedSet, getKey);
501
+ }, [virtualConfig, treeData, expandedSet]);
502
+
503
+ const useVirtualPath = !!(
504
+ virtualConfig && flat.length >= virtualConfig.threshold
505
+ );
506
+
507
+ return (
508
+ <TreeRuntimeContext.Provider value={runtime}>
509
+ <div
510
+ data-slot="tree"
511
+ data-size={size}
512
+ role="tree"
513
+ className={cn(
514
+ 'text-xs text-foreground',
515
+ useVirtualPath && 'max-h-96 overflow-auto',
516
+ className,
517
+ )}
518
+ {...divProps}
519
+ >
520
+ {useVirtualPath ? (
521
+ <TreeVirtualBody flat={flat} itemHeight={virtualConfig!.itemHeight} />
522
+ ) : (
523
+ treeData.map((node) => (
524
+ <TreeNodeRow key={node.key} node={node} level={0} />
525
+ ))
526
+ )}
527
+ </div>
528
+ </TreeRuntimeContext.Provider>
529
+ );
530
+ }
531
+
532
+ // ─── TreeNodeRow(递归渲染路径)─────────────────────────────────────────────
533
+
534
+ function TreeNodeRow({ node, level }: { node: TreeNode; level: number }) {
535
+ const ctx = useTreeRuntime();
536
+ const hasChildren = !!(node.children && node.children.length > 0);
537
+ const isLeaf = node.isLeaf ?? !hasChildren;
538
+ const isExpanded = ctx.expandedSet.has(node.key);
539
+
540
+ return (
541
+ <div data-slot="tree-node-wrapper">
542
+ <TreeNodeRowInner node={node} level={level} isLeaf={isLeaf} />
543
+ {hasChildren && isExpanded && (
544
+ <div data-slot="tree-children" className="relative">
545
+ {ctx.showLine && (
546
+ <span
547
+ aria-hidden
548
+ data-slot="tree-line"
549
+ className="pointer-events-none absolute top-0 bottom-0 w-px bg-border"
550
+ style={{
551
+ left: `${
552
+ level * INDENT_PER_LEVEL + NODE_BASE_PADDING_LEFT + 8
553
+ }px`,
554
+ }}
555
+ />
556
+ )}
557
+ {node.children!.map((child) => (
558
+ <TreeNodeRow key={child.key} node={child} level={level + 1} />
559
+ ))}
560
+ </div>
561
+ )}
562
+ </div>
563
+ );
564
+ }
565
+
566
+ // ─── 单行渲染(虚拟路径与递归路径共用)──────────────────────────────────────
567
+
568
+ function TreeNodeRowInner({
569
+ node,
570
+ level,
571
+ isLeaf,
572
+ }: {
573
+ node: TreeNode;
574
+ level: number;
575
+ isLeaf: boolean;
576
+ }) {
577
+ const ctx = useTreeRuntime();
578
+ const hasChildren = !!(node.children && node.children.length > 0);
579
+ const isExpanded = ctx.expandedSet.has(node.key);
580
+ const isLoading = ctx.loadingSet.has(node.key);
581
+ const isSelected = ctx.selectedSet.has(node.key);
582
+ const nodeSelectable = !node.disabled && (node.selectable ?? ctx.selectable);
583
+ const nodeCheckable = node.checkable ?? ctx.checkable;
584
+ const isMatched = ctx.filterTreeNode?.(node) ?? false;
585
+
586
+ // 勾选态
587
+ let isChecked: boolean | 'indeterminate' = false;
588
+ if (nodeCheckable) {
589
+ if (ctx.checkStrictly) {
590
+ isChecked = ctx.checkedSet.has(node.key);
591
+ } else {
592
+ const fully = isFullyChecked(node, ctx.checkedSet, getKey);
593
+ const half = !fully && isIndeterminate(node, ctx.checkedSet, getKey);
594
+ isChecked = fully ? true : half ? 'indeterminate' : false;
595
+ }
596
+ }
597
+
598
+ return (
599
+ <div
600
+ role="treeitem"
601
+ aria-expanded={hasChildren ? isExpanded : undefined}
602
+ aria-selected={isSelected}
603
+ data-slot="tree-node"
604
+ data-selected={isSelected}
605
+ data-disabled={node.disabled ? 'true' : 'false'}
606
+ data-level={level}
607
+ className={cn(
608
+ treeNodeVariants({
609
+ size: ctx.size,
610
+ block: ctx.blockNode,
611
+ selectable: nodeSelectable,
612
+ }),
613
+ )}
614
+ style={{
615
+ paddingLeft: `${level * INDENT_PER_LEVEL + NODE_BASE_PADDING_LEFT}px`,
616
+ }}
617
+ onClick={() => {
618
+ if (node.disabled) return;
619
+ // 点行为:可选中时优先选中;否则若可勾选则切换勾选(TreeSelect 多选场景复用)
620
+ if (nodeSelectable) {
621
+ ctx.onSelect(node);
622
+ return;
623
+ }
624
+ if (ctx.checkable && nodeCheckable && !node.disableCheckbox) {
625
+ const fully = isChecked === true;
626
+ ctx.onCheck(node, !fully);
627
+ }
628
+ }}
629
+ >
630
+ {/* Expand / loading switcher */}
631
+ <span
632
+ data-slot="tree-switcher"
633
+ className="inline-flex size-4 shrink-0 items-center justify-center"
634
+ onClick={(e) => {
635
+ if (isLeaf) return;
636
+ e.stopPropagation();
637
+ ctx.onToggleExpand(node);
638
+ }}
639
+ >
640
+ {isLoading ? (
641
+ <Loader2Icon className="size-3 animate-spin text-muted-foreground" />
642
+ ) : !isLeaf ? (
643
+ <ChevronRightIcon
644
+ className={cn(
645
+ 'size-3 text-muted-foreground transition-transform',
646
+ isExpanded && 'rotate-90',
647
+ )}
648
+ />
649
+ ) : null}
650
+ </span>
651
+
652
+ {/* Checkbox */}
653
+ {ctx.checkable && nodeCheckable && (
654
+ <span
655
+ className="inline-flex shrink-0"
656
+ onClick={(e) => e.stopPropagation()}
657
+ onPointerDown={(e) => e.stopPropagation()}
658
+ >
659
+ <Checkbox
660
+ checked={isChecked}
661
+ disabled={node.disabled || node.disableCheckbox}
662
+ onCheckedChange={(next) =>
663
+ ctx.onCheck(
664
+ node,
665
+ next === true || next === 'indeterminate' ? true : false,
666
+ )
667
+ }
668
+ tabIndex={-1}
669
+ />
670
+ </span>
671
+ )}
672
+
673
+ {/* Icon */}
674
+ {ctx.showIcon && (
675
+ <span
676
+ data-slot="tree-icon"
677
+ className="inline-flex size-4 shrink-0 items-center justify-center text-muted-foreground"
678
+ >
679
+ {node.icon ??
680
+ (isLeaf ? (
681
+ <FileIcon className="size-3.5" />
682
+ ) : (
683
+ <FolderIcon className="size-3.5" />
684
+ ))}
685
+ </span>
686
+ )}
687
+
688
+ {/* Label */}
689
+ <span
690
+ data-slot="tree-label"
691
+ data-matched={isMatched ? 'true' : undefined}
692
+ className={cn(
693
+ 'truncate',
694
+ ctx.blockNode && 'flex-1',
695
+ isMatched &&
696
+ 'rounded-sm bg-accent px-1 font-medium text-accent-foreground',
697
+ )}
698
+ >
699
+ {ctx.titleRender ? ctx.titleRender(node) : node.label}
700
+ </span>
701
+ </div>
702
+ );
703
+ }
704
+
705
+ // ─── 虚拟滚动渲染路径 ───────────────────────────────────────────────────────
706
+
707
+ function TreeVirtualBody({
708
+ flat,
709
+ itemHeight,
710
+ }: {
711
+ flat: FlatTreeNode<TreeNode>[];
712
+ itemHeight: number;
713
+ }) {
714
+ const parentRef = React.useRef<HTMLDivElement | null>(null);
715
+ // virtualizer 直接挂在外层 div(max-h-96 overflow-auto),但外层 div 由 Tree 控制;
716
+ // 这里再包一层固定高度容器以承载虚拟列表。
717
+ const virtualizer = useVirtualizer({
718
+ count: flat.length,
719
+ getScrollElement: () => parentRef.current,
720
+ estimateSize: () => itemHeight,
721
+ overscan: 8,
722
+ });
723
+ const items = virtualizer.getVirtualItems();
724
+ const total = virtualizer.getTotalSize();
725
+
726
+ return (
727
+ <div
728
+ ref={parentRef}
729
+ data-slot="tree-virtual-scroll"
730
+ className="h-96 overflow-auto"
731
+ >
732
+ <div
733
+ data-slot="tree-virtual-inner"
734
+ style={{ height: total, position: 'relative', width: '100%' }}
735
+ >
736
+ {items.map((vi) => {
737
+ const entry = flat[vi.index]!;
738
+ return (
739
+ <div
740
+ key={getKey(entry.node)}
741
+ data-index={vi.index}
742
+ ref={virtualizer.measureElement}
743
+ style={{
744
+ position: 'absolute',
745
+ top: 0,
746
+ left: 0,
747
+ width: '100%',
748
+ transform: `translateY(${vi.start}px)`,
749
+ }}
750
+ >
751
+ <TreeNodeRowInner
752
+ node={entry.node}
753
+ level={entry.level}
754
+ isLeaf={entry.isLeaf}
755
+ />
756
+ </div>
757
+ );
758
+ })}
759
+ </div>
760
+ </div>
761
+ );
762
+ }
763
+
764
+ export { Tree, treeNodeVariants };