@bridgebrew/ui 0.0.0-stage → 0.1.10-next.79
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +39 -2
- package/SOURCE.md +182 -0
- package/dist/build.js +871 -0
- package/dist/theme-css.js +896 -0
- package/dist/themes.js +69 -0
- package/dist/types/build/stylesheet.d.ts +31 -0
- package/dist/types/components/composite/command/command.d.ts +94 -0
- package/dist/types/components/composite/command/index.d.ts +2 -0
- package/dist/types/components/composite/draft-bar/draft-bar.d.ts +12 -0
- package/dist/types/components/composite/draft-bar/index.d.ts +2 -0
- package/dist/types/components/composite/image-field/image-field.d.ts +33 -0
- package/dist/types/components/composite/image-field/index.d.ts +2 -0
- package/dist/types/components/composite/list/index.d.ts +3 -0
- package/dist/types/components/composite/list/list-swipe.d.ts +28 -0
- package/dist/types/components/composite/list/list.d.ts +95 -0
- package/dist/types/components/composite/picker/index.d.ts +2 -0
- package/dist/types/components/composite/picker/picker.d.ts +44 -0
- package/dist/types/components/composite/prompt-field/index.d.ts +2 -0
- package/dist/types/components/composite/prompt-field/prompt-field.d.ts +18 -0
- package/dist/types/components/composite/properties/index.d.ts +2 -0
- package/dist/types/components/composite/properties/properties.d.ts +24 -0
- package/dist/types/components/composite/snooze-menu/index.d.ts +4 -0
- package/dist/types/components/composite/snooze-menu/presets.d.ts +36 -0
- package/dist/types/components/composite/snooze-menu/snooze-menu.d.ts +27 -0
- package/dist/types/components/composite/tag-input/index.d.ts +2 -0
- package/dist/types/components/composite/tag-input/tag-input.d.ts +22 -0
- package/dist/types/components/composite/wizard/index.d.ts +2 -0
- package/dist/types/components/composite/wizard/wizard.d.ts +53 -0
- package/dist/types/components/core/avatar/avatar.d.ts +16 -0
- package/dist/types/components/core/avatar/index.d.ts +2 -0
- package/dist/types/components/core/badge/badge.d.ts +8 -0
- package/dist/types/components/core/badge/index.d.ts +2 -0
- package/dist/types/components/core/breadcrumb/breadcrumb.d.ts +21 -0
- package/dist/types/components/core/breadcrumb/index.d.ts +2 -0
- package/dist/types/components/core/bullets/bullets.d.ts +15 -0
- package/dist/types/components/core/bullets/index.d.ts +2 -0
- package/dist/types/components/core/button/button.d.ts +14 -0
- package/dist/types/components/core/button/index.d.ts +2 -0
- package/dist/types/components/core/card/card.d.ts +16 -0
- package/dist/types/components/core/card/index.d.ts +2 -0
- package/dist/types/components/core/checkbox/checkbox.d.ts +15 -0
- package/dist/types/components/core/checkbox/index.d.ts +2 -0
- package/dist/types/components/core/cluster/cluster.d.ts +5 -0
- package/dist/types/components/core/cluster/index.d.ts +1 -0
- package/dist/types/components/core/code-block/code-block.d.ts +18 -0
- package/dist/types/components/core/code-block/index.d.ts +2 -0
- package/dist/types/components/core/collapsible/collapsible.d.ts +8 -0
- package/dist/types/components/core/collapsible/index.d.ts +1 -0
- package/dist/types/components/core/colour-picker/colour-picker.d.ts +25 -0
- package/dist/types/components/core/colour-picker/index.d.ts +4 -0
- package/dist/types/components/core/combobox/combobox.d.ts +63 -0
- package/dist/types/components/core/combobox/index.d.ts +2 -0
- package/dist/types/components/core/detail/detail.d.ts +12 -0
- package/dist/types/components/core/detail/index.d.ts +1 -0
- package/dist/types/components/core/dialog/dialog.d.ts +43 -0
- package/dist/types/components/core/dialog/drag.d.ts +4 -0
- package/dist/types/components/core/dialog/index.d.ts +2 -0
- package/dist/types/components/core/drop-zone/drop-zone.d.ts +23 -0
- package/dist/types/components/core/drop-zone/index.d.ts +2 -0
- package/dist/types/components/core/dropdown-menu/dropdown-menu.d.ts +78 -0
- package/dist/types/components/core/dropdown-menu/index.d.ts +2 -0
- package/dist/types/components/core/editable-field/editable-field.d.ts +42 -0
- package/dist/types/components/core/editable-field/index.d.ts +2 -0
- package/dist/types/components/core/empty-state/empty-state.d.ts +11 -0
- package/dist/types/components/core/empty-state/index.d.ts +2 -0
- package/dist/types/components/core/field/field.d.ts +31 -0
- package/dist/types/components/core/field/index.d.ts +2 -0
- package/dist/types/components/core/icon/icon-sets.d.ts +38 -0
- package/dist/types/components/core/icon/icon.d.ts +14 -0
- package/dist/types/components/core/icon/index.d.ts +2 -0
- package/dist/types/components/core/input/index.d.ts +4 -0
- package/dist/types/components/core/input/input.d.ts +22 -0
- package/dist/types/components/core/input/textarea.d.ts +8 -0
- package/dist/types/components/core/kbd/index.d.ts +2 -0
- package/dist/types/components/core/kbd/kbd.d.ts +7 -0
- package/dist/types/components/core/label/index.d.ts +2 -0
- package/dist/types/components/core/label/label.d.ts +13 -0
- package/dist/types/components/core/main-content/index.d.ts +2 -0
- package/dist/types/components/core/main-content/main-content.d.ts +18 -0
- package/dist/types/components/core/pane/index.d.ts +1 -0
- package/dist/types/components/core/pane/pane.d.ts +12 -0
- package/dist/types/components/core/pick-menu/index.d.ts +4 -0
- package/dist/types/components/core/pick-menu/pick-menu.d.ts +57 -0
- package/dist/types/components/core/pick-menu/tag-menu.d.ts +19 -0
- package/dist/types/components/core/popover/index.d.ts +2 -0
- package/dist/types/components/core/popover/popover.d.ts +22 -0
- package/dist/types/components/core/progress/index.d.ts +2 -0
- package/dist/types/components/core/progress/progress.d.ts +13 -0
- package/dist/types/components/core/resizable/index.d.ts +2 -0
- package/dist/types/components/core/resizable/resizable.d.ts +15 -0
- package/dist/types/components/core/resizable/use-remembered-layout.d.ts +31 -0
- package/dist/types/components/core/screen-link/index.d.ts +2 -0
- package/dist/types/components/core/screen-link/screen-link.d.ts +52 -0
- package/dist/types/components/core/scroll-area/index.d.ts +2 -0
- package/dist/types/components/core/scroll-area/scroll-area.d.ts +13 -0
- package/dist/types/components/core/scroll-area/steps.d.ts +5 -0
- package/dist/types/components/core/section/index.d.ts +2 -0
- package/dist/types/components/core/section/section.d.ts +16 -0
- package/dist/types/components/core/segment-group/index.d.ts +2 -0
- package/dist/types/components/core/segment-group/segment-group.d.ts +24 -0
- package/dist/types/components/core/select/index.d.ts +2 -0
- package/dist/types/components/core/select/select.d.ts +39 -0
- package/dist/types/components/core/skeleton/index.d.ts +2 -0
- package/dist/types/components/core/skeleton/skeleton.d.ts +13 -0
- package/dist/types/components/core/slider/index.d.ts +2 -0
- package/dist/types/components/core/slider/slider.d.ts +9 -0
- package/dist/types/components/core/sortable/index.d.ts +2 -0
- package/dist/types/components/core/sortable/sortable.d.ts +53 -0
- package/dist/types/components/core/split-view/index.d.ts +2 -0
- package/dist/types/components/core/split-view/split-view.d.ts +28 -0
- package/dist/types/components/core/status-icon/index.d.ts +2 -0
- package/dist/types/components/core/status-icon/status-icon.d.ts +13 -0
- package/dist/types/components/core/table/collapsible-rows.d.ts +7 -0
- package/dist/types/components/core/table/expand-toggle.d.ts +10 -0
- package/dist/types/components/core/table/group-header.d.ts +14 -0
- package/dist/types/components/core/table/index.d.ts +8 -0
- package/dist/types/components/core/table/table.d.ts +31 -0
- package/dist/types/components/core/tabs/index.d.ts +2 -0
- package/dist/types/components/core/tabs/tabs.d.ts +20 -0
- package/dist/types/components/core/tag-pill/index.d.ts +2 -0
- package/dist/types/components/core/tag-pill/tag-pill.d.ts +25 -0
- package/dist/types/components/core/thumbnail/index.d.ts +2 -0
- package/dist/types/components/core/thumbnail/thumbnail.d.ts +23 -0
- package/dist/types/components/core/toast/index.d.ts +2 -0
- package/dist/types/components/core/toast/toast.d.ts +88 -0
- package/dist/types/components/core/toggle/index.d.ts +2 -0
- package/dist/types/components/core/toggle/toggle.d.ts +9 -0
- package/dist/types/components/core/toggle-group/index.d.ts +2 -0
- package/dist/types/components/core/toggle-group/toggle-group.d.ts +21 -0
- package/dist/types/components/core/tooltip/index.d.ts +2 -0
- package/dist/types/components/core/tooltip/tooltip.d.ts +33 -0
- package/dist/types/components/layout/multi-pane/index.d.ts +4 -0
- package/dist/types/components/layout/multi-pane/list-detail.d.ts +17 -0
- package/dist/types/components/layout/multi-pane/multi-pane.d.ts +34 -0
- package/dist/types/components/layout/single-pane/index.d.ts +2 -0
- package/dist/types/components/layout/single-pane/single-pane.d.ts +11 -0
- package/dist/types/components/shell/app-shell/app-shell.d.ts +12 -0
- package/dist/types/components/shell/app-shell/index.d.ts +2 -0
- package/dist/types/components/shell/sidebar/index.d.ts +2 -0
- package/dist/types/components/shell/sidebar/sidebar-group.d.ts +45 -0
- package/dist/types/components/shell/sidebar/sidebar-item.d.ts +19 -0
- package/dist/types/components/shell/sidebar/sidebar-resize-handle.d.ts +17 -0
- package/dist/types/components/shell/sidebar/sidebar-tree.d.ts +42 -0
- package/dist/types/components/shell/sidebar/sidebar.d.ts +27 -0
- package/dist/types/components/template/address-book-template/address-book-template.d.ts +15 -0
- package/dist/types/components/template/address-book-template/index.d.ts +2 -0
- package/dist/types/components/template/mail-template/index.d.ts +2 -0
- package/dist/types/components/template/mail-template/mail-template.d.ts +11 -0
- package/dist/types/components/template/use-narrow.d.ts +3 -0
- package/dist/types/index.d.ts +149 -0
- package/dist/types/kit/check-rendering.d.ts +3 -0
- package/dist/types/kit/kit.d.ts +76 -0
- package/dist/types/lib/clipboard.d.ts +5 -0
- package/dist/types/lib/dates.d.ts +9 -0
- package/dist/types/lib/json.d.ts +26 -0
- package/dist/types/lib/keys.d.ts +15 -0
- package/dist/types/lib/utils.d.ts +2 -0
- package/dist/types/lib/view-scope.d.ts +22 -0
- package/dist/types/profile/profile.d.ts +34 -0
- package/dist/types/theme/appearance.d.ts +31 -0
- package/dist/types/theme/boot.d.ts +3 -0
- package/dist/types/theme/client-appearance-react.d.ts +3 -0
- package/dist/types/theme/client-appearance.d.ts +69 -0
- package/dist/types/theme/generate-tokens.d.ts +45 -0
- package/dist/types/theme/pack-themes-react.d.ts +24 -0
- package/dist/types/theme/palette.d.ts +111 -0
- package/dist/types/theme/semantic-mapping.d.ts +28 -0
- package/dist/types/theme/set-theme.d.ts +30 -0
- package/dist/types/theme/theme-colours.d.ts +14 -0
- package/dist/types/theme/theme-css.d.ts +3 -0
- package/dist/types/theme/themes.d.ts +63 -0
- package/dist/types/theme/wallpaper-sheet.d.ts +16 -0
- package/dist/types/theme/wallpaper-theme-react.d.ts +7 -0
- package/dist/types/theme/wallpaper-theme.d.ts +37 -0
- package/package.json +87 -3
- package/src/build/stylesheet.ts +128 -0
- package/src/components/composite/command/command.meta.yaml +74 -0
- package/src/components/composite/command/command.tsx +939 -0
- package/src/components/composite/command/index.ts +17 -0
- package/src/components/composite/draft-bar/draft-bar.meta.yaml +19 -0
- package/src/components/composite/draft-bar/draft-bar.tsx +57 -0
- package/src/components/composite/draft-bar/index.ts +2 -0
- package/src/components/composite/image-field/image-field.meta.yaml +69 -0
- package/src/components/composite/image-field/image-field.tsx +267 -0
- package/src/components/composite/image-field/index.ts +2 -0
- package/src/components/composite/list/index.ts +18 -0
- package/src/components/composite/list/list-swipe.tsx +163 -0
- package/src/components/composite/list/list.meta.yaml +238 -0
- package/src/components/composite/list/list.tsx +868 -0
- package/src/components/composite/picker/index.ts +2 -0
- package/src/components/composite/picker/picker.meta.yaml +103 -0
- package/src/components/composite/picker/picker.tsx +276 -0
- package/src/components/composite/prompt-field/index.ts +2 -0
- package/src/components/composite/prompt-field/prompt-field.meta.yaml +60 -0
- package/src/components/composite/prompt-field/prompt-field.tsx +81 -0
- package/src/components/composite/properties/index.ts +9 -0
- package/src/components/composite/properties/properties.meta.yaml +56 -0
- package/src/components/composite/properties/properties.tsx +132 -0
- package/src/components/composite/snooze-menu/index.ts +11 -0
- package/src/components/composite/snooze-menu/presets.ts +169 -0
- package/src/components/composite/snooze-menu/snooze-menu.meta.yaml +58 -0
- package/src/components/composite/snooze-menu/snooze-menu.tsx +146 -0
- package/src/components/composite/tag-input/index.ts +2 -0
- package/src/components/composite/tag-input/tag-input.meta.yaml +51 -0
- package/src/components/composite/tag-input/tag-input.tsx +404 -0
- package/src/components/composite/wizard/index.ts +2 -0
- package/src/components/composite/wizard/wizard.meta.yaml +73 -0
- package/src/components/composite/wizard/wizard.tsx +256 -0
- package/src/components/core/avatar/avatar.meta.yaml +71 -0
- package/src/components/core/avatar/avatar.tsx +92 -0
- package/src/components/core/avatar/index.ts +2 -0
- package/src/components/core/badge/badge.meta.yaml +34 -0
- package/src/components/core/badge/badge.tsx +23 -0
- package/src/components/core/badge/index.ts +2 -0
- package/src/components/core/breadcrumb/breadcrumb.meta.yaml +45 -0
- package/src/components/core/breadcrumb/breadcrumb.tsx +110 -0
- package/src/components/core/breadcrumb/index.ts +2 -0
- package/src/components/core/bullets/bullets.meta.yaml +37 -0
- package/src/components/core/bullets/bullets.tsx +60 -0
- package/src/components/core/bullets/index.ts +2 -0
- package/src/components/core/button/button.meta.yaml +91 -0
- package/src/components/core/button/button.tsx +93 -0
- package/src/components/core/button/index.ts +2 -0
- package/src/components/core/card/card.meta.yaml +94 -0
- package/src/components/core/card/card.tsx +54 -0
- package/src/components/core/card/index.ts +2 -0
- package/src/components/core/checkbox/checkbox.meta.yaml +59 -0
- package/src/components/core/checkbox/checkbox.tsx +106 -0
- package/src/components/core/checkbox/index.ts +2 -0
- package/src/components/core/cluster/cluster.meta.yaml +4 -0
- package/src/components/core/cluster/cluster.tsx +17 -0
- package/src/components/core/cluster/index.ts +1 -0
- package/src/components/core/code-block/code-block.meta.yaml +30 -0
- package/src/components/core/code-block/code-block.tsx +93 -0
- package/src/components/core/code-block/index.ts +2 -0
- package/src/components/core/collapsible/collapsible.meta.yaml +34 -0
- package/src/components/core/collapsible/collapsible.tsx +54 -0
- package/src/components/core/collapsible/index.ts +1 -0
- package/src/components/core/colour-picker/colour-picker.meta.yaml +52 -0
- package/src/components/core/colour-picker/colour-picker.tsx +314 -0
- package/src/components/core/colour-picker/index.ts +4 -0
- package/src/components/core/combobox/combobox.meta.yaml +75 -0
- package/src/components/core/combobox/combobox.tsx +288 -0
- package/src/components/core/combobox/index.ts +2 -0
- package/src/components/core/detail/detail.meta.yaml +13 -0
- package/src/components/core/detail/detail.tsx +73 -0
- package/src/components/core/detail/index.ts +1 -0
- package/src/components/core/dialog/dialog.meta.yaml +95 -0
- package/src/components/core/dialog/dialog.tsx +254 -0
- package/src/components/core/dialog/drag.ts +40 -0
- package/src/components/core/dialog/index.ts +25 -0
- package/src/components/core/drop-zone/drop-zone.meta.yaml +55 -0
- package/src/components/core/drop-zone/drop-zone.tsx +146 -0
- package/src/components/core/drop-zone/index.ts +2 -0
- package/src/components/core/dropdown-menu/dropdown-menu.meta.yaml +118 -0
- package/src/components/core/dropdown-menu/dropdown-menu.tsx +407 -0
- package/src/components/core/dropdown-menu/index.ts +32 -0
- package/src/components/core/editable-field/editable-field.meta.yaml +120 -0
- package/src/components/core/editable-field/editable-field.tsx +346 -0
- package/src/components/core/editable-field/index.ts +2 -0
- package/src/components/core/empty-state/empty-state.meta.yaml +21 -0
- package/src/components/core/empty-state/empty-state.tsx +42 -0
- package/src/components/core/empty-state/index.ts +2 -0
- package/src/components/core/field/field.meta.yaml +37 -0
- package/src/components/core/field/field.tsx +100 -0
- package/src/components/core/field/index.ts +9 -0
- package/src/components/core/icon/curated-names.json +107 -0
- package/src/components/core/icon/icon-sets.ts +109 -0
- package/src/components/core/icon/icon.meta.yaml +30 -0
- package/src/components/core/icon/icon.tsx +93 -0
- package/src/components/core/icon/index.ts +2 -0
- package/src/components/core/input/index.ts +4 -0
- package/src/components/core/input/input.meta.yaml +98 -0
- package/src/components/core/input/input.tsx +133 -0
- package/src/components/core/input/textarea.meta.yaml +79 -0
- package/src/components/core/input/textarea.tsx +63 -0
- package/src/components/core/kbd/index.ts +2 -0
- package/src/components/core/kbd/kbd.meta.yaml +12 -0
- package/src/components/core/kbd/kbd.tsx +29 -0
- package/src/components/core/label/index.ts +2 -0
- package/src/components/core/label/label.meta.yaml +55 -0
- package/src/components/core/label/label.tsx +72 -0
- package/src/components/core/main-content/index.ts +2 -0
- package/src/components/core/main-content/main-content.meta.yaml +23 -0
- package/src/components/core/main-content/main-content.tsx +49 -0
- package/src/components/core/pane/index.ts +1 -0
- package/src/components/core/pane/pane.meta.yaml +13 -0
- package/src/components/core/pane/pane.tsx +64 -0
- package/src/components/core/pick-menu/index.ts +4 -0
- package/src/components/core/pick-menu/pick-menu.meta.yaml +36 -0
- package/src/components/core/pick-menu/pick-menu.tsx +348 -0
- package/src/components/core/pick-menu/tag-menu.meta.yaml +7 -0
- package/src/components/core/pick-menu/tag-menu.tsx +79 -0
- package/src/components/core/popover/index.ts +2 -0
- package/src/components/core/popover/popover.meta.yaml +16 -0
- package/src/components/core/popover/popover.tsx +66 -0
- package/src/components/core/progress/index.ts +2 -0
- package/src/components/core/progress/progress.meta.yaml +47 -0
- package/src/components/core/progress/progress.tsx +56 -0
- package/src/components/core/resizable/index.ts +13 -0
- package/src/components/core/resizable/resizable.meta.yaml +110 -0
- package/src/components/core/resizable/resizable.tsx +125 -0
- package/src/components/core/resizable/use-remembered-layout.ts +261 -0
- package/src/components/core/screen-link/index.ts +2 -0
- package/src/components/core/screen-link/screen-link.meta.yaml +34 -0
- package/src/components/core/screen-link/screen-link.tsx +100 -0
- package/src/components/core/scroll-area/index.ts +2 -0
- package/src/components/core/scroll-area/scroll-area.meta.yaml +72 -0
- package/src/components/core/scroll-area/scroll-area.tsx +95 -0
- package/src/components/core/scroll-area/steps.tsx +72 -0
- package/src/components/core/section/index.ts +2 -0
- package/src/components/core/section/section.meta.yaml +72 -0
- package/src/components/core/section/section.tsx +93 -0
- package/src/components/core/segment-group/index.ts +2 -0
- package/src/components/core/segment-group/segment-group.meta.yaml +71 -0
- package/src/components/core/segment-group/segment-group.tsx +166 -0
- package/src/components/core/select/index.ts +20 -0
- package/src/components/core/select/select.meta.yaml +48 -0
- package/src/components/core/select/select.tsx +226 -0
- package/src/components/core/skeleton/index.ts +2 -0
- package/src/components/core/skeleton/skeleton.meta.yaml +50 -0
- package/src/components/core/skeleton/skeleton.tsx +71 -0
- package/src/components/core/slider/index.ts +2 -0
- package/src/components/core/slider/slider.meta.yaml +55 -0
- package/src/components/core/slider/slider.tsx +46 -0
- package/src/components/core/sortable/index.ts +16 -0
- package/src/components/core/sortable/sortable.meta.yaml +125 -0
- package/src/components/core/sortable/sortable.tsx +471 -0
- package/src/components/core/split-view/index.ts +2 -0
- package/src/components/core/split-view/split-view.meta.yaml +85 -0
- package/src/components/core/split-view/split-view.tsx +193 -0
- package/src/components/core/status-icon/index.ts +2 -0
- package/src/components/core/status-icon/status-icon.meta.yaml +64 -0
- package/src/components/core/status-icon/status-icon.tsx +94 -0
- package/src/components/core/table/collapsible-rows.tsx +30 -0
- package/src/components/core/table/expand-toggle.tsx +58 -0
- package/src/components/core/table/group-header.tsx +35 -0
- package/src/components/core/table/index.ts +26 -0
- package/src/components/core/table/table.meta.yaml +67 -0
- package/src/components/core/table/table.tsx +166 -0
- package/src/components/core/tabs/index.ts +2 -0
- package/src/components/core/tabs/tabs.meta.yaml +57 -0
- package/src/components/core/tabs/tabs.tsx +74 -0
- package/src/components/core/tag-pill/index.ts +2 -0
- package/src/components/core/tag-pill/tag-pill.meta.yaml +19 -0
- package/src/components/core/tag-pill/tag-pill.tsx +102 -0
- package/src/components/core/thumbnail/index.ts +2 -0
- package/src/components/core/thumbnail/thumbnail.meta.yaml +59 -0
- package/src/components/core/thumbnail/thumbnail.tsx +162 -0
- package/src/components/core/toast/index.ts +12 -0
- package/src/components/core/toast/toast.meta.yaml +93 -0
- package/src/components/core/toast/toast.tsx +763 -0
- package/src/components/core/toggle/index.ts +2 -0
- package/src/components/core/toggle/toggle.meta.yaml +53 -0
- package/src/components/core/toggle/toggle.tsx +44 -0
- package/src/components/core/toggle-group/index.ts +2 -0
- package/src/components/core/toggle-group/toggle-group.meta.yaml +59 -0
- package/src/components/core/toggle-group/toggle-group.tsx +68 -0
- package/src/components/core/tooltip/index.ts +7 -0
- package/src/components/core/tooltip/tooltip.meta.yaml +93 -0
- package/src/components/core/tooltip/tooltip.tsx +198 -0
- package/src/components/layout/multi-pane/index.ts +4 -0
- package/src/components/layout/multi-pane/list-detail.tsx +45 -0
- package/src/components/layout/multi-pane/multi-pane.meta.yaml +67 -0
- package/src/components/layout/multi-pane/multi-pane.tsx +158 -0
- package/src/components/layout/single-pane/index.ts +2 -0
- package/src/components/layout/single-pane/single-pane.meta.yaml +35 -0
- package/src/components/layout/single-pane/single-pane.tsx +48 -0
- package/src/components/shell/app-shell/app-shell.meta.yaml +65 -0
- package/src/components/shell/app-shell/app-shell.tsx +61 -0
- package/src/components/shell/app-shell/index.ts +2 -0
- package/src/components/shell/sidebar/index.ts +35 -0
- package/src/components/shell/sidebar/sidebar-group.tsx +254 -0
- package/src/components/shell/sidebar/sidebar-item.tsx +88 -0
- package/src/components/shell/sidebar/sidebar-resize-handle.tsx +101 -0
- package/src/components/shell/sidebar/sidebar-tree.tsx +325 -0
- package/src/components/shell/sidebar/sidebar.meta.yaml +126 -0
- package/src/components/shell/sidebar/sidebar.tsx +142 -0
- package/src/components/template/address-book-template/address-book-template.meta.yaml +22 -0
- package/src/components/template/address-book-template/address-book-template.tsx +201 -0
- package/src/components/template/address-book-template/index.ts +2 -0
- package/src/components/template/mail-template/index.ts +2 -0
- package/src/components/template/mail-template/mail-template.meta.yaml +22 -0
- package/src/components/template/mail-template/mail-template.tsx +731 -0
- package/src/components/template/use-narrow.ts +18 -0
- package/src/index.ts +505 -0
- package/src/kit/check-rendering.tsx +130 -0
- package/src/kit/kit.tsx +177 -0
- package/src/lib/clipboard.ts +27 -0
- package/src/lib/dates.ts +13 -0
- package/src/lib/json.ts +59 -0
- package/src/lib/keys.ts +54 -0
- package/src/lib/utils.ts +12 -0
- package/src/lib/view-scope.tsx +60 -0
- package/src/profile/profile.ts +238 -0
- package/src/theme/appearance.ts +198 -0
- package/src/theme/boot.ts +6 -0
- package/src/theme/client-appearance-react.ts +14 -0
- package/src/theme/client-appearance.ts +284 -0
- package/src/theme/generate-tokens.ts +658 -0
- package/src/theme/pack-themes-react.ts +107 -0
- package/src/theme/palette.ts +301 -0
- package/src/theme/semantic-mapping.ts +165 -0
- package/src/theme/set-theme.ts +162 -0
- package/src/theme/theme-colours.ts +60 -0
- package/src/theme/theme-css.ts +15 -0
- package/src/theme/themes.ts +133 -0
- package/src/theme/wallpaper-sheet.ts +58 -0
- package/src/theme/wallpaper-theme-react.ts +60 -0
- package/src/theme/wallpaper-theme.ts +231 -0
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
import { cva, type VariantProps } from "class-variance-authority";
|
|
3
|
+
|
|
4
|
+
import { cn } from "../../../lib/utils";
|
|
5
|
+
import {
|
|
6
|
+
SidebarCollapse,
|
|
7
|
+
SidebarGroup,
|
|
8
|
+
SidebarGroupContent,
|
|
9
|
+
SidebarGroupTrigger,
|
|
10
|
+
type SidebarCollapseProps,
|
|
11
|
+
type SidebarGroupContentProps,
|
|
12
|
+
type SidebarGroupProps,
|
|
13
|
+
type SidebarGroupTriggerProps,
|
|
14
|
+
} from "./sidebar-group";
|
|
15
|
+
import { SidebarItem, sidebarItemVariants, type SidebarItemProps } from "./sidebar-item";
|
|
16
|
+
import { ScrollArea } from "../../core/scroll-area";
|
|
17
|
+
import {
|
|
18
|
+
SIDEBAR_DEFAULT_WIDTH,
|
|
19
|
+
SIDEBAR_MIN_WIDTH,
|
|
20
|
+
SidebarResizeHandle,
|
|
21
|
+
clampSidebarWidth,
|
|
22
|
+
type SidebarResizeHandleProps,
|
|
23
|
+
} from "./sidebar-resize-handle";
|
|
24
|
+
import {
|
|
25
|
+
SidebarTree,
|
|
26
|
+
SidebarTreeItem,
|
|
27
|
+
type SidebarTreeItemProps,
|
|
28
|
+
type SidebarTreeProps,
|
|
29
|
+
} from "./sidebar-tree";
|
|
30
|
+
|
|
31
|
+
// --- Sidebar (root) ---
|
|
32
|
+
|
|
33
|
+
const sidebarVariants = cva(
|
|
34
|
+
"flex h-full flex-col bg-sidebar w-(--sidebar-width,220px) py-3 px-2 min-h-0 overflow-hidden has-[[data-slot=sidebar-content]]:p-0",
|
|
35
|
+
);
|
|
36
|
+
|
|
37
|
+
interface SidebarProps extends React.ComponentProps<"nav">, VariantProps<typeof sidebarVariants> {}
|
|
38
|
+
|
|
39
|
+
function Sidebar({ className, ...props }: SidebarProps) {
|
|
40
|
+
return <nav data-slot="sidebar" className={cn(sidebarVariants({ className }))} {...props} />;
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
// --- SidebarContent ---
|
|
44
|
+
|
|
45
|
+
interface SidebarContentProps extends React.ComponentProps<"div"> {}
|
|
46
|
+
|
|
47
|
+
function SidebarContent({ className, ...props }: SidebarContentProps) {
|
|
48
|
+
// It scrolls in the kit's ScrollArea (Bridge's scrollbar, not the OS's), its rows in a column inside.
|
|
49
|
+
return (
|
|
50
|
+
<ScrollArea className="flex min-h-0 flex-1 flex-col" viewportClassName="min-h-0 flex-1">
|
|
51
|
+
<div
|
|
52
|
+
data-slot="sidebar-content"
|
|
53
|
+
className={cn("flex flex-col gap-px py-3 px-2", className)}
|
|
54
|
+
{...props}
|
|
55
|
+
/>
|
|
56
|
+
</ScrollArea>
|
|
57
|
+
);
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
// --- SidebarHeader ---
|
|
61
|
+
|
|
62
|
+
interface SidebarHeaderProps extends React.ComponentProps<"div"> {}
|
|
63
|
+
|
|
64
|
+
/** Brand / app header for the top of a sidebar. Use as the first child of
|
|
65
|
+
* SidebarContent — its `px-1.5` matches SidebarItem so the brand icon lands on
|
|
66
|
+
* the same left rail as the nav item icons (no manual alignment). */
|
|
67
|
+
function SidebarHeader({ className, ...props }: SidebarHeaderProps) {
|
|
68
|
+
return (
|
|
69
|
+
<div
|
|
70
|
+
data-slot="sidebar-header"
|
|
71
|
+
className={cn("flex items-center gap-2 px-1.5 pt-0.5 pb-1.5", className)}
|
|
72
|
+
{...props}
|
|
73
|
+
/>
|
|
74
|
+
);
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
// --- SidebarSection ---
|
|
78
|
+
|
|
79
|
+
interface SidebarSectionProps extends React.ComponentProps<"div"> {}
|
|
80
|
+
|
|
81
|
+
function SidebarSection({ className, ...props }: SidebarSectionProps) {
|
|
82
|
+
return (
|
|
83
|
+
<div
|
|
84
|
+
data-slot="sidebar-section"
|
|
85
|
+
className={cn(
|
|
86
|
+
"text-xs font-medium text-muted uppercase tracking-[0.5px] px-1.5 pt-3.5 pb-1",
|
|
87
|
+
className,
|
|
88
|
+
)}
|
|
89
|
+
{...props}
|
|
90
|
+
/>
|
|
91
|
+
);
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
// --- SidebarFooter ---
|
|
95
|
+
|
|
96
|
+
interface SidebarFooterProps extends React.ComponentProps<"div"> {}
|
|
97
|
+
|
|
98
|
+
function SidebarFooter({ className, ...props }: SidebarFooterProps) {
|
|
99
|
+
return (
|
|
100
|
+
<div
|
|
101
|
+
data-slot="sidebar-footer"
|
|
102
|
+
className={cn("shrink-0 border-t border-border-subtle pt-2 pb-3 px-2", className)}
|
|
103
|
+
{...props}
|
|
104
|
+
/>
|
|
105
|
+
);
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
export {
|
|
109
|
+
Sidebar,
|
|
110
|
+
sidebarVariants,
|
|
111
|
+
SidebarContent,
|
|
112
|
+
SidebarHeader,
|
|
113
|
+
SidebarSection,
|
|
114
|
+
SidebarItem,
|
|
115
|
+
sidebarItemVariants,
|
|
116
|
+
SidebarFooter,
|
|
117
|
+
SidebarGroup,
|
|
118
|
+
SidebarGroupTrigger,
|
|
119
|
+
SidebarGroupContent,
|
|
120
|
+
SidebarTree,
|
|
121
|
+
SidebarTreeItem,
|
|
122
|
+
SidebarCollapse,
|
|
123
|
+
SidebarResizeHandle,
|
|
124
|
+
SIDEBAR_MIN_WIDTH,
|
|
125
|
+
SIDEBAR_DEFAULT_WIDTH,
|
|
126
|
+
clampSidebarWidth,
|
|
127
|
+
};
|
|
128
|
+
export type {
|
|
129
|
+
SidebarProps,
|
|
130
|
+
SidebarContentProps,
|
|
131
|
+
SidebarHeaderProps,
|
|
132
|
+
SidebarSectionProps,
|
|
133
|
+
SidebarItemProps,
|
|
134
|
+
SidebarFooterProps,
|
|
135
|
+
SidebarGroupProps,
|
|
136
|
+
SidebarGroupTriggerProps,
|
|
137
|
+
SidebarGroupContentProps,
|
|
138
|
+
SidebarTreeProps,
|
|
139
|
+
SidebarTreeItemProps,
|
|
140
|
+
SidebarCollapseProps,
|
|
141
|
+
SidebarResizeHandleProps,
|
|
142
|
+
};
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
name: AddressBookTemplate
|
|
2
|
+
description: "A template (an example to build from, sample data, nothing behind it): an address book of 40 made-up people. MultiPane with a Pane on the left (a search, a records List, a count) and a Detail on the right (an avatar, the name, Properties). Narrow, the list alone; a row opens its record alone with Back, as a phone screen."
|
|
3
|
+
layer: template
|
|
4
|
+
category: template
|
|
5
|
+
when_to_use:
|
|
6
|
+
- "To see how a list-and-record screen is put together before building one with real data (Contacts, Organizations)"
|
|
7
|
+
when_not_to_use:
|
|
8
|
+
- "In a plugin's screen: build it with MultiPane, Pane, List and Detail bound to the plugin's data (RecordsScreen for records)"
|
|
9
|
+
props:
|
|
10
|
+
- name: openId
|
|
11
|
+
type: string
|
|
12
|
+
required: false
|
|
13
|
+
description: "With onOpen, driven by a shell: the person open (the screen's item in Bridge's phone shell), none for the list alone"
|
|
14
|
+
- name: onOpen
|
|
15
|
+
type: "(id: string) => void"
|
|
16
|
+
required: false
|
|
17
|
+
description: "A row opened: the shell opens it (ctx.screen.open), its Back closes it; without it the template keeps its own person and its own Back"
|
|
18
|
+
composition_partners:
|
|
19
|
+
- MultiPane (its layout)
|
|
20
|
+
- Pane, Input, List, EmptyState (the list)
|
|
21
|
+
- Detail, Avatar, Section, Properties (the record)
|
|
22
|
+
notes: "Sub-parts by data-slot: address-book-template. Its people are made up; searching filters them by name or company."
|
|
@@ -0,0 +1,201 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
|
|
3
|
+
import { Avatar } from "../../core/avatar";
|
|
4
|
+
import { Button } from "../../core/button";
|
|
5
|
+
import { Detail, DetailHeader, DetailTitle } from "../../core/detail";
|
|
6
|
+
import { EmptyState } from "../../core/empty-state";
|
|
7
|
+
import { Icon } from "../../core/icon";
|
|
8
|
+
import { Input } from "../../core/input";
|
|
9
|
+
import { Pane, PaneBody, PaneFooter, PaneHeader } from "../../core/pane";
|
|
10
|
+
import { Section } from "../../core/section";
|
|
11
|
+
import { List, ListItem } from "../../composite/list";
|
|
12
|
+
import { Properties, PropertyRow } from "../../composite/properties";
|
|
13
|
+
import { MultiPane } from "../../layout/multi-pane";
|
|
14
|
+
import { useNarrow } from "../use-narrow";
|
|
15
|
+
|
|
16
|
+
// research-070: a template, an example to build from, with sample data and nothing behind it. A list beside its
|
|
17
|
+
// record (an address book of 40 made-up people, enough for the list to scroll): MultiPane, a Pane holding a search and a
|
|
18
|
+
// records List on the left, a Detail on the right. Narrow (a phone), the list alone; a row opens its record alone with
|
|
19
|
+
// a Back button, as a phone screen would (or, driven by a shell, with the shell's Back).
|
|
20
|
+
|
|
21
|
+
interface Person {
|
|
22
|
+
id: string;
|
|
23
|
+
name: string;
|
|
24
|
+
email: string;
|
|
25
|
+
phone: string;
|
|
26
|
+
company: string;
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
const people: Person[] = [
|
|
30
|
+
["Ada Moreau", "Northwind"],
|
|
31
|
+
["Basile Laurent", "Atelier Brun"],
|
|
32
|
+
["Chloé Martin", "Northwind"],
|
|
33
|
+
["David Okafor", "Lumen"],
|
|
34
|
+
["Elena Rossi", "Atelier Brun"],
|
|
35
|
+
["Farid Haddad", "Lumen"],
|
|
36
|
+
["Gaëlle Simon", "Northwind"],
|
|
37
|
+
["Hugo Petit", "Kestrel"],
|
|
38
|
+
["Inès Fontaine", "Kestrel"],
|
|
39
|
+
["Jules Bernard", "Lumen"],
|
|
40
|
+
["Kenji Watanabe", "Atelier Brun"],
|
|
41
|
+
["Léa Dubois", "Kestrel"],
|
|
42
|
+
["Malik Benali", "Northwind"],
|
|
43
|
+
["Nora Lindqvist", "Lumen"],
|
|
44
|
+
["Oscar Girard", "Kestrel"],
|
|
45
|
+
["Paula Ferreira", "Atelier Brun"],
|
|
46
|
+
["Quentin Roux", "Northwind"],
|
|
47
|
+
["Rania Saleh", "Lumen"],
|
|
48
|
+
["Samuel Cohen", "Kestrel"],
|
|
49
|
+
["Tara Nair", "Atelier Brun"],
|
|
50
|
+
["Ugo Bianchi", "Northwind"],
|
|
51
|
+
["Vera Novak", "Lumen"],
|
|
52
|
+
["William Blake", "Kestrel"],
|
|
53
|
+
["Xavier Leroy", "Atelier Brun"],
|
|
54
|
+
["Yasmine Amrani", "Northwind"],
|
|
55
|
+
["Zoé Lambert", "Lumen"],
|
|
56
|
+
["Adrien Faure", "Kestrel"],
|
|
57
|
+
["Bianca Costa", "Atelier Brun"],
|
|
58
|
+
["Camille Renard", "Northwind"],
|
|
59
|
+
["Diane Mercier", "Lumen"],
|
|
60
|
+
["Émile Garnier", "Kestrel"],
|
|
61
|
+
["Fatou Diallo", "Atelier Brun"],
|
|
62
|
+
["Gabriel Henry", "Northwind"],
|
|
63
|
+
["Hana Sato", "Lumen"],
|
|
64
|
+
["Ilan Weiss", "Kestrel"],
|
|
65
|
+
["Jade Chevalier", "Atelier Brun"],
|
|
66
|
+
["Karim Mansour", "Northwind"],
|
|
67
|
+
["Lina Perrin", "Lumen"],
|
|
68
|
+
["Marc Olsen", "Kestrel"],
|
|
69
|
+
["Nadia Rahman", "Atelier Brun"],
|
|
70
|
+
].map(([name, company], i) => {
|
|
71
|
+
const first = name!.split(" ")[0]!.normalize("NFD").replace(/\p{M}/gu, "").toLowerCase();
|
|
72
|
+
return {
|
|
73
|
+
id: `p${i + 1}`,
|
|
74
|
+
name: name!,
|
|
75
|
+
company: company!,
|
|
76
|
+
email: `${first}@${company!.toLowerCase().replace(/\s+/g, "")}.example`,
|
|
77
|
+
phone: `+33 6 ${String((10 + i * 7) % 100).padStart(2, "0")} ${String((20 + i * 3) % 100).padStart(2, "0")} 40 ${String((11 + i) % 100).padStart(2, "0")}`,
|
|
78
|
+
};
|
|
79
|
+
});
|
|
80
|
+
|
|
81
|
+
interface AddressBookTemplateProps extends Omit<React.ComponentProps<"div">, "children"> {
|
|
82
|
+
/** Driven by a shell (Bridge's phone shell: the opened person is the screen's item, its Back closes it): the person
|
|
83
|
+
* open, none for the list alone. Without `onOpen`, the template keeps its own (the first person, its own Back). */
|
|
84
|
+
openId?: string | undefined;
|
|
85
|
+
/** A row opened, with `openId`: the shell opens it (`ctx.screen.open`). */
|
|
86
|
+
onOpen?: ((id: string) => void) | undefined;
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
function AddressBookTemplate({ openId: driven, onOpen, ...props }: AddressBookTemplateProps) {
|
|
90
|
+
const root = React.useRef<HTMLDivElement | null>(null);
|
|
91
|
+
const narrow = useNarrow(root);
|
|
92
|
+
const [query, setQuery] = React.useState("");
|
|
93
|
+
const [own, setOwn] = React.useState<string | undefined>(people[0]!.id);
|
|
94
|
+
/** Narrow: the record shown alone (a phone pushed it). */
|
|
95
|
+
const [ownPushed, setPushed] = React.useState(false);
|
|
96
|
+
const openId = onOpen ? driven : own;
|
|
97
|
+
const pushed = onOpen ? driven !== undefined : ownPushed;
|
|
98
|
+
const shown = people.filter((person) =>
|
|
99
|
+
`${person.name} ${person.company}`.toLowerCase().includes(query.trim().toLowerCase()),
|
|
100
|
+
);
|
|
101
|
+
const open = people.find((person) => person.id === openId);
|
|
102
|
+
const openRow = (id: string) => {
|
|
103
|
+
if (onOpen) return onOpen(id);
|
|
104
|
+
setOwn(id);
|
|
105
|
+
if (narrow) setPushed(true);
|
|
106
|
+
};
|
|
107
|
+
|
|
108
|
+
const list = (
|
|
109
|
+
<Pane aria-label="People">
|
|
110
|
+
<PaneHeader>
|
|
111
|
+
<Input
|
|
112
|
+
variant="outline"
|
|
113
|
+
type="search"
|
|
114
|
+
placeholder="Search"
|
|
115
|
+
aria-label="Search people"
|
|
116
|
+
value={query}
|
|
117
|
+
onChange={(event) => setQuery(event.target.value)}
|
|
118
|
+
/>
|
|
119
|
+
</PaneHeader>
|
|
120
|
+
<PaneBody>
|
|
121
|
+
{shown.length === 0 ? (
|
|
122
|
+
<EmptyState fill>No one matches</EmptyState>
|
|
123
|
+
) : (
|
|
124
|
+
<List
|
|
125
|
+
variant="records"
|
|
126
|
+
aria-label="People"
|
|
127
|
+
{...(openId !== undefined && { openKey: openId })}
|
|
128
|
+
onOpen={openRow}
|
|
129
|
+
>
|
|
130
|
+
{shown.map((person) => (
|
|
131
|
+
<ListItem
|
|
132
|
+
key={person.id}
|
|
133
|
+
value={person.id}
|
|
134
|
+
textValue={person.name}
|
|
135
|
+
leading={<Avatar name={person.name} size="sm" tint />}
|
|
136
|
+
trailing={<span className="text-xs text-muted">{person.company}</span>}
|
|
137
|
+
>
|
|
138
|
+
{person.name}
|
|
139
|
+
</ListItem>
|
|
140
|
+
))}
|
|
141
|
+
</List>
|
|
142
|
+
)}
|
|
143
|
+
</PaneBody>
|
|
144
|
+
<PaneFooter>
|
|
145
|
+
<span>
|
|
146
|
+
<strong>{shown.length}</strong> people
|
|
147
|
+
</span>
|
|
148
|
+
</PaneFooter>
|
|
149
|
+
</Pane>
|
|
150
|
+
);
|
|
151
|
+
|
|
152
|
+
const record = open ? (
|
|
153
|
+
<Detail aria-label={open.name}>
|
|
154
|
+
{narrow && !onOpen && (
|
|
155
|
+
<div>
|
|
156
|
+
<Button variant="ghost" size="sm" onClick={() => setPushed(false)}>
|
|
157
|
+
<Icon name="chevron-left" size={14} />
|
|
158
|
+
Back
|
|
159
|
+
</Button>
|
|
160
|
+
</div>
|
|
161
|
+
)}
|
|
162
|
+
<DetailHeader>
|
|
163
|
+
<Avatar name={open.name} size="3xl" tint />
|
|
164
|
+
<DetailTitle>
|
|
165
|
+
<Section size="lg" title={open.name} description={open.company} />
|
|
166
|
+
</DetailTitle>
|
|
167
|
+
</DetailHeader>
|
|
168
|
+
<Properties>
|
|
169
|
+
<PropertyRow label="Email">{open.email}</PropertyRow>
|
|
170
|
+
<PropertyRow label="Phone">{open.phone}</PropertyRow>
|
|
171
|
+
<PropertyRow label="Company">{open.company}</PropertyRow>
|
|
172
|
+
</Properties>
|
|
173
|
+
</Detail>
|
|
174
|
+
) : (
|
|
175
|
+
<EmptyState fill>No one selected</EmptyState>
|
|
176
|
+
);
|
|
177
|
+
|
|
178
|
+
return (
|
|
179
|
+
<div
|
|
180
|
+
ref={root}
|
|
181
|
+
data-slot="address-book-template"
|
|
182
|
+
className="flex min-h-0 min-w-0 flex-1 flex-col"
|
|
183
|
+
{...props}
|
|
184
|
+
>
|
|
185
|
+
<MultiPane
|
|
186
|
+
mode={narrow && pushed ? "main" : "split"}
|
|
187
|
+
defaultNavSize="320px"
|
|
188
|
+
nav={list}
|
|
189
|
+
main={record}
|
|
190
|
+
/>
|
|
191
|
+
</div>
|
|
192
|
+
);
|
|
193
|
+
}
|
|
194
|
+
|
|
195
|
+
/** @deprecated AddressBookTemplate, its name until November 2026 (published in 0.1.x, so kept). */
|
|
196
|
+
const ListDetailTemplate = AddressBookTemplate;
|
|
197
|
+
/** @deprecated AddressBookTemplateProps. */
|
|
198
|
+
type ListDetailTemplateProps = AddressBookTemplateProps;
|
|
199
|
+
|
|
200
|
+
export { AddressBookTemplate, ListDetailTemplate };
|
|
201
|
+
export type { AddressBookTemplateProps, ListDetailTemplateProps };
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
name: MailTemplate
|
|
2
|
+
description: "A template (an example to build from, sample data, nothing behind it): a mailbox of 24 made-up mails. MultiPane with a Pane on the left (a search, a records List grouped by day, Today, Yesterday, Last 7 days, Earlier; each row three lines as mail clients show it: the sender and the date, the subject, the text's start in grey; unread, a dot in the row checkbox's place (ListItem marker), important, a red flag there instead (the flag wins; the bold still says unread) and the sender, subject and date in bold; no avatar, as mail clients' lists; a count; the rows selected get a bar over the list: Archive, Spam, Mark read, Mark unread, Flag (every swipe action reachable without a swipe); on touch a row's swipe (ListItem swipeStart/swipeEnd, as Proton Mail): Flag and Read/Unread (blue) to the right, Archive and Spam to the left, a full swipe to the left archives) and the mail open on the right in a Detail, in a large Card on a grey pane (bg-hover) so it stands out (the subject as its title, the sender as mail clients show it: the name and the date, the address and 'to You' under them; then the text, and a bordered memo field to reply under it). Its actions change the sample only, as mail clients do: Archive (the mail leaves the inbox, the next one opens, a toast offers Undo), Flag (pressed when flagged), Mark unread / Mark read (its icon the mail's state: an open envelope read, a closed one unread), Reply (Send says it was sent). Opening a mail marks it read; J or ↓ opens the next one while the list is beside it. Narrow, the list alone; a row opens its mail alone with Back, as a phone screen: the whole screen, no card nor grey pane, a smaller title, as mail apps show a message. Its toasts need a ToastProvider (Bridge's shell gives one to every screen)."
|
|
3
|
+
layer: template
|
|
4
|
+
category: template
|
|
5
|
+
when_to_use:
|
|
6
|
+
- "To see how a list of messages beside the one open is put together before building one with real data (mail, notifications, a support inbox)"
|
|
7
|
+
when_not_to_use:
|
|
8
|
+
- "In a plugin's screen: build it with MultiPane, Pane, List and Detail bound to the plugin's data"
|
|
9
|
+
props:
|
|
10
|
+
- name: openId
|
|
11
|
+
type: string
|
|
12
|
+
required: false
|
|
13
|
+
description: "With onOpen, driven by a shell: the mail open (the screen's item in Bridge's phone shell), none for the list alone"
|
|
14
|
+
- name: onOpen
|
|
15
|
+
type: "(id: string) => void"
|
|
16
|
+
required: false
|
|
17
|
+
description: "A row opened: the shell opens it (ctx.screen.open), its Back closes it; without it the template keeps its own mail and its own Back"
|
|
18
|
+
composition_partners:
|
|
19
|
+
- MultiPane (its layout)
|
|
20
|
+
- Pane, Input, List (openFollowsCursor, marker), ListGroup, BulkBar and BulkAction, EmptyState with Clear search (the list)
|
|
21
|
+
- Detail, Section, Button and Tip (Archive, Flag, Mark unread), Icon flag, Card, Textarea outline (Reply), useToast (the mail)
|
|
22
|
+
notes: "Sub-parts by data-slot: mail-template, mail-template-mail, mail-template-from, mail-template-body, mail-template-reply; an unread row carries data-unread. A row is ListItem's free content (size auto), the kit's way for a mail or a chat row. Its mails are made up; searching filters them by sender, subject or text; nothing found names the search and offers Clear search."
|