@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,243 @@
|
|
|
1
|
+
# Message
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Message, MessageAction, MessageActions, MessageContent, MessageText, Response } from "@zonsh/ui";
|
|
5
|
+
import { PencilIcon, RotateCcwIcon, ThumbsDownIcon, ThumbsUpIcon } from "lucide-react";
|
|
6
|
+
|
|
7
|
+
/* An illustrative conversation, not real data. */
|
|
8
|
+
const answer = `Four things are on your list this week:
|
|
9
|
+
|
|
10
|
+
- **Finish the chapter draft** — due Thursday; two sections left.
|
|
11
|
+
- **Book the dentist** — the practice opens at 8:00.
|
|
12
|
+
- **Return the library books** — due Friday.
|
|
13
|
+
- **Plan Saturday's hike** — waiting on the weather.
|
|
14
|
+
|
|
15
|
+
Want me to block time for the draft tomorrow morning?`;
|
|
16
|
+
|
|
17
|
+
export function Basic() {
|
|
18
|
+
return (
|
|
19
|
+
<div className="flex w-full max-w-2xl flex-col gap-6">
|
|
20
|
+
<Message from="user">
|
|
21
|
+
<MessageContent>
|
|
22
|
+
<MessageText>What is on my list for this week?</MessageText>
|
|
23
|
+
<MessageActions>
|
|
24
|
+
<MessageAction label="Edit">
|
|
25
|
+
<PencilIcon />
|
|
26
|
+
</MessageAction>
|
|
27
|
+
<MessageAction label="Copy" copy="What is on my list for this week?" />
|
|
28
|
+
</MessageActions>
|
|
29
|
+
</MessageContent>
|
|
30
|
+
</Message>
|
|
31
|
+
<Message from="assistant">
|
|
32
|
+
<MessageContent>
|
|
33
|
+
<Response>{answer}</Response>
|
|
34
|
+
<MessageActions>
|
|
35
|
+
<MessageAction label="Copy" copy={answer} />
|
|
36
|
+
<MessageAction label="Try again">
|
|
37
|
+
<RotateCcwIcon />
|
|
38
|
+
</MessageAction>
|
|
39
|
+
<MessageAction label="Good response">
|
|
40
|
+
<ThumbsUpIcon />
|
|
41
|
+
</MessageAction>
|
|
42
|
+
<MessageAction label="Bad response">
|
|
43
|
+
<ThumbsDownIcon />
|
|
44
|
+
</MessageAction>
|
|
45
|
+
</MessageActions>
|
|
46
|
+
</MessageContent>
|
|
47
|
+
</Message>
|
|
48
|
+
</div>
|
|
49
|
+
);
|
|
50
|
+
}
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
One turn of a conversation. A **user** message is a 20px card at the end (the left, right to left), sized to its text, at most 80% wide. An **assistant** message is plain text across the full width — no bubble, avatar or mark — so a long answer reads like a document. `MessageActions` holds 30px ghost icon buttons with tooltips.
|
|
54
|
+
|
|
55
|
+
## Usage
|
|
56
|
+
|
|
57
|
+
```tsx
|
|
58
|
+
import { Message, MessageContent, MessageText, Response } from "@zonsh/ui";
|
|
59
|
+
|
|
60
|
+
<Message from="user">
|
|
61
|
+
<MessageContent>
|
|
62
|
+
<MessageText>What is on my list for this week?</MessageText>
|
|
63
|
+
</MessageContent>
|
|
64
|
+
</Message>;
|
|
65
|
+
|
|
66
|
+
<Message from="assistant">
|
|
67
|
+
<MessageContent>
|
|
68
|
+
<Response>{reply}</Response>
|
|
69
|
+
</MessageContent>
|
|
70
|
+
</Message>;
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
- `from` — `"user"`, `"assistant"`, or `"other"` for another person.
|
|
74
|
+
- `label` on `MessageAction` — tooltip and accessible name.
|
|
75
|
+
- `copy` on `MessageAction` — makes it a `CopyButton`: `<MessageAction label="Copy" copy={text} />`. Its icon turns to a check (a cross if the clipboard refuses) and "Copied" is announced; an `onClick` with a clipboard call gives no answer.
|
|
76
|
+
|
|
77
|
+
## When to use
|
|
78
|
+
|
|
79
|
+
- Every turn in a `Conversation`: a `Response` for markdown, `MessageText` for plain text. `Reasoning`, `ToolCall` and `Sources` go in the assistant's `MessageContent`, around the `Response`.
|
|
80
|
+
- A chat between people: `from="user"` for the signed-in person, `"other"` for the rest.
|
|
81
|
+
|
|
82
|
+
## Examples
|
|
83
|
+
|
|
84
|
+
### Plain text
|
|
85
|
+
|
|
86
|
+
`MessageText` keeps line breaks and wraps long words.
|
|
87
|
+
|
|
88
|
+
```tsx
|
|
89
|
+
import { Message, MessageContent, MessageText } from "@zonsh/ui";
|
|
90
|
+
|
|
91
|
+
export function PlainText() {
|
|
92
|
+
return (
|
|
93
|
+
<div className="flex w-full max-w-2xl flex-col gap-6">
|
|
94
|
+
<Message from="user">
|
|
95
|
+
<MessageContent>
|
|
96
|
+
<MessageText>
|
|
97
|
+
{"Draft a message to Mira.\nAsk if we can move Thursday's review to Friday."}
|
|
98
|
+
</MessageText>
|
|
99
|
+
</MessageContent>
|
|
100
|
+
</Message>
|
|
101
|
+
<Message from="assistant">
|
|
102
|
+
<MessageContent>
|
|
103
|
+
<MessageText>
|
|
104
|
+
{
|
|
105
|
+
"Hi Mira,\n\ncould we move Thursday's review to Friday morning? One more day would let me finish the last two sections first.\n\nThanks!"
|
|
106
|
+
}
|
|
107
|
+
</MessageText>
|
|
108
|
+
</MessageContent>
|
|
109
|
+
</Message>
|
|
110
|
+
</div>
|
|
111
|
+
);
|
|
112
|
+
}
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
### Between people
|
|
116
|
+
|
|
117
|
+
`from="other"` sits at the start in a flat bubble on the hover fill, at most 80% wide. Add a `MessageAvatar` when more than two people talk or the face helps.
|
|
118
|
+
|
|
119
|
+
```tsx
|
|
120
|
+
import { Message, MessageAction, MessageActions, MessageAvatar, MessageContent, MessageText } from "@zonsh/ui";
|
|
121
|
+
|
|
122
|
+
/* A sample chat between two people: you, and Lena from the bakery around the corner. */
|
|
123
|
+
export function BetweenPeople() {
|
|
124
|
+
return (
|
|
125
|
+
<div role="log" aria-label="Chat with Lena Hoffmann" className="flex w-full max-w-xl flex-col gap-4">
|
|
126
|
+
<Message from="other">
|
|
127
|
+
<MessageAvatar name="Lena Hoffmann" />
|
|
128
|
+
<MessageContent>
|
|
129
|
+
<MessageText>Morning! The rye loaves are out of the oven. Still want two for Saturday?</MessageText>
|
|
130
|
+
</MessageContent>
|
|
131
|
+
</Message>
|
|
132
|
+
<Message from="user">
|
|
133
|
+
<MessageContent>
|
|
134
|
+
<MessageText>Yes please, two. Could you slice one of them?</MessageText>
|
|
135
|
+
</MessageContent>
|
|
136
|
+
</Message>
|
|
137
|
+
<Message from="other">
|
|
138
|
+
<MessageAvatar name="Lena Hoffmann" />
|
|
139
|
+
<MessageContent>
|
|
140
|
+
<MessageText>Of course. They'll be at the counter from 8:00 under your name.</MessageText>
|
|
141
|
+
<MessageActions>
|
|
142
|
+
<MessageAction
|
|
143
|
+
label="Copy"
|
|
144
|
+
copy="Of course. They'll be at the counter from 8:00 under your name."
|
|
145
|
+
/>
|
|
146
|
+
</MessageActions>
|
|
147
|
+
</MessageContent>
|
|
148
|
+
</Message>
|
|
149
|
+
</div>
|
|
150
|
+
);
|
|
151
|
+
}
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
### Failed
|
|
155
|
+
|
|
156
|
+
When a reply breaks off, keep what arrived and put a `MessageError` under it: a destructive line with an icon and words, and "Try again" with `onRetry`. `retrying` shows a spinner and ignores clicks. An unsent user message takes the same line ("Not sent.").
|
|
157
|
+
|
|
158
|
+
```tsx
|
|
159
|
+
import { Message, MessageAction, MessageActions, MessageContent, MessageError, MessageText, Response } from "@zonsh/ui";
|
|
160
|
+
import * as React from "react";
|
|
161
|
+
|
|
162
|
+
const fullNotes = `Three decisions came out of Tuesday's meeting:
|
|
163
|
+
|
|
164
|
+
- **The launch moves to 3 November**, so the help pages can be translated first.
|
|
165
|
+
- **Mira owns the pricing page**; a draft is due next Wednesday.
|
|
166
|
+
- **The beta stays open** until the launch, with no new sign-ups after 20 October.`;
|
|
167
|
+
|
|
168
|
+
const brokenNotes = `Three decisions came out of Tuesday's meeting:
|
|
169
|
+
|
|
170
|
+
- **The launch moves to 3 November**, so the help pages`;
|
|
171
|
+
|
|
172
|
+
const RETRY_LATENCY = 900;
|
|
173
|
+
|
|
174
|
+
/**
|
|
175
|
+
* A reply that broke off: what arrived stays, the error says what happened under it, and "Try
|
|
176
|
+
* again" asks once more — here it then comes through in full.
|
|
177
|
+
*/
|
|
178
|
+
export function Failed() {
|
|
179
|
+
const [status, setStatus] = React.useState<"failed" | "retrying" | "done">("failed");
|
|
180
|
+
const timer = React.useRef<ReturnType<typeof setTimeout>>(undefined);
|
|
181
|
+
React.useEffect(() => () => clearTimeout(timer.current), []);
|
|
182
|
+
const retry = () => {
|
|
183
|
+
setStatus("retrying");
|
|
184
|
+
timer.current = setTimeout(() => setStatus("done"), RETRY_LATENCY);
|
|
185
|
+
};
|
|
186
|
+
return (
|
|
187
|
+
<div className="flex w-full max-w-2xl flex-col gap-6">
|
|
188
|
+
<Message from="user">
|
|
189
|
+
<MessageContent>
|
|
190
|
+
<MessageText>Summarise the notes from Tuesday's meeting.</MessageText>
|
|
191
|
+
</MessageContent>
|
|
192
|
+
</Message>
|
|
193
|
+
<Message from="assistant">
|
|
194
|
+
<MessageContent>
|
|
195
|
+
<Response>{status === "done" ? fullNotes : brokenNotes}</Response>
|
|
196
|
+
{status === "done" ? (
|
|
197
|
+
<MessageActions>
|
|
198
|
+
<MessageAction label="Copy" copy={fullNotes} />
|
|
199
|
+
</MessageActions>
|
|
200
|
+
) : (
|
|
201
|
+
<MessageError onRetry={retry} retrying={status === "retrying"}>
|
|
202
|
+
The connection dropped, and the reply stopped partway.
|
|
203
|
+
</MessageError>
|
|
204
|
+
)}
|
|
205
|
+
</MessageContent>
|
|
206
|
+
</Message>
|
|
207
|
+
</div>
|
|
208
|
+
);
|
|
209
|
+
}
|
|
210
|
+
```
|
|
211
|
+
|
|
212
|
+
## Props
|
|
213
|
+
|
|
214
|
+
| Component | Prop | Type | Default |
|
|
215
|
+
| --------------- | ------------------------ | ---------------------------------------------------------------------- | ------- |
|
|
216
|
+
| `Message` | `from` | `"user" \| "assistant" \| "other"` — `other`: another person | — |
|
|
217
|
+
| `MessageAvatar` | `name` / `src` / `size` | `Avatar` props, or a mark as children, always 32px — rarely needed | — |
|
|
218
|
+
| `MessageAction` | `label` | `string` — tooltip and accessible name | — |
|
|
219
|
+
| `MessageAction` | `copy` | `string \| () => string \| Promise<string>` — makes it the copy action | — |
|
|
220
|
+
| `MessageAction` | `onCopy` / `onCopyError` | with `copy`: called once copied, or when it failed | — |
|
|
221
|
+
| `MessageError` | `onRetry` | `() => void` — shows "Try again" | — |
|
|
222
|
+
| `MessageError` | `retrying` | `boolean` — the retry is on its way | `false` |
|
|
223
|
+
| `MessageError` | `labels` | `Partial<MessageMessages>` — `failed`, `retry` | English |
|
|
224
|
+
|
|
225
|
+
`MessageAction` forwards `Button` props (`onClick`, `disabled`). `MessageError` forwards `<div>` props; its words come from a `LocaleProvider` (`messages.message`) or `labels`. Data attributes: `data-from` on the message.
|
|
226
|
+
|
|
227
|
+
## Brand rules
|
|
228
|
+
|
|
229
|
+
- **Do** keep the assistant flat and the user in a card; that tells turns apart without colour.
|
|
230
|
+
- **Do** keep actions to what people use: copy, try again, rate. Four at most.
|
|
231
|
+
- **Don't** give the assistant a face — no avatar, mark or icon. The reply needs the full width.
|
|
232
|
+
- **Don't** give every message a person's avatar. `MessageAvatar` is for group chats; show the user's own only if the product shows it elsewhere.
|
|
233
|
+
|
|
234
|
+
## Accessibility
|
|
235
|
+
|
|
236
|
+
- Actions are named buttons ("Copy", "Try again") with tooltips. Under the assistant they always show; under others, on hover and whenever focus is in the message (Tab reaches them while hidden), and always on touch (`pointer: coarse`), where a hidden button would still take the tap.
|
|
237
|
+
- `MessageError` is `role="alert"`, read out as it appears, in words — never colour alone.
|
|
238
|
+
- Turns are identified by their place in the log, not by a picture. A mark passed as `MessageAvatar` children is decorative (`aria-hidden`).
|
|
239
|
+
|
|
240
|
+
---
|
|
241
|
+
|
|
242
|
+
- Import: `import { Message, MessageAvatar, MessageContent, MessageText, MessageActions, MessageAction, MessageError } from "@zonsh/ui"`
|
|
243
|
+
- Source: `packages/ui/src/components/message.tsx`
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
# Meter
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Meter } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
export function Default() {
|
|
7
|
+
return (
|
|
8
|
+
<div className="flex max-w-sm flex-col gap-5">
|
|
9
|
+
<Meter value={42} label="Storage used" showValue />
|
|
10
|
+
<Meter value={80} label="Profile completeness" showValue />
|
|
11
|
+
</div>
|
|
12
|
+
);
|
|
13
|
+
}
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
A measurement within a known range — capacity, a score, a quota. It looks like `Progress` (recessed 6px track, foreground indicator, mono label and value), but nothing is moving towards completion.
|
|
17
|
+
|
|
18
|
+
## Usage
|
|
19
|
+
|
|
20
|
+
```tsx
|
|
21
|
+
import { Meter } from "@zonsh/ui";
|
|
22
|
+
|
|
23
|
+
<Meter value={42} label="Storage used" showValue />;
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
`value` (within `min`–`max`, 0–100 by default), `label` and `showValue` cover most meters.
|
|
27
|
+
|
|
28
|
+
## When to use
|
|
29
|
+
|
|
30
|
+
- Static quantities: storage used, profile completeness, seats assigned.
|
|
31
|
+
- Work in progress is `Progress`.
|
|
32
|
+
|
|
33
|
+
## Examples
|
|
34
|
+
|
|
35
|
+
### Custom range
|
|
36
|
+
|
|
37
|
+
```tsx
|
|
38
|
+
import { Meter } from "@zonsh/ui";
|
|
39
|
+
|
|
40
|
+
export function CustomRange() {
|
|
41
|
+
return (
|
|
42
|
+
<div className="max-w-sm">
|
|
43
|
+
<Meter
|
|
44
|
+
value={7}
|
|
45
|
+
max={10}
|
|
46
|
+
label="Seats assigned"
|
|
47
|
+
showValue
|
|
48
|
+
format={{ style: "decimal" }}
|
|
49
|
+
getAriaValueText={(_, value) => `${value} of 10 seats`}
|
|
50
|
+
/>
|
|
51
|
+
</div>
|
|
52
|
+
);
|
|
53
|
+
}
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
### Thresholds
|
|
57
|
+
|
|
58
|
+
A `tone` function turns the disk amber at 80% and red at 95%; the label says it too.
|
|
59
|
+
|
|
60
|
+
```tsx
|
|
61
|
+
import { Meter } from "@zonsh/ui";
|
|
62
|
+
|
|
63
|
+
const diskTone = (value: number) => (value >= 95 ? "destructive" : value >= 80 ? "warning" : "default");
|
|
64
|
+
|
|
65
|
+
export function Thresholds() {
|
|
66
|
+
return (
|
|
67
|
+
<div className="flex max-w-sm flex-col gap-5">
|
|
68
|
+
<Meter value={52} label="Photos · 52%" tone={diskTone} />
|
|
69
|
+
<Meter value={91} label="Backups · 91%, 38 GB left" tone={diskTone} />
|
|
70
|
+
<Meter value={98} label="Videos · full in about 2 days" tone={diskTone} />
|
|
71
|
+
</div>
|
|
72
|
+
);
|
|
73
|
+
}
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
## Props
|
|
77
|
+
|
|
78
|
+
| Prop | Type | Default |
|
|
79
|
+
| ------------------ | -------------------------------- | ----------- |
|
|
80
|
+
| `value` | `number` | required |
|
|
81
|
+
| `label` | `ReactNode` — visible mono label | — |
|
|
82
|
+
| `showValue` | `boolean` | `false` |
|
|
83
|
+
| `tone` | `"default" \| "success" \| "warning" \| "info" \| "destructive"`, or `(value) => tone` | `"default"` |
|
|
84
|
+
| `min` / `max` | `number` | `0` / `100` |
|
|
85
|
+
| `format` | `Intl.NumberFormatOptions` | percent |
|
|
86
|
+
| `getAriaValueText` | `(formatted, value) => string` | — |
|
|
87
|
+
|
|
88
|
+
Base UI `Meter.Root` props are forwarded.
|
|
89
|
+
|
|
90
|
+
## Brand rules
|
|
91
|
+
|
|
92
|
+
- **Do** say what is measured and in what unit.
|
|
93
|
+
- **Do** pass a `tone` function when a line matters, and say it in text too ("91% · 38 GB left").
|
|
94
|
+
- **Don't** grade every value through a traffic light: an ordinary reading stays in the foreground ink.
|
|
95
|
+
|
|
96
|
+
## Accessibility
|
|
97
|
+
|
|
98
|
+
- `role="meter"` with value attributes, named by `label` or else `aria-label`.
|
|
99
|
+
- Use `getAriaValueText` for units ("7 of 10 seats").
|
|
100
|
+
|
|
101
|
+
---
|
|
102
|
+
|
|
103
|
+
- Import: `import { Meter } from "@zonsh/ui"`
|
|
104
|
+
- Source: `packages/ui/src/components/meter.tsx`
|
|
105
|
+
- Primitive: `@base-ui/react/meter` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/meter.md`)
|
|
@@ -0,0 +1,333 @@
|
|
|
1
|
+
# Money Input
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Field, FieldDescription, FieldLabel, MoneyInput } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
export function Basic() {
|
|
7
|
+
return (
|
|
8
|
+
<Field className="max-w-72">
|
|
9
|
+
<FieldLabel>Amount to send</FieldLabel>
|
|
10
|
+
<MoneyInput currency="EUR" locale="en-IE" name="amount" defaultValue="250.00" />
|
|
11
|
+
<FieldDescription>Arrives in the recipient's account within one working day.</FieldDescription>
|
|
12
|
+
</Field>
|
|
13
|
+
);
|
|
14
|
+
}
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
A recessed field like `Input` holding an amount in Licht Mono tabular figures, with the currency's symbol as a muted addon on the side the locale writes it (`€ 1,234.50` en-US, `1.234,50 €` de-DE). Focused, the amount is plain (`1234.50`); on blur it is grouped the locale's way (`1 234,50`, `12,34,567.00` in en-IN). Decimal places are the currency's — 0 for yen, 2 for euros, 3 for Kuwaiti dinars — and an extra digit is refused as typed, so nothing is rounded.
|
|
18
|
+
|
|
19
|
+
## Usage
|
|
20
|
+
|
|
21
|
+
```tsx
|
|
22
|
+
import { Field, FieldLabel, MoneyInput } from "@zonsh/ui";
|
|
23
|
+
|
|
24
|
+
<Field name="amount">
|
|
25
|
+
<FieldLabel>Amount to send</FieldLabel>
|
|
26
|
+
<MoneyInput currency="EUR" required max="10000" />
|
|
27
|
+
</Field>;
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
The props you'll set: `currency`, `value` / `onValueChange` and `min` / `max`.
|
|
31
|
+
|
|
32
|
+
## When to use
|
|
33
|
+
|
|
34
|
+
- Any amount of money someone enters: a transfer, a refund, a price, a limit, a budget line.
|
|
35
|
+
- One currency per field; to let people choose, pair it with a currency `Select` in a `ButtonGroup`.
|
|
36
|
+
- Not for a quantity or a percentage: `NumberField`. Not for showing an amount: format it with `Intl.NumberFormat` and set it in Licht Mono.
|
|
37
|
+
|
|
38
|
+
## The value
|
|
39
|
+
|
|
40
|
+
The value is an **exact decimal string** with exactly the currency's decimal places — `"1234.50"`, `"-0.05"`, `"15000"` for yen — or `null` when empty or not an amount. Never a JavaScript number, which can't hold 0.10 exactly and loses digits past 2^53; a string stays exact and goes straight into a decimal column or a JSON body.
|
|
41
|
+
|
|
42
|
+
`onValueChange` also gives **minor units** (cents, pence, fils) as a `bigint` (`"12.34"` → `1234n`); `toMinorUnits("12.34", "EUR")` and `fromMinorUnits(1234n, "EUR")` convert either way. Send a `bigint` in JSON as `String(minor)`.
|
|
43
|
+
|
|
44
|
+
Forms submit the decimal string under the field's name; `onFormSubmit` and a `Field`'s `validate` get it too, never the formatted text.
|
|
45
|
+
|
|
46
|
+
`NumberField` with `format={{ style: "currency" }}` is not a substitute: its value is a float, it reads a lone separator only the locale's way (`1,234.56` pasted into a German field is 1.23), and it keeps thousands separators while editing. Use it for quantities, this for money.
|
|
47
|
+
|
|
48
|
+
## Examples
|
|
49
|
+
|
|
50
|
+
### Currencies
|
|
51
|
+
|
|
52
|
+
`fractionDigits` overrides the currency's decimal places — whole euros on a price list, say.
|
|
53
|
+
|
|
54
|
+
```tsx
|
|
55
|
+
import { Field, FieldDescription, FieldLabel, MoneyInput } from "@zonsh/ui";
|
|
56
|
+
|
|
57
|
+
export function Currencies() {
|
|
58
|
+
return (
|
|
59
|
+
<div className="@container w-full max-w-xl">
|
|
60
|
+
<div className="grid gap-4 @md:grid-cols-2">
|
|
61
|
+
<Field>
|
|
62
|
+
<FieldLabel>Hotel deposit</FieldLabel>
|
|
63
|
+
<MoneyInput currency="JPY" locale="ja-JP" defaultValue="15000" />
|
|
64
|
+
<FieldDescription>Yen have no decimal places.</FieldDescription>
|
|
65
|
+
</Field>
|
|
66
|
+
<Field>
|
|
67
|
+
<FieldLabel>Rent</FieldLabel>
|
|
68
|
+
<MoneyInput currency="KWD" locale="en-KW" defaultValue="425.750" />
|
|
69
|
+
<FieldDescription>Kuwaiti dinars have three.</FieldDescription>
|
|
70
|
+
</Field>
|
|
71
|
+
<Field>
|
|
72
|
+
<FieldLabel>Course fee</FieldLabel>
|
|
73
|
+
<MoneyInput currency="USD" locale="en-US" defaultValue="1290" />
|
|
74
|
+
</Field>
|
|
75
|
+
<Field>
|
|
76
|
+
<FieldLabel>Kaution</FieldLabel>
|
|
77
|
+
<MoneyInput currency="EUR" locale="de-DE" defaultValue="1850.5" />
|
|
78
|
+
</Field>
|
|
79
|
+
</div>
|
|
80
|
+
</div>
|
|
81
|
+
);
|
|
82
|
+
}
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
### Locales
|
|
86
|
+
|
|
87
|
+
Formatting follows `locale`, else the `LocaleProvider`'s, else the browser's.
|
|
88
|
+
|
|
89
|
+
```tsx
|
|
90
|
+
import { Field, FieldLabel, MoneyInput } from "@zonsh/ui";
|
|
91
|
+
|
|
92
|
+
export function Locales() {
|
|
93
|
+
return (
|
|
94
|
+
<div className="@container w-full max-w-xl">
|
|
95
|
+
<div className="grid gap-4 @md:grid-cols-2">
|
|
96
|
+
<Field>
|
|
97
|
+
<FieldLabel>en-US</FieldLabel>
|
|
98
|
+
<MoneyInput currency="EUR" locale="en-US" defaultValue="1234567.89" />
|
|
99
|
+
</Field>
|
|
100
|
+
<Field>
|
|
101
|
+
<FieldLabel>de-DE</FieldLabel>
|
|
102
|
+
<MoneyInput currency="EUR" locale="de-DE" defaultValue="1234567.89" />
|
|
103
|
+
</Field>
|
|
104
|
+
<Field>
|
|
105
|
+
<FieldLabel>fr-CH</FieldLabel>
|
|
106
|
+
<MoneyInput currency="CHF" locale="fr-CH" defaultValue="1234567.89" />
|
|
107
|
+
</Field>
|
|
108
|
+
<Field>
|
|
109
|
+
<FieldLabel>en-IN</FieldLabel>
|
|
110
|
+
<MoneyInput currency="INR" locale="en-IN" defaultValue="1234567.89" />
|
|
111
|
+
</Field>
|
|
112
|
+
</div>
|
|
113
|
+
</div>
|
|
114
|
+
);
|
|
115
|
+
}
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
### Minor units
|
|
119
|
+
|
|
120
|
+
Controlled, showing what `onValueChange` reports.
|
|
121
|
+
|
|
122
|
+
```tsx
|
|
123
|
+
import { Field, FieldLabel, MoneyInput } from "@zonsh/ui";
|
|
124
|
+
import * as React from "react";
|
|
125
|
+
|
|
126
|
+
export function Value() {
|
|
127
|
+
const [value, setValue] = React.useState<string | null>("49.90");
|
|
128
|
+
const [minor, setMinor] = React.useState<bigint | null>(4990n);
|
|
129
|
+
return (
|
|
130
|
+
<div className="flex max-w-72 flex-col gap-4">
|
|
131
|
+
<Field>
|
|
132
|
+
<FieldLabel>Refund to the customer</FieldLabel>
|
|
133
|
+
<MoneyInput
|
|
134
|
+
currency="GBP"
|
|
135
|
+
locale="en-GB"
|
|
136
|
+
value={value}
|
|
137
|
+
onValueChange={(next, details) => {
|
|
138
|
+
setValue(next);
|
|
139
|
+
setMinor(details.minorUnits);
|
|
140
|
+
}}
|
|
141
|
+
/>
|
|
142
|
+
</Field>
|
|
143
|
+
<dl className="grid grid-cols-[auto_1fr] gap-x-4 gap-y-1 font-mono text-[13px] tabular-nums">
|
|
144
|
+
<dt className="text-muted-foreground">value</dt>
|
|
145
|
+
<dd data-testid="money-value">{value === null ? "null" : `"${value}"`}</dd>
|
|
146
|
+
<dt className="text-muted-foreground">minorUnits</dt>
|
|
147
|
+
<dd data-testid="money-minor">{minor === null ? "null" : `${minor}n`}</dd>
|
|
148
|
+
</dl>
|
|
149
|
+
</div>
|
|
150
|
+
);
|
|
151
|
+
}
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
### Bounds and negatives
|
|
155
|
+
|
|
156
|
+
Outside `min` / `max` the field is invalid with a message ("Enter €5,000.00 or less.") for `FieldError`; the amount is never changed for you. Negatives need `allowNegative`.
|
|
157
|
+
|
|
158
|
+
```tsx
|
|
159
|
+
import { Field, FieldDescription, FieldError, FieldLabel, MoneyInput } from "@zonsh/ui";
|
|
160
|
+
|
|
161
|
+
export function Bounds() {
|
|
162
|
+
return (
|
|
163
|
+
<div className="flex max-w-72 flex-col gap-5">
|
|
164
|
+
<Field validationMode="onChange">
|
|
165
|
+
<FieldLabel>Daily card limit</FieldLabel>
|
|
166
|
+
<MoneyInput currency="EUR" locale="en-IE" min="50" max="5000" defaultValue="750" />
|
|
167
|
+
<FieldDescription>Between €50 and €5,000.</FieldDescription>
|
|
168
|
+
<FieldError />
|
|
169
|
+
</Field>
|
|
170
|
+
<Field validationMode="onChange">
|
|
171
|
+
<FieldLabel>Correction to the ledger</FieldLabel>
|
|
172
|
+
<MoneyInput currency="USD" locale="en-US" allowNegative defaultValue="-12.40" />
|
|
173
|
+
<FieldDescription>Negative takes the amount off the balance.</FieldDescription>
|
|
174
|
+
<FieldError />
|
|
175
|
+
</Field>
|
|
176
|
+
</div>
|
|
177
|
+
);
|
|
178
|
+
}
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
### Sizes
|
|
182
|
+
|
|
183
|
+
```tsx
|
|
184
|
+
import { Field, FieldLabel, MoneyInput } from "@zonsh/ui";
|
|
185
|
+
|
|
186
|
+
export function Sizes() {
|
|
187
|
+
return (
|
|
188
|
+
<div className="flex max-w-72 flex-col gap-4">
|
|
189
|
+
<Field>
|
|
190
|
+
<FieldLabel>Dense</FieldLabel>
|
|
191
|
+
<MoneyInput size="sm" currency="EUR" locale="en-IE" defaultValue="18.00" />
|
|
192
|
+
</Field>
|
|
193
|
+
<Field>
|
|
194
|
+
<FieldLabel>Default</FieldLabel>
|
|
195
|
+
<MoneyInput currency="EUR" locale="en-IE" defaultValue="18.00" />
|
|
196
|
+
</Field>
|
|
197
|
+
<Field>
|
|
198
|
+
<FieldLabel>Prominent</FieldLabel>
|
|
199
|
+
<MoneyInput size="lg" currency="EUR" locale="en-IE" defaultValue="18.00" />
|
|
200
|
+
</Field>
|
|
201
|
+
</div>
|
|
202
|
+
);
|
|
203
|
+
}
|
|
204
|
+
```
|
|
205
|
+
|
|
206
|
+
### States
|
|
207
|
+
|
|
208
|
+
`readOnly` drops the recess and keeps the amount selectable.
|
|
209
|
+
|
|
210
|
+
```tsx
|
|
211
|
+
import { Field, FieldError, FieldLabel, MoneyInput } from "@zonsh/ui";
|
|
212
|
+
|
|
213
|
+
export function States() {
|
|
214
|
+
return (
|
|
215
|
+
<div className="flex max-w-72 flex-col gap-4">
|
|
216
|
+
<Field invalid>
|
|
217
|
+
<FieldLabel>Top up</FieldLabel>
|
|
218
|
+
<MoneyInput currency="EUR" locale="en-IE" defaultValue="2000" />
|
|
219
|
+
<FieldError match>Your balance allows €1,500.00 today.</FieldError>
|
|
220
|
+
</Field>
|
|
221
|
+
<Field disabled>
|
|
222
|
+
<FieldLabel>Membership fee</FieldLabel>
|
|
223
|
+
<MoneyInput currency="EUR" locale="en-IE" defaultValue="60" />
|
|
224
|
+
</Field>
|
|
225
|
+
<Field>
|
|
226
|
+
<FieldLabel>Invoice total</FieldLabel>
|
|
227
|
+
<MoneyInput currency="EUR" locale="en-IE" defaultValue="1180.25" readOnly />
|
|
228
|
+
</Field>
|
|
229
|
+
</div>
|
|
230
|
+
);
|
|
231
|
+
}
|
|
232
|
+
```
|
|
233
|
+
|
|
234
|
+
### In a form
|
|
235
|
+
|
|
236
|
+
`required`, `min` and `max` stop a `Form`'s submit, focus the field and show its `FieldError`.
|
|
237
|
+
|
|
238
|
+
```tsx
|
|
239
|
+
import { Button, Field, FieldDescription, FieldError, FieldLabel, Form, FormActions, MoneyInput, toMinorUnits } from "@zonsh/ui";
|
|
240
|
+
import * as React from "react";
|
|
241
|
+
|
|
242
|
+
export function InAForm() {
|
|
243
|
+
const [sent, setSent] = React.useState<string | null>(null);
|
|
244
|
+
return (
|
|
245
|
+
<Form
|
|
246
|
+
className="max-w-80"
|
|
247
|
+
onFormSubmit={(values: { amount: string }) =>
|
|
248
|
+
setSent(`${values.amount} (${toMinorUnits(values.amount, "CHF")} Rappen)`)
|
|
249
|
+
}
|
|
250
|
+
>
|
|
251
|
+
<Field name="amount">
|
|
252
|
+
<FieldLabel>Transfer</FieldLabel>
|
|
253
|
+
<MoneyInput currency="CHF" locale="de-CH" required min="1" max="10000" />
|
|
254
|
+
<FieldDescription>Up to CHF 10’000 a day.</FieldDescription>
|
|
255
|
+
<FieldError match="valueMissing">Enter the amount to transfer.</FieldError>
|
|
256
|
+
<FieldError match="customError" />
|
|
257
|
+
</Field>
|
|
258
|
+
<FormActions>
|
|
259
|
+
<Button type="submit">Review transfer</Button>
|
|
260
|
+
</FormActions>
|
|
261
|
+
{sent && (
|
|
262
|
+
<p data-testid="money-sent" className="font-mono text-[13px] text-muted-foreground tabular-nums">
|
|
263
|
+
Submitted {sent}
|
|
264
|
+
</p>
|
|
265
|
+
)}
|
|
266
|
+
</Form>
|
|
267
|
+
);
|
|
268
|
+
}
|
|
269
|
+
```
|
|
270
|
+
|
|
271
|
+
## Typing and pasting
|
|
272
|
+
|
|
273
|
+
- **Typing.** Digits in any script (Arabic-Indic, Devanagari, full-width), the decimal separator and, with `allowNegative`, a leading minus. Phones show the decimal keypad (`inputmode="decimal"`), or the full keyboard with `allowNegative`, as the pad has no minus.
|
|
274
|
+
- **Either separator.** Both `.` and `,` are read, since a keypad offers only its region's: the locale's decimal always as the decimal, the other as a thousands separator only before exactly three digits. In en-US `12,5` is 12.50 and `1,250` is 1250.00; in de-DE `12.5` is 12.50.
|
|
275
|
+
- **Pasting** reads either convention and drops a surrounding currency symbol or code: `1.234,56`, `1,234.56`, `€ 12`, `CHF 1'234.50`, `12,50 kr.` and the accounting `(12.00)` all read as you'd expect. With both `.` and `,`, the last one is the decimal.
|
|
276
|
+
- **Never guessed.** The locale's own decimal is never read as a thousands separator: `1.234` pasted into an en-US euro field is too many decimal places, and the field says so ("Use no more than 2 decimal places.") rather than making it 1,234.00.
|
|
277
|
+
|
|
278
|
+
## Props
|
|
279
|
+
|
|
280
|
+
| Prop | Type | Default |
|
|
281
|
+
| ------------------------ | ---------------------------------------------------------------------- | ----------------------- |
|
|
282
|
+
| `currency` | `string`: ISO 4217 code | — |
|
|
283
|
+
| `value` / `defaultValue` | `string \| null`: a decimal string, `"1234.50"` | — |
|
|
284
|
+
| `onValueChange` | `(value: string \| null, { minorUnits: bigint \| null }) => void` | — |
|
|
285
|
+
| `locale` | `string` (BCP 47) | the provider's, browser |
|
|
286
|
+
| `currencyDisplay` | `"symbol" \| "narrowSymbol" \| "code"` | `"symbol"` |
|
|
287
|
+
| `fractionDigits` | `number` | the currency's |
|
|
288
|
+
| `allowNegative` | `boolean` | `false` |
|
|
289
|
+
| `min` / `max` | `string \| number` | — |
|
|
290
|
+
| `size` | `"sm" \| "default" \| "lg"` | `"default"` |
|
|
291
|
+
| `name` | `string`: submits the decimal string | — |
|
|
292
|
+
| `required` | `boolean` | `false` |
|
|
293
|
+
| `disabled` / `readOnly` | `boolean` | `false` |
|
|
294
|
+
| `labels` | `{ invalid?, precision?, negative?, rangeUnderflow?, rangeOverflow? }` | English |
|
|
295
|
+
|
|
296
|
+
Other props (`placeholder`, `aria-*`, `onFocus`, `onBlur`, …) go to the visible `<input>`. A value with more decimal places than the currency (`"1.005"` for euros) is not an amount and shows as empty: the field doesn't round what you give it either. A form reset returns an uncontrolled field to its `defaultValue`.
|
|
297
|
+
|
|
298
|
+
`FieldError` messages come from `labels`, or a `LocaleProvider`'s `moneyInput`; `rangeUnderflow` and `rangeOverflow` get the bound formatted with the currency. A `FieldError` with `match="customError"` shows them; `match="valueMissing"` shows the empty required field.
|
|
299
|
+
|
|
300
|
+
On the server without `locale` it formats en-US until hydration; pass `locale` from the request to avoid the switch.
|
|
301
|
+
|
|
302
|
+
Data attributes: `data-slot="money-input"` and `data-size` on the field, `data-slot="money-input-currency"` on the symbol, and the `Field`'s `data-invalid`, `data-dirty`, `data-touched`, `data-filled` and `data-focused`.
|
|
303
|
+
|
|
304
|
+
## Brand rules
|
|
305
|
+
|
|
306
|
+
- **Do** keep the decimal string, or its minor units, from the field to the server. Never `parseFloat` it.
|
|
307
|
+
- **Do** name the currency in the field, not in the label: "Amount to send", with the € beside the number.
|
|
308
|
+
- **Do** set `min` and `max` to the real rule — a daily limit, a balance — and say it in a `FieldDescription`.
|
|
309
|
+
- **Don't** clamp or round an amount for people. Show the message and let them change it.
|
|
310
|
+
- **Don't** colour the amount. A negative amount is marked by its minus sign; status colour is for the message.
|
|
311
|
+
|
|
312
|
+
## Accessibility
|
|
313
|
+
|
|
314
|
+
- The input is a text field named by its `FieldLabel`, described by the `Field`'s description and error and by the currency's full name ("Euro", "Swiss Franc"), not its symbol.
|
|
315
|
+
- Errors use the destructive edge and a message, never colour alone.
|
|
316
|
+
- Clicking the currency addon focuses the field. The input stays at least 16px on phones, so iOS doesn't zoom.
|
|
317
|
+
|
|
318
|
+
### Keyboard
|
|
319
|
+
|
|
320
|
+
| Key | What it does |
|
|
321
|
+
| ----------- | ----------------------------------------------------------------------------------------------- |
|
|
322
|
+
| Tab | Moves into the field with the amount ungrouped and selected; leaving it groups the amount again |
|
|
323
|
+
| 0–9 / . / , | Types the amount; letters and other symbols are not typed |
|
|
324
|
+
| - (minus) | Makes the amount negative, typed in front, with `allowNegative` |
|
|
325
|
+
| ⌘V / Ctrl+V | Pastes an amount written in either convention, around a currency symbol or code |
|
|
326
|
+
|
|
327
|
+
Both `.` and `,` are read as described under Typing and pasting.
|
|
328
|
+
|
|
329
|
+
---
|
|
330
|
+
|
|
331
|
+
- Import: `import { MoneyInput, toMinorUnits, fromMinorUnits } from "@zonsh/ui"`
|
|
332
|
+
- Source: `packages/ui/src/components/money-input.tsx`
|
|
333
|
+
- Primitive: `@base-ui/react/field` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/field.md`)
|