@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,197 @@
|
|
|
1
|
+
# Native Select
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Field, FieldLabel, NativeSelect, NativeSelectOption } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
export function Basic() {
|
|
7
|
+
return (
|
|
8
|
+
<Field className="w-full max-w-sm">
|
|
9
|
+
<FieldLabel>Country</FieldLabel>
|
|
10
|
+
<NativeSelect defaultValue="de" name="country">
|
|
11
|
+
<NativeSelectOption value="de">Germany</NativeSelectOption>
|
|
12
|
+
<NativeSelectOption value="at">Austria</NativeSelectOption>
|
|
13
|
+
<NativeSelectOption value="ch">Switzerland</NativeSelectOption>
|
|
14
|
+
<NativeSelectOption value="nl">Netherlands</NativeSelectOption>
|
|
15
|
+
<NativeSelectOption value="other">Somewhere else</NativeSelectOption>
|
|
16
|
+
</NativeSelect>
|
|
17
|
+
</Field>
|
|
18
|
+
);
|
|
19
|
+
}
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
A real `<select>` in the field material, 38px (30px with `size="sm"`), with `Select`'s chevron. The platform draws the list — a wheel or sheet on phones, the OS menu on desktop.
|
|
23
|
+
|
|
24
|
+
## Usage
|
|
25
|
+
|
|
26
|
+
```tsx
|
|
27
|
+
import { Field, FieldLabel, NativeSelect, NativeSelectOption } from "@zonsh/ui";
|
|
28
|
+
|
|
29
|
+
<Field>
|
|
30
|
+
<FieldLabel>Country</FieldLabel>
|
|
31
|
+
<NativeSelect name="country" defaultValue="de">
|
|
32
|
+
<NativeSelectOption value="de">Germany</NativeSelectOption>
|
|
33
|
+
<NativeSelectOption value="at">Austria</NativeSelectOption>
|
|
34
|
+
</NativeSelect>
|
|
35
|
+
</Field>;
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
The props you'll reach for: `name`, `defaultValue` (or `value` / `onChange`) and `size`.
|
|
39
|
+
|
|
40
|
+
## When to use
|
|
41
|
+
|
|
42
|
+
- Plain forms — contact, settings, checkout; the value submits like any field.
|
|
43
|
+
- Long lists searched by typing (countries, years), mobile-first screens, and pages that must work before JavaScript loads.
|
|
44
|
+
- `Select` when options need icons, descriptions or the menu material; `Combobox` to filter a long list.
|
|
45
|
+
|
|
46
|
+
## Examples
|
|
47
|
+
|
|
48
|
+
### Placeholder
|
|
49
|
+
|
|
50
|
+
A native select has no placeholder; use a disabled, empty first option.
|
|
51
|
+
|
|
52
|
+
```tsx
|
|
53
|
+
import { Field, FieldDescription, FieldLabel, NativeSelect, NativeSelectOption } from "@zonsh/ui";
|
|
54
|
+
|
|
55
|
+
export function Placeholder() {
|
|
56
|
+
return (
|
|
57
|
+
<Field className="w-full max-w-sm">
|
|
58
|
+
<FieldLabel>Team size</FieldLabel>
|
|
59
|
+
<NativeSelect defaultValue="" required>
|
|
60
|
+
<NativeSelectOption value="" disabled>
|
|
61
|
+
Choose a range
|
|
62
|
+
</NativeSelectOption>
|
|
63
|
+
<NativeSelectOption value="1-10">1–10 people</NativeSelectOption>
|
|
64
|
+
<NativeSelectOption value="11-50">11–50 people</NativeSelectOption>
|
|
65
|
+
<NativeSelectOption value="51-250">51–250 people</NativeSelectOption>
|
|
66
|
+
<NativeSelectOption value="250+">More than 250</NativeSelectOption>
|
|
67
|
+
</NativeSelect>
|
|
68
|
+
<FieldDescription>A disabled empty first option works as the placeholder.</FieldDescription>
|
|
69
|
+
</Field>
|
|
70
|
+
);
|
|
71
|
+
}
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
### Groups
|
|
75
|
+
|
|
76
|
+
```tsx
|
|
77
|
+
import { Field, FieldLabel, NativeSelect, NativeSelectOptGroup, NativeSelectOption } from "@zonsh/ui";
|
|
78
|
+
|
|
79
|
+
export function Groups() {
|
|
80
|
+
return (
|
|
81
|
+
<Field className="w-full max-w-sm">
|
|
82
|
+
<FieldLabel>What is it about?</FieldLabel>
|
|
83
|
+
<NativeSelect defaultValue="problem">
|
|
84
|
+
<NativeSelectOptGroup label="Help">
|
|
85
|
+
<NativeSelectOption value="general">General question</NativeSelectOption>
|
|
86
|
+
<NativeSelectOption value="billing">Billing</NativeSelectOption>
|
|
87
|
+
<NativeSelectOption value="problem">Report a problem</NativeSelectOption>
|
|
88
|
+
</NativeSelectOptGroup>
|
|
89
|
+
<NativeSelectOptGroup label="Ideas">
|
|
90
|
+
<NativeSelectOption value="feedback">Feedback</NativeSelectOption>
|
|
91
|
+
<NativeSelectOption value="feature">A feature request</NativeSelectOption>
|
|
92
|
+
</NativeSelectOptGroup>
|
|
93
|
+
</NativeSelect>
|
|
94
|
+
</Field>
|
|
95
|
+
);
|
|
96
|
+
}
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
### Sizes
|
|
100
|
+
|
|
101
|
+
```tsx
|
|
102
|
+
import { Field, FieldLabel, NativeSelect, NativeSelectOption } from "@zonsh/ui";
|
|
103
|
+
|
|
104
|
+
export function Sizes() {
|
|
105
|
+
return (
|
|
106
|
+
<div className="flex w-full max-w-xs flex-col gap-4">
|
|
107
|
+
<Field>
|
|
108
|
+
<FieldLabel>Dense</FieldLabel>
|
|
109
|
+
<NativeSelect size="sm" defaultValue="25">
|
|
110
|
+
<NativeSelectOption value="25">25 rows</NativeSelectOption>
|
|
111
|
+
<NativeSelectOption value="50">50 rows</NativeSelectOption>
|
|
112
|
+
<NativeSelectOption value="100">100 rows</NativeSelectOption>
|
|
113
|
+
</NativeSelect>
|
|
114
|
+
</Field>
|
|
115
|
+
<Field>
|
|
116
|
+
<FieldLabel>Default</FieldLabel>
|
|
117
|
+
<NativeSelect defaultValue="25">
|
|
118
|
+
<NativeSelectOption value="25">25 rows</NativeSelectOption>
|
|
119
|
+
<NativeSelectOption value="50">50 rows</NativeSelectOption>
|
|
120
|
+
<NativeSelectOption value="100">100 rows</NativeSelectOption>
|
|
121
|
+
</NativeSelect>
|
|
122
|
+
</Field>
|
|
123
|
+
</div>
|
|
124
|
+
);
|
|
125
|
+
}
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
### States
|
|
129
|
+
|
|
130
|
+
```tsx
|
|
131
|
+
import { Field, FieldError, FieldLabel, NativeSelect, NativeSelectOption } from "@zonsh/ui";
|
|
132
|
+
|
|
133
|
+
function Invalid() {
|
|
134
|
+
return (
|
|
135
|
+
<Field invalid className="w-full max-w-sm">
|
|
136
|
+
<FieldLabel>Preferred language</FieldLabel>
|
|
137
|
+
<NativeSelect defaultValue="">
|
|
138
|
+
<NativeSelectOption value="" disabled>
|
|
139
|
+
Choose a language
|
|
140
|
+
</NativeSelectOption>
|
|
141
|
+
<NativeSelectOption value="en">English</NativeSelectOption>
|
|
142
|
+
<NativeSelectOption value="de">Deutsch</NativeSelectOption>
|
|
143
|
+
</NativeSelect>
|
|
144
|
+
<FieldError match>Choose a language for the interface.</FieldError>
|
|
145
|
+
</Field>
|
|
146
|
+
);
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
function Disabled() {
|
|
150
|
+
return (
|
|
151
|
+
<Field disabled className="w-full max-w-sm">
|
|
152
|
+
<FieldLabel>Billing period</FieldLabel>
|
|
153
|
+
<NativeSelect defaultValue="monthly">
|
|
154
|
+
<NativeSelectOption value="monthly">Monthly</NativeSelectOption>
|
|
155
|
+
<NativeSelectOption value="yearly">Yearly</NativeSelectOption>
|
|
156
|
+
</NativeSelect>
|
|
157
|
+
</Field>
|
|
158
|
+
);
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
/** The invalid and disabled states, one under the other. */
|
|
162
|
+
export function States() {
|
|
163
|
+
return (
|
|
164
|
+
<div className="flex w-full max-w-sm flex-col gap-8">
|
|
165
|
+
<Invalid />
|
|
166
|
+
<Disabled />
|
|
167
|
+
</div>
|
|
168
|
+
);
|
|
169
|
+
}
|
|
170
|
+
```
|
|
171
|
+
|
|
172
|
+
## Props
|
|
173
|
+
|
|
174
|
+
| Component | Prop | Type | Default |
|
|
175
|
+
| -------------- | ------------------ | ------------------- | ----------- |
|
|
176
|
+
| `NativeSelect` | `size` | `"sm" \| "default"` | `"default"` |
|
|
177
|
+
| `NativeSelect` | `wrapperClassName` | `string` | — |
|
|
178
|
+
|
|
179
|
+
`NativeSelect` takes every `<select>` prop (`name`, `value`, `defaultValue`, `onChange`, `required`, `disabled`). `className` styles the select; `wrapperClassName` the wrapper holding the chevron (width, layout). As a Base UI `Field.Control` it takes a `Field`'s label, description and validation. `NativeSelectOption` is `<option>`, `NativeSelectOptGroup` `<optgroup>`. Data attributes: `data-size`, `data-invalid`, `data-disabled`.
|
|
180
|
+
|
|
181
|
+
## Brand rules
|
|
182
|
+
|
|
183
|
+
- **Do** keep option labels short and plain; browsers ignore most `<option>` styling.
|
|
184
|
+
- **Do** match the height of the fields beside it.
|
|
185
|
+
- **Don't** use `multiple`: the native multi-select cannot take the material. Use `CheckboxGroup` or `Combobox`.
|
|
186
|
+
|
|
187
|
+
## Accessibility
|
|
188
|
+
|
|
189
|
+
- Keyboard, typeahead and screen reader support come from the platform.
|
|
190
|
+
- Label it with `FieldLabel` inside a `Field`.
|
|
191
|
+
- The chevron is decorative and `aria-hidden`.
|
|
192
|
+
- Invalid selects show the destructive border and ring, and a `FieldError` message.
|
|
193
|
+
|
|
194
|
+
---
|
|
195
|
+
|
|
196
|
+
- Import: `import { NativeSelect, NativeSelectOption, NativeSelectOptGroup } from "@zonsh/ui"`
|
|
197
|
+
- Source: `packages/ui/src/components/native-select.tsx`
|
|
@@ -0,0 +1,253 @@
|
|
|
1
|
+
# Navigation menu
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { NavigationMenu, NavigationMenuContent, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
const product = [
|
|
7
|
+
{ href: "#projects", title: "Projects", description: "Create, organise and share your work." },
|
|
8
|
+
{
|
|
9
|
+
href: "#deploys",
|
|
10
|
+
title: "Deploys",
|
|
11
|
+
description: "A preview for every branch, production on merge.",
|
|
12
|
+
},
|
|
13
|
+
{
|
|
14
|
+
href: "#analytics",
|
|
15
|
+
title: "Analytics",
|
|
16
|
+
description: "Visits and performance, without cookies.",
|
|
17
|
+
},
|
|
18
|
+
];
|
|
19
|
+
|
|
20
|
+
const docs = [
|
|
21
|
+
{ href: "#start", title: "Getting started", description: "Install, sign in and deploy a first project." },
|
|
22
|
+
{ href: "#guides", title: "Guides", description: "Step-by-step walkthroughs for common tasks." },
|
|
23
|
+
{ href: "#reference", title: "API reference", description: "Every endpoint, parameter and response." },
|
|
24
|
+
];
|
|
25
|
+
|
|
26
|
+
export function Header() {
|
|
27
|
+
return (
|
|
28
|
+
<NavigationMenu>
|
|
29
|
+
<NavigationMenuList>
|
|
30
|
+
<NavigationMenuItem>
|
|
31
|
+
<NavigationMenuTrigger>Product</NavigationMenuTrigger>
|
|
32
|
+
<NavigationMenuContent>
|
|
33
|
+
<ul className="m-0 grid list-none gap-1 p-0 sm:w-[440px]">
|
|
34
|
+
{product.map((item) => (
|
|
35
|
+
<li key={item.href}>
|
|
36
|
+
<NavigationMenuLink variant="row" href={item.href}>
|
|
37
|
+
{item.title}
|
|
38
|
+
<small>{item.description}</small>
|
|
39
|
+
</NavigationMenuLink>
|
|
40
|
+
</li>
|
|
41
|
+
))}
|
|
42
|
+
</ul>
|
|
43
|
+
</NavigationMenuContent>
|
|
44
|
+
</NavigationMenuItem>
|
|
45
|
+
<NavigationMenuItem>
|
|
46
|
+
<NavigationMenuTrigger>Docs</NavigationMenuTrigger>
|
|
47
|
+
<NavigationMenuContent>
|
|
48
|
+
<ul className="m-0 grid list-none gap-1 p-0 sm:w-[380px]">
|
|
49
|
+
{docs.map((item) => (
|
|
50
|
+
<li key={item.href}>
|
|
51
|
+
<NavigationMenuLink variant="row" href={item.href}>
|
|
52
|
+
{item.title}
|
|
53
|
+
<small>{item.description}</small>
|
|
54
|
+
</NavigationMenuLink>
|
|
55
|
+
</li>
|
|
56
|
+
))}
|
|
57
|
+
</ul>
|
|
58
|
+
</NavigationMenuContent>
|
|
59
|
+
</NavigationMenuItem>
|
|
60
|
+
<NavigationMenuItem>
|
|
61
|
+
<NavigationMenuLink href="#pricing" active>
|
|
62
|
+
Pricing
|
|
63
|
+
</NavigationMenuLink>
|
|
64
|
+
</NavigationMenuItem>
|
|
65
|
+
<NavigationMenuItem>
|
|
66
|
+
<NavigationMenuLink href="#blog">Blog</NavigationMenuLink>
|
|
67
|
+
</NavigationMenuItem>
|
|
68
|
+
<NavigationMenuItem>
|
|
69
|
+
<NavigationMenuLink href="#about">About</NavigationMenuLink>
|
|
70
|
+
</NavigationMenuItem>
|
|
71
|
+
</NavigationMenuList>
|
|
72
|
+
</NavigationMenu>
|
|
73
|
+
);
|
|
74
|
+
}
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
Site-header links that brighten on hover, when open, or on the current page. A panel opens in one `material-menu` popup that resizes and slides between items; its rows (`variant="row"`) take a title and a `<small>` description.
|
|
78
|
+
|
|
79
|
+
## Usage
|
|
80
|
+
|
|
81
|
+
```tsx
|
|
82
|
+
import {
|
|
83
|
+
NavigationMenu,
|
|
84
|
+
NavigationMenuContent,
|
|
85
|
+
NavigationMenuItem,
|
|
86
|
+
NavigationMenuLink,
|
|
87
|
+
NavigationMenuList,
|
|
88
|
+
NavigationMenuTrigger,
|
|
89
|
+
} from "@zonsh/ui";
|
|
90
|
+
|
|
91
|
+
<NavigationMenu>
|
|
92
|
+
<NavigationMenuList>
|
|
93
|
+
<NavigationMenuItem>
|
|
94
|
+
<NavigationMenuTrigger>Product</NavigationMenuTrigger>
|
|
95
|
+
<NavigationMenuContent>
|
|
96
|
+
<NavigationMenuLink variant="row" href="/product/deploys">
|
|
97
|
+
Deploys
|
|
98
|
+
</NavigationMenuLink>
|
|
99
|
+
</NavigationMenuContent>
|
|
100
|
+
</NavigationMenuItem>
|
|
101
|
+
<NavigationMenuItem>
|
|
102
|
+
<NavigationMenuLink href="/about">About</NavigationMenuLink>
|
|
103
|
+
</NavigationMenuItem>
|
|
104
|
+
</NavigationMenuList>
|
|
105
|
+
</NavigationMenu>;
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
The props you'll use: `variant` on the root, and `active` (the current page) and `render` (your router's link) on links.
|
|
109
|
+
|
|
110
|
+
## When to use
|
|
111
|
+
|
|
112
|
+
- A desktop header with a few sections, some grouping several pages ("Product").
|
|
113
|
+
- For a whole site header (logo, actions, mobile panel) use `SiteHeader`, built on this; use it directly only for what SiteHeader cannot express.
|
|
114
|
+
- Not for in-page views (`Tabs`) or app navigation (`Sidebar`).
|
|
115
|
+
|
|
116
|
+
## Examples
|
|
117
|
+
|
|
118
|
+
### Pill
|
|
119
|
+
|
|
120
|
+
One raised surface glides to the hovered item, the open trigger, or the current page.
|
|
121
|
+
|
|
122
|
+
```tsx
|
|
123
|
+
import { NavigationMenu, NavigationMenuContent, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger } from "@zonsh/ui";
|
|
124
|
+
|
|
125
|
+
// product: as in the first example on this page that uses them.
|
|
126
|
+
|
|
127
|
+
export function Pill() {
|
|
128
|
+
return (
|
|
129
|
+
<NavigationMenu variant="pill">
|
|
130
|
+
<NavigationMenuList>
|
|
131
|
+
<NavigationMenuItem>
|
|
132
|
+
<NavigationMenuTrigger>Product</NavigationMenuTrigger>
|
|
133
|
+
<NavigationMenuContent>
|
|
134
|
+
<ul className="m-0 grid list-none gap-1 p-0 sm:w-[440px]">
|
|
135
|
+
{product.map((item) => (
|
|
136
|
+
<li key={item.href}>
|
|
137
|
+
<NavigationMenuLink variant="row" href={item.href}>
|
|
138
|
+
{item.title}
|
|
139
|
+
<small>{item.description}</small>
|
|
140
|
+
</NavigationMenuLink>
|
|
141
|
+
</li>
|
|
142
|
+
))}
|
|
143
|
+
</ul>
|
|
144
|
+
</NavigationMenuContent>
|
|
145
|
+
</NavigationMenuItem>
|
|
146
|
+
<NavigationMenuItem>
|
|
147
|
+
<NavigationMenuLink href="#pricing" active>
|
|
148
|
+
Pricing
|
|
149
|
+
</NavigationMenuLink>
|
|
150
|
+
</NavigationMenuItem>
|
|
151
|
+
<NavigationMenuItem>
|
|
152
|
+
<NavigationMenuLink href="#blog">Blog</NavigationMenuLink>
|
|
153
|
+
</NavigationMenuItem>
|
|
154
|
+
<NavigationMenuItem>
|
|
155
|
+
<NavigationMenuLink href="#about">About</NavigationMenuLink>
|
|
156
|
+
</NavigationMenuItem>
|
|
157
|
+
</NavigationMenuList>
|
|
158
|
+
</NavigationMenu>
|
|
159
|
+
);
|
|
160
|
+
}
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
### Underline
|
|
164
|
+
|
|
165
|
+
A 1px foreground rule, gliding the same way.
|
|
166
|
+
|
|
167
|
+
```tsx
|
|
168
|
+
import { NavigationMenu, NavigationMenuContent, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger } from "@zonsh/ui";
|
|
169
|
+
|
|
170
|
+
// docs: as in the first example on this page that uses them.
|
|
171
|
+
|
|
172
|
+
export function Underline() {
|
|
173
|
+
return (
|
|
174
|
+
<NavigationMenu variant="underline">
|
|
175
|
+
<NavigationMenuList>
|
|
176
|
+
<NavigationMenuItem>
|
|
177
|
+
<NavigationMenuTrigger>Docs</NavigationMenuTrigger>
|
|
178
|
+
<NavigationMenuContent>
|
|
179
|
+
<ul className="m-0 grid list-none gap-1 p-0 sm:w-[380px]">
|
|
180
|
+
{docs.map((item) => (
|
|
181
|
+
<li key={item.href}>
|
|
182
|
+
<NavigationMenuLink variant="row" href={item.href}>
|
|
183
|
+
{item.title}
|
|
184
|
+
<small>{item.description}</small>
|
|
185
|
+
</NavigationMenuLink>
|
|
186
|
+
</li>
|
|
187
|
+
))}
|
|
188
|
+
</ul>
|
|
189
|
+
</NavigationMenuContent>
|
|
190
|
+
</NavigationMenuItem>
|
|
191
|
+
<NavigationMenuItem>
|
|
192
|
+
<NavigationMenuLink href="#pricing" active>
|
|
193
|
+
Pricing
|
|
194
|
+
</NavigationMenuLink>
|
|
195
|
+
</NavigationMenuItem>
|
|
196
|
+
<NavigationMenuItem>
|
|
197
|
+
<NavigationMenuLink href="#blog">Blog</NavigationMenuLink>
|
|
198
|
+
</NavigationMenuItem>
|
|
199
|
+
<NavigationMenuItem>
|
|
200
|
+
<NavigationMenuLink href="#about">About</NavigationMenuLink>
|
|
201
|
+
</NavigationMenuItem>
|
|
202
|
+
</NavigationMenuList>
|
|
203
|
+
</NavigationMenu>
|
|
204
|
+
);
|
|
205
|
+
}
|
|
206
|
+
```
|
|
207
|
+
|
|
208
|
+
## Props
|
|
209
|
+
|
|
210
|
+
| Prop | Type | Default |
|
|
211
|
+
| ---------------------------------------- | ------------------------------------------------------------------------ | --------------- |
|
|
212
|
+
| `NavigationMenu.variant` | `"text" \| "pill" \| "underline"` — the bar's design | `"text"` |
|
|
213
|
+
| `NavigationMenu.positioner` | Base UI `Positioner` props (`sideOffset`, `align`, `collisionPadding` …) | `sideOffset: 8` |
|
|
214
|
+
| `NavigationMenu.value` / `onValueChange` | controlled open item | — |
|
|
215
|
+
| `NavigationMenu.delay` / `closeDelay` | `number` (ms) | `50` |
|
|
216
|
+
| `NavigationMenuLink.variant` | `"bar" \| "row"` | `"bar"` |
|
|
217
|
+
| `NavigationMenuLink.active` | `boolean` — the current page | `false` |
|
|
218
|
+
| `NavigationMenuLink.closeOnClick` | `boolean` | `false` |
|
|
219
|
+
| `NavigationMenuLink.render` | `ReactElement` — your router's link | `<a>` |
|
|
220
|
+
|
|
221
|
+
`NavigationMenu` renders the portal, positioner, popup and viewport for you. Data attributes: `data-variant` on the root and links, `data-popup-open` on triggers, `data-active` on the current link.
|
|
222
|
+
|
|
223
|
+
## Brand rules
|
|
224
|
+
|
|
225
|
+
- **Do** keep top-level labels to one word, and about five of them: "Product Docs Pricing Blog About".
|
|
226
|
+
- **Do** give panel rows a short description of the page.
|
|
227
|
+
- **Don't** put actions ("Sign up") in the menu; use a `Button` in the header's actions.
|
|
228
|
+
- **Don't** fill top-level items on hover; in `pill` one surface glides between them.
|
|
229
|
+
- **Don't** add more than one level of panels.
|
|
230
|
+
|
|
231
|
+
## Accessibility
|
|
232
|
+
|
|
233
|
+
- Base UI provides the disclosure semantics and `aria-expanded`.
|
|
234
|
+
- `active` sets `aria-current="page"` on the link.
|
|
235
|
+
- On small screens, switch to a full panel (see `SiteHeader`) rather than a hover menu.
|
|
236
|
+
|
|
237
|
+
### Keyboard
|
|
238
|
+
|
|
239
|
+
| Key | What it does |
|
|
240
|
+
| --------------- | -------------------------------------------------------------------------- |
|
|
241
|
+
| Tab / Shift+Tab | Moves between the links and triggers; from an open trigger, into its panel |
|
|
242
|
+
| ← / → | Moves between the links and triggers (swapped right to left) |
|
|
243
|
+
| Enter / Space | Opens or closes the focused trigger's panel, or follows the focused link |
|
|
244
|
+
| ↓ | Opens the focused trigger's panel |
|
|
245
|
+
| Escape | Closes the open panel and returns focus to its trigger |
|
|
246
|
+
|
|
247
|
+
Tabbing out of an open panel closes it.
|
|
248
|
+
|
|
249
|
+
---
|
|
250
|
+
|
|
251
|
+
- Import: `import { NavigationMenu, NavigationMenuList, NavigationMenuItem, NavigationMenuTrigger, NavigationMenuContent, NavigationMenuLink } from "@zonsh/ui"`
|
|
252
|
+
- Source: `packages/ui/src/components/navigation-menu.tsx`
|
|
253
|
+
- Primitive: `@base-ui/react/navigation-menu` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/navigation-menu.md`)
|
|
@@ -0,0 +1,210 @@
|
|
|
1
|
+
# Number Field
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Field, FieldDescription, FieldLabel, NumberField } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
export function Basic() {
|
|
7
|
+
return (
|
|
8
|
+
<Field className="max-w-60">
|
|
9
|
+
<FieldLabel>Tickets</FieldLabel>
|
|
10
|
+
<NumberField defaultValue={2} min={1} max={10} />
|
|
11
|
+
<FieldDescription>Up to ten per order.</FieldDescription>
|
|
12
|
+
</Field>
|
|
13
|
+
);
|
|
14
|
+
}
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
A recessed 38px field (30px dense): the number centred in Licht Mono tabular figures, a raised round − and + on either side.
|
|
18
|
+
|
|
19
|
+
## Usage
|
|
20
|
+
|
|
21
|
+
```tsx
|
|
22
|
+
import { Field, FieldLabel, NumberField } from "@zonsh/ui";
|
|
23
|
+
|
|
24
|
+
<Field>
|
|
25
|
+
<FieldLabel>Tickets</FieldLabel>
|
|
26
|
+
<NumberField defaultValue={2} min={1} max={10} />
|
|
27
|
+
</Field>;
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
The props you'll use: `min` / `max`, `step`, and `format` for currency and units.
|
|
31
|
+
|
|
32
|
+
## When to use
|
|
33
|
+
|
|
34
|
+
- Exact counts, quantities and amounts: tickets, seats, a monthly budget.
|
|
35
|
+
- For a rough position or a range, use `Slider`.
|
|
36
|
+
|
|
37
|
+
## Examples
|
|
38
|
+
|
|
39
|
+
### Stacked steppers
|
|
40
|
+
|
|
41
|
+
`steppers="stacked"` puts the number at the start and ▲ ▼ in one split key at the end (mirrored right to left), for settings packed in a column. The halves are small, so keep `sides` for touch.
|
|
42
|
+
|
|
43
|
+
```tsx
|
|
44
|
+
import { Field, FieldLabel, NumberField } from "@zonsh/ui";
|
|
45
|
+
|
|
46
|
+
export function Stacked() {
|
|
47
|
+
return (
|
|
48
|
+
<div className="flex flex-col gap-4">
|
|
49
|
+
<Field className="max-w-48">
|
|
50
|
+
<FieldLabel>Width (px)</FieldLabel>
|
|
51
|
+
<NumberField steppers="stacked" defaultValue={320} min={0} step={10} />
|
|
52
|
+
</Field>
|
|
53
|
+
<Field className="max-w-48">
|
|
54
|
+
<FieldLabel>Columns</FieldLabel>
|
|
55
|
+
<NumberField steppers="stacked" size="sm" defaultValue={12} min={1} max={24} />
|
|
56
|
+
</Field>
|
|
57
|
+
</div>
|
|
58
|
+
);
|
|
59
|
+
}
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
### Scrub label
|
|
63
|
+
|
|
64
|
+
`label` is a scrub area: drag across it. Leave it out under a `FieldLabel`.
|
|
65
|
+
|
|
66
|
+
```tsx
|
|
67
|
+
import { NumberField } from "@zonsh/ui";
|
|
68
|
+
|
|
69
|
+
export function ScrubLabel() {
|
|
70
|
+
return (
|
|
71
|
+
<div className="max-w-60">
|
|
72
|
+
<NumberField label="Seats" defaultValue={12} min={1} max={250} />
|
|
73
|
+
</div>
|
|
74
|
+
);
|
|
75
|
+
}
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
### Currency
|
|
79
|
+
|
|
80
|
+
`format` writes currency and units.
|
|
81
|
+
|
|
82
|
+
```tsx
|
|
83
|
+
import { Field, FieldLabel, NumberField } from "@zonsh/ui";
|
|
84
|
+
|
|
85
|
+
export function Currency() {
|
|
86
|
+
return (
|
|
87
|
+
<Field className="max-w-60">
|
|
88
|
+
<FieldLabel>Monthly budget</FieldLabel>
|
|
89
|
+
<NumberField
|
|
90
|
+
defaultValue={4000}
|
|
91
|
+
min={0}
|
|
92
|
+
step={500}
|
|
93
|
+
format={{ style: "currency", currency: "EUR", maximumFractionDigits: 0 }}
|
|
94
|
+
/>
|
|
95
|
+
</Field>
|
|
96
|
+
);
|
|
97
|
+
}
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
### Sizes
|
|
101
|
+
|
|
102
|
+
Dense steppers are flat until hovered.
|
|
103
|
+
|
|
104
|
+
```tsx
|
|
105
|
+
import { Field, FieldLabel, NumberField } from "@zonsh/ui";
|
|
106
|
+
|
|
107
|
+
export function Sizes() {
|
|
108
|
+
return (
|
|
109
|
+
<div className="flex flex-col gap-4">
|
|
110
|
+
<Field className="max-w-48">
|
|
111
|
+
<FieldLabel>Dense</FieldLabel>
|
|
112
|
+
<NumberField size="sm" defaultValue={3} min={0} />
|
|
113
|
+
</Field>
|
|
114
|
+
<Field className="max-w-48">
|
|
115
|
+
<FieldLabel>Default</FieldLabel>
|
|
116
|
+
<NumberField defaultValue={3} min={0} />
|
|
117
|
+
</Field>
|
|
118
|
+
</div>
|
|
119
|
+
);
|
|
120
|
+
}
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
### States
|
|
124
|
+
|
|
125
|
+
```tsx
|
|
126
|
+
import { Field, FieldError, FieldLabel, NumberField } from "@zonsh/ui";
|
|
127
|
+
|
|
128
|
+
function Invalid() {
|
|
129
|
+
return (
|
|
130
|
+
<Field invalid className="max-w-60">
|
|
131
|
+
<FieldLabel>Copies</FieldLabel>
|
|
132
|
+
<NumberField defaultValue={0} min={0} />
|
|
133
|
+
<FieldError match>Order at least one copy.</FieldError>
|
|
134
|
+
</Field>
|
|
135
|
+
);
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
function Disabled() {
|
|
139
|
+
return (
|
|
140
|
+
<Field disabled className="max-w-60">
|
|
141
|
+
<FieldLabel>Storage included (GB)</FieldLabel>
|
|
142
|
+
<NumberField defaultValue={10} />
|
|
143
|
+
</Field>
|
|
144
|
+
);
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
/** The invalid and disabled states, one under the other. */
|
|
148
|
+
export function States() {
|
|
149
|
+
return (
|
|
150
|
+
<div className="flex w-full max-w-sm flex-col gap-8">
|
|
151
|
+
<Invalid />
|
|
152
|
+
<Disabled />
|
|
153
|
+
</div>
|
|
154
|
+
);
|
|
155
|
+
}
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
## Motion
|
|
159
|
+
|
|
160
|
+
A step (stepper, arrow key, wheel) rolls the changed digits: up rises from below, down drops from above. A digit that appears or disappears (9 → 10) grows or shrinks its place, so the value never jumps. Typing, pasting and scrubbing don't roll. A step that comes while the digits still roll (a held key or stepper, a fast wheel) rolls on from where they are, so a held key keeps counting visibly and lands on the last value. The roll is NumberRoll's: drawn over the input while it moves, and the input, with its caret and selection, shows again once the digits land.
|
|
161
|
+
|
|
162
|
+
## Props
|
|
163
|
+
|
|
164
|
+
| Prop | Type | Default |
|
|
165
|
+
| ------------- | ---------------------------------------------- | -------------------------------------------- |
|
|
166
|
+
| `size` | `"sm" \| "default"` | `"default"` |
|
|
167
|
+
| `steppers` | `"sides" \| "stacked"` | `"sides"` |
|
|
168
|
+
| `label` | `ReactNode`: renders a scrub-area label | — |
|
|
169
|
+
| `placeholder` | `string` | — |
|
|
170
|
+
| `labels` | `{ decrement?, increment?, roleDescription? }` | `"Decrease"`, `"Increase"`, `"Number field"` |
|
|
171
|
+
| `min` / `max` | `number` | — |
|
|
172
|
+
| `step` | `number \| "any"` | `1` |
|
|
173
|
+
| `format` | `Intl.NumberFormatOptions` | — |
|
|
174
|
+
|
|
175
|
+
`value`, `defaultValue`, `onValueChange`, `onValueCommitted`, `smallStep`, `largeStep`, `allowWheelScrub`, `name`, `required`, `disabled` and `readOnly` go to Base UI's `NumberField.Root`. A form reset returns an uncontrolled field to its `defaultValue`. Data attributes: `data-size`, `data-steppers`, `data-disabled`, `data-invalid`, `data-scrubbing`.
|
|
176
|
+
|
|
177
|
+
`labels` (`Partial<NumberFieldMessages>`) names the steppers and the field's role; a `LocaleProvider` sets them for every NumberField (`messages.numberField`), and its `locale` formats the number unless `locale` is given.
|
|
178
|
+
|
|
179
|
+
## Brand rules
|
|
180
|
+
|
|
181
|
+
- **Do** set `min` and `max` to the business rule, so the steppers stop where they should.
|
|
182
|
+
- **Do** keep digits mono and tabular.
|
|
183
|
+
- **Don't** type units into the input by hand. Use `format`.
|
|
184
|
+
|
|
185
|
+
## Accessibility
|
|
186
|
+
|
|
187
|
+
- The input is a text field with `aria-roledescription="Number field"`. While an IME composes, its keys don't step or commit.
|
|
188
|
+
- Pressing a stepper or the scrub label focuses the input, so the arrows keep stepping; no caret shows until the number is clicked or edited.
|
|
189
|
+
- The steppers have accessible names; change them with `labels.decrement` and `labels.increment`.
|
|
190
|
+
- Focus shows the field's 2px `--control-focus` outline and border.
|
|
191
|
+
- The digit roll is an overlay hidden from assistive tech; the input keeps the value and name. Under `prefers-reduced-motion` the value changes without moving.
|
|
192
|
+
|
|
193
|
+
### Keyboard
|
|
194
|
+
|
|
195
|
+
| Key | What it does |
|
|
196
|
+
| ------------------- | ------------------------------------------------------------------- |
|
|
197
|
+
| ↑ / ↓ | Steps the value by `step` |
|
|
198
|
+
| Shift+↑ / ↓ | Steps by `largeStep` (10 by default) |
|
|
199
|
+
| Page Up / Page Down | Steps by `largeStep`, as Shift+↑ / ↓ do |
|
|
200
|
+
| Alt+↑ / ↓ | Steps by `smallStep` (0.1 by default) |
|
|
201
|
+
| Home / End | Sets the value to `min` or `max`, when that bound is set |
|
|
202
|
+
| Enter | Puts the typed number in, and the focus stays; a form still submits |
|
|
203
|
+
|
|
204
|
+
Typed numbers are clamped and formatted on Enter or blur. Only digits, the locale's separators and a sign (when negatives are allowed) can be typed.
|
|
205
|
+
|
|
206
|
+
---
|
|
207
|
+
|
|
208
|
+
- Import: `import { NumberField } from "@zonsh/ui"`
|
|
209
|
+
- Source: `packages/ui/src/components/number-field.tsx`
|
|
210
|
+
- Primitive: `@base-ui/react/number-field` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/number-field.md`)
|