@zonsh/ui 0.5.0 → 0.6.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +643 -0
- package/README.md +49 -21
- package/dist/brand.d.ts +3 -0
- package/dist/brand.js +7 -0
- package/dist/components/_breadcrumb-more.d.ts +6 -0
- package/dist/components/_breadcrumb-more.js +5 -0
- package/dist/components/_drawing-svg.d.ts +11 -0
- package/dist/components/_drawing-svg.js +30 -0
- package/dist/components/_media.d.ts +159 -0
- package/dist/components/_media.js +266 -0
- package/dist/components/_overlay.d.ts +8 -5
- package/dist/components/_overlay.js +11 -6
- package/dist/components/_scheduler-calendar.d.ts +71 -0
- package/dist/components/_scheduler-calendar.js +940 -0
- package/dist/components/_scheduler-editor.d.ts +29 -0
- package/dist/components/_scheduler-editor.js +111 -0
- package/dist/components/_scheduler-menu.d.ts +16 -0
- package/dist/components/_scheduler-menu.js +18 -0
- package/dist/components/_scheduler-parts.d.ts +164 -0
- package/dist/components/_scheduler-parts.js +327 -0
- package/dist/components/_suggest-list.d.ts +142 -0
- package/dist/components/_suggest-list.js +159 -0
- package/dist/components/_toolbar-more.d.ts +24 -0
- package/dist/components/_toolbar-more.js +25 -0
- package/dist/components/accordion.d.ts +1 -1
- package/dist/components/accordion.js +6 -6
- package/dist/components/action-sheet.d.ts +88 -0
- package/dist/components/action-sheet.js +124 -0
- package/dist/components/alert-dialog.js +3 -1
- package/dist/components/alert.d.ts +11 -18
- package/dist/components/alert.js +9 -6
- package/dist/components/app-bar.d.ts +93 -0
- package/dist/components/app-bar.js +175 -0
- package/dist/components/audio-player.d.ts +134 -0
- package/dist/components/audio-player.js +618 -0
- package/dist/components/avatar.d.ts +6 -6
- package/dist/components/avatar.js +13 -11
- package/dist/components/badge.d.ts +12 -12
- package/dist/components/badge.js +7 -5
- package/dist/components/bottom-nav.d.ts +53 -11
- package/dist/components/bottom-nav.js +388 -23
- package/dist/components/breadcrumb.d.ts +11 -2
- package/dist/components/breadcrumb.js +60 -6
- package/dist/components/button-group.js +5 -1
- package/dist/components/button.d.ts +23 -6
- package/dist/components/button.js +63 -7
- package/dist/components/calendar.js +8 -6
- package/dist/components/card.d.ts +10 -8
- package/dist/components/card.js +15 -14
- package/dist/components/carousel.d.ts +2 -2
- package/dist/components/carousel.js +21 -8
- package/dist/components/chart.d.ts +27 -1
- package/dist/components/chart.js +15 -5
- package/dist/components/checkbox.js +2 -2
- package/dist/components/code-block.d.ts +9 -2
- package/dist/components/code-block.js +26 -7
- package/dist/components/collapsible.js +3 -3
- package/dist/components/color-picker.d.ts +2 -2
- package/dist/components/color-picker.js +5 -5
- package/dist/components/combobox.d.ts +26 -7
- package/dist/components/combobox.js +32 -13
- package/dist/components/command.d.ts +29 -5
- package/dist/components/command.js +35 -10
- package/dist/components/context-menu.d.ts +5 -2
- package/dist/components/context-menu.js +24 -3
- package/dist/components/conversation.d.ts +1 -1
- package/dist/components/conversation.js +67 -13
- package/dist/components/copy-button.d.ts +1 -1
- package/dist/components/copy-button.js +1 -1
- package/dist/components/data-table.d.ts +6 -6
- package/dist/components/data-table.js +41 -15
- package/dist/components/date-picker.d.ts +31 -9
- package/dist/components/date-picker.js +100 -18
- package/dist/components/dialog.d.ts +17 -10
- package/dist/components/dialog.js +20 -13
- package/dist/components/drawer.d.ts +26 -8
- package/dist/components/drawer.js +75 -16
- package/dist/components/drawing.d.ts +25 -0
- package/dist/components/drawing.js +32 -0
- package/dist/components/empty.js +2 -2
- package/dist/components/feature-list.d.ts +65 -13
- package/dist/components/feature-list.js +116 -15
- package/dist/components/field.js +2 -2
- package/dist/components/file-drop.d.ts +9 -7
- package/dist/components/file-drop.js +8 -43
- package/dist/components/filter-bar.d.ts +10 -9
- package/dist/components/filter-bar.js +42 -25
- package/dist/components/graph.d.ts +19 -3
- package/dist/components/graph.js +170 -25
- package/dist/components/illustration.js +3 -28
- package/dist/components/input-group.d.ts +5 -10
- package/dist/components/input-group.js +16 -16
- package/dist/components/input.d.ts +2 -2
- package/dist/components/input.js +3 -3
- package/dist/components/item.d.ts +9 -6
- package/dist/components/item.js +13 -8
- package/dist/components/kbd.d.ts +1 -1
- package/dist/components/kbd.js +1 -1
- package/dist/components/lightbox.d.ts +76 -9
- package/dist/components/lightbox.js +333 -45
- package/dist/components/locale.d.ts +6 -6
- package/dist/components/logo.d.ts +21 -1
- package/dist/components/logo.js +32 -2
- package/dist/components/markdown-editor.d.ts +275 -0
- package/dist/components/markdown-editor.js +831 -0
- package/dist/components/mentions.d.ts +153 -0
- package/dist/components/mentions.js +507 -0
- package/dist/components/menu.d.ts +2 -1
- package/dist/components/menu.js +5 -4
- package/dist/components/menubar.d.ts +23 -5
- package/dist/components/menubar.js +97 -22
- package/dist/components/message.d.ts +62 -11
- package/dist/components/message.js +49 -13
- package/dist/components/meter.js +1 -1
- package/dist/components/money-input.d.ts +1 -1
- package/dist/components/money-input.js +1 -1
- package/dist/components/native-select.d.ts +2 -2
- package/dist/components/native-select.js +4 -4
- package/dist/components/navigation-menu.d.ts +3 -1
- package/dist/components/navigation-menu.js +23 -12
- package/dist/components/number-field.d.ts +2 -9
- package/dist/components/number-field.js +86 -36
- package/dist/components/number-roll.d.ts +26 -0
- package/dist/components/number-roll.js +81 -0
- package/dist/components/otp-field.d.ts +1 -1
- package/dist/components/otp-field.js +24 -3
- package/dist/components/pagination.d.ts +11 -3
- package/dist/components/pagination.js +59 -13
- package/dist/components/pdf-viewer.d.ts +1 -1
- package/dist/components/pdf-viewer.js +8 -8
- package/dist/components/phone-input.d.ts +1 -1
- package/dist/components/phone-input.js +2 -2
- package/dist/components/popover.js +5 -3
- package/dist/components/preview-card.d.ts +37 -2
- package/dist/components/preview-card.js +226 -2
- package/dist/components/progress.js +1 -1
- package/dist/components/prompt-input.d.ts +1 -1
- package/dist/components/prompt-input.js +24 -14
- package/dist/components/pull-to-refresh.d.ts +50 -0
- package/dist/components/pull-to-refresh.js +189 -0
- package/dist/components/quote.d.ts +6 -1
- package/dist/components/quote.js +3 -2
- package/dist/components/radio-group.js +1 -1
- package/dist/components/rating.d.ts +4 -1
- package/dist/components/rating.js +131 -10
- package/dist/components/reasoning.d.ts +1 -1
- package/dist/components/reasoning.js +7 -3
- package/dist/components/resizable.d.ts +1 -1
- package/dist/components/resizable.js +2 -2
- package/dist/components/response.d.ts +1 -1
- package/dist/components/response.js +18 -6
- package/dist/components/scheduler.d.ts +352 -0
- package/dist/components/scheduler.js +1717 -0
- package/dist/components/scroll-area.js +1 -1
- package/dist/components/select.d.ts +17 -4
- package/dist/components/select.js +140 -9
- package/dist/components/separator.d.ts +1 -1
- package/dist/components/separator.js +3 -3
- package/dist/components/sidebar.d.ts +44 -3
- package/dist/components/sidebar.js +57 -17
- package/dist/components/site-header.d.ts +18 -13
- package/dist/components/site-header.js +23 -11
- package/dist/components/skeleton.d.ts +17 -7
- package/dist/components/skeleton.js +22 -7
- package/dist/components/slider.js +2 -2
- package/dist/components/sortable.d.ts +55 -4
- package/dist/components/sortable.js +172 -103
- package/dist/components/sources.d.ts +1 -1
- package/dist/components/sources.js +2 -2
- package/dist/components/spinner.d.ts +4 -4
- package/dist/components/spinner.js +4 -4
- package/dist/components/stat.d.ts +21 -4
- package/dist/components/stat.js +17 -8
- package/dist/components/stepper.d.ts +1 -1
- package/dist/components/stepper.js +8 -7
- package/dist/components/suggestions.d.ts +11 -3
- package/dist/components/suggestions.js +10 -4
- package/dist/components/swipe-actions.d.ts +66 -0
- package/dist/components/swipe-actions.js +292 -0
- package/dist/components/switch.js +1 -1
- package/dist/components/table.d.ts +12 -6
- package/dist/components/table.js +78 -30
- package/dist/components/tabs.js +7 -4
- package/dist/components/tag.d.ts +19 -20
- package/dist/components/tag.js +9 -5
- package/dist/components/tags-input.d.ts +2 -7
- package/dist/components/tags-input.js +11 -8
- package/dist/components/textarea.d.ts +3 -2
- package/dist/components/textarea.js +4 -3
- package/dist/components/theme.d.ts +49 -6
- package/dist/components/theme.js +147 -9
- package/dist/components/time-field.d.ts +4 -9
- package/dist/components/time-field.js +6 -6
- package/dist/components/timeline.d.ts +19 -3
- package/dist/components/timeline.js +21 -9
- package/dist/components/tippy.d.ts +17 -1
- package/dist/components/tippy.js +95 -15
- package/dist/components/toast.d.ts +2 -7
- package/dist/components/toast.js +12 -8
- package/dist/components/toggle-group.d.ts +7 -1
- package/dist/components/toggle-group.js +16 -5
- package/dist/components/toggle.d.ts +2 -2
- package/dist/components/toggle.js +3 -2
- package/dist/components/tool-call.d.ts +1 -1
- package/dist/components/tool-call.js +4 -4
- package/dist/components/toolbar.d.ts +57 -4
- package/dist/components/toolbar.js +216 -16
- package/dist/components/tooltip.d.ts +1 -1
- package/dist/components/tooltip.js +4 -2
- package/dist/components/tour.d.ts +1 -1
- package/dist/components/tour.js +36 -15
- package/dist/components/tree.js +5 -5
- package/dist/components/typography.d.ts +31 -8
- package/dist/components/typography.js +21 -10
- package/dist/components/video-player.d.ts +7 -2
- package/dist/components/video-player.js +121 -220
- package/dist/index.d.ts +99 -92
- package/dist/index.js +99 -92
- package/dist/lib/calendar.d.ts +153 -0
- package/dist/lib/calendar.js +312 -0
- package/dist/lib/cn.d.ts +3 -1
- package/dist/lib/cn.js +5 -0
- package/dist/lib/code-highlight.d.ts +14 -0
- package/dist/lib/code-highlight.js +81 -18
- package/dist/lib/drag.d.ts +39 -0
- package/dist/lib/drag.js +96 -0
- package/dist/lib/editorial-assets.js +16 -8
- package/dist/lib/figure/figures/automation.js +25 -6
- package/dist/lib/figure/figures/bar-chart.js +6 -1
- package/dist/lib/figure/figures/brackets-classic.js +4 -1
- package/dist/lib/figure/figures/city.js +12 -2
- package/dist/lib/figure/figures/conveyor.js +17 -4
- package/dist/lib/figure/figures/database.js +5 -2
- package/dist/lib/figure/figures/documents.js +11 -3
- package/dist/lib/figure/figures/inbox.js +5 -2
- package/dist/lib/figure/figures/laptop.js +3 -1
- package/dist/lib/figure/figures/pipeline.js +45 -10
- package/dist/lib/figure/figures/platform.js +62 -7
- package/dist/lib/figure/figures/server.js +21 -5
- package/dist/lib/figure/figures/spreadsheet.js +29 -5
- package/dist/lib/figure/kernel.d.ts +4 -2
- package/dist/lib/figure/kernel.js +10 -5
- package/dist/lib/figure/parts.js +6 -2
- package/dist/lib/files.d.ts +31 -0
- package/dist/lib/files.js +60 -0
- package/dist/lib/gesture.d.ts +70 -0
- package/dist/lib/gesture.js +141 -0
- package/dist/lib/glide.d.ts +5 -0
- package/dist/lib/glide.js +9 -1
- package/dist/lib/icons.d.ts +1 -0
- package/dist/lib/icons.js +6 -0
- package/dist/lib/illustration-library.js +1 -6
- package/dist/lib/markdown-edit.d.ts +112 -0
- package/dist/lib/markdown-edit.js +557 -0
- package/dist/lib/markdown-rich-editor.d.ts +188 -0
- package/dist/lib/markdown-rich-editor.js +1153 -0
- package/dist/lib/markdown-rich.d.ts +63 -0
- package/dist/lib/markdown-rich.js +534 -0
- package/dist/lib/mentions.d.ts +100 -0
- package/dist/lib/mentions.js +246 -0
- package/dist/lib/motion.d.ts +18 -0
- package/dist/lib/motion.js +43 -5
- package/dist/lib/number-roll.d.ts +89 -0
- package/dist/lib/number-roll.js +391 -0
- package/dist/lib/platform.d.ts +6 -0
- package/dist/lib/platform.js +14 -0
- package/dist/lib/portal-container.d.ts +9 -0
- package/dist/lib/portal-container.js +10 -0
- package/dist/lib/press.d.ts +5 -0
- package/dist/lib/press.js +186 -0
- package/dist/lib/scheduler.d.ts +128 -0
- package/dist/lib/scheduler.js +272 -0
- package/dist/lib/scroll-edges.d.ts +9 -0
- package/dist/lib/scroll-edges.js +50 -0
- package/dist/lib/table-fit.d.ts +1 -1
- package/dist/lib/table-fit.js +65 -8
- package/dist/lib/theme-preset.d.ts +267 -0
- package/dist/lib/theme-preset.js +1046 -0
- package/dist/lib/theme-script.d.ts +23 -3
- package/dist/lib/theme-script.js +17 -5
- package/dist/lib/tippy/sprite.d.ts +36 -4
- package/dist/lib/tippy/sprite.js +188 -15
- package/dist/lib/tone.d.ts +4 -0
- package/dist/lib/tone.js +1 -0
- package/dist/messages/de.d.ts +3 -3
- package/dist/messages/de.js +274 -3
- package/dist/skills/zon-ui/SKILL.md +279 -0
- package/dist/skills/zon-ui/references/authoring.md +265 -0
- package/dist/skills/zon-ui/references/brand.md +416 -0
- package/dist/skills/zon-ui/references/components/accordion.md +199 -0
- package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
- package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
- package/dist/skills/zon-ui/references/components/alert.md +167 -0
- package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
- package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
- package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
- package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
- package/dist/skills/zon-ui/references/components/avatar.md +98 -0
- package/dist/skills/zon-ui/references/components/badge.md +227 -0
- package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
- package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
- package/dist/skills/zon-ui/references/components/button-group.md +216 -0
- package/dist/skills/zon-ui/references/components/button.md +309 -0
- package/dist/skills/zon-ui/references/components/calendar.md +296 -0
- package/dist/skills/zon-ui/references/components/card.md +158 -0
- package/dist/skills/zon-ui/references/components/carousel.md +297 -0
- package/dist/skills/zon-ui/references/components/chart.md +739 -0
- package/dist/skills/zon-ui/references/components/chat.md +417 -0
- package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
- package/dist/skills/zon-ui/references/components/code-block.md +143 -0
- package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
- package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
- package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
- package/dist/skills/zon-ui/references/components/combobox.md +455 -0
- package/dist/skills/zon-ui/references/components/command.md +326 -0
- package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
- package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
- package/dist/skills/zon-ui/references/components/conversation.md +146 -0
- package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
- package/dist/skills/zon-ui/references/components/crm.md +1022 -0
- package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
- package/dist/skills/zon-ui/references/components/data-table.md +776 -0
- package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
- package/dist/skills/zon-ui/references/components/dialog.md +335 -0
- package/dist/skills/zon-ui/references/components/direction.md +165 -0
- package/dist/skills/zon-ui/references/components/drawer.md +276 -0
- package/dist/skills/zon-ui/references/components/drawing.md +94 -0
- package/dist/skills/zon-ui/references/components/empty.md +225 -0
- package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
- package/dist/skills/zon-ui/references/components/field.md +209 -0
- package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
- package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
- package/dist/skills/zon-ui/references/components/form.md +970 -0
- package/dist/skills/zon-ui/references/components/graph.md +339 -0
- package/dist/skills/zon-ui/references/components/illustration.md +497 -0
- package/dist/skills/zon-ui/references/components/inbox.md +263 -0
- package/dist/skills/zon-ui/references/components/input-group.md +339 -0
- package/dist/skills/zon-ui/references/components/input.md +189 -0
- package/dist/skills/zon-ui/references/components/item.md +277 -0
- package/dist/skills/zon-ui/references/components/kanban.md +626 -0
- package/dist/skills/zon-ui/references/components/kbd.md +116 -0
- package/dist/skills/zon-ui/references/components/label.md +104 -0
- package/dist/skills/zon-ui/references/components/layout.md +291 -0
- package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
- package/dist/skills/zon-ui/references/components/locale.md +279 -0
- package/dist/skills/zon-ui/references/components/logo.md +257 -0
- package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
- package/dist/skills/zon-ui/references/components/mentions.md +512 -0
- package/dist/skills/zon-ui/references/components/menu.md +218 -0
- package/dist/skills/zon-ui/references/components/menubar.md +292 -0
- package/dist/skills/zon-ui/references/components/message.md +243 -0
- package/dist/skills/zon-ui/references/components/meter.md +105 -0
- package/dist/skills/zon-ui/references/components/money-input.md +333 -0
- package/dist/skills/zon-ui/references/components/native-select.md +197 -0
- package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
- package/dist/skills/zon-ui/references/components/number-field.md +210 -0
- package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
- package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
- package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
- package/dist/skills/zon-ui/references/components/pagination.md +109 -0
- package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
- package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
- package/dist/skills/zon-ui/references/components/popover.md +176 -0
- package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
- package/dist/skills/zon-ui/references/components/pricing.md +724 -0
- package/dist/skills/zon-ui/references/components/progress.md +92 -0
- package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
- package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
- package/dist/skills/zon-ui/references/components/quote.md +115 -0
- package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
- package/dist/skills/zon-ui/references/components/rating.md +260 -0
- package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
- package/dist/skills/zon-ui/references/components/resizable.md +213 -0
- package/dist/skills/zon-ui/references/components/response.md +170 -0
- package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
- package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
- package/dist/skills/zon-ui/references/components/select.md +351 -0
- package/dist/skills/zon-ui/references/components/separator.md +103 -0
- package/dist/skills/zon-ui/references/components/settings.md +793 -0
- package/dist/skills/zon-ui/references/components/shop.md +1715 -0
- package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
- package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
- package/dist/skills/zon-ui/references/components/site-header.md +303 -0
- package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
- package/dist/skills/zon-ui/references/components/slider.md +172 -0
- package/dist/skills/zon-ui/references/components/sortable.md +405 -0
- package/dist/skills/zon-ui/references/components/sources.md +106 -0
- package/dist/skills/zon-ui/references/components/spinner.md +222 -0
- package/dist/skills/zon-ui/references/components/stat.md +267 -0
- package/dist/skills/zon-ui/references/components/stepper.md +285 -0
- package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
- package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
- package/dist/skills/zon-ui/references/components/switch.md +160 -0
- package/dist/skills/zon-ui/references/components/table.md +999 -0
- package/dist/skills/zon-ui/references/components/tabs.md +258 -0
- package/dist/skills/zon-ui/references/components/tag.md +115 -0
- package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
- package/dist/skills/zon-ui/references/components/textarea.md +95 -0
- package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
- package/dist/skills/zon-ui/references/components/theme.md +362 -0
- package/dist/skills/zon-ui/references/components/time-field.md +222 -0
- package/dist/skills/zon-ui/references/components/timeline.md +285 -0
- package/dist/skills/zon-ui/references/components/tippy.md +243 -0
- package/dist/skills/zon-ui/references/components/toast.md +220 -0
- package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
- package/dist/skills/zon-ui/references/components/toggle.md +167 -0
- package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
- package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
- package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
- package/dist/skills/zon-ui/references/components/tour.md +423 -0
- package/dist/skills/zon-ui/references/components/tree.md +481 -0
- package/dist/skills/zon-ui/references/components/typography.md +347 -0
- package/dist/skills/zon-ui/references/components/video-player.md +386 -0
- package/dist/skills/zon-ui/references/marketing.md +467 -0
- package/dist/skills/zon-ui/references/motion.md +455 -0
- package/dist/skills/zon-ui/references/recipes.md +1232 -0
- package/dist/skills/zon-ui/references/tokens.md +866 -0
- package/dist/sources/accordion.css +4 -0
- package/dist/sources/action-sheet.css +11 -0
- package/dist/sources/alert-dialog.css +6 -0
- package/dist/sources/alert.css +3 -0
- package/dist/sources/app-bar.css +14 -0
- package/dist/sources/ascii-field.css +3 -0
- package/dist/sources/aspect-ratio.css +3 -0
- package/dist/sources/audio-player.css +20 -0
- package/dist/sources/avatar.css +3 -0
- package/dist/sources/badge.css +3 -0
- package/dist/sources/bottom-nav.css +9 -0
- package/dist/sources/breadcrumb.css +14 -0
- package/dist/sources/button-group.css +3 -0
- package/dist/sources/button.css +9 -0
- package/dist/sources/calendar.css +13 -0
- package/dist/sources/card.css +3 -0
- package/dist/sources/carousel.css +11 -0
- package/dist/sources/chart.css +5 -0
- package/dist/sources/checkbox.css +6 -0
- package/dist/sources/code-block.css +13 -0
- package/dist/sources/collapsible.css +4 -0
- package/dist/sources/color-picker.css +13 -0
- package/dist/sources/combobox.css +13 -0
- package/dist/sources/command.css +13 -0
- package/dist/sources/context-menu.css +12 -0
- package/dist/sources/conversation.css +10 -0
- package/dist/sources/copy-button.css +10 -0
- package/dist/sources/data-table.css +27 -0
- package/dist/sources/date-picker.css +20 -0
- package/dist/sources/dialog.css +9 -0
- package/dist/sources/direction.css +2 -0
- package/dist/sources/drawer.css +9 -0
- package/dist/sources/drawing.css +5 -0
- package/dist/sources/empty.css +3 -0
- package/dist/sources/feature-list.css +4 -0
- package/dist/sources/field.css +4 -0
- package/dist/sources/file-drop.css +15 -0
- package/dist/sources/filter-bar.css +30 -0
- package/dist/sources/form.css +4 -0
- package/dist/sources/graph.css +19 -0
- package/dist/sources/illustration.css +28 -0
- package/dist/sources/input-group.css +7 -0
- package/dist/sources/input.css +3 -0
- package/dist/sources/item.css +4 -0
- package/dist/sources/kbd.css +5 -0
- package/dist/sources/label.css +3 -0
- package/dist/sources/layout.css +3 -0
- package/dist/sources/lightbox.css +33 -0
- package/dist/sources/locale.css +2 -0
- package/dist/sources/logo.css +4 -0
- package/dist/sources/markdown-editor.css +41 -0
- package/dist/sources/mentions.css +13 -0
- package/dist/sources/menu.css +11 -0
- package/dist/sources/menubar.css +14 -0
- package/dist/sources/message.css +16 -0
- package/dist/sources/meter.css +4 -0
- package/dist/sources/money-input.css +10 -0
- package/dist/sources/native-select.css +4 -0
- package/dist/sources/navigation-menu.css +8 -0
- package/dist/sources/number-field.css +8 -0
- package/dist/sources/number-roll.css +6 -0
- package/dist/sources/otp-field.css +5 -0
- package/dist/sources/pagination.css +11 -0
- package/dist/sources/pdf-viewer.css +30 -0
- package/dist/sources/phone-input.css +20 -0
- package/dist/sources/popover.css +7 -0
- package/dist/sources/preview-card.css +7 -0
- package/dist/sources/progress.css +4 -0
- package/dist/sources/prompt-input.css +15 -0
- package/dist/sources/pull-to-refresh.css +14 -0
- package/dist/sources/quote.css +3 -0
- package/dist/sources/radio-group.css +5 -0
- package/dist/sources/rating.css +6 -0
- package/dist/sources/reasoning.css +6 -0
- package/dist/sources/resizable.css +4 -0
- package/dist/sources/response.css +16 -0
- package/dist/sources/scheduler.css +44 -0
- package/dist/sources/scroll-area.css +3 -0
- package/dist/sources/select.css +12 -0
- package/dist/sources/separator.css +3 -0
- package/dist/sources/sidebar.css +19 -0
- package/dist/sources/site-header.css +15 -0
- package/dist/sources/skeleton.css +3 -0
- package/dist/sources/slider.css +6 -0
- package/dist/sources/sortable.css +12 -0
- package/dist/sources/sources.css +6 -0
- package/dist/sources/spinner.css +6 -0
- package/dist/sources/stat.css +9 -0
- package/dist/sources/stepper.css +6 -0
- package/dist/sources/suggestions.css +10 -0
- package/dist/sources/swipe-actions.css +20 -0
- package/dist/sources/switch.css +5 -0
- package/dist/sources/table.css +7 -0
- package/dist/sources/tabs.css +5 -0
- package/dist/sources/tag.css +3 -0
- package/dist/sources/tags-input.css +6 -0
- package/dist/sources/textarea.css +3 -0
- package/dist/sources/theme.css +13 -0
- package/dist/sources/time-field.css +7 -0
- package/dist/sources/timeline.css +7 -0
- package/dist/sources/tippy.css +6 -0
- package/dist/sources/toast.css +6 -0
- package/dist/sources/toggle-group.css +5 -0
- package/dist/sources/toggle.css +3 -0
- package/dist/sources/tool-call.css +16 -0
- package/dist/sources/toolbar.css +14 -0
- package/dist/sources/tooltip.css +6 -0
- package/dist/sources/tour.css +14 -0
- package/dist/sources/tree.css +6 -0
- package/dist/sources/typography.css +4 -0
- package/dist/sources/video-player.css +21 -0
- package/dist/styles/ai.css +3 -0
- package/dist/styles/brand.css +98 -0
- package/dist/styles/core.css +266 -0
- package/dist/styles/editor.css +3 -0
- package/dist/styles/expressive.css +35 -56
- package/dist/styles/fonts.css +61 -117
- package/dist/styles/graph.css +4 -0
- package/dist/styles/illustration.css +4 -0
- package/dist/styles/index.css +11 -201
- package/dist/styles/material.css +138 -12
- package/dist/styles/parts/ai.css +18 -13
- package/dist/styles/parts/brand.css +2 -2
- package/dist/styles/parts/controls.css +29 -20
- package/dist/styles/parts/data.css +13 -9
- package/dist/styles/parts/editor.css +372 -0
- package/dist/styles/parts/feedback.css +32 -2
- package/dist/styles/parts/foundations.css +12 -7
- package/dist/styles/parts/graph.css +25 -9
- package/dist/styles/parts/inputs.css +172 -9
- package/dist/styles/parts/isometric.css +6 -5
- package/dist/styles/parts/navigation.css +206 -27
- package/dist/styles/parts/overlays.css +19 -4
- package/dist/styles/parts/pdf.css +2 -2
- package/dist/styles/pdf.css +3 -0
- package/dist/styles/prose.css +3 -0
- package/dist/styles/tokens.css +89 -14
- package/dist/theme.d.ts +1 -0
- package/dist/theme.js +5 -0
- package/dist/vite.d.ts +48 -59
- package/dist/vite.js +54 -21
- package/package.json +69 -2
|
@@ -0,0 +1,362 @@
|
|
|
1
|
+
# Theme
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { ThemeProvider, ThemeToggle } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
export function Toggle() {
|
|
7
|
+
return (
|
|
8
|
+
<ThemeProvider>
|
|
9
|
+
<ThemeToggle />
|
|
10
|
+
</ThemeProvider>
|
|
11
|
+
);
|
|
12
|
+
}
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
Every token is redefined under `.dark`, so a theme is one class on `<html>`. `ThemeProvider` sets it, remembers the choice and follows the OS on `system`; `themeScript` applies it before the first paint. `ThemeToggle` is a round secondary icon button.
|
|
16
|
+
|
|
17
|
+
## Usage
|
|
18
|
+
|
|
19
|
+
```tsx
|
|
20
|
+
import { ThemeProvider, ThemeToggle, themeScript } from "@zonsh/ui";
|
|
21
|
+
|
|
22
|
+
// In <head>, before the stylesheets:
|
|
23
|
+
<script dangerouslySetInnerHTML={{ __html: themeScript }} />
|
|
24
|
+
|
|
25
|
+
// At the root:
|
|
26
|
+
<ThemeProvider>
|
|
27
|
+
<header>
|
|
28
|
+
<ThemeToggle />
|
|
29
|
+
</header>
|
|
30
|
+
</ThemeProvider>
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
- `ThemeProvider.preset` — your theme: `themePresetFromColor(…)`, a preset code or a theme.json.
|
|
34
|
+
- `ThemeProvider.defaultTheme` — before anyone picks.
|
|
35
|
+
- `ThemeToggle.size` — `"sm"` for a dense header.
|
|
36
|
+
|
|
37
|
+
Changed `storageKey`, `defaultTheme` or `themeColor`? Build the script with the same: `createThemeScript({ storageKey, defaultTheme, themeColor })`.
|
|
38
|
+
|
|
39
|
+
## When to use
|
|
40
|
+
|
|
41
|
+
- `ThemeProvider` once at the root; `themeScript` in every page's `<head>`; one `ThemeToggle`, usually in the header; `useTheme()` for a menu with "System".
|
|
42
|
+
- `ThemeScope` for one area in its own theme or scheme, popups included. A plain region with no popups can use `.theme-dark` / `.theme-light`.
|
|
43
|
+
|
|
44
|
+
## Setting up
|
|
45
|
+
|
|
46
|
+
### In a Vite app's index.html
|
|
47
|
+
|
|
48
|
+
`zonThemeScript()` from `@zonsh/ui/vite` puts the script atop `<head>`, right after `<meta charset>`, in every page (options as `createThemeScript`).
|
|
49
|
+
|
|
50
|
+
```ts
|
|
51
|
+
// vite.config.ts
|
|
52
|
+
import { zonThemeScript } from "@zonsh/ui/vite";
|
|
53
|
+
|
|
54
|
+
export default defineConfig({ plugins: [react(), tailwindcss(), zonThemeScript()] });
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
With a theme of your own, give the plugin the same `preset` as `ThemeProvider`: it writes the theme's stylesheet into `index.html` after the library's, so the first paint already has your colours, corners and density instead of zon's grey until the app runs. Keep the preset in one module both import, from `@zonsh/ui/theme` (plain code, which the Vite config can load):
|
|
58
|
+
|
|
59
|
+
```ts
|
|
60
|
+
// src/theme.ts
|
|
61
|
+
import { themePresetFromColor } from "@zonsh/ui/theme";
|
|
62
|
+
|
|
63
|
+
export const preset = themePresetFromColor("#c2410c", { neutral: "warm", corners: "round" });
|
|
64
|
+
|
|
65
|
+
// vite.config.ts
|
|
66
|
+
import { zonThemeScript } from "@zonsh/ui/vite";
|
|
67
|
+
import { preset } from "./src/theme";
|
|
68
|
+
|
|
69
|
+
export default defineConfig({ plugins: [react(), tailwindcss(), zonThemeScript({ preset })] });
|
|
70
|
+
|
|
71
|
+
// src/main.tsx: <ThemeProvider preset={preset}>
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
Or paste `themeScript` (the defaults) first in `<head>`:
|
|
75
|
+
|
|
76
|
+
```html
|
|
77
|
+
<script>(function(){var t=null;try{t=localStorage.getItem("zon-theme")}catch(e){}if(t!=="light"&&t!=="dark"&&t!=="system")t="system";var d=t==="dark";if(t==="system"){try{d=matchMedia("(prefers-color-scheme: dark)").matches}catch(e){}}document.documentElement.classList.toggle("dark",d);var m=document.querySelector('meta[name="theme-color"]:not([media])');if(!m){m=document.createElement("meta");m.name="theme-color";document.head.appendChild(m)}m.content=d?"#141414":"#f9f9f9";})();</script>
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
Both keep `<meta name="theme-color">` (no `media`; made if missing) at the page tone (`PAGE_TONE`, `--page-tone`), or a preset's `--background`; `themeColor: false` leaves it to you. See also Layout, "The page's edges on a phone".
|
|
81
|
+
|
|
82
|
+
Server-rendered (a Next.js root layout): `suppressHydrationWarning` on `<html>`.
|
|
83
|
+
|
|
84
|
+
### Your own colour
|
|
85
|
+
|
|
86
|
+
Unthemed, an app looks like zon: grey, a near-black primary. `themePresetFromColor` makes a theme from one colour: the primary, checked controls and focus outline take its hue, and every text colour is moved until it reads. `neutral`, `corners` and `density` set the rest. For every colour and the exact shape, use a preset code from the [theme editor](./theme-editor.md).
|
|
87
|
+
|
|
88
|
+
```tsx
|
|
89
|
+
import { ThemeProvider, themePresetFromColor } from "@zonsh/ui";
|
|
90
|
+
|
|
91
|
+
<ThemeProvider preset={themePresetFromColor("#c2410c", { neutral: "warm", corners: "round" })}>
|
|
92
|
+
{children}
|
|
93
|
+
</ThemeProvider>;
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
Any CSS colour works; a very light one is deepened so its label reads, and a grey keeps zon's primary. Bad input throws a `ThemePresetError` that says why.
|
|
97
|
+
|
|
98
|
+
Pick a colour away from the hues that already mean something: the status colours (green success, amber warning, blue info, red destructive) and the category tones the app uses (blue, aqua, violet, magenta, orange, lime). A teal primary beside the aqua tone, or a red one beside `destructive`, makes a selected row read as a status. When the brand colour is close to one, keep that meaning off the screen where they meet, or move the category to another tone.
|
|
99
|
+
|
|
100
|
+
For a first paint in your colours with no flash of zon's grey: in Vite, the same `preset` to `zonThemeScript({ preset })` (above); server-rendered, `themeFromPreset(preset).css` in a `<style>` in `<head>` after the library's stylesheet, or that CSS pasted after `@import "@zonsh/ui/styles.css";`.
|
|
101
|
+
|
|
102
|
+
As a code: `pnpm create zon@latest theme --color "#c2410c" --corners round` (`--css` for the stylesheet), or `encodeThemePreset(themePresetFromColor(…))` from `@zonsh/ui/theme`. `pnpm create zon@latest my-app` asks for the look or takes `--color`, `--neutral`, `--corners`, `--density`.
|
|
103
|
+
|
|
104
|
+
| Option | Values | Default |
|
|
105
|
+
| --------- | -------------------------------------------------------------------------------------------------------- | --------- |
|
|
106
|
+
| `neutral` | `pure` (zon's grey), `warm` (paper), `cool` (slate), `tinted` (a hint of the colour) | `pure` |
|
|
107
|
+
| `corners` | `square` (0), `subtle` (half zon's), `default` (zon's 12px buttons, 20px cards), `round` (one and a half times), or a step of `THEME_CORNERS` | `default` |
|
|
108
|
+
| `density` | `dense` (30px controls), `compact` (34px), `default` (38px), `comfortable` (42px), `spacious` (46px) | `default` |
|
|
109
|
+
| `controlHeight` | the default control height in px, one of `THEME_HEIGHTS` (30, 34, 38, 42, 46), in place of `density` | — |
|
|
110
|
+
|
|
111
|
+
What a density changes, inside the components: the control heights, row heights and inset parts follow the default control height; padding, gaps, icons and the sidebar's width scale by `--space` (0.79 dense, 0.89 compact, 1 default, 1.05 comfortable, 1.1 spacious — in a roomy theme they grow only as fast as the type, so it is taller rather than padded out); type scales by `--type`, half the density's change, never under 10px; a card's padding follows `--space` too. The small parts keep their sizes (a checkbox, a switch, a badge, a key cap, a tag), and so does your own layout.
|
|
112
|
+
|
|
113
|
+
### A theme of your own
|
|
114
|
+
|
|
115
|
+
A [theme editor](./theme-editor.md) theme is a preset code:
|
|
116
|
+
|
|
117
|
+
```tsx
|
|
118
|
+
<ThemeProvider preset="Z11ARFCXWTUPYKES">{children}</ThemeProvider>
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
The provider adds its stylesheet to the end of `<head>`; an unreadable code leaves zon's theme and warns once in development. For a server-rendered first paint, render `themeFromPreset(code).css` in `<head>`:
|
|
122
|
+
|
|
123
|
+
```tsx
|
|
124
|
+
import { themeFromPreset, themeScript } from "@zonsh/ui";
|
|
125
|
+
|
|
126
|
+
<head>
|
|
127
|
+
<script dangerouslySetInnerHTML={{ __html: themeScript }} />
|
|
128
|
+
<style dangerouslySetInnerHTML={{ __html: themeFromPreset("Z11ARFCXWTUPYKES").css }} />
|
|
129
|
+
</head>;
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
Light tokens go on `:root, .theme-light`, dark on `.dark, [data-theme="dark"], .theme-dark`, shape on `:root`.
|
|
133
|
+
|
|
134
|
+
### One area of a page
|
|
135
|
+
|
|
136
|
+
`ThemeScope` gives one area its own theme, or holds it light or dark.
|
|
137
|
+
|
|
138
|
+
```tsx
|
|
139
|
+
import { Button, Label, Menu, MenuContent, MenuItem, MenuTrigger, Mono, Switch, ThemeScope, themePresetFromColor } from "@zonsh/ui";
|
|
140
|
+
import { ChevronDownIcon } from "lucide-react";
|
|
141
|
+
|
|
142
|
+
const clay = themePresetFromColor("#c2410c", { neutral: "warm", corners: "round", density: "comfortable" });
|
|
143
|
+
|
|
144
|
+
/** One panel's controls: a menu (which opens in the panel's theme), a switch and the primary. */
|
|
145
|
+
function PanelControls({ action }: { action: string }) {
|
|
146
|
+
return (
|
|
147
|
+
<div className="flex flex-wrap items-center gap-3">
|
|
148
|
+
<Menu>
|
|
149
|
+
<MenuTrigger render={<Button variant="secondary" />}>
|
|
150
|
+
Kiln
|
|
151
|
+
<ChevronDownIcon />
|
|
152
|
+
</MenuTrigger>
|
|
153
|
+
<MenuContent>
|
|
154
|
+
<MenuItem>Kiln 1</MenuItem>
|
|
155
|
+
<MenuItem>Kiln 2</MenuItem>
|
|
156
|
+
<MenuItem>Test kiln</MenuItem>
|
|
157
|
+
</MenuContent>
|
|
158
|
+
</Menu>
|
|
159
|
+
<Label>
|
|
160
|
+
<Switch defaultChecked />
|
|
161
|
+
Slow cool
|
|
162
|
+
</Label>
|
|
163
|
+
<Button>{action}</Button>
|
|
164
|
+
</div>
|
|
165
|
+
);
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
export function Scope() {
|
|
169
|
+
return (
|
|
170
|
+
<div className="grid gap-4 md:grid-cols-2">
|
|
171
|
+
<ThemeScope preset={clay} className="flex flex-col gap-4 rounded-card border border-border p-6">
|
|
172
|
+
<Mono className="text-xs text-muted-foreground">A theme from #c2410c, round and comfortable</Mono>
|
|
173
|
+
<PanelControls action="Start firing" />
|
|
174
|
+
</ThemeScope>
|
|
175
|
+
<ThemeScope scheme="dark" className="flex flex-col gap-4 rounded-card border border-border p-6">
|
|
176
|
+
<Mono className="text-xs text-muted-foreground">zon's own, always dark</Mono>
|
|
177
|
+
<PanelControls action="Start firing" />
|
|
178
|
+
</ThemeScope>
|
|
179
|
+
</div>
|
|
180
|
+
);
|
|
181
|
+
}
|
|
182
|
+
```
|
|
183
|
+
|
|
184
|
+
```tsx
|
|
185
|
+
import { ThemeScope, themePresetFromColor } from "@zonsh/ui";
|
|
186
|
+
|
|
187
|
+
<ThemeScope preset={themePresetFromColor("#c2410c", { corners: "round" })} className="p-6">
|
|
188
|
+
{/* a customer's branded preview, an embedded widget, a night section */}
|
|
189
|
+
</ThemeScope>;
|
|
190
|
+
|
|
191
|
+
<ThemeScope scheme="dark">{/* always dark, in zon's colours */}</ThemeScope>;
|
|
192
|
+
```
|
|
193
|
+
|
|
194
|
+
A `div` with `bg-background text-foreground`. Without `scheme` it follows the page; `scheme` holds it (adding `.theme-light` / `.theme-dark`). Density and corners reach every component inside; your own spacing keeps Tailwind's step.
|
|
195
|
+
|
|
196
|
+
Popups opened inside (menus, dialogs, tooltips, toasts …) portal into a themed element at the end of `<body>`, matching and unclipped; a `Toaster` takes its scope's theme. Your own portals use `usePortalContainer()`: `<Popover.Portal container={usePortalContainer()}>`. Scopes nest. Inside a `.theme-dark` / `.theme-light` region, give the scope the same `scheme`.
|
|
197
|
+
|
|
198
|
+
Its stylesheet is server-rendered into `<head>` once per theme. Outside React: `themeScopeStyle(theme, "dark")` (an inline style) or `themeFromPreset(theme, { scope: "promo" }).css` (for `data-theme-scope="promo"`).
|
|
199
|
+
|
|
200
|
+
### A theme in the repository
|
|
201
|
+
|
|
202
|
+
Commit the [theme editor](./theme-editor.md)'s `theme.json` (every token on its own line, so changes review well) and pass it as is:
|
|
203
|
+
|
|
204
|
+
```tsx
|
|
205
|
+
import theme from "./theme.json";
|
|
206
|
+
|
|
207
|
+
<ThemeProvider preset={theme}>{children}</ThemeProvider>;
|
|
208
|
+
```
|
|
209
|
+
|
|
210
|
+
Hand edits win over the code. `themeFromPreset(preset).json` / `.css` write the file and stylesheet deterministically.
|
|
211
|
+
|
|
212
|
+
### Part sizes
|
|
213
|
+
|
|
214
|
+
Small parts have their own size tokens outside `--density`; override them on `:root` after the library's stylesheet:
|
|
215
|
+
|
|
216
|
+
```css
|
|
217
|
+
:root {
|
|
218
|
+
--check-size: 20px;
|
|
219
|
+
--focus-width: 3px;
|
|
220
|
+
}
|
|
221
|
+
```
|
|
222
|
+
|
|
223
|
+
| Token | Default | What it sizes |
|
|
224
|
+
| --- | --- | --- |
|
|
225
|
+
| `--focus-width` | `2px` | Every focus outline, the global `:focus-visible` one and the components' own |
|
|
226
|
+
| `--check-size` | `18px` | Checkbox and Radio, and the task-list boxes in Response and Markdown Editor |
|
|
227
|
+
| `--touch-target` | `44px` | The least a finger hits on a coarse pointer: `touch-target`'s invisible area around a small control |
|
|
228
|
+
| `--switch-w` | `38px` | The Switch track's width |
|
|
229
|
+
| `--switch-h` | `22px` | The Switch track's height |
|
|
230
|
+
| `--switch-thumb` | `18px` | The Switch thumb; pressed, it stretches 7px wider |
|
|
231
|
+
| `--slider-thumb` | `18px` | The Slider thumb, the Video and Audio Player scrubber's thumb and the Color Picker's handles |
|
|
232
|
+
| `--track-h` | `6px` | The Slider, Progress and Meter tracks; scales with `--density` |
|
|
233
|
+
| `--badge-h-sm` | `16px` | A `size="sm"` Badge (height and least width) |
|
|
234
|
+
| `--badge-h` | `20px` | A default Badge (height and least width) |
|
|
235
|
+
| `--kbd-h` | `20px` | A Kbd key cap (least height and width) |
|
|
236
|
+
| `--tag-h` | `22px` | A Tag's least height |
|
|
237
|
+
| `--scroll-thumb` | `4px` | The ScrollArea thumb; scales with `--density` |
|
|
238
|
+
| `--hairline-opacity` | `60%` | The components' hairline rules: `--border` at this strength (Separator, Table, Accordion, Card, Sidebar …) |
|
|
239
|
+
| `--card-space` | `24px` | `surface-card`'s padding on a phone |
|
|
240
|
+
| `--card-space-sm` | `32px` | … from 40rem |
|
|
241
|
+
| `--card-space-md` | `40px` | … from 48rem; one card overrides all three with `--card-padding` |
|
|
242
|
+
| `--drag-lift` | `1.02` | The scale of an item lifted in Sortable and Kanban |
|
|
243
|
+
|
|
244
|
+
`--track-h` and `--scroll-thumb` scale with `--density` (`calc(var(--zon-spacing) * 1.5)`).
|
|
245
|
+
|
|
246
|
+
### Printing
|
|
247
|
+
|
|
248
|
+
A page prints as it is on screen, in the scheme it is in, and the browser leaves out backgrounds unless asked: no grain, no material fills, so text and hairlines carry what is printed. Paper wants the light theme, whatever the reader has chosen:
|
|
249
|
+
|
|
250
|
+
- **The part to print** (an invoice, a receipt) takes `.theme-light` and `text-foreground`. The class sets the light tokens there; the text colour has to be set again, because text inherits the colour already worked out on the dark `<body>`.
|
|
251
|
+
- **Or the whole page, for the print only:** take `.dark` off `<html>` on `beforeprint` and put it back on `afterprint`.
|
|
252
|
+
|
|
253
|
+
```ts
|
|
254
|
+
const { resolvedTheme } = useTheme();
|
|
255
|
+
useEffect(() => {
|
|
256
|
+
const light = () => document.documentElement.classList.remove("dark");
|
|
257
|
+
const back = () => document.documentElement.classList.toggle("dark", resolvedTheme === "dark");
|
|
258
|
+
window.addEventListener("beforeprint", light);
|
|
259
|
+
window.addEventListener("afterprint", back);
|
|
260
|
+
return () => {
|
|
261
|
+
window.removeEventListener("beforeprint", light);
|
|
262
|
+
window.removeEventListener("afterprint", back);
|
|
263
|
+
};
|
|
264
|
+
}, [resolvedTheme]);
|
|
265
|
+
```
|
|
266
|
+
|
|
267
|
+
- **Leave the app out:** `print:hidden` on the sidebar, the header, the toolbar and the buttons; `print:static` on anything `sticky` or `fixed`, which would repeat on every page or cover the content.
|
|
268
|
+
|
|
269
|
+
## Examples
|
|
270
|
+
|
|
271
|
+
### Chooser
|
|
272
|
+
|
|
273
|
+
```tsx
|
|
274
|
+
import { Button, Mono, ThemeProvider, useTheme, type ThemeMode } from "@zonsh/ui";
|
|
275
|
+
|
|
276
|
+
function ThemeChoices() {
|
|
277
|
+
const { theme, resolvedTheme, setTheme } = useTheme();
|
|
278
|
+
const modes: { value: ThemeMode; label: string }[] = [
|
|
279
|
+
{ value: "light", label: "Light" },
|
|
280
|
+
{ value: "dark", label: "Dark" },
|
|
281
|
+
{ value: "system", label: "System" },
|
|
282
|
+
];
|
|
283
|
+
return (
|
|
284
|
+
<div className="flex flex-col items-start gap-4">
|
|
285
|
+
<div className="flex flex-wrap gap-2" role="group" aria-label="Theme">
|
|
286
|
+
{modes.map((mode) => (
|
|
287
|
+
<Button
|
|
288
|
+
key={mode.value}
|
|
289
|
+
variant="secondary"
|
|
290
|
+
className="aria-pressed:bg-control-hover aria-pressed:text-foreground"
|
|
291
|
+
aria-pressed={theme === mode.value}
|
|
292
|
+
onClick={() => setTheme(mode.value)}
|
|
293
|
+
>
|
|
294
|
+
{mode.label}
|
|
295
|
+
</Button>
|
|
296
|
+
))}
|
|
297
|
+
</div>
|
|
298
|
+
<Mono className="text-[13px] text-muted-foreground">
|
|
299
|
+
theme: {theme} · applied: {resolvedTheme}
|
|
300
|
+
</Mono>
|
|
301
|
+
</div>
|
|
302
|
+
);
|
|
303
|
+
}
|
|
304
|
+
|
|
305
|
+
export function Chooser() {
|
|
306
|
+
return (
|
|
307
|
+
<ThemeProvider>
|
|
308
|
+
<ThemeChoices />
|
|
309
|
+
</ThemeProvider>
|
|
310
|
+
);
|
|
311
|
+
}
|
|
312
|
+
|
|
313
|
+
/* Made once, outside render: a preset object made on every render would still apply once, but
|
|
314
|
+
there is no need to build it again. */
|
|
315
|
+
```
|
|
316
|
+
|
|
317
|
+
## Props
|
|
318
|
+
|
|
319
|
+
**ThemeProvider**
|
|
320
|
+
|
|
321
|
+
| Prop | Type | Default |
|
|
322
|
+
| -------------- | ------------------------------- | ------------------- |
|
|
323
|
+
| `defaultTheme` | `"light" \| "dark" \| "system"` | `"system"` |
|
|
324
|
+
| `storageKey` | `string` — localStorage key | `"zon-theme"` |
|
|
325
|
+
| `themeColor` | `boolean` — keep `<meta name="theme-color">` at the page tone | `true` |
|
|
326
|
+
| `preset` | `string \| ThemePreset \| ThemeFile` — a theme editor preset code, a preset such as `themePresetFromColor("#c2410c")`, or a theme.json file; its stylesheet goes into `<head>` | — |
|
|
327
|
+
|
|
328
|
+
**ThemeScope** takes every `div` prop, and:
|
|
329
|
+
|
|
330
|
+
| Prop | Type | Default |
|
|
331
|
+
| -------- | --------------------------------------------- | ---------------- |
|
|
332
|
+
| `preset` | `string \| ThemePreset \| ThemeFile` — the area's theme | — (the page's) |
|
|
333
|
+
| `scheme` | `"light" \| "dark"` — hold the area in one scheme | — (the page's) |
|
|
334
|
+
|
|
335
|
+
**usePortalContainer()** — the portal element inside a ThemeScope, else `undefined`.
|
|
336
|
+
|
|
337
|
+
**themeScopeStyle(theme, scheme, { format? })** — one scheme's tokens, shape and `colorScheme` as a style.
|
|
338
|
+
|
|
339
|
+
**useTheme()** — `{ theme, resolvedTheme, setTheme }`; `resolvedTheme` is `"light" | "dark"`.
|
|
340
|
+
|
|
341
|
+
**ThemeToggle** forwards `Button` props but `variant` and `children`; `size` `"default"` (36px) or `"sm"` (30px); `onClick` runs first.
|
|
342
|
+
|
|
343
|
+
**zonThemeScript(options)** (from `@zonsh/ui/vite`) — the Vite plugin: `storageKey`, `defaultTheme` and `themeColor` as `createThemeScript`, and `preset`, whose stylesheet it writes into `index.html` for the first paint.
|
|
344
|
+
|
|
345
|
+
**themeScript** — the minified script for the defaults; **createThemeScript(options)** for others (options escaped, so `</script>` cannot break out). **THEME_STORAGE_KEY** is `"zon-theme"`; **PAGE_TONE** `{ light: "#f9f9f9", dark: "#141414" }`. The toggle's name is `messages.theme.toggle`.
|
|
346
|
+
|
|
347
|
+
## Brand rules
|
|
348
|
+
|
|
349
|
+
- **Do** preview everything in both themes, with semantic tokens rather than `dark:` overrides, and one toggle per page.
|
|
350
|
+
- **Do** ask once how the product should look (zon's own, a brand colour, a preset code) and set it in the theme, not on components.
|
|
351
|
+
- **Don't** invert the logo with a filter; it uses `currentColor`.
|
|
352
|
+
- **Don't** tint a theme by hand or pick separate dark-mode hues.
|
|
353
|
+
|
|
354
|
+
## Accessibility
|
|
355
|
+
|
|
356
|
+
- `ThemeToggle` is labelled "Toggle light and dark theme"; its icons are `aria-hidden`.
|
|
357
|
+
- The icon is picked by CSS, right on the first paint. Blocked storage keeps the choice for the session. `system` follows `prefers-color-scheme` live, and other tabs through the `storage` event.
|
|
358
|
+
|
|
359
|
+
---
|
|
360
|
+
|
|
361
|
+
- Import: `import { ThemeProvider, useTheme, ThemeToggle, ThemeScope, usePortalContainer, themeScript, createThemeScript, THEME_STORAGE_KEY } from "@zonsh/ui"`
|
|
362
|
+
- Source: `packages/ui/src/components/theme.tsx`
|
|
@@ -0,0 +1,222 @@
|
|
|
1
|
+
# Time Field
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Field, FieldDescription, FieldLabel, TimeField } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
export function Basic() {
|
|
7
|
+
return (
|
|
8
|
+
<Field className="max-w-48">
|
|
9
|
+
<FieldLabel>Daily reminder</FieldLabel>
|
|
10
|
+
<TimeField defaultValue="08:30" name="reminder" />
|
|
11
|
+
<FieldDescription>We send the day's notes at this time.</FieldDescription>
|
|
12
|
+
</Field>
|
|
13
|
+
);
|
|
14
|
+
}
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
A recessed field (38px, 30px dense) holding the time as mono segments, `14 : 30`, plus seconds or AM/PM when needed. The value is always 24-hour — `"14:30"` or `"14:30:05"` — and `null` until complete.
|
|
18
|
+
|
|
19
|
+
## Usage
|
|
20
|
+
|
|
21
|
+
```tsx
|
|
22
|
+
import { Field, FieldLabel, TimeField } from "@zonsh/ui";
|
|
23
|
+
|
|
24
|
+
<Field>
|
|
25
|
+
<FieldLabel>Daily reminder</FieldLabel>
|
|
26
|
+
<TimeField defaultValue="08:30" name="reminder" />
|
|
27
|
+
</Field>;
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
- `value` / `onValueChange` — `"HH:mm"` or `null`.
|
|
31
|
+
- `step` — minutes per arrow press.
|
|
32
|
+
- `min` / `max` — bounds, applied on blur.
|
|
33
|
+
|
|
34
|
+
Each segment is a spinbutton: arrows step and wrap (59 → 00) with a digit roll, changing in place when held. Typing moves on once no other digit could follow (`7` in the minutes is 07; `1` in the hours waits for 1 or 12). Backspace clears a segment. A pasted `14:30` or `2:30 pm` fills the field; Arabic, Persian and full-width digits count. Right to left it still reads `14 : 30`, at the field's start with the icon on the left. A focused segment takes the hover fill.
|
|
35
|
+
|
|
36
|
+
## When to use
|
|
37
|
+
|
|
38
|
+
- A time of day; beside a `DatePicker` for date and time.
|
|
39
|
+
- Durations: a `NumberField` per unit — they don't wrap at midnight.
|
|
40
|
+
- Not a `Select` of quarter hours: `step={15}`.
|
|
41
|
+
|
|
42
|
+
## Examples
|
|
43
|
+
|
|
44
|
+
### 12 and 24 hours
|
|
45
|
+
|
|
46
|
+
The clock follows `locale` (en-US `04 : 45 PM`, de-DE `16:45`); `hourCycle` overrides it. `seconds`, or a value with seconds, adds that segment.
|
|
47
|
+
|
|
48
|
+
```tsx
|
|
49
|
+
import { Field, FieldLabel, TimeField } from "@zonsh/ui";
|
|
50
|
+
|
|
51
|
+
export function Clock() {
|
|
52
|
+
return (
|
|
53
|
+
<div className="flex flex-col gap-4">
|
|
54
|
+
<Field className="max-w-48">
|
|
55
|
+
<FieldLabel>Pickup (12-hour)</FieldLabel>
|
|
56
|
+
<TimeField hourCycle={12} locale="en-US" defaultValue="16:45" />
|
|
57
|
+
</Field>
|
|
58
|
+
<Field className="max-w-48">
|
|
59
|
+
<FieldLabel>Abholung (de-DE)</FieldLabel>
|
|
60
|
+
<TimeField locale="de-DE" defaultValue="16:45" />
|
|
61
|
+
</Field>
|
|
62
|
+
<Field className="max-w-48">
|
|
63
|
+
<FieldLabel>Backup starts at</FieldLabel>
|
|
64
|
+
<TimeField hourCycle={24} seconds defaultValue="03:15:00" />
|
|
65
|
+
</Field>
|
|
66
|
+
</div>
|
|
67
|
+
);
|
|
68
|
+
}
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
### Steps and bounds
|
|
72
|
+
|
|
73
|
+
`step={15}` steps 00, 15, 30, 45; typing still takes any minute. A finished time outside `min` / `max` snaps to the nearest bound on blur, as in `NumberField`.
|
|
74
|
+
|
|
75
|
+
```tsx
|
|
76
|
+
import { Field, FieldDescription, FieldLabel, TimeField } from "@zonsh/ui";
|
|
77
|
+
import * as React from "react";
|
|
78
|
+
|
|
79
|
+
export function Steps() {
|
|
80
|
+
const [value, setValue] = React.useState<string | null>("19:00");
|
|
81
|
+
return (
|
|
82
|
+
<Field className="max-w-48">
|
|
83
|
+
<FieldLabel>Table for two</FieldLabel>
|
|
84
|
+
<TimeField hourCycle={24} step={15} min="17:00" max="22:30" value={value} onValueChange={setValue} />
|
|
85
|
+
<FieldDescription>
|
|
86
|
+
{value ? `Booking for ${value}. ` : "Pick a time. "}
|
|
87
|
+
Seatings every quarter hour, 17:00 to 22:30.
|
|
88
|
+
</FieldDescription>
|
|
89
|
+
</Field>
|
|
90
|
+
);
|
|
91
|
+
}
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
### Sizes
|
|
95
|
+
|
|
96
|
+
```tsx
|
|
97
|
+
import { Field, FieldLabel, TimeField } from "@zonsh/ui";
|
|
98
|
+
|
|
99
|
+
export function Sizes() {
|
|
100
|
+
return (
|
|
101
|
+
<div className="flex flex-col gap-4">
|
|
102
|
+
<Field className="max-w-40">
|
|
103
|
+
<FieldLabel>Dense</FieldLabel>
|
|
104
|
+
<TimeField size="sm" hourCycle={24} defaultValue="14:30" />
|
|
105
|
+
</Field>
|
|
106
|
+
<Field className="max-w-40">
|
|
107
|
+
<FieldLabel>Default</FieldLabel>
|
|
108
|
+
<TimeField hourCycle={24} defaultValue="14:30" />
|
|
109
|
+
</Field>
|
|
110
|
+
</div>
|
|
111
|
+
);
|
|
112
|
+
}
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
### States
|
|
116
|
+
|
|
117
|
+
Inside a `Field`, `invalid` gives the red edge and `disabled` dims it. `readOnly` drops the recess but keeps segments focusable, so the time is still read out.
|
|
118
|
+
|
|
119
|
+
```tsx
|
|
120
|
+
import { Field, FieldError, FieldLabel, TimeField } from "@zonsh/ui";
|
|
121
|
+
|
|
122
|
+
function Invalid() {
|
|
123
|
+
return (
|
|
124
|
+
<Field invalid className="max-w-48">
|
|
125
|
+
<FieldLabel>Lesson ends</FieldLabel>
|
|
126
|
+
<TimeField hourCycle={24} defaultValue="09:15" />
|
|
127
|
+
<FieldError match>The lesson ends before it starts at 10:00.</FieldError>
|
|
128
|
+
</Field>
|
|
129
|
+
);
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
function Disabled() {
|
|
133
|
+
return (
|
|
134
|
+
<Field disabled className="max-w-48">
|
|
135
|
+
<FieldLabel>Quiet hours begin</FieldLabel>
|
|
136
|
+
<TimeField hourCycle={24} defaultValue="22:00" />
|
|
137
|
+
</Field>
|
|
138
|
+
);
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
function ReadOnly() {
|
|
142
|
+
return (
|
|
143
|
+
<Field className="max-w-48">
|
|
144
|
+
<FieldLabel>Checkout by</FieldLabel>
|
|
145
|
+
<TimeField hourCycle={24} defaultValue="11:00" readOnly />
|
|
146
|
+
</Field>
|
|
147
|
+
);
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
/** Invalid, disabled and read-only, one under the other. */
|
|
151
|
+
export function States() {
|
|
152
|
+
return (
|
|
153
|
+
<div className="flex w-full max-w-sm flex-col gap-8">
|
|
154
|
+
<Invalid />
|
|
155
|
+
<Disabled />
|
|
156
|
+
<ReadOnly />
|
|
157
|
+
</div>
|
|
158
|
+
);
|
|
159
|
+
}
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
## Props
|
|
163
|
+
|
|
164
|
+
| Prop | Type | Default |
|
|
165
|
+
| ------------------------ | ------------------------------------------------------------- | ------------------------------------------ |
|
|
166
|
+
| `value` / `defaultValue` | `string \| null`: `"HH:mm"` or `"HH:mm:ss"`, 24-hour | — |
|
|
167
|
+
| `onValueChange` | `(value: string \| null) => void` | — |
|
|
168
|
+
| `size` | `"sm" \| "default"` | `"default"` |
|
|
169
|
+
| `hourCycle` | `12 \| 24` | the locale's |
|
|
170
|
+
| `locale` | `string` (BCP 47) | the `LocaleProvider`'s, else the browser's |
|
|
171
|
+
| `seconds` | `boolean` | from the value |
|
|
172
|
+
| `step` | `number`: minutes per arrow press on the minutes | `1` |
|
|
173
|
+
| `min` / `max` | `string`: `"HH:mm"` | — |
|
|
174
|
+
| `name` | `string`: submits the value in a hidden input (`""` if empty) | — |
|
|
175
|
+
| `required` | `boolean`: a time must be entered | `false` |
|
|
176
|
+
| `disabled` / `readOnly` | `boolean` | `false` |
|
|
177
|
+
| `icon` | `boolean`: the clock at the end | `true` |
|
|
178
|
+
| `labels` | `{ hour?, minute?, second?, dayPeriod?, empty? }` | English |
|
|
179
|
+
| `inputRef` | the hidden input, for a form library to focus the field | — |
|
|
180
|
+
|
|
181
|
+
Without `locale`, server rendering shows the en-US clock until hydration; pass it from the request.
|
|
182
|
+
|
|
183
|
+
`required` makes an incomplete field `valueMissing` (blocks submit, focuses the first empty segment). `validate` and `onFormSubmit` get the 24-hour value.
|
|
184
|
+
|
|
185
|
+
Other props go to the group; a form reset restores `defaultValue`. Data: `data-size`, `data-disabled`, `data-readonly`, `data-invalid` (from a `Field`); on each segment `data-type`, and `data-placeholder` while empty.
|
|
186
|
+
|
|
187
|
+
A `LocaleProvider` sets `labels` (`messages.timeField`) and the default `locale`.
|
|
188
|
+
|
|
189
|
+
## Brand rules
|
|
190
|
+
|
|
191
|
+
- **Do** keep the value 24-hour; the display follows the locale.
|
|
192
|
+
- **Do** set `step` and bounds to the business rule.
|
|
193
|
+
- **Don't** add AM/PM by hand; use `hourCycle={12}`.
|
|
194
|
+
- **Don't** use a long `Select` of times.
|
|
195
|
+
|
|
196
|
+
## Accessibility
|
|
197
|
+
|
|
198
|
+
- The field is a `group` named by its `FieldLabel`; each segment is a `spinbutton` named by the label and its own name ("Daily reminder Hours"), with `aria-valuenow` and `aria-valuetext` ("Empty" until filled; on a 12-hour clock the hour reads with its half of the day, "9 PM"). Rename segments with `labels`.
|
|
199
|
+
- Clicking the label focuses the first segment.
|
|
200
|
+
- Segments are `contenteditable` with `inputmode="numeric"` (a number pad on phones); IME input is applied when composition ends.
|
|
201
|
+
- `Field` descriptions and errors are announced per segment, with `aria-required` when required.
|
|
202
|
+
- The roll is hidden from assistive tech and still under reduced motion.
|
|
203
|
+
|
|
204
|
+
### Keyboard
|
|
205
|
+
|
|
206
|
+
| Key | What it does |
|
|
207
|
+
| ------------------ | ---------------------------------------------------------------------- |
|
|
208
|
+
| Tab / Shift+Tab | Moves to the next or previous segment |
|
|
209
|
+
| ← / → | Moves to the segment on the left or right |
|
|
210
|
+
| ↑ / ↓ | Steps the segment up or down, wrapping at the ends (minutes by `step`) |
|
|
211
|
+
| Home / End | Sets the segment to its first or last value |
|
|
212
|
+
| 0–9 | Types into the segment, and moves on once it is full |
|
|
213
|
+
| A / P | Sets the AM/PM segment |
|
|
214
|
+
| : or Space | Moves on from a filled segment |
|
|
215
|
+
| Backspace / Delete | Clears the segment; Backspace in an empty one moves to the previous |
|
|
216
|
+
|
|
217
|
+
Segments always run left to right, so ← and → follow what you see. AM/PM also takes the first letter of the locale's names.
|
|
218
|
+
|
|
219
|
+
---
|
|
220
|
+
|
|
221
|
+
- Import: `import { TimeField } from "@zonsh/ui"`
|
|
222
|
+
- Source: `packages/ui/src/components/time-field.tsx`
|