@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,344 @@
|
|
|
1
|
+
# Swipe Actions
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Item, ItemContent, ItemDescription, ItemTitle, SwipeActions } from "@zonsh/ui";
|
|
5
|
+
import { ArchiveIcon, CheckIcon, MailIcon, Trash2Icon } from "lucide-react";
|
|
6
|
+
import * as React from "react";
|
|
7
|
+
|
|
8
|
+
/** A phone-sized screen for the demos: 390px wide, its list scrolling inside. */
|
|
9
|
+
function Phone({ label, children }: { label: string; children: React.ReactNode }) {
|
|
10
|
+
return (
|
|
11
|
+
<div className="relative mx-auto h-[600px] w-full max-w-[390px] overflow-hidden border border-field-edge">
|
|
12
|
+
<div
|
|
13
|
+
role="region"
|
|
14
|
+
aria-label={label}
|
|
15
|
+
tabIndex={0}
|
|
16
|
+
data-slot="demo-phone-screen"
|
|
17
|
+
className="h-full overflow-y-auto pt-6 focus-ring"
|
|
18
|
+
>
|
|
19
|
+
{children}
|
|
20
|
+
</div>
|
|
21
|
+
</div>
|
|
22
|
+
);
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
const messages = [
|
|
26
|
+
{ id: "m1", from: "Ines Moreau", subject: "Kiln booking for Saturday", time: "09:41" },
|
|
27
|
+
{ id: "m2", from: "Theo Lindqvist", subject: "Notes from the reading group", time: "08:15" },
|
|
28
|
+
{ id: "m3", from: "Allotment society", subject: "Water is back on at the east gate", time: "Yesterday" },
|
|
29
|
+
{ id: "m4", from: "Jun Park", subject: "Photos from the coast walk", time: "Yesterday" },
|
|
30
|
+
{ id: "m5", from: "Library", subject: "Two books are due on Friday", time: "Mon" },
|
|
31
|
+
{ id: "m6", from: "Ana Ribeiro", subject: "Porto — train times", time: "Sun" },
|
|
32
|
+
];
|
|
33
|
+
|
|
34
|
+
export function Basic() {
|
|
35
|
+
const [rows, setRows] = React.useState(messages);
|
|
36
|
+
const [unread, setUnread] = React.useState<Set<string>>(() => new Set(["m1", "m2"]));
|
|
37
|
+
const [status, setStatus] = React.useState("");
|
|
38
|
+
const remove = (id: string, verb: string) => {
|
|
39
|
+
const row = rows.find((r) => r.id === id);
|
|
40
|
+
setRows((list) => list.filter((r) => r.id !== id));
|
|
41
|
+
setStatus(`${verb}: ${row?.subject}`);
|
|
42
|
+
};
|
|
43
|
+
const toggleUnread = (id: string) =>
|
|
44
|
+
setUnread((set) => {
|
|
45
|
+
const next = new Set(set);
|
|
46
|
+
if (next.has(id)) next.delete(id);
|
|
47
|
+
else next.add(id);
|
|
48
|
+
return next;
|
|
49
|
+
});
|
|
50
|
+
return (
|
|
51
|
+
<Phone label="Mail screen">
|
|
52
|
+
<ul aria-label="Inbox">
|
|
53
|
+
{rows.map((m) => (
|
|
54
|
+
<li key={m.id} className="border-b border-border/60">
|
|
55
|
+
<SwipeActions
|
|
56
|
+
label={m.subject}
|
|
57
|
+
leading={[
|
|
58
|
+
{
|
|
59
|
+
label: unread.has(m.id) ? "Read" : "Unread",
|
|
60
|
+
icon: unread.has(m.id) ? <CheckIcon /> : <MailIcon />,
|
|
61
|
+
tone: "info",
|
|
62
|
+
onSelect: () => toggleUnread(m.id),
|
|
63
|
+
},
|
|
64
|
+
]}
|
|
65
|
+
trailing={[
|
|
66
|
+
{ label: "Archive", icon: <ArchiveIcon />, onSelect: () => remove(m.id, "Archived") },
|
|
67
|
+
{
|
|
68
|
+
label: "Delete",
|
|
69
|
+
icon: <Trash2Icon />,
|
|
70
|
+
tone: "destructive",
|
|
71
|
+
onSelect: () => remove(m.id, "Deleted"),
|
|
72
|
+
},
|
|
73
|
+
]}
|
|
74
|
+
>
|
|
75
|
+
<Item render={<a href={`#${m.id}`} />} className="rounded-none">
|
|
76
|
+
<ItemContent>
|
|
77
|
+
<ItemTitle className="flex w-full items-baseline gap-2">
|
|
78
|
+
{unread.has(m.id) && (
|
|
79
|
+
<span className="size-2 shrink-0 self-center rounded-full bg-info">
|
|
80
|
+
<span className="sr-only">Unread</span>
|
|
81
|
+
</span>
|
|
82
|
+
)}
|
|
83
|
+
<span className="min-w-0 flex-1 truncate">{m.from}</span>
|
|
84
|
+
<span className="shrink-0 font-mono text-11 font-normal text-muted-foreground">
|
|
85
|
+
{m.time}
|
|
86
|
+
</span>
|
|
87
|
+
</ItemTitle>
|
|
88
|
+
<ItemDescription className="truncate">{m.subject}</ItemDescription>
|
|
89
|
+
</ItemContent>
|
|
90
|
+
</Item>
|
|
91
|
+
</SwipeActions>
|
|
92
|
+
</li>
|
|
93
|
+
))}
|
|
94
|
+
</ul>
|
|
95
|
+
<p className="px-4 pt-4 text-13 text-muted-foreground" aria-live="polite">
|
|
96
|
+
{rows.length === 0 ? "Inbox zero." : status}
|
|
97
|
+
</p>
|
|
98
|
+
</Phone>
|
|
99
|
+
);
|
|
100
|
+
}
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
A row of a list — an `Item`, a link, a mail — that slides aside under the finger to uncover its actions. Swipe it a little and let go to keep them open; on a side with a single action, swipe on through more than 60% of the row and that action takes the whole strip and runs when you let go; let go short and the row springs back over 300ms. A flick is enough either way. Opening one row shuts the last; scrolling the list or tapping elsewhere shuts it too.
|
|
104
|
+
|
|
105
|
+
**A full swipe runs an action only on a side with one.** With two or more on a side — Archive and Delete — no action is the obvious one to run, and a long swipe meant to show Archive must never delete: swiping on through, however far, only opens the row to show the tiles, rubber-banding past them, and you tap the one you want.
|
|
106
|
+
|
|
107
|
+
Each action is a tile as tall as the row, an icon over a short label in Licht Sans. They stay monochrome but for meaning: `destructive` Delete in the destructive ink on a 15% tint, the status tones for what they mean (an `info` Unread, a `success` Done).
|
|
108
|
+
|
|
109
|
+
**It never fights a scroll.** The row only answers a press that has moved 8px and more sideways than up or down; anything steeper is the list's scroll, which the browser keeps (`touch-action: pan-y`). Touch and pen swipe; a mouse keeps selecting text and uses the menu button.
|
|
110
|
+
|
|
111
|
+
## When to use
|
|
112
|
+
|
|
113
|
+
- Lists people triage with a thumb: mail, notifications, tasks, a basket — one or two actions a side, the one done most often outermost.
|
|
114
|
+
- One action on a side when a full swipe should run it (Done, Read). Two or three open the row and wait for a tap; more, or actions that need a look first, belong in an `ActionSheet` from the row, or the row's own screen.
|
|
115
|
+
- A table on a desktop: row actions in a `Menu` at the row's end (here `menu="always"`).
|
|
116
|
+
|
|
117
|
+
## Usage
|
|
118
|
+
|
|
119
|
+
```tsx
|
|
120
|
+
import { Item, ItemContent, ItemTitle, SwipeActions } from "@zonsh/ui";
|
|
121
|
+
import { ArchiveIcon, Trash2Icon } from "lucide-react";
|
|
122
|
+
|
|
123
|
+
<SwipeActions
|
|
124
|
+
label={mail.subject}
|
|
125
|
+
trailing={[
|
|
126
|
+
{ label: "Archive", icon: <ArchiveIcon />, onSelect: () => archive(mail.id) },
|
|
127
|
+
{ label: "Delete", icon: <Trash2Icon />, tone: "destructive", onSelect: () => remove(mail.id) },
|
|
128
|
+
]}
|
|
129
|
+
>
|
|
130
|
+
<Item render={<a href={`/mail/${mail.id}`} />}>…</Item>
|
|
131
|
+
</SwipeActions>;
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
`trailing` sits at the line's end, its last action outermost. `leading` sits at the start, its first action outermost. Here the single leading action runs from a full swipe; the two trailing ones only open. Right to left the sides follow the reading direction: trailing actions are on the left, revealed by a swipe to the right.
|
|
135
|
+
|
|
136
|
+
## Examples
|
|
137
|
+
|
|
138
|
+
### Always a menu
|
|
139
|
+
|
|
140
|
+
`menu="always"` keeps the menu button beside the row for a mouse: a list that is used on a desktop too. On a phone the swipe is the shortcut and the button the way everyone can see.
|
|
141
|
+
|
|
142
|
+
```tsx
|
|
143
|
+
import { Item, ItemContent, ItemDescription, ItemTitle, SwipeActions } from "@zonsh/ui";
|
|
144
|
+
import { CheckIcon, PinIcon } from "lucide-react";
|
|
145
|
+
import * as React from "react";
|
|
146
|
+
|
|
147
|
+
const tasks = [
|
|
148
|
+
{ id: "t1", title: "Glaze the test tiles", meta: "Studio · due Thursday" },
|
|
149
|
+
{ id: "t2", title: "Order more clay", meta: "Supplies · 2 bags of stoneware" },
|
|
150
|
+
{ id: "t3", title: "Photograph the mugs for the shop", meta: "Shop · before the market" },
|
|
151
|
+
];
|
|
152
|
+
|
|
153
|
+
export function MenuButton() {
|
|
154
|
+
const [rows, setRows] = React.useState(tasks);
|
|
155
|
+
const [pinned, setPinned] = React.useState<string | null>(null);
|
|
156
|
+
return (
|
|
157
|
+
<ul aria-label="Tasks" className="mx-auto w-full max-w-md">
|
|
158
|
+
{rows.map((t) => (
|
|
159
|
+
<li key={t.id} className="border-b border-border/60 first:border-t">
|
|
160
|
+
<SwipeActions
|
|
161
|
+
menu="always"
|
|
162
|
+
label={t.title}
|
|
163
|
+
leading={[
|
|
164
|
+
{
|
|
165
|
+
label: pinned === t.id ? "Unpin" : "Pin",
|
|
166
|
+
icon: <PinIcon />,
|
|
167
|
+
onSelect: () => setPinned((p) => (p === t.id ? null : t.id)),
|
|
168
|
+
},
|
|
169
|
+
]}
|
|
170
|
+
trailing={[
|
|
171
|
+
{
|
|
172
|
+
label: "Done",
|
|
173
|
+
icon: <CheckIcon />,
|
|
174
|
+
tone: "success",
|
|
175
|
+
onSelect: () => setRows((list) => list.filter((r) => r.id !== t.id)),
|
|
176
|
+
},
|
|
177
|
+
]}
|
|
178
|
+
>
|
|
179
|
+
<Item size="sm" className="rounded-none">
|
|
180
|
+
<ItemContent>
|
|
181
|
+
<ItemTitle>
|
|
182
|
+
{pinned === t.id && (
|
|
183
|
+
<>
|
|
184
|
+
<PinIcon aria-hidden className="size-3.5 text-muted-foreground" />
|
|
185
|
+
<span className="sr-only">Pinned:</span>
|
|
186
|
+
</>
|
|
187
|
+
)}
|
|
188
|
+
{t.title}
|
|
189
|
+
</ItemTitle>
|
|
190
|
+
<ItemDescription>{t.meta}</ItemDescription>
|
|
191
|
+
</ItemContent>
|
|
192
|
+
</Item>
|
|
193
|
+
</SwipeActions>
|
|
194
|
+
</li>
|
|
195
|
+
))}
|
|
196
|
+
</ul>
|
|
197
|
+
);
|
|
198
|
+
}
|
|
199
|
+
```
|
|
200
|
+
|
|
201
|
+
### Three actions on a side
|
|
202
|
+
|
|
203
|
+
With three trailing actions the row only opens, as with two: swipe as far as you like, let go and
|
|
204
|
+
the tiles stay on screen for a tap. The single leading action still runs from a full swipe.
|
|
205
|
+
|
|
206
|
+
```tsx
|
|
207
|
+
import { Item, ItemContent, ItemDescription, ItemTitle, SwipeActions } from "@zonsh/ui";
|
|
208
|
+
import { ArchiveIcon, CheckIcon, FlagIcon, Trash2Icon } from "lucide-react";
|
|
209
|
+
import * as React from "react";
|
|
210
|
+
|
|
211
|
+
// Phone: as in the first example on this page that uses them.
|
|
212
|
+
|
|
213
|
+
const alerts = [
|
|
214
|
+
{ id: "a1", title: "Kiln reached 1240 °C", meta: "Studio · 2 min ago" },
|
|
215
|
+
{ id: "a2", title: "Ines shared “Glaze tests”", meta: "Shared · 1 h ago" },
|
|
216
|
+
{ id: "a3", title: "Market stall confirmed", meta: "Events · Yesterday" },
|
|
217
|
+
{ id: "a4", title: "Clay order shipped", meta: "Supplies · Mon" },
|
|
218
|
+
];
|
|
219
|
+
|
|
220
|
+
/** Three trailing actions: a swipe opens the row and waits for a tap; it never runs one by itself. */
|
|
221
|
+
export function ManyActions() {
|
|
222
|
+
const [rows, setRows] = React.useState(alerts);
|
|
223
|
+
const [flagged, setFlagged] = React.useState<Set<string>>(() => new Set());
|
|
224
|
+
const [status, setStatus] = React.useState("");
|
|
225
|
+
const remove = (id: string, verb: string) => {
|
|
226
|
+
const row = rows.find((r) => r.id === id);
|
|
227
|
+
setRows((list) => list.filter((r) => r.id !== id));
|
|
228
|
+
setStatus(`${verb}: ${row?.title}`);
|
|
229
|
+
};
|
|
230
|
+
return (
|
|
231
|
+
<Phone label="Notifications screen">
|
|
232
|
+
<ul aria-label="Notifications">
|
|
233
|
+
{rows.map((a) => (
|
|
234
|
+
<li key={a.id} className="border-b border-border/60">
|
|
235
|
+
<SwipeActions
|
|
236
|
+
label={a.title}
|
|
237
|
+
leading={[
|
|
238
|
+
{ label: "Done", icon: <CheckIcon />, tone: "success", onSelect: () => remove(a.id, "Done") },
|
|
239
|
+
]}
|
|
240
|
+
trailing={[
|
|
241
|
+
{
|
|
242
|
+
label: flagged.has(a.id) ? "Unflag" : "Flag",
|
|
243
|
+
icon: <FlagIcon />,
|
|
244
|
+
tone: "warning",
|
|
245
|
+
onSelect: () =>
|
|
246
|
+
setFlagged((set) => {
|
|
247
|
+
const next = new Set(set);
|
|
248
|
+
if (next.has(a.id)) next.delete(a.id);
|
|
249
|
+
else next.add(a.id);
|
|
250
|
+
return next;
|
|
251
|
+
}),
|
|
252
|
+
},
|
|
253
|
+
{ label: "Archive", icon: <ArchiveIcon />, onSelect: () => remove(a.id, "Archived") },
|
|
254
|
+
{
|
|
255
|
+
label: "Delete",
|
|
256
|
+
icon: <Trash2Icon />,
|
|
257
|
+
tone: "destructive",
|
|
258
|
+
onSelect: () => remove(a.id, "Deleted"),
|
|
259
|
+
},
|
|
260
|
+
]}
|
|
261
|
+
>
|
|
262
|
+
<Item className="rounded-none">
|
|
263
|
+
<ItemContent>
|
|
264
|
+
<ItemTitle className="flex w-full items-center gap-2">
|
|
265
|
+
{flagged.has(a.id) && (
|
|
266
|
+
<FlagIcon aria-label="Flagged" className="size-3.5 shrink-0 text-warning" />
|
|
267
|
+
)}
|
|
268
|
+
<span className="min-w-0 flex-1 truncate">{a.title}</span>
|
|
269
|
+
</ItemTitle>
|
|
270
|
+
<ItemDescription className="truncate">{a.meta}</ItemDescription>
|
|
271
|
+
</ItemContent>
|
|
272
|
+
</Item>
|
|
273
|
+
</SwipeActions>
|
|
274
|
+
</li>
|
|
275
|
+
))}
|
|
276
|
+
</ul>
|
|
277
|
+
<p className="px-4 pt-4 text-13 text-muted-foreground" aria-live="polite">
|
|
278
|
+
{rows.length === 0 ? "All caught up." : status}
|
|
279
|
+
</p>
|
|
280
|
+
</Phone>
|
|
281
|
+
);
|
|
282
|
+
}
|
|
283
|
+
```
|
|
284
|
+
|
|
285
|
+
## Props
|
|
286
|
+
|
|
287
|
+
| Prop | Type | Default | Notes |
|
|
288
|
+
| -------------- | ------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
289
|
+
| `children` | `ReactNode` | — | The row: an `Item`, a link, a list entry. |
|
|
290
|
+
| `leading` | `SwipeAction[]` | — | At the line's start, revealed by a swipe towards its end. The first is outermost. |
|
|
291
|
+
| `trailing` | `SwipeAction[]` | — | At the line's end. The last is outermost. |
|
|
292
|
+
| `fullSwipe` | `boolean \| "leading" \| "trailing"` | `true` | A swipe through 60% of the row runs that side's action. Only on a side with a single action; with two or more the swipe only opens the row. |
|
|
293
|
+
| `menu` | `"auto" \| "always" \| false` | `"auto"` | The menu button with every action: shown on focus and hover (`auto`), always, or not at all. |
|
|
294
|
+
| `label` | `string` | — | What the row is: the menu button reads "Actions for {label}". |
|
|
295
|
+
| `disabled` | `boolean` | `false` | No swipe and no menu. |
|
|
296
|
+
| `onOpenChange` | `(side: "leading" \| "trailing" \| null) => void` | — | Called as the row opens on a side or shuts. |
|
|
297
|
+
| `labels` | `Partial<SwipeActionsMessages>` | — | `menu(label?)` and `revealed(actions)`, what is read when a swipe opens the row. |
|
|
298
|
+
| `ref` | `Ref<HTMLDivElement>` | — | The root. |
|
|
299
|
+
|
|
300
|
+
Every other prop goes to the root `<div>`.
|
|
301
|
+
|
|
302
|
+
### SwipeAction
|
|
303
|
+
|
|
304
|
+
| Field | Type | Notes |
|
|
305
|
+
| ---------- | ---------------------------------------------------------------- | ------------------------------------------------- |
|
|
306
|
+
| `label` | `string` | One short word, under the icon and in the menu. |
|
|
307
|
+
| `icon` | `ReactNode` | A lucide icon. |
|
|
308
|
+
| `onSelect` | `() => void` | Runs it, from the tile, a full swipe or the menu. |
|
|
309
|
+
| `tone` | `"default" \| "destructive" \| "info" \| "success" \| "warning"` | The ink and tint, for what the action means. |
|
|
310
|
+
|
|
311
|
+
## Motion
|
|
312
|
+
|
|
313
|
+
- While the finger holds it the row follows 1:1, with no transition, and rubber-bands against a side with no actions and past what a side can reach.
|
|
314
|
+
- Let go, it settles over 2 × `--duration` (300ms) on `--ease`, and so does the strip of actions. Under reduced motion it jumps to where it rests.
|
|
315
|
+
- Crossing into a full swipe gives a haptic tick where the device has one, and the tile takes the whole strip. A side of two or more never crosses into one.
|
|
316
|
+
- Pressed, a row and a tile darken at once, in 90ms, and give a little: a row to 98.5%, a tile to 97%. Let go, they ease back. A press that moves (a scroll, a swipe) lets go of the shade at once. Under reduced motion only the shade shows.
|
|
317
|
+
|
|
318
|
+
## Brand rules
|
|
319
|
+
|
|
320
|
+
- **Do** put the action people take most often outermost, and Delete at the trailing end.
|
|
321
|
+
- **Do** keep each label one word, with an icon people know.
|
|
322
|
+
- **Don't** colour a tile for decoration: monochrome, or the tone the action means.
|
|
323
|
+
- **Don't** hide an action in the swipe alone: the menu, or the row's own screen, must offer it too.
|
|
324
|
+
|
|
325
|
+
## Accessibility
|
|
326
|
+
|
|
327
|
+
- The swipe is a shortcut. Every action is also in a menu button at the row's end, named "Actions for {label}": in the reading order always, drawn when it is focused or the row is hovered (`menu="auto"`), or always drawn (`menu="always"`).
|
|
328
|
+
- The tiles stay out of the reading order and the accessibility tree until a swipe opens them; then they are buttons, Tab reaches them, and "Actions shown: Archive, Delete" is read. A full swipe on a side of one reads the action it ran.
|
|
329
|
+
- Escape shuts an open row; a tap on the open row shuts it without following its link.
|
|
330
|
+
- Right to left the sides swap with the reading direction, and the swipe mirrors.
|
|
331
|
+
|
|
332
|
+
### Keyboard
|
|
333
|
+
|
|
334
|
+
| Key | What it does |
|
|
335
|
+
| --------------- | ----------------------------------------------------------- |
|
|
336
|
+
| Tab | Moves from the row to its menu button, which shows on focus |
|
|
337
|
+
| Enter / Space | On the menu button, opens the actions |
|
|
338
|
+
| Arrow Down / Up | In the menu, moves between the actions |
|
|
339
|
+
| Escape | Closes the menu, or shuts a row a swipe has opened |
|
|
340
|
+
|
|
341
|
+
---
|
|
342
|
+
|
|
343
|
+
- Import: `import { SwipeActions } from "@zonsh/ui"`
|
|
344
|
+
- Source: `packages/ui/src/components/swipe-actions.tsx`
|
|
@@ -0,0 +1,160 @@
|
|
|
1
|
+
# Switch
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Field, FieldLabel, Switch } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
export function Basic() {
|
|
7
|
+
return (
|
|
8
|
+
<Field>
|
|
9
|
+
<FieldLabel>
|
|
10
|
+
<Switch defaultChecked />
|
|
11
|
+
Email me when a deployment finishes
|
|
12
|
+
</FieldLabel>
|
|
13
|
+
</Field>
|
|
14
|
+
);
|
|
15
|
+
}
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
A recessed 38 × 22px track, a raised 18px thumb; on, the track takes `--primary`. A press stretches the thumb to 25px.
|
|
19
|
+
|
|
20
|
+
## Usage
|
|
21
|
+
|
|
22
|
+
```tsx
|
|
23
|
+
import { Field, FieldLabel, Switch } from "@zonsh/ui";
|
|
24
|
+
|
|
25
|
+
<Field>
|
|
26
|
+
<FieldLabel>
|
|
27
|
+
<Switch defaultChecked />
|
|
28
|
+
Email me when a deployment finishes
|
|
29
|
+
</FieldLabel>
|
|
30
|
+
</Field>;
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
- `checked` / `onCheckedChange` — control it.
|
|
34
|
+
- `disabled` — blocks changes.
|
|
35
|
+
- `nativeButton` — with `render={<button type="button" />}`, for a label beside it.
|
|
36
|
+
|
|
37
|
+
## When to use
|
|
38
|
+
|
|
39
|
+
- Settings that apply at once. In a form with a submit button, use a `Checkbox`.
|
|
40
|
+
|
|
41
|
+
## Examples
|
|
42
|
+
|
|
43
|
+
### Settings list
|
|
44
|
+
|
|
45
|
+
With the label beside the switch, render it as a native button so the label still works.
|
|
46
|
+
|
|
47
|
+
```tsx
|
|
48
|
+
import { Field, FieldDescription, FieldLabel, Switch } from "@zonsh/ui";
|
|
49
|
+
|
|
50
|
+
const settings = [
|
|
51
|
+
{
|
|
52
|
+
label: "Deployment emails",
|
|
53
|
+
description: "One message when a release goes live, with a link to the change log.",
|
|
54
|
+
on: true,
|
|
55
|
+
},
|
|
56
|
+
{
|
|
57
|
+
label: "Failed build alerts",
|
|
58
|
+
description: "Tell me straight away when a build stops halfway.",
|
|
59
|
+
on: true,
|
|
60
|
+
},
|
|
61
|
+
{
|
|
62
|
+
label: "Weekly summary",
|
|
63
|
+
description: "Builds, errors and time spent, every Monday morning.",
|
|
64
|
+
on: false,
|
|
65
|
+
},
|
|
66
|
+
];
|
|
67
|
+
|
|
68
|
+
export function SettingsList() {
|
|
69
|
+
return (
|
|
70
|
+
<div className="w-full max-w-lg">
|
|
71
|
+
{settings.map((setting) => (
|
|
72
|
+
<Field
|
|
73
|
+
key={setting.label}
|
|
74
|
+
className="flex-row items-center justify-between gap-6 border-t border-border/60 py-4 last:border-b"
|
|
75
|
+
>
|
|
76
|
+
<div className="flex flex-col gap-1">
|
|
77
|
+
<FieldLabel>{setting.label}</FieldLabel>
|
|
78
|
+
<FieldDescription>{setting.description}</FieldDescription>
|
|
79
|
+
</div>
|
|
80
|
+
<Switch defaultChecked={setting.on} nativeButton render={<button type="button" />} />
|
|
81
|
+
</Field>
|
|
82
|
+
))}
|
|
83
|
+
</div>
|
|
84
|
+
);
|
|
85
|
+
}
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
### States
|
|
89
|
+
|
|
90
|
+
```tsx
|
|
91
|
+
import { Field, FieldLabel, Switch } from "@zonsh/ui";
|
|
92
|
+
|
|
93
|
+
export function States() {
|
|
94
|
+
return (
|
|
95
|
+
<div className="flex flex-col gap-3">
|
|
96
|
+
<Field>
|
|
97
|
+
<FieldLabel>
|
|
98
|
+
<Switch />
|
|
99
|
+
Off
|
|
100
|
+
</FieldLabel>
|
|
101
|
+
</Field>
|
|
102
|
+
<Field>
|
|
103
|
+
<FieldLabel>
|
|
104
|
+
<Switch defaultChecked />
|
|
105
|
+
On
|
|
106
|
+
</FieldLabel>
|
|
107
|
+
</Field>
|
|
108
|
+
<Field disabled>
|
|
109
|
+
<FieldLabel>
|
|
110
|
+
<Switch />
|
|
111
|
+
Disabled
|
|
112
|
+
</FieldLabel>
|
|
113
|
+
</Field>
|
|
114
|
+
<Field disabled>
|
|
115
|
+
<FieldLabel>
|
|
116
|
+
<Switch defaultChecked />
|
|
117
|
+
Disabled and on
|
|
118
|
+
</FieldLabel>
|
|
119
|
+
</Field>
|
|
120
|
+
</div>
|
|
121
|
+
);
|
|
122
|
+
}
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
## Props
|
|
126
|
+
|
|
127
|
+
| Prop | Type | Default |
|
|
128
|
+
| ----------------- | ----------------------------------------- | ------- |
|
|
129
|
+
| `checked` | `boolean` | — |
|
|
130
|
+
| `defaultChecked` | `boolean` | `false` |
|
|
131
|
+
| `onCheckedChange` | `(checked: boolean, details) => void` | — |
|
|
132
|
+
| `disabled` | `boolean` | `false` |
|
|
133
|
+
| `readOnly` | `boolean` | `false` |
|
|
134
|
+
| `nativeButton` | `boolean`: set with `render={<button />}` | `false` |
|
|
135
|
+
|
|
136
|
+
Other Base UI props are forwarded. Data attributes: `data-checked`, `data-unchecked`, `data-disabled`, `data-invalid`.
|
|
137
|
+
|
|
138
|
+
## Brand rules
|
|
139
|
+
|
|
140
|
+
- **Do** label the setting ("Failed job alerts"), not the state.
|
|
141
|
+
- **Don't** flatten it: the track stays recessed, the thumb raised.
|
|
142
|
+
- **Don't** put "On"/"Off" or colour in the track.
|
|
143
|
+
- **Don't** use it for a value saved on submit.
|
|
144
|
+
|
|
145
|
+
## Accessibility
|
|
146
|
+
|
|
147
|
+
- `role="switch"` with `aria-checked`; a flush 2px `--control-focus` outline on focus.
|
|
148
|
+
- Still under reduced motion.
|
|
149
|
+
|
|
150
|
+
### Keyboard
|
|
151
|
+
|
|
152
|
+
| Key | What it does |
|
|
153
|
+
| ------------- | --------------------------- |
|
|
154
|
+
| Space / Enter | Turns the setting on or off |
|
|
155
|
+
|
|
156
|
+
---
|
|
157
|
+
|
|
158
|
+
- Import: `import { Switch } from "@zonsh/ui"`
|
|
159
|
+
- Source: `packages/ui/src/components/switch.tsx`
|
|
160
|
+
- Primitive: `@base-ui/react/switch` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/switch.md`)
|