@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,455 @@
|
|
|
1
|
+
# Combobox
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Combobox, ComboboxContent, ComboboxEmpty, ComboboxInput, ComboboxItem, ComboboxList, Field, FieldLabel } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
interface Language {
|
|
7
|
+
value: string;
|
|
8
|
+
label: string;
|
|
9
|
+
}
|
|
10
|
+
|
|
11
|
+
const languages: Language[] = [
|
|
12
|
+
{ value: "en", label: "English" },
|
|
13
|
+
{ value: "fr", label: "French" },
|
|
14
|
+
{ value: "de", label: "German" },
|
|
15
|
+
{ value: "es", label: "Spanish" },
|
|
16
|
+
{ value: "it", label: "Italian" },
|
|
17
|
+
{ value: "pl", label: "Polish" },
|
|
18
|
+
{ value: "ja", label: "Japanese" },
|
|
19
|
+
{ value: "ko", label: "Korean" },
|
|
20
|
+
{ value: "zh", label: "Mandarin Chinese" },
|
|
21
|
+
{ value: "hi", label: "Hindi" },
|
|
22
|
+
{ value: "vi", label: "Vietnamese" },
|
|
23
|
+
{ value: "th", label: "Thai" },
|
|
24
|
+
{ value: "ar", label: "Arabic" },
|
|
25
|
+
{ value: "he", label: "Hebrew" },
|
|
26
|
+
{ value: "sw", label: "Swahili" },
|
|
27
|
+
{ value: "am", label: "Amharic" },
|
|
28
|
+
{ value: "yo", label: "Yoruba" },
|
|
29
|
+
];
|
|
30
|
+
|
|
31
|
+
export function Basic() {
|
|
32
|
+
return (
|
|
33
|
+
<Field className="max-w-sm">
|
|
34
|
+
<FieldLabel>Which language should the app use?</FieldLabel>
|
|
35
|
+
<Combobox items={languages}>
|
|
36
|
+
<ComboboxInput placeholder="Start typing, e.g. Japanese" />
|
|
37
|
+
<ComboboxContent>
|
|
38
|
+
<ComboboxEmpty>No language matches. Try a shorter name.</ComboboxEmpty>
|
|
39
|
+
<ComboboxList>
|
|
40
|
+
{(language: Language) => (
|
|
41
|
+
<ComboboxItem key={language.value} value={language}>
|
|
42
|
+
{language.label}
|
|
43
|
+
</ComboboxItem>
|
|
44
|
+
)}
|
|
45
|
+
</ComboboxList>
|
|
46
|
+
</ComboboxContent>
|
|
47
|
+
</Combobox>
|
|
48
|
+
</Field>
|
|
49
|
+
);
|
|
50
|
+
}
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
A `Select` you can type into: a recessed 38px field (30px dense) with a round chevron and optional clear button, over a menu-material popup as wide as the field with 38px items. With `multiple`, choices become raised chips in the field.
|
|
54
|
+
|
|
55
|
+
## Usage
|
|
56
|
+
|
|
57
|
+
```tsx
|
|
58
|
+
import {
|
|
59
|
+
Combobox,
|
|
60
|
+
ComboboxContent,
|
|
61
|
+
ComboboxEmpty,
|
|
62
|
+
ComboboxInput,
|
|
63
|
+
ComboboxItem,
|
|
64
|
+
ComboboxList,
|
|
65
|
+
Field,
|
|
66
|
+
FieldLabel,
|
|
67
|
+
} from "@zonsh/ui";
|
|
68
|
+
|
|
69
|
+
<Field>
|
|
70
|
+
<FieldLabel>Which language should the app use?</FieldLabel>
|
|
71
|
+
<Combobox items={languages}>
|
|
72
|
+
<ComboboxInput placeholder="Start typing, e.g. Japanese" />
|
|
73
|
+
<ComboboxContent>
|
|
74
|
+
<ComboboxEmpty>No language matches. Try a shorter name.</ComboboxEmpty>
|
|
75
|
+
<ComboboxList>
|
|
76
|
+
{(language: Language) => (
|
|
77
|
+
<ComboboxItem key={language.value} value={language}>
|
|
78
|
+
{language.label}
|
|
79
|
+
</ComboboxItem>
|
|
80
|
+
)}
|
|
81
|
+
</ComboboxList>
|
|
82
|
+
</ComboboxContent>
|
|
83
|
+
</Combobox>
|
|
84
|
+
</Field>;
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
`{ value, label }` items show their `label`; otherwise pass `itemToStringLabel`. The props you'll reach for: `items`, `multiple` and `onValueChange` (or `value`).
|
|
88
|
+
|
|
89
|
+
## When to use
|
|
90
|
+
|
|
91
|
+
- A fixed list of roughly 15 or more: languages, countries, team members.
|
|
92
|
+
- For a handful of options, use `Select`; for 2–5, `ToggleGroup`.
|
|
93
|
+
- Only listed values are accepted, so not for free-text search.
|
|
94
|
+
- A flat list past 200 options renders only those in view; the keyboard still reaches all. A grouped list renders all; past a few hundred, flatten it.
|
|
95
|
+
|
|
96
|
+
## Examples
|
|
97
|
+
|
|
98
|
+
### Grouped
|
|
99
|
+
|
|
100
|
+
Pass `{ value, items }[]` and render groups with `ComboboxGroup`, `ComboboxGroupLabel` and `ComboboxCollection`. `showClear` adds a clear button.
|
|
101
|
+
|
|
102
|
+
```tsx
|
|
103
|
+
import { Combobox, ComboboxCollection, ComboboxContent, ComboboxEmpty, ComboboxGroup, ComboboxGroupLabel, ComboboxInput, ComboboxItem, ComboboxList, Field, FieldLabel } from "@zonsh/ui";
|
|
104
|
+
|
|
105
|
+
// Language, languages: as in the first example on this page that uses them.
|
|
106
|
+
|
|
107
|
+
interface LanguageGroup {
|
|
108
|
+
value: string;
|
|
109
|
+
items: Language[];
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
const groupedLanguages: LanguageGroup[] = [
|
|
113
|
+
{ value: "Europe", items: languages.slice(0, 6) },
|
|
114
|
+
{ value: "Asia", items: languages.slice(6, 12) },
|
|
115
|
+
{ value: "Africa and the Middle East", items: languages.slice(12, 17) },
|
|
116
|
+
];
|
|
117
|
+
|
|
118
|
+
export function Grouped() {
|
|
119
|
+
return (
|
|
120
|
+
<Field className="max-w-sm">
|
|
121
|
+
<FieldLabel>Which language do you want to learn?</FieldLabel>
|
|
122
|
+
<Combobox items={groupedLanguages}>
|
|
123
|
+
<ComboboxInput placeholder="Search languages" showClear />
|
|
124
|
+
<ComboboxContent>
|
|
125
|
+
<ComboboxEmpty>No language matches. Try a shorter name.</ComboboxEmpty>
|
|
126
|
+
<ComboboxList>
|
|
127
|
+
{(group: LanguageGroup) => (
|
|
128
|
+
<ComboboxGroup key={group.value} items={group.items}>
|
|
129
|
+
<ComboboxGroupLabel>{group.value}</ComboboxGroupLabel>
|
|
130
|
+
<ComboboxCollection>
|
|
131
|
+
{(language: Language) => (
|
|
132
|
+
<ComboboxItem key={language.value} value={language}>
|
|
133
|
+
{language.label}
|
|
134
|
+
</ComboboxItem>
|
|
135
|
+
)}
|
|
136
|
+
</ComboboxCollection>
|
|
137
|
+
</ComboboxGroup>
|
|
138
|
+
)}
|
|
139
|
+
</ComboboxList>
|
|
140
|
+
</ComboboxContent>
|
|
141
|
+
</Combobox>
|
|
142
|
+
</Field>
|
|
143
|
+
);
|
|
144
|
+
}
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
### Multiple
|
|
148
|
+
|
|
149
|
+
`ComboboxChips` replaces the field: a function child over the selected values, ending in a `ComboboxInput`.
|
|
150
|
+
|
|
151
|
+
```tsx
|
|
152
|
+
import { Combobox, ComboboxChip, ComboboxChips, ComboboxContent, ComboboxEmpty, ComboboxInput, ComboboxItem, ComboboxList, Field, FieldDescription, FieldLabel } from "@zonsh/ui";
|
|
153
|
+
|
|
154
|
+
// Language, languages: as in the first example on this page that uses them.
|
|
155
|
+
|
|
156
|
+
export function Multiple() {
|
|
157
|
+
return (
|
|
158
|
+
<Field className="max-w-md">
|
|
159
|
+
<FieldLabel>Languages you speak</FieldLabel>
|
|
160
|
+
<Combobox items={languages} multiple defaultValue={[languages[3]!, languages[8]!]}>
|
|
161
|
+
<ComboboxChips>
|
|
162
|
+
{(value: Language[]) => (
|
|
163
|
+
<>
|
|
164
|
+
{value.map((language) => (
|
|
165
|
+
<ComboboxChip key={language.value}>{language.label}</ComboboxChip>
|
|
166
|
+
))}
|
|
167
|
+
<ComboboxInput placeholder={value.length > 0 ? "" : "Add a language"} />
|
|
168
|
+
</>
|
|
169
|
+
)}
|
|
170
|
+
</ComboboxChips>
|
|
171
|
+
<ComboboxContent>
|
|
172
|
+
<ComboboxEmpty>No language matches. Try a shorter name.</ComboboxEmpty>
|
|
173
|
+
<ComboboxList>
|
|
174
|
+
{(language: Language) => (
|
|
175
|
+
<ComboboxItem key={language.value} value={language}>
|
|
176
|
+
{language.label}
|
|
177
|
+
</ComboboxItem>
|
|
178
|
+
)}
|
|
179
|
+
</ComboboxList>
|
|
180
|
+
</ComboboxContent>
|
|
181
|
+
</Combobox>
|
|
182
|
+
<FieldDescription>Backspace removes the last one.</FieldDescription>
|
|
183
|
+
</Field>
|
|
184
|
+
);
|
|
185
|
+
}
|
|
186
|
+
```
|
|
187
|
+
|
|
188
|
+
### Sizes
|
|
189
|
+
|
|
190
|
+
```tsx
|
|
191
|
+
import { Combobox, ComboboxContent, ComboboxEmpty, ComboboxInput, ComboboxItem, ComboboxList, Field, FieldLabel } from "@zonsh/ui";
|
|
192
|
+
|
|
193
|
+
// Language, languages: as in the first example on this page that uses them.
|
|
194
|
+
|
|
195
|
+
export function Sizes() {
|
|
196
|
+
return (
|
|
197
|
+
<div className="flex w-full max-w-sm flex-col gap-4">
|
|
198
|
+
<Field>
|
|
199
|
+
<FieldLabel>Dense</FieldLabel>
|
|
200
|
+
<Combobox items={languages}>
|
|
201
|
+
<ComboboxInput size="sm" placeholder="Filter by language" />
|
|
202
|
+
<ComboboxContent>
|
|
203
|
+
<ComboboxEmpty>No language matches.</ComboboxEmpty>
|
|
204
|
+
<ComboboxList>
|
|
205
|
+
{(language: Language) => (
|
|
206
|
+
<ComboboxItem key={language.value} value={language}>
|
|
207
|
+
{language.label}
|
|
208
|
+
</ComboboxItem>
|
|
209
|
+
)}
|
|
210
|
+
</ComboboxList>
|
|
211
|
+
</ComboboxContent>
|
|
212
|
+
</Combobox>
|
|
213
|
+
</Field>
|
|
214
|
+
<Field>
|
|
215
|
+
<FieldLabel>Default</FieldLabel>
|
|
216
|
+
<Combobox items={languages}>
|
|
217
|
+
<ComboboxInput placeholder="Filter by language" />
|
|
218
|
+
<ComboboxContent>
|
|
219
|
+
<ComboboxEmpty>No language matches.</ComboboxEmpty>
|
|
220
|
+
<ComboboxList>
|
|
221
|
+
{(language: Language) => (
|
|
222
|
+
<ComboboxItem key={language.value} value={language}>
|
|
223
|
+
{language.label}
|
|
224
|
+
</ComboboxItem>
|
|
225
|
+
)}
|
|
226
|
+
</ComboboxList>
|
|
227
|
+
</ComboboxContent>
|
|
228
|
+
</Combobox>
|
|
229
|
+
</Field>
|
|
230
|
+
</div>
|
|
231
|
+
);
|
|
232
|
+
}
|
|
233
|
+
```
|
|
234
|
+
|
|
235
|
+
### Async
|
|
236
|
+
|
|
237
|
+
Pass `filter={null}` and the results as `items`; fetch in `onInputValueChange`. `ComboboxStatus` is a polite line above the list: with `loading`, a spinner and "Loading…" (or your words); before typing, a hint; then how many. Keep it mounted and change its text. Mark `ComboboxContent` `aria-busy` while loading, and keep the chosen item in `items` so the field can show it.
|
|
238
|
+
|
|
239
|
+
```tsx
|
|
240
|
+
import { Combobox, ComboboxContent, ComboboxEmpty, ComboboxInput, ComboboxItem, ComboboxList, ComboboxStatus, Field, FieldLabel } from "@zonsh/ui";
|
|
241
|
+
import * as React from "react";
|
|
242
|
+
|
|
243
|
+
interface Person {
|
|
244
|
+
id: string;
|
|
245
|
+
name: string;
|
|
246
|
+
team: string;
|
|
247
|
+
}
|
|
248
|
+
|
|
249
|
+
/** A small staff directory standing in for a server. */
|
|
250
|
+
const directory: Person[] = [
|
|
251
|
+
{ id: "u1", name: "Amara Okafor", team: "Design" },
|
|
252
|
+
{ id: "u2", name: "Bastian Krüger", team: "Platform" },
|
|
253
|
+
{ id: "u3", name: "Chen Wei", team: "Mobile" },
|
|
254
|
+
{ id: "u4", name: "Dana Levi", team: "Research" },
|
|
255
|
+
{ id: "u5", name: "Elif Yılmaz", team: "Platform" },
|
|
256
|
+
{ id: "u6", name: "Farid Haddad", team: "Support" },
|
|
257
|
+
{ id: "u7", name: "Greta Lindqvist", team: "Design" },
|
|
258
|
+
{ id: "u8", name: "Hiro Tanaka", team: "Mobile" },
|
|
259
|
+
{ id: "u9", name: "Isabel Moreno", team: "Data" },
|
|
260
|
+
{ id: "u10", name: "Jonah Brooks", team: "Support" },
|
|
261
|
+
];
|
|
262
|
+
|
|
263
|
+
const SEARCH_LATENCY = 600;
|
|
264
|
+
|
|
265
|
+
/**
|
|
266
|
+
* Results come from a server as you type: the status says it is searching (and screen readers hear
|
|
267
|
+
* it), then how many it found; ComboboxEmpty says when no one matches. Here a timer stands in for
|
|
268
|
+
* the request, and a newer query replaces the one still on its way.
|
|
269
|
+
*/
|
|
270
|
+
export function Async() {
|
|
271
|
+
const [query, setQuery] = React.useState("");
|
|
272
|
+
const [results, setResults] = React.useState<Person[]>([]);
|
|
273
|
+
const [loading, setLoading] = React.useState(false);
|
|
274
|
+
const [value, setValue] = React.useState<Person | null>(null);
|
|
275
|
+
const timer = React.useRef<ReturnType<typeof setTimeout>>(undefined);
|
|
276
|
+
React.useEffect(() => () => clearTimeout(timer.current), []);
|
|
277
|
+
// The chosen person stays among the items, so the field can show them.
|
|
278
|
+
const items = value && !results.some((person) => person.id === value.id) ? [...results, value] : results;
|
|
279
|
+
const searched = query.trim();
|
|
280
|
+
const found = !loading && searched !== "" && results.length > 0;
|
|
281
|
+
|
|
282
|
+
return (
|
|
283
|
+
<Field className="max-w-sm">
|
|
284
|
+
<FieldLabel>Assign a reviewer</FieldLabel>
|
|
285
|
+
<Combobox
|
|
286
|
+
items={items}
|
|
287
|
+
value={value}
|
|
288
|
+
filter={null}
|
|
289
|
+
itemToStringLabel={(person: Person) => person.name}
|
|
290
|
+
isItemEqualToValue={(item: Person, current: Person) => item.id === current.id}
|
|
291
|
+
onValueChange={(person: Person | null) => setValue(person)}
|
|
292
|
+
onInputValueChange={(next, { reason }) => {
|
|
293
|
+
setQuery(next);
|
|
294
|
+
clearTimeout(timer.current);
|
|
295
|
+
if (reason === "item-press") return;
|
|
296
|
+
const words = next.trim().toLowerCase();
|
|
297
|
+
if (!words) {
|
|
298
|
+
setResults([]);
|
|
299
|
+
setLoading(false);
|
|
300
|
+
return;
|
|
301
|
+
}
|
|
302
|
+
setLoading(true);
|
|
303
|
+
timer.current = setTimeout(() => {
|
|
304
|
+
setResults(directory.filter((person) => person.name.toLowerCase().includes(words)));
|
|
305
|
+
setLoading(false);
|
|
306
|
+
}, SEARCH_LATENCY);
|
|
307
|
+
}}
|
|
308
|
+
>
|
|
309
|
+
<ComboboxInput placeholder="Search by name" showClear />
|
|
310
|
+
<ComboboxContent aria-busy={loading || undefined}>
|
|
311
|
+
{/* Once results are in, the count is for screen readers only: the list shows them. */}
|
|
312
|
+
<ComboboxStatus loading={loading} className={found ? "sr-only" : undefined}>
|
|
313
|
+
{loading
|
|
314
|
+
? "Searching the directory…"
|
|
315
|
+
: !searched
|
|
316
|
+
? "Type a name to search the directory."
|
|
317
|
+
: found
|
|
318
|
+
? `${results.length} ${results.length === 1 ? "person" : "people"} found`
|
|
319
|
+
: null}
|
|
320
|
+
</ComboboxStatus>
|
|
321
|
+
<ComboboxEmpty>
|
|
322
|
+
{!loading && searched ? `No one called “${searched}”. Try a first name.` : null}
|
|
323
|
+
</ComboboxEmpty>
|
|
324
|
+
<ComboboxList>
|
|
325
|
+
{(person: Person) => (
|
|
326
|
+
<ComboboxItem key={person.id} value={person}>
|
|
327
|
+
{person.name} <span className="text-muted-foreground">· {person.team}</span>
|
|
328
|
+
</ComboboxItem>
|
|
329
|
+
)}
|
|
330
|
+
</ComboboxList>
|
|
331
|
+
</ComboboxContent>
|
|
332
|
+
</Combobox>
|
|
333
|
+
</Field>
|
|
334
|
+
);
|
|
335
|
+
}
|
|
336
|
+
```
|
|
337
|
+
|
|
338
|
+
### States
|
|
339
|
+
|
|
340
|
+
In a `Field`, `invalid` gives the red edge and `FieldError` says what to do; `disabled` dims it and leaves the tab order. `readOnly` drops the recess, chevron and clear button, and the list stays shut.
|
|
341
|
+
|
|
342
|
+
```tsx
|
|
343
|
+
import { Combobox, ComboboxContent, ComboboxEmpty, ComboboxInput, ComboboxItem, ComboboxList, Field, FieldDescription, FieldError, FieldLabel } from "@zonsh/ui";
|
|
344
|
+
|
|
345
|
+
// Language, languages: as in the first example on this page that uses them.
|
|
346
|
+
|
|
347
|
+
function LanguageField({
|
|
348
|
+
placeholder,
|
|
349
|
+
defaultValue,
|
|
350
|
+
readOnly,
|
|
351
|
+
disabled,
|
|
352
|
+
}: {
|
|
353
|
+
placeholder?: string;
|
|
354
|
+
defaultValue?: Language;
|
|
355
|
+
readOnly?: boolean;
|
|
356
|
+
disabled?: boolean;
|
|
357
|
+
}) {
|
|
358
|
+
return (
|
|
359
|
+
<Combobox items={languages} defaultValue={defaultValue} readOnly={readOnly} disabled={disabled}>
|
|
360
|
+
<ComboboxInput placeholder={placeholder} showClear />
|
|
361
|
+
<ComboboxContent>
|
|
362
|
+
<ComboboxEmpty>No language matches. Try a shorter name.</ComboboxEmpty>
|
|
363
|
+
<ComboboxList>
|
|
364
|
+
{(language: Language) => (
|
|
365
|
+
<ComboboxItem key={language.value} value={language}>
|
|
366
|
+
{language.label}
|
|
367
|
+
</ComboboxItem>
|
|
368
|
+
)}
|
|
369
|
+
</ComboboxList>
|
|
370
|
+
</ComboboxContent>
|
|
371
|
+
</Combobox>
|
|
372
|
+
);
|
|
373
|
+
}
|
|
374
|
+
|
|
375
|
+
export function States() {
|
|
376
|
+
return (
|
|
377
|
+
<div className="flex w-full max-w-sm flex-col gap-4">
|
|
378
|
+
<Field invalid>
|
|
379
|
+
<FieldLabel>Invalid</FieldLabel>
|
|
380
|
+
<LanguageField placeholder="Start typing, e.g. Japanese" />
|
|
381
|
+
<FieldError match>Choose the language your course is taught in.</FieldError>
|
|
382
|
+
</Field>
|
|
383
|
+
<Field disabled>
|
|
384
|
+
<FieldLabel>Disabled</FieldLabel>
|
|
385
|
+
<LanguageField defaultValue={languages[2]} disabled />
|
|
386
|
+
</Field>
|
|
387
|
+
<Field>
|
|
388
|
+
<FieldLabel>Read-only</FieldLabel>
|
|
389
|
+
<LanguageField defaultValue={languages[1]} readOnly />
|
|
390
|
+
<FieldDescription>Set by your workspace. Ask an owner to change it.</FieldDescription>
|
|
391
|
+
</Field>
|
|
392
|
+
</div>
|
|
393
|
+
);
|
|
394
|
+
}
|
|
395
|
+
```
|
|
396
|
+
|
|
397
|
+
## Props
|
|
398
|
+
|
|
399
|
+
| Component | Prop | Type | Default |
|
|
400
|
+
| ----------------- | ------------- | ------------------------------------------------------------ | ------------------ |
|
|
401
|
+
| `ComboboxInput` | `size` | `"sm" \| "default"` | `"default"` |
|
|
402
|
+
| | `showTrigger` | `boolean` | `true` |
|
|
403
|
+
| | `showClear` | `boolean` | `false` |
|
|
404
|
+
| | `className` | `string`: applies to the visible field | — |
|
|
405
|
+
| `ComboboxContent` | `positioner` | Base UI `Positioner` props (`side`, `align`, `sideOffset` …) | `sideOffset: 6` |
|
|
406
|
+
| `ComboboxChips` | `children` | `ReactNode \| (value: T[]) => ReactNode` | — |
|
|
407
|
+
| `ComboboxChip` | `labels` | `{ remove?: (label?) => string }` | `"Remove {label}"` |
|
|
408
|
+
| `ComboboxStatus` | `loading` | `boolean`: a spinner and "Loading…" (or its children) | `false` |
|
|
409
|
+
| | `labels` | `{ loading?: string }` | `"Loading…"` |
|
|
410
|
+
|
|
411
|
+
`Combobox` is Base UI's `Combobox.Root` and takes `items`, `value`, `defaultValue`, `onValueChange`, `multiple`, `inputValue`, `onInputValueChange`, `filter`, `autoHighlight`, `limit`, `name`, `required`, `disabled` and `readOnly`. The field writes `data-disabled`, `data-readonly` and `data-invalid` (from a `Field`). Item data attributes: `data-highlighted`, `data-selected`, `data-disabled`.
|
|
412
|
+
|
|
413
|
+
`ComboboxInput` takes `labels` (`Partial<ComboboxMessages>`: `clear`, `showOptions`); chips read `remove`, `ComboboxStatus` reads `loading`. A `LocaleProvider` sets them all (`messages.combobox`).
|
|
414
|
+
|
|
415
|
+
## Brand rules
|
|
416
|
+
|
|
417
|
+
- **Do** write an empty state that says what to try next, not just "No results".
|
|
418
|
+
- **Do** keep items at 38px with 7px corners and the check at the end of the row. A long option wraps to two lines, then ends in "…".
|
|
419
|
+
- **Don't** give the popup a heavier shadow or another radius; it shares the menu material.
|
|
420
|
+
- **Don't** colour chips; they are raised secondary surfaces.
|
|
421
|
+
|
|
422
|
+
## Accessibility
|
|
423
|
+
|
|
424
|
+
- The input has `role="combobox"` and the list `role="listbox"`; the highlight is `aria-activedescendant`, so focus stays in the input.
|
|
425
|
+
- Each chip's remove button has a name.
|
|
426
|
+
- `ComboboxEmpty` and `ComboboxStatus` announce politely: "Searching…", then how many were found. The spinner is hidden; the words carry it.
|
|
427
|
+
- Label the input with `FieldLabel`. The trigger and clear buttons have their own accessible names.
|
|
428
|
+
|
|
429
|
+
### Keyboard
|
|
430
|
+
|
|
431
|
+
In the input:
|
|
432
|
+
|
|
433
|
+
| Key | What it does |
|
|
434
|
+
| ---------- | --------------------------------------------------------------------------------------------- |
|
|
435
|
+
| ↓ / ↑ | Opens the list, then moves the highlight; it loops through the input at the ends |
|
|
436
|
+
| Enter | Picks the highlighted item; with none highlighted it closes the list and lets the form submit |
|
|
437
|
+
| Escape | Closes the list; pressed again with the list closed, it clears the value and the text |
|
|
438
|
+
| Home / End | Moves the caret to the start or end of the text |
|
|
439
|
+
| Backspace | With the input empty, removes the last chip (`multiple`) |
|
|
440
|
+
| ← | At the start of the input, moves focus to the last chip (swapped right to left) |
|
|
441
|
+
|
|
442
|
+
On a chip:
|
|
443
|
+
|
|
444
|
+
| Key | What it does |
|
|
445
|
+
| ------------------ | ---------------------------------------------------------------------------------------------- |
|
|
446
|
+
| ← / → | Moves to the previous or next chip; past either end, back to the input (swapped right to left) |
|
|
447
|
+
| Backspace / Delete | Removes the chip |
|
|
448
|
+
| ↓ / ↑ | Opens the list |
|
|
449
|
+
| Typing | Returns to the input |
|
|
450
|
+
|
|
451
|
+
---
|
|
452
|
+
|
|
453
|
+
- Import: `import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty, ComboboxGroup, ComboboxGroupLabel } from "@zonsh/ui"`
|
|
454
|
+
- Source: `packages/ui/src/components/combobox.tsx`
|
|
455
|
+
- Primitive: `@base-ui/react/combobox` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/combobox.md`)
|