@bridgebrew/ui 0.0.0-stage → 0.1.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +39 -2
- package/SOURCE.md +182 -0
- package/dist/build.js +871 -0
- package/dist/theme-css.js +896 -0
- package/dist/themes.js +69 -0
- package/dist/types/build/stylesheet.d.ts +31 -0
- package/dist/types/components/composite/command/command.d.ts +94 -0
- package/dist/types/components/composite/command/index.d.ts +2 -0
- package/dist/types/components/composite/draft-bar/draft-bar.d.ts +12 -0
- package/dist/types/components/composite/draft-bar/index.d.ts +2 -0
- package/dist/types/components/composite/image-field/image-field.d.ts +33 -0
- package/dist/types/components/composite/image-field/index.d.ts +2 -0
- package/dist/types/components/composite/list/index.d.ts +3 -0
- package/dist/types/components/composite/list/list-swipe.d.ts +28 -0
- package/dist/types/components/composite/list/list.d.ts +95 -0
- package/dist/types/components/composite/picker/index.d.ts +2 -0
- package/dist/types/components/composite/picker/picker.d.ts +44 -0
- package/dist/types/components/composite/prompt-field/index.d.ts +2 -0
- package/dist/types/components/composite/prompt-field/prompt-field.d.ts +18 -0
- package/dist/types/components/composite/properties/index.d.ts +2 -0
- package/dist/types/components/composite/properties/properties.d.ts +24 -0
- package/dist/types/components/composite/snooze-menu/index.d.ts +4 -0
- package/dist/types/components/composite/snooze-menu/presets.d.ts +36 -0
- package/dist/types/components/composite/snooze-menu/snooze-menu.d.ts +27 -0
- package/dist/types/components/composite/tag-input/index.d.ts +2 -0
- package/dist/types/components/composite/tag-input/tag-input.d.ts +22 -0
- package/dist/types/components/composite/wizard/index.d.ts +2 -0
- package/dist/types/components/composite/wizard/wizard.d.ts +53 -0
- package/dist/types/components/core/avatar/avatar.d.ts +16 -0
- package/dist/types/components/core/avatar/index.d.ts +2 -0
- package/dist/types/components/core/badge/badge.d.ts +8 -0
- package/dist/types/components/core/badge/index.d.ts +2 -0
- package/dist/types/components/core/breadcrumb/breadcrumb.d.ts +21 -0
- package/dist/types/components/core/breadcrumb/index.d.ts +2 -0
- package/dist/types/components/core/bullets/bullets.d.ts +15 -0
- package/dist/types/components/core/bullets/index.d.ts +2 -0
- package/dist/types/components/core/button/button.d.ts +14 -0
- package/dist/types/components/core/button/index.d.ts +2 -0
- package/dist/types/components/core/card/card.d.ts +16 -0
- package/dist/types/components/core/card/index.d.ts +2 -0
- package/dist/types/components/core/checkbox/checkbox.d.ts +15 -0
- package/dist/types/components/core/checkbox/index.d.ts +2 -0
- package/dist/types/components/core/cluster/cluster.d.ts +5 -0
- package/dist/types/components/core/cluster/index.d.ts +1 -0
- package/dist/types/components/core/code-block/code-block.d.ts +18 -0
- package/dist/types/components/core/code-block/index.d.ts +2 -0
- package/dist/types/components/core/collapsible/collapsible.d.ts +8 -0
- package/dist/types/components/core/collapsible/index.d.ts +1 -0
- package/dist/types/components/core/colour-picker/colour-picker.d.ts +25 -0
- package/dist/types/components/core/colour-picker/index.d.ts +4 -0
- package/dist/types/components/core/combobox/combobox.d.ts +63 -0
- package/dist/types/components/core/combobox/index.d.ts +2 -0
- package/dist/types/components/core/detail/detail.d.ts +12 -0
- package/dist/types/components/core/detail/index.d.ts +1 -0
- package/dist/types/components/core/dialog/dialog.d.ts +43 -0
- package/dist/types/components/core/dialog/drag.d.ts +4 -0
- package/dist/types/components/core/dialog/index.d.ts +2 -0
- package/dist/types/components/core/drop-zone/drop-zone.d.ts +23 -0
- package/dist/types/components/core/drop-zone/index.d.ts +2 -0
- package/dist/types/components/core/dropdown-menu/dropdown-menu.d.ts +78 -0
- package/dist/types/components/core/dropdown-menu/index.d.ts +2 -0
- package/dist/types/components/core/editable-field/editable-field.d.ts +42 -0
- package/dist/types/components/core/editable-field/index.d.ts +2 -0
- package/dist/types/components/core/empty-state/empty-state.d.ts +11 -0
- package/dist/types/components/core/empty-state/index.d.ts +2 -0
- package/dist/types/components/core/field/field.d.ts +31 -0
- package/dist/types/components/core/field/index.d.ts +2 -0
- package/dist/types/components/core/icon/icon-sets.d.ts +38 -0
- package/dist/types/components/core/icon/icon.d.ts +14 -0
- package/dist/types/components/core/icon/index.d.ts +2 -0
- package/dist/types/components/core/input/index.d.ts +4 -0
- package/dist/types/components/core/input/input.d.ts +22 -0
- package/dist/types/components/core/input/textarea.d.ts +8 -0
- package/dist/types/components/core/kbd/index.d.ts +2 -0
- package/dist/types/components/core/kbd/kbd.d.ts +7 -0
- package/dist/types/components/core/label/index.d.ts +2 -0
- package/dist/types/components/core/label/label.d.ts +13 -0
- package/dist/types/components/core/main-content/index.d.ts +2 -0
- package/dist/types/components/core/main-content/main-content.d.ts +18 -0
- package/dist/types/components/core/pane/index.d.ts +1 -0
- package/dist/types/components/core/pane/pane.d.ts +12 -0
- package/dist/types/components/core/pick-menu/index.d.ts +4 -0
- package/dist/types/components/core/pick-menu/pick-menu.d.ts +57 -0
- package/dist/types/components/core/pick-menu/tag-menu.d.ts +19 -0
- package/dist/types/components/core/popover/index.d.ts +2 -0
- package/dist/types/components/core/popover/popover.d.ts +22 -0
- package/dist/types/components/core/progress/index.d.ts +2 -0
- package/dist/types/components/core/progress/progress.d.ts +13 -0
- package/dist/types/components/core/resizable/index.d.ts +2 -0
- package/dist/types/components/core/resizable/resizable.d.ts +15 -0
- package/dist/types/components/core/resizable/use-remembered-layout.d.ts +31 -0
- package/dist/types/components/core/screen-link/index.d.ts +2 -0
- package/dist/types/components/core/screen-link/screen-link.d.ts +52 -0
- package/dist/types/components/core/scroll-area/index.d.ts +2 -0
- package/dist/types/components/core/scroll-area/scroll-area.d.ts +13 -0
- package/dist/types/components/core/scroll-area/steps.d.ts +5 -0
- package/dist/types/components/core/section/index.d.ts +2 -0
- package/dist/types/components/core/section/section.d.ts +16 -0
- package/dist/types/components/core/segment-group/index.d.ts +2 -0
- package/dist/types/components/core/segment-group/segment-group.d.ts +24 -0
- package/dist/types/components/core/select/index.d.ts +2 -0
- package/dist/types/components/core/select/select.d.ts +39 -0
- package/dist/types/components/core/skeleton/index.d.ts +2 -0
- package/dist/types/components/core/skeleton/skeleton.d.ts +13 -0
- package/dist/types/components/core/slider/index.d.ts +2 -0
- package/dist/types/components/core/slider/slider.d.ts +9 -0
- package/dist/types/components/core/sortable/index.d.ts +2 -0
- package/dist/types/components/core/sortable/sortable.d.ts +53 -0
- package/dist/types/components/core/split-view/index.d.ts +2 -0
- package/dist/types/components/core/split-view/split-view.d.ts +28 -0
- package/dist/types/components/core/status-icon/index.d.ts +2 -0
- package/dist/types/components/core/status-icon/status-icon.d.ts +13 -0
- package/dist/types/components/core/table/collapsible-rows.d.ts +7 -0
- package/dist/types/components/core/table/expand-toggle.d.ts +10 -0
- package/dist/types/components/core/table/group-header.d.ts +14 -0
- package/dist/types/components/core/table/index.d.ts +8 -0
- package/dist/types/components/core/table/table.d.ts +31 -0
- package/dist/types/components/core/tabs/index.d.ts +2 -0
- package/dist/types/components/core/tabs/tabs.d.ts +20 -0
- package/dist/types/components/core/tag-pill/index.d.ts +2 -0
- package/dist/types/components/core/tag-pill/tag-pill.d.ts +25 -0
- package/dist/types/components/core/thumbnail/index.d.ts +2 -0
- package/dist/types/components/core/thumbnail/thumbnail.d.ts +23 -0
- package/dist/types/components/core/toast/index.d.ts +2 -0
- package/dist/types/components/core/toast/toast.d.ts +88 -0
- package/dist/types/components/core/toggle/index.d.ts +2 -0
- package/dist/types/components/core/toggle/toggle.d.ts +9 -0
- package/dist/types/components/core/toggle-group/index.d.ts +2 -0
- package/dist/types/components/core/toggle-group/toggle-group.d.ts +21 -0
- package/dist/types/components/core/tooltip/index.d.ts +2 -0
- package/dist/types/components/core/tooltip/tooltip.d.ts +33 -0
- package/dist/types/components/layout/multi-pane/index.d.ts +4 -0
- package/dist/types/components/layout/multi-pane/list-detail.d.ts +17 -0
- package/dist/types/components/layout/multi-pane/multi-pane.d.ts +34 -0
- package/dist/types/components/layout/single-pane/index.d.ts +2 -0
- package/dist/types/components/layout/single-pane/single-pane.d.ts +11 -0
- package/dist/types/components/shell/app-shell/app-shell.d.ts +12 -0
- package/dist/types/components/shell/app-shell/index.d.ts +2 -0
- package/dist/types/components/shell/sidebar/index.d.ts +2 -0
- package/dist/types/components/shell/sidebar/sidebar-group.d.ts +45 -0
- package/dist/types/components/shell/sidebar/sidebar-item.d.ts +19 -0
- package/dist/types/components/shell/sidebar/sidebar-resize-handle.d.ts +17 -0
- package/dist/types/components/shell/sidebar/sidebar-tree.d.ts +42 -0
- package/dist/types/components/shell/sidebar/sidebar.d.ts +27 -0
- package/dist/types/components/template/address-book-template/address-book-template.d.ts +15 -0
- package/dist/types/components/template/address-book-template/index.d.ts +2 -0
- package/dist/types/components/template/mail-template/index.d.ts +2 -0
- package/dist/types/components/template/mail-template/mail-template.d.ts +11 -0
- package/dist/types/components/template/use-narrow.d.ts +3 -0
- package/dist/types/index.d.ts +149 -0
- package/dist/types/kit/check-rendering.d.ts +3 -0
- package/dist/types/kit/kit.d.ts +76 -0
- package/dist/types/lib/clipboard.d.ts +5 -0
- package/dist/types/lib/dates.d.ts +9 -0
- package/dist/types/lib/json.d.ts +26 -0
- package/dist/types/lib/keys.d.ts +15 -0
- package/dist/types/lib/utils.d.ts +2 -0
- package/dist/types/lib/view-scope.d.ts +22 -0
- package/dist/types/profile/profile.d.ts +34 -0
- package/dist/types/theme/appearance.d.ts +31 -0
- package/dist/types/theme/boot.d.ts +3 -0
- package/dist/types/theme/client-appearance-react.d.ts +3 -0
- package/dist/types/theme/client-appearance.d.ts +69 -0
- package/dist/types/theme/generate-tokens.d.ts +45 -0
- package/dist/types/theme/pack-themes-react.d.ts +24 -0
- package/dist/types/theme/palette.d.ts +111 -0
- package/dist/types/theme/semantic-mapping.d.ts +28 -0
- package/dist/types/theme/set-theme.d.ts +30 -0
- package/dist/types/theme/theme-colours.d.ts +14 -0
- package/dist/types/theme/theme-css.d.ts +3 -0
- package/dist/types/theme/themes.d.ts +63 -0
- package/dist/types/theme/wallpaper-sheet.d.ts +16 -0
- package/dist/types/theme/wallpaper-theme-react.d.ts +7 -0
- package/dist/types/theme/wallpaper-theme.d.ts +37 -0
- package/package.json +87 -3
- package/src/build/stylesheet.ts +128 -0
- package/src/components/composite/command/command.meta.yaml +74 -0
- package/src/components/composite/command/command.tsx +939 -0
- package/src/components/composite/command/index.ts +17 -0
- package/src/components/composite/draft-bar/draft-bar.meta.yaml +19 -0
- package/src/components/composite/draft-bar/draft-bar.tsx +57 -0
- package/src/components/composite/draft-bar/index.ts +2 -0
- package/src/components/composite/image-field/image-field.meta.yaml +69 -0
- package/src/components/composite/image-field/image-field.tsx +267 -0
- package/src/components/composite/image-field/index.ts +2 -0
- package/src/components/composite/list/index.ts +18 -0
- package/src/components/composite/list/list-swipe.tsx +163 -0
- package/src/components/composite/list/list.meta.yaml +238 -0
- package/src/components/composite/list/list.tsx +868 -0
- package/src/components/composite/picker/index.ts +2 -0
- package/src/components/composite/picker/picker.meta.yaml +103 -0
- package/src/components/composite/picker/picker.tsx +276 -0
- package/src/components/composite/prompt-field/index.ts +2 -0
- package/src/components/composite/prompt-field/prompt-field.meta.yaml +60 -0
- package/src/components/composite/prompt-field/prompt-field.tsx +81 -0
- package/src/components/composite/properties/index.ts +9 -0
- package/src/components/composite/properties/properties.meta.yaml +56 -0
- package/src/components/composite/properties/properties.tsx +132 -0
- package/src/components/composite/snooze-menu/index.ts +11 -0
- package/src/components/composite/snooze-menu/presets.ts +169 -0
- package/src/components/composite/snooze-menu/snooze-menu.meta.yaml +58 -0
- package/src/components/composite/snooze-menu/snooze-menu.tsx +146 -0
- package/src/components/composite/tag-input/index.ts +2 -0
- package/src/components/composite/tag-input/tag-input.meta.yaml +51 -0
- package/src/components/composite/tag-input/tag-input.tsx +404 -0
- package/src/components/composite/wizard/index.ts +2 -0
- package/src/components/composite/wizard/wizard.meta.yaml +73 -0
- package/src/components/composite/wizard/wizard.tsx +256 -0
- package/src/components/core/avatar/avatar.meta.yaml +71 -0
- package/src/components/core/avatar/avatar.tsx +92 -0
- package/src/components/core/avatar/index.ts +2 -0
- package/src/components/core/badge/badge.meta.yaml +34 -0
- package/src/components/core/badge/badge.tsx +23 -0
- package/src/components/core/badge/index.ts +2 -0
- package/src/components/core/breadcrumb/breadcrumb.meta.yaml +45 -0
- package/src/components/core/breadcrumb/breadcrumb.tsx +110 -0
- package/src/components/core/breadcrumb/index.ts +2 -0
- package/src/components/core/bullets/bullets.meta.yaml +37 -0
- package/src/components/core/bullets/bullets.tsx +60 -0
- package/src/components/core/bullets/index.ts +2 -0
- package/src/components/core/button/button.meta.yaml +91 -0
- package/src/components/core/button/button.tsx +93 -0
- package/src/components/core/button/index.ts +2 -0
- package/src/components/core/card/card.meta.yaml +94 -0
- package/src/components/core/card/card.tsx +54 -0
- package/src/components/core/card/index.ts +2 -0
- package/src/components/core/checkbox/checkbox.meta.yaml +59 -0
- package/src/components/core/checkbox/checkbox.tsx +106 -0
- package/src/components/core/checkbox/index.ts +2 -0
- package/src/components/core/cluster/cluster.meta.yaml +4 -0
- package/src/components/core/cluster/cluster.tsx +17 -0
- package/src/components/core/cluster/index.ts +1 -0
- package/src/components/core/code-block/code-block.meta.yaml +30 -0
- package/src/components/core/code-block/code-block.tsx +93 -0
- package/src/components/core/code-block/index.ts +2 -0
- package/src/components/core/collapsible/collapsible.meta.yaml +34 -0
- package/src/components/core/collapsible/collapsible.tsx +54 -0
- package/src/components/core/collapsible/index.ts +1 -0
- package/src/components/core/colour-picker/colour-picker.meta.yaml +52 -0
- package/src/components/core/colour-picker/colour-picker.tsx +314 -0
- package/src/components/core/colour-picker/index.ts +4 -0
- package/src/components/core/combobox/combobox.meta.yaml +75 -0
- package/src/components/core/combobox/combobox.tsx +288 -0
- package/src/components/core/combobox/index.ts +2 -0
- package/src/components/core/detail/detail.meta.yaml +13 -0
- package/src/components/core/detail/detail.tsx +73 -0
- package/src/components/core/detail/index.ts +1 -0
- package/src/components/core/dialog/dialog.meta.yaml +95 -0
- package/src/components/core/dialog/dialog.tsx +254 -0
- package/src/components/core/dialog/drag.ts +40 -0
- package/src/components/core/dialog/index.ts +25 -0
- package/src/components/core/drop-zone/drop-zone.meta.yaml +55 -0
- package/src/components/core/drop-zone/drop-zone.tsx +146 -0
- package/src/components/core/drop-zone/index.ts +2 -0
- package/src/components/core/dropdown-menu/dropdown-menu.meta.yaml +118 -0
- package/src/components/core/dropdown-menu/dropdown-menu.tsx +407 -0
- package/src/components/core/dropdown-menu/index.ts +32 -0
- package/src/components/core/editable-field/editable-field.meta.yaml +120 -0
- package/src/components/core/editable-field/editable-field.tsx +346 -0
- package/src/components/core/editable-field/index.ts +2 -0
- package/src/components/core/empty-state/empty-state.meta.yaml +21 -0
- package/src/components/core/empty-state/empty-state.tsx +42 -0
- package/src/components/core/empty-state/index.ts +2 -0
- package/src/components/core/field/field.meta.yaml +37 -0
- package/src/components/core/field/field.tsx +100 -0
- package/src/components/core/field/index.ts +9 -0
- package/src/components/core/icon/curated-names.json +107 -0
- package/src/components/core/icon/icon-sets.ts +109 -0
- package/src/components/core/icon/icon.meta.yaml +30 -0
- package/src/components/core/icon/icon.tsx +93 -0
- package/src/components/core/icon/index.ts +2 -0
- package/src/components/core/input/index.ts +4 -0
- package/src/components/core/input/input.meta.yaml +98 -0
- package/src/components/core/input/input.tsx +133 -0
- package/src/components/core/input/textarea.meta.yaml +79 -0
- package/src/components/core/input/textarea.tsx +63 -0
- package/src/components/core/kbd/index.ts +2 -0
- package/src/components/core/kbd/kbd.meta.yaml +12 -0
- package/src/components/core/kbd/kbd.tsx +29 -0
- package/src/components/core/label/index.ts +2 -0
- package/src/components/core/label/label.meta.yaml +55 -0
- package/src/components/core/label/label.tsx +72 -0
- package/src/components/core/main-content/index.ts +2 -0
- package/src/components/core/main-content/main-content.meta.yaml +23 -0
- package/src/components/core/main-content/main-content.tsx +49 -0
- package/src/components/core/pane/index.ts +1 -0
- package/src/components/core/pane/pane.meta.yaml +13 -0
- package/src/components/core/pane/pane.tsx +64 -0
- package/src/components/core/pick-menu/index.ts +4 -0
- package/src/components/core/pick-menu/pick-menu.meta.yaml +36 -0
- package/src/components/core/pick-menu/pick-menu.tsx +348 -0
- package/src/components/core/pick-menu/tag-menu.meta.yaml +7 -0
- package/src/components/core/pick-menu/tag-menu.tsx +79 -0
- package/src/components/core/popover/index.ts +2 -0
- package/src/components/core/popover/popover.meta.yaml +16 -0
- package/src/components/core/popover/popover.tsx +66 -0
- package/src/components/core/progress/index.ts +2 -0
- package/src/components/core/progress/progress.meta.yaml +47 -0
- package/src/components/core/progress/progress.tsx +56 -0
- package/src/components/core/resizable/index.ts +13 -0
- package/src/components/core/resizable/resizable.meta.yaml +110 -0
- package/src/components/core/resizable/resizable.tsx +125 -0
- package/src/components/core/resizable/use-remembered-layout.ts +261 -0
- package/src/components/core/screen-link/index.ts +2 -0
- package/src/components/core/screen-link/screen-link.meta.yaml +34 -0
- package/src/components/core/screen-link/screen-link.tsx +100 -0
- package/src/components/core/scroll-area/index.ts +2 -0
- package/src/components/core/scroll-area/scroll-area.meta.yaml +72 -0
- package/src/components/core/scroll-area/scroll-area.tsx +95 -0
- package/src/components/core/scroll-area/steps.tsx +72 -0
- package/src/components/core/section/index.ts +2 -0
- package/src/components/core/section/section.meta.yaml +72 -0
- package/src/components/core/section/section.tsx +93 -0
- package/src/components/core/segment-group/index.ts +2 -0
- package/src/components/core/segment-group/segment-group.meta.yaml +71 -0
- package/src/components/core/segment-group/segment-group.tsx +166 -0
- package/src/components/core/select/index.ts +20 -0
- package/src/components/core/select/select.meta.yaml +48 -0
- package/src/components/core/select/select.tsx +226 -0
- package/src/components/core/skeleton/index.ts +2 -0
- package/src/components/core/skeleton/skeleton.meta.yaml +50 -0
- package/src/components/core/skeleton/skeleton.tsx +71 -0
- package/src/components/core/slider/index.ts +2 -0
- package/src/components/core/slider/slider.meta.yaml +55 -0
- package/src/components/core/slider/slider.tsx +46 -0
- package/src/components/core/sortable/index.ts +16 -0
- package/src/components/core/sortable/sortable.meta.yaml +125 -0
- package/src/components/core/sortable/sortable.tsx +471 -0
- package/src/components/core/split-view/index.ts +2 -0
- package/src/components/core/split-view/split-view.meta.yaml +85 -0
- package/src/components/core/split-view/split-view.tsx +193 -0
- package/src/components/core/status-icon/index.ts +2 -0
- package/src/components/core/status-icon/status-icon.meta.yaml +64 -0
- package/src/components/core/status-icon/status-icon.tsx +94 -0
- package/src/components/core/table/collapsible-rows.tsx +30 -0
- package/src/components/core/table/expand-toggle.tsx +58 -0
- package/src/components/core/table/group-header.tsx +35 -0
- package/src/components/core/table/index.ts +26 -0
- package/src/components/core/table/table.meta.yaml +67 -0
- package/src/components/core/table/table.tsx +166 -0
- package/src/components/core/tabs/index.ts +2 -0
- package/src/components/core/tabs/tabs.meta.yaml +57 -0
- package/src/components/core/tabs/tabs.tsx +74 -0
- package/src/components/core/tag-pill/index.ts +2 -0
- package/src/components/core/tag-pill/tag-pill.meta.yaml +19 -0
- package/src/components/core/tag-pill/tag-pill.tsx +102 -0
- package/src/components/core/thumbnail/index.ts +2 -0
- package/src/components/core/thumbnail/thumbnail.meta.yaml +59 -0
- package/src/components/core/thumbnail/thumbnail.tsx +162 -0
- package/src/components/core/toast/index.ts +12 -0
- package/src/components/core/toast/toast.meta.yaml +93 -0
- package/src/components/core/toast/toast.tsx +763 -0
- package/src/components/core/toggle/index.ts +2 -0
- package/src/components/core/toggle/toggle.meta.yaml +53 -0
- package/src/components/core/toggle/toggle.tsx +44 -0
- package/src/components/core/toggle-group/index.ts +2 -0
- package/src/components/core/toggle-group/toggle-group.meta.yaml +59 -0
- package/src/components/core/toggle-group/toggle-group.tsx +68 -0
- package/src/components/core/tooltip/index.ts +7 -0
- package/src/components/core/tooltip/tooltip.meta.yaml +93 -0
- package/src/components/core/tooltip/tooltip.tsx +198 -0
- package/src/components/layout/multi-pane/index.ts +4 -0
- package/src/components/layout/multi-pane/list-detail.tsx +45 -0
- package/src/components/layout/multi-pane/multi-pane.meta.yaml +67 -0
- package/src/components/layout/multi-pane/multi-pane.tsx +158 -0
- package/src/components/layout/single-pane/index.ts +2 -0
- package/src/components/layout/single-pane/single-pane.meta.yaml +35 -0
- package/src/components/layout/single-pane/single-pane.tsx +48 -0
- package/src/components/shell/app-shell/app-shell.meta.yaml +65 -0
- package/src/components/shell/app-shell/app-shell.tsx +61 -0
- package/src/components/shell/app-shell/index.ts +2 -0
- package/src/components/shell/sidebar/index.ts +35 -0
- package/src/components/shell/sidebar/sidebar-group.tsx +254 -0
- package/src/components/shell/sidebar/sidebar-item.tsx +88 -0
- package/src/components/shell/sidebar/sidebar-resize-handle.tsx +101 -0
- package/src/components/shell/sidebar/sidebar-tree.tsx +325 -0
- package/src/components/shell/sidebar/sidebar.meta.yaml +126 -0
- package/src/components/shell/sidebar/sidebar.tsx +142 -0
- package/src/components/template/address-book-template/address-book-template.meta.yaml +22 -0
- package/src/components/template/address-book-template/address-book-template.tsx +201 -0
- package/src/components/template/address-book-template/index.ts +2 -0
- package/src/components/template/mail-template/index.ts +2 -0
- package/src/components/template/mail-template/mail-template.meta.yaml +22 -0
- package/src/components/template/mail-template/mail-template.tsx +731 -0
- package/src/components/template/use-narrow.ts +18 -0
- package/src/index.ts +505 -0
- package/src/kit/check-rendering.tsx +130 -0
- package/src/kit/kit.tsx +177 -0
- package/src/lib/clipboard.ts +27 -0
- package/src/lib/dates.ts +13 -0
- package/src/lib/json.ts +59 -0
- package/src/lib/keys.ts +54 -0
- package/src/lib/utils.ts +12 -0
- package/src/lib/view-scope.tsx +60 -0
- package/src/profile/profile.ts +238 -0
- package/src/theme/appearance.ts +198 -0
- package/src/theme/boot.ts +6 -0
- package/src/theme/client-appearance-react.ts +14 -0
- package/src/theme/client-appearance.ts +284 -0
- package/src/theme/generate-tokens.ts +658 -0
- package/src/theme/pack-themes-react.ts +107 -0
- package/src/theme/palette.ts +301 -0
- package/src/theme/semantic-mapping.ts +165 -0
- package/src/theme/set-theme.ts +162 -0
- package/src/theme/theme-colours.ts +60 -0
- package/src/theme/theme-css.ts +15 -0
- package/src/theme/themes.ts +133 -0
- package/src/theme/wallpaper-sheet.ts +58 -0
- package/src/theme/wallpaper-theme-react.ts +60 -0
- package/src/theme/wallpaper-theme.ts +231 -0
|
@@ -0,0 +1,254 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
import { Dialog as DialogPrimitive } from "@base-ui/react/dialog";
|
|
3
|
+
import { cva, type VariantProps } from "class-variance-authority";
|
|
4
|
+
|
|
5
|
+
import { cn } from "../../../lib/utils";
|
|
6
|
+
import { useCapability, useKitRoot } from "../../../kit/kit";
|
|
7
|
+
import { dragByTitleBar } from "./drag";
|
|
8
|
+
|
|
9
|
+
// --- DialogContent maximize context (opt-in via `maximizable`) ---
|
|
10
|
+
|
|
11
|
+
interface DialogContentContextValue {
|
|
12
|
+
maximizable: boolean;
|
|
13
|
+
maximized: boolean;
|
|
14
|
+
setMaximized: (value: boolean) => void;
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
const DialogContentContext = React.createContext<DialogContentContextValue | null>(null);
|
|
18
|
+
|
|
19
|
+
// --- Dialog (root) ---
|
|
20
|
+
|
|
21
|
+
interface DialogProps extends React.ComponentProps<typeof DialogPrimitive.Root> {}
|
|
22
|
+
|
|
23
|
+
function Dialog(props: DialogProps) {
|
|
24
|
+
return <DialogPrimitive.Root {...props} />;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
// --- DialogTrigger ---
|
|
28
|
+
|
|
29
|
+
interface DialogTriggerProps extends React.ComponentProps<typeof DialogPrimitive.Trigger> {}
|
|
30
|
+
|
|
31
|
+
function DialogTrigger({ className, ...props }: DialogTriggerProps) {
|
|
32
|
+
return <DialogPrimitive.Trigger data-slot="dialog-trigger" className={className} {...props} />;
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
// --- DialogContent (wraps Overlay + Content inside Portal) ---
|
|
36
|
+
|
|
37
|
+
const dialogContentVariants = cva(
|
|
38
|
+
"fixed left-1/2 top-1/2 z-50 -translate-x-1/2 -translate-y-1/2 bg-surface rounded-dialog flex flex-col overflow-hidden transition-[width,height,max-height] duration-200 ease-out [interpolate-size:allow-keywords]",
|
|
39
|
+
{
|
|
40
|
+
variants: {
|
|
41
|
+
fullscreen: {
|
|
42
|
+
false: "w-[560px] max-w-[calc(100vw-2rem)] h-auto max-h-[80vh]",
|
|
43
|
+
true: "w-[90vw] h-[90vh] max-h-[90vh]",
|
|
44
|
+
},
|
|
45
|
+
},
|
|
46
|
+
defaultVariants: {
|
|
47
|
+
fullscreen: false,
|
|
48
|
+
},
|
|
49
|
+
},
|
|
50
|
+
);
|
|
51
|
+
|
|
52
|
+
interface DialogContentProps
|
|
53
|
+
extends
|
|
54
|
+
React.ComponentProps<typeof DialogPrimitive.Popup>,
|
|
55
|
+
VariantProps<typeof dialogContentVariants> {
|
|
56
|
+
/** Allow the user to toggle the dialog between its size and fullscreen via
|
|
57
|
+
* a <DialogMaximize /> button placed in the header. Opt-in (default false). */
|
|
58
|
+
maximizable?: boolean;
|
|
59
|
+
/** Classes of the backdrop behind it (a darker one for an image viewer). */
|
|
60
|
+
backdropClassName?: string;
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
function DialogContent({
|
|
64
|
+
className,
|
|
65
|
+
children,
|
|
66
|
+
fullscreen,
|
|
67
|
+
maximizable = false,
|
|
68
|
+
backdropClassName,
|
|
69
|
+
...props
|
|
70
|
+
}: DialogContentProps) {
|
|
71
|
+
const [maximized, setMaximized] = React.useState(Boolean(fullscreen));
|
|
72
|
+
// When maximizable, the toggle drives the size; otherwise `fullscreen` is static.
|
|
73
|
+
const isFullscreen = maximizable ? maximized : fullscreen;
|
|
74
|
+
const draggable = useCapability("dialog.dragByTitleBar");
|
|
75
|
+
const root = useKitRoot("dialog.content");
|
|
76
|
+
return (
|
|
77
|
+
<DialogPrimitive.Portal>
|
|
78
|
+
<DialogPrimitive.Backdrop
|
|
79
|
+
data-slot="dialog-overlay"
|
|
80
|
+
className={cn("fixed inset-0 z-50 bg-black/30", backdropClassName)}
|
|
81
|
+
/>
|
|
82
|
+
<DialogPrimitive.Popup
|
|
83
|
+
data-slot="dialog-content"
|
|
84
|
+
className={cn(
|
|
85
|
+
dialogContentVariants({ fullscreen: isFullscreen, className }),
|
|
86
|
+
draggable && "[transform:translate(var(--dialog-drag-x,0px),var(--dialog-drag-y,0px))]",
|
|
87
|
+
)}
|
|
88
|
+
style={{ boxShadow: "var(--shadow-dialog)" }}
|
|
89
|
+
render={root && ((wiring) => root(wiring as React.ComponentPropsWithRef<"div">))}
|
|
90
|
+
{...props}
|
|
91
|
+
>
|
|
92
|
+
<DialogContentContext.Provider value={{ maximizable, maximized, setMaximized }}>
|
|
93
|
+
{children}
|
|
94
|
+
</DialogContentContext.Provider>
|
|
95
|
+
</DialogPrimitive.Popup>
|
|
96
|
+
</DialogPrimitive.Portal>
|
|
97
|
+
);
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
// --- DialogHeader ---
|
|
101
|
+
|
|
102
|
+
interface DialogHeaderProps extends React.ComponentProps<"div"> {}
|
|
103
|
+
|
|
104
|
+
function DialogHeader({ className, onPointerDown, ...props }: DialogHeaderProps) {
|
|
105
|
+
const draggable = useCapability("dialog.dragByTitleBar");
|
|
106
|
+
return (
|
|
107
|
+
<div
|
|
108
|
+
data-slot="dialog-header"
|
|
109
|
+
data-draggable={draggable || undefined}
|
|
110
|
+
className={cn("flex items-center pl-3 pr-2 pt-2 gap-1", className)}
|
|
111
|
+
onPointerDown={(event) => {
|
|
112
|
+
onPointerDown?.(event);
|
|
113
|
+
if (draggable && !event.defaultPrevented) dragByTitleBar(event);
|
|
114
|
+
}}
|
|
115
|
+
{...props}
|
|
116
|
+
/>
|
|
117
|
+
);
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
// --- DialogBody ---
|
|
121
|
+
|
|
122
|
+
interface DialogBodyProps extends React.ComponentProps<"div"> {}
|
|
123
|
+
|
|
124
|
+
function DialogBody({ className, ...props }: DialogBodyProps) {
|
|
125
|
+
return <div data-slot="dialog-body" className={cn("flex-1 px-5 pt-3", className)} {...props} />;
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
// --- DialogFooter ---
|
|
129
|
+
|
|
130
|
+
interface DialogFooterProps extends React.ComponentProps<"div"> {}
|
|
131
|
+
|
|
132
|
+
function DialogFooter({ className, ...props }: DialogFooterProps) {
|
|
133
|
+
return (
|
|
134
|
+
<div
|
|
135
|
+
data-slot="dialog-footer"
|
|
136
|
+
className={cn("flex items-center px-3 py-2.5 border-t border-border", className)}
|
|
137
|
+
{...props}
|
|
138
|
+
/>
|
|
139
|
+
);
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
// --- DialogTitle ---
|
|
143
|
+
|
|
144
|
+
interface DialogTitleProps extends React.ComponentProps<typeof DialogPrimitive.Title> {}
|
|
145
|
+
|
|
146
|
+
function DialogTitle({ className, ...props }: DialogTitleProps) {
|
|
147
|
+
return (
|
|
148
|
+
<DialogPrimitive.Title
|
|
149
|
+
data-slot="dialog-title"
|
|
150
|
+
className={cn("text-base font-medium flex-1", className)}
|
|
151
|
+
{...props}
|
|
152
|
+
/>
|
|
153
|
+
);
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
// --- DialogDescription ---
|
|
157
|
+
|
|
158
|
+
interface DialogDescriptionProps extends React.ComponentProps<typeof DialogPrimitive.Description> {}
|
|
159
|
+
|
|
160
|
+
function DialogDescription({ className, ...props }: DialogDescriptionProps) {
|
|
161
|
+
return (
|
|
162
|
+
<DialogPrimitive.Description
|
|
163
|
+
data-slot="dialog-description"
|
|
164
|
+
className={cn("text-sm text-muted", className)}
|
|
165
|
+
{...props}
|
|
166
|
+
/>
|
|
167
|
+
);
|
|
168
|
+
}
|
|
169
|
+
|
|
170
|
+
// --- DialogClose ---
|
|
171
|
+
|
|
172
|
+
interface DialogCloseProps extends React.ComponentProps<typeof DialogPrimitive.Close> {}
|
|
173
|
+
|
|
174
|
+
function DialogClose({ className, ...props }: DialogCloseProps) {
|
|
175
|
+
return <DialogPrimitive.Close data-slot="dialog-close" className={className} {...props} />;
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
// --- DialogMaximize (opt-in toggle; renders only inside a maximizable content) ---
|
|
179
|
+
|
|
180
|
+
interface DialogMaximizeProps extends React.ComponentProps<"button"> {}
|
|
181
|
+
|
|
182
|
+
function DialogMaximize({ className, onClick, ...props }: DialogMaximizeProps) {
|
|
183
|
+
const ctx = React.useContext(DialogContentContext);
|
|
184
|
+
if (!ctx?.maximizable) return null;
|
|
185
|
+
const { maximized, setMaximized } = ctx;
|
|
186
|
+
return (
|
|
187
|
+
<button
|
|
188
|
+
type="button"
|
|
189
|
+
data-slot="dialog-maximize"
|
|
190
|
+
aria-label={maximized ? "Restore" : "Maximize"}
|
|
191
|
+
aria-pressed={maximized}
|
|
192
|
+
className={className}
|
|
193
|
+
{...props}
|
|
194
|
+
onClick={(event) => {
|
|
195
|
+
onClick?.(event);
|
|
196
|
+
if (!event.defaultPrevented) setMaximized(!maximized);
|
|
197
|
+
}}
|
|
198
|
+
>
|
|
199
|
+
<svg
|
|
200
|
+
width="15"
|
|
201
|
+
height="15"
|
|
202
|
+
viewBox="0 0 24 24"
|
|
203
|
+
fill="none"
|
|
204
|
+
stroke="currentColor"
|
|
205
|
+
strokeWidth="2"
|
|
206
|
+
strokeLinecap="round"
|
|
207
|
+
strokeLinejoin="round"
|
|
208
|
+
aria-hidden="true"
|
|
209
|
+
>
|
|
210
|
+
{maximized ? (
|
|
211
|
+
<>
|
|
212
|
+
<polyline points="4 14 10 14 10 20" />
|
|
213
|
+
<polyline points="20 10 14 10 14 4" />
|
|
214
|
+
<line x1="14" y1="10" x2="21" y2="3" />
|
|
215
|
+
<line x1="3" y1="21" x2="10" y2="14" />
|
|
216
|
+
</>
|
|
217
|
+
) : (
|
|
218
|
+
<>
|
|
219
|
+
<polyline points="15 3 21 3 21 9" />
|
|
220
|
+
<polyline points="9 21 3 21 3 15" />
|
|
221
|
+
<line x1="21" y1="3" x2="14" y2="10" />
|
|
222
|
+
<line x1="3" y1="21" x2="10" y2="14" />
|
|
223
|
+
</>
|
|
224
|
+
)}
|
|
225
|
+
</svg>
|
|
226
|
+
</button>
|
|
227
|
+
);
|
|
228
|
+
}
|
|
229
|
+
|
|
230
|
+
export {
|
|
231
|
+
Dialog,
|
|
232
|
+
DialogTrigger,
|
|
233
|
+
DialogContent,
|
|
234
|
+
dialogContentVariants,
|
|
235
|
+
DialogHeader,
|
|
236
|
+
DialogBody,
|
|
237
|
+
DialogFooter,
|
|
238
|
+
DialogTitle,
|
|
239
|
+
DialogDescription,
|
|
240
|
+
DialogClose,
|
|
241
|
+
DialogMaximize,
|
|
242
|
+
};
|
|
243
|
+
export type {
|
|
244
|
+
DialogProps,
|
|
245
|
+
DialogTriggerProps,
|
|
246
|
+
DialogContentProps,
|
|
247
|
+
DialogHeaderProps,
|
|
248
|
+
DialogBodyProps,
|
|
249
|
+
DialogFooterProps,
|
|
250
|
+
DialogTitleProps,
|
|
251
|
+
DialogDescriptionProps,
|
|
252
|
+
DialogCloseProps,
|
|
253
|
+
DialogMaximizeProps,
|
|
254
|
+
};
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import type * as React from "react";
|
|
2
|
+
|
|
3
|
+
// The kit capability "dialog.dragByTitleBar" (kit/kit.tsx): a rendering that turns it on lets the header move
|
|
4
|
+
// the window. The offset lives on the window element (--dialog-drag-x/y), read only while the capability is on:
|
|
5
|
+
// a switch to a rendering without it centres the window again, and back finds it where it was left; a reopened
|
|
6
|
+
// dialog starts centred (a new element).
|
|
7
|
+
|
|
8
|
+
const clamp = (value: number, min: number, max: number) => Math.max(min, Math.min(value, max));
|
|
9
|
+
|
|
10
|
+
/** Drags the dialog by its header (its pointerdown, primary button, not on a control in it); the header
|
|
11
|
+
* stays inside the viewport. */
|
|
12
|
+
export function dragByTitleBar(event: React.PointerEvent<HTMLElement>) {
|
|
13
|
+
if (event.button !== 0 || (event.target as Element).closest("button, a, input, select, textarea"))
|
|
14
|
+
return;
|
|
15
|
+
const bar = event.currentTarget;
|
|
16
|
+
const frame = bar.closest<HTMLElement>("[data-slot=dialog-content]");
|
|
17
|
+
if (!frame) return;
|
|
18
|
+
event.preventDefault(); // no text selection while dragging
|
|
19
|
+
const offset = (axis: "x" | "y") =>
|
|
20
|
+
parseFloat(frame.style.getPropertyValue(`--dialog-drag-${axis}`)) || 0;
|
|
21
|
+
const from = { x: offset("x"), y: offset("y") };
|
|
22
|
+
const start = { x: event.clientX, y: event.clientY };
|
|
23
|
+
const box = frame.getBoundingClientRect();
|
|
24
|
+
const barHeight = bar.getBoundingClientRect().height;
|
|
25
|
+
const move = (e: PointerEvent) => {
|
|
26
|
+
const dx = clamp(e.clientX - start.x, -box.left, innerWidth - box.right);
|
|
27
|
+
const dy = clamp(e.clientY - start.y, -box.top, innerHeight - box.top - barHeight);
|
|
28
|
+
frame.style.setProperty("--dialog-drag-x", `${from.x + dx}px`);
|
|
29
|
+
frame.style.setProperty("--dialog-drag-y", `${from.y + dy}px`);
|
|
30
|
+
};
|
|
31
|
+
const end = () => {
|
|
32
|
+
bar.removeEventListener("pointermove", move);
|
|
33
|
+
bar.removeEventListener("pointerup", end);
|
|
34
|
+
bar.removeEventListener("pointercancel", end);
|
|
35
|
+
};
|
|
36
|
+
bar.setPointerCapture?.(event.pointerId);
|
|
37
|
+
bar.addEventListener("pointermove", move);
|
|
38
|
+
bar.addEventListener("pointerup", end);
|
|
39
|
+
bar.addEventListener("pointercancel", end);
|
|
40
|
+
}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
export {
|
|
2
|
+
Dialog,
|
|
3
|
+
DialogTrigger,
|
|
4
|
+
DialogContent,
|
|
5
|
+
dialogContentVariants,
|
|
6
|
+
DialogHeader,
|
|
7
|
+
DialogBody,
|
|
8
|
+
DialogFooter,
|
|
9
|
+
DialogTitle,
|
|
10
|
+
DialogDescription,
|
|
11
|
+
DialogClose,
|
|
12
|
+
DialogMaximize,
|
|
13
|
+
} from "./dialog";
|
|
14
|
+
export type {
|
|
15
|
+
DialogProps,
|
|
16
|
+
DialogTriggerProps,
|
|
17
|
+
DialogContentProps,
|
|
18
|
+
DialogHeaderProps,
|
|
19
|
+
DialogBodyProps,
|
|
20
|
+
DialogFooterProps,
|
|
21
|
+
DialogTitleProps,
|
|
22
|
+
DialogDescriptionProps,
|
|
23
|
+
DialogCloseProps,
|
|
24
|
+
DialogMaximizeProps,
|
|
25
|
+
} from "./dialog";
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
name: DropZone
|
|
2
|
+
description: "Wraps content as a place to drop files; while files are dragged over it an overlay says what a drop does, and a ref opens the system file picker."
|
|
3
|
+
layer: core
|
|
4
|
+
category: input
|
|
5
|
+
when_to_use:
|
|
6
|
+
- "A pane, a form or a prompt where the user drops files to upload or attach them"
|
|
7
|
+
- 'When the same place also needs a "choose files" trigger without the caller writing an <input type=file>'
|
|
8
|
+
when_not_to_use:
|
|
9
|
+
- "A one-line field for a value — use Input"
|
|
10
|
+
- "One image that is replaced by a drop — use ImageField"
|
|
11
|
+
props:
|
|
12
|
+
- name: onFiles
|
|
13
|
+
type: "(files: File[]) => void"
|
|
14
|
+
required: true
|
|
15
|
+
description: "The files dropped or picked, filtered by `accept` and `multiple`"
|
|
16
|
+
- name: accept
|
|
17
|
+
type: string
|
|
18
|
+
required: false
|
|
19
|
+
description: "What it takes, as <input accept>: mime types, image/*, extensions (.pdf)"
|
|
20
|
+
- name: multiple
|
|
21
|
+
type: boolean
|
|
22
|
+
required: false
|
|
23
|
+
default: "true"
|
|
24
|
+
description: "Keep every file; false keeps the first"
|
|
25
|
+
- name: disabled
|
|
26
|
+
type: boolean
|
|
27
|
+
required: false
|
|
28
|
+
default: "false"
|
|
29
|
+
description: "Ignores drags and the picker"
|
|
30
|
+
- name: label
|
|
31
|
+
type: string
|
|
32
|
+
required: false
|
|
33
|
+
default: '"Drop to upload"'
|
|
34
|
+
description: "What the overlay says while files are dragged over it"
|
|
35
|
+
- name: ref
|
|
36
|
+
type: "Ref<DropZoneHandle>"
|
|
37
|
+
required: false
|
|
38
|
+
description: "Exposes open(), which shows the system file picker (a hidden <input type=file>)"
|
|
39
|
+
- name: className
|
|
40
|
+
type: string
|
|
41
|
+
required: false
|
|
42
|
+
description: "Additional CSS classes merged via cn() on the wrapping div"
|
|
43
|
+
props_priority:
|
|
44
|
+
- onFiles
|
|
45
|
+
- accept
|
|
46
|
+
- multiple
|
|
47
|
+
- disabled
|
|
48
|
+
- ref
|
|
49
|
+
examples:
|
|
50
|
+
- title: "Attach images, with a button that opens the picker"
|
|
51
|
+
code: "const zone = useRef<DropZoneHandle>(null);\n<DropZone ref={zone} accept=\"image/*\" onFiles={addImages} className=\"rounded-default border border-dashed border-border p-3\">\n <Button onClick={() => zone.current?.open()}>Choose images…</Button>\n <p className=\"text-xs text-muted\">Or drop them here.</p>\n</DropZone>"
|
|
52
|
+
anti_patterns:
|
|
53
|
+
- "Don't read the overlay's label as a control — the whole zone is the target; the overlay ignores the pointer"
|
|
54
|
+
- "Don't keep the files' names to filter them yourself — pass the same accept the <input> takes"
|
|
55
|
+
accessibility_notes: "The overlay appears only while files are dragged; it is not announced, so the zone's own text must say it takes files. The hidden input is out of the tab order and aria-hidden: give the visible trigger an accessible name (the ref's open()). Dragging text or a link shows nothing."
|
|
@@ -0,0 +1,146 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
|
|
3
|
+
import { cn } from "../../../lib/utils";
|
|
4
|
+
|
|
5
|
+
/** What a `DropZone`'s ref exposes: opening the system file picker without the caller writing an `<input>`. */
|
|
6
|
+
interface DropZoneHandle {
|
|
7
|
+
open: () => void;
|
|
8
|
+
}
|
|
9
|
+
|
|
10
|
+
interface DropZoneProps extends Omit<React.ComponentProps<"div">, "ref"> {
|
|
11
|
+
/** The files dropped or picked, filtered by `accept` and `multiple`. */
|
|
12
|
+
onFiles: (files: File[]) => void;
|
|
13
|
+
/** What it takes, as `<input accept>`: mime types, `image/*`, extensions (`.pdf`). */
|
|
14
|
+
accept?: string;
|
|
15
|
+
/** Keep every file dropped; false keeps the first (default true). */
|
|
16
|
+
multiple?: boolean;
|
|
17
|
+
/** Ignores drags and the picker. */
|
|
18
|
+
disabled?: boolean;
|
|
19
|
+
/** What the overlay says while files are dragged over it (default "Drop to upload"). */
|
|
20
|
+
label?: string;
|
|
21
|
+
ref?: React.Ref<DropZoneHandle>;
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
/** Whether `file` fits one of `accept`'s comma-separated entries (`image/*`, `image/png`, `.pdf`). */
|
|
25
|
+
function accepted(file: File, accept?: string): boolean {
|
|
26
|
+
if (!accept) return true;
|
|
27
|
+
const type = file.type.toLowerCase();
|
|
28
|
+
const name = file.name.toLowerCase();
|
|
29
|
+
return accept.split(",").some((entry) => {
|
|
30
|
+
const token = entry.trim().toLowerCase();
|
|
31
|
+
if (!token) return false;
|
|
32
|
+
if (token === "*/*") return true;
|
|
33
|
+
if (token.endsWith("/*")) return type.startsWith(token.slice(0, -1));
|
|
34
|
+
if (token.startsWith(".")) return name.endsWith(token);
|
|
35
|
+
return type === token;
|
|
36
|
+
});
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
/** Whether a drag carries files (not text, a link or a selection). */
|
|
40
|
+
function carriesFiles(event: React.DragEvent): boolean {
|
|
41
|
+
const data = event.dataTransfer;
|
|
42
|
+
return Boolean(data && (data.types.includes("Files") || data.files?.length));
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
/** Wraps content as a place to drop files: while files are dragged over it an overlay says what a drop does; the
|
|
46
|
+
* ref's `open()` shows the system file picker (a hidden `<input type=file>`). */
|
|
47
|
+
function DropZone({
|
|
48
|
+
onFiles,
|
|
49
|
+
accept,
|
|
50
|
+
multiple = true,
|
|
51
|
+
disabled = false,
|
|
52
|
+
label = "Drop to upload",
|
|
53
|
+
ref,
|
|
54
|
+
className,
|
|
55
|
+
children,
|
|
56
|
+
...props
|
|
57
|
+
}: DropZoneProps) {
|
|
58
|
+
const input = React.useRef<HTMLInputElement>(null);
|
|
59
|
+
const depth = React.useRef(0);
|
|
60
|
+
const [over, setOver] = React.useState(false);
|
|
61
|
+
|
|
62
|
+
React.useImperativeHandle(
|
|
63
|
+
ref,
|
|
64
|
+
() => ({
|
|
65
|
+
open: () => {
|
|
66
|
+
if (!disabled) input.current?.click();
|
|
67
|
+
},
|
|
68
|
+
}),
|
|
69
|
+
[disabled],
|
|
70
|
+
);
|
|
71
|
+
|
|
72
|
+
React.useEffect(() => {
|
|
73
|
+
if (!disabled) return;
|
|
74
|
+
depth.current = 0;
|
|
75
|
+
setOver(false);
|
|
76
|
+
}, [disabled]);
|
|
77
|
+
|
|
78
|
+
/** The files to hand over: those `accept` takes, only the first without `multiple`. */
|
|
79
|
+
const picked = (files: File[]): File[] => {
|
|
80
|
+
const kept = files.filter((file) => accepted(file, accept));
|
|
81
|
+
return multiple ? kept : kept.slice(0, 1);
|
|
82
|
+
};
|
|
83
|
+
|
|
84
|
+
return (
|
|
85
|
+
<div
|
|
86
|
+
data-slot="drop-zone"
|
|
87
|
+
data-over={over ? "true" : undefined}
|
|
88
|
+
className={cn("relative", className)}
|
|
89
|
+
{...props}
|
|
90
|
+
onDragEnter={(event) => {
|
|
91
|
+
if (disabled || !carriesFiles(event)) return;
|
|
92
|
+
event.preventDefault();
|
|
93
|
+
depth.current += 1;
|
|
94
|
+
setOver(true);
|
|
95
|
+
}}
|
|
96
|
+
onDragOver={(event) => {
|
|
97
|
+
if (disabled || !carriesFiles(event)) return;
|
|
98
|
+
event.preventDefault();
|
|
99
|
+
if (event.dataTransfer) event.dataTransfer.dropEffect = "copy";
|
|
100
|
+
}}
|
|
101
|
+
onDragLeave={() => {
|
|
102
|
+
if (disabled || depth.current === 0) return;
|
|
103
|
+
depth.current = Math.max(0, depth.current - 1);
|
|
104
|
+
if (depth.current === 0) setOver(false);
|
|
105
|
+
}}
|
|
106
|
+
onDrop={(event) => {
|
|
107
|
+
if (disabled || !carriesFiles(event)) return;
|
|
108
|
+
event.preventDefault();
|
|
109
|
+
depth.current = 0;
|
|
110
|
+
setOver(false);
|
|
111
|
+
const files = picked(Array.from(event.dataTransfer?.files ?? []));
|
|
112
|
+
if (files.length) onFiles(files);
|
|
113
|
+
}}
|
|
114
|
+
>
|
|
115
|
+
{children}
|
|
116
|
+
{over && (
|
|
117
|
+
<div
|
|
118
|
+
data-slot="drop-zone-overlay"
|
|
119
|
+
className="pointer-events-none absolute inset-0 z-10 flex items-center justify-center rounded-lg border-2 border-dashed border-accent bg-surface/80 px-4 text-center text-sm font-medium text-accent"
|
|
120
|
+
>
|
|
121
|
+
{label}
|
|
122
|
+
</div>
|
|
123
|
+
)}
|
|
124
|
+
<input
|
|
125
|
+
ref={input}
|
|
126
|
+
data-slot="drop-zone-input"
|
|
127
|
+
type="file"
|
|
128
|
+
hidden
|
|
129
|
+
tabIndex={-1}
|
|
130
|
+
aria-hidden="true"
|
|
131
|
+
accept={accept}
|
|
132
|
+
multiple={multiple}
|
|
133
|
+
disabled={disabled}
|
|
134
|
+
onChange={(event) => {
|
|
135
|
+
const files = picked(Array.from(event.currentTarget.files ?? []));
|
|
136
|
+
if (files.length) onFiles(files);
|
|
137
|
+
// The same file chosen again fires a change too.
|
|
138
|
+
event.currentTarget.value = "";
|
|
139
|
+
}}
|
|
140
|
+
/>
|
|
141
|
+
</div>
|
|
142
|
+
);
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
export { DropZone };
|
|
146
|
+
export type { DropZoneHandle, DropZoneProps };
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
name: DropdownMenu
|
|
2
|
+
description: "Contextual action menu with keyboard shortcuts, separators, section labels, and destructive variants."
|
|
3
|
+
layer: core
|
|
4
|
+
category: overlay
|
|
5
|
+
when_to_use:
|
|
6
|
+
- "For contextual action menus triggered by buttons"
|
|
7
|
+
- "For overflow menus with multiple actions"
|
|
8
|
+
- "For menus with destructive actions, shortcuts, and grouping"
|
|
9
|
+
when_not_to_use:
|
|
10
|
+
- "For navigation menus — use Sidebar or Tabs"
|
|
11
|
+
- "For form select inputs — use a Select component"
|
|
12
|
+
- "For simple tooltips — use Tooltip component"
|
|
13
|
+
composition_partners:
|
|
14
|
+
- Button (as DropdownMenuTrigger child)
|
|
15
|
+
- Table (for row action menus)
|
|
16
|
+
- Dialog (triggered from menu items)
|
|
17
|
+
props:
|
|
18
|
+
- name: variant
|
|
19
|
+
type: "'default' | 'destructive'"
|
|
20
|
+
required: false
|
|
21
|
+
default: "'default'"
|
|
22
|
+
description: "Visual style for menu items — destructive renders in red (DropdownMenuItem only)"
|
|
23
|
+
- name: size
|
|
24
|
+
type: "'default' | 'large'"
|
|
25
|
+
required: false
|
|
26
|
+
default: "'default'"
|
|
27
|
+
description: "Item height (DropdownMenuItem and DropdownMenuSubTrigger) — large for a launcher's items (a Start menu's first column), taller with a bigger icon; renderings read data-size"
|
|
28
|
+
- name: sideOffset
|
|
29
|
+
type: "number | ((data) => number)"
|
|
30
|
+
required: false
|
|
31
|
+
default: "4"
|
|
32
|
+
description: "Distance from trigger in pixels (DropdownMenuContent only)"
|
|
33
|
+
- name: align
|
|
34
|
+
type: "'start' | 'center' | 'end'"
|
|
35
|
+
required: false
|
|
36
|
+
default: "'start'"
|
|
37
|
+
description: "Alignment relative to trigger (DropdownMenuContent only)"
|
|
38
|
+
- name: side
|
|
39
|
+
type: "'top' | 'right' | 'bottom' | 'left' | 'inline-start' | 'inline-end'"
|
|
40
|
+
required: false
|
|
41
|
+
default: "'bottom'"
|
|
42
|
+
description: "Preferred side to open the menu against the trigger (DropdownMenuContent only)"
|
|
43
|
+
- name: alignOffset
|
|
44
|
+
type: "number | ((data) => number)"
|
|
45
|
+
required: false
|
|
46
|
+
default: "0"
|
|
47
|
+
description: "Offset along the alignment axis in pixels (DropdownMenuContent only)"
|
|
48
|
+
- name: collisionPadding
|
|
49
|
+
type: "number | { top?, right?, bottom?, left? }"
|
|
50
|
+
required: false
|
|
51
|
+
default: "5"
|
|
52
|
+
description: "Minimum distance from viewport edges when auto-positioning (DropdownMenuContent only)"
|
|
53
|
+
- name: anchor
|
|
54
|
+
type: "Element | VirtualElement | RefObject<Element> | (() => Element | VirtualElement | null)"
|
|
55
|
+
required: false
|
|
56
|
+
description: "What to position against instead of the trigger (DropdownMenuContent only) — e.g. a point where a right-click happened, as { getBoundingClientRect: () => new DOMRect(x, y, 0, 0) }, for a menu opened without a trigger"
|
|
57
|
+
- name: onSelect
|
|
58
|
+
type: "(event: Event) => void"
|
|
59
|
+
required: false
|
|
60
|
+
description: "Activation callback on DropdownMenuItem. Base UI activates pointer and keyboard selections through the item's click path, so the native event is a click event (a PointerEvent in modern browsers) even for Enter/Space. Fires even if onClick calls preventDefault. Unlike Radix, event.preventDefault() no longer keeps the menu open — use closeOnClick={false} instead."
|
|
61
|
+
- name: closeOnClick
|
|
62
|
+
type: boolean
|
|
63
|
+
required: false
|
|
64
|
+
default: "true"
|
|
65
|
+
description: "Whether activating a DropdownMenuItem closes the menu (Base UI). Set false to keep the menu open — replaces the Radix pattern of calling event.preventDefault() inside onSelect."
|
|
66
|
+
- name: render
|
|
67
|
+
type: "ReactElement | (props, state) => ReactElement"
|
|
68
|
+
required: false
|
|
69
|
+
description: "Replace the rendered element on DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator, or DropdownMenuGroup, e.g. render={<Button />} on the trigger."
|
|
70
|
+
props_priority:
|
|
71
|
+
- variant
|
|
72
|
+
- sideOffset
|
|
73
|
+
- align
|
|
74
|
+
- side
|
|
75
|
+
variants:
|
|
76
|
+
- default: "Standard menu item with text-secondary, hover shows bg-hover"
|
|
77
|
+
- destructive: "Red text for dangerous actions (delete, remove)"
|
|
78
|
+
examples:
|
|
79
|
+
- title: "Basic dropdown menu"
|
|
80
|
+
code: |
|
|
81
|
+
import { MoreHorizontal } from 'lucide-react';
|
|
82
|
+
|
|
83
|
+
<DropdownMenu>
|
|
84
|
+
<DropdownMenuTrigger render={<Button size="icon-sm" aria-label="Open actions" />}>
|
|
85
|
+
<MoreHorizontal size={14} />
|
|
86
|
+
</DropdownMenuTrigger>
|
|
87
|
+
<DropdownMenuContent>
|
|
88
|
+
<DropdownMenuItem>Edit</DropdownMenuItem>
|
|
89
|
+
<DropdownMenuItem>
|
|
90
|
+
Copy link
|
|
91
|
+
<DropdownMenuShortcut>⌘L</DropdownMenuShortcut>
|
|
92
|
+
</DropdownMenuItem>
|
|
93
|
+
<DropdownMenuSeparator />
|
|
94
|
+
<DropdownMenuItem variant="destructive">Delete</DropdownMenuItem>
|
|
95
|
+
</DropdownMenuContent>
|
|
96
|
+
</DropdownMenu>
|
|
97
|
+
- title: "Menu with labels and groups"
|
|
98
|
+
code: |
|
|
99
|
+
<DropdownMenu>
|
|
100
|
+
<DropdownMenuTrigger render={<Button />}>Open actions</DropdownMenuTrigger>
|
|
101
|
+
<DropdownMenuContent>
|
|
102
|
+
<DropdownMenuLabel>Actions</DropdownMenuLabel>
|
|
103
|
+
<DropdownMenuGroup>
|
|
104
|
+
<DropdownMenuItem>Edit</DropdownMenuItem>
|
|
105
|
+
<DropdownMenuItem>Duplicate</DropdownMenuItem>
|
|
106
|
+
</DropdownMenuGroup>
|
|
107
|
+
<DropdownMenuSeparator />
|
|
108
|
+
<DropdownMenuItem variant="destructive">Delete</DropdownMenuItem>
|
|
109
|
+
</DropdownMenuContent>
|
|
110
|
+
</DropdownMenu>
|
|
111
|
+
anti_patterns:
|
|
112
|
+
- "Don't call event.preventDefault() inside onSelect to keep the menu open — that was the Radix idiom and no longer works. Pass closeOnClick={false} on the DropdownMenuItem instead."
|
|
113
|
+
- "Don't put complex interactive elements inside DropdownMenuItem — it's designed for simple actions"
|
|
114
|
+
- "Don't use DropdownMenu for navigation links — it's for actions, not navigation"
|
|
115
|
+
- "Don't nest DropdownMenus — sub-menus are not supported in this implementation"
|
|
116
|
+
- "Don't forget to use render={<Button />} on the trigger when wrapping a Button"
|
|
117
|
+
accessibility_notes: "Built on Base UI Menu — renders role='menu' and role='menuitem'. Keyboard: Arrow keys navigate items, Enter/Space to activate, Escape to close. Per the ARIA menu pattern, focus is NOT trapped: Tab closes the menu and moves focus to the next tabbable element; Escape closes and returns focus to the trigger."
|
|
118
|
+
notes: "Sub-components: DropdownMenu (root), DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem (with variant), DropdownMenuSeparator, DropdownMenuLabel, DropdownMenuGroup, DropdownMenuShortcut (visual shortcut hint)."
|