@zonsh/ui 0.4.1 → 0.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +639 -0
- package/README.md +49 -21
- package/dist/brand.d.ts +3 -0
- package/dist/brand.js +7 -0
- package/dist/components/_breadcrumb-more.d.ts +6 -0
- package/dist/components/_breadcrumb-more.js +5 -0
- package/dist/components/_drawing-svg.d.ts +11 -0
- package/dist/components/_drawing-svg.js +30 -0
- package/dist/components/_media.d.ts +159 -0
- package/dist/components/_media.js +266 -0
- package/dist/components/_overlay.d.ts +8 -5
- package/dist/components/_overlay.js +11 -6
- package/dist/components/_scheduler-calendar.d.ts +71 -0
- package/dist/components/_scheduler-calendar.js +940 -0
- package/dist/components/_scheduler-editor.d.ts +29 -0
- package/dist/components/_scheduler-editor.js +111 -0
- package/dist/components/_scheduler-menu.d.ts +16 -0
- package/dist/components/_scheduler-menu.js +18 -0
- package/dist/components/_scheduler-parts.d.ts +164 -0
- package/dist/components/_scheduler-parts.js +327 -0
- package/dist/components/_suggest-list.d.ts +142 -0
- package/dist/components/_suggest-list.js +159 -0
- package/dist/components/_toolbar-more.d.ts +24 -0
- package/dist/components/_toolbar-more.js +25 -0
- package/dist/components/accordion.d.ts +1 -1
- package/dist/components/accordion.js +7 -7
- 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/ascii-field.js +2 -1
- 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 +389 -24
- 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 +64 -8
- 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 +38 -1
- package/dist/components/chart.js +27 -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 +4 -4
- 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 +37 -12
- 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 +77 -16
- package/dist/components/copy-button.d.ts +1 -1
- package/dist/components/copy-button.js +8 -6
- 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 +190 -28
- package/dist/components/illustration.js +53 -31
- package/dist/components/input-group.d.ts +6 -11
- package/dist/components/input-group.js +21 -19
- 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/layout.d.ts +2 -1
- package/dist/components/layout.js +55 -11
- package/dist/components/lightbox.d.ts +76 -9
- package/dist/components/lightbox.js +354 -48
- 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 +153 -31
- package/dist/components/message.d.ts +62 -11
- package/dist/components/message.js +51 -14
- 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 -10
- package/dist/components/number-field.d.ts +2 -9
- package/dist/components/number-field.js +90 -26
- 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 +35 -17
- 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 +8 -3
- 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 +4 -3
- package/dist/components/response.js +39 -15
- 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 +90 -31
- package/dist/components/site-header.d.ts +18 -13
- package/dist/components/site-header.js +26 -9
- package/dist/components/skeleton.d.ts +18 -8
- package/dist/components/skeleton.js +23 -8
- package/dist/components/slider.js +2 -2
- package/dist/components/sortable.d.ts +55 -4
- package/dist/components/sortable.js +187 -94
- 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 +13 -7
- package/dist/components/table.js +124 -23
- package/dist/components/tabs.js +15 -8
- 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 +50 -7
- package/dist/components/theme.js +168 -12
- package/dist/components/time-field.d.ts +6 -10
- package/dist/components/time-field.js +19 -9
- 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 +17 -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 +8 -3
- package/dist/components/toolbar.d.ts +57 -4
- package/dist/components/toolbar.js +219 -16
- package/dist/components/tooltip.d.ts +5 -3
- package/dist/components/tooltip.js +14 -6
- package/dist/components/tour.d.ts +1 -1
- package/dist/components/tour.js +70 -24
- package/dist/components/tree.js +33 -10
- 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 +182 -225
- 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 +10 -4
- package/dist/lib/glide.js +14 -5
- 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 +4 -3
- package/dist/lib/table-fit.js +92 -25
- 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 +75 -77
- 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 -193
- package/dist/styles/material.css +177 -31
- package/dist/styles/parts/ai.css +20 -14
- package/dist/styles/parts/brand.css +2 -2
- package/dist/styles/parts/controls.css +51 -38
- package/dist/styles/parts/data.css +43 -11
- package/dist/styles/parts/editor.css +372 -0
- package/dist/styles/parts/feedback.css +75 -15
- 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 +237 -25
- package/dist/styles/parts/overlays.css +110 -8
- package/dist/styles/parts/pdf.css +15 -9
- package/dist/styles/pdf.css +3 -0
- package/dist/styles/prose.css +3 -0
- package/dist/styles/tokens.css +105 -15
- 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,326 @@
|
|
|
1
|
+
# Command
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Button, CommandDialog, KbdShortcut, Toaster, toast, useCommandShortcut, type CommandEntry } from "@zonsh/ui";
|
|
5
|
+
import { BookOpenIcon, FilePlusIcon, FileTextIcon, MailIcon, MoonIcon, SearchIcon } from "lucide-react";
|
|
6
|
+
import * as React from "react";
|
|
7
|
+
|
|
8
|
+
const go = (page: string) => () => toast(`Opening ${page}`);
|
|
9
|
+
|
|
10
|
+
const entries: CommandEntry[] = [
|
|
11
|
+
{
|
|
12
|
+
value: "start",
|
|
13
|
+
label: "Getting started",
|
|
14
|
+
group: "Pages",
|
|
15
|
+
keywords: ["install", "setup"],
|
|
16
|
+
icon: <FileTextIcon />,
|
|
17
|
+
onSelect: go("Getting started"),
|
|
18
|
+
},
|
|
19
|
+
{
|
|
20
|
+
value: "changelog",
|
|
21
|
+
label: "Changelog",
|
|
22
|
+
group: "Pages",
|
|
23
|
+
keywords: ["releases", "what's new"],
|
|
24
|
+
icon: <FileTextIcon />,
|
|
25
|
+
onSelect: go("Changelog"),
|
|
26
|
+
},
|
|
27
|
+
{
|
|
28
|
+
value: "brand",
|
|
29
|
+
label: "Brand guide",
|
|
30
|
+
group: "Pages",
|
|
31
|
+
keywords: ["logo", "fonts"],
|
|
32
|
+
icon: <BookOpenIcon />,
|
|
33
|
+
onSelect: go("Brand guide"),
|
|
34
|
+
},
|
|
35
|
+
{ value: "button", label: "Button", group: "Components", hint: "controls", onSelect: go("Button") },
|
|
36
|
+
{
|
|
37
|
+
value: "dialog",
|
|
38
|
+
label: "Dialog",
|
|
39
|
+
group: "Components",
|
|
40
|
+
hint: "overlays",
|
|
41
|
+
keywords: ["modal"],
|
|
42
|
+
onSelect: go("Dialog"),
|
|
43
|
+
},
|
|
44
|
+
{
|
|
45
|
+
value: "menu",
|
|
46
|
+
label: "Menu",
|
|
47
|
+
group: "Components",
|
|
48
|
+
hint: "overlays",
|
|
49
|
+
keywords: ["dropdown"],
|
|
50
|
+
onSelect: go("Menu"),
|
|
51
|
+
},
|
|
52
|
+
{
|
|
53
|
+
value: "toast",
|
|
54
|
+
label: "Toast",
|
|
55
|
+
group: "Components",
|
|
56
|
+
hint: "overlays",
|
|
57
|
+
keywords: ["notification", "snackbar"],
|
|
58
|
+
onSelect: go("Toast"),
|
|
59
|
+
},
|
|
60
|
+
{
|
|
61
|
+
value: "new",
|
|
62
|
+
label: "New document",
|
|
63
|
+
group: "Actions",
|
|
64
|
+
icon: <FilePlusIcon />,
|
|
65
|
+
onSelect: () => toast.success("Created “Untitled document”."),
|
|
66
|
+
},
|
|
67
|
+
{
|
|
68
|
+
value: "email",
|
|
69
|
+
label: "Email the team",
|
|
70
|
+
group: "Actions",
|
|
71
|
+
icon: <MailIcon />,
|
|
72
|
+
onSelect: go("your mail app"),
|
|
73
|
+
},
|
|
74
|
+
{
|
|
75
|
+
value: "theme",
|
|
76
|
+
label: "Toggle dark mode",
|
|
77
|
+
group: "Actions",
|
|
78
|
+
icon: <MoonIcon />,
|
|
79
|
+
hint: <KbdShortcut keys={["mod", "shift", "L"]} />,
|
|
80
|
+
onSelect: go("dark mode"),
|
|
81
|
+
},
|
|
82
|
+
];
|
|
83
|
+
|
|
84
|
+
export function GlobalSearch() {
|
|
85
|
+
const [open, setOpen] = React.useState(false);
|
|
86
|
+
// ⌘J / Ctrl+J here because the docs site already owns K; in an app use useCommandShortcut(() => …)
|
|
87
|
+
// for ⌘K / Ctrl+K. KbdShortcut writes the keys for the device: ⌘ J on a Mac, Ctrl J elsewhere.
|
|
88
|
+
useCommandShortcut("j", () => setOpen((value) => !value));
|
|
89
|
+
return (
|
|
90
|
+
<>
|
|
91
|
+
<Toaster />
|
|
92
|
+
<CommandDialog
|
|
93
|
+
open={open}
|
|
94
|
+
onOpenChange={setOpen}
|
|
95
|
+
items={entries}
|
|
96
|
+
label="Search the docs"
|
|
97
|
+
placeholder="Search pages, components and actions…"
|
|
98
|
+
trigger={
|
|
99
|
+
<Button variant="secondary" className="w-64 justify-between">
|
|
100
|
+
<span className="inline-flex items-center gap-2 text-muted-foreground">
|
|
101
|
+
<SearchIcon />
|
|
102
|
+
Search
|
|
103
|
+
</span>
|
|
104
|
+
<KbdShortcut keys={["mod", "J"]} />
|
|
105
|
+
</Button>
|
|
106
|
+
}
|
|
107
|
+
/>
|
|
108
|
+
</>
|
|
109
|
+
);
|
|
110
|
+
}
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
Press ⌘K (Ctrl+K), type, press Enter. The palette is a dialog **object** — 20px corners, card material, about 640px wide in the top third of the screen — with a borderless 46px search field, results under mono eyebrows, 38px items that rise when highlighted, and a footer of key hints. Built on Base UI `Dialog` with an inline `Autocomplete`, so the input keeps focus while the arrows move. Unlike other popups it has no motion: it is summoned many times a day. (The demo opens with ⌘J / Ctrl+J; the docs site owns ⌘K.)
|
|
114
|
+
|
|
115
|
+
## Usage
|
|
116
|
+
|
|
117
|
+
Describe entries as data; each entry's `onSelect` runs on click or Enter, then the palette closes.
|
|
118
|
+
|
|
119
|
+
```tsx
|
|
120
|
+
import { Button, CommandDialog, useCommandShortcut, type CommandEntry } from "@zonsh/ui";
|
|
121
|
+
|
|
122
|
+
const items: CommandEntry[] = [
|
|
123
|
+
{
|
|
124
|
+
value: "dialog",
|
|
125
|
+
label: "Dialog",
|
|
126
|
+
group: "Components",
|
|
127
|
+
keywords: ["modal"],
|
|
128
|
+
onSelect: () => navigate("/dialog"),
|
|
129
|
+
},
|
|
130
|
+
{ value: "new", label: "New document", group: "Actions", onSelect: createDocument },
|
|
131
|
+
];
|
|
132
|
+
|
|
133
|
+
function Search() {
|
|
134
|
+
const [open, setOpen] = React.useState(false);
|
|
135
|
+
useCommandShortcut(() => setOpen((value) => !value));
|
|
136
|
+
return (
|
|
137
|
+
<CommandDialog
|
|
138
|
+
open={open}
|
|
139
|
+
onOpenChange={setOpen}
|
|
140
|
+
items={items}
|
|
141
|
+
trigger={<Button variant="secondary">Search</Button>}
|
|
142
|
+
/>
|
|
143
|
+
);
|
|
144
|
+
}
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
The props you'll reach for: `items`, `open` / `onOpenChange` and `trigger`.
|
|
148
|
+
|
|
149
|
+
Every query word must match. The label ranks highest (equal, starts with, a word starts with, contains), then `keywords`, the group, then `description`: "side" finds Sidebar first, "modal" finds Dialog by keyword. Groups follow their best entry.
|
|
150
|
+
|
|
151
|
+
## When to use
|
|
152
|
+
|
|
153
|
+
- Global search for a docs site or app: pages, components, settings.
|
|
154
|
+
- A quick launcher for frequent actions: "New document", "Toggle dark mode".
|
|
155
|
+
- Not as the only route to anything; it is a shortcut over the visible navigation.
|
|
156
|
+
- Thousands of entries are fine: it lists the 200 best matches (the first 200 before anything is typed).
|
|
157
|
+
|
|
158
|
+
## Examples
|
|
159
|
+
|
|
160
|
+
### Custom composition
|
|
161
|
+
|
|
162
|
+
Pass children to compose the parts yourself; `CommandList` and `CommandGroup` take render functions over the grouped items.
|
|
163
|
+
|
|
164
|
+
```tsx
|
|
165
|
+
import { Button, CommandDialog, CommandEmpty, CommandFooter, CommandGroup, CommandInput, CommandItem, CommandList, KbdShortcut, Toaster, toast, type CommandEntry, type CommandGroupData } from "@zonsh/ui";
|
|
166
|
+
import { BookOpenIcon, FilePlusIcon, FileTextIcon, MailIcon, MoonIcon } from "lucide-react";
|
|
167
|
+
|
|
168
|
+
// go, entries: as in the first example on this page that uses them.
|
|
169
|
+
|
|
170
|
+
export function CustomComposition() {
|
|
171
|
+
return (
|
|
172
|
+
<>
|
|
173
|
+
<Toaster />
|
|
174
|
+
<CommandDialog items={entries} label="Jump to" trigger={<Button variant="secondary">Jump to…</Button>}>
|
|
175
|
+
<CommandInput placeholder="Type a page or component…" />
|
|
176
|
+
<CommandEmpty>No page or component by that name.</CommandEmpty>
|
|
177
|
+
<CommandList>
|
|
178
|
+
{(group: CommandGroupData) => (
|
|
179
|
+
<CommandGroup key={group.value} items={group.items} label={group.value}>
|
|
180
|
+
{(entry: CommandEntry) => (
|
|
181
|
+
<CommandItem key={entry.value} value={entry}>
|
|
182
|
+
<span className="min-w-0 flex-1 truncate">{entry.label}</span>
|
|
183
|
+
<span className="font-mono text-xs text-muted-foreground">{entry.group}</span>
|
|
184
|
+
</CommandItem>
|
|
185
|
+
)}
|
|
186
|
+
</CommandGroup>
|
|
187
|
+
)}
|
|
188
|
+
</CommandList>
|
|
189
|
+
<CommandFooter>Results update as you type · Esc to close</CommandFooter>
|
|
190
|
+
</CommandDialog>
|
|
191
|
+
</>
|
|
192
|
+
);
|
|
193
|
+
}
|
|
194
|
+
```
|
|
195
|
+
|
|
196
|
+
### Async results
|
|
197
|
+
|
|
198
|
+
Fetch in `onQueryChange`, pass the results as `items`, and set `loading` meanwhile: a "Searching…" row appears, the palette is `aria-busy`, and "Nothing matches" waits for the answer. `filter={() => true}` keeps the server's order over `scoreCommandEntry`. In your own composition, put a `CommandStatus` between input and list.
|
|
199
|
+
|
|
200
|
+
```tsx
|
|
201
|
+
import { Button, CommandDialog, KbdShortcut, Toaster, toast, scoreCommandEntry, type CommandEntry } from "@zonsh/ui";
|
|
202
|
+
import { BookOpenIcon, FilePlusIcon, FileTextIcon, LifeBuoyIcon, MailIcon, MoonIcon } from "lucide-react";
|
|
203
|
+
import * as React from "react";
|
|
204
|
+
|
|
205
|
+
// go, entries: as in the first example on this page that uses them.
|
|
206
|
+
|
|
207
|
+
/** The help centre of a notebook app, standing in for a search server. */
|
|
208
|
+
const articles: CommandEntry[] = [
|
|
209
|
+
["share", "Share a notebook with your team", ["invite", "permissions"]],
|
|
210
|
+
["export", "Export notes as Markdown", ["download", "backup"]],
|
|
211
|
+
["restore", "Restore a deleted page", ["trash", "undo", "recover"]],
|
|
212
|
+
["sync", "Sync notes across your devices", ["offline", "phone"]],
|
|
213
|
+
["two-step", "Turn on two-step sign-in", ["security", "2fa", "code"]],
|
|
214
|
+
["import", "Import a folder of Markdown files", ["migrate", "zip"]],
|
|
215
|
+
].map(([value, label, keywords]) => ({
|
|
216
|
+
value: `help-${value}`,
|
|
217
|
+
label: label as string,
|
|
218
|
+
keywords: keywords as string[],
|
|
219
|
+
group: "Help articles",
|
|
220
|
+
icon: <LifeBuoyIcon />,
|
|
221
|
+
onSelect: go(label as string),
|
|
222
|
+
}));
|
|
223
|
+
|
|
224
|
+
const quickActions = entries.filter((entry) => entry.group === "Actions");
|
|
225
|
+
|
|
226
|
+
const SEARCH_LATENCY = 600;
|
|
227
|
+
|
|
228
|
+
/**
|
|
229
|
+
* Results that come from a server: the actions are at hand, the help articles arrive a moment
|
|
230
|
+
* after each query. While they are on their way the palette says "Searching…" and holds back
|
|
231
|
+
* "Nothing matches". A timer stands in for the request here; a newer query replaces an older one.
|
|
232
|
+
*/
|
|
233
|
+
export function AsyncResults() {
|
|
234
|
+
const [found, setFound] = React.useState<CommandEntry[]>([]);
|
|
235
|
+
const [loading, setLoading] = React.useState(false);
|
|
236
|
+
const timer = React.useRef<ReturnType<typeof setTimeout>>(undefined);
|
|
237
|
+
React.useEffect(() => () => clearTimeout(timer.current), []);
|
|
238
|
+
const items = React.useMemo(() => [...quickActions, ...found], [found]);
|
|
239
|
+
|
|
240
|
+
const search = (query: string) => {
|
|
241
|
+
clearTimeout(timer.current);
|
|
242
|
+
if (!query.trim()) {
|
|
243
|
+
setFound([]);
|
|
244
|
+
setLoading(false);
|
|
245
|
+
return;
|
|
246
|
+
}
|
|
247
|
+
setLoading(true);
|
|
248
|
+
timer.current = setTimeout(() => {
|
|
249
|
+
setFound(articles.filter((article) => scoreCommandEntry(article, query) > 0));
|
|
250
|
+
setLoading(false);
|
|
251
|
+
}, SEARCH_LATENCY);
|
|
252
|
+
};
|
|
253
|
+
|
|
254
|
+
return (
|
|
255
|
+
<>
|
|
256
|
+
<Toaster />
|
|
257
|
+
<CommandDialog
|
|
258
|
+
items={items}
|
|
259
|
+
loading={loading}
|
|
260
|
+
onQueryChange={search}
|
|
261
|
+
label="Search help"
|
|
262
|
+
placeholder="Search actions and help articles…"
|
|
263
|
+
emptyMessage="No action or article matches. Try one word, like “export”."
|
|
264
|
+
trigger={<Button variant="secondary">Search help…</Button>}
|
|
265
|
+
/>
|
|
266
|
+
</>
|
|
267
|
+
);
|
|
268
|
+
}
|
|
269
|
+
```
|
|
270
|
+
|
|
271
|
+
## Props
|
|
272
|
+
|
|
273
|
+
**`CommandEntry`** — `value` (unique), `label`, `group?`, `keywords?`, `description?` (searched with the lowest weight, not shown), `onSelect?`, `icon?` (16px lucide), `hint?` (muted trailing text; on a narrow row label and hint each keep half and end in "…"), `disabled?`. `scoreCommandEntry(entry, query)` exposes the ranking.
|
|
274
|
+
|
|
275
|
+
| Prop | Type | Default |
|
|
276
|
+
| ----------------------------------------------------- | ---------------------------------------------------------------------------- | ------------------------------------------------------------ |
|
|
277
|
+
| `CommandDialog.items` | `CommandEntry[]` — grouped by `group` in first-seen order | — |
|
|
278
|
+
| `CommandDialog.open` / `defaultOpen` / `onOpenChange` | dialog state | — |
|
|
279
|
+
| `CommandDialog.filter` | `(entry, query) => boolean` — replaces the ranking; matches keep their order | ranked by `scoreCommandEntry` (case- and accent-insensitive) |
|
|
280
|
+
| `CommandDialog.trigger` | element that opens it, e.g. `<Button />` | — |
|
|
281
|
+
| `CommandDialog.label` | accessible name | `"Search"` |
|
|
282
|
+
| `CommandDialog.placeholder` | `string` | `"Search pages and actions…"` |
|
|
283
|
+
| `CommandDialog.emptyMessage` | `ReactNode` | `"Nothing matches that search."` |
|
|
284
|
+
| `CommandDialog.children` | replace the default input / list / footer | — |
|
|
285
|
+
| `CommandDialog.loading` | `boolean` — "Searching…" with a spinner, `aria-busy`, no empty message | `false` |
|
|
286
|
+
| `CommandDialog.onQueryChange` | `(query) => void` — as it is typed, and `""` once the palette closes | — |
|
|
287
|
+
| `CommandStatus.loading` | `boolean` — a spinner and `labels.loading`, unless it has children | `false` |
|
|
288
|
+
| `CommandItem.value` | `CommandEntry` — required | — |
|
|
289
|
+
| `CommandItem.onItemSelect` | `(entry) => void`, after the entry's `onSelect` | — |
|
|
290
|
+
| `CommandItem.closeOnSelect` | `boolean` | `true` |
|
|
291
|
+
| `CommandGroup.items` / `label` | the group's entries / heading | — |
|
|
292
|
+
| `CommandFooter.children` | replaces the default "↑↓ navigate · ↵ open" | — |
|
|
293
|
+
|
|
294
|
+
**`useCommandShortcut(onOpen)`** or **`useCommandShortcut(key, onOpen)`** — calls `onOpen` on ⌘ + `key` on Apple devices, Ctrl + `key` elsewhere (default `"k"`), preventing the browser default. Never the other modifier: on a Mac, Ctrl+K deletes to the end of the line.
|
|
295
|
+
|
|
296
|
+
`CommandDialog` takes `labels` (`Partial<CommandMessages>`: `label`, `placeholder`, `empty`, `close`, `navigate`, `open`, `loading`); `label`, `placeholder` and `emptyMessage` win. A `LocaleProvider` sets them for every palette (`messages.command`).
|
|
297
|
+
|
|
298
|
+
## Brand rules
|
|
299
|
+
|
|
300
|
+
- **Do** label entries as the navigation does, and add `keywords` for the words people type.
|
|
301
|
+
- **Do** keep groups few and plainly named: "Pages", "Actions".
|
|
302
|
+
- **Don't** change the 20px radius or the card material — it is an object, not a menu.
|
|
303
|
+
- **Don't** colour the highlight; it is the raised treatment.
|
|
304
|
+
|
|
305
|
+
## Accessibility
|
|
306
|
+
|
|
307
|
+
- Focus lands in the search field and stays there; the highlighted option is `aria-activedescendant`.
|
|
308
|
+
- The `Esc` key in the field is a real close button ("Close search") for touch and screen-reader users. On a touch-only device it is a round × and the keyboard-hint footer is left out.
|
|
309
|
+
- The field has focus the whole time the palette is open, so the caret marks it (its hairline matches the footer's `--border`). The empty state and the "Searching…" row are live regions; the spinner is hidden, the words carry it.
|
|
310
|
+
- Show the shortcut on the visible trigger so people find it.
|
|
311
|
+
|
|
312
|
+
### Keyboard
|
|
313
|
+
|
|
314
|
+
| Key | What it does |
|
|
315
|
+
| ----------- | ----------------------------------------------------------------------------------- |
|
|
316
|
+
| ⌘K / Ctrl+K | Opens or closes the palette, with `useCommandShortcut` (⌘ on a Mac, Ctrl elsewhere) |
|
|
317
|
+
| Typing | Filters the results; the first match is highlighted |
|
|
318
|
+
| ↓ / ↑ | Moves the highlight, looping at the ends |
|
|
319
|
+
| Enter | Runs the highlighted entry's `onSelect` and closes the palette |
|
|
320
|
+
| Escape | Closes the palette and returns focus to where it was |
|
|
321
|
+
|
|
322
|
+
---
|
|
323
|
+
|
|
324
|
+
- Import: `import { CommandDialog, CommandInput, CommandList, CommandGroup, CommandGroupLabel, CommandItem, CommandEmpty, CommandFooter } from "@zonsh/ui"`
|
|
325
|
+
- Source: `packages/ui/src/components/command.tsx`
|
|
326
|
+
- Primitive: `@base-ui/react/autocomplete` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/autocomplete.md`)
|