@zonsh/ui 0.5.0 → 0.6.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +643 -0
- package/README.md +49 -21
- package/dist/brand.d.ts +3 -0
- package/dist/brand.js +7 -0
- package/dist/components/_breadcrumb-more.d.ts +6 -0
- package/dist/components/_breadcrumb-more.js +5 -0
- package/dist/components/_drawing-svg.d.ts +11 -0
- package/dist/components/_drawing-svg.js +30 -0
- package/dist/components/_media.d.ts +159 -0
- package/dist/components/_media.js +266 -0
- package/dist/components/_overlay.d.ts +8 -5
- package/dist/components/_overlay.js +11 -6
- package/dist/components/_scheduler-calendar.d.ts +71 -0
- package/dist/components/_scheduler-calendar.js +940 -0
- package/dist/components/_scheduler-editor.d.ts +29 -0
- package/dist/components/_scheduler-editor.js +111 -0
- package/dist/components/_scheduler-menu.d.ts +16 -0
- package/dist/components/_scheduler-menu.js +18 -0
- package/dist/components/_scheduler-parts.d.ts +164 -0
- package/dist/components/_scheduler-parts.js +327 -0
- package/dist/components/_suggest-list.d.ts +142 -0
- package/dist/components/_suggest-list.js +159 -0
- package/dist/components/_toolbar-more.d.ts +24 -0
- package/dist/components/_toolbar-more.js +25 -0
- package/dist/components/accordion.d.ts +1 -1
- package/dist/components/accordion.js +6 -6
- package/dist/components/action-sheet.d.ts +88 -0
- package/dist/components/action-sheet.js +124 -0
- package/dist/components/alert-dialog.js +3 -1
- package/dist/components/alert.d.ts +11 -18
- package/dist/components/alert.js +9 -6
- package/dist/components/app-bar.d.ts +93 -0
- package/dist/components/app-bar.js +175 -0
- package/dist/components/audio-player.d.ts +134 -0
- package/dist/components/audio-player.js +618 -0
- package/dist/components/avatar.d.ts +6 -6
- package/dist/components/avatar.js +13 -11
- package/dist/components/badge.d.ts +12 -12
- package/dist/components/badge.js +7 -5
- package/dist/components/bottom-nav.d.ts +53 -11
- package/dist/components/bottom-nav.js +388 -23
- package/dist/components/breadcrumb.d.ts +11 -2
- package/dist/components/breadcrumb.js +60 -6
- package/dist/components/button-group.js +5 -1
- package/dist/components/button.d.ts +23 -6
- package/dist/components/button.js +63 -7
- package/dist/components/calendar.js +8 -6
- package/dist/components/card.d.ts +10 -8
- package/dist/components/card.js +15 -14
- package/dist/components/carousel.d.ts +2 -2
- package/dist/components/carousel.js +21 -8
- package/dist/components/chart.d.ts +27 -1
- package/dist/components/chart.js +15 -5
- package/dist/components/checkbox.js +2 -2
- package/dist/components/code-block.d.ts +9 -2
- package/dist/components/code-block.js +26 -7
- package/dist/components/collapsible.js +3 -3
- package/dist/components/color-picker.d.ts +2 -2
- package/dist/components/color-picker.js +5 -5
- package/dist/components/combobox.d.ts +26 -7
- package/dist/components/combobox.js +32 -13
- package/dist/components/command.d.ts +29 -5
- package/dist/components/command.js +35 -10
- package/dist/components/context-menu.d.ts +5 -2
- package/dist/components/context-menu.js +24 -3
- package/dist/components/conversation.d.ts +1 -1
- package/dist/components/conversation.js +67 -13
- package/dist/components/copy-button.d.ts +1 -1
- package/dist/components/copy-button.js +1 -1
- package/dist/components/data-table.d.ts +6 -6
- package/dist/components/data-table.js +41 -15
- package/dist/components/date-picker.d.ts +31 -9
- package/dist/components/date-picker.js +100 -18
- package/dist/components/dialog.d.ts +17 -10
- package/dist/components/dialog.js +20 -13
- package/dist/components/drawer.d.ts +26 -8
- package/dist/components/drawer.js +75 -16
- package/dist/components/drawing.d.ts +25 -0
- package/dist/components/drawing.js +32 -0
- package/dist/components/empty.js +2 -2
- package/dist/components/feature-list.d.ts +65 -13
- package/dist/components/feature-list.js +116 -15
- package/dist/components/field.js +2 -2
- package/dist/components/file-drop.d.ts +9 -7
- package/dist/components/file-drop.js +8 -43
- package/dist/components/filter-bar.d.ts +10 -9
- package/dist/components/filter-bar.js +42 -25
- package/dist/components/graph.d.ts +19 -3
- package/dist/components/graph.js +170 -25
- package/dist/components/illustration.js +3 -28
- package/dist/components/input-group.d.ts +5 -10
- package/dist/components/input-group.js +16 -16
- package/dist/components/input.d.ts +2 -2
- package/dist/components/input.js +3 -3
- package/dist/components/item.d.ts +9 -6
- package/dist/components/item.js +13 -8
- package/dist/components/kbd.d.ts +1 -1
- package/dist/components/kbd.js +1 -1
- package/dist/components/lightbox.d.ts +76 -9
- package/dist/components/lightbox.js +333 -45
- package/dist/components/locale.d.ts +6 -6
- package/dist/components/logo.d.ts +21 -1
- package/dist/components/logo.js +32 -2
- package/dist/components/markdown-editor.d.ts +275 -0
- package/dist/components/markdown-editor.js +831 -0
- package/dist/components/mentions.d.ts +153 -0
- package/dist/components/mentions.js +507 -0
- package/dist/components/menu.d.ts +2 -1
- package/dist/components/menu.js +5 -4
- package/dist/components/menubar.d.ts +23 -5
- package/dist/components/menubar.js +97 -22
- package/dist/components/message.d.ts +62 -11
- package/dist/components/message.js +49 -13
- package/dist/components/meter.js +1 -1
- package/dist/components/money-input.d.ts +1 -1
- package/dist/components/money-input.js +1 -1
- package/dist/components/native-select.d.ts +2 -2
- package/dist/components/native-select.js +4 -4
- package/dist/components/navigation-menu.d.ts +3 -1
- package/dist/components/navigation-menu.js +23 -12
- package/dist/components/number-field.d.ts +2 -9
- package/dist/components/number-field.js +86 -36
- package/dist/components/number-roll.d.ts +26 -0
- package/dist/components/number-roll.js +81 -0
- package/dist/components/otp-field.d.ts +1 -1
- package/dist/components/otp-field.js +24 -3
- package/dist/components/pagination.d.ts +11 -3
- package/dist/components/pagination.js +59 -13
- package/dist/components/pdf-viewer.d.ts +1 -1
- package/dist/components/pdf-viewer.js +8 -8
- package/dist/components/phone-input.d.ts +1 -1
- package/dist/components/phone-input.js +2 -2
- package/dist/components/popover.js +5 -3
- package/dist/components/preview-card.d.ts +37 -2
- package/dist/components/preview-card.js +226 -2
- package/dist/components/progress.js +1 -1
- package/dist/components/prompt-input.d.ts +1 -1
- package/dist/components/prompt-input.js +24 -14
- package/dist/components/pull-to-refresh.d.ts +50 -0
- package/dist/components/pull-to-refresh.js +189 -0
- package/dist/components/quote.d.ts +6 -1
- package/dist/components/quote.js +3 -2
- package/dist/components/radio-group.js +1 -1
- package/dist/components/rating.d.ts +4 -1
- package/dist/components/rating.js +131 -10
- package/dist/components/reasoning.d.ts +1 -1
- package/dist/components/reasoning.js +7 -3
- package/dist/components/resizable.d.ts +1 -1
- package/dist/components/resizable.js +2 -2
- package/dist/components/response.d.ts +1 -1
- package/dist/components/response.js +18 -6
- package/dist/components/scheduler.d.ts +352 -0
- package/dist/components/scheduler.js +1717 -0
- package/dist/components/scroll-area.js +1 -1
- package/dist/components/select.d.ts +17 -4
- package/dist/components/select.js +140 -9
- package/dist/components/separator.d.ts +1 -1
- package/dist/components/separator.js +3 -3
- package/dist/components/sidebar.d.ts +44 -3
- package/dist/components/sidebar.js +57 -17
- package/dist/components/site-header.d.ts +18 -13
- package/dist/components/site-header.js +23 -11
- package/dist/components/skeleton.d.ts +17 -7
- package/dist/components/skeleton.js +22 -7
- package/dist/components/slider.js +2 -2
- package/dist/components/sortable.d.ts +55 -4
- package/dist/components/sortable.js +172 -103
- package/dist/components/sources.d.ts +1 -1
- package/dist/components/sources.js +2 -2
- package/dist/components/spinner.d.ts +4 -4
- package/dist/components/spinner.js +4 -4
- package/dist/components/stat.d.ts +21 -4
- package/dist/components/stat.js +17 -8
- package/dist/components/stepper.d.ts +1 -1
- package/dist/components/stepper.js +8 -7
- package/dist/components/suggestions.d.ts +11 -3
- package/dist/components/suggestions.js +10 -4
- package/dist/components/swipe-actions.d.ts +66 -0
- package/dist/components/swipe-actions.js +292 -0
- package/dist/components/switch.js +1 -1
- package/dist/components/table.d.ts +12 -6
- package/dist/components/table.js +78 -30
- package/dist/components/tabs.js +7 -4
- package/dist/components/tag.d.ts +19 -20
- package/dist/components/tag.js +9 -5
- package/dist/components/tags-input.d.ts +2 -7
- package/dist/components/tags-input.js +11 -8
- package/dist/components/textarea.d.ts +3 -2
- package/dist/components/textarea.js +4 -3
- package/dist/components/theme.d.ts +49 -6
- package/dist/components/theme.js +147 -9
- package/dist/components/time-field.d.ts +4 -9
- package/dist/components/time-field.js +6 -6
- package/dist/components/timeline.d.ts +19 -3
- package/dist/components/timeline.js +21 -9
- package/dist/components/tippy.d.ts +17 -1
- package/dist/components/tippy.js +95 -15
- package/dist/components/toast.d.ts +2 -7
- package/dist/components/toast.js +12 -8
- package/dist/components/toggle-group.d.ts +7 -1
- package/dist/components/toggle-group.js +16 -5
- package/dist/components/toggle.d.ts +2 -2
- package/dist/components/toggle.js +3 -2
- package/dist/components/tool-call.d.ts +1 -1
- package/dist/components/tool-call.js +4 -4
- package/dist/components/toolbar.d.ts +57 -4
- package/dist/components/toolbar.js +216 -16
- package/dist/components/tooltip.d.ts +1 -1
- package/dist/components/tooltip.js +4 -2
- package/dist/components/tour.d.ts +1 -1
- package/dist/components/tour.js +36 -15
- package/dist/components/tree.js +5 -5
- package/dist/components/typography.d.ts +31 -8
- package/dist/components/typography.js +21 -10
- package/dist/components/video-player.d.ts +7 -2
- package/dist/components/video-player.js +121 -220
- package/dist/index.d.ts +99 -92
- package/dist/index.js +99 -92
- package/dist/lib/calendar.d.ts +153 -0
- package/dist/lib/calendar.js +312 -0
- package/dist/lib/cn.d.ts +3 -1
- package/dist/lib/cn.js +5 -0
- package/dist/lib/code-highlight.d.ts +14 -0
- package/dist/lib/code-highlight.js +81 -18
- package/dist/lib/drag.d.ts +39 -0
- package/dist/lib/drag.js +96 -0
- package/dist/lib/editorial-assets.js +16 -8
- package/dist/lib/figure/figures/automation.js +25 -6
- package/dist/lib/figure/figures/bar-chart.js +6 -1
- package/dist/lib/figure/figures/brackets-classic.js +4 -1
- package/dist/lib/figure/figures/city.js +12 -2
- package/dist/lib/figure/figures/conveyor.js +17 -4
- package/dist/lib/figure/figures/database.js +5 -2
- package/dist/lib/figure/figures/documents.js +11 -3
- package/dist/lib/figure/figures/inbox.js +5 -2
- package/dist/lib/figure/figures/laptop.js +3 -1
- package/dist/lib/figure/figures/pipeline.js +45 -10
- package/dist/lib/figure/figures/platform.js +62 -7
- package/dist/lib/figure/figures/server.js +21 -5
- package/dist/lib/figure/figures/spreadsheet.js +29 -5
- package/dist/lib/figure/kernel.d.ts +4 -2
- package/dist/lib/figure/kernel.js +10 -5
- package/dist/lib/figure/parts.js +6 -2
- package/dist/lib/files.d.ts +31 -0
- package/dist/lib/files.js +60 -0
- package/dist/lib/gesture.d.ts +70 -0
- package/dist/lib/gesture.js +141 -0
- package/dist/lib/glide.d.ts +5 -0
- package/dist/lib/glide.js +9 -1
- package/dist/lib/icons.d.ts +1 -0
- package/dist/lib/icons.js +6 -0
- package/dist/lib/illustration-library.js +1 -6
- package/dist/lib/markdown-edit.d.ts +112 -0
- package/dist/lib/markdown-edit.js +557 -0
- package/dist/lib/markdown-rich-editor.d.ts +188 -0
- package/dist/lib/markdown-rich-editor.js +1153 -0
- package/dist/lib/markdown-rich.d.ts +63 -0
- package/dist/lib/markdown-rich.js +534 -0
- package/dist/lib/mentions.d.ts +100 -0
- package/dist/lib/mentions.js +246 -0
- package/dist/lib/motion.d.ts +18 -0
- package/dist/lib/motion.js +43 -5
- package/dist/lib/number-roll.d.ts +89 -0
- package/dist/lib/number-roll.js +391 -0
- package/dist/lib/platform.d.ts +6 -0
- package/dist/lib/platform.js +14 -0
- package/dist/lib/portal-container.d.ts +9 -0
- package/dist/lib/portal-container.js +10 -0
- package/dist/lib/press.d.ts +5 -0
- package/dist/lib/press.js +186 -0
- package/dist/lib/scheduler.d.ts +128 -0
- package/dist/lib/scheduler.js +272 -0
- package/dist/lib/scroll-edges.d.ts +9 -0
- package/dist/lib/scroll-edges.js +50 -0
- package/dist/lib/table-fit.d.ts +1 -1
- package/dist/lib/table-fit.js +65 -8
- package/dist/lib/theme-preset.d.ts +267 -0
- package/dist/lib/theme-preset.js +1046 -0
- package/dist/lib/theme-script.d.ts +23 -3
- package/dist/lib/theme-script.js +17 -5
- package/dist/lib/tippy/sprite.d.ts +36 -4
- package/dist/lib/tippy/sprite.js +188 -15
- package/dist/lib/tone.d.ts +4 -0
- package/dist/lib/tone.js +1 -0
- package/dist/messages/de.d.ts +3 -3
- package/dist/messages/de.js +274 -3
- package/dist/skills/zon-ui/SKILL.md +279 -0
- package/dist/skills/zon-ui/references/authoring.md +265 -0
- package/dist/skills/zon-ui/references/brand.md +416 -0
- package/dist/skills/zon-ui/references/components/accordion.md +199 -0
- package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
- package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
- package/dist/skills/zon-ui/references/components/alert.md +167 -0
- package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
- package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
- package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
- package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
- package/dist/skills/zon-ui/references/components/avatar.md +98 -0
- package/dist/skills/zon-ui/references/components/badge.md +227 -0
- package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
- package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
- package/dist/skills/zon-ui/references/components/button-group.md +216 -0
- package/dist/skills/zon-ui/references/components/button.md +309 -0
- package/dist/skills/zon-ui/references/components/calendar.md +296 -0
- package/dist/skills/zon-ui/references/components/card.md +158 -0
- package/dist/skills/zon-ui/references/components/carousel.md +297 -0
- package/dist/skills/zon-ui/references/components/chart.md +739 -0
- package/dist/skills/zon-ui/references/components/chat.md +417 -0
- package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
- package/dist/skills/zon-ui/references/components/code-block.md +143 -0
- package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
- package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
- package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
- package/dist/skills/zon-ui/references/components/combobox.md +455 -0
- package/dist/skills/zon-ui/references/components/command.md +326 -0
- package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
- package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
- package/dist/skills/zon-ui/references/components/conversation.md +146 -0
- package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
- package/dist/skills/zon-ui/references/components/crm.md +1022 -0
- package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
- package/dist/skills/zon-ui/references/components/data-table.md +776 -0
- package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
- package/dist/skills/zon-ui/references/components/dialog.md +335 -0
- package/dist/skills/zon-ui/references/components/direction.md +165 -0
- package/dist/skills/zon-ui/references/components/drawer.md +276 -0
- package/dist/skills/zon-ui/references/components/drawing.md +94 -0
- package/dist/skills/zon-ui/references/components/empty.md +225 -0
- package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
- package/dist/skills/zon-ui/references/components/field.md +209 -0
- package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
- package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
- package/dist/skills/zon-ui/references/components/form.md +970 -0
- package/dist/skills/zon-ui/references/components/graph.md +339 -0
- package/dist/skills/zon-ui/references/components/illustration.md +497 -0
- package/dist/skills/zon-ui/references/components/inbox.md +263 -0
- package/dist/skills/zon-ui/references/components/input-group.md +339 -0
- package/dist/skills/zon-ui/references/components/input.md +189 -0
- package/dist/skills/zon-ui/references/components/item.md +277 -0
- package/dist/skills/zon-ui/references/components/kanban.md +626 -0
- package/dist/skills/zon-ui/references/components/kbd.md +116 -0
- package/dist/skills/zon-ui/references/components/label.md +104 -0
- package/dist/skills/zon-ui/references/components/layout.md +291 -0
- package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
- package/dist/skills/zon-ui/references/components/locale.md +279 -0
- package/dist/skills/zon-ui/references/components/logo.md +257 -0
- package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
- package/dist/skills/zon-ui/references/components/mentions.md +512 -0
- package/dist/skills/zon-ui/references/components/menu.md +218 -0
- package/dist/skills/zon-ui/references/components/menubar.md +292 -0
- package/dist/skills/zon-ui/references/components/message.md +243 -0
- package/dist/skills/zon-ui/references/components/meter.md +105 -0
- package/dist/skills/zon-ui/references/components/money-input.md +333 -0
- package/dist/skills/zon-ui/references/components/native-select.md +197 -0
- package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
- package/dist/skills/zon-ui/references/components/number-field.md +210 -0
- package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
- package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
- package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
- package/dist/skills/zon-ui/references/components/pagination.md +109 -0
- package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
- package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
- package/dist/skills/zon-ui/references/components/popover.md +176 -0
- package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
- package/dist/skills/zon-ui/references/components/pricing.md +724 -0
- package/dist/skills/zon-ui/references/components/progress.md +92 -0
- package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
- package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
- package/dist/skills/zon-ui/references/components/quote.md +115 -0
- package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
- package/dist/skills/zon-ui/references/components/rating.md +260 -0
- package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
- package/dist/skills/zon-ui/references/components/resizable.md +213 -0
- package/dist/skills/zon-ui/references/components/response.md +170 -0
- package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
- package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
- package/dist/skills/zon-ui/references/components/select.md +351 -0
- package/dist/skills/zon-ui/references/components/separator.md +103 -0
- package/dist/skills/zon-ui/references/components/settings.md +793 -0
- package/dist/skills/zon-ui/references/components/shop.md +1715 -0
- package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
- package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
- package/dist/skills/zon-ui/references/components/site-header.md +303 -0
- package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
- package/dist/skills/zon-ui/references/components/slider.md +172 -0
- package/dist/skills/zon-ui/references/components/sortable.md +405 -0
- package/dist/skills/zon-ui/references/components/sources.md +106 -0
- package/dist/skills/zon-ui/references/components/spinner.md +222 -0
- package/dist/skills/zon-ui/references/components/stat.md +267 -0
- package/dist/skills/zon-ui/references/components/stepper.md +285 -0
- package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
- package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
- package/dist/skills/zon-ui/references/components/switch.md +160 -0
- package/dist/skills/zon-ui/references/components/table.md +999 -0
- package/dist/skills/zon-ui/references/components/tabs.md +258 -0
- package/dist/skills/zon-ui/references/components/tag.md +115 -0
- package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
- package/dist/skills/zon-ui/references/components/textarea.md +95 -0
- package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
- package/dist/skills/zon-ui/references/components/theme.md +362 -0
- package/dist/skills/zon-ui/references/components/time-field.md +222 -0
- package/dist/skills/zon-ui/references/components/timeline.md +285 -0
- package/dist/skills/zon-ui/references/components/tippy.md +243 -0
- package/dist/skills/zon-ui/references/components/toast.md +220 -0
- package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
- package/dist/skills/zon-ui/references/components/toggle.md +167 -0
- package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
- package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
- package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
- package/dist/skills/zon-ui/references/components/tour.md +423 -0
- package/dist/skills/zon-ui/references/components/tree.md +481 -0
- package/dist/skills/zon-ui/references/components/typography.md +347 -0
- package/dist/skills/zon-ui/references/components/video-player.md +386 -0
- package/dist/skills/zon-ui/references/marketing.md +467 -0
- package/dist/skills/zon-ui/references/motion.md +455 -0
- package/dist/skills/zon-ui/references/recipes.md +1232 -0
- package/dist/skills/zon-ui/references/tokens.md +866 -0
- package/dist/sources/accordion.css +4 -0
- package/dist/sources/action-sheet.css +11 -0
- package/dist/sources/alert-dialog.css +6 -0
- package/dist/sources/alert.css +3 -0
- package/dist/sources/app-bar.css +14 -0
- package/dist/sources/ascii-field.css +3 -0
- package/dist/sources/aspect-ratio.css +3 -0
- package/dist/sources/audio-player.css +20 -0
- package/dist/sources/avatar.css +3 -0
- package/dist/sources/badge.css +3 -0
- package/dist/sources/bottom-nav.css +9 -0
- package/dist/sources/breadcrumb.css +14 -0
- package/dist/sources/button-group.css +3 -0
- package/dist/sources/button.css +9 -0
- package/dist/sources/calendar.css +13 -0
- package/dist/sources/card.css +3 -0
- package/dist/sources/carousel.css +11 -0
- package/dist/sources/chart.css +5 -0
- package/dist/sources/checkbox.css +6 -0
- package/dist/sources/code-block.css +13 -0
- package/dist/sources/collapsible.css +4 -0
- package/dist/sources/color-picker.css +13 -0
- package/dist/sources/combobox.css +13 -0
- package/dist/sources/command.css +13 -0
- package/dist/sources/context-menu.css +12 -0
- package/dist/sources/conversation.css +10 -0
- package/dist/sources/copy-button.css +10 -0
- package/dist/sources/data-table.css +27 -0
- package/dist/sources/date-picker.css +20 -0
- package/dist/sources/dialog.css +9 -0
- package/dist/sources/direction.css +2 -0
- package/dist/sources/drawer.css +9 -0
- package/dist/sources/drawing.css +5 -0
- package/dist/sources/empty.css +3 -0
- package/dist/sources/feature-list.css +4 -0
- package/dist/sources/field.css +4 -0
- package/dist/sources/file-drop.css +15 -0
- package/dist/sources/filter-bar.css +30 -0
- package/dist/sources/form.css +4 -0
- package/dist/sources/graph.css +19 -0
- package/dist/sources/illustration.css +28 -0
- package/dist/sources/input-group.css +7 -0
- package/dist/sources/input.css +3 -0
- package/dist/sources/item.css +4 -0
- package/dist/sources/kbd.css +5 -0
- package/dist/sources/label.css +3 -0
- package/dist/sources/layout.css +3 -0
- package/dist/sources/lightbox.css +33 -0
- package/dist/sources/locale.css +2 -0
- package/dist/sources/logo.css +4 -0
- package/dist/sources/markdown-editor.css +41 -0
- package/dist/sources/mentions.css +13 -0
- package/dist/sources/menu.css +11 -0
- package/dist/sources/menubar.css +14 -0
- package/dist/sources/message.css +16 -0
- package/dist/sources/meter.css +4 -0
- package/dist/sources/money-input.css +10 -0
- package/dist/sources/native-select.css +4 -0
- package/dist/sources/navigation-menu.css +8 -0
- package/dist/sources/number-field.css +8 -0
- package/dist/sources/number-roll.css +6 -0
- package/dist/sources/otp-field.css +5 -0
- package/dist/sources/pagination.css +11 -0
- package/dist/sources/pdf-viewer.css +30 -0
- package/dist/sources/phone-input.css +20 -0
- package/dist/sources/popover.css +7 -0
- package/dist/sources/preview-card.css +7 -0
- package/dist/sources/progress.css +4 -0
- package/dist/sources/prompt-input.css +15 -0
- package/dist/sources/pull-to-refresh.css +14 -0
- package/dist/sources/quote.css +3 -0
- package/dist/sources/radio-group.css +5 -0
- package/dist/sources/rating.css +6 -0
- package/dist/sources/reasoning.css +6 -0
- package/dist/sources/resizable.css +4 -0
- package/dist/sources/response.css +16 -0
- package/dist/sources/scheduler.css +44 -0
- package/dist/sources/scroll-area.css +3 -0
- package/dist/sources/select.css +12 -0
- package/dist/sources/separator.css +3 -0
- package/dist/sources/sidebar.css +19 -0
- package/dist/sources/site-header.css +15 -0
- package/dist/sources/skeleton.css +3 -0
- package/dist/sources/slider.css +6 -0
- package/dist/sources/sortable.css +12 -0
- package/dist/sources/sources.css +6 -0
- package/dist/sources/spinner.css +6 -0
- package/dist/sources/stat.css +9 -0
- package/dist/sources/stepper.css +6 -0
- package/dist/sources/suggestions.css +10 -0
- package/dist/sources/swipe-actions.css +20 -0
- package/dist/sources/switch.css +5 -0
- package/dist/sources/table.css +7 -0
- package/dist/sources/tabs.css +5 -0
- package/dist/sources/tag.css +3 -0
- package/dist/sources/tags-input.css +6 -0
- package/dist/sources/textarea.css +3 -0
- package/dist/sources/theme.css +13 -0
- package/dist/sources/time-field.css +7 -0
- package/dist/sources/timeline.css +7 -0
- package/dist/sources/tippy.css +6 -0
- package/dist/sources/toast.css +6 -0
- package/dist/sources/toggle-group.css +5 -0
- package/dist/sources/toggle.css +3 -0
- package/dist/sources/tool-call.css +16 -0
- package/dist/sources/toolbar.css +14 -0
- package/dist/sources/tooltip.css +6 -0
- package/dist/sources/tour.css +14 -0
- package/dist/sources/tree.css +6 -0
- package/dist/sources/typography.css +4 -0
- package/dist/sources/video-player.css +21 -0
- package/dist/styles/ai.css +3 -0
- package/dist/styles/brand.css +98 -0
- package/dist/styles/core.css +266 -0
- package/dist/styles/editor.css +3 -0
- package/dist/styles/expressive.css +35 -56
- package/dist/styles/fonts.css +61 -117
- package/dist/styles/graph.css +4 -0
- package/dist/styles/illustration.css +4 -0
- package/dist/styles/index.css +11 -201
- package/dist/styles/material.css +138 -12
- package/dist/styles/parts/ai.css +18 -13
- package/dist/styles/parts/brand.css +2 -2
- package/dist/styles/parts/controls.css +29 -20
- package/dist/styles/parts/data.css +13 -9
- package/dist/styles/parts/editor.css +372 -0
- package/dist/styles/parts/feedback.css +32 -2
- package/dist/styles/parts/foundations.css +12 -7
- package/dist/styles/parts/graph.css +25 -9
- package/dist/styles/parts/inputs.css +172 -9
- package/dist/styles/parts/isometric.css +6 -5
- package/dist/styles/parts/navigation.css +206 -27
- package/dist/styles/parts/overlays.css +19 -4
- package/dist/styles/parts/pdf.css +2 -2
- package/dist/styles/pdf.css +3 -0
- package/dist/styles/prose.css +3 -0
- package/dist/styles/tokens.css +89 -14
- package/dist/theme.d.ts +1 -0
- package/dist/theme.js +5 -0
- package/dist/vite.d.ts +48 -59
- package/dist/vite.js +54 -21
- package/package.json +69 -2
|
@@ -0,0 +1,258 @@
|
|
|
1
|
+
# Tabs
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Tabs, TabsList, TabsPanel, TabsTab } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
export function Segmented() {
|
|
7
|
+
return (
|
|
8
|
+
<Tabs defaultValue="details" className="max-w-xl">
|
|
9
|
+
<TabsList>
|
|
10
|
+
<TabsTab value="details">Details</TabsTab>
|
|
11
|
+
<TabsTab value="sizing">Sizing</TabsTab>
|
|
12
|
+
<TabsTab value="care">Care</TabsTab>
|
|
13
|
+
</TabsList>
|
|
14
|
+
<TabsPanel value="details" className="flex min-h-24 flex-col gap-2">
|
|
15
|
+
<h3 className="m-0 display text-[24px] leading-[1.1] text-foreground">Waxed cotton jacket</h3>
|
|
16
|
+
<p className="m-0 text-[15px] leading-relaxed text-foreground-soft">
|
|
17
|
+
A light, water-resistant jacket with two deep pockets and a collar that turns up against the wind.
|
|
18
|
+
</p>
|
|
19
|
+
</TabsPanel>
|
|
20
|
+
<TabsPanel value="sizing" className="flex min-h-24 flex-col gap-2">
|
|
21
|
+
<h3 className="m-0 display text-[24px] leading-[1.1] text-foreground">A relaxed fit</h3>
|
|
22
|
+
<p className="m-0 text-[15px] leading-relaxed text-foreground-soft">
|
|
23
|
+
Cut with room for a jumper underneath. If you are between sizes, take the smaller one; the model is
|
|
24
|
+
182cm and wears a medium.
|
|
25
|
+
</p>
|
|
26
|
+
</TabsPanel>
|
|
27
|
+
<TabsPanel value="care" className="flex min-h-24 flex-col gap-2">
|
|
28
|
+
<h3 className="m-0 display text-[24px] leading-[1.1] text-foreground">Wipe, don't wash</h3>
|
|
29
|
+
<p className="m-0 text-[15px] leading-relaxed text-foreground-soft">
|
|
30
|
+
Sponge off dirt with cold water and let it dry at room temperature. Re-wax once a year.
|
|
31
|
+
</p>
|
|
32
|
+
</TabsPanel>
|
|
33
|
+
</Tabs>
|
|
34
|
+
);
|
|
35
|
+
}
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
Related panels, one visible at a time. **Segmented** (default): a recessed 38px track whose raised segment slides to the active tab (`--active-tab-left`, `--active-tab-width`), like `ToggleGroup`. **Underline**: mono labels on a hairline with a 1px indicator. A list too long for its row scrolls sideways without a scrollbar, keeping the active and focused tabs in view.
|
|
39
|
+
|
|
40
|
+
## Usage
|
|
41
|
+
|
|
42
|
+
```tsx
|
|
43
|
+
import { Tabs, TabsList, TabsPanel, TabsTab } from "@zonsh/ui";
|
|
44
|
+
|
|
45
|
+
<Tabs defaultValue="details">
|
|
46
|
+
<TabsList>
|
|
47
|
+
<TabsTab value="details">Details</TabsTab>
|
|
48
|
+
<TabsTab value="sizing">Sizing</TabsTab>
|
|
49
|
+
</TabsList>
|
|
50
|
+
<TabsPanel value="details">…</TabsPanel>
|
|
51
|
+
<TabsPanel value="sizing">…</TabsPanel>
|
|
52
|
+
</Tabs>;
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
- `Tabs.defaultValue` — the tab shown first (or `value` + `onValueChange`).
|
|
56
|
+
- `TabsTab.value` — matches its `TabsPanel`.
|
|
57
|
+
- `TabsList.variant` — `"segmented"` or `"underline"`.
|
|
58
|
+
|
|
59
|
+
## When to use
|
|
60
|
+
|
|
61
|
+
- Two to six views of one subject: "Details / Sizing / Care".
|
|
62
|
+
- `segmented` in product UI; `underline` on marketing and content pages.
|
|
63
|
+
- Not for site navigation (`NavigationMenu`, `Sidebar`) or form values (`ToggleGroup`, `Select`).
|
|
64
|
+
|
|
65
|
+
## Examples
|
|
66
|
+
|
|
67
|
+
### Underline
|
|
68
|
+
|
|
69
|
+
```tsx
|
|
70
|
+
import { Tabs, TabsList, TabsPanel, TabsTab } from "@zonsh/ui";
|
|
71
|
+
|
|
72
|
+
export function Underline() {
|
|
73
|
+
return (
|
|
74
|
+
<Tabs defaultValue="overview" className="max-w-xl">
|
|
75
|
+
<TabsList variant="underline">
|
|
76
|
+
<TabsTab value="overview">Overview</TabsTab>
|
|
77
|
+
<TabsTab value="install">Install</TabsTab>
|
|
78
|
+
<TabsTab value="usage">Usage</TabsTab>
|
|
79
|
+
</TabsList>
|
|
80
|
+
<TabsPanel value="overview" className="flex min-h-24 flex-col gap-2">
|
|
81
|
+
<h3 className="m-0 display text-[24px] leading-[1.1] text-foreground">What the CLI does</h3>
|
|
82
|
+
<p className="m-0 text-[15px] leading-relaxed text-foreground-soft">
|
|
83
|
+
It creates a project, runs it locally and deploys a preview of every branch you push.
|
|
84
|
+
</p>
|
|
85
|
+
</TabsPanel>
|
|
86
|
+
<TabsPanel value="install" className="flex min-h-24 flex-col gap-2">
|
|
87
|
+
<h3 className="m-0 display text-[24px] leading-[1.1] text-foreground">One command</h3>
|
|
88
|
+
<p className="m-0 text-[15px] leading-relaxed text-foreground-soft">
|
|
89
|
+
Install it with your package manager, then sign in once from the terminal.
|
|
90
|
+
</p>
|
|
91
|
+
</TabsPanel>
|
|
92
|
+
<TabsPanel value="usage" className="flex min-h-24 flex-col gap-2">
|
|
93
|
+
<h3 className="m-0 display text-[24px] leading-[1.1] text-foreground">Day to day</h3>
|
|
94
|
+
<p className="m-0 text-[15px] leading-relaxed text-foreground-soft">
|
|
95
|
+
Run it in a project folder to start the dev server; add a flag to deploy instead.
|
|
96
|
+
</p>
|
|
97
|
+
</TabsPanel>
|
|
98
|
+
</Tabs>
|
|
99
|
+
);
|
|
100
|
+
}
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
### Vertical
|
|
104
|
+
|
|
105
|
+
The arrow keys follow the orientation.
|
|
106
|
+
|
|
107
|
+
```tsx
|
|
108
|
+
import { Tabs, TabsList, TabsPanel, TabsTab } from "@zonsh/ui";
|
|
109
|
+
|
|
110
|
+
export function Vertical() {
|
|
111
|
+
return (
|
|
112
|
+
<div className="@container w-full">
|
|
113
|
+
<div className="grid gap-12 @lg:grid-cols-2">
|
|
114
|
+
<Tabs defaultValue="account" orientation="vertical">
|
|
115
|
+
<TabsList>
|
|
116
|
+
<TabsTab value="account">Account</TabsTab>
|
|
117
|
+
<TabsTab value="team">Team</TabsTab>
|
|
118
|
+
<TabsTab value="billing">Billing</TabsTab>
|
|
119
|
+
</TabsList>
|
|
120
|
+
<TabsPanel value="account" className="text-[15px] text-foreground-soft">
|
|
121
|
+
Profile and sign-in.
|
|
122
|
+
</TabsPanel>
|
|
123
|
+
<TabsPanel value="team" className="text-[15px] text-foreground-soft">
|
|
124
|
+
Who can see this workspace.
|
|
125
|
+
</TabsPanel>
|
|
126
|
+
<TabsPanel value="billing" className="text-[15px] text-foreground-soft">
|
|
127
|
+
Plan, receipts and payment method.
|
|
128
|
+
</TabsPanel>
|
|
129
|
+
</Tabs>
|
|
130
|
+
<Tabs defaultValue="basics" orientation="vertical">
|
|
131
|
+
<TabsList variant="underline">
|
|
132
|
+
<TabsTab value="basics">01 Basics</TabsTab>
|
|
133
|
+
<TabsTab value="layout">02 Layout</TabsTab>
|
|
134
|
+
<TabsTab value="colour">03 Colour</TabsTab>
|
|
135
|
+
</TabsList>
|
|
136
|
+
<TabsPanel value="basics" className="text-[15px] text-foreground-soft">
|
|
137
|
+
Line length, leading and a type scale.
|
|
138
|
+
</TabsPanel>
|
|
139
|
+
<TabsPanel value="layout" className="text-[15px] text-foreground-soft">
|
|
140
|
+
Grids, margins and white space.
|
|
141
|
+
</TabsPanel>
|
|
142
|
+
<TabsPanel value="colour" className="text-[15px] text-foreground-soft">
|
|
143
|
+
Contrast, palettes and when to hold back.
|
|
144
|
+
</TabsPanel>
|
|
145
|
+
</Tabs>
|
|
146
|
+
</div>
|
|
147
|
+
</div>
|
|
148
|
+
);
|
|
149
|
+
}
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
### Disabled
|
|
153
|
+
|
|
154
|
+
A disabled tab stays in the arrow-key order, so it is read out; say why on the page.
|
|
155
|
+
|
|
156
|
+
```tsx
|
|
157
|
+
import { Tabs, TabsList, TabsPanel, TabsTab } from "@zonsh/ui";
|
|
158
|
+
|
|
159
|
+
export function Disabled() {
|
|
160
|
+
return (
|
|
161
|
+
<Tabs defaultValue="summary" className="max-w-xl">
|
|
162
|
+
<TabsList>
|
|
163
|
+
<TabsTab value="summary">Summary</TabsTab>
|
|
164
|
+
<TabsTab value="files">Files</TabsTab>
|
|
165
|
+
<TabsTab value="results" disabled>
|
|
166
|
+
Results
|
|
167
|
+
</TabsTab>
|
|
168
|
+
</TabsList>
|
|
169
|
+
<TabsPanel value="summary" className="flex min-h-24 flex-col gap-2">
|
|
170
|
+
<h3 className="m-0 display text-24 leading-[1.1] text-foreground">Soil survey, plot 7</h3>
|
|
171
|
+
<p className="m-0 text-15 leading-relaxed text-foreground-soft">
|
|
172
|
+
Samples were taken on 12 September. Results open once the lab has checked them, in about two weeks.
|
|
173
|
+
</p>
|
|
174
|
+
</TabsPanel>
|
|
175
|
+
<TabsPanel value="files" className="flex min-h-24 flex-col gap-2">
|
|
176
|
+
<h3 className="m-0 display text-24 leading-[1.1] text-foreground">Field notes and photos</h3>
|
|
177
|
+
<p className="m-0 text-15 leading-relaxed text-foreground-soft">
|
|
178
|
+
Six photos and the sampling sheet, as uploaded from the field.
|
|
179
|
+
</p>
|
|
180
|
+
</TabsPanel>
|
|
181
|
+
<TabsPanel value="results" />
|
|
182
|
+
</Tabs>
|
|
183
|
+
);
|
|
184
|
+
}
|
|
185
|
+
```
|
|
186
|
+
|
|
187
|
+
### More tabs than fit
|
|
188
|
+
|
|
189
|
+
A list wider than its room scrolls sideways, and its ends fade where there is more to scroll, as a `ScrollArea`'s do; the active tab is kept in view, clear of the fade.
|
|
190
|
+
|
|
191
|
+
```tsx
|
|
192
|
+
import { Tabs, TabsList, TabsPanel, TabsTab } from "@zonsh/ui";
|
|
193
|
+
|
|
194
|
+
export function Overflow() {
|
|
195
|
+
const sections = ["Overview", "Lessons", "Assignments", "Discussion", "Grades", "Resources", "People"];
|
|
196
|
+
return (
|
|
197
|
+
<Tabs defaultValue="overview" className="max-w-72">
|
|
198
|
+
<TabsList variant="underline">
|
|
199
|
+
{sections.map((name) => (
|
|
200
|
+
<TabsTab key={name} value={name.toLowerCase()}>
|
|
201
|
+
{name}
|
|
202
|
+
</TabsTab>
|
|
203
|
+
))}
|
|
204
|
+
</TabsList>
|
|
205
|
+
{sections.map((name) => (
|
|
206
|
+
<TabsPanel key={name} value={name.toLowerCase()} className="text-[15px] text-foreground-soft">
|
|
207
|
+
{name} of the course, Introduction to statistics.
|
|
208
|
+
</TabsPanel>
|
|
209
|
+
))}
|
|
210
|
+
</Tabs>
|
|
211
|
+
);
|
|
212
|
+
}
|
|
213
|
+
```
|
|
214
|
+
|
|
215
|
+
## Props
|
|
216
|
+
|
|
217
|
+
| Prop | Type | Default |
|
|
218
|
+
| -------------------------- | ---------------------------- | -------------- |
|
|
219
|
+
| `TabsList.variant` | `"segmented" \| "underline"` | `"segmented"` |
|
|
220
|
+
| `Tabs.defaultValue` | `any` | `0` |
|
|
221
|
+
| `Tabs.value` | `any` — controlled | — |
|
|
222
|
+
| `Tabs.onValueChange` | `(value, details) => void` | — |
|
|
223
|
+
| `Tabs.orientation` | `"horizontal" \| "vertical"` | `"horizontal"` |
|
|
224
|
+
| `TabsList.activateOnFocus` | `boolean` | `false` |
|
|
225
|
+
| `TabsTab.value` | `any` — required | — |
|
|
226
|
+
| `TabsTab.disabled` | `boolean` | `false` |
|
|
227
|
+
| `TabsPanel.keepMounted` | `boolean` | `false` |
|
|
228
|
+
|
|
229
|
+
The root is full width, so tabs never move on switching. Other Base UI props are forwarded. Data attributes: `data-variant` (list), `data-active` (tab), `data-orientation`.
|
|
230
|
+
|
|
231
|
+
## Brand rules
|
|
232
|
+
|
|
233
|
+
- **Do** keep labels short and parallel nouns.
|
|
234
|
+
- **Do** give panels a shared minimum height (`min-h-24`) so content below does not jump.
|
|
235
|
+
- **Don't** mark the active tab with a flat fill or bold; the indicator is the state.
|
|
236
|
+
- **Don't** add an icon or badge to every tab.
|
|
237
|
+
- **Don't** hide content people must compare: put it side by side.
|
|
238
|
+
|
|
239
|
+
## Accessibility
|
|
240
|
+
|
|
241
|
+
- `role="tablist"`, `role="tab"`, `aria-selected`, `aria-controls`; a flush 2px `--control-focus` outline on the tab and a focused panel.
|
|
242
|
+
|
|
243
|
+
### Keyboard
|
|
244
|
+
|
|
245
|
+
| Key | What it does |
|
|
246
|
+
| ------------- | --------------------------------------------------------------------------------------------------------- |
|
|
247
|
+
| ← / → | Moves focus to the previous or next tab, looping at the ends (swapped right to left; ↑ / ↓ when vertical) |
|
|
248
|
+
| Home / End | Moves focus to the first or last tab |
|
|
249
|
+
| Enter / Space | Shows the focused tab's panel |
|
|
250
|
+
| Tab | Leaves the list for the panel: the list is one Tab stop, on the current tab |
|
|
251
|
+
|
|
252
|
+
With `activateOnFocus`, moving focus shows the panel at once.
|
|
253
|
+
|
|
254
|
+
---
|
|
255
|
+
|
|
256
|
+
- Import: `import { Tabs, TabsList, TabsTab, TabsPanel } from "@zonsh/ui"`
|
|
257
|
+
- Source: `packages/ui/src/components/tabs.tsx`
|
|
258
|
+
- Primitive: `@base-ui/react/tabs` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/tabs.md`)
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
# Tag
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Tag } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
export function Variants() {
|
|
7
|
+
return (
|
|
8
|
+
<div className="flex flex-wrap items-center gap-2">
|
|
9
|
+
<Tag>TypeScript</Tag>
|
|
10
|
+
<Tag variant="muted">Internal tool</Tag>
|
|
11
|
+
<Tag variant="outline">Integration</Tag>
|
|
12
|
+
<Tag tone="info">New</Tag>
|
|
13
|
+
<Tag tone="destructive">Error</Tag>
|
|
14
|
+
</div>
|
|
15
|
+
);
|
|
16
|
+
}
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
A 22px label in Licht Mono 11px on a raised key surface, 7px corners. Tones are tints: the colour's ink, deepened for 4.5:1, on a 10% wash in a 30% edge. Labels, not controls: no hover.
|
|
20
|
+
|
|
21
|
+
## Usage
|
|
22
|
+
|
|
23
|
+
```tsx
|
|
24
|
+
import { Tag } from "@zonsh/ui";
|
|
25
|
+
|
|
26
|
+
<Tag>TypeScript</Tag>
|
|
27
|
+
<Tag variant="muted" dot>Draft</Tag>
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
- `variant` — `default`, `muted`, `outline` (on raised surfaces).
|
|
31
|
+
- `tone` — a status or category tint.
|
|
32
|
+
- `dot` — a leading status dot.
|
|
33
|
+
|
|
34
|
+
## When to use
|
|
35
|
+
|
|
36
|
+
- Metadata by a title or in a cell: "TypeScript", "Draft".
|
|
37
|
+
- A status `tone` (`success`, `warning`, `info`, `destructive`) for a state: "Published", "Failed".
|
|
38
|
+
- A category `tone` (`blue`, `aqua`, `violet`, `magenta`, `orange`, `lime`) for kinds people tell apart at a glance, one tone per kind across the app.
|
|
39
|
+
- Not for actions or filters: `Button` or `ToggleGroup`.
|
|
40
|
+
|
|
41
|
+
## Examples
|
|
42
|
+
|
|
43
|
+
### Status
|
|
44
|
+
|
|
45
|
+
```tsx
|
|
46
|
+
import { Tag } from "@zonsh/ui";
|
|
47
|
+
|
|
48
|
+
export function Status() {
|
|
49
|
+
return (
|
|
50
|
+
<div className="flex flex-wrap items-center gap-2">
|
|
51
|
+
<Tag dot>Running</Tag>
|
|
52
|
+
<Tag dot variant="muted">
|
|
53
|
+
Paused
|
|
54
|
+
</Tag>
|
|
55
|
+
<Tag dot tone="success">
|
|
56
|
+
Published
|
|
57
|
+
</Tag>
|
|
58
|
+
<Tag dot tone="warning">
|
|
59
|
+
Expires in 3 days
|
|
60
|
+
</Tag>
|
|
61
|
+
<Tag dot tone="info">
|
|
62
|
+
Syncing
|
|
63
|
+
</Tag>
|
|
64
|
+
<Tag dot tone="destructive">
|
|
65
|
+
Failed
|
|
66
|
+
</Tag>
|
|
67
|
+
</div>
|
|
68
|
+
);
|
|
69
|
+
}
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
### Category tones
|
|
73
|
+
|
|
74
|
+
```tsx
|
|
75
|
+
import { Tag } from "@zonsh/ui";
|
|
76
|
+
|
|
77
|
+
export function Tones() {
|
|
78
|
+
return (
|
|
79
|
+
<div className="flex flex-wrap items-center gap-2">
|
|
80
|
+
<Tag tone="blue">Document</Tag>
|
|
81
|
+
<Tag tone="orange">Spreadsheet</Tag>
|
|
82
|
+
<Tag tone="aqua">Image</Tag>
|
|
83
|
+
<Tag tone="magenta">Audio</Tag>
|
|
84
|
+
<Tag tone="lime">Archive</Tag>
|
|
85
|
+
<Tag tone="violet">Video</Tag>
|
|
86
|
+
</div>
|
|
87
|
+
);
|
|
88
|
+
}
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
## Props
|
|
92
|
+
|
|
93
|
+
| Prop | Type | Default |
|
|
94
|
+
| --------- | ---------------------------------------------------- | ----------- |
|
|
95
|
+
| `variant` | `"default" \| "muted" \| "outline"` | `"default"` |
|
|
96
|
+
| `tone` | status `"success" \| "warning" \| "info" \| "destructive"` · category `"blue" \| "aqua" \| "violet" \| "magenta" \| "orange" \| "lime"` | — |
|
|
97
|
+
| `dot` | `boolean` — 6px dot in the current ink | `false` |
|
|
98
|
+
|
|
99
|
+
Those three are all it adds: `<span>` props are forwarded, and there is no `size` (one height, 22px) and no `render` (a tag is always a `<span>`, never a link or a button; link the row's title beside it instead). Icons inside are 12px. Text (one `tag-text` span) truncates with "…" rather than overflow; `min-w-0` lets a tag shrink in a row.
|
|
100
|
+
|
|
101
|
+
## Brand rules
|
|
102
|
+
|
|
103
|
+
- **Do** keep text short, mixed case; keep most tags grey.
|
|
104
|
+
- **Don't** colour for decoration or give a tone two meanings.
|
|
105
|
+
- **Don't** use `destructive` for "important": it means failed.
|
|
106
|
+
- **Don't** make tags clickable; use `Button size="sm"`.
|
|
107
|
+
|
|
108
|
+
## Accessibility
|
|
109
|
+
|
|
110
|
+
- Meaning lives in the text ("Failed"), not only the colour or dot; the dot is `aria-hidden`.
|
|
111
|
+
|
|
112
|
+
---
|
|
113
|
+
|
|
114
|
+
- Import: `import { Tag } from "@zonsh/ui"`
|
|
115
|
+
- Source: `packages/ui/src/components/tag.tsx`
|
|
@@ -0,0 +1,216 @@
|
|
|
1
|
+
# Tags Input
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Field, FieldDescription, FieldLabel, TagsInput } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
export function Basic() {
|
|
7
|
+
return (
|
|
8
|
+
<Field className="w-full max-w-md">
|
|
9
|
+
<FieldLabel>Topics</FieldLabel>
|
|
10
|
+
<TagsInput name="topics" defaultValue={["typography", "accessibility"]} placeholder="Add a topic" />
|
|
11
|
+
<FieldDescription>Press Enter or type a comma after each one.</FieldDescription>
|
|
12
|
+
</Field>
|
|
13
|
+
);
|
|
14
|
+
}
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
One recessed 38px field (30px dense) holding typed values as raised chips — a multiple `Combobox`'s own — then the text input; it grows a row at a time. Enter or a comma adds a tag, a pasted list adds them all, Backspace twice removes the last. Text left typed is added on blur; a duplicate (any case) lights up the existing tag instead.
|
|
18
|
+
|
|
19
|
+
## Usage
|
|
20
|
+
|
|
21
|
+
```tsx
|
|
22
|
+
import { Field, FieldLabel, TagsInput } from "@zonsh/ui";
|
|
23
|
+
|
|
24
|
+
<Field>
|
|
25
|
+
<FieldLabel>Topics</FieldLabel>
|
|
26
|
+
<TagsInput name="topics" defaultValue={["typography"]} placeholder="Add a topic" />
|
|
27
|
+
</Field>;
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
- `value` / `defaultValue` — the tags, a `string[]`.
|
|
31
|
+
- `validate` — returns `false` for a tag that doesn't fit; it is kept and marked.
|
|
32
|
+
- `max` — caps the number of tags.
|
|
33
|
+
|
|
34
|
+
## When to use
|
|
35
|
+
|
|
36
|
+
- Values people type: topics, keywords, emails to invite, allowed domains.
|
|
37
|
+
- Values from a known list: a multiple `Combobox`, which only accepts what's in it. One value: `Input`.
|
|
38
|
+
|
|
39
|
+
## Examples
|
|
40
|
+
|
|
41
|
+
### Validation
|
|
42
|
+
|
|
43
|
+
An invalid tag is kept, in red ink with a red edge and an alert icon, read as "invalid"; the field takes `aria-invalid`. Say what is wrong in a `FieldError`.
|
|
44
|
+
|
|
45
|
+
```tsx
|
|
46
|
+
import { Field, FieldDescription, FieldError, FieldLabel, TagsInput } from "@zonsh/ui";
|
|
47
|
+
import * as React from "react";
|
|
48
|
+
|
|
49
|
+
const isEmail = (tag: string) => /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(tag);
|
|
50
|
+
|
|
51
|
+
export function Emails() {
|
|
52
|
+
const [emails, setEmails] = React.useState(["mira@example.com", "jonas@example", "ade@example.org"]);
|
|
53
|
+
const wrong = emails.filter((e) => !isEmail(e));
|
|
54
|
+
return (
|
|
55
|
+
<Field invalid={wrong.length > 0} className="w-full max-w-md">
|
|
56
|
+
<FieldLabel>Invite to the workspace</FieldLabel>
|
|
57
|
+
<TagsInput
|
|
58
|
+
name="invite"
|
|
59
|
+
value={emails}
|
|
60
|
+
onValueChange={setEmails}
|
|
61
|
+
validate={isEmail}
|
|
62
|
+
placeholder="name@example.com"
|
|
63
|
+
inputMode="email"
|
|
64
|
+
/>
|
|
65
|
+
{wrong.length > 0 ? (
|
|
66
|
+
<FieldError match>
|
|
67
|
+
{wrong.length === 1
|
|
68
|
+
? `${wrong[0]} isn't a full email address. Fix it or remove it before sending.`
|
|
69
|
+
: `${wrong.length} addresses aren't complete. Fix them or remove them before sending.`}
|
|
70
|
+
</FieldError>
|
|
71
|
+
) : (
|
|
72
|
+
<FieldDescription>Paste a list separated by commas to add them all.</FieldDescription>
|
|
73
|
+
)}
|
|
74
|
+
</Field>
|
|
75
|
+
);
|
|
76
|
+
}
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
### Maximum
|
|
80
|
+
|
|
81
|
+
When full, typing stops; the rest of a pasted list stays in the input.
|
|
82
|
+
|
|
83
|
+
```tsx
|
|
84
|
+
import { Field, FieldDescription, FieldLabel, TagsInput } from "@zonsh/ui";
|
|
85
|
+
import * as React from "react";
|
|
86
|
+
|
|
87
|
+
export function Max() {
|
|
88
|
+
const [keywords, setKeywords] = React.useState(["sourdough", "rye", "overnight"]);
|
|
89
|
+
return (
|
|
90
|
+
<Field className="w-full max-w-md">
|
|
91
|
+
<FieldLabel>Recipe keywords</FieldLabel>
|
|
92
|
+
<TagsInput value={keywords} onValueChange={setKeywords} max={5} placeholder="Add a keyword" />
|
|
93
|
+
<FieldDescription>
|
|
94
|
+
<span className="font-mono tabular-nums">{keywords.length} / 5</span> keywords used.
|
|
95
|
+
</FieldDescription>
|
|
96
|
+
</Field>
|
|
97
|
+
);
|
|
98
|
+
}
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
### Sizes
|
|
102
|
+
|
|
103
|
+
In the dense field the chips are 24px and the remove buttons 18px.
|
|
104
|
+
|
|
105
|
+
```tsx
|
|
106
|
+
import { Field, FieldLabel, TagsInput } from "@zonsh/ui";
|
|
107
|
+
|
|
108
|
+
export function Sizes() {
|
|
109
|
+
return (
|
|
110
|
+
<div className="flex w-full max-w-md flex-col gap-4">
|
|
111
|
+
<Field>
|
|
112
|
+
<FieldLabel>Dense</FieldLabel>
|
|
113
|
+
<TagsInput size="sm" defaultValue={["frontend", "design-system"]} placeholder="Add a label" />
|
|
114
|
+
</Field>
|
|
115
|
+
<Field>
|
|
116
|
+
<FieldLabel>Default</FieldLabel>
|
|
117
|
+
<TagsInput defaultValue={["frontend", "design-system"]} placeholder="Add a label" />
|
|
118
|
+
</Field>
|
|
119
|
+
</div>
|
|
120
|
+
);
|
|
121
|
+
}
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
### States
|
|
125
|
+
|
|
126
|
+
Disabled dims the field and its chips. Read-only drops the recess and the remove buttons.
|
|
127
|
+
|
|
128
|
+
```tsx
|
|
129
|
+
import { Field, FieldDescription, FieldLabel, TagsInput } from "@zonsh/ui";
|
|
130
|
+
|
|
131
|
+
function Disabled() {
|
|
132
|
+
return (
|
|
133
|
+
<Field disabled>
|
|
134
|
+
<FieldLabel>Allowed domains</FieldLabel>
|
|
135
|
+
<TagsInput defaultValue={["example.com", "example.org"]} />
|
|
136
|
+
<FieldDescription>Set by your organisation's admin.</FieldDescription>
|
|
137
|
+
</Field>
|
|
138
|
+
);
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
function ReadOnly() {
|
|
142
|
+
return (
|
|
143
|
+
<Field>
|
|
144
|
+
<FieldLabel>Course prerequisites</FieldLabel>
|
|
145
|
+
<TagsInput readOnly defaultValue={["Linear algebra", "Intro to Python"]} />
|
|
146
|
+
</Field>
|
|
147
|
+
);
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
/** Disabled and read-only, one under the other. */
|
|
151
|
+
export function States() {
|
|
152
|
+
return (
|
|
153
|
+
<div className="flex w-full max-w-md flex-col gap-8">
|
|
154
|
+
<Disabled />
|
|
155
|
+
<ReadOnly />
|
|
156
|
+
</div>
|
|
157
|
+
);
|
|
158
|
+
}
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
## Props
|
|
162
|
+
|
|
163
|
+
| Prop | Type | Default |
|
|
164
|
+
| ------------------------ | --------------------------------------- | ---------------- |
|
|
165
|
+
| `value` / `defaultValue` | `string[]` | `[]` |
|
|
166
|
+
| `onValueChange` | `(value: string[]) => void` | — |
|
|
167
|
+
| `size` | `"sm" \| "default"` | `"default"` |
|
|
168
|
+
| `validate` | `(tag: string) => boolean` | — |
|
|
169
|
+
| `max` | `number` | — |
|
|
170
|
+
| `name` | `string`: one hidden input per tag | the `Field`'s |
|
|
171
|
+
| `required` | `boolean`: at least one tag | `false` |
|
|
172
|
+
| `labels` | `{ remove?: (tag) => string, invalid? }` | `"Remove {tag}"`, `"(invalid)"` |
|
|
173
|
+
| `placeholder` | `string`: shown while there are no tags | — |
|
|
174
|
+
| `disabled` / `readOnly` | `boolean` | `false` |
|
|
175
|
+
| `className` | `string`: the visible field | — |
|
|
176
|
+
|
|
177
|
+
Other props (`id`, `aria-label`, `inputMode`, `onBlur` …) go to the text input, which takes its label, descriptions and validity from a `Field`.
|
|
178
|
+
|
|
179
|
+
- **Forms.** The name goes to the tags, not the typed text: one entry per tag (`formData.getAll("topics")`). In a `Form`, `onFormSubmit` and a `Field`'s `validate` get one comma-separated string, `"typography,colour"`.
|
|
180
|
+
- **`required`** means at least one tag: until then `valueMissing`, no submit, `FieldError match="valueMissing"` shows, focus goes to the input.
|
|
181
|
+
- `validationMode="onBlur"` validates when focus leaves the field, chips included. A reset restores `defaultValue`.
|
|
182
|
+
- Data attributes: `data-size`, `data-readonly`, `data-full` on the field; `data-invalid` on a chip that fails `validate`.
|
|
183
|
+
- A `LocaleProvider` sets `labels` for every TagsInput (`messages.tagsInput`).
|
|
184
|
+
|
|
185
|
+
## Brand rules
|
|
186
|
+
|
|
187
|
+
- **Do** keep tags short; describe how to add one.
|
|
188
|
+
- **Do** say what is wrong with an invalid tag in words, under the field.
|
|
189
|
+
- **Don't** colour chips by kind or status. Only an invalid tag takes the destructive ink.
|
|
190
|
+
- **Don't** use it to pick from a list. That is a multiple `Combobox`.
|
|
191
|
+
|
|
192
|
+
## Accessibility
|
|
193
|
+
|
|
194
|
+
- The text input is labelled by the `FieldLabel`; clicking the label or empty space focuses it; `required` adds `aria-required`. The input holding the tags is hidden from assistive tech.
|
|
195
|
+
- Enter while an IME is composing picks its characters; it doesn't add a tag.
|
|
196
|
+
- Chips sit in a `toolbar` (screen readers stay in focus mode); each remove button is "Remove {tag}".
|
|
197
|
+
- An invalid tag is marked with an icon and read as "invalid", never colour alone.
|
|
198
|
+
|
|
199
|
+
### Keyboard
|
|
200
|
+
|
|
201
|
+
| Key | What it does |
|
|
202
|
+
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------- |
|
|
203
|
+
| Enter / , | Adds what was typed as a tag |
|
|
204
|
+
| ⌘V / Ctrl+V | Adds a pasted list, split at commas, semicolons, tabs and new lines |
|
|
205
|
+
| Backspace | Moves to the last chip from the empty input; removes the focused chip |
|
|
206
|
+
| ← / → | Moves to the last chip from the start of the input, and between chips; → past the last returns to the input (swapped right to left) |
|
|
207
|
+
| Delete | Removes the focused chip |
|
|
208
|
+
| Escape | Returns from a chip to the input, as typing does |
|
|
209
|
+
| Tab | Leaves the field, adding what was typed and not yet added |
|
|
210
|
+
|
|
211
|
+
Chips are reached with the arrows, not Tab. After Backspace focus goes to the chip before, after Delete to the one taking its place; from the last chip both return to the input, so Backspace, Backspace only takes the last tag. Arrows follow the field's direction (`DirectionProvider` or `dir="rtl"`).
|
|
212
|
+
|
|
213
|
+
---
|
|
214
|
+
|
|
215
|
+
- Import: `import { TagsInput } from "@zonsh/ui"`
|
|
216
|
+
- Source: `packages/ui/src/components/tags-input.tsx`
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
# Textarea
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Field, FieldDescription, FieldLabel, Textarea } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
export function Basic() {
|
|
7
|
+
return (
|
|
8
|
+
<Field className="w-full max-w-lg">
|
|
9
|
+
<FieldLabel>Your review</FieldLabel>
|
|
10
|
+
<Textarea placeholder="What did you like, and what would you change?" />
|
|
11
|
+
<FieldDescription>Two or three sentences are plenty.</FieldDescription>
|
|
12
|
+
</Field>
|
|
13
|
+
);
|
|
14
|
+
}
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
`Input`'s recessed field over several lines: at least 140px tall at the default density (110 in a dense theme, 170 in a spacious one), resizable, `w-full` (size the `Field`, 28–36rem). Corners cap at 10px so the handle stays inside.
|
|
18
|
+
|
|
19
|
+
## Usage
|
|
20
|
+
|
|
21
|
+
```tsx
|
|
22
|
+
import { Field, FieldLabel, Textarea } from "@zonsh/ui";
|
|
23
|
+
|
|
24
|
+
<Field className="w-full max-w-lg">
|
|
25
|
+
<FieldLabel>A little context</FieldLabel>
|
|
26
|
+
<Textarea />
|
|
27
|
+
</Field>;
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
- `rows` — starting height in lines.
|
|
31
|
+
- `maxLength` / `required` — native constraints, checked by the `Field`.
|
|
32
|
+
- `onValueChange` — the text as it changes.
|
|
33
|
+
|
|
34
|
+
## When to use
|
|
35
|
+
|
|
36
|
+
- Anything longer than a sentence. One line: `Input`. With a toolbar under it (a count, a Send button): `InputGroupTextarea`.
|
|
37
|
+
|
|
38
|
+
## Examples
|
|
39
|
+
|
|
40
|
+
### Validation
|
|
41
|
+
|
|
42
|
+
Native constraints, with `FieldError` saying how to fix them.
|
|
43
|
+
|
|
44
|
+
```tsx
|
|
45
|
+
import { Field, FieldError, FieldLabel, Textarea } from "@zonsh/ui";
|
|
46
|
+
|
|
47
|
+
export function Validation() {
|
|
48
|
+
return (
|
|
49
|
+
<Field invalid className="w-full max-w-lg">
|
|
50
|
+
<FieldLabel>What went wrong?</FieldLabel>
|
|
51
|
+
<Textarea defaultValue="It broke." minLength={20} />
|
|
52
|
+
<FieldError match>A little more detail, please: at least 20 characters.</FieldError>
|
|
53
|
+
</Field>
|
|
54
|
+
);
|
|
55
|
+
}
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
### Disabled
|
|
59
|
+
|
|
60
|
+
```tsx
|
|
61
|
+
import { Field, FieldLabel, Textarea } from "@zonsh/ui";
|
|
62
|
+
|
|
63
|
+
export function Disabled() {
|
|
64
|
+
return (
|
|
65
|
+
<Field disabled className="w-full max-w-lg">
|
|
66
|
+
<FieldLabel>Lesson notes</FieldLabel>
|
|
67
|
+
<Textarea defaultValue="Keep lines between 45 and 75 characters. Set leading at about 1.5 for body text." />
|
|
68
|
+
</Field>
|
|
69
|
+
);
|
|
70
|
+
}
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
## Props
|
|
74
|
+
|
|
75
|
+
No props of its own. Native `<textarea>` props are forwarded (`rows`, `minLength`, `maxLength`, `required` …), plus Base UI `Field.Control` props such as `onValueChange`. Data attributes: `data-invalid`, `data-valid`, `data-disabled`, `data-filled`, `data-focused`.
|
|
76
|
+
|
|
77
|
+
## Brand rules
|
|
78
|
+
|
|
79
|
+
- **Do** set the width on the column, not the textarea.
|
|
80
|
+
- **Do** keep the minimum height and the resize handle.
|
|
81
|
+
- **Don't** fix the height or use `resize-none`.
|
|
82
|
+
- **Don't** give it a flat fill or a thick outline.
|
|
83
|
+
|
|
84
|
+
## Accessibility
|
|
85
|
+
|
|
86
|
+
- In a `Field` with a visible `FieldLabel`; description and error link via `aria-describedby`.
|
|
87
|
+
- Focus: a flush 2px `--control-focus` outline and border.
|
|
88
|
+
- 16px text on phones, so iOS doesn't zoom.
|
|
89
|
+
- A placeholder is an example, never the instructions.
|
|
90
|
+
|
|
91
|
+
---
|
|
92
|
+
|
|
93
|
+
- Import: `import { Textarea } from "@zonsh/ui"`
|
|
94
|
+
- Source: `packages/ui/src/components/textarea.tsx`
|
|
95
|
+
- Primitive: `@base-ui/react/field` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/field.md`)
|