@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,481 @@
|
|
|
1
|
+
# Tree
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Tree, type TreeNode } from "@zonsh/ui";
|
|
5
|
+
import { FileCodeIcon, FileJsonIcon, FileTextIcon, FolderIcon, FolderOpenIcon, ImageIcon } from "lucide-react";
|
|
6
|
+
|
|
7
|
+
/** A folder that opens with its branch. */
|
|
8
|
+
const folder = ({ expanded }: { expanded: boolean }) => (expanded ? <FolderOpenIcon /> : <FolderIcon />);
|
|
9
|
+
|
|
10
|
+
const project: TreeNode[] = [
|
|
11
|
+
{
|
|
12
|
+
id: "src",
|
|
13
|
+
label: "src",
|
|
14
|
+
icon: folder,
|
|
15
|
+
children: [
|
|
16
|
+
{
|
|
17
|
+
id: "src/components",
|
|
18
|
+
label: "components",
|
|
19
|
+
icon: folder,
|
|
20
|
+
children: [
|
|
21
|
+
{ id: "src/components/cart.tsx", label: "cart.tsx", icon: <FileCodeIcon /> },
|
|
22
|
+
{ id: "src/components/checkout.tsx", label: "checkout.tsx", icon: <FileCodeIcon /> },
|
|
23
|
+
{ id: "src/components/product-card.tsx", label: "product-card.tsx", icon: <FileCodeIcon /> },
|
|
24
|
+
],
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
id: "src/lib",
|
|
28
|
+
label: "lib",
|
|
29
|
+
icon: folder,
|
|
30
|
+
children: [
|
|
31
|
+
{ id: "src/lib/prices.ts", label: "prices.ts", icon: <FileCodeIcon /> },
|
|
32
|
+
{ id: "src/lib/stock.ts", label: "stock.ts", icon: <FileCodeIcon /> },
|
|
33
|
+
],
|
|
34
|
+
},
|
|
35
|
+
{ id: "src/main.tsx", label: "main.tsx", icon: <FileCodeIcon /> },
|
|
36
|
+
],
|
|
37
|
+
},
|
|
38
|
+
{
|
|
39
|
+
id: "public",
|
|
40
|
+
label: "public",
|
|
41
|
+
icon: folder,
|
|
42
|
+
children: [{ id: "public/logo.svg", label: "logo.svg", icon: <ImageIcon /> }],
|
|
43
|
+
},
|
|
44
|
+
{ id: "package.json", label: "package.json", icon: <FileJsonIcon /> },
|
|
45
|
+
{ id: "README.md", label: "README.md", icon: <FileTextIcon /> },
|
|
46
|
+
];
|
|
47
|
+
|
|
48
|
+
export function Basic() {
|
|
49
|
+
return (
|
|
50
|
+
<Tree
|
|
51
|
+
aria-label="Shop storefront files"
|
|
52
|
+
items={project}
|
|
53
|
+
defaultExpanded={["src", "src/components"]}
|
|
54
|
+
defaultSelected={["src/components/checkout.tsx"]}
|
|
55
|
+
className="max-w-72"
|
|
56
|
+
/>
|
|
57
|
+
);
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
/* A file explorer: dense rows, and the working copy's changes as mono letters at the end. */
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
Things inside things: 38px rows (30px `sm`) at 7px corners like `Menu` items, a raised selection like a current `SidebarItem`, turning chevrons and hairline guides. Leaves keep the chevron's room, so labels at a level align.
|
|
64
|
+
|
|
65
|
+
## Usage
|
|
66
|
+
|
|
67
|
+
```tsx
|
|
68
|
+
import { Tree, type TreeNode } from "@zonsh/ui";
|
|
69
|
+
import { FileCodeIcon, FolderIcon } from "lucide-react";
|
|
70
|
+
|
|
71
|
+
const items: TreeNode[] = [
|
|
72
|
+
{
|
|
73
|
+
id: "src",
|
|
74
|
+
label: "src",
|
|
75
|
+
icon: <FolderIcon />,
|
|
76
|
+
children: [{ id: "src/main.tsx", label: "main.tsx", icon: <FileCodeIcon /> }],
|
|
77
|
+
},
|
|
78
|
+
];
|
|
79
|
+
|
|
80
|
+
<Tree aria-label="Project files" items={items} defaultExpanded={["src"]} />;
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
- `items` — the nodes (`TreeNode[]`).
|
|
84
|
+
- `defaultExpanded` / `expanded` — open branch ids.
|
|
85
|
+
- `selectionMode` — single, multiple or none.
|
|
86
|
+
|
|
87
|
+
### Why data, not parts
|
|
88
|
+
|
|
89
|
+
The keyboard needs the whole visible order at once (Down past a branch's end, Left to the parent, Home, End, type-ahead, Shift ranges), so `Tree` takes `items`, not nested children: it computes the order, ARIA levels and set sizes, and keeps one tab stop. `label`, `icon` (or a function of row state) and `meta` still take React nodes.
|
|
90
|
+
|
|
91
|
+
## When to use
|
|
92
|
+
|
|
93
|
+
- Files and folders, outlines, settings nested more than a level, a nested docs contents (rows can be links).
|
|
94
|
+
- `size="sm"` in dense panels; `selectionMode="multiple"` to act on several nodes.
|
|
95
|
+
- Two shallow levels: a `Sidebar` or `Accordion`. Choosing values: `Select` or `Checkbox`.
|
|
96
|
+
|
|
97
|
+
## Examples
|
|
98
|
+
|
|
99
|
+
### Dense
|
|
100
|
+
|
|
101
|
+
`size="sm"`: 30px rows and 13px labels, for a file explorer. `meta` adds a mono detail at the row's end — here a change letter in a status colour, with a title saying what it means and a visually hidden word read after the name ("rainfall.ipynb, modified").
|
|
102
|
+
|
|
103
|
+
```tsx
|
|
104
|
+
import { Tree, type TreeNode } from "@zonsh/ui";
|
|
105
|
+
import { FileIcon, FileTextIcon, FolderIcon, FolderOpenIcon, ImageIcon, NotebookTextIcon } from "lucide-react";
|
|
106
|
+
|
|
107
|
+
// folder: as in the first example on this page that uses them.
|
|
108
|
+
|
|
109
|
+
/* The letter is what you see; the word is what a screen reader reads with the file's name. */
|
|
110
|
+
const modified = (
|
|
111
|
+
<span className="text-warning" title="Modified">
|
|
112
|
+
<span aria-hidden>M</span>
|
|
113
|
+
<span className="sr-only">, modified</span>
|
|
114
|
+
</span>
|
|
115
|
+
);
|
|
116
|
+
|
|
117
|
+
const added = (
|
|
118
|
+
<span className="text-success" title="Added">
|
|
119
|
+
<span aria-hidden>A</span>
|
|
120
|
+
<span className="sr-only">, added</span>
|
|
121
|
+
</span>
|
|
122
|
+
);
|
|
123
|
+
|
|
124
|
+
const notebook: TreeNode[] = [
|
|
125
|
+
{
|
|
126
|
+
id: "analysis",
|
|
127
|
+
label: "analysis",
|
|
128
|
+
icon: folder,
|
|
129
|
+
children: [
|
|
130
|
+
{ id: "analysis/rainfall.ipynb", label: "rainfall.ipynb", icon: <NotebookTextIcon />, meta: modified },
|
|
131
|
+
{ id: "analysis/rivers.ipynb", label: "rivers.ipynb", icon: <NotebookTextIcon /> },
|
|
132
|
+
{
|
|
133
|
+
id: "analysis/figures",
|
|
134
|
+
label: "figures",
|
|
135
|
+
icon: folder,
|
|
136
|
+
children: [
|
|
137
|
+
{ id: "analysis/figures/monthly.png", label: "monthly.png", icon: <ImageIcon />, meta: added },
|
|
138
|
+
{ id: "analysis/figures/stations.png", label: "stations.png", icon: <ImageIcon /> },
|
|
139
|
+
],
|
|
140
|
+
},
|
|
141
|
+
],
|
|
142
|
+
},
|
|
143
|
+
{
|
|
144
|
+
id: "data",
|
|
145
|
+
label: "data",
|
|
146
|
+
icon: folder,
|
|
147
|
+
children: [
|
|
148
|
+
{ id: "data/stations.csv", label: "stations.csv", icon: <FileIcon /> },
|
|
149
|
+
{ id: "data/readings-2026.csv", label: "readings-2026.csv", icon: <FileIcon />, meta: added },
|
|
150
|
+
],
|
|
151
|
+
},
|
|
152
|
+
{ id: "environment.yml", label: "environment.yml", icon: <FileTextIcon /> },
|
|
153
|
+
];
|
|
154
|
+
|
|
155
|
+
export function Dense() {
|
|
156
|
+
return (
|
|
157
|
+
<Tree
|
|
158
|
+
aria-label="Notebook project files"
|
|
159
|
+
size="sm"
|
|
160
|
+
items={notebook}
|
|
161
|
+
defaultExpanded={["analysis", "analysis/figures", "data"]}
|
|
162
|
+
defaultSelected={["analysis/rainfall.ipynb"]}
|
|
163
|
+
className="max-w-64"
|
|
164
|
+
/>
|
|
165
|
+
);
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
/* Several at once: Shift extends, ⌘/Ctrl or Space toggles one. */
|
|
169
|
+
```
|
|
170
|
+
|
|
171
|
+
### Multiple selection
|
|
172
|
+
|
|
173
|
+
With `selectionMode="multiple"`, a click selects one; ⌘-click (Ctrl-click elsewhere; on a Mac Ctrl-click is a right-click) or Space toggles; Shift with a click, Space, arrows or Home/End extends a range from the anchor, keeping selections outside it. On link rows these select rather than open a tab. A `disabled` node is reachable but inert.
|
|
174
|
+
|
|
175
|
+
```tsx
|
|
176
|
+
import { Tree, type TreeNode } from "@zonsh/ui";
|
|
177
|
+
import * as React from "react";
|
|
178
|
+
|
|
179
|
+
const lessons: TreeNode[] = [
|
|
180
|
+
{
|
|
181
|
+
id: "m1",
|
|
182
|
+
label: "1 · Getting comfortable with clay",
|
|
183
|
+
children: [
|
|
184
|
+
{ id: "m1-1", label: "Wedging and centring" },
|
|
185
|
+
{ id: "m1-2", label: "Pulling your first walls" },
|
|
186
|
+
{ id: "m1-3", label: "Trimming a foot ring" },
|
|
187
|
+
],
|
|
188
|
+
},
|
|
189
|
+
{
|
|
190
|
+
id: "m2",
|
|
191
|
+
label: "2 · Forms",
|
|
192
|
+
children: [
|
|
193
|
+
{ id: "m2-1", label: "Cylinders and mugs" },
|
|
194
|
+
{ id: "m2-2", label: "Bowls" },
|
|
195
|
+
{ id: "m2-3", label: "Attaching handles" },
|
|
196
|
+
],
|
|
197
|
+
},
|
|
198
|
+
{
|
|
199
|
+
id: "m3",
|
|
200
|
+
label: "3 · Glazing",
|
|
201
|
+
children: [
|
|
202
|
+
{ id: "m3-1", label: "Dipping and pouring" },
|
|
203
|
+
{ id: "m3-2", label: "Kiln loading", disabled: true },
|
|
204
|
+
],
|
|
205
|
+
},
|
|
206
|
+
];
|
|
207
|
+
|
|
208
|
+
/** Lessons only: a module selected with its lessons is not one more lesson to download. */
|
|
209
|
+
const isLesson = (id: string) => id.includes("-");
|
|
210
|
+
|
|
211
|
+
export function Multiple() {
|
|
212
|
+
const [selected, setSelected] = React.useState<string[]>(["m1-2", "m2-1"]);
|
|
213
|
+
const count = selected.filter(isLesson).length;
|
|
214
|
+
return (
|
|
215
|
+
<div className="flex w-full max-w-80 flex-col gap-3">
|
|
216
|
+
<Tree
|
|
217
|
+
aria-label="Course lessons to download"
|
|
218
|
+
selectionMode="multiple"
|
|
219
|
+
items={lessons}
|
|
220
|
+
defaultExpanded={["m1", "m2", "m3"]}
|
|
221
|
+
selected={selected}
|
|
222
|
+
onSelectedChange={setSelected}
|
|
223
|
+
/>
|
|
224
|
+
<p className="m-0 font-mono text-xs text-muted-foreground" aria-live="polite">
|
|
225
|
+
{count === 1 ? "1 lesson" : `${count} lessons`} selected for offline viewing
|
|
226
|
+
</p>
|
|
227
|
+
</div>
|
|
228
|
+
);
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
/* Docs navigation: rows are links, the selection is the page you are on. */
|
|
232
|
+
```
|
|
233
|
+
|
|
234
|
+
### Navigation
|
|
235
|
+
|
|
236
|
+
Nodes with `href` are links. Keep the selection on the current page; route in `onAction` (`event.preventDefault()` stops navigation).
|
|
237
|
+
|
|
238
|
+
```tsx
|
|
239
|
+
import { Tree, type TreeNode } from "@zonsh/ui";
|
|
240
|
+
import { BookOpenIcon, FileCodeIcon, PlayCircleIcon } from "lucide-react";
|
|
241
|
+
import * as React from "react";
|
|
242
|
+
|
|
243
|
+
const guide: TreeNode[] = [
|
|
244
|
+
{ id: "start", label: "Getting started", icon: <PlayCircleIcon />, href: "#start" },
|
|
245
|
+
{
|
|
246
|
+
id: "guides",
|
|
247
|
+
label: "Guides",
|
|
248
|
+
icon: <BookOpenIcon />,
|
|
249
|
+
children: [
|
|
250
|
+
{ id: "orders", label: "Taking orders", href: "#orders" },
|
|
251
|
+
{
|
|
252
|
+
id: "shipping",
|
|
253
|
+
label: "Shipping",
|
|
254
|
+
children: [
|
|
255
|
+
{ id: "zones", label: "Delivery zones", href: "#zones" },
|
|
256
|
+
{ id: "labels", label: "Printing labels", href: "#labels" },
|
|
257
|
+
],
|
|
258
|
+
},
|
|
259
|
+
{ id: "returns", label: "Returns and refunds", href: "#returns" },
|
|
260
|
+
],
|
|
261
|
+
},
|
|
262
|
+
{ id: "api", label: "API reference", icon: <FileCodeIcon />, href: "#api" },
|
|
263
|
+
];
|
|
264
|
+
|
|
265
|
+
/** The ids that are pages; a section without a page of its own only opens and closes. */
|
|
266
|
+
function pages(nodes: TreeNode[]): string[] {
|
|
267
|
+
return nodes.flatMap((n) => [...(n.href ? [n.id] : []), ...pages(n.children ?? [])]);
|
|
268
|
+
}
|
|
269
|
+
|
|
270
|
+
const guidePages = new Set(pages(guide));
|
|
271
|
+
|
|
272
|
+
export function Navigation() {
|
|
273
|
+
const [page, setPage] = React.useState("labels");
|
|
274
|
+
return (
|
|
275
|
+
<nav aria-label="Help centre" className="w-full max-w-64">
|
|
276
|
+
<Tree
|
|
277
|
+
aria-label="Help centre pages"
|
|
278
|
+
items={guide}
|
|
279
|
+
defaultExpanded={["guides", "shipping"]}
|
|
280
|
+
selected={[page]}
|
|
281
|
+
onSelectedChange={(ids) => ids[0] && guidePages.has(ids[0]) && setPage(ids[0])}
|
|
282
|
+
onAction={(_node, event) => {
|
|
283
|
+
// A router would navigate here; the demo stays on the page.
|
|
284
|
+
event.preventDefault();
|
|
285
|
+
}}
|
|
286
|
+
/>
|
|
287
|
+
</nav>
|
|
288
|
+
);
|
|
289
|
+
}
|
|
290
|
+
|
|
291
|
+
/* Controlled expansion: buttons that open and close every branch. */
|
|
292
|
+
```
|
|
293
|
+
|
|
294
|
+
### Controlled
|
|
295
|
+
|
|
296
|
+
`expanded`, `selected` and their handlers, for "Expand all" or revealing a file. `guides={false}` drops the hairlines.
|
|
297
|
+
|
|
298
|
+
```tsx
|
|
299
|
+
import { Button, Tree, type TreeNode } from "@zonsh/ui";
|
|
300
|
+
import { FileCodeIcon, FileJsonIcon, FileTextIcon, FolderIcon, FolderOpenIcon, ImageIcon } from "lucide-react";
|
|
301
|
+
import * as React from "react";
|
|
302
|
+
|
|
303
|
+
// folder, project: as in the first example on this page that uses them.
|
|
304
|
+
|
|
305
|
+
function branches(nodes: TreeNode[]): string[] {
|
|
306
|
+
return nodes.flatMap((n) => (n.children ? [n.id, ...branches(n.children)] : []));
|
|
307
|
+
}
|
|
308
|
+
|
|
309
|
+
export function Controlled() {
|
|
310
|
+
const [expanded, setExpanded] = React.useState<string[]>(["src"]);
|
|
311
|
+
const all = branches(project);
|
|
312
|
+
return (
|
|
313
|
+
<div className="flex w-full max-w-72 flex-col gap-3">
|
|
314
|
+
<div className="flex gap-2">
|
|
315
|
+
<Button variant="secondary" size="sm" onClick={() => setExpanded(all)}>
|
|
316
|
+
Expand all
|
|
317
|
+
</Button>
|
|
318
|
+
<Button variant="ghost" size="sm" onClick={() => setExpanded([])}>
|
|
319
|
+
Collapse all
|
|
320
|
+
</Button>
|
|
321
|
+
</div>
|
|
322
|
+
<Tree
|
|
323
|
+
aria-label="Shop storefront files"
|
|
324
|
+
items={project}
|
|
325
|
+
expanded={expanded}
|
|
326
|
+
onExpandedChange={setExpanded}
|
|
327
|
+
guides={false}
|
|
328
|
+
/>
|
|
329
|
+
</div>
|
|
330
|
+
);
|
|
331
|
+
}
|
|
332
|
+
|
|
333
|
+
/* A large tree: eleven years of a camera's photos by month, every folder open. */
|
|
334
|
+
```
|
|
335
|
+
|
|
336
|
+
### Large trees
|
|
337
|
+
|
|
338
|
+
Past 500 nodes only the rows in view and a few either side render — here eleven years of photos, every folder open — and `virtualized` forces it either way. Rows look the same, and the keyboard still reaches every one: the row it moves to is rendered and scrolled into view before taking focus, and the focused row stays rendered when scrolled away.
|
|
339
|
+
|
|
340
|
+
```tsx
|
|
341
|
+
import { ScrollArea, Tree, type TreeNode } from "@zonsh/ui";
|
|
342
|
+
import { FolderIcon, FolderOpenIcon, ImageIcon } from "lucide-react";
|
|
343
|
+
|
|
344
|
+
// folder: as in the first example on this page that uses them.
|
|
345
|
+
|
|
346
|
+
const months = [
|
|
347
|
+
"January",
|
|
348
|
+
"February",
|
|
349
|
+
"March",
|
|
350
|
+
"April",
|
|
351
|
+
"May",
|
|
352
|
+
"June",
|
|
353
|
+
"July",
|
|
354
|
+
"August",
|
|
355
|
+
"September",
|
|
356
|
+
"October",
|
|
357
|
+
"November",
|
|
358
|
+
"December",
|
|
359
|
+
];
|
|
360
|
+
|
|
361
|
+
const PER_MONTH = 36;
|
|
362
|
+
|
|
363
|
+
/** Year by year, month by month, as on the card: the camera's counter runs on down the list. */
|
|
364
|
+
const library: TreeNode[] = Array.from({ length: 11 }, (_, y) => ({
|
|
365
|
+
id: `${2016 + y}`,
|
|
366
|
+
label: `${2016 + y}`,
|
|
367
|
+
icon: folder,
|
|
368
|
+
children: months.map((month, m) => ({
|
|
369
|
+
id: `${2016 + y}/${month}`,
|
|
370
|
+
label: month,
|
|
371
|
+
icon: folder,
|
|
372
|
+
children: Array.from({ length: PER_MONTH }, (_, i) => {
|
|
373
|
+
const name = `IMG_${String((y * 12 + m) * PER_MONTH + i + 1).padStart(4, "0")}.jpg`;
|
|
374
|
+
return { id: `${2016 + y}/${month}/${name}`, label: name, icon: <ImageIcon /> };
|
|
375
|
+
}),
|
|
376
|
+
})),
|
|
377
|
+
}));
|
|
378
|
+
|
|
379
|
+
const libraryFolders = library.flatMap((year) => [year.id, ...year.children!.map((month) => month.id)]);
|
|
380
|
+
|
|
381
|
+
const libraryRows = libraryFolders.length + library.length * months.length * PER_MONTH;
|
|
382
|
+
|
|
383
|
+
export function Large() {
|
|
384
|
+
return (
|
|
385
|
+
<div className="flex w-full max-w-72 flex-col gap-3">
|
|
386
|
+
{/* Room for the focus ring, and rows that stop beside the scrollbar. */}
|
|
387
|
+
<ScrollArea className="h-80" contentClassName="p-0.5 pe-3">
|
|
388
|
+
<Tree
|
|
389
|
+
aria-label="Photo library"
|
|
390
|
+
items={library}
|
|
391
|
+
defaultExpanded={libraryFolders}
|
|
392
|
+
defaultSelected={["2016/January/IMG_0003.jpg"]}
|
|
393
|
+
/>
|
|
394
|
+
</ScrollArea>
|
|
395
|
+
<p className="m-0 font-mono text-xs text-muted-foreground">
|
|
396
|
+
{libraryRows.toLocaleString("en")} rows, every folder open
|
|
397
|
+
</p>
|
|
398
|
+
</div>
|
|
399
|
+
);
|
|
400
|
+
}
|
|
401
|
+
```
|
|
402
|
+
|
|
403
|
+
It scrolls with whatever box scrolls, or the page — no ref or height needed; the server renders the first screenful. Trade-offs:
|
|
404
|
+
|
|
405
|
+
- Branches open and close at once, without easing.
|
|
406
|
+
- Find in page, printing and browse mode see only rendered rows.
|
|
407
|
+
- Row heights are measured as rows come into view, so custom labels that wrap make the scroll length settle; plain labels truncate.
|
|
408
|
+
|
|
409
|
+
## Props
|
|
410
|
+
|
|
411
|
+
| Prop | Type | Default |
|
|
412
|
+
| --------------------------------------------------- | ----------------------------------- | -------------- |
|
|
413
|
+
| `items` | `TreeNode[]` | — |
|
|
414
|
+
| `size` | `"default" \| "sm"` | `"default"` |
|
|
415
|
+
| `selectionMode` | `"single" \| "multiple" \| "none"` | `"single"` |
|
|
416
|
+
| `selected` / `defaultSelected` / `onSelectedChange` | `string[]` | `[]` |
|
|
417
|
+
| `expanded` / `defaultExpanded` / `onExpandedChange` | `string[]` (branch ids) | `[]` |
|
|
418
|
+
| `onAction` | `(node, event) => void` | — |
|
|
419
|
+
| `guides` | `boolean` | `true` |
|
|
420
|
+
| `virtualized` | `boolean` — render the rows in view | past 500 nodes |
|
|
421
|
+
| `aria-label` / `aria-labelledby` | `string` — required, names the tree | — |
|
|
422
|
+
|
|
423
|
+
Other `<ul>` attributes and `ref` go to the `tree` element.
|
|
424
|
+
|
|
425
|
+
`TreeNode`:
|
|
426
|
+
|
|
427
|
+
| Field | Type | Notes |
|
|
428
|
+
| ----------- | ----------------------------------------------------------- | ---------------------------------------------------------- |
|
|
429
|
+
| `id` | `string` | Unique across the whole tree; development warns otherwise. |
|
|
430
|
+
| `label` | `ReactNode` | Truncates to one line. |
|
|
431
|
+
| `icon` | `ReactNode \| ({ expanded, selected, level }) => ReactNode` | A 16px lucide icon; the function form opens a folder. |
|
|
432
|
+
| `meta` | `ReactNode` | Mono, muted, at the row's end. |
|
|
433
|
+
| `children` | `TreeNode[]` | Makes the node a branch, even when empty. |
|
|
434
|
+
| `disabled` | `boolean` | Focusable; cannot be selected, opened or followed. |
|
|
435
|
+
| `href` | `string` | The row renders as a link. |
|
|
436
|
+
| `textValue` | `string` | What type-ahead matches when `label` is not plain text. |
|
|
437
|
+
|
|
438
|
+
Selection is always an id list, even in `single` mode. Clicking a branch selects and toggles it; its chevron only toggles. Children mount on first open and stay. Clicks fold with easing; keys fold at once.
|
|
439
|
+
|
|
440
|
+
Slots: `tree`, `tree-item` (the `treeitem`), `tree-row`, `tree-chevron` (`tree-chevron-space` on a leaf), `tree-icon`, `tree-label`, `tree-meta`, `tree-group` and the `tree-group-frame` around it that opens and closes. A virtual tree has `tree-guide` and `tree-spacer` (the height of unrendered rows) instead of groups, and `data-virtualized` on the tree. A selected row has `data-selected`, a disabled one `data-disabled`.
|
|
441
|
+
|
|
442
|
+
## Brand rules
|
|
443
|
+
|
|
444
|
+
- **Do** keep labels short and let them truncate.
|
|
445
|
+
- **Do** use one icon per kind of node; an opening folder is the only moving icon.
|
|
446
|
+
- **Do** colour a `meta` mark only for a status, paired with text (a letter, a count), a title and a screen-reader word.
|
|
447
|
+
- **Don't** put buttons or inputs in rows: a treeitem is one focusable thing. Use a `ContextMenu` or a toolbar above.
|
|
448
|
+
- **Don't** nest past four or five levels.
|
|
449
|
+
- **Don't** box the tree in a card in a sidebar.
|
|
450
|
+
|
|
451
|
+
## Accessibility
|
|
452
|
+
|
|
453
|
+
- The WAI-ARIA tree pattern: `role="tree"`, `treeitem` and `group`, with `aria-level`, `aria-posinset`, `aria-setsize`, `aria-expanded` on branches, `aria-selected` (unless `selectionMode="none"`) and `aria-multiselectable` in `multiple` mode. A virtual tree reads the same.
|
|
454
|
+
- One tab stop, with a roving tabindex.
|
|
455
|
+
- In a navigation tree the selected link has `aria-current="page"`.
|
|
456
|
+
- Name the tree with `aria-label` or `aria-labelledby`. Icons and chevrons are `aria-hidden`; the focus ring is on the focused row only.
|
|
457
|
+
- When the focused node leaves `items` (deleted or replaced), focus moves to the row taking its place — the next, else the previous — not to the page.
|
|
458
|
+
|
|
459
|
+
### Keyboard
|
|
460
|
+
|
|
461
|
+
| Key | What it does |
|
|
462
|
+
| ------------------------ | -------------------------------------------------------------------------- |
|
|
463
|
+
| Tab | Moves into the tree on the selected row, or the first, and out again |
|
|
464
|
+
| ↓ / ↑ | Moves to the next or previous visible row |
|
|
465
|
+
| → | Opens a closed branch, or moves to its first child (swapped right to left) |
|
|
466
|
+
| ← | Closes an open branch, or moves to its parent (swapped right to left) |
|
|
467
|
+
| Home / End | Moves to the first or last visible row |
|
|
468
|
+
| \* | Opens every branch beside the focused row |
|
|
469
|
+
| Letters | Moves to the next row whose label starts with what was typed |
|
|
470
|
+
| Enter | Selects the row and activates it: follows its link, or calls `onAction` |
|
|
471
|
+
| Space | Selects the row, or toggles it in `multiple` mode |
|
|
472
|
+
| Shift+Space | Selects the range from the anchor to the row (`multiple`) |
|
|
473
|
+
| Shift+↓ / ↑ / Home / End | Moves and grows or shrinks the range from the anchor (`multiple`) |
|
|
474
|
+
| ⌘A / Ctrl+A | Selects every row (`multiple`) |
|
|
475
|
+
|
|
476
|
+
Letters typed within half a second make one prefix; a single letter pressed again cycles through the rows that start with it. ⌘A is for a Mac, Ctrl+A for everything else.
|
|
477
|
+
|
|
478
|
+
---
|
|
479
|
+
|
|
480
|
+
- Import: `import { Tree } from "@zonsh/ui"`
|
|
481
|
+
- Source: `packages/ui/src/components/tree.tsx`
|