@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,226 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
import { Select as SelectPrimitive } from "@base-ui/react/select";
|
|
3
|
+
import { CSPProvider } from "@base-ui/react/csp-provider";
|
|
4
|
+
|
|
5
|
+
import { cn } from "../../../lib/utils";
|
|
6
|
+
import { inputVariants } from "../input/input";
|
|
7
|
+
import { dropdownMenuItemVariants } from "../dropdown-menu/dropdown-menu";
|
|
8
|
+
import { ScrollArea } from "../scroll-area";
|
|
9
|
+
|
|
10
|
+
// Bridge: structure from an earlier Bridge `select.tsx` (Base UI Select), restyled to the kit:
|
|
11
|
+
// the trigger is an `Input variant="outline"`, the popup a `DropdownMenuContent`.
|
|
12
|
+
|
|
13
|
+
// --- Select (root) ---
|
|
14
|
+
|
|
15
|
+
const Select = SelectPrimitive.Root;
|
|
16
|
+
|
|
17
|
+
type SelectProps<
|
|
18
|
+
Value = unknown,
|
|
19
|
+
Multiple extends boolean | undefined = false,
|
|
20
|
+
> = SelectPrimitive.Root.Props<Value, Multiple>;
|
|
21
|
+
|
|
22
|
+
// --- SelectTrigger ---
|
|
23
|
+
|
|
24
|
+
interface SelectTriggerProps extends React.ComponentProps<typeof SelectPrimitive.Trigger> {
|
|
25
|
+
/** Height, as `Input variant="outline"` (h-sm, h-md, h-lg). Defaults to `default` (h-md), as Button and Input: a form that wants h-lg sets `lg` on each of its controls. */
|
|
26
|
+
size?: "sm" | "default" | "lg";
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
// Optical centring (Bridge): a text control, so 1px bottom padding; the chevron keeps the box's centre.
|
|
30
|
+
function SelectTrigger({ className, size = "default", children, ...props }: SelectTriggerProps) {
|
|
31
|
+
return (
|
|
32
|
+
<SelectPrimitive.Trigger
|
|
33
|
+
data-slot="select-trigger"
|
|
34
|
+
className={cn(
|
|
35
|
+
inputVariants({ variant: "outline", size }),
|
|
36
|
+
"pb-px items-center justify-between gap-1.5 text-left whitespace-nowrap cursor-pointer data-popup-open:border-accent data-placeholder:text-placeholder",
|
|
37
|
+
className,
|
|
38
|
+
)}
|
|
39
|
+
{...props}
|
|
40
|
+
>
|
|
41
|
+
{children}
|
|
42
|
+
<SelectPrimitive.Icon className="flex shrink-0 -mb-px text-muted">
|
|
43
|
+
<svg
|
|
44
|
+
aria-hidden="true"
|
|
45
|
+
className="size-4"
|
|
46
|
+
viewBox="0 0 24 24"
|
|
47
|
+
fill="none"
|
|
48
|
+
stroke="currentColor"
|
|
49
|
+
strokeWidth="2"
|
|
50
|
+
strokeLinecap="round"
|
|
51
|
+
strokeLinejoin="round"
|
|
52
|
+
>
|
|
53
|
+
<path d="m6 9 6 6 6-6" />
|
|
54
|
+
</svg>
|
|
55
|
+
</SelectPrimitive.Icon>
|
|
56
|
+
</SelectPrimitive.Trigger>
|
|
57
|
+
);
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
// --- SelectValue ---
|
|
61
|
+
|
|
62
|
+
interface SelectValueProps extends React.ComponentProps<typeof SelectPrimitive.Value> {}
|
|
63
|
+
|
|
64
|
+
function SelectValue({ className, ...props }: SelectValueProps) {
|
|
65
|
+
return (
|
|
66
|
+
<SelectPrimitive.Value
|
|
67
|
+
data-slot="select-value"
|
|
68
|
+
className={cn("flex-1 truncate", className)}
|
|
69
|
+
{...props}
|
|
70
|
+
/>
|
|
71
|
+
);
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
// --- SelectContent ---
|
|
75
|
+
|
|
76
|
+
interface SelectContentProps extends React.ComponentProps<typeof SelectPrimitive.Popup> {
|
|
77
|
+
/** Distance from the trigger in px (lives on Base UI's Positioner) */
|
|
78
|
+
sideOffset?: SelectPrimitive.Positioner.Props["sideOffset"];
|
|
79
|
+
/** Alignment against the trigger (lives on Base UI's Positioner) */
|
|
80
|
+
align?: SelectPrimitive.Positioner.Props["align"];
|
|
81
|
+
/** Which side of the trigger to position against (lives on Base UI's Positioner) */
|
|
82
|
+
side?: SelectPrimitive.Positioner.Props["side"];
|
|
83
|
+
/** Offset along the alignment axis (lives on Base UI's Positioner) */
|
|
84
|
+
alignOffset?: SelectPrimitive.Positioner.Props["alignOffset"];
|
|
85
|
+
/** Overlay the selected item on the trigger (macOS style) instead of dropping below it, as DropdownMenu does. */
|
|
86
|
+
alignItemWithTrigger?: SelectPrimitive.Positioner.Props["alignItemWithTrigger"];
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
function SelectContent({
|
|
90
|
+
className,
|
|
91
|
+
children,
|
|
92
|
+
sideOffset = 4,
|
|
93
|
+
align = "start",
|
|
94
|
+
side,
|
|
95
|
+
alignOffset,
|
|
96
|
+
alignItemWithTrigger = false,
|
|
97
|
+
...props
|
|
98
|
+
}: SelectContentProps) {
|
|
99
|
+
// Bridge: the page's CSP refuses inline <style>; Base UI's scrollbar-hiding style element is only
|
|
100
|
+
// needed with scroll arrows or without a List, neither of which this popup has.
|
|
101
|
+
return (
|
|
102
|
+
<CSPProvider disableStyleElements>
|
|
103
|
+
<SelectPrimitive.Portal>
|
|
104
|
+
<SelectPrimitive.Positioner
|
|
105
|
+
sideOffset={sideOffset}
|
|
106
|
+
align={align}
|
|
107
|
+
side={side}
|
|
108
|
+
alignOffset={alignOffset}
|
|
109
|
+
alignItemWithTrigger={alignItemWithTrigger}
|
|
110
|
+
className="z-50"
|
|
111
|
+
>
|
|
112
|
+
<SelectPrimitive.Popup
|
|
113
|
+
data-slot="select-content"
|
|
114
|
+
className={cn(
|
|
115
|
+
"z-50 flex min-w-(--anchor-width) max-h-(--available-height) flex-col bg-surface rounded-dropdown outline-none",
|
|
116
|
+
className,
|
|
117
|
+
)}
|
|
118
|
+
style={{ boxShadow: "var(--shadow-dropdown)" }}
|
|
119
|
+
{...props}
|
|
120
|
+
>
|
|
121
|
+
<ScrollArea className="flex min-h-0 flex-col" viewportClassName="min-h-0 flex-1">
|
|
122
|
+
<SelectPrimitive.List className="flex flex-col p-1">{children}</SelectPrimitive.List>
|
|
123
|
+
</ScrollArea>
|
|
124
|
+
</SelectPrimitive.Popup>
|
|
125
|
+
</SelectPrimitive.Positioner>
|
|
126
|
+
</SelectPrimitive.Portal>
|
|
127
|
+
</CSPProvider>
|
|
128
|
+
);
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
// --- SelectItem ---
|
|
132
|
+
|
|
133
|
+
interface SelectItemProps extends React.ComponentProps<typeof SelectPrimitive.Item> {}
|
|
134
|
+
|
|
135
|
+
function SelectItem({ className, children, ...props }: SelectItemProps) {
|
|
136
|
+
return (
|
|
137
|
+
<SelectPrimitive.Item
|
|
138
|
+
data-slot="select-item"
|
|
139
|
+
className={cn(
|
|
140
|
+
dropdownMenuItemVariants(),
|
|
141
|
+
"data-disabled:pointer-events-none data-disabled:opacity-50",
|
|
142
|
+
className,
|
|
143
|
+
)}
|
|
144
|
+
{...props}
|
|
145
|
+
>
|
|
146
|
+
<SelectPrimitive.ItemText className="flex-1 truncate">{children}</SelectPrimitive.ItemText>
|
|
147
|
+
<SelectPrimitive.ItemIndicator className="flex shrink-0 text-muted">
|
|
148
|
+
<svg
|
|
149
|
+
aria-hidden="true"
|
|
150
|
+
className="size-4"
|
|
151
|
+
viewBox="0 0 24 24"
|
|
152
|
+
fill="none"
|
|
153
|
+
stroke="currentColor"
|
|
154
|
+
strokeWidth="2"
|
|
155
|
+
strokeLinecap="round"
|
|
156
|
+
strokeLinejoin="round"
|
|
157
|
+
>
|
|
158
|
+
<path d="M20 6 9 17l-5-5" />
|
|
159
|
+
</svg>
|
|
160
|
+
</SelectPrimitive.ItemIndicator>
|
|
161
|
+
</SelectPrimitive.Item>
|
|
162
|
+
);
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
// --- SelectGroup ---
|
|
166
|
+
|
|
167
|
+
interface SelectGroupProps extends React.ComponentProps<typeof SelectPrimitive.Group> {}
|
|
168
|
+
|
|
169
|
+
function SelectGroup({ className, ...props }: SelectGroupProps) {
|
|
170
|
+
return (
|
|
171
|
+
<SelectPrimitive.Group
|
|
172
|
+
data-slot="select-group"
|
|
173
|
+
className={cn("flex flex-col", className)}
|
|
174
|
+
{...props}
|
|
175
|
+
/>
|
|
176
|
+
);
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
// --- SelectLabel (a group's label, inside SelectGroup) ---
|
|
180
|
+
|
|
181
|
+
interface SelectLabelProps extends React.ComponentProps<typeof SelectPrimitive.GroupLabel> {}
|
|
182
|
+
|
|
183
|
+
function SelectLabel({ className, ...props }: SelectLabelProps) {
|
|
184
|
+
return (
|
|
185
|
+
<SelectPrimitive.GroupLabel
|
|
186
|
+
data-slot="select-label"
|
|
187
|
+
className={cn("text-xs font-medium text-muted px-2 pt-1.5 pb-0.5", className)}
|
|
188
|
+
{...props}
|
|
189
|
+
/>
|
|
190
|
+
);
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
// --- SelectSeparator ---
|
|
194
|
+
|
|
195
|
+
interface SelectSeparatorProps extends React.ComponentProps<typeof SelectPrimitive.Separator> {}
|
|
196
|
+
|
|
197
|
+
function SelectSeparator({ className, ...props }: SelectSeparatorProps) {
|
|
198
|
+
return (
|
|
199
|
+
<SelectPrimitive.Separator
|
|
200
|
+
data-slot="select-separator"
|
|
201
|
+
className={cn("h-px bg-border my-1", className)}
|
|
202
|
+
{...props}
|
|
203
|
+
/>
|
|
204
|
+
);
|
|
205
|
+
}
|
|
206
|
+
|
|
207
|
+
export {
|
|
208
|
+
Select,
|
|
209
|
+
SelectTrigger,
|
|
210
|
+
SelectValue,
|
|
211
|
+
SelectContent,
|
|
212
|
+
SelectItem,
|
|
213
|
+
SelectGroup,
|
|
214
|
+
SelectLabel,
|
|
215
|
+
SelectSeparator,
|
|
216
|
+
};
|
|
217
|
+
export type {
|
|
218
|
+
SelectProps,
|
|
219
|
+
SelectTriggerProps,
|
|
220
|
+
SelectValueProps,
|
|
221
|
+
SelectContentProps,
|
|
222
|
+
SelectItemProps,
|
|
223
|
+
SelectGroupProps,
|
|
224
|
+
SelectLabelProps,
|
|
225
|
+
SelectSeparatorProps,
|
|
226
|
+
};
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
name: Skeleton
|
|
2
|
+
description: "A pulsing placeholder block shown while content loads. Purely visual: its size comes from className, not from a width or height prop."
|
|
3
|
+
layer: core
|
|
4
|
+
category: feedback
|
|
5
|
+
when_to_use:
|
|
6
|
+
- "While data or an image loads, in the shape and size of what will replace it"
|
|
7
|
+
- "For a list or card's loading state (a block per line, a circle for an avatar)"
|
|
8
|
+
when_not_to_use:
|
|
9
|
+
- "For a short wait where a spinner reads better — use a spinner"
|
|
10
|
+
- "As the final empty state — show real copy when there is nothing to load"
|
|
11
|
+
- "For a progress that is known — show a progress value instead of an indefinite pulse"
|
|
12
|
+
composition_partners:
|
|
13
|
+
- Card (as a loading body)
|
|
14
|
+
- Avatar (a `round` circle placeholder, matching the avatar's size)
|
|
15
|
+
- List (one line per row)
|
|
16
|
+
props:
|
|
17
|
+
- name: round
|
|
18
|
+
type: boolean
|
|
19
|
+
required: false
|
|
20
|
+
default: "false"
|
|
21
|
+
description: "Draw a circle (rounded-full) instead of the default rounded-sm rectangle, e.g. for an avatar"
|
|
22
|
+
- name: className
|
|
23
|
+
type: string
|
|
24
|
+
required: false
|
|
25
|
+
description: "Sizing and layout (e.g. h-4 w-24, size-6); merged with the base classes"
|
|
26
|
+
- name: ...divProps
|
|
27
|
+
type: React.ComponentProps<"div">
|
|
28
|
+
required: false
|
|
29
|
+
description: "Any other div attribute, spread onto the block"
|
|
30
|
+
props_priority:
|
|
31
|
+
- round
|
|
32
|
+
- className
|
|
33
|
+
examples:
|
|
34
|
+
- title: "A line of text"
|
|
35
|
+
code: '<Skeleton className="h-4 w-24" />'
|
|
36
|
+
- title: "An avatar's place"
|
|
37
|
+
code: '<Skeleton round className="size-6" />'
|
|
38
|
+
- title: "A card's loading body"
|
|
39
|
+
code: |
|
|
40
|
+
<Card>
|
|
41
|
+
<div className="flex flex-col gap-2">
|
|
42
|
+
<Skeleton className="h-4 w-3/4" />
|
|
43
|
+
<Skeleton className="h-4 w-1/2" />
|
|
44
|
+
</div>
|
|
45
|
+
</Card>
|
|
46
|
+
anti_patterns:
|
|
47
|
+
- "Don't animate it yourself — the pulse and its reduced-motion fallback are built in"
|
|
48
|
+
- "Don't use it as a permanent empty state — it promises content that will not arrive"
|
|
49
|
+
- "Don't give it children or text — it is aria-hidden decoration"
|
|
50
|
+
accessibility_notes: "Renders an aria-hidden div, so assistive technology skips it; announce the loading state on the surrounding region (e.g. aria-busy) instead."
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
|
|
3
|
+
import { cn } from "../../../lib/utils";
|
|
4
|
+
|
|
5
|
+
interface SkeletonProps extends React.ComponentProps<"div"> {
|
|
6
|
+
/** Draw a circle instead of the default rounded rectangle (e.g. an avatar's place). */
|
|
7
|
+
round?: boolean;
|
|
8
|
+
}
|
|
9
|
+
|
|
10
|
+
/** A pulsing placeholder block. Purely presentational; its size comes from `className`. */
|
|
11
|
+
function Skeleton({ className, round, ...props }: SkeletonProps) {
|
|
12
|
+
return (
|
|
13
|
+
<div
|
|
14
|
+
data-slot="skeleton"
|
|
15
|
+
aria-hidden="true"
|
|
16
|
+
className={cn(
|
|
17
|
+
"bg-active rounded-sm animate-pulse motion-reduce:animate-none",
|
|
18
|
+
round && "rounded-full",
|
|
19
|
+
className,
|
|
20
|
+
)}
|
|
21
|
+
{...props}
|
|
22
|
+
/>
|
|
23
|
+
);
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
// research-033's mockup: a list's and a record page's shapes while they load; a screen reader hears "Loading…".
|
|
27
|
+
|
|
28
|
+
/** A list loading: eight rows (an avatar, a name, a line). */
|
|
29
|
+
function ListSkeleton() {
|
|
30
|
+
return (
|
|
31
|
+
<div role="status" data-slot="list-skeleton" className="flex flex-col gap-1.5 px-3 py-2">
|
|
32
|
+
<span className="sr-only">Loading…</span>
|
|
33
|
+
{Array.from({ length: 8 }, (_, at) => (
|
|
34
|
+
<div key={at} className="flex min-h-9 items-center gap-3">
|
|
35
|
+
<Skeleton round style={{ width: 28, height: 28, flex: "none" }} />
|
|
36
|
+
<Skeleton style={{ width: 90 + ((at * 23) % 60), height: 10 }} />
|
|
37
|
+
<Skeleton style={{ width: 60 + ((at * 37) % 80), height: 8 }} />
|
|
38
|
+
</div>
|
|
39
|
+
))}
|
|
40
|
+
</div>
|
|
41
|
+
);
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/** A record page loading: its header (an avatar, a title, a line), then five rows (a label, a value). */
|
|
45
|
+
function DetailSkeleton() {
|
|
46
|
+
return (
|
|
47
|
+
<div
|
|
48
|
+
role="status"
|
|
49
|
+
data-slot="detail-skeleton"
|
|
50
|
+
className="flex h-full flex-col gap-1 px-10 py-6"
|
|
51
|
+
>
|
|
52
|
+
<span className="sr-only">Loading…</span>
|
|
53
|
+
<div className="mb-[18px] flex items-center gap-[18px]">
|
|
54
|
+
<Skeleton round style={{ width: 64, height: 64, flex: "none" }} />
|
|
55
|
+
<div className="flex flex-col gap-2.5">
|
|
56
|
+
<Skeleton style={{ width: 180, height: 18 }} />
|
|
57
|
+
<Skeleton style={{ width: 120, height: 10 }} />
|
|
58
|
+
</div>
|
|
59
|
+
</div>
|
|
60
|
+
{[110, 60, 139, 168, 90].map((width, at) => (
|
|
61
|
+
<div key={at} className="flex min-h-9 items-center gap-[60px]">
|
|
62
|
+
<Skeleton style={{ width: 64, height: 9 }} />
|
|
63
|
+
<Skeleton style={{ width, height: 10 }} />
|
|
64
|
+
</div>
|
|
65
|
+
))}
|
|
66
|
+
</div>
|
|
67
|
+
);
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
export { Skeleton, ListSkeleton, DetailSkeleton };
|
|
71
|
+
export type { SkeletonProps };
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
name: Slider
|
|
2
|
+
description: "One numeric value on a range, built on Base UI Slider: a 6px track filled in the accent up to a 16px thumb, as wide as its container (160px at least)."
|
|
3
|
+
layer: core
|
|
4
|
+
category: input
|
|
5
|
+
when_to_use:
|
|
6
|
+
- "For a bounded number whose exact value matters less than its feel (an opacity, a blur, a size)"
|
|
7
|
+
- "For settings that apply live while dragged"
|
|
8
|
+
when_not_to_use:
|
|
9
|
+
- "For an exact number typed in — use Input type=number"
|
|
10
|
+
- "For a few named choices — use SegmentGroup"
|
|
11
|
+
composition_partners:
|
|
12
|
+
- Properties (as value in PropertyRow, beside the value read out)
|
|
13
|
+
props:
|
|
14
|
+
- name: value
|
|
15
|
+
type: number
|
|
16
|
+
required: false
|
|
17
|
+
description: "Controlled value"
|
|
18
|
+
- name: onValueChange
|
|
19
|
+
type: "(value: number, eventDetails) => void"
|
|
20
|
+
required: false
|
|
21
|
+
description: "Each move, while dragged or keyed"
|
|
22
|
+
- name: onValueCommitted
|
|
23
|
+
type: "(value: number, eventDetails) => void"
|
|
24
|
+
required: false
|
|
25
|
+
description: "Once the pointer is released or a key pressed"
|
|
26
|
+
- name: min
|
|
27
|
+
type: number
|
|
28
|
+
required: false
|
|
29
|
+
description: "Lowest value (0)"
|
|
30
|
+
- name: max
|
|
31
|
+
type: number
|
|
32
|
+
required: false
|
|
33
|
+
description: "Highest value (100)"
|
|
34
|
+
- name: step
|
|
35
|
+
type: number
|
|
36
|
+
required: false
|
|
37
|
+
description: "Increment (1)"
|
|
38
|
+
- name: disabled
|
|
39
|
+
type: boolean
|
|
40
|
+
required: false
|
|
41
|
+
description: "Whether the slider is disabled"
|
|
42
|
+
props_priority:
|
|
43
|
+
- value
|
|
44
|
+
- onValueChange
|
|
45
|
+
- min
|
|
46
|
+
- max
|
|
47
|
+
- step
|
|
48
|
+
examples:
|
|
49
|
+
- title: "Controlled slider"
|
|
50
|
+
code: '<Slider value={opacity} onValueChange={setOpacity} min={30} max={100} aria-label="Opacity" />'
|
|
51
|
+
anti_patterns:
|
|
52
|
+
- "Don't use without showing the value next to it when the number means something"
|
|
53
|
+
- "Don't leave it in a shrink-to-fit container: give the container a width (a settings row: 280px)"
|
|
54
|
+
- "Don't pass an array value — this Slider holds one value"
|
|
55
|
+
accessibility_notes: "Built on Base UI Slider — a native range input inside the thumb, role='slider' with aria-valuenow/min/max. Keyboard: arrows step, Page Up/Down step by ten, Home/End to the ends. Label it with aria-label or aria-labelledby."
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
import { Slider as SliderPrimitive } from "@base-ui/react/slider";
|
|
3
|
+
|
|
4
|
+
import { cn } from "../../../lib/utils";
|
|
5
|
+
|
|
6
|
+
interface SliderProps extends Omit<
|
|
7
|
+
React.ComponentProps<typeof SliderPrimitive.Root<number>>,
|
|
8
|
+
"render"
|
|
9
|
+
> {}
|
|
10
|
+
|
|
11
|
+
/** One value on a range: a 6px track filled in the accent up to a 16px thumb, as wide as its
|
|
12
|
+
* container (min 160px); its label goes to the thumb's input. */
|
|
13
|
+
function Slider({
|
|
14
|
+
className,
|
|
15
|
+
"aria-label": label,
|
|
16
|
+
"aria-labelledby": labelledBy,
|
|
17
|
+
...props
|
|
18
|
+
}: SliderProps) {
|
|
19
|
+
return (
|
|
20
|
+
<SliderPrimitive.Root
|
|
21
|
+
data-slot="slider"
|
|
22
|
+
className={cn(
|
|
23
|
+
"relative flex w-full min-w-40 touch-none items-center select-none data-disabled:opacity-50",
|
|
24
|
+
className,
|
|
25
|
+
)}
|
|
26
|
+
{...props}
|
|
27
|
+
>
|
|
28
|
+
<SliderPrimitive.Control className="flex h-6 w-full grow cursor-pointer items-center data-disabled:cursor-not-allowed">
|
|
29
|
+
<SliderPrimitive.Track
|
|
30
|
+
data-slot="slider-track"
|
|
31
|
+
className="relative h-1.5 w-full rounded-full bg-border"
|
|
32
|
+
>
|
|
33
|
+
<SliderPrimitive.Indicator className="rounded-full bg-accent" />
|
|
34
|
+
<SliderPrimitive.Thumb
|
|
35
|
+
aria-label={label}
|
|
36
|
+
aria-labelledby={labelledBy}
|
|
37
|
+
className="size-4 rounded-full border border-border bg-white shadow-sm transition-[box-shadow] outline-none has-[:focus-visible]:ring-2 has-[:focus-visible]:ring-accent has-[:focus-visible]:ring-offset-2 has-[:focus-visible]:ring-offset-background"
|
|
38
|
+
/>
|
|
39
|
+
</SliderPrimitive.Track>
|
|
40
|
+
</SliderPrimitive.Control>
|
|
41
|
+
</SliderPrimitive.Root>
|
|
42
|
+
);
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
export { Slider };
|
|
46
|
+
export type { SliderProps };
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
export {
|
|
2
|
+
SortableBoard,
|
|
3
|
+
SortableList,
|
|
4
|
+
SortableItem,
|
|
5
|
+
DragHandle,
|
|
6
|
+
useSortableDragState,
|
|
7
|
+
arrayMove,
|
|
8
|
+
} from "./sortable";
|
|
9
|
+
export type {
|
|
10
|
+
SortableBoardProps,
|
|
11
|
+
SortableListProps,
|
|
12
|
+
SortableItemProps,
|
|
13
|
+
DragHandleProps,
|
|
14
|
+
SortableDragState,
|
|
15
|
+
MoveEvent,
|
|
16
|
+
} from "./sortable";
|
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
name: Sortable
|
|
2
|
+
description: "Drag-and-drop sortable primitives for reorderable lists and cross-container Kanban boards. Built on @dnd-kit."
|
|
3
|
+
layer: core
|
|
4
|
+
category: interaction
|
|
5
|
+
when_to_use:
|
|
6
|
+
- "For Kanban boards with cross-column card dragging"
|
|
7
|
+
- "For reorderable lists (priority ordering, playlist management)"
|
|
8
|
+
- "For any UI where users rearrange items by dragging"
|
|
9
|
+
when_not_to_use:
|
|
10
|
+
- "For static lists that don't need reordering — use List component"
|
|
11
|
+
- "For simple selection — use List with selectionMode"
|
|
12
|
+
- "For file upload drag-and-drop — this is for sortable reordering only"
|
|
13
|
+
composition_partners:
|
|
14
|
+
- Card (primary draggable surface in Kanban and list views)
|
|
15
|
+
- ScrollArea (scrollable containers that hold SortableLists)
|
|
16
|
+
- StatusIcon (status display inside draggable cards)
|
|
17
|
+
- Avatar (assignee on draggable cards)
|
|
18
|
+
- Label (category tags on draggable cards)
|
|
19
|
+
- Badge (column counts)
|
|
20
|
+
- DropdownMenu (card actions — must not trigger drag)
|
|
21
|
+
- List (alternative to Card for simpler reorderable lists)
|
|
22
|
+
props:
|
|
23
|
+
- name: "SortableBoard.onMove"
|
|
24
|
+
type: "(event: MoveEvent) => void"
|
|
25
|
+
required: false
|
|
26
|
+
description: "Called when item moves between containers. MoveEvent: { itemId, fromContainerId, toContainerId, fromIndex, toIndex }"
|
|
27
|
+
- name: "SortableBoard.renderOverlay"
|
|
28
|
+
type: "(activeId: string) => React.ReactNode"
|
|
29
|
+
required: false
|
|
30
|
+
description: "Render function for drag overlay content. Receives the active item id."
|
|
31
|
+
- name: "SortableList.id"
|
|
32
|
+
type: string
|
|
33
|
+
required: true
|
|
34
|
+
description: "Unique container ID, required for cross-container sorting"
|
|
35
|
+
- name: "SortableList.items"
|
|
36
|
+
type: "string[]"
|
|
37
|
+
required: true
|
|
38
|
+
description: "Ordered array of item IDs"
|
|
39
|
+
- name: "SortableList.onReorder"
|
|
40
|
+
type: "(items: string[]) => void"
|
|
41
|
+
required: false
|
|
42
|
+
description: "Called when items are reordered within this list"
|
|
43
|
+
- name: "SortableList.itemLabel"
|
|
44
|
+
type: "(id: string) => string"
|
|
45
|
+
required: false
|
|
46
|
+
description: 'An item''s name in the screen reader announcements of a standalone list, with its position ("Picked up Draft notes, at position 2 of 3."); without it, dnd-kit announces the id'
|
|
47
|
+
- name: "SortableList.orientation"
|
|
48
|
+
type: "'vertical' | 'horizontal'"
|
|
49
|
+
required: false
|
|
50
|
+
default: "'vertical'"
|
|
51
|
+
description: "Sorting axis"
|
|
52
|
+
- name: "SortableItem.id"
|
|
53
|
+
type: string
|
|
54
|
+
required: true
|
|
55
|
+
description: "Unique item ID matching an entry in parent's items array"
|
|
56
|
+
- name: "SortableItem.disabled"
|
|
57
|
+
type: boolean
|
|
58
|
+
required: false
|
|
59
|
+
default: "false"
|
|
60
|
+
description: "Disable drag on this item"
|
|
61
|
+
- name: "SortableItem.dragFullItem"
|
|
62
|
+
type: "boolean | 'pointer'"
|
|
63
|
+
required: false
|
|
64
|
+
default: "false"
|
|
65
|
+
description: "When true, entire item is draggable (a button role and tab stop, Space/Enter pick it up). When false (default), only a DragHandle child activates drag via context. 'pointer': the entire item drags with the pointer only, with no role, tab stop or key handling, for an item that is itself a control (a List option); give the keyboard another way to reorder (Move up / Move down menu items)."
|
|
66
|
+
props_priority:
|
|
67
|
+
- "SortableList.items"
|
|
68
|
+
- "SortableList.onReorder"
|
|
69
|
+
- "SortableItem.id"
|
|
70
|
+
- "SortableBoard.onMove"
|
|
71
|
+
- "SortableBoard.renderOverlay"
|
|
72
|
+
examples:
|
|
73
|
+
- title: "Single list reorder"
|
|
74
|
+
code: |
|
|
75
|
+
<SortableList id="tasks" items={taskIds} onReorder={setTaskIds}>
|
|
76
|
+
{tasks.map(task => (
|
|
77
|
+
<SortableItem key={task.id} id={task.id}>
|
|
78
|
+
<Card variant="outline" interactive>
|
|
79
|
+
<div className="flex items-center gap-2">
|
|
80
|
+
<DragHandle />
|
|
81
|
+
<StatusIcon status={task.status} />
|
|
82
|
+
<span className="text-sm">{task.title}</span>
|
|
83
|
+
</div>
|
|
84
|
+
</Card>
|
|
85
|
+
</SortableItem>
|
|
86
|
+
))}
|
|
87
|
+
</SortableList>
|
|
88
|
+
- title: "Kanban board with cross-column drag"
|
|
89
|
+
code: |
|
|
90
|
+
<SortableBoard onMove={handleMove} renderOverlay={(id) => <CardOverlay id={id} />}>
|
|
91
|
+
<div className="flex gap-4 h-full">
|
|
92
|
+
{columns.map(col => (
|
|
93
|
+
<div key={col.id} className="w-[280px] flex flex-col">
|
|
94
|
+
<div className="flex items-center gap-2 p-3">
|
|
95
|
+
<StatusIcon status={col.status} />
|
|
96
|
+
<span className="text-sm font-medium">{col.label}</span>
|
|
97
|
+
<Badge>{col.items.length}</Badge>
|
|
98
|
+
</div>
|
|
99
|
+
<ScrollArea className="flex-1">
|
|
100
|
+
<SortableList id={col.id} items={col.itemIds} onReorder={(ids) => reorderColumn(col.id, ids)}>
|
|
101
|
+
<div className="flex flex-col gap-2 p-2">
|
|
102
|
+
{col.items.map(item => (
|
|
103
|
+
<SortableItem key={item.id} id={item.id}>
|
|
104
|
+
<Card variant="outline" interactive>
|
|
105
|
+
<p className="text-sm">{item.title}</p>
|
|
106
|
+
</Card>
|
|
107
|
+
</SortableItem>
|
|
108
|
+
))}
|
|
109
|
+
</div>
|
|
110
|
+
</SortableList>
|
|
111
|
+
</ScrollArea>
|
|
112
|
+
</div>
|
|
113
|
+
))}
|
|
114
|
+
</div>
|
|
115
|
+
</SortableBoard>
|
|
116
|
+
anti_patterns:
|
|
117
|
+
- "Don't use dragFullItem={true} when items contain interactive elements (buttons, links, inputs) — use DragHandle instead so clicks and text selection work"
|
|
118
|
+
- 'Don''t use dragFullItem={true} around a List option: its button role sits between the listbox and the option, and Space on the option picks the row up instead of selecting it — use dragFullItem="pointer" and Move up / Move down menu items'
|
|
119
|
+
- "Don't use SortableBoard for single-list reorder — SortableList works standalone"
|
|
120
|
+
- "Don't forget renderOverlay on SortableBoard — without it, no visual feedback during cross-container drag"
|
|
121
|
+
- "Don't nest SortableBoard inside another SortableBoard — use one board with multiple lists"
|
|
122
|
+
accessibility_notes: "Keyboard: Space/Enter to pick up item, Arrow keys to move within list, Space/Enter to drop, Escape to cancel. Screen reader announcements via @dnd-kit's built-in accessibility API. DragHandle has aria-label for identification."
|
|
123
|
+
notes: "Sub-components: SortableBoard (cross-container DnD context with swing physics overlay), SortableList (single sortable group with useDroppable for empty container drops), SortableItem (draggable wrapper), DragHandle (visual grip receiving listeners via context). Hook: useSortableDragState() returns { activeId, overContainerId } — use inside SortableBoard children to highlight drop zones. SortableList auto-detects if inside SortableBoard — when standalone, creates its own DnD context. arrayMove utility is re-exported for convenience. Touch sensor uses 250ms delay to distinguish from scroll. Pointer sensor uses 5px distance threshold. See kanban-board pattern for a complete multi-column implementation."
|
|
124
|
+
related_patterns:
|
|
125
|
+
- kanban-board
|