@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,218 @@
|
|
|
1
|
+
# Menu
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Button, Menu, MenuContent, MenuItem, MenuSeparator, MenuShortcut, MenuTrigger } from "@zonsh/ui";
|
|
5
|
+
import { ArchiveIcon, ChevronDownIcon, CopyIcon, PencilIcon, Trash2Icon } from "lucide-react";
|
|
6
|
+
|
|
7
|
+
export function Basic() {
|
|
8
|
+
return (
|
|
9
|
+
<Menu>
|
|
10
|
+
<MenuTrigger render={<Button variant="secondary" />}>
|
|
11
|
+
Project
|
|
12
|
+
<ChevronDownIcon />
|
|
13
|
+
</MenuTrigger>
|
|
14
|
+
<MenuContent>
|
|
15
|
+
<MenuItem>
|
|
16
|
+
<PencilIcon />
|
|
17
|
+
Rename
|
|
18
|
+
<MenuShortcut keys={["mod", "R"]} />
|
|
19
|
+
</MenuItem>
|
|
20
|
+
<MenuItem>
|
|
21
|
+
<CopyIcon />
|
|
22
|
+
Duplicate
|
|
23
|
+
<MenuShortcut keys={["mod", "D"]} />
|
|
24
|
+
</MenuItem>
|
|
25
|
+
<MenuItem>
|
|
26
|
+
<ArchiveIcon />
|
|
27
|
+
Archive
|
|
28
|
+
</MenuItem>
|
|
29
|
+
<MenuSeparator />
|
|
30
|
+
<MenuItem variant="destructive">
|
|
31
|
+
<Trash2Icon />
|
|
32
|
+
Delete project
|
|
33
|
+
</MenuItem>
|
|
34
|
+
</MenuContent>
|
|
35
|
+
</Menu>
|
|
36
|
+
);
|
|
37
|
+
}
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
Actions behind a button, in `material-menu` at 12px: 38px items at 7px that lift on highlight like `SelectItem`, mono group labels and shortcuts.
|
|
41
|
+
|
|
42
|
+
## Usage
|
|
43
|
+
|
|
44
|
+
```tsx
|
|
45
|
+
import { Button, Menu, MenuContent, MenuItem, MenuSeparator, MenuTrigger } from "@zonsh/ui";
|
|
46
|
+
|
|
47
|
+
<Menu>
|
|
48
|
+
<MenuTrigger render={<Button variant="secondary" />}>Project</MenuTrigger>
|
|
49
|
+
<MenuContent>
|
|
50
|
+
<MenuItem onClick={rename}>Rename</MenuItem>
|
|
51
|
+
<MenuItem onClick={duplicate}>Duplicate</MenuItem>
|
|
52
|
+
<MenuSeparator />
|
|
53
|
+
<MenuItem variant="destructive" onClick={remove}>
|
|
54
|
+
Delete project
|
|
55
|
+
</MenuItem>
|
|
56
|
+
</MenuContent>
|
|
57
|
+
</Menu>;
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
The props you'll use: `MenuTrigger render` (a secondary or ghost `Button`), `MenuItem variant="destructive"` and `MenuContent align`. Icons first (16px lucide), shortcuts last.
|
|
61
|
+
|
|
62
|
+
## When to use
|
|
63
|
+
|
|
64
|
+
- Secondary actions on a thing ("Rename", "Delete project"), often from an overflow `…` button.
|
|
65
|
+
- View toggles and sort order (`MenuCheckboxItem`, `MenuRadioGroup`).
|
|
66
|
+
- Not for choosing a form value — use `Select`. Not for site navigation — use `NavigationMenu`.
|
|
67
|
+
|
|
68
|
+
## Examples
|
|
69
|
+
|
|
70
|
+
### Checkbox and radio
|
|
71
|
+
|
|
72
|
+
They keep the menu open on click.
|
|
73
|
+
|
|
74
|
+
```tsx
|
|
75
|
+
import { Button, Menu, MenuCheckboxItem, MenuContent, MenuGroup, MenuGroupLabel, MenuRadioGroup, MenuRadioItem, MenuSeparator, MenuTrigger } from "@zonsh/ui";
|
|
76
|
+
import { ChevronDownIcon } from "lucide-react";
|
|
77
|
+
import * as React from "react";
|
|
78
|
+
|
|
79
|
+
export function CheckboxAndRadio() {
|
|
80
|
+
const [grid, setGrid] = React.useState(true);
|
|
81
|
+
const [notes, setNotes] = React.useState(false);
|
|
82
|
+
const [sort, setSort] = React.useState("updated");
|
|
83
|
+
return (
|
|
84
|
+
<Menu>
|
|
85
|
+
<MenuTrigger render={<Button variant="secondary" />}>
|
|
86
|
+
View
|
|
87
|
+
<ChevronDownIcon />
|
|
88
|
+
</MenuTrigger>
|
|
89
|
+
<MenuContent className="min-w-56">
|
|
90
|
+
<MenuGroup>
|
|
91
|
+
<MenuGroupLabel>Show</MenuGroupLabel>
|
|
92
|
+
<MenuCheckboxItem checked={grid} onCheckedChange={setGrid}>
|
|
93
|
+
Blueprint grid
|
|
94
|
+
</MenuCheckboxItem>
|
|
95
|
+
<MenuCheckboxItem checked={notes} onCheckedChange={setNotes}>
|
|
96
|
+
Margin notes
|
|
97
|
+
</MenuCheckboxItem>
|
|
98
|
+
</MenuGroup>
|
|
99
|
+
<MenuSeparator />
|
|
100
|
+
<MenuRadioGroup value={sort} onValueChange={setSort}>
|
|
101
|
+
<MenuGroupLabel>Sort by</MenuGroupLabel>
|
|
102
|
+
<MenuRadioItem value="updated">Last updated</MenuRadioItem>
|
|
103
|
+
<MenuRadioItem value="name">Name</MenuRadioItem>
|
|
104
|
+
<MenuRadioItem value="owner">Owner</MenuRadioItem>
|
|
105
|
+
</MenuRadioGroup>
|
|
106
|
+
</MenuContent>
|
|
107
|
+
</Menu>
|
|
108
|
+
);
|
|
109
|
+
}
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
### Submenu
|
|
113
|
+
|
|
114
|
+
Submenus open to the inline end on hover or arrow key; `MenuLinkItem` is a real link.
|
|
115
|
+
|
|
116
|
+
```tsx
|
|
117
|
+
import { Button, Menu, MenuContent, MenuItem, MenuLinkItem, MenuSeparator, MenuSub, MenuSubContent, MenuSubTrigger, MenuTrigger } from "@zonsh/ui";
|
|
118
|
+
import { EllipsisIcon, ExternalLinkIcon, PencilIcon, Share2Icon } from "lucide-react";
|
|
119
|
+
|
|
120
|
+
export function Submenu() {
|
|
121
|
+
return (
|
|
122
|
+
<Menu>
|
|
123
|
+
<MenuTrigger render={<Button variant="ghost" size="icon" aria-label="More actions" />}>
|
|
124
|
+
<EllipsisIcon />
|
|
125
|
+
</MenuTrigger>
|
|
126
|
+
<MenuContent>
|
|
127
|
+
<MenuItem>
|
|
128
|
+
<PencilIcon />
|
|
129
|
+
Edit post
|
|
130
|
+
</MenuItem>
|
|
131
|
+
<MenuSub>
|
|
132
|
+
<MenuSubTrigger>
|
|
133
|
+
<Share2Icon />
|
|
134
|
+
Share
|
|
135
|
+
</MenuSubTrigger>
|
|
136
|
+
<MenuSubContent>
|
|
137
|
+
<MenuItem>Copy link</MenuItem>
|
|
138
|
+
<MenuItem>Send by email</MenuItem>
|
|
139
|
+
<MenuItem>Export as PDF</MenuItem>
|
|
140
|
+
</MenuSubContent>
|
|
141
|
+
</MenuSub>
|
|
142
|
+
<MenuSeparator />
|
|
143
|
+
<MenuLinkItem href="#history">
|
|
144
|
+
<ExternalLinkIcon className="rtl:-scale-x-100" />
|
|
145
|
+
Open version history
|
|
146
|
+
</MenuLinkItem>
|
|
147
|
+
</MenuContent>
|
|
148
|
+
</Menu>
|
|
149
|
+
);
|
|
150
|
+
}
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
## Behaviour
|
|
154
|
+
|
|
155
|
+
Checks draw in and out; a radio group's dot glides to the option picked. Popups stay inside their trigger's room: in a narrow panel they shift and narrow, and a submenu with no room beside it opens below its item.
|
|
156
|
+
|
|
157
|
+
## Props
|
|
158
|
+
|
|
159
|
+
| Prop | Type | Default |
|
|
160
|
+
| ---------------------------------------------- | ---------------------------------------------------------- | ----------- |
|
|
161
|
+
| `MenuContent.side` | `"top" \| "right" \| "bottom" \| "left" …` | `"bottom"` |
|
|
162
|
+
| `MenuContent.align` | `"start" \| "center" \| "end"` | `"start"` |
|
|
163
|
+
| `MenuContent.sideOffset` | `number` | `6` |
|
|
164
|
+
| `MenuContent.positioner` / `portal` | Base UI positioner / portal props | — |
|
|
165
|
+
| `MenuItem.variant` | `"default" \| "destructive"` | `"default"` |
|
|
166
|
+
| `MenuItem.closeOnClick` | `boolean` | `true` |
|
|
167
|
+
| `MenuItem.disabled` | `boolean` | `false` |
|
|
168
|
+
| `MenuCheckboxItem.checked` / `onCheckedChange` | `boolean` | — |
|
|
169
|
+
| `MenuRadioGroup.value` / `onValueChange` | `any` | — |
|
|
170
|
+
| `MenuShortcut.keys` | `string[]` — `["mod", "D"]`: ⌘D on Apple, Ctrl+D elsewhere | — |
|
|
171
|
+
| `MenuRadioItem.value` | `any` — required | — |
|
|
172
|
+
| `MenuTrigger.openOnHover` | `boolean` | `false` |
|
|
173
|
+
| `MenuSubContent.sideOffset` / `alignOffset` | `number` | `2` / `-5` |
|
|
174
|
+
|
|
175
|
+
`Menu` is Base UI `Menu.Root`; `MenuSub` is `Menu.SubmenuRoot`. Data attributes: `data-variant` on items, plus Base UI's `data-highlighted`, `data-checked`, `data-disabled`, `data-popup-open`.
|
|
176
|
+
|
|
177
|
+
## Brand rules
|
|
178
|
+
|
|
179
|
+
- **Do** write items as verbs: "Rename", "Export as PDF", "Delete project".
|
|
180
|
+
- **Do** put destructive items last, after a separator, and confirm them with an `AlertDialog`.
|
|
181
|
+
- **Don't** colour icons or the highlight; only destructive ink and a status mark (a dot beside a state) take colour.
|
|
182
|
+
- **Don't** shrink items below 38px or change the 7px item radius.
|
|
183
|
+
- **Don't** nest more than one level of submenu.
|
|
184
|
+
|
|
185
|
+
## Accessibility
|
|
186
|
+
|
|
187
|
+
- `role="menu"` with `menuitem`, `menuitemcheckbox` and `menuitemradio` items.
|
|
188
|
+
- Give icon-only triggers an `aria-label`.
|
|
189
|
+
- `MenuShortcut` is decorative (`aria-hidden`); wire the shortcut yourself (`event.metaKey || event.ctrlKey` for `mod`). `keys` writes it for the device (⌘D on a Mac, Ctrl+D elsewhere); it is hidden on touch-only devices.
|
|
190
|
+
- Label groups with `MenuGroupLabel` so they are announced together.
|
|
191
|
+
|
|
192
|
+
### Keyboard
|
|
193
|
+
|
|
194
|
+
On the trigger:
|
|
195
|
+
|
|
196
|
+
| Key | What it does |
|
|
197
|
+
| ----------------- | -------------------------------------------- |
|
|
198
|
+
| Enter / Space / ↓ | Opens the menu and highlights the first item |
|
|
199
|
+
| ↑ | Opens the menu and highlights the last item |
|
|
200
|
+
|
|
201
|
+
In the menu:
|
|
202
|
+
|
|
203
|
+
| Key | What it does |
|
|
204
|
+
| ------------- | ------------------------------------------------------------------------------------------------------- |
|
|
205
|
+
| ↓ / ↑ | Moves the highlight, looping at the ends |
|
|
206
|
+
| Home / End | Highlights the first or last item |
|
|
207
|
+
| Enter / Space | Runs the highlighted item and closes the menu; a checkbox or radio item toggles and the menu stays open |
|
|
208
|
+
| → | Opens the highlighted submenu and highlights its first item (← right to left) |
|
|
209
|
+
| ← | Closes the submenu and returns to its trigger (→ right to left) |
|
|
210
|
+
| Typing | Highlights the next item that starts with the letters typed |
|
|
211
|
+
| Escape | Closes the menu and returns focus to the trigger |
|
|
212
|
+
| Tab | Closes the menu and moves focus on |
|
|
213
|
+
|
|
214
|
+
---
|
|
215
|
+
|
|
216
|
+
- Import: `import { Menu, MenuTrigger, MenuContent, MenuItem, MenuLinkItem, MenuCheckboxItem, MenuRadioGroup, MenuRadioItem } from "@zonsh/ui"`
|
|
217
|
+
- Source: `packages/ui/src/components/menu.tsx`
|
|
218
|
+
- Primitive: `@base-ui/react/menu` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/menu.md`)
|
|
@@ -0,0 +1,292 @@
|
|
|
1
|
+
# Menubar
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarGroupLabel, MenubarItem, MenubarMenu, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger } from "@zonsh/ui";
|
|
5
|
+
import { FilePlusIcon, FolderOpenIcon, SaveIcon, Trash2Icon } from "lucide-react";
|
|
6
|
+
import * as React from "react";
|
|
7
|
+
|
|
8
|
+
export function Basic() {
|
|
9
|
+
const [grid, setGrid] = React.useState(true);
|
|
10
|
+
const [rulers, setRulers] = React.useState(false);
|
|
11
|
+
const [zoom, setZoom] = React.useState("fit");
|
|
12
|
+
return (
|
|
13
|
+
<Menubar>
|
|
14
|
+
<MenubarMenu>
|
|
15
|
+
<MenubarTrigger>File</MenubarTrigger>
|
|
16
|
+
<MenubarContent>
|
|
17
|
+
<MenubarItem>
|
|
18
|
+
<FilePlusIcon />
|
|
19
|
+
New document
|
|
20
|
+
<MenubarShortcut keys={["mod", "N"]} />
|
|
21
|
+
</MenubarItem>
|
|
22
|
+
<MenubarItem>
|
|
23
|
+
<FolderOpenIcon />
|
|
24
|
+
Open…
|
|
25
|
+
<MenubarShortcut keys={["mod", "O"]} />
|
|
26
|
+
</MenubarItem>
|
|
27
|
+
<MenubarItem>
|
|
28
|
+
<SaveIcon />
|
|
29
|
+
Save
|
|
30
|
+
<MenubarShortcut keys={["mod", "S"]} />
|
|
31
|
+
</MenubarItem>
|
|
32
|
+
<MenubarSeparator />
|
|
33
|
+
<MenubarSub>
|
|
34
|
+
<MenubarSubTrigger>Export as</MenubarSubTrigger>
|
|
35
|
+
<MenubarSubContent>
|
|
36
|
+
<MenubarItem>PDF</MenubarItem>
|
|
37
|
+
<MenubarItem>PNG</MenubarItem>
|
|
38
|
+
<MenubarItem>JSON</MenubarItem>
|
|
39
|
+
</MenubarSubContent>
|
|
40
|
+
</MenubarSub>
|
|
41
|
+
<MenubarSeparator />
|
|
42
|
+
<MenubarItem variant="destructive">
|
|
43
|
+
<Trash2Icon />
|
|
44
|
+
Delete document
|
|
45
|
+
</MenubarItem>
|
|
46
|
+
</MenubarContent>
|
|
47
|
+
</MenubarMenu>
|
|
48
|
+
<MenubarMenu>
|
|
49
|
+
<MenubarTrigger>Edit</MenubarTrigger>
|
|
50
|
+
<MenubarContent>
|
|
51
|
+
<MenubarItem>
|
|
52
|
+
Undo
|
|
53
|
+
<MenubarShortcut keys={["mod", "Z"]} />
|
|
54
|
+
</MenubarItem>
|
|
55
|
+
<MenubarItem>
|
|
56
|
+
Redo
|
|
57
|
+
<MenubarShortcut keys={["mod", "shift", "Z"]} />
|
|
58
|
+
</MenubarItem>
|
|
59
|
+
<MenubarSeparator />
|
|
60
|
+
<MenubarItem>
|
|
61
|
+
Duplicate step
|
|
62
|
+
<MenubarShortcut keys={["mod", "D"]} />
|
|
63
|
+
</MenubarItem>
|
|
64
|
+
<MenubarItem disabled>Paste step</MenubarItem>
|
|
65
|
+
</MenubarContent>
|
|
66
|
+
</MenubarMenu>
|
|
67
|
+
<MenubarMenu>
|
|
68
|
+
<MenubarTrigger>View</MenubarTrigger>
|
|
69
|
+
<MenubarContent>
|
|
70
|
+
<MenubarCheckboxItem checked={grid} onCheckedChange={setGrid}>
|
|
71
|
+
Show grid
|
|
72
|
+
</MenubarCheckboxItem>
|
|
73
|
+
<MenubarCheckboxItem checked={rulers} onCheckedChange={setRulers}>
|
|
74
|
+
Show rulers
|
|
75
|
+
</MenubarCheckboxItem>
|
|
76
|
+
<MenubarSeparator />
|
|
77
|
+
<MenubarGroup>
|
|
78
|
+
<MenubarGroupLabel>Zoom</MenubarGroupLabel>
|
|
79
|
+
<MenubarRadioGroup value={zoom} onValueChange={setZoom}>
|
|
80
|
+
<MenubarRadioItem value="fit">Fit to screen</MenubarRadioItem>
|
|
81
|
+
<MenubarRadioItem value="100">100%</MenubarRadioItem>
|
|
82
|
+
<MenubarRadioItem value="200">200%</MenubarRadioItem>
|
|
83
|
+
</MenubarRadioGroup>
|
|
84
|
+
</MenubarGroup>
|
|
85
|
+
</MenubarContent>
|
|
86
|
+
</MenubarMenu>
|
|
87
|
+
<MenubarMenu>
|
|
88
|
+
<MenubarTrigger>Help</MenubarTrigger>
|
|
89
|
+
<MenubarContent>
|
|
90
|
+
<MenubarItem>Keyboard shortcuts</MenubarItem>
|
|
91
|
+
<MenubarItem>Documentation</MenubarItem>
|
|
92
|
+
</MenubarContent>
|
|
93
|
+
</MenubarMenu>
|
|
94
|
+
</Menubar>
|
|
95
|
+
);
|
|
96
|
+
}
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
A desktop-style menu bar: dense 30px triggers in a 38px bar, opening the `Menu` popup and items.
|
|
100
|
+
|
|
101
|
+
## Usage
|
|
102
|
+
|
|
103
|
+
```tsx
|
|
104
|
+
import {
|
|
105
|
+
Menubar,
|
|
106
|
+
MenubarContent,
|
|
107
|
+
MenubarItem,
|
|
108
|
+
MenubarMenu,
|
|
109
|
+
MenubarSeparator,
|
|
110
|
+
MenubarShortcut,
|
|
111
|
+
MenubarTrigger,
|
|
112
|
+
} from "@zonsh/ui";
|
|
113
|
+
|
|
114
|
+
<Menubar>
|
|
115
|
+
<MenubarMenu>
|
|
116
|
+
<MenubarTrigger>File</MenubarTrigger>
|
|
117
|
+
<MenubarContent>
|
|
118
|
+
<MenubarItem>
|
|
119
|
+
New document
|
|
120
|
+
<MenubarShortcut keys={["mod", "N"]} />
|
|
121
|
+
</MenubarItem>
|
|
122
|
+
<MenubarSeparator />
|
|
123
|
+
<MenubarItem variant="destructive">Delete document</MenubarItem>
|
|
124
|
+
</MenubarContent>
|
|
125
|
+
</MenubarMenu>
|
|
126
|
+
</Menubar>;
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
The props you'll use: `MenubarContent align`, `MenubarItem variant` and `MenubarShortcut keys` (`["mod", "N"]`: ⌘N on a Mac, Ctrl+N elsewhere).
|
|
130
|
+
|
|
131
|
+
## When to use
|
|
132
|
+
|
|
133
|
+
- The command set of an editor or admin tool, where people expect "File / Edit / View" and shortcuts.
|
|
134
|
+
- Not for site navigation (`NavigationMenu`), actions on one thing (`Menu`) or direct commands (`Toolbar`).
|
|
135
|
+
|
|
136
|
+
## Examples
|
|
137
|
+
|
|
138
|
+
### In a toolbar row
|
|
139
|
+
|
|
140
|
+
Menus aligned to the end of a document header.
|
|
141
|
+
|
|
142
|
+
```tsx
|
|
143
|
+
import { Menubar, MenubarContent, MenubarItem, MenubarMenu, MenubarShortcut, MenubarTrigger } from "@zonsh/ui";
|
|
144
|
+
|
|
145
|
+
export function InAToolbar() {
|
|
146
|
+
return (
|
|
147
|
+
<div className="flex w-full max-w-2xl items-center justify-between gap-4 border-b border-border/60 pb-3">
|
|
148
|
+
<span className="font-mono text-xs text-muted-foreground">backup-photos.sh</span>
|
|
149
|
+
<Menubar>
|
|
150
|
+
<MenubarMenu>
|
|
151
|
+
<MenubarTrigger>Run</MenubarTrigger>
|
|
152
|
+
<MenubarContent align="end">
|
|
153
|
+
<MenubarItem>
|
|
154
|
+
Run once
|
|
155
|
+
<MenubarShortcut keys={["mod", "enter"]} />
|
|
156
|
+
</MenubarItem>
|
|
157
|
+
<MenubarItem>Run on schedule…</MenubarItem>
|
|
158
|
+
</MenubarContent>
|
|
159
|
+
</MenubarMenu>
|
|
160
|
+
<MenubarMenu>
|
|
161
|
+
<MenubarTrigger>Share</MenubarTrigger>
|
|
162
|
+
<MenubarContent align="end">
|
|
163
|
+
<MenubarItem>Copy link</MenubarItem>
|
|
164
|
+
<MenubarItem>Invite a teammate…</MenubarItem>
|
|
165
|
+
</MenubarContent>
|
|
166
|
+
</MenubarMenu>
|
|
167
|
+
</Menubar>
|
|
168
|
+
</div>
|
|
169
|
+
);
|
|
170
|
+
}
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
### On a narrow screen
|
|
174
|
+
|
|
175
|
+
A bar that does not fit its row folds into one menu button. Its menu holds every menu's items, each under its menu's name as a group, in one list a thumb can scroll — no menus opening sideways off a phone's edge. The bar comes back when there is room. Here, beside a file name in a 288px header.
|
|
176
|
+
|
|
177
|
+
```tsx
|
|
178
|
+
import { Menubar, MenubarCheckboxItem, MenubarContent, MenubarItem, MenubarMenu, MenubarShortcut, MenubarTrigger } from "@zonsh/ui";
|
|
179
|
+
import { FilePlusIcon, SaveIcon } from "lucide-react";
|
|
180
|
+
import * as React from "react";
|
|
181
|
+
|
|
182
|
+
export function Narrow() {
|
|
183
|
+
const [wrap, setWrap] = React.useState(true);
|
|
184
|
+
return (
|
|
185
|
+
<div className="flex w-full max-w-72 items-center justify-between gap-3 border-b border-border/60 pb-3">
|
|
186
|
+
<span className="shrink-0 font-mono text-xs text-muted-foreground">field-notes.md</span>
|
|
187
|
+
<Menubar>
|
|
188
|
+
<MenubarMenu>
|
|
189
|
+
<MenubarTrigger>File</MenubarTrigger>
|
|
190
|
+
<MenubarContent>
|
|
191
|
+
<MenubarItem>
|
|
192
|
+
<FilePlusIcon />
|
|
193
|
+
New note
|
|
194
|
+
<MenubarShortcut keys={["mod", "N"]} />
|
|
195
|
+
</MenubarItem>
|
|
196
|
+
<MenubarItem>
|
|
197
|
+
<SaveIcon />
|
|
198
|
+
Save
|
|
199
|
+
<MenubarShortcut keys={["mod", "S"]} />
|
|
200
|
+
</MenubarItem>
|
|
201
|
+
</MenubarContent>
|
|
202
|
+
</MenubarMenu>
|
|
203
|
+
<MenubarMenu>
|
|
204
|
+
<MenubarTrigger>Edit</MenubarTrigger>
|
|
205
|
+
<MenubarContent>
|
|
206
|
+
<MenubarItem>
|
|
207
|
+
Undo
|
|
208
|
+
<MenubarShortcut keys={["mod", "Z"]} />
|
|
209
|
+
</MenubarItem>
|
|
210
|
+
<MenubarItem>Find and replace…</MenubarItem>
|
|
211
|
+
</MenubarContent>
|
|
212
|
+
</MenubarMenu>
|
|
213
|
+
<MenubarMenu>
|
|
214
|
+
<MenubarTrigger>View</MenubarTrigger>
|
|
215
|
+
<MenubarContent>
|
|
216
|
+
<MenubarCheckboxItem checked={wrap} onCheckedChange={setWrap}>
|
|
217
|
+
Wrap long lines
|
|
218
|
+
</MenubarCheckboxItem>
|
|
219
|
+
</MenubarContent>
|
|
220
|
+
</MenubarMenu>
|
|
221
|
+
<MenubarMenu>
|
|
222
|
+
<MenubarTrigger>Help</MenubarTrigger>
|
|
223
|
+
<MenubarContent>
|
|
224
|
+
<MenubarItem>Keyboard shortcuts</MenubarItem>
|
|
225
|
+
</MenubarContent>
|
|
226
|
+
</MenubarMenu>
|
|
227
|
+
</Menubar>
|
|
228
|
+
</div>
|
|
229
|
+
);
|
|
230
|
+
}
|
|
231
|
+
```
|
|
232
|
+
|
|
233
|
+
`collapse="auto"` is the default; `collapse` folds it always (a phone layout of your own), `collapse={false}` never.
|
|
234
|
+
|
|
235
|
+
## Behaviour
|
|
236
|
+
|
|
237
|
+
Hover only brightens a trigger, so a closed menu never looks open. One raised highlight marks the open trigger and glides along the bar; with a menu open, moving along opens the next in one shared, resizing surface.
|
|
238
|
+
|
|
239
|
+
## Props
|
|
240
|
+
|
|
241
|
+
| Prop | Type | Default |
|
|
242
|
+
| ------------------------------------------- | ------------------------------------------ | -------------- |
|
|
243
|
+
| `Menubar.orientation` | `"horizontal" \| "vertical"` | `"horizontal"` |
|
|
244
|
+
| `Menubar.loopFocus` | `boolean` | `true` |
|
|
245
|
+
| `Menubar.modal` | `boolean` | `true` |
|
|
246
|
+
| `Menubar.disabled` | `boolean` | `false` |
|
|
247
|
+
| `Menubar.collapse` | `boolean \| "auto"` — one menu button, its menus as groups; `"auto"` while the bar would not fit | `"auto"` |
|
|
248
|
+
| `Menubar.labels` | `{ menu?: string }` — the collapsed button's name | English |
|
|
249
|
+
| `MenubarContent.side` | `"top" \| "right" \| "bottom" \| "left" …` | `"bottom"` |
|
|
250
|
+
| `MenubarContent.align` | `"start" \| "center" \| "end"` | `"start"` |
|
|
251
|
+
| `MenubarContent.sideOffset` | `number` | `8` |
|
|
252
|
+
| `MenubarContent.positioner` / `portal` | Base UI positioner / portal props | — |
|
|
253
|
+
| `MenubarItem.variant` | `"default" \| "destructive"` | `"default"` |
|
|
254
|
+
| `MenubarCheckboxItem.checked` | `boolean` | — |
|
|
255
|
+
| `MenubarRadioGroup.value` / `onValueChange` | `any` | — |
|
|
256
|
+
|
|
257
|
+
`MenubarMenu` is Base UI `Menu.Root`; `MenubarSub` is `Menu.SubmenuRoot`. Items are the `Menu` items with their own `data-slot` (`menubar-item` …); every `Menu` prop applies. Triggers expose Base UI's `data-popup-open` and `data-pressed`.
|
|
258
|
+
|
|
259
|
+
## Brand rules
|
|
260
|
+
|
|
261
|
+
- **Do** keep menu names to one word: "File", "Edit", "View", "Run".
|
|
262
|
+
- **Do** give frequent commands a `MenubarShortcut` with `keys`, and wire the keys yourself.
|
|
263
|
+
- **Don't** put a menubar on a marketing or content page; it belongs to tools.
|
|
264
|
+
- **Don't** add icons to the bar's triggers or make them 38px; the bar is dense.
|
|
265
|
+
- **Don't** colour the open trigger. The raised material is the state.
|
|
266
|
+
|
|
267
|
+
## Accessibility
|
|
268
|
+
|
|
269
|
+
- `role="menubar"` with `menuitem` triggers.
|
|
270
|
+
- `MenubarShortcut` is decorative (`aria-hidden`); register the shortcut on the page.
|
|
271
|
+
- Collapsed, the bar is one menu button named "Menu" (`labels.menu`, `messages.menubar.menu`); each menu is a `group` labelled by its name. The button takes a 44px tap area on a touch screen (`touch-target`).
|
|
272
|
+
|
|
273
|
+
### Keyboard
|
|
274
|
+
|
|
275
|
+
| Key | What it does |
|
|
276
|
+
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------ |
|
|
277
|
+
| ← / → | Moves between the triggers, looping at the ends (swapped right to left); with a menu open, opens the neighbouring menu instead |
|
|
278
|
+
| Home / End | Moves to the first or last trigger |
|
|
279
|
+
| Enter / Space / ↓ | Opens the focused trigger's menu and highlights its first item |
|
|
280
|
+
| ↓ / ↑ | Moves the highlight in the open menu, looping at the ends |
|
|
281
|
+
| Enter / Space | Runs the highlighted item; a checkbox or radio item toggles and the menu stays open |
|
|
282
|
+
| Typing | Highlights the next item that starts with the letters typed |
|
|
283
|
+
| Escape | Closes the menu and returns focus to its trigger |
|
|
284
|
+
| Tab | Leaves the menubar: it is one Tab stop |
|
|
285
|
+
|
|
286
|
+
Submenus inside a menu take → and ← as in `Menu`.
|
|
287
|
+
|
|
288
|
+
---
|
|
289
|
+
|
|
290
|
+
- Import: `import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem, MenubarLinkItem, MenubarCheckboxItem, MenubarRadioGroup } from "@zonsh/ui"`
|
|
291
|
+
- Source: `packages/ui/src/components/menubar.tsx`
|
|
292
|
+
- Primitive: `@base-ui/react/menubar` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/menubar.md`)
|