@bridgebrew/ui 0.0.0-stage → 0.1.10-next.79
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,88 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
import { cva, type VariantProps } from "class-variance-authority";
|
|
3
|
+
|
|
4
|
+
import { useRender } from "@base-ui/react/use-render";
|
|
5
|
+
|
|
6
|
+
import { cn } from "../../../lib/utils";
|
|
7
|
+
import { Badge } from "../../core/badge/badge";
|
|
8
|
+
|
|
9
|
+
// --- SidebarItem ---
|
|
10
|
+
|
|
11
|
+
const sidebarItemVariants = cva(
|
|
12
|
+
"flex items-center gap-2 px-1.5 h-(--height-md) rounded-control text-sm text-secondary cursor-pointer border-0 bg-transparent w-full text-left no-underline transition-[background,color] duration-100",
|
|
13
|
+
{
|
|
14
|
+
variants: {
|
|
15
|
+
active: {
|
|
16
|
+
true: "bg-active text-foreground font-medium",
|
|
17
|
+
false: "hover:bg-hover hover:text-foreground",
|
|
18
|
+
},
|
|
19
|
+
},
|
|
20
|
+
defaultVariants: { active: false },
|
|
21
|
+
},
|
|
22
|
+
);
|
|
23
|
+
|
|
24
|
+
interface SidebarItemProps
|
|
25
|
+
extends Omit<React.ComponentProps<"button">, "color">, VariantProps<typeof sidebarItemVariants> {
|
|
26
|
+
/** Replace the rendered element (for router links, etc.), e.g. render={<a href="…" />} */
|
|
27
|
+
render?: useRender.RenderProp;
|
|
28
|
+
/** Optional icon displayed before label */
|
|
29
|
+
icon?: React.ReactNode;
|
|
30
|
+
/** Optional count displayed as Badge on the right */
|
|
31
|
+
count?: number;
|
|
32
|
+
/** Optional team dot color (hex string) */
|
|
33
|
+
teamDot?: string;
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
function SidebarItem({
|
|
37
|
+
className,
|
|
38
|
+
children,
|
|
39
|
+
icon,
|
|
40
|
+
count,
|
|
41
|
+
teamDot,
|
|
42
|
+
active,
|
|
43
|
+
render,
|
|
44
|
+
ref,
|
|
45
|
+
...props
|
|
46
|
+
}: SidebarItemProps) {
|
|
47
|
+
return useRender({
|
|
48
|
+
// Default to a plain <button /> render element instead of Base UI's
|
|
49
|
+
// defaultTagName path, which injects type="button" — the pre-migration
|
|
50
|
+
// <button> was implicitly type="submit" inside forms.
|
|
51
|
+
render: render ?? <button />,
|
|
52
|
+
ref: ref as React.Ref<HTMLButtonElement>,
|
|
53
|
+
props: {
|
|
54
|
+
"data-slot": "sidebar-item",
|
|
55
|
+
className: cn(sidebarItemVariants({ active, className })),
|
|
56
|
+
...props,
|
|
57
|
+
// When a custom element is rendered, pass children through untouched
|
|
58
|
+
// (the render path intentionally skips icon/count/teamDot decorations).
|
|
59
|
+
children: render ? (
|
|
60
|
+
children
|
|
61
|
+
) : (
|
|
62
|
+
<>
|
|
63
|
+
{teamDot && (
|
|
64
|
+
<span
|
|
65
|
+
data-slot="sidebar-team-dot"
|
|
66
|
+
className="size-2 rounded-full shrink-0"
|
|
67
|
+
style={{ background: teamDot }}
|
|
68
|
+
/>
|
|
69
|
+
)}
|
|
70
|
+
{icon && (
|
|
71
|
+
<span data-slot="sidebar-item-icon" className="text-muted shrink-0">
|
|
72
|
+
{icon}
|
|
73
|
+
</span>
|
|
74
|
+
)}
|
|
75
|
+
{children}
|
|
76
|
+
{count !== undefined && (
|
|
77
|
+
<span className="ml-auto">
|
|
78
|
+
<Badge>{count}</Badge>
|
|
79
|
+
</span>
|
|
80
|
+
)}
|
|
81
|
+
</>
|
|
82
|
+
),
|
|
83
|
+
},
|
|
84
|
+
});
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
export { SidebarItem, sidebarItemVariants };
|
|
88
|
+
export type { SidebarItemProps };
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
|
|
3
|
+
import { cn } from "../../../lib/utils";
|
|
4
|
+
|
|
5
|
+
// --- SidebarResizeHandle ---
|
|
6
|
+
|
|
7
|
+
const SIDEBAR_MIN_WIDTH = 190;
|
|
8
|
+
const SIDEBAR_DEFAULT_WIDTH = 220;
|
|
9
|
+
/** Half the viewport, never under the minimum. */
|
|
10
|
+
const sidebarMaxWidth = () => Math.max(SIDEBAR_MIN_WIDTH, Math.floor(window.innerWidth / 2));
|
|
11
|
+
const clampSidebarWidth = (width: number) =>
|
|
12
|
+
Math.min(sidebarMaxWidth(), Math.max(SIDEBAR_MIN_WIDTH, Math.round(width)));
|
|
13
|
+
|
|
14
|
+
interface SidebarResizeHandleProps extends Omit<React.ComponentProps<"div">, "children"> {
|
|
15
|
+
/** The sidebar's width in px (a Sidebar reads it from `--sidebar-width`). */
|
|
16
|
+
width: number;
|
|
17
|
+
/** Called with the next width, already clamped: while dragging, per key, on double-click. */
|
|
18
|
+
onWidthChange: (width: number) => void;
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
/** An 8px vertical separator on the sidebar's right edge: drag it (pointer capture), ArrowLeft/Right
|
|
22
|
+
* by 8px, double-click for the default width; clamped between 190px and half the viewport. Place it
|
|
23
|
+
* absolutely in a positioned container whose left edge is the sidebar's: the width is the pointer's
|
|
24
|
+
* x minus that edge. */
|
|
25
|
+
function SidebarResizeHandle({
|
|
26
|
+
width,
|
|
27
|
+
onWidthChange,
|
|
28
|
+
className,
|
|
29
|
+
style,
|
|
30
|
+
...props
|
|
31
|
+
}: SidebarResizeHandleProps) {
|
|
32
|
+
const [dragging, setDragging] = React.useState(false);
|
|
33
|
+
// While dragging, the whole page keeps the resize cursor and selects no text.
|
|
34
|
+
React.useEffect(() => {
|
|
35
|
+
if (!dragging) return;
|
|
36
|
+
const root = document.documentElement.style;
|
|
37
|
+
root.setProperty("cursor", "col-resize");
|
|
38
|
+
root.setProperty("user-select", "none");
|
|
39
|
+
return () => {
|
|
40
|
+
root.removeProperty("cursor");
|
|
41
|
+
root.removeProperty("user-select");
|
|
42
|
+
};
|
|
43
|
+
}, [dragging]);
|
|
44
|
+
const fromPointer = (event: React.PointerEvent<HTMLDivElement>) => {
|
|
45
|
+
const container = event.currentTarget.offsetParent;
|
|
46
|
+
onWidthChange(
|
|
47
|
+
clampSidebarWidth(event.clientX - (container?.getBoundingClientRect().left ?? 0)),
|
|
48
|
+
);
|
|
49
|
+
};
|
|
50
|
+
const stop = (event: React.PointerEvent<HTMLDivElement>) => {
|
|
51
|
+
if (event.currentTarget.hasPointerCapture(event.pointerId))
|
|
52
|
+
event.currentTarget.releasePointerCapture(event.pointerId);
|
|
53
|
+
setDragging(false);
|
|
54
|
+
};
|
|
55
|
+
return (
|
|
56
|
+
<div
|
|
57
|
+
data-slot="sidebar-resize-handle"
|
|
58
|
+
data-dragging={dragging || undefined}
|
|
59
|
+
role="separator"
|
|
60
|
+
aria-label="Resize sidebar"
|
|
61
|
+
aria-orientation="vertical"
|
|
62
|
+
aria-valuemin={SIDEBAR_MIN_WIDTH}
|
|
63
|
+
aria-valuemax={sidebarMaxWidth()}
|
|
64
|
+
aria-valuenow={width}
|
|
65
|
+
tabIndex={0}
|
|
66
|
+
className={cn(
|
|
67
|
+
"absolute inset-y-0 z-20 w-2 cursor-col-resize touch-none outline-none",
|
|
68
|
+
// The 2px line: on hover and keyboard focus, stronger while dragging.
|
|
69
|
+
"after:absolute after:inset-y-0 after:left-[2px] after:w-[4px] after:bg-transparent after:transition-colors after:duration-100",
|
|
70
|
+
"hover:after:bg-border focus-visible:after:bg-border data-[dragging]:after:bg-muted/40",
|
|
71
|
+
className,
|
|
72
|
+
)}
|
|
73
|
+
// Centred on the sidebar's right border (the aside's, 1px past `width`).
|
|
74
|
+
style={{ left: width - 3, ...style }}
|
|
75
|
+
onDoubleClick={() => onWidthChange(clampSidebarWidth(SIDEBAR_DEFAULT_WIDTH))}
|
|
76
|
+
onKeyDown={(event) => {
|
|
77
|
+
if (event.key !== "ArrowLeft" && event.key !== "ArrowRight") return;
|
|
78
|
+
event.preventDefault();
|
|
79
|
+
onWidthChange(clampSidebarWidth(width + (event.key === "ArrowLeft" ? -8 : 8)));
|
|
80
|
+
}}
|
|
81
|
+
onPointerDown={(event) => {
|
|
82
|
+
event.preventDefault();
|
|
83
|
+
event.currentTarget.setPointerCapture(event.pointerId);
|
|
84
|
+
setDragging(true);
|
|
85
|
+
}}
|
|
86
|
+
onPointerMove={(event) => {
|
|
87
|
+
if (event.currentTarget.hasPointerCapture(event.pointerId)) fromPointer(event);
|
|
88
|
+
}}
|
|
89
|
+
onPointerUp={(event) => {
|
|
90
|
+
if (event.currentTarget.hasPointerCapture(event.pointerId)) fromPointer(event);
|
|
91
|
+
stop(event);
|
|
92
|
+
}}
|
|
93
|
+
onPointerCancel={stop}
|
|
94
|
+
onLostPointerCapture={() => setDragging(false)}
|
|
95
|
+
{...props}
|
|
96
|
+
/>
|
|
97
|
+
);
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
export { SidebarResizeHandle, SIDEBAR_MIN_WIDTH, SIDEBAR_DEFAULT_WIDTH, clampSidebarWidth };
|
|
101
|
+
export type { SidebarResizeHandleProps };
|
|
@@ -0,0 +1,325 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
|
|
3
|
+
import { cn } from "../../../lib/utils";
|
|
4
|
+
import { SidebarChevron, SidebarCollapse, SidebarTrailing, renders } from "./sidebar-group";
|
|
5
|
+
import { sidebarItemVariants } from "./sidebar-item";
|
|
6
|
+
|
|
7
|
+
// --- SidebarTree ---
|
|
8
|
+
|
|
9
|
+
/** The rows of `tree` a user can reach: none inside a closed SidebarCollapse (it is inert). */
|
|
10
|
+
const visibleItems = (tree: Element) =>
|
|
11
|
+
[...tree.querySelectorAll<HTMLElement>('[role="treeitem"]')].filter(
|
|
12
|
+
(item) => !item.closest("[inert]"),
|
|
13
|
+
);
|
|
14
|
+
|
|
15
|
+
const TreeVariant = React.createContext<"default" | "navigation">("default");
|
|
16
|
+
const TreeIndent = React.createContext(12);
|
|
17
|
+
/** The depth of the row whose `guide` ties these children to it; none when it draws no guide. */
|
|
18
|
+
const GuidedBy = React.createContext<number | undefined>(undefined);
|
|
19
|
+
|
|
20
|
+
interface SidebarTreeProps extends React.ComponentProps<"div"> {
|
|
21
|
+
/** Navigation: rows of text (after their icon, when given), permanent chevrons on the right, and hierarchy guides. */
|
|
22
|
+
variant?: "default" | "navigation";
|
|
23
|
+
/** The indent of a level, 12px by default (wider for a phone's larger icons). */
|
|
24
|
+
indent?: number;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
/** A navigation tree of SidebarTreeItem rows (`role="tree"`; name it with `aria-label`) with one tab
|
|
28
|
+
* stop: the row last focused, else the active one (a new active row takes the stop), else the first
|
|
29
|
+
* row shown. The rows handle the arrow keys. */
|
|
30
|
+
function SidebarTree({ className, variant = "default", indent = 12, ...props }: SidebarTreeProps) {
|
|
31
|
+
const ref = React.useRef<HTMLDivElement>(null);
|
|
32
|
+
const focused = React.useRef<Element | null>(null);
|
|
33
|
+
const active = React.useRef<Element | null>(null);
|
|
34
|
+
// Tab stops set on the DOM, never by React: a render leaves them alone.
|
|
35
|
+
const rove = () => {
|
|
36
|
+
const tree = ref.current;
|
|
37
|
+
if (!tree) return;
|
|
38
|
+
const current = tree.querySelector('[role="treeitem"][aria-current]');
|
|
39
|
+
if (current !== active.current) {
|
|
40
|
+
active.current = current;
|
|
41
|
+
if (current) focused.current = current;
|
|
42
|
+
}
|
|
43
|
+
const shown = visibleItems(tree);
|
|
44
|
+
const stop =
|
|
45
|
+
shown.find((item) => item === focused.current) ??
|
|
46
|
+
shown.find((item) => item === current) ??
|
|
47
|
+
shown[0];
|
|
48
|
+
for (const item of tree.querySelectorAll<HTMLElement>('[role="treeitem"]'))
|
|
49
|
+
item.tabIndex = item === stop ? 0 : -1;
|
|
50
|
+
};
|
|
51
|
+
React.useLayoutEffect(rove);
|
|
52
|
+
return (
|
|
53
|
+
<TreeVariant.Provider value={variant}>
|
|
54
|
+
<TreeIndent.Provider value={indent}>
|
|
55
|
+
<div
|
|
56
|
+
data-slot="sidebar-tree"
|
|
57
|
+
data-variant={variant}
|
|
58
|
+
role="tree"
|
|
59
|
+
className={cn("flex flex-col gap-px", className)}
|
|
60
|
+
{...props}
|
|
61
|
+
ref={ref}
|
|
62
|
+
onFocus={(event) => {
|
|
63
|
+
props.onFocus?.(event);
|
|
64
|
+
if (event.target.getAttribute("role") !== "treeitem") return;
|
|
65
|
+
focused.current = event.target;
|
|
66
|
+
rove();
|
|
67
|
+
}}
|
|
68
|
+
/>
|
|
69
|
+
</TreeIndent.Provider>
|
|
70
|
+
</TreeVariant.Provider>
|
|
71
|
+
);
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
// --- SidebarTreeItem ---
|
|
75
|
+
|
|
76
|
+
interface SidebarTreeItemProps extends Omit<React.ComponentProps<"div">, "onSelect"> {
|
|
77
|
+
/** The item's title; also names its toggle ("Toggle <label>"). */
|
|
78
|
+
label: string;
|
|
79
|
+
/** Shown before the label. With children, the chevron takes its place on hover and keyboard focus,
|
|
80
|
+
* and always where nothing can hover (touch screens). */
|
|
81
|
+
icon?: React.ReactNode;
|
|
82
|
+
/** Nesting level, 0 at the top; 12px of indent a level (the tree's `indent`). */
|
|
83
|
+
depth?: number;
|
|
84
|
+
active?: boolean | undefined;
|
|
85
|
+
/** Set when the item has children: whether they show. Leave undefined for a leaf. */
|
|
86
|
+
expanded?: boolean | undefined;
|
|
87
|
+
onExpandedChange?: (expanded: boolean) => void;
|
|
88
|
+
/** Clicking the row anywhere but the toggle, or Enter/Space on the focused item: the item itself
|
|
89
|
+
* is selectable, children or not. */
|
|
90
|
+
onSelect?: () => void;
|
|
91
|
+
/** Shown at the right end, outside the label (a count, a status icon): the item's description.
|
|
92
|
+
* Non-interactive: it sits in the clickable row. */
|
|
93
|
+
trailing?: React.ReactNode;
|
|
94
|
+
/** The children rows (SidebarTreeItems at `depth + 1`), in a `group` that opens and closes with `expanded`. */
|
|
95
|
+
children?: React.ReactNode;
|
|
96
|
+
/** Lines from this row's icon to each of its children (a branch into each, rounded on the last), saying they belong
|
|
97
|
+
* to it (without it, the `navigation` variant draws a straight line of its own). */
|
|
98
|
+
guide?: boolean;
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
/** One `treeitem` of a SidebarTree: its row (the icon or, with children, a toggle; the label) and its
|
|
102
|
+
* children rows. The item is the focus target (the row's two buttons are for the mouse only):
|
|
103
|
+
* Up/Down move across the rows shown, Home/End to the first/last, Right opens or moves to the first
|
|
104
|
+
* child, Left closes or moves to the parent, Enter/Space select as a row click does. */
|
|
105
|
+
function SidebarTreeItem({
|
|
106
|
+
className,
|
|
107
|
+
style,
|
|
108
|
+
label,
|
|
109
|
+
icon,
|
|
110
|
+
depth = 0,
|
|
111
|
+
active = false,
|
|
112
|
+
expanded,
|
|
113
|
+
onExpandedChange,
|
|
114
|
+
onSelect,
|
|
115
|
+
onClick,
|
|
116
|
+
trailing,
|
|
117
|
+
children,
|
|
118
|
+
guide = false,
|
|
119
|
+
...props
|
|
120
|
+
}: SidebarTreeItemProps) {
|
|
121
|
+
const navigation = React.useContext(TreeVariant) === "navigation";
|
|
122
|
+
const guidedBy = React.useContext(GuidedBy);
|
|
123
|
+
const step = React.useContext(TreeIndent);
|
|
124
|
+
/** Where the parent's guide runs: under its icon, a little left of its middle, so each branch shows. */
|
|
125
|
+
// In `navigation` (its chevrons on the right), centred under the icon: nothing there for the branches to show past.
|
|
126
|
+
const guideX = guidedBy === undefined ? 0 : 6 + step * guidedBy + (navigation ? 7.5 : 5.5);
|
|
127
|
+
const iconBox = "size-4 flex items-center justify-center shrink-0 text-muted";
|
|
128
|
+
const labelId = React.useId();
|
|
129
|
+
const trailingId = React.useId();
|
|
130
|
+
const end = renders(trailing);
|
|
131
|
+
const item = React.useRef<HTMLDivElement>(null);
|
|
132
|
+
const onKeyDown = (event: React.KeyboardEvent<HTMLDivElement>) => {
|
|
133
|
+
if (event.target !== event.currentTarget) return; // a descendant item's key
|
|
134
|
+
const tree = event.currentTarget.closest('[role="tree"]');
|
|
135
|
+
const shown = tree ? visibleItems(tree) : [event.currentTarget];
|
|
136
|
+
const at = shown.indexOf(event.currentTarget);
|
|
137
|
+
const focus = (to: HTMLElement | null | undefined) => to?.focus();
|
|
138
|
+
switch (event.key) {
|
|
139
|
+
case "ArrowDown":
|
|
140
|
+
focus(shown[at + 1]);
|
|
141
|
+
break;
|
|
142
|
+
case "ArrowUp":
|
|
143
|
+
focus(shown[at - 1]);
|
|
144
|
+
break;
|
|
145
|
+
case "Home":
|
|
146
|
+
focus(shown[0]);
|
|
147
|
+
break;
|
|
148
|
+
case "End":
|
|
149
|
+
focus(shown.at(-1));
|
|
150
|
+
break;
|
|
151
|
+
// Open, the next row shown is its first child.
|
|
152
|
+
case "ArrowRight":
|
|
153
|
+
if (expanded === false) onExpandedChange?.(true);
|
|
154
|
+
else if (expanded) focus(shown[at + 1]);
|
|
155
|
+
break;
|
|
156
|
+
case "ArrowLeft":
|
|
157
|
+
if (expanded) onExpandedChange?.(false);
|
|
158
|
+
else focus(event.currentTarget.parentElement?.closest<HTMLElement>('[role="treeitem"]'));
|
|
159
|
+
break;
|
|
160
|
+
case "Enter":
|
|
161
|
+
case " ":
|
|
162
|
+
onSelect?.();
|
|
163
|
+
break;
|
|
164
|
+
default:
|
|
165
|
+
return;
|
|
166
|
+
}
|
|
167
|
+
event.preventDefault();
|
|
168
|
+
};
|
|
169
|
+
return (
|
|
170
|
+
<div
|
|
171
|
+
ref={item}
|
|
172
|
+
data-slot="sidebar-tree-node"
|
|
173
|
+
role="treeitem"
|
|
174
|
+
// Named by its label (not the toggle's "Toggle …", nor the children's), described by its trailing content.
|
|
175
|
+
aria-labelledby={labelId}
|
|
176
|
+
aria-describedby={end ? trailingId : undefined}
|
|
177
|
+
aria-level={depth + 1}
|
|
178
|
+
aria-expanded={expanded}
|
|
179
|
+
aria-current={active ? "page" : undefined}
|
|
180
|
+
className={cn(
|
|
181
|
+
"outline-none [&:focus-visible>[data-slot=sidebar-tree-item]]:ring-2 [&:focus-visible>[data-slot=sidebar-tree-item]]:ring-accent [&:focus-visible>[data-slot=sidebar-tree-item]]:ring-inset",
|
|
182
|
+
guidedBy !== undefined && "group/guided relative",
|
|
183
|
+
)}
|
|
184
|
+
onKeyDown={onKeyDown}
|
|
185
|
+
>
|
|
186
|
+
{guidedBy !== undefined && (
|
|
187
|
+
<>
|
|
188
|
+
{/* The parent's guide past this row, down to the next sibling; none after the last. */}
|
|
189
|
+
<span
|
|
190
|
+
data-slot="sidebar-tree-guide"
|
|
191
|
+
aria-hidden="true"
|
|
192
|
+
className="pointer-events-none absolute top-0 bottom-0 border-l border-border group-first/guided:-top-1.5 group-last/guided:hidden"
|
|
193
|
+
style={{ left: guideX }}
|
|
194
|
+
/>
|
|
195
|
+
{/* Its branch: down to this row's middle, then into it; rounded on the last. */}
|
|
196
|
+
<span
|
|
197
|
+
data-slot="sidebar-tree-branch"
|
|
198
|
+
aria-hidden="true"
|
|
199
|
+
// The first starts under the parent's icon.
|
|
200
|
+
className="pointer-events-none absolute top-0 h-[calc(var(--height-md)/2)] border-b border-l border-border group-first/guided:-top-1.5 group-first/guided:h-[calc(var(--height-md)/2+6px)] group-last/guided:rounded-bl-[4px]"
|
|
201
|
+
style={{ left: guideX, width: 6 + step * depth - guideX - 0.5 }}
|
|
202
|
+
/>
|
|
203
|
+
</>
|
|
204
|
+
)}
|
|
205
|
+
<div
|
|
206
|
+
data-slot="sidebar-tree-item"
|
|
207
|
+
data-variant={navigation ? "navigation" : "default"}
|
|
208
|
+
className={cn(
|
|
209
|
+
sidebarItemVariants({ active }),
|
|
210
|
+
"group/tree-item cursor-default",
|
|
211
|
+
navigation && "h-9 rounded-control",
|
|
212
|
+
className,
|
|
213
|
+
)}
|
|
214
|
+
// 6px (the item rail) plus 12px a level: every level shows, four fit the 220px sidebar.
|
|
215
|
+
style={{ paddingLeft: 6 + step * depth, ...style }}
|
|
216
|
+
{...props}
|
|
217
|
+
// A press anywhere on the row focuses the item, not a button: the arrow keys work from there.
|
|
218
|
+
// Without scrolling: the row moving under the pointer would lose the click. In a draggable row (a navigator
|
|
219
|
+
// that moves nodes by dragging them) the press is left to the browser, which starts the drag from it.
|
|
220
|
+
// Without the focus ring: a scripted focus would take `:focus-visible` from the previous focus (a text
|
|
221
|
+
// field, another row), so a click would draw the keyboard ring (#187).
|
|
222
|
+
onMouseDown={(event) => {
|
|
223
|
+
props.onMouseDown?.(event);
|
|
224
|
+
if (!event.currentTarget.closest('[draggable="true"]')) event.preventDefault();
|
|
225
|
+
item.current?.focus({ preventScroll: true, focusVisible: false });
|
|
226
|
+
}}
|
|
227
|
+
// The label button bubbles here too, so a click on it counts once. A consumer's `onClick` runs
|
|
228
|
+
// first and can keep the selection from happening with `preventDefault()`.
|
|
229
|
+
onClick={(event) => {
|
|
230
|
+
// In a draggable row the browser's own press moved the focus elsewhere: back on the item, ring-less.
|
|
231
|
+
if (event.currentTarget.closest('[draggable="true"]'))
|
|
232
|
+
item.current?.focus({ preventScroll: true, focusVisible: false });
|
|
233
|
+
onClick?.(event);
|
|
234
|
+
if (!event.defaultPrevented) onSelect?.();
|
|
235
|
+
}}
|
|
236
|
+
>
|
|
237
|
+
{!navigation &&
|
|
238
|
+
(expanded === undefined ? (
|
|
239
|
+
<span data-slot="sidebar-item-icon" className={iconBox}>
|
|
240
|
+
{icon}
|
|
241
|
+
</span>
|
|
242
|
+
) : (
|
|
243
|
+
<button
|
|
244
|
+
type="button"
|
|
245
|
+
tabIndex={-1}
|
|
246
|
+
data-slot="sidebar-tree-toggle"
|
|
247
|
+
className={cn(iconBox, "rounded-sm cursor-pointer hover:text-foreground")}
|
|
248
|
+
aria-label={`Toggle ${label}`}
|
|
249
|
+
onClick={(event) => {
|
|
250
|
+
event.stopPropagation(); // toggling only, not selecting
|
|
251
|
+
onExpandedChange?.(!expanded);
|
|
252
|
+
}}
|
|
253
|
+
>
|
|
254
|
+
<span
|
|
255
|
+
data-slot="sidebar-item-icon"
|
|
256
|
+
// On hover, on the item's own keyboard focus (not a descendant item's), and on touch screens.
|
|
257
|
+
className="flex group-hover/tree-item:hidden [:focus-visible>[data-slot=sidebar-tree-item]_&]:hidden [@media(hover:none)]:hidden"
|
|
258
|
+
>
|
|
259
|
+
{icon}
|
|
260
|
+
</span>
|
|
261
|
+
<span
|
|
262
|
+
data-slot="expand-toggle"
|
|
263
|
+
className="hidden group-hover/tree-item:flex [:focus-visible>[data-slot=sidebar-tree-item]_&]:flex [@media(hover:none)]:flex"
|
|
264
|
+
>
|
|
265
|
+
<SidebarChevron expanded={expanded} />
|
|
266
|
+
</span>
|
|
267
|
+
</button>
|
|
268
|
+
))}
|
|
269
|
+
{navigation && icon !== undefined && (
|
|
270
|
+
<span data-slot="sidebar-item-icon" className={iconBox}>
|
|
271
|
+
{icon}
|
|
272
|
+
</span>
|
|
273
|
+
)}
|
|
274
|
+
<button
|
|
275
|
+
id={labelId}
|
|
276
|
+
type="button"
|
|
277
|
+
tabIndex={-1}
|
|
278
|
+
data-slot="sidebar-tree-label"
|
|
279
|
+
className="min-w-0 flex-1 truncate text-left cursor-pointer"
|
|
280
|
+
>
|
|
281
|
+
{label}
|
|
282
|
+
</button>
|
|
283
|
+
{end && <SidebarTrailing id={trailingId}>{trailing}</SidebarTrailing>}
|
|
284
|
+
{/* A leaf keeps the chevron's place: every row's trailing content in one column. */}
|
|
285
|
+
{navigation && expanded === undefined && <span aria-hidden="true" className={iconBox} />}
|
|
286
|
+
{navigation && expanded !== undefined && (
|
|
287
|
+
<button
|
|
288
|
+
type="button"
|
|
289
|
+
tabIndex={-1}
|
|
290
|
+
data-slot="sidebar-tree-toggle"
|
|
291
|
+
className={cn(iconBox, "rounded-sm cursor-pointer hover:text-foreground")}
|
|
292
|
+
aria-label={`Toggle ${label}`}
|
|
293
|
+
onClick={(event) => {
|
|
294
|
+
event.stopPropagation();
|
|
295
|
+
onExpandedChange?.(!expanded);
|
|
296
|
+
}}
|
|
297
|
+
>
|
|
298
|
+
<SidebarChevron expanded={expanded} />
|
|
299
|
+
</button>
|
|
300
|
+
)}
|
|
301
|
+
</div>
|
|
302
|
+
{children !== undefined && expanded !== undefined && (
|
|
303
|
+
<SidebarCollapse
|
|
304
|
+
role="group"
|
|
305
|
+
open={expanded}
|
|
306
|
+
className={navigation ? "relative" : undefined}
|
|
307
|
+
>
|
|
308
|
+
{navigation && !guide && (
|
|
309
|
+
<span
|
|
310
|
+
data-slot="sidebar-tree-guide"
|
|
311
|
+
aria-hidden="true"
|
|
312
|
+
className="absolute inset-y-0 border-l border-border pointer-events-none"
|
|
313
|
+
// Under the row's text, or the middle of its icon when it has one (its 16px box, less half the line).
|
|
314
|
+
style={{ left: 6 + step * depth + (icon === undefined ? 0 : 7.5) }}
|
|
315
|
+
/>
|
|
316
|
+
)}
|
|
317
|
+
<GuidedBy.Provider value={guide ? depth : undefined}>{children}</GuidedBy.Provider>
|
|
318
|
+
</SidebarCollapse>
|
|
319
|
+
)}
|
|
320
|
+
</div>
|
|
321
|
+
);
|
|
322
|
+
}
|
|
323
|
+
|
|
324
|
+
export { SidebarTree, SidebarTreeItem };
|
|
325
|
+
export type { SidebarTreeProps, SidebarTreeItemProps };
|
|
@@ -0,0 +1,126 @@
|
|
|
1
|
+
name: Sidebar
|
|
2
|
+
description: "Full-height primary navigation with treeview support, collapsible sections, team indicators, and badge counts. 220px wide unless `--sidebar-width` says otherwise (SidebarResizeHandle). In a constrained-height parent such as AppShell, SidebarContent scrolls independently while SidebarFooter stays pinned."
|
|
3
|
+
layer: shell
|
|
4
|
+
category: navigation
|
|
5
|
+
when_to_use:
|
|
6
|
+
- "For primary app navigation with hierarchical sections"
|
|
7
|
+
- "For sidebar menus with collapsible groups and team indicators"
|
|
8
|
+
- "For navigation items with icons, counts, and active state"
|
|
9
|
+
when_not_to_use:
|
|
10
|
+
- "For secondary navigation — use Tabs or Breadcrumb"
|
|
11
|
+
- "For contextual menus — use DropdownMenu"
|
|
12
|
+
- "For mobile-only navigation — Sidebar is desktop-first, 220px by default"
|
|
13
|
+
composition_partners:
|
|
14
|
+
- AppShell (as sidebar prop)
|
|
15
|
+
- Badge (rendered via count prop on SidebarItem)
|
|
16
|
+
- Avatar (as icon in SidebarItem)
|
|
17
|
+
props:
|
|
18
|
+
- name: active
|
|
19
|
+
type: boolean
|
|
20
|
+
required: false
|
|
21
|
+
default: "false"
|
|
22
|
+
description: "Whether the sidebar item is currently active (SidebarItem only)"
|
|
23
|
+
- name: render
|
|
24
|
+
type: "ReactElement | (props, state) => ReactElement"
|
|
25
|
+
required: false
|
|
26
|
+
description: "Replace the rendered element for router link integration, e.g. render={<Link to=… />} (SidebarItem only). NOTE: render replaces the item's internal layout — icon, count and teamDot are ignored; provide your own children."
|
|
27
|
+
- name: icon
|
|
28
|
+
type: React.ReactNode
|
|
29
|
+
required: false
|
|
30
|
+
description: "Icon displayed before the label (SidebarItem only)"
|
|
31
|
+
- name: count
|
|
32
|
+
type: number
|
|
33
|
+
required: false
|
|
34
|
+
description: "Count displayed as Badge on the right (SidebarItem only)"
|
|
35
|
+
- name: teamDot
|
|
36
|
+
type: string
|
|
37
|
+
required: false
|
|
38
|
+
description: "Hex color for team dot indicator (SidebarItem and SidebarGroupTrigger)"
|
|
39
|
+
- name: defaultExpanded
|
|
40
|
+
type: boolean
|
|
41
|
+
required: false
|
|
42
|
+
default: "true"
|
|
43
|
+
description: "Initial expanded state for uncontrolled groups (SidebarGroup only)"
|
|
44
|
+
- name: expanded
|
|
45
|
+
type: boolean
|
|
46
|
+
required: false
|
|
47
|
+
description: "Controlled expanded state (SidebarGroup only)"
|
|
48
|
+
- name: onExpandedChange
|
|
49
|
+
type: "(expanded: boolean) => void"
|
|
50
|
+
required: false
|
|
51
|
+
description: "Callback when group expanded state changes (SidebarGroup only)"
|
|
52
|
+
- name: variant
|
|
53
|
+
type: "'group' | 'section'"
|
|
54
|
+
required: false
|
|
55
|
+
default: "'group'"
|
|
56
|
+
description: "`section`: a collapsible SidebarSection, the small caps label with the chevron on the right (SidebarGroupTrigger only)"
|
|
57
|
+
- name: label
|
|
58
|
+
type: string
|
|
59
|
+
required: true
|
|
60
|
+
description: 'The row''s title; also names its toggle, "Toggle <label>" (SidebarTreeItem only)'
|
|
61
|
+
- name: depth
|
|
62
|
+
type: number
|
|
63
|
+
required: false
|
|
64
|
+
default: "0"
|
|
65
|
+
description: "Nesting level; indents 12px a level, or the tree's `indent` (SidebarTreeItem only)"
|
|
66
|
+
- name: indent
|
|
67
|
+
type: number
|
|
68
|
+
required: false
|
|
69
|
+
default: "12"
|
|
70
|
+
description: "The indent of a level, in px: wider for a phone's larger icons (SidebarTree only)"
|
|
71
|
+
- name: variant (SidebarTree)
|
|
72
|
+
type: "'default' | 'navigation'"
|
|
73
|
+
required: false
|
|
74
|
+
default: "'default'"
|
|
75
|
+
description: "`navigation`: rows of text after their icon (when given), the chevron always on the right, a leaf keeping its place so every row's trailing content stays in one column, and hierarchy guides (SidebarTree only)"
|
|
76
|
+
- name: guide
|
|
77
|
+
type: boolean
|
|
78
|
+
required: false
|
|
79
|
+
default: "false"
|
|
80
|
+
description: "Lines from the row's icon to each of its children, a branch into each, rounded on the last: they belong to it and go with it (SidebarTreeItem only; without it, a `navigation` tree draws a straight line of its own; with it, its branches start under the middle of the row's icon)"
|
|
81
|
+
- name: onSelect
|
|
82
|
+
type: "() => void"
|
|
83
|
+
required: false
|
|
84
|
+
description: "Clicking the row anywhere but the toggle, or Enter/Space on the focused item (SidebarTreeItem only)"
|
|
85
|
+
- name: trailing
|
|
86
|
+
type: React.ReactNode
|
|
87
|
+
required: false
|
|
88
|
+
description: "Shown at the right end: outside the label (SidebarTreeItem), before a section's chevron (SidebarGroupTrigger); the description (`aria-describedby`) of the tree item or the trigger, never part of its name. Non-interactive only: it sits in a clickable row or inside a button (no links, no buttons). Generic: a Badge count, a spinning `loader-circle` Icon with a label"
|
|
89
|
+
props_priority:
|
|
90
|
+
- active
|
|
91
|
+
- icon
|
|
92
|
+
- count
|
|
93
|
+
- render
|
|
94
|
+
- teamDot
|
|
95
|
+
examples:
|
|
96
|
+
- title: "Complete sidebar"
|
|
97
|
+
code: |
|
|
98
|
+
import { Inbox, Eye } from 'lucide-react';
|
|
99
|
+
|
|
100
|
+
<Sidebar>
|
|
101
|
+
<SidebarItem icon={<Inbox size={16} />} count={12} active>
|
|
102
|
+
Inbox
|
|
103
|
+
</SidebarItem>
|
|
104
|
+
<SidebarItem icon={<Eye size={16} />}>My Issues</SidebarItem>
|
|
105
|
+
<SidebarSection>Your Teams</SidebarSection>
|
|
106
|
+
<SidebarGroup>
|
|
107
|
+
<SidebarGroupTrigger teamDot="#e08a20">
|
|
108
|
+
Engineering
|
|
109
|
+
</SidebarGroupTrigger>
|
|
110
|
+
<SidebarGroupContent>
|
|
111
|
+
<SidebarItem>Active</SidebarItem>
|
|
112
|
+
<SidebarItem>Backlog</SidebarItem>
|
|
113
|
+
</SidebarGroupContent>
|
|
114
|
+
</SidebarGroup>
|
|
115
|
+
</Sidebar>
|
|
116
|
+
anti_patterns:
|
|
117
|
+
- "Don't override the width with classes — set `--sidebar-width` (as SidebarResizeHandle's owner does); 220px is the default"
|
|
118
|
+
- "Don't nest SidebarGroups — only one level of grouping is supported; for a tree use SidebarTreeItem rows"
|
|
119
|
+
- "Don't use SidebarGroupTrigger/SidebarGroupContent outside SidebarGroup — they depend on context"
|
|
120
|
+
- "Don't use a static SidebarSection for a collection users expect to collapse — wrap its trigger and items in SidebarGroup"
|
|
121
|
+
- "Don't add padding or margin to Sidebar children — spacing is handled by the component"
|
|
122
|
+
accessibility_notes: 'Sidebar renders as <nav>. SidebarGroupTrigger uses aria-expanded. SidebarTree is a `tree` (name it with aria-label) with one tab stop (roving tabindex: the item last focused, else the active one, else the first shown). SidebarTreeItem is a `treeitem` named by its label, with aria-level, aria-expanded (with children), aria-current="page" when active, its trailing content as description, and its children rows in a `group` inside it; keys on the focused item: Up/Down, Home/End, Right opens or enters, Left closes or goes up, Enter/Space select. Its toggle and label buttons are for the mouse (tabindex -1); a press on the row focuses the item. SidebarItem renders as <button> (or a custom element via the render prop). Keyboard: Tab navigation between items, Enter/Space to activate.'
|
|
123
|
+
notes: "Sub-components: Sidebar (full-height nav container; its parent must establish a height), SidebarContent (flexible scroll area), SidebarHeader (brand/app header — use as first child of SidebarContent when the app has no global AppShell header; px-1.5 aligns the brand icon to the item rail), SidebarSection (static uppercase label), SidebarItem (interactive item with icon/count/teamDot), SidebarFooter (pinned bottom area), SidebarGroup (collapsible collection), SidebarGroupTrigger (expand/collapse toggle), SidebarGroupContent (collapsible content area), SidebarResizeHandle (8px separator on the sidebar's right edge: drag, ArrowLeft/Right 8px, double-click resets to 220px; 190px to half the viewport; its owner stores the width and sets `--sidebar-width`), SidebarCollapse (animated open/close; closed content stays mounted but inert, aria-hidden, invisible; SidebarGroupContent and SidebarTreeItem use it), SidebarTree (the `tree` holding SidebarTreeItems, one tab stop), SidebarTreeItem (a tree item: its row, icon or, with children, a toggle whose chevron replaces the icon on hover and keyboard focus, and the label; its children rows, at depth + 1, as its children)."
|
|
124
|
+
related_patterns:
|
|
125
|
+
- list-view
|
|
126
|
+
- crud-page
|