@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.
- package/README.md +46 -50
- package/manifest.json +406 -653
- package/package.json +15 -34
- package/src/_design-system/theme-tokens/stories.tsx +1474 -0
- package/src/components/accordion/index.tsx +139 -0
- package/src/components/accordion/meta.md +162 -0
- package/src/components/accordion/stories.tsx +145 -0
- package/src/components/affix/index.tsx +149 -0
- package/src/components/affix/meta.md +23 -0
- package/src/components/affix/stories.tsx +70 -0
- package/src/components/alert/index.tsx +220 -0
- package/src/components/alert/meta.md +133 -0
- package/src/components/alert/stories.tsx +126 -0
- package/src/components/alert-dialog/index.tsx +282 -0
- package/src/components/alert-dialog/meta.md +86 -0
- package/src/components/alert-dialog/stories.tsx +163 -0
- package/src/components/avatar/index.tsx +159 -0
- package/src/components/avatar/meta.md +242 -0
- package/src/components/avatar/stories.tsx +241 -0
- package/src/components/badge/index.tsx +299 -0
- package/src/components/badge/meta.md +237 -0
- package/src/components/badge/stories.tsx +275 -0
- package/src/components/breadcrumb/index.tsx +137 -0
- package/src/components/breadcrumb/meta.md +64 -0
- package/src/components/breadcrumb/stories.tsx +86 -0
- package/src/components/button/index.tsx +202 -0
- package/src/components/button/meta.md +209 -0
- package/src/components/button/stories.tsx +215 -0
- package/src/components/button-group/index.tsx +211 -0
- package/src/components/button-group/meta.md +190 -0
- package/src/components/button-group/stories.tsx +182 -0
- package/src/components/calendar/index.tsx +240 -0
- package/src/components/calendar/meta.md +36 -0
- package/src/components/calendar/stories.tsx +36 -0
- package/src/components/card/index.tsx +262 -0
- package/src/components/card/meta.md +194 -0
- package/src/components/card/stories.tsx +202 -0
- package/src/components/carousel/index.tsx +481 -0
- package/src/components/carousel/meta.md +208 -0
- package/src/components/carousel/stories.tsx +271 -0
- package/src/components/cascader-select/index.tsx +308 -0
- package/src/components/cascader-select/meta.md +28 -0
- package/src/components/cascader-select/stories.tsx +118 -0
- package/src/components/checkbox/index.tsx +208 -0
- package/src/components/checkbox/meta.md +166 -0
- package/src/components/checkbox/stories.tsx +206 -0
- package/src/components/collapsible/index.tsx +72 -0
- package/src/components/collapsible/meta.md +87 -0
- package/src/components/collapsible/stories.tsx +97 -0
- package/src/components/color-picker/index.tsx +677 -0
- package/src/components/color-picker/meta.md +83 -0
- package/src/components/color-picker/stories.tsx +172 -0
- package/src/components/combobox/index.tsx +687 -0
- package/src/components/combobox/meta.md +83 -0
- package/src/components/combobox/stories.tsx +179 -0
- package/src/components/command/index.tsx +238 -0
- package/src/components/command/meta.md +48 -0
- package/src/components/command/stories.tsx +83 -0
- package/src/components/data-table/index.tsx +1537 -0
- package/src/components/data-table/meta.md +107 -0
- package/src/components/data-table/stories.tsx +1234 -0
- package/src/components/date-picker/index.tsx +1492 -0
- package/src/components/date-picker/meta.md +103 -0
- package/src/components/date-picker/stories.tsx +125 -0
- package/src/components/descriptions/index.tsx +535 -0
- package/src/components/descriptions/meta.md +104 -0
- package/src/components/descriptions/stories.tsx +389 -0
- package/src/components/dialog/index.tsx +255 -0
- package/src/components/dialog/meta.md +244 -0
- package/src/components/dialog/stories.tsx +330 -0
- package/src/components/dropdown-menu/index.tsx +301 -0
- package/src/components/dropdown-menu/meta.md +93 -0
- package/src/components/dropdown-menu/stories.tsx +124 -0
- package/src/components/empty/index.tsx +431 -0
- package/src/components/empty/meta.md +274 -0
- package/src/components/empty/stories.tsx +278 -0
- package/src/components/field/index.tsx +374 -0
- package/src/components/field/meta.md +283 -0
- package/src/components/field/stories.tsx +327 -0
- package/src/components/filter-bar/index.tsx +976 -0
- package/src/components/filter-bar/meta.md +57 -0
- package/src/components/filter-bar/stories.tsx +496 -0
- package/src/components/float-button/index.tsx +163 -0
- package/src/components/float-button/meta.md +73 -0
- package/src/components/float-button/stories.tsx +68 -0
- package/src/components/form/index.tsx +218 -0
- package/src/components/form/meta.md +16 -0
- package/src/components/form/stories.tsx +301 -0
- package/src/components/hover-card/index.tsx +103 -0
- package/src/components/hover-card/meta.md +71 -0
- package/src/components/hover-card/stories.tsx +107 -0
- package/src/components/icon/index.tsx +225 -0
- package/src/components/icon/meta.md +102 -0
- package/src/components/icon/stories.tsx +127 -0
- package/src/components/image/index.tsx +147 -0
- package/src/components/image/meta.md +55 -0
- package/src/components/image/stories.tsx +48 -0
- package/src/components/input/index.tsx +63 -0
- package/src/components/input/meta.md +57 -0
- package/src/components/input/stories.tsx +66 -0
- package/src/components/input-group/index.tsx +292 -0
- package/src/components/input-group/meta.md +108 -0
- package/src/components/input-group/stories.tsx +258 -0
- package/src/components/input-ip/index.tsx +288 -0
- package/src/components/input-ip/meta.md +48 -0
- package/src/components/input-ip/stories.tsx +69 -0
- package/src/components/input-number/index.tsx +360 -0
- package/src/components/input-number/meta.md +156 -0
- package/src/components/input-number/stories.tsx +187 -0
- package/src/components/item/index.tsx +368 -0
- package/src/components/item/meta.md +395 -0
- package/src/components/item/stories.tsx +432 -0
- package/src/components/label/index.tsx +44 -0
- package/src/components/label/meta.md +68 -0
- package/src/components/label/stories.tsx +64 -0
- package/src/components/mentions/index.tsx +369 -0
- package/src/components/mentions/meta.md +118 -0
- package/src/components/mentions/stories.tsx +153 -0
- package/src/components/menubar/index.tsx +313 -0
- package/src/components/menubar/meta.md +52 -0
- package/src/components/menubar/stories.tsx +99 -0
- package/src/components/navigation-menu/index.tsx +216 -0
- package/src/components/navigation-menu/meta.md +66 -0
- package/src/components/navigation-menu/stories.tsx +137 -0
- package/src/components/page-header/index.tsx +218 -0
- package/src/components/page-header/meta.md +211 -0
- package/src/components/page-header/stories.tsx +290 -0
- package/src/components/page-shell/index.tsx +119 -0
- package/src/components/page-shell/meta.md +115 -0
- package/src/components/page-shell/stories.tsx +154 -0
- package/src/components/pagination/index.tsx +580 -0
- package/src/components/pagination/meta.md +39 -0
- package/src/components/pagination/stories.tsx +319 -0
- package/src/components/popconfirm/index.tsx +477 -0
- package/src/components/popconfirm/meta.md +164 -0
- package/src/components/popconfirm/stories.tsx +231 -0
- package/src/components/popover/index.tsx +181 -0
- package/src/components/popover/meta.md +97 -0
- package/src/components/popover/stories.tsx +169 -0
- package/src/components/progress/index.tsx +176 -0
- package/src/components/progress/meta.md +95 -0
- package/src/components/progress/stories.tsx +115 -0
- package/src/components/radio-group/index.tsx +78 -0
- package/src/components/radio-group/meta.md +137 -0
- package/src/components/radio-group/stories.tsx +285 -0
- package/src/components/rate/index.tsx +284 -0
- package/src/components/rate/meta.md +63 -0
- package/src/components/rate/stories.tsx +107 -0
- package/src/components/resizable/index.tsx +122 -0
- package/src/components/resizable/meta.md +142 -0
- package/src/components/resizable/stories.tsx +105 -0
- package/src/components/scroll-area/index.tsx +83 -0
- package/src/components/scroll-area/meta.md +85 -0
- package/src/components/scroll-area/stories.tsx +82 -0
- package/src/components/select/index.tsx +325 -0
- package/src/components/select/meta.md +183 -0
- package/src/components/select/stories.tsx +210 -0
- package/src/components/separator/index.tsx +51 -0
- package/src/components/separator/meta.md +68 -0
- package/src/components/separator/stories.tsx +53 -0
- package/src/components/sheet/index.tsx +293 -0
- package/src/components/sheet/meta.md +226 -0
- package/src/components/sheet/stories.tsx +405 -0
- package/src/components/sidebar/index.tsx +715 -0
- package/src/components/sidebar/meta.md +14 -0
- package/src/components/sidebar/{sidebar.stories.tsx → stories.tsx} +250 -330
- package/src/components/skeleton/index.tsx +415 -0
- package/src/components/skeleton/meta.md +210 -0
- package/src/components/skeleton/stories.tsx +197 -0
- package/src/components/slider/index.tsx +222 -0
- package/src/components/slider/meta.md +125 -0
- package/src/components/slider/stories.tsx +109 -0
- package/src/components/sonner/index.tsx +149 -0
- package/src/components/sonner/meta.md +156 -0
- package/src/components/sonner/stories.tsx +285 -0
- package/src/components/spinner/index.tsx +335 -0
- package/src/components/spinner/meta.md +172 -0
- package/src/components/spinner/stories.tsx +197 -0
- package/src/components/statistic/{statistic.tsx → index.tsx} +25 -26
- package/src/components/statistic/meta.md +94 -0
- package/src/components/statistic/stories.tsx +85 -0
- package/src/components/steps/index.tsx +500 -0
- package/src/components/steps/meta.md +245 -0
- package/src/components/steps/stories.tsx +287 -0
- package/src/components/switch/index.tsx +175 -0
- package/src/components/switch/meta.md +107 -0
- package/src/components/switch/stories.tsx +154 -0
- package/src/components/table/index.tsx +350 -0
- package/src/components/table/meta.md +148 -0
- package/src/components/table/stories.tsx +189 -0
- package/src/components/tabs/index.tsx +379 -0
- package/src/components/tabs/meta.md +244 -0
- package/src/components/tabs/stories.tsx +312 -0
- package/src/components/tag/index.tsx +774 -0
- package/src/components/tag/meta.md +256 -0
- package/src/components/tag/stories.tsx +431 -0
- package/src/components/textarea/index.tsx +62 -0
- package/src/components/textarea/meta.md +77 -0
- package/src/components/textarea/stories.tsx +112 -0
- package/src/components/time-picker/index.tsx +887 -0
- package/src/components/time-picker/meta.md +102 -0
- package/src/components/time-picker/stories.tsx +125 -0
- package/src/components/timeline/index.tsx +422 -0
- package/src/components/timeline/meta.md +352 -0
- package/src/components/timeline/stories.tsx +369 -0
- package/src/components/toggle/index.tsx +74 -0
- package/src/components/toggle/meta.md +76 -0
- package/src/components/toggle/stories.tsx +66 -0
- package/src/components/toggle-group/index.tsx +167 -0
- package/src/components/toggle-group/meta.md +141 -0
- package/src/components/toggle-group/stories.tsx +124 -0
- package/src/components/tooltip/index.tsx +144 -0
- package/src/components/tooltip/meta.md +186 -0
- package/src/components/tooltip/stories.tsx +212 -0
- package/src/components/transfer/index.tsx +639 -0
- package/src/components/transfer/meta.md +76 -0
- package/src/components/transfer/stories.tsx +221 -0
- package/src/components/tree/index.tsx +764 -0
- package/src/components/tree/meta.md +96 -0
- package/src/components/tree/stories.tsx +385 -0
- package/src/components/tree/utils.ts +269 -0
- package/src/components/tree-select/index.tsx +400 -0
- package/src/components/tree-select/meta.md +78 -0
- package/src/components/tree-select/stories.tsx +234 -0
- package/src/components/typography/index.tsx +290 -0
- package/src/components/typography/meta.md +151 -0
- package/src/components/typography/stories.tsx +151 -0
- package/src/components/upload/index.tsx +858 -0
- package/src/components/upload/meta.md +122 -0
- package/src/components/upload/stories.tsx +261 -0
- package/src/components/watermark/index.tsx +152 -0
- package/src/components/watermark/meta.md +67 -0
- package/src/components/watermark/stories.tsx +59 -0
- package/src/hooks/use-mobile.ts +9 -11
- package/src/lib/color.ts +243 -0
- package/src/{utils/cn.ts → lib/utils.ts} +1 -1
- package/src/components/accordion/accordion.meta.md +0 -88
- package/src/components/accordion/accordion.stories.tsx +0 -72
- package/src/components/accordion/accordion.tsx +0 -154
- package/src/components/affix/affix.meta.md +0 -98
- package/src/components/affix/affix.stories.tsx +0 -134
- package/src/components/affix/affix.tsx +0 -167
- package/src/components/alert/alert.meta.md +0 -132
- package/src/components/alert/alert.stories.tsx +0 -138
- package/src/components/alert/alert.tsx +0 -179
- package/src/components/alert-dialog/alert-dialog.meta.md +0 -152
- package/src/components/alert-dialog/alert-dialog.stories.tsx +0 -223
- package/src/components/alert-dialog/alert-dialog.tsx +0 -183
- package/src/components/anchor/anchor.meta.md +0 -92
- package/src/components/anchor/anchor.stories.tsx +0 -74
- package/src/components/anchor/anchor.tsx +0 -130
- package/src/components/app/app.meta.md +0 -91
- package/src/components/app/app.stories.tsx +0 -64
- package/src/components/app/app.tsx +0 -58
- package/src/components/aspect-ratio/aspect-ratio.meta.md +0 -82
- package/src/components/aspect-ratio/aspect-ratio.stories.tsx +0 -59
- package/src/components/aspect-ratio/aspect-ratio.tsx +0 -22
- package/src/components/auto-complete/auto-complete.meta.md +0 -110
- package/src/components/auto-complete/auto-complete.stories.tsx +0 -136
- package/src/components/auto-complete/auto-complete.tsx +0 -253
- package/src/components/avatar/avatar.meta.md +0 -93
- package/src/components/avatar/avatar.stories.tsx +0 -98
- package/src/components/avatar/avatar.tsx +0 -127
- package/src/components/badge/badge.meta.md +0 -120
- package/src/components/badge/badge.stories.tsx +0 -153
- package/src/components/badge/badge.tsx +0 -204
- package/src/components/breadcrumb/breadcrumb.meta.md +0 -127
- package/src/components/breadcrumb/breadcrumb.stories.tsx +0 -207
- package/src/components/breadcrumb/breadcrumb.tsx +0 -136
- package/src/components/button/button.meta.md +0 -335
- package/src/components/button/button.stories.tsx +0 -743
- package/src/components/button/button.tsx +0 -466
- package/src/components/calendar/calendar.meta.md +0 -128
- package/src/components/calendar/calendar.stories.tsx +0 -68
- package/src/components/calendar/calendar.tsx +0 -172
- package/src/components/card/card.meta.md +0 -139
- package/src/components/card/card.stories.tsx +0 -151
- package/src/components/card/card.tsx +0 -306
- package/src/components/carousel/carousel.meta.md +0 -118
- package/src/components/carousel/carousel.stories.tsx +0 -89
- package/src/components/carousel/carousel.tsx +0 -224
- package/src/components/cascader/cascader.meta.md +0 -140
- package/src/components/cascader/cascader.stories.tsx +0 -120
- package/src/components/cascader/cascader.tsx +0 -548
- package/src/components/checkbox/checkbox.meta.md +0 -167
- package/src/components/checkbox/checkbox.stories.tsx +0 -288
- package/src/components/checkbox/checkbox.tsx +0 -195
- package/src/components/collapsible/collapsible.meta.md +0 -88
- package/src/components/collapsible/collapsible.stories.tsx +0 -43
- package/src/components/collapsible/collapsible.tsx +0 -105
- package/src/components/color-picker/color-picker.meta.md +0 -89
- package/src/components/color-picker/color-picker.stories.tsx +0 -159
- package/src/components/color-picker/color-picker.tsx +0 -171
- package/src/components/command/command.meta.md +0 -120
- package/src/components/command/command.stories.tsx +0 -59
- package/src/components/command/command.tsx +0 -158
- package/src/components/context-menu/context-menu.meta.md +0 -93
- package/src/components/context-menu/context-menu.stories.tsx +0 -54
- package/src/components/context-menu/context-menu.tsx +0 -204
- package/src/components/data-table/data-table.meta.md +0 -150
- package/src/components/data-table/data-table.stories.tsx +0 -132
- package/src/components/data-table/data-table.tsx +0 -185
- package/src/components/date-picker/date-picker.meta.md +0 -175
- package/src/components/date-picker/date-picker.stories.tsx +0 -108
- package/src/components/date-picker/date-picker.tsx +0 -1554
- package/src/components/descriptions/descriptions.meta.md +0 -83
- package/src/components/descriptions/descriptions.stories.tsx +0 -60
- package/src/components/descriptions/descriptions.tsx +0 -137
- package/src/components/dialog/dialog.meta.md +0 -168
- package/src/components/dialog/dialog.stories.tsx +0 -255
- package/src/components/dialog/dialog.tsx +0 -180
- package/src/components/dialog/imperative.tsx +0 -252
- package/src/components/drawer/drawer.meta.md +0 -95
- package/src/components/drawer/drawer.stories.tsx +0 -71
- package/src/components/drawer/drawer.tsx +0 -23
- package/src/components/dropdown-menu/dropdown-menu.meta.md +0 -171
- package/src/components/dropdown-menu/dropdown-menu.stories.tsx +0 -198
- package/src/components/dropdown-menu/dropdown-menu.tsx +0 -209
- package/src/components/ellipsis/ellipsis.meta.md +0 -87
- package/src/components/ellipsis/ellipsis.stories.tsx +0 -72
- package/src/components/ellipsis/ellipsis.tsx +0 -153
- package/src/components/empty/empty.meta.md +0 -86
- package/src/components/empty/empty.stories.tsx +0 -46
- package/src/components/empty/empty.tsx +0 -54
- package/src/components/field/field.meta.md +0 -154
- package/src/components/field/field.stories.tsx +0 -497
- package/src/components/field/field.tsx +0 -392
- package/src/components/filter-bar/filter-bar.meta.md +0 -92
- package/src/components/filter-bar/filter-bar.stories.tsx +0 -1086
- package/src/components/filter-bar/filter-bar.tsx +0 -568
- package/src/components/flex/flex.meta.md +0 -142
- package/src/components/flex/flex.stories.tsx +0 -199
- package/src/components/flex/flex.tsx +0 -145
- package/src/components/float-button/float-button.meta.md +0 -92
- package/src/components/float-button/float-button.stories.tsx +0 -80
- package/src/components/float-button/float-button.tsx +0 -143
- package/src/components/form/form.meta.md +0 -153
- package/src/components/form/form.stories.tsx +0 -472
- package/src/components/form/form.tsx +0 -260
- package/src/components/grid/grid.meta.md +0 -92
- package/src/components/grid/grid.stories.tsx +0 -101
- package/src/components/grid/grid.tsx +0 -130
- package/src/components/hover-card/hover-card.meta.md +0 -103
- package/src/components/hover-card/hover-card.stories.tsx +0 -97
- package/src/components/hover-card/hover-card.tsx +0 -67
- package/src/components/icon/DEVELOPMENT.md +0 -809
- package/src/components/icon/icon.meta.md +0 -170
- package/src/components/icon/icon.stories.tsx +0 -344
- package/src/components/icon/icon.tsx +0 -248
- package/src/components/image/image.meta.md +0 -99
- package/src/components/image/image.stories.tsx +0 -55
- package/src/components/image/image.tsx +0 -140
- package/src/components/input/input.meta.md +0 -115
- package/src/components/input/input.stories.tsx +0 -144
- package/src/components/input/input.tsx +0 -212
- package/src/components/input-group/input-group.meta.md +0 -124
- package/src/components/input-group/input-group.stories.tsx +0 -121
- package/src/components/input-group/input-group.tsx +0 -143
- package/src/components/input-number/input-number.meta.md +0 -148
- package/src/components/input-number/input-number.stories.tsx +0 -125
- package/src/components/input-number/input-number.tsx +0 -283
- package/src/components/input-otp/input-otp.meta.md +0 -106
- package/src/components/input-otp/input-otp.stories.tsx +0 -65
- package/src/components/input-otp/input-otp.tsx +0 -97
- package/src/components/item/item.meta.md +0 -121
- package/src/components/item/item.stories.tsx +0 -116
- package/src/components/item/item.tsx +0 -172
- package/src/components/kbd/kbd.meta.md +0 -94
- package/src/components/kbd/kbd.stories.tsx +0 -70
- package/src/components/kbd/kbd.tsx +0 -86
- package/src/components/label/label.meta.md +0 -99
- package/src/components/label/label.stories.tsx +0 -145
- package/src/components/label/label.tsx +0 -138
- package/src/components/masonry/masonry.meta.md +0 -90
- package/src/components/masonry/masonry.stories.tsx +0 -68
- package/src/components/masonry/masonry.tsx +0 -60
- package/src/components/mentions/mentions.meta.md +0 -119
- package/src/components/mentions/mentions.stories.tsx +0 -189
- package/src/components/mentions/mentions.tsx +0 -243
- package/src/components/menubar/menubar.meta.md +0 -118
- package/src/components/menubar/menubar.stories.tsx +0 -141
- package/src/components/menubar/menubar.tsx +0 -232
- package/src/components/native-select/native-select.meta.md +0 -93
- package/src/components/native-select/native-select.stories.tsx +0 -83
- package/src/components/native-select/native-select.tsx +0 -54
- package/src/components/navigation-menu/navigation-menu.meta.md +0 -118
- package/src/components/navigation-menu/navigation-menu.stories.tsx +0 -215
- package/src/components/navigation-menu/navigation-menu.tsx +0 -129
- package/src/components/notification/notification.meta.md +0 -133
- package/src/components/notification/notification.stories.tsx +0 -98
- package/src/components/notification/notification.tsx +0 -99
- package/src/components/page-header/DEVELOPMENT.md +0 -842
- package/src/components/page-header/page-header.meta.md +0 -210
- package/src/components/page-header/page-header.stories.tsx +0 -428
- package/src/components/page-header/page-header.tsx +0 -284
- package/src/components/page-shell/page-shell.meta.md +0 -116
- package/src/components/page-shell/page-shell.stories.tsx +0 -149
- package/src/components/page-shell/page-shell.tsx +0 -115
- package/src/components/pagination/pagination.meta.md +0 -230
- package/src/components/pagination/pagination.stories.tsx +0 -284
- package/src/components/pagination/pagination.tsx +0 -567
- package/src/components/popconfirm/popconfirm.meta.md +0 -114
- package/src/components/popconfirm/popconfirm.stories.tsx +0 -75
- package/src/components/popconfirm/popconfirm.tsx +0 -134
- package/src/components/popover/popover.meta.md +0 -154
- package/src/components/popover/popover.stories.tsx +0 -158
- package/src/components/popover/popover.tsx +0 -104
- package/src/components/progress/progress.meta.md +0 -118
- package/src/components/progress/progress.stories.tsx +0 -75
- package/src/components/progress/progress.tsx +0 -203
- package/src/components/radio-group/radio-group.meta.md +0 -175
- package/src/components/radio-group/radio-group.stories.tsx +0 -113
- package/src/components/radio-group/radio-group.tsx +0 -209
- package/src/components/rate/rate.meta.md +0 -118
- package/src/components/rate/rate.stories.tsx +0 -89
- package/src/components/rate/rate.tsx +0 -180
- package/src/components/resizable/resizable.meta.md +0 -95
- package/src/components/resizable/resizable.stories.tsx +0 -104
- package/src/components/resizable/resizable.tsx +0 -56
- package/src/components/result/result.meta.md +0 -95
- package/src/components/result/result.stories.tsx +0 -67
- package/src/components/result/result.tsx +0 -100
- package/src/components/scroll-area/scroll-area.meta.md +0 -85
- package/src/components/scroll-area/scroll-area.stories.tsx +0 -49
- package/src/components/scroll-area/scroll-area.tsx +0 -51
- package/src/components/segmented/segmented.meta.md +0 -106
- package/src/components/segmented/segmented.stories.tsx +0 -130
- package/src/components/segmented/segmented.tsx +0 -146
- package/src/components/select/select.meta.md +0 -255
- package/src/components/select/select.stories.tsx +0 -275
- package/src/components/select/select.tsx +0 -735
- package/src/components/separator/separator.meta.md +0 -75
- package/src/components/separator/separator.stories.tsx +0 -71
- package/src/components/separator/separator.tsx +0 -100
- package/src/components/sheet/sheet.meta.md +0 -113
- package/src/components/sheet/sheet.stories.tsx +0 -188
- package/src/components/sheet/sheet.tsx +0 -226
- package/src/components/sidebar/sidebar.meta.md +0 -151
- package/src/components/sidebar/sidebar.tsx +0 -853
- package/src/components/skeleton/skeleton.meta.md +0 -94
- package/src/components/skeleton/skeleton.stories.tsx +0 -79
- package/src/components/skeleton/skeleton.tsx +0 -144
- package/src/components/slider/slider.meta.md +0 -146
- package/src/components/slider/slider.stories.tsx +0 -121
- package/src/components/slider/slider.tsx +0 -227
- package/src/components/sonner/sonner.meta.md +0 -147
- package/src/components/sonner/sonner.stories.tsx +0 -164
- package/src/components/sonner/sonner.tsx +0 -169
- package/src/components/spinner/spinner.meta.md +0 -125
- package/src/components/spinner/spinner.stories.tsx +0 -123
- package/src/components/spinner/spinner.tsx +0 -166
- package/src/components/statistic/statistic.meta.md +0 -104
- package/src/components/statistic/statistic.stories.tsx +0 -67
- package/src/components/steps/steps.meta.md +0 -116
- package/src/components/steps/steps.stories.tsx +0 -115
- package/src/components/steps/steps.tsx +0 -173
- package/src/components/switch/switch.meta.md +0 -138
- package/src/components/switch/switch.stories.tsx +0 -75
- package/src/components/switch/switch.tsx +0 -169
- package/src/components/table/table.meta.md +0 -106
- package/src/components/table/table.stories.tsx +0 -80
- package/src/components/table/table.tsx +0 -124
- package/src/components/tabs/tabs.meta.md +0 -111
- package/src/components/tabs/tabs.stories.tsx +0 -156
- package/src/components/tabs/tabs.tsx +0 -190
- package/src/components/tag/tag.meta.md +0 -159
- package/src/components/tag/tag.stories.tsx +0 -250
- package/src/components/tag/tag.tsx +0 -386
- package/src/components/textarea/textarea.meta.md +0 -99
- package/src/components/textarea/textarea.stories.tsx +0 -89
- package/src/components/textarea/textarea.tsx +0 -137
- package/src/components/time-picker/time-picker.meta.md +0 -175
- package/src/components/time-picker/time-picker.stories.tsx +0 -129
- package/src/components/time-picker/time-picker.tsx +0 -946
- package/src/components/timeline/timeline.meta.md +0 -110
- package/src/components/timeline/timeline.stories.tsx +0 -134
- package/src/components/timeline/timeline.tsx +0 -168
- package/src/components/toggle/toggle.meta.md +0 -89
- package/src/components/toggle/toggle.stories.tsx +0 -66
- package/src/components/toggle/toggle.tsx +0 -54
- package/src/components/toggle-group/toggle-group.meta.md +0 -91
- package/src/components/toggle-group/toggle-group.stories.tsx +0 -83
- package/src/components/toggle-group/toggle-group.tsx +0 -78
- package/src/components/tooltip/tooltip.meta.md +0 -149
- package/src/components/tooltip/tooltip.stories.tsx +0 -108
- package/src/components/tooltip/tooltip.tsx +0 -153
- package/src/components/tour/tour.meta.md +0 -121
- package/src/components/tour/tour.stories.tsx +0 -66
- package/src/components/tour/tour.tsx +0 -242
- package/src/components/transfer/transfer.meta.md +0 -95
- package/src/components/transfer/transfer.stories.tsx +0 -64
- package/src/components/transfer/transfer.tsx +0 -258
- package/src/components/tree/tree.meta.md +0 -169
- package/src/components/tree/tree.stories.tsx +0 -128
- package/src/components/tree/tree.tsx +0 -368
- package/src/components/tree-select/tree-select.meta.md +0 -151
- package/src/components/tree-select/tree-select.stories.tsx +0 -80
- package/src/components/tree-select/tree-select.tsx +0 -206
- package/src/components/typography/typography.meta.md +0 -149
- package/src/components/typography/typography.stories.tsx +0 -116
- package/src/components/typography/typography.tsx +0 -260
- package/src/components/upload/upload.meta.md +0 -156
- package/src/components/upload/upload.stories.tsx +0 -135
- package/src/components/upload/upload.tsx +0 -398
- package/src/components/watermark/watermark.meta.md +0 -100
- package/src/components/watermark/watermark.stories.tsx +0 -170
- package/src/components/watermark/watermark.tsx +0 -166
- package/src/hooks/use-breakpoint.ts +0 -117
- package/src/hooks/use-debounce-callback.ts +0 -52
- package/src/stories/theme-tokens.stories.tsx +0 -747
- 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 };
|