@zonsh/ui 0.5.0 → 0.6.0
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 +639 -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,220 @@
|
|
|
1
|
+
# Toast
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Button, Toaster, toast } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
export function Types() {
|
|
7
|
+
return (
|
|
8
|
+
<div className="flex flex-wrap gap-3">
|
|
9
|
+
<Toaster />
|
|
10
|
+
<Button
|
|
11
|
+
variant="secondary"
|
|
12
|
+
onClick={() => toast("Draft created", { description: "Find it under Projects → Drafts." })}
|
|
13
|
+
>
|
|
14
|
+
Default
|
|
15
|
+
</Button>
|
|
16
|
+
<Button variant="secondary" onClick={() => toast.success("Your changes are saved.")}>
|
|
17
|
+
Success
|
|
18
|
+
</Button>
|
|
19
|
+
<Button
|
|
20
|
+
variant="secondary"
|
|
21
|
+
onClick={() =>
|
|
22
|
+
toast.warning("Album saved, but 2 photos were skipped.", {
|
|
23
|
+
description: "They are larger than 50 MB.",
|
|
24
|
+
})
|
|
25
|
+
}
|
|
26
|
+
>
|
|
27
|
+
Warning
|
|
28
|
+
</Button>
|
|
29
|
+
<Button variant="secondary" onClick={() => toast.info("A new version is available.")}>
|
|
30
|
+
Info
|
|
31
|
+
</Button>
|
|
32
|
+
<Button
|
|
33
|
+
variant="secondary"
|
|
34
|
+
onClick={() =>
|
|
35
|
+
toast.error("We couldn't send your message.", {
|
|
36
|
+
description: "Check your connection and try again.",
|
|
37
|
+
})
|
|
38
|
+
}
|
|
39
|
+
>
|
|
40
|
+
Error
|
|
41
|
+
</Button>
|
|
42
|
+
<Button
|
|
43
|
+
variant="secondary"
|
|
44
|
+
onClick={() => {
|
|
45
|
+
const id = toast.loading("Syncing your library…");
|
|
46
|
+
setTimeout(() => toast.update(id, { type: "success", title: "Your library is up to date." }), 1800);
|
|
47
|
+
}}
|
|
48
|
+
>
|
|
49
|
+
Loading
|
|
50
|
+
</Button>
|
|
51
|
+
</div>
|
|
52
|
+
);
|
|
53
|
+
}
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
A brief message about something that just happened. Toasts stack bottom-right (full width on mobile), expand on hover or focus, and swipe away. Every type is neutral `material-menu` at 12px; status is the icon alone, in `--success`, `--warning`, `--info` or `--destructive`. `loading` has a spinner and stays until updated.
|
|
57
|
+
|
|
58
|
+
## Usage
|
|
59
|
+
|
|
60
|
+
Mount one `Toaster` near the root; call `toast` from anywhere, even outside React.
|
|
61
|
+
|
|
62
|
+
```tsx
|
|
63
|
+
import { Toaster, toast } from "@zonsh/ui";
|
|
64
|
+
|
|
65
|
+
<Toaster />;
|
|
66
|
+
|
|
67
|
+
toast.success("Your changes are saved.");
|
|
68
|
+
toast.error("We couldn't send your message.", { description: "Check your connection and try again." });
|
|
69
|
+
toast("Photo deleted", { action: { label: "Undo", onClick: restore } });
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
- `description` — a second line: what to do next.
|
|
73
|
+
- `action` — one button, usually "Undo".
|
|
74
|
+
- `timeout` — ms open; `0` keeps it.
|
|
75
|
+
|
|
76
|
+
## When to use
|
|
77
|
+
|
|
78
|
+
- Confirming an action (saved, sent, removed with "Undo") or background work finishing or failing.
|
|
79
|
+
- Not for a decision (`AlertDialog`) or anything that must stay visible.
|
|
80
|
+
|
|
81
|
+
## Examples
|
|
82
|
+
|
|
83
|
+
### With action
|
|
84
|
+
|
|
85
|
+
```tsx
|
|
86
|
+
import { Button, Toaster, toast } from "@zonsh/ui";
|
|
87
|
+
|
|
88
|
+
export function WithAction() {
|
|
89
|
+
return (
|
|
90
|
+
<>
|
|
91
|
+
<Toaster />
|
|
92
|
+
<Button
|
|
93
|
+
variant="secondary"
|
|
94
|
+
onClick={() =>
|
|
95
|
+
toast("Calendar disconnected", {
|
|
96
|
+
description: "New events no longer appear in your planner.",
|
|
97
|
+
action: { label: "Undo", onClick: () => toast.success("Calendar connected again.") },
|
|
98
|
+
})
|
|
99
|
+
}
|
|
100
|
+
>
|
|
101
|
+
Disconnect calendar
|
|
102
|
+
</Button>
|
|
103
|
+
</>
|
|
104
|
+
);
|
|
105
|
+
}
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
### Promise toast
|
|
109
|
+
|
|
110
|
+
One toast from loading to success or error.
|
|
111
|
+
|
|
112
|
+
```tsx
|
|
113
|
+
import { Button, Toaster, toast } from "@zonsh/ui";
|
|
114
|
+
|
|
115
|
+
function sendMessage() {
|
|
116
|
+
return new Promise<string>((resolve, reject) =>
|
|
117
|
+
setTimeout(() => (Math.random() > 0.3 ? resolve("Your message") : reject(new Error("timeout"))), 1500),
|
|
118
|
+
);
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
export function PromiseToast() {
|
|
122
|
+
return (
|
|
123
|
+
<>
|
|
124
|
+
<Toaster />
|
|
125
|
+
<Button
|
|
126
|
+
variant="secondary"
|
|
127
|
+
onClick={() =>
|
|
128
|
+
toast
|
|
129
|
+
.promise(sendMessage(), {
|
|
130
|
+
loading: { title: "Sending your message…" },
|
|
131
|
+
success: (name) => ({
|
|
132
|
+
title: `${name} is sent.`,
|
|
133
|
+
description: "You'll find the reply in your inbox.",
|
|
134
|
+
}),
|
|
135
|
+
error: {
|
|
136
|
+
title: "We couldn't send your message.",
|
|
137
|
+
description: "Nothing was lost. Try again in a moment.",
|
|
138
|
+
},
|
|
139
|
+
})
|
|
140
|
+
.catch(() => {})
|
|
141
|
+
}
|
|
142
|
+
>
|
|
143
|
+
Send message
|
|
144
|
+
</Button>
|
|
145
|
+
</>
|
|
146
|
+
);
|
|
147
|
+
}
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
### Hook
|
|
151
|
+
|
|
152
|
+
`useToast()`: the API bound to the nearest `Toaster` (your tree as its children), plus the live `toasts`; outside one, the global `toast`.
|
|
153
|
+
|
|
154
|
+
```tsx
|
|
155
|
+
import { Button, Toaster, useToast } from "@zonsh/ui";
|
|
156
|
+
|
|
157
|
+
function SaveButton() {
|
|
158
|
+
const notify = useToast();
|
|
159
|
+
return (
|
|
160
|
+
<Button variant="secondary" onClick={() => notify.success("Your changes are saved.")}>
|
|
161
|
+
Save ({notify.toasts.length} open)
|
|
162
|
+
</Button>
|
|
163
|
+
);
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
export function Hook() {
|
|
167
|
+
return (
|
|
168
|
+
<Toaster>
|
|
169
|
+
<SaveButton />
|
|
170
|
+
</Toaster>
|
|
171
|
+
);
|
|
172
|
+
}
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
## Props
|
|
176
|
+
|
|
177
|
+
**`toast(title, options?)`** returns the id. Also `toast.success`, `.warning`, `.info`, `.error` (high priority), `.loading` (stays until updated), `.promise(promise, { loading, success, error })`, `.update(id, options)`, `.dismiss(id?)`.
|
|
178
|
+
|
|
179
|
+
| Option | Type | Default |
|
|
180
|
+
| ---------------------- | ----------------------------------------------------------------------- | ----------- |
|
|
181
|
+
| `type` | `"default" \| "success" \| "warning" \| "info" \| "error" \| "loading"` | `"default"` |
|
|
182
|
+
| `description` | `ReactNode` | — |
|
|
183
|
+
| `action` | `{ label: ReactNode; onClick: () => void }` | — |
|
|
184
|
+
| `timeout` | `number` (ms), `0` keeps it open | `5000` |
|
|
185
|
+
| `priority` | `"low" \| "high"` | `"low"` |
|
|
186
|
+
| `id` | `string` — reuse to update in place | generated |
|
|
187
|
+
| `onClose` / `onRemove` | callbacks | — |
|
|
188
|
+
| `actionProps`, `data` | forwarded to Base UI | — |
|
|
189
|
+
|
|
190
|
+
**`Toaster`**
|
|
191
|
+
|
|
192
|
+
| Prop | Type | Default |
|
|
193
|
+
| -------------- | ------------------------------------------------------------- | ----------------------------------------- |
|
|
194
|
+
| `limit` | `number` — older toasts beyond it fade out | `3` |
|
|
195
|
+
| `timeout` | `number` (ms) | `5000` |
|
|
196
|
+
| `toastManager` | `Toast.createToastManager()` | the library-wide manager behind `toast()` |
|
|
197
|
+
| `labels` | `{ close?, region? }` — each close button, the stack's region | `"Dismiss"`, `"Notifications"` |
|
|
198
|
+
| `className` | classes for the fixed viewport | — |
|
|
199
|
+
| `children` | your app, to use `useToast()` | — |
|
|
200
|
+
|
|
201
|
+
Only the first `Toaster` per manager renders, so toasts never double. Right to left the stack mirrors to bottom-left. Motion is in `styles/parts/overlays.css` (`--toast-index`, `--toast-offset-y`, `--toast-swipe-movement-*`); `data-type` on each toast. Put the `Toaster` inside the `LocaleProvider` (`messages.toast`).
|
|
202
|
+
|
|
203
|
+
## Brand rules
|
|
204
|
+
|
|
205
|
+
- **Do** write the outcome as a sentence: "Your changes are saved."; in an error, what to do next.
|
|
206
|
+
- **Do** use each type only for its status, never for emphasis.
|
|
207
|
+
- **Don't** colour the surface, border or text.
|
|
208
|
+
- **Don't** toast every click, stack more than three, or put the only path to something in a toast.
|
|
209
|
+
|
|
210
|
+
## Accessibility
|
|
211
|
+
|
|
212
|
+
- The viewport is a landmark; F6 moves into the stack, Tab between toasts and buttons.
|
|
213
|
+
- Title and description are announced politely (`error` with high priority).
|
|
214
|
+
- Hover or focus pauses the timers; each toast has a labelled close button. Reduced motion: the stack moves instantly.
|
|
215
|
+
|
|
216
|
+
---
|
|
217
|
+
|
|
218
|
+
- Import: `import { Toaster, toast, useToast } from "@zonsh/ui"`
|
|
219
|
+
- Source: `packages/ui/src/components/toast.tsx`
|
|
220
|
+
- Primitive: `@base-ui/react/toast` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/toast.md`)
|
|
@@ -0,0 +1,261 @@
|
|
|
1
|
+
# Toggle Group
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { ToggleGroup, ToggleGroupItem } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
export function Basic() {
|
|
7
|
+
return (
|
|
8
|
+
<ToggleGroup aria-label="Reporting period" defaultValue={["month"]}>
|
|
9
|
+
<ToggleGroupItem value="week">Week</ToggleGroupItem>
|
|
10
|
+
<ToggleGroupItem value="month">Month</ToggleGroupItem>
|
|
11
|
+
<ToggleGroupItem value="quarter">Quarter</ToggleGroupItem>
|
|
12
|
+
<ToggleGroupItem value="year">Year</ToggleGroupItem>
|
|
13
|
+
</ToggleGroup>
|
|
14
|
+
);
|
|
15
|
+
}
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
The zon **segmented control**: a recessed 38px track holding 30px segments. Hover only brightens a segment's ink (no fill); the current one is **raised** like a secondary button. In single mode that surface glides to the picked segment (`--duration-glide`, `--ease-glide`), instantly under reduced motion; with `multiple` each pressed segment raises itself. Segments that outgrow the row scroll inside the track.
|
|
19
|
+
|
|
20
|
+
## Usage
|
|
21
|
+
|
|
22
|
+
```tsx
|
|
23
|
+
import { ToggleGroup, ToggleGroupItem } from "@zonsh/ui";
|
|
24
|
+
|
|
25
|
+
<ToggleGroup aria-label="Reporting period" defaultValue={["month"]}>
|
|
26
|
+
<ToggleGroupItem value="week">Week</ToggleGroupItem>
|
|
27
|
+
<ToggleGroupItem value="month">Month</ToggleGroupItem>
|
|
28
|
+
<ToggleGroupItem value="quarter">Quarter</ToggleGroupItem>
|
|
29
|
+
</ToggleGroup>;
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
- `defaultValue` — the pressed segment, as an array.
|
|
33
|
+
- `aria-label` — names the group.
|
|
34
|
+
- `ToggleGroupItem.icon` — a 16px icon before the label.
|
|
35
|
+
|
|
36
|
+
## When to use
|
|
37
|
+
|
|
38
|
+
- 2–5 short, exclusive options seen side by side: a period, a view, light/dark/system. More, or long labels: `Select`.
|
|
39
|
+
- Independent actions are a toolbar of `Button`s or `Toggle`s.
|
|
40
|
+
|
|
41
|
+
## Examples
|
|
42
|
+
|
|
43
|
+
### Small
|
|
44
|
+
|
|
45
|
+
`size="sm"` is a 30px track holding 24px segments, for a dense screen beside other `sm` controls: a table's toolbar, a filter row. A dense theme (`density`) makes both sizes smaller already.
|
|
46
|
+
|
|
47
|
+
```tsx
|
|
48
|
+
import { ToggleGroup, ToggleGroupItem } from "@zonsh/ui";
|
|
49
|
+
|
|
50
|
+
export function Small() {
|
|
51
|
+
return (
|
|
52
|
+
<ToggleGroup size="sm" aria-label="Rows shown" defaultValue={["open"]}>
|
|
53
|
+
<ToggleGroupItem value="open">Open</ToggleGroupItem>
|
|
54
|
+
<ToggleGroupItem value="closed">Closed</ToggleGroupItem>
|
|
55
|
+
<ToggleGroupItem value="all">All</ToggleGroupItem>
|
|
56
|
+
</ToggleGroup>
|
|
57
|
+
);
|
|
58
|
+
}
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
### With icons
|
|
62
|
+
|
|
63
|
+
```tsx
|
|
64
|
+
import { ToggleGroup, ToggleGroupItem } from "@zonsh/ui";
|
|
65
|
+
import { CalendarRangeIcon, KanbanIcon, ListIcon } from "lucide-react";
|
|
66
|
+
|
|
67
|
+
export function WithIcons() {
|
|
68
|
+
return (
|
|
69
|
+
<ToggleGroup aria-label="Project view" defaultValue={["board"]}>
|
|
70
|
+
<ToggleGroupItem value="list">
|
|
71
|
+
<ListIcon />
|
|
72
|
+
List
|
|
73
|
+
</ToggleGroupItem>
|
|
74
|
+
<ToggleGroupItem value="board">
|
|
75
|
+
<KanbanIcon />
|
|
76
|
+
Board
|
|
77
|
+
</ToggleGroupItem>
|
|
78
|
+
<ToggleGroupItem value="timeline">
|
|
79
|
+
<CalendarRangeIcon />
|
|
80
|
+
Timeline
|
|
81
|
+
</ToggleGroupItem>
|
|
82
|
+
</ToggleGroup>
|
|
83
|
+
);
|
|
84
|
+
}
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
### Icon only
|
|
88
|
+
|
|
89
|
+
Each needs an `aria-label`.
|
|
90
|
+
|
|
91
|
+
```tsx
|
|
92
|
+
import { ToggleGroup, ToggleGroupItem } from "@zonsh/ui";
|
|
93
|
+
import { MonitorIcon, MoonIcon, SunIcon } from "lucide-react";
|
|
94
|
+
|
|
95
|
+
export function IconOnly() {
|
|
96
|
+
return (
|
|
97
|
+
<ToggleGroup aria-label="Colour theme" defaultValue={["system"]}>
|
|
98
|
+
<ToggleGroupItem value="light" aria-label="Light">
|
|
99
|
+
<SunIcon />
|
|
100
|
+
</ToggleGroupItem>
|
|
101
|
+
<ToggleGroupItem value="dark" aria-label="Dark">
|
|
102
|
+
<MoonIcon />
|
|
103
|
+
</ToggleGroupItem>
|
|
104
|
+
<ToggleGroupItem value="system" aria-label="Match system">
|
|
105
|
+
<MonitorIcon />
|
|
106
|
+
</ToggleGroupItem>
|
|
107
|
+
</ToggleGroup>
|
|
108
|
+
);
|
|
109
|
+
}
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
### Reveal
|
|
113
|
+
|
|
114
|
+
With an `icon` and a label on every segment, `reveal="label"` shows icons and slides in the pressed segment's label (`"icon"` the reverse). The hidden label still names it.
|
|
115
|
+
|
|
116
|
+
```tsx
|
|
117
|
+
import { ToggleGroup, ToggleGroupItem } from "@zonsh/ui";
|
|
118
|
+
import { CalendarRangeIcon, KanbanIcon, ListIcon, MonitorIcon, MoonIcon, SunIcon } from "lucide-react";
|
|
119
|
+
|
|
120
|
+
export function Reveal() {
|
|
121
|
+
return (
|
|
122
|
+
<div className="flex flex-col items-start gap-4">
|
|
123
|
+
<ToggleGroup aria-label="Project view" defaultValue={["board"]} reveal="label">
|
|
124
|
+
<ToggleGroupItem value="list" icon={<ListIcon />}>
|
|
125
|
+
List
|
|
126
|
+
</ToggleGroupItem>
|
|
127
|
+
<ToggleGroupItem value="board" icon={<KanbanIcon />}>
|
|
128
|
+
Board
|
|
129
|
+
</ToggleGroupItem>
|
|
130
|
+
<ToggleGroupItem value="timeline" icon={<CalendarRangeIcon />}>
|
|
131
|
+
Timeline
|
|
132
|
+
</ToggleGroupItem>
|
|
133
|
+
</ToggleGroup>
|
|
134
|
+
<ToggleGroup aria-label="Colour theme" defaultValue={["system"]} reveal="icon">
|
|
135
|
+
<ToggleGroupItem value="light" icon={<SunIcon />}>
|
|
136
|
+
Light
|
|
137
|
+
</ToggleGroupItem>
|
|
138
|
+
<ToggleGroupItem value="dark" icon={<MoonIcon />}>
|
|
139
|
+
Dark
|
|
140
|
+
</ToggleGroupItem>
|
|
141
|
+
<ToggleGroupItem value="system" icon={<MonitorIcon />}>
|
|
142
|
+
System
|
|
143
|
+
</ToggleGroupItem>
|
|
144
|
+
</ToggleGroup>
|
|
145
|
+
</div>
|
|
146
|
+
);
|
|
147
|
+
}
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
### Controlled
|
|
151
|
+
|
|
152
|
+
One segment stays pressed unless `allowEmpty`.
|
|
153
|
+
|
|
154
|
+
```tsx
|
|
155
|
+
import { ToggleGroup, ToggleGroupItem } from "@zonsh/ui";
|
|
156
|
+
import * as React from "react";
|
|
157
|
+
|
|
158
|
+
export function Controlled() {
|
|
159
|
+
const [value, setValue] = React.useState<string[]>(["monthly"]);
|
|
160
|
+
return (
|
|
161
|
+
<div className="flex flex-col items-start gap-3">
|
|
162
|
+
<span id="billing-label" className="text-sm font-medium">
|
|
163
|
+
Billing
|
|
164
|
+
</span>
|
|
165
|
+
<ToggleGroup aria-labelledby="billing-label" value={value} onValueChange={setValue}>
|
|
166
|
+
<ToggleGroupItem value="monthly">Monthly</ToggleGroupItem>
|
|
167
|
+
<ToggleGroupItem value="yearly">Yearly</ToggleGroupItem>
|
|
168
|
+
</ToggleGroup>
|
|
169
|
+
<p className="font-mono text-xs text-muted-foreground">value: {value.join(", ")}</p>
|
|
170
|
+
</div>
|
|
171
|
+
);
|
|
172
|
+
}
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
### Disabled
|
|
176
|
+
|
|
177
|
+
```tsx
|
|
178
|
+
import { ToggleGroup, ToggleGroupItem } from "@zonsh/ui";
|
|
179
|
+
|
|
180
|
+
export function Disabled() {
|
|
181
|
+
return (
|
|
182
|
+
<div className="flex flex-col items-start gap-3">
|
|
183
|
+
<ToggleGroup aria-label="Environment" defaultValue={["staging"]} disabled>
|
|
184
|
+
<ToggleGroupItem value="staging">Staging</ToggleGroupItem>
|
|
185
|
+
<ToggleGroupItem value="production">Production</ToggleGroupItem>
|
|
186
|
+
</ToggleGroup>
|
|
187
|
+
<ToggleGroup aria-label="Export format" defaultValue={["csv"]}>
|
|
188
|
+
<ToggleGroupItem value="csv">CSV</ToggleGroupItem>
|
|
189
|
+
<ToggleGroupItem value="xlsx">Excel</ToggleGroupItem>
|
|
190
|
+
<ToggleGroupItem value="pdf" disabled>
|
|
191
|
+
PDF
|
|
192
|
+
</ToggleGroupItem>
|
|
193
|
+
</ToggleGroup>
|
|
194
|
+
</div>
|
|
195
|
+
);
|
|
196
|
+
}
|
|
197
|
+
```
|
|
198
|
+
|
|
199
|
+
### More segments than fit
|
|
200
|
+
|
|
201
|
+
A track wider than its room scrolls inside itself, and its ends fade where there is more to scroll, as a `ScrollArea`'s do; the pressed segment is kept in view. Past five options, a `Select` is usually the better control.
|
|
202
|
+
|
|
203
|
+
```tsx
|
|
204
|
+
import { ToggleGroup, ToggleGroupItem } from "@zonsh/ui";
|
|
205
|
+
|
|
206
|
+
export function Overflow() {
|
|
207
|
+
return (
|
|
208
|
+
<div className="w-full max-w-64">
|
|
209
|
+
<ToggleGroup aria-label="Units" defaultValue={["metres"]}>
|
|
210
|
+
<ToggleGroupItem value="millimetres">Millimetres</ToggleGroupItem>
|
|
211
|
+
<ToggleGroupItem value="centimetres">Centimetres</ToggleGroupItem>
|
|
212
|
+
<ToggleGroupItem value="metres">Metres</ToggleGroupItem>
|
|
213
|
+
<ToggleGroupItem value="kilometres">Kilometres</ToggleGroupItem>
|
|
214
|
+
</ToggleGroup>
|
|
215
|
+
</div>
|
|
216
|
+
);
|
|
217
|
+
}
|
|
218
|
+
```
|
|
219
|
+
|
|
220
|
+
## Props
|
|
221
|
+
|
|
222
|
+
| Prop | Type | Default |
|
|
223
|
+
| --------------- | ------------------------------------------------------------- | -------------- |
|
|
224
|
+
| `value` | `string[]` | — |
|
|
225
|
+
| `defaultValue` | `string[]` | — |
|
|
226
|
+
| `onValueChange` | `(value: string[], details) => void` | — |
|
|
227
|
+
| `allowEmpty` | `boolean`: let single mode be cleared | `false` |
|
|
228
|
+
| `reveal` | `"label" \| "icon"`: what a pressed segment shows in addition | — |
|
|
229
|
+
| `size` | `"sm" \| "default"`: a 30px track with 24px segments, or 38px | `"default"` |
|
|
230
|
+
| `multiple` | `boolean` | `false` |
|
|
231
|
+
| `disabled` | `boolean` | `false` |
|
|
232
|
+
| `orientation` | `"horizontal" \| "vertical"` | `"horizontal"` |
|
|
233
|
+
|
|
234
|
+
`ToggleGroupItem` takes `value` (required), `icon` and `disabled`, and forwards `<button>` props. `data-pressed`, `data-disabled`, `data-orientation`; `data-reveal` and `data-size` on the group.
|
|
235
|
+
|
|
236
|
+
## Brand rules
|
|
237
|
+
|
|
238
|
+
- **Do** keep labels to a word or two. Use `size="sm"` only beside other `sm` controls, never to fit long labels.
|
|
239
|
+
- **Don't** give the active segment a primary fill, a hover fill or a second indicator.
|
|
240
|
+
- **Don't** set fixed heights on the track or segments.
|
|
241
|
+
|
|
242
|
+
## Accessibility
|
|
243
|
+
|
|
244
|
+
- `role="group"` of `aria-pressed` buttons, named by `aria-label` or `aria-labelledby`; a flush 2px `--control-focus` outline.
|
|
245
|
+
|
|
246
|
+
### Keyboard
|
|
247
|
+
|
|
248
|
+
| Key | What it does |
|
|
249
|
+
| ------------- | ------------------------------------------------------------------------------------------------------------- |
|
|
250
|
+
| ← / → | Moves focus to the previous or next segment, looping at the ends (swapped right to left; ↑ / ↓ when vertical) |
|
|
251
|
+
| Home / End | Moves focus to the first or last segment |
|
|
252
|
+
| Enter / Space | Picks the focused segment; with `multiple`, presses or releases it |
|
|
253
|
+
| Tab | Leaves the group: it is one Tab stop, on the current segment |
|
|
254
|
+
|
|
255
|
+
Arrows only move focus; nothing changes until Enter or Space.
|
|
256
|
+
|
|
257
|
+
---
|
|
258
|
+
|
|
259
|
+
- Import: `import { ToggleGroup, ToggleGroupItem } from "@zonsh/ui"`
|
|
260
|
+
- Source: `packages/ui/src/components/toggle-group.tsx`
|
|
261
|
+
- Primitive: `@base-ui/react/toggle-group` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/toggle-group.md`)
|
|
@@ -0,0 +1,167 @@
|
|
|
1
|
+
# Toggle
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Toggle } from "@zonsh/ui";
|
|
5
|
+
import { ArchiveIcon } from "lucide-react";
|
|
6
|
+
|
|
7
|
+
export function Basic() {
|
|
8
|
+
return (
|
|
9
|
+
<Toggle>
|
|
10
|
+
<ArchiveIcon />
|
|
11
|
+
Show archived projects
|
|
12
|
+
</Toggle>
|
|
13
|
+
);
|
|
14
|
+
}
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
A secondary button that stays pressed. Off, it is quiet, and hover only brightens the ink. On, it sinks in: `--control-hover` fill, a deeper inset, the 1px `--control-focus` edge and full ink. Never a colour fill.
|
|
18
|
+
|
|
19
|
+
## Usage
|
|
20
|
+
|
|
21
|
+
```tsx
|
|
22
|
+
import { Toggle } from "@zonsh/ui";
|
|
23
|
+
import { Grid3x3Icon } from "lucide-react";
|
|
24
|
+
|
|
25
|
+
<Toggle>
|
|
26
|
+
<Grid3x3Icon />
|
|
27
|
+
Show grid
|
|
28
|
+
</Toggle>;
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
- `pressed` / `onPressedChange` — control it.
|
|
32
|
+
- `size` — `sm`, `default`, `icon`, `icon-sm`.
|
|
33
|
+
- `aria-label` — required when icon-only.
|
|
34
|
+
|
|
35
|
+
## When to use
|
|
36
|
+
|
|
37
|
+
- One on/off tool: "Show grid", bold. A choice of options: `ToggleGroup`; a saved value: `Checkbox` or `Switch`.
|
|
38
|
+
|
|
39
|
+
## Examples
|
|
40
|
+
|
|
41
|
+
### Off and on
|
|
42
|
+
|
|
43
|
+
```tsx
|
|
44
|
+
import { Toggle } from "@zonsh/ui";
|
|
45
|
+
import { Grid3x3Icon } from "lucide-react";
|
|
46
|
+
|
|
47
|
+
export function States() {
|
|
48
|
+
return (
|
|
49
|
+
<div className="flex flex-wrap items-center gap-3">
|
|
50
|
+
<Toggle>
|
|
51
|
+
<Grid3x3Icon />
|
|
52
|
+
Show grid
|
|
53
|
+
</Toggle>
|
|
54
|
+
<Toggle defaultPressed>
|
|
55
|
+
<Grid3x3Icon />
|
|
56
|
+
Show grid
|
|
57
|
+
</Toggle>
|
|
58
|
+
</div>
|
|
59
|
+
);
|
|
60
|
+
}
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
### Icon only
|
|
64
|
+
|
|
65
|
+
Circular; always with an `aria-label`.
|
|
66
|
+
|
|
67
|
+
```tsx
|
|
68
|
+
import { Toggle } from "@zonsh/ui";
|
|
69
|
+
import { BoldIcon, ItalicIcon, UnderlineIcon } from "lucide-react";
|
|
70
|
+
|
|
71
|
+
export function IconOnly() {
|
|
72
|
+
return (
|
|
73
|
+
<div className="flex items-center gap-2">
|
|
74
|
+
<Toggle size="icon" aria-label="Bold" defaultPressed>
|
|
75
|
+
<BoldIcon />
|
|
76
|
+
</Toggle>
|
|
77
|
+
<Toggle size="icon" aria-label="Italic">
|
|
78
|
+
<ItalicIcon />
|
|
79
|
+
</Toggle>
|
|
80
|
+
<Toggle size="icon" aria-label="Underline">
|
|
81
|
+
<UnderlineIcon />
|
|
82
|
+
</Toggle>
|
|
83
|
+
</div>
|
|
84
|
+
);
|
|
85
|
+
}
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
### Sizes
|
|
89
|
+
|
|
90
|
+
`sm` 30px, `default` 38px; icon circles 30 and 36px.
|
|
91
|
+
|
|
92
|
+
```tsx
|
|
93
|
+
import { Toggle } from "@zonsh/ui";
|
|
94
|
+
import { Grid3x3Icon, PinIcon } from "lucide-react";
|
|
95
|
+
|
|
96
|
+
export function Sizes() {
|
|
97
|
+
return (
|
|
98
|
+
<div className="flex flex-wrap items-center gap-3">
|
|
99
|
+
<Toggle size="sm">
|
|
100
|
+
<Grid3x3Icon />
|
|
101
|
+
Show grid
|
|
102
|
+
</Toggle>
|
|
103
|
+
<Toggle defaultPressed>
|
|
104
|
+
<Grid3x3Icon />
|
|
105
|
+
Show grid
|
|
106
|
+
</Toggle>
|
|
107
|
+
<Toggle size="icon-sm" aria-label="Pin this view">
|
|
108
|
+
<PinIcon />
|
|
109
|
+
</Toggle>
|
|
110
|
+
<Toggle size="icon" aria-label="Pin this view" defaultPressed>
|
|
111
|
+
<PinIcon />
|
|
112
|
+
</Toggle>
|
|
113
|
+
</div>
|
|
114
|
+
);
|
|
115
|
+
}
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
### Disabled
|
|
119
|
+
|
|
120
|
+
```tsx
|
|
121
|
+
import { Toggle } from "@zonsh/ui";
|
|
122
|
+
|
|
123
|
+
export function Disabled() {
|
|
124
|
+
return (
|
|
125
|
+
<div className="flex flex-wrap items-center gap-3">
|
|
126
|
+
<Toggle disabled>Show archived projects</Toggle>
|
|
127
|
+
<Toggle disabled defaultPressed>
|
|
128
|
+
Show archived projects
|
|
129
|
+
</Toggle>
|
|
130
|
+
</div>
|
|
131
|
+
);
|
|
132
|
+
}
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
## Props
|
|
136
|
+
|
|
137
|
+
| Prop | Type | Default |
|
|
138
|
+
| ----------------- | ------------------------------------------ | ----------- |
|
|
139
|
+
| `size` | `"sm" \| "default" \| "icon" \| "icon-sm"` | `"default"` |
|
|
140
|
+
| `pressed` | `boolean` | — |
|
|
141
|
+
| `defaultPressed` | `boolean` | `false` |
|
|
142
|
+
| `onPressedChange` | `(pressed: boolean, details) => void` | — |
|
|
143
|
+
| `disabled` | `boolean` | `false` |
|
|
144
|
+
|
|
145
|
+
Other `<button>` props are forwarded. Data attributes: `data-size`, `data-pressed`, `data-disabled`.
|
|
146
|
+
|
|
147
|
+
## Brand rules
|
|
148
|
+
|
|
149
|
+
- **Do** keep the label constant; "Show" never becomes "Hide".
|
|
150
|
+
- **Don't** fill it with `--primary` or make off look pressed.
|
|
151
|
+
- **Don't** size it with `h-*` or padding; use `size`.
|
|
152
|
+
|
|
153
|
+
## Accessibility
|
|
154
|
+
|
|
155
|
+
- A `<button>` with `aria-pressed`; icon-only needs `aria-label`; a flush 2px `--control-focus` outline.
|
|
156
|
+
|
|
157
|
+
### Keyboard
|
|
158
|
+
|
|
159
|
+
| Key | What it does |
|
|
160
|
+
| ------------- | ------------------------------ |
|
|
161
|
+
| Enter / Space | Presses or releases the toggle |
|
|
162
|
+
|
|
163
|
+
---
|
|
164
|
+
|
|
165
|
+
- Import: `import { Toggle } from "@zonsh/ui"`
|
|
166
|
+
- Source: `packages/ui/src/components/toggle.tsx`
|
|
167
|
+
- Primitive: `@base-ui/react/toggle` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/toggle.md`)
|