@zonsh/ui 0.5.0 → 0.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +639 -0
- package/README.md +49 -21
- package/dist/brand.d.ts +3 -0
- package/dist/brand.js +7 -0
- package/dist/components/_breadcrumb-more.d.ts +6 -0
- package/dist/components/_breadcrumb-more.js +5 -0
- package/dist/components/_drawing-svg.d.ts +11 -0
- package/dist/components/_drawing-svg.js +30 -0
- package/dist/components/_media.d.ts +159 -0
- package/dist/components/_media.js +266 -0
- package/dist/components/_overlay.d.ts +8 -5
- package/dist/components/_overlay.js +11 -6
- package/dist/components/_scheduler-calendar.d.ts +71 -0
- package/dist/components/_scheduler-calendar.js +940 -0
- package/dist/components/_scheduler-editor.d.ts +29 -0
- package/dist/components/_scheduler-editor.js +111 -0
- package/dist/components/_scheduler-menu.d.ts +16 -0
- package/dist/components/_scheduler-menu.js +18 -0
- package/dist/components/_scheduler-parts.d.ts +164 -0
- package/dist/components/_scheduler-parts.js +327 -0
- package/dist/components/_suggest-list.d.ts +142 -0
- package/dist/components/_suggest-list.js +159 -0
- package/dist/components/_toolbar-more.d.ts +24 -0
- package/dist/components/_toolbar-more.js +25 -0
- package/dist/components/accordion.d.ts +1 -1
- package/dist/components/accordion.js +6 -6
- package/dist/components/action-sheet.d.ts +88 -0
- package/dist/components/action-sheet.js +124 -0
- package/dist/components/alert-dialog.js +3 -1
- package/dist/components/alert.d.ts +11 -18
- package/dist/components/alert.js +9 -6
- package/dist/components/app-bar.d.ts +93 -0
- package/dist/components/app-bar.js +175 -0
- package/dist/components/audio-player.d.ts +134 -0
- package/dist/components/audio-player.js +618 -0
- package/dist/components/avatar.d.ts +6 -6
- package/dist/components/avatar.js +13 -11
- package/dist/components/badge.d.ts +12 -12
- package/dist/components/badge.js +7 -5
- package/dist/components/bottom-nav.d.ts +53 -11
- package/dist/components/bottom-nav.js +388 -23
- package/dist/components/breadcrumb.d.ts +11 -2
- package/dist/components/breadcrumb.js +60 -6
- package/dist/components/button-group.js +5 -1
- package/dist/components/button.d.ts +23 -6
- package/dist/components/button.js +63 -7
- package/dist/components/calendar.js +8 -6
- package/dist/components/card.d.ts +10 -8
- package/dist/components/card.js +15 -14
- package/dist/components/carousel.d.ts +2 -2
- package/dist/components/carousel.js +21 -8
- package/dist/components/chart.d.ts +27 -1
- package/dist/components/chart.js +15 -5
- package/dist/components/checkbox.js +2 -2
- package/dist/components/code-block.d.ts +9 -2
- package/dist/components/code-block.js +26 -7
- package/dist/components/collapsible.js +3 -3
- package/dist/components/color-picker.d.ts +2 -2
- package/dist/components/color-picker.js +5 -5
- package/dist/components/combobox.d.ts +26 -7
- package/dist/components/combobox.js +32 -13
- package/dist/components/command.d.ts +29 -5
- package/dist/components/command.js +35 -10
- package/dist/components/context-menu.d.ts +5 -2
- package/dist/components/context-menu.js +24 -3
- package/dist/components/conversation.d.ts +1 -1
- package/dist/components/conversation.js +67 -13
- package/dist/components/copy-button.d.ts +1 -1
- package/dist/components/copy-button.js +1 -1
- package/dist/components/data-table.d.ts +6 -6
- package/dist/components/data-table.js +41 -15
- package/dist/components/date-picker.d.ts +31 -9
- package/dist/components/date-picker.js +100 -18
- package/dist/components/dialog.d.ts +17 -10
- package/dist/components/dialog.js +20 -13
- package/dist/components/drawer.d.ts +26 -8
- package/dist/components/drawer.js +75 -16
- package/dist/components/drawing.d.ts +25 -0
- package/dist/components/drawing.js +32 -0
- package/dist/components/empty.js +2 -2
- package/dist/components/feature-list.d.ts +65 -13
- package/dist/components/feature-list.js +116 -15
- package/dist/components/field.js +2 -2
- package/dist/components/file-drop.d.ts +9 -7
- package/dist/components/file-drop.js +8 -43
- package/dist/components/filter-bar.d.ts +10 -9
- package/dist/components/filter-bar.js +42 -25
- package/dist/components/graph.d.ts +19 -3
- package/dist/components/graph.js +170 -25
- package/dist/components/illustration.js +3 -28
- package/dist/components/input-group.d.ts +5 -10
- package/dist/components/input-group.js +16 -16
- package/dist/components/input.d.ts +2 -2
- package/dist/components/input.js +3 -3
- package/dist/components/item.d.ts +9 -6
- package/dist/components/item.js +13 -8
- package/dist/components/kbd.d.ts +1 -1
- package/dist/components/kbd.js +1 -1
- package/dist/components/lightbox.d.ts +76 -9
- package/dist/components/lightbox.js +333 -45
- package/dist/components/locale.d.ts +6 -6
- package/dist/components/logo.d.ts +21 -1
- package/dist/components/logo.js +32 -2
- package/dist/components/markdown-editor.d.ts +275 -0
- package/dist/components/markdown-editor.js +831 -0
- package/dist/components/mentions.d.ts +153 -0
- package/dist/components/mentions.js +507 -0
- package/dist/components/menu.d.ts +2 -1
- package/dist/components/menu.js +5 -4
- package/dist/components/menubar.d.ts +23 -5
- package/dist/components/menubar.js +97 -22
- package/dist/components/message.d.ts +62 -11
- package/dist/components/message.js +49 -13
- package/dist/components/meter.js +1 -1
- package/dist/components/money-input.d.ts +1 -1
- package/dist/components/money-input.js +1 -1
- package/dist/components/native-select.d.ts +2 -2
- package/dist/components/native-select.js +4 -4
- package/dist/components/navigation-menu.d.ts +3 -1
- package/dist/components/navigation-menu.js +23 -12
- package/dist/components/number-field.d.ts +2 -9
- package/dist/components/number-field.js +86 -36
- package/dist/components/number-roll.d.ts +26 -0
- package/dist/components/number-roll.js +81 -0
- package/dist/components/otp-field.d.ts +1 -1
- package/dist/components/otp-field.js +24 -3
- package/dist/components/pagination.d.ts +11 -3
- package/dist/components/pagination.js +59 -13
- package/dist/components/pdf-viewer.d.ts +1 -1
- package/dist/components/pdf-viewer.js +8 -8
- package/dist/components/phone-input.d.ts +1 -1
- package/dist/components/phone-input.js +2 -2
- package/dist/components/popover.js +5 -3
- package/dist/components/preview-card.d.ts +37 -2
- package/dist/components/preview-card.js +226 -2
- package/dist/components/progress.js +1 -1
- package/dist/components/prompt-input.d.ts +1 -1
- package/dist/components/prompt-input.js +24 -14
- package/dist/components/pull-to-refresh.d.ts +50 -0
- package/dist/components/pull-to-refresh.js +189 -0
- package/dist/components/quote.d.ts +6 -1
- package/dist/components/quote.js +3 -2
- package/dist/components/radio-group.js +1 -1
- package/dist/components/rating.d.ts +4 -1
- package/dist/components/rating.js +131 -10
- package/dist/components/reasoning.d.ts +1 -1
- package/dist/components/reasoning.js +7 -3
- package/dist/components/resizable.d.ts +1 -1
- package/dist/components/resizable.js +2 -2
- package/dist/components/response.d.ts +1 -1
- package/dist/components/response.js +18 -6
- package/dist/components/scheduler.d.ts +352 -0
- package/dist/components/scheduler.js +1717 -0
- package/dist/components/scroll-area.js +1 -1
- package/dist/components/select.d.ts +17 -4
- package/dist/components/select.js +140 -9
- package/dist/components/separator.d.ts +1 -1
- package/dist/components/separator.js +3 -3
- package/dist/components/sidebar.d.ts +44 -3
- package/dist/components/sidebar.js +57 -17
- package/dist/components/site-header.d.ts +18 -13
- package/dist/components/site-header.js +23 -11
- package/dist/components/skeleton.d.ts +17 -7
- package/dist/components/skeleton.js +22 -7
- package/dist/components/slider.js +2 -2
- package/dist/components/sortable.d.ts +55 -4
- package/dist/components/sortable.js +172 -103
- package/dist/components/sources.d.ts +1 -1
- package/dist/components/sources.js +2 -2
- package/dist/components/spinner.d.ts +4 -4
- package/dist/components/spinner.js +4 -4
- package/dist/components/stat.d.ts +21 -4
- package/dist/components/stat.js +17 -8
- package/dist/components/stepper.d.ts +1 -1
- package/dist/components/stepper.js +8 -7
- package/dist/components/suggestions.d.ts +11 -3
- package/dist/components/suggestions.js +10 -4
- package/dist/components/swipe-actions.d.ts +66 -0
- package/dist/components/swipe-actions.js +292 -0
- package/dist/components/switch.js +1 -1
- package/dist/components/table.d.ts +12 -6
- package/dist/components/table.js +78 -30
- package/dist/components/tabs.js +7 -4
- package/dist/components/tag.d.ts +19 -20
- package/dist/components/tag.js +9 -5
- package/dist/components/tags-input.d.ts +2 -7
- package/dist/components/tags-input.js +11 -8
- package/dist/components/textarea.d.ts +3 -2
- package/dist/components/textarea.js +4 -3
- package/dist/components/theme.d.ts +49 -6
- package/dist/components/theme.js +147 -9
- package/dist/components/time-field.d.ts +4 -9
- package/dist/components/time-field.js +6 -6
- package/dist/components/timeline.d.ts +19 -3
- package/dist/components/timeline.js +21 -9
- package/dist/components/tippy.d.ts +17 -1
- package/dist/components/tippy.js +95 -15
- package/dist/components/toast.d.ts +2 -7
- package/dist/components/toast.js +12 -8
- package/dist/components/toggle-group.d.ts +7 -1
- package/dist/components/toggle-group.js +16 -5
- package/dist/components/toggle.d.ts +2 -2
- package/dist/components/toggle.js +3 -2
- package/dist/components/tool-call.d.ts +1 -1
- package/dist/components/tool-call.js +4 -4
- package/dist/components/toolbar.d.ts +57 -4
- package/dist/components/toolbar.js +216 -16
- package/dist/components/tooltip.d.ts +1 -1
- package/dist/components/tooltip.js +4 -2
- package/dist/components/tour.d.ts +1 -1
- package/dist/components/tour.js +36 -15
- package/dist/components/tree.js +5 -5
- package/dist/components/typography.d.ts +31 -8
- package/dist/components/typography.js +21 -10
- package/dist/components/video-player.d.ts +7 -2
- package/dist/components/video-player.js +121 -220
- package/dist/index.d.ts +99 -92
- package/dist/index.js +99 -92
- package/dist/lib/calendar.d.ts +153 -0
- package/dist/lib/calendar.js +312 -0
- package/dist/lib/cn.d.ts +3 -1
- package/dist/lib/cn.js +5 -0
- package/dist/lib/code-highlight.d.ts +14 -0
- package/dist/lib/code-highlight.js +81 -18
- package/dist/lib/drag.d.ts +39 -0
- package/dist/lib/drag.js +96 -0
- package/dist/lib/editorial-assets.js +16 -8
- package/dist/lib/figure/figures/automation.js +25 -6
- package/dist/lib/figure/figures/bar-chart.js +6 -1
- package/dist/lib/figure/figures/brackets-classic.js +4 -1
- package/dist/lib/figure/figures/city.js +12 -2
- package/dist/lib/figure/figures/conveyor.js +17 -4
- package/dist/lib/figure/figures/database.js +5 -2
- package/dist/lib/figure/figures/documents.js +11 -3
- package/dist/lib/figure/figures/inbox.js +5 -2
- package/dist/lib/figure/figures/laptop.js +3 -1
- package/dist/lib/figure/figures/pipeline.js +45 -10
- package/dist/lib/figure/figures/platform.js +62 -7
- package/dist/lib/figure/figures/server.js +21 -5
- package/dist/lib/figure/figures/spreadsheet.js +29 -5
- package/dist/lib/figure/kernel.d.ts +4 -2
- package/dist/lib/figure/kernel.js +10 -5
- package/dist/lib/figure/parts.js +6 -2
- package/dist/lib/files.d.ts +31 -0
- package/dist/lib/files.js +60 -0
- package/dist/lib/gesture.d.ts +70 -0
- package/dist/lib/gesture.js +141 -0
- package/dist/lib/glide.d.ts +5 -0
- package/dist/lib/glide.js +9 -1
- package/dist/lib/icons.d.ts +1 -0
- package/dist/lib/icons.js +6 -0
- package/dist/lib/illustration-library.js +1 -6
- package/dist/lib/markdown-edit.d.ts +112 -0
- package/dist/lib/markdown-edit.js +557 -0
- package/dist/lib/markdown-rich-editor.d.ts +188 -0
- package/dist/lib/markdown-rich-editor.js +1153 -0
- package/dist/lib/markdown-rich.d.ts +63 -0
- package/dist/lib/markdown-rich.js +534 -0
- package/dist/lib/mentions.d.ts +100 -0
- package/dist/lib/mentions.js +246 -0
- package/dist/lib/motion.d.ts +18 -0
- package/dist/lib/motion.js +43 -5
- package/dist/lib/number-roll.d.ts +89 -0
- package/dist/lib/number-roll.js +391 -0
- package/dist/lib/platform.d.ts +6 -0
- package/dist/lib/platform.js +14 -0
- package/dist/lib/portal-container.d.ts +9 -0
- package/dist/lib/portal-container.js +10 -0
- package/dist/lib/press.d.ts +5 -0
- package/dist/lib/press.js +186 -0
- package/dist/lib/scheduler.d.ts +128 -0
- package/dist/lib/scheduler.js +272 -0
- package/dist/lib/scroll-edges.d.ts +9 -0
- package/dist/lib/scroll-edges.js +50 -0
- package/dist/lib/table-fit.d.ts +1 -1
- package/dist/lib/table-fit.js +65 -8
- package/dist/lib/theme-preset.d.ts +267 -0
- package/dist/lib/theme-preset.js +1046 -0
- package/dist/lib/theme-script.d.ts +23 -3
- package/dist/lib/theme-script.js +17 -5
- package/dist/lib/tippy/sprite.d.ts +36 -4
- package/dist/lib/tippy/sprite.js +188 -15
- package/dist/lib/tone.d.ts +4 -0
- package/dist/lib/tone.js +1 -0
- package/dist/messages/de.d.ts +3 -3
- package/dist/messages/de.js +274 -3
- package/dist/skills/zon-ui/SKILL.md +279 -0
- package/dist/skills/zon-ui/references/authoring.md +265 -0
- package/dist/skills/zon-ui/references/brand.md +416 -0
- package/dist/skills/zon-ui/references/components/accordion.md +199 -0
- package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
- package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
- package/dist/skills/zon-ui/references/components/alert.md +167 -0
- package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
- package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
- package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
- package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
- package/dist/skills/zon-ui/references/components/avatar.md +98 -0
- package/dist/skills/zon-ui/references/components/badge.md +227 -0
- package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
- package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
- package/dist/skills/zon-ui/references/components/button-group.md +216 -0
- package/dist/skills/zon-ui/references/components/button.md +309 -0
- package/dist/skills/zon-ui/references/components/calendar.md +296 -0
- package/dist/skills/zon-ui/references/components/card.md +158 -0
- package/dist/skills/zon-ui/references/components/carousel.md +297 -0
- package/dist/skills/zon-ui/references/components/chart.md +739 -0
- package/dist/skills/zon-ui/references/components/chat.md +417 -0
- package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
- package/dist/skills/zon-ui/references/components/code-block.md +143 -0
- package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
- package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
- package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
- package/dist/skills/zon-ui/references/components/combobox.md +455 -0
- package/dist/skills/zon-ui/references/components/command.md +326 -0
- package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
- package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
- package/dist/skills/zon-ui/references/components/conversation.md +146 -0
- package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
- package/dist/skills/zon-ui/references/components/crm.md +1022 -0
- package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
- package/dist/skills/zon-ui/references/components/data-table.md +776 -0
- package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
- package/dist/skills/zon-ui/references/components/dialog.md +335 -0
- package/dist/skills/zon-ui/references/components/direction.md +165 -0
- package/dist/skills/zon-ui/references/components/drawer.md +276 -0
- package/dist/skills/zon-ui/references/components/drawing.md +94 -0
- package/dist/skills/zon-ui/references/components/empty.md +225 -0
- package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
- package/dist/skills/zon-ui/references/components/field.md +209 -0
- package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
- package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
- package/dist/skills/zon-ui/references/components/form.md +970 -0
- package/dist/skills/zon-ui/references/components/graph.md +339 -0
- package/dist/skills/zon-ui/references/components/illustration.md +497 -0
- package/dist/skills/zon-ui/references/components/inbox.md +263 -0
- package/dist/skills/zon-ui/references/components/input-group.md +339 -0
- package/dist/skills/zon-ui/references/components/input.md +189 -0
- package/dist/skills/zon-ui/references/components/item.md +277 -0
- package/dist/skills/zon-ui/references/components/kanban.md +626 -0
- package/dist/skills/zon-ui/references/components/kbd.md +116 -0
- package/dist/skills/zon-ui/references/components/label.md +104 -0
- package/dist/skills/zon-ui/references/components/layout.md +291 -0
- package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
- package/dist/skills/zon-ui/references/components/locale.md +279 -0
- package/dist/skills/zon-ui/references/components/logo.md +257 -0
- package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
- package/dist/skills/zon-ui/references/components/mentions.md +512 -0
- package/dist/skills/zon-ui/references/components/menu.md +218 -0
- package/dist/skills/zon-ui/references/components/menubar.md +292 -0
- package/dist/skills/zon-ui/references/components/message.md +243 -0
- package/dist/skills/zon-ui/references/components/meter.md +105 -0
- package/dist/skills/zon-ui/references/components/money-input.md +333 -0
- package/dist/skills/zon-ui/references/components/native-select.md +197 -0
- package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
- package/dist/skills/zon-ui/references/components/number-field.md +210 -0
- package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
- package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
- package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
- package/dist/skills/zon-ui/references/components/pagination.md +109 -0
- package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
- package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
- package/dist/skills/zon-ui/references/components/popover.md +176 -0
- package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
- package/dist/skills/zon-ui/references/components/pricing.md +724 -0
- package/dist/skills/zon-ui/references/components/progress.md +92 -0
- package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
- package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
- package/dist/skills/zon-ui/references/components/quote.md +115 -0
- package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
- package/dist/skills/zon-ui/references/components/rating.md +260 -0
- package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
- package/dist/skills/zon-ui/references/components/resizable.md +213 -0
- package/dist/skills/zon-ui/references/components/response.md +170 -0
- package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
- package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
- package/dist/skills/zon-ui/references/components/select.md +351 -0
- package/dist/skills/zon-ui/references/components/separator.md +103 -0
- package/dist/skills/zon-ui/references/components/settings.md +793 -0
- package/dist/skills/zon-ui/references/components/shop.md +1715 -0
- package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
- package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
- package/dist/skills/zon-ui/references/components/site-header.md +303 -0
- package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
- package/dist/skills/zon-ui/references/components/slider.md +172 -0
- package/dist/skills/zon-ui/references/components/sortable.md +405 -0
- package/dist/skills/zon-ui/references/components/sources.md +106 -0
- package/dist/skills/zon-ui/references/components/spinner.md +222 -0
- package/dist/skills/zon-ui/references/components/stat.md +267 -0
- package/dist/skills/zon-ui/references/components/stepper.md +285 -0
- package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
- package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
- package/dist/skills/zon-ui/references/components/switch.md +160 -0
- package/dist/skills/zon-ui/references/components/table.md +999 -0
- package/dist/skills/zon-ui/references/components/tabs.md +258 -0
- package/dist/skills/zon-ui/references/components/tag.md +115 -0
- package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
- package/dist/skills/zon-ui/references/components/textarea.md +95 -0
- package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
- package/dist/skills/zon-ui/references/components/theme.md +362 -0
- package/dist/skills/zon-ui/references/components/time-field.md +222 -0
- package/dist/skills/zon-ui/references/components/timeline.md +285 -0
- package/dist/skills/zon-ui/references/components/tippy.md +243 -0
- package/dist/skills/zon-ui/references/components/toast.md +220 -0
- package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
- package/dist/skills/zon-ui/references/components/toggle.md +167 -0
- package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
- package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
- package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
- package/dist/skills/zon-ui/references/components/tour.md +423 -0
- package/dist/skills/zon-ui/references/components/tree.md +481 -0
- package/dist/skills/zon-ui/references/components/typography.md +347 -0
- package/dist/skills/zon-ui/references/components/video-player.md +386 -0
- package/dist/skills/zon-ui/references/marketing.md +467 -0
- package/dist/skills/zon-ui/references/motion.md +455 -0
- package/dist/skills/zon-ui/references/recipes.md +1232 -0
- package/dist/skills/zon-ui/references/tokens.md +866 -0
- package/dist/sources/accordion.css +4 -0
- package/dist/sources/action-sheet.css +11 -0
- package/dist/sources/alert-dialog.css +6 -0
- package/dist/sources/alert.css +3 -0
- package/dist/sources/app-bar.css +14 -0
- package/dist/sources/ascii-field.css +3 -0
- package/dist/sources/aspect-ratio.css +3 -0
- package/dist/sources/audio-player.css +20 -0
- package/dist/sources/avatar.css +3 -0
- package/dist/sources/badge.css +3 -0
- package/dist/sources/bottom-nav.css +9 -0
- package/dist/sources/breadcrumb.css +14 -0
- package/dist/sources/button-group.css +3 -0
- package/dist/sources/button.css +9 -0
- package/dist/sources/calendar.css +13 -0
- package/dist/sources/card.css +3 -0
- package/dist/sources/carousel.css +11 -0
- package/dist/sources/chart.css +5 -0
- package/dist/sources/checkbox.css +6 -0
- package/dist/sources/code-block.css +13 -0
- package/dist/sources/collapsible.css +4 -0
- package/dist/sources/color-picker.css +13 -0
- package/dist/sources/combobox.css +13 -0
- package/dist/sources/command.css +13 -0
- package/dist/sources/context-menu.css +12 -0
- package/dist/sources/conversation.css +10 -0
- package/dist/sources/copy-button.css +10 -0
- package/dist/sources/data-table.css +27 -0
- package/dist/sources/date-picker.css +20 -0
- package/dist/sources/dialog.css +9 -0
- package/dist/sources/direction.css +2 -0
- package/dist/sources/drawer.css +9 -0
- package/dist/sources/drawing.css +5 -0
- package/dist/sources/empty.css +3 -0
- package/dist/sources/feature-list.css +4 -0
- package/dist/sources/field.css +4 -0
- package/dist/sources/file-drop.css +15 -0
- package/dist/sources/filter-bar.css +30 -0
- package/dist/sources/form.css +4 -0
- package/dist/sources/graph.css +19 -0
- package/dist/sources/illustration.css +28 -0
- package/dist/sources/input-group.css +7 -0
- package/dist/sources/input.css +3 -0
- package/dist/sources/item.css +4 -0
- package/dist/sources/kbd.css +5 -0
- package/dist/sources/label.css +3 -0
- package/dist/sources/layout.css +3 -0
- package/dist/sources/lightbox.css +33 -0
- package/dist/sources/locale.css +2 -0
- package/dist/sources/logo.css +4 -0
- package/dist/sources/markdown-editor.css +41 -0
- package/dist/sources/mentions.css +13 -0
- package/dist/sources/menu.css +11 -0
- package/dist/sources/menubar.css +14 -0
- package/dist/sources/message.css +16 -0
- package/dist/sources/meter.css +4 -0
- package/dist/sources/money-input.css +10 -0
- package/dist/sources/native-select.css +4 -0
- package/dist/sources/navigation-menu.css +8 -0
- package/dist/sources/number-field.css +8 -0
- package/dist/sources/number-roll.css +6 -0
- package/dist/sources/otp-field.css +5 -0
- package/dist/sources/pagination.css +11 -0
- package/dist/sources/pdf-viewer.css +30 -0
- package/dist/sources/phone-input.css +20 -0
- package/dist/sources/popover.css +7 -0
- package/dist/sources/preview-card.css +7 -0
- package/dist/sources/progress.css +4 -0
- package/dist/sources/prompt-input.css +15 -0
- package/dist/sources/pull-to-refresh.css +14 -0
- package/dist/sources/quote.css +3 -0
- package/dist/sources/radio-group.css +5 -0
- package/dist/sources/rating.css +6 -0
- package/dist/sources/reasoning.css +6 -0
- package/dist/sources/resizable.css +4 -0
- package/dist/sources/response.css +16 -0
- package/dist/sources/scheduler.css +44 -0
- package/dist/sources/scroll-area.css +3 -0
- package/dist/sources/select.css +12 -0
- package/dist/sources/separator.css +3 -0
- package/dist/sources/sidebar.css +19 -0
- package/dist/sources/site-header.css +15 -0
- package/dist/sources/skeleton.css +3 -0
- package/dist/sources/slider.css +6 -0
- package/dist/sources/sortable.css +12 -0
- package/dist/sources/sources.css +6 -0
- package/dist/sources/spinner.css +6 -0
- package/dist/sources/stat.css +9 -0
- package/dist/sources/stepper.css +6 -0
- package/dist/sources/suggestions.css +10 -0
- package/dist/sources/swipe-actions.css +20 -0
- package/dist/sources/switch.css +5 -0
- package/dist/sources/table.css +7 -0
- package/dist/sources/tabs.css +5 -0
- package/dist/sources/tag.css +3 -0
- package/dist/sources/tags-input.css +6 -0
- package/dist/sources/textarea.css +3 -0
- package/dist/sources/theme.css +13 -0
- package/dist/sources/time-field.css +7 -0
- package/dist/sources/timeline.css +7 -0
- package/dist/sources/tippy.css +6 -0
- package/dist/sources/toast.css +6 -0
- package/dist/sources/toggle-group.css +5 -0
- package/dist/sources/toggle.css +3 -0
- package/dist/sources/tool-call.css +16 -0
- package/dist/sources/toolbar.css +14 -0
- package/dist/sources/tooltip.css +6 -0
- package/dist/sources/tour.css +14 -0
- package/dist/sources/tree.css +6 -0
- package/dist/sources/typography.css +4 -0
- package/dist/sources/video-player.css +21 -0
- package/dist/styles/ai.css +3 -0
- package/dist/styles/brand.css +98 -0
- package/dist/styles/core.css +266 -0
- package/dist/styles/editor.css +3 -0
- package/dist/styles/expressive.css +35 -56
- package/dist/styles/fonts.css +61 -117
- package/dist/styles/graph.css +4 -0
- package/dist/styles/illustration.css +4 -0
- package/dist/styles/index.css +11 -201
- package/dist/styles/material.css +138 -12
- package/dist/styles/parts/ai.css +18 -13
- package/dist/styles/parts/brand.css +2 -2
- package/dist/styles/parts/controls.css +29 -20
- package/dist/styles/parts/data.css +13 -9
- package/dist/styles/parts/editor.css +372 -0
- package/dist/styles/parts/feedback.css +32 -2
- package/dist/styles/parts/foundations.css +12 -7
- package/dist/styles/parts/graph.css +25 -9
- package/dist/styles/parts/inputs.css +172 -9
- package/dist/styles/parts/isometric.css +6 -5
- package/dist/styles/parts/navigation.css +206 -27
- package/dist/styles/parts/overlays.css +19 -4
- package/dist/styles/parts/pdf.css +2 -2
- package/dist/styles/pdf.css +3 -0
- package/dist/styles/prose.css +3 -0
- package/dist/styles/tokens.css +89 -14
- package/dist/theme.d.ts +1 -0
- package/dist/theme.js +5 -0
- package/dist/vite.d.ts +48 -59
- package/dist/vite.js +54 -21
- package/package.json +69 -2
|
@@ -0,0 +1,146 @@
|
|
|
1
|
+
# Tool Call
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { ToolCall, ToolCallInput, ToolCallOutput } from "@zonsh/ui";
|
|
5
|
+
import { PackageSearchIcon } from "lucide-react";
|
|
6
|
+
|
|
7
|
+
/* Illustrative tool calls, not real data. */
|
|
8
|
+
const found = [
|
|
9
|
+
{ order: "#1048", customer: "Ana Ruiz", items: 2, waitingFor: "Packing" },
|
|
10
|
+
{ order: "#1051", customer: "Tom Becker", items: 1, waitingFor: "Stock" },
|
|
11
|
+
{ order: "#1053", customer: "Mei Lin", items: 3, waitingFor: "Address check" },
|
|
12
|
+
];
|
|
13
|
+
|
|
14
|
+
export function Basic() {
|
|
15
|
+
return (
|
|
16
|
+
<div className="w-full max-w-2xl">
|
|
17
|
+
<ToolCall name="search_orders" status="completed" icon={<PackageSearchIcon />} defaultOpen>
|
|
18
|
+
<ToolCallInput input={{ status: "not_shipped", limit: 10 }} />
|
|
19
|
+
<ToolCallOutput output={found} />
|
|
20
|
+
</ToolCall>
|
|
21
|
+
</div>
|
|
22
|
+
);
|
|
23
|
+
}
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
A tool the model called, as a folding card: the name in mono, the status as a tag. Opened: the parameters and result as coloured code, or your own rendering.
|
|
27
|
+
|
|
28
|
+
## Usage
|
|
29
|
+
|
|
30
|
+
```tsx
|
|
31
|
+
import { ToolCall, ToolCallInput, ToolCallOutput } from "@zonsh/ui";
|
|
32
|
+
|
|
33
|
+
<ToolCall name="search_orders" status="completed">
|
|
34
|
+
<ToolCallInput input={part.input} />
|
|
35
|
+
<ToolCallOutput output={part.output} />
|
|
36
|
+
</ToolCall>;
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
- `ToolCall.status` — pending, running, completed or error.
|
|
40
|
+
- `ToolCallOutput.output` — the result; `errorText` for a failure.
|
|
41
|
+
- `ToolCallInput.language` — colours a string input.
|
|
42
|
+
|
|
43
|
+
## When to use
|
|
44
|
+
|
|
45
|
+
- One per tool used in a reply; thinking between tools is `Reasoning`.
|
|
46
|
+
|
|
47
|
+
## Examples
|
|
48
|
+
|
|
49
|
+
### States
|
|
50
|
+
|
|
51
|
+
A failed call shows its error in words, with an icon.
|
|
52
|
+
|
|
53
|
+
```tsx
|
|
54
|
+
import { ToolCall, ToolCallInput, ToolCallOutput } from "@zonsh/ui";
|
|
55
|
+
import { MailIcon, PackageSearchIcon } from "lucide-react";
|
|
56
|
+
|
|
57
|
+
// found: as in the first example on this page that uses them.
|
|
58
|
+
|
|
59
|
+
export function States() {
|
|
60
|
+
return (
|
|
61
|
+
<div className="flex w-full max-w-2xl flex-col gap-3">
|
|
62
|
+
<ToolCall name="email_customer" status="pending" icon={<MailIcon />}>
|
|
63
|
+
<ToolCallInput input={{ order: "#1051", template: "back_in_stock_soon" }} />
|
|
64
|
+
</ToolCall>
|
|
65
|
+
<ToolCall name="search_orders" status="running" icon={<PackageSearchIcon />}>
|
|
66
|
+
<ToolCallInput input={{ status: "not_shipped" }} />
|
|
67
|
+
</ToolCall>
|
|
68
|
+
<ToolCall name="search_orders" status="completed" icon={<PackageSearchIcon />}>
|
|
69
|
+
<ToolCallInput input={{ status: "not_shipped" }} />
|
|
70
|
+
<ToolCallOutput output={found} />
|
|
71
|
+
</ToolCall>
|
|
72
|
+
<ToolCall name="refund_order" status="error" defaultOpen>
|
|
73
|
+
<ToolCallInput input={{ order: "#1046", amount: 24.9 }} />
|
|
74
|
+
<ToolCallOutput errorText="The payment provider did not answer. Nothing was refunded; the order is unchanged." />
|
|
75
|
+
</ToolCall>
|
|
76
|
+
</div>
|
|
77
|
+
);
|
|
78
|
+
}
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
### A command
|
|
82
|
+
|
|
83
|
+
A string shows as is; `language` colours it.
|
|
84
|
+
|
|
85
|
+
```tsx
|
|
86
|
+
import { ToolCall, ToolCallInput, ToolCallOutput } from "@zonsh/ui";
|
|
87
|
+
import { TerminalIcon } from "lucide-react";
|
|
88
|
+
|
|
89
|
+
/** A command and what it printed: a string input in its own language. */
|
|
90
|
+
export function Command() {
|
|
91
|
+
return (
|
|
92
|
+
<div className="w-full max-w-2xl">
|
|
93
|
+
<ToolCall name="run_command" status="completed" icon={<TerminalIcon />} defaultOpen>
|
|
94
|
+
<ToolCallInput label="Command" language="bash" input={'git log --oneline -3 -- "src/orders"'} />
|
|
95
|
+
<ToolCallOutput
|
|
96
|
+
label="Output"
|
|
97
|
+
output={`a41c9e2 Hold back orders waiting for stock
|
|
98
|
+
7d03b18 Show the packing step on the order page
|
|
99
|
+
c92f5a0 Check addresses before an order ships`}
|
|
100
|
+
/>
|
|
101
|
+
</ToolCall>
|
|
102
|
+
</div>
|
|
103
|
+
);
|
|
104
|
+
}
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
## Props
|
|
108
|
+
|
|
109
|
+
| Component | Prop | Type | Default |
|
|
110
|
+
| ---------------- | ----------- | ---------------------------------------------------------------------------------------------------------- | ------------------------------------- |
|
|
111
|
+
| `ToolCall` | `name` | `string` | — |
|
|
112
|
+
| | `status` | `"pending" \| "running" \| "completed" \| "error"` | — |
|
|
113
|
+
| | `icon` | `ReactNode` — 14px | a wrench |
|
|
114
|
+
| | `labels` | `Partial<ToolCallMessages>` — the status labels, and `parameters`, `result` and `failure` for the headings | Pending · Running · Completed · Error |
|
|
115
|
+
| | `highlight` | `boolean` — colour the input and output as code | `true` |
|
|
116
|
+
| `ToolCallInput` | `input` | `unknown` — objects show as JSON | — |
|
|
117
|
+
| | `language` | `string` — for a string input, e.g. `"bash"` | — |
|
|
118
|
+
| | `label` | `ReactNode` — the heading | Parameters |
|
|
119
|
+
| `ToolCallOutput` | `output` | `unknown`, or `children` for your own rendering | — |
|
|
120
|
+
| | `errorText` | `string` | — |
|
|
121
|
+
| | `language` | `string` — for a string output, e.g. `"html"` | — |
|
|
122
|
+
| | `label` | `ReactNode` — the heading | Result, or Error with `errorText` |
|
|
123
|
+
|
|
124
|
+
`ToolCall` takes Base UI `Collapsible` props (`defaultOpen`, `open`); `data-status`. A `LocaleProvider` sets the labels (`messages.toolCall`).
|
|
125
|
+
|
|
126
|
+
## Brand rules
|
|
127
|
+
|
|
128
|
+
- **Do** keep calls folded: they are for checking, not reading first.
|
|
129
|
+
- **Do** say in an error what it means: "Nothing was refunded; the order is unchanged."
|
|
130
|
+
- **Don't** colour pending or running.
|
|
131
|
+
|
|
132
|
+
## Accessibility
|
|
133
|
+
|
|
134
|
+
- The header is a button with `aria-expanded`; the status is text in it, and the spinner announces its label. Errors use colour, an icon and words.
|
|
135
|
+
|
|
136
|
+
### Keyboard
|
|
137
|
+
|
|
138
|
+
| Key | What it does |
|
|
139
|
+
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
140
|
+
| Enter / Space | Opens or closes the parameters and result from the header |
|
|
141
|
+
| Tab | Moves from the header into the open panel — its code blocks scroll with the arrow keys and have their copy buttons — or on to the next call |
|
|
142
|
+
|
|
143
|
+
---
|
|
144
|
+
|
|
145
|
+
- Import: `import { ToolCall, ToolCallInput, ToolCallOutput } from "@zonsh/ui"`
|
|
146
|
+
- Source: `packages/ui/src/components/tool-call.tsx`
|
|
@@ -0,0 +1,260 @@
|
|
|
1
|
+
# Toolbar
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Toolbar, ToolbarButton, ToolbarGroup, ToolbarSeparator } from "@zonsh/ui";
|
|
5
|
+
import { BoldIcon, ItalicIcon, LinkIcon, ListIcon, ListOrderedIcon, UnderlineIcon } from "lucide-react";
|
|
6
|
+
import * as React from "react";
|
|
7
|
+
|
|
8
|
+
export function Formatting() {
|
|
9
|
+
const [marks, setMarks] = React.useState<Record<string, boolean>>({ bold: true });
|
|
10
|
+
const toggle = (key: string) => setMarks((m) => ({ ...m, [key]: !m[key] }));
|
|
11
|
+
return (
|
|
12
|
+
// In a narrow frame the link button keeps only its icon, so the toolbar stays on one line.
|
|
13
|
+
<div className="@container flex w-full justify-center">
|
|
14
|
+
<Toolbar aria-label="Formatting">
|
|
15
|
+
<ToolbarGroup aria-label="Text style">
|
|
16
|
+
<ToolbarButton aria-label="Bold" aria-pressed={!!marks.bold} onClick={() => toggle("bold")}>
|
|
17
|
+
<BoldIcon />
|
|
18
|
+
</ToolbarButton>
|
|
19
|
+
<ToolbarButton aria-label="Italic" aria-pressed={!!marks.italic} onClick={() => toggle("italic")}>
|
|
20
|
+
<ItalicIcon />
|
|
21
|
+
</ToolbarButton>
|
|
22
|
+
<ToolbarButton
|
|
23
|
+
aria-label="Underline"
|
|
24
|
+
aria-pressed={!!marks.underline}
|
|
25
|
+
onClick={() => toggle("underline")}
|
|
26
|
+
>
|
|
27
|
+
<UnderlineIcon />
|
|
28
|
+
</ToolbarButton>
|
|
29
|
+
</ToolbarGroup>
|
|
30
|
+
<ToolbarSeparator />
|
|
31
|
+
<ToolbarGroup aria-label="Lists">
|
|
32
|
+
<ToolbarButton aria-label="Bulleted list">
|
|
33
|
+
<ListIcon />
|
|
34
|
+
</ToolbarButton>
|
|
35
|
+
<ToolbarButton aria-label="Numbered list">
|
|
36
|
+
<ListOrderedIcon />
|
|
37
|
+
</ToolbarButton>
|
|
38
|
+
</ToolbarGroup>
|
|
39
|
+
<ToolbarSeparator />
|
|
40
|
+
<ToolbarButton aria-label="Insert link">
|
|
41
|
+
<LinkIcon />
|
|
42
|
+
<span className="hidden @[20rem]:inline">Insert link</span>
|
|
43
|
+
</ToolbarButton>
|
|
44
|
+
</Toolbar>
|
|
45
|
+
</div>
|
|
46
|
+
);
|
|
47
|
+
}
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
A dense row of related commands on a 12px surface. 30px buttons are flat and muted; hover brightens the label, and a button that is on (`aria-pressed`) rises. Hairlines split groups. The toolbar is one Tab stop; arrows move inside.
|
|
51
|
+
|
|
52
|
+
## Usage
|
|
53
|
+
|
|
54
|
+
```tsx
|
|
55
|
+
import { Toolbar, ToolbarButton, ToolbarGroup, ToolbarSeparator } from "@zonsh/ui";
|
|
56
|
+
|
|
57
|
+
<Toolbar aria-label="Formatting">
|
|
58
|
+
<ToolbarGroup>
|
|
59
|
+
<ToolbarButton aria-label="Bold">
|
|
60
|
+
<BoldIcon />
|
|
61
|
+
</ToolbarButton>
|
|
62
|
+
<ToolbarButton aria-label="Italic">
|
|
63
|
+
<ItalicIcon />
|
|
64
|
+
</ToolbarButton>
|
|
65
|
+
</ToolbarGroup>
|
|
66
|
+
<ToolbarSeparator />
|
|
67
|
+
<ToolbarButton>Insert link</ToolbarButton>
|
|
68
|
+
</Toolbar>;
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
- `aria-pressed` — a toggle that rises while on.
|
|
72
|
+
- `overflow` — fold what doesn't fit into "…".
|
|
73
|
+
- `orientation` — `"vertical"` for a tool rail.
|
|
74
|
+
|
|
75
|
+
## When to use
|
|
76
|
+
|
|
77
|
+
- Repeated commands on one thing: formatting, acting on selected rows.
|
|
78
|
+
- Not for navigation or a single action.
|
|
79
|
+
|
|
80
|
+
## Examples
|
|
81
|
+
|
|
82
|
+
### Table actions
|
|
83
|
+
|
|
84
|
+
Text buttons for table actions.
|
|
85
|
+
|
|
86
|
+
```tsx
|
|
87
|
+
import { Toolbar, ToolbarButton, ToolbarSeparator } from "@zonsh/ui";
|
|
88
|
+
|
|
89
|
+
export function TableActions() {
|
|
90
|
+
return (
|
|
91
|
+
<Toolbar aria-label="Selected rows">
|
|
92
|
+
<ToolbarButton>Assign</ToolbarButton>
|
|
93
|
+
<ToolbarButton>Export CSV</ToolbarButton>
|
|
94
|
+
<ToolbarSeparator />
|
|
95
|
+
<ToolbarButton disabled>Archive</ToolbarButton>
|
|
96
|
+
</Toolbar>
|
|
97
|
+
);
|
|
98
|
+
}
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
### Toggles
|
|
102
|
+
|
|
103
|
+
Name each group of toggles.
|
|
104
|
+
|
|
105
|
+
```tsx
|
|
106
|
+
<ToolbarGroup aria-label="Text style">
|
|
107
|
+
<ToolbarButton aria-label="Bold" aria-pressed={bold} onClick={() => setBold(!bold)}>
|
|
108
|
+
<BoldIcon />
|
|
109
|
+
</ToolbarButton>
|
|
110
|
+
<ToolbarButton aria-label="Italic" aria-pressed={italic} onClick={() => setItalic(!italic)}>
|
|
111
|
+
<ItalicIcon />
|
|
112
|
+
</ToolbarButton>
|
|
113
|
+
</ToolbarGroup>
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
### A menu in the toolbar
|
|
117
|
+
|
|
118
|
+
`render` makes a button a `Menu` trigger in the arrow-key order; Enter, Space or ↓ opens it.
|
|
119
|
+
|
|
120
|
+
```tsx
|
|
121
|
+
<Toolbar aria-label="Document">
|
|
122
|
+
<ToolbarButton>Share</ToolbarButton>
|
|
123
|
+
<Menu>
|
|
124
|
+
<ToolbarButton render={<MenuTrigger />}>
|
|
125
|
+
Export
|
|
126
|
+
<ChevronDownIcon />
|
|
127
|
+
</ToolbarButton>
|
|
128
|
+
<MenuContent>
|
|
129
|
+
<MenuItem>PDF</MenuItem>
|
|
130
|
+
<MenuItem>Markdown</MenuItem>
|
|
131
|
+
</MenuContent>
|
|
132
|
+
</Menu>
|
|
133
|
+
</Toolbar>
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
### Vertical
|
|
137
|
+
|
|
138
|
+
Stacks the buttons; arrows become ↑ and ↓.
|
|
139
|
+
|
|
140
|
+
```tsx
|
|
141
|
+
<Toolbar aria-label="Tools" orientation="vertical">
|
|
142
|
+
<ToolbarButton aria-label="Select"><MousePointer2Icon /></ToolbarButton>
|
|
143
|
+
<ToolbarButton aria-label="Draw"><PencilIcon /></ToolbarButton>
|
|
144
|
+
<ToolbarSeparator />
|
|
145
|
+
<ToolbarButton aria-label="Erase"><EraserIcon /></ToolbarButton>
|
|
146
|
+
</Toolbar>
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
### Overflow
|
|
150
|
+
|
|
151
|
+
Buttons that don't fit move into a "…" menu with their names and shortcuts, toggles as checked items. `overflowPriority`: lower goes first, then from the end; `false` stays. Narrow the frame to see it.
|
|
152
|
+
|
|
153
|
+
```tsx
|
|
154
|
+
import { Toolbar, ToolbarButton, ToolbarGroup, ToolbarSeparator } from "@zonsh/ui";
|
|
155
|
+
import { BoldIcon, CodeIcon, ItalicIcon, LinkIcon, ListChecksIcon, ListIcon, ListOrderedIcon, QuoteIcon, StrikethroughIcon, UnderlineIcon } from "lucide-react";
|
|
156
|
+
import * as React from "react";
|
|
157
|
+
|
|
158
|
+
export function Overflow() {
|
|
159
|
+
const [marks, setMarks] = React.useState<Record<string, boolean>>({});
|
|
160
|
+
const toggle = (key: string) => setMarks((m) => ({ ...m, [key]: !m[key] }));
|
|
161
|
+
const mark = (
|
|
162
|
+
key: string,
|
|
163
|
+
label: string,
|
|
164
|
+
Icon: typeof BoldIcon,
|
|
165
|
+
shortcut?: string[],
|
|
166
|
+
priority?: number,
|
|
167
|
+
) => (
|
|
168
|
+
<ToolbarButton
|
|
169
|
+
aria-label={label}
|
|
170
|
+
aria-pressed={!!marks[key]}
|
|
171
|
+
onClick={() => toggle(key)}
|
|
172
|
+
overflowShortcut={shortcut}
|
|
173
|
+
overflowPriority={priority}
|
|
174
|
+
>
|
|
175
|
+
<Icon />
|
|
176
|
+
</ToolbarButton>
|
|
177
|
+
);
|
|
178
|
+
return (
|
|
179
|
+
// The frame is resizable: narrow it and the commands at the end move into "…".
|
|
180
|
+
<div className="w-full max-w-md min-w-0 resize-x overflow-hidden p-1">
|
|
181
|
+
<Toolbar aria-label="Formatting" overflow>
|
|
182
|
+
<ToolbarGroup aria-label="Text style">
|
|
183
|
+
{mark("bold", "Bold", BoldIcon, ["mod", "B"], 2)}
|
|
184
|
+
{mark("italic", "Italic", ItalicIcon, ["mod", "I"], 2)}
|
|
185
|
+
{mark("underline", "Underline", UnderlineIcon, ["mod", "U"], 1)}
|
|
186
|
+
{mark("strike", "Strikethrough", StrikethroughIcon, ["mod", "shift", "X"])}
|
|
187
|
+
{mark("code", "Code", CodeIcon, ["mod", "E"])}
|
|
188
|
+
</ToolbarGroup>
|
|
189
|
+
<ToolbarSeparator />
|
|
190
|
+
<ToolbarGroup aria-label="Blocks">
|
|
191
|
+
<ToolbarButton aria-label="Bulleted list" overflowPriority={1}>
|
|
192
|
+
<ListIcon />
|
|
193
|
+
</ToolbarButton>
|
|
194
|
+
<ToolbarButton aria-label="Numbered list">
|
|
195
|
+
<ListOrderedIcon />
|
|
196
|
+
</ToolbarButton>
|
|
197
|
+
<ToolbarButton aria-label="To-do list">
|
|
198
|
+
<ListChecksIcon />
|
|
199
|
+
</ToolbarButton>
|
|
200
|
+
<ToolbarButton aria-label="Quote">
|
|
201
|
+
<QuoteIcon />
|
|
202
|
+
</ToolbarButton>
|
|
203
|
+
</ToolbarGroup>
|
|
204
|
+
<ToolbarSeparator />
|
|
205
|
+
<ToolbarButton aria-label="Insert link" overflowPriority={1}>
|
|
206
|
+
<LinkIcon />
|
|
207
|
+
</ToolbarButton>
|
|
208
|
+
</Toolbar>
|
|
209
|
+
</div>
|
|
210
|
+
);
|
|
211
|
+
}
|
|
212
|
+
```
|
|
213
|
+
|
|
214
|
+
## Props
|
|
215
|
+
|
|
216
|
+
| Prop | Type | Default |
|
|
217
|
+
| ------------------------------------- | ------------------------------------------------ | -------------- |
|
|
218
|
+
| `Toolbar.orientation` | `"horizontal" \| "vertical"` | `"horizontal"` |
|
|
219
|
+
| `Toolbar.loopFocus` | `boolean` | `true` |
|
|
220
|
+
| `Toolbar.disabled` | `boolean` | — |
|
|
221
|
+
| `Toolbar.overflow` | `boolean`: fold what doesn't fit into "…" | `false` |
|
|
222
|
+
| `Toolbar.variant` | `"surface" \| "plain"`: `plain` for a row inside another surface | `"surface"` |
|
|
223
|
+
| `Toolbar.labels` | `{ more?: string }`: the "…" button's name | English |
|
|
224
|
+
| `ToolbarButton.overflowPriority` | `number \| false`: lower folds first; `false` never | `0` |
|
|
225
|
+
| `ToolbarButton.overflowLabel` | `string`: its name in the "…" menu | `aria-label` |
|
|
226
|
+
| `ToolbarButton.overflowShortcut` | `string[]`: `KbdShortcut` keys in the "…" menu | — |
|
|
227
|
+
| `ToolbarButton.disabled` | `boolean` | `false` |
|
|
228
|
+
| `ToolbarButton.focusableWhenDisabled` | `boolean` | `true` |
|
|
229
|
+
| `ToolbarButton.render` | `ReactElement` — e.g. a `Toggle` or menu trigger | — |
|
|
230
|
+
| `ToolbarGroup.disabled` | `boolean` | `false` |
|
|
231
|
+
|
|
232
|
+
Other Base UI `Toolbar` props are forwarded. A `LocaleProvider` sets `labels` for every Toolbar (`messages.toolbar`).
|
|
233
|
+
|
|
234
|
+
## Brand rules
|
|
235
|
+
|
|
236
|
+
- **Do** keep everything at 30px (`size="sm"`).
|
|
237
|
+
- **Do** separate groups with `ToolbarSeparator`.
|
|
238
|
+
- **Don't** fill pressed buttons; set `aria-pressed`.
|
|
239
|
+
- **Don't** add a hover fill; raised means "on".
|
|
240
|
+
- **Don't** put the page's primary action in a toolbar.
|
|
241
|
+
|
|
242
|
+
## Accessibility
|
|
243
|
+
|
|
244
|
+
- Label the toolbar and icon-only buttons.
|
|
245
|
+
- Disabled buttons stay focusable and hoverable, so a tooltip can say why; clicks are inert.
|
|
246
|
+
- The "…" button is named "More"; its items carry names and toggle states.
|
|
247
|
+
|
|
248
|
+
### Keyboard
|
|
249
|
+
|
|
250
|
+
| Key | What it does |
|
|
251
|
+
| ------------- | ------------------------------------------------------------------------------------------------------- |
|
|
252
|
+
| ← / → | Moves to the previous or next control, looping at the ends (swapped right to left; ↑ / ↓ when vertical) |
|
|
253
|
+
| Enter / Space | Presses the focused button, or opens the "…" menu |
|
|
254
|
+
| Tab | Leaves the toolbar: it is one Tab stop |
|
|
255
|
+
|
|
256
|
+
---
|
|
257
|
+
|
|
258
|
+
- Import: `import { Toolbar, ToolbarButton, ToolbarGroup, ToolbarSeparator } from "@zonsh/ui"`
|
|
259
|
+
- Source: `packages/ui/src/components/toolbar.tsx`
|
|
260
|
+
- Primitive: `@base-ui/react/toolbar` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/toolbar.md`)
|
|
@@ -0,0 +1,172 @@
|
|
|
1
|
+
# Tooltip
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Button, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "@zonsh/ui";
|
|
5
|
+
import { CopyIcon, DownloadIcon, Share2Icon } from "lucide-react";
|
|
6
|
+
|
|
7
|
+
export function Basic() {
|
|
8
|
+
return (
|
|
9
|
+
<TooltipProvider>
|
|
10
|
+
<div className="flex gap-2">
|
|
11
|
+
{[
|
|
12
|
+
{ label: "Copy link", icon: <CopyIcon /> },
|
|
13
|
+
{ label: "Download PDF", icon: <DownloadIcon /> },
|
|
14
|
+
{ label: "Share project", icon: <Share2Icon /> },
|
|
15
|
+
].map(({ label, icon }) => (
|
|
16
|
+
<Tooltip key={label}>
|
|
17
|
+
<TooltipTrigger render={<Button variant="secondary" size="icon" aria-label={label} />}>
|
|
18
|
+
{icon}
|
|
19
|
+
</TooltipTrigger>
|
|
20
|
+
<TooltipContent>{label}</TooltipContent>
|
|
21
|
+
</Tooltip>
|
|
22
|
+
))}
|
|
23
|
+
</div>
|
|
24
|
+
</TooltipProvider>
|
|
25
|
+
);
|
|
26
|
+
}
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
A label for a control with no visible text: `material-menu` at 7px, 12px Licht Mono (or Licht Sans with `variant="text"`). It opens after 150ms; under one `TooltipProvider`, once one is open its neighbours open at once.
|
|
30
|
+
|
|
31
|
+
## Usage
|
|
32
|
+
|
|
33
|
+
```tsx
|
|
34
|
+
import { Button, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "@zonsh/ui";
|
|
35
|
+
|
|
36
|
+
<TooltipProvider>
|
|
37
|
+
<Tooltip>
|
|
38
|
+
<TooltipTrigger render={<Button variant="secondary" size="icon" aria-label="Copy link" />}>
|
|
39
|
+
<CopyIcon />
|
|
40
|
+
</TooltipTrigger>
|
|
41
|
+
<TooltipContent>Copy link</TooltipContent>
|
|
42
|
+
</Tooltip>
|
|
43
|
+
</TooltipProvider>;
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
- `TooltipContent.side` — where it opens.
|
|
47
|
+
- `TooltipContent.variant` — `"text"` for a short sentence.
|
|
48
|
+
- `TooltipTrigger.delay` — the wait before opening, in ms.
|
|
49
|
+
|
|
50
|
+
## When to use
|
|
51
|
+
|
|
52
|
+
- Naming icon-only buttons; a shortcut or exact value beside a control.
|
|
53
|
+
- Not for anything people must read or click (touch has no tooltips): use a `Popover` or the page.
|
|
54
|
+
|
|
55
|
+
## Examples
|
|
56
|
+
|
|
57
|
+
### Text variant
|
|
58
|
+
|
|
59
|
+
```tsx
|
|
60
|
+
import { Button, Tooltip, TooltipContent, TooltipTrigger } from "@zonsh/ui";
|
|
61
|
+
|
|
62
|
+
export function TextVariant() {
|
|
63
|
+
return (
|
|
64
|
+
<Tooltip>
|
|
65
|
+
<TooltipTrigger render={<Button variant="ghost" />}>Opening hours</TooltipTrigger>
|
|
66
|
+
<TooltipContent variant="text" side="bottom">
|
|
67
|
+
Monday to Friday, 9:00 to 18:00.
|
|
68
|
+
</TooltipContent>
|
|
69
|
+
</Tooltip>
|
|
70
|
+
);
|
|
71
|
+
}
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
### Delayed
|
|
75
|
+
|
|
76
|
+
A longer `delay` for controls people pass over (text links, a dense table); `delay={0}` for a label people look for every time. Here: 0, 150 (default) and 700ms.
|
|
77
|
+
|
|
78
|
+
```tsx
|
|
79
|
+
import { Button, Tooltip, TooltipContent, TooltipTrigger } from "@zonsh/ui";
|
|
80
|
+
|
|
81
|
+
export function Delayed() {
|
|
82
|
+
return (
|
|
83
|
+
<div className="flex flex-wrap gap-3">
|
|
84
|
+
<Tooltip>
|
|
85
|
+
<TooltipTrigger delay={0} render={<Button variant="secondary" />}>
|
|
86
|
+
Instant
|
|
87
|
+
</TooltipTrigger>
|
|
88
|
+
<TooltipContent>Opens at once</TooltipContent>
|
|
89
|
+
</Tooltip>
|
|
90
|
+
<Tooltip>
|
|
91
|
+
<TooltipTrigger render={<Button variant="secondary" />}>Quick</TooltipTrigger>
|
|
92
|
+
<TooltipContent>Opens after 150ms</TooltipContent>
|
|
93
|
+
</Tooltip>
|
|
94
|
+
<Tooltip>
|
|
95
|
+
<TooltipTrigger delay={700} render={<Button variant="secondary" />}>
|
|
96
|
+
Delayed
|
|
97
|
+
</TooltipTrigger>
|
|
98
|
+
<TooltipContent>Opens after 700ms</TooltipContent>
|
|
99
|
+
</Tooltip>
|
|
100
|
+
</div>
|
|
101
|
+
);
|
|
102
|
+
}
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
### With arrow
|
|
106
|
+
|
|
107
|
+
```tsx
|
|
108
|
+
import { Button, formatShortcut, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, useShortcutKeys } from "@zonsh/ui";
|
|
109
|
+
|
|
110
|
+
/** "Copy" as the device writes it: ⌘C on Apple, Ctrl+C elsewhere. */
|
|
111
|
+
function CopyShortcut() {
|
|
112
|
+
const { mod } = useShortcutKeys();
|
|
113
|
+
return <>{formatShortcut(["mod", "C"], mod)}</>;
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
export function WithArrow() {
|
|
117
|
+
return (
|
|
118
|
+
<TooltipProvider>
|
|
119
|
+
<div className="flex flex-wrap gap-3">
|
|
120
|
+
{(["left", "top", "bottom", "right"] as const).map((side) => (
|
|
121
|
+
<Tooltip key={side}>
|
|
122
|
+
<TooltipTrigger render={<Button variant="secondary" size="sm" />}>{side}</TooltipTrigger>
|
|
123
|
+
<TooltipContent side={side} arrow>
|
|
124
|
+
<CopyShortcut />
|
|
125
|
+
</TooltipContent>
|
|
126
|
+
</Tooltip>
|
|
127
|
+
))}
|
|
128
|
+
</div>
|
|
129
|
+
</TooltipProvider>
|
|
130
|
+
);
|
|
131
|
+
}
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
## Props
|
|
135
|
+
|
|
136
|
+
| Prop | Type | Default |
|
|
137
|
+
| -------------------------------------- | ------------------------------------------ | ------------------------ |
|
|
138
|
+
| `TooltipProvider.delay` | `number` (ms) | `150` |
|
|
139
|
+
| `TooltipProvider.closeDelay` | `number` (ms) | `0` |
|
|
140
|
+
| `TooltipProvider.timeout` | `number` (ms) — window for instant re-open | `400` |
|
|
141
|
+
| `TooltipContent.variant` | `"mono" \| "text"` | `"mono"` |
|
|
142
|
+
| `TooltipContent.side` | `"top" \| "right" \| "bottom" \| "left" …` | `"top"` |
|
|
143
|
+
| `TooltipContent.align` | `"start" \| "center" \| "end"` | `"center"` |
|
|
144
|
+
| `TooltipContent.sideOffset` | `number` | `6` |
|
|
145
|
+
| `TooltipContent.arrow` | `boolean` | `false` |
|
|
146
|
+
| `TooltipContent.positioner` / `portal` | Base UI positioner / portal props | — |
|
|
147
|
+
| `TooltipTrigger.delay` / `closeDelay` | per-trigger override | provider, or `150` / `0` |
|
|
148
|
+
|
|
149
|
+
`Tooltip` is Base UI `Tooltip.Root` (`open`, `onOpenChange`, `disabled`, `trackCursorAxis` …). Data attributes: `data-variant` on the popup.
|
|
150
|
+
|
|
151
|
+
## Brand rules
|
|
152
|
+
|
|
153
|
+
- **Do** keep it to a few words, under one `TooltipProvider` per app or toolbar.
|
|
154
|
+
- **Don't** put links, buttons or essential information in it, or repeat a button's visible label.
|
|
155
|
+
|
|
156
|
+
## Accessibility
|
|
157
|
+
|
|
158
|
+
- Opens on hover and focus. It describes its trigger, not names it: icon-only triggers still need `aria-label`.
|
|
159
|
+
- To explain a disabled button, set `focusableWhenDisabled` on it so it can be hovered and focused; clicks still do nothing.
|
|
160
|
+
|
|
161
|
+
### Keyboard
|
|
162
|
+
|
|
163
|
+
| Key | What it does |
|
|
164
|
+
| ------ | ------------------------------------------------------------------- |
|
|
165
|
+
| Tab | Focusing the trigger opens its tooltip; moving focus away closes it |
|
|
166
|
+
| Escape | Closes the tooltip; focus stays on the trigger |
|
|
167
|
+
|
|
168
|
+
---
|
|
169
|
+
|
|
170
|
+
- Import: `import { TooltipProvider, Tooltip, TooltipTrigger, TooltipContent } from "@zonsh/ui"`
|
|
171
|
+
- Source: `packages/ui/src/components/tooltip.tsx`
|
|
172
|
+
- Primitive: `@base-ui/react/tooltip` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/tooltip.md`)
|