@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,222 @@
|
|
|
1
|
+
# Spinner
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Eyebrow, SPINNER_VARIANTS, Spinner } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
export function Basic() {
|
|
7
|
+
return (
|
|
8
|
+
// Columns by the room the example has, not the screen, so the names never run together.
|
|
9
|
+
<div className="@container w-full max-w-3xl">
|
|
10
|
+
<ul className="m-0 grid list-none grid-cols-2 gap-x-6 gap-y-10 p-0 @2xs:grid-cols-3 @md:grid-cols-4 @xl:grid-cols-6">
|
|
11
|
+
{SPINNER_VARIANTS.map((variant) => (
|
|
12
|
+
<li key={variant} className="flex flex-col items-center gap-4">
|
|
13
|
+
<Spinner variant={variant} size="lg" label={`Loading (${variant})`} />
|
|
14
|
+
<Eyebrow as="span">{variant}</Eyebrow>
|
|
15
|
+
</li>
|
|
16
|
+
))}
|
|
17
|
+
</ul>
|
|
18
|
+
</div>
|
|
19
|
+
);
|
|
20
|
+
}
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
An indeterminate loading indicator with `role="status"` and a name, in the current text colour. CSS only: no timers, the same on the server, transform and opacity. Under reduced motion each face holds a "busy" pose and breathes in opacity.
|
|
24
|
+
|
|
25
|
+
## Usage
|
|
26
|
+
|
|
27
|
+
```tsx
|
|
28
|
+
import { Spinner } from "@zonsh/ui";
|
|
29
|
+
|
|
30
|
+
<Spinner label="Sending message" />
|
|
31
|
+
<Spinner variant="dots" size="sm" label="Saving draft" />
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
- `label` — say what is loading: "Sending message".
|
|
35
|
+
- `variant` — the face; `ring` by default.
|
|
36
|
+
- `size` — `sm` 12px, `default` 16px, `lg` 20px.
|
|
37
|
+
|
|
38
|
+
| Face | What it does (still: under reduced motion) |
|
|
39
|
+
| ---------- | -------------------------------------------------------- |
|
|
40
|
+
| `ring` | A lucide `LoaderCircle`, once a second. The default. |
|
|
41
|
+
| `arc` | An arc growing and shrinking as it turns, over a track. |
|
|
42
|
+
| `dots` | Three dots lifting in turn. Still: an ellipsis. |
|
|
43
|
+
| `bars` | Four bars rising and falling, an equaliser. |
|
|
44
|
+
| `pulse` | A ring widening from a dot. Still: a target. |
|
|
45
|
+
| `orbit` | A dot circling a hairline orbit. |
|
|
46
|
+
| `grid` | A 3×3 grid, a wave from the top-left. |
|
|
47
|
+
| `cursor` | A blinking block cursor. Still: a solid block. |
|
|
48
|
+
| `ascii` | `\| / − \` in Licht Mono. Still: `…`. |
|
|
49
|
+
| `brackets` | The logo's brackets opening and closing. Still: the mark. |
|
|
50
|
+
| `crescent` | A moon waxing and waning, tilted 14°. Still: the crescent. |
|
|
51
|
+
|
|
52
|
+
## When to use
|
|
53
|
+
|
|
54
|
+
- A short wait of unknown length: sending, saving, syncing.
|
|
55
|
+
- `ring` in controls and copy; `dots` where it is too busy. `arc`, `bars`, `pulse`, `orbit`, `grid` in panels and fetching cards.
|
|
56
|
+
- `cursor` and `ascii` beside mono labels: status lines, logs.
|
|
57
|
+
- `brackets` and `crescent` for brand moments (a splash, a first load). One per view.
|
|
58
|
+
- Known progress: `Progress`. Known layout of the coming content: `Skeleton`.
|
|
59
|
+
|
|
60
|
+
## Examples
|
|
61
|
+
|
|
62
|
+
### Sizes
|
|
63
|
+
|
|
64
|
+
Every face at `sm`, `default` (the icon size inside buttons) and `lg`.
|
|
65
|
+
|
|
66
|
+
```tsx
|
|
67
|
+
import { Eyebrow, SPINNER_VARIANTS, Spinner } from "@zonsh/ui";
|
|
68
|
+
import * as React from "react";
|
|
69
|
+
|
|
70
|
+
export function Sizes() {
|
|
71
|
+
return (
|
|
72
|
+
// The size columns give way to the names in a narrow frame.
|
|
73
|
+
<div className="grid grid-cols-[auto_repeat(3,minmax(min-content,4.5rem))] items-center gap-x-2 gap-y-5">
|
|
74
|
+
<span />
|
|
75
|
+
{(["sm", "default", "lg"] as const).map((size) => (
|
|
76
|
+
<Eyebrow key={size} as="span" className="text-center">
|
|
77
|
+
{size}
|
|
78
|
+
</Eyebrow>
|
|
79
|
+
))}
|
|
80
|
+
{SPINNER_VARIANTS.map((variant) => (
|
|
81
|
+
<React.Fragment key={variant}>
|
|
82
|
+
<Eyebrow as="span" className="pr-4">
|
|
83
|
+
{variant}
|
|
84
|
+
</Eyebrow>
|
|
85
|
+
{(["sm", "default", "lg"] as const).map((size) => (
|
|
86
|
+
<span key={size} className="flex justify-center">
|
|
87
|
+
<Spinner variant={variant} size={size} label={`Loading (${variant}, ${size})`} />
|
|
88
|
+
</span>
|
|
89
|
+
))}
|
|
90
|
+
</React.Fragment>
|
|
91
|
+
))}
|
|
92
|
+
</div>
|
|
93
|
+
);
|
|
94
|
+
}
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
### In a button
|
|
98
|
+
|
|
99
|
+
Use Button's `loading` first ("Send message"): the ring takes the icon's place or covers the label, the width holds, the button is `aria-busy` and inert. For another face ("Save draft"): hide the label with `invisible`, lay the spinner over it `absolute` in a `relative` button, set `aria-busy` and ignore repeat clicks.
|
|
100
|
+
|
|
101
|
+
```tsx
|
|
102
|
+
import { Button, Spinner } from "@zonsh/ui";
|
|
103
|
+
import { SendIcon } from "lucide-react";
|
|
104
|
+
import * as React from "react";
|
|
105
|
+
|
|
106
|
+
/** One pending flag per button: each button loads on its own. */
|
|
107
|
+
function usePending(ms = 2000) {
|
|
108
|
+
const [pending, setPending] = React.useState(false);
|
|
109
|
+
const timer = React.useRef<number | undefined>(undefined);
|
|
110
|
+
React.useEffect(() => () => window.clearTimeout(timer.current), []);
|
|
111
|
+
const start = () => {
|
|
112
|
+
if (pending) return;
|
|
113
|
+
setPending(true);
|
|
114
|
+
timer.current = window.setTimeout(() => setPending(false), ms);
|
|
115
|
+
};
|
|
116
|
+
return [pending, start] as const;
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
export function InButton() {
|
|
120
|
+
const [sending, send] = usePending();
|
|
121
|
+
const [saving, save] = usePending();
|
|
122
|
+
|
|
123
|
+
return (
|
|
124
|
+
<div className="flex flex-wrap items-center gap-3">
|
|
125
|
+
<Button onClick={send} loading={sending} loadingLabel="Sending message">
|
|
126
|
+
<SendIcon className="rtl:-scale-x-100" />
|
|
127
|
+
Send message
|
|
128
|
+
</Button>
|
|
129
|
+
<Button variant="secondary" onClick={save} aria-busy={saving} className="relative">
|
|
130
|
+
<span className={saving ? "invisible" : undefined}>Save draft</span>
|
|
131
|
+
{saving && <Spinner variant="dots" label="Saving draft" className="absolute" />}
|
|
132
|
+
</Button>
|
|
133
|
+
</div>
|
|
134
|
+
);
|
|
135
|
+
}
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
### Inline status
|
|
139
|
+
|
|
140
|
+
```tsx
|
|
141
|
+
import { Spinner } from "@zonsh/ui";
|
|
142
|
+
|
|
143
|
+
export function Inline() {
|
|
144
|
+
return (
|
|
145
|
+
<div className="flex flex-col gap-3">
|
|
146
|
+
<p className="m-0 flex items-center gap-2 font-mono text-xs text-muted-foreground">
|
|
147
|
+
<Spinner variant="ascii" size="sm" label="Syncing" />
|
|
148
|
+
Syncing photos from your phone
|
|
149
|
+
</p>
|
|
150
|
+
<p className="m-0 flex items-center gap-2 font-mono text-xs text-muted-foreground">
|
|
151
|
+
<Spinner variant="cursor" size="sm" label="Running build" />
|
|
152
|
+
Building the site
|
|
153
|
+
</p>
|
|
154
|
+
<p className="m-0 flex items-center gap-2 text-sm text-muted-foreground">
|
|
155
|
+
<Spinner variant="arc" size="sm" label="Checking availability" />
|
|
156
|
+
Checking the calendar for a free slot
|
|
157
|
+
</p>
|
|
158
|
+
</div>
|
|
159
|
+
);
|
|
160
|
+
}
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
### Scaled up
|
|
164
|
+
|
|
165
|
+
Brand faces for a splash, sized with a class; the drawing scales with the box.
|
|
166
|
+
|
|
167
|
+
```tsx
|
|
168
|
+
import { Eyebrow, Spinner } from "@zonsh/ui";
|
|
169
|
+
|
|
170
|
+
export function Brand() {
|
|
171
|
+
return (
|
|
172
|
+
<div className="flex flex-wrap items-center gap-16">
|
|
173
|
+
<div className="flex flex-col items-center gap-4">
|
|
174
|
+
<Spinner variant="brackets" size="lg" label="Loading zon" className="size-12" />
|
|
175
|
+
<Eyebrow as="span">brackets</Eyebrow>
|
|
176
|
+
</div>
|
|
177
|
+
<div className="flex flex-col items-center gap-4">
|
|
178
|
+
<Spinner variant="crescent" size="lg" label="Loading" className="size-12" />
|
|
179
|
+
<Eyebrow as="span">crescent</Eyebrow>
|
|
180
|
+
</div>
|
|
181
|
+
</div>
|
|
182
|
+
);
|
|
183
|
+
}
|
|
184
|
+
```
|
|
185
|
+
|
|
186
|
+
## Motion
|
|
187
|
+
|
|
188
|
+
- Durations: `ring` 1s, `ascii` 0.52s, `dots` and `bars` 1s, `orbit` and `grid` 1.2s, `arc`, `pulse` and `brackets` 1.6s, `crescent` 2.4s — all looping.
|
|
189
|
+
- `brackets` uses the logo's geometry and `--ease`; each half moves 3/24 of the box outward and back.
|
|
190
|
+
- `crescent` slides a masked shadow along the mark's 14° axis; a hairline keeps the new moon visible. At rest the shadow matches the mark's cut.
|
|
191
|
+
- Keyframes: `styles/parts/feedback.css`. Each part's resting style is its reduced-motion pose, where the spinner fades between 100% and 55% every 0.8s.
|
|
192
|
+
|
|
193
|
+
## Props
|
|
194
|
+
|
|
195
|
+
| Prop | Type | Default |
|
|
196
|
+
| --------- | ------------------------------------------------------------------------------------------------------------------------ | ----------- |
|
|
197
|
+
| `variant` | `"ring" \| "arc" \| "dots" \| "bars" \| "pulse" \| "orbit" \| "grid" \| "cursor" \| "ascii" \| "brackets" \| "crescent"` | `"ring"` |
|
|
198
|
+
| `size` | `"sm" \| "default" \| "lg"` | `"default"` |
|
|
199
|
+
| `label` | `string` — the accessible name | `"Loading"` |
|
|
200
|
+
|
|
201
|
+
Other `<span>` props are forwarded. `SPINNER_VARIANTS` lists every face in gallery order. Data attributes: `data-slot="spinner"`, `data-variant`, `data-size`. Without a `label`, the status reads `messages.spinner.loading`.
|
|
202
|
+
|
|
203
|
+
## Brand rules
|
|
204
|
+
|
|
205
|
+
- **Do** keep the spinner in the current ink; never colour it.
|
|
206
|
+
- **Do** keep a button's width while it shows a spinner.
|
|
207
|
+
- **Do** pick one face per product surface; mixed faces on one screen read as noise.
|
|
208
|
+
- **Don't** use braille or box-drawing frames for ASCII: they are not in the Licht Mono subset and fall back to another face.
|
|
209
|
+
- **Don't** put a spinner over a whole page; show skeletons for the content.
|
|
210
|
+
- **Don't** use `brackets` as the logo. The logo is `Logo` / `LogoMark`.
|
|
211
|
+
- **Don't** add a second motion (pulse, glow) alongside it.
|
|
212
|
+
|
|
213
|
+
## Accessibility
|
|
214
|
+
|
|
215
|
+
- `role="status"` with `aria-label` from `label`. Say what is loading: "Sending message", not "Loading".
|
|
216
|
+
- Remove it when the work ends and confirm the result in text (a toast, the updated content).
|
|
217
|
+
- The drawing is `aria-hidden`. Under reduced motion every face stands still and only its opacity breathes.
|
|
218
|
+
|
|
219
|
+
---
|
|
220
|
+
|
|
221
|
+
- Import: `import { Spinner } from "@zonsh/ui"`
|
|
222
|
+
- Source: `packages/ui/src/components/spinner.tsx`
|
|
@@ -0,0 +1,267 @@
|
|
|
1
|
+
# Stat
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Stat } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
/* Figures for a fictional open-source library, fixed so every render is the same. */
|
|
7
|
+
const downloads = [812, 840, 795, 901, 978, 1012, 960, 1104, 1180, 1132, 1210, 1284];
|
|
8
|
+
|
|
9
|
+
export function Basic() {
|
|
10
|
+
return (
|
|
11
|
+
<div className="w-full max-w-xs">
|
|
12
|
+
<Stat label="Downloads" value={1284} change={0.124} changeLabel="vs. last week" series={downloads} />
|
|
13
|
+
</div>
|
|
14
|
+
);
|
|
15
|
+
}
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
A product figure as type: an eyebrow label, the value in Licht Mono 24px tabular, a hairline above, no box. Optionally the change ("↗ 12.4%" and what against), a line on what it covers, and an SVG sparkline. The change is green the better way and red the worse, by `better`.
|
|
19
|
+
|
|
20
|
+
## Usage
|
|
21
|
+
|
|
22
|
+
```tsx
|
|
23
|
+
import { Stat, StatGroup } from "@zonsh/ui";
|
|
24
|
+
|
|
25
|
+
<StatGroup>
|
|
26
|
+
<Stat label="Orders" value={1284} change={0.124} changeLabel="vs. last week" series={ordersByDay} />
|
|
27
|
+
<Stat label="Build time" value="42 s" change={-0.087} better="down" />
|
|
28
|
+
</StatGroup>;
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
- `value` — a number is formatted for the locale (`format`); text is shown as is, so keep the unit in it: "42 s".
|
|
32
|
+
- `change` — signed fraction: `0.12` is a rise of 12%.
|
|
33
|
+
- `better` — `up` (orders), `down` (build times, refunds) or `neither` (only news).
|
|
34
|
+
|
|
35
|
+
## When to use
|
|
36
|
+
|
|
37
|
+
- A few figures atop a dashboard or report (`StatGroup`), or one beside a chart. `Sparkline` alone for a trend in a row.
|
|
38
|
+
- Editorial facts on a marketing page are a large Licht numeral (Brand: Numbers); a figure in a sentence stays there.
|
|
39
|
+
|
|
40
|
+
## Examples
|
|
41
|
+
|
|
42
|
+
### A row
|
|
43
|
+
|
|
44
|
+
A `<dl>` grid of as many 10rem columns as fit; or set `grid-cols-2 @3xl:grid-cols-4` in a size container.
|
|
45
|
+
|
|
46
|
+
```tsx
|
|
47
|
+
import { Stat, StatGroup } from "@zonsh/ui";
|
|
48
|
+
|
|
49
|
+
// downloads: as in the first example on this page that uses them.
|
|
50
|
+
|
|
51
|
+
const buildSeconds = [58, 55, 57, 52, 50, 51, 47, 46, 44, 45, 43, 42];
|
|
52
|
+
|
|
53
|
+
const issues = [21, 22, 20, 23, 19, 18, 18, 20, 17, 16, 18, 17];
|
|
54
|
+
|
|
55
|
+
const bundleKb = [41.2, 41.2, 41.6, 41.6, 41.9, 42.0, 42.0, 42.3, 42.3, 42.4, 42.4, 42.5];
|
|
56
|
+
|
|
57
|
+
export function Group() {
|
|
58
|
+
return (
|
|
59
|
+
<StatGroup className="w-full max-w-4xl">
|
|
60
|
+
<Stat label="Downloads" value={1284} change={0.124} changeLabel="vs. last week" series={downloads} />
|
|
61
|
+
<Stat
|
|
62
|
+
label="Build time"
|
|
63
|
+
value="42 s"
|
|
64
|
+
change={-0.087}
|
|
65
|
+
better="down"
|
|
66
|
+
changeLabel="vs. last week"
|
|
67
|
+
series={buildSeconds}
|
|
68
|
+
/>
|
|
69
|
+
<Stat label="Open issues" value={17} change={-0.056} better="down" series={issues} />
|
|
70
|
+
<Stat
|
|
71
|
+
label="Bundle size"
|
|
72
|
+
value="42.5 kB"
|
|
73
|
+
change={0.0072}
|
|
74
|
+
better="down"
|
|
75
|
+
changeLabel="gzip"
|
|
76
|
+
series={bundleKb}
|
|
77
|
+
/>
|
|
78
|
+
</StatGroup>
|
|
79
|
+
);
|
|
80
|
+
}
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
### Which way is better
|
|
84
|
+
|
|
85
|
+
`better="down"` turns a fall green; `"neither"` keeps soft ink. Zero shows a dash and "No change".
|
|
86
|
+
|
|
87
|
+
```tsx
|
|
88
|
+
import { Stat, StatGroup } from "@zonsh/ui";
|
|
89
|
+
|
|
90
|
+
export function Direction() {
|
|
91
|
+
return (
|
|
92
|
+
<StatGroup className="w-full max-w-3xl">
|
|
93
|
+
<Stat label="Sign-ups" value={312} change={0.08} changeLabel="vs. last month" />
|
|
94
|
+
<Stat
|
|
95
|
+
label="Median page load"
|
|
96
|
+
value="1.4 s"
|
|
97
|
+
change={-0.12}
|
|
98
|
+
better="down"
|
|
99
|
+
changeLabel="vs. last month"
|
|
100
|
+
/>
|
|
101
|
+
<Stat label="Refunds" value={9} change={0.5} better="down" changeLabel="up from 6" />
|
|
102
|
+
<Stat
|
|
103
|
+
label="Team members"
|
|
104
|
+
value={14}
|
|
105
|
+
change={2}
|
|
106
|
+
changeFormat={{ style: "decimal" }}
|
|
107
|
+
better="neither"
|
|
108
|
+
changeLabel="joined this month"
|
|
109
|
+
/>
|
|
110
|
+
</StatGroup>
|
|
111
|
+
);
|
|
112
|
+
}
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
### Description and format
|
|
116
|
+
|
|
117
|
+
```tsx
|
|
118
|
+
import { Stat, StatGroup } from "@zonsh/ui";
|
|
119
|
+
|
|
120
|
+
export function Description() {
|
|
121
|
+
return (
|
|
122
|
+
<StatGroup className="w-full max-w-2xl">
|
|
123
|
+
<Stat label="Lessons finished" value="18 of 24" description="Web typography, autumn term" />
|
|
124
|
+
<Stat
|
|
125
|
+
label="Takings"
|
|
126
|
+
value={4820.5}
|
|
127
|
+
format={{ style: "currency", currency: "EUR" }}
|
|
128
|
+
description="September 2026, before fees"
|
|
129
|
+
/>
|
|
130
|
+
</StatGroup>
|
|
131
|
+
);
|
|
132
|
+
}
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
### Sizes
|
|
136
|
+
|
|
137
|
+
`sm` 20px, `default` 24px, `lg` 30px.
|
|
138
|
+
|
|
139
|
+
```tsx
|
|
140
|
+
import { Stat, StatGroup } from "@zonsh/ui";
|
|
141
|
+
|
|
142
|
+
export function Sizes() {
|
|
143
|
+
return (
|
|
144
|
+
<StatGroup className="w-full max-w-2xl">
|
|
145
|
+
<Stat size="sm" label="Small" value="1,284" />
|
|
146
|
+
<Stat label="Default" value="1,284" />
|
|
147
|
+
<Stat size="lg" label="Large" value="1,284" />
|
|
148
|
+
</StatGroup>
|
|
149
|
+
);
|
|
150
|
+
}
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
### Loading and no data
|
|
154
|
+
|
|
155
|
+
`loading` puts placeholders under the label and sets `aria-busy`; load figures one by one. Unmeasured is `value={null}`: "—", read "No data", with a `description` saying why. Never 0.
|
|
156
|
+
|
|
157
|
+
```tsx
|
|
158
|
+
import { Stat, StatGroup } from "@zonsh/ui";
|
|
159
|
+
|
|
160
|
+
// downloads: as in the first example on this page that uses them.
|
|
161
|
+
|
|
162
|
+
/** One figure still loading, one with nothing to show for the period, beside one that is in. */
|
|
163
|
+
export function States() {
|
|
164
|
+
return (
|
|
165
|
+
<StatGroup className="w-full max-w-3xl">
|
|
166
|
+
<Stat label="Downloads" value={1284} change={0.124} changeLabel="vs. last week" series={downloads} />
|
|
167
|
+
<Stat label="Stars" value={null} loading changeLabel="vs. last week" />
|
|
168
|
+
<Stat
|
|
169
|
+
label="Sponsors"
|
|
170
|
+
value={null}
|
|
171
|
+
description="No sponsors yet. They show here once someone sponsors the project."
|
|
172
|
+
/>
|
|
173
|
+
</StatGroup>
|
|
174
|
+
);
|
|
175
|
+
}
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
### Sparkline on its own
|
|
179
|
+
|
|
180
|
+
`data` oldest first; it fills its box (36px tall by default). `area={false}` draws only the line; `baseline="zero"` starts at zero.
|
|
181
|
+
|
|
182
|
+
```tsx
|
|
183
|
+
import { Sparkline } from "@zonsh/ui";
|
|
184
|
+
|
|
185
|
+
// downloads: as in the first example on this page that uses them.
|
|
186
|
+
|
|
187
|
+
const packages = [
|
|
188
|
+
{ name: "core", downloads: [210, 230, 228, 251, 266, 290, 301] },
|
|
189
|
+
{ name: "cli", downloads: [88, 84, 90, 79, 76, 81, 72] },
|
|
190
|
+
{ name: "plugins", downloads: [40, 41, 39, 52, 61, 58, 66] },
|
|
191
|
+
];
|
|
192
|
+
|
|
193
|
+
export function SparklineOnItsOwn() {
|
|
194
|
+
return (
|
|
195
|
+
<ul className="m-0 flex w-full max-w-sm list-none flex-col p-0">
|
|
196
|
+
{packages.map((pkg) => (
|
|
197
|
+
<li
|
|
198
|
+
key={pkg.name}
|
|
199
|
+
className="grid grid-cols-[1fr_6rem_3rem] items-center gap-4 border-t border-border/60 py-2 last:border-b"
|
|
200
|
+
>
|
|
201
|
+
<span className="font-mono text-sm text-foreground">{pkg.name}</span>
|
|
202
|
+
<Sparkline data={pkg.downloads} className="h-6" />
|
|
203
|
+
<span className="text-end font-mono text-xs text-muted-foreground tabular-nums">
|
|
204
|
+
{pkg.downloads.at(-1)}
|
|
205
|
+
</span>
|
|
206
|
+
</li>
|
|
207
|
+
))}
|
|
208
|
+
</ul>
|
|
209
|
+
);
|
|
210
|
+
}
|
|
211
|
+
```
|
|
212
|
+
|
|
213
|
+
## Props
|
|
214
|
+
|
|
215
|
+
### Stat
|
|
216
|
+
|
|
217
|
+
| Prop | Type | Default |
|
|
218
|
+
| -------------- | --------------------------------------------------------------- | -------------------------- |
|
|
219
|
+
| `label` | `ReactNode` — the eyebrow | required |
|
|
220
|
+
| `value` | `ReactNode`; a number is formatted for the locale | required |
|
|
221
|
+
| `loading` | `boolean` — placeholders, `aria-busy` | `false` |
|
|
222
|
+
| `format` | `Intl.NumberFormatOptions` for a number value | — |
|
|
223
|
+
| `roll` | `boolean` — a number's digits roll as it changes (`NumberRoll`) | `false` |
|
|
224
|
+
| `change` | `number`, signed: `0.12` is a rise of 12% | — |
|
|
225
|
+
| `changeFormat` | `Intl.NumberFormatOptions` | percent, up to one decimal |
|
|
226
|
+
| `changeLabel` | `ReactNode` — what the change is against | — |
|
|
227
|
+
| `better` | `"up" \| "down" \| "neither"` | `"up"` |
|
|
228
|
+
| `description` | `ReactNode` | — |
|
|
229
|
+
| `series` | `number[]` — drawn as a `Sparkline` | — |
|
|
230
|
+
| `size` | `"sm" \| "default" \| "lg"` | `"default"` |
|
|
231
|
+
| `labels` | `Partial<StatMessages>` | English |
|
|
232
|
+
|
|
233
|
+
Other `<div>` props go to the root. Data attributes: `data-size`, `data-loading`; `data-empty` on `stat-value` with no value; on `stat-change`, `data-direction` (`up`, `down`, `flat`) and `data-tone` (`positive`, `negative`, `neutral`).
|
|
234
|
+
|
|
235
|
+
### Sparkline
|
|
236
|
+
|
|
237
|
+
| Prop | Type | Default |
|
|
238
|
+
| ------------- | ------------------ | ---------------- |
|
|
239
|
+
| `data` | `number[]` | required |
|
|
240
|
+
| `area` | `boolean` | `true` |
|
|
241
|
+
| `color` | CSS colour | `var(--chart-1)` |
|
|
242
|
+
| `baseline` | `"data" \| "zero"` | `"data"` |
|
|
243
|
+
| `strokeWidth` | `number` (px) | `1.25` |
|
|
244
|
+
|
|
245
|
+
Other `<svg>` props are forwarded; give it `aria-label` to make it an image people hear.
|
|
246
|
+
|
|
247
|
+
## Brand rules
|
|
248
|
+
|
|
249
|
+
- **Do** show a few figures that answer a real question, and say their period ("last 14 days").
|
|
250
|
+
- **Do** keep the value monochrome; size, never bold, makes it the thing to read.
|
|
251
|
+
- **Do** set `better` for every change shown, and `neither` when the direction is only news.
|
|
252
|
+
- **Don't** invent figures, changes or trends to fill a row.
|
|
253
|
+
- **Don't** colour the value, label or sparkline. Colour is on the change alone, with its arrow and amount.
|
|
254
|
+
- **Don't** put a stat in a card. A hairline and whitespace group a row of figures.
|
|
255
|
+
|
|
256
|
+
## Accessibility
|
|
257
|
+
|
|
258
|
+
- A Stat is a description list (`<dl>`, or a `<div>` inside a `StatGroup`'s `<dl>`), so each value is read with its label.
|
|
259
|
+
- The change is read as words — "Up 12.4%", "Down 8.7%", "No change" — and the arrow is hidden; colour is never the only signal.
|
|
260
|
+
- The sparkline is hidden; when the days matter, add a `Chart` people can step through.
|
|
261
|
+
- A loading Stat is `aria-busy` and reads "Loading"; `null` reads "No data", not a dash.
|
|
262
|
+
- Interface text comes from a `LocaleProvider` (`messages.stat`) or `labels`; numbers are formatted for its locale.
|
|
263
|
+
|
|
264
|
+
---
|
|
265
|
+
|
|
266
|
+
- Import: `import { Stat, StatGroup, Sparkline } from "@zonsh/ui"`
|
|
267
|
+
- Source: `packages/ui/src/components/stat.tsx`
|