@zonsh/ui 0.4.1 → 0.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +639 -0
- package/README.md +49 -21
- package/dist/brand.d.ts +3 -0
- package/dist/brand.js +7 -0
- package/dist/components/_breadcrumb-more.d.ts +6 -0
- package/dist/components/_breadcrumb-more.js +5 -0
- package/dist/components/_drawing-svg.d.ts +11 -0
- package/dist/components/_drawing-svg.js +30 -0
- package/dist/components/_media.d.ts +159 -0
- package/dist/components/_media.js +266 -0
- package/dist/components/_overlay.d.ts +8 -5
- package/dist/components/_overlay.js +11 -6
- package/dist/components/_scheduler-calendar.d.ts +71 -0
- package/dist/components/_scheduler-calendar.js +940 -0
- package/dist/components/_scheduler-editor.d.ts +29 -0
- package/dist/components/_scheduler-editor.js +111 -0
- package/dist/components/_scheduler-menu.d.ts +16 -0
- package/dist/components/_scheduler-menu.js +18 -0
- package/dist/components/_scheduler-parts.d.ts +164 -0
- package/dist/components/_scheduler-parts.js +327 -0
- package/dist/components/_suggest-list.d.ts +142 -0
- package/dist/components/_suggest-list.js +159 -0
- package/dist/components/_toolbar-more.d.ts +24 -0
- package/dist/components/_toolbar-more.js +25 -0
- package/dist/components/accordion.d.ts +1 -1
- package/dist/components/accordion.js +7 -7
- package/dist/components/action-sheet.d.ts +88 -0
- package/dist/components/action-sheet.js +124 -0
- package/dist/components/alert-dialog.js +3 -1
- package/dist/components/alert.d.ts +11 -18
- package/dist/components/alert.js +9 -6
- package/dist/components/app-bar.d.ts +93 -0
- package/dist/components/app-bar.js +175 -0
- package/dist/components/ascii-field.js +2 -1
- package/dist/components/audio-player.d.ts +134 -0
- package/dist/components/audio-player.js +618 -0
- package/dist/components/avatar.d.ts +6 -6
- package/dist/components/avatar.js +13 -11
- package/dist/components/badge.d.ts +12 -12
- package/dist/components/badge.js +7 -5
- package/dist/components/bottom-nav.d.ts +53 -11
- package/dist/components/bottom-nav.js +389 -24
- package/dist/components/breadcrumb.d.ts +11 -2
- package/dist/components/breadcrumb.js +60 -6
- package/dist/components/button-group.js +5 -1
- package/dist/components/button.d.ts +23 -6
- package/dist/components/button.js +64 -8
- package/dist/components/calendar.js +8 -6
- package/dist/components/card.d.ts +10 -8
- package/dist/components/card.js +15 -14
- package/dist/components/carousel.d.ts +2 -2
- package/dist/components/carousel.js +21 -8
- package/dist/components/chart.d.ts +38 -1
- package/dist/components/chart.js +27 -5
- package/dist/components/checkbox.js +2 -2
- package/dist/components/code-block.d.ts +9 -2
- package/dist/components/code-block.js +26 -7
- package/dist/components/collapsible.js +4 -4
- package/dist/components/color-picker.d.ts +2 -2
- package/dist/components/color-picker.js +5 -5
- package/dist/components/combobox.d.ts +26 -7
- package/dist/components/combobox.js +32 -13
- package/dist/components/command.d.ts +29 -5
- package/dist/components/command.js +37 -12
- package/dist/components/context-menu.d.ts +5 -2
- package/dist/components/context-menu.js +24 -3
- package/dist/components/conversation.d.ts +1 -1
- package/dist/components/conversation.js +77 -16
- package/dist/components/copy-button.d.ts +1 -1
- package/dist/components/copy-button.js +8 -6
- package/dist/components/data-table.d.ts +6 -6
- package/dist/components/data-table.js +41 -15
- package/dist/components/date-picker.d.ts +31 -9
- package/dist/components/date-picker.js +100 -18
- package/dist/components/dialog.d.ts +17 -10
- package/dist/components/dialog.js +20 -13
- package/dist/components/drawer.d.ts +26 -8
- package/dist/components/drawer.js +75 -16
- package/dist/components/drawing.d.ts +25 -0
- package/dist/components/drawing.js +32 -0
- package/dist/components/empty.js +2 -2
- package/dist/components/feature-list.d.ts +65 -13
- package/dist/components/feature-list.js +116 -15
- package/dist/components/field.js +2 -2
- package/dist/components/file-drop.d.ts +9 -7
- package/dist/components/file-drop.js +8 -43
- package/dist/components/filter-bar.d.ts +10 -9
- package/dist/components/filter-bar.js +42 -25
- package/dist/components/graph.d.ts +19 -3
- package/dist/components/graph.js +190 -28
- package/dist/components/illustration.js +53 -31
- package/dist/components/input-group.d.ts +6 -11
- package/dist/components/input-group.js +21 -19
- package/dist/components/input.d.ts +2 -2
- package/dist/components/input.js +3 -3
- package/dist/components/item.d.ts +9 -6
- package/dist/components/item.js +13 -8
- package/dist/components/kbd.d.ts +1 -1
- package/dist/components/kbd.js +1 -1
- package/dist/components/layout.d.ts +2 -1
- package/dist/components/layout.js +55 -11
- package/dist/components/lightbox.d.ts +76 -9
- package/dist/components/lightbox.js +354 -48
- package/dist/components/locale.d.ts +6 -6
- package/dist/components/logo.d.ts +21 -1
- package/dist/components/logo.js +32 -2
- package/dist/components/markdown-editor.d.ts +275 -0
- package/dist/components/markdown-editor.js +831 -0
- package/dist/components/mentions.d.ts +153 -0
- package/dist/components/mentions.js +507 -0
- package/dist/components/menu.d.ts +2 -1
- package/dist/components/menu.js +5 -4
- package/dist/components/menubar.d.ts +23 -5
- package/dist/components/menubar.js +153 -31
- package/dist/components/message.d.ts +62 -11
- package/dist/components/message.js +51 -14
- package/dist/components/meter.js +1 -1
- package/dist/components/money-input.d.ts +1 -1
- package/dist/components/money-input.js +1 -1
- package/dist/components/native-select.d.ts +2 -2
- package/dist/components/native-select.js +4 -4
- package/dist/components/navigation-menu.d.ts +3 -1
- package/dist/components/navigation-menu.js +23 -10
- package/dist/components/number-field.d.ts +2 -9
- package/dist/components/number-field.js +90 -26
- package/dist/components/number-roll.d.ts +26 -0
- package/dist/components/number-roll.js +81 -0
- package/dist/components/otp-field.d.ts +1 -1
- package/dist/components/otp-field.js +24 -3
- package/dist/components/pagination.d.ts +11 -3
- package/dist/components/pagination.js +59 -13
- package/dist/components/pdf-viewer.d.ts +1 -1
- package/dist/components/pdf-viewer.js +8 -8
- package/dist/components/phone-input.d.ts +1 -1
- package/dist/components/phone-input.js +2 -2
- package/dist/components/popover.js +5 -3
- package/dist/components/preview-card.d.ts +37 -2
- package/dist/components/preview-card.js +226 -2
- package/dist/components/progress.js +1 -1
- package/dist/components/prompt-input.d.ts +1 -1
- package/dist/components/prompt-input.js +35 -17
- package/dist/components/pull-to-refresh.d.ts +50 -0
- package/dist/components/pull-to-refresh.js +189 -0
- package/dist/components/quote.d.ts +6 -1
- package/dist/components/quote.js +3 -2
- package/dist/components/radio-group.js +8 -3
- package/dist/components/rating.d.ts +4 -1
- package/dist/components/rating.js +131 -10
- package/dist/components/reasoning.d.ts +1 -1
- package/dist/components/reasoning.js +7 -3
- package/dist/components/resizable.d.ts +1 -1
- package/dist/components/resizable.js +2 -2
- package/dist/components/response.d.ts +4 -3
- package/dist/components/response.js +39 -15
- package/dist/components/scheduler.d.ts +352 -0
- package/dist/components/scheduler.js +1717 -0
- package/dist/components/scroll-area.js +1 -1
- package/dist/components/select.d.ts +17 -4
- package/dist/components/select.js +140 -9
- package/dist/components/separator.d.ts +1 -1
- package/dist/components/separator.js +3 -3
- package/dist/components/sidebar.d.ts +44 -3
- package/dist/components/sidebar.js +90 -31
- package/dist/components/site-header.d.ts +18 -13
- package/dist/components/site-header.js +26 -9
- package/dist/components/skeleton.d.ts +18 -8
- package/dist/components/skeleton.js +23 -8
- package/dist/components/slider.js +2 -2
- package/dist/components/sortable.d.ts +55 -4
- package/dist/components/sortable.js +187 -94
- package/dist/components/sources.d.ts +1 -1
- package/dist/components/sources.js +2 -2
- package/dist/components/spinner.d.ts +4 -4
- package/dist/components/spinner.js +4 -4
- package/dist/components/stat.d.ts +21 -4
- package/dist/components/stat.js +17 -8
- package/dist/components/stepper.d.ts +1 -1
- package/dist/components/stepper.js +8 -7
- package/dist/components/suggestions.d.ts +11 -3
- package/dist/components/suggestions.js +10 -4
- package/dist/components/swipe-actions.d.ts +66 -0
- package/dist/components/swipe-actions.js +292 -0
- package/dist/components/switch.js +1 -1
- package/dist/components/table.d.ts +13 -7
- package/dist/components/table.js +124 -23
- package/dist/components/tabs.js +15 -8
- package/dist/components/tag.d.ts +19 -20
- package/dist/components/tag.js +9 -5
- package/dist/components/tags-input.d.ts +2 -7
- package/dist/components/tags-input.js +11 -8
- package/dist/components/textarea.d.ts +3 -2
- package/dist/components/textarea.js +4 -3
- package/dist/components/theme.d.ts +50 -7
- package/dist/components/theme.js +168 -12
- package/dist/components/time-field.d.ts +6 -10
- package/dist/components/time-field.js +19 -9
- package/dist/components/timeline.d.ts +19 -3
- package/dist/components/timeline.js +21 -9
- package/dist/components/tippy.d.ts +17 -1
- package/dist/components/tippy.js +95 -15
- package/dist/components/toast.d.ts +2 -7
- package/dist/components/toast.js +12 -8
- package/dist/components/toggle-group.d.ts +7 -1
- package/dist/components/toggle-group.js +17 -5
- package/dist/components/toggle.d.ts +2 -2
- package/dist/components/toggle.js +3 -2
- package/dist/components/tool-call.d.ts +1 -1
- package/dist/components/tool-call.js +8 -3
- package/dist/components/toolbar.d.ts +57 -4
- package/dist/components/toolbar.js +219 -16
- package/dist/components/tooltip.d.ts +5 -3
- package/dist/components/tooltip.js +14 -6
- package/dist/components/tour.d.ts +1 -1
- package/dist/components/tour.js +70 -24
- package/dist/components/tree.js +33 -10
- package/dist/components/typography.d.ts +31 -8
- package/dist/components/typography.js +21 -10
- package/dist/components/video-player.d.ts +7 -2
- package/dist/components/video-player.js +182 -225
- package/dist/index.d.ts +99 -92
- package/dist/index.js +99 -92
- package/dist/lib/calendar.d.ts +153 -0
- package/dist/lib/calendar.js +312 -0
- package/dist/lib/cn.d.ts +3 -1
- package/dist/lib/cn.js +5 -0
- package/dist/lib/code-highlight.d.ts +14 -0
- package/dist/lib/code-highlight.js +81 -18
- package/dist/lib/drag.d.ts +39 -0
- package/dist/lib/drag.js +96 -0
- package/dist/lib/editorial-assets.js +16 -8
- package/dist/lib/figure/figures/automation.js +25 -6
- package/dist/lib/figure/figures/bar-chart.js +6 -1
- package/dist/lib/figure/figures/brackets-classic.js +4 -1
- package/dist/lib/figure/figures/city.js +12 -2
- package/dist/lib/figure/figures/conveyor.js +17 -4
- package/dist/lib/figure/figures/database.js +5 -2
- package/dist/lib/figure/figures/documents.js +11 -3
- package/dist/lib/figure/figures/inbox.js +5 -2
- package/dist/lib/figure/figures/laptop.js +3 -1
- package/dist/lib/figure/figures/pipeline.js +45 -10
- package/dist/lib/figure/figures/platform.js +62 -7
- package/dist/lib/figure/figures/server.js +21 -5
- package/dist/lib/figure/figures/spreadsheet.js +29 -5
- package/dist/lib/figure/kernel.d.ts +4 -2
- package/dist/lib/figure/kernel.js +10 -5
- package/dist/lib/figure/parts.js +6 -2
- package/dist/lib/files.d.ts +31 -0
- package/dist/lib/files.js +60 -0
- package/dist/lib/gesture.d.ts +70 -0
- package/dist/lib/gesture.js +141 -0
- package/dist/lib/glide.d.ts +10 -4
- package/dist/lib/glide.js +14 -5
- package/dist/lib/icons.d.ts +1 -0
- package/dist/lib/icons.js +6 -0
- package/dist/lib/illustration-library.js +1 -6
- package/dist/lib/markdown-edit.d.ts +112 -0
- package/dist/lib/markdown-edit.js +557 -0
- package/dist/lib/markdown-rich-editor.d.ts +188 -0
- package/dist/lib/markdown-rich-editor.js +1153 -0
- package/dist/lib/markdown-rich.d.ts +63 -0
- package/dist/lib/markdown-rich.js +534 -0
- package/dist/lib/mentions.d.ts +100 -0
- package/dist/lib/mentions.js +246 -0
- package/dist/lib/motion.d.ts +18 -0
- package/dist/lib/motion.js +43 -5
- package/dist/lib/number-roll.d.ts +89 -0
- package/dist/lib/number-roll.js +391 -0
- package/dist/lib/platform.d.ts +6 -0
- package/dist/lib/platform.js +14 -0
- package/dist/lib/portal-container.d.ts +9 -0
- package/dist/lib/portal-container.js +10 -0
- package/dist/lib/press.d.ts +5 -0
- package/dist/lib/press.js +186 -0
- package/dist/lib/scheduler.d.ts +128 -0
- package/dist/lib/scheduler.js +272 -0
- package/dist/lib/scroll-edges.d.ts +9 -0
- package/dist/lib/scroll-edges.js +50 -0
- package/dist/lib/table-fit.d.ts +4 -3
- package/dist/lib/table-fit.js +92 -25
- package/dist/lib/theme-preset.d.ts +267 -0
- package/dist/lib/theme-preset.js +1046 -0
- package/dist/lib/theme-script.d.ts +23 -3
- package/dist/lib/theme-script.js +17 -5
- package/dist/lib/tippy/sprite.d.ts +36 -4
- package/dist/lib/tippy/sprite.js +188 -15
- package/dist/lib/tone.d.ts +4 -0
- package/dist/lib/tone.js +1 -0
- package/dist/messages/de.d.ts +3 -3
- package/dist/messages/de.js +274 -3
- package/dist/skills/zon-ui/SKILL.md +279 -0
- package/dist/skills/zon-ui/references/authoring.md +265 -0
- package/dist/skills/zon-ui/references/brand.md +416 -0
- package/dist/skills/zon-ui/references/components/accordion.md +199 -0
- package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
- package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
- package/dist/skills/zon-ui/references/components/alert.md +167 -0
- package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
- package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
- package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
- package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
- package/dist/skills/zon-ui/references/components/avatar.md +98 -0
- package/dist/skills/zon-ui/references/components/badge.md +227 -0
- package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
- package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
- package/dist/skills/zon-ui/references/components/button-group.md +216 -0
- package/dist/skills/zon-ui/references/components/button.md +309 -0
- package/dist/skills/zon-ui/references/components/calendar.md +296 -0
- package/dist/skills/zon-ui/references/components/card.md +158 -0
- package/dist/skills/zon-ui/references/components/carousel.md +297 -0
- package/dist/skills/zon-ui/references/components/chart.md +739 -0
- package/dist/skills/zon-ui/references/components/chat.md +417 -0
- package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
- package/dist/skills/zon-ui/references/components/code-block.md +143 -0
- package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
- package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
- package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
- package/dist/skills/zon-ui/references/components/combobox.md +455 -0
- package/dist/skills/zon-ui/references/components/command.md +326 -0
- package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
- package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
- package/dist/skills/zon-ui/references/components/conversation.md +146 -0
- package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
- package/dist/skills/zon-ui/references/components/crm.md +1022 -0
- package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
- package/dist/skills/zon-ui/references/components/data-table.md +776 -0
- package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
- package/dist/skills/zon-ui/references/components/dialog.md +335 -0
- package/dist/skills/zon-ui/references/components/direction.md +165 -0
- package/dist/skills/zon-ui/references/components/drawer.md +276 -0
- package/dist/skills/zon-ui/references/components/drawing.md +94 -0
- package/dist/skills/zon-ui/references/components/empty.md +225 -0
- package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
- package/dist/skills/zon-ui/references/components/field.md +209 -0
- package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
- package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
- package/dist/skills/zon-ui/references/components/form.md +970 -0
- package/dist/skills/zon-ui/references/components/graph.md +339 -0
- package/dist/skills/zon-ui/references/components/illustration.md +497 -0
- package/dist/skills/zon-ui/references/components/inbox.md +263 -0
- package/dist/skills/zon-ui/references/components/input-group.md +339 -0
- package/dist/skills/zon-ui/references/components/input.md +189 -0
- package/dist/skills/zon-ui/references/components/item.md +277 -0
- package/dist/skills/zon-ui/references/components/kanban.md +626 -0
- package/dist/skills/zon-ui/references/components/kbd.md +116 -0
- package/dist/skills/zon-ui/references/components/label.md +104 -0
- package/dist/skills/zon-ui/references/components/layout.md +291 -0
- package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
- package/dist/skills/zon-ui/references/components/locale.md +279 -0
- package/dist/skills/zon-ui/references/components/logo.md +257 -0
- package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
- package/dist/skills/zon-ui/references/components/mentions.md +512 -0
- package/dist/skills/zon-ui/references/components/menu.md +218 -0
- package/dist/skills/zon-ui/references/components/menubar.md +292 -0
- package/dist/skills/zon-ui/references/components/message.md +243 -0
- package/dist/skills/zon-ui/references/components/meter.md +105 -0
- package/dist/skills/zon-ui/references/components/money-input.md +333 -0
- package/dist/skills/zon-ui/references/components/native-select.md +197 -0
- package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
- package/dist/skills/zon-ui/references/components/number-field.md +210 -0
- package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
- package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
- package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
- package/dist/skills/zon-ui/references/components/pagination.md +109 -0
- package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
- package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
- package/dist/skills/zon-ui/references/components/popover.md +176 -0
- package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
- package/dist/skills/zon-ui/references/components/pricing.md +724 -0
- package/dist/skills/zon-ui/references/components/progress.md +92 -0
- package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
- package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
- package/dist/skills/zon-ui/references/components/quote.md +115 -0
- package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
- package/dist/skills/zon-ui/references/components/rating.md +260 -0
- package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
- package/dist/skills/zon-ui/references/components/resizable.md +213 -0
- package/dist/skills/zon-ui/references/components/response.md +170 -0
- package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
- package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
- package/dist/skills/zon-ui/references/components/select.md +351 -0
- package/dist/skills/zon-ui/references/components/separator.md +103 -0
- package/dist/skills/zon-ui/references/components/settings.md +793 -0
- package/dist/skills/zon-ui/references/components/shop.md +1715 -0
- package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
- package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
- package/dist/skills/zon-ui/references/components/site-header.md +303 -0
- package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
- package/dist/skills/zon-ui/references/components/slider.md +172 -0
- package/dist/skills/zon-ui/references/components/sortable.md +405 -0
- package/dist/skills/zon-ui/references/components/sources.md +106 -0
- package/dist/skills/zon-ui/references/components/spinner.md +222 -0
- package/dist/skills/zon-ui/references/components/stat.md +267 -0
- package/dist/skills/zon-ui/references/components/stepper.md +285 -0
- package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
- package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
- package/dist/skills/zon-ui/references/components/switch.md +160 -0
- package/dist/skills/zon-ui/references/components/table.md +999 -0
- package/dist/skills/zon-ui/references/components/tabs.md +258 -0
- package/dist/skills/zon-ui/references/components/tag.md +115 -0
- package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
- package/dist/skills/zon-ui/references/components/textarea.md +95 -0
- package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
- package/dist/skills/zon-ui/references/components/theme.md +362 -0
- package/dist/skills/zon-ui/references/components/time-field.md +222 -0
- package/dist/skills/zon-ui/references/components/timeline.md +285 -0
- package/dist/skills/zon-ui/references/components/tippy.md +243 -0
- package/dist/skills/zon-ui/references/components/toast.md +220 -0
- package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
- package/dist/skills/zon-ui/references/components/toggle.md +167 -0
- package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
- package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
- package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
- package/dist/skills/zon-ui/references/components/tour.md +423 -0
- package/dist/skills/zon-ui/references/components/tree.md +481 -0
- package/dist/skills/zon-ui/references/components/typography.md +347 -0
- package/dist/skills/zon-ui/references/components/video-player.md +386 -0
- package/dist/skills/zon-ui/references/marketing.md +467 -0
- package/dist/skills/zon-ui/references/motion.md +455 -0
- package/dist/skills/zon-ui/references/recipes.md +1232 -0
- package/dist/skills/zon-ui/references/tokens.md +866 -0
- package/dist/sources/accordion.css +4 -0
- package/dist/sources/action-sheet.css +11 -0
- package/dist/sources/alert-dialog.css +6 -0
- package/dist/sources/alert.css +3 -0
- package/dist/sources/app-bar.css +14 -0
- package/dist/sources/ascii-field.css +3 -0
- package/dist/sources/aspect-ratio.css +3 -0
- package/dist/sources/audio-player.css +20 -0
- package/dist/sources/avatar.css +3 -0
- package/dist/sources/badge.css +3 -0
- package/dist/sources/bottom-nav.css +9 -0
- package/dist/sources/breadcrumb.css +14 -0
- package/dist/sources/button-group.css +3 -0
- package/dist/sources/button.css +9 -0
- package/dist/sources/calendar.css +13 -0
- package/dist/sources/card.css +3 -0
- package/dist/sources/carousel.css +11 -0
- package/dist/sources/chart.css +5 -0
- package/dist/sources/checkbox.css +6 -0
- package/dist/sources/code-block.css +13 -0
- package/dist/sources/collapsible.css +4 -0
- package/dist/sources/color-picker.css +13 -0
- package/dist/sources/combobox.css +13 -0
- package/dist/sources/command.css +13 -0
- package/dist/sources/context-menu.css +12 -0
- package/dist/sources/conversation.css +10 -0
- package/dist/sources/copy-button.css +10 -0
- package/dist/sources/data-table.css +27 -0
- package/dist/sources/date-picker.css +20 -0
- package/dist/sources/dialog.css +9 -0
- package/dist/sources/direction.css +2 -0
- package/dist/sources/drawer.css +9 -0
- package/dist/sources/drawing.css +5 -0
- package/dist/sources/empty.css +3 -0
- package/dist/sources/feature-list.css +4 -0
- package/dist/sources/field.css +4 -0
- package/dist/sources/file-drop.css +15 -0
- package/dist/sources/filter-bar.css +30 -0
- package/dist/sources/form.css +4 -0
- package/dist/sources/graph.css +19 -0
- package/dist/sources/illustration.css +28 -0
- package/dist/sources/input-group.css +7 -0
- package/dist/sources/input.css +3 -0
- package/dist/sources/item.css +4 -0
- package/dist/sources/kbd.css +5 -0
- package/dist/sources/label.css +3 -0
- package/dist/sources/layout.css +3 -0
- package/dist/sources/lightbox.css +33 -0
- package/dist/sources/locale.css +2 -0
- package/dist/sources/logo.css +4 -0
- package/dist/sources/markdown-editor.css +41 -0
- package/dist/sources/mentions.css +13 -0
- package/dist/sources/menu.css +11 -0
- package/dist/sources/menubar.css +14 -0
- package/dist/sources/message.css +16 -0
- package/dist/sources/meter.css +4 -0
- package/dist/sources/money-input.css +10 -0
- package/dist/sources/native-select.css +4 -0
- package/dist/sources/navigation-menu.css +8 -0
- package/dist/sources/number-field.css +8 -0
- package/dist/sources/number-roll.css +6 -0
- package/dist/sources/otp-field.css +5 -0
- package/dist/sources/pagination.css +11 -0
- package/dist/sources/pdf-viewer.css +30 -0
- package/dist/sources/phone-input.css +20 -0
- package/dist/sources/popover.css +7 -0
- package/dist/sources/preview-card.css +7 -0
- package/dist/sources/progress.css +4 -0
- package/dist/sources/prompt-input.css +15 -0
- package/dist/sources/pull-to-refresh.css +14 -0
- package/dist/sources/quote.css +3 -0
- package/dist/sources/radio-group.css +5 -0
- package/dist/sources/rating.css +6 -0
- package/dist/sources/reasoning.css +6 -0
- package/dist/sources/resizable.css +4 -0
- package/dist/sources/response.css +16 -0
- package/dist/sources/scheduler.css +44 -0
- package/dist/sources/scroll-area.css +3 -0
- package/dist/sources/select.css +12 -0
- package/dist/sources/separator.css +3 -0
- package/dist/sources/sidebar.css +19 -0
- package/dist/sources/site-header.css +15 -0
- package/dist/sources/skeleton.css +3 -0
- package/dist/sources/slider.css +6 -0
- package/dist/sources/sortable.css +12 -0
- package/dist/sources/sources.css +6 -0
- package/dist/sources/spinner.css +6 -0
- package/dist/sources/stat.css +9 -0
- package/dist/sources/stepper.css +6 -0
- package/dist/sources/suggestions.css +10 -0
- package/dist/sources/swipe-actions.css +20 -0
- package/dist/sources/switch.css +5 -0
- package/dist/sources/table.css +7 -0
- package/dist/sources/tabs.css +5 -0
- package/dist/sources/tag.css +3 -0
- package/dist/sources/tags-input.css +6 -0
- package/dist/sources/textarea.css +3 -0
- package/dist/sources/theme.css +13 -0
- package/dist/sources/time-field.css +7 -0
- package/dist/sources/timeline.css +7 -0
- package/dist/sources/tippy.css +6 -0
- package/dist/sources/toast.css +6 -0
- package/dist/sources/toggle-group.css +5 -0
- package/dist/sources/toggle.css +3 -0
- package/dist/sources/tool-call.css +16 -0
- package/dist/sources/toolbar.css +14 -0
- package/dist/sources/tooltip.css +6 -0
- package/dist/sources/tour.css +14 -0
- package/dist/sources/tree.css +6 -0
- package/dist/sources/typography.css +4 -0
- package/dist/sources/video-player.css +21 -0
- package/dist/styles/ai.css +3 -0
- package/dist/styles/brand.css +98 -0
- package/dist/styles/core.css +266 -0
- package/dist/styles/editor.css +3 -0
- package/dist/styles/expressive.css +75 -77
- package/dist/styles/fonts.css +61 -117
- package/dist/styles/graph.css +4 -0
- package/dist/styles/illustration.css +4 -0
- package/dist/styles/index.css +11 -193
- package/dist/styles/material.css +177 -31
- package/dist/styles/parts/ai.css +20 -14
- package/dist/styles/parts/brand.css +2 -2
- package/dist/styles/parts/controls.css +51 -38
- package/dist/styles/parts/data.css +43 -11
- package/dist/styles/parts/editor.css +372 -0
- package/dist/styles/parts/feedback.css +75 -15
- package/dist/styles/parts/foundations.css +12 -7
- package/dist/styles/parts/graph.css +25 -9
- package/dist/styles/parts/inputs.css +172 -9
- package/dist/styles/parts/isometric.css +6 -5
- package/dist/styles/parts/navigation.css +237 -25
- package/dist/styles/parts/overlays.css +110 -8
- package/dist/styles/parts/pdf.css +15 -9
- package/dist/styles/pdf.css +3 -0
- package/dist/styles/prose.css +3 -0
- package/dist/styles/tokens.css +105 -15
- package/dist/theme.d.ts +1 -0
- package/dist/theme.js +5 -0
- package/dist/vite.d.ts +48 -59
- package/dist/vite.js +54 -21
- package/package.json +69 -2
|
@@ -0,0 +1,339 @@
|
|
|
1
|
+
# Graph
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Graph, type GraphEdge, type GraphNode } from "@zonsh/ui/graph";
|
|
5
|
+
import { FileTextIcon, MailIcon, ShieldCheckIcon, SpellCheckIcon } from "lucide-react";
|
|
6
|
+
|
|
7
|
+
/** An article's way from draft to published, as a BPMN-style flow. */
|
|
8
|
+
const flowNodes: GraphNode[] = [
|
|
9
|
+
{ id: "start", kind: "start", label: "Draft submitted" },
|
|
10
|
+
{ id: "check", label: "Run the style check", meta: "automatic", icon: <SpellCheckIcon /> },
|
|
11
|
+
{ id: "edit", label: "Edit the draft", meta: "editor", icon: <FileTextIcon /> },
|
|
12
|
+
{ id: "ok", kind: "gateway", label: "Ready?" },
|
|
13
|
+
{ id: "approve", label: "Approve", meta: "editor-in-chief", icon: <ShieldCheckIcon /> },
|
|
14
|
+
{ id: "ask", label: "Ask the author", meta: "editor", icon: <MailIcon /> },
|
|
15
|
+
{ id: "wait", kind: "event", label: "Revision received" },
|
|
16
|
+
{ id: "schedule", label: "Schedule the post", meta: "editor" },
|
|
17
|
+
{ id: "end", kind: "end", label: "Published" },
|
|
18
|
+
{ id: "note", kind: "note", label: "Pieces that name a person get a second read." },
|
|
19
|
+
];
|
|
20
|
+
|
|
21
|
+
const flowEdges: GraphEdge[] = [
|
|
22
|
+
{ source: "start", target: "check" },
|
|
23
|
+
{ source: "check", target: "edit" },
|
|
24
|
+
{ source: "edit", target: "ok" },
|
|
25
|
+
{ source: "ok", target: "approve", label: "yes" },
|
|
26
|
+
{ source: "ok", target: "ask", label: "no" },
|
|
27
|
+
{ source: "ask", target: "wait", kind: "message" },
|
|
28
|
+
{ source: "wait", target: "edit" },
|
|
29
|
+
{ source: "approve", target: "schedule", animated: true },
|
|
30
|
+
{ source: "schedule", target: "end" },
|
|
31
|
+
{ source: "note", target: "approve", kind: "association" },
|
|
32
|
+
];
|
|
33
|
+
|
|
34
|
+
export function Flow() {
|
|
35
|
+
return <Graph aria-label="Article review flow" nodes={flowNodes} edges={flowEdges} layout="flow" />;
|
|
36
|
+
}
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
Things and how they connect, on a canvas you pan by dragging and zoom by wheel or pinch. Pass plain `nodes` and `edges` and the layout places them: a **flow** in ranks with right-angle, round-cornered edges; a **tree** in tiers from its root; a **network** settled under forces. Give every node a `position` to keep your own.
|
|
40
|
+
|
|
41
|
+
## Usage
|
|
42
|
+
|
|
43
|
+
Graph has its own entry, `@zonsh/ui/graph`, and needs three optional peers:
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
pnpm add @xyflow/react @dagrejs/dagre d3-force
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
```tsx
|
|
50
|
+
import { Graph } from "@zonsh/ui/graph";
|
|
51
|
+
|
|
52
|
+
<Graph
|
|
53
|
+
aria-label="Article review"
|
|
54
|
+
nodes={[
|
|
55
|
+
{ id: "start", kind: "start", label: "Draft submitted" },
|
|
56
|
+
{ id: "check", label: "Edit the draft" },
|
|
57
|
+
{ id: "end", kind: "end", label: "Published" },
|
|
58
|
+
]}
|
|
59
|
+
edges={[
|
|
60
|
+
{ source: "start", target: "check" },
|
|
61
|
+
{ source: "check", target: "end" },
|
|
62
|
+
]}
|
|
63
|
+
/>;
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
The props you'll reach for: `nodes` / `edges`, `layout` (`"flow"`, `"tree"`, `"network"`) and `aria-label`, which every graph needs. It fills its width and is 640px tall (at most 80% of the viewport); set a height with a class.
|
|
67
|
+
|
|
68
|
+
## When to use
|
|
69
|
+
|
|
70
|
+
- A **process** — BPMN-style tasks, events and gateways, in lanes for several roles.
|
|
71
|
+
- A **structure** — an org chart, dependency tree or sitemap: `layout="tree"`.
|
|
72
|
+
- **Relations** between people, systems or topics: `layout="network"`.
|
|
73
|
+
- A small diagram people **edit**: `editable`.
|
|
74
|
+
- Not for numbers over time or categories — use `Chart`. Not for a hierarchy people scan — a `Table` with groups (`fit` when its width varies) or a tree list reads faster.
|
|
75
|
+
|
|
76
|
+
## Examples
|
|
77
|
+
|
|
78
|
+
### Network
|
|
79
|
+
|
|
80
|
+
`entity` pills and `person` avatars; links are plain unless `directed`. `minimap` adds a draggable map in the corner.
|
|
81
|
+
|
|
82
|
+
```tsx
|
|
83
|
+
import { Graph, type GraphEdge, type GraphNode } from "@zonsh/ui/graph";
|
|
84
|
+
|
|
85
|
+
/** zon.sh and what it is made of. */
|
|
86
|
+
const zonNodes: GraphNode[] = [
|
|
87
|
+
{ id: "malik", kind: "person", label: "malik", meta: "builds and keeps" },
|
|
88
|
+
{ id: "zon", label: "zon.sh" },
|
|
89
|
+
{ id: "licht", label: "Licht", meta: "typeface" },
|
|
90
|
+
{ id: "gallery", label: "Gallery" },
|
|
91
|
+
{ id: "ui", label: "zon/ui" },
|
|
92
|
+
{ id: "docs", label: "zon.sh/ui" },
|
|
93
|
+
{ id: "openpanel", label: "openpanel" },
|
|
94
|
+
{ id: "eigenpair", label: "eigenpair" },
|
|
95
|
+
{ id: "sans", label: "Licht Sans" },
|
|
96
|
+
{ id: "base", label: "Base UI" },
|
|
97
|
+
];
|
|
98
|
+
|
|
99
|
+
const zonEdges: GraphEdge[] = [
|
|
100
|
+
{ source: "malik", target: "zon", label: "keeps" },
|
|
101
|
+
{ source: "malik", target: "licht", label: "draws" },
|
|
102
|
+
{ source: "malik", target: "openpanel" },
|
|
103
|
+
{ source: "malik", target: "eigenpair" },
|
|
104
|
+
{ source: "zon", target: "licht" },
|
|
105
|
+
{ source: "zon", target: "gallery" },
|
|
106
|
+
{ source: "zon", target: "docs" },
|
|
107
|
+
{ source: "docs", target: "ui" },
|
|
108
|
+
{ source: "ui", target: "licht", label: "headlines" },
|
|
109
|
+
{ source: "ui", target: "sans", label: "reading" },
|
|
110
|
+
{ source: "ui", target: "base", label: "built on" },
|
|
111
|
+
{ source: "gallery", target: "licht" },
|
|
112
|
+
];
|
|
113
|
+
|
|
114
|
+
export function Network() {
|
|
115
|
+
return (
|
|
116
|
+
<Graph
|
|
117
|
+
aria-label="zon.sh and what it is made of"
|
|
118
|
+
nodes={zonNodes}
|
|
119
|
+
edges={zonEdges}
|
|
120
|
+
layout="network"
|
|
121
|
+
minimap
|
|
122
|
+
/>
|
|
123
|
+
);
|
|
124
|
+
}
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
### Tree
|
|
128
|
+
|
|
129
|
+
An org chart of `person` nodes, root down.
|
|
130
|
+
|
|
131
|
+
```tsx
|
|
132
|
+
import { Graph, type GraphEdge, type GraphNode } from "@zonsh/ui/graph";
|
|
133
|
+
|
|
134
|
+
/** A small team. */
|
|
135
|
+
const team: GraphNode[] = [
|
|
136
|
+
{ id: "lea", kind: "person", label: "Lea Hoffmann", meta: "Lead" },
|
|
137
|
+
{ id: "jonas", kind: "person", label: "Jonas Weber", meta: "Engineering" },
|
|
138
|
+
{ id: "mira", kind: "person", label: "Mira Koch", meta: "Design" },
|
|
139
|
+
{ id: "tom", kind: "person", label: "Tom Becker", meta: "Accounts" },
|
|
140
|
+
{ id: "ana", kind: "person", label: "Ana Schulz", meta: "Engineer" },
|
|
141
|
+
{ id: "ben", kind: "person", label: "Ben Wolf", meta: "Engineer" },
|
|
142
|
+
{ id: "eva", kind: "person", label: "Eva Klein", meta: "Designer" },
|
|
143
|
+
];
|
|
144
|
+
|
|
145
|
+
const reports: GraphEdge[] = [
|
|
146
|
+
{ source: "lea", target: "jonas" },
|
|
147
|
+
{ source: "lea", target: "mira" },
|
|
148
|
+
{ source: "lea", target: "tom" },
|
|
149
|
+
{ source: "jonas", target: "ana" },
|
|
150
|
+
{ source: "jonas", target: "ben" },
|
|
151
|
+
{ source: "mira", target: "eva" },
|
|
152
|
+
];
|
|
153
|
+
|
|
154
|
+
export function Tree() {
|
|
155
|
+
return <Graph aria-label="Team" nodes={team} edges={reports} layout="tree" />;
|
|
156
|
+
}
|
|
157
|
+
```
|
|
158
|
+
|
|
159
|
+
### Lanes
|
|
160
|
+
|
|
161
|
+
`group` nodes hold the nodes that name them as `parent`: BPMN lanes, or clusters. Messages between lanes are dashed.
|
|
162
|
+
|
|
163
|
+
```tsx
|
|
164
|
+
import { Graph, type GraphEdge, type GraphNode } from "@zonsh/ui/graph";
|
|
165
|
+
|
|
166
|
+
/** The same review, in lanes: who does what. */
|
|
167
|
+
const laneNodes: GraphNode[] = [
|
|
168
|
+
{ id: "desk", kind: "group", label: "Editors" },
|
|
169
|
+
{ id: "chief", kind: "group", label: "Editor-in-chief" },
|
|
170
|
+
{ id: "s", kind: "start", label: "Draft submitted", parent: "desk" },
|
|
171
|
+
{ id: "check", label: "Edit the draft", parent: "desk" },
|
|
172
|
+
{ id: "decide", kind: "gateway", gateway: "exclusive", label: "Approve?", parent: "chief" },
|
|
173
|
+
{ id: "sign", label: "Sign off", parent: "chief" },
|
|
174
|
+
{ id: "book", label: "Schedule the post", parent: "desk" },
|
|
175
|
+
{ id: "e", kind: "end", label: "Published", parent: "desk" },
|
|
176
|
+
];
|
|
177
|
+
|
|
178
|
+
const laneEdges: GraphEdge[] = [
|
|
179
|
+
{ source: "s", target: "check" },
|
|
180
|
+
{ source: "check", target: "decide", kind: "message", label: "for sign-off" },
|
|
181
|
+
{ source: "decide", target: "sign", label: "yes" },
|
|
182
|
+
{ source: "sign", target: "book", kind: "message" },
|
|
183
|
+
{ source: "book", target: "e" },
|
|
184
|
+
];
|
|
185
|
+
|
|
186
|
+
export function Lanes() {
|
|
187
|
+
return <Graph aria-label="Article review in lanes" nodes={laneNodes} edges={laneEdges} layout="flow" />;
|
|
188
|
+
}
|
|
189
|
+
```
|
|
190
|
+
|
|
191
|
+
### Editable
|
|
192
|
+
|
|
193
|
+
`editable` makes a small diagram editor: drag from a node's handle onto another to connect them; right-click or long-press to add a step, decision, event or note, tidy or fit (canvas), rename or delete (node), or label, reverse or remove (connection). `onChange` receives the whole graph, positions included, after every change — pass it back as props and nothing is laid out again.
|
|
194
|
+
|
|
195
|
+
```tsx
|
|
196
|
+
import { Mono } from "@zonsh/ui";
|
|
197
|
+
import { Graph, type GraphValue } from "@zonsh/ui/graph";
|
|
198
|
+
import * as React from "react";
|
|
199
|
+
|
|
200
|
+
export function Editable() {
|
|
201
|
+
const [value, setValue] = React.useState<GraphValue>({
|
|
202
|
+
nodes: [
|
|
203
|
+
{ id: "a", kind: "start", label: "Start" },
|
|
204
|
+
{ id: "b", label: "First step" },
|
|
205
|
+
{ id: "c", label: "Second step" },
|
|
206
|
+
{ id: "d", kind: "end", label: "End" },
|
|
207
|
+
],
|
|
208
|
+
edges: [
|
|
209
|
+
{ source: "a", target: "b" },
|
|
210
|
+
{ source: "b", target: "c" },
|
|
211
|
+
{ source: "c", target: "d" },
|
|
212
|
+
],
|
|
213
|
+
});
|
|
214
|
+
return (
|
|
215
|
+
<div className="flex w-full flex-col gap-3">
|
|
216
|
+
<Graph
|
|
217
|
+
aria-label="A flow to edit"
|
|
218
|
+
className="h-auto min-h-120 flex-1"
|
|
219
|
+
nodes={value.nodes}
|
|
220
|
+
edges={value.edges}
|
|
221
|
+
layout="flow"
|
|
222
|
+
editable
|
|
223
|
+
onChange={setValue}
|
|
224
|
+
/>
|
|
225
|
+
<Mono className="text-xs text-muted-foreground">
|
|
226
|
+
{value.nodes.length} nodes · {value.edges.length} {value.edges.length === 1 ? "edge" : "edges"} —
|
|
227
|
+
right-click the canvas, a node or a connection; drag from a handle to connect
|
|
228
|
+
</Mono>
|
|
229
|
+
</div>
|
|
230
|
+
);
|
|
231
|
+
}
|
|
232
|
+
```
|
|
233
|
+
|
|
234
|
+
### Empty
|
|
235
|
+
|
|
236
|
+
With no nodes the canvas keeps its grid and controls and shows `emptyMessage` ("Nothing here yet. Add a node to start." when editable). It lets the pointer through, so right-click still opens the menu.
|
|
237
|
+
|
|
238
|
+
```tsx
|
|
239
|
+
import { Graph, type GraphValue } from "@zonsh/ui/graph";
|
|
240
|
+
import * as React from "react";
|
|
241
|
+
|
|
242
|
+
/** A new process with no steps yet: the canvas says how to start, and the controls are there to. */
|
|
243
|
+
export function Empty() {
|
|
244
|
+
const [value, setValue] = React.useState<GraphValue>({ nodes: [], edges: [] });
|
|
245
|
+
return (
|
|
246
|
+
<Graph
|
|
247
|
+
aria-label="Returns process"
|
|
248
|
+
className="h-96"
|
|
249
|
+
nodes={value.nodes}
|
|
250
|
+
edges={value.edges}
|
|
251
|
+
layout="flow"
|
|
252
|
+
editable
|
|
253
|
+
onChange={setValue}
|
|
254
|
+
emptyMessage="No steps yet. Add the first one with + below, or right-click the canvas."
|
|
255
|
+
/>
|
|
256
|
+
);
|
|
257
|
+
}
|
|
258
|
+
```
|
|
259
|
+
|
|
260
|
+
## Interaction
|
|
261
|
+
|
|
262
|
+
Hover or select a node and its connections light up while the rest steps back. In a network, a dragged node's neighbours follow (up to 300 nodes; larger networks move only the dragged node and take a few seconds to lay out). Tidy glides every node back into the layout, the camera framing the result on the same clock.
|
|
263
|
+
|
|
264
|
+
On a touch-only device it behaves like a map in a page: one finger scrolls past, two fingers pan and pinch, and a one-finger drag shows "Use two fingers to move the graph" (`labels.touchHint`). A tap lights up a node's connections. Only an `editable` graph lets one finger drag a node or draw a connection.
|
|
265
|
+
|
|
266
|
+
## Nodes and edges
|
|
267
|
+
|
|
268
|
+
| Kind | Drawn as | For |
|
|
269
|
+
| --------- | -------------------------------------------------------------------------- | -------------------------- |
|
|
270
|
+
| `task` | a raised box, 12px corners, label, optional `icon` and mono `meta` | a step (flow default) |
|
|
271
|
+
| `start` | a thin ring, the label under it | where a flow begins |
|
|
272
|
+
| `end` | a thick ring | where it ends |
|
|
273
|
+
| `event` | a double ring | something that happens |
|
|
274
|
+
| `gateway` | a diamond with ×, + or ○ (`gateway: "exclusive" \| "parallel" \| "inclusive"`) | a branch or a join |
|
|
275
|
+
| `note` | a text bracket | an annotation |
|
|
276
|
+
| `person` | an `Avatar` (`image`, or initials) with the name and `meta` | people |
|
|
277
|
+
| `entity` | a raised pill | a show, a topic, a system (network default) |
|
|
278
|
+
| `group` | a dashed region with an eyebrow title | a lane, a cluster |
|
|
279
|
+
|
|
280
|
+
Edges are `flow` (solid, arrow), `message` (dashed, arrow), `association` (dotted) or `relation` (plain link, the network default). Each takes a `label` (mono, on a small plate), `directed` to add or drop the arrow, and `animated` for travelling dashes.
|
|
281
|
+
|
|
282
|
+
## Props
|
|
283
|
+
|
|
284
|
+
| Prop | Type | Default |
|
|
285
|
+
| --------------- | ------------------------------------------------------ | ------------------------------- |
|
|
286
|
+
| `nodes` | `GraphNode[]` | — |
|
|
287
|
+
| `edges` | `GraphEdge[]` | — |
|
|
288
|
+
| `layout` | `"flow" \| "tree" \| "network" \| "none"` | `"flow"` |
|
|
289
|
+
| `direction` | `"right" \| "down"` | `"right"` (`"down"` under 480px wide), trees `"down"` |
|
|
290
|
+
| `editable` | `boolean` | `false` |
|
|
291
|
+
| `onChange` | `(value: { nodes, edges }) => void` | — |
|
|
292
|
+
| `onSelect` | `(selection: { nodes: string[]; edges: string[] }) => void` | — |
|
|
293
|
+
| `newNodeKind` | `GraphNodeKind` — added by the Add control | `task`, networks `entity` |
|
|
294
|
+
| `minimap` | `boolean` — a small map, bottom right; left out under 480px wide | `false` |
|
|
295
|
+
| `controls` | `boolean` — zoom, fit, add and tidy | `true` |
|
|
296
|
+
| `background` | `"dots" \| "lines" \| "none"` | `"dots"` |
|
|
297
|
+
| `variant` | `"region" \| "card"` | `"region"` |
|
|
298
|
+
| `emptyMessage` | `ReactNode` — shown while there are no nodes | `labels.empty` / `emptyEditable` |
|
|
299
|
+
|
|
300
|
+
`GraphNode`: `id`, `label`, `kind`, `meta`, `icon`, `image`, `gateway`, `parent`, `position`, `size`. `GraphEdge`: `id`, `source`, `target`, `label`, `kind`, `directed`, `animated`. Other `<div>` props go to the frame. Data attributes: `data-slot="graph"` with `data-layout`, `data-editable`, `data-touch` (touch-only device) and `data-empty`; nodes `data-slot="graph-node"` with `data-kind`, and `data-lit` / `data-dim` while a node is in focus.
|
|
301
|
+
|
|
302
|
+
`labels` (`Partial<GraphMessages>`) renames the editor menu, the controls, new nodes' names, the connections read to screen readers and React Flow's own descriptions; a `LocaleProvider` sets them for every graph (`messages.graph`).
|
|
303
|
+
|
|
304
|
+
## Brand rules
|
|
305
|
+
|
|
306
|
+
- **Do** tell kinds apart by shape and line; nodes, edges and lanes stay in the page's ink. Colour, if any, is a status mark in a node's icon — never a kind or a lane.
|
|
307
|
+
- **Do** keep labels as short as the step: "Approve", "Ask the author" — `meta` carries who or how.
|
|
308
|
+
- **Do** give every graph an `aria-label` that says what it shows.
|
|
309
|
+
- **Don't** draw a hairball. Past a few dozen nodes, show part of the graph, group it, or let people filter it.
|
|
310
|
+
- **Don't** invent relations in sample data; label illustrative graphs as samples.
|
|
311
|
+
|
|
312
|
+
## Accessibility
|
|
313
|
+
|
|
314
|
+
- The canvas is named by `aria-label` and described by a visually hidden list of every connection as text ("Run the style check to Edit the draft"), so the graph reads without the picture.
|
|
315
|
+
- Every node and edge is focusable and named; the selected node shows the 2px focus edge.
|
|
316
|
+
- Control buttons are labelled and have tooltips. Under reduced motion, animated edges stand still and a network does not move while you drag.
|
|
317
|
+
|
|
318
|
+
### Keyboard
|
|
319
|
+
|
|
320
|
+
| Key | What it does |
|
|
321
|
+
| ------------------ | -------------------------------------------------------------------------------------- |
|
|
322
|
+
| Tab / Shift+Tab | Moves through the nodes, the edges and the control buttons |
|
|
323
|
+
| Enter / Space | Selects the focused node or edge |
|
|
324
|
+
| Escape | Clears the focused node's or edge's selection |
|
|
325
|
+
| ↑ / ↓ / ← / → | Pans the view by 40px, from a focused node or edge; with Shift, by 160px |
|
|
326
|
+
| ↑ / ↓ / ← / → | Moves the selected nodes by 5px, with Shift by 20px, from a selected node (`editable`) |
|
|
327
|
+
| + / − | Zooms the view in or out, from a focused node or edge |
|
|
328
|
+
| ← / → | Moves between the control buttons |
|
|
329
|
+
| Enter | Opens the focused node's or connection's label for editing (`editable`) |
|
|
330
|
+
| Enter / Escape | Keeps or cancels the label being edited |
|
|
331
|
+
| Shift+F10 | Opens the focused node's or connection's menu (`editable`): Rename, Connect to, Delete |
|
|
332
|
+
| Delete / Backspace | Removes the selected nodes and edges (`editable`) |
|
|
333
|
+
|
|
334
|
+
The arrows move a node only in an `editable` graph, once the focused node is selected (Space); Escape lets go and they pan again. They and + / − are left alone in a label being edited and in the controls. To connect two nodes from the keyboard, open a node's menu (context-menu key or Shift+F10) and pick the other under Connect to.
|
|
335
|
+
|
|
336
|
+
---
|
|
337
|
+
|
|
338
|
+
- Import: `import { Graph } from "@zonsh/ui/graph"`
|
|
339
|
+
- Source: `packages/ui/src/components/graph.tsx`
|