@bridgebrew/ui 0.0.0-stage → 0.1.9
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/LICENSE +21 -0
- package/README.md +39 -2
- package/SOURCE.md +182 -0
- package/dist/build.js +871 -0
- package/dist/theme-css.js +896 -0
- package/dist/themes.js +69 -0
- package/dist/types/build/stylesheet.d.ts +31 -0
- package/dist/types/components/composite/command/command.d.ts +94 -0
- package/dist/types/components/composite/command/index.d.ts +2 -0
- package/dist/types/components/composite/draft-bar/draft-bar.d.ts +12 -0
- package/dist/types/components/composite/draft-bar/index.d.ts +2 -0
- package/dist/types/components/composite/image-field/image-field.d.ts +33 -0
- package/dist/types/components/composite/image-field/index.d.ts +2 -0
- package/dist/types/components/composite/list/index.d.ts +3 -0
- package/dist/types/components/composite/list/list-swipe.d.ts +28 -0
- package/dist/types/components/composite/list/list.d.ts +95 -0
- package/dist/types/components/composite/picker/index.d.ts +2 -0
- package/dist/types/components/composite/picker/picker.d.ts +44 -0
- package/dist/types/components/composite/prompt-field/index.d.ts +2 -0
- package/dist/types/components/composite/prompt-field/prompt-field.d.ts +18 -0
- package/dist/types/components/composite/properties/index.d.ts +2 -0
- package/dist/types/components/composite/properties/properties.d.ts +24 -0
- package/dist/types/components/composite/snooze-menu/index.d.ts +4 -0
- package/dist/types/components/composite/snooze-menu/presets.d.ts +36 -0
- package/dist/types/components/composite/snooze-menu/snooze-menu.d.ts +27 -0
- package/dist/types/components/composite/tag-input/index.d.ts +2 -0
- package/dist/types/components/composite/tag-input/tag-input.d.ts +22 -0
- package/dist/types/components/composite/wizard/index.d.ts +2 -0
- package/dist/types/components/composite/wizard/wizard.d.ts +53 -0
- package/dist/types/components/core/avatar/avatar.d.ts +16 -0
- package/dist/types/components/core/avatar/index.d.ts +2 -0
- package/dist/types/components/core/badge/badge.d.ts +8 -0
- package/dist/types/components/core/badge/index.d.ts +2 -0
- package/dist/types/components/core/breadcrumb/breadcrumb.d.ts +21 -0
- package/dist/types/components/core/breadcrumb/index.d.ts +2 -0
- package/dist/types/components/core/bullets/bullets.d.ts +15 -0
- package/dist/types/components/core/bullets/index.d.ts +2 -0
- package/dist/types/components/core/button/button.d.ts +14 -0
- package/dist/types/components/core/button/index.d.ts +2 -0
- package/dist/types/components/core/card/card.d.ts +16 -0
- package/dist/types/components/core/card/index.d.ts +2 -0
- package/dist/types/components/core/checkbox/checkbox.d.ts +15 -0
- package/dist/types/components/core/checkbox/index.d.ts +2 -0
- package/dist/types/components/core/cluster/cluster.d.ts +5 -0
- package/dist/types/components/core/cluster/index.d.ts +1 -0
- package/dist/types/components/core/code-block/code-block.d.ts +18 -0
- package/dist/types/components/core/code-block/index.d.ts +2 -0
- package/dist/types/components/core/collapsible/collapsible.d.ts +8 -0
- package/dist/types/components/core/collapsible/index.d.ts +1 -0
- package/dist/types/components/core/colour-picker/colour-picker.d.ts +25 -0
- package/dist/types/components/core/colour-picker/index.d.ts +4 -0
- package/dist/types/components/core/combobox/combobox.d.ts +63 -0
- package/dist/types/components/core/combobox/index.d.ts +2 -0
- package/dist/types/components/core/detail/detail.d.ts +12 -0
- package/dist/types/components/core/detail/index.d.ts +1 -0
- package/dist/types/components/core/dialog/dialog.d.ts +43 -0
- package/dist/types/components/core/dialog/drag.d.ts +4 -0
- package/dist/types/components/core/dialog/index.d.ts +2 -0
- package/dist/types/components/core/drop-zone/drop-zone.d.ts +23 -0
- package/dist/types/components/core/drop-zone/index.d.ts +2 -0
- package/dist/types/components/core/dropdown-menu/dropdown-menu.d.ts +78 -0
- package/dist/types/components/core/dropdown-menu/index.d.ts +2 -0
- package/dist/types/components/core/editable-field/editable-field.d.ts +42 -0
- package/dist/types/components/core/editable-field/index.d.ts +2 -0
- package/dist/types/components/core/empty-state/empty-state.d.ts +11 -0
- package/dist/types/components/core/empty-state/index.d.ts +2 -0
- package/dist/types/components/core/field/field.d.ts +31 -0
- package/dist/types/components/core/field/index.d.ts +2 -0
- package/dist/types/components/core/icon/icon-sets.d.ts +38 -0
- package/dist/types/components/core/icon/icon.d.ts +14 -0
- package/dist/types/components/core/icon/index.d.ts +2 -0
- package/dist/types/components/core/input/index.d.ts +4 -0
- package/dist/types/components/core/input/input.d.ts +22 -0
- package/dist/types/components/core/input/textarea.d.ts +8 -0
- package/dist/types/components/core/kbd/index.d.ts +2 -0
- package/dist/types/components/core/kbd/kbd.d.ts +7 -0
- package/dist/types/components/core/label/index.d.ts +2 -0
- package/dist/types/components/core/label/label.d.ts +13 -0
- package/dist/types/components/core/main-content/index.d.ts +2 -0
- package/dist/types/components/core/main-content/main-content.d.ts +18 -0
- package/dist/types/components/core/pane/index.d.ts +1 -0
- package/dist/types/components/core/pane/pane.d.ts +12 -0
- package/dist/types/components/core/pick-menu/index.d.ts +4 -0
- package/dist/types/components/core/pick-menu/pick-menu.d.ts +57 -0
- package/dist/types/components/core/pick-menu/tag-menu.d.ts +19 -0
- package/dist/types/components/core/popover/index.d.ts +2 -0
- package/dist/types/components/core/popover/popover.d.ts +22 -0
- package/dist/types/components/core/progress/index.d.ts +2 -0
- package/dist/types/components/core/progress/progress.d.ts +13 -0
- package/dist/types/components/core/resizable/index.d.ts +2 -0
- package/dist/types/components/core/resizable/resizable.d.ts +15 -0
- package/dist/types/components/core/resizable/use-remembered-layout.d.ts +31 -0
- package/dist/types/components/core/screen-link/index.d.ts +2 -0
- package/dist/types/components/core/screen-link/screen-link.d.ts +52 -0
- package/dist/types/components/core/scroll-area/index.d.ts +2 -0
- package/dist/types/components/core/scroll-area/scroll-area.d.ts +13 -0
- package/dist/types/components/core/scroll-area/steps.d.ts +5 -0
- package/dist/types/components/core/section/index.d.ts +2 -0
- package/dist/types/components/core/section/section.d.ts +16 -0
- package/dist/types/components/core/segment-group/index.d.ts +2 -0
- package/dist/types/components/core/segment-group/segment-group.d.ts +24 -0
- package/dist/types/components/core/select/index.d.ts +2 -0
- package/dist/types/components/core/select/select.d.ts +39 -0
- package/dist/types/components/core/skeleton/index.d.ts +2 -0
- package/dist/types/components/core/skeleton/skeleton.d.ts +13 -0
- package/dist/types/components/core/slider/index.d.ts +2 -0
- package/dist/types/components/core/slider/slider.d.ts +9 -0
- package/dist/types/components/core/sortable/index.d.ts +2 -0
- package/dist/types/components/core/sortable/sortable.d.ts +53 -0
- package/dist/types/components/core/split-view/index.d.ts +2 -0
- package/dist/types/components/core/split-view/split-view.d.ts +28 -0
- package/dist/types/components/core/status-icon/index.d.ts +2 -0
- package/dist/types/components/core/status-icon/status-icon.d.ts +13 -0
- package/dist/types/components/core/table/collapsible-rows.d.ts +7 -0
- package/dist/types/components/core/table/expand-toggle.d.ts +10 -0
- package/dist/types/components/core/table/group-header.d.ts +14 -0
- package/dist/types/components/core/table/index.d.ts +8 -0
- package/dist/types/components/core/table/table.d.ts +31 -0
- package/dist/types/components/core/tabs/index.d.ts +2 -0
- package/dist/types/components/core/tabs/tabs.d.ts +20 -0
- package/dist/types/components/core/tag-pill/index.d.ts +2 -0
- package/dist/types/components/core/tag-pill/tag-pill.d.ts +25 -0
- package/dist/types/components/core/thumbnail/index.d.ts +2 -0
- package/dist/types/components/core/thumbnail/thumbnail.d.ts +23 -0
- package/dist/types/components/core/toast/index.d.ts +2 -0
- package/dist/types/components/core/toast/toast.d.ts +88 -0
- package/dist/types/components/core/toggle/index.d.ts +2 -0
- package/dist/types/components/core/toggle/toggle.d.ts +9 -0
- package/dist/types/components/core/toggle-group/index.d.ts +2 -0
- package/dist/types/components/core/toggle-group/toggle-group.d.ts +21 -0
- package/dist/types/components/core/tooltip/index.d.ts +2 -0
- package/dist/types/components/core/tooltip/tooltip.d.ts +33 -0
- package/dist/types/components/layout/multi-pane/index.d.ts +4 -0
- package/dist/types/components/layout/multi-pane/list-detail.d.ts +17 -0
- package/dist/types/components/layout/multi-pane/multi-pane.d.ts +34 -0
- package/dist/types/components/layout/single-pane/index.d.ts +2 -0
- package/dist/types/components/layout/single-pane/single-pane.d.ts +11 -0
- package/dist/types/components/shell/app-shell/app-shell.d.ts +12 -0
- package/dist/types/components/shell/app-shell/index.d.ts +2 -0
- package/dist/types/components/shell/sidebar/index.d.ts +2 -0
- package/dist/types/components/shell/sidebar/sidebar-group.d.ts +45 -0
- package/dist/types/components/shell/sidebar/sidebar-item.d.ts +19 -0
- package/dist/types/components/shell/sidebar/sidebar-resize-handle.d.ts +17 -0
- package/dist/types/components/shell/sidebar/sidebar-tree.d.ts +42 -0
- package/dist/types/components/shell/sidebar/sidebar.d.ts +27 -0
- package/dist/types/components/template/address-book-template/address-book-template.d.ts +15 -0
- package/dist/types/components/template/address-book-template/index.d.ts +2 -0
- package/dist/types/components/template/mail-template/index.d.ts +2 -0
- package/dist/types/components/template/mail-template/mail-template.d.ts +11 -0
- package/dist/types/components/template/use-narrow.d.ts +3 -0
- package/dist/types/index.d.ts +149 -0
- package/dist/types/kit/check-rendering.d.ts +3 -0
- package/dist/types/kit/kit.d.ts +76 -0
- package/dist/types/lib/clipboard.d.ts +5 -0
- package/dist/types/lib/dates.d.ts +9 -0
- package/dist/types/lib/json.d.ts +26 -0
- package/dist/types/lib/keys.d.ts +15 -0
- package/dist/types/lib/utils.d.ts +2 -0
- package/dist/types/lib/view-scope.d.ts +22 -0
- package/dist/types/profile/profile.d.ts +34 -0
- package/dist/types/theme/appearance.d.ts +31 -0
- package/dist/types/theme/boot.d.ts +3 -0
- package/dist/types/theme/client-appearance-react.d.ts +3 -0
- package/dist/types/theme/client-appearance.d.ts +69 -0
- package/dist/types/theme/generate-tokens.d.ts +45 -0
- package/dist/types/theme/pack-themes-react.d.ts +24 -0
- package/dist/types/theme/palette.d.ts +111 -0
- package/dist/types/theme/semantic-mapping.d.ts +28 -0
- package/dist/types/theme/set-theme.d.ts +30 -0
- package/dist/types/theme/theme-colours.d.ts +14 -0
- package/dist/types/theme/theme-css.d.ts +3 -0
- package/dist/types/theme/themes.d.ts +63 -0
- package/dist/types/theme/wallpaper-sheet.d.ts +16 -0
- package/dist/types/theme/wallpaper-theme-react.d.ts +7 -0
- package/dist/types/theme/wallpaper-theme.d.ts +37 -0
- package/package.json +87 -3
- package/src/build/stylesheet.ts +128 -0
- package/src/components/composite/command/command.meta.yaml +74 -0
- package/src/components/composite/command/command.tsx +939 -0
- package/src/components/composite/command/index.ts +17 -0
- package/src/components/composite/draft-bar/draft-bar.meta.yaml +19 -0
- package/src/components/composite/draft-bar/draft-bar.tsx +57 -0
- package/src/components/composite/draft-bar/index.ts +2 -0
- package/src/components/composite/image-field/image-field.meta.yaml +69 -0
- package/src/components/composite/image-field/image-field.tsx +267 -0
- package/src/components/composite/image-field/index.ts +2 -0
- package/src/components/composite/list/index.ts +18 -0
- package/src/components/composite/list/list-swipe.tsx +163 -0
- package/src/components/composite/list/list.meta.yaml +238 -0
- package/src/components/composite/list/list.tsx +868 -0
- package/src/components/composite/picker/index.ts +2 -0
- package/src/components/composite/picker/picker.meta.yaml +103 -0
- package/src/components/composite/picker/picker.tsx +276 -0
- package/src/components/composite/prompt-field/index.ts +2 -0
- package/src/components/composite/prompt-field/prompt-field.meta.yaml +60 -0
- package/src/components/composite/prompt-field/prompt-field.tsx +81 -0
- package/src/components/composite/properties/index.ts +9 -0
- package/src/components/composite/properties/properties.meta.yaml +56 -0
- package/src/components/composite/properties/properties.tsx +132 -0
- package/src/components/composite/snooze-menu/index.ts +11 -0
- package/src/components/composite/snooze-menu/presets.ts +169 -0
- package/src/components/composite/snooze-menu/snooze-menu.meta.yaml +58 -0
- package/src/components/composite/snooze-menu/snooze-menu.tsx +146 -0
- package/src/components/composite/tag-input/index.ts +2 -0
- package/src/components/composite/tag-input/tag-input.meta.yaml +51 -0
- package/src/components/composite/tag-input/tag-input.tsx +404 -0
- package/src/components/composite/wizard/index.ts +2 -0
- package/src/components/composite/wizard/wizard.meta.yaml +73 -0
- package/src/components/composite/wizard/wizard.tsx +256 -0
- package/src/components/core/avatar/avatar.meta.yaml +71 -0
- package/src/components/core/avatar/avatar.tsx +92 -0
- package/src/components/core/avatar/index.ts +2 -0
- package/src/components/core/badge/badge.meta.yaml +34 -0
- package/src/components/core/badge/badge.tsx +23 -0
- package/src/components/core/badge/index.ts +2 -0
- package/src/components/core/breadcrumb/breadcrumb.meta.yaml +45 -0
- package/src/components/core/breadcrumb/breadcrumb.tsx +110 -0
- package/src/components/core/breadcrumb/index.ts +2 -0
- package/src/components/core/bullets/bullets.meta.yaml +37 -0
- package/src/components/core/bullets/bullets.tsx +60 -0
- package/src/components/core/bullets/index.ts +2 -0
- package/src/components/core/button/button.meta.yaml +91 -0
- package/src/components/core/button/button.tsx +93 -0
- package/src/components/core/button/index.ts +2 -0
- package/src/components/core/card/card.meta.yaml +94 -0
- package/src/components/core/card/card.tsx +54 -0
- package/src/components/core/card/index.ts +2 -0
- package/src/components/core/checkbox/checkbox.meta.yaml +59 -0
- package/src/components/core/checkbox/checkbox.tsx +106 -0
- package/src/components/core/checkbox/index.ts +2 -0
- package/src/components/core/cluster/cluster.meta.yaml +4 -0
- package/src/components/core/cluster/cluster.tsx +17 -0
- package/src/components/core/cluster/index.ts +1 -0
- package/src/components/core/code-block/code-block.meta.yaml +30 -0
- package/src/components/core/code-block/code-block.tsx +93 -0
- package/src/components/core/code-block/index.ts +2 -0
- package/src/components/core/collapsible/collapsible.meta.yaml +34 -0
- package/src/components/core/collapsible/collapsible.tsx +54 -0
- package/src/components/core/collapsible/index.ts +1 -0
- package/src/components/core/colour-picker/colour-picker.meta.yaml +52 -0
- package/src/components/core/colour-picker/colour-picker.tsx +314 -0
- package/src/components/core/colour-picker/index.ts +4 -0
- package/src/components/core/combobox/combobox.meta.yaml +75 -0
- package/src/components/core/combobox/combobox.tsx +288 -0
- package/src/components/core/combobox/index.ts +2 -0
- package/src/components/core/detail/detail.meta.yaml +13 -0
- package/src/components/core/detail/detail.tsx +73 -0
- package/src/components/core/detail/index.ts +1 -0
- package/src/components/core/dialog/dialog.meta.yaml +95 -0
- package/src/components/core/dialog/dialog.tsx +254 -0
- package/src/components/core/dialog/drag.ts +40 -0
- package/src/components/core/dialog/index.ts +25 -0
- package/src/components/core/drop-zone/drop-zone.meta.yaml +55 -0
- package/src/components/core/drop-zone/drop-zone.tsx +146 -0
- package/src/components/core/drop-zone/index.ts +2 -0
- package/src/components/core/dropdown-menu/dropdown-menu.meta.yaml +118 -0
- package/src/components/core/dropdown-menu/dropdown-menu.tsx +407 -0
- package/src/components/core/dropdown-menu/index.ts +32 -0
- package/src/components/core/editable-field/editable-field.meta.yaml +120 -0
- package/src/components/core/editable-field/editable-field.tsx +346 -0
- package/src/components/core/editable-field/index.ts +2 -0
- package/src/components/core/empty-state/empty-state.meta.yaml +21 -0
- package/src/components/core/empty-state/empty-state.tsx +42 -0
- package/src/components/core/empty-state/index.ts +2 -0
- package/src/components/core/field/field.meta.yaml +37 -0
- package/src/components/core/field/field.tsx +100 -0
- package/src/components/core/field/index.ts +9 -0
- package/src/components/core/icon/curated-names.json +107 -0
- package/src/components/core/icon/icon-sets.ts +109 -0
- package/src/components/core/icon/icon.meta.yaml +30 -0
- package/src/components/core/icon/icon.tsx +93 -0
- package/src/components/core/icon/index.ts +2 -0
- package/src/components/core/input/index.ts +4 -0
- package/src/components/core/input/input.meta.yaml +98 -0
- package/src/components/core/input/input.tsx +133 -0
- package/src/components/core/input/textarea.meta.yaml +79 -0
- package/src/components/core/input/textarea.tsx +63 -0
- package/src/components/core/kbd/index.ts +2 -0
- package/src/components/core/kbd/kbd.meta.yaml +12 -0
- package/src/components/core/kbd/kbd.tsx +29 -0
- package/src/components/core/label/index.ts +2 -0
- package/src/components/core/label/label.meta.yaml +55 -0
- package/src/components/core/label/label.tsx +72 -0
- package/src/components/core/main-content/index.ts +2 -0
- package/src/components/core/main-content/main-content.meta.yaml +23 -0
- package/src/components/core/main-content/main-content.tsx +49 -0
- package/src/components/core/pane/index.ts +1 -0
- package/src/components/core/pane/pane.meta.yaml +13 -0
- package/src/components/core/pane/pane.tsx +64 -0
- package/src/components/core/pick-menu/index.ts +4 -0
- package/src/components/core/pick-menu/pick-menu.meta.yaml +36 -0
- package/src/components/core/pick-menu/pick-menu.tsx +348 -0
- package/src/components/core/pick-menu/tag-menu.meta.yaml +7 -0
- package/src/components/core/pick-menu/tag-menu.tsx +79 -0
- package/src/components/core/popover/index.ts +2 -0
- package/src/components/core/popover/popover.meta.yaml +16 -0
- package/src/components/core/popover/popover.tsx +66 -0
- package/src/components/core/progress/index.ts +2 -0
- package/src/components/core/progress/progress.meta.yaml +47 -0
- package/src/components/core/progress/progress.tsx +56 -0
- package/src/components/core/resizable/index.ts +13 -0
- package/src/components/core/resizable/resizable.meta.yaml +110 -0
- package/src/components/core/resizable/resizable.tsx +125 -0
- package/src/components/core/resizable/use-remembered-layout.ts +261 -0
- package/src/components/core/screen-link/index.ts +2 -0
- package/src/components/core/screen-link/screen-link.meta.yaml +34 -0
- package/src/components/core/screen-link/screen-link.tsx +100 -0
- package/src/components/core/scroll-area/index.ts +2 -0
- package/src/components/core/scroll-area/scroll-area.meta.yaml +72 -0
- package/src/components/core/scroll-area/scroll-area.tsx +95 -0
- package/src/components/core/scroll-area/steps.tsx +72 -0
- package/src/components/core/section/index.ts +2 -0
- package/src/components/core/section/section.meta.yaml +72 -0
- package/src/components/core/section/section.tsx +93 -0
- package/src/components/core/segment-group/index.ts +2 -0
- package/src/components/core/segment-group/segment-group.meta.yaml +71 -0
- package/src/components/core/segment-group/segment-group.tsx +166 -0
- package/src/components/core/select/index.ts +20 -0
- package/src/components/core/select/select.meta.yaml +48 -0
- package/src/components/core/select/select.tsx +226 -0
- package/src/components/core/skeleton/index.ts +2 -0
- package/src/components/core/skeleton/skeleton.meta.yaml +50 -0
- package/src/components/core/skeleton/skeleton.tsx +71 -0
- package/src/components/core/slider/index.ts +2 -0
- package/src/components/core/slider/slider.meta.yaml +55 -0
- package/src/components/core/slider/slider.tsx +46 -0
- package/src/components/core/sortable/index.ts +16 -0
- package/src/components/core/sortable/sortable.meta.yaml +125 -0
- package/src/components/core/sortable/sortable.tsx +471 -0
- package/src/components/core/split-view/index.ts +2 -0
- package/src/components/core/split-view/split-view.meta.yaml +85 -0
- package/src/components/core/split-view/split-view.tsx +193 -0
- package/src/components/core/status-icon/index.ts +2 -0
- package/src/components/core/status-icon/status-icon.meta.yaml +64 -0
- package/src/components/core/status-icon/status-icon.tsx +94 -0
- package/src/components/core/table/collapsible-rows.tsx +30 -0
- package/src/components/core/table/expand-toggle.tsx +58 -0
- package/src/components/core/table/group-header.tsx +35 -0
- package/src/components/core/table/index.ts +26 -0
- package/src/components/core/table/table.meta.yaml +67 -0
- package/src/components/core/table/table.tsx +166 -0
- package/src/components/core/tabs/index.ts +2 -0
- package/src/components/core/tabs/tabs.meta.yaml +57 -0
- package/src/components/core/tabs/tabs.tsx +74 -0
- package/src/components/core/tag-pill/index.ts +2 -0
- package/src/components/core/tag-pill/tag-pill.meta.yaml +19 -0
- package/src/components/core/tag-pill/tag-pill.tsx +102 -0
- package/src/components/core/thumbnail/index.ts +2 -0
- package/src/components/core/thumbnail/thumbnail.meta.yaml +59 -0
- package/src/components/core/thumbnail/thumbnail.tsx +162 -0
- package/src/components/core/toast/index.ts +12 -0
- package/src/components/core/toast/toast.meta.yaml +93 -0
- package/src/components/core/toast/toast.tsx +763 -0
- package/src/components/core/toggle/index.ts +2 -0
- package/src/components/core/toggle/toggle.meta.yaml +53 -0
- package/src/components/core/toggle/toggle.tsx +44 -0
- package/src/components/core/toggle-group/index.ts +2 -0
- package/src/components/core/toggle-group/toggle-group.meta.yaml +59 -0
- package/src/components/core/toggle-group/toggle-group.tsx +68 -0
- package/src/components/core/tooltip/index.ts +7 -0
- package/src/components/core/tooltip/tooltip.meta.yaml +93 -0
- package/src/components/core/tooltip/tooltip.tsx +198 -0
- package/src/components/layout/multi-pane/index.ts +4 -0
- package/src/components/layout/multi-pane/list-detail.tsx +45 -0
- package/src/components/layout/multi-pane/multi-pane.meta.yaml +67 -0
- package/src/components/layout/multi-pane/multi-pane.tsx +158 -0
- package/src/components/layout/single-pane/index.ts +2 -0
- package/src/components/layout/single-pane/single-pane.meta.yaml +35 -0
- package/src/components/layout/single-pane/single-pane.tsx +48 -0
- package/src/components/shell/app-shell/app-shell.meta.yaml +65 -0
- package/src/components/shell/app-shell/app-shell.tsx +61 -0
- package/src/components/shell/app-shell/index.ts +2 -0
- package/src/components/shell/sidebar/index.ts +35 -0
- package/src/components/shell/sidebar/sidebar-group.tsx +254 -0
- package/src/components/shell/sidebar/sidebar-item.tsx +88 -0
- package/src/components/shell/sidebar/sidebar-resize-handle.tsx +101 -0
- package/src/components/shell/sidebar/sidebar-tree.tsx +325 -0
- package/src/components/shell/sidebar/sidebar.meta.yaml +126 -0
- package/src/components/shell/sidebar/sidebar.tsx +142 -0
- package/src/components/template/address-book-template/address-book-template.meta.yaml +22 -0
- package/src/components/template/address-book-template/address-book-template.tsx +201 -0
- package/src/components/template/address-book-template/index.ts +2 -0
- package/src/components/template/mail-template/index.ts +2 -0
- package/src/components/template/mail-template/mail-template.meta.yaml +22 -0
- package/src/components/template/mail-template/mail-template.tsx +731 -0
- package/src/components/template/use-narrow.ts +18 -0
- package/src/index.ts +505 -0
- package/src/kit/check-rendering.tsx +130 -0
- package/src/kit/kit.tsx +177 -0
- package/src/lib/clipboard.ts +27 -0
- package/src/lib/dates.ts +13 -0
- package/src/lib/json.ts +59 -0
- package/src/lib/keys.ts +54 -0
- package/src/lib/utils.ts +12 -0
- package/src/lib/view-scope.tsx +60 -0
- package/src/profile/profile.ts +238 -0
- package/src/theme/appearance.ts +198 -0
- package/src/theme/boot.ts +6 -0
- package/src/theme/client-appearance-react.ts +14 -0
- package/src/theme/client-appearance.ts +284 -0
- package/src/theme/generate-tokens.ts +658 -0
- package/src/theme/pack-themes-react.ts +107 -0
- package/src/theme/palette.ts +301 -0
- package/src/theme/semantic-mapping.ts +165 -0
- package/src/theme/set-theme.ts +162 -0
- package/src/theme/theme-colours.ts +60 -0
- package/src/theme/theme-css.ts +15 -0
- package/src/theme/themes.ts +133 -0
- package/src/theme/wallpaper-sheet.ts +58 -0
- package/src/theme/wallpaper-theme-react.ts +60 -0
- package/src/theme/wallpaper-theme.ts +231 -0
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
name: TagMenu
|
|
2
|
+
description: "The mockup's tag menu on a record: the workspace's known tags with their counts (asked when it opens), the record's checked, Create “…” for a new one; it stays open while picking."
|
|
3
|
+
layer: core
|
|
4
|
+
category: input
|
|
5
|
+
composition_partners:
|
|
6
|
+
- TagList, TagPill (the record's tags, the + that opens it)
|
|
7
|
+
- DataMenuTrigger (the +)
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
|
|
3
|
+
import { TagDot } from "../tag-pill";
|
|
4
|
+
import { PickMenu } from "./pick-menu";
|
|
5
|
+
|
|
6
|
+
// research-033's mockup tag menu: the workspace's known tags with how many hold them (asked when it opens), the
|
|
7
|
+
// record's checked, Create “…” for a new one (listed from then on); it stays open while picking.
|
|
8
|
+
|
|
9
|
+
interface TagCount {
|
|
10
|
+
value: string;
|
|
11
|
+
count: number;
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
interface TagMenuProps {
|
|
15
|
+
open: boolean;
|
|
16
|
+
onOpenChange: (open: boolean) => void;
|
|
17
|
+
anchor: Element | null;
|
|
18
|
+
/** The record's tags. */
|
|
19
|
+
value: readonly string[];
|
|
20
|
+
/** Adds or removes `tag` (any case). */
|
|
21
|
+
onToggle: (tag: string) => void;
|
|
22
|
+
/** The known tags with their counts, asked each time the menu opens (a failure keeps the last ones). */
|
|
23
|
+
load: () => Promise<TagCount[]>;
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
const fold = (tag: string) => tag.toLowerCase();
|
|
27
|
+
|
|
28
|
+
function TagMenu({ open, onOpenChange, anchor, value, onToggle, load }: TagMenuProps) {
|
|
29
|
+
const [known, setKnown] = React.useState<TagCount[]>([]);
|
|
30
|
+
const latest = React.useRef(load);
|
|
31
|
+
latest.current = load;
|
|
32
|
+
React.useEffect(() => {
|
|
33
|
+
if (!open) return;
|
|
34
|
+
let live = true;
|
|
35
|
+
latest.current().then(
|
|
36
|
+
(tags) => {
|
|
37
|
+
if (live) setKnown(tags);
|
|
38
|
+
},
|
|
39
|
+
() => {},
|
|
40
|
+
);
|
|
41
|
+
return () => {
|
|
42
|
+
live = false;
|
|
43
|
+
};
|
|
44
|
+
}, [open]);
|
|
45
|
+
const holds = (tag: string) => value.some((each) => fold(each) === fold(tag));
|
|
46
|
+
const options = [
|
|
47
|
+
...known,
|
|
48
|
+
...value
|
|
49
|
+
.filter((tag) => !known.some((each) => fold(each.value) === fold(tag)))
|
|
50
|
+
.map((tag) => ({ value: tag, count: 1 })),
|
|
51
|
+
].map(({ value: tag, count }) => ({
|
|
52
|
+
key: fold(tag),
|
|
53
|
+
label: tag,
|
|
54
|
+
...(count > 0 && { note: String(count) }),
|
|
55
|
+
checked: holds(tag),
|
|
56
|
+
icon: <TagDot name={tag} />,
|
|
57
|
+
}));
|
|
58
|
+
return (
|
|
59
|
+
<PickMenu
|
|
60
|
+
open={open}
|
|
61
|
+
onOpenChange={onOpenChange}
|
|
62
|
+
multiple
|
|
63
|
+
aria-label="Tags"
|
|
64
|
+
anchor={anchor}
|
|
65
|
+
options={options}
|
|
66
|
+
onPick={(option) => onToggle(option.label)}
|
|
67
|
+
onCreate={(tag) => {
|
|
68
|
+
// Listed from now on, checked or not (the known tags were asked when the menu opened).
|
|
69
|
+
setKnown((current) => [...current, { value: tag, count: 0 }]);
|
|
70
|
+
onToggle(tag);
|
|
71
|
+
}}
|
|
72
|
+
placeholder="Change or add tags…"
|
|
73
|
+
footer="Enter toggles · stays open · Esc closes"
|
|
74
|
+
/>
|
|
75
|
+
);
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
export { TagMenu };
|
|
79
|
+
export type { TagMenuProps, TagCount };
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
name: Popover
|
|
2
|
+
description: "A floating panel tied to a trigger (Base UI Popover): placed and flipped to fit the viewport, never taller than the room left, focus trapped and returned, closed by Escape or a click outside."
|
|
3
|
+
layer: core
|
|
4
|
+
category: overlay
|
|
5
|
+
when_to_use:
|
|
6
|
+
- "A panel that is not a menu: a model picker, a filter, a small form beside its trigger"
|
|
7
|
+
- "Not for a list of actions (DropdownMenu) or a hint (Tooltip)"
|
|
8
|
+
props:
|
|
9
|
+
- name: side
|
|
10
|
+
type: '"top" | "bottom" | "left" | "right"'
|
|
11
|
+
required: false
|
|
12
|
+
default: '"bottom"'
|
|
13
|
+
- name: align
|
|
14
|
+
type: '"start" | "center" | "end"'
|
|
15
|
+
required: false
|
|
16
|
+
default: '"start"'
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
import { Popover as PopoverPrimitive } from "@base-ui/react/popover";
|
|
3
|
+
|
|
4
|
+
import { cn } from "../../../lib/utils";
|
|
5
|
+
|
|
6
|
+
// A floating panel tied to a trigger, on Base UI's Popover: it places itself (flipping and shrinking to the room the
|
|
7
|
+
// viewport leaves, `--available-height`), traps and returns the focus, and closes on Escape or a click outside. For a
|
|
8
|
+
// panel that is no menu (a model picker, a filter): a menu's items are `DropdownMenu`'s.
|
|
9
|
+
|
|
10
|
+
interface PopoverProps extends React.ComponentProps<typeof PopoverPrimitive.Root> {}
|
|
11
|
+
|
|
12
|
+
function Popover(props: PopoverProps) {
|
|
13
|
+
return <PopoverPrimitive.Root {...props} />;
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
interface PopoverTriggerProps extends React.ComponentProps<typeof PopoverPrimitive.Trigger> {}
|
|
17
|
+
|
|
18
|
+
function PopoverTrigger(props: PopoverTriggerProps) {
|
|
19
|
+
return <PopoverPrimitive.Trigger data-slot="popover-trigger" {...props} />;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
interface PopoverContentProps extends React.ComponentProps<typeof PopoverPrimitive.Popup> {
|
|
23
|
+
/** Which side of the trigger to open on; it flips when there is no room (lives on Base UI's Positioner). */
|
|
24
|
+
side?: React.ComponentProps<typeof PopoverPrimitive.Positioner>["side"];
|
|
25
|
+
/** Alignment against the trigger (lives on Base UI's Positioner). */
|
|
26
|
+
align?: React.ComponentProps<typeof PopoverPrimitive.Positioner>["align"];
|
|
27
|
+
/** Distance from the trigger in px (lives on Base UI's Positioner). */
|
|
28
|
+
sideOffset?: React.ComponentProps<typeof PopoverPrimitive.Positioner>["sideOffset"];
|
|
29
|
+
/** Minimum distance from the viewport edges in px (lives on Base UI's Positioner). */
|
|
30
|
+
collisionPadding?: React.ComponentProps<typeof PopoverPrimitive.Positioner>["collisionPadding"];
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/** The panel, in a portal: never taller than the room the viewport leaves on its side. */
|
|
34
|
+
function PopoverContent({
|
|
35
|
+
className,
|
|
36
|
+
side = "bottom",
|
|
37
|
+
align = "start",
|
|
38
|
+
sideOffset = 6,
|
|
39
|
+
collisionPadding = 8,
|
|
40
|
+
...props
|
|
41
|
+
}: PopoverContentProps) {
|
|
42
|
+
return (
|
|
43
|
+
<PopoverPrimitive.Portal>
|
|
44
|
+
<PopoverPrimitive.Positioner
|
|
45
|
+
side={side}
|
|
46
|
+
align={align}
|
|
47
|
+
sideOffset={sideOffset}
|
|
48
|
+
collisionPadding={collisionPadding}
|
|
49
|
+
className="z-50"
|
|
50
|
+
>
|
|
51
|
+
<PopoverPrimitive.Popup
|
|
52
|
+
data-slot="popover-content"
|
|
53
|
+
className={cn(
|
|
54
|
+
"max-h-(--available-height) max-w-(--available-width) overflow-hidden rounded-dialog border border-border bg-surface text-[13px] outline-none",
|
|
55
|
+
className,
|
|
56
|
+
)}
|
|
57
|
+
style={{ boxShadow: "var(--shadow-dropdown)" }}
|
|
58
|
+
{...props}
|
|
59
|
+
/>
|
|
60
|
+
</PopoverPrimitive.Positioner>
|
|
61
|
+
</PopoverPrimitive.Portal>
|
|
62
|
+
);
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
export { Popover, PopoverTrigger, PopoverContent };
|
|
66
|
+
export type { PopoverProps, PopoverTriggerProps, PopoverContentProps };
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
name: Progress
|
|
2
|
+
description: "A horizontal progress bar: determinate from a 0..1 value, or indeterminate and animated while the length is unknown."
|
|
3
|
+
layer: core
|
|
4
|
+
category: feedback
|
|
5
|
+
when_to_use:
|
|
6
|
+
- "A task with a known share done (an upload, an install, a batch)"
|
|
7
|
+
- "A task whose length is unknown yet, as an indeterminate bar (a load, a long save)"
|
|
8
|
+
when_not_to_use:
|
|
9
|
+
- "A short wait under about a second — a busy button or a spinner says it"
|
|
10
|
+
- "A value the user sets — use Slider"
|
|
11
|
+
props:
|
|
12
|
+
- name: value
|
|
13
|
+
type: number
|
|
14
|
+
required: false
|
|
15
|
+
description: "How far along, 0 to 1, clamped; absent: indeterminate and animated"
|
|
16
|
+
- name: label
|
|
17
|
+
type: string
|
|
18
|
+
required: false
|
|
19
|
+
description: "The bar's accessible name (say what is progressing)"
|
|
20
|
+
- name: size
|
|
21
|
+
type: "'sm' | 'md'"
|
|
22
|
+
required: false
|
|
23
|
+
default: "'md'"
|
|
24
|
+
description: "The bar's height: 4px or 8px"
|
|
25
|
+
- name: tone
|
|
26
|
+
type: "'default' | 'danger'"
|
|
27
|
+
required: false
|
|
28
|
+
default: "'default'"
|
|
29
|
+
description: "The accent bar, or the destructive one for a failure or a limit"
|
|
30
|
+
- name: className
|
|
31
|
+
type: string
|
|
32
|
+
required: false
|
|
33
|
+
description: "Additional CSS classes merged via cn()"
|
|
34
|
+
props_priority:
|
|
35
|
+
- value
|
|
36
|
+
- label
|
|
37
|
+
- tone
|
|
38
|
+
- size
|
|
39
|
+
examples:
|
|
40
|
+
- title: "An upload"
|
|
41
|
+
code: '<Progress value={sent / total} label="Uploading the images" />'
|
|
42
|
+
- title: "An unknown wait"
|
|
43
|
+
code: '<Progress label="Installing" size="sm" />'
|
|
44
|
+
anti_patterns:
|
|
45
|
+
- "Don't animate a determinate bar — the width change is the motion"
|
|
46
|
+
- "Don't use aria-valuenow yourself — the bar sets it from `value` and leaves it off when indeterminate"
|
|
47
|
+
accessibility_notes: "role=progressbar with aria-valuemin 0 and aria-valuemax 100; aria-valuenow is the rounded percent when determinate and absent when indeterminate. `label` names it; without one, an ancestor label or the surrounding text must say what is progressing."
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
|
|
3
|
+
import { cn } from "../../../lib/utils";
|
|
4
|
+
|
|
5
|
+
interface ProgressProps extends Omit<React.ComponentProps<"div">, "value"> {
|
|
6
|
+
/** How far along, 0 to 1; absent: indeterminate (an animated bar). */
|
|
7
|
+
value?: number;
|
|
8
|
+
/** The bar's accessible name. */
|
|
9
|
+
label?: string;
|
|
10
|
+
size?: "sm" | "md";
|
|
11
|
+
tone?: "default" | "danger";
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
/** A horizontal progress bar: determinate from `value` (clamped to 0..1), or indeterminate and animated. */
|
|
15
|
+
function Progress({
|
|
16
|
+
value,
|
|
17
|
+
label,
|
|
18
|
+
size = "md",
|
|
19
|
+
tone = "default",
|
|
20
|
+
className,
|
|
21
|
+
...props
|
|
22
|
+
}: ProgressProps) {
|
|
23
|
+
const determinate = value !== undefined && Number.isFinite(value);
|
|
24
|
+
const percent = determinate ? Math.round(Math.min(1, Math.max(0, value)) * 100) : undefined;
|
|
25
|
+
return (
|
|
26
|
+
<div
|
|
27
|
+
data-slot="progress"
|
|
28
|
+
role="progressbar"
|
|
29
|
+
aria-label={label}
|
|
30
|
+
aria-valuemin={0}
|
|
31
|
+
aria-valuemax={100}
|
|
32
|
+
aria-valuenow={percent}
|
|
33
|
+
data-size={size}
|
|
34
|
+
data-tone={tone}
|
|
35
|
+
className={cn(
|
|
36
|
+
"relative w-full overflow-hidden rounded-full bg-active",
|
|
37
|
+
size === "sm" ? "h-1" : "h-2",
|
|
38
|
+
className,
|
|
39
|
+
)}
|
|
40
|
+
{...props}
|
|
41
|
+
>
|
|
42
|
+
<span
|
|
43
|
+
data-slot="progress-bar"
|
|
44
|
+
className={cn(
|
|
45
|
+
"block h-full rounded-full transition-[width] duration-200",
|
|
46
|
+
tone === "danger" ? "bg-destructive" : "bg-accent",
|
|
47
|
+
determinate ? "w-auto" : "w-1/2 animate-pulse motion-reduce:animate-none",
|
|
48
|
+
)}
|
|
49
|
+
style={percent === undefined ? undefined : { width: `${percent}%` }}
|
|
50
|
+
/>
|
|
51
|
+
</div>
|
|
52
|
+
);
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
export { Progress };
|
|
56
|
+
export type { ProgressProps };
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
export {
|
|
2
|
+
ResizablePanelGroup,
|
|
3
|
+
ResizablePanel,
|
|
4
|
+
ResizableHandle,
|
|
5
|
+
useGroupRef,
|
|
6
|
+
usePanelRef,
|
|
7
|
+
} from "./resizable";
|
|
8
|
+
export type {
|
|
9
|
+
PanelImperativeHandle,
|
|
10
|
+
ResizablePanelGroupProps,
|
|
11
|
+
ResizablePanelProps,
|
|
12
|
+
ResizableHandleProps,
|
|
13
|
+
} from "./resizable";
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
name: Resizable
|
|
2
|
+
description: "Resizable panel layout built on react-resizable-panels. Compose panels with drag handles for split views, resizable sidebars, and adjustable layouts."
|
|
3
|
+
layer: core
|
|
4
|
+
category: layout
|
|
5
|
+
when_to_use:
|
|
6
|
+
- "As the base of SplitView and MultiPane: a screen split into columns or rows is a SplitView (shadcn's Resizable under Bridge's names), a list beside its record a MultiPane"
|
|
7
|
+
- "Directly only inside the kit, or for what SplitView cannot say (a panel's imperative handle, a layout kept between reloads)"
|
|
8
|
+
when_not_to_use:
|
|
9
|
+
- "For a screen split into columns or rows — use SplitView"
|
|
10
|
+
- "For a list beside its record — use MultiPane"
|
|
11
|
+
- "For fixed-width layouts — use plain flex or grid CSS"
|
|
12
|
+
- "For collapsible sections — use a disclosure or accordion pattern"
|
|
13
|
+
- "For responsive breakpoints — use CSS media queries instead"
|
|
14
|
+
composition_partners:
|
|
15
|
+
- Sidebar (as content inside a ResizablePanel for resizable sidebar)
|
|
16
|
+
- AppShell (can be replaced by ResizablePanelGroup for resizable layouts)
|
|
17
|
+
- Table (as content in a panel for master-detail views)
|
|
18
|
+
tailwind_classes:
|
|
19
|
+
bg-border: "Handle separator color"
|
|
20
|
+
"before:bg-border": "The 4px line on hover and keyboard focus, as the sidebar's edge"
|
|
21
|
+
"before:bg-muted/40": "The line while dragged (never the accent)"
|
|
22
|
+
props:
|
|
23
|
+
- name: orientation
|
|
24
|
+
type: "'horizontal' | 'vertical'"
|
|
25
|
+
required: true
|
|
26
|
+
description: "Orientation of panel layout (ResizablePanelGroup only)"
|
|
27
|
+
- name: defaultSize
|
|
28
|
+
type: "number | string"
|
|
29
|
+
required: false
|
|
30
|
+
description: "Default size of the panel. Prefer strings with CSS units (e.g. '220px', '30%'). Bare numbers are flex-grow ratios — avoid them as they cause unintuitive sizing. (ResizablePanel only)"
|
|
31
|
+
- name: minSize
|
|
32
|
+
type: "number | string"
|
|
33
|
+
required: false
|
|
34
|
+
description: "Minimum size of the panel. Use a string with units for pixel values (e.g. '180px') (ResizablePanel only)"
|
|
35
|
+
- name: maxSize
|
|
36
|
+
type: "number | string"
|
|
37
|
+
required: false
|
|
38
|
+
description: "Maximum size of the panel. Use a string with units for pixel values (e.g. '360px') (ResizablePanel only)"
|
|
39
|
+
- name: collapsible
|
|
40
|
+
type: boolean
|
|
41
|
+
required: false
|
|
42
|
+
default: "false"
|
|
43
|
+
description: "Whether the panel can collapse to zero size (ResizablePanel only)"
|
|
44
|
+
- name: onResize
|
|
45
|
+
type: "(size: number) => void"
|
|
46
|
+
required: false
|
|
47
|
+
description: "Callback when panel is resized, receives size as a percentage number 0-100 (ResizablePanel only)"
|
|
48
|
+
- name: withHandle
|
|
49
|
+
type: boolean
|
|
50
|
+
required: false
|
|
51
|
+
default: "false"
|
|
52
|
+
description: "Show a visible grip indicator on the drag handle (ResizableHandle only)"
|
|
53
|
+
- name: id
|
|
54
|
+
type: string
|
|
55
|
+
required: false
|
|
56
|
+
description: "Panel identifier, required when using defaultLayout on the group (ResizablePanel only)"
|
|
57
|
+
props_priority:
|
|
58
|
+
- orientation
|
|
59
|
+
- defaultSize
|
|
60
|
+
- minSize
|
|
61
|
+
- maxSize
|
|
62
|
+
- withHandle
|
|
63
|
+
- collapsible
|
|
64
|
+
- id
|
|
65
|
+
examples:
|
|
66
|
+
- title: "Resizable sidebar layout"
|
|
67
|
+
code: |
|
|
68
|
+
<ResizablePanelGroup orientation="horizontal">
|
|
69
|
+
<ResizablePanel defaultSize="220px" minSize="180px" maxSize="360px">
|
|
70
|
+
<Sidebar className="w-full h-full">
|
|
71
|
+
<SidebarSection>Navigation</SidebarSection>
|
|
72
|
+
<SidebarItem icon={<Inbox size={14} />}>Inbox</SidebarItem>
|
|
73
|
+
</Sidebar>
|
|
74
|
+
</ResizablePanel>
|
|
75
|
+
<ResizableHandle />
|
|
76
|
+
<ResizablePanel>
|
|
77
|
+
<main className="p-4">Main content</main>
|
|
78
|
+
</ResizablePanel>
|
|
79
|
+
</ResizablePanelGroup>
|
|
80
|
+
- title: "Split view with grip handle"
|
|
81
|
+
code: |
|
|
82
|
+
<ResizablePanelGroup orientation="horizontal">
|
|
83
|
+
<ResizablePanel defaultSize="360px" minSize="280px">
|
|
84
|
+
<ScrollArea className="h-full">List panel</ScrollArea>
|
|
85
|
+
</ResizablePanel>
|
|
86
|
+
<ResizableHandle withHandle />
|
|
87
|
+
<ResizablePanel>
|
|
88
|
+
<ScrollArea className="h-full"><div className="p-4">Detail panel</div></ScrollArea>
|
|
89
|
+
</ResizablePanel>
|
|
90
|
+
</ResizablePanelGroup>
|
|
91
|
+
- title: "Vertical split"
|
|
92
|
+
code: |
|
|
93
|
+
<ResizablePanelGroup orientation="vertical">
|
|
94
|
+
<ResizablePanel defaultSize="70%">
|
|
95
|
+
<div className="p-4">Top content</div>
|
|
96
|
+
</ResizablePanel>
|
|
97
|
+
<ResizableHandle />
|
|
98
|
+
<ResizablePanel defaultSize="30%" minSize="20%">
|
|
99
|
+
<div className="p-4">Bottom panel</div>
|
|
100
|
+
</ResizablePanel>
|
|
101
|
+
</ResizablePanelGroup>
|
|
102
|
+
anti_patterns:
|
|
103
|
+
- "Don't use bare numbers for defaultSize/minSize/maxSize — use strings with units ('220px', '30%')"
|
|
104
|
+
- "Don't wrap ResizableHandle outside of a ResizablePanelGroup — it must be a direct child"
|
|
105
|
+
- "Don't use Resizable for static layouts that don't need user-adjustable sizing"
|
|
106
|
+
- "Don't forget to set Sidebar className='w-full h-full' when placing it inside a ResizablePanel — the panel controls width"
|
|
107
|
+
accessibility_notes: "Built on react-resizable-panels — handles render role='separator' with aria-valuenow/min/max. Keyboard: Arrow keys adjust panel size, Home/End jump to min/max. Focus ring visible on handle."
|
|
108
|
+
notes: "Sub-components: ResizablePanelGroup (container with orientation), ResizablePanel (individual resizable region), ResizableHandle (drag separator between panels). Sizes accept strings with CSS units ('220px', '30%') or numbers for flex ratios. The library handles persistence via an optional autoSaveId prop on PanelGroup."
|
|
109
|
+
related_patterns:
|
|
110
|
+
- multi-pane
|
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
import {
|
|
3
|
+
Group,
|
|
4
|
+
Panel,
|
|
5
|
+
Separator,
|
|
6
|
+
useGroupRef,
|
|
7
|
+
usePanelRef,
|
|
8
|
+
type GroupProps,
|
|
9
|
+
type PanelImperativeHandle,
|
|
10
|
+
type PanelProps,
|
|
11
|
+
type SeparatorProps,
|
|
12
|
+
} from "react-resizable-panels";
|
|
13
|
+
|
|
14
|
+
import { cn } from "../../../lib/utils";
|
|
15
|
+
|
|
16
|
+
// --- ResizablePanelGroup ---
|
|
17
|
+
|
|
18
|
+
type ResizablePanelGroupProps = GroupProps;
|
|
19
|
+
|
|
20
|
+
// Bridge: an edge is grabbed 3px each side with a mouse (the library's 5px reached a pane's scrollbar beside it,
|
|
21
|
+
// research-070), 10px with a finger.
|
|
22
|
+
const hitArea = { coarse: 20, fine: 6 };
|
|
23
|
+
|
|
24
|
+
function ResizablePanelGroup({ className, ...props }: ResizablePanelGroupProps) {
|
|
25
|
+
return (
|
|
26
|
+
<Group
|
|
27
|
+
resizeTargetMinimumSize={hitArea}
|
|
28
|
+
data-slot="resizable-panel-group"
|
|
29
|
+
className={cn("flex h-full w-full", className)}
|
|
30
|
+
{...props}
|
|
31
|
+
/>
|
|
32
|
+
);
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
// --- ResizablePanel ---
|
|
36
|
+
|
|
37
|
+
type ResizablePanelProps = PanelProps;
|
|
38
|
+
|
|
39
|
+
// Bridge: the library's panel scrolls its content natively (`overflow: auto` on its inner box, the OS's scrollbar).
|
|
40
|
+
// A kit panel clips instead: what scrolls goes through the kit's ScrollArea (research-070).
|
|
41
|
+
function ResizablePanel({ style, ...props }: ResizablePanelProps) {
|
|
42
|
+
return <Panel data-slot="resizable-panel" style={{ overflow: "hidden", ...style }} {...props} />;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
// --- ResizableHandle ---
|
|
46
|
+
|
|
47
|
+
// Bridge: react-resizable-panels 4 marks a handle between stacked panels (a vertical group) aria-orientation="horizontal"
|
|
48
|
+
// (it has no data-orientation), a hovered one data-separator="hover" and a dragged one "active": the line, its hit area
|
|
49
|
+
// and the grip turn on them.
|
|
50
|
+
|
|
51
|
+
interface ResizableHandleProps extends Omit<SeparatorProps, "onDoubleClick"> {
|
|
52
|
+
/** Show a visible grip indicator on the handle */
|
|
53
|
+
withHandle?: boolean;
|
|
54
|
+
/** Replaces the library's own double-click (a panel back to its defaultSize), e.g. toggling two widths. */
|
|
55
|
+
onDoubleClick?: () => void;
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
function ResizableHandle({
|
|
59
|
+
className,
|
|
60
|
+
withHandle = false,
|
|
61
|
+
onDoubleClick,
|
|
62
|
+
...props
|
|
63
|
+
}: ResizableHandleProps) {
|
|
64
|
+
const element = React.useRef<HTMLDivElement | null>(null);
|
|
65
|
+
const handler = React.useRef(onDoubleClick);
|
|
66
|
+
handler.current = onDoubleClick;
|
|
67
|
+
const handles = onDoubleClick !== undefined;
|
|
68
|
+
// react-resizable-panels resets a panel on a double-click from a document capture listener, before React hears it:
|
|
69
|
+
// a window capture listener runs first, and its preventDefault makes the library leave the panel alone.
|
|
70
|
+
React.useEffect(() => {
|
|
71
|
+
if (!handles) return;
|
|
72
|
+
const listen = (event: MouseEvent) => {
|
|
73
|
+
if (!(event.target instanceof Node) || !element.current?.contains(event.target)) return;
|
|
74
|
+
event.preventDefault();
|
|
75
|
+
handler.current?.();
|
|
76
|
+
};
|
|
77
|
+
window.addEventListener("dblclick", listen, true);
|
|
78
|
+
return () => window.removeEventListener("dblclick", listen, true);
|
|
79
|
+
}, [handles]);
|
|
80
|
+
return (
|
|
81
|
+
<Separator
|
|
82
|
+
elementRef={element}
|
|
83
|
+
data-slot="resizable-handle"
|
|
84
|
+
className={cn(
|
|
85
|
+
// The 1px divider; its hit area (`after`) 5px wide, clear of a pane's scrollbar beside it (3px off the edge).
|
|
86
|
+
"relative z-10 flex w-px items-center justify-center bg-border after:absolute after:inset-y-0 after:-left-[2px] after:-right-[2px] focus-visible:outline-none",
|
|
87
|
+
// As the sidebar's edge (SidebarResizeHandle): a 4px grey line on hover and keyboard focus, darker while
|
|
88
|
+
// dragged; never the accent.
|
|
89
|
+
"before:absolute before:inset-y-0 before:left-1/2 before:w-[4px] before:-translate-x-1/2 before:bg-transparent before:transition-colors before:duration-100 data-[separator=hover]:before:bg-border focus-visible:before:bg-border data-[separator=active]:before:bg-muted/40",
|
|
90
|
+
"[&[aria-orientation=horizontal]]:h-px [&[aria-orientation=horizontal]]:w-full [&[aria-orientation=horizontal]]:after:inset-x-0 [&[aria-orientation=horizontal]]:after:-top-[2px] [&[aria-orientation=horizontal]]:after:-bottom-[2px]",
|
|
91
|
+
"[&[aria-orientation=horizontal]]:before:inset-x-0 [&[aria-orientation=horizontal]]:before:inset-y-auto [&[aria-orientation=horizontal]]:before:top-1/2 [&[aria-orientation=horizontal]]:before:h-[4px] [&[aria-orientation=horizontal]]:before:w-full [&[aria-orientation=horizontal]]:before:translate-x-0 [&[aria-orientation=horizontal]]:before:-translate-y-1/2",
|
|
92
|
+
className,
|
|
93
|
+
)}
|
|
94
|
+
{...props}
|
|
95
|
+
>
|
|
96
|
+
{withHandle && (
|
|
97
|
+
<div className="z-10 flex h-4 w-3 items-center justify-center rounded-sm border border-border bg-border [[aria-orientation=horizontal]_&]:h-3 [[aria-orientation=horizontal]_&]:w-4">
|
|
98
|
+
<svg
|
|
99
|
+
xmlns="http://www.w3.org/2000/svg"
|
|
100
|
+
viewBox="0 0 6 14"
|
|
101
|
+
fill="currentColor"
|
|
102
|
+
className="size-2.5 text-muted [[aria-orientation=horizontal]_&]:rotate-90"
|
|
103
|
+
>
|
|
104
|
+
<circle cx="1.5" cy="3" r="0.75" />
|
|
105
|
+
<circle cx="4.5" cy="3" r="0.75" />
|
|
106
|
+
<circle cx="1.5" cy="7" r="0.75" />
|
|
107
|
+
<circle cx="4.5" cy="7" r="0.75" />
|
|
108
|
+
<circle cx="1.5" cy="11" r="0.75" />
|
|
109
|
+
<circle cx="4.5" cy="11" r="0.75" />
|
|
110
|
+
</svg>
|
|
111
|
+
</div>
|
|
112
|
+
)}
|
|
113
|
+
</Separator>
|
|
114
|
+
);
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
// `usePanelRef`: a panel's handle for its `panelRef` (getSize, resize), e.g. a double-click on the handle toggling widths.
|
|
118
|
+
// `useGroupRef`: a group's handle for its `groupRef` (getLayout, setLayout), e.g. another tab's kept sizes.
|
|
119
|
+
export { ResizablePanelGroup, ResizablePanel, ResizableHandle, useGroupRef, usePanelRef };
|
|
120
|
+
export type {
|
|
121
|
+
PanelImperativeHandle,
|
|
122
|
+
ResizablePanelGroupProps,
|
|
123
|
+
ResizablePanelProps,
|
|
124
|
+
ResizableHandleProps,
|
|
125
|
+
};
|