@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
@@ -1,284 +0,0 @@
1
- import * as React from 'react';
2
- import { ArrowLeft } from 'lucide-react';
3
-
4
- import { cn } from '@/utils/cn';
5
- import { Skeleton, SkeletonParagraph } from '@/components/skeleton/skeleton';
6
-
7
- // ─── PageHeader: 顶层容器(<header>) ─────────────────────────────────────────
8
-
9
- export interface PageHeaderProps extends React.HTMLAttributes<HTMLElement> {
10
- /**
11
- * 右下角背景装饰图 URL — 通过 inline `style.backgroundImage` 注入(Tailwind 不支持
12
- * 动态 URL)。固定 `bg-no-repeat bg-right-bottom`。
13
- */
14
- backgroundImage?: string;
15
- }
16
-
17
- const PageHeader = React.forwardRef<HTMLElement, PageHeaderProps>(
18
- ({ className, backgroundImage, style, children, ...props }, ref) => {
19
- const bgStyle: React.CSSProperties | undefined = backgroundImage
20
- ? {
21
- backgroundImage: `url(${backgroundImage})`,
22
- backgroundRepeat: 'no-repeat',
23
- backgroundPosition: 'right bottom',
24
- ...style,
25
- }
26
- : style;
27
-
28
- return (
29
- <header
30
- ref={ref}
31
- className={cn(
32
- 'relative flex min-h-[var(--page-header-height)] flex-col gap-4',
33
- className,
34
- )}
35
- style={bgStyle}
36
- {...props}
37
- >
38
- {children}
39
- </header>
40
- );
41
- },
42
- );
43
- PageHeader.displayName = 'PageHeader';
44
-
45
- // ─── PageHeaderNav: 导航层(面包屑 + 右侧链接)──────────────────────────────
46
-
47
- const PageHeaderNav = React.forwardRef<
48
- HTMLDivElement,
49
- React.HTMLAttributes<HTMLDivElement>
50
- >(({ className, ...props }, ref) => (
51
- <div
52
- ref={ref}
53
- className={cn(
54
- 'flex min-h-5 items-center justify-between text-xs',
55
- className,
56
- )}
57
- {...props}
58
- />
59
- ));
60
- PageHeaderNav.displayName = 'PageHeaderNav';
61
-
62
- // ─── PageHeaderContent: 主内容区(左右双列)─────────────────────────────────
63
-
64
- const PageHeaderContent = React.forwardRef<
65
- HTMLDivElement,
66
- React.HTMLAttributes<HTMLDivElement>
67
- >(({ className, ...props }, ref) => (
68
- <div
69
- ref={ref}
70
- className={cn(
71
- 'flex flex-wrap items-start justify-between gap-4',
72
- className,
73
- )}
74
- {...props}
75
- />
76
- ));
77
- PageHeaderContent.displayName = 'PageHeaderContent';
78
-
79
- // ─── PageHeaderHeading: 标题行 ───────────────────────────────────────────────
80
-
81
- export interface PageHeaderHeadingProps
82
- extends React.HTMLAttributes<HTMLDivElement> {
83
- /**
84
- * 前置返回按钮。为 `true` 时渲染 `ArrowLeft` 图标按钮,点击触发 `onBack`。
85
- * @default false
86
- */
87
- goBack?: boolean;
88
- /** 返回按钮点击回调。 */
89
- onBack?: (e: React.MouseEvent<HTMLButtonElement>) => void;
90
- }
91
-
92
- const PageHeaderHeading = React.forwardRef<
93
- HTMLDivElement,
94
- PageHeaderHeadingProps
95
- >(({ className, goBack = false, onBack, children, ...props }, ref) => (
96
- <div
97
- ref={ref}
98
- className={cn('flex items-center gap-3', className)}
99
- {...props}
100
- >
101
- {goBack ? (
102
- <button
103
- type="button"
104
- onClick={onBack}
105
- aria-label="返回"
106
- className={cn(
107
- 'inline-flex size-8 shrink-0 cursor-pointer items-center justify-center text-muted-foreground transition-colors',
108
- 'hover:text-foreground',
109
- 'focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring',
110
- )}
111
- >
112
- <ArrowLeft className="size-5" aria-hidden="true" />
113
- </button>
114
- ) : null}
115
- {children}
116
- </div>
117
- ));
118
- PageHeaderHeading.displayName = 'PageHeaderHeading';
119
-
120
- // ─── PageHeaderDescription: 描述文字(<p>) ──────────────────────────────────
121
-
122
- const PageHeaderDescription = React.forwardRef<
123
- HTMLParagraphElement,
124
- React.HTMLAttributes<HTMLParagraphElement>
125
- >(({ className, ...props }, ref) => (
126
- <p
127
- ref={ref}
128
- className={cn('my-2 text-xs text-muted-foreground', className)}
129
- {...props}
130
- />
131
- ));
132
- PageHeaderDescription.displayName = 'PageHeaderDescription';
133
-
134
- // ─── PageHeaderActions: 操作按钮区 ───────────────────────────────────────────
135
-
136
- const PageHeaderActions = React.forwardRef<
137
- HTMLDivElement,
138
- React.HTMLAttributes<HTMLDivElement>
139
- >(({ className, ...props }, ref) => (
140
- <div
141
- ref={ref}
142
- className={cn(
143
- 'flex shrink-0 items-center gap-[var(--button-gap)]',
144
- className,
145
- )}
146
- {...props}
147
- />
148
- ));
149
- PageHeaderActions.displayName = 'PageHeaderActions';
150
-
151
- // ─── PageHeaderData / PageHeaderDataItem: 数据概览 ───────────────────────────
152
-
153
- const PageHeaderData = React.forwardRef<
154
- HTMLDivElement,
155
- React.HTMLAttributes<HTMLDivElement>
156
- >(({ className, ...props }, ref) => (
157
- <div
158
- ref={ref}
159
- className={cn('flex shrink-0 items-end gap-6', className)}
160
- {...props}
161
- />
162
- ));
163
- PageHeaderData.displayName = 'PageHeaderData';
164
-
165
- const dataItemColor = {
166
- default: 'text-foreground',
167
- primary: 'text-primary',
168
- success: 'text-success',
169
- warning: 'text-warning',
170
- destructive: 'text-destructive',
171
- } as const;
172
-
173
- export interface PageHeaderDataItemProps
174
- extends React.HTMLAttributes<HTMLDivElement> {
175
- /** 数据标签(上行,muted 小字)。 */
176
- label: React.ReactNode;
177
- /**
178
- * 值的语义色(调色板) — 对齐 [ADR 0021](../../../../../docs/adr/0021-semantic-color-api-unification.md)。
179
- *
180
- * 填充背景类场景 default 本身为中性色,省略 muted 档;信息色用 `primary`,不收 `info`。
181
- * @default "default"
182
- */
183
- color?: keyof typeof dataItemColor;
184
- }
185
-
186
- const PageHeaderDataItem = React.forwardRef<
187
- HTMLDivElement,
188
- PageHeaderDataItemProps
189
- >(({ className, label, color = 'default', children, ...props }, ref) => (
190
- <div ref={ref} className={cn('flex flex-col', className)} {...props}>
191
- <span className="text-xs text-muted-foreground">{label}</span>
192
- <span
193
- className={cn(
194
- 'text-base font-semibold tabular-nums',
195
- dataItemColor[color],
196
- )}
197
- >
198
- {children}
199
- </span>
200
- </div>
201
- ));
202
- PageHeaderDataItem.displayName = 'PageHeaderDataItem';
203
-
204
- // ─── PageHeaderFooter: 底部详情 ──────────────────────────────────────────────
205
-
206
- const PageHeaderFooter = React.forwardRef<
207
- HTMLDivElement,
208
- React.HTMLAttributes<HTMLDivElement>
209
- >(({ className, ...props }, ref) => (
210
- <div
211
- ref={ref}
212
- className={cn('mt-4 border-t border-t-border pt-4', className)}
213
- {...props}
214
- />
215
- ));
216
- PageHeaderFooter.displayName = 'PageHeaderFooter';
217
-
218
- // ─── PageHeaderSkeleton: 骨架屏 ──────────────────────────────────────────────
219
-
220
- export interface PageHeaderSkeletonProps
221
- extends React.HTMLAttributes<HTMLDivElement> {
222
- /**
223
- * 显示面包屑骨架行。
224
- * @default true
225
- */
226
- showNav?: boolean;
227
- /**
228
- * 显示描述骨架行。
229
- * @default true
230
- */
231
- showDescription?: boolean;
232
- /**
233
- * 显示底部详情骨架(3 列 × 2 行网格)。
234
- * @default false
235
- */
236
- showFooter?: boolean;
237
- }
238
-
239
- const PageHeaderSkeleton = React.forwardRef<
240
- HTMLDivElement,
241
- PageHeaderSkeletonProps
242
- >(
243
- (
244
- {
245
- className,
246
- showNav = true,
247
- showDescription = true,
248
- showFooter = false,
249
- ...props
250
- },
251
- ref,
252
- ) => (
253
- <div
254
- ref={ref}
255
- className={cn('flex flex-col gap-4', className)}
256
- aria-busy="true"
257
- {...props}
258
- >
259
- {showNav ? <Skeleton shape="line" className="h-3 w-48" /> : null}
260
- <div className="flex items-center gap-3">
261
- <Skeleton shape="rect" className="size-8 rounded-md" />
262
- <Skeleton shape="line" className="h-6 w-80" />
263
- </div>
264
- {showDescription ? <Skeleton shape="line" className="h-4 w-96" /> : null}
265
- {showFooter ? <SkeletonParagraph rows={2} className="pt-3" /> : null}
266
- </div>
267
- ),
268
- );
269
- PageHeaderSkeleton.displayName = 'PageHeaderSkeleton';
270
-
271
- // ─── exports ─────────────────────────────────────────────────────────────────
272
-
273
- export {
274
- PageHeader,
275
- PageHeaderNav,
276
- PageHeaderContent,
277
- PageHeaderHeading,
278
- PageHeaderDescription,
279
- PageHeaderActions,
280
- PageHeaderData,
281
- PageHeaderDataItem,
282
- PageHeaderFooter,
283
- PageHeaderSkeleton,
284
- };
@@ -1,116 +0,0 @@
1
- ---
2
- id: page-shell
3
- name: PageShell
4
- displayName: 页面壳
5
- type: component
6
- category: layout
7
- since: 0.1.0
8
- package: '@teamix-evo/ui'
9
- ---
10
-
11
- # PageShell 页面壳
12
-
13
- 页面级三明治壳 — `header` + `sidebar` + `children` 三 slot 任意组合,覆盖"全屏 / 仅顶部 / 仅左导 / 顶部+左导" 四种页面形态。`background` prop 走 shadcn 语义槽枚举(`background` / `muted` / `card` / `sidebar` / `accent`),亮暗模式由 [`@teamix-evo/tokens`](../../../../tokens/) 文件自动管。
14
-
15
- PageShell 传 `sidebar` 时内部用 [`<SidebarProvider embedded>`](../sidebar/sidebar.meta.md) —— ui Sidebar 的嵌入模式,sidebar-container 自动走 `position: relative + h-full`(替代默认 `fixed inset-y-0 h-svh`),与 header 共存而不被撑到 viewport 顶端。消费方不再需要手写 `!relative !top-0 !h-full` hack。
16
-
17
- ## When to use
18
-
19
- - **应用主页面骨架** — 控制台 / dashboard / 管理后台等所有需要 sidebar/topbar 的页面
20
- - **无 sidebar 全屏页** — 登录页 / 错误页 / 落地页(不传 `sidebar` 即可)
21
- - **opentrek 风格无吊顶 layout** — 仅传 `sidebar`,主区背景设 `muted`
22
- - **uni-manager 风格吊顶+左导** — 同时传 `header={<UmTopbar />}` 与 `sidebar={<Sidebar />}`
23
-
24
- ## When NOT to use
25
-
26
- - **页面内子布局**(分屏 / 多面板)→ 直接用 flex / grid,PageShell 是页面级唯一壳
27
- - **Modal / Drawer 内的布局** → 这些组件自带容器,不要再叠 PageShell
28
- - **路由级布局共享** — 这是 React Router / Next.js layout 层职责,PageShell 是渲染层
29
-
30
- ## Props
31
-
32
- <!-- auto:props:begin -->
33
- | 名称 | 类型 | 默认值 | 必填 | 说明 |
34
- | --- | --- | --- | --- | --- |
35
- | `header` | `ReactNode` | – | – | 顶部条 slot — 通常是 UmTopbar / 自建 navbar。不传则不渲染顶部。 |
36
- | `sidebar` | `ReactNode` | – | – | 左侧 slot — 通常是 ui `<Sidebar>` 或基于它组合的整装件(如 OpSidebar)。不传则不渲染 sidebar 与 SidebarProvider。 |
37
- | `background` | `'background' \| 'muted' \| 'card' \| 'sidebar' \| 'accent'` | `'background'` | – | 主区背景 — 走 shadcn 语义槽枚举,亮暗模式由 token 文件自动切换。 |
38
- | `sidebarWidth` | `string` | `'14rem'` | – | sidebar 宽度 — 透传给 SidebarProvider 的 `--sidebar-width` CSS 变量。仅在传 `sidebar` 时生效。 |
39
- <!-- auto:props:end -->
40
-
41
- ## 依赖
42
-
43
- <!-- auto:deps:begin -->
44
- ### 同库依赖
45
-
46
- | Entry | 类型 | 描述 |
47
- | --- | --- | --- |
48
- | `cn` | util | Tailwind className 合并工具 |
49
- | `sidebar` | component | shadcn Sidebar 25 primitives |
50
- <!-- auto:deps:end -->
51
-
52
- ## AI 生成纪律
53
-
54
- ### 硬约束
55
-
56
- - **不传 `sidebar` 时不要在 children 内调用 `useSidebar()`** — PageShell 不传 sidebar 即不渲染 SidebarProvider,无 sidebar context
57
- - **`background` 必须用枚举值,不要传 raw className** — 想要其他背景请扩 `PageShellBackground` 枚举或在 children 内自加 wrapper
58
- - **不要在 PageShell 外再包 `SidebarProvider`** — PageShell 传 sidebar 时自带,重复包会破坏 cookie 持久化与 Cmd+B 快捷键
59
- - **sidebar slot 传 ui `<Sidebar>` 时不需要再加 `className="!relative ..."`** — PageShell 已注入 scoped CSS 覆盖
60
-
61
- ### 推荐范式
62
-
63
- - 全屏:`<PageShell><LoginForm /></PageShell>`
64
- - opentrek 无吊顶:`<PageShell background="muted" sidebar={<OpSidebar />}><OpPageContainer>...</OpPageContainer></PageShell>`
65
- - uni-manager 吊顶+左导:`<PageShell header={<UmTopbar ... />} sidebar={<Sidebar>...</Sidebar>}><UmPageContainer>...</UmPageContainer></PageShell>`
66
-
67
- ### 反例
68
-
69
- - ❌ 在 PageShell 外手动包 `<SidebarProvider>` — 重复 provider
70
- - ❌ `background="#f7f7f7"` 传颜色值 — 必须用枚举,违反 token discipline
71
- - ❌ 不传 `sidebar` 但 children 内用 `useSidebar()` — 报错"must be used within a SidebarProvider"
72
-
73
- ## Examples
74
-
75
- ```tsx
76
- import { PageShell } from '@/components/page-shell/page-shell';
77
- import { Sidebar, SidebarContent, SidebarMenu, ... } from '@/components/sidebar/sidebar';
78
-
79
- // 全屏单区 — 登录页
80
- <PageShell>
81
- <LoginForm />
82
- </PageShell>
83
-
84
- // 仅顶部 — 简单页面
85
- <PageShell header={<Navbar />}>
86
- <main>...</main>
87
- </PageShell>
88
-
89
- // 仅 sidebar — opentrek 风格(灰底)
90
- <PageShell background="muted" sidebar={<OpSidebar />}>
91
- <OpPageContainer header={...}>...</OpPageContainer>
92
- </PageShell>
93
-
94
- // 完整三明治 — uni-manager 风格(白底)
95
- <PageShell
96
- header={<UmTopbar brand={...} menus={...} ... />}
97
- sidebar={<Sidebar collapsible="icon">...</Sidebar>}
98
- sidebarWidth="14rem"
99
- >
100
- <UmPageContainer header={<PageHeader>...</PageHeader>}>
101
- <DataTable ... />
102
- </UmPageContainer>
103
- </PageShell>
104
- ```
105
-
106
- ## 实现细节
107
-
108
- PageShell 传 `sidebar` 时,内部用 `<SidebarProvider embedded ...>` 启用 ui Sidebar 的嵌入模式。该模式下 [Sidebar](../sidebar/sidebar.meta.md) 的 `sidebar-container` 自动从默认 `fixed inset-y-0 h-svh` 切到 `relative h-full`,让 sidebar 跟 header 在同一布局流里垂直对齐 —— 完全声明式,无 scoped CSS、无 `!important` 覆盖。
109
-
110
- `embedded` 是 ui SidebarProvider 的原生 prop(默认 `false` 保持 shadcn 全屏行为),由 context 透传给所有下游 `<Sidebar>` 自动响应。
111
-
112
- ## 关联
113
-
114
- - 范本组件:[Sidebar](../sidebar/sidebar.meta.md) — PageShell 内嵌的 SidebarProvider / SidebarInset 来自这里
115
- - 关联组件:[PageHeader](../page-header/page-header.meta.md) — 页面内 PageContainer 的 header slot 首选
116
- - 关联 ADR:[ADR 0005](../../../../../docs/adr/0005-ui-no-variant.md) — ui 不感知 variant,具体页面壳由 biz-ui 的 OpPageContainer / UmPageContainer 在 PageShell 内拼装
@@ -1,149 +0,0 @@
1
- import * as React from 'react';
2
- import type { Meta, StoryObj } from '@storybook/react-vite';
3
- import { Bell, Home, Inbox, Settings, Users } from 'lucide-react';
4
-
5
- import { PageShell } from './page-shell';
6
- import {
7
- Sidebar,
8
- SidebarContent,
9
- SidebarGroup,
10
- SidebarHeader,
11
- SidebarMenu,
12
- SidebarMenuButton,
13
- SidebarMenuItem,
14
- SidebarTrigger,
15
- } from '@/components/sidebar/sidebar';
16
- import { Button } from '@/components/button/button';
17
-
18
- const meta: Meta<typeof PageShell> = {
19
- title: '布局 · Layout/PageShell',
20
- component: PageShell,
21
- tags: ['autodocs'],
22
- parameters: {
23
- layout: 'fullscreen',
24
- docs: {
25
- description: {
26
- component:
27
- 'PageShell — 页面三明治壳。`header` + `sidebar` + `children` 三 slot 任意组合;`background` prop 走 shadcn 语义槽枚举(`background` / `muted` / `card` / `sidebar` / `accent`),亮暗模式由 token 文件自动管。内部为传入的 ui `<Sidebar>` 注入 scoped CSS 覆盖默认 `position: fixed`,让 sidebar 跟 header 共存而不被撑到 viewport 顶端。',
28
- },
29
- },
30
- },
31
- argTypes: {
32
- background: {
33
- control: 'inline-radio',
34
- options: ['background', 'muted', 'card', 'sidebar', 'accent'],
35
- },
36
- sidebarWidth: { control: 'text' },
37
- },
38
- };
39
-
40
- export default meta;
41
- type Story = StoryObj<typeof PageShell>;
42
-
43
- // ─── 共享 demo 内容 ──────────────────────────────────────────────────────
44
-
45
- function DemoHeader() {
46
- return (
47
- <header className="flex h-14 items-center justify-between border-b border-border bg-background px-6">
48
- <span className="text-sm font-semibold">TopBar</span>
49
- <Button variant="ghost" size="sm">
50
- <Bell className="size-4" /> 通知
51
- </Button>
52
- </header>
53
- );
54
- }
55
-
56
- function DemoSidebar() {
57
- return (
58
- <Sidebar collapsible="icon">
59
- <SidebarHeader>
60
- <div className="flex items-center justify-between px-2 py-2">
61
- <span className="text-sm font-semibold group-data-[collapsible=icon]:hidden">
62
- Logo
63
- </span>
64
- <SidebarTrigger />
65
- </div>
66
- </SidebarHeader>
67
- <SidebarContent>
68
- <SidebarGroup>
69
- <SidebarMenu>
70
- {[
71
- { id: 'home', title: '首页', icon: Home },
72
- { id: 'inbox', title: '收件箱', icon: Inbox },
73
- { id: 'team', title: '团队', icon: Users },
74
- { id: 'settings', title: '设置', icon: Settings },
75
- ].map((it) => (
76
- <SidebarMenuItem key={it.id}>
77
- <SidebarMenuButton tooltip={it.title}>
78
- <it.icon />
79
- <span>{it.title}</span>
80
- </SidebarMenuButton>
81
- </SidebarMenuItem>
82
- ))}
83
- </SidebarMenu>
84
- </SidebarGroup>
85
- </SidebarContent>
86
- </Sidebar>
87
- );
88
- }
89
-
90
- function DemoMain({ label = '主区内容' }: { label?: string }) {
91
- return (
92
- <div className="px-6 py-4">
93
- <h1 className="text-2xl font-semibold text-foreground">{label}</h1>
94
- <p className="mt-2 text-sm text-muted-foreground">
95
- PageShell 提供布局壳,具体内容由 PageContainer + 业务组件填充。
96
- </p>
97
- </div>
98
- );
99
- }
100
-
101
- // ─── Stories ─────────────────────────────────────────────────────────────
102
-
103
- /**
104
- * Fullscreen — 不传 `header` 与 `sidebar`,只渲染 children。适合登录页 / 错误页 / 落地页。
105
- */
106
- export const Fullscreen: Story = {
107
- args: { background: 'background' },
108
- render: (args) => (
109
- <PageShell {...args}>
110
- <DemoMain label="全屏单区" />
111
- </PageShell>
112
- ),
113
- };
114
-
115
- /**
116
- * WithHeader — 仅传 `header`,顶部条 + 全宽主区。
117
- */
118
- export const WithHeader: Story = {
119
- args: { background: 'background' },
120
- render: (args) => (
121
- <PageShell {...args} header={<DemoHeader />}>
122
- <DemoMain label="顶部 + 全宽主区" />
123
- </PageShell>
124
- ),
125
- };
126
-
127
- /**
128
- * WithSidebar — 仅传 `sidebar`,左导 + 主区。无吊顶布局(opentrek 风格,主区背景常用 `muted`)。
129
- */
130
- export const WithSidebar: Story = {
131
- args: { background: 'muted' },
132
- render: (args) => (
133
- <PageShell {...args} sidebar={<DemoSidebar />}>
134
- <DemoMain label="左导 + 主区(muted 背景)" />
135
- </PageShell>
136
- ),
137
- };
138
-
139
- /**
140
- * Complete — header + sidebar + children 完整三明治。切 controls 看不同 `background`。
141
- */
142
- export const Complete: Story = {
143
- args: { background: 'background' },
144
- render: (args) => (
145
- <PageShell {...args} header={<DemoHeader />} sidebar={<DemoSidebar />}>
146
- <DemoMain label="吊顶 + 左导 + 主区" />
147
- </PageShell>
148
- ),
149
- };
@@ -1,115 +0,0 @@
1
- /**
2
- * PageShell — 页面三明治壳(layout-level composed component)
3
- *
4
- * 用 shadcn Sidebar primitives 组合一个"顶部 header(可选) + 左侧 sidebar(可选) + 主区"
5
- * 的页面骨架。三个 slot 都可空,组合出四种页面形态:
6
- *
7
- * 1. 不传 header & sidebar → 全屏单区(登录页 / 错误页)
8
- * 2. 仅 header → 顶部条 + 全宽主区
9
- * 3. 仅 sidebar → 左导 + 主区(opentrek 那种无吊顶 layout)
10
- * 4. header + sidebar → 吊顶 + 左导 + 主区(uni-manager 那种)
11
- *
12
- * 主区背景由 `background` prop 切换 — 用 shadcn 语义槽枚举,亮暗由 token 文件自动管。
13
- *
14
- * 传 `sidebar` 时,PageShell 内部用 `<SidebarProvider embedded>` —— ui Sidebar 的嵌入模式,
15
- * sidebar-container 自动走 `position: relative + h-full`(替代默认 `fixed inset-y-0 h-svh`),
16
- * 与 header 共存而不被撑到 viewport 顶端。
17
- */
18
- import * as React from 'react';
19
-
20
- import { cn } from '@/utils/cn';
21
- import { SidebarInset, SidebarProvider } from '@/components/sidebar/sidebar';
22
-
23
- export type PageShellBackground =
24
- | 'background'
25
- | 'muted'
26
- | 'card'
27
- | 'sidebar'
28
- | 'accent';
29
-
30
- const BG_CLASS: Record<PageShellBackground, string> = {
31
- background: 'bg-background',
32
- muted: 'bg-muted',
33
- card: 'bg-card',
34
- sidebar: 'bg-sidebar',
35
- accent: 'bg-accent',
36
- };
37
-
38
- export interface PageShellProps extends React.HTMLAttributes<HTMLDivElement> {
39
- /** 顶部条 slot — 通常是 UmTopbar / 自建 navbar。不传则不渲染顶部。 */
40
- header?: React.ReactNode;
41
- /** 左侧 slot — 通常是 ui `<Sidebar>` 或基于它组合的整装件(如 OpSidebar)。不传则不渲染 sidebar 与 SidebarProvider。 */
42
- sidebar?: React.ReactNode;
43
- /** 主区内容。 */
44
- children: React.ReactNode;
45
- /**
46
- * 主区背景 — 走 shadcn 语义槽枚举,亮暗模式由 token 文件自动切换。
47
- * @default "background"
48
- */
49
- background?: PageShellBackground;
50
- /**
51
- * sidebar 宽度 — 透传给 SidebarProvider 的 `--sidebar-width` CSS 变量。仅在传 `sidebar` 时生效。
52
- * @default "14rem"
53
- */
54
- sidebarWidth?: string;
55
- }
56
-
57
- const PageShell = React.forwardRef<HTMLDivElement, PageShellProps>(
58
- function PageShell(
59
- {
60
- header,
61
- sidebar,
62
- children,
63
- background = 'background',
64
- sidebarWidth = '14rem',
65
- className,
66
- style,
67
- ...rest
68
- },
69
- ref,
70
- ) {
71
- const bgClass = BG_CLASS[background];
72
-
73
- if (!sidebar) {
74
- return (
75
- <div
76
- ref={ref}
77
- className={cn('flex min-h-svh w-full flex-col', className)}
78
- style={style}
79
- {...rest}
80
- >
81
- {header}
82
- <main className={cn('flex-1 overflow-y-auto', bgClass)}>
83
- {children}
84
- </main>
85
- </div>
86
- );
87
- }
88
-
89
- return (
90
- <SidebarProvider
91
- ref={ref}
92
- embedded
93
- className={cn('!flex-col', className)}
94
- style={
95
- {
96
- '--sidebar-width': sidebarWidth,
97
- ...style,
98
- } as React.CSSProperties
99
- }
100
- {...rest}
101
- >
102
- {header}
103
- <div className="flex w-full flex-1 min-h-0">
104
- {sidebar}
105
- <SidebarInset className={cn('!min-h-0 overflow-y-auto', bgClass)}>
106
- {children}
107
- </SidebarInset>
108
- </div>
109
- </SidebarProvider>
110
- );
111
- },
112
- );
113
- PageShell.displayName = 'PageShell';
114
-
115
- export { PageShell };