@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,115 @@
|
|
|
1
|
+
# Quote
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Quote } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
export function Placeholder() {
|
|
7
|
+
return (
|
|
8
|
+
<Quote author="Person's name" byline="Role, Organisation" className="max-w-2xl">
|
|
9
|
+
Quote from a real customer goes here.
|
|
10
|
+
</Quote>
|
|
11
|
+
);
|
|
12
|
+
}
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
A quote card, shown with the placeholder it carries until a real quote is approved. A quote is an object, so it is a 20px card: Licht at 24–28px under a quiet opening mark, a mono attribution and an optional logo below a hairline.
|
|
16
|
+
|
|
17
|
+
> **Never invent quotes.** No testimonial, name, role or logo that does not exist or is not approved. Until you have one, use clearly placeholder text — "Quote from a real customer goes here." — so nothing fictional ships. A quote the owner gives you, or the page being redesigned already shows, is theirs to publish: keep its words.
|
|
18
|
+
|
|
19
|
+
## Usage
|
|
20
|
+
|
|
21
|
+
```tsx
|
|
22
|
+
import { Quote } from "@zonsh/ui";
|
|
23
|
+
|
|
24
|
+
<Quote author="Person's name" byline="Role, Organisation">
|
|
25
|
+
Quote from a real customer goes here.
|
|
26
|
+
</Quote>;
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
The props you'll reach for: `author`, `byline` and `logo`.
|
|
30
|
+
|
|
31
|
+
## When to use
|
|
32
|
+
|
|
33
|
+
- A real, approved statement from a customer, reader or partner, attributed by name.
|
|
34
|
+
- Not for your own claims dressed as quotes, nor pull quotes from your own copy — use typography.
|
|
35
|
+
|
|
36
|
+
## Examples
|
|
37
|
+
|
|
38
|
+
### With logo
|
|
39
|
+
|
|
40
|
+
The organisation's own mark, in one colour so it takes the ink — with their permission.
|
|
41
|
+
|
|
42
|
+
```tsx
|
|
43
|
+
import { Quote } from "@zonsh/ui";
|
|
44
|
+
|
|
45
|
+
export function WithLogo() {
|
|
46
|
+
return (
|
|
47
|
+
<Quote
|
|
48
|
+
author="Person's name"
|
|
49
|
+
byline="Role, Organisation"
|
|
50
|
+
logo={
|
|
51
|
+
<span className="inline-flex h-6 items-center rounded-item border border-dashed border-field-edge px-2 font-mono text-[10px] tracking-[0.14em] uppercase">
|
|
52
|
+
Their logo
|
|
53
|
+
</span>
|
|
54
|
+
}
|
|
55
|
+
className="max-w-2xl"
|
|
56
|
+
>
|
|
57
|
+
Quote from a real customer goes here. Use their words, with their approval, and nothing else.
|
|
58
|
+
</Quote>
|
|
59
|
+
);
|
|
60
|
+
}
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
### Small
|
|
64
|
+
|
|
65
|
+
`size="sm"`: 18–20px text and 24px padding, for two or three quotes side by side or one per `Carousel` slide.
|
|
66
|
+
|
|
67
|
+
```tsx
|
|
68
|
+
import { Quote } from "@zonsh/ui";
|
|
69
|
+
|
|
70
|
+
export function Small() {
|
|
71
|
+
return (
|
|
72
|
+
<ul className="m-0 grid w-full max-w-4xl list-none gap-4 p-0 md:grid-cols-2">
|
|
73
|
+
{["First", "Second"].map((n) => (
|
|
74
|
+
<li key={n} className="flex">
|
|
75
|
+
<Quote size="sm" author="Person's name" byline="Role, Organisation">
|
|
76
|
+
{n} quote from a real customer goes here, in their words and with their approval.
|
|
77
|
+
</Quote>
|
|
78
|
+
</li>
|
|
79
|
+
))}
|
|
80
|
+
</ul>
|
|
81
|
+
);
|
|
82
|
+
}
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
## Props
|
|
86
|
+
|
|
87
|
+
| Prop | Type | Default |
|
|
88
|
+
| ---------- | ------------------------------------------------ | ------- |
|
|
89
|
+
| `children` | `ReactNode` — the quote; `<p>`s are spaced | — |
|
|
90
|
+
| `author` | `ReactNode` — who said it | — |
|
|
91
|
+
| `byline` | `ReactNode` — role and organisation | — |
|
|
92
|
+
| `logo` | `ReactNode` — a small single-colour logo, 24px tall | — |
|
|
93
|
+
| `cite` | `string` — source URL, set on `<blockquote>` | — |
|
|
94
|
+
| `size` | `"default" \| "sm"` — 24–28px for one quote on its own; 18–20px with 24px padding for quotes side by side or in a carousel | `"default"` |
|
|
95
|
+
|
|
96
|
+
Renders `<figure>`, `<blockquote>`, `<figcaption>`; figure props are forwarded. For a size in between, set it on the text part: `className="[&_[data-slot=quote-text]]:text-[22px]"`.
|
|
97
|
+
|
|
98
|
+
## Brand rules
|
|
99
|
+
|
|
100
|
+
- **Do** use real words from a real person, approved for publication, with their name.
|
|
101
|
+
- **Do** keep it to one or two sentences.
|
|
102
|
+
- **Don't** invent quotes, names, roles, logos or results, not even as "realistic" demo content.
|
|
103
|
+
- **Don't** add star ratings, colour avatars or extra quotation marks.
|
|
104
|
+
- **Don't** remove the card material or change the 20px radius. It is an object.
|
|
105
|
+
|
|
106
|
+
## Accessibility
|
|
107
|
+
|
|
108
|
+
- `<blockquote>` in `<figure>` with the attribution in `<figcaption>`.
|
|
109
|
+
- The opening mark is decorative and `aria-hidden`.
|
|
110
|
+
- A logo image needs an `alt` with the organisation's name, or hide it if the byline already names it.
|
|
111
|
+
|
|
112
|
+
---
|
|
113
|
+
|
|
114
|
+
- Import: `import { Quote } from "@zonsh/ui"`
|
|
115
|
+
- Source: `packages/ui/src/components/quote.tsx`
|
|
@@ -0,0 +1,215 @@
|
|
|
1
|
+
# Radio Group
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Field, FieldItem, FieldLabel, Fieldset, FieldsetLegend, Radio, RadioGroup } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
export function Basic() {
|
|
7
|
+
return (
|
|
8
|
+
<Field name="shipping">
|
|
9
|
+
<Fieldset render={<RadioGroup defaultValue="standard" />}>
|
|
10
|
+
<FieldsetLegend>Shipping method</FieldsetLegend>
|
|
11
|
+
<FieldItem>
|
|
12
|
+
<FieldLabel>
|
|
13
|
+
<Radio value="standard" />
|
|
14
|
+
Standard, 3–5 working days
|
|
15
|
+
</FieldLabel>
|
|
16
|
+
</FieldItem>
|
|
17
|
+
<FieldItem>
|
|
18
|
+
<FieldLabel>
|
|
19
|
+
<Radio value="express" />
|
|
20
|
+
Express, next working day
|
|
21
|
+
</FieldLabel>
|
|
22
|
+
</FieldItem>
|
|
23
|
+
<FieldItem>
|
|
24
|
+
<FieldLabel>
|
|
25
|
+
<Radio value="pickup" />
|
|
26
|
+
Pick up in store
|
|
27
|
+
</FieldLabel>
|
|
28
|
+
</FieldItem>
|
|
29
|
+
</Fieldset>
|
|
30
|
+
</Field>
|
|
31
|
+
);
|
|
32
|
+
}
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
An 18px round control, recessed until chosen, then `--primary` with a small dot.
|
|
36
|
+
|
|
37
|
+
## Usage
|
|
38
|
+
|
|
39
|
+
```tsx
|
|
40
|
+
import { Field, FieldItem, FieldLabel, Fieldset, FieldsetLegend, Radio, RadioGroup } from "@zonsh/ui";
|
|
41
|
+
|
|
42
|
+
<Field name="shipping">
|
|
43
|
+
<Fieldset render={<RadioGroup defaultValue="standard" />}>
|
|
44
|
+
<FieldsetLegend>Shipping method</FieldsetLegend>
|
|
45
|
+
<FieldItem>
|
|
46
|
+
<FieldLabel>
|
|
47
|
+
<Radio value="standard" />
|
|
48
|
+
Standard, 3–5 working days
|
|
49
|
+
</FieldLabel>
|
|
50
|
+
</FieldItem>
|
|
51
|
+
<FieldItem>
|
|
52
|
+
<FieldLabel>
|
|
53
|
+
<Radio value="express" />
|
|
54
|
+
Express, next working day
|
|
55
|
+
</FieldLabel>
|
|
56
|
+
</FieldItem>
|
|
57
|
+
</Fieldset>
|
|
58
|
+
</Field>;
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
The props you'll reach for: `defaultValue` (or `value` / `onValueChange`) on the group, `value` on each `Radio`, and `name` on the `Field`.
|
|
62
|
+
|
|
63
|
+
## When to use
|
|
64
|
+
|
|
65
|
+
- One of 2–7 options that each need a sentence or description.
|
|
66
|
+
- 2–5 short labels compared side by side: `ToggleGroup`.
|
|
67
|
+
- Long lists: `Select`, or `Combobox` when typing helps.
|
|
68
|
+
|
|
69
|
+
## Examples
|
|
70
|
+
|
|
71
|
+
### With descriptions
|
|
72
|
+
|
|
73
|
+
`FieldItem` takes a description per option; indent it `pl-7` to align with the label.
|
|
74
|
+
|
|
75
|
+
```tsx
|
|
76
|
+
import { Field, FieldDescription, FieldItem, FieldLabel, Fieldset, FieldsetLegend, Radio, RadioGroup } from "@zonsh/ui";
|
|
77
|
+
|
|
78
|
+
const options = [
|
|
79
|
+
{
|
|
80
|
+
value: "private",
|
|
81
|
+
label: "Private",
|
|
82
|
+
description: "Only you can see the project and its preview links.",
|
|
83
|
+
},
|
|
84
|
+
{
|
|
85
|
+
value: "team",
|
|
86
|
+
label: "Team",
|
|
87
|
+
description: "Everyone in the workspace can open it; only editors can change it.",
|
|
88
|
+
},
|
|
89
|
+
{
|
|
90
|
+
value: "public",
|
|
91
|
+
label: "Public",
|
|
92
|
+
description: "Anyone with the link can view the deployed site and its source.",
|
|
93
|
+
},
|
|
94
|
+
];
|
|
95
|
+
|
|
96
|
+
export function WithDescriptions() {
|
|
97
|
+
return (
|
|
98
|
+
<Field name="visibility" className="max-w-md">
|
|
99
|
+
<Fieldset render={<RadioGroup defaultValue="team" />}>
|
|
100
|
+
<FieldsetLegend>Who can see this project?</FieldsetLegend>
|
|
101
|
+
{options.map((option) => (
|
|
102
|
+
<FieldItem key={option.value} className="gap-1">
|
|
103
|
+
<FieldLabel>
|
|
104
|
+
<Radio value={option.value} />
|
|
105
|
+
{option.label}
|
|
106
|
+
</FieldLabel>
|
|
107
|
+
<FieldDescription className="pl-7">{option.description}</FieldDescription>
|
|
108
|
+
</FieldItem>
|
|
109
|
+
))}
|
|
110
|
+
</Fieldset>
|
|
111
|
+
</Field>
|
|
112
|
+
);
|
|
113
|
+
}
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
### States
|
|
117
|
+
|
|
118
|
+
`<FieldItem disabled>` disables one option; say why in its label.
|
|
119
|
+
|
|
120
|
+
```tsx
|
|
121
|
+
import { Field, FieldError, FieldItem, FieldLabel, Fieldset, FieldsetLegend, Radio, RadioGroup } from "@zonsh/ui";
|
|
122
|
+
|
|
123
|
+
function Disabled() {
|
|
124
|
+
return (
|
|
125
|
+
<Field name="hosting">
|
|
126
|
+
<Fieldset render={<RadioGroup defaultValue="eu" />}>
|
|
127
|
+
<FieldsetLegend>Hosting region</FieldsetLegend>
|
|
128
|
+
<FieldItem>
|
|
129
|
+
<FieldLabel>
|
|
130
|
+
<Radio value="eu" />
|
|
131
|
+
European Union
|
|
132
|
+
</FieldLabel>
|
|
133
|
+
</FieldItem>
|
|
134
|
+
<FieldItem disabled>
|
|
135
|
+
<FieldLabel>
|
|
136
|
+
<Radio value="us" />
|
|
137
|
+
United States (not available for this project)
|
|
138
|
+
</FieldLabel>
|
|
139
|
+
</FieldItem>
|
|
140
|
+
</Fieldset>
|
|
141
|
+
</Field>
|
|
142
|
+
);
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
function Invalid() {
|
|
146
|
+
return (
|
|
147
|
+
<Field name="timeline" invalid>
|
|
148
|
+
<Fieldset render={<RadioGroup />}>
|
|
149
|
+
<FieldsetLegend>When do you need it?</FieldsetLegend>
|
|
150
|
+
<FieldItem>
|
|
151
|
+
<FieldLabel>
|
|
152
|
+
<Radio value="soon" />
|
|
153
|
+
As soon as possible
|
|
154
|
+
</FieldLabel>
|
|
155
|
+
</FieldItem>
|
|
156
|
+
<FieldItem>
|
|
157
|
+
<FieldLabel>
|
|
158
|
+
<Radio value="quarter" />
|
|
159
|
+
Within three months
|
|
160
|
+
</FieldLabel>
|
|
161
|
+
</FieldItem>
|
|
162
|
+
<FieldItem>
|
|
163
|
+
<FieldLabel>
|
|
164
|
+
<Radio value="later" />
|
|
165
|
+
Later this year
|
|
166
|
+
</FieldLabel>
|
|
167
|
+
</FieldItem>
|
|
168
|
+
</Fieldset>
|
|
169
|
+
<FieldError match>Pick the closest option. A rough idea is fine.</FieldError>
|
|
170
|
+
</Field>
|
|
171
|
+
);
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
/** The invalid and disabled states, one under the other. */
|
|
175
|
+
export function States() {
|
|
176
|
+
return (
|
|
177
|
+
<div className="flex w-full max-w-sm flex-col gap-8">
|
|
178
|
+
<Invalid />
|
|
179
|
+
<Disabled />
|
|
180
|
+
</div>
|
|
181
|
+
);
|
|
182
|
+
}
|
|
183
|
+
```
|
|
184
|
+
|
|
185
|
+
## Props
|
|
186
|
+
|
|
187
|
+
`RadioGroup`: `value`, `defaultValue`, `onValueChange`, `name`, `required`, `disabled`, `readOnly`. `Radio`: `value` (required), `disabled`, `readOnly`. The group stacks its options with a 12px gap. Other Base UI props are forwarded. Data attributes: `data-checked`, `data-unchecked`, `data-disabled`, `data-invalid`.
|
|
188
|
+
|
|
189
|
+
## Brand rules
|
|
190
|
+
|
|
191
|
+
- **Do** start with a sensible `defaultValue`, or make the choice `required`.
|
|
192
|
+
- **Do** write parallel options that are easy to scan.
|
|
193
|
+
- **Don't** lay radios out in a row when the labels wrap. Use a column.
|
|
194
|
+
- **Don't** use radios for actions. Choosing one never submits anything.
|
|
195
|
+
|
|
196
|
+
## Accessibility
|
|
197
|
+
|
|
198
|
+
- The legend names the group (`Fieldset` + `FieldsetLegend`); each option keeps a visible label.
|
|
199
|
+
- The wrapping `FieldLabel` is the touch target: the whole line chooses the option, not just the 18px radio.
|
|
200
|
+
- Errors show a destructive border and ring on each radio, plus a `FieldError` message.
|
|
201
|
+
|
|
202
|
+
### Keyboard
|
|
203
|
+
|
|
204
|
+
| Key | What it does |
|
|
205
|
+
| ----- | ----------------------------------------------------------------------------------------------------- |
|
|
206
|
+
| Tab | Moves into the group, onto the chosen option (or the first), and out again: the group is one Tab stop |
|
|
207
|
+
| ↓ / → | Moves to the next option and chooses it, looping at the end (← and → swapped right to left) |
|
|
208
|
+
| ↑ / ← | Moves to the previous option and chooses it, looping at the start |
|
|
209
|
+
| Space | Chooses the focused option, when none is chosen yet |
|
|
210
|
+
|
|
211
|
+
---
|
|
212
|
+
|
|
213
|
+
- Import: `import { RadioGroup, Radio } from "@zonsh/ui"`
|
|
214
|
+
- Source: `packages/ui/src/components/radio-group.tsx`
|
|
215
|
+
- Primitive: `@base-ui/react/radio-group` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/radio-group.md`)
|
|
@@ -0,0 +1,260 @@
|
|
|
1
|
+
# Rating
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Field, FieldLabel, Rating } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
export function Basic() {
|
|
7
|
+
return (
|
|
8
|
+
<Field name="delivery">
|
|
9
|
+
<FieldLabel>How was the delivery?</FieldLabel>
|
|
10
|
+
<Rating defaultValue={4} />
|
|
11
|
+
</Field>
|
|
12
|
+
);
|
|
13
|
+
}
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
Stars in the ink — outlines in `--control-muted`, filled in `--foreground`, softer ink under the pointer — in a row as tall as a control (30, 38 or 46px). Underneath is a Base UI radio group, one radio per star (two with `allowHalf`), so keyboard, forms and `Field` work as usual.
|
|
17
|
+
|
|
18
|
+
## Usage
|
|
19
|
+
|
|
20
|
+
```tsx
|
|
21
|
+
import { Field, FieldLabel, Rating } from "@zonsh/ui";
|
|
22
|
+
|
|
23
|
+
<Field name="delivery">
|
|
24
|
+
<FieldLabel>How was the delivery?</FieldLabel>
|
|
25
|
+
<Rating defaultValue={4} />
|
|
26
|
+
</Field>;
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
- `value` / `defaultValue`, `onValueChange` — a number, or `null` for not rated.
|
|
30
|
+
- `readOnly` — a picture of any score.
|
|
31
|
+
- `allowHalf` — half stars.
|
|
32
|
+
|
|
33
|
+
## When to use
|
|
34
|
+
|
|
35
|
+
- A score given on a feeling: a delivery, a recipe, a support conversation. `readOnly` shows one: an average, a review's score.
|
|
36
|
+
- A precise number is a `NumberField` or `Slider`; a yes/no a `Switch`; named options ("Too easy, Just right") a `RadioGroup` or `ToggleGroup`.
|
|
37
|
+
|
|
38
|
+
## Examples
|
|
39
|
+
|
|
40
|
+
### Half stars
|
|
41
|
+
|
|
42
|
+
Each star is two choices; arrows step by a half. On touch a finger can slide along the row and sets the rating where it lifts. A dense (`sm`) rating spaces its stars to 24px targets on touch.
|
|
43
|
+
|
|
44
|
+
```tsx
|
|
45
|
+
import { Field, FieldLabel, Rating } from "@zonsh/ui";
|
|
46
|
+
import * as React from "react";
|
|
47
|
+
|
|
48
|
+
export function Halves() {
|
|
49
|
+
const [value, setValue] = React.useState<number | null>(3.5);
|
|
50
|
+
return (
|
|
51
|
+
<Field name="difficulty" className="items-start">
|
|
52
|
+
<FieldLabel>How hard was the course?</FieldLabel>
|
|
53
|
+
<div className="flex items-center gap-3">
|
|
54
|
+
<Rating allowHalf value={value} onValueChange={setValue} />
|
|
55
|
+
<span className="font-mono text-xs text-muted-foreground tabular-nums">
|
|
56
|
+
{value == null ? "Not rated" : `${value} / 5`}
|
|
57
|
+
</span>
|
|
58
|
+
</div>
|
|
59
|
+
</Field>
|
|
60
|
+
);
|
|
61
|
+
}
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
### Clearable
|
|
65
|
+
|
|
66
|
+
Picking the current rating again clears it, as do Backspace and Delete.
|
|
67
|
+
|
|
68
|
+
```tsx
|
|
69
|
+
import { Field, FieldDescription, FieldLabel, Rating } from "@zonsh/ui";
|
|
70
|
+
import * as React from "react";
|
|
71
|
+
|
|
72
|
+
export function Clearable() {
|
|
73
|
+
const [value, setValue] = React.useState<number | null>(2);
|
|
74
|
+
return (
|
|
75
|
+
<Field name="recipe" className="items-start">
|
|
76
|
+
<FieldLabel>Rate this recipe</FieldLabel>
|
|
77
|
+
<Rating clearable value={value} onValueChange={setValue} />
|
|
78
|
+
<FieldDescription>
|
|
79
|
+
{value == null ? "No rating yet." : "Pick the same star again, or press Backspace, to clear it."}
|
|
80
|
+
</FieldDescription>
|
|
81
|
+
</Field>
|
|
82
|
+
);
|
|
83
|
+
}
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
### Read-only
|
|
87
|
+
|
|
88
|
+
Any score — 3.7 fills most of the fourth star — read out as "3.7 out of 5". Put the review count beside an average.
|
|
89
|
+
|
|
90
|
+
```tsx
|
|
91
|
+
import { Rating } from "@zonsh/ui";
|
|
92
|
+
|
|
93
|
+
const reviews = [
|
|
94
|
+
{ title: "Ceramic mug", rating: 4.5, count: 38 },
|
|
95
|
+
{ title: "Linen tote bag", rating: 3.7, count: 12 },
|
|
96
|
+
{ title: "Desk lamp", rating: 5, count: 1 },
|
|
97
|
+
];
|
|
98
|
+
|
|
99
|
+
export function ReadOnly() {
|
|
100
|
+
return (
|
|
101
|
+
<ul className="m-0 flex w-full max-w-sm list-none flex-col p-0">
|
|
102
|
+
{reviews.map((product) => (
|
|
103
|
+
<li
|
|
104
|
+
key={product.title}
|
|
105
|
+
className="flex items-center justify-between gap-4 border-t border-border/60 py-2 last:border-b"
|
|
106
|
+
>
|
|
107
|
+
<span className="text-sm text-foreground">{product.title}</span>
|
|
108
|
+
<span className="flex items-center gap-2">
|
|
109
|
+
<Rating readOnly size="sm" value={product.rating} />
|
|
110
|
+
<span className="font-mono text-xs text-muted-foreground tabular-nums">
|
|
111
|
+
{product.rating} · {product.count} {product.count === 1 ? "review" : "reviews"}
|
|
112
|
+
</span>
|
|
113
|
+
</span>
|
|
114
|
+
</li>
|
|
115
|
+
))}
|
|
116
|
+
</ul>
|
|
117
|
+
);
|
|
118
|
+
}
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
### Sizes
|
|
122
|
+
|
|
123
|
+
`sm` 30px / 16px stars, `default` 38px / 20px, `lg` 46px / 24px.
|
|
124
|
+
|
|
125
|
+
```tsx
|
|
126
|
+
import { Rating } from "@zonsh/ui";
|
|
127
|
+
|
|
128
|
+
export function Sizes() {
|
|
129
|
+
return (
|
|
130
|
+
<div className="flex flex-col items-start gap-4">
|
|
131
|
+
<Rating size="sm" defaultValue={3} aria-label="Small" />
|
|
132
|
+
<Rating defaultValue={3} aria-label="Default" />
|
|
133
|
+
<Rating size="lg" defaultValue={3} aria-label="Large" />
|
|
134
|
+
</div>
|
|
135
|
+
);
|
|
136
|
+
}
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
### In a form
|
|
140
|
+
|
|
141
|
+
It submits its number under the `Field`'s name; `required` blocks an empty submit, turning the empty stars red with a `FieldError`. Reset restores it.
|
|
142
|
+
|
|
143
|
+
```tsx
|
|
144
|
+
import { Button, Field, FieldError, FieldLabel, Form, FormActions, Rating, Textarea } from "@zonsh/ui";
|
|
145
|
+
import * as React from "react";
|
|
146
|
+
|
|
147
|
+
export function InForm() {
|
|
148
|
+
const [sent, setSent] = React.useState<string | null>(null);
|
|
149
|
+
return (
|
|
150
|
+
<Form
|
|
151
|
+
className="w-full max-w-md"
|
|
152
|
+
onFormSubmit={(values) => setSent(`${values.stars} out of 5`)}
|
|
153
|
+
onReset={() => setSent(null)}
|
|
154
|
+
>
|
|
155
|
+
<Field name="stars">
|
|
156
|
+
<FieldLabel>Your rating</FieldLabel>
|
|
157
|
+
<Rating required />
|
|
158
|
+
<FieldError match="valueMissing">Pick from one to five stars.</FieldError>
|
|
159
|
+
</Field>
|
|
160
|
+
<Field name="review">
|
|
161
|
+
<FieldLabel>What stood out?</FieldLabel>
|
|
162
|
+
<Textarea placeholder="The handle stays cool, the glaze has a small chip on the rim…" />
|
|
163
|
+
</Field>
|
|
164
|
+
<FormActions align="between">
|
|
165
|
+
<Button type="reset" variant="ghost">
|
|
166
|
+
Clear
|
|
167
|
+
</Button>
|
|
168
|
+
<Button type="submit">Post review</Button>
|
|
169
|
+
</FormActions>
|
|
170
|
+
{sent && (
|
|
171
|
+
<p role="status" className="m-0 text-sm text-foreground-soft">
|
|
172
|
+
Posted: {sent}.
|
|
173
|
+
</p>
|
|
174
|
+
)}
|
|
175
|
+
</Form>
|
|
176
|
+
);
|
|
177
|
+
}
|
|
178
|
+
```
|
|
179
|
+
|
|
180
|
+
### Another icon
|
|
181
|
+
|
|
182
|
+
`icon` takes any lucide icon; change `labels.item` to match.
|
|
183
|
+
|
|
184
|
+
```tsx
|
|
185
|
+
import { Field, FieldLabel, Rating } from "@zonsh/ui";
|
|
186
|
+
import { HeartIcon } from "lucide-react";
|
|
187
|
+
|
|
188
|
+
export function Icon() {
|
|
189
|
+
return (
|
|
190
|
+
<Field name="favourite">
|
|
191
|
+
<FieldLabel>How much did you enjoy the walk?</FieldLabel>
|
|
192
|
+
<Rating max={3} defaultValue={2} icon={<HeartIcon />} labels={{ item: (value) => `${value} of 3` }} />
|
|
193
|
+
</Field>
|
|
194
|
+
);
|
|
195
|
+
}
|
|
196
|
+
```
|
|
197
|
+
|
|
198
|
+
### Disabled
|
|
199
|
+
|
|
200
|
+
```tsx
|
|
201
|
+
import { Field, FieldLabel, Rating } from "@zonsh/ui";
|
|
202
|
+
|
|
203
|
+
export function Disabled() {
|
|
204
|
+
return (
|
|
205
|
+
<Field name="locked" disabled>
|
|
206
|
+
<FieldLabel>Rating (closed after 30 days)</FieldLabel>
|
|
207
|
+
<Rating defaultValue={4} />
|
|
208
|
+
</Field>
|
|
209
|
+
);
|
|
210
|
+
}
|
|
211
|
+
```
|
|
212
|
+
|
|
213
|
+
## Props
|
|
214
|
+
|
|
215
|
+
| Prop | Type | Default |
|
|
216
|
+
| -------------------------------------- | ------------------------------------------------------ | -------------- |
|
|
217
|
+
| `value` / `defaultValue` | `number \| null` | — / `null` |
|
|
218
|
+
| `onValueChange` | `(value: number \| null) => void` | — |
|
|
219
|
+
| `max` | `number` — how many stars | `5` |
|
|
220
|
+
| `allowHalf` | `boolean` | `false` |
|
|
221
|
+
| `clearable` | `boolean` | `false` |
|
|
222
|
+
| `readOnly` | `boolean` — a picture of the score | `false` |
|
|
223
|
+
| `size` | `"sm" \| "default" \| "lg"` | `"default"` |
|
|
224
|
+
| `icon` | a lucide icon element | `<StarIcon />` |
|
|
225
|
+
| `name`, `required`, `disabled`, `form` | as on a `RadioGroup`; `name` defaults to the `Field`'s | — |
|
|
226
|
+
| `labels` | `Partial<RatingMessages>` | English |
|
|
227
|
+
|
|
228
|
+
Other `RadioGroup` props are forwarded. Data attributes: `data-size`, and the Field's `data-invalid`, `data-disabled`, `data-touched` … Names ("1 star", "4.5 out of 5", "Not rated") come from `messages.rating` or `labels`, with numbers in the locale.
|
|
229
|
+
|
|
230
|
+
## Brand rules
|
|
231
|
+
|
|
232
|
+
- **Do** keep the stars in the ink: a rating is a value, not a status. No yellow, no green for five.
|
|
233
|
+
- **Do** label it with the question ("How was the delivery?"), not "Rating".
|
|
234
|
+
- **Do** show the count next to an average.
|
|
235
|
+
- **Don't** invent reviews or averages to fill a product page.
|
|
236
|
+
- **Don't** add a confirm step: picking a star is the answer.
|
|
237
|
+
|
|
238
|
+
## Accessibility
|
|
239
|
+
|
|
240
|
+
- A `radiogroup` named by the `FieldLabel` (or `aria-label`), with a `radio` per star: "1 star" … "5 stars" ("0.5 stars" … with halves).
|
|
241
|
+
- The focused star has the 2px outline; invalid is red stars plus the `FieldError` text.
|
|
242
|
+
- Read-only, it is one `img` named "4.5 out of 5" or "Not rated", so a product list reads a line each.
|
|
243
|
+
|
|
244
|
+
### Keyboard
|
|
245
|
+
|
|
246
|
+
| Key | What it does |
|
|
247
|
+
| ------------------ | -------------------------------------------------------------------------------------- |
|
|
248
|
+
| Tab | Moves to the picked star, or the first |
|
|
249
|
+
| ← / → | Lowers or raises the rating and picks it, wrapping at the ends (swapped right to left) |
|
|
250
|
+
| ↑ / ↓ | Raises or lowers the rating: ↑ raises it, ↓ lowers it |
|
|
251
|
+
| Space | Picks the focused star |
|
|
252
|
+
| Backspace / Delete | Clears the rating, when it is `clearable` |
|
|
253
|
+
|
|
254
|
+
With `allowHalf`, each key moves a half. ← and → swap right to left (`dir="rtl"` or a `DirectionProvider`); ↑ and ↓ never do. From no rating, ↑ (or → left to right) picks the lowest and ↓ the highest.
|
|
255
|
+
|
|
256
|
+
---
|
|
257
|
+
|
|
258
|
+
- Import: `import { Rating } from "@zonsh/ui"`
|
|
259
|
+
- Source: `packages/ui/src/components/rating.tsx`
|
|
260
|
+
- Primitive: `@base-ui/react/radio-group` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/radio-group.md`)
|
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
# Reasoning
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Reasoning, ReasoningContent, ReasoningTrigger } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
/* Illustrative reasoning, not real data. */
|
|
7
|
+
const thoughts = `The question is what can be cooked tonight with what is in the fridge.
|
|
8
|
+
There are eggs, spinach, feta and half a bag of rice.
|
|
9
|
+
A frittata uses the eggs, spinach and feta, and takes about twenty minutes.
|
|
10
|
+
Fried rice needs soy sauce, which is not on the list — so suggest the frittata first.`;
|
|
11
|
+
|
|
12
|
+
export function Basic() {
|
|
13
|
+
return (
|
|
14
|
+
<div className="w-full max-w-2xl">
|
|
15
|
+
<Reasoning duration={4}>
|
|
16
|
+
<ReasoningTrigger />
|
|
17
|
+
<ReasoningContent>{thoughts}</ReasoningContent>
|
|
18
|
+
</Reasoning>
|
|
19
|
+
</div>
|
|
20
|
+
);
|
|
21
|
+
}
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
The model's thinking, folded under a mono trigger; open, it is muted text beside a hairline. The answer is the `Response` under it.
|
|
25
|
+
|
|
26
|
+
## Usage
|
|
27
|
+
|
|
28
|
+
```tsx
|
|
29
|
+
import { Reasoning, ReasoningContent, ReasoningTrigger } from "@zonsh/ui";
|
|
30
|
+
|
|
31
|
+
<Reasoning streaming={part.state === "streaming"}>
|
|
32
|
+
<ReasoningTrigger />
|
|
33
|
+
<ReasoningContent>{part.text}</ReasoningContent>
|
|
34
|
+
</Reasoning>;
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
The props you'll reach for: `streaming`, `duration`, and `open` / `onOpenChange` to control it.
|
|
38
|
+
|
|
39
|
+
## When to use
|
|
40
|
+
|
|
41
|
+
- Above the reply, for models that expose reasoning. Pass the text, or a `Response` for markdown.
|
|
42
|
+
- Steps taken with tools are `ToolCall`s; reasoning is the thinking between them.
|
|
43
|
+
|
|
44
|
+
## Examples
|
|
45
|
+
|
|
46
|
+
### Streaming
|
|
47
|
+
|
|
48
|
+
While `streaming`, "Thinking…" shimmers and the panel opens. When it ends, the label gives the time taken (`duration`, or measured) and a second later the panel folds on the slower glide — unless the reader opened or closed it. This demo keeps thinking.
|
|
49
|
+
|
|
50
|
+
```tsx
|
|
51
|
+
import { Reasoning, ReasoningContent, ReasoningTrigger } from "@zonsh/ui";
|
|
52
|
+
|
|
53
|
+
// thoughts: as in the first example on this page that uses them.
|
|
54
|
+
|
|
55
|
+
/** Thinking, for as long as the page is open: the finished state is the example above. */
|
|
56
|
+
export function Streaming() {
|
|
57
|
+
return (
|
|
58
|
+
<div className="w-full max-w-2xl">
|
|
59
|
+
<Reasoning streaming>
|
|
60
|
+
<ReasoningTrigger />
|
|
61
|
+
<ReasoningContent>{thoughts}</ReasoningContent>
|
|
62
|
+
</Reasoning>
|
|
63
|
+
</div>
|
|
64
|
+
);
|
|
65
|
+
}
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
## Props
|
|
69
|
+
|
|
70
|
+
| Component | Prop | Type | Default |
|
|
71
|
+
| ------------------ | --------------------------------------- | ----------------------------------------- | --------------------------------- |
|
|
72
|
+
| `Reasoning` | `streaming` | `boolean` | `false` |
|
|
73
|
+
| | `duration` | `number` — seconds; measured if not given | — |
|
|
74
|
+
| | `open` / `defaultOpen` / `onOpenChange` | Base UI `Collapsible` props | open while streaming |
|
|
75
|
+
| `ReasoningTrigger` | `children` | replaces the label | Thinking… / Thought for n seconds |
|
|
76
|
+
|
|
77
|
+
Data attributes: `data-streaming` on the root and the label; `data-panel-open` on the trigger.
|
|
78
|
+
|
|
79
|
+
`ReasoningTrigger` takes `labels` (`Partial<ReasoningMessages>`: `thinking`, `thoughtBriefly`, `thoughtFor(seconds)`); a `LocaleProvider` sets them for every trigger (`messages.reasoning`).
|
|
80
|
+
|
|
81
|
+
## Brand rules
|
|
82
|
+
|
|
83
|
+
- **Do** keep it folded once the answer is there. Readers who want it can open it.
|
|
84
|
+
- **Don't** style the reasoning like the answer. It stays muted and smaller.
|
|
85
|
+
- **Don't** invent a duration. Pass the real one or let it measure.
|
|
86
|
+
|
|
87
|
+
## Accessibility
|
|
88
|
+
|
|
89
|
+
- The trigger is a button with `aria-expanded`; open, the panel's content stays in the reading order.
|
|
90
|
+
- Under reduced motion the label breathes in opacity instead of shimmering, and the panel opens and closes instantly.
|
|
91
|
+
|
|
92
|
+
### Keyboard
|
|
93
|
+
|
|
94
|
+
| Key | What it does |
|
|
95
|
+
| ------------- | --------------------------------------------------------------------- |
|
|
96
|
+
| Enter / Space | Opens or closes the reasoning from the trigger |
|
|
97
|
+
| Tab | Moves from the trigger into the open panel; a closed panel is skipped |
|
|
98
|
+
|
|
99
|
+
---
|
|
100
|
+
|
|
101
|
+
- Import: `import { Reasoning, ReasoningTrigger, ReasoningContent } from "@zonsh/ui"`
|
|
102
|
+
- Source: `packages/ui/src/components/reasoning.tsx`
|