@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,53 @@
|
|
|
1
|
+
name: Toggle
|
|
2
|
+
description: "Binary on/off switch built on Base UI Switch primitive. Renders as a 28x16px track with a 12px thumb."
|
|
3
|
+
layer: core
|
|
4
|
+
category: input
|
|
5
|
+
when_to_use:
|
|
6
|
+
- "For on/off settings and preferences"
|
|
7
|
+
- "For enabling/disabling features in settings panels"
|
|
8
|
+
- "For binary state toggles where immediate effect is expected"
|
|
9
|
+
when_not_to_use:
|
|
10
|
+
- "For form checkboxes — use Checkbox component"
|
|
11
|
+
- "For multi-option selection — use SegmentGroup"
|
|
12
|
+
- "For action buttons — use Button component"
|
|
13
|
+
composition_partners:
|
|
14
|
+
- Properties (as value in PropertyRow)
|
|
15
|
+
- Dialog (in settings forms)
|
|
16
|
+
props:
|
|
17
|
+
- name: checked
|
|
18
|
+
type: boolean
|
|
19
|
+
required: false
|
|
20
|
+
description: "Controlled checked state"
|
|
21
|
+
- name: onCheckedChange
|
|
22
|
+
type: "(checked: boolean, eventDetails) => void"
|
|
23
|
+
required: false
|
|
24
|
+
description: "Callback when checked state changes. Base UI passes eventDetails as the second argument; eventDetails.cancel() prevents the change."
|
|
25
|
+
- name: defaultChecked
|
|
26
|
+
type: boolean
|
|
27
|
+
required: false
|
|
28
|
+
description: "Initial checked state (uncontrolled)"
|
|
29
|
+
- name: disabled
|
|
30
|
+
type: boolean
|
|
31
|
+
required: false
|
|
32
|
+
description: "Whether the toggle is disabled"
|
|
33
|
+
props_priority:
|
|
34
|
+
- checked
|
|
35
|
+
- onCheckedChange
|
|
36
|
+
- disabled
|
|
37
|
+
- defaultChecked
|
|
38
|
+
examples:
|
|
39
|
+
- title: "Uncontrolled toggle"
|
|
40
|
+
code: "<Toggle defaultChecked />"
|
|
41
|
+
- title: "Controlled toggle"
|
|
42
|
+
code: |
|
|
43
|
+
<Toggle
|
|
44
|
+
checked={enabled}
|
|
45
|
+
onCheckedChange={setEnabled}
|
|
46
|
+
/>
|
|
47
|
+
- title: "Disabled toggle"
|
|
48
|
+
code: "<Toggle disabled />"
|
|
49
|
+
anti_patterns:
|
|
50
|
+
- "Don't use for multi-state selection — Toggle is strictly binary (on/off)"
|
|
51
|
+
- "Don't add custom track/thumb styles via className — the dimensions are fixed by design"
|
|
52
|
+
- "Don't use as a checkbox replacement in forms where submit behavior is expected"
|
|
53
|
+
accessibility_notes: "Built on Base UI Switch — renders role='switch' with proper aria-checked. Keyboard: Space to toggle. Focus ring shown on keyboard navigation."
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
import { Switch as SwitchPrimitive } from "@base-ui/react/switch";
|
|
3
|
+
import { cva, type VariantProps } from "class-variance-authority";
|
|
4
|
+
|
|
5
|
+
import { cn } from "../../../lib/utils";
|
|
6
|
+
|
|
7
|
+
const toggleVariants = cva(
|
|
8
|
+
"inline-flex items-center p-0 w-[28px] h-[16px] rounded-full relative cursor-pointer transition-colors duration-150 data-unchecked:bg-border data-checked:bg-accent focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-accent focus-visible:ring-offset-2 focus-visible:ring-offset-background disabled:opacity-50 disabled:cursor-not-allowed",
|
|
9
|
+
);
|
|
10
|
+
|
|
11
|
+
interface ToggleProps
|
|
12
|
+
extends
|
|
13
|
+
Omit<
|
|
14
|
+
React.ComponentProps<typeof SwitchPrimitive.Root>,
|
|
15
|
+
// `render`/`nativeButton` are fixed internally (the control always
|
|
16
|
+
// renders a native <button>). They are also discarded at runtime below,
|
|
17
|
+
// since JS consumers bypass the TS Omit.
|
|
18
|
+
"render" | "nativeButton"
|
|
19
|
+
>,
|
|
20
|
+
VariantProps<typeof toggleVariants> {}
|
|
21
|
+
|
|
22
|
+
function Toggle({ className, ...props }: ToggleProps) {
|
|
23
|
+
// The TS Omit hides these, but JS consumers could still pass them and the
|
|
24
|
+
// {...props} spread comes last — discard so the internal values always win.
|
|
25
|
+
delete (props as Record<string, unknown>).render;
|
|
26
|
+
delete (props as Record<string, unknown>).nativeButton;
|
|
27
|
+
return (
|
|
28
|
+
<SwitchPrimitive.Root
|
|
29
|
+
data-slot="toggle"
|
|
30
|
+
// Render a native <button> (Base UI defaults to <span>) to keep the
|
|
31
|
+
// Radix-era DOM contract: native disabled attr + :disabled styling.
|
|
32
|
+
render={<button type="button" />}
|
|
33
|
+
nativeButton
|
|
34
|
+
className={cn(toggleVariants({ className }))}
|
|
35
|
+
{...props}
|
|
36
|
+
>
|
|
37
|
+
{/* translate-x-[14px] (not 12px) because flex positions thumb at x=0, so: 28px track - 12px thumb - 2px margin = 14px */}
|
|
38
|
+
<SwitchPrimitive.Thumb className="block size-3 rounded-full bg-white shadow-sm transition-transform duration-150 data-unchecked:translate-x-0.5 data-checked:translate-x-[14px]" />
|
|
39
|
+
</SwitchPrimitive.Root>
|
|
40
|
+
);
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
export { Toggle, toggleVariants };
|
|
44
|
+
export type { ToggleProps };
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
name: ToggleGroup
|
|
2
|
+
description: "A row of toggle buttons in one track; any number of them may be pressed at once."
|
|
3
|
+
layer: core
|
|
4
|
+
category: input
|
|
5
|
+
when_to_use:
|
|
6
|
+
- "For multiple-choice selection among a few options (weekdays, filters)"
|
|
7
|
+
- "For a setting with several independent toggles sharing one control"
|
|
8
|
+
when_not_to_use:
|
|
9
|
+
- "For one choice among options — use SegmentGroup"
|
|
10
|
+
- "For a single on/off setting — use Toggle"
|
|
11
|
+
- "For more than 7 options — use a DropdownMenu or Select"
|
|
12
|
+
composition_partners:
|
|
13
|
+
- Properties (as a value control in PropertyRow)
|
|
14
|
+
- Field (with a FieldLabel)
|
|
15
|
+
props:
|
|
16
|
+
- name: items
|
|
17
|
+
type: "ToggleGroupItem[]"
|
|
18
|
+
required: true
|
|
19
|
+
description: "Each item's value, label and optional full-name title"
|
|
20
|
+
- name: value
|
|
21
|
+
type: "string[]"
|
|
22
|
+
required: true
|
|
23
|
+
description: "The pressed items' values (controlled)"
|
|
24
|
+
- name: onValueChange
|
|
25
|
+
type: "(value: string[]) => void"
|
|
26
|
+
required: true
|
|
27
|
+
description: "Called with the new pressed values"
|
|
28
|
+
- name: aria-label
|
|
29
|
+
type: "string"
|
|
30
|
+
required: true
|
|
31
|
+
description: "The group's accessible name"
|
|
32
|
+
- name: size
|
|
33
|
+
type: "'sm' | 'default' | 'lg'"
|
|
34
|
+
required: false
|
|
35
|
+
default: "'default'"
|
|
36
|
+
description: "Height on the height tokens, as SegmentGroup, Button and Input: sm (h-sm, 26px), default (h-md, 30px), lg (h-lg, 34px) at the look's default Control height, which they follow"
|
|
37
|
+
props_priority:
|
|
38
|
+
- items
|
|
39
|
+
- value
|
|
40
|
+
- onValueChange
|
|
41
|
+
- aria-label
|
|
42
|
+
examples:
|
|
43
|
+
- title: "Weekdays"
|
|
44
|
+
code: |
|
|
45
|
+
<ToggleGroup
|
|
46
|
+
aria-label="Days"
|
|
47
|
+
items={[
|
|
48
|
+
{ value: "1", label: "M", title: "Monday" },
|
|
49
|
+
{ value: "2", label: "T", title: "Tuesday" },
|
|
50
|
+
{ value: "3", label: "W", title: "Wednesday" },
|
|
51
|
+
]}
|
|
52
|
+
value={days}
|
|
53
|
+
onValueChange={setDays}
|
|
54
|
+
/>
|
|
55
|
+
anti_patterns:
|
|
56
|
+
- "Don't use for a single choice — SegmentGroup does that with radio semantics"
|
|
57
|
+
- "Don't mix controlled and uncontrolled — value and onValueChange are both required"
|
|
58
|
+
accessibility_notes: "Base UI ToggleGroup with multiple enabled. Each button exposes aria-pressed; arrow keys move between items and Space or Enter toggles the focused one."
|
|
59
|
+
notes: "ToggleGroupItem type: { value: string, label: React.ReactNode, title?: string }. Styled as SegmentGroup: a track of the height tokens (its size, default h-md) with quiet text and a raised surface for pressed items."
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
import { Toggle as TogglePrimitive } from "@base-ui/react/toggle";
|
|
3
|
+
import { ToggleGroup as ToggleGroupPrimitive } from "@base-ui/react/toggle-group";
|
|
4
|
+
|
|
5
|
+
import { cn } from "../../../lib/utils";
|
|
6
|
+
import { segmentGroupVariants, segmentItemSizes } from "../segment-group/segment-group";
|
|
7
|
+
|
|
8
|
+
interface ToggleGroupItem {
|
|
9
|
+
value: string;
|
|
10
|
+
label: React.ReactNode;
|
|
11
|
+
/** The item's full name, shown in the browser's tooltip (a weekday's "Monday" for "M"). */
|
|
12
|
+
title?: string;
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
interface ToggleGroupProps {
|
|
16
|
+
items: ToggleGroupItem[];
|
|
17
|
+
value: string[];
|
|
18
|
+
onValueChange: (value: string[]) => void;
|
|
19
|
+
"aria-label": string;
|
|
20
|
+
/** Height, as SegmentGroup's and Button's (h-sm, h-md, h-lg). Defaults to `default` (h-md). */
|
|
21
|
+
size?: "sm" | "default" | "lg";
|
|
22
|
+
className?: string;
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
/** A multiple-choice toggle group, drawn as SegmentGroup is: several quiet buttons in one track, each independently
|
|
26
|
+
* pressed (weekdays, filters). Base UI's ToggleGroup keeps the pressed set and its keyboard behaviour. */
|
|
27
|
+
function ToggleGroup({
|
|
28
|
+
className,
|
|
29
|
+
size = "default",
|
|
30
|
+
items,
|
|
31
|
+
value,
|
|
32
|
+
onValueChange,
|
|
33
|
+
...props
|
|
34
|
+
}: ToggleGroupProps) {
|
|
35
|
+
return (
|
|
36
|
+
<ToggleGroupPrimitive
|
|
37
|
+
data-slot="toggle-group"
|
|
38
|
+
multiple
|
|
39
|
+
value={value}
|
|
40
|
+
onValueChange={(next) => onValueChange([...next])}
|
|
41
|
+
data-size={size}
|
|
42
|
+
className={cn(segmentGroupVariants({ size }), className)}
|
|
43
|
+
{...props}
|
|
44
|
+
>
|
|
45
|
+
{items.map((item) => {
|
|
46
|
+
const pressed = value.includes(item.value);
|
|
47
|
+
return (
|
|
48
|
+
<TogglePrimitive
|
|
49
|
+
key={item.value}
|
|
50
|
+
data-slot="toggle-group-item"
|
|
51
|
+
value={item.value}
|
|
52
|
+
title={item.title}
|
|
53
|
+
className={cn(
|
|
54
|
+
"relative z-[1] flex h-full cursor-pointer items-center justify-center rounded-control-inner bg-transparent font-medium transition-colors duration-150 outline-none",
|
|
55
|
+
segmentItemSizes[size],
|
|
56
|
+
pressed ? "bg-surface text-foreground shadow-xs" : "text-muted hover:text-secondary",
|
|
57
|
+
)}
|
|
58
|
+
>
|
|
59
|
+
{item.label}
|
|
60
|
+
</TogglePrimitive>
|
|
61
|
+
);
|
|
62
|
+
})}
|
|
63
|
+
</ToggleGroupPrimitive>
|
|
64
|
+
);
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
export { ToggleGroup };
|
|
68
|
+
export type { ToggleGroupProps, ToggleGroupItem };
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
name: Tooltip
|
|
2
|
+
description: "Contextual hover information built on Base UI Tooltip. TooltipProvider is recommended for shared delays across adjacent tooltips."
|
|
3
|
+
layer: core
|
|
4
|
+
category: overlay
|
|
5
|
+
when_to_use:
|
|
6
|
+
- "For providing additional context on hover for icon buttons"
|
|
7
|
+
- "For explaining UI elements without cluttering the interface"
|
|
8
|
+
- "For showing keyboard shortcuts or brief descriptions"
|
|
9
|
+
when_not_to_use:
|
|
10
|
+
- "For interactive content — use DropdownMenu or Dialog"
|
|
11
|
+
- "For lengthy descriptions — use inline text or a dedicated section"
|
|
12
|
+
- "For mobile-first interfaces — tooltips rely on hover which doesn't work on touch"
|
|
13
|
+
composition_partners:
|
|
14
|
+
- Button (as TooltipTrigger child, especially icon buttons)
|
|
15
|
+
- TooltipProvider (recommended app-level wrapper for shared timing)
|
|
16
|
+
props:
|
|
17
|
+
- name: delay
|
|
18
|
+
type: number
|
|
19
|
+
required: false
|
|
20
|
+
description: "Milliseconds before the tooltip appears. TooltipProvider defaults to 120ms in Bridge UI; TooltipTrigger also accepts a per-trigger override (Base UI defaults to 600ms without a provider)."
|
|
21
|
+
- name: timeout
|
|
22
|
+
type: number
|
|
23
|
+
required: false
|
|
24
|
+
default: "80"
|
|
25
|
+
description: "Milliseconds within which moving between triggers shows the next tooltip instantly (TooltipProvider only)"
|
|
26
|
+
- name: closeDelay
|
|
27
|
+
type: number
|
|
28
|
+
required: false
|
|
29
|
+
description: "Milliseconds before an open tooltip closes. Forwarded by TooltipProvider and TooltipTrigger; TooltipTrigger defaults to 0ms."
|
|
30
|
+
- name: sideOffset
|
|
31
|
+
type: "number | ((data) => number)"
|
|
32
|
+
required: false
|
|
33
|
+
default: "6"
|
|
34
|
+
description: "Distance from trigger in pixels (TooltipContent only)"
|
|
35
|
+
- name: side
|
|
36
|
+
type: "'top' | 'right' | 'bottom' | 'left'"
|
|
37
|
+
required: false
|
|
38
|
+
default: "'top'"
|
|
39
|
+
description: "Preferred side to display tooltip (TooltipContent only)"
|
|
40
|
+
- name: align
|
|
41
|
+
type: "'start' | 'center' | 'end'"
|
|
42
|
+
required: false
|
|
43
|
+
default: "'center'"
|
|
44
|
+
description: "Alignment relative to trigger (TooltipContent only)"
|
|
45
|
+
- name: alignOffset
|
|
46
|
+
type: "number | ((data) => number)"
|
|
47
|
+
required: false
|
|
48
|
+
default: "0"
|
|
49
|
+
description: "Offset along the alignment axis in pixels (TooltipContent only)"
|
|
50
|
+
- name: collisionPadding
|
|
51
|
+
type: "number | { top?, right?, bottom?, left? }"
|
|
52
|
+
required: false
|
|
53
|
+
default: "5"
|
|
54
|
+
description: "Minimum distance from viewport edges when auto-positioning (TooltipContent only)"
|
|
55
|
+
- name: render
|
|
56
|
+
type: "ReactElement | (props, state) => ReactElement"
|
|
57
|
+
required: false
|
|
58
|
+
description: "Replace the rendered element on TooltipTrigger or TooltipContent, e.g. render={<Button />} on the trigger."
|
|
59
|
+
- name: hint
|
|
60
|
+
type: React.ReactNode
|
|
61
|
+
required: false
|
|
62
|
+
description: "A second, lighter line under the message, for an action hint such as 'Click to retry' (TooltipContent only). The popup wraps at max-w-[220px]."
|
|
63
|
+
props_priority:
|
|
64
|
+
- side
|
|
65
|
+
- sideOffset
|
|
66
|
+
- hint
|
|
67
|
+
- delay
|
|
68
|
+
examples:
|
|
69
|
+
- title: "Tooltip on icon button"
|
|
70
|
+
code: |
|
|
71
|
+
import { Plus } from 'lucide-react';
|
|
72
|
+
|
|
73
|
+
<TooltipProvider>
|
|
74
|
+
<Tooltip>
|
|
75
|
+
<TooltipTrigger render={<Button size="icon-sm" aria-label="Create new issue" />}>
|
|
76
|
+
<Plus size={14} />
|
|
77
|
+
</TooltipTrigger>
|
|
78
|
+
<TooltipContent>Create new issue</TooltipContent>
|
|
79
|
+
</Tooltip>
|
|
80
|
+
</TooltipProvider>
|
|
81
|
+
- title: "Tooltip with side placement"
|
|
82
|
+
code: |
|
|
83
|
+
<Tooltip>
|
|
84
|
+
<TooltipTrigger render={<Button size="icon" aria-label="Settings" />}>⚙️</TooltipTrigger>
|
|
85
|
+
<TooltipContent side="right">Settings</TooltipContent>
|
|
86
|
+
</Tooltip>
|
|
87
|
+
anti_patterns:
|
|
88
|
+
- "Don't skip the TooltipProvider ancestor — tooltips still work without it, but you lose the shared 120ms/80ms delay defaults and instant-move behavior between adjacent tooltips"
|
|
89
|
+
- "Don't put interactive elements inside TooltipContent — tooltips are for display only"
|
|
90
|
+
- "Don't use Tooltip for critical information — it's hidden by default and requires hover"
|
|
91
|
+
- "Don't forget render={<Button />} on TooltipTrigger when wrapping a Button"
|
|
92
|
+
accessibility_notes: "Built on Base UI Tooltip — the wrapper restores aria-describedby to associate tooltip content with trigger. Tooltip appears on focus as well as hover. Escape key dismisses tooltip."
|
|
93
|
+
notes: "Sub-components: TooltipProvider (app-level wrapper), Tooltip (root), TooltipTrigger, TooltipContent. Provider should wrap the app once, not each individual tooltip."
|
|
@@ -0,0 +1,198 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
import { Tooltip as TooltipPrimitive } from "@base-ui/react/tooltip";
|
|
3
|
+
|
|
4
|
+
import { cn } from "../../../lib/utils";
|
|
5
|
+
|
|
6
|
+
// --- TooltipProvider ---
|
|
7
|
+
|
|
8
|
+
interface TooltipProviderProps extends React.ComponentProps<typeof TooltipPrimitive.Provider> {}
|
|
9
|
+
|
|
10
|
+
function TooltipProvider({ delay = 120, timeout = 80, ...props }: TooltipProviderProps) {
|
|
11
|
+
return <TooltipPrimitive.Provider delay={delay} timeout={timeout} {...props} />;
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
// --- Tooltip (root) ---
|
|
15
|
+
|
|
16
|
+
// Base UI (unlike Radix) does not link trigger and popup with
|
|
17
|
+
// aria-describedby. This context restores that wiring in the wrappers so the
|
|
18
|
+
// tooltip text stays announced by screen readers. The popup registers its
|
|
19
|
+
// effective DOM id while it is actually mounted, so the trigger never points
|
|
20
|
+
// at a dangling id and consumer-supplied ids are respected.
|
|
21
|
+
interface TooltipA11yContextValue {
|
|
22
|
+
/** Effective ids for every currently mounted popup. */
|
|
23
|
+
registeredPopupIds: string[];
|
|
24
|
+
/** Register one mounted popup and return its ownership-safe cleanup. */
|
|
25
|
+
registerPopup: (id: string) => () => void;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
const TooltipA11yContext = React.createContext<TooltipA11yContextValue | null>(null);
|
|
29
|
+
|
|
30
|
+
/** Registers the popup id while (and only while) the popup is mounted.
|
|
31
|
+
* Rendered inside the Popup so its lifecycle tracks the actual DOM node. */
|
|
32
|
+
function TooltipPopupRegistrar({ id }: { id: string }) {
|
|
33
|
+
const a11y = React.useContext(TooltipA11yContext);
|
|
34
|
+
const registerPopup = a11y?.registerPopup;
|
|
35
|
+
React.useLayoutEffect(() => registerPopup?.(id), [registerPopup, id]);
|
|
36
|
+
return null;
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
interface TooltipProps extends React.ComponentProps<typeof TooltipPrimitive.Root> {}
|
|
40
|
+
|
|
41
|
+
function Tooltip(props: TooltipProps) {
|
|
42
|
+
const nextRegistrationKey = React.useRef(0);
|
|
43
|
+
const [popupRegistrations, setPopupRegistrations] = React.useState<
|
|
44
|
+
Array<{ key: number; id: string }>
|
|
45
|
+
>([]);
|
|
46
|
+
const registerPopup = React.useCallback((id: string) => {
|
|
47
|
+
const key = nextRegistrationKey.current++;
|
|
48
|
+
setPopupRegistrations((current) => [...current, { key, id }]);
|
|
49
|
+
return () => {
|
|
50
|
+
setPopupRegistrations((current) =>
|
|
51
|
+
current.filter((registration) => registration.key !== key),
|
|
52
|
+
);
|
|
53
|
+
};
|
|
54
|
+
}, []);
|
|
55
|
+
const registeredPopupIds = React.useMemo(
|
|
56
|
+
() => [...new Set(popupRegistrations.map(({ id }) => id))],
|
|
57
|
+
[popupRegistrations],
|
|
58
|
+
);
|
|
59
|
+
const a11y = React.useMemo(
|
|
60
|
+
() => ({ registeredPopupIds, registerPopup }),
|
|
61
|
+
[registeredPopupIds, registerPopup],
|
|
62
|
+
);
|
|
63
|
+
|
|
64
|
+
return (
|
|
65
|
+
<TooltipA11yContext.Provider value={a11y}>
|
|
66
|
+
<TooltipPrimitive.Root {...props} />
|
|
67
|
+
</TooltipA11yContext.Provider>
|
|
68
|
+
);
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
// --- TooltipTrigger ---
|
|
72
|
+
|
|
73
|
+
interface TooltipTriggerProps extends React.ComponentProps<typeof TooltipPrimitive.Trigger> {}
|
|
74
|
+
|
|
75
|
+
function TooltipTrigger({
|
|
76
|
+
className,
|
|
77
|
+
"aria-describedby": ariaDescribedByProp,
|
|
78
|
+
...props
|
|
79
|
+
}: TooltipTriggerProps) {
|
|
80
|
+
const a11y = React.useContext(TooltipA11yContext);
|
|
81
|
+
// Merge a consumer-supplied aria-describedby with the tooltip linkage
|
|
82
|
+
// (space-separated id list), like Radix did — never replace one with the
|
|
83
|
+
// other.
|
|
84
|
+
const ariaDescribedByTokens = [
|
|
85
|
+
...(ariaDescribedByProp?.split(/\s+/).filter(Boolean) ?? []),
|
|
86
|
+
...(a11y?.registeredPopupIds ?? []),
|
|
87
|
+
];
|
|
88
|
+
const ariaDescribedBy =
|
|
89
|
+
ariaDescribedByTokens.length > 0 ? [...new Set(ariaDescribedByTokens)].join(" ") : undefined;
|
|
90
|
+
return (
|
|
91
|
+
<TooltipPrimitive.Trigger
|
|
92
|
+
data-slot="tooltip-trigger"
|
|
93
|
+
className={className}
|
|
94
|
+
aria-describedby={ariaDescribedBy}
|
|
95
|
+
{...props}
|
|
96
|
+
/>
|
|
97
|
+
);
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
// --- TooltipContent ---
|
|
101
|
+
|
|
102
|
+
interface TooltipContentProps extends React.ComponentProps<typeof TooltipPrimitive.Popup> {
|
|
103
|
+
/** Which side of the trigger to position against (lives on Base UI's Positioner) */
|
|
104
|
+
side?: "top" | "right" | "bottom" | "left";
|
|
105
|
+
/** Distance from the trigger in px (lives on Base UI's Positioner) */
|
|
106
|
+
sideOffset?: React.ComponentProps<typeof TooltipPrimitive.Positioner>["sideOffset"];
|
|
107
|
+
/** Alignment against the trigger (lives on Base UI's Positioner) */
|
|
108
|
+
align?: React.ComponentProps<typeof TooltipPrimitive.Positioner>["align"];
|
|
109
|
+
/** Offset along the alignment axis (lives on Base UI's Positioner) */
|
|
110
|
+
alignOffset?: React.ComponentProps<typeof TooltipPrimitive.Positioner>["alignOffset"];
|
|
111
|
+
/** Minimum distance from the viewport edges (lives on Base UI's Positioner) */
|
|
112
|
+
collisionPadding?: React.ComponentProps<typeof TooltipPrimitive.Positioner>["collisionPadding"];
|
|
113
|
+
/** A second, lighter line under the message (e.g. an action hint such as "Click to retry"). */
|
|
114
|
+
hint?: React.ReactNode;
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
function TooltipContent({
|
|
118
|
+
className,
|
|
119
|
+
sideOffset = 6,
|
|
120
|
+
side = "top",
|
|
121
|
+
align,
|
|
122
|
+
alignOffset,
|
|
123
|
+
collisionPadding,
|
|
124
|
+
hint,
|
|
125
|
+
id,
|
|
126
|
+
style,
|
|
127
|
+
children,
|
|
128
|
+
...props
|
|
129
|
+
}: TooltipContentProps) {
|
|
130
|
+
const fallbackId = React.useId();
|
|
131
|
+
// Respect a consumer-supplied id — the trigger's aria-describedby follows it.
|
|
132
|
+
const effectiveId = id ?? fallbackId;
|
|
133
|
+
return (
|
|
134
|
+
<TooltipPrimitive.Portal>
|
|
135
|
+
<TooltipPrimitive.Positioner
|
|
136
|
+
sideOffset={sideOffset}
|
|
137
|
+
side={side}
|
|
138
|
+
align={align}
|
|
139
|
+
alignOffset={alignOffset}
|
|
140
|
+
collisionPadding={collisionPadding}
|
|
141
|
+
className="z-50"
|
|
142
|
+
>
|
|
143
|
+
<TooltipPrimitive.Popup
|
|
144
|
+
{...props}
|
|
145
|
+
data-slot="tooltip-content"
|
|
146
|
+
role="tooltip"
|
|
147
|
+
id={effectiveId}
|
|
148
|
+
className={cn(
|
|
149
|
+
"z-50 bg-foreground text-background rounded-sm text-xs px-2 py-1 max-w-[220px] whitespace-normal",
|
|
150
|
+
className,
|
|
151
|
+
)}
|
|
152
|
+
style={{ boxShadow: "var(--shadow-tooltip)", ...style }}
|
|
153
|
+
>
|
|
154
|
+
<TooltipPopupRegistrar id={effectiveId} />
|
|
155
|
+
{children}
|
|
156
|
+
{hint != null ? (
|
|
157
|
+
<span data-slot="tooltip-hint" className="block text-[11.5px] opacity-60 mt-px">
|
|
158
|
+
{hint}
|
|
159
|
+
</span>
|
|
160
|
+
) : null}
|
|
161
|
+
<TooltipPrimitive.Arrow
|
|
162
|
+
className={cn(
|
|
163
|
+
"flex",
|
|
164
|
+
"data-[side=top]:bottom-[-4px] data-[side=top]:rotate-0",
|
|
165
|
+
"data-[side=bottom]:top-[-4px] data-[side=bottom]:rotate-180",
|
|
166
|
+
"data-[side=left]:right-[-6px] data-[side=left]:-rotate-90",
|
|
167
|
+
"data-[side=right]:left-[-6px] data-[side=right]:rotate-90",
|
|
168
|
+
)}
|
|
169
|
+
>
|
|
170
|
+
{/* 8x4 triangle pointing away from the popup (down for side="top") */}
|
|
171
|
+
<svg
|
|
172
|
+
width="8"
|
|
173
|
+
height="4"
|
|
174
|
+
viewBox="0 0 8 4"
|
|
175
|
+
className="fill-foreground"
|
|
176
|
+
aria-hidden="true"
|
|
177
|
+
>
|
|
178
|
+
<path d="M0 0h8L4 4Z" />
|
|
179
|
+
</svg>
|
|
180
|
+
</TooltipPrimitive.Arrow>
|
|
181
|
+
</TooltipPrimitive.Popup>
|
|
182
|
+
</TooltipPrimitive.Positioner>
|
|
183
|
+
</TooltipPrimitive.Portal>
|
|
184
|
+
);
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
/** An icon-only control with its tooltip (the kit's rule for lossy glyphs): `<Tip label="Filter"><Button …/></Tip>`. */
|
|
188
|
+
function Tip({ label, children }: { label: React.ReactNode; children: React.ReactElement }) {
|
|
189
|
+
return (
|
|
190
|
+
<Tooltip>
|
|
191
|
+
<TooltipTrigger render={children} />
|
|
192
|
+
<TooltipContent>{label}</TooltipContent>
|
|
193
|
+
</Tooltip>
|
|
194
|
+
);
|
|
195
|
+
}
|
|
196
|
+
|
|
197
|
+
export { TooltipProvider, Tooltip, TooltipTrigger, TooltipContent, Tip };
|
|
198
|
+
export type { TooltipProps, TooltipProviderProps, TooltipTriggerProps, TooltipContentProps };
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
import type * as React from "react";
|
|
2
|
+
|
|
3
|
+
import { MultiPane, multiPaneNarrowWidth, type MultiPaneProps } from "./multi-pane";
|
|
4
|
+
|
|
5
|
+
// MultiPane's name until November 2026 (research-070), kept for plugins built against it: `list` is MultiPane's `nav`,
|
|
6
|
+
// `detail` its `main`. New screens take MultiPane.
|
|
7
|
+
|
|
8
|
+
interface ListDetailProps extends Omit<
|
|
9
|
+
MultiPaneProps,
|
|
10
|
+
"nav" | "main" | "aside" | "mode" | "defaultNavSize"
|
|
11
|
+
> {
|
|
12
|
+
list: React.ReactNode;
|
|
13
|
+
detail: React.ReactNode;
|
|
14
|
+
mode?: "split" | "list" | "detail";
|
|
15
|
+
/** The list's starting width (`"320px"` by default). */
|
|
16
|
+
defaultListSize?: string;
|
|
17
|
+
/** Ignored: the record keeps 380px at least. */
|
|
18
|
+
detailMinSize?: string;
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
/** @deprecated MultiPane's `multiPaneNarrowWidth`. */
|
|
22
|
+
const listDetailNarrowWidth = multiPaneNarrowWidth;
|
|
23
|
+
|
|
24
|
+
/** @deprecated MultiPane, `nav` and `main`. */
|
|
25
|
+
function ListDetail({
|
|
26
|
+
list,
|
|
27
|
+
detail,
|
|
28
|
+
mode = "split",
|
|
29
|
+
defaultListSize = "320px",
|
|
30
|
+
detailMinSize: _ignored,
|
|
31
|
+
...props
|
|
32
|
+
}: ListDetailProps) {
|
|
33
|
+
return (
|
|
34
|
+
<MultiPane
|
|
35
|
+
nav={list}
|
|
36
|
+
main={detail}
|
|
37
|
+
mode={mode === "list" ? "nav" : mode === "detail" ? "main" : "split"}
|
|
38
|
+
defaultNavSize={defaultListSize}
|
|
39
|
+
{...props}
|
|
40
|
+
/>
|
|
41
|
+
);
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
export { ListDetail, listDetailNarrowWidth };
|
|
45
|
+
export type { ListDetailProps };
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
name: MultiPane
|
|
2
|
+
description: "A screen's skeleton in two or three panes, nav | main | aside: main takes what the others leave, nav and aside start at 25 %, each edge dragged (200px at least for nav and aside, 380px for main), a double-click on an edge back to the starting widths. When room runs out the panes leave from the right: three panes in a box under 800px leave the aside out, under 640px the first pane stays alone; the screen opens what left elsewhere (a window; on a phone, pushed with the shell's Back). mode shows one pane alone (a window showing only it)."
|
|
3
|
+
layer: layout
|
|
4
|
+
category: layout
|
|
5
|
+
when_to_use:
|
|
6
|
+
- "A list beside its record (Contacts, Health): nav and main"
|
|
7
|
+
- "A table beside the row it opened (Orders): main and aside"
|
|
8
|
+
- "Three columns: folders | list | message, pages | document | properties"
|
|
9
|
+
when_not_to_use:
|
|
10
|
+
- "A single column (a page of sections, settings): Pane alone"
|
|
11
|
+
- "Any other split of a view into rows or columns (an editor above its console, a grid of panes) — use SplitView"
|
|
12
|
+
props:
|
|
13
|
+
- name: nav
|
|
14
|
+
type: React.ReactNode
|
|
15
|
+
required: false
|
|
16
|
+
description: "The left pane (a list, folders); none: main on the left"
|
|
17
|
+
- name: main
|
|
18
|
+
type: React.ReactNode
|
|
19
|
+
required: true
|
|
20
|
+
description: "The pane that takes the room"
|
|
21
|
+
- name: aside
|
|
22
|
+
type: React.ReactNode
|
|
23
|
+
required: false
|
|
24
|
+
description: "The right pane (a record, properties); none: main on the right"
|
|
25
|
+
- name: mode
|
|
26
|
+
type: "'split' | 'nav' | 'main' | 'aside'"
|
|
27
|
+
required: false
|
|
28
|
+
default: "'split'"
|
|
29
|
+
description: "split: the panes side by side; a pane's name: that pane alone at any width, a window showing only it"
|
|
30
|
+
- name: defaultNavSize
|
|
31
|
+
type: string
|
|
32
|
+
required: false
|
|
33
|
+
default: "'25%'"
|
|
34
|
+
description: "nav's starting width, in px or % ('320px', '65%' for a list that matters more than its record): dragged from there, a double-click on the edge comes back to it"
|
|
35
|
+
- name: defaultAsideSize
|
|
36
|
+
type: string
|
|
37
|
+
required: false
|
|
38
|
+
default: "'25%'"
|
|
39
|
+
description: "aside's starting width, in px or %"
|
|
40
|
+
- name: storageKey
|
|
41
|
+
type: string
|
|
42
|
+
required: false
|
|
43
|
+
description: "`<plugin>/<screen>/<split>@v<n>` (e.g. 'bridge-settings/health/list@v1'): the sizes a user dragged, kept per workspace in their profile and brought back there; a double-click on an edge forgets them. Omit for no memory"
|
|
44
|
+
- name: scroll
|
|
45
|
+
type: "('nav' | 'main' | 'aside')[]"
|
|
46
|
+
required: false
|
|
47
|
+
default: "[]"
|
|
48
|
+
description: "The panes that scroll their content, through the kit's ScrollArea (as a frame's scrolling); the others leave it to their content (a Pane's body, a Detail keep their header fixed)"
|
|
49
|
+
- name: collapse
|
|
50
|
+
type: boolean
|
|
51
|
+
required: false
|
|
52
|
+
default: "true"
|
|
53
|
+
description: "When room runs out, the panes leave from the right; off for a screen that cannot open them elsewhere yet"
|
|
54
|
+
composition_partners:
|
|
55
|
+
- Pane (each pane's content)
|
|
56
|
+
- Detail, EmptyState, DetailSkeleton (a record pane)
|
|
57
|
+
examples:
|
|
58
|
+
- title: "A list beside its record"
|
|
59
|
+
code: |
|
|
60
|
+
<MultiPane nav={<Pane aria-label="Contacts">…</Pane>} main={<Detail>…</Detail>} />
|
|
61
|
+
- title: "A table beside the row it opened"
|
|
62
|
+
code: |
|
|
63
|
+
<MultiPane main={<Pane aria-label="Orders"><Table>…</Table></Pane>} aside={open && <Detail>…</Detail>} />
|
|
64
|
+
anti_patterns:
|
|
65
|
+
- "Don't define a component in a pane's prop (main={() => <Detail />}, or a component declared inside the screen's render): each render makes a new component, React mounts it again and its state goes (a draft, the scroll, the focus). Pass an element: main={<Detail />}"
|
|
66
|
+
- "Don't write a large block of JSX inside a pane's prop: put it in a variable or a small component of its own (nav={list} main={record})"
|
|
67
|
+
notes: "Sub-parts by data-slot: panes, multi-pane-alone (a pane alone, mode other than split and the first pane). Panel ids nav, main, aside (the keys of the kept sizes). Narrow under multiPaneNarrowWidth (640px) of its own box, a container query; three panes leave their aside out under multiPaneAsideWidth (800px), measured. ListDetail is its former name (list is nav, detail is main), kept for plugins built against it."
|