@zonsh/ui 0.5.0 → 0.6.1
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/CHANGELOG.md +643 -0
- package/README.md +49 -21
- package/dist/brand.d.ts +3 -0
- package/dist/brand.js +7 -0
- package/dist/components/_breadcrumb-more.d.ts +6 -0
- package/dist/components/_breadcrumb-more.js +5 -0
- package/dist/components/_drawing-svg.d.ts +11 -0
- package/dist/components/_drawing-svg.js +30 -0
- package/dist/components/_media.d.ts +159 -0
- package/dist/components/_media.js +266 -0
- package/dist/components/_overlay.d.ts +8 -5
- package/dist/components/_overlay.js +11 -6
- package/dist/components/_scheduler-calendar.d.ts +71 -0
- package/dist/components/_scheduler-calendar.js +940 -0
- package/dist/components/_scheduler-editor.d.ts +29 -0
- package/dist/components/_scheduler-editor.js +111 -0
- package/dist/components/_scheduler-menu.d.ts +16 -0
- package/dist/components/_scheduler-menu.js +18 -0
- package/dist/components/_scheduler-parts.d.ts +164 -0
- package/dist/components/_scheduler-parts.js +327 -0
- package/dist/components/_suggest-list.d.ts +142 -0
- package/dist/components/_suggest-list.js +159 -0
- package/dist/components/_toolbar-more.d.ts +24 -0
- package/dist/components/_toolbar-more.js +25 -0
- package/dist/components/accordion.d.ts +1 -1
- package/dist/components/accordion.js +6 -6
- package/dist/components/action-sheet.d.ts +88 -0
- package/dist/components/action-sheet.js +124 -0
- package/dist/components/alert-dialog.js +3 -1
- package/dist/components/alert.d.ts +11 -18
- package/dist/components/alert.js +9 -6
- package/dist/components/app-bar.d.ts +93 -0
- package/dist/components/app-bar.js +175 -0
- package/dist/components/audio-player.d.ts +134 -0
- package/dist/components/audio-player.js +618 -0
- package/dist/components/avatar.d.ts +6 -6
- package/dist/components/avatar.js +13 -11
- package/dist/components/badge.d.ts +12 -12
- package/dist/components/badge.js +7 -5
- package/dist/components/bottom-nav.d.ts +53 -11
- package/dist/components/bottom-nav.js +388 -23
- package/dist/components/breadcrumb.d.ts +11 -2
- package/dist/components/breadcrumb.js +60 -6
- package/dist/components/button-group.js +5 -1
- package/dist/components/button.d.ts +23 -6
- package/dist/components/button.js +63 -7
- package/dist/components/calendar.js +8 -6
- package/dist/components/card.d.ts +10 -8
- package/dist/components/card.js +15 -14
- package/dist/components/carousel.d.ts +2 -2
- package/dist/components/carousel.js +21 -8
- package/dist/components/chart.d.ts +27 -1
- package/dist/components/chart.js +15 -5
- package/dist/components/checkbox.js +2 -2
- package/dist/components/code-block.d.ts +9 -2
- package/dist/components/code-block.js +26 -7
- package/dist/components/collapsible.js +3 -3
- package/dist/components/color-picker.d.ts +2 -2
- package/dist/components/color-picker.js +5 -5
- package/dist/components/combobox.d.ts +26 -7
- package/dist/components/combobox.js +32 -13
- package/dist/components/command.d.ts +29 -5
- package/dist/components/command.js +35 -10
- package/dist/components/context-menu.d.ts +5 -2
- package/dist/components/context-menu.js +24 -3
- package/dist/components/conversation.d.ts +1 -1
- package/dist/components/conversation.js +67 -13
- package/dist/components/copy-button.d.ts +1 -1
- package/dist/components/copy-button.js +1 -1
- package/dist/components/data-table.d.ts +6 -6
- package/dist/components/data-table.js +41 -15
- package/dist/components/date-picker.d.ts +31 -9
- package/dist/components/date-picker.js +100 -18
- package/dist/components/dialog.d.ts +17 -10
- package/dist/components/dialog.js +20 -13
- package/dist/components/drawer.d.ts +26 -8
- package/dist/components/drawer.js +75 -16
- package/dist/components/drawing.d.ts +25 -0
- package/dist/components/drawing.js +32 -0
- package/dist/components/empty.js +2 -2
- package/dist/components/feature-list.d.ts +65 -13
- package/dist/components/feature-list.js +116 -15
- package/dist/components/field.js +2 -2
- package/dist/components/file-drop.d.ts +9 -7
- package/dist/components/file-drop.js +8 -43
- package/dist/components/filter-bar.d.ts +10 -9
- package/dist/components/filter-bar.js +42 -25
- package/dist/components/graph.d.ts +19 -3
- package/dist/components/graph.js +170 -25
- package/dist/components/illustration.js +3 -28
- package/dist/components/input-group.d.ts +5 -10
- package/dist/components/input-group.js +16 -16
- package/dist/components/input.d.ts +2 -2
- package/dist/components/input.js +3 -3
- package/dist/components/item.d.ts +9 -6
- package/dist/components/item.js +13 -8
- package/dist/components/kbd.d.ts +1 -1
- package/dist/components/kbd.js +1 -1
- package/dist/components/lightbox.d.ts +76 -9
- package/dist/components/lightbox.js +333 -45
- package/dist/components/locale.d.ts +6 -6
- package/dist/components/logo.d.ts +21 -1
- package/dist/components/logo.js +32 -2
- package/dist/components/markdown-editor.d.ts +275 -0
- package/dist/components/markdown-editor.js +831 -0
- package/dist/components/mentions.d.ts +153 -0
- package/dist/components/mentions.js +507 -0
- package/dist/components/menu.d.ts +2 -1
- package/dist/components/menu.js +5 -4
- package/dist/components/menubar.d.ts +23 -5
- package/dist/components/menubar.js +97 -22
- package/dist/components/message.d.ts +62 -11
- package/dist/components/message.js +49 -13
- package/dist/components/meter.js +1 -1
- package/dist/components/money-input.d.ts +1 -1
- package/dist/components/money-input.js +1 -1
- package/dist/components/native-select.d.ts +2 -2
- package/dist/components/native-select.js +4 -4
- package/dist/components/navigation-menu.d.ts +3 -1
- package/dist/components/navigation-menu.js +23 -12
- package/dist/components/number-field.d.ts +2 -9
- package/dist/components/number-field.js +86 -36
- package/dist/components/number-roll.d.ts +26 -0
- package/dist/components/number-roll.js +81 -0
- package/dist/components/otp-field.d.ts +1 -1
- package/dist/components/otp-field.js +24 -3
- package/dist/components/pagination.d.ts +11 -3
- package/dist/components/pagination.js +59 -13
- package/dist/components/pdf-viewer.d.ts +1 -1
- package/dist/components/pdf-viewer.js +8 -8
- package/dist/components/phone-input.d.ts +1 -1
- package/dist/components/phone-input.js +2 -2
- package/dist/components/popover.js +5 -3
- package/dist/components/preview-card.d.ts +37 -2
- package/dist/components/preview-card.js +226 -2
- package/dist/components/progress.js +1 -1
- package/dist/components/prompt-input.d.ts +1 -1
- package/dist/components/prompt-input.js +24 -14
- package/dist/components/pull-to-refresh.d.ts +50 -0
- package/dist/components/pull-to-refresh.js +189 -0
- package/dist/components/quote.d.ts +6 -1
- package/dist/components/quote.js +3 -2
- package/dist/components/radio-group.js +1 -1
- package/dist/components/rating.d.ts +4 -1
- package/dist/components/rating.js +131 -10
- package/dist/components/reasoning.d.ts +1 -1
- package/dist/components/reasoning.js +7 -3
- package/dist/components/resizable.d.ts +1 -1
- package/dist/components/resizable.js +2 -2
- package/dist/components/response.d.ts +1 -1
- package/dist/components/response.js +18 -6
- package/dist/components/scheduler.d.ts +352 -0
- package/dist/components/scheduler.js +1717 -0
- package/dist/components/scroll-area.js +1 -1
- package/dist/components/select.d.ts +17 -4
- package/dist/components/select.js +140 -9
- package/dist/components/separator.d.ts +1 -1
- package/dist/components/separator.js +3 -3
- package/dist/components/sidebar.d.ts +44 -3
- package/dist/components/sidebar.js +57 -17
- package/dist/components/site-header.d.ts +18 -13
- package/dist/components/site-header.js +23 -11
- package/dist/components/skeleton.d.ts +17 -7
- package/dist/components/skeleton.js +22 -7
- package/dist/components/slider.js +2 -2
- package/dist/components/sortable.d.ts +55 -4
- package/dist/components/sortable.js +172 -103
- package/dist/components/sources.d.ts +1 -1
- package/dist/components/sources.js +2 -2
- package/dist/components/spinner.d.ts +4 -4
- package/dist/components/spinner.js +4 -4
- package/dist/components/stat.d.ts +21 -4
- package/dist/components/stat.js +17 -8
- package/dist/components/stepper.d.ts +1 -1
- package/dist/components/stepper.js +8 -7
- package/dist/components/suggestions.d.ts +11 -3
- package/dist/components/suggestions.js +10 -4
- package/dist/components/swipe-actions.d.ts +66 -0
- package/dist/components/swipe-actions.js +292 -0
- package/dist/components/switch.js +1 -1
- package/dist/components/table.d.ts +12 -6
- package/dist/components/table.js +78 -30
- package/dist/components/tabs.js +7 -4
- package/dist/components/tag.d.ts +19 -20
- package/dist/components/tag.js +9 -5
- package/dist/components/tags-input.d.ts +2 -7
- package/dist/components/tags-input.js +11 -8
- package/dist/components/textarea.d.ts +3 -2
- package/dist/components/textarea.js +4 -3
- package/dist/components/theme.d.ts +49 -6
- package/dist/components/theme.js +147 -9
- package/dist/components/time-field.d.ts +4 -9
- package/dist/components/time-field.js +6 -6
- package/dist/components/timeline.d.ts +19 -3
- package/dist/components/timeline.js +21 -9
- package/dist/components/tippy.d.ts +17 -1
- package/dist/components/tippy.js +95 -15
- package/dist/components/toast.d.ts +2 -7
- package/dist/components/toast.js +12 -8
- package/dist/components/toggle-group.d.ts +7 -1
- package/dist/components/toggle-group.js +16 -5
- package/dist/components/toggle.d.ts +2 -2
- package/dist/components/toggle.js +3 -2
- package/dist/components/tool-call.d.ts +1 -1
- package/dist/components/tool-call.js +4 -4
- package/dist/components/toolbar.d.ts +57 -4
- package/dist/components/toolbar.js +216 -16
- package/dist/components/tooltip.d.ts +1 -1
- package/dist/components/tooltip.js +4 -2
- package/dist/components/tour.d.ts +1 -1
- package/dist/components/tour.js +36 -15
- package/dist/components/tree.js +5 -5
- package/dist/components/typography.d.ts +31 -8
- package/dist/components/typography.js +21 -10
- package/dist/components/video-player.d.ts +7 -2
- package/dist/components/video-player.js +121 -220
- package/dist/index.d.ts +99 -92
- package/dist/index.js +99 -92
- package/dist/lib/calendar.d.ts +153 -0
- package/dist/lib/calendar.js +312 -0
- package/dist/lib/cn.d.ts +3 -1
- package/dist/lib/cn.js +5 -0
- package/dist/lib/code-highlight.d.ts +14 -0
- package/dist/lib/code-highlight.js +81 -18
- package/dist/lib/drag.d.ts +39 -0
- package/dist/lib/drag.js +96 -0
- package/dist/lib/editorial-assets.js +16 -8
- package/dist/lib/figure/figures/automation.js +25 -6
- package/dist/lib/figure/figures/bar-chart.js +6 -1
- package/dist/lib/figure/figures/brackets-classic.js +4 -1
- package/dist/lib/figure/figures/city.js +12 -2
- package/dist/lib/figure/figures/conveyor.js +17 -4
- package/dist/lib/figure/figures/database.js +5 -2
- package/dist/lib/figure/figures/documents.js +11 -3
- package/dist/lib/figure/figures/inbox.js +5 -2
- package/dist/lib/figure/figures/laptop.js +3 -1
- package/dist/lib/figure/figures/pipeline.js +45 -10
- package/dist/lib/figure/figures/platform.js +62 -7
- package/dist/lib/figure/figures/server.js +21 -5
- package/dist/lib/figure/figures/spreadsheet.js +29 -5
- package/dist/lib/figure/kernel.d.ts +4 -2
- package/dist/lib/figure/kernel.js +10 -5
- package/dist/lib/figure/parts.js +6 -2
- package/dist/lib/files.d.ts +31 -0
- package/dist/lib/files.js +60 -0
- package/dist/lib/gesture.d.ts +70 -0
- package/dist/lib/gesture.js +141 -0
- package/dist/lib/glide.d.ts +5 -0
- package/dist/lib/glide.js +9 -1
- package/dist/lib/icons.d.ts +1 -0
- package/dist/lib/icons.js +6 -0
- package/dist/lib/illustration-library.js +1 -6
- package/dist/lib/markdown-edit.d.ts +112 -0
- package/dist/lib/markdown-edit.js +557 -0
- package/dist/lib/markdown-rich-editor.d.ts +188 -0
- package/dist/lib/markdown-rich-editor.js +1153 -0
- package/dist/lib/markdown-rich.d.ts +63 -0
- package/dist/lib/markdown-rich.js +534 -0
- package/dist/lib/mentions.d.ts +100 -0
- package/dist/lib/mentions.js +246 -0
- package/dist/lib/motion.d.ts +18 -0
- package/dist/lib/motion.js +43 -5
- package/dist/lib/number-roll.d.ts +89 -0
- package/dist/lib/number-roll.js +391 -0
- package/dist/lib/platform.d.ts +6 -0
- package/dist/lib/platform.js +14 -0
- package/dist/lib/portal-container.d.ts +9 -0
- package/dist/lib/portal-container.js +10 -0
- package/dist/lib/press.d.ts +5 -0
- package/dist/lib/press.js +186 -0
- package/dist/lib/scheduler.d.ts +128 -0
- package/dist/lib/scheduler.js +272 -0
- package/dist/lib/scroll-edges.d.ts +9 -0
- package/dist/lib/scroll-edges.js +50 -0
- package/dist/lib/table-fit.d.ts +1 -1
- package/dist/lib/table-fit.js +65 -8
- package/dist/lib/theme-preset.d.ts +267 -0
- package/dist/lib/theme-preset.js +1046 -0
- package/dist/lib/theme-script.d.ts +23 -3
- package/dist/lib/theme-script.js +17 -5
- package/dist/lib/tippy/sprite.d.ts +36 -4
- package/dist/lib/tippy/sprite.js +188 -15
- package/dist/lib/tone.d.ts +4 -0
- package/dist/lib/tone.js +1 -0
- package/dist/messages/de.d.ts +3 -3
- package/dist/messages/de.js +274 -3
- package/dist/skills/zon-ui/SKILL.md +279 -0
- package/dist/skills/zon-ui/references/authoring.md +265 -0
- package/dist/skills/zon-ui/references/brand.md +416 -0
- package/dist/skills/zon-ui/references/components/accordion.md +199 -0
- package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
- package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
- package/dist/skills/zon-ui/references/components/alert.md +167 -0
- package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
- package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
- package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
- package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
- package/dist/skills/zon-ui/references/components/avatar.md +98 -0
- package/dist/skills/zon-ui/references/components/badge.md +227 -0
- package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
- package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
- package/dist/skills/zon-ui/references/components/button-group.md +216 -0
- package/dist/skills/zon-ui/references/components/button.md +309 -0
- package/dist/skills/zon-ui/references/components/calendar.md +296 -0
- package/dist/skills/zon-ui/references/components/card.md +158 -0
- package/dist/skills/zon-ui/references/components/carousel.md +297 -0
- package/dist/skills/zon-ui/references/components/chart.md +739 -0
- package/dist/skills/zon-ui/references/components/chat.md +417 -0
- package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
- package/dist/skills/zon-ui/references/components/code-block.md +143 -0
- package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
- package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
- package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
- package/dist/skills/zon-ui/references/components/combobox.md +455 -0
- package/dist/skills/zon-ui/references/components/command.md +326 -0
- package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
- package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
- package/dist/skills/zon-ui/references/components/conversation.md +146 -0
- package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
- package/dist/skills/zon-ui/references/components/crm.md +1022 -0
- package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
- package/dist/skills/zon-ui/references/components/data-table.md +776 -0
- package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
- package/dist/skills/zon-ui/references/components/dialog.md +335 -0
- package/dist/skills/zon-ui/references/components/direction.md +165 -0
- package/dist/skills/zon-ui/references/components/drawer.md +276 -0
- package/dist/skills/zon-ui/references/components/drawing.md +94 -0
- package/dist/skills/zon-ui/references/components/empty.md +225 -0
- package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
- package/dist/skills/zon-ui/references/components/field.md +209 -0
- package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
- package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
- package/dist/skills/zon-ui/references/components/form.md +970 -0
- package/dist/skills/zon-ui/references/components/graph.md +339 -0
- package/dist/skills/zon-ui/references/components/illustration.md +497 -0
- package/dist/skills/zon-ui/references/components/inbox.md +263 -0
- package/dist/skills/zon-ui/references/components/input-group.md +339 -0
- package/dist/skills/zon-ui/references/components/input.md +189 -0
- package/dist/skills/zon-ui/references/components/item.md +277 -0
- package/dist/skills/zon-ui/references/components/kanban.md +626 -0
- package/dist/skills/zon-ui/references/components/kbd.md +116 -0
- package/dist/skills/zon-ui/references/components/label.md +104 -0
- package/dist/skills/zon-ui/references/components/layout.md +291 -0
- package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
- package/dist/skills/zon-ui/references/components/locale.md +279 -0
- package/dist/skills/zon-ui/references/components/logo.md +257 -0
- package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
- package/dist/skills/zon-ui/references/components/mentions.md +512 -0
- package/dist/skills/zon-ui/references/components/menu.md +218 -0
- package/dist/skills/zon-ui/references/components/menubar.md +292 -0
- package/dist/skills/zon-ui/references/components/message.md +243 -0
- package/dist/skills/zon-ui/references/components/meter.md +105 -0
- package/dist/skills/zon-ui/references/components/money-input.md +333 -0
- package/dist/skills/zon-ui/references/components/native-select.md +197 -0
- package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
- package/dist/skills/zon-ui/references/components/number-field.md +210 -0
- package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
- package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
- package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
- package/dist/skills/zon-ui/references/components/pagination.md +109 -0
- package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
- package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
- package/dist/skills/zon-ui/references/components/popover.md +176 -0
- package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
- package/dist/skills/zon-ui/references/components/pricing.md +724 -0
- package/dist/skills/zon-ui/references/components/progress.md +92 -0
- package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
- package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
- package/dist/skills/zon-ui/references/components/quote.md +115 -0
- package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
- package/dist/skills/zon-ui/references/components/rating.md +260 -0
- package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
- package/dist/skills/zon-ui/references/components/resizable.md +213 -0
- package/dist/skills/zon-ui/references/components/response.md +170 -0
- package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
- package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
- package/dist/skills/zon-ui/references/components/select.md +351 -0
- package/dist/skills/zon-ui/references/components/separator.md +103 -0
- package/dist/skills/zon-ui/references/components/settings.md +793 -0
- package/dist/skills/zon-ui/references/components/shop.md +1715 -0
- package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
- package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
- package/dist/skills/zon-ui/references/components/site-header.md +303 -0
- package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
- package/dist/skills/zon-ui/references/components/slider.md +172 -0
- package/dist/skills/zon-ui/references/components/sortable.md +405 -0
- package/dist/skills/zon-ui/references/components/sources.md +106 -0
- package/dist/skills/zon-ui/references/components/spinner.md +222 -0
- package/dist/skills/zon-ui/references/components/stat.md +267 -0
- package/dist/skills/zon-ui/references/components/stepper.md +285 -0
- package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
- package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
- package/dist/skills/zon-ui/references/components/switch.md +160 -0
- package/dist/skills/zon-ui/references/components/table.md +999 -0
- package/dist/skills/zon-ui/references/components/tabs.md +258 -0
- package/dist/skills/zon-ui/references/components/tag.md +115 -0
- package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
- package/dist/skills/zon-ui/references/components/textarea.md +95 -0
- package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
- package/dist/skills/zon-ui/references/components/theme.md +362 -0
- package/dist/skills/zon-ui/references/components/time-field.md +222 -0
- package/dist/skills/zon-ui/references/components/timeline.md +285 -0
- package/dist/skills/zon-ui/references/components/tippy.md +243 -0
- package/dist/skills/zon-ui/references/components/toast.md +220 -0
- package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
- package/dist/skills/zon-ui/references/components/toggle.md +167 -0
- package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
- package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
- package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
- package/dist/skills/zon-ui/references/components/tour.md +423 -0
- package/dist/skills/zon-ui/references/components/tree.md +481 -0
- package/dist/skills/zon-ui/references/components/typography.md +347 -0
- package/dist/skills/zon-ui/references/components/video-player.md +386 -0
- package/dist/skills/zon-ui/references/marketing.md +467 -0
- package/dist/skills/zon-ui/references/motion.md +455 -0
- package/dist/skills/zon-ui/references/recipes.md +1232 -0
- package/dist/skills/zon-ui/references/tokens.md +866 -0
- package/dist/sources/accordion.css +4 -0
- package/dist/sources/action-sheet.css +11 -0
- package/dist/sources/alert-dialog.css +6 -0
- package/dist/sources/alert.css +3 -0
- package/dist/sources/app-bar.css +14 -0
- package/dist/sources/ascii-field.css +3 -0
- package/dist/sources/aspect-ratio.css +3 -0
- package/dist/sources/audio-player.css +20 -0
- package/dist/sources/avatar.css +3 -0
- package/dist/sources/badge.css +3 -0
- package/dist/sources/bottom-nav.css +9 -0
- package/dist/sources/breadcrumb.css +14 -0
- package/dist/sources/button-group.css +3 -0
- package/dist/sources/button.css +9 -0
- package/dist/sources/calendar.css +13 -0
- package/dist/sources/card.css +3 -0
- package/dist/sources/carousel.css +11 -0
- package/dist/sources/chart.css +5 -0
- package/dist/sources/checkbox.css +6 -0
- package/dist/sources/code-block.css +13 -0
- package/dist/sources/collapsible.css +4 -0
- package/dist/sources/color-picker.css +13 -0
- package/dist/sources/combobox.css +13 -0
- package/dist/sources/command.css +13 -0
- package/dist/sources/context-menu.css +12 -0
- package/dist/sources/conversation.css +10 -0
- package/dist/sources/copy-button.css +10 -0
- package/dist/sources/data-table.css +27 -0
- package/dist/sources/date-picker.css +20 -0
- package/dist/sources/dialog.css +9 -0
- package/dist/sources/direction.css +2 -0
- package/dist/sources/drawer.css +9 -0
- package/dist/sources/drawing.css +5 -0
- package/dist/sources/empty.css +3 -0
- package/dist/sources/feature-list.css +4 -0
- package/dist/sources/field.css +4 -0
- package/dist/sources/file-drop.css +15 -0
- package/dist/sources/filter-bar.css +30 -0
- package/dist/sources/form.css +4 -0
- package/dist/sources/graph.css +19 -0
- package/dist/sources/illustration.css +28 -0
- package/dist/sources/input-group.css +7 -0
- package/dist/sources/input.css +3 -0
- package/dist/sources/item.css +4 -0
- package/dist/sources/kbd.css +5 -0
- package/dist/sources/label.css +3 -0
- package/dist/sources/layout.css +3 -0
- package/dist/sources/lightbox.css +33 -0
- package/dist/sources/locale.css +2 -0
- package/dist/sources/logo.css +4 -0
- package/dist/sources/markdown-editor.css +41 -0
- package/dist/sources/mentions.css +13 -0
- package/dist/sources/menu.css +11 -0
- package/dist/sources/menubar.css +14 -0
- package/dist/sources/message.css +16 -0
- package/dist/sources/meter.css +4 -0
- package/dist/sources/money-input.css +10 -0
- package/dist/sources/native-select.css +4 -0
- package/dist/sources/navigation-menu.css +8 -0
- package/dist/sources/number-field.css +8 -0
- package/dist/sources/number-roll.css +6 -0
- package/dist/sources/otp-field.css +5 -0
- package/dist/sources/pagination.css +11 -0
- package/dist/sources/pdf-viewer.css +30 -0
- package/dist/sources/phone-input.css +20 -0
- package/dist/sources/popover.css +7 -0
- package/dist/sources/preview-card.css +7 -0
- package/dist/sources/progress.css +4 -0
- package/dist/sources/prompt-input.css +15 -0
- package/dist/sources/pull-to-refresh.css +14 -0
- package/dist/sources/quote.css +3 -0
- package/dist/sources/radio-group.css +5 -0
- package/dist/sources/rating.css +6 -0
- package/dist/sources/reasoning.css +6 -0
- package/dist/sources/resizable.css +4 -0
- package/dist/sources/response.css +16 -0
- package/dist/sources/scheduler.css +44 -0
- package/dist/sources/scroll-area.css +3 -0
- package/dist/sources/select.css +12 -0
- package/dist/sources/separator.css +3 -0
- package/dist/sources/sidebar.css +19 -0
- package/dist/sources/site-header.css +15 -0
- package/dist/sources/skeleton.css +3 -0
- package/dist/sources/slider.css +6 -0
- package/dist/sources/sortable.css +12 -0
- package/dist/sources/sources.css +6 -0
- package/dist/sources/spinner.css +6 -0
- package/dist/sources/stat.css +9 -0
- package/dist/sources/stepper.css +6 -0
- package/dist/sources/suggestions.css +10 -0
- package/dist/sources/swipe-actions.css +20 -0
- package/dist/sources/switch.css +5 -0
- package/dist/sources/table.css +7 -0
- package/dist/sources/tabs.css +5 -0
- package/dist/sources/tag.css +3 -0
- package/dist/sources/tags-input.css +6 -0
- package/dist/sources/textarea.css +3 -0
- package/dist/sources/theme.css +13 -0
- package/dist/sources/time-field.css +7 -0
- package/dist/sources/timeline.css +7 -0
- package/dist/sources/tippy.css +6 -0
- package/dist/sources/toast.css +6 -0
- package/dist/sources/toggle-group.css +5 -0
- package/dist/sources/toggle.css +3 -0
- package/dist/sources/tool-call.css +16 -0
- package/dist/sources/toolbar.css +14 -0
- package/dist/sources/tooltip.css +6 -0
- package/dist/sources/tour.css +14 -0
- package/dist/sources/tree.css +6 -0
- package/dist/sources/typography.css +4 -0
- package/dist/sources/video-player.css +21 -0
- package/dist/styles/ai.css +3 -0
- package/dist/styles/brand.css +98 -0
- package/dist/styles/core.css +266 -0
- package/dist/styles/editor.css +3 -0
- package/dist/styles/expressive.css +35 -56
- package/dist/styles/fonts.css +61 -117
- package/dist/styles/graph.css +4 -0
- package/dist/styles/illustration.css +4 -0
- package/dist/styles/index.css +11 -201
- package/dist/styles/material.css +138 -12
- package/dist/styles/parts/ai.css +18 -13
- package/dist/styles/parts/brand.css +2 -2
- package/dist/styles/parts/controls.css +29 -20
- package/dist/styles/parts/data.css +13 -9
- package/dist/styles/parts/editor.css +372 -0
- package/dist/styles/parts/feedback.css +32 -2
- package/dist/styles/parts/foundations.css +12 -7
- package/dist/styles/parts/graph.css +25 -9
- package/dist/styles/parts/inputs.css +172 -9
- package/dist/styles/parts/isometric.css +6 -5
- package/dist/styles/parts/navigation.css +206 -27
- package/dist/styles/parts/overlays.css +19 -4
- package/dist/styles/parts/pdf.css +2 -2
- package/dist/styles/pdf.css +3 -0
- package/dist/styles/prose.css +3 -0
- package/dist/styles/tokens.css +89 -14
- package/dist/theme.d.ts +1 -0
- package/dist/theme.js +5 -0
- package/dist/vite.d.ts +48 -59
- package/dist/vite.js +54 -21
- package/package.json +69 -2
|
@@ -0,0 +1,268 @@
|
|
|
1
|
+
# Action Sheet
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { ActionSheet, ActionSheetAction, ActionSheetContent, ActionSheetTrigger, Button, Eyebrow, Heading } from "@zonsh/ui";
|
|
5
|
+
import { EllipsisIcon } from "lucide-react";
|
|
6
|
+
import * as React from "react";
|
|
7
|
+
|
|
8
|
+
/**
|
|
9
|
+
* A phone-sized screen. Its layout containment makes it the box a sheet's fixed backdrop and
|
|
10
|
+
* viewport fill, so the sheet opens inside the screen rather than across the docs page.
|
|
11
|
+
*/
|
|
12
|
+
function Phone({
|
|
13
|
+
label,
|
|
14
|
+
screen,
|
|
15
|
+
children,
|
|
16
|
+
}: {
|
|
17
|
+
label: string;
|
|
18
|
+
screen: React.RefObject<HTMLDivElement | null>;
|
|
19
|
+
children: React.ReactNode;
|
|
20
|
+
}) {
|
|
21
|
+
return (
|
|
22
|
+
<div
|
|
23
|
+
ref={screen}
|
|
24
|
+
className="relative mx-auto h-[600px] w-full max-w-[390px] overflow-hidden border border-field-edge [contain:layout_paint]"
|
|
25
|
+
>
|
|
26
|
+
<div role="region" aria-label={label} className="h-full overflow-y-auto px-5 pt-8">
|
|
27
|
+
{children}
|
|
28
|
+
</div>
|
|
29
|
+
</div>
|
|
30
|
+
);
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
const photos = [
|
|
34
|
+
{ name: "Harbour at dawn", meta: "IMG_2041 · 4.2 MB" },
|
|
35
|
+
{ name: "Market in Ribeira", meta: "IMG_2057 · 3.8 MB" },
|
|
36
|
+
{ name: "Tram 28", meta: "IMG_2063 · 5.1 MB" },
|
|
37
|
+
];
|
|
38
|
+
|
|
39
|
+
export function Basic() {
|
|
40
|
+
const screen = React.useRef<HTMLDivElement>(null);
|
|
41
|
+
const [done, setDone] = React.useState("");
|
|
42
|
+
const toast = (words: string) => setDone(words);
|
|
43
|
+
return (
|
|
44
|
+
<Phone label="Photos screen" screen={screen}>
|
|
45
|
+
<Eyebrow>Album</Eyebrow>
|
|
46
|
+
<Heading level={3} className="mt-2">
|
|
47
|
+
Porto, October
|
|
48
|
+
</Heading>
|
|
49
|
+
<ul className="mt-6">
|
|
50
|
+
{photos.map((photo) => (
|
|
51
|
+
<li
|
|
52
|
+
key={photo.name}
|
|
53
|
+
className="flex items-center justify-between gap-3 border-t border-border/60 py-3 last:border-b"
|
|
54
|
+
>
|
|
55
|
+
<div className="min-w-0">
|
|
56
|
+
<p className="truncate text-15">{photo.name}</p>
|
|
57
|
+
<p className="mt-0.5 font-mono text-11 text-muted-foreground">{photo.meta}</p>
|
|
58
|
+
</div>
|
|
59
|
+
<ActionSheet presentation="sheet">
|
|
60
|
+
<ActionSheetTrigger
|
|
61
|
+
render={<Button variant="ghost" size="icon-sm" aria-label={`Options for ${photo.name}`} />}
|
|
62
|
+
>
|
|
63
|
+
<EllipsisIcon />
|
|
64
|
+
</ActionSheetTrigger>
|
|
65
|
+
<ActionSheetContent
|
|
66
|
+
portal={{ container: screen }}
|
|
67
|
+
title={photo.name}
|
|
68
|
+
description="Deleted photos stay in Recently deleted for 30 days."
|
|
69
|
+
>
|
|
70
|
+
<ActionSheetAction onClick={() => toast("Link copied")}>Share link</ActionSheetAction>
|
|
71
|
+
<ActionSheetAction onClick={() => toast("Duplicated")}>Duplicate</ActionSheetAction>
|
|
72
|
+
<ActionSheetAction onClick={() => toast("Moved to Favourites")}>
|
|
73
|
+
Move to Favourites
|
|
74
|
+
</ActionSheetAction>
|
|
75
|
+
<ActionSheetAction variant="destructive" onClick={() => toast("Photo deleted")}>
|
|
76
|
+
Delete photo
|
|
77
|
+
</ActionSheetAction>
|
|
78
|
+
</ActionSheetContent>
|
|
79
|
+
</ActionSheet>
|
|
80
|
+
</li>
|
|
81
|
+
))}
|
|
82
|
+
</ul>
|
|
83
|
+
<p className="mt-4 text-13 text-muted-foreground" aria-live="polite">
|
|
84
|
+
{done}
|
|
85
|
+
</p>
|
|
86
|
+
</Phone>
|
|
87
|
+
);
|
|
88
|
+
}
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
The choices for one thing — a photo, a message, a file — rising from the bottom of a phone screen where the thumb already is. A 20px card in the menu material holds an optional title and one sentence about what happens, then the actions, each a full-width 46px row with its label centred; apart from it, a second card holds Cancel. It sits 8px in from the screen's edges and above the home indicator.
|
|
92
|
+
|
|
93
|
+
The choices run edge to edge across their card, nothing inset: a choice's highlight fills the card's width, square where two choices meet and following the card's 20px corners at its top and bottom. The Cancel card is the button itself, so its highlight and its focus ring are the card's own shape. A choice lights up under the finger the moment it lands, a shade of its own ink (the destructive one deepens its red), and its card gives a little, to 98.5%, springing back when let go; Cancel does the same. Under reduced motion only the shade shows.
|
|
94
|
+
|
|
95
|
+
It is a Base UI Drawer underneath: it slides up over 300ms, follows the finger 1:1 when swiped down and closes past a flick, and the backdrop lightens as it goes. Escape, a tap on the backdrop, Cancel or any action closes it, and focus goes back to what opened it.
|
|
96
|
+
|
|
97
|
+
**On a desktop it is a dialog.** `presentation="auto"` (the default) shows the sheet on a phone — a coarse pointer under 768px — and the same two cards as a small centred dialog everywhere else. A sheet stuck to the bottom of a wide window is far from the pointer that opened it. A `Menu` was the other candidate; it was not chosen because a menu is anchored to its trigger and reads its items as menu items with arrow-key focus only, while an action sheet's title and message must be read, and the same content and focus order should hold in both forms.
|
|
98
|
+
|
|
99
|
+
## When to use
|
|
100
|
+
|
|
101
|
+
- Two to six actions on one thing, on a phone, where the thing's own screen has no room for them: Share, Duplicate, Move, Delete.
|
|
102
|
+
- Confirming a destructive action that has a gentler alternative ("Pause until January" or "Leave the course").
|
|
103
|
+
- A pointer on a desktop, near the trigger: a `Menu`. A yes-or-no confirmation with nothing else: an `AlertDialog`.
|
|
104
|
+
- Anything to fill in or read at length: a `Drawer`.
|
|
105
|
+
|
|
106
|
+
## Usage
|
|
107
|
+
|
|
108
|
+
```tsx
|
|
109
|
+
import { ActionSheet, ActionSheetAction, ActionSheetContent, ActionSheetTrigger, Button } from "@zonsh/ui";
|
|
110
|
+
|
|
111
|
+
<ActionSheet>
|
|
112
|
+
<ActionSheetTrigger render={<Button variant="secondary" />}>Manage file</ActionSheetTrigger>
|
|
113
|
+
<ActionSheetContent title="quarterly-plan.pdf">
|
|
114
|
+
<ActionSheetAction onClick={share}>Share</ActionSheetAction>
|
|
115
|
+
<ActionSheetAction onClick={duplicate}>Make a copy</ActionSheetAction>
|
|
116
|
+
<ActionSheetAction variant="destructive" onClick={remove}>
|
|
117
|
+
Delete
|
|
118
|
+
</ActionSheetAction>
|
|
119
|
+
</ActionSheetContent>
|
|
120
|
+
</ActionSheet>;
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
An action closes the sheet after its `onClick`; call `event.preventDefault()` there to keep it open. Cancel is added for you.
|
|
124
|
+
|
|
125
|
+
## Examples
|
|
126
|
+
|
|
127
|
+
### Auto
|
|
128
|
+
|
|
129
|
+
A sheet on a phone, a small dialog here. Icons go before every label or none.
|
|
130
|
+
|
|
131
|
+
```tsx
|
|
132
|
+
import { ActionSheet, ActionSheetAction, ActionSheetContent, ActionSheetTrigger, Button } from "@zonsh/ui";
|
|
133
|
+
import { CopyIcon, FolderInputIcon, ShareIcon, Trash2Icon } from "lucide-react";
|
|
134
|
+
import * as React from "react";
|
|
135
|
+
|
|
136
|
+
export function Auto() {
|
|
137
|
+
const [done, setDone] = React.useState("");
|
|
138
|
+
const toast = (words: string) => setDone(words);
|
|
139
|
+
return (
|
|
140
|
+
<div className="flex flex-col items-start gap-3">
|
|
141
|
+
<ActionSheet>
|
|
142
|
+
<ActionSheetTrigger render={<Button variant="secondary" />}>Manage file</ActionSheetTrigger>
|
|
143
|
+
<ActionSheetContent title="quarterly-plan.pdf">
|
|
144
|
+
<ActionSheetAction icon={<ShareIcon />} onClick={() => toast("Share sheet opened")}>
|
|
145
|
+
Share
|
|
146
|
+
</ActionSheetAction>
|
|
147
|
+
<ActionSheetAction icon={<CopyIcon />} onClick={() => toast("Copy made")}>
|
|
148
|
+
Make a copy
|
|
149
|
+
</ActionSheetAction>
|
|
150
|
+
<ActionSheetAction icon={<FolderInputIcon />} onClick={() => toast("Moved to Archive")}>
|
|
151
|
+
Move to Archive
|
|
152
|
+
</ActionSheetAction>
|
|
153
|
+
<ActionSheetAction variant="destructive" icon={<Trash2Icon />} onClick={() => toast("File deleted")}>
|
|
154
|
+
Delete
|
|
155
|
+
</ActionSheetAction>
|
|
156
|
+
</ActionSheetContent>
|
|
157
|
+
</ActionSheet>
|
|
158
|
+
<p className="text-13 text-muted-foreground" aria-live="polite">
|
|
159
|
+
{done}
|
|
160
|
+
</p>
|
|
161
|
+
</div>
|
|
162
|
+
);
|
|
163
|
+
}
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
### Controlled
|
|
167
|
+
|
|
168
|
+
`open` and `onOpenChange` open it from anywhere — after a swipe, a long press, or as here, a plain button.
|
|
169
|
+
|
|
170
|
+
```tsx
|
|
171
|
+
import { ActionSheet, ActionSheetAction, ActionSheetContent, Button } from "@zonsh/ui";
|
|
172
|
+
import * as React from "react";
|
|
173
|
+
|
|
174
|
+
export function Controlled() {
|
|
175
|
+
const [open, setOpen] = React.useState(false);
|
|
176
|
+
const [choice, setChoice] = React.useState("Nothing chosen yet.");
|
|
177
|
+
return (
|
|
178
|
+
<div className="flex flex-col items-start gap-3">
|
|
179
|
+
<Button variant="secondary" onClick={() => setOpen(true)}>
|
|
180
|
+
Leave the course
|
|
181
|
+
</Button>
|
|
182
|
+
<p className="text-13 text-muted-foreground" aria-live="polite">
|
|
183
|
+
{choice}
|
|
184
|
+
</p>
|
|
185
|
+
<ActionSheet open={open} onOpenChange={setOpen}>
|
|
186
|
+
<ActionSheetContent
|
|
187
|
+
title="Leave Watercolour basics?"
|
|
188
|
+
description="Your sketches stay in your library; your place in the class goes to the waiting list."
|
|
189
|
+
>
|
|
190
|
+
<ActionSheetAction onClick={() => setChoice("Paused until January.")}>
|
|
191
|
+
Pause until January
|
|
192
|
+
</ActionSheetAction>
|
|
193
|
+
<ActionSheetAction variant="destructive" onClick={() => setChoice("You left the course.")}>
|
|
194
|
+
Leave the course
|
|
195
|
+
</ActionSheetAction>
|
|
196
|
+
</ActionSheetContent>
|
|
197
|
+
</ActionSheet>
|
|
198
|
+
</div>
|
|
199
|
+
);
|
|
200
|
+
}
|
|
201
|
+
```
|
|
202
|
+
|
|
203
|
+
### Inside a preview
|
|
204
|
+
|
|
205
|
+
A sheet's backdrop and viewport are fixed to the screen. In a phone-sized preview, render it into the preview with `portal={{ container }}` and give the preview `contain: layout paint`, so the sheet fills the preview instead of the window — as the first example does.
|
|
206
|
+
|
|
207
|
+
## Props
|
|
208
|
+
|
|
209
|
+
### ActionSheet
|
|
210
|
+
|
|
211
|
+
| Prop | Type | Default | Notes |
|
|
212
|
+
| ---------------------- | ------------------------------- | -------- | ----------------------------------------------------------------- |
|
|
213
|
+
| `open` | `boolean` | — | Controlled. |
|
|
214
|
+
| `defaultOpen` | `boolean` | `false` | Uncontrolled. |
|
|
215
|
+
| `onOpenChange` | `(open, eventDetails?) => void` | — | Opening and closing, by any means. |
|
|
216
|
+
| `onOpenChangeComplete` | `(open: boolean) => void` | — | After the motion has finished. |
|
|
217
|
+
| `presentation` | `"auto" \| "sheet" \| "dialog"` | `"auto"` | A sheet on a phone and a dialog elsewhere, or always one of them. |
|
|
218
|
+
| `children` | `ReactNode` | — | The trigger and the content. |
|
|
219
|
+
|
|
220
|
+
### ActionSheetContent
|
|
221
|
+
|
|
222
|
+
| Prop | Type | Default | Notes |
|
|
223
|
+
| ------------- | ------------------------------ | ------- | ---------------------------------------------------------------------------------- |
|
|
224
|
+
| `title` | `ReactNode` | — | What the actions act on, one short line. The sheet's name. |
|
|
225
|
+
| `description` | `ReactNode` | — | One sentence on what happens. |
|
|
226
|
+
| `cancel` | `boolean` | `true` | The separate Cancel card. |
|
|
227
|
+
| `labels` | `Partial<ActionSheetMessages>` | — | `cancel` ("Cancel"), and `actions` ("Actions"), the name without a title. |
|
|
228
|
+
| `portal` | `{ container?, keepMounted? }` | — | Where it renders: a preview's element, say. |
|
|
229
|
+
| `dir` | `string` | — | The popup's direction; inside a right-to-left `DirectionProvider` it follows that. |
|
|
230
|
+
|
|
231
|
+
### ActionSheetAction
|
|
232
|
+
|
|
233
|
+
| Prop | Type | Default | Notes |
|
|
234
|
+
| -------------- | ---------------------------- | ----------- | ----------------------------------------------------- |
|
|
235
|
+
| `variant` | `"default" \| "destructive"` | `"default"` | The destructive ink, for the one action that deletes. |
|
|
236
|
+
| `icon` | `ReactNode` | — | A lucide icon before the label. |
|
|
237
|
+
| `closeOnClick` | `boolean` | `true` | Closes the sheet after `onClick`. |
|
|
238
|
+
|
|
239
|
+
Every other prop goes to the `<button>`. `ActionSheetTrigger` takes Base UI's trigger props, `render` among them.
|
|
240
|
+
|
|
241
|
+
## Brand rules
|
|
242
|
+
|
|
243
|
+
- **Do** name each action by what it does to the thing ("Delete photo", "Move to Favourites"), with at most one destructive, last before Cancel.
|
|
244
|
+
- **Do** keep the title to what the sheet is about and the message to one sentence; no headline, no icon in the header.
|
|
245
|
+
- **Don't** put a primary button in a sheet, colour a row, or add a fill: the menu material and the destructive ink are the only marks.
|
|
246
|
+
- **Don't** reach for it for more than six actions, or for settings: that is a screen of its own or a `Drawer`.
|
|
247
|
+
|
|
248
|
+
## Accessibility
|
|
249
|
+
|
|
250
|
+
- A modal dialog named by its `title` (or "Actions"), described by its `description`. Focus moves to the first action when it opens, stays inside while it is open, and returns to the trigger when it closes.
|
|
251
|
+
- Actions are buttons in reading order; the destructive one says what it destroys in words, not only in red.
|
|
252
|
+
- Swiping down is never the only way out: Cancel, Escape and the backdrop close it too.
|
|
253
|
+
- Under reduced motion the sheet and the dialog fade in place instead of travelling.
|
|
254
|
+
|
|
255
|
+
### Keyboard
|
|
256
|
+
|
|
257
|
+
| Key | What it does |
|
|
258
|
+
| --------------- | ----------------------------------------------- |
|
|
259
|
+
| Enter / Space | On the trigger, opens it; on an action, runs it |
|
|
260
|
+
| Tab / Shift+Tab | Moves through the actions and Cancel, inside it |
|
|
261
|
+
| Arrow Down / Up | Moves to the next or previous action, wrapping |
|
|
262
|
+
| Escape | Closes it without choosing |
|
|
263
|
+
|
|
264
|
+
---
|
|
265
|
+
|
|
266
|
+
- Import: `import { ActionSheet, ActionSheetTrigger, ActionSheetContent, ActionSheetAction } from "@zonsh/ui"`
|
|
267
|
+
- Source: `packages/ui/src/components/action-sheet.tsx`
|
|
268
|
+
- Primitive: `@base-ui/react/drawer` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/drawer.md`)
|
|
@@ -0,0 +1,276 @@
|
|
|
1
|
+
# Alert Dialog
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { AlertDialog, AlertDialogClose, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, AlertDialogTrigger, Button } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
export function Destructive() {
|
|
7
|
+
return (
|
|
8
|
+
<AlertDialog>
|
|
9
|
+
<AlertDialogTrigger render={<Button variant="destructive" />}>Remove integration</AlertDialogTrigger>
|
|
10
|
+
<AlertDialogContent>
|
|
11
|
+
<AlertDialogHeader>
|
|
12
|
+
<AlertDialogTitle>Remove this integration?</AlertDialogTitle>
|
|
13
|
+
<AlertDialogDescription>
|
|
14
|
+
Events will stop syncing from your calendar. Events already imported stay where they are.
|
|
15
|
+
</AlertDialogDescription>
|
|
16
|
+
</AlertDialogHeader>
|
|
17
|
+
<AlertDialogFooter>
|
|
18
|
+
<AlertDialogClose render={<Button variant="secondary" />}>Keep it</AlertDialogClose>
|
|
19
|
+
<AlertDialogClose render={<Button variant="destructive" />}>Remove integration</AlertDialogClose>
|
|
20
|
+
</AlertDialogFooter>
|
|
21
|
+
</AlertDialogContent>
|
|
22
|
+
</AlertDialog>
|
|
23
|
+
);
|
|
24
|
+
}
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
A `Dialog` for a decision someone must make before going on. It is announced as an alert, ignores outside clicks and has no close button: the footer holds the two answers.
|
|
28
|
+
|
|
29
|
+
## Usage
|
|
30
|
+
|
|
31
|
+
```tsx
|
|
32
|
+
import {
|
|
33
|
+
AlertDialog,
|
|
34
|
+
AlertDialogClose,
|
|
35
|
+
AlertDialogContent,
|
|
36
|
+
AlertDialogDescription,
|
|
37
|
+
AlertDialogFooter,
|
|
38
|
+
AlertDialogHeader,
|
|
39
|
+
AlertDialogTitle,
|
|
40
|
+
AlertDialogTrigger,
|
|
41
|
+
Button,
|
|
42
|
+
} from "@zonsh/ui";
|
|
43
|
+
|
|
44
|
+
<AlertDialog>
|
|
45
|
+
<AlertDialogTrigger render={<Button variant="destructive" />}>Remove integration</AlertDialogTrigger>
|
|
46
|
+
<AlertDialogContent>
|
|
47
|
+
<AlertDialogHeader>
|
|
48
|
+
<AlertDialogTitle>Remove this integration?</AlertDialogTitle>
|
|
49
|
+
<AlertDialogDescription>Events will stop syncing.</AlertDialogDescription>
|
|
50
|
+
</AlertDialogHeader>
|
|
51
|
+
<AlertDialogFooter>
|
|
52
|
+
<AlertDialogClose render={<Button variant="secondary" />}>Keep it</AlertDialogClose>
|
|
53
|
+
<AlertDialogClose render={<Button variant="destructive" />} onClick={remove}>
|
|
54
|
+
Remove integration
|
|
55
|
+
</AlertDialogClose>
|
|
56
|
+
</AlertDialogFooter>
|
|
57
|
+
</AlertDialogContent>
|
|
58
|
+
</AlertDialog>;
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
The props you'll reach for: `open` / `onOpenChange` on `AlertDialog`, `render` on `AlertDialogClose`, `size` on `AlertDialogContent`.
|
|
62
|
+
|
|
63
|
+
## When to use
|
|
64
|
+
|
|
65
|
+
- Confirming what cannot be undone: "Remove this integration?", "Delete workspace?".
|
|
66
|
+
- Leaving with unsaved work: "Save your changes first?".
|
|
67
|
+
- Not for information (a toast or inline message) or tasks with fields (`Dialog`).
|
|
68
|
+
|
|
69
|
+
## Examples
|
|
70
|
+
|
|
71
|
+
### Unsaved changes
|
|
72
|
+
|
|
73
|
+
Control `open` when the confirm does work before closing.
|
|
74
|
+
|
|
75
|
+
```tsx
|
|
76
|
+
import { AlertDialog, AlertDialogClose, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, AlertDialogTrigger, Button } from "@zonsh/ui";
|
|
77
|
+
import * as React from "react";
|
|
78
|
+
|
|
79
|
+
export function UnsavedChanges() {
|
|
80
|
+
const [open, setOpen] = React.useState(false);
|
|
81
|
+
const [saved, setSaved] = React.useState(false);
|
|
82
|
+
return (
|
|
83
|
+
<div className="flex items-center gap-4">
|
|
84
|
+
<AlertDialog open={open} onOpenChange={setOpen}>
|
|
85
|
+
<AlertDialogTrigger render={<Button variant="secondary" />}>Leave editor</AlertDialogTrigger>
|
|
86
|
+
<AlertDialogContent>
|
|
87
|
+
<AlertDialogHeader>
|
|
88
|
+
<AlertDialogTitle>Save your changes first?</AlertDialogTitle>
|
|
89
|
+
<AlertDialogDescription>
|
|
90
|
+
You edited the chapter draft. If you leave now, those edits are lost.
|
|
91
|
+
</AlertDialogDescription>
|
|
92
|
+
</AlertDialogHeader>
|
|
93
|
+
<AlertDialogFooter>
|
|
94
|
+
<AlertDialogClose render={<Button variant="secondary" />}>Discard edits</AlertDialogClose>
|
|
95
|
+
<Button
|
|
96
|
+
onClick={() => {
|
|
97
|
+
setSaved(true);
|
|
98
|
+
setOpen(false);
|
|
99
|
+
}}
|
|
100
|
+
>
|
|
101
|
+
Save and leave
|
|
102
|
+
</Button>
|
|
103
|
+
</AlertDialogFooter>
|
|
104
|
+
</AlertDialogContent>
|
|
105
|
+
</AlertDialog>
|
|
106
|
+
{saved && <span className="text-sm text-muted-foreground">Your changes are saved.</span>}
|
|
107
|
+
</div>
|
|
108
|
+
);
|
|
109
|
+
}
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
### Pending confirm
|
|
113
|
+
|
|
114
|
+
When the confirm can fail, keep the dialog open until it settles: the confirm takes `loading`, the other choice is disabled and Escape waits. On failure, say what to do in a `role="alert"` line and keep both choices; close only on success.
|
|
115
|
+
|
|
116
|
+
```tsx
|
|
117
|
+
import { AlertDialog, AlertDialogClose, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, AlertDialogTrigger, Button } from "@zonsh/ui";
|
|
118
|
+
import { CircleAlertIcon } from "lucide-react";
|
|
119
|
+
import * as React from "react";
|
|
120
|
+
|
|
121
|
+
const DELETE_LATENCY = 800;
|
|
122
|
+
|
|
123
|
+
/**
|
|
124
|
+
* The confirm does work before it closes: it shows a spinner, the dialog holds while it runs, and a
|
|
125
|
+
* failure is said in the dialog, which stays open so the person can try again or keep the page.
|
|
126
|
+
* Here the first attempt fails and the second goes through.
|
|
127
|
+
*/
|
|
128
|
+
export function Pending() {
|
|
129
|
+
const [open, setOpen] = React.useState(false);
|
|
130
|
+
const [pending, setPending] = React.useState(false);
|
|
131
|
+
const [error, setError] = React.useState<string | null>(null);
|
|
132
|
+
const [deleted, setDeleted] = React.useState(false);
|
|
133
|
+
const attempts = React.useRef(0);
|
|
134
|
+
const timer = React.useRef<ReturnType<typeof setTimeout>>(undefined);
|
|
135
|
+
React.useEffect(() => () => clearTimeout(timer.current), []);
|
|
136
|
+
|
|
137
|
+
const remove = () => {
|
|
138
|
+
setPending(true);
|
|
139
|
+
setError(null);
|
|
140
|
+
timer.current = setTimeout(() => {
|
|
141
|
+
setPending(false);
|
|
142
|
+
attempts.current += 1;
|
|
143
|
+
if (attempts.current === 1) {
|
|
144
|
+
setError("The page couldn't be deleted: the connection dropped. Try again.");
|
|
145
|
+
return;
|
|
146
|
+
}
|
|
147
|
+
setOpen(false);
|
|
148
|
+
setDeleted(true);
|
|
149
|
+
}, DELETE_LATENCY);
|
|
150
|
+
};
|
|
151
|
+
|
|
152
|
+
return (
|
|
153
|
+
<div className="flex items-center gap-4">
|
|
154
|
+
<AlertDialog
|
|
155
|
+
open={open}
|
|
156
|
+
onOpenChange={(next) => {
|
|
157
|
+
// While the delete runs, Escape does not close the dialog: its answer is still to come.
|
|
158
|
+
if (pending) return;
|
|
159
|
+
setOpen(next);
|
|
160
|
+
if (next) setError(null);
|
|
161
|
+
}}
|
|
162
|
+
>
|
|
163
|
+
<AlertDialogTrigger render={<Button variant="destructive" />}>Delete page</AlertDialogTrigger>
|
|
164
|
+
<AlertDialogContent>
|
|
165
|
+
<AlertDialogHeader>
|
|
166
|
+
<AlertDialogTitle>Delete “Spring catalogue”?</AlertDialogTitle>
|
|
167
|
+
<AlertDialogDescription>
|
|
168
|
+
The page and its 14 product cards are deleted for everyone. The products themselves stay in the
|
|
169
|
+
shop.
|
|
170
|
+
</AlertDialogDescription>
|
|
171
|
+
</AlertDialogHeader>
|
|
172
|
+
{error && (
|
|
173
|
+
<p role="alert" className="m-0 flex items-start gap-2 text-sm text-destructive">
|
|
174
|
+
<CircleAlertIcon aria-hidden className="mt-0.5 size-4 shrink-0" />
|
|
175
|
+
{error}
|
|
176
|
+
</p>
|
|
177
|
+
)}
|
|
178
|
+
<AlertDialogFooter>
|
|
179
|
+
<AlertDialogClose render={<Button variant="secondary" />} disabled={pending}>
|
|
180
|
+
Keep page
|
|
181
|
+
</AlertDialogClose>
|
|
182
|
+
<Button variant="destructive" loading={pending} loadingLabel="Deleting page" onClick={remove}>
|
|
183
|
+
Delete page
|
|
184
|
+
</Button>
|
|
185
|
+
</AlertDialogFooter>
|
|
186
|
+
</AlertDialogContent>
|
|
187
|
+
</AlertDialog>
|
|
188
|
+
{deleted && (
|
|
189
|
+
<span role="status" className="text-sm text-muted-foreground">
|
|
190
|
+
“Spring catalogue” is deleted.
|
|
191
|
+
</span>
|
|
192
|
+
)}
|
|
193
|
+
</div>
|
|
194
|
+
);
|
|
195
|
+
}
|
|
196
|
+
```
|
|
197
|
+
|
|
198
|
+
### Sizes
|
|
199
|
+
|
|
200
|
+
`sm` fits most questions; `lg` and `xl` show what a confirmation affects. On mobile every size is full width minus a 16px gutter.
|
|
201
|
+
|
|
202
|
+
```tsx
|
|
203
|
+
import { AlertDialog, AlertDialogClose, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, AlertDialogTrigger, Button } from "@zonsh/ui";
|
|
204
|
+
|
|
205
|
+
const alertSizes = [
|
|
206
|
+
{ size: "sm", width: "416px" },
|
|
207
|
+
{ size: "default", width: "512px" },
|
|
208
|
+
{ size: "lg", width: "704px" },
|
|
209
|
+
{ size: "xl", width: "896px" },
|
|
210
|
+
] as const;
|
|
211
|
+
|
|
212
|
+
export function Sizes() {
|
|
213
|
+
return (
|
|
214
|
+
<div className="flex flex-wrap gap-3">
|
|
215
|
+
{alertSizes.map(({ size, width }) => (
|
|
216
|
+
<AlertDialog key={size}>
|
|
217
|
+
<AlertDialogTrigger render={<Button variant="secondary" />}>{size}</AlertDialogTrigger>
|
|
218
|
+
<AlertDialogContent size={size}>
|
|
219
|
+
<AlertDialogHeader>
|
|
220
|
+
<AlertDialogTitle>Archive this project?</AlertDialogTitle>
|
|
221
|
+
<AlertDialogDescription>
|
|
222
|
+
Its pages, notes and files move to the archive and stay readable. This dialog uses size "
|
|
223
|
+
{size}" ({width}).
|
|
224
|
+
</AlertDialogDescription>
|
|
225
|
+
</AlertDialogHeader>
|
|
226
|
+
<AlertDialogFooter>
|
|
227
|
+
<AlertDialogClose render={<Button variant="secondary" />}>Keep it</AlertDialogClose>
|
|
228
|
+
<AlertDialogClose render={<Button />}>Archive project</AlertDialogClose>
|
|
229
|
+
</AlertDialogFooter>
|
|
230
|
+
</AlertDialogContent>
|
|
231
|
+
</AlertDialog>
|
|
232
|
+
))}
|
|
233
|
+
</div>
|
|
234
|
+
);
|
|
235
|
+
}
|
|
236
|
+
```
|
|
237
|
+
|
|
238
|
+
## Props
|
|
239
|
+
|
|
240
|
+
| Prop | Type | Default |
|
|
241
|
+
| ---------------------------------- | ------------------------------------------------------------- | ------- |
|
|
242
|
+
| `AlertDialog.open` / `defaultOpen` | `boolean` | — |
|
|
243
|
+
| `AlertDialog.onOpenChange` | `(open, details) => void` | — |
|
|
244
|
+
| `AlertDialogContent.size` | `"sm" \| "default" \| "lg" \| "xl"` (416 / 512 / 704 / 896px) | `"sm"` |
|
|
245
|
+
| `AlertDialogContent.portal` | `AlertDialog.Portal` props | — |
|
|
246
|
+
| `AlertDialogClose.render` | element, e.g. `<Button variant="secondary" />` | — |
|
|
247
|
+
|
|
248
|
+
`AlertDialog` is Base UI `AlertDialog.Root`; its props are forwarded. `AlertDialogContent` renders Portal → Backdrop → Viewport → Popup with `role="alertdialog"`.
|
|
249
|
+
|
|
250
|
+
## Brand rules
|
|
251
|
+
|
|
252
|
+
- **Do** phrase the title as the question, and name the action in the button: "Remove integration", never "OK" or "Yes".
|
|
253
|
+
- **Do** say concretely what is lost and what is kept.
|
|
254
|
+
- **Do** use `destructive` only when something is really destroyed; red is a status colour, never emphasis.
|
|
255
|
+
- **Don't** add icons, illustrations or a coloured header for urgency. The interruption is the urgency.
|
|
256
|
+
- **Don't** stack an alert dialog on a toast; if it needs confirming, it isn't a toast.
|
|
257
|
+
|
|
258
|
+
## Accessibility
|
|
259
|
+
|
|
260
|
+
- `role="alertdialog"`, labelled by `AlertDialogTitle` and described by `AlertDialogDescription`.
|
|
261
|
+
- Focus moves to the first button (the safe choice — put cancel first in the markup) and is trapped.
|
|
262
|
+
- Outside presses do not dismiss it, so a stray tap cannot answer the question.
|
|
263
|
+
|
|
264
|
+
### Keyboard
|
|
265
|
+
|
|
266
|
+
| Key | What it does |
|
|
267
|
+
| --------------- | -------------------------------------------------------------------- |
|
|
268
|
+
| Enter / Space | Opens the dialog from its trigger, or presses the focused button |
|
|
269
|
+
| Tab / Shift+Tab | Moves between the two choices; focus stays inside the dialog |
|
|
270
|
+
| Escape | Closes the dialog without an answer and returns focus to the trigger |
|
|
271
|
+
|
|
272
|
+
---
|
|
273
|
+
|
|
274
|
+
- Import: `import { AlertDialog, AlertDialogTrigger, AlertDialogContent, AlertDialogHeader, AlertDialogTitle, AlertDialogDescription, AlertDialogFooter, AlertDialogClose } from "@zonsh/ui"`
|
|
275
|
+
- Source: `packages/ui/src/components/alert-dialog.tsx`
|
|
276
|
+
- Primitive: `@base-ui/react/alert-dialog` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/alert-dialog.md`)
|