@zonsh/ui 0.5.0 → 0.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +639 -0
- package/README.md +49 -21
- package/dist/brand.d.ts +3 -0
- package/dist/brand.js +7 -0
- package/dist/components/_breadcrumb-more.d.ts +6 -0
- package/dist/components/_breadcrumb-more.js +5 -0
- package/dist/components/_drawing-svg.d.ts +11 -0
- package/dist/components/_drawing-svg.js +30 -0
- package/dist/components/_media.d.ts +159 -0
- package/dist/components/_media.js +266 -0
- package/dist/components/_overlay.d.ts +8 -5
- package/dist/components/_overlay.js +11 -6
- package/dist/components/_scheduler-calendar.d.ts +71 -0
- package/dist/components/_scheduler-calendar.js +940 -0
- package/dist/components/_scheduler-editor.d.ts +29 -0
- package/dist/components/_scheduler-editor.js +111 -0
- package/dist/components/_scheduler-menu.d.ts +16 -0
- package/dist/components/_scheduler-menu.js +18 -0
- package/dist/components/_scheduler-parts.d.ts +164 -0
- package/dist/components/_scheduler-parts.js +327 -0
- package/dist/components/_suggest-list.d.ts +142 -0
- package/dist/components/_suggest-list.js +159 -0
- package/dist/components/_toolbar-more.d.ts +24 -0
- package/dist/components/_toolbar-more.js +25 -0
- package/dist/components/accordion.d.ts +1 -1
- package/dist/components/accordion.js +6 -6
- package/dist/components/action-sheet.d.ts +88 -0
- package/dist/components/action-sheet.js +124 -0
- package/dist/components/alert-dialog.js +3 -1
- package/dist/components/alert.d.ts +11 -18
- package/dist/components/alert.js +9 -6
- package/dist/components/app-bar.d.ts +93 -0
- package/dist/components/app-bar.js +175 -0
- package/dist/components/audio-player.d.ts +134 -0
- package/dist/components/audio-player.js +618 -0
- package/dist/components/avatar.d.ts +6 -6
- package/dist/components/avatar.js +13 -11
- package/dist/components/badge.d.ts +12 -12
- package/dist/components/badge.js +7 -5
- package/dist/components/bottom-nav.d.ts +53 -11
- package/dist/components/bottom-nav.js +388 -23
- package/dist/components/breadcrumb.d.ts +11 -2
- package/dist/components/breadcrumb.js +60 -6
- package/dist/components/button-group.js +5 -1
- package/dist/components/button.d.ts +23 -6
- package/dist/components/button.js +63 -7
- package/dist/components/calendar.js +8 -6
- package/dist/components/card.d.ts +10 -8
- package/dist/components/card.js +15 -14
- package/dist/components/carousel.d.ts +2 -2
- package/dist/components/carousel.js +21 -8
- package/dist/components/chart.d.ts +27 -1
- package/dist/components/chart.js +15 -5
- package/dist/components/checkbox.js +2 -2
- package/dist/components/code-block.d.ts +9 -2
- package/dist/components/code-block.js +26 -7
- package/dist/components/collapsible.js +3 -3
- package/dist/components/color-picker.d.ts +2 -2
- package/dist/components/color-picker.js +5 -5
- package/dist/components/combobox.d.ts +26 -7
- package/dist/components/combobox.js +32 -13
- package/dist/components/command.d.ts +29 -5
- package/dist/components/command.js +35 -10
- package/dist/components/context-menu.d.ts +5 -2
- package/dist/components/context-menu.js +24 -3
- package/dist/components/conversation.d.ts +1 -1
- package/dist/components/conversation.js +67 -13
- package/dist/components/copy-button.d.ts +1 -1
- package/dist/components/copy-button.js +1 -1
- package/dist/components/data-table.d.ts +6 -6
- package/dist/components/data-table.js +41 -15
- package/dist/components/date-picker.d.ts +31 -9
- package/dist/components/date-picker.js +100 -18
- package/dist/components/dialog.d.ts +17 -10
- package/dist/components/dialog.js +20 -13
- package/dist/components/drawer.d.ts +26 -8
- package/dist/components/drawer.js +75 -16
- package/dist/components/drawing.d.ts +25 -0
- package/dist/components/drawing.js +32 -0
- package/dist/components/empty.js +2 -2
- package/dist/components/feature-list.d.ts +65 -13
- package/dist/components/feature-list.js +116 -15
- package/dist/components/field.js +2 -2
- package/dist/components/file-drop.d.ts +9 -7
- package/dist/components/file-drop.js +8 -43
- package/dist/components/filter-bar.d.ts +10 -9
- package/dist/components/filter-bar.js +42 -25
- package/dist/components/graph.d.ts +19 -3
- package/dist/components/graph.js +170 -25
- package/dist/components/illustration.js +3 -28
- package/dist/components/input-group.d.ts +5 -10
- package/dist/components/input-group.js +16 -16
- package/dist/components/input.d.ts +2 -2
- package/dist/components/input.js +3 -3
- package/dist/components/item.d.ts +9 -6
- package/dist/components/item.js +13 -8
- package/dist/components/kbd.d.ts +1 -1
- package/dist/components/kbd.js +1 -1
- package/dist/components/lightbox.d.ts +76 -9
- package/dist/components/lightbox.js +333 -45
- package/dist/components/locale.d.ts +6 -6
- package/dist/components/logo.d.ts +21 -1
- package/dist/components/logo.js +32 -2
- package/dist/components/markdown-editor.d.ts +275 -0
- package/dist/components/markdown-editor.js +831 -0
- package/dist/components/mentions.d.ts +153 -0
- package/dist/components/mentions.js +507 -0
- package/dist/components/menu.d.ts +2 -1
- package/dist/components/menu.js +5 -4
- package/dist/components/menubar.d.ts +23 -5
- package/dist/components/menubar.js +97 -22
- package/dist/components/message.d.ts +62 -11
- package/dist/components/message.js +49 -13
- package/dist/components/meter.js +1 -1
- package/dist/components/money-input.d.ts +1 -1
- package/dist/components/money-input.js +1 -1
- package/dist/components/native-select.d.ts +2 -2
- package/dist/components/native-select.js +4 -4
- package/dist/components/navigation-menu.d.ts +3 -1
- package/dist/components/navigation-menu.js +23 -12
- package/dist/components/number-field.d.ts +2 -9
- package/dist/components/number-field.js +86 -36
- package/dist/components/number-roll.d.ts +26 -0
- package/dist/components/number-roll.js +81 -0
- package/dist/components/otp-field.d.ts +1 -1
- package/dist/components/otp-field.js +24 -3
- package/dist/components/pagination.d.ts +11 -3
- package/dist/components/pagination.js +59 -13
- package/dist/components/pdf-viewer.d.ts +1 -1
- package/dist/components/pdf-viewer.js +8 -8
- package/dist/components/phone-input.d.ts +1 -1
- package/dist/components/phone-input.js +2 -2
- package/dist/components/popover.js +5 -3
- package/dist/components/preview-card.d.ts +37 -2
- package/dist/components/preview-card.js +226 -2
- package/dist/components/progress.js +1 -1
- package/dist/components/prompt-input.d.ts +1 -1
- package/dist/components/prompt-input.js +24 -14
- package/dist/components/pull-to-refresh.d.ts +50 -0
- package/dist/components/pull-to-refresh.js +189 -0
- package/dist/components/quote.d.ts +6 -1
- package/dist/components/quote.js +3 -2
- package/dist/components/radio-group.js +1 -1
- package/dist/components/rating.d.ts +4 -1
- package/dist/components/rating.js +131 -10
- package/dist/components/reasoning.d.ts +1 -1
- package/dist/components/reasoning.js +7 -3
- package/dist/components/resizable.d.ts +1 -1
- package/dist/components/resizable.js +2 -2
- package/dist/components/response.d.ts +1 -1
- package/dist/components/response.js +18 -6
- package/dist/components/scheduler.d.ts +352 -0
- package/dist/components/scheduler.js +1717 -0
- package/dist/components/scroll-area.js +1 -1
- package/dist/components/select.d.ts +17 -4
- package/dist/components/select.js +140 -9
- package/dist/components/separator.d.ts +1 -1
- package/dist/components/separator.js +3 -3
- package/dist/components/sidebar.d.ts +44 -3
- package/dist/components/sidebar.js +57 -17
- package/dist/components/site-header.d.ts +18 -13
- package/dist/components/site-header.js +23 -11
- package/dist/components/skeleton.d.ts +17 -7
- package/dist/components/skeleton.js +22 -7
- package/dist/components/slider.js +2 -2
- package/dist/components/sortable.d.ts +55 -4
- package/dist/components/sortable.js +172 -103
- package/dist/components/sources.d.ts +1 -1
- package/dist/components/sources.js +2 -2
- package/dist/components/spinner.d.ts +4 -4
- package/dist/components/spinner.js +4 -4
- package/dist/components/stat.d.ts +21 -4
- package/dist/components/stat.js +17 -8
- package/dist/components/stepper.d.ts +1 -1
- package/dist/components/stepper.js +8 -7
- package/dist/components/suggestions.d.ts +11 -3
- package/dist/components/suggestions.js +10 -4
- package/dist/components/swipe-actions.d.ts +66 -0
- package/dist/components/swipe-actions.js +292 -0
- package/dist/components/switch.js +1 -1
- package/dist/components/table.d.ts +12 -6
- package/dist/components/table.js +78 -30
- package/dist/components/tabs.js +7 -4
- package/dist/components/tag.d.ts +19 -20
- package/dist/components/tag.js +9 -5
- package/dist/components/tags-input.d.ts +2 -7
- package/dist/components/tags-input.js +11 -8
- package/dist/components/textarea.d.ts +3 -2
- package/dist/components/textarea.js +4 -3
- package/dist/components/theme.d.ts +49 -6
- package/dist/components/theme.js +147 -9
- package/dist/components/time-field.d.ts +4 -9
- package/dist/components/time-field.js +6 -6
- package/dist/components/timeline.d.ts +19 -3
- package/dist/components/timeline.js +21 -9
- package/dist/components/tippy.d.ts +17 -1
- package/dist/components/tippy.js +95 -15
- package/dist/components/toast.d.ts +2 -7
- package/dist/components/toast.js +12 -8
- package/dist/components/toggle-group.d.ts +7 -1
- package/dist/components/toggle-group.js +16 -5
- package/dist/components/toggle.d.ts +2 -2
- package/dist/components/toggle.js +3 -2
- package/dist/components/tool-call.d.ts +1 -1
- package/dist/components/tool-call.js +4 -4
- package/dist/components/toolbar.d.ts +57 -4
- package/dist/components/toolbar.js +216 -16
- package/dist/components/tooltip.d.ts +1 -1
- package/dist/components/tooltip.js +4 -2
- package/dist/components/tour.d.ts +1 -1
- package/dist/components/tour.js +36 -15
- package/dist/components/tree.js +5 -5
- package/dist/components/typography.d.ts +31 -8
- package/dist/components/typography.js +21 -10
- package/dist/components/video-player.d.ts +7 -2
- package/dist/components/video-player.js +121 -220
- package/dist/index.d.ts +99 -92
- package/dist/index.js +99 -92
- package/dist/lib/calendar.d.ts +153 -0
- package/dist/lib/calendar.js +312 -0
- package/dist/lib/cn.d.ts +3 -1
- package/dist/lib/cn.js +5 -0
- package/dist/lib/code-highlight.d.ts +14 -0
- package/dist/lib/code-highlight.js +81 -18
- package/dist/lib/drag.d.ts +39 -0
- package/dist/lib/drag.js +96 -0
- package/dist/lib/editorial-assets.js +16 -8
- package/dist/lib/figure/figures/automation.js +25 -6
- package/dist/lib/figure/figures/bar-chart.js +6 -1
- package/dist/lib/figure/figures/brackets-classic.js +4 -1
- package/dist/lib/figure/figures/city.js +12 -2
- package/dist/lib/figure/figures/conveyor.js +17 -4
- package/dist/lib/figure/figures/database.js +5 -2
- package/dist/lib/figure/figures/documents.js +11 -3
- package/dist/lib/figure/figures/inbox.js +5 -2
- package/dist/lib/figure/figures/laptop.js +3 -1
- package/dist/lib/figure/figures/pipeline.js +45 -10
- package/dist/lib/figure/figures/platform.js +62 -7
- package/dist/lib/figure/figures/server.js +21 -5
- package/dist/lib/figure/figures/spreadsheet.js +29 -5
- package/dist/lib/figure/kernel.d.ts +4 -2
- package/dist/lib/figure/kernel.js +10 -5
- package/dist/lib/figure/parts.js +6 -2
- package/dist/lib/files.d.ts +31 -0
- package/dist/lib/files.js +60 -0
- package/dist/lib/gesture.d.ts +70 -0
- package/dist/lib/gesture.js +141 -0
- package/dist/lib/glide.d.ts +5 -0
- package/dist/lib/glide.js +9 -1
- package/dist/lib/icons.d.ts +1 -0
- package/dist/lib/icons.js +6 -0
- package/dist/lib/illustration-library.js +1 -6
- package/dist/lib/markdown-edit.d.ts +112 -0
- package/dist/lib/markdown-edit.js +557 -0
- package/dist/lib/markdown-rich-editor.d.ts +188 -0
- package/dist/lib/markdown-rich-editor.js +1153 -0
- package/dist/lib/markdown-rich.d.ts +63 -0
- package/dist/lib/markdown-rich.js +534 -0
- package/dist/lib/mentions.d.ts +100 -0
- package/dist/lib/mentions.js +246 -0
- package/dist/lib/motion.d.ts +18 -0
- package/dist/lib/motion.js +43 -5
- package/dist/lib/number-roll.d.ts +89 -0
- package/dist/lib/number-roll.js +391 -0
- package/dist/lib/platform.d.ts +6 -0
- package/dist/lib/platform.js +14 -0
- package/dist/lib/portal-container.d.ts +9 -0
- package/dist/lib/portal-container.js +10 -0
- package/dist/lib/press.d.ts +5 -0
- package/dist/lib/press.js +186 -0
- package/dist/lib/scheduler.d.ts +128 -0
- package/dist/lib/scheduler.js +272 -0
- package/dist/lib/scroll-edges.d.ts +9 -0
- package/dist/lib/scroll-edges.js +50 -0
- package/dist/lib/table-fit.d.ts +1 -1
- package/dist/lib/table-fit.js +65 -8
- package/dist/lib/theme-preset.d.ts +267 -0
- package/dist/lib/theme-preset.js +1046 -0
- package/dist/lib/theme-script.d.ts +23 -3
- package/dist/lib/theme-script.js +17 -5
- package/dist/lib/tippy/sprite.d.ts +36 -4
- package/dist/lib/tippy/sprite.js +188 -15
- package/dist/lib/tone.d.ts +4 -0
- package/dist/lib/tone.js +1 -0
- package/dist/messages/de.d.ts +3 -3
- package/dist/messages/de.js +274 -3
- package/dist/skills/zon-ui/SKILL.md +279 -0
- package/dist/skills/zon-ui/references/authoring.md +265 -0
- package/dist/skills/zon-ui/references/brand.md +416 -0
- package/dist/skills/zon-ui/references/components/accordion.md +199 -0
- package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
- package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
- package/dist/skills/zon-ui/references/components/alert.md +167 -0
- package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
- package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
- package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
- package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
- package/dist/skills/zon-ui/references/components/avatar.md +98 -0
- package/dist/skills/zon-ui/references/components/badge.md +227 -0
- package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
- package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
- package/dist/skills/zon-ui/references/components/button-group.md +216 -0
- package/dist/skills/zon-ui/references/components/button.md +309 -0
- package/dist/skills/zon-ui/references/components/calendar.md +296 -0
- package/dist/skills/zon-ui/references/components/card.md +158 -0
- package/dist/skills/zon-ui/references/components/carousel.md +297 -0
- package/dist/skills/zon-ui/references/components/chart.md +739 -0
- package/dist/skills/zon-ui/references/components/chat.md +417 -0
- package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
- package/dist/skills/zon-ui/references/components/code-block.md +143 -0
- package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
- package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
- package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
- package/dist/skills/zon-ui/references/components/combobox.md +455 -0
- package/dist/skills/zon-ui/references/components/command.md +326 -0
- package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
- package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
- package/dist/skills/zon-ui/references/components/conversation.md +146 -0
- package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
- package/dist/skills/zon-ui/references/components/crm.md +1022 -0
- package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
- package/dist/skills/zon-ui/references/components/data-table.md +776 -0
- package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
- package/dist/skills/zon-ui/references/components/dialog.md +335 -0
- package/dist/skills/zon-ui/references/components/direction.md +165 -0
- package/dist/skills/zon-ui/references/components/drawer.md +276 -0
- package/dist/skills/zon-ui/references/components/drawing.md +94 -0
- package/dist/skills/zon-ui/references/components/empty.md +225 -0
- package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
- package/dist/skills/zon-ui/references/components/field.md +209 -0
- package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
- package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
- package/dist/skills/zon-ui/references/components/form.md +970 -0
- package/dist/skills/zon-ui/references/components/graph.md +339 -0
- package/dist/skills/zon-ui/references/components/illustration.md +497 -0
- package/dist/skills/zon-ui/references/components/inbox.md +263 -0
- package/dist/skills/zon-ui/references/components/input-group.md +339 -0
- package/dist/skills/zon-ui/references/components/input.md +189 -0
- package/dist/skills/zon-ui/references/components/item.md +277 -0
- package/dist/skills/zon-ui/references/components/kanban.md +626 -0
- package/dist/skills/zon-ui/references/components/kbd.md +116 -0
- package/dist/skills/zon-ui/references/components/label.md +104 -0
- package/dist/skills/zon-ui/references/components/layout.md +291 -0
- package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
- package/dist/skills/zon-ui/references/components/locale.md +279 -0
- package/dist/skills/zon-ui/references/components/logo.md +257 -0
- package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
- package/dist/skills/zon-ui/references/components/mentions.md +512 -0
- package/dist/skills/zon-ui/references/components/menu.md +218 -0
- package/dist/skills/zon-ui/references/components/menubar.md +292 -0
- package/dist/skills/zon-ui/references/components/message.md +243 -0
- package/dist/skills/zon-ui/references/components/meter.md +105 -0
- package/dist/skills/zon-ui/references/components/money-input.md +333 -0
- package/dist/skills/zon-ui/references/components/native-select.md +197 -0
- package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
- package/dist/skills/zon-ui/references/components/number-field.md +210 -0
- package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
- package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
- package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
- package/dist/skills/zon-ui/references/components/pagination.md +109 -0
- package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
- package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
- package/dist/skills/zon-ui/references/components/popover.md +176 -0
- package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
- package/dist/skills/zon-ui/references/components/pricing.md +724 -0
- package/dist/skills/zon-ui/references/components/progress.md +92 -0
- package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
- package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
- package/dist/skills/zon-ui/references/components/quote.md +115 -0
- package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
- package/dist/skills/zon-ui/references/components/rating.md +260 -0
- package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
- package/dist/skills/zon-ui/references/components/resizable.md +213 -0
- package/dist/skills/zon-ui/references/components/response.md +170 -0
- package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
- package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
- package/dist/skills/zon-ui/references/components/select.md +351 -0
- package/dist/skills/zon-ui/references/components/separator.md +103 -0
- package/dist/skills/zon-ui/references/components/settings.md +793 -0
- package/dist/skills/zon-ui/references/components/shop.md +1715 -0
- package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
- package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
- package/dist/skills/zon-ui/references/components/site-header.md +303 -0
- package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
- package/dist/skills/zon-ui/references/components/slider.md +172 -0
- package/dist/skills/zon-ui/references/components/sortable.md +405 -0
- package/dist/skills/zon-ui/references/components/sources.md +106 -0
- package/dist/skills/zon-ui/references/components/spinner.md +222 -0
- package/dist/skills/zon-ui/references/components/stat.md +267 -0
- package/dist/skills/zon-ui/references/components/stepper.md +285 -0
- package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
- package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
- package/dist/skills/zon-ui/references/components/switch.md +160 -0
- package/dist/skills/zon-ui/references/components/table.md +999 -0
- package/dist/skills/zon-ui/references/components/tabs.md +258 -0
- package/dist/skills/zon-ui/references/components/tag.md +115 -0
- package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
- package/dist/skills/zon-ui/references/components/textarea.md +95 -0
- package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
- package/dist/skills/zon-ui/references/components/theme.md +362 -0
- package/dist/skills/zon-ui/references/components/time-field.md +222 -0
- package/dist/skills/zon-ui/references/components/timeline.md +285 -0
- package/dist/skills/zon-ui/references/components/tippy.md +243 -0
- package/dist/skills/zon-ui/references/components/toast.md +220 -0
- package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
- package/dist/skills/zon-ui/references/components/toggle.md +167 -0
- package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
- package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
- package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
- package/dist/skills/zon-ui/references/components/tour.md +423 -0
- package/dist/skills/zon-ui/references/components/tree.md +481 -0
- package/dist/skills/zon-ui/references/components/typography.md +347 -0
- package/dist/skills/zon-ui/references/components/video-player.md +386 -0
- package/dist/skills/zon-ui/references/marketing.md +467 -0
- package/dist/skills/zon-ui/references/motion.md +455 -0
- package/dist/skills/zon-ui/references/recipes.md +1232 -0
- package/dist/skills/zon-ui/references/tokens.md +866 -0
- package/dist/sources/accordion.css +4 -0
- package/dist/sources/action-sheet.css +11 -0
- package/dist/sources/alert-dialog.css +6 -0
- package/dist/sources/alert.css +3 -0
- package/dist/sources/app-bar.css +14 -0
- package/dist/sources/ascii-field.css +3 -0
- package/dist/sources/aspect-ratio.css +3 -0
- package/dist/sources/audio-player.css +20 -0
- package/dist/sources/avatar.css +3 -0
- package/dist/sources/badge.css +3 -0
- package/dist/sources/bottom-nav.css +9 -0
- package/dist/sources/breadcrumb.css +14 -0
- package/dist/sources/button-group.css +3 -0
- package/dist/sources/button.css +9 -0
- package/dist/sources/calendar.css +13 -0
- package/dist/sources/card.css +3 -0
- package/dist/sources/carousel.css +11 -0
- package/dist/sources/chart.css +5 -0
- package/dist/sources/checkbox.css +6 -0
- package/dist/sources/code-block.css +13 -0
- package/dist/sources/collapsible.css +4 -0
- package/dist/sources/color-picker.css +13 -0
- package/dist/sources/combobox.css +13 -0
- package/dist/sources/command.css +13 -0
- package/dist/sources/context-menu.css +12 -0
- package/dist/sources/conversation.css +10 -0
- package/dist/sources/copy-button.css +10 -0
- package/dist/sources/data-table.css +27 -0
- package/dist/sources/date-picker.css +20 -0
- package/dist/sources/dialog.css +9 -0
- package/dist/sources/direction.css +2 -0
- package/dist/sources/drawer.css +9 -0
- package/dist/sources/drawing.css +5 -0
- package/dist/sources/empty.css +3 -0
- package/dist/sources/feature-list.css +4 -0
- package/dist/sources/field.css +4 -0
- package/dist/sources/file-drop.css +15 -0
- package/dist/sources/filter-bar.css +30 -0
- package/dist/sources/form.css +4 -0
- package/dist/sources/graph.css +19 -0
- package/dist/sources/illustration.css +28 -0
- package/dist/sources/input-group.css +7 -0
- package/dist/sources/input.css +3 -0
- package/dist/sources/item.css +4 -0
- package/dist/sources/kbd.css +5 -0
- package/dist/sources/label.css +3 -0
- package/dist/sources/layout.css +3 -0
- package/dist/sources/lightbox.css +33 -0
- package/dist/sources/locale.css +2 -0
- package/dist/sources/logo.css +4 -0
- package/dist/sources/markdown-editor.css +41 -0
- package/dist/sources/mentions.css +13 -0
- package/dist/sources/menu.css +11 -0
- package/dist/sources/menubar.css +14 -0
- package/dist/sources/message.css +16 -0
- package/dist/sources/meter.css +4 -0
- package/dist/sources/money-input.css +10 -0
- package/dist/sources/native-select.css +4 -0
- package/dist/sources/navigation-menu.css +8 -0
- package/dist/sources/number-field.css +8 -0
- package/dist/sources/number-roll.css +6 -0
- package/dist/sources/otp-field.css +5 -0
- package/dist/sources/pagination.css +11 -0
- package/dist/sources/pdf-viewer.css +30 -0
- package/dist/sources/phone-input.css +20 -0
- package/dist/sources/popover.css +7 -0
- package/dist/sources/preview-card.css +7 -0
- package/dist/sources/progress.css +4 -0
- package/dist/sources/prompt-input.css +15 -0
- package/dist/sources/pull-to-refresh.css +14 -0
- package/dist/sources/quote.css +3 -0
- package/dist/sources/radio-group.css +5 -0
- package/dist/sources/rating.css +6 -0
- package/dist/sources/reasoning.css +6 -0
- package/dist/sources/resizable.css +4 -0
- package/dist/sources/response.css +16 -0
- package/dist/sources/scheduler.css +44 -0
- package/dist/sources/scroll-area.css +3 -0
- package/dist/sources/select.css +12 -0
- package/dist/sources/separator.css +3 -0
- package/dist/sources/sidebar.css +19 -0
- package/dist/sources/site-header.css +15 -0
- package/dist/sources/skeleton.css +3 -0
- package/dist/sources/slider.css +6 -0
- package/dist/sources/sortable.css +12 -0
- package/dist/sources/sources.css +6 -0
- package/dist/sources/spinner.css +6 -0
- package/dist/sources/stat.css +9 -0
- package/dist/sources/stepper.css +6 -0
- package/dist/sources/suggestions.css +10 -0
- package/dist/sources/swipe-actions.css +20 -0
- package/dist/sources/switch.css +5 -0
- package/dist/sources/table.css +7 -0
- package/dist/sources/tabs.css +5 -0
- package/dist/sources/tag.css +3 -0
- package/dist/sources/tags-input.css +6 -0
- package/dist/sources/textarea.css +3 -0
- package/dist/sources/theme.css +13 -0
- package/dist/sources/time-field.css +7 -0
- package/dist/sources/timeline.css +7 -0
- package/dist/sources/tippy.css +6 -0
- package/dist/sources/toast.css +6 -0
- package/dist/sources/toggle-group.css +5 -0
- package/dist/sources/toggle.css +3 -0
- package/dist/sources/tool-call.css +16 -0
- package/dist/sources/toolbar.css +14 -0
- package/dist/sources/tooltip.css +6 -0
- package/dist/sources/tour.css +14 -0
- package/dist/sources/tree.css +6 -0
- package/dist/sources/typography.css +4 -0
- package/dist/sources/video-player.css +21 -0
- package/dist/styles/ai.css +3 -0
- package/dist/styles/brand.css +98 -0
- package/dist/styles/core.css +266 -0
- package/dist/styles/editor.css +3 -0
- package/dist/styles/expressive.css +35 -56
- package/dist/styles/fonts.css +61 -117
- package/dist/styles/graph.css +4 -0
- package/dist/styles/illustration.css +4 -0
- package/dist/styles/index.css +11 -201
- package/dist/styles/material.css +138 -12
- package/dist/styles/parts/ai.css +18 -13
- package/dist/styles/parts/brand.css +2 -2
- package/dist/styles/parts/controls.css +29 -20
- package/dist/styles/parts/data.css +13 -9
- package/dist/styles/parts/editor.css +372 -0
- package/dist/styles/parts/feedback.css +32 -2
- package/dist/styles/parts/foundations.css +12 -7
- package/dist/styles/parts/graph.css +25 -9
- package/dist/styles/parts/inputs.css +172 -9
- package/dist/styles/parts/isometric.css +6 -5
- package/dist/styles/parts/navigation.css +206 -27
- package/dist/styles/parts/overlays.css +19 -4
- package/dist/styles/parts/pdf.css +2 -2
- package/dist/styles/pdf.css +3 -0
- package/dist/styles/prose.css +3 -0
- package/dist/styles/tokens.css +89 -14
- package/dist/theme.d.ts +1 -0
- package/dist/theme.js +5 -0
- package/dist/vite.d.ts +48 -59
- package/dist/vite.js +54 -21
- package/package.json +69 -2
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
# Aspect Ratio
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { AspectRatio } from "@zonsh/ui";
|
|
5
|
+
import { Illustration } from "@zonsh/ui/illustration";
|
|
6
|
+
|
|
7
|
+
export function Basic() {
|
|
8
|
+
return (
|
|
9
|
+
<AspectRatio ratio={16 / 9} className="max-w-xl surface-container">
|
|
10
|
+
<Illustration name="editorial/automation" priority />
|
|
11
|
+
</AspectRatio>
|
|
12
|
+
);
|
|
13
|
+
}
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
A full-width box that keeps its proportions; its direct child fills it, so the media never sets the height. It has no surface or radius — give it the material of what it is.
|
|
17
|
+
|
|
18
|
+
## Usage
|
|
19
|
+
|
|
20
|
+
```tsx
|
|
21
|
+
import { AspectRatio } from "@zonsh/ui";
|
|
22
|
+
import { Illustration } from "@zonsh/ui/illustration";
|
|
23
|
+
|
|
24
|
+
<AspectRatio ratio={16 / 9}>
|
|
25
|
+
<Illustration name="editorial/integration" />
|
|
26
|
+
</AspectRatio>;
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
The one prop is `ratio` (width ÷ height: `16 / 9`, `4 / 3`, `1`). An unusable ratio (0, negative, `NaN`, `Infinity`) falls back to square.
|
|
30
|
+
|
|
31
|
+
## When to use
|
|
32
|
+
|
|
33
|
+
- Illustrations, covers, screenshots and video embeds whose height follows their width.
|
|
34
|
+
- Reserving space before media loads.
|
|
35
|
+
- Not for text: it must grow with its length.
|
|
36
|
+
|
|
37
|
+
## Examples
|
|
38
|
+
|
|
39
|
+
### Ratios
|
|
40
|
+
|
|
41
|
+
```tsx
|
|
42
|
+
import { AspectRatio } from "@zonsh/ui";
|
|
43
|
+
|
|
44
|
+
export function Ratios() {
|
|
45
|
+
return (
|
|
46
|
+
<div className="grid w-full max-w-2xl grid-cols-3 items-start gap-4">
|
|
47
|
+
{[
|
|
48
|
+
{ label: "1 / 1", ratio: 1 },
|
|
49
|
+
{ label: "4 / 3", ratio: 4 / 3 },
|
|
50
|
+
{ label: "16 / 9", ratio: 16 / 9 },
|
|
51
|
+
].map(({ label, ratio }) => (
|
|
52
|
+
<figure key={label} className="m-0 flex flex-col gap-2">
|
|
53
|
+
<AspectRatio ratio={ratio} className="blueprint border border-field-edge [--cell:16px]">
|
|
54
|
+
<div className="flex items-center justify-center font-mono text-xs text-muted-foreground">
|
|
55
|
+
{label}
|
|
56
|
+
</div>
|
|
57
|
+
</AspectRatio>
|
|
58
|
+
</figure>
|
|
59
|
+
))}
|
|
60
|
+
</div>
|
|
61
|
+
);
|
|
62
|
+
}
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
### In a card
|
|
66
|
+
|
|
67
|
+
A card cover: `[--card-padding:0] overflow-hidden` on the card, then pad the content.
|
|
68
|
+
|
|
69
|
+
```tsx
|
|
70
|
+
import { AspectRatio, Card, CardDescription, CardHeader, CardTitle } from "@zonsh/ui";
|
|
71
|
+
import { Illustration } from "@zonsh/ui/illustration";
|
|
72
|
+
|
|
73
|
+
export function InCard() {
|
|
74
|
+
return (
|
|
75
|
+
<Card className="max-w-sm gap-0 overflow-hidden [--card-padding:0]">
|
|
76
|
+
<AspectRatio ratio={4 / 3} className="border-b border-field-edge">
|
|
77
|
+
<Illustration name="editorial/integration" priority />
|
|
78
|
+
</AspectRatio>
|
|
79
|
+
<CardHeader className="p-6">
|
|
80
|
+
<CardTitle>Writing for the web</CardTitle>
|
|
81
|
+
<CardDescription>
|
|
82
|
+
A short course on clear headlines, scannable paragraphs and links that say where they go.
|
|
83
|
+
</CardDescription>
|
|
84
|
+
</CardHeader>
|
|
85
|
+
</Card>
|
|
86
|
+
);
|
|
87
|
+
}
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
## Props
|
|
91
|
+
|
|
92
|
+
| Prop | Type | Default |
|
|
93
|
+
| ------- | ---------------------------------------- | ------- |
|
|
94
|
+
| `ratio` | `number` — width ÷ height, e.g. `16 / 9` | `1` |
|
|
95
|
+
|
|
96
|
+
All `<div>` props are forwarded; `style` is merged after the ratio. The direct child gets `absolute inset-0 size-full`. Add `object-cover` to a photo that should crop to fill; illustrations keep their `object-contain`. Data attribute: `data-slot="aspect-ratio"`.
|
|
97
|
+
|
|
98
|
+
## Brand rules
|
|
99
|
+
|
|
100
|
+
- **Do** take the radius of what it is: none for a region, `rounded-card` only when the box is itself an object.
|
|
101
|
+
- **Do** frame a region with `surface-container` or a `--field-edge` border, not a shadow.
|
|
102
|
+
- **Don't** give the child a fixed height; the ratio sets it.
|
|
103
|
+
- **Don't** stretch the logo or an illustration to fill a ratio — keep `object-contain`.
|
|
104
|
+
|
|
105
|
+
## Accessibility
|
|
106
|
+
|
|
107
|
+
- `AspectRatio` adds no semantics. The media inside needs its own `alt` (or `alt=""` / `aria-hidden` when decorative), and video needs captions.
|
|
108
|
+
|
|
109
|
+
---
|
|
110
|
+
|
|
111
|
+
- Import: `import { AspectRatio } from "@zonsh/ui"`
|
|
112
|
+
- Source: `packages/ui/src/components/aspect-ratio.tsx`
|
|
@@ -0,0 +1,231 @@
|
|
|
1
|
+
# Audio Player
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { AudioPlayer } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
const FILES = `${import.meta.env.BASE_URL}files`;
|
|
7
|
+
|
|
8
|
+
/** The eclipse clip's score, as 120 peaks: computed once with `audioPeaks` and kept with the file. */
|
|
9
|
+
const SCORE_PEAKS = [
|
|
10
|
+
0.04, 0.08, 0.11, 0.12, 0.11, 0.11, 0.12, 0.13, 0.17, 0.2, 0.21, 0.22, 0.22, 0.21, 0.21, 0.22, 0.23, 0.24,
|
|
11
|
+
0.24, 0.25, 0.26, 0.28, 0.28, 0.28, 0.25, 0.21, 0.17, 0.16, 0.19, 0.28, 0.34, 0.38, 0.4, 0.4, 0.39, 0.36,
|
|
12
|
+
0.31, 0.24, 0.18, 0.16, 0.17, 0.26, 1, 0.76, 0.66, 0.54, 0.46, 0.45, 0.43, 0.37, 0.33, 0.34, 0.32, 0.31,
|
|
13
|
+
0.28, 0.3, 0.31, 0.28, 0.23, 0.18, 0.18, 0.21, 0.32, 0.42, 0.5, 0.53, 0.55, 0.53, 0.49, 0.4, 0.31, 0.21,
|
|
14
|
+
0.15, 0.16, 0.19, 0.23, 0.27, 0.36, 0.54, 0.52, 0.47, 0.43, 0.43, 0.39, 0.39, 0.36, 0.36, 0.45, 0.33, 0.3,
|
|
15
|
+
0.27, 0.22, 0.16, 0.13, 0.14, 0.2, 0.26, 0.32, 0.36, 0.39, 0.39, 0.38, 0.35, 0.28, 0.2, 0.14, 0.12, 0.12,
|
|
16
|
+
0.14, 0.14, 0.13, 0.12, 0.11, 0.08, 0.07, 0.06, 0.05, 0.03, 0.02, 0.01,
|
|
17
|
+
];
|
|
18
|
+
|
|
19
|
+
export function Basic() {
|
|
20
|
+
return (
|
|
21
|
+
<div className="w-full max-w-md">
|
|
22
|
+
<AudioPlayer
|
|
23
|
+
src={`${FILES}/eclipse-score.m4a`}
|
|
24
|
+
title="Totality"
|
|
25
|
+
artist="Score for the eclipse short"
|
|
26
|
+
artwork={`${FILES}/eclipse-poster.jpg`}
|
|
27
|
+
peaks={SCORE_PEAKS}
|
|
28
|
+
/>
|
|
29
|
+
</div>
|
|
30
|
+
);
|
|
31
|
+
}
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
The browser's `<audio>` with its controls in the zon material — a sibling of the `VideoPlayer`. The waveform is the scrubber: 2px bars, played in foreground ink, the rest muted. Hovering shows the time under the pointer; a click jumps, a drag scrubs. A round raised play button anchors it, times sit at the waveform's ends in mono, and speed ("1×") and volume stay quiet.
|
|
35
|
+
|
|
36
|
+
## Usage
|
|
37
|
+
|
|
38
|
+
```tsx
|
|
39
|
+
import { AudioPlayer } from "@zonsh/ui";
|
|
40
|
+
|
|
41
|
+
<AudioPlayer
|
|
42
|
+
src={[
|
|
43
|
+
{ src: "/media/lecture-4.webm", type: "audio/webm; codecs=opus" },
|
|
44
|
+
{ src: "/media/lecture-4.m4a", type: "audio/mp4" },
|
|
45
|
+
]}
|
|
46
|
+
title="Lecture 4 — Orbits, recap"
|
|
47
|
+
artist="Mon 6 Oct"
|
|
48
|
+
peaks={lecture.peaks}
|
|
49
|
+
/>;
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
The props you'll reach for: `src`, `title`, `peaks`.
|
|
53
|
+
|
|
54
|
+
## When to use
|
|
55
|
+
|
|
56
|
+
- **`AudioPlayer`** for audio people listen to on purpose: a voice note, a lecture, a podcast, a track.
|
|
57
|
+
- **`variant="card"`** (default) for one recording on its own.
|
|
58
|
+
- **`layout="row"`** for a list of recordings, one per row under hairlines.
|
|
59
|
+
- **`layout="note"`** for a voice message inside a chat `Message`.
|
|
60
|
+
- **`variant="plain"`** without a surface: in a dialog, a sheet or on the Lightbox. **`variant="region"`** for a square surface, part of the page.
|
|
61
|
+
- **`VideoPlayer`** for anything with a picture. A sound with a still image is audio: give the image as `artwork`.
|
|
62
|
+
- Interface sounds: a plain `<audio>` without controls, played from your own button. A player asks people to do something.
|
|
63
|
+
|
|
64
|
+
## Examples
|
|
65
|
+
|
|
66
|
+
### Without peaks
|
|
67
|
+
|
|
68
|
+
Without `peaks` the waveform is a regular pattern made from the URL — stable per file, plainly not the sound. Pass real peaks where the shape helps people find their place, or `peaks="auto"` to decode the file in the browser once on screen.
|
|
69
|
+
|
|
70
|
+
```tsx
|
|
71
|
+
import { AudioPlayer } from "@zonsh/ui";
|
|
72
|
+
|
|
73
|
+
// FILES: as in the first example on this page that uses them.
|
|
74
|
+
|
|
75
|
+
export function Placeholder() {
|
|
76
|
+
return (
|
|
77
|
+
<div className="w-full max-w-md">
|
|
78
|
+
{/* No peaks: a quiet pattern made from the URL stands in for the waveform. */}
|
|
79
|
+
<AudioPlayer src={`${FILES}/eclipse-chimes.m4a`} title="Voice note from Jonas" artist="Today, 09:41" />
|
|
80
|
+
</div>
|
|
81
|
+
);
|
|
82
|
+
}
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
### List
|
|
86
|
+
|
|
87
|
+
One line each; under 384px the waveform steps out. `preload="none"` loads nothing until played, and `duration` shows the length meanwhile. Playing one pauses the one before.
|
|
88
|
+
|
|
89
|
+
```tsx
|
|
90
|
+
import { AudioPlayer } from "@zonsh/ui";
|
|
91
|
+
|
|
92
|
+
// FILES, SCORE_PEAKS: as in the first example on this page that uses them.
|
|
93
|
+
|
|
94
|
+
const RECORDINGS = [
|
|
95
|
+
{
|
|
96
|
+
id: "orbits",
|
|
97
|
+
title: "Lecture 4 — Orbits, recap",
|
|
98
|
+
date: "Mon 6 Oct",
|
|
99
|
+
file: "eclipse-score.m4a",
|
|
100
|
+
peaks: SCORE_PEAKS,
|
|
101
|
+
},
|
|
102
|
+
{ id: "shadow", title: "Office hours: the Moon's shadow", date: "Wed 8 Oct", file: "eclipse-chimes.m4a" },
|
|
103
|
+
{ id: "lab", title: "Lab notes, pinhole projector", date: "Thu 9 Oct", file: "eclipse-score.m4a" },
|
|
104
|
+
];
|
|
105
|
+
|
|
106
|
+
export function List() {
|
|
107
|
+
return (
|
|
108
|
+
<ul className="w-full max-w-2xl divide-y divide-border/60 border-y border-border/60">
|
|
109
|
+
{RECORDINGS.map((r) => (
|
|
110
|
+
<li key={r.id} className="py-2.5">
|
|
111
|
+
<AudioPlayer
|
|
112
|
+
layout="row"
|
|
113
|
+
src={`${FILES}/${r.file}`}
|
|
114
|
+
title={r.title}
|
|
115
|
+
artist={r.date}
|
|
116
|
+
peaks={r.peaks}
|
|
117
|
+
// Nothing loads until it's played; the length is known from the list.
|
|
118
|
+
preload="none"
|
|
119
|
+
duration={12}
|
|
120
|
+
/>
|
|
121
|
+
</li>
|
|
122
|
+
))}
|
|
123
|
+
</ul>
|
|
124
|
+
);
|
|
125
|
+
}
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
### Voice note
|
|
129
|
+
|
|
130
|
+
The smallest: at most 384px wide, no surface, for a message card or an assistant's reply.
|
|
131
|
+
|
|
132
|
+
```tsx
|
|
133
|
+
import { AudioPlayer, Message, MessageContent, MessageText } from "@zonsh/ui";
|
|
134
|
+
|
|
135
|
+
// FILES, SCORE_PEAKS: as in the first example on this page that uses them.
|
|
136
|
+
|
|
137
|
+
export function VoiceNote() {
|
|
138
|
+
return (
|
|
139
|
+
<div className="flex w-full max-w-2xl flex-col gap-6">
|
|
140
|
+
<Message from="user">
|
|
141
|
+
<MessageContent>
|
|
142
|
+
{/* The user's card holds it: a voice note has no surface of its own. */}
|
|
143
|
+
<MessageText className="[--card-padding:6px_10px_6px_6px]">
|
|
144
|
+
<AudioPlayer layout="note" src={`${FILES}/eclipse-chimes.m4a`} aria-label="Voice note" />
|
|
145
|
+
</MessageText>
|
|
146
|
+
</MessageContent>
|
|
147
|
+
</Message>
|
|
148
|
+
<Message from="assistant">
|
|
149
|
+
<MessageContent>
|
|
150
|
+
<MessageText>Here is the score for the eclipse short, as a preview:</MessageText>
|
|
151
|
+
<AudioPlayer
|
|
152
|
+
layout="note"
|
|
153
|
+
src={`${FILES}/eclipse-score.m4a`}
|
|
154
|
+
peaks={SCORE_PEAKS}
|
|
155
|
+
aria-label="Score preview"
|
|
156
|
+
/>
|
|
157
|
+
</MessageContent>
|
|
158
|
+
</Message>
|
|
159
|
+
</div>
|
|
160
|
+
);
|
|
161
|
+
}
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
## Props
|
|
165
|
+
|
|
166
|
+
| Prop | Type | Default |
|
|
167
|
+
| -------------------------------- | --------------------------------------------------------------------------------------------------- | -------------------------------------- |
|
|
168
|
+
| `src` | `string \| { src, type? }[]`: one URL, or encodings in order | — |
|
|
169
|
+
| `title` | `string`: shown in Licht Sans, and the player's accessible name | — |
|
|
170
|
+
| `artist` | `string`: a muted line under the title — who, or when | — |
|
|
171
|
+
| `artwork` | `string`: a square image beside the title | — |
|
|
172
|
+
| `peaks` | `number[] \| "auto"`: from 0 to 1, or decoded in the browser once on screen | a pattern from the URL |
|
|
173
|
+
| `duration` | `number`: seconds, shown until the file's own length is known | — |
|
|
174
|
+
| `variant` | `"card" \| "region" \| "plain"`: the surface | `"card"`; `"plain"` in a row or a note |
|
|
175
|
+
| `layout` | `"default" \| "row" \| "note"` | `"default"` |
|
|
176
|
+
| `size` | `"default" \| "sm"`: the play button a step smaller | `"default"` |
|
|
177
|
+
| `autoPlay` | `boolean` | `false` |
|
|
178
|
+
| `loop` | `boolean` | `false` |
|
|
179
|
+
| `preload` | `"none" \| "metadata" \| "auto"` | `"metadata"` |
|
|
180
|
+
| `volumeStorageKey` | `string`: keeps the listener's volume and mute in localStorage under this key | — |
|
|
181
|
+
| `pauseOthers` | `boolean`: starting it with sound pauses the other players with sound | `true` |
|
|
182
|
+
| `speeds` | `number[] \| false`: the speed menu | `[0.5, 0.75, 1, 1.25, 1.5, 2]` |
|
|
183
|
+
| `onPlay` / `onPause` / `onEnded` | `() => void` | — |
|
|
184
|
+
| `onTimeUpdate` | `(seconds: number) => void`: as the playhead moves | — |
|
|
185
|
+
| `audioRef` | `Ref<HTMLAudioElement>`: the element, for anything else | — |
|
|
186
|
+
| `labels` | `Partial<AudioPlayerMessages>`: the player's words, over a LocaleProvider's | English |
|
|
187
|
+
|
|
188
|
+
Other props go to the root `div`; an `aria-label` there names a player without a title. Data attributes: `data-size`, `data-variant`, `data-layout`, `data-playing` while playing, `data-ready` once the length is known. The waveform sets `--audio-progress` (0 to 1) on the root as it plays, for anything of yours that should follow it, and has `data-placeholder` while it draws the pattern.
|
|
189
|
+
|
|
190
|
+
## Brand rules
|
|
191
|
+
|
|
192
|
+
- **Do** title a recording by what it is ("Lecture 4 — Orbits, recap"), with a date or speaker as `artist`.
|
|
193
|
+
- **Do** compute peaks once and store them; never decode a file on every page view.
|
|
194
|
+
- **Don't** colour the waveform or the play button: played is foreground ink, the rest muted, as on every slider.
|
|
195
|
+
- **Don't** present the placeholder as the sound; where the shape matters, give real `peaks`.
|
|
196
|
+
- **Don't** autoplay; let people press play.
|
|
197
|
+
- **Don't** put the card in a card: use `layout="row"` in a list, `layout="note"` in a message, `variant="plain"` in a dialog.
|
|
198
|
+
|
|
199
|
+
## Another language
|
|
200
|
+
|
|
201
|
+
The words come from a LocaleProvider's `audioPlayer` messages (German ships in `@zonsh/ui/messages/de`); `labels` replaces any of them for one player. Lengths of time are functions, so each language says them its own way.
|
|
202
|
+
|
|
203
|
+
## Accessibility
|
|
204
|
+
|
|
205
|
+
- The player is a group named by its `title` (with the `artist`) or `aria-label`, and takes focus, so the shortcuts work after a click on it; tabbed to, it shows the focus ring.
|
|
206
|
+
- Play's name says what it does now ("Play", "Pause", "Play again"); mute says "Mute" or "Unmute"; the speed menu names its rate ("Speed, 1.5×").
|
|
207
|
+
- The waveform is a native range input named "Seek" that reads its value in words: "42 seconds of 3 minutes 15 seconds". The bars are for the eye only; with keyboard focus a ring goes round them and the playhead line shows.
|
|
208
|
+
- The timeline runs left to right on right-to-left pages too.
|
|
209
|
+
- A file that can't play says so in words and disables play.
|
|
210
|
+
- In forced colours, the played part takes the system highlight.
|
|
211
|
+
- Only the playhead moves (position, not motion); decoded peaks grow from the pattern, which reduced motion turns off.
|
|
212
|
+
- The volume button opens a popover with mute and the slider; on touch screens, where the device's buttons set volume, it isn't shown. `M` mutes from the keyboard.
|
|
213
|
+
|
|
214
|
+
### Keyboard
|
|
215
|
+
|
|
216
|
+
With focus anywhere in the player:
|
|
217
|
+
|
|
218
|
+
| Keys | Action |
|
|
219
|
+
| -------------- | ------------------------- |
|
|
220
|
+
| `Space` / `K` | Play or pause |
|
|
221
|
+
| `←` / `→` | Back or forward 5 seconds |
|
|
222
|
+
| `↑` / `↓` | Volume up or down |
|
|
223
|
+
| `Home` / `End` | To the start or the end |
|
|
224
|
+
| `M` | Mute or unmute |
|
|
225
|
+
|
|
226
|
+
A control that was clicked rather than tabbed to hands its keys to the player: `Space` then plays or pauses instead of pressing it again. On the scrubber and the volume, the arrows, `Home` and `End` are the slider's; on the scrubber the arrows step five seconds and Page Up/Down ten.
|
|
227
|
+
|
|
228
|
+
---
|
|
229
|
+
|
|
230
|
+
- Import: `import { AudioPlayer, audioPeaks } from "@zonsh/ui"`
|
|
231
|
+
- Source: `packages/ui/src/components/audio-player.tsx`
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
# Avatar
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Avatar } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
export function Sizes() {
|
|
7
|
+
return (
|
|
8
|
+
<div className="flex items-center gap-4">
|
|
9
|
+
<Avatar size="sm" name="Anna Becker" />
|
|
10
|
+
<Avatar name="Jonas Weber" />
|
|
11
|
+
<Avatar size="lg" name="Lea Schmitz" />
|
|
12
|
+
</div>
|
|
13
|
+
);
|
|
14
|
+
}
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
A person as a round image with a `--field-edge` ring, and mono initials from `name` while it loads or if it fails. 24, 32 and 40px; 80px (`xl`) for a profile page, 128px (`2xl`) for a picker.
|
|
18
|
+
|
|
19
|
+
## Usage
|
|
20
|
+
|
|
21
|
+
```tsx
|
|
22
|
+
import { Avatar, AvatarGroup } from "@zonsh/ui";
|
|
23
|
+
|
|
24
|
+
<Avatar name="Malik Mardan" src="/team/malik.jpg" />
|
|
25
|
+
|
|
26
|
+
<AvatarGroup max={3}>
|
|
27
|
+
<Avatar name="…" />
|
|
28
|
+
</AvatarGroup>;
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
The props you'll reach for: `name`, `src`, `size`.
|
|
32
|
+
|
|
33
|
+
## When to use
|
|
34
|
+
|
|
35
|
+
- The signed-in user, workspace members, a note's author — real people only, never stock faces.
|
|
36
|
+
|
|
37
|
+
## Examples
|
|
38
|
+
|
|
39
|
+
### Group
|
|
40
|
+
|
|
41
|
+
Past `max`, the rest collapse into `+N`.
|
|
42
|
+
|
|
43
|
+
```tsx
|
|
44
|
+
import { Avatar, AvatarGroup } from "@zonsh/ui";
|
|
45
|
+
|
|
46
|
+
export function Group() {
|
|
47
|
+
return (
|
|
48
|
+
<div className="flex flex-col items-start gap-4">
|
|
49
|
+
<AvatarGroup max={3}>
|
|
50
|
+
<Avatar name="Anna Becker" />
|
|
51
|
+
<Avatar name="Jonas Weber" />
|
|
52
|
+
<Avatar name="Lea Schmitz" />
|
|
53
|
+
<Avatar name="Tom Fischer" />
|
|
54
|
+
<Avatar name="Mia Wagner" />
|
|
55
|
+
</AvatarGroup>
|
|
56
|
+
{/* Small: give the group the size too, so they overlap less and both initials show. */}
|
|
57
|
+
<AvatarGroup max={3} size="sm">
|
|
58
|
+
<Avatar size="sm" name="Anna Becker" />
|
|
59
|
+
<Avatar size="sm" name="Jonas Weber" />
|
|
60
|
+
<Avatar size="sm" name="Lea Schmitz" />
|
|
61
|
+
<Avatar size="sm" name="Tom Fischer" />
|
|
62
|
+
</AvatarGroup>
|
|
63
|
+
</div>
|
|
64
|
+
);
|
|
65
|
+
}
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
## Props
|
|
69
|
+
|
|
70
|
+
| Prop | Type | Default |
|
|
71
|
+
| ------------------- | -------------------------------------------- | ----------- |
|
|
72
|
+
| `Avatar.src` | `string` | — |
|
|
73
|
+
| `Avatar.name` | `string` — `alt` and initials | — |
|
|
74
|
+
| `Avatar.fallback` | `ReactNode` — overrides initials | derived |
|
|
75
|
+
| `Avatar.size` | `"sm" \| "default" \| "lg" \| "xl" \| "2xl"` | `"default"` |
|
|
76
|
+
| `Avatar.imageProps` | Base UI `Avatar.Image` props | — |
|
|
77
|
+
| `AvatarGroup.max` | `number` — then `+N` | — |
|
|
78
|
+
| `AvatarGroup.size` | the avatars' size: the overlap and the `+N` | `"default"` |
|
|
79
|
+
|
|
80
|
+
Other Base UI `Avatar.Root` props are forwarded.
|
|
81
|
+
|
|
82
|
+
## Brand rules
|
|
83
|
+
|
|
84
|
+
- **Do** match sizes within a group.
|
|
85
|
+
- **Do** use a status colour for a presence dot only with a text equivalent (a `Badge` with a label); never colour alone.
|
|
86
|
+
- **Don't** colour avatars for decoration: no per-person background colours. A person is not a category.
|
|
87
|
+
- **Don't** show placeholder people in marketing material.
|
|
88
|
+
|
|
89
|
+
## Accessibility
|
|
90
|
+
|
|
91
|
+
- The image's `alt` is `name`. The initials fallback is hidden from screen readers in favour of the full name.
|
|
92
|
+
- Omit `name` beside a visible name.
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
- Import: `import { Avatar, AvatarGroup } from "@zonsh/ui"`
|
|
97
|
+
- Source: `packages/ui/src/components/avatar.tsx`
|
|
98
|
+
- Primitive: `@base-ui/react/avatar` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/avatar.md`)
|
|
@@ -0,0 +1,227 @@
|
|
|
1
|
+
# Badge
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Badge, BadgeAnchor, Button } from "@zonsh/ui";
|
|
5
|
+
import { BellIcon } from "lucide-react";
|
|
6
|
+
|
|
7
|
+
export function Basic() {
|
|
8
|
+
return (
|
|
9
|
+
<BadgeAnchor>
|
|
10
|
+
<Button size="icon" variant="secondary" aria-label="Notifications, 3 unread">
|
|
11
|
+
<BellIcon />
|
|
12
|
+
</Button>
|
|
13
|
+
<Badge count={3} aria-hidden />
|
|
14
|
+
</BadgeAnchor>
|
|
15
|
+
);
|
|
16
|
+
}
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
A round count or flag on an object: unread notifications on a bell, a person online, a new page. 20px tall (16px `sm`), Licht Mono tabular numerals, primary fill by default. `BadgeAnchor` pins it to the corner of an icon button, avatar or card, with a 2px cut-out in the page colour.
|
|
20
|
+
|
|
21
|
+
## Usage
|
|
22
|
+
|
|
23
|
+
```tsx
|
|
24
|
+
import { Badge, BadgeAnchor, Button } from "@zonsh/ui";
|
|
25
|
+
import { BellIcon } from "lucide-react";
|
|
26
|
+
|
|
27
|
+
<BadgeAnchor>
|
|
28
|
+
<Button size="icon" variant="secondary" aria-label="Notifications, 3 unread">
|
|
29
|
+
<BellIcon />
|
|
30
|
+
</Button>
|
|
31
|
+
<Badge count={3} aria-hidden />
|
|
32
|
+
</BadgeAnchor>;
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
The props you'll reach for: `count`, `dot` (with `label`) and `variant`.
|
|
36
|
+
|
|
37
|
+
## When to use
|
|
38
|
+
|
|
39
|
+
- A count on an icon button or avatar: `default` when it needs attention, `secondary` when it informs.
|
|
40
|
+
- A "NEW" marker beside a nav item or heading, as a `secondary` badge.
|
|
41
|
+
- A status dot on an avatar: online (`success`), away (`warning`), syncing (`info`), failed (`destructive`).
|
|
42
|
+
- A `Tag` names something ("TypeScript", "Draft") beside a title; a number or dot about an object is a badge. Progress is `Progress` or `Meter`.
|
|
43
|
+
|
|
44
|
+
## Examples
|
|
45
|
+
|
|
46
|
+
### Variants
|
|
47
|
+
|
|
48
|
+
`default` takes the primary fill, `secondary` the raised key surface. `tone` is a status colour, only for done, attention soon, news or failed.
|
|
49
|
+
|
|
50
|
+
```tsx
|
|
51
|
+
import { Badge } from "@zonsh/ui";
|
|
52
|
+
|
|
53
|
+
export function Variants() {
|
|
54
|
+
return (
|
|
55
|
+
<div className="flex flex-wrap items-center gap-3">
|
|
56
|
+
<Badge count={4} />
|
|
57
|
+
<Badge variant="secondary" count={12} />
|
|
58
|
+
<Badge tone="success" count={2} label="sent" />
|
|
59
|
+
<Badge tone="warning" count={4} label="expiring" />
|
|
60
|
+
<Badge tone="info" count={6} label="new" />
|
|
61
|
+
<Badge tone="destructive" count={1} label="failed" />
|
|
62
|
+
<Badge variant="secondary">NEW</Badge>
|
|
63
|
+
</div>
|
|
64
|
+
);
|
|
65
|
+
}
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
### Counts
|
|
69
|
+
|
|
70
|
+
`count` caps at `max`: 128 reads "99+". Zero renders nothing. Use `size="sm"` on 30px controls.
|
|
71
|
+
|
|
72
|
+
```tsx
|
|
73
|
+
import { Badge, BadgeAnchor, Button } from "@zonsh/ui";
|
|
74
|
+
import { BellIcon, InboxIcon, MessageSquareIcon } from "lucide-react";
|
|
75
|
+
|
|
76
|
+
export function Counts() {
|
|
77
|
+
return (
|
|
78
|
+
<div className="flex flex-wrap items-center gap-6">
|
|
79
|
+
<BadgeAnchor>
|
|
80
|
+
<Button size="icon" variant="secondary" aria-label="Messages, 8 unread">
|
|
81
|
+
<MessageSquareIcon />
|
|
82
|
+
</Button>
|
|
83
|
+
<Badge count={8} aria-hidden />
|
|
84
|
+
</BadgeAnchor>
|
|
85
|
+
<BadgeAnchor>
|
|
86
|
+
<Button size="icon" variant="secondary" aria-label="Inbox, 128 unread">
|
|
87
|
+
<InboxIcon />
|
|
88
|
+
</Button>
|
|
89
|
+
<Badge count={128} aria-hidden />
|
|
90
|
+
</BadgeAnchor>
|
|
91
|
+
<BadgeAnchor>
|
|
92
|
+
<Button size="icon-sm" variant="ghost" aria-label="Notifications, 5 unread">
|
|
93
|
+
<BellIcon />
|
|
94
|
+
</Button>
|
|
95
|
+
<Badge size="sm" variant="secondary" count={5} aria-hidden />
|
|
96
|
+
</BadgeAnchor>
|
|
97
|
+
<BadgeAnchor>
|
|
98
|
+
<Button size="icon" variant="secondary" aria-label="Notifications">
|
|
99
|
+
<BellIcon />
|
|
100
|
+
</Button>
|
|
101
|
+
<Badge count={0} aria-hidden />
|
|
102
|
+
</BadgeAnchor>
|
|
103
|
+
</div>
|
|
104
|
+
);
|
|
105
|
+
}
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
### Status dot
|
|
109
|
+
|
|
110
|
+
On an avatar use `placement="bottom-end"`. A dot always needs a `label`: colour alone tells a screen reader, or someone colour-blind, nothing.
|
|
111
|
+
|
|
112
|
+
```tsx
|
|
113
|
+
import { Avatar, Badge, BadgeAnchor } from "@zonsh/ui";
|
|
114
|
+
|
|
115
|
+
export function StatusDot() {
|
|
116
|
+
return (
|
|
117
|
+
<div className="flex flex-wrap items-center gap-6">
|
|
118
|
+
<BadgeAnchor placement="bottom-end">
|
|
119
|
+
<Avatar size="lg" name="Anna Becker" />
|
|
120
|
+
<Badge dot tone="success" label="Online" />
|
|
121
|
+
</BadgeAnchor>
|
|
122
|
+
<BadgeAnchor placement="bottom-end">
|
|
123
|
+
<Avatar size="lg" name="Jonas Weber" />
|
|
124
|
+
<Badge dot tone="warning" label="Away" />
|
|
125
|
+
</BadgeAnchor>
|
|
126
|
+
<BadgeAnchor placement="bottom-end">
|
|
127
|
+
<Avatar size="lg" name="Lea Schmitz" />
|
|
128
|
+
<Badge dot tone="destructive" label="Sync failed" />
|
|
129
|
+
</BadgeAnchor>
|
|
130
|
+
<BadgeAnchor>
|
|
131
|
+
<Avatar name="Anna Becker" />
|
|
132
|
+
<Badge size="sm" count={2} label="unread messages" />
|
|
133
|
+
</BadgeAnchor>
|
|
134
|
+
</div>
|
|
135
|
+
);
|
|
136
|
+
}
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
### New marker
|
|
140
|
+
|
|
141
|
+
A small `secondary` badge after the text. One short word in capitals.
|
|
142
|
+
|
|
143
|
+
```tsx
|
|
144
|
+
import { Badge, Button } from "@zonsh/ui";
|
|
145
|
+
import { ScrollTextIcon } from "lucide-react";
|
|
146
|
+
|
|
147
|
+
export function NewMarker() {
|
|
148
|
+
return (
|
|
149
|
+
<div className="flex flex-col items-start gap-4">
|
|
150
|
+
<p className="flex items-center gap-2 text-[15px]">
|
|
151
|
+
Document intake for scanned orders
|
|
152
|
+
<Badge variant="secondary" size="sm">
|
|
153
|
+
NEW
|
|
154
|
+
</Badge>
|
|
155
|
+
</p>
|
|
156
|
+
<Button variant="ghost">
|
|
157
|
+
<ScrollTextIcon />
|
|
158
|
+
Changelog
|
|
159
|
+
<Badge variant="secondary" size="sm">
|
|
160
|
+
NEW
|
|
161
|
+
</Badge>
|
|
162
|
+
</Button>
|
|
163
|
+
</div>
|
|
164
|
+
);
|
|
165
|
+
}
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
### On a card
|
|
169
|
+
|
|
170
|
+
`shape="rect"` pins the badge just inside the corner of a button or card. On a surface other than the page, set `--badge-cutout` to that surface's colour.
|
|
171
|
+
|
|
172
|
+
```tsx
|
|
173
|
+
import { Badge, BadgeAnchor, Button } from "@zonsh/ui";
|
|
174
|
+
import { InboxIcon } from "lucide-react";
|
|
175
|
+
|
|
176
|
+
export function OnACard() {
|
|
177
|
+
return (
|
|
178
|
+
<div className="flex flex-wrap items-center gap-4 surface-card [--badge-cutout:var(--control-surface)] [--card-padding:24px]">
|
|
179
|
+
<BadgeAnchor shape="rect">
|
|
180
|
+
<Button variant="secondary">
|
|
181
|
+
<InboxIcon />
|
|
182
|
+
Review requests
|
|
183
|
+
</Button>
|
|
184
|
+
<Badge count={6} aria-hidden />
|
|
185
|
+
</BadgeAnchor>
|
|
186
|
+
<p className="min-w-40 flex-1 text-sm text-muted-foreground">6 requests wait for a reply.</p>
|
|
187
|
+
</div>
|
|
188
|
+
);
|
|
189
|
+
}
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
## Props
|
|
193
|
+
|
|
194
|
+
| Component | Prop | Type | Default |
|
|
195
|
+
| ------------- | ----------- | ------------------------------------------------------------------------------ | ----------- |
|
|
196
|
+
| `Badge` | `variant` | `"default" \| "secondary"` | `"default"` |
|
|
197
|
+
| `Badge` | `tone` | `"success" \| "warning" \| "info" \| "destructive"` — status only | — |
|
|
198
|
+
| `Badge` | `size` | `"sm"` (16px, dot 8px) \| `"default"` (20px, dot 10px) | `"default"` |
|
|
199
|
+
| `Badge` | `count` | `number` — zero, less or `NaN` renders nothing | — |
|
|
200
|
+
| `Badge` | `max` | `number` — above it the badge reads "99+" | `99` |
|
|
201
|
+
| `Badge` | `dot` | `boolean` — a dot with no text | `false` |
|
|
202
|
+
| `Badge` | `label` | `string` — screen-reader text, required with `dot` | — |
|
|
203
|
+
| `BadgeAnchor` | `shape` | `"circle" \| "rect"` | `"circle"` |
|
|
204
|
+
| `BadgeAnchor` | `placement` | `"top-end" \| "bottom-end"` | `"top-end"` |
|
|
205
|
+
|
|
206
|
+
Both render a `<span>`. `children` on `Badge` shows a word instead of a count. `BadgeAnchor` never outgrows its container: a long label ends in "…", badge still on the corner. Data attributes: badge `data-variant`, `data-tone`, `data-size`, `data-dot`; anchor `data-shape`, `data-placement`. CSS variable: `--badge-cutout` (default `--background`).
|
|
207
|
+
|
|
208
|
+
## Brand rules
|
|
209
|
+
|
|
210
|
+
- **Do** keep most badges monochrome. A status colour means its status, nothing else.
|
|
211
|
+
- **Do** put a count on the object it counts, with `BadgeAnchor`, not floating beside it.
|
|
212
|
+
- **Don't** colour a "NEW" marker or a plain count to make it pop.
|
|
213
|
+
- **Don't** use a badge as a label for a thing ("TypeScript", "Draft"). That is a `Tag`.
|
|
214
|
+
- **Don't** show a badge for zero.
|
|
215
|
+
|
|
216
|
+
## Accessibility
|
|
217
|
+
|
|
218
|
+
- A count on an icon button belongs in the button's `aria-label` ("Notifications, 3 unread"); hide the badge with `aria-hidden` so it is not read twice.
|
|
219
|
+
- A standalone badge reads its text; add `label` for context ("2 sent").
|
|
220
|
+
- A status dot needs `label` ("Online", "Sync failed"); colour is never the only signal.
|
|
221
|
+
- Announce a live count change from the control's label or a `role="status"` region, not the badge.
|
|
222
|
+
- The badge ignores the pointer; the control keeps its full click target.
|
|
223
|
+
|
|
224
|
+
---
|
|
225
|
+
|
|
226
|
+
- Import: `import { Badge, BadgeAnchor } from "@zonsh/ui"`
|
|
227
|
+
- Source: `packages/ui/src/components/badge.tsx`
|