@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,285 @@
|
|
|
1
|
+
# Stepper
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Button, Stepper, type StepperStep } from "@zonsh/ui";
|
|
5
|
+
import { ArrowLeftIcon } from "lucide-react";
|
|
6
|
+
import * as React from "react";
|
|
7
|
+
|
|
8
|
+
const checkout: StepperStep[] = [
|
|
9
|
+
{ title: "Basket" },
|
|
10
|
+
{ title: "Delivery" },
|
|
11
|
+
{ title: "Payment" },
|
|
12
|
+
{ title: "Review" },
|
|
13
|
+
];
|
|
14
|
+
|
|
15
|
+
export function Basic() {
|
|
16
|
+
const [step, setStep] = React.useState(1);
|
|
17
|
+
return (
|
|
18
|
+
<div className="flex w-full max-w-2xl flex-col gap-8">
|
|
19
|
+
<Stepper steps={checkout} value={step} aria-label="Checkout" />
|
|
20
|
+
<div className="flex justify-between gap-3">
|
|
21
|
+
<Button variant="ghost" disabled={step === 0} onClick={() => setStep((s) => Math.max(s - 1, 0))}>
|
|
22
|
+
<ArrowLeftIcon className="rtl:-scale-x-100" />
|
|
23
|
+
Back
|
|
24
|
+
</Button>
|
|
25
|
+
<Button
|
|
26
|
+
disabled={step === checkout.length}
|
|
27
|
+
onClick={() => setStep((s) => Math.min(s + 1, checkout.length))}
|
|
28
|
+
>
|
|
29
|
+
{step === checkout.length - 1 ? "Place order" : "Continue"}
|
|
30
|
+
</Button>
|
|
31
|
+
</div>
|
|
32
|
+
</div>
|
|
33
|
+
);
|
|
34
|
+
}
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
Mono indices on 24px round markers joined by hairlines: upcoming recessed and muted, current raised with the focus-grey edge, finished filled with a check, an error a red "!" with its text. Below about 8rem per step the row becomes the step in mono over a `Progress` track: "02 / 04 · Delivery".
|
|
38
|
+
|
|
39
|
+
## Usage
|
|
40
|
+
|
|
41
|
+
```tsx
|
|
42
|
+
import { Stepper } from "@zonsh/ui";
|
|
43
|
+
|
|
44
|
+
const steps = [{ title: "Basket" }, { title: "Delivery" }, { title: "Payment" }, { title: "Review" }];
|
|
45
|
+
|
|
46
|
+
<Stepper steps={steps} value={1} aria-label="Checkout" />;
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
- `steps` — the steps, each with a `title` (and optional `description`, `error`, `content`).
|
|
50
|
+
- `value` — the current step, from 0; earlier steps are complete, `steps.length` finishes all.
|
|
51
|
+
- `onValueChange` — makes finished steps buttons that go back.
|
|
52
|
+
|
|
53
|
+
## When to use
|
|
54
|
+
|
|
55
|
+
- Three to six steps done once, in order: checkout, setup, import. `vertical` when each step's form sits under its title; `compact` in a small card or dialog.
|
|
56
|
+
- Not for pages in any order (`Tabs`, `Sidebar`), two steps (one form), or a long form people want whole (sections on one page).
|
|
57
|
+
|
|
58
|
+
## Examples
|
|
59
|
+
|
|
60
|
+
### Descriptions
|
|
61
|
+
|
|
62
|
+
A line under each title says what the step asks for.
|
|
63
|
+
|
|
64
|
+
```tsx
|
|
65
|
+
import { Stepper } from "@zonsh/ui";
|
|
66
|
+
|
|
67
|
+
export function Descriptions() {
|
|
68
|
+
return (
|
|
69
|
+
<div className="w-full max-w-3xl">
|
|
70
|
+
<Stepper
|
|
71
|
+
aria-label="Import a notebook"
|
|
72
|
+
value={2}
|
|
73
|
+
steps={[
|
|
74
|
+
{ title: "Choose a file", description: "Markdown, HTML or a .zip export" },
|
|
75
|
+
{ title: "Map the folders", description: "Pick where each section goes" },
|
|
76
|
+
{ title: "Check the links", description: "Fix the ones that point nowhere" },
|
|
77
|
+
{ title: "Import", description: "Takes about a minute per thousand pages" },
|
|
78
|
+
]}
|
|
79
|
+
/>
|
|
80
|
+
</div>
|
|
81
|
+
);
|
|
82
|
+
}
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
### Vertical
|
|
86
|
+
|
|
87
|
+
The current step's `content` shows under it; each Continue moves on.
|
|
88
|
+
|
|
89
|
+
```tsx
|
|
90
|
+
import { Button, Stepper, type StepperStep } from "@zonsh/ui";
|
|
91
|
+
import * as React from "react";
|
|
92
|
+
|
|
93
|
+
const course: StepperStep[] = [
|
|
94
|
+
{ title: "Your details", description: "Name and email for the certificate" },
|
|
95
|
+
{ title: "Pick a cohort", description: "Starts on the first Monday of each month" },
|
|
96
|
+
{ title: "Prepare", description: "Install the tools before the first session" },
|
|
97
|
+
{ title: "First session", description: "A one-hour live introduction" },
|
|
98
|
+
];
|
|
99
|
+
|
|
100
|
+
export function Vertical() {
|
|
101
|
+
const [step, setStep] = React.useState(1);
|
|
102
|
+
const steps = course.map((s, i) =>
|
|
103
|
+
i === step
|
|
104
|
+
? {
|
|
105
|
+
...s,
|
|
106
|
+
content: (
|
|
107
|
+
<div className="flex flex-col gap-4">
|
|
108
|
+
<p className="m-0 text-sm text-foreground-soft">
|
|
109
|
+
{i === 1
|
|
110
|
+
? "The November cohort meets on Tuesdays and Thursdays at 18:00 CET."
|
|
111
|
+
: i === 2
|
|
112
|
+
? "You need Git, a code editor and Node 22 or later."
|
|
113
|
+
: i === 3
|
|
114
|
+
? "The link to the session arrives by email the day before."
|
|
115
|
+
: "Use the address you check most: the course sends its reminders there."}
|
|
116
|
+
</p>
|
|
117
|
+
<div className="flex gap-2">
|
|
118
|
+
<Button size="sm" onClick={() => setStep(i + 1)}>
|
|
119
|
+
Continue
|
|
120
|
+
</Button>
|
|
121
|
+
{i > 0 && (
|
|
122
|
+
<Button size="sm" variant="ghost" onClick={() => setStep(i - 1)}>
|
|
123
|
+
Back
|
|
124
|
+
</Button>
|
|
125
|
+
)}
|
|
126
|
+
</div>
|
|
127
|
+
</div>
|
|
128
|
+
),
|
|
129
|
+
}
|
|
130
|
+
: s,
|
|
131
|
+
);
|
|
132
|
+
return (
|
|
133
|
+
<div className="w-full max-w-md">
|
|
134
|
+
<Stepper orientation="vertical" steps={steps} value={step} aria-label="Course enrolment" />
|
|
135
|
+
</div>
|
|
136
|
+
);
|
|
137
|
+
}
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
### Going back
|
|
141
|
+
|
|
142
|
+
Finished steps go back on click; steps ahead stay plain — forward is the step's Continue.
|
|
143
|
+
|
|
144
|
+
```tsx
|
|
145
|
+
import { Stepper } from "@zonsh/ui";
|
|
146
|
+
import * as React from "react";
|
|
147
|
+
|
|
148
|
+
export function GoBack() {
|
|
149
|
+
const [step, setStep] = React.useState(3);
|
|
150
|
+
return (
|
|
151
|
+
<div className="flex w-full max-w-2xl flex-col gap-6">
|
|
152
|
+
<Stepper
|
|
153
|
+
aria-label="Publish a course"
|
|
154
|
+
steps={[{ title: "Outline" }, { title: "Lessons" }, { title: "Pricing" }, { title: "Publish" }]}
|
|
155
|
+
value={step}
|
|
156
|
+
onValueChange={setStep}
|
|
157
|
+
/>
|
|
158
|
+
<p className="m-0 text-sm text-muted-foreground">
|
|
159
|
+
Pick a finished step to go back to it. Steps ahead open from the step before them.
|
|
160
|
+
</p>
|
|
161
|
+
</div>
|
|
162
|
+
);
|
|
163
|
+
}
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
### Errors
|
|
167
|
+
|
|
168
|
+
`error` shows its text under the title, read after "Needs attention" — never only red.
|
|
169
|
+
|
|
170
|
+
```tsx
|
|
171
|
+
import { Stepper } from "@zonsh/ui";
|
|
172
|
+
|
|
173
|
+
export function Errors() {
|
|
174
|
+
return (
|
|
175
|
+
<div className="flex w-full max-w-2xl flex-col gap-10">
|
|
176
|
+
<Stepper
|
|
177
|
+
aria-label="Deploy"
|
|
178
|
+
value={3}
|
|
179
|
+
steps={[
|
|
180
|
+
{ title: "Build" },
|
|
181
|
+
{ title: "Test", error: "2 of 148 tests failed" },
|
|
182
|
+
{ title: "Preview" },
|
|
183
|
+
{ title: "Release" },
|
|
184
|
+
]}
|
|
185
|
+
/>
|
|
186
|
+
<Stepper
|
|
187
|
+
aria-label="Order a print"
|
|
188
|
+
orientation="vertical"
|
|
189
|
+
value={1}
|
|
190
|
+
steps={[
|
|
191
|
+
{ title: "Upload", description: "poster-final.pdf, 4.2 MB" },
|
|
192
|
+
{
|
|
193
|
+
title: "Check the file",
|
|
194
|
+
error: "The image is 72 dpi; a print at A2 needs at least 150.",
|
|
195
|
+
},
|
|
196
|
+
{ title: "Paper and size" },
|
|
197
|
+
{ title: "Pay" },
|
|
198
|
+
]}
|
|
199
|
+
/>
|
|
200
|
+
</div>
|
|
201
|
+
);
|
|
202
|
+
}
|
|
203
|
+
```
|
|
204
|
+
|
|
205
|
+
### Compact
|
|
206
|
+
|
|
207
|
+
Always the step over a track, read as "Step 2 of 3".
|
|
208
|
+
|
|
209
|
+
```tsx
|
|
210
|
+
import { Button, Field, FieldLabel, Input, Stepper } from "@zonsh/ui";
|
|
211
|
+
import * as React from "react";
|
|
212
|
+
|
|
213
|
+
export function Compact() {
|
|
214
|
+
const [step, setStep] = React.useState(1);
|
|
215
|
+
return (
|
|
216
|
+
<div className="flex w-full max-w-sm flex-col gap-6">
|
|
217
|
+
<Stepper
|
|
218
|
+
compact
|
|
219
|
+
steps={[{ title: "Account" }, { title: "Profile" }, { title: "Interests" }]}
|
|
220
|
+
value={step}
|
|
221
|
+
aria-label="Sign-up"
|
|
222
|
+
/>
|
|
223
|
+
<Field>
|
|
224
|
+
<FieldLabel>Display name</FieldLabel>
|
|
225
|
+
<Input defaultValue="Ines Duarte" />
|
|
226
|
+
</Field>
|
|
227
|
+
<div className="flex justify-between gap-3">
|
|
228
|
+
<Button variant="ghost" disabled={step === 0} onClick={() => setStep((s) => Math.max(s - 1, 0))}>
|
|
229
|
+
Back
|
|
230
|
+
</Button>
|
|
231
|
+
<Button disabled={step === 3} onClick={() => setStep((s) => Math.min(s + 1, 3))}>
|
|
232
|
+
{step >= 2 ? "Finish sign-up" : "Continue"}
|
|
233
|
+
</Button>
|
|
234
|
+
</div>
|
|
235
|
+
</div>
|
|
236
|
+
);
|
|
237
|
+
}
|
|
238
|
+
```
|
|
239
|
+
|
|
240
|
+
## Props
|
|
241
|
+
|
|
242
|
+
| Prop | Type | Default |
|
|
243
|
+
| --------------- | ----------------------------------------------------------- | ---------------------------------- |
|
|
244
|
+
| `steps` | `StepperStep[]` | required |
|
|
245
|
+
| `value` | `number` — the current step, 0-based | required |
|
|
246
|
+
| `onValueChange` | `(index: number) => void` — makes finished steps links back | — |
|
|
247
|
+
| `orientation` | `"horizontal" \| "vertical"` | `"horizontal"` |
|
|
248
|
+
| `compact` | `boolean \| "auto"` | `"auto"` in a row, `false` stacked |
|
|
249
|
+
| `aria-label` | `string` — names the list and the compact track | — |
|
|
250
|
+
| `labels` | `Partial<StepperMessages>` | English |
|
|
251
|
+
|
|
252
|
+
Each `StepperStep` has `title`, and optionally `description`, `error` (text; marks the step), `status` (`"upcoming" | "current" | "complete" | "error"`, overriding what `value` implies — a step done out of order), `disabled` (no link back) and `content` (under the current step, vertical only).
|
|
253
|
+
|
|
254
|
+
Other `<div>` props go to the root. Data attributes: `data-orientation` on the root, `data-status` on each `stepper-item` and `stepper-marker`, `data-complete` on a darkened `stepper-connector`. Interface text ("Completed", "Needs attention", "Step 2 of 4", "Done") comes from a `LocaleProvider` (`messages.stepper`) or `labels`.
|
|
255
|
+
|
|
256
|
+
## Brand rules
|
|
257
|
+
|
|
258
|
+
- **Do** name steps with a noun or two: "Delivery", "Payment". The step's heading can say more.
|
|
259
|
+
- **Do** keep one primary per step: "Continue", and on the last what it does — "Place order".
|
|
260
|
+
- **Do** put an error on the step it is about, in words, even after people have moved past it.
|
|
261
|
+
- **Don't** colour the markers; red is only for an error.
|
|
262
|
+
- **Don't** let people jump ahead to steps whose answers depend on earlier ones.
|
|
263
|
+
- **Don't** use a stepper for more than about six steps. Group them, or split the flow.
|
|
264
|
+
|
|
265
|
+
## Accessibility
|
|
266
|
+
|
|
267
|
+
- The steps are an ordered list; the current one has `aria-current="step"`. Name it with `aria-label` ("Checkout") when the page has more than one flow.
|
|
268
|
+
- Finished steps are read with "Completed", errors with "Needs attention" and the text. Markers are hidden.
|
|
269
|
+
- Steps that go back are buttons named by their title, with the 2px focus outline; the others are not focusable.
|
|
270
|
+
- The compact track is a `progressbar` named "02 / 04 · Delivery", valued "Step 2 of 4"; only one form is shown at a time.
|
|
271
|
+
- Move focus to the new step's heading when the step changes (see the Onboarding block).
|
|
272
|
+
|
|
273
|
+
### Keyboard
|
|
274
|
+
|
|
275
|
+
| Key | What it does |
|
|
276
|
+
| ------------- | ------------------------------------------ |
|
|
277
|
+
| Tab | Moves to each finished step that goes back |
|
|
278
|
+
| Enter / Space | Goes back to the focused step |
|
|
279
|
+
|
|
280
|
+
The other steps are not focusable, and the compact track has no keys.
|
|
281
|
+
|
|
282
|
+
---
|
|
283
|
+
|
|
284
|
+
- Import: `import { Stepper } from "@zonsh/ui"`
|
|
285
|
+
- Source: `packages/ui/src/components/stepper.tsx`
|
|
@@ -0,0 +1,146 @@
|
|
|
1
|
+
# Suggestions
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Suggestion, Suggestions } from "@zonsh/ui";
|
|
5
|
+
import * as React from "react";
|
|
6
|
+
|
|
7
|
+
const prompts = [
|
|
8
|
+
"Which assignments are due this week?",
|
|
9
|
+
"Quiz me on chapter 3",
|
|
10
|
+
"Explain recursion with a short example",
|
|
11
|
+
];
|
|
12
|
+
|
|
13
|
+
export function Basic() {
|
|
14
|
+
const [picked, setPicked] = React.useState<string | null>(null);
|
|
15
|
+
return (
|
|
16
|
+
<div className="flex w-full max-w-2xl flex-col gap-3">
|
|
17
|
+
<Suggestions>
|
|
18
|
+
{prompts.map((prompt) => (
|
|
19
|
+
<Suggestion key={prompt} suggestion={prompt} onClick={setPicked} />
|
|
20
|
+
))}
|
|
21
|
+
</Suggestions>
|
|
22
|
+
<p className="m-0 font-mono text-xs text-muted-foreground">
|
|
23
|
+
{picked ? `Picked: ${picked}` : "Nothing picked yet"}
|
|
24
|
+
</p>
|
|
25
|
+
</div>
|
|
26
|
+
);
|
|
27
|
+
}
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
Prompts as 30px raised buttons that wrap. Picking one calls `onClick` with the prompt, to send or to edit first.
|
|
31
|
+
|
|
32
|
+
## Usage
|
|
33
|
+
|
|
34
|
+
```tsx
|
|
35
|
+
import { Suggestion, Suggestions } from "@zonsh/ui";
|
|
36
|
+
|
|
37
|
+
<Suggestions>
|
|
38
|
+
<Suggestion suggestion="Which assignments are due this week?" onClick={send} />
|
|
39
|
+
</Suggestions>;
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
- `suggestion` — the prompt.
|
|
43
|
+
- `onClick` — send it, or fill the prompt bar.
|
|
44
|
+
- `disabled` — on `Suggestions`, while a reply streams.
|
|
45
|
+
|
|
46
|
+
## When to use
|
|
47
|
+
|
|
48
|
+
- In an empty chat, or under the last reply. Actions that aren't prompts are `Button`s.
|
|
49
|
+
|
|
50
|
+
## Examples
|
|
51
|
+
|
|
52
|
+
### While a reply streams
|
|
53
|
+
|
|
54
|
+
The row dims but stays in place and in the tab order; focus stays on the one just picked. Disable the prompt bar's send too.
|
|
55
|
+
|
|
56
|
+
```tsx
|
|
57
|
+
import { Suggestion, Suggestions } from "@zonsh/ui";
|
|
58
|
+
import * as React from "react";
|
|
59
|
+
|
|
60
|
+
const followUps = ["Make it shorter", "Add a packing list", "What if it rains?"];
|
|
61
|
+
|
|
62
|
+
const REPLY_TIME = 1500;
|
|
63
|
+
|
|
64
|
+
/**
|
|
65
|
+
* Picking a follow-up sends it; while the reply streams the row is disabled, so a second prompt
|
|
66
|
+
* can't jump the queue. The suggestions stay where they are, and focus stays on the one picked.
|
|
67
|
+
*/
|
|
68
|
+
export function WhileStreaming() {
|
|
69
|
+
const [asked, setAsked] = React.useState<string | null>(null);
|
|
70
|
+
const [streaming, setStreaming] = React.useState(false);
|
|
71
|
+
const timer = React.useRef<ReturnType<typeof setTimeout>>(undefined);
|
|
72
|
+
React.useEffect(() => () => clearTimeout(timer.current), []);
|
|
73
|
+
const send = (prompt: string) => {
|
|
74
|
+
setAsked(prompt);
|
|
75
|
+
setStreaming(true);
|
|
76
|
+
timer.current = setTimeout(() => setStreaming(false), REPLY_TIME);
|
|
77
|
+
};
|
|
78
|
+
return (
|
|
79
|
+
<div className="flex w-full max-w-2xl flex-col gap-3">
|
|
80
|
+
<Suggestions disabled={streaming} aria-label="Follow-up questions">
|
|
81
|
+
{followUps.map((prompt) => (
|
|
82
|
+
<Suggestion key={prompt} suggestion={prompt} onClick={send} />
|
|
83
|
+
))}
|
|
84
|
+
</Suggestions>
|
|
85
|
+
<p aria-live="polite" className="m-0 font-mono text-xs text-muted-foreground">
|
|
86
|
+
{streaming
|
|
87
|
+
? `Answering “${asked}”…`
|
|
88
|
+
: asked
|
|
89
|
+
? `Answered “${asked}”`
|
|
90
|
+
: "Plan for a day walk on the coast"}
|
|
91
|
+
</p>
|
|
92
|
+
</div>
|
|
93
|
+
);
|
|
94
|
+
}
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
### Fill the prompt instead
|
|
98
|
+
|
|
99
|
+
For a start rather than a whole question.
|
|
100
|
+
|
|
101
|
+
```tsx
|
|
102
|
+
<Suggestions>
|
|
103
|
+
<Suggestion suggestion="Summarise this week's changes to " onClick={setPrompt}>
|
|
104
|
+
Summarise changes…
|
|
105
|
+
</Suggestion>
|
|
106
|
+
<Suggestion suggestion="Write release notes for " onClick={setPrompt}>
|
|
107
|
+
Release notes…
|
|
108
|
+
</Suggestion>
|
|
109
|
+
</Suggestions>
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
### Under a reply
|
|
113
|
+
|
|
114
|
+
```tsx
|
|
115
|
+
<Suggestions>
|
|
116
|
+
{followUps.map((prompt) => (
|
|
117
|
+
<Suggestion key={prompt} suggestion={prompt} onClick={send} />
|
|
118
|
+
))}
|
|
119
|
+
</Suggestions>
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
## Props
|
|
123
|
+
|
|
124
|
+
| Component | Prop | Type | Default |
|
|
125
|
+
| ------------- | ------------ | ------------------------------ | ---------- |
|
|
126
|
+
| `Suggestions` | `disabled` | `boolean` — disables every one | `false` |
|
|
127
|
+
| `Suggestion` | `suggestion` | `string` — the prompt | — |
|
|
128
|
+
| | `onClick` | `(suggestion: string) => void` | — |
|
|
129
|
+
| | `children` | a shorter label | the prompt |
|
|
130
|
+
|
|
131
|
+
`Suggestion` forwards `Button` props (`disabled` for one alone). `Suggestions` forwards `<div>` props and writes `data-disabled`.
|
|
132
|
+
|
|
133
|
+
## Brand rules
|
|
134
|
+
|
|
135
|
+
- **Do** write them as the person would ask: "Which assignments are due this week?", not "Assignment status".
|
|
136
|
+
- **Don't** show more than four, or under every reply.
|
|
137
|
+
|
|
138
|
+
## Accessibility
|
|
139
|
+
|
|
140
|
+
- Each is a button named by its full prompt, even when truncated or relabelled.
|
|
141
|
+
- Disabled, each is `aria-disabled` and stays focusable, so focus isn't lost while the reply streams.
|
|
142
|
+
|
|
143
|
+
---
|
|
144
|
+
|
|
145
|
+
- Import: `import { Suggestions, Suggestion } from "@zonsh/ui"`
|
|
146
|
+
- Source: `packages/ui/src/components/suggestions.tsx`
|