@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,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 };