@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,72 @@
|
|
|
1
|
+
name: Section
|
|
2
|
+
description: "A titled block of content at three scales: a page's title and lead (lg), a section of that page (default), a captioned item inside one (sm). Optional description and header actions; the children follow."
|
|
3
|
+
layer: core
|
|
4
|
+
category: layout
|
|
5
|
+
when_to_use:
|
|
6
|
+
- "For a page's title and its one-line lead, above the page's sections (size='lg')"
|
|
7
|
+
- "For a titled group of a page: a settings group, a design-system story's 'Variants' (size='default')"
|
|
8
|
+
- "For a caption over one item: a colour token, a component variant (size='sm')"
|
|
9
|
+
when_not_to_use:
|
|
10
|
+
- "For a bordered surface — wrap the content in a Card (a Section inside a Card, or Cards inside a Section)"
|
|
11
|
+
- "For a property list — use Properties and PropertyRow"
|
|
12
|
+
- "For navigation group labels — use SidebarSection or ListGroup"
|
|
13
|
+
composition_partners:
|
|
14
|
+
- Card (the frame a section's content sits in)
|
|
15
|
+
- Input (a search field in actions)
|
|
16
|
+
- Button (an action in actions)
|
|
17
|
+
props:
|
|
18
|
+
- name: title
|
|
19
|
+
type: React.ReactNode
|
|
20
|
+
required: true
|
|
21
|
+
description: "The heading, which names the section (aria-labelledby): h2 at lg, h3 at default, h4 at sm"
|
|
22
|
+
- name: description
|
|
23
|
+
type: React.ReactNode
|
|
24
|
+
required: false
|
|
25
|
+
description: "A line under the title: text-sm secondary at lg, text-xs muted otherwise"
|
|
26
|
+
- name: actions
|
|
27
|
+
type: React.ReactNode
|
|
28
|
+
required: false
|
|
29
|
+
description: "At the header's end, top-aligned with the title (a search field, a button)"
|
|
30
|
+
- name: size
|
|
31
|
+
type: "'sm' | 'default' | 'lg'"
|
|
32
|
+
required: false
|
|
33
|
+
default: "'default'"
|
|
34
|
+
description: "The scale: the heading's level and type, and the gap between header and children"
|
|
35
|
+
- name: children
|
|
36
|
+
type: React.ReactNode
|
|
37
|
+
required: false
|
|
38
|
+
description: "The content, after the header"
|
|
39
|
+
props_priority:
|
|
40
|
+
- title
|
|
41
|
+
- size
|
|
42
|
+
- description
|
|
43
|
+
- actions
|
|
44
|
+
- children
|
|
45
|
+
variants:
|
|
46
|
+
- lg: "text-xl semibold title (h2), text-sm secondary description, gap-8 — a page"
|
|
47
|
+
- default: "text-sm semibold title (h3), text-xs muted description, gap-3 — a section"
|
|
48
|
+
- sm: "text-xs medium secondary title (h4), text-xs muted description, gap-2 — a caption"
|
|
49
|
+
sizes:
|
|
50
|
+
- sm: "gap-2"
|
|
51
|
+
- default: "gap-3"
|
|
52
|
+
- lg: "gap-8"
|
|
53
|
+
examples:
|
|
54
|
+
- title: "A page of sections"
|
|
55
|
+
code: |
|
|
56
|
+
<Section size="lg" title="Button" description="Triggers an action.">
|
|
57
|
+
<Section title="Variants">
|
|
58
|
+
<Card variant="outline" size="lg">
|
|
59
|
+
<Section size="sm" title="primary"><Button variant="primary">Save</Button></Section>
|
|
60
|
+
</Card>
|
|
61
|
+
</Section>
|
|
62
|
+
</Section>
|
|
63
|
+
- title: "Header actions"
|
|
64
|
+
code: |
|
|
65
|
+
<Section title="Icons" actions={<Input variant="outline" size="default" placeholder="Search" />}>
|
|
66
|
+
…
|
|
67
|
+
</Section>
|
|
68
|
+
anti_patterns:
|
|
69
|
+
- "Don't style plain text as a heading in a plugin — use Section"
|
|
70
|
+
- "Don't put a border or background on Section — compose it with Card"
|
|
71
|
+
accessibility_notes: "Renders a <section> labelled by its heading (a region landmark). Heading levels are fixed by size (h2, h3, h4): nest lg > default > sm for a correct outline."
|
|
72
|
+
notes: "Sub-parts by data-slot: section, section-header, section-title, section-description, section-actions. The title truncates on one line, except at `lg` (a page title), which wraps; the description wraps."
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
import { cva, type VariantProps } from "class-variance-authority";
|
|
3
|
+
|
|
4
|
+
import { cn } from "../../../lib/utils";
|
|
5
|
+
|
|
6
|
+
// Bridge: a titled block of content at three scales, the kit's only typography for headings: `lg` a page's title
|
|
7
|
+
// and lead (h2), `default` a section of that page (h3), `sm` a captioned item inside one (h4: a token, a variant).
|
|
8
|
+
// Optional `description` under the title and `actions` at the header's end; the children follow.
|
|
9
|
+
|
|
10
|
+
const sectionVariants = cva("flex min-w-0 flex-col", {
|
|
11
|
+
variants: {
|
|
12
|
+
size: {
|
|
13
|
+
sm: "gap-2",
|
|
14
|
+
default: "gap-3",
|
|
15
|
+
lg: "gap-8",
|
|
16
|
+
},
|
|
17
|
+
},
|
|
18
|
+
defaultVariants: { size: "default" },
|
|
19
|
+
});
|
|
20
|
+
|
|
21
|
+
const titles = {
|
|
22
|
+
sm: "text-xs font-medium text-secondary",
|
|
23
|
+
default: "text-sm font-semibold text-foreground",
|
|
24
|
+
lg: "text-xl font-semibold text-foreground",
|
|
25
|
+
} as const;
|
|
26
|
+
|
|
27
|
+
const descriptions = {
|
|
28
|
+
sm: "text-xs text-muted",
|
|
29
|
+
default: "text-xs text-muted",
|
|
30
|
+
lg: "text-sm text-secondary",
|
|
31
|
+
} as const;
|
|
32
|
+
|
|
33
|
+
const headings = { sm: "h4", default: "h3", lg: "h2" } as const;
|
|
34
|
+
|
|
35
|
+
interface SectionProps
|
|
36
|
+
extends Omit<React.ComponentProps<"section">, "title">, VariantProps<typeof sectionVariants> {
|
|
37
|
+
/** The heading: h2 at `lg`, h3 at `default`, h4 at `sm`. Names the section. */
|
|
38
|
+
title: React.ReactNode;
|
|
39
|
+
/** A line under the title. */
|
|
40
|
+
description?: React.ReactNode;
|
|
41
|
+
/** At the header's end (a search field, a button). */
|
|
42
|
+
actions?: React.ReactNode;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
function Section({
|
|
46
|
+
className,
|
|
47
|
+
size,
|
|
48
|
+
title,
|
|
49
|
+
description,
|
|
50
|
+
actions,
|
|
51
|
+
children,
|
|
52
|
+
...props
|
|
53
|
+
}: SectionProps) {
|
|
54
|
+
const scale = size ?? "default";
|
|
55
|
+
const Heading = headings[scale];
|
|
56
|
+
const id = React.useId();
|
|
57
|
+
return (
|
|
58
|
+
<section
|
|
59
|
+
data-slot="section"
|
|
60
|
+
data-size={scale}
|
|
61
|
+
aria-labelledby={id}
|
|
62
|
+
className={cn(sectionVariants({ size: scale, className }))}
|
|
63
|
+
{...props}
|
|
64
|
+
>
|
|
65
|
+
<div data-slot="section-header" className="flex min-w-0 flex-wrap items-start gap-3">
|
|
66
|
+
<div className="flex min-w-0 flex-1 basis-64 flex-col gap-0.5">
|
|
67
|
+
<Heading
|
|
68
|
+
id={id}
|
|
69
|
+
data-slot="section-title"
|
|
70
|
+
// A page title (`lg`) wraps: cut, it could not be read; a section title stays on one line beside its actions.
|
|
71
|
+
className={cn("min-w-0", scale === "lg" ? "break-words" : "truncate", titles[scale])}
|
|
72
|
+
>
|
|
73
|
+
{title}
|
|
74
|
+
</Heading>
|
|
75
|
+
{description != null && description !== false && (
|
|
76
|
+
<p data-slot="section-description" className={descriptions[scale]}>
|
|
77
|
+
{description}
|
|
78
|
+
</p>
|
|
79
|
+
)}
|
|
80
|
+
</div>
|
|
81
|
+
{actions != null && actions !== false && (
|
|
82
|
+
<div data-slot="section-actions" className="ml-auto flex shrink-0 items-center gap-1">
|
|
83
|
+
{actions}
|
|
84
|
+
</div>
|
|
85
|
+
)}
|
|
86
|
+
</div>
|
|
87
|
+
{children}
|
|
88
|
+
</section>
|
|
89
|
+
);
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
export { Section, sectionVariants };
|
|
93
|
+
export type { SectionProps };
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
name: SegmentGroup
|
|
2
|
+
description: "Animated segmented control for single-value selection with radio-group semantics and sliding indicator."
|
|
3
|
+
layer: core
|
|
4
|
+
category: input
|
|
5
|
+
when_to_use:
|
|
6
|
+
- "For single-choice selection between 2-5 options"
|
|
7
|
+
- "For view mode toggles (e.g. list/board/calendar)"
|
|
8
|
+
- "For filter controls with mutually exclusive options"
|
|
9
|
+
when_not_to_use:
|
|
10
|
+
- "For on/off binary toggles — use Toggle component"
|
|
11
|
+
- "For navigation between views — use Tabs component"
|
|
12
|
+
- "For more than 5 options — use DropdownMenu or Select"
|
|
13
|
+
composition_partners:
|
|
14
|
+
- Properties (as value control in PropertyRow)
|
|
15
|
+
props:
|
|
16
|
+
- name: items
|
|
17
|
+
type: "SegmentGroupItem[]"
|
|
18
|
+
required: true
|
|
19
|
+
description: "Array of selectable items, each with value and label"
|
|
20
|
+
- name: value
|
|
21
|
+
type: string
|
|
22
|
+
required: true
|
|
23
|
+
description: "Currently selected value (controlled)"
|
|
24
|
+
- name: onValueChange
|
|
25
|
+
type: "(value: string) => void"
|
|
26
|
+
required: true
|
|
27
|
+
description: "Callback when selection changes"
|
|
28
|
+
- name: fullWidth
|
|
29
|
+
type: boolean
|
|
30
|
+
required: false
|
|
31
|
+
default: "false"
|
|
32
|
+
description: "Stretch the control to fill its container, with segments sharing the width equally (default false = content width)"
|
|
33
|
+
- name: size
|
|
34
|
+
type: "'sm' | 'default' | 'lg'"
|
|
35
|
+
required: false
|
|
36
|
+
default: "'default'"
|
|
37
|
+
description: "Height on the height tokens, as 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; its segments' padding and text follow"
|
|
38
|
+
props_priority:
|
|
39
|
+
- items
|
|
40
|
+
- value
|
|
41
|
+
- onValueChange
|
|
42
|
+
- fullWidth
|
|
43
|
+
examples:
|
|
44
|
+
- title: "View mode selector"
|
|
45
|
+
code: |
|
|
46
|
+
<SegmentGroup
|
|
47
|
+
items={[
|
|
48
|
+
{ value: "list", label: "List" },
|
|
49
|
+
{ value: "board", label: "Board" },
|
|
50
|
+
{ value: "calendar", label: "Calendar" },
|
|
51
|
+
]}
|
|
52
|
+
value={view}
|
|
53
|
+
onValueChange={setView}
|
|
54
|
+
/>
|
|
55
|
+
- title: "Priority selector"
|
|
56
|
+
code: |
|
|
57
|
+
<SegmentGroup
|
|
58
|
+
items={[
|
|
59
|
+
{ value: "low", label: "Low" },
|
|
60
|
+
{ value: "medium", label: "Medium" },
|
|
61
|
+
{ value: "high", label: "High" },
|
|
62
|
+
]}
|
|
63
|
+
value="medium"
|
|
64
|
+
onValueChange={setPriority}
|
|
65
|
+
/>
|
|
66
|
+
anti_patterns:
|
|
67
|
+
- "Don't use for more than 5 items — the horizontal layout becomes cramped"
|
|
68
|
+
- "Don't use for navigation — SegmentGroup is a form control, not a nav element"
|
|
69
|
+
- "Don't mix controlled and uncontrolled — SegmentGroup only supports controlled mode (value + onValueChange required)"
|
|
70
|
+
accessibility_notes: "Renders with radio-group semantics using hidden radio inputs. Each segment has a <label> with associated <input type='radio'>. Keyboard: Arrow keys navigate segments, auto-selects on focus. The sliding indicator is purely visual."
|
|
71
|
+
notes: "SegmentGroupItem type: { value: string, label: React.ReactNode }. The animated sliding indicator uses layoutId-style positioning based on the selected radio's getBoundingClientRect."
|
|
@@ -0,0 +1,166 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
import { cva, type VariantProps } from "class-variance-authority";
|
|
3
|
+
|
|
4
|
+
import { cn } from "../../../lib/utils";
|
|
5
|
+
|
|
6
|
+
// Its heights are Button's and Input's (h-sm, h-md, h-lg, default h-md): a group beside a button or a field lines up
|
|
7
|
+
// with it when both keep their default size.
|
|
8
|
+
const segmentGroupVariants = cva("relative items-center gap-px bg-active rounded-control p-0.5", {
|
|
9
|
+
variants: {
|
|
10
|
+
fullWidth: {
|
|
11
|
+
true: "flex w-full",
|
|
12
|
+
false: "inline-flex",
|
|
13
|
+
},
|
|
14
|
+
size: {
|
|
15
|
+
sm: "h-sm",
|
|
16
|
+
default: "h-md",
|
|
17
|
+
lg: "h-lg",
|
|
18
|
+
},
|
|
19
|
+
},
|
|
20
|
+
defaultVariants: {
|
|
21
|
+
fullWidth: false,
|
|
22
|
+
size: "default",
|
|
23
|
+
},
|
|
24
|
+
});
|
|
25
|
+
|
|
26
|
+
/** A segment's padding and text at each size, shared with ToggleGroup's items. */
|
|
27
|
+
const segmentItemSizes = {
|
|
28
|
+
sm: "px-1.5 text-xs",
|
|
29
|
+
default: "px-2 text-xs",
|
|
30
|
+
lg: "px-2.5 text-sm",
|
|
31
|
+
} as const;
|
|
32
|
+
|
|
33
|
+
interface SegmentGroupItem {
|
|
34
|
+
value: string;
|
|
35
|
+
label: React.ReactNode;
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
interface SegmentGroupProps
|
|
39
|
+
extends React.ComponentProps<"div">, VariantProps<typeof segmentGroupVariants> {
|
|
40
|
+
items: SegmentGroupItem[];
|
|
41
|
+
value: string;
|
|
42
|
+
onValueChange: (value: string) => void;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
function SegmentGroup({
|
|
46
|
+
className,
|
|
47
|
+
fullWidth,
|
|
48
|
+
size,
|
|
49
|
+
items,
|
|
50
|
+
value,
|
|
51
|
+
onValueChange,
|
|
52
|
+
...props
|
|
53
|
+
}: SegmentGroupProps) {
|
|
54
|
+
const containerRef = React.useRef<HTMLDivElement>(null);
|
|
55
|
+
const [rect, setRect] = React.useState<{
|
|
56
|
+
left: number;
|
|
57
|
+
width: number;
|
|
58
|
+
} | null>(null);
|
|
59
|
+
const [ready, setReady] = React.useState(false);
|
|
60
|
+
|
|
61
|
+
// Keyed on the values, not the array: a caller passing a new array at each render (`items={[...modes]}`) must not
|
|
62
|
+
// queue a new measure after every commit, which a burst of synchronous re-renders turns into React's
|
|
63
|
+
// "Maximum update depth exceeded" (bridge#131). A label that changes width is caught by the ResizeObserver.
|
|
64
|
+
const values = items.map((item) => item.value).join("\u0000");
|
|
65
|
+
|
|
66
|
+
React.useEffect(() => {
|
|
67
|
+
const container = containerRef.current;
|
|
68
|
+
if (!container) return;
|
|
69
|
+
const measure = () => {
|
|
70
|
+
const active = container.querySelector<HTMLButtonElement>('[aria-checked="true"]');
|
|
71
|
+
if (!active) {
|
|
72
|
+
setRect(null);
|
|
73
|
+
return;
|
|
74
|
+
}
|
|
75
|
+
const cRect = container.getBoundingClientRect();
|
|
76
|
+
const aRect = active.getBoundingClientRect();
|
|
77
|
+
const left = aRect.left - cRect.left;
|
|
78
|
+
const width = aRect.width;
|
|
79
|
+
setRect((previous) =>
|
|
80
|
+
previous && previous.left === left && previous.width === width ? previous : { left, width },
|
|
81
|
+
);
|
|
82
|
+
};
|
|
83
|
+
measure();
|
|
84
|
+
// enable transitions after first paint
|
|
85
|
+
if (!ready) {
|
|
86
|
+
requestAnimationFrame(() => {
|
|
87
|
+
setReady(true);
|
|
88
|
+
});
|
|
89
|
+
}
|
|
90
|
+
if (typeof ResizeObserver === "undefined") return;
|
|
91
|
+
const observer = new ResizeObserver(measure);
|
|
92
|
+
observer.observe(container);
|
|
93
|
+
for (const segment of container.querySelectorAll('[data-slot="segment"]'))
|
|
94
|
+
observer.observe(segment);
|
|
95
|
+
return () => observer.disconnect();
|
|
96
|
+
}, [value, values, ready, fullWidth]);
|
|
97
|
+
|
|
98
|
+
const handleKeyDown = (e: React.KeyboardEvent<HTMLButtonElement>, index: number) => {
|
|
99
|
+
let nextIndex: number | null = null;
|
|
100
|
+
if (e.key === "ArrowRight" || e.key === "ArrowDown") {
|
|
101
|
+
nextIndex = (index + 1) % items.length;
|
|
102
|
+
} else if (e.key === "ArrowLeft" || e.key === "ArrowUp") {
|
|
103
|
+
nextIndex = (index - 1 + items.length) % items.length;
|
|
104
|
+
}
|
|
105
|
+
if (nextIndex !== null) {
|
|
106
|
+
const nextItem = items[nextIndex];
|
|
107
|
+
if (!nextItem) return;
|
|
108
|
+
e.preventDefault();
|
|
109
|
+
onValueChange(nextItem.value);
|
|
110
|
+
const container = e.currentTarget.closest('[data-slot="segment-group"]');
|
|
111
|
+
const buttons = container?.querySelectorAll<HTMLButtonElement>('[role="radio"]');
|
|
112
|
+
buttons?.[nextIndex]?.focus();
|
|
113
|
+
}
|
|
114
|
+
};
|
|
115
|
+
|
|
116
|
+
return (
|
|
117
|
+
<div
|
|
118
|
+
ref={containerRef}
|
|
119
|
+
data-slot="segment-group"
|
|
120
|
+
role="radiogroup"
|
|
121
|
+
data-size={size ?? "default"}
|
|
122
|
+
className={cn(segmentGroupVariants({ fullWidth, size, className }))}
|
|
123
|
+
{...props}
|
|
124
|
+
>
|
|
125
|
+
{rect && (
|
|
126
|
+
<span
|
|
127
|
+
data-slot="segment-indicator"
|
|
128
|
+
className="absolute top-0.5 h-[calc(100%-4px)] rounded-control-inner bg-surface shadow-xs"
|
|
129
|
+
style={{
|
|
130
|
+
left: rect.left,
|
|
131
|
+
width: rect.width,
|
|
132
|
+
transition: ready
|
|
133
|
+
? "left 150ms cubic-bezier(0.4,0,0.2,1), width 150ms cubic-bezier(0.4,0,0.2,1)"
|
|
134
|
+
: "none",
|
|
135
|
+
}}
|
|
136
|
+
/>
|
|
137
|
+
)}
|
|
138
|
+
{items.map((item, index) => {
|
|
139
|
+
const isActive = value === item.value;
|
|
140
|
+
return (
|
|
141
|
+
<button
|
|
142
|
+
key={item.value}
|
|
143
|
+
data-slot="segment"
|
|
144
|
+
type="button"
|
|
145
|
+
role="radio"
|
|
146
|
+
aria-checked={isActive}
|
|
147
|
+
tabIndex={isActive ? 0 : -1}
|
|
148
|
+
className={cn(
|
|
149
|
+
"relative z-[1] flex items-center justify-center h-full rounded-control-inner bg-transparent font-medium cursor-pointer transition-colors duration-150",
|
|
150
|
+
segmentItemSizes[size ?? "default"],
|
|
151
|
+
fullWidth && "flex-1",
|
|
152
|
+
isActive ? "text-foreground" : "text-muted hover:text-secondary",
|
|
153
|
+
)}
|
|
154
|
+
onClick={() => onValueChange(item.value)}
|
|
155
|
+
onKeyDown={(e) => handleKeyDown(e, index)}
|
|
156
|
+
>
|
|
157
|
+
{item.label}
|
|
158
|
+
</button>
|
|
159
|
+
);
|
|
160
|
+
})}
|
|
161
|
+
</div>
|
|
162
|
+
);
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
export { SegmentGroup, segmentGroupVariants, segmentItemSizes };
|
|
166
|
+
export type { SegmentGroupProps, SegmentGroupItem };
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
export {
|
|
2
|
+
Select,
|
|
3
|
+
SelectTrigger,
|
|
4
|
+
SelectValue,
|
|
5
|
+
SelectContent,
|
|
6
|
+
SelectItem,
|
|
7
|
+
SelectGroup,
|
|
8
|
+
SelectLabel,
|
|
9
|
+
SelectSeparator,
|
|
10
|
+
} from "./select";
|
|
11
|
+
export type {
|
|
12
|
+
SelectProps,
|
|
13
|
+
SelectTriggerProps,
|
|
14
|
+
SelectValueProps,
|
|
15
|
+
SelectContentProps,
|
|
16
|
+
SelectItemProps,
|
|
17
|
+
SelectGroupProps,
|
|
18
|
+
SelectLabelProps,
|
|
19
|
+
SelectSeparatorProps,
|
|
20
|
+
} from "./select";
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
name: Select
|
|
2
|
+
description: "Form select on Base UI: a trigger styled like Input outline and a DropdownMenu-style popup with a check on the chosen item."
|
|
3
|
+
layer: core
|
|
4
|
+
category: input
|
|
5
|
+
when_to_use:
|
|
6
|
+
- "For choosing one value from a short fixed list in a form"
|
|
7
|
+
when_not_to_use:
|
|
8
|
+
- "For actions — use DropdownMenu"
|
|
9
|
+
- "For searching a long list, or one loaded from the server — use Combobox"
|
|
10
|
+
- "For a property on a detail card (status, organization) — use Picker; Select stays for forms, Settings and composers"
|
|
11
|
+
composition_partners:
|
|
12
|
+
- Field (label, description, error)
|
|
13
|
+
props:
|
|
14
|
+
- name: value / defaultValue / onValueChange
|
|
15
|
+
type: "Base UI Select.Root props"
|
|
16
|
+
required: false
|
|
17
|
+
description: "Controlled or uncontrolled value (Select)"
|
|
18
|
+
- name: items
|
|
19
|
+
type: "Record<string, ReactNode> | { value, label }[]"
|
|
20
|
+
required: false
|
|
21
|
+
description: "Labels by value, so the trigger shows 'Developer' for value 'dev' (Select); without it the trigger shows the raw value"
|
|
22
|
+
- name: size
|
|
23
|
+
type: "'sm' | 'default' | 'lg'"
|
|
24
|
+
required: false
|
|
25
|
+
default: "'default'"
|
|
26
|
+
description: "Trigger height (SelectTrigger), as Input and Button: sm (h-sm, 26px), default (h-md, 30px), lg (h-lg, 34px) at the look's default Control height, which they follow. A form that wants taller controls sets lg on each of its controls"
|
|
27
|
+
- name: placeholder
|
|
28
|
+
type: ReactNode
|
|
29
|
+
required: false
|
|
30
|
+
description: "Shown while nothing is chosen (SelectValue)"
|
|
31
|
+
examples:
|
|
32
|
+
- title: "Role select in a field"
|
|
33
|
+
code: |
|
|
34
|
+
const roles = { dev: "Developer", design: "Designer" };
|
|
35
|
+
const [role, setRole] = useState<string | null>(null);
|
|
36
|
+
|
|
37
|
+
<Field>
|
|
38
|
+
<FieldLabel>Role</FieldLabel>
|
|
39
|
+
<Select items={roles} value={role} onValueChange={(value) => setRole(value as string | null)}>
|
|
40
|
+
<SelectTrigger><SelectValue placeholder="Choose a role" /></SelectTrigger>
|
|
41
|
+
<SelectContent>
|
|
42
|
+
{Object.entries(roles).map(([value, label]) => (
|
|
43
|
+
<SelectItem key={value} value={value}>{label}</SelectItem>
|
|
44
|
+
))}
|
|
45
|
+
</SelectContent>
|
|
46
|
+
</Select>
|
|
47
|
+
</Field>
|
|
48
|
+
accessibility_notes: "Base UI listbox semantics; labelled by a surrounding FieldLabel; aria-invalid inside an invalid Field."
|