@zonsh/ui 0.5.0 → 0.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +639 -0
- package/README.md +49 -21
- package/dist/brand.d.ts +3 -0
- package/dist/brand.js +7 -0
- package/dist/components/_breadcrumb-more.d.ts +6 -0
- package/dist/components/_breadcrumb-more.js +5 -0
- package/dist/components/_drawing-svg.d.ts +11 -0
- package/dist/components/_drawing-svg.js +30 -0
- package/dist/components/_media.d.ts +159 -0
- package/dist/components/_media.js +266 -0
- package/dist/components/_overlay.d.ts +8 -5
- package/dist/components/_overlay.js +11 -6
- package/dist/components/_scheduler-calendar.d.ts +71 -0
- package/dist/components/_scheduler-calendar.js +940 -0
- package/dist/components/_scheduler-editor.d.ts +29 -0
- package/dist/components/_scheduler-editor.js +111 -0
- package/dist/components/_scheduler-menu.d.ts +16 -0
- package/dist/components/_scheduler-menu.js +18 -0
- package/dist/components/_scheduler-parts.d.ts +164 -0
- package/dist/components/_scheduler-parts.js +327 -0
- package/dist/components/_suggest-list.d.ts +142 -0
- package/dist/components/_suggest-list.js +159 -0
- package/dist/components/_toolbar-more.d.ts +24 -0
- package/dist/components/_toolbar-more.js +25 -0
- package/dist/components/accordion.d.ts +1 -1
- package/dist/components/accordion.js +6 -6
- package/dist/components/action-sheet.d.ts +88 -0
- package/dist/components/action-sheet.js +124 -0
- package/dist/components/alert-dialog.js +3 -1
- package/dist/components/alert.d.ts +11 -18
- package/dist/components/alert.js +9 -6
- package/dist/components/app-bar.d.ts +93 -0
- package/dist/components/app-bar.js +175 -0
- package/dist/components/audio-player.d.ts +134 -0
- package/dist/components/audio-player.js +618 -0
- package/dist/components/avatar.d.ts +6 -6
- package/dist/components/avatar.js +13 -11
- package/dist/components/badge.d.ts +12 -12
- package/dist/components/badge.js +7 -5
- package/dist/components/bottom-nav.d.ts +53 -11
- package/dist/components/bottom-nav.js +388 -23
- package/dist/components/breadcrumb.d.ts +11 -2
- package/dist/components/breadcrumb.js +60 -6
- package/dist/components/button-group.js +5 -1
- package/dist/components/button.d.ts +23 -6
- package/dist/components/button.js +63 -7
- package/dist/components/calendar.js +8 -6
- package/dist/components/card.d.ts +10 -8
- package/dist/components/card.js +15 -14
- package/dist/components/carousel.d.ts +2 -2
- package/dist/components/carousel.js +21 -8
- package/dist/components/chart.d.ts +27 -1
- package/dist/components/chart.js +15 -5
- package/dist/components/checkbox.js +2 -2
- package/dist/components/code-block.d.ts +9 -2
- package/dist/components/code-block.js +26 -7
- package/dist/components/collapsible.js +3 -3
- package/dist/components/color-picker.d.ts +2 -2
- package/dist/components/color-picker.js +5 -5
- package/dist/components/combobox.d.ts +26 -7
- package/dist/components/combobox.js +32 -13
- package/dist/components/command.d.ts +29 -5
- package/dist/components/command.js +35 -10
- package/dist/components/context-menu.d.ts +5 -2
- package/dist/components/context-menu.js +24 -3
- package/dist/components/conversation.d.ts +1 -1
- package/dist/components/conversation.js +67 -13
- package/dist/components/copy-button.d.ts +1 -1
- package/dist/components/copy-button.js +1 -1
- package/dist/components/data-table.d.ts +6 -6
- package/dist/components/data-table.js +41 -15
- package/dist/components/date-picker.d.ts +31 -9
- package/dist/components/date-picker.js +100 -18
- package/dist/components/dialog.d.ts +17 -10
- package/dist/components/dialog.js +20 -13
- package/dist/components/drawer.d.ts +26 -8
- package/dist/components/drawer.js +75 -16
- package/dist/components/drawing.d.ts +25 -0
- package/dist/components/drawing.js +32 -0
- package/dist/components/empty.js +2 -2
- package/dist/components/feature-list.d.ts +65 -13
- package/dist/components/feature-list.js +116 -15
- package/dist/components/field.js +2 -2
- package/dist/components/file-drop.d.ts +9 -7
- package/dist/components/file-drop.js +8 -43
- package/dist/components/filter-bar.d.ts +10 -9
- package/dist/components/filter-bar.js +42 -25
- package/dist/components/graph.d.ts +19 -3
- package/dist/components/graph.js +170 -25
- package/dist/components/illustration.js +3 -28
- package/dist/components/input-group.d.ts +5 -10
- package/dist/components/input-group.js +16 -16
- package/dist/components/input.d.ts +2 -2
- package/dist/components/input.js +3 -3
- package/dist/components/item.d.ts +9 -6
- package/dist/components/item.js +13 -8
- package/dist/components/kbd.d.ts +1 -1
- package/dist/components/kbd.js +1 -1
- package/dist/components/lightbox.d.ts +76 -9
- package/dist/components/lightbox.js +333 -45
- package/dist/components/locale.d.ts +6 -6
- package/dist/components/logo.d.ts +21 -1
- package/dist/components/logo.js +32 -2
- package/dist/components/markdown-editor.d.ts +275 -0
- package/dist/components/markdown-editor.js +831 -0
- package/dist/components/mentions.d.ts +153 -0
- package/dist/components/mentions.js +507 -0
- package/dist/components/menu.d.ts +2 -1
- package/dist/components/menu.js +5 -4
- package/dist/components/menubar.d.ts +23 -5
- package/dist/components/menubar.js +97 -22
- package/dist/components/message.d.ts +62 -11
- package/dist/components/message.js +49 -13
- package/dist/components/meter.js +1 -1
- package/dist/components/money-input.d.ts +1 -1
- package/dist/components/money-input.js +1 -1
- package/dist/components/native-select.d.ts +2 -2
- package/dist/components/native-select.js +4 -4
- package/dist/components/navigation-menu.d.ts +3 -1
- package/dist/components/navigation-menu.js +23 -12
- package/dist/components/number-field.d.ts +2 -9
- package/dist/components/number-field.js +86 -36
- package/dist/components/number-roll.d.ts +26 -0
- package/dist/components/number-roll.js +81 -0
- package/dist/components/otp-field.d.ts +1 -1
- package/dist/components/otp-field.js +24 -3
- package/dist/components/pagination.d.ts +11 -3
- package/dist/components/pagination.js +59 -13
- package/dist/components/pdf-viewer.d.ts +1 -1
- package/dist/components/pdf-viewer.js +8 -8
- package/dist/components/phone-input.d.ts +1 -1
- package/dist/components/phone-input.js +2 -2
- package/dist/components/popover.js +5 -3
- package/dist/components/preview-card.d.ts +37 -2
- package/dist/components/preview-card.js +226 -2
- package/dist/components/progress.js +1 -1
- package/dist/components/prompt-input.d.ts +1 -1
- package/dist/components/prompt-input.js +24 -14
- package/dist/components/pull-to-refresh.d.ts +50 -0
- package/dist/components/pull-to-refresh.js +189 -0
- package/dist/components/quote.d.ts +6 -1
- package/dist/components/quote.js +3 -2
- package/dist/components/radio-group.js +1 -1
- package/dist/components/rating.d.ts +4 -1
- package/dist/components/rating.js +131 -10
- package/dist/components/reasoning.d.ts +1 -1
- package/dist/components/reasoning.js +7 -3
- package/dist/components/resizable.d.ts +1 -1
- package/dist/components/resizable.js +2 -2
- package/dist/components/response.d.ts +1 -1
- package/dist/components/response.js +18 -6
- package/dist/components/scheduler.d.ts +352 -0
- package/dist/components/scheduler.js +1717 -0
- package/dist/components/scroll-area.js +1 -1
- package/dist/components/select.d.ts +17 -4
- package/dist/components/select.js +140 -9
- package/dist/components/separator.d.ts +1 -1
- package/dist/components/separator.js +3 -3
- package/dist/components/sidebar.d.ts +44 -3
- package/dist/components/sidebar.js +57 -17
- package/dist/components/site-header.d.ts +18 -13
- package/dist/components/site-header.js +23 -11
- package/dist/components/skeleton.d.ts +17 -7
- package/dist/components/skeleton.js +22 -7
- package/dist/components/slider.js +2 -2
- package/dist/components/sortable.d.ts +55 -4
- package/dist/components/sortable.js +172 -103
- package/dist/components/sources.d.ts +1 -1
- package/dist/components/sources.js +2 -2
- package/dist/components/spinner.d.ts +4 -4
- package/dist/components/spinner.js +4 -4
- package/dist/components/stat.d.ts +21 -4
- package/dist/components/stat.js +17 -8
- package/dist/components/stepper.d.ts +1 -1
- package/dist/components/stepper.js +8 -7
- package/dist/components/suggestions.d.ts +11 -3
- package/dist/components/suggestions.js +10 -4
- package/dist/components/swipe-actions.d.ts +66 -0
- package/dist/components/swipe-actions.js +292 -0
- package/dist/components/switch.js +1 -1
- package/dist/components/table.d.ts +12 -6
- package/dist/components/table.js +78 -30
- package/dist/components/tabs.js +7 -4
- package/dist/components/tag.d.ts +19 -20
- package/dist/components/tag.js +9 -5
- package/dist/components/tags-input.d.ts +2 -7
- package/dist/components/tags-input.js +11 -8
- package/dist/components/textarea.d.ts +3 -2
- package/dist/components/textarea.js +4 -3
- package/dist/components/theme.d.ts +49 -6
- package/dist/components/theme.js +147 -9
- package/dist/components/time-field.d.ts +4 -9
- package/dist/components/time-field.js +6 -6
- package/dist/components/timeline.d.ts +19 -3
- package/dist/components/timeline.js +21 -9
- package/dist/components/tippy.d.ts +17 -1
- package/dist/components/tippy.js +95 -15
- package/dist/components/toast.d.ts +2 -7
- package/dist/components/toast.js +12 -8
- package/dist/components/toggle-group.d.ts +7 -1
- package/dist/components/toggle-group.js +16 -5
- package/dist/components/toggle.d.ts +2 -2
- package/dist/components/toggle.js +3 -2
- package/dist/components/tool-call.d.ts +1 -1
- package/dist/components/tool-call.js +4 -4
- package/dist/components/toolbar.d.ts +57 -4
- package/dist/components/toolbar.js +216 -16
- package/dist/components/tooltip.d.ts +1 -1
- package/dist/components/tooltip.js +4 -2
- package/dist/components/tour.d.ts +1 -1
- package/dist/components/tour.js +36 -15
- package/dist/components/tree.js +5 -5
- package/dist/components/typography.d.ts +31 -8
- package/dist/components/typography.js +21 -10
- package/dist/components/video-player.d.ts +7 -2
- package/dist/components/video-player.js +121 -220
- package/dist/index.d.ts +99 -92
- package/dist/index.js +99 -92
- package/dist/lib/calendar.d.ts +153 -0
- package/dist/lib/calendar.js +312 -0
- package/dist/lib/cn.d.ts +3 -1
- package/dist/lib/cn.js +5 -0
- package/dist/lib/code-highlight.d.ts +14 -0
- package/dist/lib/code-highlight.js +81 -18
- package/dist/lib/drag.d.ts +39 -0
- package/dist/lib/drag.js +96 -0
- package/dist/lib/editorial-assets.js +16 -8
- package/dist/lib/figure/figures/automation.js +25 -6
- package/dist/lib/figure/figures/bar-chart.js +6 -1
- package/dist/lib/figure/figures/brackets-classic.js +4 -1
- package/dist/lib/figure/figures/city.js +12 -2
- package/dist/lib/figure/figures/conveyor.js +17 -4
- package/dist/lib/figure/figures/database.js +5 -2
- package/dist/lib/figure/figures/documents.js +11 -3
- package/dist/lib/figure/figures/inbox.js +5 -2
- package/dist/lib/figure/figures/laptop.js +3 -1
- package/dist/lib/figure/figures/pipeline.js +45 -10
- package/dist/lib/figure/figures/platform.js +62 -7
- package/dist/lib/figure/figures/server.js +21 -5
- package/dist/lib/figure/figures/spreadsheet.js +29 -5
- package/dist/lib/figure/kernel.d.ts +4 -2
- package/dist/lib/figure/kernel.js +10 -5
- package/dist/lib/figure/parts.js +6 -2
- package/dist/lib/files.d.ts +31 -0
- package/dist/lib/files.js +60 -0
- package/dist/lib/gesture.d.ts +70 -0
- package/dist/lib/gesture.js +141 -0
- package/dist/lib/glide.d.ts +5 -0
- package/dist/lib/glide.js +9 -1
- package/dist/lib/icons.d.ts +1 -0
- package/dist/lib/icons.js +6 -0
- package/dist/lib/illustration-library.js +1 -6
- package/dist/lib/markdown-edit.d.ts +112 -0
- package/dist/lib/markdown-edit.js +557 -0
- package/dist/lib/markdown-rich-editor.d.ts +188 -0
- package/dist/lib/markdown-rich-editor.js +1153 -0
- package/dist/lib/markdown-rich.d.ts +63 -0
- package/dist/lib/markdown-rich.js +534 -0
- package/dist/lib/mentions.d.ts +100 -0
- package/dist/lib/mentions.js +246 -0
- package/dist/lib/motion.d.ts +18 -0
- package/dist/lib/motion.js +43 -5
- package/dist/lib/number-roll.d.ts +89 -0
- package/dist/lib/number-roll.js +391 -0
- package/dist/lib/platform.d.ts +6 -0
- package/dist/lib/platform.js +14 -0
- package/dist/lib/portal-container.d.ts +9 -0
- package/dist/lib/portal-container.js +10 -0
- package/dist/lib/press.d.ts +5 -0
- package/dist/lib/press.js +186 -0
- package/dist/lib/scheduler.d.ts +128 -0
- package/dist/lib/scheduler.js +272 -0
- package/dist/lib/scroll-edges.d.ts +9 -0
- package/dist/lib/scroll-edges.js +50 -0
- package/dist/lib/table-fit.d.ts +1 -1
- package/dist/lib/table-fit.js +65 -8
- package/dist/lib/theme-preset.d.ts +267 -0
- package/dist/lib/theme-preset.js +1046 -0
- package/dist/lib/theme-script.d.ts +23 -3
- package/dist/lib/theme-script.js +17 -5
- package/dist/lib/tippy/sprite.d.ts +36 -4
- package/dist/lib/tippy/sprite.js +188 -15
- package/dist/lib/tone.d.ts +4 -0
- package/dist/lib/tone.js +1 -0
- package/dist/messages/de.d.ts +3 -3
- package/dist/messages/de.js +274 -3
- package/dist/skills/zon-ui/SKILL.md +279 -0
- package/dist/skills/zon-ui/references/authoring.md +265 -0
- package/dist/skills/zon-ui/references/brand.md +416 -0
- package/dist/skills/zon-ui/references/components/accordion.md +199 -0
- package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
- package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
- package/dist/skills/zon-ui/references/components/alert.md +167 -0
- package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
- package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
- package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
- package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
- package/dist/skills/zon-ui/references/components/avatar.md +98 -0
- package/dist/skills/zon-ui/references/components/badge.md +227 -0
- package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
- package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
- package/dist/skills/zon-ui/references/components/button-group.md +216 -0
- package/dist/skills/zon-ui/references/components/button.md +309 -0
- package/dist/skills/zon-ui/references/components/calendar.md +296 -0
- package/dist/skills/zon-ui/references/components/card.md +158 -0
- package/dist/skills/zon-ui/references/components/carousel.md +297 -0
- package/dist/skills/zon-ui/references/components/chart.md +739 -0
- package/dist/skills/zon-ui/references/components/chat.md +417 -0
- package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
- package/dist/skills/zon-ui/references/components/code-block.md +143 -0
- package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
- package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
- package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
- package/dist/skills/zon-ui/references/components/combobox.md +455 -0
- package/dist/skills/zon-ui/references/components/command.md +326 -0
- package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
- package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
- package/dist/skills/zon-ui/references/components/conversation.md +146 -0
- package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
- package/dist/skills/zon-ui/references/components/crm.md +1022 -0
- package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
- package/dist/skills/zon-ui/references/components/data-table.md +776 -0
- package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
- package/dist/skills/zon-ui/references/components/dialog.md +335 -0
- package/dist/skills/zon-ui/references/components/direction.md +165 -0
- package/dist/skills/zon-ui/references/components/drawer.md +276 -0
- package/dist/skills/zon-ui/references/components/drawing.md +94 -0
- package/dist/skills/zon-ui/references/components/empty.md +225 -0
- package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
- package/dist/skills/zon-ui/references/components/field.md +209 -0
- package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
- package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
- package/dist/skills/zon-ui/references/components/form.md +970 -0
- package/dist/skills/zon-ui/references/components/graph.md +339 -0
- package/dist/skills/zon-ui/references/components/illustration.md +497 -0
- package/dist/skills/zon-ui/references/components/inbox.md +263 -0
- package/dist/skills/zon-ui/references/components/input-group.md +339 -0
- package/dist/skills/zon-ui/references/components/input.md +189 -0
- package/dist/skills/zon-ui/references/components/item.md +277 -0
- package/dist/skills/zon-ui/references/components/kanban.md +626 -0
- package/dist/skills/zon-ui/references/components/kbd.md +116 -0
- package/dist/skills/zon-ui/references/components/label.md +104 -0
- package/dist/skills/zon-ui/references/components/layout.md +291 -0
- package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
- package/dist/skills/zon-ui/references/components/locale.md +279 -0
- package/dist/skills/zon-ui/references/components/logo.md +257 -0
- package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
- package/dist/skills/zon-ui/references/components/mentions.md +512 -0
- package/dist/skills/zon-ui/references/components/menu.md +218 -0
- package/dist/skills/zon-ui/references/components/menubar.md +292 -0
- package/dist/skills/zon-ui/references/components/message.md +243 -0
- package/dist/skills/zon-ui/references/components/meter.md +105 -0
- package/dist/skills/zon-ui/references/components/money-input.md +333 -0
- package/dist/skills/zon-ui/references/components/native-select.md +197 -0
- package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
- package/dist/skills/zon-ui/references/components/number-field.md +210 -0
- package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
- package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
- package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
- package/dist/skills/zon-ui/references/components/pagination.md +109 -0
- package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
- package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
- package/dist/skills/zon-ui/references/components/popover.md +176 -0
- package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
- package/dist/skills/zon-ui/references/components/pricing.md +724 -0
- package/dist/skills/zon-ui/references/components/progress.md +92 -0
- package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
- package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
- package/dist/skills/zon-ui/references/components/quote.md +115 -0
- package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
- package/dist/skills/zon-ui/references/components/rating.md +260 -0
- package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
- package/dist/skills/zon-ui/references/components/resizable.md +213 -0
- package/dist/skills/zon-ui/references/components/response.md +170 -0
- package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
- package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
- package/dist/skills/zon-ui/references/components/select.md +351 -0
- package/dist/skills/zon-ui/references/components/separator.md +103 -0
- package/dist/skills/zon-ui/references/components/settings.md +793 -0
- package/dist/skills/zon-ui/references/components/shop.md +1715 -0
- package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
- package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
- package/dist/skills/zon-ui/references/components/site-header.md +303 -0
- package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
- package/dist/skills/zon-ui/references/components/slider.md +172 -0
- package/dist/skills/zon-ui/references/components/sortable.md +405 -0
- package/dist/skills/zon-ui/references/components/sources.md +106 -0
- package/dist/skills/zon-ui/references/components/spinner.md +222 -0
- package/dist/skills/zon-ui/references/components/stat.md +267 -0
- package/dist/skills/zon-ui/references/components/stepper.md +285 -0
- package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
- package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
- package/dist/skills/zon-ui/references/components/switch.md +160 -0
- package/dist/skills/zon-ui/references/components/table.md +999 -0
- package/dist/skills/zon-ui/references/components/tabs.md +258 -0
- package/dist/skills/zon-ui/references/components/tag.md +115 -0
- package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
- package/dist/skills/zon-ui/references/components/textarea.md +95 -0
- package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
- package/dist/skills/zon-ui/references/components/theme.md +362 -0
- package/dist/skills/zon-ui/references/components/time-field.md +222 -0
- package/dist/skills/zon-ui/references/components/timeline.md +285 -0
- package/dist/skills/zon-ui/references/components/tippy.md +243 -0
- package/dist/skills/zon-ui/references/components/toast.md +220 -0
- package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
- package/dist/skills/zon-ui/references/components/toggle.md +167 -0
- package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
- package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
- package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
- package/dist/skills/zon-ui/references/components/tour.md +423 -0
- package/dist/skills/zon-ui/references/components/tree.md +481 -0
- package/dist/skills/zon-ui/references/components/typography.md +347 -0
- package/dist/skills/zon-ui/references/components/video-player.md +386 -0
- package/dist/skills/zon-ui/references/marketing.md +467 -0
- package/dist/skills/zon-ui/references/motion.md +455 -0
- package/dist/skills/zon-ui/references/recipes.md +1232 -0
- package/dist/skills/zon-ui/references/tokens.md +866 -0
- package/dist/sources/accordion.css +4 -0
- package/dist/sources/action-sheet.css +11 -0
- package/dist/sources/alert-dialog.css +6 -0
- package/dist/sources/alert.css +3 -0
- package/dist/sources/app-bar.css +14 -0
- package/dist/sources/ascii-field.css +3 -0
- package/dist/sources/aspect-ratio.css +3 -0
- package/dist/sources/audio-player.css +20 -0
- package/dist/sources/avatar.css +3 -0
- package/dist/sources/badge.css +3 -0
- package/dist/sources/bottom-nav.css +9 -0
- package/dist/sources/breadcrumb.css +14 -0
- package/dist/sources/button-group.css +3 -0
- package/dist/sources/button.css +9 -0
- package/dist/sources/calendar.css +13 -0
- package/dist/sources/card.css +3 -0
- package/dist/sources/carousel.css +11 -0
- package/dist/sources/chart.css +5 -0
- package/dist/sources/checkbox.css +6 -0
- package/dist/sources/code-block.css +13 -0
- package/dist/sources/collapsible.css +4 -0
- package/dist/sources/color-picker.css +13 -0
- package/dist/sources/combobox.css +13 -0
- package/dist/sources/command.css +13 -0
- package/dist/sources/context-menu.css +12 -0
- package/dist/sources/conversation.css +10 -0
- package/dist/sources/copy-button.css +10 -0
- package/dist/sources/data-table.css +27 -0
- package/dist/sources/date-picker.css +20 -0
- package/dist/sources/dialog.css +9 -0
- package/dist/sources/direction.css +2 -0
- package/dist/sources/drawer.css +9 -0
- package/dist/sources/drawing.css +5 -0
- package/dist/sources/empty.css +3 -0
- package/dist/sources/feature-list.css +4 -0
- package/dist/sources/field.css +4 -0
- package/dist/sources/file-drop.css +15 -0
- package/dist/sources/filter-bar.css +30 -0
- package/dist/sources/form.css +4 -0
- package/dist/sources/graph.css +19 -0
- package/dist/sources/illustration.css +28 -0
- package/dist/sources/input-group.css +7 -0
- package/dist/sources/input.css +3 -0
- package/dist/sources/item.css +4 -0
- package/dist/sources/kbd.css +5 -0
- package/dist/sources/label.css +3 -0
- package/dist/sources/layout.css +3 -0
- package/dist/sources/lightbox.css +33 -0
- package/dist/sources/locale.css +2 -0
- package/dist/sources/logo.css +4 -0
- package/dist/sources/markdown-editor.css +41 -0
- package/dist/sources/mentions.css +13 -0
- package/dist/sources/menu.css +11 -0
- package/dist/sources/menubar.css +14 -0
- package/dist/sources/message.css +16 -0
- package/dist/sources/meter.css +4 -0
- package/dist/sources/money-input.css +10 -0
- package/dist/sources/native-select.css +4 -0
- package/dist/sources/navigation-menu.css +8 -0
- package/dist/sources/number-field.css +8 -0
- package/dist/sources/number-roll.css +6 -0
- package/dist/sources/otp-field.css +5 -0
- package/dist/sources/pagination.css +11 -0
- package/dist/sources/pdf-viewer.css +30 -0
- package/dist/sources/phone-input.css +20 -0
- package/dist/sources/popover.css +7 -0
- package/dist/sources/preview-card.css +7 -0
- package/dist/sources/progress.css +4 -0
- package/dist/sources/prompt-input.css +15 -0
- package/dist/sources/pull-to-refresh.css +14 -0
- package/dist/sources/quote.css +3 -0
- package/dist/sources/radio-group.css +5 -0
- package/dist/sources/rating.css +6 -0
- package/dist/sources/reasoning.css +6 -0
- package/dist/sources/resizable.css +4 -0
- package/dist/sources/response.css +16 -0
- package/dist/sources/scheduler.css +44 -0
- package/dist/sources/scroll-area.css +3 -0
- package/dist/sources/select.css +12 -0
- package/dist/sources/separator.css +3 -0
- package/dist/sources/sidebar.css +19 -0
- package/dist/sources/site-header.css +15 -0
- package/dist/sources/skeleton.css +3 -0
- package/dist/sources/slider.css +6 -0
- package/dist/sources/sortable.css +12 -0
- package/dist/sources/sources.css +6 -0
- package/dist/sources/spinner.css +6 -0
- package/dist/sources/stat.css +9 -0
- package/dist/sources/stepper.css +6 -0
- package/dist/sources/suggestions.css +10 -0
- package/dist/sources/swipe-actions.css +20 -0
- package/dist/sources/switch.css +5 -0
- package/dist/sources/table.css +7 -0
- package/dist/sources/tabs.css +5 -0
- package/dist/sources/tag.css +3 -0
- package/dist/sources/tags-input.css +6 -0
- package/dist/sources/textarea.css +3 -0
- package/dist/sources/theme.css +13 -0
- package/dist/sources/time-field.css +7 -0
- package/dist/sources/timeline.css +7 -0
- package/dist/sources/tippy.css +6 -0
- package/dist/sources/toast.css +6 -0
- package/dist/sources/toggle-group.css +5 -0
- package/dist/sources/toggle.css +3 -0
- package/dist/sources/tool-call.css +16 -0
- package/dist/sources/toolbar.css +14 -0
- package/dist/sources/tooltip.css +6 -0
- package/dist/sources/tour.css +14 -0
- package/dist/sources/tree.css +6 -0
- package/dist/sources/typography.css +4 -0
- package/dist/sources/video-player.css +21 -0
- package/dist/styles/ai.css +3 -0
- package/dist/styles/brand.css +98 -0
- package/dist/styles/core.css +266 -0
- package/dist/styles/editor.css +3 -0
- package/dist/styles/expressive.css +35 -56
- package/dist/styles/fonts.css +61 -117
- package/dist/styles/graph.css +4 -0
- package/dist/styles/illustration.css +4 -0
- package/dist/styles/index.css +11 -201
- package/dist/styles/material.css +138 -12
- package/dist/styles/parts/ai.css +18 -13
- package/dist/styles/parts/brand.css +2 -2
- package/dist/styles/parts/controls.css +29 -20
- package/dist/styles/parts/data.css +13 -9
- package/dist/styles/parts/editor.css +372 -0
- package/dist/styles/parts/feedback.css +32 -2
- package/dist/styles/parts/foundations.css +12 -7
- package/dist/styles/parts/graph.css +25 -9
- package/dist/styles/parts/inputs.css +172 -9
- package/dist/styles/parts/isometric.css +6 -5
- package/dist/styles/parts/navigation.css +206 -27
- package/dist/styles/parts/overlays.css +19 -4
- package/dist/styles/parts/pdf.css +2 -2
- package/dist/styles/pdf.css +3 -0
- package/dist/styles/prose.css +3 -0
- package/dist/styles/tokens.css +89 -14
- package/dist/theme.d.ts +1 -0
- package/dist/theme.js +5 -0
- package/dist/vite.d.ts +48 -59
- package/dist/vite.js +54 -21
- package/package.json +69 -2
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
# Scroll area
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { ScrollArea } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
const notes = [
|
|
7
|
+
"Outline: twelve chapters, two points of view.",
|
|
8
|
+
"First draft of chapters one to four.",
|
|
9
|
+
"Writing group: the start is slow, the ending lands.",
|
|
10
|
+
"Rewrote chapter one to open on the storm.",
|
|
11
|
+
"First draft of chapters five to twelve.",
|
|
12
|
+
"Read the whole draft aloud; cut 6,000 words.",
|
|
13
|
+
"Copy-edit back with 212 notes, most of them commas.",
|
|
14
|
+
"Next: a cover brief, and a title everyone can live with.",
|
|
15
|
+
];
|
|
16
|
+
|
|
17
|
+
export function Vertical() {
|
|
18
|
+
return (
|
|
19
|
+
<ScrollArea className="h-56 max-w-md border-y border-border/60" contentClassName="py-4 pr-4">
|
|
20
|
+
<ol className="m-0 flex list-none flex-col gap-4 p-0">
|
|
21
|
+
{notes.map((note, i) => (
|
|
22
|
+
<li key={note} className="flex gap-4 text-[15px] text-foreground-soft">
|
|
23
|
+
<span className="font-mono text-[12px] text-muted-foreground tabular-nums">
|
|
24
|
+
{String(i + 1).padStart(2, "0")}
|
|
25
|
+
</span>
|
|
26
|
+
{note}
|
|
27
|
+
</li>
|
|
28
|
+
))}
|
|
29
|
+
</ol>
|
|
30
|
+
</ScrollArea>
|
|
31
|
+
);
|
|
32
|
+
}
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
A bounded region with a quiet scrollbar — a 4px round `--field-edge` thumb, shown on hover or while scrolling — and edges that fade where there is more, growing as you scroll away and gone at the end.
|
|
36
|
+
|
|
37
|
+
## Usage
|
|
38
|
+
|
|
39
|
+
```tsx
|
|
40
|
+
import { ScrollArea } from "@zonsh/ui";
|
|
41
|
+
|
|
42
|
+
<ScrollArea className="h-64">…</ScrollArea>;
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
The props you'll reach for: a height on `className` (`h-*` or `max-h-*`), `orientation`, and `scrollbar={false}` for sidebars.
|
|
46
|
+
|
|
47
|
+
## When to use
|
|
48
|
+
|
|
49
|
+
- Bounded panels: a sidebar list, a changelog in a card, a wide table, a code listing.
|
|
50
|
+
- Not for the main page, and never nested in another scroll area.
|
|
51
|
+
- Sidebars scroll without a bar (`scrollbar={false}`); the fade is the cue.
|
|
52
|
+
- Select, Combobox and Command lists already scroll in one, rendered as the viewport (`viewportRender`) so the highlighted option still scrolls into view.
|
|
53
|
+
|
|
54
|
+
Native scrollbars (the page, `overflow-auto` panels) are styled thin with a `--field-edge` thumb, but stay visible and have no fade.
|
|
55
|
+
|
|
56
|
+
## Examples
|
|
57
|
+
|
|
58
|
+
### Horizontal
|
|
59
|
+
|
|
60
|
+
```tsx
|
|
61
|
+
import { ScrollArea, Tag } from "@zonsh/ui";
|
|
62
|
+
|
|
63
|
+
const stack = [
|
|
64
|
+
"Landscape",
|
|
65
|
+
"Portrait",
|
|
66
|
+
"Black and white",
|
|
67
|
+
"Film",
|
|
68
|
+
"Night",
|
|
69
|
+
"Street",
|
|
70
|
+
"Travel",
|
|
71
|
+
"Architecture",
|
|
72
|
+
"Macro",
|
|
73
|
+
"Long exposure",
|
|
74
|
+
"Archive",
|
|
75
|
+
];
|
|
76
|
+
|
|
77
|
+
export function Horizontal() {
|
|
78
|
+
return (
|
|
79
|
+
<ScrollArea orientation="horizontal" className="max-w-sm" contentClassName="py-3">
|
|
80
|
+
<div className="flex w-max gap-2">
|
|
81
|
+
{stack.map((item) => (
|
|
82
|
+
<Tag key={item}>{item}</Tag>
|
|
83
|
+
))}
|
|
84
|
+
</div>
|
|
85
|
+
</ScrollArea>
|
|
86
|
+
);
|
|
87
|
+
}
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
## Props
|
|
91
|
+
|
|
92
|
+
| Prop | Type | Default |
|
|
93
|
+
| ----------------------- | ------------------------------------------------------- | ------------ |
|
|
94
|
+
| `orientation` | `"vertical" \| "horizontal" \| "both"` | `"vertical"` |
|
|
95
|
+
| `fade` | `boolean` | `true` |
|
|
96
|
+
| `scrollbar` | `boolean` — `false` for sidebars | `true` |
|
|
97
|
+
| `viewportClassName` | `string` | — |
|
|
98
|
+
| `contentClassName` | `string` | — |
|
|
99
|
+
| `viewportRender` | `ReactElement` — render the viewport as another part, e.g. a list | — |
|
|
100
|
+
| `overflowEdgeThreshold` | Base UI — distance before an edge counts as overflowing | `0` |
|
|
101
|
+
|
|
102
|
+
Other Base UI `ScrollArea.Root` props are forwarded. The fade is `--scroll-fade` (24px) on the viewport. A `vertical` area keeps content to its width, so rows wrap or truncate; sideways scrolling needs `horizontal` or `both`.
|
|
103
|
+
|
|
104
|
+
## Brand rules
|
|
105
|
+
|
|
106
|
+
- **Do** give the area a clear boundary — a `Card` (`card` or `region`) or a sidebar column.
|
|
107
|
+
- **Do** put padding on the content (`contentClassName`), not on the root.
|
|
108
|
+
- **Don't** colour the thumb or make it thicker.
|
|
109
|
+
- **Don't** give a sidebar a scrollbar. Pass `scrollbar={false}` and keep `fade` on.
|
|
110
|
+
- **Don't** hide content people must see inside a short scroll area.
|
|
111
|
+
|
|
112
|
+
## Accessibility
|
|
113
|
+
|
|
114
|
+
- The viewport is keyboard-scrollable and shows the flush focus outline when focused.
|
|
115
|
+
- Native scrolling is preserved: wheel, touch, keyboard and assistive technology all work.
|
|
116
|
+
- The fade is a mask only; it never hides content from screen readers.
|
|
117
|
+
|
|
118
|
+
---
|
|
119
|
+
|
|
120
|
+
- Import: `import { ScrollArea } from "@zonsh/ui"`
|
|
121
|
+
- Source: `packages/ui/src/components/scroll-area.tsx`
|
|
122
|
+
- Primitive: `@base-ui/react/scroll-area` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/scroll-area.md`)
|
|
@@ -0,0 +1,351 @@
|
|
|
1
|
+
# Select
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Field, FieldDescription, FieldLabel, Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
const topics = [
|
|
7
|
+
{ value: "drawing", label: "Drawing" },
|
|
8
|
+
{ value: "photography", label: "Photography" },
|
|
9
|
+
{ value: "typography", label: "Typography" },
|
|
10
|
+
{ value: "writing", label: "Writing" },
|
|
11
|
+
{ value: "unsure", label: "Not sure yet" },
|
|
12
|
+
];
|
|
13
|
+
|
|
14
|
+
export function Basic() {
|
|
15
|
+
return (
|
|
16
|
+
<Field className="max-w-sm">
|
|
17
|
+
<FieldLabel>What would you like to learn?</FieldLabel>
|
|
18
|
+
<Select items={topics}>
|
|
19
|
+
<SelectTrigger>
|
|
20
|
+
<SelectValue placeholder="Choose the closest fit" />
|
|
21
|
+
</SelectTrigger>
|
|
22
|
+
<SelectContent>
|
|
23
|
+
{topics.map((topic) => (
|
|
24
|
+
<SelectItem key={topic.value} value={topic.value}>
|
|
25
|
+
{topic.label}
|
|
26
|
+
</SelectItem>
|
|
27
|
+
))}
|
|
28
|
+
</SelectContent>
|
|
29
|
+
</Select>
|
|
30
|
+
<FieldDescription>We use it to suggest a first course. You can change it any time.</FieldDescription>
|
|
31
|
+
</Field>
|
|
32
|
+
);
|
|
33
|
+
}
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
A recessed trigger — 10px corners, 38px (30px with `size="sm"`), a two-way chevron — opening a 12px menu-material list below it (`popup-motion`), at least as wide. Items are 38px with 7px corners, lift when highlighted, and the chosen one has a check at the end (the left, right to left).
|
|
37
|
+
|
|
38
|
+
## Usage
|
|
39
|
+
|
|
40
|
+
```tsx
|
|
41
|
+
import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@zonsh/ui";
|
|
42
|
+
|
|
43
|
+
<Select items={topics}>
|
|
44
|
+
<SelectTrigger>
|
|
45
|
+
<SelectValue placeholder="Choose the closest fit" />
|
|
46
|
+
</SelectTrigger>
|
|
47
|
+
<SelectContent>
|
|
48
|
+
{topics.map((topic) => (
|
|
49
|
+
<SelectItem key={topic.value} value={topic.value}>
|
|
50
|
+
{topic.label}
|
|
51
|
+
</SelectItem>
|
|
52
|
+
))}
|
|
53
|
+
</SelectContent>
|
|
54
|
+
</Select>;
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
- `items` (`{ value, label }[]`) — so `SelectValue` shows the chosen label.
|
|
58
|
+
- `value` / `defaultValue`, `onValueChange` — `multiple` makes the value an array.
|
|
59
|
+
- `placeholder` on `SelectValue`.
|
|
60
|
+
|
|
61
|
+
## When to use
|
|
62
|
+
|
|
63
|
+
- One choice from 5–15 options. On a phone it opens the platform's own picker by default (see On phones).
|
|
64
|
+
- `multiple` for several from a short list. Many options, or chips: `Combobox` with `multiple`.
|
|
65
|
+
- 2–5 short options to compare: `ToggleGroup`. More than ~15: `Combobox`, which also draws only the options in view — a Select with a thousand takes most of a second to open.
|
|
66
|
+
|
|
67
|
+
## Examples
|
|
68
|
+
|
|
69
|
+
### Dense
|
|
70
|
+
|
|
71
|
+
For filter bars and tables; items stay 38px.
|
|
72
|
+
|
|
73
|
+
```tsx
|
|
74
|
+
import { Field, FieldLabel, Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@zonsh/ui";
|
|
75
|
+
|
|
76
|
+
const statuses = [
|
|
77
|
+
{ value: "all", label: "All statuses" },
|
|
78
|
+
{ value: "running", label: "Running" },
|
|
79
|
+
{ value: "paused", label: "Paused" },
|
|
80
|
+
{ value: "failed", label: "Failed" },
|
|
81
|
+
];
|
|
82
|
+
|
|
83
|
+
export function Dense() {
|
|
84
|
+
return (
|
|
85
|
+
<Field className="max-w-48">
|
|
86
|
+
<FieldLabel>Status</FieldLabel>
|
|
87
|
+
<Select items={statuses} defaultValue="all">
|
|
88
|
+
<SelectTrigger size="sm">
|
|
89
|
+
<SelectValue />
|
|
90
|
+
</SelectTrigger>
|
|
91
|
+
<SelectContent>
|
|
92
|
+
{statuses.map((status) => (
|
|
93
|
+
<SelectItem key={status.value} value={status.value}>
|
|
94
|
+
{status.label}
|
|
95
|
+
</SelectItem>
|
|
96
|
+
))}
|
|
97
|
+
</SelectContent>
|
|
98
|
+
</Select>
|
|
99
|
+
</Field>
|
|
100
|
+
);
|
|
101
|
+
}
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
### Over the trigger
|
|
105
|
+
|
|
106
|
+
`alignItemWithTrigger` lays the chosen option exactly on the value, as macOS does — for short lists of settings. Opened by touch, or near the window's edge, it opens below.
|
|
107
|
+
|
|
108
|
+
```tsx
|
|
109
|
+
import { Field, FieldLabel, Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@zonsh/ui";
|
|
110
|
+
|
|
111
|
+
const fonts = [
|
|
112
|
+
{ value: "licht", label: "Licht" },
|
|
113
|
+
{ value: "licht-sans", label: "Licht Sans" },
|
|
114
|
+
{ value: "licht-mono", label: "Licht Mono" },
|
|
115
|
+
{ value: "system", label: "System font" },
|
|
116
|
+
];
|
|
117
|
+
|
|
118
|
+
/** Opens over the trigger, the chosen option laid on the value. With a mouse; touch opens below. */
|
|
119
|
+
export function OverTheTrigger() {
|
|
120
|
+
return (
|
|
121
|
+
<Field className="max-w-48">
|
|
122
|
+
<FieldLabel>Reading font</FieldLabel>
|
|
123
|
+
<Select items={fonts} defaultValue="licht-sans">
|
|
124
|
+
<SelectTrigger>
|
|
125
|
+
<SelectValue />
|
|
126
|
+
</SelectTrigger>
|
|
127
|
+
<SelectContent alignItemWithTrigger>
|
|
128
|
+
{fonts.map((font) => (
|
|
129
|
+
<SelectItem key={font.value} value={font.value}>
|
|
130
|
+
{font.label}
|
|
131
|
+
</SelectItem>
|
|
132
|
+
))}
|
|
133
|
+
</SelectContent>
|
|
134
|
+
</Select>
|
|
135
|
+
</Field>
|
|
136
|
+
);
|
|
137
|
+
}
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
### Multiple
|
|
141
|
+
|
|
142
|
+
The list stays open while people pick. A function child of `SelectValue` writes the trigger's text — here the first choice and a count.
|
|
143
|
+
|
|
144
|
+
```tsx
|
|
145
|
+
import { Field, FieldDescription, FieldLabel, Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@zonsh/ui";
|
|
146
|
+
|
|
147
|
+
// topics: as in the first example on this page that uses them.
|
|
148
|
+
|
|
149
|
+
const labels: Record<string, string> = Object.fromEntries(topics.map((topic) => [topic.value, topic.label]));
|
|
150
|
+
|
|
151
|
+
/** The first choice by name, the rest as a count, so the trigger keeps one line. */
|
|
152
|
+
function chosen(value: string[]) {
|
|
153
|
+
if (value.length === 0) return "Choose any that apply";
|
|
154
|
+
const more = value.length > 1 ? ` +${value.length - 1}` : "";
|
|
155
|
+
return `${labels[value[0]!]}${more}`;
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
export function Multiple() {
|
|
159
|
+
return (
|
|
160
|
+
<Field className="max-w-sm">
|
|
161
|
+
<FieldLabel>Interests</FieldLabel>
|
|
162
|
+
<Select items={topics} multiple defaultValue={["drawing", "typography"]}>
|
|
163
|
+
<SelectTrigger>
|
|
164
|
+
<SelectValue>{chosen}</SelectValue>
|
|
165
|
+
</SelectTrigger>
|
|
166
|
+
<SelectContent>
|
|
167
|
+
{topics.map((topic) => (
|
|
168
|
+
<SelectItem key={topic.value} value={topic.value}>
|
|
169
|
+
{topic.label}
|
|
170
|
+
</SelectItem>
|
|
171
|
+
))}
|
|
172
|
+
</SelectContent>
|
|
173
|
+
</Select>
|
|
174
|
+
<FieldDescription>
|
|
175
|
+
The list stays open while you pick; press Escape or click outside to close it.
|
|
176
|
+
</FieldDescription>
|
|
177
|
+
</Field>
|
|
178
|
+
);
|
|
179
|
+
}
|
|
180
|
+
```
|
|
181
|
+
|
|
182
|
+
### Grouped
|
|
183
|
+
|
|
184
|
+
```tsx
|
|
185
|
+
import { Field, FieldLabel, Select, SelectContent, SelectGroup, SelectGroupLabel, SelectItem, SelectSeparator, SelectTrigger, SelectValue } from "@zonsh/ui";
|
|
186
|
+
|
|
187
|
+
const slots = [
|
|
188
|
+
{ value: "mon-am", label: "Monday morning" },
|
|
189
|
+
{ value: "mon-pm", label: "Monday afternoon" },
|
|
190
|
+
{ value: "wed-am", label: "Wednesday morning" },
|
|
191
|
+
{ value: "wed-pm", label: "Wednesday afternoon" },
|
|
192
|
+
{ value: "any", label: "Any time works" },
|
|
193
|
+
];
|
|
194
|
+
|
|
195
|
+
export function Grouped() {
|
|
196
|
+
return (
|
|
197
|
+
<Field className="max-w-sm">
|
|
198
|
+
<FieldLabel>Delivery window</FieldLabel>
|
|
199
|
+
<Select items={slots}>
|
|
200
|
+
<SelectTrigger>
|
|
201
|
+
<SelectValue placeholder="Pick a slot" />
|
|
202
|
+
</SelectTrigger>
|
|
203
|
+
<SelectContent>
|
|
204
|
+
<SelectGroup>
|
|
205
|
+
<SelectGroupLabel>Monday</SelectGroupLabel>
|
|
206
|
+
<SelectItem value="mon-am">Monday morning</SelectItem>
|
|
207
|
+
<SelectItem value="mon-pm">Monday afternoon</SelectItem>
|
|
208
|
+
</SelectGroup>
|
|
209
|
+
<SelectGroup>
|
|
210
|
+
<SelectGroupLabel>Wednesday</SelectGroupLabel>
|
|
211
|
+
<SelectItem value="wed-am">Wednesday morning</SelectItem>
|
|
212
|
+
<SelectItem value="wed-pm">Wednesday afternoon</SelectItem>
|
|
213
|
+
</SelectGroup>
|
|
214
|
+
<SelectSeparator />
|
|
215
|
+
<SelectItem value="any">Any time works</SelectItem>
|
|
216
|
+
</SelectContent>
|
|
217
|
+
</Select>
|
|
218
|
+
</Field>
|
|
219
|
+
);
|
|
220
|
+
}
|
|
221
|
+
```
|
|
222
|
+
|
|
223
|
+
### On phones
|
|
224
|
+
|
|
225
|
+
Custom popup on the desktop, the platform's picker on a phone: by default (`native="touch"`) a Select renders a real `<select>` (a `NativeSelect`) on a coarse pointer under 768px wide; `native` uses it everywhere, and `native={false}` keeps the popup on phones too — for a list whose rows need icons or descriptions that `items` can't say. Same API — `items`, `value`, `defaultValue`, `onValueChange`, `name`, `required`, `disabled`, `Field`; size, width and `aria-*` from `SelectTrigger`, placeholder from `SelectValue`, groups from grouped `items`. It needs text labels: `multiple` or element labels keep the popup. `Select` holds the value, so it survives a phone turning. Element labels in `items` keep the popup on their own.
|
|
226
|
+
|
|
227
|
+
```tsx
|
|
228
|
+
import { Field, FieldDescription, FieldLabel, Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@zonsh/ui";
|
|
229
|
+
|
|
230
|
+
// topics: as in the first example on this page that uses them.
|
|
231
|
+
|
|
232
|
+
/** On a phone the platform's own picker opens (the default, `native="touch"`); elsewhere the popup. */
|
|
233
|
+
export function NativeOnPhones() {
|
|
234
|
+
return (
|
|
235
|
+
<Field className="max-w-sm">
|
|
236
|
+
<FieldLabel>What would you like to learn?</FieldLabel>
|
|
237
|
+
<Select items={topics} defaultValue="typography">
|
|
238
|
+
<SelectTrigger>
|
|
239
|
+
<SelectValue placeholder="Choose the closest fit" />
|
|
240
|
+
</SelectTrigger>
|
|
241
|
+
<SelectContent>
|
|
242
|
+
{topics.map((topic) => (
|
|
243
|
+
<SelectItem key={topic.value} value={topic.value}>
|
|
244
|
+
{topic.label}
|
|
245
|
+
</SelectItem>
|
|
246
|
+
))}
|
|
247
|
+
</SelectContent>
|
|
248
|
+
</Select>
|
|
249
|
+
<FieldDescription>Open it on a phone: the list is the phone's own.</FieldDescription>
|
|
250
|
+
</Field>
|
|
251
|
+
);
|
|
252
|
+
}
|
|
253
|
+
```
|
|
254
|
+
|
|
255
|
+
### States
|
|
256
|
+
|
|
257
|
+
```tsx
|
|
258
|
+
import { Field, FieldError, FieldLabel, Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@zonsh/ui";
|
|
259
|
+
|
|
260
|
+
// topics: as in the first example on this page that uses them.
|
|
261
|
+
|
|
262
|
+
export function States() {
|
|
263
|
+
return (
|
|
264
|
+
<div className="flex w-full max-w-sm flex-col gap-4">
|
|
265
|
+
<Field disabled>
|
|
266
|
+
<FieldLabel>Disabled</FieldLabel>
|
|
267
|
+
<Select items={topics} defaultValue="photography">
|
|
268
|
+
<SelectTrigger>
|
|
269
|
+
<SelectValue />
|
|
270
|
+
</SelectTrigger>
|
|
271
|
+
<SelectContent>
|
|
272
|
+
{topics.map((topic) => (
|
|
273
|
+
<SelectItem key={topic.value} value={topic.value}>
|
|
274
|
+
{topic.label}
|
|
275
|
+
</SelectItem>
|
|
276
|
+
))}
|
|
277
|
+
</SelectContent>
|
|
278
|
+
</Select>
|
|
279
|
+
</Field>
|
|
280
|
+
<Field invalid>
|
|
281
|
+
<FieldLabel>Invalid</FieldLabel>
|
|
282
|
+
<Select items={topics}>
|
|
283
|
+
<SelectTrigger>
|
|
284
|
+
<SelectValue placeholder="Choose the closest fit" />
|
|
285
|
+
</SelectTrigger>
|
|
286
|
+
<SelectContent>
|
|
287
|
+
{topics.map((topic) => (
|
|
288
|
+
<SelectItem key={topic.value} value={topic.value}>
|
|
289
|
+
{topic.label}
|
|
290
|
+
</SelectItem>
|
|
291
|
+
))}
|
|
292
|
+
</SelectContent>
|
|
293
|
+
</Select>
|
|
294
|
+
<FieldError match>Pick one. "Not sure yet" is a fine answer.</FieldError>
|
|
295
|
+
</Field>
|
|
296
|
+
</div>
|
|
297
|
+
);
|
|
298
|
+
}
|
|
299
|
+
```
|
|
300
|
+
|
|
301
|
+
## Props
|
|
302
|
+
|
|
303
|
+
| Component | Prop | Type | Default |
|
|
304
|
+
| --------------- | ---------------------- | -------------------------------------------------------------------- | --------------- |
|
|
305
|
+
| `Select` | `native` | `boolean \| "touch"` — a native `<select>`; `"touch"` on phones only | `"touch"` |
|
|
306
|
+
| `SelectTrigger` | `size` | `"sm" \| "default"` | `"default"` |
|
|
307
|
+
| `SelectValue` | `placeholder` | `ReactNode` | — |
|
|
308
|
+
| `SelectValue` | `children` | `ReactNode \| (value) => ReactNode` | the label(s) |
|
|
309
|
+
| `SelectContent` | `alignItemWithTrigger` | `boolean` — open over the trigger | `false` |
|
|
310
|
+
| `SelectContent` | `positioner` | Base UI `Positioner` props (`side`, `align`, `sideOffset`) | `sideOffset: 6` |
|
|
311
|
+
|
|
312
|
+
`Select` is Base UI's `Select.Root` and takes `items`, `value`, `defaultValue`, `onValueChange`, `multiple`, `name`, `required` and `disabled`. The trigger fills its column (`w-full`, `min-w-40`); for a narrow one — a page size, a unit — set `className="w-20 min-w-0"`. Data attributes: trigger `data-popup-open`, `data-invalid`, `data-disabled`; item `data-highlighted`, `data-selected`.
|
|
313
|
+
|
|
314
|
+
## Brand rules
|
|
315
|
+
|
|
316
|
+
- **Do** write a placeholder that helps ("Choose the closest fit"), and offer "Not sure yet" when that is honest.
|
|
317
|
+
- **Do** keep items at 38px with 7px corners. A long option wraps to two lines, then ends in "…"; the popup grows past the trigger only up to 24rem.
|
|
318
|
+
- **Don't** restyle the popup with a different radius, a heavier shadow or a flat fill.
|
|
319
|
+
- **Don't** hide two or three options in a select; use `ToggleGroup` or `RadioGroup`.
|
|
320
|
+
|
|
321
|
+
## Accessibility
|
|
322
|
+
|
|
323
|
+
- The trigger is a button with `aria-haspopup="listbox"`; the list is a `listbox` of `option`s, `aria-multiselectable` with `multiple`.
|
|
324
|
+
- Label it with `FieldLabel` in a `Field`; invalid shows the destructive border, ring and a `FieldError`.
|
|
325
|
+
|
|
326
|
+
### Keyboard
|
|
327
|
+
|
|
328
|
+
On the closed trigger:
|
|
329
|
+
|
|
330
|
+
| Key | What it does |
|
|
331
|
+
| --------------------- | ---------------------------------------------------------------------------------------------------------- |
|
|
332
|
+
| Enter / Space / ↓ / ↑ | Opens the list with the chosen option highlighted |
|
|
333
|
+
| Typing | Chooses the next option that starts with the letters typed, without opening the list (not with `multiple`) |
|
|
334
|
+
|
|
335
|
+
In the open list:
|
|
336
|
+
|
|
337
|
+
| Key | What it does |
|
|
338
|
+
| ------------- | --------------------------------------------------------------------------------------------------------------- |
|
|
339
|
+
| ↓ / ↑ | Moves the highlight |
|
|
340
|
+
| Home / End | Highlights the first or last option |
|
|
341
|
+
| Typing | Highlights the next option that starts with the letters typed |
|
|
342
|
+
| Enter / Space | Chooses the highlighted option and closes the list; with `multiple`, adds or removes it and the list stays open |
|
|
343
|
+
| Escape | Closes the list and returns focus to the trigger; the value stays as it was |
|
|
344
|
+
|
|
345
|
+
While typing, a space is part of the search, not a choice. On a phone, the platform's own picker opens instead (see On phones).
|
|
346
|
+
|
|
347
|
+
---
|
|
348
|
+
|
|
349
|
+
- Import: `import { Select, SelectTrigger, SelectValue, SelectContent, SelectItem, SelectGroup, SelectGroupLabel, SelectSeparator } from "@zonsh/ui"`
|
|
350
|
+
- Source: `packages/ui/src/components/select.tsx`
|
|
351
|
+
- Primitive: `@base-ui/react/select` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/select.md`)
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
# Separator
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Separator } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
export function Horizontal() {
|
|
7
|
+
return (
|
|
8
|
+
<div className="flex max-w-xl flex-col gap-6">
|
|
9
|
+
<p className="m-0 text-[15px] text-foreground-soft">
|
|
10
|
+
Your order has been packed and will leave the warehouse today.
|
|
11
|
+
</p>
|
|
12
|
+
<Separator />
|
|
13
|
+
<p className="m-0 text-[15px] text-foreground-soft">
|
|
14
|
+
You will get a tracking link as soon as it ships.
|
|
15
|
+
</p>
|
|
16
|
+
</div>
|
|
17
|
+
);
|
|
18
|
+
}
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
The 1px `border/60` rule that does most of the grouping here, horizontal or vertical, optionally with a mono label.
|
|
22
|
+
|
|
23
|
+
## Usage
|
|
24
|
+
|
|
25
|
+
```tsx
|
|
26
|
+
import { Separator } from "@zonsh/ui";
|
|
27
|
+
|
|
28
|
+
<Separator />
|
|
29
|
+
<Separator label="or" />
|
|
30
|
+
<Separator orientation="vertical" />
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
`orientation` and `label` (horizontal only) are its props.
|
|
34
|
+
|
|
35
|
+
## When to use
|
|
36
|
+
|
|
37
|
+
- Between sections, settings groups or list items — before any box.
|
|
38
|
+
- Vertically between inline groups: header actions, meta lines.
|
|
39
|
+
- Labelled, to divide alternatives ("or") or number a section.
|
|
40
|
+
|
|
41
|
+
## Examples
|
|
42
|
+
|
|
43
|
+
### Labelled
|
|
44
|
+
|
|
45
|
+
```tsx
|
|
46
|
+
import { Separator } from "@zonsh/ui";
|
|
47
|
+
|
|
48
|
+
export function Labelled() {
|
|
49
|
+
return (
|
|
50
|
+
<div className="flex max-w-xl flex-col gap-8">
|
|
51
|
+
<Separator label="or" />
|
|
52
|
+
<Separator label="02 — Chapters" />
|
|
53
|
+
</div>
|
|
54
|
+
);
|
|
55
|
+
}
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
### Vertical
|
|
59
|
+
|
|
60
|
+
It stretches to its flex row's height.
|
|
61
|
+
|
|
62
|
+
```tsx
|
|
63
|
+
import { Separator } from "@zonsh/ui";
|
|
64
|
+
|
|
65
|
+
export function Vertical() {
|
|
66
|
+
return (
|
|
67
|
+
<div className="flex items-center gap-4 font-mono text-[13px] text-foreground-soft">
|
|
68
|
+
<span>Cologne</span>
|
|
69
|
+
<Separator orientation="vertical" />
|
|
70
|
+
<span>12 May</span>
|
|
71
|
+
<Separator orientation="vertical" />
|
|
72
|
+
<span>6 min read</span>
|
|
73
|
+
</div>
|
|
74
|
+
);
|
|
75
|
+
}
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
## Props
|
|
79
|
+
|
|
80
|
+
| Prop | Type | Default |
|
|
81
|
+
| ------------- | ----------------------------- | -------------- |
|
|
82
|
+
| `orientation` | `"horizontal" \| "vertical"` | `"horizontal"` |
|
|
83
|
+
| `label` | `ReactNode` — horizontal only | — |
|
|
84
|
+
|
|
85
|
+
Base UI `Separator` props are forwarded. Data: `data-orientation`, and `data-labelled` when a label is set.
|
|
86
|
+
|
|
87
|
+
## Brand rules
|
|
88
|
+
|
|
89
|
+
- **Do** reach for a rule and whitespace before a `Card`.
|
|
90
|
+
- **Do** keep labels to a word or an index ("or", "02").
|
|
91
|
+
- **Don't** thicken it, darken it to `foreground`, or use dashed lines.
|
|
92
|
+
- **Don't** set a rule against a bordered box; the border separates already.
|
|
93
|
+
|
|
94
|
+
## Accessibility
|
|
95
|
+
|
|
96
|
+
- `role="separator"` with `aria-orientation`; a label is part of it, so keep it short.
|
|
97
|
+
- A decorative rule inside a component can be a CSS border.
|
|
98
|
+
|
|
99
|
+
---
|
|
100
|
+
|
|
101
|
+
- Import: `import { Separator } from "@zonsh/ui"`
|
|
102
|
+
- Source: `packages/ui/src/components/separator.tsx`
|
|
103
|
+
- Primitive: `@base-ui/react/separator` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/separator.md`)
|