@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,93 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
|
|
3
|
+
import { copyText } from "../../../lib/clipboard";
|
|
4
|
+
import { cn } from "../../../lib/utils";
|
|
5
|
+
import { Button } from "../button";
|
|
6
|
+
import { Icon } from "../icon";
|
|
7
|
+
import { ScrollArea } from "../scroll-area";
|
|
8
|
+
|
|
9
|
+
// Code to read and copy (research-070): the kit's mono font on the hover tint, its long lines scrolling sideways (the
|
|
10
|
+
// kit's ScrollArea), a Copy button in its corner. Coloured when given `tokens`: the caller highlights (Shiki in its own
|
|
11
|
+
// bundle, its `css-variables` theme, as the docs plugin), never the kit, which every page loads; a token's colour is a
|
|
12
|
+
// `--shiki-*` variable this block sets from the theme's colours, so light, dark and skins follow.
|
|
13
|
+
|
|
14
|
+
interface CodeBlockProps extends Omit<React.ComponentProps<"div">, "children"> {
|
|
15
|
+
/** The code, as written (its line breaks and indentation kept). */
|
|
16
|
+
code: string;
|
|
17
|
+
/** Its language (`tsx`, `css`): `data-language`. */
|
|
18
|
+
language?: string;
|
|
19
|
+
/** The code cut into coloured pieces, line by line (Shiki's `codeToTokens(…).tokens`); none: plain. Copy copies
|
|
20
|
+
* `code`. */
|
|
21
|
+
tokens?: readonly (readonly CodeToken[])[] | undefined;
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
/** A piece of a line and its colour (a `var(--shiki-token-…)` from Shiki's css-variables theme, or any colour). */
|
|
25
|
+
interface CodeToken {
|
|
26
|
+
content: string;
|
|
27
|
+
color?: string | undefined;
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/** The `--shiki-*` variables a css-variables token names, from the theme's own colours (light, dark and skins follow):
|
|
31
|
+
* tags blue, attributes amber, keywords red, strings green, punctuation grey. */
|
|
32
|
+
const palette = [
|
|
33
|
+
"[--shiki-foreground:var(--fg)] [--shiki-color-text:var(--fg)] [--shiki-token-parameter:var(--fg)]",
|
|
34
|
+
"[--shiki-token-constant:var(--accent)] [--shiki-token-link:var(--accent)]",
|
|
35
|
+
"[--shiki-token-function:var(--warning-text)]",
|
|
36
|
+
"[--shiki-token-keyword:var(--label-bug-fg)]",
|
|
37
|
+
"[--shiki-token-string:var(--label-improvement-fg)] [--shiki-token-string-expression:var(--label-improvement-fg)]",
|
|
38
|
+
"[--shiki-token-punctuation:var(--fg-secondary)] [--shiki-token-comment:var(--fg-muted)]",
|
|
39
|
+
].join(" ");
|
|
40
|
+
|
|
41
|
+
function CodeBlock({ code, language, tokens, className, ...props }: CodeBlockProps) {
|
|
42
|
+
const [copied, setCopied] = React.useState(false);
|
|
43
|
+
const timer = React.useRef<ReturnType<typeof setTimeout>>(undefined);
|
|
44
|
+
React.useEffect(() => () => clearTimeout(timer.current), []);
|
|
45
|
+
const copy = () => {
|
|
46
|
+
copyText(code)
|
|
47
|
+
.then(() => {
|
|
48
|
+
setCopied(true);
|
|
49
|
+
clearTimeout(timer.current);
|
|
50
|
+
timer.current = setTimeout(() => setCopied(false), 1500);
|
|
51
|
+
})
|
|
52
|
+
.catch(() => setCopied(false));
|
|
53
|
+
};
|
|
54
|
+
return (
|
|
55
|
+
<div
|
|
56
|
+
data-slot="code-block"
|
|
57
|
+
{...(language !== undefined && { "data-language": language })}
|
|
58
|
+
className={cn("group relative rounded-dropdown bg-hover", palette, className)}
|
|
59
|
+
{...props}
|
|
60
|
+
>
|
|
61
|
+
<ScrollArea orientation="horizontal">
|
|
62
|
+
<pre className="m-0 px-3.5 py-3 font-mono text-xs leading-relaxed whitespace-pre">
|
|
63
|
+
<code>
|
|
64
|
+
{tokens
|
|
65
|
+
? tokens.map((line, i) => (
|
|
66
|
+
<React.Fragment key={i}>
|
|
67
|
+
{i > 0 && "\n"}
|
|
68
|
+
{line.map((token, j) => (
|
|
69
|
+
<span key={j} style={token.color ? { color: token.color } : undefined}>
|
|
70
|
+
{token.content}
|
|
71
|
+
</span>
|
|
72
|
+
))}
|
|
73
|
+
</React.Fragment>
|
|
74
|
+
))
|
|
75
|
+
: code}
|
|
76
|
+
</code>
|
|
77
|
+
</pre>
|
|
78
|
+
</ScrollArea>
|
|
79
|
+
<Button
|
|
80
|
+
variant="ghost"
|
|
81
|
+
size="icon-sm"
|
|
82
|
+
aria-label={copied ? "Copied" : "Copy code"}
|
|
83
|
+
onClick={copy}
|
|
84
|
+
className="absolute top-1.5 right-1.5 opacity-0 group-hover:opacity-100 focus-visible:opacity-100 [@media(hover:none)]:opacity-100"
|
|
85
|
+
>
|
|
86
|
+
<Icon name={copied ? "check" : "copy"} size={14} />
|
|
87
|
+
</Button>
|
|
88
|
+
</div>
|
|
89
|
+
);
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
export { CodeBlock };
|
|
93
|
+
export type { CodeBlockProps, CodeToken };
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
name: Collapsible
|
|
2
|
+
description: "Base UI's Collapsible under the kit's look: CollapsibleTrigger (its label after a chevron, turned down while open) shows or hides CollapsiblePanel. Closed by default."
|
|
3
|
+
layer: core
|
|
4
|
+
category: disclosure
|
|
5
|
+
when_to_use:
|
|
6
|
+
- "Something most people need not see at first: a sample's code, advanced settings, a long detail"
|
|
7
|
+
when_not_to_use:
|
|
8
|
+
- "A list whose groups fold — use List's ListGroup collapsible"
|
|
9
|
+
- "Rows that fold under a heading in a card — use CollapsibleRows"
|
|
10
|
+
props:
|
|
11
|
+
- name: defaultOpen
|
|
12
|
+
type: boolean
|
|
13
|
+
required: false
|
|
14
|
+
default: "false"
|
|
15
|
+
description: "Collapsible: open at first (uncontrolled)"
|
|
16
|
+
- name: open
|
|
17
|
+
type: boolean
|
|
18
|
+
required: false
|
|
19
|
+
description: "Collapsible: open or closed, driven with onOpenChange"
|
|
20
|
+
- name: onOpenChange
|
|
21
|
+
type: "(open: boolean) => void"
|
|
22
|
+
required: false
|
|
23
|
+
description: "Collapsible: called when the trigger opens or closes it"
|
|
24
|
+
composition_partners:
|
|
25
|
+
- CodeBlock (a sample's code, closed under it)
|
|
26
|
+
examples:
|
|
27
|
+
- title: "A sample's code"
|
|
28
|
+
code: |
|
|
29
|
+
<Collapsible>
|
|
30
|
+
<CollapsibleTrigger>Code</CollapsibleTrigger>
|
|
31
|
+
<CollapsiblePanel><CodeBlock code={source} /></CollapsiblePanel>
|
|
32
|
+
</Collapsible>
|
|
33
|
+
accessibility_notes: "Base UI: the trigger is a button with aria-expanded and aria-controls naming the panel."
|
|
34
|
+
notes: "Sub-parts by data-slot: collapsible, collapsible-trigger (data-panel-open while open), collapsible-panel."
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
import { Collapsible as CollapsiblePrimitive } from "@base-ui/react/collapsible";
|
|
3
|
+
|
|
4
|
+
import { cn } from "../../../lib/utils";
|
|
5
|
+
import { Icon } from "../icon";
|
|
6
|
+
|
|
7
|
+
// Base UI's Collapsible under the kit's look (research-070): a trigger that shows or hides its panel, a chevron
|
|
8
|
+
// turning with it. Closed by default (`defaultOpen`, or `open` and `onOpenChange` to drive it).
|
|
9
|
+
|
|
10
|
+
function Collapsible(props: React.ComponentProps<typeof CollapsiblePrimitive.Root>) {
|
|
11
|
+
return <CollapsiblePrimitive.Root data-slot="collapsible" {...props} />;
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
/** The trigger: its label after a chevron pointing right, down while open. */
|
|
15
|
+
function CollapsibleTrigger({
|
|
16
|
+
className,
|
|
17
|
+
children,
|
|
18
|
+
...props
|
|
19
|
+
}: React.ComponentProps<typeof CollapsiblePrimitive.Trigger>) {
|
|
20
|
+
return (
|
|
21
|
+
<CollapsiblePrimitive.Trigger
|
|
22
|
+
data-slot="collapsible-trigger"
|
|
23
|
+
className={cn(
|
|
24
|
+
"group inline-flex cursor-pointer items-center gap-1 rounded-control text-sm text-secondary outline-none select-none hover:text-foreground focus-visible:text-foreground focus-visible:ring-2 focus-visible:ring-accent/40",
|
|
25
|
+
className,
|
|
26
|
+
)}
|
|
27
|
+
{...props}
|
|
28
|
+
>
|
|
29
|
+
<Icon
|
|
30
|
+
name="chevron-right"
|
|
31
|
+
size={14}
|
|
32
|
+
aria-hidden
|
|
33
|
+
className="transition-transform duration-150 group-data-[panel-open]:rotate-90"
|
|
34
|
+
/>
|
|
35
|
+
{children}
|
|
36
|
+
</CollapsiblePrimitive.Trigger>
|
|
37
|
+
);
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
/** What the trigger shows and hides. */
|
|
41
|
+
function CollapsiblePanel({
|
|
42
|
+
className,
|
|
43
|
+
...props
|
|
44
|
+
}: React.ComponentProps<typeof CollapsiblePrimitive.Panel>) {
|
|
45
|
+
return (
|
|
46
|
+
<CollapsiblePrimitive.Panel
|
|
47
|
+
data-slot="collapsible-panel"
|
|
48
|
+
className={cn("pt-2", className)}
|
|
49
|
+
{...props}
|
|
50
|
+
/>
|
|
51
|
+
);
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
export { Collapsible, CollapsibleTrigger, CollapsiblePanel };
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export { Collapsible, CollapsibleTrigger, CollapsiblePanel } from "./collapsible";
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
name: ColourPicker
|
|
2
|
+
description: "A colour chosen first among the theme's accents (a row of swatches after the default), then among more of its colours (a popover, by group), then any (the popover's Custom: the native picker and a CSS colour typed). The row reads out the chosen colour's name."
|
|
3
|
+
layer: core
|
|
4
|
+
category: input
|
|
5
|
+
when_to_use:
|
|
6
|
+
- "For a colour a user sets (a tile, a paint, an accent) that should follow the theme unless chosen otherwise"
|
|
7
|
+
- "When the theme's own colours are the likely choices and any colour is still allowed"
|
|
8
|
+
when_not_to_use:
|
|
9
|
+
- "For a few named options that are not colours — use SegmentGroup"
|
|
10
|
+
composition_partners:
|
|
11
|
+
- Properties (as value in PropertyRow)
|
|
12
|
+
props:
|
|
13
|
+
- name: value
|
|
14
|
+
type: "string | undefined"
|
|
15
|
+
required: true
|
|
16
|
+
description: "The colour stored (often `var(--accent)`); undefined: the default"
|
|
17
|
+
- name: onChange
|
|
18
|
+
type: "(value: string | undefined) => void"
|
|
19
|
+
required: true
|
|
20
|
+
description: "A colour chosen; undefined: back to the default"
|
|
21
|
+
- name: swatches
|
|
22
|
+
type: "ColourSwatch[]"
|
|
23
|
+
required: false
|
|
24
|
+
description: "Offered inline (THEME_COLOURS)"
|
|
25
|
+
- name: groups
|
|
26
|
+
type: "ColourGroup[]"
|
|
27
|
+
required: false
|
|
28
|
+
description: "Offered in the popover, by group (THEME_COLOUR_GROUPS)"
|
|
29
|
+
- name: defaultColour
|
|
30
|
+
type: string
|
|
31
|
+
required: false
|
|
32
|
+
description: "What the default swatch draws (none: crossed out)"
|
|
33
|
+
- name: defaultName
|
|
34
|
+
type: string
|
|
35
|
+
required: false
|
|
36
|
+
description: "The default's name (Default)"
|
|
37
|
+
- name: theme
|
|
38
|
+
type: string
|
|
39
|
+
required: false
|
|
40
|
+
description: "The theme the swatches are drawn in (data-theme)"
|
|
41
|
+
props_priority:
|
|
42
|
+
- value
|
|
43
|
+
- onChange
|
|
44
|
+
- defaultColour
|
|
45
|
+
- theme
|
|
46
|
+
examples:
|
|
47
|
+
- title: "A paint colour following the theme"
|
|
48
|
+
code: '<ColourPicker value={c1} onChange={setC1} defaultColour="var(--paint-c1)" defaultName="Theme''s first paint colour" />'
|
|
49
|
+
anti_patterns:
|
|
50
|
+
- "Don't store a token's resolved value when the colour should follow the theme: store its reference (`var(--accent)`), as the swatches do"
|
|
51
|
+
- "Don't offer the theme's text or background colour for a surface: what is drawn on it would not read"
|
|
52
|
+
accessibility_notes: "Each swatch is a radio (role='radio', aria-checked) named by its colour; the inline row and each popover group are radiogroups. The popover opens from a 'More colours' button; Custom's field is labelled 'A CSS colour', committed on Enter or blur, Escape restoring the stored one."
|
|
@@ -0,0 +1,314 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
import { Popover as PopoverPrimitive } from "@base-ui/react/popover";
|
|
3
|
+
import { CSPProvider } from "@base-ui/react/csp-provider";
|
|
4
|
+
|
|
5
|
+
import { cn } from "../../../lib/utils";
|
|
6
|
+
import { Input } from "../input/input";
|
|
7
|
+
import {
|
|
8
|
+
THEME_COLOUR_GROUPS,
|
|
9
|
+
THEME_COLOURS,
|
|
10
|
+
type ColourGroup,
|
|
11
|
+
type ColourSwatch,
|
|
12
|
+
} from "../../../theme/theme-colours";
|
|
13
|
+
import { isComposing } from "../../../lib/keys";
|
|
14
|
+
|
|
15
|
+
// Bridge: a colour chosen first among a few (the theme's accents, inline), then among more (a popover, by group, the
|
|
16
|
+
// row's own first), then any (the popover's Custom: the native picker and a CSS colour typed). A swatch's value is its
|
|
17
|
+
// CSS colour as stored, often a reference to a theme token (`var(--accent)`), so it follows the theme; the swatches are
|
|
18
|
+
// drawn in `theme` (`data-theme`), the name of the one chosen read out under them.
|
|
19
|
+
|
|
20
|
+
interface ColourPickerProps {
|
|
21
|
+
/** The colour stored; `undefined`: the default. */
|
|
22
|
+
value: string | undefined;
|
|
23
|
+
/** A colour chosen (`undefined`: back to the default). */
|
|
24
|
+
onChange: (value: string | undefined) => void;
|
|
25
|
+
/** Offered inline, after the default. */
|
|
26
|
+
swatches?: readonly ColourSwatch[];
|
|
27
|
+
/** Offered in the popover, by group, before Custom. */
|
|
28
|
+
groups?: readonly ColourGroup[];
|
|
29
|
+
/** What the default draws (a CSS colour; none: a crossed-out swatch), and its name. */
|
|
30
|
+
defaultColour?: string | undefined;
|
|
31
|
+
defaultName?: string;
|
|
32
|
+
/** The theme the swatches are drawn in (`data-theme`); none: the page's. */
|
|
33
|
+
theme?: string | undefined;
|
|
34
|
+
disabled?: boolean;
|
|
35
|
+
invalid?: boolean;
|
|
36
|
+
"aria-labelledby"?: string;
|
|
37
|
+
className?: string;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
/** A crossed-out swatch: no colour of its own. */
|
|
41
|
+
const unset =
|
|
42
|
+
"linear-gradient(to top right, transparent calc(50% - 1px), var(--color-destructive) calc(50% - 0.5px) calc(50% + 0.5px), transparent calc(50% + 1px)), var(--color-surface)";
|
|
43
|
+
|
|
44
|
+
/** A swatch as a radio: its colour, ringed when chosen. */
|
|
45
|
+
function Dot({
|
|
46
|
+
colour,
|
|
47
|
+
name,
|
|
48
|
+
checked,
|
|
49
|
+
dashed,
|
|
50
|
+
disabled,
|
|
51
|
+
theme,
|
|
52
|
+
onPick,
|
|
53
|
+
}: {
|
|
54
|
+
colour: string | undefined;
|
|
55
|
+
theme: string | undefined;
|
|
56
|
+
name: string;
|
|
57
|
+
checked: boolean;
|
|
58
|
+
dashed?: boolean;
|
|
59
|
+
disabled?: boolean | undefined;
|
|
60
|
+
onPick: () => void;
|
|
61
|
+
}) {
|
|
62
|
+
return (
|
|
63
|
+
<button
|
|
64
|
+
type="button"
|
|
65
|
+
role="radio"
|
|
66
|
+
aria-checked={checked}
|
|
67
|
+
aria-label={name}
|
|
68
|
+
title={name}
|
|
69
|
+
disabled={disabled}
|
|
70
|
+
onClick={onPick}
|
|
71
|
+
data-slot="colour-swatch"
|
|
72
|
+
className={cn(
|
|
73
|
+
"size-5 shrink-0 cursor-pointer overflow-hidden rounded-full border border-input p-0 outline-hidden transition-shadow focus-visible:ring-2 focus-visible:ring-accent disabled:cursor-default disabled:opacity-50",
|
|
74
|
+
dashed && "border-dashed border-muted",
|
|
75
|
+
checked && "ring-2 ring-accent ring-offset-2 ring-offset-surface",
|
|
76
|
+
)}
|
|
77
|
+
>
|
|
78
|
+
{/* Its colour in the swatches' theme; the ring in the page's. */}
|
|
79
|
+
<span
|
|
80
|
+
data-theme={theme}
|
|
81
|
+
className="block size-full rounded-full"
|
|
82
|
+
style={{ background: colour ?? unset }}
|
|
83
|
+
/>
|
|
84
|
+
</button>
|
|
85
|
+
);
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
/** `colour` as `#rrggbb` for the native picker: a token resolved on `scope`, then drawn on a canvas. */
|
|
89
|
+
function hexOf(colour: string, scope: Element | null): string {
|
|
90
|
+
const name = /^var\((--[a-z0-9-]+)\)$/.exec(colour)?.[1];
|
|
91
|
+
const resolved = name && scope ? getComputedStyle(scope).getPropertyValue(name).trim() : colour;
|
|
92
|
+
const context = document.createElement("canvas").getContext("2d", { willReadFrequently: true });
|
|
93
|
+
if (!context) return "#808080";
|
|
94
|
+
context.fillStyle = "#808080";
|
|
95
|
+
context.fillStyle = resolved;
|
|
96
|
+
context.fillRect(0, 0, 1, 1);
|
|
97
|
+
const [r, g, b] = context.getImageData(0, 0, 1, 1).data;
|
|
98
|
+
return `#${[r, g, b].map((n) => n!.toString(16).padStart(2, "0")).join("")}`;
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
/** A colour among the theme's first (inline), then more (the popover), then any (Custom). */
|
|
102
|
+
function ColourPicker({
|
|
103
|
+
value,
|
|
104
|
+
onChange,
|
|
105
|
+
swatches = THEME_COLOURS,
|
|
106
|
+
groups = THEME_COLOUR_GROUPS,
|
|
107
|
+
defaultColour,
|
|
108
|
+
defaultName = "Default",
|
|
109
|
+
theme,
|
|
110
|
+
disabled,
|
|
111
|
+
invalid,
|
|
112
|
+
"aria-labelledby": labelledBy,
|
|
113
|
+
className,
|
|
114
|
+
}: ColourPickerProps) {
|
|
115
|
+
const [open, setOpen] = React.useState(false);
|
|
116
|
+
const scope = React.useRef<HTMLSpanElement>(null);
|
|
117
|
+
/** The picker's colour waiting for `timer`: chosen once it rests, or when the picker goes. */
|
|
118
|
+
const timer = React.useRef<ReturnType<typeof setTimeout>>(undefined);
|
|
119
|
+
const waiting = React.useRef<string>(undefined);
|
|
120
|
+
/** The latest props, for a colour chosen after a render (the timer, the picker going). */
|
|
121
|
+
const latest = React.useRef({ value, onChange });
|
|
122
|
+
latest.current = { value, onChange };
|
|
123
|
+
const pick = (next: string | undefined) => {
|
|
124
|
+
clearTimeout(timer.current);
|
|
125
|
+
waiting.current = undefined;
|
|
126
|
+
if (next !== latest.current.value) latest.current.onChange(next);
|
|
127
|
+
};
|
|
128
|
+
React.useEffect(
|
|
129
|
+
() => () => {
|
|
130
|
+
if (waiting.current !== undefined) pick(waiting.current);
|
|
131
|
+
},
|
|
132
|
+
[],
|
|
133
|
+
);
|
|
134
|
+
const offered = [...swatches, ...groups.flatMap((group) => group.swatches)];
|
|
135
|
+
const named = offered.find((swatch) => swatch.value === value);
|
|
136
|
+
/** What Custom's field shows: a colour of its own, none for the default or a theme colour. */
|
|
137
|
+
const own = value !== undefined && named === undefined ? value : "";
|
|
138
|
+
const [text, setText] = React.useState(own);
|
|
139
|
+
React.useEffect(() => setText(own), [own]);
|
|
140
|
+
const commit = (typed: string) => pick(typed.trim() === "" ? undefined : typed.trim());
|
|
141
|
+
return (
|
|
142
|
+
<div
|
|
143
|
+
data-slot="colour-picker"
|
|
144
|
+
data-swatch-theme={theme}
|
|
145
|
+
className={cn("flex min-w-0 flex-col gap-1", className)}
|
|
146
|
+
>
|
|
147
|
+
{/* Where a token resolves in the swatches' theme (the native picker's colour). */}
|
|
148
|
+
<span ref={scope} data-theme={theme} hidden />
|
|
149
|
+
<div className="flex items-center gap-1.5">
|
|
150
|
+
<div role="radiogroup" aria-labelledby={labelledBy} className="flex items-center gap-1.5">
|
|
151
|
+
<Dot
|
|
152
|
+
colour={defaultColour}
|
|
153
|
+
name={defaultName}
|
|
154
|
+
dashed
|
|
155
|
+
theme={theme}
|
|
156
|
+
checked={value === undefined}
|
|
157
|
+
disabled={disabled}
|
|
158
|
+
onPick={() => pick(undefined)}
|
|
159
|
+
/>
|
|
160
|
+
{swatches.map((swatch) => (
|
|
161
|
+
<Dot
|
|
162
|
+
key={swatch.value}
|
|
163
|
+
colour={swatch.value}
|
|
164
|
+
name={swatch.name}
|
|
165
|
+
theme={theme}
|
|
166
|
+
checked={swatch.value === value}
|
|
167
|
+
disabled={disabled}
|
|
168
|
+
onPick={() => pick(swatch.value)}
|
|
169
|
+
/>
|
|
170
|
+
))}
|
|
171
|
+
</div>
|
|
172
|
+
<PopoverPrimitive.Root open={open} onOpenChange={setOpen}>
|
|
173
|
+
<PopoverPrimitive.Trigger
|
|
174
|
+
disabled={disabled}
|
|
175
|
+
aria-label="More colours"
|
|
176
|
+
title="More colours"
|
|
177
|
+
data-slot="colour-more"
|
|
178
|
+
className="grid size-5 shrink-0 cursor-pointer place-items-center rounded-full border border-input bg-transparent text-xs leading-none text-secondary outline-hidden hover:bg-hover focus-visible:ring-2 focus-visible:ring-accent disabled:cursor-default disabled:opacity-50 data-popup-open:bg-active"
|
|
179
|
+
>
|
|
180
|
+
⋯
|
|
181
|
+
</PopoverPrimitive.Trigger>
|
|
182
|
+
<CSPProvider disableStyleElements>
|
|
183
|
+
<PopoverPrimitive.Portal>
|
|
184
|
+
<PopoverPrimitive.Positioner sideOffset={6} align="start" className="z-50">
|
|
185
|
+
<PopoverPrimitive.Popup
|
|
186
|
+
data-slot="colour-popover"
|
|
187
|
+
className="flex w-64 flex-col gap-3 rounded-dropdown bg-surface p-3 outline-none"
|
|
188
|
+
style={{ boxShadow: "var(--shadow-dropdown)" }}
|
|
189
|
+
>
|
|
190
|
+
<div className="flex flex-col gap-2.5">
|
|
191
|
+
{/* The row's own first: the default and the inline swatches, under the first one's group. */}
|
|
192
|
+
<div role="radiogroup" aria-label="Theme" className="flex items-center gap-2">
|
|
193
|
+
<span className="w-16 shrink-0 text-xs text-muted">Theme</span>
|
|
194
|
+
<div className="flex flex-wrap gap-1.5">
|
|
195
|
+
<Dot
|
|
196
|
+
colour={defaultColour}
|
|
197
|
+
name={defaultName}
|
|
198
|
+
dashed
|
|
199
|
+
theme={theme}
|
|
200
|
+
checked={value === undefined}
|
|
201
|
+
onPick={() => {
|
|
202
|
+
pick(undefined);
|
|
203
|
+
setOpen(false);
|
|
204
|
+
}}
|
|
205
|
+
/>
|
|
206
|
+
{swatches.map((swatch) => (
|
|
207
|
+
<Dot
|
|
208
|
+
key={swatch.value}
|
|
209
|
+
colour={swatch.value}
|
|
210
|
+
name={swatch.name}
|
|
211
|
+
theme={theme}
|
|
212
|
+
checked={swatch.value === value}
|
|
213
|
+
onPick={() => {
|
|
214
|
+
pick(swatch.value);
|
|
215
|
+
setOpen(false);
|
|
216
|
+
}}
|
|
217
|
+
/>
|
|
218
|
+
))}
|
|
219
|
+
</div>
|
|
220
|
+
</div>
|
|
221
|
+
{groups.map((group) => (
|
|
222
|
+
<div
|
|
223
|
+
key={group.label}
|
|
224
|
+
role="radiogroup"
|
|
225
|
+
aria-label={group.label}
|
|
226
|
+
className="flex items-center gap-2"
|
|
227
|
+
>
|
|
228
|
+
<span className="w-16 shrink-0 text-xs text-muted">{group.label}</span>
|
|
229
|
+
<div className="flex flex-wrap gap-1.5">
|
|
230
|
+
{group.swatches.map((swatch) => (
|
|
231
|
+
<Dot
|
|
232
|
+
key={swatch.value}
|
|
233
|
+
colour={swatch.value}
|
|
234
|
+
name={swatch.name}
|
|
235
|
+
theme={theme}
|
|
236
|
+
checked={swatch.value === value}
|
|
237
|
+
onPick={() => {
|
|
238
|
+
pick(swatch.value);
|
|
239
|
+
setOpen(false);
|
|
240
|
+
}}
|
|
241
|
+
/>
|
|
242
|
+
))}
|
|
243
|
+
</div>
|
|
244
|
+
</div>
|
|
245
|
+
))}
|
|
246
|
+
</div>
|
|
247
|
+
<div className="h-px bg-border" />
|
|
248
|
+
<div className="flex flex-col gap-1.5">
|
|
249
|
+
<span className="text-xs text-muted">Custom</span>
|
|
250
|
+
<div className="flex items-center gap-2">
|
|
251
|
+
<label className="relative block size-(--height-md) shrink-0 cursor-pointer overflow-hidden rounded-control border border-input">
|
|
252
|
+
<span
|
|
253
|
+
data-theme={theme}
|
|
254
|
+
className="absolute inset-0"
|
|
255
|
+
style={{ background: value ?? defaultColour ?? unset }}
|
|
256
|
+
/>
|
|
257
|
+
<input
|
|
258
|
+
type="color"
|
|
259
|
+
aria-label="Pick a colour"
|
|
260
|
+
value={hexOf(value ?? defaultColour ?? "#808080", scope.current)}
|
|
261
|
+
className="absolute inset-0 size-full cursor-[inherit] opacity-0"
|
|
262
|
+
// While the picker drags: shown, then chosen once it rests.
|
|
263
|
+
onChange={(event) => {
|
|
264
|
+
const picked = event.target.value;
|
|
265
|
+
setText(picked);
|
|
266
|
+
clearTimeout(timer.current);
|
|
267
|
+
waiting.current = picked;
|
|
268
|
+
timer.current = setTimeout(() => commit(picked), 200);
|
|
269
|
+
}}
|
|
270
|
+
/>
|
|
271
|
+
</label>
|
|
272
|
+
<Input
|
|
273
|
+
variant="outline"
|
|
274
|
+
aria-label="A CSS colour"
|
|
275
|
+
aria-invalid={invalid || undefined}
|
|
276
|
+
spellCheck={false}
|
|
277
|
+
autoComplete="off"
|
|
278
|
+
placeholder="#2f855a, oklch(62% 0.14 165)…"
|
|
279
|
+
className="min-w-0 flex-1 font-mono text-xs"
|
|
280
|
+
value={text}
|
|
281
|
+
onChange={(event) => setText(event.currentTarget.value)}
|
|
282
|
+
onBlur={(event) => commit(event.currentTarget.value)}
|
|
283
|
+
onKeyDown={(event) => {
|
|
284
|
+
if (event.key === "Enter" && !isComposing(event))
|
|
285
|
+
commit(event.currentTarget.value);
|
|
286
|
+
else if (event.key === "Escape") setText(own);
|
|
287
|
+
}}
|
|
288
|
+
/>
|
|
289
|
+
</div>
|
|
290
|
+
</div>
|
|
291
|
+
</PopoverPrimitive.Popup>
|
|
292
|
+
</PopoverPrimitive.Positioner>
|
|
293
|
+
</PopoverPrimitive.Portal>
|
|
294
|
+
</CSPProvider>
|
|
295
|
+
</PopoverPrimitive.Root>
|
|
296
|
+
</div>
|
|
297
|
+
{/* Under the row, so a long name never pushes what follows. */}
|
|
298
|
+
<span
|
|
299
|
+
data-slot="colour-name"
|
|
300
|
+
title={value}
|
|
301
|
+
className={cn(
|
|
302
|
+
"min-w-0 truncate text-xs",
|
|
303
|
+
invalid ? "text-destructive" : "text-secondary",
|
|
304
|
+
value !== undefined && named === undefined && "font-mono",
|
|
305
|
+
)}
|
|
306
|
+
>
|
|
307
|
+
{value === undefined ? defaultName : (named?.name ?? value)}
|
|
308
|
+
</span>
|
|
309
|
+
</div>
|
|
310
|
+
);
|
|
311
|
+
}
|
|
312
|
+
|
|
313
|
+
export { ColourPicker };
|
|
314
|
+
export type { ColourPickerProps };
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
name: Combobox
|
|
2
|
+
description: "Single-value picker on Base UI: an input framed like Input outline to type in, and a Select-style popup of the caller's items, filtered in place or searched on the server."
|
|
3
|
+
layer: core
|
|
4
|
+
category: input
|
|
5
|
+
when_to_use:
|
|
6
|
+
- "For choosing one record from a long list, or one loaded from the server as the user types"
|
|
7
|
+
when_not_to_use:
|
|
8
|
+
- "For a short fixed list — use Select"
|
|
9
|
+
- "For several values — use TagInput"
|
|
10
|
+
- "For a property on a detail card (a pill that opens a searchable menu) — use Picker"
|
|
11
|
+
composition_partners:
|
|
12
|
+
- Field (label, description, error)
|
|
13
|
+
props:
|
|
14
|
+
- name: value / onValueChange
|
|
15
|
+
type: "Item | null / (item: Item) => void | Promise<unknown>"
|
|
16
|
+
required: true
|
|
17
|
+
description: "Controlled selection, matched by itemToKey. Clearing the text or Escape never picks null (the value stays): offer a 'None' item to unassign. When onValueChange returns a promise (an async save), the picked label shows until value changes or the promise settles (a failure reverts to value)"
|
|
18
|
+
- name: items
|
|
19
|
+
type: "readonly Item[]"
|
|
20
|
+
required: true
|
|
21
|
+
description: "What the popup offers now"
|
|
22
|
+
- name: itemToString / itemToKey
|
|
23
|
+
type: "(item: Item) => string"
|
|
24
|
+
required: true
|
|
25
|
+
description: "The item's label (input text, default filter) and its identity (selected check, keys)"
|
|
26
|
+
- name: onInputChange
|
|
27
|
+
type: "(text: string) => void"
|
|
28
|
+
required: false
|
|
29
|
+
description: "The text the user types, and '' once the popup has closed: the caller fetches here"
|
|
30
|
+
- name: onOpenChange
|
|
31
|
+
type: "(open: boolean) => void"
|
|
32
|
+
required: false
|
|
33
|
+
description: "The popup opened or closed, e.g. to retry a failed load on open"
|
|
34
|
+
- name: filter
|
|
35
|
+
type: "null"
|
|
36
|
+
required: false
|
|
37
|
+
description: "null shows items unfiltered (server-searched); by default 'contains', any case and accent"
|
|
38
|
+
- name: loading / emptyText
|
|
39
|
+
type: "boolean / ReactNode"
|
|
40
|
+
required: false
|
|
41
|
+
default: "false / 'No results'"
|
|
42
|
+
description: "Shown while the list is empty: 'Loading…' while loading, else emptyText (also for a fetch error)"
|
|
43
|
+
- name: renderItem
|
|
44
|
+
type: "(item: Item) => ReactNode"
|
|
45
|
+
required: false
|
|
46
|
+
description: "An item's row content; defaults to its label"
|
|
47
|
+
- name: size
|
|
48
|
+
type: "'sm' | 'default' | 'lg'"
|
|
49
|
+
required: false
|
|
50
|
+
default: "'default'"
|
|
51
|
+
description: "Height, as SelectTrigger, Input and Button: sm (h-sm, 26px) in property rows, default (h-md, 30px), lg (h-lg, 34px) in a form whose controls all take lg; at the look's default Control height, which they follow"
|
|
52
|
+
- name: placeholder / disabled / readOnly / aria-label / className
|
|
53
|
+
type: "string / boolean / boolean / string / string"
|
|
54
|
+
required: false
|
|
55
|
+
description: "className goes on the frame"
|
|
56
|
+
examples:
|
|
57
|
+
- title: "Server-searched organization"
|
|
58
|
+
code: |
|
|
59
|
+
const [query, setQuery] = useState("");
|
|
60
|
+
const { items, loading, error } = useOrganizations(query); // GET /organizations?q=…&take=20
|
|
61
|
+
|
|
62
|
+
<Combobox
|
|
63
|
+
aria-label="Organization"
|
|
64
|
+
size="sm"
|
|
65
|
+
value={current}
|
|
66
|
+
onValueChange={(org) => save(org.id)}
|
|
67
|
+
items={[none, ...items]}
|
|
68
|
+
itemToString={(org) => org.name}
|
|
69
|
+
itemToKey={(org) => org.id}
|
|
70
|
+
onInputChange={setQuery}
|
|
71
|
+
filter={null}
|
|
72
|
+
loading={loading}
|
|
73
|
+
emptyText={error ? "Organizations could not be loaded" : "No organizations"}
|
|
74
|
+
/>
|
|
75
|
+
accessibility_notes: "Base UI combobox semantics (input role=combobox, listbox popup, aria-activedescendant); ↑↓ move, Enter picks, Escape closes and reverts the text, Tab leaves; the empty/loading text is a polite live region; labelled by aria-label or a surrounding FieldLabel."
|