@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,288 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
import { Combobox as ComboboxPrimitive } from "@base-ui/react/combobox";
|
|
3
|
+
import { CSPProvider } from "@base-ui/react/csp-provider";
|
|
4
|
+
|
|
5
|
+
import { cn } from "../../../lib/utils";
|
|
6
|
+
import { inputVariants } from "../input/input";
|
|
7
|
+
import { dropdownMenuItemVariants } from "../dropdown-menu/dropdown-menu";
|
|
8
|
+
import { ScrollArea } from "../scroll-area";
|
|
9
|
+
|
|
10
|
+
// Bridge: a single-value picker on Base UI's Combobox, styled as `Select` (an `Input variant="outline"` frame with a
|
|
11
|
+
// chevron, a `DropdownMenuContent` popup, `dropdownMenuItemVariants` items with a check). One controlled component:
|
|
12
|
+
// the caller owns `items` (and may load them from the server through `onInputChange`, with `filter={null}`).
|
|
13
|
+
// Base UI's default filter is already `contains` through an `Intl.Collator` at base sensitivity (any case, any accent).
|
|
14
|
+
|
|
15
|
+
interface ComboboxProps<Item> {
|
|
16
|
+
/** The selected item, or `null`. */
|
|
17
|
+
value: Item | null;
|
|
18
|
+
/** Called with the picked item. Clearing the text or Escape never picks `null`: offer a "None" item for that. The
|
|
19
|
+
* picked label shows until `value` changes or the returned promise settles (a failed save: back to `value`). */
|
|
20
|
+
onValueChange: (item: Item) => void | Promise<unknown>;
|
|
21
|
+
/** What the popup offers now. */
|
|
22
|
+
items: readonly Item[];
|
|
23
|
+
/** The item's label, shown in the input and matched by the default filter. */
|
|
24
|
+
itemToString: (item: Item) => string;
|
|
25
|
+
/** The item's identity, for the selected check and React keys. */
|
|
26
|
+
itemToKey: (item: Item) => string;
|
|
27
|
+
/** Called with the text the user types, and with "" once the popup has closed (the text reverts to the value). */
|
|
28
|
+
onInputChange?: (text: string) => void;
|
|
29
|
+
/** Called when the popup opens or closes (e.g. to retry a failed load on open). */
|
|
30
|
+
onOpenChange?: (open: boolean) => void;
|
|
31
|
+
/** `null` shows `items` as they are (the caller filters, e.g. on the server); by default `contains`, any case and accent. */
|
|
32
|
+
filter?: null;
|
|
33
|
+
/** While nothing is shown, "Loading…" instead of `emptyText`. */
|
|
34
|
+
loading?: boolean;
|
|
35
|
+
/** Shown when no item matches. Defaults to "No results". */
|
|
36
|
+
emptyText?: React.ReactNode;
|
|
37
|
+
/** An item's row content; defaults to its label. */
|
|
38
|
+
renderItem?: (item: Item) => React.ReactNode;
|
|
39
|
+
placeholder?: string;
|
|
40
|
+
disabled?: boolean;
|
|
41
|
+
readOnly?: boolean;
|
|
42
|
+
/** Height, as `SelectTrigger` (h-sm, h-md, h-lg). Defaults to `default` (h-md), as Button and Input; `sm` in property rows. */
|
|
43
|
+
size?: "sm" | "default" | "lg";
|
|
44
|
+
"aria-label"?: string;
|
|
45
|
+
/** In a form: the input's id, the label naming it, and whether its value is refused. */
|
|
46
|
+
id?: string;
|
|
47
|
+
"aria-labelledby"?: string;
|
|
48
|
+
"aria-invalid"?: boolean | undefined;
|
|
49
|
+
/** On the frame. */
|
|
50
|
+
className?: string;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
// Optical centring (Bridge): a text control, so 1px bottom padding; the chevron keeps the box's centre, as SelectTrigger.
|
|
54
|
+
function Combobox<Item>({
|
|
55
|
+
value,
|
|
56
|
+
onValueChange,
|
|
57
|
+
items,
|
|
58
|
+
itemToString,
|
|
59
|
+
itemToKey,
|
|
60
|
+
onInputChange,
|
|
61
|
+
onOpenChange,
|
|
62
|
+
filter,
|
|
63
|
+
loading = false,
|
|
64
|
+
emptyText = "No results",
|
|
65
|
+
renderItem,
|
|
66
|
+
placeholder,
|
|
67
|
+
disabled,
|
|
68
|
+
readOnly,
|
|
69
|
+
size = "default",
|
|
70
|
+
"aria-label": ariaLabel,
|
|
71
|
+
id,
|
|
72
|
+
"aria-labelledby": labelledBy,
|
|
73
|
+
"aria-invalid": invalid,
|
|
74
|
+
className,
|
|
75
|
+
}: ComboboxProps<Item>) {
|
|
76
|
+
const { shown, onPick } = usePendingPick(value, itemToKey, onValueChange);
|
|
77
|
+
// The text is controlled so that it reverts to the shown label whenever no pick happened: Base UI reverts it when
|
|
78
|
+
// the popup closes, not on leaving an input whose popup never opened, and Escape on a closed one empties it.
|
|
79
|
+
const label = shown === null ? "" : itemToString(shown);
|
|
80
|
+
const [text, setText] = React.useState(label);
|
|
81
|
+
const open = React.useRef(false);
|
|
82
|
+
const input = React.useRef<HTMLInputElement>(null);
|
|
83
|
+
const previous = React.useRef(label);
|
|
84
|
+
React.useEffect(() => {
|
|
85
|
+
// A new label replaces the text unless the user is typing (edited text, open or focused); close and blur revert.
|
|
86
|
+
const untouched =
|
|
87
|
+
text === previous.current || (!open.current && document.activeElement !== input.current);
|
|
88
|
+
previous.current = label;
|
|
89
|
+
if (untouched) setText(label);
|
|
90
|
+
// Run on a label change only.
|
|
91
|
+
}, [label]);
|
|
92
|
+
return (
|
|
93
|
+
<ComboboxPrimitive.Root<Item>
|
|
94
|
+
items={items}
|
|
95
|
+
value={shown}
|
|
96
|
+
onValueChange={onPick}
|
|
97
|
+
inputValue={text}
|
|
98
|
+
onInputValueChange={(next, details) => {
|
|
99
|
+
setText(details.reason === "escape-key" ? label : next);
|
|
100
|
+
if (details.reason === "input-change") onInputChange?.(next);
|
|
101
|
+
}}
|
|
102
|
+
onOpenChange={(next) => {
|
|
103
|
+
open.current = next;
|
|
104
|
+
onOpenChange?.(next);
|
|
105
|
+
}}
|
|
106
|
+
onOpenChangeComplete={(next) => {
|
|
107
|
+
if (!next) onInputChange?.("");
|
|
108
|
+
}}
|
|
109
|
+
itemToStringLabel={itemToString}
|
|
110
|
+
itemToStringValue={itemToKey}
|
|
111
|
+
isItemEqualToValue={(a, b) => itemToKey(a) === itemToKey(b)}
|
|
112
|
+
{...(filter === null && { filter: null })}
|
|
113
|
+
disabled={disabled}
|
|
114
|
+
readOnly={readOnly}
|
|
115
|
+
>
|
|
116
|
+
<ComboboxPrimitive.InputGroup
|
|
117
|
+
data-slot="combobox"
|
|
118
|
+
className={cn(
|
|
119
|
+
inputVariants({ variant: "outline", size }),
|
|
120
|
+
"items-center gap-1.5 pr-1.5 focus-within:border-accent data-popup-open:border-accent has-[[aria-invalid=true]]:border-destructive data-disabled:opacity-50",
|
|
121
|
+
className,
|
|
122
|
+
)}
|
|
123
|
+
>
|
|
124
|
+
<ComboboxPrimitive.Input
|
|
125
|
+
ref={input}
|
|
126
|
+
data-slot="combobox-input"
|
|
127
|
+
aria-label={ariaLabel}
|
|
128
|
+
id={id}
|
|
129
|
+
aria-labelledby={labelledBy}
|
|
130
|
+
aria-invalid={invalid}
|
|
131
|
+
placeholder={placeholder}
|
|
132
|
+
onBlur={() => {
|
|
133
|
+
if (!open.current) setText(label);
|
|
134
|
+
}}
|
|
135
|
+
className="pb-px min-w-0 flex-1 h-full bg-transparent text-sm text-foreground outline-hidden placeholder:text-placeholder disabled:cursor-not-allowed"
|
|
136
|
+
/>
|
|
137
|
+
<ComboboxPrimitive.Trigger
|
|
138
|
+
data-slot="combobox-trigger"
|
|
139
|
+
aria-label="Show options"
|
|
140
|
+
className="flex shrink-0 cursor-pointer items-center text-muted disabled:cursor-not-allowed"
|
|
141
|
+
>
|
|
142
|
+
<svg
|
|
143
|
+
aria-hidden="true"
|
|
144
|
+
className="size-4"
|
|
145
|
+
viewBox="0 0 24 24"
|
|
146
|
+
fill="none"
|
|
147
|
+
stroke="currentColor"
|
|
148
|
+
strokeWidth="2"
|
|
149
|
+
strokeLinecap="round"
|
|
150
|
+
strokeLinejoin="round"
|
|
151
|
+
>
|
|
152
|
+
<path d="m6 9 6 6 6-6" />
|
|
153
|
+
</svg>
|
|
154
|
+
</ComboboxPrimitive.Trigger>
|
|
155
|
+
</ComboboxPrimitive.InputGroup>
|
|
156
|
+
{/* The page's CSP refuses inline <style>, as in SelectContent. */}
|
|
157
|
+
<CSPProvider disableStyleElements>
|
|
158
|
+
<ComboboxPrimitive.Portal>
|
|
159
|
+
<ComboboxPrimitive.Positioner sideOffset={4} align="start" className="z-50">
|
|
160
|
+
<ComboboxPrimitive.Popup
|
|
161
|
+
data-slot="combobox-content"
|
|
162
|
+
className="z-50 flex min-w-(--anchor-width) max-h-[min(var(--available-height),20rem)] flex-col bg-surface rounded-dropdown outline-none"
|
|
163
|
+
style={{ boxShadow: "var(--shadow-dropdown)" }}
|
|
164
|
+
>
|
|
165
|
+
<ScrollArea className="flex min-h-0 flex-col" viewportClassName="min-h-0 flex-1">
|
|
166
|
+
<div className="p-1">
|
|
167
|
+
<ComboboxOptions
|
|
168
|
+
slot="combobox"
|
|
169
|
+
itemToString={itemToString}
|
|
170
|
+
itemToKey={itemToKey}
|
|
171
|
+
renderItem={renderItem}
|
|
172
|
+
loading={loading}
|
|
173
|
+
emptyText={emptyText}
|
|
174
|
+
/>
|
|
175
|
+
</div>
|
|
176
|
+
</ScrollArea>
|
|
177
|
+
</ComboboxPrimitive.Popup>
|
|
178
|
+
</ComboboxPrimitive.Positioner>
|
|
179
|
+
</ComboboxPrimitive.Portal>
|
|
180
|
+
</CSPProvider>
|
|
181
|
+
</ComboboxPrimitive.Root>
|
|
182
|
+
);
|
|
183
|
+
}
|
|
184
|
+
|
|
185
|
+
// Shared with Picker (exported from this module, not from the kit's index).
|
|
186
|
+
|
|
187
|
+
/** An item picked through an async `onValueChange` shows until `value` changes or the promise settles (a failure:
|
|
188
|
+
* back to `value`). `onPick` drops Base UI's `null` (an emptied input, Escape while closed): the value stays. */
|
|
189
|
+
function usePendingPick<Item>(
|
|
190
|
+
value: Item | null,
|
|
191
|
+
itemToKey: (item: Item) => string,
|
|
192
|
+
onValueChange: (item: Item) => void | Promise<unknown>,
|
|
193
|
+
) {
|
|
194
|
+
const keyOf = (item: Item | null) => (item === null ? null : itemToKey(item));
|
|
195
|
+
const [pending, setPending] = React.useState<{ item: Item; was: string | null } | null>(null);
|
|
196
|
+
const shown = pending && pending.was === keyOf(value) ? pending.item : value;
|
|
197
|
+
// A new value ends the pending pick (else A → B → A would show it again).
|
|
198
|
+
const key = keyOf(value);
|
|
199
|
+
React.useEffect(() => setPending(null), [key]);
|
|
200
|
+
const onPick = (next: Item | null) => {
|
|
201
|
+
if (next === null) return;
|
|
202
|
+
const settled = onValueChange(next);
|
|
203
|
+
if (!(settled instanceof Promise)) return;
|
|
204
|
+
// The current one again: nothing to show meanwhile; its failure is the caller's to report.
|
|
205
|
+
if (itemToKey(next) === key) return void settled.catch(() => {});
|
|
206
|
+
const mark = { item: next, was: key };
|
|
207
|
+
setPending(mark);
|
|
208
|
+
const clear = () => setPending((current) => (current === mark ? null : current));
|
|
209
|
+
settled.then(clear, clear);
|
|
210
|
+
};
|
|
211
|
+
return { shown, onPick };
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
interface ComboboxOptionsProps<Item> {
|
|
215
|
+
/** The data-slot prefix: `<slot>-empty`, `<slot>-item`, `<slot>-item-label`. */
|
|
216
|
+
slot: string;
|
|
217
|
+
itemToString: (item: Item) => string;
|
|
218
|
+
itemToKey: (item: Item) => string;
|
|
219
|
+
renderItem?: ((item: Item) => React.ReactNode) | undefined;
|
|
220
|
+
loading: boolean;
|
|
221
|
+
emptyText: React.ReactNode;
|
|
222
|
+
/** Before the label (an icon). */
|
|
223
|
+
leading?: ((item: Item) => React.ReactNode) | undefined;
|
|
224
|
+
/** After the check (a hint), with the item's index among those shown. */
|
|
225
|
+
trailing?: ((item: Item, index: number) => React.ReactNode) | undefined;
|
|
226
|
+
listRef?: React.Ref<HTMLDivElement>;
|
|
227
|
+
}
|
|
228
|
+
|
|
229
|
+
/** The popup's body: the empty/loading text, then the items, each with a check when selected. */
|
|
230
|
+
function ComboboxOptions<Item>({
|
|
231
|
+
slot,
|
|
232
|
+
itemToString,
|
|
233
|
+
itemToKey,
|
|
234
|
+
renderItem,
|
|
235
|
+
loading,
|
|
236
|
+
emptyText,
|
|
237
|
+
leading,
|
|
238
|
+
trailing,
|
|
239
|
+
listRef,
|
|
240
|
+
}: ComboboxOptionsProps<Item>) {
|
|
241
|
+
return (
|
|
242
|
+
<>
|
|
243
|
+
{/* Its children only while the list is empty; the element stays mounted to announce them. */}
|
|
244
|
+
<ComboboxPrimitive.Empty
|
|
245
|
+
data-slot={`${slot}-empty`}
|
|
246
|
+
className="px-2 py-1.5 text-sm text-muted empty:p-0"
|
|
247
|
+
>
|
|
248
|
+
{loading ? "Loading…" : emptyText}
|
|
249
|
+
</ComboboxPrimitive.Empty>
|
|
250
|
+
<ComboboxPrimitive.List ref={listRef} className="flex flex-col outline-none">
|
|
251
|
+
{(item: Item, index: number) => (
|
|
252
|
+
<ComboboxPrimitive.Item
|
|
253
|
+
key={itemToKey(item)}
|
|
254
|
+
value={item}
|
|
255
|
+
data-slot={`${slot}-item`}
|
|
256
|
+
className={cn(
|
|
257
|
+
dropdownMenuItemVariants(),
|
|
258
|
+
"data-disabled:pointer-events-none data-disabled:opacity-50",
|
|
259
|
+
)}
|
|
260
|
+
>
|
|
261
|
+
{leading?.(item)}
|
|
262
|
+
<span data-slot={`${slot}-item-label`} className="flex-1 truncate">
|
|
263
|
+
{renderItem ? renderItem(item) : itemToString(item)}
|
|
264
|
+
</span>
|
|
265
|
+
<ComboboxPrimitive.ItemIndicator className="flex shrink-0 text-muted">
|
|
266
|
+
<svg
|
|
267
|
+
aria-hidden="true"
|
|
268
|
+
className="size-4"
|
|
269
|
+
viewBox="0 0 24 24"
|
|
270
|
+
fill="none"
|
|
271
|
+
stroke="currentColor"
|
|
272
|
+
strokeWidth="2"
|
|
273
|
+
strokeLinecap="round"
|
|
274
|
+
strokeLinejoin="round"
|
|
275
|
+
>
|
|
276
|
+
<path d="M20 6 9 17l-5-5" />
|
|
277
|
+
</svg>
|
|
278
|
+
</ComboboxPrimitive.ItemIndicator>
|
|
279
|
+
{trailing?.(item, index)}
|
|
280
|
+
</ComboboxPrimitive.Item>
|
|
281
|
+
)}
|
|
282
|
+
</ComboboxPrimitive.List>
|
|
283
|
+
</>
|
|
284
|
+
);
|
|
285
|
+
}
|
|
286
|
+
|
|
287
|
+
export { Combobox, ComboboxOptions, usePendingPick };
|
|
288
|
+
export type { ComboboxProps };
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
name: Detail
|
|
2
|
+
description: "A record's page (Contacts' card the reference): it scrolls in its pane at a readable width; DetailHeader holds the avatar, the DetailTitle (an inline-title name, a line under it) and the actions; PropertyRows follow."
|
|
3
|
+
layer: core
|
|
4
|
+
category: layout
|
|
5
|
+
when_to_use:
|
|
6
|
+
- "The card side of a list-and-card screen, or a record opened alone"
|
|
7
|
+
when_not_to_use:
|
|
8
|
+
- "A boxed summary inside a page — use Card"
|
|
9
|
+
composition_partners:
|
|
10
|
+
- Avatar (size 3xl, first in DetailHeader)
|
|
11
|
+
- EditableField / RecordField (variant title, in DetailTitle)
|
|
12
|
+
- Properties and PropertyRow (the record's fields)
|
|
13
|
+
- DetailSkeleton (while the record loads)
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
|
|
3
|
+
import { cn } from "../../../lib/utils";
|
|
4
|
+
import { MainContent } from "../main-content";
|
|
5
|
+
import { ScrollArea } from "../scroll-area";
|
|
6
|
+
|
|
7
|
+
// A record's page (research-033's mockup, Contacts' card the reference): it scrolls in its pane, in a MainContent
|
|
8
|
+
// (its column, margins and alignment: read); a header (an avatar, the title block, the actions), then its rows.
|
|
9
|
+
|
|
10
|
+
/** The page: a ScrollArea filling its pane, around an `article` (its props: aria-label names the record). */
|
|
11
|
+
function Detail({ className, children, ...props }: React.ComponentProps<"article">) {
|
|
12
|
+
return (
|
|
13
|
+
<ScrollArea className="h-full">
|
|
14
|
+
<MainContent>
|
|
15
|
+
<article data-slot="detail" className={cn("flex flex-col gap-5", className)} {...props}>
|
|
16
|
+
{children}
|
|
17
|
+
</article>
|
|
18
|
+
</MainContent>
|
|
19
|
+
</ScrollArea>
|
|
20
|
+
);
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
/** The page's header: an avatar, its DetailTitle, then the actions (a ⋯ menu). */
|
|
24
|
+
function DetailHeader({ className, ...props }: React.ComponentProps<"header">) {
|
|
25
|
+
return (
|
|
26
|
+
<header
|
|
27
|
+
data-slot="detail-header"
|
|
28
|
+
className={cn(
|
|
29
|
+
"flex items-start gap-[18px] [&>[data-slot=key-hint-wrapper]]:inline-flex [&>[data-slot=key-hint-wrapper]]:max-w-full",
|
|
30
|
+
className,
|
|
31
|
+
)}
|
|
32
|
+
{...props}
|
|
33
|
+
/>
|
|
34
|
+
);
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
/** The title block: the name (an inline-title field), the line under it. */
|
|
38
|
+
function DetailTitle({ className, ...props }: React.ComponentProps<"div">) {
|
|
39
|
+
return (
|
|
40
|
+
<div
|
|
41
|
+
data-slot="detail-title"
|
|
42
|
+
className={cn(
|
|
43
|
+
"flex min-w-0 flex-1 flex-col pt-1.5 [&>[data-slot=key-hint-wrapper]]:inline-flex [&>[data-slot=key-hint-wrapper]]:max-w-full",
|
|
44
|
+
className,
|
|
45
|
+
)}
|
|
46
|
+
{...props}
|
|
47
|
+
/>
|
|
48
|
+
);
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
/** A line of help under the page's rows ("Edit any value in place: Enter … Esc reverts"); its keys as Kbd. */
|
|
52
|
+
function DetailHint({ className, ...props }: React.ComponentProps<"p">) {
|
|
53
|
+
return (
|
|
54
|
+
<p
|
|
55
|
+
data-slot="detail-hint"
|
|
56
|
+
className={cn("m-0 mt-4 text-[12px] leading-[normal] text-muted [&_kbd]:mx-0.5", className)}
|
|
57
|
+
{...props}
|
|
58
|
+
/>
|
|
59
|
+
);
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
/** The line under a page's name when it is not a field ("2 people"). */
|
|
63
|
+
function DetailSubtitle({ className, ...props }: React.ComponentProps<"p">) {
|
|
64
|
+
return (
|
|
65
|
+
<p
|
|
66
|
+
data-slot="detail-subtitle"
|
|
67
|
+
className={cn("m-0 text-[13px] text-secondary", className)}
|
|
68
|
+
{...props}
|
|
69
|
+
/>
|
|
70
|
+
);
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
export { Detail, DetailHeader, DetailTitle, DetailHint, DetailSubtitle };
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export { Detail, DetailHeader, DetailTitle, DetailHint, DetailSubtitle } from "./detail";
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
name: Dialog
|
|
2
|
+
description: "Modal dialog with header, body, and footer layout. Supports standard and fullscreen modes with overlay backdrop."
|
|
3
|
+
layer: core
|
|
4
|
+
category: overlay
|
|
5
|
+
when_to_use:
|
|
6
|
+
- "For modal forms (create issue, edit settings)"
|
|
7
|
+
- "For confirmation dialogs (delete, discard changes)"
|
|
8
|
+
- "For fullscreen views of detailed content"
|
|
9
|
+
when_not_to_use:
|
|
10
|
+
- "For non-blocking notifications — use Toast component"
|
|
11
|
+
- "For contextual actions — use DropdownMenu"
|
|
12
|
+
- "For inline content expansion — use a disclosure pattern"
|
|
13
|
+
- "For a dialog in steps (a choice, then a form) — use Wizard"
|
|
14
|
+
composition_partners:
|
|
15
|
+
- Button (as DialogTrigger child and in DialogFooter)
|
|
16
|
+
- Input (in form fields within DialogBody)
|
|
17
|
+
- Textarea (in form fields within DialogBody)
|
|
18
|
+
- Properties (for structured forms)
|
|
19
|
+
props:
|
|
20
|
+
- name: open
|
|
21
|
+
type: boolean
|
|
22
|
+
required: false
|
|
23
|
+
description: "Controlled open state"
|
|
24
|
+
- name: onOpenChange
|
|
25
|
+
type: "(open: boolean, eventDetails) => void"
|
|
26
|
+
required: false
|
|
27
|
+
description: "Callback when dialog open state changes. Base UI passes eventDetails as the second argument; eventDetails.cancel() prevents the change."
|
|
28
|
+
- name: render
|
|
29
|
+
type: "ReactElement | (props, state) => ReactElement"
|
|
30
|
+
required: false
|
|
31
|
+
description: "Replace the rendered element on DialogTrigger, DialogContent, DialogTitle, DialogDescription, or DialogClose, e.g. render={<Button />} on a trigger/close control."
|
|
32
|
+
- name: fullscreen
|
|
33
|
+
type: boolean
|
|
34
|
+
required: false
|
|
35
|
+
default: "false"
|
|
36
|
+
description: "Fullscreen mode — 90vw x 90vh instead of 560px width (DialogContent only)"
|
|
37
|
+
- name: maximizable
|
|
38
|
+
type: boolean
|
|
39
|
+
required: false
|
|
40
|
+
default: "false"
|
|
41
|
+
description: "Opt-in: let the user toggle the dialog to/from fullscreen via a <DialogMaximize /> button placed in the header (DialogContent only)"
|
|
42
|
+
props_priority:
|
|
43
|
+
- open
|
|
44
|
+
- onOpenChange
|
|
45
|
+
- fullscreen
|
|
46
|
+
- maximizable
|
|
47
|
+
variants:
|
|
48
|
+
- default: "Standard dialog — w-[560px] (never wider than the window less 1rem each side: a phone), max-h-[80vh], centered with backdrop"
|
|
49
|
+
- fullscreen: "Fullscreen dialog — w-[90vw], h-[90vh], for detailed content views"
|
|
50
|
+
examples:
|
|
51
|
+
- title: "Basic dialog"
|
|
52
|
+
code: |
|
|
53
|
+
<Dialog>
|
|
54
|
+
<DialogTrigger render={<Button variant="primary" />}>
|
|
55
|
+
Create Issue
|
|
56
|
+
</DialogTrigger>
|
|
57
|
+
<DialogContent>
|
|
58
|
+
<DialogHeader>
|
|
59
|
+
<DialogTitle>New Issue</DialogTitle>
|
|
60
|
+
<DialogDescription>Create a new issue</DialogDescription>
|
|
61
|
+
</DialogHeader>
|
|
62
|
+
<DialogBody>
|
|
63
|
+
<Input placeholder="Issue title" />
|
|
64
|
+
<Textarea placeholder="Description..." />
|
|
65
|
+
</DialogBody>
|
|
66
|
+
<DialogFooter>
|
|
67
|
+
<DialogClose render={<Button />}>Cancel</DialogClose>
|
|
68
|
+
<Button variant="primary">Create</Button>
|
|
69
|
+
</DialogFooter>
|
|
70
|
+
</DialogContent>
|
|
71
|
+
</Dialog>
|
|
72
|
+
- title: "Fullscreen dialog"
|
|
73
|
+
code: |
|
|
74
|
+
<Dialog>
|
|
75
|
+
<DialogTrigger render={<Button />}>Open details</DialogTrigger>
|
|
76
|
+
<DialogContent fullscreen>
|
|
77
|
+
<DialogHeader>
|
|
78
|
+
<DialogTitle>Detailed View</DialogTitle>
|
|
79
|
+
<DialogClose render={<Button size="icon-sm" aria-label="Close dialog" />}>
|
|
80
|
+
×
|
|
81
|
+
</DialogClose>
|
|
82
|
+
</DialogHeader>
|
|
83
|
+
<DialogBody>Full-width content here</DialogBody>
|
|
84
|
+
</DialogContent>
|
|
85
|
+
</Dialog>
|
|
86
|
+
anti_patterns:
|
|
87
|
+
- "Don't use Dialog for non-blocking feedback — use Toast instead"
|
|
88
|
+
- "Don't forget DialogHeader/DialogBody/DialogFooter structure — they provide consistent spacing"
|
|
89
|
+
- "Don't nest Dialogs — only one modal should be open at a time"
|
|
90
|
+
- "Don't forget to use render={<Button />} on DialogTrigger when wrapping a Button"
|
|
91
|
+
accessibility_notes: "Built on Base UI Dialog — renders role='dialog' with aria-labelledby (title) and aria-describedby (description). Keyboard: Escape to close, Tab traps focus within dialog. Overlay backdrop prevents interaction with content behind."
|
|
92
|
+
notes: "Sub-components: Dialog (root), DialogTrigger, DialogContent (fullscreen variant + opt-in maximizable), DialogHeader, DialogTitle, DialogDescription, DialogBody (scrollable), DialogFooter, DialogClose, DialogMaximize (opt-in maximize/restore toggle — place in the header; renders only when DialogContent has maximizable)."
|
|
93
|
+
related_patterns:
|
|
94
|
+
- form-dialog
|
|
95
|
+
- crud-page
|