@zonsh/ui 0.5.0 → 0.6.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +643 -0
- package/README.md +49 -21
- package/dist/brand.d.ts +3 -0
- package/dist/brand.js +7 -0
- package/dist/components/_breadcrumb-more.d.ts +6 -0
- package/dist/components/_breadcrumb-more.js +5 -0
- package/dist/components/_drawing-svg.d.ts +11 -0
- package/dist/components/_drawing-svg.js +30 -0
- package/dist/components/_media.d.ts +159 -0
- package/dist/components/_media.js +266 -0
- package/dist/components/_overlay.d.ts +8 -5
- package/dist/components/_overlay.js +11 -6
- package/dist/components/_scheduler-calendar.d.ts +71 -0
- package/dist/components/_scheduler-calendar.js +940 -0
- package/dist/components/_scheduler-editor.d.ts +29 -0
- package/dist/components/_scheduler-editor.js +111 -0
- package/dist/components/_scheduler-menu.d.ts +16 -0
- package/dist/components/_scheduler-menu.js +18 -0
- package/dist/components/_scheduler-parts.d.ts +164 -0
- package/dist/components/_scheduler-parts.js +327 -0
- package/dist/components/_suggest-list.d.ts +142 -0
- package/dist/components/_suggest-list.js +159 -0
- package/dist/components/_toolbar-more.d.ts +24 -0
- package/dist/components/_toolbar-more.js +25 -0
- package/dist/components/accordion.d.ts +1 -1
- package/dist/components/accordion.js +6 -6
- package/dist/components/action-sheet.d.ts +88 -0
- package/dist/components/action-sheet.js +124 -0
- package/dist/components/alert-dialog.js +3 -1
- package/dist/components/alert.d.ts +11 -18
- package/dist/components/alert.js +9 -6
- package/dist/components/app-bar.d.ts +93 -0
- package/dist/components/app-bar.js +175 -0
- package/dist/components/audio-player.d.ts +134 -0
- package/dist/components/audio-player.js +618 -0
- package/dist/components/avatar.d.ts +6 -6
- package/dist/components/avatar.js +13 -11
- package/dist/components/badge.d.ts +12 -12
- package/dist/components/badge.js +7 -5
- package/dist/components/bottom-nav.d.ts +53 -11
- package/dist/components/bottom-nav.js +388 -23
- package/dist/components/breadcrumb.d.ts +11 -2
- package/dist/components/breadcrumb.js +60 -6
- package/dist/components/button-group.js +5 -1
- package/dist/components/button.d.ts +23 -6
- package/dist/components/button.js +63 -7
- package/dist/components/calendar.js +8 -6
- package/dist/components/card.d.ts +10 -8
- package/dist/components/card.js +15 -14
- package/dist/components/carousel.d.ts +2 -2
- package/dist/components/carousel.js +21 -8
- package/dist/components/chart.d.ts +27 -1
- package/dist/components/chart.js +15 -5
- package/dist/components/checkbox.js +2 -2
- package/dist/components/code-block.d.ts +9 -2
- package/dist/components/code-block.js +26 -7
- package/dist/components/collapsible.js +3 -3
- package/dist/components/color-picker.d.ts +2 -2
- package/dist/components/color-picker.js +5 -5
- package/dist/components/combobox.d.ts +26 -7
- package/dist/components/combobox.js +32 -13
- package/dist/components/command.d.ts +29 -5
- package/dist/components/command.js +35 -10
- package/dist/components/context-menu.d.ts +5 -2
- package/dist/components/context-menu.js +24 -3
- package/dist/components/conversation.d.ts +1 -1
- package/dist/components/conversation.js +67 -13
- package/dist/components/copy-button.d.ts +1 -1
- package/dist/components/copy-button.js +1 -1
- package/dist/components/data-table.d.ts +6 -6
- package/dist/components/data-table.js +41 -15
- package/dist/components/date-picker.d.ts +31 -9
- package/dist/components/date-picker.js +100 -18
- package/dist/components/dialog.d.ts +17 -10
- package/dist/components/dialog.js +20 -13
- package/dist/components/drawer.d.ts +26 -8
- package/dist/components/drawer.js +75 -16
- package/dist/components/drawing.d.ts +25 -0
- package/dist/components/drawing.js +32 -0
- package/dist/components/empty.js +2 -2
- package/dist/components/feature-list.d.ts +65 -13
- package/dist/components/feature-list.js +116 -15
- package/dist/components/field.js +2 -2
- package/dist/components/file-drop.d.ts +9 -7
- package/dist/components/file-drop.js +8 -43
- package/dist/components/filter-bar.d.ts +10 -9
- package/dist/components/filter-bar.js +42 -25
- package/dist/components/graph.d.ts +19 -3
- package/dist/components/graph.js +170 -25
- package/dist/components/illustration.js +3 -28
- package/dist/components/input-group.d.ts +5 -10
- package/dist/components/input-group.js +16 -16
- package/dist/components/input.d.ts +2 -2
- package/dist/components/input.js +3 -3
- package/dist/components/item.d.ts +9 -6
- package/dist/components/item.js +13 -8
- package/dist/components/kbd.d.ts +1 -1
- package/dist/components/kbd.js +1 -1
- package/dist/components/lightbox.d.ts +76 -9
- package/dist/components/lightbox.js +333 -45
- package/dist/components/locale.d.ts +6 -6
- package/dist/components/logo.d.ts +21 -1
- package/dist/components/logo.js +32 -2
- package/dist/components/markdown-editor.d.ts +275 -0
- package/dist/components/markdown-editor.js +831 -0
- package/dist/components/mentions.d.ts +153 -0
- package/dist/components/mentions.js +507 -0
- package/dist/components/menu.d.ts +2 -1
- package/dist/components/menu.js +5 -4
- package/dist/components/menubar.d.ts +23 -5
- package/dist/components/menubar.js +97 -22
- package/dist/components/message.d.ts +62 -11
- package/dist/components/message.js +49 -13
- package/dist/components/meter.js +1 -1
- package/dist/components/money-input.d.ts +1 -1
- package/dist/components/money-input.js +1 -1
- package/dist/components/native-select.d.ts +2 -2
- package/dist/components/native-select.js +4 -4
- package/dist/components/navigation-menu.d.ts +3 -1
- package/dist/components/navigation-menu.js +23 -12
- package/dist/components/number-field.d.ts +2 -9
- package/dist/components/number-field.js +86 -36
- package/dist/components/number-roll.d.ts +26 -0
- package/dist/components/number-roll.js +81 -0
- package/dist/components/otp-field.d.ts +1 -1
- package/dist/components/otp-field.js +24 -3
- package/dist/components/pagination.d.ts +11 -3
- package/dist/components/pagination.js +59 -13
- package/dist/components/pdf-viewer.d.ts +1 -1
- package/dist/components/pdf-viewer.js +8 -8
- package/dist/components/phone-input.d.ts +1 -1
- package/dist/components/phone-input.js +2 -2
- package/dist/components/popover.js +5 -3
- package/dist/components/preview-card.d.ts +37 -2
- package/dist/components/preview-card.js +226 -2
- package/dist/components/progress.js +1 -1
- package/dist/components/prompt-input.d.ts +1 -1
- package/dist/components/prompt-input.js +24 -14
- package/dist/components/pull-to-refresh.d.ts +50 -0
- package/dist/components/pull-to-refresh.js +189 -0
- package/dist/components/quote.d.ts +6 -1
- package/dist/components/quote.js +3 -2
- package/dist/components/radio-group.js +1 -1
- package/dist/components/rating.d.ts +4 -1
- package/dist/components/rating.js +131 -10
- package/dist/components/reasoning.d.ts +1 -1
- package/dist/components/reasoning.js +7 -3
- package/dist/components/resizable.d.ts +1 -1
- package/dist/components/resizable.js +2 -2
- package/dist/components/response.d.ts +1 -1
- package/dist/components/response.js +18 -6
- package/dist/components/scheduler.d.ts +352 -0
- package/dist/components/scheduler.js +1717 -0
- package/dist/components/scroll-area.js +1 -1
- package/dist/components/select.d.ts +17 -4
- package/dist/components/select.js +140 -9
- package/dist/components/separator.d.ts +1 -1
- package/dist/components/separator.js +3 -3
- package/dist/components/sidebar.d.ts +44 -3
- package/dist/components/sidebar.js +57 -17
- package/dist/components/site-header.d.ts +18 -13
- package/dist/components/site-header.js +23 -11
- package/dist/components/skeleton.d.ts +17 -7
- package/dist/components/skeleton.js +22 -7
- package/dist/components/slider.js +2 -2
- package/dist/components/sortable.d.ts +55 -4
- package/dist/components/sortable.js +172 -103
- package/dist/components/sources.d.ts +1 -1
- package/dist/components/sources.js +2 -2
- package/dist/components/spinner.d.ts +4 -4
- package/dist/components/spinner.js +4 -4
- package/dist/components/stat.d.ts +21 -4
- package/dist/components/stat.js +17 -8
- package/dist/components/stepper.d.ts +1 -1
- package/dist/components/stepper.js +8 -7
- package/dist/components/suggestions.d.ts +11 -3
- package/dist/components/suggestions.js +10 -4
- package/dist/components/swipe-actions.d.ts +66 -0
- package/dist/components/swipe-actions.js +292 -0
- package/dist/components/switch.js +1 -1
- package/dist/components/table.d.ts +12 -6
- package/dist/components/table.js +78 -30
- package/dist/components/tabs.js +7 -4
- package/dist/components/tag.d.ts +19 -20
- package/dist/components/tag.js +9 -5
- package/dist/components/tags-input.d.ts +2 -7
- package/dist/components/tags-input.js +11 -8
- package/dist/components/textarea.d.ts +3 -2
- package/dist/components/textarea.js +4 -3
- package/dist/components/theme.d.ts +49 -6
- package/dist/components/theme.js +147 -9
- package/dist/components/time-field.d.ts +4 -9
- package/dist/components/time-field.js +6 -6
- package/dist/components/timeline.d.ts +19 -3
- package/dist/components/timeline.js +21 -9
- package/dist/components/tippy.d.ts +17 -1
- package/dist/components/tippy.js +95 -15
- package/dist/components/toast.d.ts +2 -7
- package/dist/components/toast.js +12 -8
- package/dist/components/toggle-group.d.ts +7 -1
- package/dist/components/toggle-group.js +16 -5
- package/dist/components/toggle.d.ts +2 -2
- package/dist/components/toggle.js +3 -2
- package/dist/components/tool-call.d.ts +1 -1
- package/dist/components/tool-call.js +4 -4
- package/dist/components/toolbar.d.ts +57 -4
- package/dist/components/toolbar.js +216 -16
- package/dist/components/tooltip.d.ts +1 -1
- package/dist/components/tooltip.js +4 -2
- package/dist/components/tour.d.ts +1 -1
- package/dist/components/tour.js +36 -15
- package/dist/components/tree.js +5 -5
- package/dist/components/typography.d.ts +31 -8
- package/dist/components/typography.js +21 -10
- package/dist/components/video-player.d.ts +7 -2
- package/dist/components/video-player.js +121 -220
- package/dist/index.d.ts +99 -92
- package/dist/index.js +99 -92
- package/dist/lib/calendar.d.ts +153 -0
- package/dist/lib/calendar.js +312 -0
- package/dist/lib/cn.d.ts +3 -1
- package/dist/lib/cn.js +5 -0
- package/dist/lib/code-highlight.d.ts +14 -0
- package/dist/lib/code-highlight.js +81 -18
- package/dist/lib/drag.d.ts +39 -0
- package/dist/lib/drag.js +96 -0
- package/dist/lib/editorial-assets.js +16 -8
- package/dist/lib/figure/figures/automation.js +25 -6
- package/dist/lib/figure/figures/bar-chart.js +6 -1
- package/dist/lib/figure/figures/brackets-classic.js +4 -1
- package/dist/lib/figure/figures/city.js +12 -2
- package/dist/lib/figure/figures/conveyor.js +17 -4
- package/dist/lib/figure/figures/database.js +5 -2
- package/dist/lib/figure/figures/documents.js +11 -3
- package/dist/lib/figure/figures/inbox.js +5 -2
- package/dist/lib/figure/figures/laptop.js +3 -1
- package/dist/lib/figure/figures/pipeline.js +45 -10
- package/dist/lib/figure/figures/platform.js +62 -7
- package/dist/lib/figure/figures/server.js +21 -5
- package/dist/lib/figure/figures/spreadsheet.js +29 -5
- package/dist/lib/figure/kernel.d.ts +4 -2
- package/dist/lib/figure/kernel.js +10 -5
- package/dist/lib/figure/parts.js +6 -2
- package/dist/lib/files.d.ts +31 -0
- package/dist/lib/files.js +60 -0
- package/dist/lib/gesture.d.ts +70 -0
- package/dist/lib/gesture.js +141 -0
- package/dist/lib/glide.d.ts +5 -0
- package/dist/lib/glide.js +9 -1
- package/dist/lib/icons.d.ts +1 -0
- package/dist/lib/icons.js +6 -0
- package/dist/lib/illustration-library.js +1 -6
- package/dist/lib/markdown-edit.d.ts +112 -0
- package/dist/lib/markdown-edit.js +557 -0
- package/dist/lib/markdown-rich-editor.d.ts +188 -0
- package/dist/lib/markdown-rich-editor.js +1153 -0
- package/dist/lib/markdown-rich.d.ts +63 -0
- package/dist/lib/markdown-rich.js +534 -0
- package/dist/lib/mentions.d.ts +100 -0
- package/dist/lib/mentions.js +246 -0
- package/dist/lib/motion.d.ts +18 -0
- package/dist/lib/motion.js +43 -5
- package/dist/lib/number-roll.d.ts +89 -0
- package/dist/lib/number-roll.js +391 -0
- package/dist/lib/platform.d.ts +6 -0
- package/dist/lib/platform.js +14 -0
- package/dist/lib/portal-container.d.ts +9 -0
- package/dist/lib/portal-container.js +10 -0
- package/dist/lib/press.d.ts +5 -0
- package/dist/lib/press.js +186 -0
- package/dist/lib/scheduler.d.ts +128 -0
- package/dist/lib/scheduler.js +272 -0
- package/dist/lib/scroll-edges.d.ts +9 -0
- package/dist/lib/scroll-edges.js +50 -0
- package/dist/lib/table-fit.d.ts +1 -1
- package/dist/lib/table-fit.js +65 -8
- package/dist/lib/theme-preset.d.ts +267 -0
- package/dist/lib/theme-preset.js +1046 -0
- package/dist/lib/theme-script.d.ts +23 -3
- package/dist/lib/theme-script.js +17 -5
- package/dist/lib/tippy/sprite.d.ts +36 -4
- package/dist/lib/tippy/sprite.js +188 -15
- package/dist/lib/tone.d.ts +4 -0
- package/dist/lib/tone.js +1 -0
- package/dist/messages/de.d.ts +3 -3
- package/dist/messages/de.js +274 -3
- package/dist/skills/zon-ui/SKILL.md +279 -0
- package/dist/skills/zon-ui/references/authoring.md +265 -0
- package/dist/skills/zon-ui/references/brand.md +416 -0
- package/dist/skills/zon-ui/references/components/accordion.md +199 -0
- package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
- package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
- package/dist/skills/zon-ui/references/components/alert.md +167 -0
- package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
- package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
- package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
- package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
- package/dist/skills/zon-ui/references/components/avatar.md +98 -0
- package/dist/skills/zon-ui/references/components/badge.md +227 -0
- package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
- package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
- package/dist/skills/zon-ui/references/components/button-group.md +216 -0
- package/dist/skills/zon-ui/references/components/button.md +309 -0
- package/dist/skills/zon-ui/references/components/calendar.md +296 -0
- package/dist/skills/zon-ui/references/components/card.md +158 -0
- package/dist/skills/zon-ui/references/components/carousel.md +297 -0
- package/dist/skills/zon-ui/references/components/chart.md +739 -0
- package/dist/skills/zon-ui/references/components/chat.md +417 -0
- package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
- package/dist/skills/zon-ui/references/components/code-block.md +143 -0
- package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
- package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
- package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
- package/dist/skills/zon-ui/references/components/combobox.md +455 -0
- package/dist/skills/zon-ui/references/components/command.md +326 -0
- package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
- package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
- package/dist/skills/zon-ui/references/components/conversation.md +146 -0
- package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
- package/dist/skills/zon-ui/references/components/crm.md +1022 -0
- package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
- package/dist/skills/zon-ui/references/components/data-table.md +776 -0
- package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
- package/dist/skills/zon-ui/references/components/dialog.md +335 -0
- package/dist/skills/zon-ui/references/components/direction.md +165 -0
- package/dist/skills/zon-ui/references/components/drawer.md +276 -0
- package/dist/skills/zon-ui/references/components/drawing.md +94 -0
- package/dist/skills/zon-ui/references/components/empty.md +225 -0
- package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
- package/dist/skills/zon-ui/references/components/field.md +209 -0
- package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
- package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
- package/dist/skills/zon-ui/references/components/form.md +970 -0
- package/dist/skills/zon-ui/references/components/graph.md +339 -0
- package/dist/skills/zon-ui/references/components/illustration.md +497 -0
- package/dist/skills/zon-ui/references/components/inbox.md +263 -0
- package/dist/skills/zon-ui/references/components/input-group.md +339 -0
- package/dist/skills/zon-ui/references/components/input.md +189 -0
- package/dist/skills/zon-ui/references/components/item.md +277 -0
- package/dist/skills/zon-ui/references/components/kanban.md +626 -0
- package/dist/skills/zon-ui/references/components/kbd.md +116 -0
- package/dist/skills/zon-ui/references/components/label.md +104 -0
- package/dist/skills/zon-ui/references/components/layout.md +291 -0
- package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
- package/dist/skills/zon-ui/references/components/locale.md +279 -0
- package/dist/skills/zon-ui/references/components/logo.md +257 -0
- package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
- package/dist/skills/zon-ui/references/components/mentions.md +512 -0
- package/dist/skills/zon-ui/references/components/menu.md +218 -0
- package/dist/skills/zon-ui/references/components/menubar.md +292 -0
- package/dist/skills/zon-ui/references/components/message.md +243 -0
- package/dist/skills/zon-ui/references/components/meter.md +105 -0
- package/dist/skills/zon-ui/references/components/money-input.md +333 -0
- package/dist/skills/zon-ui/references/components/native-select.md +197 -0
- package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
- package/dist/skills/zon-ui/references/components/number-field.md +210 -0
- package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
- package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
- package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
- package/dist/skills/zon-ui/references/components/pagination.md +109 -0
- package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
- package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
- package/dist/skills/zon-ui/references/components/popover.md +176 -0
- package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
- package/dist/skills/zon-ui/references/components/pricing.md +724 -0
- package/dist/skills/zon-ui/references/components/progress.md +92 -0
- package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
- package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
- package/dist/skills/zon-ui/references/components/quote.md +115 -0
- package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
- package/dist/skills/zon-ui/references/components/rating.md +260 -0
- package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
- package/dist/skills/zon-ui/references/components/resizable.md +213 -0
- package/dist/skills/zon-ui/references/components/response.md +170 -0
- package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
- package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
- package/dist/skills/zon-ui/references/components/select.md +351 -0
- package/dist/skills/zon-ui/references/components/separator.md +103 -0
- package/dist/skills/zon-ui/references/components/settings.md +793 -0
- package/dist/skills/zon-ui/references/components/shop.md +1715 -0
- package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
- package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
- package/dist/skills/zon-ui/references/components/site-header.md +303 -0
- package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
- package/dist/skills/zon-ui/references/components/slider.md +172 -0
- package/dist/skills/zon-ui/references/components/sortable.md +405 -0
- package/dist/skills/zon-ui/references/components/sources.md +106 -0
- package/dist/skills/zon-ui/references/components/spinner.md +222 -0
- package/dist/skills/zon-ui/references/components/stat.md +267 -0
- package/dist/skills/zon-ui/references/components/stepper.md +285 -0
- package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
- package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
- package/dist/skills/zon-ui/references/components/switch.md +160 -0
- package/dist/skills/zon-ui/references/components/table.md +999 -0
- package/dist/skills/zon-ui/references/components/tabs.md +258 -0
- package/dist/skills/zon-ui/references/components/tag.md +115 -0
- package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
- package/dist/skills/zon-ui/references/components/textarea.md +95 -0
- package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
- package/dist/skills/zon-ui/references/components/theme.md +362 -0
- package/dist/skills/zon-ui/references/components/time-field.md +222 -0
- package/dist/skills/zon-ui/references/components/timeline.md +285 -0
- package/dist/skills/zon-ui/references/components/tippy.md +243 -0
- package/dist/skills/zon-ui/references/components/toast.md +220 -0
- package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
- package/dist/skills/zon-ui/references/components/toggle.md +167 -0
- package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
- package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
- package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
- package/dist/skills/zon-ui/references/components/tour.md +423 -0
- package/dist/skills/zon-ui/references/components/tree.md +481 -0
- package/dist/skills/zon-ui/references/components/typography.md +347 -0
- package/dist/skills/zon-ui/references/components/video-player.md +386 -0
- package/dist/skills/zon-ui/references/marketing.md +467 -0
- package/dist/skills/zon-ui/references/motion.md +455 -0
- package/dist/skills/zon-ui/references/recipes.md +1232 -0
- package/dist/skills/zon-ui/references/tokens.md +866 -0
- package/dist/sources/accordion.css +4 -0
- package/dist/sources/action-sheet.css +11 -0
- package/dist/sources/alert-dialog.css +6 -0
- package/dist/sources/alert.css +3 -0
- package/dist/sources/app-bar.css +14 -0
- package/dist/sources/ascii-field.css +3 -0
- package/dist/sources/aspect-ratio.css +3 -0
- package/dist/sources/audio-player.css +20 -0
- package/dist/sources/avatar.css +3 -0
- package/dist/sources/badge.css +3 -0
- package/dist/sources/bottom-nav.css +9 -0
- package/dist/sources/breadcrumb.css +14 -0
- package/dist/sources/button-group.css +3 -0
- package/dist/sources/button.css +9 -0
- package/dist/sources/calendar.css +13 -0
- package/dist/sources/card.css +3 -0
- package/dist/sources/carousel.css +11 -0
- package/dist/sources/chart.css +5 -0
- package/dist/sources/checkbox.css +6 -0
- package/dist/sources/code-block.css +13 -0
- package/dist/sources/collapsible.css +4 -0
- package/dist/sources/color-picker.css +13 -0
- package/dist/sources/combobox.css +13 -0
- package/dist/sources/command.css +13 -0
- package/dist/sources/context-menu.css +12 -0
- package/dist/sources/conversation.css +10 -0
- package/dist/sources/copy-button.css +10 -0
- package/dist/sources/data-table.css +27 -0
- package/dist/sources/date-picker.css +20 -0
- package/dist/sources/dialog.css +9 -0
- package/dist/sources/direction.css +2 -0
- package/dist/sources/drawer.css +9 -0
- package/dist/sources/drawing.css +5 -0
- package/dist/sources/empty.css +3 -0
- package/dist/sources/feature-list.css +4 -0
- package/dist/sources/field.css +4 -0
- package/dist/sources/file-drop.css +15 -0
- package/dist/sources/filter-bar.css +30 -0
- package/dist/sources/form.css +4 -0
- package/dist/sources/graph.css +19 -0
- package/dist/sources/illustration.css +28 -0
- package/dist/sources/input-group.css +7 -0
- package/dist/sources/input.css +3 -0
- package/dist/sources/item.css +4 -0
- package/dist/sources/kbd.css +5 -0
- package/dist/sources/label.css +3 -0
- package/dist/sources/layout.css +3 -0
- package/dist/sources/lightbox.css +33 -0
- package/dist/sources/locale.css +2 -0
- package/dist/sources/logo.css +4 -0
- package/dist/sources/markdown-editor.css +41 -0
- package/dist/sources/mentions.css +13 -0
- package/dist/sources/menu.css +11 -0
- package/dist/sources/menubar.css +14 -0
- package/dist/sources/message.css +16 -0
- package/dist/sources/meter.css +4 -0
- package/dist/sources/money-input.css +10 -0
- package/dist/sources/native-select.css +4 -0
- package/dist/sources/navigation-menu.css +8 -0
- package/dist/sources/number-field.css +8 -0
- package/dist/sources/number-roll.css +6 -0
- package/dist/sources/otp-field.css +5 -0
- package/dist/sources/pagination.css +11 -0
- package/dist/sources/pdf-viewer.css +30 -0
- package/dist/sources/phone-input.css +20 -0
- package/dist/sources/popover.css +7 -0
- package/dist/sources/preview-card.css +7 -0
- package/dist/sources/progress.css +4 -0
- package/dist/sources/prompt-input.css +15 -0
- package/dist/sources/pull-to-refresh.css +14 -0
- package/dist/sources/quote.css +3 -0
- package/dist/sources/radio-group.css +5 -0
- package/dist/sources/rating.css +6 -0
- package/dist/sources/reasoning.css +6 -0
- package/dist/sources/resizable.css +4 -0
- package/dist/sources/response.css +16 -0
- package/dist/sources/scheduler.css +44 -0
- package/dist/sources/scroll-area.css +3 -0
- package/dist/sources/select.css +12 -0
- package/dist/sources/separator.css +3 -0
- package/dist/sources/sidebar.css +19 -0
- package/dist/sources/site-header.css +15 -0
- package/dist/sources/skeleton.css +3 -0
- package/dist/sources/slider.css +6 -0
- package/dist/sources/sortable.css +12 -0
- package/dist/sources/sources.css +6 -0
- package/dist/sources/spinner.css +6 -0
- package/dist/sources/stat.css +9 -0
- package/dist/sources/stepper.css +6 -0
- package/dist/sources/suggestions.css +10 -0
- package/dist/sources/swipe-actions.css +20 -0
- package/dist/sources/switch.css +5 -0
- package/dist/sources/table.css +7 -0
- package/dist/sources/tabs.css +5 -0
- package/dist/sources/tag.css +3 -0
- package/dist/sources/tags-input.css +6 -0
- package/dist/sources/textarea.css +3 -0
- package/dist/sources/theme.css +13 -0
- package/dist/sources/time-field.css +7 -0
- package/dist/sources/timeline.css +7 -0
- package/dist/sources/tippy.css +6 -0
- package/dist/sources/toast.css +6 -0
- package/dist/sources/toggle-group.css +5 -0
- package/dist/sources/toggle.css +3 -0
- package/dist/sources/tool-call.css +16 -0
- package/dist/sources/toolbar.css +14 -0
- package/dist/sources/tooltip.css +6 -0
- package/dist/sources/tour.css +14 -0
- package/dist/sources/tree.css +6 -0
- package/dist/sources/typography.css +4 -0
- package/dist/sources/video-player.css +21 -0
- package/dist/styles/ai.css +3 -0
- package/dist/styles/brand.css +98 -0
- package/dist/styles/core.css +266 -0
- package/dist/styles/editor.css +3 -0
- package/dist/styles/expressive.css +35 -56
- package/dist/styles/fonts.css +61 -117
- package/dist/styles/graph.css +4 -0
- package/dist/styles/illustration.css +4 -0
- package/dist/styles/index.css +11 -201
- package/dist/styles/material.css +138 -12
- package/dist/styles/parts/ai.css +18 -13
- package/dist/styles/parts/brand.css +2 -2
- package/dist/styles/parts/controls.css +29 -20
- package/dist/styles/parts/data.css +13 -9
- package/dist/styles/parts/editor.css +372 -0
- package/dist/styles/parts/feedback.css +32 -2
- package/dist/styles/parts/foundations.css +12 -7
- package/dist/styles/parts/graph.css +25 -9
- package/dist/styles/parts/inputs.css +172 -9
- package/dist/styles/parts/isometric.css +6 -5
- package/dist/styles/parts/navigation.css +206 -27
- package/dist/styles/parts/overlays.css +19 -4
- package/dist/styles/parts/pdf.css +2 -2
- package/dist/styles/pdf.css +3 -0
- package/dist/styles/prose.css +3 -0
- package/dist/styles/tokens.css +89 -14
- package/dist/theme.d.ts +1 -0
- package/dist/theme.js +5 -0
- package/dist/vite.d.ts +48 -59
- package/dist/vite.js +54 -21
- package/package.json +69 -2
|
@@ -0,0 +1,739 @@
|
|
|
1
|
+
# Chart
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { chartAnimation, ChartContainer, ChartGradient, ChartTooltip, ChartTooltipContent, type ChartConfig } from "@zonsh/ui/chart";
|
|
5
|
+
import { Area, AreaChart, CartesianGrid, XAxis, YAxis } from "recharts";
|
|
6
|
+
|
|
7
|
+
const requests = [
|
|
8
|
+
{ day: "Sep 22", requests: 1240 },
|
|
9
|
+
{ day: "Sep 23", requests: 1385 },
|
|
10
|
+
{ day: "Sep 24", requests: 1302 },
|
|
11
|
+
{ day: "Sep 25", requests: 1518 },
|
|
12
|
+
{ day: "Sep 26", requests: 1460 },
|
|
13
|
+
{ day: "Sep 27", requests: 690 },
|
|
14
|
+
{ day: "Sep 28", requests: 612 },
|
|
15
|
+
{ day: "Sep 29", requests: 1410 },
|
|
16
|
+
{ day: "Sep 30", requests: 1555 },
|
|
17
|
+
{ day: "Oct 1", requests: 1620 },
|
|
18
|
+
{ day: "Oct 2", requests: 1498 },
|
|
19
|
+
{ day: "Oct 3", requests: 1530 },
|
|
20
|
+
{ day: "Oct 4", requests: 720 },
|
|
21
|
+
{ day: "Oct 5", requests: 655 },
|
|
22
|
+
];
|
|
23
|
+
|
|
24
|
+
const requestsConfig = {
|
|
25
|
+
requests: { label: "Requests" },
|
|
26
|
+
} satisfies ChartConfig;
|
|
27
|
+
|
|
28
|
+
export function Default() {
|
|
29
|
+
return (
|
|
30
|
+
<ChartContainer config={requestsConfig} className="aspect-auto h-60" aria-label="Requests per day">
|
|
31
|
+
<AreaChart data={requests} margin={{ top: 8, right: 20, left: 4, bottom: 0 }}>
|
|
32
|
+
<ChartGradient id="fill-requests" color="var(--color-requests)" />
|
|
33
|
+
<CartesianGrid />
|
|
34
|
+
<XAxis dataKey="day" tickMargin={8} minTickGap={24} />
|
|
35
|
+
<YAxis width={40} tickMargin={4} />
|
|
36
|
+
<ChartTooltip content={<ChartTooltipContent hideIndicator />} />
|
|
37
|
+
<Area
|
|
38
|
+
{...chartAnimation}
|
|
39
|
+
dataKey="requests"
|
|
40
|
+
type="monotone"
|
|
41
|
+
stroke="var(--color-requests)"
|
|
42
|
+
fill="url(#fill-requests)"
|
|
43
|
+
/>
|
|
44
|
+
</AreaChart>
|
|
45
|
+
</ChartContainer>
|
|
46
|
+
);
|
|
47
|
+
}
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
Recharts charts inside a `ChartContainer`, which sizes the chart, turns a `config` into one `--color-<key>` variable per series, and themes Recharts: 11px Licht Mono ticks, horizontal hairline grid, no tick marks, a gliding hairline cursor (a band on bars), 1.5px lines with only the active dot. Tooltips are menu material with mono tabular values; legends are mono 11px.
|
|
51
|
+
|
|
52
|
+
Series are **monochrome by default** — the `--chart-1` … `--chart-5` ramp, told apart by value plus a dash, hatch or gradient. When the categories are the point (storage by file type), `palette="tones"` gives each series a category tone (`--tone-blue`, orange, aqua, magenta, lime, violet, in order). Use the same tone for the same kind across the app, and keep the legend.
|
|
53
|
+
|
|
54
|
+
## Usage
|
|
55
|
+
|
|
56
|
+
The kit has its own entry, `@zonsh/ui/chart`, and needs `recharts` v3 (an optional dependency):
|
|
57
|
+
|
|
58
|
+
```bash
|
|
59
|
+
pnpm add recharts
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
```tsx
|
|
63
|
+
import {
|
|
64
|
+
chartAnimation,
|
|
65
|
+
ChartContainer,
|
|
66
|
+
ChartGradient,
|
|
67
|
+
ChartTooltip,
|
|
68
|
+
ChartTooltipContent,
|
|
69
|
+
type ChartConfig,
|
|
70
|
+
} from "@zonsh/ui/chart";
|
|
71
|
+
import { Area, AreaChart, CartesianGrid, XAxis } from "recharts";
|
|
72
|
+
|
|
73
|
+
const config = { requests: { label: "Requests" } } satisfies ChartConfig;
|
|
74
|
+
|
|
75
|
+
<ChartContainer config={config} className="aspect-auto h-60" aria-label="Requests per day">
|
|
76
|
+
<AreaChart data={data}>
|
|
77
|
+
<ChartGradient id="fill-requests" color="var(--color-requests)" />
|
|
78
|
+
<CartesianGrid />
|
|
79
|
+
<XAxis dataKey="day" tickMargin={8} />
|
|
80
|
+
<ChartTooltip content={<ChartTooltipContent hideIndicator />} />
|
|
81
|
+
<Area
|
|
82
|
+
{...chartAnimation}
|
|
83
|
+
dataKey="requests"
|
|
84
|
+
type="monotone"
|
|
85
|
+
stroke="var(--color-requests)"
|
|
86
|
+
fill="url(#fill-requests)"
|
|
87
|
+
/>
|
|
88
|
+
</AreaChart>
|
|
89
|
+
</ChartContainer>;
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
The props you'll reach for: `config` and an `aria-label` on `ChartContainer`, `className` to size it (`aspect-auto h-60`), and `palette` when categories need tones.
|
|
93
|
+
|
|
94
|
+
## When to use
|
|
95
|
+
|
|
96
|
+
- **Area** for one quantity over time; stacked areas for parts of a whole over time.
|
|
97
|
+
- **Bar** to compare categories; **horizontal** for long names; values at the tips with `LabelList`.
|
|
98
|
+
- **Line** for several series over time, told apart with `dash`; tones only when each line is a kind people know by colour elsewhere.
|
|
99
|
+
- **Pie** only for two or three parts; past that, bars. A **donut** puts the total in the middle.
|
|
100
|
+
- A single number with no trend is a figure, not a chart (brand guide, Typography → Numbers).
|
|
101
|
+
- Rows people search or sort belong in `DataTable`; offer one beside any chart whose exact values matter.
|
|
102
|
+
|
|
103
|
+
## Examples
|
|
104
|
+
|
|
105
|
+
### Stacked area
|
|
106
|
+
|
|
107
|
+
`type="natural"` curves in the category tones, one series dashed so they read apart without colour. Use `natural` for slow trends; `monotone` when values jump — it never overshoots.
|
|
108
|
+
|
|
109
|
+
```tsx
|
|
110
|
+
import { chartAnimation, ChartContainer, ChartGradient, ChartLegend, ChartLegendContent, ChartTooltip, ChartTooltipContent, type ChartConfig } from "@zonsh/ui/chart";
|
|
111
|
+
import { Area, AreaChart, CartesianGrid, XAxis, YAxis } from "recharts";
|
|
112
|
+
|
|
113
|
+
const tasks = [
|
|
114
|
+
{ week: "W32", online: 362, store: 194 },
|
|
115
|
+
{ week: "W33", online: 395, store: 181 },
|
|
116
|
+
{ week: "W34", online: 388, store: 186 },
|
|
117
|
+
{ week: "W35", online: 431, store: 163 },
|
|
118
|
+
{ week: "W36", online: 472, store: 152 },
|
|
119
|
+
{ week: "W37", online: 458, store: 158 },
|
|
120
|
+
{ week: "W38", online: 506, store: 137 },
|
|
121
|
+
{ week: "W39", online: 547, store: 121 },
|
|
122
|
+
{ week: "W40", online: 538, store: 126 },
|
|
123
|
+
{ week: "W41", online: 584, store: 108 },
|
|
124
|
+
];
|
|
125
|
+
|
|
126
|
+
// No colours here: `palette="tones"` gives each series its category tone, in key order.
|
|
127
|
+
const tasksConfig = {
|
|
128
|
+
online: { label: "Online orders" },
|
|
129
|
+
store: { label: "In-store orders", dash: "4 3" },
|
|
130
|
+
} satisfies ChartConfig;
|
|
131
|
+
|
|
132
|
+
export function AreaStacked() {
|
|
133
|
+
return (
|
|
134
|
+
<ChartContainer
|
|
135
|
+
config={tasksConfig}
|
|
136
|
+
palette="tones"
|
|
137
|
+
className="aspect-auto h-64"
|
|
138
|
+
aria-label="Orders per week"
|
|
139
|
+
>
|
|
140
|
+
<AreaChart data={tasks} margin={{ top: 8, right: 20, left: 4, bottom: 0 }}>
|
|
141
|
+
<ChartGradient id="fill-online" color="var(--color-online)" from={0.2} />
|
|
142
|
+
<ChartGradient id="fill-store" color="var(--color-store)" from={0.3} />
|
|
143
|
+
<CartesianGrid />
|
|
144
|
+
<XAxis dataKey="week" tickMargin={8} />
|
|
145
|
+
<YAxis width={40} tickMargin={4} />
|
|
146
|
+
<ChartTooltip content={<ChartTooltipContent indicator="line" />} />
|
|
147
|
+
<Area
|
|
148
|
+
{...chartAnimation}
|
|
149
|
+
dataKey="store"
|
|
150
|
+
type="natural"
|
|
151
|
+
stackId="tasks"
|
|
152
|
+
stroke="var(--color-store)"
|
|
153
|
+
strokeDasharray="4 3"
|
|
154
|
+
fill="url(#fill-store)"
|
|
155
|
+
/>
|
|
156
|
+
<Area
|
|
157
|
+
{...chartAnimation}
|
|
158
|
+
dataKey="online"
|
|
159
|
+
type="natural"
|
|
160
|
+
stackId="tasks"
|
|
161
|
+
stroke="var(--color-online)"
|
|
162
|
+
fill="url(#fill-online)"
|
|
163
|
+
/>
|
|
164
|
+
<ChartLegend content={<ChartLegendContent />} />
|
|
165
|
+
</AreaChart>
|
|
166
|
+
</ChartContainer>
|
|
167
|
+
);
|
|
168
|
+
}
|
|
169
|
+
```
|
|
170
|
+
|
|
171
|
+
### Grouped bars
|
|
172
|
+
|
|
173
|
+
The second series is hatched with `ChartHatch` and `pattern: "hatch"`, so tooltip and legend swatches match.
|
|
174
|
+
|
|
175
|
+
```tsx
|
|
176
|
+
import { chartAnimation, ChartContainer, ChartHatch, ChartLegend, ChartLegendContent, ChartTooltip, ChartTooltipContent, type ChartConfig } from "@zonsh/ui/chart";
|
|
177
|
+
import { Bar, BarChart, CartesianGrid, XAxis, YAxis } from "recharts";
|
|
178
|
+
|
|
179
|
+
const weekdays = [
|
|
180
|
+
{ day: "Mon", online: 96, store: 34 },
|
|
181
|
+
{ day: "Tue", online: 104, store: 29 },
|
|
182
|
+
{ day: "Wed", online: 112, store: 31 },
|
|
183
|
+
{ day: "Thu", online: 99, store: 27 },
|
|
184
|
+
{ day: "Fri", online: 87, store: 22 },
|
|
185
|
+
];
|
|
186
|
+
|
|
187
|
+
const weekdaysConfig = {
|
|
188
|
+
online: { label: "Online" },
|
|
189
|
+
store: { label: "In store", color: "var(--chart-3)", pattern: "hatch" },
|
|
190
|
+
} satisfies ChartConfig;
|
|
191
|
+
|
|
192
|
+
export function BarGrouped() {
|
|
193
|
+
return (
|
|
194
|
+
<ChartContainer config={weekdaysConfig} className="aspect-auto h-64" aria-label="Orders per weekday">
|
|
195
|
+
<BarChart data={weekdays} barGap={2} margin={{ top: 8, right: 20, left: 4, bottom: 0 }}>
|
|
196
|
+
<ChartHatch id="hatch-store" color="var(--color-store)" />
|
|
197
|
+
<CartesianGrid />
|
|
198
|
+
<XAxis dataKey="day" tickMargin={8} />
|
|
199
|
+
<YAxis width={32} tickMargin={4} />
|
|
200
|
+
<ChartTooltip content={<ChartTooltipContent />} />
|
|
201
|
+
<Bar
|
|
202
|
+
{...chartAnimation}
|
|
203
|
+
dataKey="online"
|
|
204
|
+
fill="var(--color-online)"
|
|
205
|
+
radius={[3, 3, 0, 0]}
|
|
206
|
+
maxBarSize={24}
|
|
207
|
+
/>
|
|
208
|
+
<Bar
|
|
209
|
+
{...chartAnimation}
|
|
210
|
+
dataKey="store"
|
|
211
|
+
fill="url(#hatch-store)"
|
|
212
|
+
radius={[3, 3, 0, 0]}
|
|
213
|
+
maxBarSize={24}
|
|
214
|
+
/>
|
|
215
|
+
<ChartLegend content={<ChartLegendContent />} />
|
|
216
|
+
</BarChart>
|
|
217
|
+
</ChartContainer>
|
|
218
|
+
);
|
|
219
|
+
}
|
|
220
|
+
```
|
|
221
|
+
|
|
222
|
+
### Labelled bars
|
|
223
|
+
|
|
224
|
+
`grid="vertical"`, values at the bar tips, and no value axis.
|
|
225
|
+
|
|
226
|
+
```tsx
|
|
227
|
+
import { chartAnimation, ChartContainer, ChartTooltip, ChartTooltipContent, type ChartConfig } from "@zonsh/ui/chart";
|
|
228
|
+
import { Bar, BarChart, CartesianGrid, LabelList, XAxis, YAxis } from "recharts";
|
|
229
|
+
|
|
230
|
+
const pages = [
|
|
231
|
+
{ page: "Getting started", views: 1204 },
|
|
232
|
+
{ page: "Pricing", views: 932 },
|
|
233
|
+
{ page: "Changelog", views: 618 },
|
|
234
|
+
{ page: "API reference", views: 341 },
|
|
235
|
+
{ page: "Careers", views: 52 },
|
|
236
|
+
];
|
|
237
|
+
|
|
238
|
+
const pagesConfig = {
|
|
239
|
+
views: { label: "Views" },
|
|
240
|
+
} satisfies ChartConfig;
|
|
241
|
+
|
|
242
|
+
export function BarHorizontal() {
|
|
243
|
+
return (
|
|
244
|
+
<ChartContainer
|
|
245
|
+
config={pagesConfig}
|
|
246
|
+
grid="vertical"
|
|
247
|
+
className="aspect-auto h-60"
|
|
248
|
+
aria-label="Views per page"
|
|
249
|
+
>
|
|
250
|
+
<BarChart data={pages} layout="vertical" margin={{ top: 0, right: 48, left: 0, bottom: 0 }}>
|
|
251
|
+
<CartesianGrid />
|
|
252
|
+
<XAxis type="number" hide />
|
|
253
|
+
<YAxis type="category" dataKey="page" width={128} tickMargin={8} axisLine={false} />
|
|
254
|
+
<ChartTooltip content={<ChartTooltipContent hideIndicator />} />
|
|
255
|
+
<Bar
|
|
256
|
+
{...chartAnimation}
|
|
257
|
+
dataKey="views"
|
|
258
|
+
fill="var(--color-views)"
|
|
259
|
+
radius={[0, 3, 3, 0]}
|
|
260
|
+
maxBarSize={20}
|
|
261
|
+
>
|
|
262
|
+
<LabelList
|
|
263
|
+
dataKey="views"
|
|
264
|
+
position="right"
|
|
265
|
+
offset={8}
|
|
266
|
+
formatter={(v) => Number(v).toLocaleString()}
|
|
267
|
+
/>
|
|
268
|
+
</Bar>
|
|
269
|
+
</BarChart>
|
|
270
|
+
</ChartContainer>
|
|
271
|
+
);
|
|
272
|
+
}
|
|
273
|
+
```
|
|
274
|
+
|
|
275
|
+
### Category tones
|
|
276
|
+
|
|
277
|
+
File types share tones with their tags elsewhere; the axis names every bar, so colour is never the only label.
|
|
278
|
+
|
|
279
|
+
```tsx
|
|
280
|
+
import { chartAnimation, ChartContainer, ChartTooltip, ChartTooltipContent, type ChartConfig } from "@zonsh/ui/chart";
|
|
281
|
+
import { Bar, BarChart, CartesianGrid, Cell, LabelList, XAxis, YAxis } from "recharts";
|
|
282
|
+
|
|
283
|
+
const storage = [
|
|
284
|
+
{ type: "documents", gb: 42 },
|
|
285
|
+
{ type: "spreadsheets", gb: 18 },
|
|
286
|
+
{ type: "images", gb: 126 },
|
|
287
|
+
{ type: "audio", gb: 34 },
|
|
288
|
+
{ type: "archives", gb: 61 },
|
|
289
|
+
{ type: "video", gb: 208 },
|
|
290
|
+
];
|
|
291
|
+
|
|
292
|
+
const storageConfig = {
|
|
293
|
+
documents: { label: "Documents" },
|
|
294
|
+
spreadsheets: { label: "Spreadsheets" },
|
|
295
|
+
images: { label: "Images" },
|
|
296
|
+
audio: { label: "Audio" },
|
|
297
|
+
archives: { label: "Archives" },
|
|
298
|
+
video: { label: "Video" },
|
|
299
|
+
} satisfies ChartConfig;
|
|
300
|
+
|
|
301
|
+
export function BarTones() {
|
|
302
|
+
return (
|
|
303
|
+
<ChartContainer
|
|
304
|
+
config={storageConfig}
|
|
305
|
+
palette="tones"
|
|
306
|
+
grid="vertical"
|
|
307
|
+
className="aspect-auto h-64"
|
|
308
|
+
aria-label="Storage by file type in GB"
|
|
309
|
+
>
|
|
310
|
+
<BarChart data={storage} layout="vertical" margin={{ top: 0, right: 48, left: 0, bottom: 0 }}>
|
|
311
|
+
<CartesianGrid />
|
|
312
|
+
<XAxis type="number" hide />
|
|
313
|
+
<YAxis
|
|
314
|
+
type="category"
|
|
315
|
+
dataKey="type"
|
|
316
|
+
width={104}
|
|
317
|
+
tickMargin={8}
|
|
318
|
+
axisLine={false}
|
|
319
|
+
tickFormatter={(type: keyof typeof storageConfig) => String(storageConfig[type]?.label ?? type)}
|
|
320
|
+
/>
|
|
321
|
+
<ChartTooltip
|
|
322
|
+
content={<ChartTooltipContent nameKey="type" hideLabel valueFormatter={(v) => `${v} GB`} />}
|
|
323
|
+
/>
|
|
324
|
+
<Bar {...chartAnimation} dataKey="gb" radius={[0, 3, 3, 0]} maxBarSize={20}>
|
|
325
|
+
{storage.map((d) => (
|
|
326
|
+
<Cell key={d.type} fill={`var(--color-${d.type})`} />
|
|
327
|
+
))}
|
|
328
|
+
<LabelList dataKey="gb" position="right" offset={8} />
|
|
329
|
+
</Bar>
|
|
330
|
+
</BarChart>
|
|
331
|
+
</ChartContainer>
|
|
332
|
+
);
|
|
333
|
+
}
|
|
334
|
+
```
|
|
335
|
+
|
|
336
|
+
### Lines with dashes
|
|
337
|
+
|
|
338
|
+
Told apart by `--chart-1…3` and dash; the config's `dash` shows in the tooltip (`indicator="line"`) and legend.
|
|
339
|
+
|
|
340
|
+
```tsx
|
|
341
|
+
import { chartAnimation, ChartContainer, ChartLegend, ChartLegendContent, ChartTooltip, ChartTooltipContent, type ChartConfig } from "@zonsh/ui/chart";
|
|
342
|
+
import { CartesianGrid, Line, LineChart, XAxis, YAxis } from "recharts";
|
|
343
|
+
|
|
344
|
+
const latency = [
|
|
345
|
+
{ hour: "00:00", p50: 112, p95: 248, p99: 410 },
|
|
346
|
+
{ hour: "03:00", p50: 108, p95: 236, p99: 388 },
|
|
347
|
+
{ hour: "06:00", p50: 121, p95: 262, p99: 455 },
|
|
348
|
+
{ hour: "09:00", p50: 146, p95: 318, p99: 560 },
|
|
349
|
+
{ hour: "12:00", p50: 152, p95: 335, p99: 602 },
|
|
350
|
+
{ hour: "15:00", p50: 149, p95: 322, p99: 571 },
|
|
351
|
+
{ hour: "18:00", p50: 133, p95: 290, p99: 498 },
|
|
352
|
+
{ hour: "21:00", p50: 118, p95: 257, p99: 431 },
|
|
353
|
+
];
|
|
354
|
+
|
|
355
|
+
const latencyConfig = {
|
|
356
|
+
p50: { label: "p50" },
|
|
357
|
+
p95: { label: "p95", color: "var(--chart-2)", dash: "6 3" },
|
|
358
|
+
p99: { label: "p99", color: "var(--chart-3)", dash: "1.5 3" },
|
|
359
|
+
} satisfies ChartConfig;
|
|
360
|
+
|
|
361
|
+
export function LineMultiSeries() {
|
|
362
|
+
return (
|
|
363
|
+
<ChartContainer
|
|
364
|
+
config={latencyConfig}
|
|
365
|
+
className="aspect-auto h-64"
|
|
366
|
+
aria-label="Response time in milliseconds"
|
|
367
|
+
>
|
|
368
|
+
<LineChart data={latency} margin={{ top: 8, right: 20, left: 4, bottom: 0 }}>
|
|
369
|
+
<CartesianGrid />
|
|
370
|
+
<XAxis dataKey="hour" tickMargin={8} />
|
|
371
|
+
<YAxis width={40} tickMargin={4} />
|
|
372
|
+
<ChartTooltip content={<ChartTooltipContent indicator="line" valueFormatter={(v) => `${v} ms`} />} />
|
|
373
|
+
<Line {...chartAnimation} dataKey="p50" type="monotone" stroke="var(--color-p50)" />
|
|
374
|
+
<Line
|
|
375
|
+
{...chartAnimation}
|
|
376
|
+
dataKey="p95"
|
|
377
|
+
type="monotone"
|
|
378
|
+
stroke="var(--color-p95)"
|
|
379
|
+
strokeDasharray="6 3"
|
|
380
|
+
/>
|
|
381
|
+
<Line
|
|
382
|
+
{...chartAnimation}
|
|
383
|
+
dataKey="p99"
|
|
384
|
+
type="monotone"
|
|
385
|
+
stroke="var(--color-p99)"
|
|
386
|
+
strokeDasharray="1.5 3"
|
|
387
|
+
/>
|
|
388
|
+
<ChartLegend content={<ChartLegendContent />} />
|
|
389
|
+
</LineChart>
|
|
390
|
+
</ChartContainer>
|
|
391
|
+
);
|
|
392
|
+
}
|
|
393
|
+
```
|
|
394
|
+
|
|
395
|
+
### Pie
|
|
396
|
+
|
|
397
|
+
Dark to light, clockwise from twelve. `[--chart-sector-gap:var(--background)]` on the container draws a 2px gap in the colour behind (the card's surface in a card). `activeShape={ChartActiveSector}` lifts the hovered slice 4px out and 3% larger.
|
|
398
|
+
|
|
399
|
+
```tsx
|
|
400
|
+
import { ChartActiveSector, chartAnimation, ChartContainer, ChartLegend, ChartLegendContent, ChartTooltip, ChartTooltipContent, type ChartConfig } from "@zonsh/ui/chart";
|
|
401
|
+
import { Cell, Pie, PieChart } from "recharts";
|
|
402
|
+
|
|
403
|
+
const sources = [
|
|
404
|
+
{ source: "search", visits: 1460 },
|
|
405
|
+
{ source: "direct", visits: 980 },
|
|
406
|
+
{ source: "social", visits: 310 },
|
|
407
|
+
];
|
|
408
|
+
|
|
409
|
+
const sourcesConfig = {
|
|
410
|
+
search: { label: "Search", color: "var(--chart-1)" },
|
|
411
|
+
direct: { label: "Direct", color: "var(--chart-3)" },
|
|
412
|
+
social: { label: "Social", color: "var(--chart-5)" },
|
|
413
|
+
} satisfies ChartConfig;
|
|
414
|
+
|
|
415
|
+
export function PieBasic() {
|
|
416
|
+
return (
|
|
417
|
+
<ChartContainer
|
|
418
|
+
config={sourcesConfig}
|
|
419
|
+
className="mx-auto aspect-square max-h-72 [--chart-sector-gap:var(--background)]"
|
|
420
|
+
aria-label="Visits by source"
|
|
421
|
+
>
|
|
422
|
+
<PieChart>
|
|
423
|
+
<ChartTooltip content={<ChartTooltipContent nameKey="source" hideLabel />} />
|
|
424
|
+
<Pie
|
|
425
|
+
{...chartAnimation}
|
|
426
|
+
data={sources}
|
|
427
|
+
dataKey="visits"
|
|
428
|
+
nameKey="source"
|
|
429
|
+
activeShape={ChartActiveSector}
|
|
430
|
+
outerRadius="88%"
|
|
431
|
+
startAngle={90}
|
|
432
|
+
endAngle={-270}
|
|
433
|
+
>
|
|
434
|
+
{sources.map((t) => (
|
|
435
|
+
<Cell key={t.source} fill={`var(--color-${t.source})`} />
|
|
436
|
+
))}
|
|
437
|
+
</Pie>
|
|
438
|
+
<ChartLegend content={<ChartLegendContent nameKey="source" />} />
|
|
439
|
+
</PieChart>
|
|
440
|
+
</ChartContainer>
|
|
441
|
+
);
|
|
442
|
+
}
|
|
443
|
+
```
|
|
444
|
+
|
|
445
|
+
### Donut
|
|
446
|
+
|
|
447
|
+
`innerRadius`, a 2px `paddingAngle` and the total in Licht at the centre, in tones.
|
|
448
|
+
|
|
449
|
+
```tsx
|
|
450
|
+
import { ChartActiveSector, chartAnimation, ChartContainer, ChartLegend, ChartLegendContent, ChartTooltip, ChartTooltipContent, type ChartConfig } from "@zonsh/ui/chart";
|
|
451
|
+
import { Cell, Pie, PieChart } from "recharts";
|
|
452
|
+
|
|
453
|
+
// sources: as in the first example on this page that uses them.
|
|
454
|
+
|
|
455
|
+
const sourceTotal = sources.reduce((sum, t) => sum + t.visits, 0);
|
|
456
|
+
|
|
457
|
+
const sourceTones = {
|
|
458
|
+
search: { label: "Search" },
|
|
459
|
+
direct: { label: "Direct" },
|
|
460
|
+
social: { label: "Social" },
|
|
461
|
+
} satisfies ChartConfig;
|
|
462
|
+
|
|
463
|
+
export function PieDonut() {
|
|
464
|
+
return (
|
|
465
|
+
<ChartContainer
|
|
466
|
+
config={sourceTones}
|
|
467
|
+
palette="tones"
|
|
468
|
+
className="mx-auto aspect-square max-h-72"
|
|
469
|
+
aria-label="Visits by source"
|
|
470
|
+
>
|
|
471
|
+
<PieChart>
|
|
472
|
+
<ChartTooltip content={<ChartTooltipContent nameKey="source" hideLabel />} />
|
|
473
|
+
<Pie
|
|
474
|
+
{...chartAnimation}
|
|
475
|
+
data={sources}
|
|
476
|
+
dataKey="visits"
|
|
477
|
+
nameKey="source"
|
|
478
|
+
activeShape={ChartActiveSector}
|
|
479
|
+
innerRadius="62%"
|
|
480
|
+
outerRadius="88%"
|
|
481
|
+
paddingAngle={2}
|
|
482
|
+
startAngle={90}
|
|
483
|
+
endAngle={-270}
|
|
484
|
+
>
|
|
485
|
+
{sources.map((t) => (
|
|
486
|
+
<Cell key={t.source} fill={`var(--color-${t.source})`} />
|
|
487
|
+
))}
|
|
488
|
+
</Pie>
|
|
489
|
+
<text
|
|
490
|
+
x="50%"
|
|
491
|
+
y="50%"
|
|
492
|
+
textAnchor="middle"
|
|
493
|
+
dominantBaseline="middle"
|
|
494
|
+
className="fill-foreground font-heading text-[28px] font-light"
|
|
495
|
+
>
|
|
496
|
+
{sourceTotal.toLocaleString()}
|
|
497
|
+
</text>
|
|
498
|
+
<ChartLegend content={<ChartLegendContent nameKey="source" />} />
|
|
499
|
+
</PieChart>
|
|
500
|
+
</ChartContainer>
|
|
501
|
+
);
|
|
502
|
+
}
|
|
503
|
+
```
|
|
504
|
+
|
|
505
|
+
### Chart card
|
|
506
|
+
|
|
507
|
+
A `Card` with an eyebrow, a Licht number computed from the chart's data, and a compact chart.
|
|
508
|
+
|
|
509
|
+
```tsx
|
|
510
|
+
import { Card, Eyebrow } from "@zonsh/ui";
|
|
511
|
+
import { chartAnimation, ChartContainer, ChartGradient, ChartTooltip, ChartTooltipContent, type ChartConfig } from "@zonsh/ui/chart";
|
|
512
|
+
import { Area, AreaChart, CartesianGrid, XAxis } from "recharts";
|
|
513
|
+
|
|
514
|
+
// requests, requestsConfig: as in the first example on this page that uses them.
|
|
515
|
+
|
|
516
|
+
const total = requests.reduce((sum, d) => sum + d.requests, 0);
|
|
517
|
+
|
|
518
|
+
export function ChartCard() {
|
|
519
|
+
return (
|
|
520
|
+
<Card className="max-w-xl gap-5">
|
|
521
|
+
<div className="flex flex-wrap items-end justify-between gap-x-6 gap-y-3">
|
|
522
|
+
<div className="flex flex-col gap-3">
|
|
523
|
+
<Eyebrow>Requests · 14 days</Eyebrow>
|
|
524
|
+
<p className="m-0 flex items-baseline gap-2.5 font-heading font-light tracking-[-0.02em] text-foreground">
|
|
525
|
+
<span className="text-[48px] leading-none tabular-nums">{total.toLocaleString()}</span>
|
|
526
|
+
<span className="text-[20px] leading-none text-foreground-soft">requests</span>
|
|
527
|
+
</p>
|
|
528
|
+
</div>
|
|
529
|
+
</div>
|
|
530
|
+
<ChartContainer config={requestsConfig} className="aspect-auto h-40" aria-label="Requests per day">
|
|
531
|
+
<AreaChart data={requests} margin={{ top: 4, right: 20, left: 20, bottom: 0 }}>
|
|
532
|
+
<ChartGradient id="fill-requests-card" color="var(--color-requests)" />
|
|
533
|
+
<CartesianGrid />
|
|
534
|
+
<XAxis dataKey="day" tickMargin={8} minTickGap={32} />
|
|
535
|
+
<ChartTooltip content={<ChartTooltipContent hideIndicator />} />
|
|
536
|
+
<Area
|
|
537
|
+
{...chartAnimation}
|
|
538
|
+
dataKey="requests"
|
|
539
|
+
type="monotone"
|
|
540
|
+
stroke="var(--color-requests)"
|
|
541
|
+
fill="url(#fill-requests-card)"
|
|
542
|
+
/>
|
|
543
|
+
</AreaChart>
|
|
544
|
+
</ChartContainer>
|
|
545
|
+
</Card>
|
|
546
|
+
);
|
|
547
|
+
}
|
|
548
|
+
```
|
|
549
|
+
|
|
550
|
+
### Loading and empty
|
|
551
|
+
|
|
552
|
+
`loading` keeps the frame with a sweeping placeholder (`aria-busy`). `empty` keeps the frame and says why there's nothing to plot — write `emptyMessage` as why and what would fill it. Neither draws the chart you pass.
|
|
553
|
+
|
|
554
|
+
```tsx
|
|
555
|
+
import { Eyebrow } from "@zonsh/ui";
|
|
556
|
+
import { ChartContainer, type ChartConfig } from "@zonsh/ui/chart";
|
|
557
|
+
import { Area, AreaChart } from "recharts";
|
|
558
|
+
|
|
559
|
+
// requests, requestsConfig: as in the first example on this page that uses them.
|
|
560
|
+
|
|
561
|
+
/** The same frame while the data loads, and when there is none for the period. */
|
|
562
|
+
export function States() {
|
|
563
|
+
return (
|
|
564
|
+
<div className="grid w-full max-w-3xl gap-8 sm:grid-cols-2">
|
|
565
|
+
<div className="flex flex-col gap-3">
|
|
566
|
+
<Eyebrow>Loading</Eyebrow>
|
|
567
|
+
<ChartContainer
|
|
568
|
+
loading
|
|
569
|
+
config={requestsConfig}
|
|
570
|
+
className="aspect-auto h-40"
|
|
571
|
+
aria-label="Requests per day"
|
|
572
|
+
>
|
|
573
|
+
<AreaChart data={requests}>
|
|
574
|
+
<Area dataKey="requests" />
|
|
575
|
+
</AreaChart>
|
|
576
|
+
</ChartContainer>
|
|
577
|
+
</div>
|
|
578
|
+
<div className="flex flex-col gap-3">
|
|
579
|
+
<Eyebrow>Empty</Eyebrow>
|
|
580
|
+
<ChartContainer
|
|
581
|
+
empty
|
|
582
|
+
emptyMessage="No requests in these 14 days. They show here once an API key is used."
|
|
583
|
+
config={requestsConfig}
|
|
584
|
+
className="aspect-auto h-40"
|
|
585
|
+
aria-label="Requests per day"
|
|
586
|
+
>
|
|
587
|
+
<AreaChart data={[]}>
|
|
588
|
+
<Area dataKey="requests" />
|
|
589
|
+
</AreaChart>
|
|
590
|
+
</ChartContainer>
|
|
591
|
+
</div>
|
|
592
|
+
</div>
|
|
593
|
+
);
|
|
594
|
+
}
|
|
595
|
+
```
|
|
596
|
+
|
|
597
|
+
### Values as a table
|
|
598
|
+
|
|
599
|
+
A table gives exact numbers, and is what many screen reader users want. Offer both when values matter.
|
|
600
|
+
|
|
601
|
+
```tsx
|
|
602
|
+
import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow, Tabs, TabsList, TabsPanel, TabsTab } from "@zonsh/ui";
|
|
603
|
+
import { chartAnimation, ChartContainer, ChartTooltip, ChartTooltipContent, type ChartConfig } from "@zonsh/ui/chart";
|
|
604
|
+
import { Bar, BarChart, CartesianGrid, XAxis, YAxis } from "recharts";
|
|
605
|
+
|
|
606
|
+
// requests, requestsConfig: as in the first example on this page that uses them.
|
|
607
|
+
|
|
608
|
+
/** The chart for the shape, and the same values as a table for the exact numbers. */
|
|
609
|
+
export function WithTable() {
|
|
610
|
+
return (
|
|
611
|
+
<Tabs defaultValue="chart" className="max-w-xl">
|
|
612
|
+
<TabsList variant="underline" aria-label="Requests per day, shown as">
|
|
613
|
+
<TabsTab value="chart">Chart</TabsTab>
|
|
614
|
+
<TabsTab value="table">Table</TabsTab>
|
|
615
|
+
</TabsList>
|
|
616
|
+
<TabsPanel value="chart" className="pt-4">
|
|
617
|
+
<ChartContainer config={requestsConfig} className="aspect-auto h-56" aria-label="Requests per day">
|
|
618
|
+
<BarChart data={requests} margin={{ top: 4, right: 0, left: 0, bottom: 0 }}>
|
|
619
|
+
<CartesianGrid />
|
|
620
|
+
<XAxis dataKey="day" tickMargin={8} minTickGap={24} />
|
|
621
|
+
<YAxis width={40} tickMargin={4} />
|
|
622
|
+
<ChartTooltip content={<ChartTooltipContent hideIndicator />} />
|
|
623
|
+
<Bar {...chartAnimation} dataKey="requests" fill="var(--color-requests)" radius={[3, 3, 0, 0]} />
|
|
624
|
+
</BarChart>
|
|
625
|
+
</ChartContainer>
|
|
626
|
+
</TabsPanel>
|
|
627
|
+
<TabsPanel value="table" className="pt-4">
|
|
628
|
+
<Table size="sm" variant="plain" containerProps={{ className: "max-h-56" }}>
|
|
629
|
+
<TableHeader>
|
|
630
|
+
<TableRow>
|
|
631
|
+
<TableHead>Day</TableHead>
|
|
632
|
+
<TableHead numeric>Requests</TableHead>
|
|
633
|
+
</TableRow>
|
|
634
|
+
</TableHeader>
|
|
635
|
+
<TableBody>
|
|
636
|
+
{requests.map((row) => (
|
|
637
|
+
<TableRow key={row.day}>
|
|
638
|
+
<TableCell>{row.day}</TableCell>
|
|
639
|
+
<TableCell numeric>{row.requests.toLocaleString("en-US")}</TableCell>
|
|
640
|
+
</TableRow>
|
|
641
|
+
))}
|
|
642
|
+
</TableBody>
|
|
643
|
+
</Table>
|
|
644
|
+
</TabsPanel>
|
|
645
|
+
</Tabs>
|
|
646
|
+
);
|
|
647
|
+
}
|
|
648
|
+
```
|
|
649
|
+
|
|
650
|
+
## Props
|
|
651
|
+
|
|
652
|
+
### `ChartContainer`
|
|
653
|
+
|
|
654
|
+
| Prop | Type | Default |
|
|
655
|
+
| -------------- | ----------------------------------------------------- | -------------- |
|
|
656
|
+
| `config` | `ChartConfig` — series key → settings | — |
|
|
657
|
+
| `palette` | `"mono" \| "tones"` — default colours | `"mono"` |
|
|
658
|
+
| `grid` | `"horizontal" \| "vertical" \| "both"` | `"horizontal"` |
|
|
659
|
+
| `loading` | `boolean` — the frame with a placeholder, `aria-busy` | `false` |
|
|
660
|
+
| `empty` | `boolean` — the frame with `emptyMessage` | `false` |
|
|
661
|
+
| `emptyMessage` | `ReactNode` | `labels.empty` |
|
|
662
|
+
| `labels` | `{ loading?, empty? }` | English |
|
|
663
|
+
| `className` | size it: `aspect-auto h-60`, `max-h-72` | `aspect-video` |
|
|
664
|
+
| `children` | one Recharts chart | — |
|
|
665
|
+
|
|
666
|
+
Forwards `div` props; name the chart with `aria-label`. `--chart-sector-gap` separates pie segments with a 2px rule in that colour.
|
|
667
|
+
|
|
668
|
+
### `ChartConfig` entry (`ChartSeriesConfig`)
|
|
669
|
+
|
|
670
|
+
| Key | Type | Purpose |
|
|
671
|
+
| --------- | ------------------------ | ------------------------------------------------------------------------- |
|
|
672
|
+
| `label` | `ReactNode` | name in tooltip and legend |
|
|
673
|
+
| `color` | CSS colour | defaults to the palette in key order: `var(--chart-n)` or `var(--tone-…)` |
|
|
674
|
+
| `icon` | lucide component | replaces the swatch |
|
|
675
|
+
| `dash` | SVG dash array (`"4 3"`) | shows a dashed line swatch; pass the same to `strokeDasharray` |
|
|
676
|
+
| `pattern` | `"solid" \| "hatch"` | shows a hatched swatch; fill the mark with `ChartHatch` |
|
|
677
|
+
|
|
678
|
+
A key that isn't a plain CSS name (`"New York"`, `"p99.9"`) is escaped in its variable: write `chartColor("New York")` wherever you'd write the `var()` (`stroke`, a `Cell`'s `fill`, a gradient or hatch `color`). Keep gradient and hatch `id`s plain: they go into `url(#id)`.
|
|
679
|
+
|
|
680
|
+
### `ChartTooltipContent`
|
|
681
|
+
|
|
682
|
+
| Prop | Type | Default |
|
|
683
|
+
| ---------------- | ---------------------------------- | ------------------ |
|
|
684
|
+
| `indicator` | `"dot" \| "line" \| "dashed"` | `"dot"` |
|
|
685
|
+
| `hideLabel` | `boolean` | `false` |
|
|
686
|
+
| `hideIndicator` | `boolean` — for a single series | `false` |
|
|
687
|
+
| `labelFormatter` | `(label, payload) => ReactNode` | — |
|
|
688
|
+
| `valueFormatter` | `(value, name, item) => ReactNode` | `toLocaleString()` |
|
|
689
|
+
| `nameKey` | payload field naming each item | — |
|
|
690
|
+
| `labelKey` | config key / field for the heading | — |
|
|
691
|
+
|
|
692
|
+
`ChartLegendContent` takes `nameKey` and `hideIcon`. `ChartTooltip` and `ChartLegend` are Recharts' `Tooltip` and `Legend`. `ChartGradient` and `ChartHatch` take `id` and `color` (plus `from`/`to` opacity, or `angle`); use them as `fill="url(#id)"`. `useChart()` returns the config; `chartColor(key)` a series' escaped `var(--color-<key>)`.
|
|
693
|
+
|
|
694
|
+
## Many points
|
|
695
|
+
|
|
696
|
+
A chart a few hundred pixels wide shows at most two or three points per pixel, but Recharts processes them all. Past a few thousand:
|
|
697
|
+
|
|
698
|
+
- **Downsample.** `downsample(data, keys, buckets = 600)` keeps each bucket's first point and each series' low and high, so peaks survive: 100,000 readings become about 3,000.
|
|
699
|
+
|
|
700
|
+
```tsx
|
|
701
|
+
<LineChart data={downsample(readings, ["cpu", "memory"])}>
|
|
702
|
+
```
|
|
703
|
+
|
|
704
|
+
- **Give a time or number axis `type="number"`.** A category axis measures every label — seconds at 10,000 points.
|
|
705
|
+
|
|
706
|
+
## Motion
|
|
707
|
+
|
|
708
|
+
Recharts' defaults are slow (1.5s, 400ms for bars). Spread `chartAnimation` — 300ms on `--ease` — on every series:
|
|
709
|
+
|
|
710
|
+
```tsx
|
|
711
|
+
<Line {...chartAnimation} dataKey="p95" stroke="var(--color-p95)" />
|
|
712
|
+
```
|
|
713
|
+
|
|
714
|
+
`ChartContainer` can't set it: Recharts reads it from each series element, and rewriting children would break wrapped series. Animation is off under `prefers-reduced-motion`.
|
|
715
|
+
|
|
716
|
+
## Brand rules
|
|
717
|
+
|
|
718
|
+
- **Do** leave colours to the palette; in grey, separate series by value plus dash, hatch or opacity.
|
|
719
|
+
- **Do** keep lines at 1.5px with no dots, bars at a 3px data-end radius and at most 24px thick.
|
|
720
|
+
- **Do** show a legend for two or more series; a single series is named by its title or `aria-label`.
|
|
721
|
+
- **Do** label sparingly — bar tips or the line's end, never a number on every point.
|
|
722
|
+
- **Don't** colour one series for emphasis, or use a status colour for a series that is not that status — `--destructive` marks errors only.
|
|
723
|
+
- **Don't** mix tones and status colours in one chart; they would read as one scale.
|
|
724
|
+
- **Don't** add a second y-axis; two measures of different scale are two charts.
|
|
725
|
+
- **Don't** add chart junk: tick marks, vertical grid on columns, borders around marks, 3D, shadows.
|
|
726
|
+
- **Don't** present invented numbers as measured ones.
|
|
727
|
+
|
|
728
|
+
## Accessibility
|
|
729
|
+
|
|
730
|
+
- Name every chart with `aria-label` on `ChartContainer` (or a visible title it sits under).
|
|
731
|
+
- Recharts' accessibility layer is on: the chart is focusable and arrow keys move the tooltip; focus shows the 2px `--control-focus` outline.
|
|
732
|
+
- Identity never depends on colour or grey alone — legends, axis labels, dashes and hatches carry it. Offer a table when exact numbers matter.
|
|
733
|
+
- `loading` is `aria-busy` and says "Loading the chart" (`messages.chart.loading`); `empty` says why in text. `LocaleProvider` sets both.
|
|
734
|
+
- Animation is off under `prefers-reduced-motion`, and the tooltip and cursor move instantly there.
|
|
735
|
+
|
|
736
|
+
---
|
|
737
|
+
|
|
738
|
+
- Import: `import { ChartContainer, ChartTooltip, ChartTooltipContent, ChartLegend, ChartLegendContent, ChartGradient, ChartHatch, useChart } from "@zonsh/ui/chart"`
|
|
739
|
+
- Source: `packages/ui/src/components/chart.tsx`
|