@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,159 @@
|
|
|
1
|
+
# Context Menu
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger } from "@zonsh/ui";
|
|
5
|
+
import { CopyIcon, PencilIcon, Share2Icon, Trash2Icon } from "lucide-react";
|
|
6
|
+
import * as React from "react";
|
|
7
|
+
|
|
8
|
+
export function Basic() {
|
|
9
|
+
const [pinned, setPinned] = React.useState(false);
|
|
10
|
+
return (
|
|
11
|
+
<ContextMenu>
|
|
12
|
+
<ContextMenuTrigger className="flex h-40 w-full max-w-md items-center justify-center rounded-card border border-dashed border-field-edge font-mono text-xs text-muted-foreground">
|
|
13
|
+
Right-click or long-press this note
|
|
14
|
+
</ContextMenuTrigger>
|
|
15
|
+
<ContextMenuContent>
|
|
16
|
+
<ContextMenuItem>
|
|
17
|
+
<PencilIcon />
|
|
18
|
+
Edit note
|
|
19
|
+
<ContextMenuShortcut>E</ContextMenuShortcut>
|
|
20
|
+
</ContextMenuItem>
|
|
21
|
+
<ContextMenuItem>
|
|
22
|
+
<CopyIcon />
|
|
23
|
+
Duplicate
|
|
24
|
+
<ContextMenuShortcut keys={["mod", "D"]} />
|
|
25
|
+
</ContextMenuItem>
|
|
26
|
+
<ContextMenuSub>
|
|
27
|
+
<ContextMenuSubTrigger>
|
|
28
|
+
<Share2Icon />
|
|
29
|
+
Share
|
|
30
|
+
</ContextMenuSubTrigger>
|
|
31
|
+
<ContextMenuSubContent>
|
|
32
|
+
<ContextMenuItem>Copy link</ContextMenuItem>
|
|
33
|
+
<ContextMenuItem>Send by email</ContextMenuItem>
|
|
34
|
+
</ContextMenuSubContent>
|
|
35
|
+
</ContextMenuSub>
|
|
36
|
+
<ContextMenuCheckboxItem checked={pinned} onCheckedChange={setPinned}>
|
|
37
|
+
Pin to dashboard
|
|
38
|
+
</ContextMenuCheckboxItem>
|
|
39
|
+
<ContextMenuSeparator />
|
|
40
|
+
<ContextMenuItem variant="destructive">
|
|
41
|
+
<Trash2Icon />
|
|
42
|
+
Delete note
|
|
43
|
+
</ContextMenuItem>
|
|
44
|
+
</ContextMenuContent>
|
|
45
|
+
</ContextMenu>
|
|
46
|
+
);
|
|
47
|
+
}
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
A `Menu` that opens at the pointer on right click or long press of an area: `material-menu` at 12px, 38px items that lift on highlight, mono labels and shortcuts. The `ContextMenu*` item parts are the `Menu*` parts renamed, so either set works inside it.
|
|
51
|
+
|
|
52
|
+
## Usage
|
|
53
|
+
|
|
54
|
+
```tsx
|
|
55
|
+
import { ContextMenu, ContextMenuContent, ContextMenuItem, ContextMenuTrigger } from "@zonsh/ui";
|
|
56
|
+
|
|
57
|
+
<ContextMenu>
|
|
58
|
+
<ContextMenuTrigger>…the note card…</ContextMenuTrigger>
|
|
59
|
+
<ContextMenuContent>
|
|
60
|
+
<ContextMenuItem onClick={edit}>Edit note</ContextMenuItem>
|
|
61
|
+
<ContextMenuItem variant="destructive" onClick={remove}>
|
|
62
|
+
Delete note
|
|
63
|
+
</ContextMenuItem>
|
|
64
|
+
</ContextMenuContent>
|
|
65
|
+
</ContextMenu>;
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
The props you'll reach for: `ContextMenuTrigger.render`, `ContextMenuItem.variant`, `ContextMenu.onOpenChange`.
|
|
69
|
+
|
|
70
|
+
## When to use
|
|
71
|
+
|
|
72
|
+
- Shortcuts on a thing that already has visible controls: a card, a row, a file, a canvas object.
|
|
73
|
+
- Not as the only way to reach an action — touch and keyboard users may never open it.
|
|
74
|
+
|
|
75
|
+
## Examples
|
|
76
|
+
|
|
77
|
+
### A row in a list
|
|
78
|
+
|
|
79
|
+
With `render`, each row of a file list is its own trigger and the menu acts on that row. Keep the row's own buttons for the same actions.
|
|
80
|
+
|
|
81
|
+
```tsx
|
|
82
|
+
<ul>
|
|
83
|
+
{files.map((file) => (
|
|
84
|
+
<ContextMenu key={file.id}>
|
|
85
|
+
<ContextMenuTrigger render={<li />} className="flex h-(--control-h) items-center px-3">
|
|
86
|
+
{file.name}
|
|
87
|
+
</ContextMenuTrigger>
|
|
88
|
+
<ContextMenuContent>
|
|
89
|
+
<ContextMenuItem onClick={() => rename(file)}>Rename</ContextMenuItem>
|
|
90
|
+
<ContextMenuItem onClick={() => download(file)}>Download</ContextMenuItem>
|
|
91
|
+
<ContextMenuSeparator />
|
|
92
|
+
<ContextMenuItem variant="destructive" onClick={() => remove(file)}>
|
|
93
|
+
Delete
|
|
94
|
+
</ContextMenuItem>
|
|
95
|
+
</ContextMenuContent>
|
|
96
|
+
</ContextMenu>
|
|
97
|
+
))}
|
|
98
|
+
</ul>
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
### A choice
|
|
102
|
+
|
|
103
|
+
A radio group under a mono label; the menu stays open so the change shows.
|
|
104
|
+
|
|
105
|
+
```tsx
|
|
106
|
+
<ContextMenuContent>
|
|
107
|
+
<ContextMenuGroup>
|
|
108
|
+
<ContextMenuGroupLabel>Sort by</ContextMenuGroupLabel>
|
|
109
|
+
<ContextMenuRadioGroup value={sort} onValueChange={setSort}>
|
|
110
|
+
<ContextMenuRadioItem value="name">Name</ContextMenuRadioItem>
|
|
111
|
+
<ContextMenuRadioItem value="modified">Last modified</ContextMenuRadioItem>
|
|
112
|
+
<ContextMenuRadioItem value="size">Size</ContextMenuRadioItem>
|
|
113
|
+
</ContextMenuRadioGroup>
|
|
114
|
+
</ContextMenuGroup>
|
|
115
|
+
</ContextMenuContent>
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
## Props
|
|
119
|
+
|
|
120
|
+
| Prop | Type | Default |
|
|
121
|
+
| ------------------------------------------------------------------ | ------------------------------------------------ | ---------------------------------------------- |
|
|
122
|
+
| `ContextMenuTrigger` | the area; renders a `<div>` (`render` to change) | — |
|
|
123
|
+
| `ContextMenuContent.side` / `align` / `sideOffset` / `alignOffset` | positioning relative to the pointer | Base UI defaults (start-aligned at the cursor) |
|
|
124
|
+
| `ContextMenuContent.positioner` / `portal` | Base UI positioner / portal props | — |
|
|
125
|
+
| `ContextMenuItem.variant` | `"default" \| "destructive"` | `"default"` |
|
|
126
|
+
|
|
127
|
+
`ContextMenu` is Base UI `ContextMenu.Root` (`open`, `onOpenChange`, `disabled`). All item parts take the same props as their `Menu*` counterparts — see `Menu`.
|
|
128
|
+
|
|
129
|
+
## Brand rules
|
|
130
|
+
|
|
131
|
+
- **Do** mirror actions that exist elsewhere in the UI, in the same words.
|
|
132
|
+
- **Do** keep the list short and put destructive items last after a separator.
|
|
133
|
+
- **Don't** style the trigger area as a button; it is the thing itself.
|
|
134
|
+
- **Don't** override the browser's context menu on text people need to copy.
|
|
135
|
+
|
|
136
|
+
## Accessibility
|
|
137
|
+
|
|
138
|
+
- Opens with right click or long press on the trigger area.
|
|
139
|
+
- Hidden by nature: every action must also be on a visible control.
|
|
140
|
+
|
|
141
|
+
### Keyboard
|
|
142
|
+
|
|
143
|
+
| Key | What it does |
|
|
144
|
+
| ---------------------------- | ----------------------------------------------------------------------------------- |
|
|
145
|
+
| Context-menu key / Shift+F10 | Opens the menu under the focused element, while the focus is inside the area |
|
|
146
|
+
| ↓ / ↑ | Moves the highlight, looping at the ends |
|
|
147
|
+
| Home / End | Highlights the first or last item |
|
|
148
|
+
| Enter / Space | Runs the highlighted item; a checkbox or radio item toggles and the menu stays open |
|
|
149
|
+
| → / ← | Opens a submenu, or closes it and returns to its trigger (swapped right to left) |
|
|
150
|
+
| Typing | Highlights the next item that starts with the letters typed |
|
|
151
|
+
| Escape | Closes the menu |
|
|
152
|
+
|
|
153
|
+
The menu opens on the `contextmenu` event, under the focused element's start corner. The area itself takes no focus: give the things in it a tab stop (a button, a link, `tabIndex={0}` on a row) to put the menu in reach of the keyboard. A Mac keyboard has no context-menu key, so keep every action on a visible control as well.
|
|
154
|
+
|
|
155
|
+
---
|
|
156
|
+
|
|
157
|
+
- Import: `import { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuLinkItem, ContextMenuCheckboxItem, ContextMenuRadioGroup, ContextMenuRadioItem } from "@zonsh/ui"`
|
|
158
|
+
- Source: `packages/ui/src/components/context-menu.tsx`
|
|
159
|
+
- Primitive: `@base-ui/react/context-menu` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/context-menu.md`)
|
|
@@ -0,0 +1,146 @@
|
|
|
1
|
+
# Conversation
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Conversation, ConversationContent, ConversationScrollButton, Message, MessageContent, MessageText, Response } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
/* An illustrative conversation, not real data. */
|
|
7
|
+
const turns: { from: "user" | "assistant"; text: string }[] = [
|
|
8
|
+
{ from: "user", text: "Why did last night's deploy of the docs site fail?" },
|
|
9
|
+
{
|
|
10
|
+
from: "assistant",
|
|
11
|
+
text: "The build stopped at the image step:\n\n- **Install** — finished in 41 seconds.\n- **Build** — failed: `hero.avif` is larger than the 5 MB limit.\n- **Deploy** — skipped, so the site still serves Tuesday's version.",
|
|
12
|
+
},
|
|
13
|
+
{ from: "user", text: "When did the image get that big?" },
|
|
14
|
+
{
|
|
15
|
+
from: "assistant",
|
|
16
|
+
text: "It was replaced yesterday at 18:12 with an uncompressed export. The previous file was 640 KB. Nothing else in that commit touches the build.",
|
|
17
|
+
},
|
|
18
|
+
{ from: "user", text: "Who replaced it?" },
|
|
19
|
+
{
|
|
20
|
+
from: "assistant",
|
|
21
|
+
text: 'Lea, in the commit "New hero for the autumn release". The message mentions a placeholder, so the large file may not be the final one.',
|
|
22
|
+
},
|
|
23
|
+
{ from: "user", text: "Ask Lea for a smaller export, and rerun the deploy once it's in." },
|
|
24
|
+
{
|
|
25
|
+
from: "assistant",
|
|
26
|
+
text: "Done. Lea has a comment on the commit asking for a compressed export, and the deploy will run again when a new version of the file lands. I'll tell you when it's live.",
|
|
27
|
+
},
|
|
28
|
+
];
|
|
29
|
+
|
|
30
|
+
export function Basic() {
|
|
31
|
+
return (
|
|
32
|
+
<div className="flex h-[28rem] w-full max-w-3xl flex-col surface-card [--card-padding:0]">
|
|
33
|
+
<Conversation className="rounded-card" aria-label="Conversation with the assistant">
|
|
34
|
+
<ConversationContent>
|
|
35
|
+
{turns.map((turn, index) => (
|
|
36
|
+
<Message key={index} from={turn.from}>
|
|
37
|
+
<MessageContent>
|
|
38
|
+
{turn.from === "user" ? (
|
|
39
|
+
<MessageText>{turn.text}</MessageText>
|
|
40
|
+
) : (
|
|
41
|
+
<Response>{turn.text}</Response>
|
|
42
|
+
)}
|
|
43
|
+
</MessageContent>
|
|
44
|
+
</Message>
|
|
45
|
+
))}
|
|
46
|
+
</ConversationContent>
|
|
47
|
+
<ConversationScrollButton />
|
|
48
|
+
</Conversation>
|
|
49
|
+
</div>
|
|
50
|
+
);
|
|
51
|
+
}
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
The column of messages in an AI chat. At the end it follows a streaming reply, gliding rather than jumping; scrolled up, it stays put and a round button brings back the latest message.
|
|
55
|
+
|
|
56
|
+
## Usage
|
|
57
|
+
|
|
58
|
+
```tsx
|
|
59
|
+
import { Conversation, ConversationContent, ConversationScrollButton } from "@zonsh/ui";
|
|
60
|
+
|
|
61
|
+
<div className="flex h-[40rem] flex-col">
|
|
62
|
+
<Conversation aria-label="Conversation with the assistant">
|
|
63
|
+
<ConversationContent>{/* Message … */}</ConversationContent>
|
|
64
|
+
<ConversationScrollButton />
|
|
65
|
+
</Conversation>
|
|
66
|
+
{/* PromptInput */}
|
|
67
|
+
</div>;
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
The props you'll reach for: `aria-label`, `aria-busy` (while a reply streams) and `className`. It fills a flex column (`flex-1 min-h-0`): give the column a height.
|
|
71
|
+
|
|
72
|
+
## When to use
|
|
73
|
+
|
|
74
|
+
- Above a `PromptInput`, holding `Message`s. The conversation scrolls; the prompt bar stays in view.
|
|
75
|
+
- A fixed list that does not grow needs only `Item`s.
|
|
76
|
+
|
|
77
|
+
## Examples
|
|
78
|
+
|
|
79
|
+
### In a card, above the prompt bar
|
|
80
|
+
|
|
81
|
+
The prompt bar sits under the conversation; mark the log busy while a reply streams.
|
|
82
|
+
|
|
83
|
+
```tsx
|
|
84
|
+
<div className="flex h-[40rem] flex-col surface-card [--card-padding:0]">
|
|
85
|
+
<Conversation aria-label="Conversation with the assistant" aria-busy={streaming} className="rounded-t-card">
|
|
86
|
+
<ConversationContent>
|
|
87
|
+
{messages.map((m) => (
|
|
88
|
+
<Message key={m.id} from={m.from}>
|
|
89
|
+
<MessageContent>
|
|
90
|
+
{m.from === "user" ? <MessageText>{m.text}</MessageText> : <Response>{m.text}</Response>}
|
|
91
|
+
</MessageContent>
|
|
92
|
+
</Message>
|
|
93
|
+
))}
|
|
94
|
+
</ConversationContent>
|
|
95
|
+
<ConversationScrollButton />
|
|
96
|
+
</Conversation>
|
|
97
|
+
<PromptInput onSubmit={send}>{/* PromptInputTextarea, PromptInputToolbar … */}</PromptInput>
|
|
98
|
+
</div>
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
### Another language
|
|
102
|
+
|
|
103
|
+
The scroll button's name comes from `messages.conversation.scrollToLatest`, or from `label` on one button.
|
|
104
|
+
|
|
105
|
+
```tsx
|
|
106
|
+
<ConversationScrollButton label="Zur neuesten Nachricht" />
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
## Props
|
|
110
|
+
|
|
111
|
+
| Component | Prop | Type | Default |
|
|
112
|
+
| -------------------------- | ------------ | --------------------------------- | -------------------------------- |
|
|
113
|
+
| `Conversation` | `aria-label` | `string` — name the log | — |
|
|
114
|
+
| | `aria-busy` | `boolean` — while a reply streams | — |
|
|
115
|
+
| `ConversationScrollButton` | `label` | `string` | `"Scroll to the latest message"` |
|
|
116
|
+
|
|
117
|
+
`Conversation` forwards `div` props — `aria-label`, `ref`, `onScroll` — to the scrolling `log`; `className` and `style` go to its outer element, whose corners the log takes. In a card, give the conversation its corners (`rounded-card`, or `rounded-t-card` above a prompt bar) rather than clipping the card with `overflow-hidden`, which would hide the log's focus ring. `ConversationContent` and the button forward their props.
|
|
118
|
+
|
|
119
|
+
## Brand rules
|
|
120
|
+
|
|
121
|
+
- **Do** keep the prompt bar outside the conversation, always in view.
|
|
122
|
+
- **Do** let the reader stay where they scrolled. Jumping back down while someone reads is the most common chat bug.
|
|
123
|
+
- **Don't** animate each new message in. The reply writing itself out is motion enough.
|
|
124
|
+
|
|
125
|
+
## Accessibility
|
|
126
|
+
|
|
127
|
+
- The scrolling area is a focusable `log` region, so it scrolls with the keyboard. Name it with `aria-label`.
|
|
128
|
+
- Set `aria-busy` while a reply streams: screen readers then announce the reply once, when complete.
|
|
129
|
+
- The scroll button is hidden from assistive tech and the tab order while you are at the end; when shown, it reads "Scroll to the latest message".
|
|
130
|
+
|
|
131
|
+
### Keyboard
|
|
132
|
+
|
|
133
|
+
With focus on the log itself (not a control inside it):
|
|
134
|
+
|
|
135
|
+
| Key | What it does |
|
|
136
|
+
| -------------------------------- | ------------------------------------------------------------------------------------------- |
|
|
137
|
+
| ↑ / Page Up / Home / Shift+Space | Scrolls up and stops following the reply |
|
|
138
|
+
| ↓ / Page Down / End / Space | Scrolls down; back at the end, follows the reply again |
|
|
139
|
+
| Tab | Reaches the scroll button when it shows; Enter or Space on it scrolls to the latest message |
|
|
140
|
+
|
|
141
|
+
Keys pressed on a button, field, menu or other widget inside a message stay that widget's.
|
|
142
|
+
|
|
143
|
+
---
|
|
144
|
+
|
|
145
|
+
- Import: `import { Conversation, ConversationContent, ConversationScrollButton } from "@zonsh/ui"`
|
|
146
|
+
- Source: `packages/ui/src/components/conversation.tsx`
|
|
@@ -0,0 +1,162 @@
|
|
|
1
|
+
# Copy Button
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { CopyButton } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
export function Basic() {
|
|
7
|
+
return (
|
|
8
|
+
<div className="flex items-center gap-2">
|
|
9
|
+
<span className="font-mono text-sm text-foreground-soft">Order ord_4812_kq2m</span>
|
|
10
|
+
<CopyButton value="ord_4812_kq2m" labels={{ copy: "Copy order ID" }} />
|
|
11
|
+
</div>
|
|
12
|
+
);
|
|
13
|
+
}
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
A raised 30px circle with a copy icon. Pressed, it copies the value, the icon turns into a check for 1.5 seconds, and a polite live region says "Copied". The icons cross-fade in place, so the size never changes. Where the Clipboard API is blocked (`http:`, an iframe without permission) it falls back to the older copy command; if that fails, it shows a cross and says "Couldn't copy". `CodeBlock` uses it.
|
|
17
|
+
|
|
18
|
+
## Usage
|
|
19
|
+
|
|
20
|
+
```tsx
|
|
21
|
+
import { CopyButton } from "@zonsh/ui";
|
|
22
|
+
|
|
23
|
+
<CopyButton value="ord_4812_kq2m" labels={{ copy: "Copy order ID" }} />;
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
The props you'll reach for: `value`, `labels`, `variant`.
|
|
27
|
+
|
|
28
|
+
## When to use
|
|
29
|
+
|
|
30
|
+
- Beside a value people paste elsewhere: an ID, an API key, an invite link, a command, a colour.
|
|
31
|
+
- Icon-only beside the value; labelled (`children`) when it stands apart, or is a small panel's main action.
|
|
32
|
+
- In an `InputGroup`: `render={<InputGroupButton size="icon" />}`.
|
|
33
|
+
- For code, `CodeBlock` has one built in.
|
|
34
|
+
|
|
35
|
+
## Examples
|
|
36
|
+
|
|
37
|
+
### In an input group
|
|
38
|
+
|
|
39
|
+
An API key in a read-only `InputGroup`. The button takes `InputGroupButton`'s inset size and icon; CopyButton adds the click and the name.
|
|
40
|
+
|
|
41
|
+
```tsx
|
|
42
|
+
import { CopyButton, Field, FieldDescription, FieldLabel, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput } from "@zonsh/ui";
|
|
43
|
+
|
|
44
|
+
export function ApiKey() {
|
|
45
|
+
const key = "zon_test_8Hq2Lm4Vx7PaR3sT";
|
|
46
|
+
return (
|
|
47
|
+
<Field className="w-full max-w-sm">
|
|
48
|
+
<FieldLabel>Test API key</FieldLabel>
|
|
49
|
+
<InputGroup>
|
|
50
|
+
<InputGroupInput readOnly value={key} className="font-mono text-[13px] pointer-coarse:text-base" />
|
|
51
|
+
<InputGroupAddon align="inline-end">
|
|
52
|
+
<CopyButton
|
|
53
|
+
value={key}
|
|
54
|
+
labels={{ copy: "Copy API key" }}
|
|
55
|
+
render={<InputGroupButton variant="ghost" size="icon" />}
|
|
56
|
+
/>
|
|
57
|
+
</InputGroupAddon>
|
|
58
|
+
</InputGroup>
|
|
59
|
+
<FieldDescription>
|
|
60
|
+
Works against the test workspace only. Keep it out of your repository.
|
|
61
|
+
</FieldDescription>
|
|
62
|
+
</Field>
|
|
63
|
+
);
|
|
64
|
+
}
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
### Labelled
|
|
68
|
+
|
|
69
|
+
With children: a 30px labelled button whose label reads `labels.copied` for a moment, keeping the width of the longer label.
|
|
70
|
+
|
|
71
|
+
```tsx
|
|
72
|
+
import { CopyButton } from "@zonsh/ui";
|
|
73
|
+
|
|
74
|
+
export function InviteLink() {
|
|
75
|
+
const link = "https://notes.example.com/join/garden-club";
|
|
76
|
+
return (
|
|
77
|
+
<div className="flex w-full max-w-md flex-col gap-3">
|
|
78
|
+
<div className="flex flex-col gap-1">
|
|
79
|
+
<span className="text-sm font-medium text-foreground">Invite to “Garden club”</span>
|
|
80
|
+
<span className="text-[13px] text-muted-foreground">
|
|
81
|
+
Anyone with the link can read and comment on the notebook.
|
|
82
|
+
</span>
|
|
83
|
+
</div>
|
|
84
|
+
<div className="flex items-center gap-2">
|
|
85
|
+
<span className="min-w-0 flex-1 truncate font-mono text-[13px] text-foreground-soft">{link}</span>
|
|
86
|
+
<CopyButton value={link} labels={{ copied: "Link copied" }}>
|
|
87
|
+
Copy link
|
|
88
|
+
</CopyButton>
|
|
89
|
+
</div>
|
|
90
|
+
</div>
|
|
91
|
+
);
|
|
92
|
+
}
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
### Ghost, in a list
|
|
96
|
+
|
|
97
|
+
`variant="ghost"` for dense rows. `value` can be a function, read at the click. It may return a promise, but a slow one can lose the click's permission to write, so prefer text you already have. If it throws or rejects: the cross, the announcement and `onError`.
|
|
98
|
+
|
|
99
|
+
```tsx
|
|
100
|
+
import { CopyButton } from "@zonsh/ui";
|
|
101
|
+
|
|
102
|
+
export function Ghost() {
|
|
103
|
+
const commits = [
|
|
104
|
+
{ sha: "9f3c2e1", message: "Fix the totals row in the export" },
|
|
105
|
+
{ sha: "4b81d07", message: "Add the reading list to the course page" },
|
|
106
|
+
{ sha: "e27a5c9", message: "Bump the image cache to a day" },
|
|
107
|
+
];
|
|
108
|
+
return (
|
|
109
|
+
<ul className="m-0 flex w-full max-w-md list-none flex-col p-0">
|
|
110
|
+
{commits.map((commit) => (
|
|
111
|
+
<li
|
|
112
|
+
key={commit.sha}
|
|
113
|
+
className="flex items-center gap-3 border-b border-border/60 py-1.5 last:border-b-0"
|
|
114
|
+
>
|
|
115
|
+
<span className="font-mono text-xs text-muted-foreground tabular-nums">{commit.sha}</span>
|
|
116
|
+
<span className="min-w-0 flex-1 truncate text-sm">{commit.message}</span>
|
|
117
|
+
<CopyButton
|
|
118
|
+
variant="ghost"
|
|
119
|
+
value={() => commit.sha}
|
|
120
|
+
labels={{ copy: `Copy commit ${commit.sha}` }}
|
|
121
|
+
/>
|
|
122
|
+
</li>
|
|
123
|
+
))}
|
|
124
|
+
</ul>
|
|
125
|
+
);
|
|
126
|
+
}
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
## Props
|
|
130
|
+
|
|
131
|
+
| Prop | Type | Default |
|
|
132
|
+
| --------- | ------------------------------------------------------------------------------- | --------------------------------------- |
|
|
133
|
+
| `value` | `string \| () => string \| Promise<string>` — a function is read on the click | required |
|
|
134
|
+
| `labels` | `{ copy?, copied?, failed? }` | `"Copy"`, `"Copied"`, `"Couldn't copy"` |
|
|
135
|
+
| `timeout` | `number` — ms the check or cross stays | `1500` |
|
|
136
|
+
| `onCopy` | `(text) => void` | — |
|
|
137
|
+
| `onError` | `(error) => void` — the clipboard refused, or `value` threw or rejected | — |
|
|
138
|
+
| `variant` | `Button` variants | `"secondary"` |
|
|
139
|
+
| `size` | `Button` sizes | `"icon-sm"`, or `"sm"` with children |
|
|
140
|
+
| `render` | an element to draw instead of `Button`, e.g. `<InputGroupButton size="icon" />` | — |
|
|
141
|
+
|
|
142
|
+
Other `Button` props are forwarded. Data attributes: `data-copied` while the check shows, `data-copy-failed` after a failure; through `render` it keeps that element's `data-slot` and adds `data-copy-button`.
|
|
143
|
+
|
|
144
|
+
A `LocaleProvider` sets the three labels for every CopyButton (`messages.copyButton`); `labels` wins for one in particular.
|
|
145
|
+
|
|
146
|
+
## Brand rules
|
|
147
|
+
|
|
148
|
+
- **Do** name what it copies: "Copy API key", "Copy invite link" — a page often has several.
|
|
149
|
+
- **Do** keep it beside the value it copies.
|
|
150
|
+
- **Don't** add a toast: the check and announcement confirm it.
|
|
151
|
+
- **Don't** make it the primary; copying is never a view's outcome.
|
|
152
|
+
|
|
153
|
+
## Accessibility
|
|
154
|
+
|
|
155
|
+
- An icon-only button is named by `labels.copy` and keeps that name; after a click a polite live region says `labels.copied` (or `labels.failed`) once. A labelled one is named by its label.
|
|
156
|
+
- The icons are `aria-hidden`.
|
|
157
|
+
- A failure is shown with a cross and announced in words, never colour alone.
|
|
158
|
+
|
|
159
|
+
---
|
|
160
|
+
|
|
161
|
+
- Import: `import { CopyButton } from "@zonsh/ui"`
|
|
162
|
+
- Source: `packages/ui/src/components/copy-button.tsx`
|