@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,407 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
import { Menu as MenuPrimitive } from "@base-ui/react/menu";
|
|
3
|
+
import { ContextMenu as ContextMenuPrimitive } from "@base-ui/react/context-menu";
|
|
4
|
+
import { cva, type VariantProps } from "class-variance-authority";
|
|
5
|
+
import { ChevronRight } from "lucide-react";
|
|
6
|
+
|
|
7
|
+
import { cn } from "../../../lib/utils";
|
|
8
|
+
import { formatKeys } from "../../../lib/keys";
|
|
9
|
+
|
|
10
|
+
// --- DropdownMenu (root) ---
|
|
11
|
+
|
|
12
|
+
interface DropdownMenuProps extends React.ComponentProps<typeof MenuPrimitive.Root> {}
|
|
13
|
+
|
|
14
|
+
function DropdownMenu(props: DropdownMenuProps) {
|
|
15
|
+
return <MenuPrimitive.Root {...props} />;
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
// --- DropdownMenuTrigger ---
|
|
19
|
+
|
|
20
|
+
interface DropdownMenuTriggerProps extends React.ComponentProps<typeof MenuPrimitive.Trigger> {}
|
|
21
|
+
|
|
22
|
+
/** Base UI 1.7's trigger renders first with a placeholder of its menu's state, and only reads the real one once its
|
|
23
|
+
* passive effects ran: a press before them (right after the trigger appears, the page busy) opened nothing. Such a
|
|
24
|
+
* press is held (Base UI's, the caller's and the parents' click handlers skipped), and given again as a click once
|
|
25
|
+
* the trigger has rendered again. */
|
|
26
|
+
function DropdownMenuTrigger({
|
|
27
|
+
className,
|
|
28
|
+
onPointerDown,
|
|
29
|
+
onMouseDown,
|
|
30
|
+
onClick,
|
|
31
|
+
...props
|
|
32
|
+
}: DropdownMenuTriggerProps) {
|
|
33
|
+
const [ready, setReady] = React.useState(false);
|
|
34
|
+
const held = React.useRef<{ target: HTMLElement; detail: number } | null>(null);
|
|
35
|
+
React.useEffect(() => setReady(true), []);
|
|
36
|
+
React.useEffect(() => {
|
|
37
|
+
if (!ready || !held.current) return;
|
|
38
|
+
const { target, detail } = held.current;
|
|
39
|
+
held.current = null;
|
|
40
|
+
target.dispatchEvent(new MouseEvent("click", { bubbles: true, cancelable: true, detail }));
|
|
41
|
+
}, [ready]);
|
|
42
|
+
return (
|
|
43
|
+
<MenuPrimitive.Trigger
|
|
44
|
+
data-slot="dropdown-menu-trigger"
|
|
45
|
+
className={className}
|
|
46
|
+
onPointerDown={(event) => {
|
|
47
|
+
onPointerDown?.(event);
|
|
48
|
+
if (!ready) event.preventBaseUIHandler();
|
|
49
|
+
}}
|
|
50
|
+
onMouseDown={(event) => {
|
|
51
|
+
onMouseDown?.(event);
|
|
52
|
+
if (!ready) event.preventBaseUIHandler();
|
|
53
|
+
}}
|
|
54
|
+
onClick={(event) => {
|
|
55
|
+
if (ready) return onClick?.(event);
|
|
56
|
+
// Held whole: the given click runs the caller's and the parents' handlers once.
|
|
57
|
+
event.preventBaseUIHandler();
|
|
58
|
+
event.stopPropagation();
|
|
59
|
+
held.current = { target: event.currentTarget, detail: event.detail };
|
|
60
|
+
}}
|
|
61
|
+
{...props}
|
|
62
|
+
/>
|
|
63
|
+
);
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
// --- ContextMenu: the same menu, opened by a right-click (or the keyboard's
|
|
67
|
+
// context menu key, Shift+F10) on its trigger area; its content and items are
|
|
68
|
+
// DropdownMenuContent and DropdownMenuItem. ---
|
|
69
|
+
|
|
70
|
+
interface ContextMenuProps extends React.ComponentProps<typeof ContextMenuPrimitive.Root> {}
|
|
71
|
+
|
|
72
|
+
function ContextMenu(props: ContextMenuProps) {
|
|
73
|
+
return <ContextMenuPrimitive.Root {...props} />;
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
interface ContextMenuTriggerProps extends React.ComponentProps<
|
|
77
|
+
typeof ContextMenuPrimitive.Trigger
|
|
78
|
+
> {}
|
|
79
|
+
|
|
80
|
+
/** The keyboard's context menu key or Shift+F10, on a focused element: sends it the `contextmenu` a right-click would,
|
|
81
|
+
* under it (browsers do not all send one for those keys: macOS never does). For any element whose menu opens on
|
|
82
|
+
* `contextmenu`, not only `ContextMenuTrigger`'s; `true` when it did. */
|
|
83
|
+
function openContextMenuFromKey(event: React.KeyboardEvent): boolean {
|
|
84
|
+
if (
|
|
85
|
+
event.defaultPrevented ||
|
|
86
|
+
!(event.key === "ContextMenu" || (event.shiftKey && event.key === "F10"))
|
|
87
|
+
)
|
|
88
|
+
return false;
|
|
89
|
+
event.preventDefault();
|
|
90
|
+
const target = event.target as HTMLElement;
|
|
91
|
+
const box = target.getBoundingClientRect();
|
|
92
|
+
target.dispatchEvent(
|
|
93
|
+
new MouseEvent("contextmenu", {
|
|
94
|
+
bubbles: true,
|
|
95
|
+
cancelable: true,
|
|
96
|
+
clientX: box.left + 8,
|
|
97
|
+
clientY: box.bottom,
|
|
98
|
+
}),
|
|
99
|
+
);
|
|
100
|
+
return true;
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
/** The area a right-click opens the menu in: a `div` around its children. The keyboard's context menu key and
|
|
104
|
+
* Shift+F10 on a focused element inside open it too, under that element (`openContextMenuFromKey`). */
|
|
105
|
+
function ContextMenuTrigger({ onKeyDown, ...props }: ContextMenuTriggerProps) {
|
|
106
|
+
return (
|
|
107
|
+
<ContextMenuPrimitive.Trigger
|
|
108
|
+
data-slot="context-menu-trigger"
|
|
109
|
+
onKeyDown={(event) => {
|
|
110
|
+
onKeyDown?.(event);
|
|
111
|
+
openContextMenuFromKey(event);
|
|
112
|
+
}}
|
|
113
|
+
{...props}
|
|
114
|
+
/>
|
|
115
|
+
);
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
// --- DropdownMenuContent ---
|
|
119
|
+
|
|
120
|
+
interface DropdownMenuContentProps extends React.ComponentProps<typeof MenuPrimitive.Popup> {
|
|
121
|
+
/** Distance from the trigger in px (lives on Base UI's Positioner) */
|
|
122
|
+
sideOffset?: React.ComponentProps<typeof MenuPrimitive.Positioner>["sideOffset"];
|
|
123
|
+
/** Alignment against the trigger (lives on Base UI's Positioner) */
|
|
124
|
+
align?: React.ComponentProps<typeof MenuPrimitive.Positioner>["align"];
|
|
125
|
+
/** Which side of the trigger to position against (lives on Base UI's Positioner) */
|
|
126
|
+
side?: React.ComponentProps<typeof MenuPrimitive.Positioner>["side"];
|
|
127
|
+
/** Offset along the alignment axis (lives on Base UI's Positioner) */
|
|
128
|
+
alignOffset?: React.ComponentProps<typeof MenuPrimitive.Positioner>["alignOffset"];
|
|
129
|
+
/** Minimum distance from the viewport edges (lives on Base UI's Positioner) */
|
|
130
|
+
collisionPadding?: React.ComponentProps<typeof MenuPrimitive.Positioner>["collisionPadding"];
|
|
131
|
+
/** What to position against instead of the trigger: an element, or a point (a virtual element, e.g. where a
|
|
132
|
+
* right-click happened) (lives on Base UI's Positioner) */
|
|
133
|
+
anchor?: React.ComponentProps<typeof MenuPrimitive.Positioner>["anchor"];
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
function DropdownMenuContent({
|
|
137
|
+
className,
|
|
138
|
+
sideOffset = 4,
|
|
139
|
+
align = "start",
|
|
140
|
+
side,
|
|
141
|
+
alignOffset,
|
|
142
|
+
collisionPadding,
|
|
143
|
+
anchor,
|
|
144
|
+
...props
|
|
145
|
+
}: DropdownMenuContentProps) {
|
|
146
|
+
// An item's one-letter keys (`keys="R"`) run it while the menu is open (research-033's mockup).
|
|
147
|
+
const letters = React.useRef(new Map<string, HTMLElement>());
|
|
148
|
+
// Never an empty menu (owner, 17 October 2026): nothing to offer, nothing shown.
|
|
149
|
+
if (React.Children.toArray(props.children).length === 0) return null;
|
|
150
|
+
return (
|
|
151
|
+
<MenuPrimitive.Portal>
|
|
152
|
+
<MenuPrimitive.Positioner
|
|
153
|
+
sideOffset={sideOffset}
|
|
154
|
+
align={align}
|
|
155
|
+
side={side}
|
|
156
|
+
alignOffset={alignOffset}
|
|
157
|
+
collisionPadding={collisionPadding}
|
|
158
|
+
anchor={anchor}
|
|
159
|
+
className="z-50"
|
|
160
|
+
>
|
|
161
|
+
<MenuPrimitive.Popup
|
|
162
|
+
data-slot="dropdown-menu-content"
|
|
163
|
+
className={cn(
|
|
164
|
+
"z-50 min-w-[200px] bg-surface rounded-dropdown p-1 flex flex-col",
|
|
165
|
+
className,
|
|
166
|
+
)}
|
|
167
|
+
style={{ boxShadow: "var(--shadow-dropdown)" }}
|
|
168
|
+
{...props}
|
|
169
|
+
onKeyDownCapture={(event) => {
|
|
170
|
+
props.onKeyDownCapture?.(event);
|
|
171
|
+
if (event.metaKey || event.ctrlKey || event.altKey || event.key.length !== 1) return;
|
|
172
|
+
const item = letters.current.get(event.key.toLowerCase());
|
|
173
|
+
if (!item) return;
|
|
174
|
+
event.preventDefault();
|
|
175
|
+
event.stopPropagation();
|
|
176
|
+
item.click();
|
|
177
|
+
}}
|
|
178
|
+
>
|
|
179
|
+
<MenuLetters.Provider value={letters}>{props.children}</MenuLetters.Provider>
|
|
180
|
+
</MenuPrimitive.Popup>
|
|
181
|
+
</MenuPrimitive.Positioner>
|
|
182
|
+
</MenuPrimitive.Portal>
|
|
183
|
+
);
|
|
184
|
+
}
|
|
185
|
+
|
|
186
|
+
/** The open menu's one-letter items, by letter (lower case). */
|
|
187
|
+
const MenuLetters = React.createContext<React.RefObject<Map<string, HTMLElement>> | null>(null);
|
|
188
|
+
|
|
189
|
+
// --- DropdownMenuItem ---
|
|
190
|
+
|
|
191
|
+
const dropdownMenuItemVariants = cva(
|
|
192
|
+
// Bridge: a disabled item (Base UI's `data-disabled`) is dimmed and inert, as a disabled Button.
|
|
193
|
+
"flex items-center gap-2 px-2 rounded-control text-sm font-normal cursor-pointer bg-transparent border-0 w-full text-left transition-[background] duration-[80ms] outline-none select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50",
|
|
194
|
+
{
|
|
195
|
+
variants: {
|
|
196
|
+
variant: {
|
|
197
|
+
default: "text-foreground focus:bg-hover data-[highlighted]:bg-hover",
|
|
198
|
+
destructive:
|
|
199
|
+
"text-destructive focus:bg-destructive-subtle data-[highlighted]:bg-destructive-subtle",
|
|
200
|
+
},
|
|
201
|
+
// `large`: a launcher's items (a Start menu's first column), taller with a bigger icon; a rendering reads
|
|
202
|
+
// `data-size`.
|
|
203
|
+
size: {
|
|
204
|
+
default: "h-md",
|
|
205
|
+
large: "h-lg gap-2.5 [&_svg:not([class*='size-'])]:size-5",
|
|
206
|
+
},
|
|
207
|
+
},
|
|
208
|
+
defaultVariants: {
|
|
209
|
+
variant: "default",
|
|
210
|
+
size: "default",
|
|
211
|
+
},
|
|
212
|
+
},
|
|
213
|
+
);
|
|
214
|
+
|
|
215
|
+
interface DropdownMenuItemProps
|
|
216
|
+
extends
|
|
217
|
+
Omit<React.ComponentProps<typeof MenuPrimitive.Item>, "onSelect">,
|
|
218
|
+
VariantProps<typeof dropdownMenuItemVariants> {
|
|
219
|
+
/** In-repo activation callback (fires on click and Enter/Space). */
|
|
220
|
+
onSelect?: (event: Event) => void;
|
|
221
|
+
/** Its shortcut ("R", "Meta+Backspace"), shown at its end; a single letter runs it while the menu is open. */
|
|
222
|
+
keys?: string;
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
function DropdownMenuItem({
|
|
226
|
+
className,
|
|
227
|
+
variant,
|
|
228
|
+
size,
|
|
229
|
+
onSelect,
|
|
230
|
+
onClick,
|
|
231
|
+
keys,
|
|
232
|
+
children,
|
|
233
|
+
ref,
|
|
234
|
+
...props
|
|
235
|
+
}: DropdownMenuItemProps) {
|
|
236
|
+
const letters = React.useContext(MenuLetters);
|
|
237
|
+
const element = React.useRef<HTMLElement | null>(null);
|
|
238
|
+
const letter = keys !== undefined && keys.length === 1 ? keys.toLowerCase() : undefined;
|
|
239
|
+
React.useEffect(() => {
|
|
240
|
+
if (!letters || letter === undefined || !element.current) return;
|
|
241
|
+
const map = letters.current;
|
|
242
|
+
map.set(letter, element.current);
|
|
243
|
+
return () => {
|
|
244
|
+
if (map.get(letter) === element.current) map.delete(letter);
|
|
245
|
+
};
|
|
246
|
+
}, [letters, letter]);
|
|
247
|
+
return (
|
|
248
|
+
<MenuPrimitive.Item
|
|
249
|
+
data-slot="dropdown-menu-item"
|
|
250
|
+
data-variant={variant ?? "default"}
|
|
251
|
+
data-size={size ?? "default"}
|
|
252
|
+
className={cn(dropdownMenuItemVariants({ variant, size, className }))}
|
|
253
|
+
ref={(node: HTMLElement | null) => {
|
|
254
|
+
element.current = node;
|
|
255
|
+
if (typeof ref === "function") ref(node);
|
|
256
|
+
else if (ref) ref.current = node;
|
|
257
|
+
}}
|
|
258
|
+
onClick={(event) => {
|
|
259
|
+
onClick?.(event);
|
|
260
|
+
onSelect?.(event.nativeEvent);
|
|
261
|
+
}}
|
|
262
|
+
{...props}
|
|
263
|
+
>
|
|
264
|
+
{children}
|
|
265
|
+
{keys !== undefined && <DropdownMenuShortcut>{formatKeys(keys)}</DropdownMenuShortcut>}
|
|
266
|
+
</MenuPrimitive.Item>
|
|
267
|
+
);
|
|
268
|
+
}
|
|
269
|
+
|
|
270
|
+
// --- DropdownMenuSub: a submenu, opened by hovering its trigger item or by ArrowRight / Enter on it; its content is
|
|
271
|
+
// positioned beside the parent menu. Works inside a DropdownMenu and a ContextMenu. ---
|
|
272
|
+
|
|
273
|
+
interface DropdownMenuSubProps extends React.ComponentProps<typeof MenuPrimitive.SubmenuRoot> {}
|
|
274
|
+
|
|
275
|
+
function DropdownMenuSub(props: DropdownMenuSubProps) {
|
|
276
|
+
return <MenuPrimitive.SubmenuRoot {...props} />;
|
|
277
|
+
}
|
|
278
|
+
|
|
279
|
+
interface DropdownMenuSubTriggerProps
|
|
280
|
+
extends
|
|
281
|
+
React.ComponentProps<typeof MenuPrimitive.SubmenuTrigger>,
|
|
282
|
+
Pick<VariantProps<typeof dropdownMenuItemVariants>, "size"> {}
|
|
283
|
+
|
|
284
|
+
/** An item that opens its submenu, with a chevron at the right; sized as the items beside it (`size`). */
|
|
285
|
+
function DropdownMenuSubTrigger({
|
|
286
|
+
className,
|
|
287
|
+
children,
|
|
288
|
+
size,
|
|
289
|
+
...props
|
|
290
|
+
}: DropdownMenuSubTriggerProps) {
|
|
291
|
+
return (
|
|
292
|
+
<MenuPrimitive.SubmenuTrigger
|
|
293
|
+
data-slot="dropdown-menu-sub-trigger"
|
|
294
|
+
data-size={size ?? "default"}
|
|
295
|
+
className={cn(dropdownMenuItemVariants({ size }), "data-[popup-open]:bg-hover", className)}
|
|
296
|
+
{...props}
|
|
297
|
+
>
|
|
298
|
+
{children}
|
|
299
|
+
<ChevronRight aria-hidden="true" size={14} className="ml-auto text-muted" />
|
|
300
|
+
</MenuPrimitive.SubmenuTrigger>
|
|
301
|
+
);
|
|
302
|
+
}
|
|
303
|
+
|
|
304
|
+
interface DropdownMenuSubContentProps extends DropdownMenuContentProps {}
|
|
305
|
+
|
|
306
|
+
/** The submenu's items: a DropdownMenuContent beside its trigger. */
|
|
307
|
+
function DropdownMenuSubContent({
|
|
308
|
+
side = "inline-end",
|
|
309
|
+
align = "start",
|
|
310
|
+
sideOffset = 6,
|
|
311
|
+
alignOffset = -4,
|
|
312
|
+
...props
|
|
313
|
+
}: DropdownMenuSubContentProps) {
|
|
314
|
+
return (
|
|
315
|
+
<DropdownMenuContent
|
|
316
|
+
data-slot="dropdown-menu-sub-content"
|
|
317
|
+
side={side}
|
|
318
|
+
align={align}
|
|
319
|
+
sideOffset={sideOffset}
|
|
320
|
+
alignOffset={alignOffset}
|
|
321
|
+
{...props}
|
|
322
|
+
/>
|
|
323
|
+
);
|
|
324
|
+
}
|
|
325
|
+
|
|
326
|
+
// --- DropdownMenuSeparator ---
|
|
327
|
+
|
|
328
|
+
interface DropdownMenuSeparatorProps extends React.ComponentProps<typeof MenuPrimitive.Separator> {}
|
|
329
|
+
|
|
330
|
+
function DropdownMenuSeparator({ className, ...props }: DropdownMenuSeparatorProps) {
|
|
331
|
+
return (
|
|
332
|
+
<MenuPrimitive.Separator
|
|
333
|
+
data-slot="dropdown-menu-separator"
|
|
334
|
+
className={cn("h-px bg-border my-1", className)}
|
|
335
|
+
{...props}
|
|
336
|
+
/>
|
|
337
|
+
);
|
|
338
|
+
}
|
|
339
|
+
|
|
340
|
+
// --- DropdownMenuLabel ---
|
|
341
|
+
|
|
342
|
+
// Plain <div> (like Radix's DropdownMenu.Label): Base UI's Menu.GroupLabel
|
|
343
|
+
// throws when used outside <Menu.Group>, but our label is used standalone.
|
|
344
|
+
interface DropdownMenuLabelProps extends React.ComponentProps<"div"> {}
|
|
345
|
+
|
|
346
|
+
function DropdownMenuLabel({ className, ...props }: DropdownMenuLabelProps) {
|
|
347
|
+
return (
|
|
348
|
+
<div
|
|
349
|
+
data-slot="dropdown-menu-label"
|
|
350
|
+
className={cn("text-xs font-medium text-muted px-2 pt-1.5 pb-0.5", className)}
|
|
351
|
+
{...props}
|
|
352
|
+
/>
|
|
353
|
+
);
|
|
354
|
+
}
|
|
355
|
+
|
|
356
|
+
// --- DropdownMenuGroup ---
|
|
357
|
+
|
|
358
|
+
const DropdownMenuGroup = MenuPrimitive.Group;
|
|
359
|
+
|
|
360
|
+
interface DropdownMenuGroupProps extends React.ComponentProps<typeof MenuPrimitive.Group> {}
|
|
361
|
+
|
|
362
|
+
// --- DropdownMenuShortcut ---
|
|
363
|
+
|
|
364
|
+
interface DropdownMenuShortcutProps extends React.ComponentProps<"span"> {}
|
|
365
|
+
|
|
366
|
+
function DropdownMenuShortcut({ className, ...props }: DropdownMenuShortcutProps) {
|
|
367
|
+
return (
|
|
368
|
+
<span
|
|
369
|
+
data-slot="dropdown-menu-shortcut"
|
|
370
|
+
className={cn("ml-auto text-xs text-muted font-normal", className)}
|
|
371
|
+
{...props}
|
|
372
|
+
/>
|
|
373
|
+
);
|
|
374
|
+
}
|
|
375
|
+
|
|
376
|
+
export {
|
|
377
|
+
DropdownMenu,
|
|
378
|
+
DropdownMenuTrigger,
|
|
379
|
+
DropdownMenuContent,
|
|
380
|
+
DropdownMenuItem,
|
|
381
|
+
dropdownMenuItemVariants,
|
|
382
|
+
DropdownMenuSeparator,
|
|
383
|
+
DropdownMenuLabel,
|
|
384
|
+
DropdownMenuGroup,
|
|
385
|
+
DropdownMenuShortcut,
|
|
386
|
+
DropdownMenuSub,
|
|
387
|
+
DropdownMenuSubTrigger,
|
|
388
|
+
DropdownMenuSubContent,
|
|
389
|
+
ContextMenu,
|
|
390
|
+
ContextMenuTrigger,
|
|
391
|
+
openContextMenuFromKey,
|
|
392
|
+
};
|
|
393
|
+
export type {
|
|
394
|
+
DropdownMenuProps,
|
|
395
|
+
DropdownMenuTriggerProps,
|
|
396
|
+
DropdownMenuContentProps,
|
|
397
|
+
DropdownMenuItemProps,
|
|
398
|
+
DropdownMenuSeparatorProps,
|
|
399
|
+
DropdownMenuLabelProps,
|
|
400
|
+
DropdownMenuGroupProps,
|
|
401
|
+
DropdownMenuShortcutProps,
|
|
402
|
+
DropdownMenuSubProps,
|
|
403
|
+
DropdownMenuSubTriggerProps,
|
|
404
|
+
DropdownMenuSubContentProps,
|
|
405
|
+
ContextMenuProps,
|
|
406
|
+
ContextMenuTriggerProps,
|
|
407
|
+
};
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
export {
|
|
2
|
+
DropdownMenu,
|
|
3
|
+
DropdownMenuTrigger,
|
|
4
|
+
DropdownMenuContent,
|
|
5
|
+
DropdownMenuItem,
|
|
6
|
+
dropdownMenuItemVariants,
|
|
7
|
+
DropdownMenuSeparator,
|
|
8
|
+
DropdownMenuLabel,
|
|
9
|
+
DropdownMenuGroup,
|
|
10
|
+
DropdownMenuShortcut,
|
|
11
|
+
DropdownMenuSub,
|
|
12
|
+
DropdownMenuSubTrigger,
|
|
13
|
+
DropdownMenuSubContent,
|
|
14
|
+
ContextMenu,
|
|
15
|
+
ContextMenuTrigger,
|
|
16
|
+
openContextMenuFromKey,
|
|
17
|
+
} from "./dropdown-menu";
|
|
18
|
+
export type {
|
|
19
|
+
DropdownMenuProps,
|
|
20
|
+
DropdownMenuTriggerProps,
|
|
21
|
+
DropdownMenuContentProps,
|
|
22
|
+
DropdownMenuItemProps,
|
|
23
|
+
DropdownMenuSeparatorProps,
|
|
24
|
+
DropdownMenuLabelProps,
|
|
25
|
+
DropdownMenuGroupProps,
|
|
26
|
+
DropdownMenuShortcutProps,
|
|
27
|
+
DropdownMenuSubProps,
|
|
28
|
+
DropdownMenuSubTriggerProps,
|
|
29
|
+
DropdownMenuSubContentProps,
|
|
30
|
+
ContextMenuProps,
|
|
31
|
+
ContextMenuTriggerProps,
|
|
32
|
+
} from "./dropdown-menu";
|
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
name: EditableField
|
|
2
|
+
description: "A presentational inline field that reads as plain text until hovered or focused. It owns no data: the parent holds `value` and answers `onChange`. Visual only — @bridge/records' RecordField binds it to data."
|
|
3
|
+
layer: core
|
|
4
|
+
category: input
|
|
5
|
+
when_to_use:
|
|
6
|
+
- "For a record property or title edited in place on a detail card"
|
|
7
|
+
- "With @bridge/records' RecordField, which binds the draft, the commit and the save state to data"
|
|
8
|
+
- "When the parent already owns the draft (React Hook Form, useState) and wants the field's visuals and commit keys"
|
|
9
|
+
when_not_to_use:
|
|
10
|
+
- "As a standalone data-bound field — use RecordField from @bridge/records, which wires the data"
|
|
11
|
+
- "For a multi-line description with a visible border — use Textarea"
|
|
12
|
+
- "When a save button is expected — this commits on blur, Enter or ⌘/Ctrl+Enter only"
|
|
13
|
+
composition_partners:
|
|
14
|
+
- Tooltip/TooltipProvider (the field's Retry and Discard buttons use the kit Tooltip; wrap in a Provider)
|
|
15
|
+
- Input (the property and title variants draw through it)
|
|
16
|
+
- Textarea (when `multiline`)
|
|
17
|
+
props:
|
|
18
|
+
- name: value / onChange
|
|
19
|
+
type: "string / (text: string) => void"
|
|
20
|
+
required: true
|
|
21
|
+
description: "The controlled draft. The parent holds it; EditableField only draws it and reports keystrokes"
|
|
22
|
+
- name: ref
|
|
23
|
+
type: "React.Ref<HTMLInputElement | HTMLTextAreaElement>"
|
|
24
|
+
required: false
|
|
25
|
+
description: "Forwarded to the input (or the textarea, when multiline), for React Hook Form's register"
|
|
26
|
+
- name: onCommit
|
|
27
|
+
type: "() => void"
|
|
28
|
+
required: false
|
|
29
|
+
description: "Called at most once per edit: on blur, on Enter (single line) or ⌘/Ctrl+Enter (multiline). Enter commits then blurs, and the blur that follows does not commit again"
|
|
30
|
+
- name: onRevert
|
|
31
|
+
type: "() => void"
|
|
32
|
+
required: false
|
|
33
|
+
description: "Called on Escape; the field then blurs without committing"
|
|
34
|
+
- name: state
|
|
35
|
+
type: "'idle' | 'saving' | 'saved' | 'failed' | 'conflict'"
|
|
36
|
+
required: false
|
|
37
|
+
default: "'idle'"
|
|
38
|
+
description: "The save state, set as data-state on the root. saving shows a spinner, saved a check that fades after 400 ms, failed a Retry and a Discard button, conflict Keep mine and Take theirs. idle, saving and saved show no action buttons"
|
|
39
|
+
- name: error
|
|
40
|
+
type: string
|
|
41
|
+
required: false
|
|
42
|
+
description: "The failure message shown in the failed state's Discard tooltip ('Not saved: <error>')"
|
|
43
|
+
- name: theirs
|
|
44
|
+
type: string
|
|
45
|
+
required: false
|
|
46
|
+
description: 'The other window''s version, shown in the conflict state''s Take theirs tooltip (''Changed elsewhere, now "<theirs>"'')'
|
|
47
|
+
- name: onRetry / onReset
|
|
48
|
+
type: "() => void / () => void"
|
|
49
|
+
required: false
|
|
50
|
+
description: "Retry (failed) and Keep mine (conflict); Discard my change (failed) and Take theirs (conflict). Clicking either never commits the edit (their mousedown is prevented)"
|
|
51
|
+
- name: changedElsewhere
|
|
52
|
+
type: boolean
|
|
53
|
+
required: false
|
|
54
|
+
default: "false"
|
|
55
|
+
description: "Another window changed the value: data-changed-elsewhere on the root, a brief bg-accent-subtle tint, and the line 'Changed in another window, just now'"
|
|
56
|
+
- name: variant
|
|
57
|
+
type: "'property' | 'title'"
|
|
58
|
+
required: false
|
|
59
|
+
default: "'property'"
|
|
60
|
+
description: "property draws the inline input, title the inline-title input"
|
|
61
|
+
- name: invalid
|
|
62
|
+
type: boolean
|
|
63
|
+
required: false
|
|
64
|
+
default: "false"
|
|
65
|
+
description: "Sets aria-invalid and turns the placeholder destructive"
|
|
66
|
+
- name: fit
|
|
67
|
+
type: boolean
|
|
68
|
+
required: false
|
|
69
|
+
default: "false"
|
|
70
|
+
description: "As wide as its text (field-sizing: content, at least 4ch): a title or a name beside another, its status right after the text"
|
|
71
|
+
- name: multiline
|
|
72
|
+
type: boolean
|
|
73
|
+
required: false
|
|
74
|
+
default: "false"
|
|
75
|
+
description: "Draw a textarea instead of an input; then ⌘/Ctrl+Enter commits and Enter inserts a line"
|
|
76
|
+
props_priority:
|
|
77
|
+
- value / onChange
|
|
78
|
+
- onCommit
|
|
79
|
+
- state
|
|
80
|
+
- variant
|
|
81
|
+
examples:
|
|
82
|
+
- title: "A record property, held by the parent"
|
|
83
|
+
code: |
|
|
84
|
+
const [name, setName] = useState(record.name);
|
|
85
|
+
|
|
86
|
+
<EditableField
|
|
87
|
+
aria-label="Last name"
|
|
88
|
+
value={name}
|
|
89
|
+
onChange={setName}
|
|
90
|
+
onCommit={() => save(name)}
|
|
91
|
+
onRevert={() => setName(record.name)}
|
|
92
|
+
/>
|
|
93
|
+
- title: "A saving property, with its states"
|
|
94
|
+
code: |
|
|
95
|
+
<EditableField
|
|
96
|
+
aria-label="Status"
|
|
97
|
+
value={draft}
|
|
98
|
+
onChange={setDraft}
|
|
99
|
+
onCommit={commit}
|
|
100
|
+
state={saveState}
|
|
101
|
+
error={saveError}
|
|
102
|
+
onRetry={retry}
|
|
103
|
+
onReset={reset}
|
|
104
|
+
/>
|
|
105
|
+
- title: "A multiline title"
|
|
106
|
+
code: |
|
|
107
|
+
<EditableField
|
|
108
|
+
aria-label="Notes"
|
|
109
|
+
value={notes}
|
|
110
|
+
onChange={setNotes}
|
|
111
|
+
multiline
|
|
112
|
+
variant="title"
|
|
113
|
+
placeholder="Add notes…"
|
|
114
|
+
/>
|
|
115
|
+
anti_patterns:
|
|
116
|
+
- "Don't hold the draft here — EditableField owns no data; bind it through RecordField or the parent"
|
|
117
|
+
- "Don't expect a save button — the edit commits on blur, Enter or ⌘/Ctrl+Enter"
|
|
118
|
+
- "Don't use the buttons as the only focusable controls — the field itself is the control"
|
|
119
|
+
accessibility_notes: "The input (or textarea) is the control, labelled with aria-label or a surrounding FieldLabel. The saving and saved marks are role=status with aria-label Saving/Saved; the action buttons carry aria-label Retry, Discard my change, Keep mine and Take theirs, with the kit Tooltip as their description. Escape reverts; Enter commits."
|
|
120
|
+
notes: "Purely presentational: it draws the input, the commit keys and the status area, and reports every change and commit upward. @bridge/records' RecordField binds it to data (the draft, the save, the conflict) — use that on a record."
|