@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
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,643 @@
|
|
|
1
|
+
# @zonsh/ui
|
|
2
|
+
|
|
3
|
+
## 0.6.1
|
|
4
|
+
|
|
5
|
+
No changes in this release.
|
|
6
|
+
|
|
7
|
+
## 0.6.0
|
|
8
|
+
|
|
9
|
+
### Minor Changes
|
|
10
|
+
|
|
11
|
+
- 856349e: `AudioPlayer` splits its surface from its arrangement: `variant` is the surface, `card`, `region` (new, square) or `plain`, and the new `layout` is the arrangement, `default`, `row` or `note`. A row and a note have no surface unless you give one. The root also writes `data-layout`.
|
|
12
|
+
`variant="row"` and `variant="note"` are not kept: see the entry "Removed before 1.0".
|
|
13
|
+
- e382366: New `AudioPlayer`, in review: a recording or a track in the zon material in place of the browser's audio controls. The waveform is the scrubber — rounded bars that fill smoothly in the foreground ink while it plays, with a preview line and the time under the pointer — beside a large round play button, mono times at the waveform's ends, a quiet speed menu and a volume popover. Four layouts: `card` (a 20px object with title, artist and artwork), `plain` (the same without a surface, for a dialog or the Lightbox's black ground), `row` (one line for lists and history) and `note` (a voice message in chat); `size="sm"` takes each a step smaller. Given `peaks` it draws the sound, `peaks="auto"` decodes the file in the browser once on screen, and without them a quiet pattern made from the URL stands in. `audioPeaks()` computes peaks from a URL, a Blob or an ArrayBuffer with Web Audio, and `bucketPeaks()` buckets raw samples on a server. Its words come from a LocaleProvider (`audioPlayer`, German included). Starting an AudioPlayer or a VideoPlayer with sound now pauses any other player of either kind with sound; `pauseOthers={false}` keeps one out of it.
|
|
14
|
+
- 397362f: BottomNav: two looks and frosted glass. `variant="bar"` (the default) is the full-width bar, now icons alone with a 2px rule on the hairline over the current one; `variant="capsule"` floats the items in a rounded capsule with the current one on a raised pill, and takes one `action`, the new `BottomNavAction`: a round primary beside it. `frosted` turns either into frosted glass, for pictures scrolling under it. Labels are no longer drawn: each stays the item's name for screen readers. **Migrate:** nothing to change in code; a bar that relied on visible labels should use icons people already know, or move the place to a sidebar.
|
|
15
|
+
A press no longer fills the item: its icon presses in and springs back, and the action does the same.
|
|
16
|
+
The current mark moves like liquid: it can be pressed, lifting, and dragged along the bar, squashing and stretching on a spring, to choose another item, as on iOS.
|
|
17
|
+
The bar's height follows the control height where the bar sits, so a region with its own control height gets a bar that fits it.
|
|
18
|
+
- b0ad8a5: **Breaking:** `@zonsh/ui/styles.css` is now the design system alone, on a plain `--background` page. zon.sh's own look moved to an opt-in stylesheet, `@zonsh/ui/brand.css`: the still grain and the faint light from above on the page ground (`html::before`, `body::before`, `body::after`), `<html>` painted in `--page-tone`, the same grain and light in the bars that stand on the ground (`surface-page`, `SiteHeader`, `BottomNav`, which are plain `--background` without it), and the glow orb and starfield decorations. In `styles.css` the page tokens `--page-glow`, `--page-grain-opacity` and the new `--page-grain-screen` are now off (transparent, 0), and `<html>` takes `--background`. `styles.css` no longer includes it. Components look the same with or without it. The grain, blueprint, dots, rails and crosshair utilities, the `--page-tone` token, `PAGE_TONE` and the `ep-reveal` keyframes stay in the system.
|
|
19
|
+
**Migrate:** for zon.sh's look, add `@import "@zonsh/ui/brand.css";` after `@import "@zonsh/ui/styles.css";` (or after the core and parts when you load the styles in parts). Nothing to do for a plain page.
|
|
20
|
+
- 16a64ce: New entry `@zonsh/ui/brand` for zon's own brand pieces: `Logo`, `LogoMark`, `LogoLeft`, `LogoRight`, `Wordmark`, `AsciiField`, and Tippy (`Tippy`, `TippyGuide`, `tippyMoves`, also still at `@zonsh/ui/tippy`). They stay semver-stable, but apart from the components every product uses. They are no longer in `@zonsh/ui`: see the entry "Removed before 1.0".
|
|
21
|
+
- 0829c17: New `Button` variant `bare`: no fill, edge or shadow at rest or on hover — the muted ink lights up to the foreground on hover, keyboard focus, press and while its menu is open, with the usual 2px focus outline. For icon-only toggles beside other content: collapse and expand, a close mark, `<SidebarTrigger variant="bare" />`. It takes every size and text too.
|
|
22
|
+
- d8234a5: `Button` takes `loading` and `loadingLabel`: a spinner takes the place of the leading icon (or sits over the label, which keeps its width), the button is `aria-busy` and `aria-disabled`, ignores clicks and keys and keeps its focus, and says `loadingLabel` while it works. The part is `data-loading`, the spinner `data-slot="button-spinner"`. The sign-in, contact-form, shop, form, onboarding and settings demos use it in place of their hand-made pending buttons.
|
|
23
|
+
- 856349e: `Card`'s variants are now `card`, `region` and `plain`, the names every container uses for an object, a part of the page and no box. The old names are not kept: see the entry "Removed before 1.0".
|
|
24
|
+
**Breaking:** `data-variant` on a `Card` now writes the new name: `card` where it wrote `default`, `region` where it wrote `square`.
|
|
25
|
+
**Migrate:** in a stylesheet or a test, `[data-slot="card"][data-variant="default"]` becomes `[data-variant="card"]`, and `[data-variant="square"]` becomes `[data-variant="region"]`; in code, `<Card variant="square">` becomes `<Card variant="region">`.
|
|
26
|
+
- 5928790: `ChartContainer` takes `loading` and `empty`: the frame keeps its size and grid hairlines, with a placeholder sweeping over the plot while loading (`aria-busy`, "Loading the chart") or `emptyMessage` in the middle when there is nothing to plot ("No data to show yet."), and neither draws the chart. The words are `messages.chart` (`loading`, `empty`; German in the pack) or `labels`. New States and WithTable demos — the values as a table beside the chart.
|
|
27
|
+
- 569c201: A one-row `CodeBlock`, `size="sm"`: the line of code and the copy button in one row, with no header, for a command such as `pnpm add @zonsh/ui`. It is the default for one line of code without a `filename` or line numbers, so a one-line block with a `language` no longer draws a header row for the language label and the copy button; `size="default"` keeps the header. The block writes `data-size="sm"` when it is one row. A fenced block in `Response` keeps its header, so nothing jumps while a reply streams.
|
|
28
|
+
- 4be1a50: `ComboboxStatus` (new) wraps Base UI's `Combobox.Status`: a line above the list that screen readers announce politely; `loading` adds a small spinner and "Loading…" (`messages.combobox.loading`, German "Wird geladen …") when it has no words of its own. A read-only `Combobox` (`readOnly`) now hides its chevron and clear button and keeps its list shut. New Async and States demos.
|
|
29
|
+
- 559596d: `CommandDialog` takes `loading` and `onQueryChange` for results from a server: while loading, a "Searching…" row with a spinner sits above the results (announced politely), the palette is `aria-busy` and "Nothing matches" waits until the answer is in. The row is the new `CommandStatus` part (Base UI's `Autocomplete.Status`), for your own compositions; its text is `messages.command.loading` (German "Wird gesucht …"). New AsyncResults demo.
|
|
30
|
+
- 3b2021f: `DataTable`'s `tableContainerProps` is now `containerProps`, as on `Table`, and `virtualize` is now `virtualized`, as on `Tree`. The old names are not kept: see the entry "Removed before 1.0".
|
|
31
|
+
- 11cd655: `DatePicker`, `DateRangePicker` and `DateTimePicker` take `readOnly`: the trigger shows the value without the recess, as a read-only input does, stays focusable and opens no calendar, and a form still submits the value. The trigger writes `data-readonly`. New ReadOnly demo.
|
|
32
|
+
- 1961783: Density: a theme's control height is now its density, and the rest of each component follows it. `ThemeShape.height` is renamed `controlHeight` (the default control height in px; a preset saved with `height` still reads), so "density" always means how dense, never a height; and `themeShapeTokens` writes a new `--density` token, 0.79 at Dense (30px) to 1.21 at Spacious (46px). Inside every part (`[data-slot]`), Tailwind's step is `--zon-spacing × --density`, so padding, gaps and Tailwind sizes tighten or open with the heights, while your own layout outside the parts keeps its spacing. Type follows at half the rate through `--type`: the components' sizes are now `text-11` … `text-36` (and `text-xs`, `text-sm`, `text-lg` … scale too), never under 10px; `text-base` stays 16px for touch fields. `themePresetFromColor` takes `density: "dense"` and `"spacious"` besides `compact`, `default` and `comfortable`, or a `controlHeight` in px, and `themeDensity(controlHeight)` gives the factor. The theme editor's Control height is now Density, Dense to Spacious. Badges and keyboard keys keep their 16 / 20px; checkboxes, radios, switches and slider thumbs keep theirs. At zon's own density nothing moves.
|
|
33
|
+
- 59051c8: `Dialog` uses large screens: every size but `sm` is wider and steps up again from 1280px, and a new `size="full"` fills the screen but an 8px gutter, rounded like the other sizes, for a workspace, a reader or an editor. `default` is 576px, 704px from 1280px (was 512px); `lg` 768px, 960px (was 704px); `xl` 960px, 1216px (was 896px); `sm` stays 416px. The width now lives in a `--dialog-width` custom property, so a `max-w-*` class on `DialogContent` replaces it at every breakpoint. `DialogDescription` keeps a 640px reading measure in a wide dialog. `AlertDialog` is unchanged and stays small.
|
|
34
|
+
|
|
35
|
+
**Breaking (visual):** a dialog at the default size, `lg` or `xl` is wider than before. **Migrate:** to keep the old width, pass it as a class — `<DialogContent className="max-w-[32rem]">` for the old default (`max-w-[44rem]` for `lg`, `max-w-[56rem]` for `xl`) — or use `size="sm"` (416px) where the dialog holds one field or a short message.
|
|
36
|
+
|
|
37
|
+
Side `Drawer` panels are 480px wide from 1280px (416px below); a `w-*` class still sets your own. `PdfPreview` opens its reader at `size="full"`, almost the whole screen.
|
|
38
|
+
|
|
39
|
+
The Dialog docs gain a "Form in a dialog" example — a `Form` with an `id` in a `@container` body, two columns at width, submitted by a footer button with `form="…"` — and guidance on picking the size by the content.
|
|
40
|
+
|
|
41
|
+
- 13a770a: Drawer: `modal={false}` is now a panel beside the page, as Base UI means it. There is no backdrop, presses outside the panel reach the page, focus is not trapped and the page scrolls; Escape, a swipe and the close button still close it. `DrawerContent` takes `top` (pixels or a CSS length) to start the drawer below a sticky header; it sets `--drawer-top`, which can also go on `:root`. The popup has `data-modal` (`"true"`, `"false"` or `"trap-focus"`), so code that looks for open modals can tell a side panel apart. Modal drawers, the default, are unchanged.
|
|
42
|
+
|
|
43
|
+
**Breaking:** with `modal={false}`, the drawer no longer renders `data-slot="drawer-backdrop"`, and a press outside it no longer closes it (`disablePointerDismissal` now defaults to `true` there).
|
|
44
|
+
**Migrate:** to close a non-modal drawer on an outside press again, pass `disablePointerDismissal={false}`. For a backdrop, leave `modal` at its default or use `modal="trap-focus"`.
|
|
45
|
+
|
|
46
|
+
- fca920b: New entry `@zonsh/ui/drawing`: the light-table drawings one component each — `DrawingHorizon`, `DrawingEclipse`, `DrawingCrescent`, `DrawingNibStudy`, `DrawingElevationGuides` and `DrawingBracketConstruction` — drawing exactly what `<Illustration name="drawing/…" />` draws. `Illustration` reaches every entry by name, so a build that imports it for one drawing takes the whole library: every isometric figure as a chunk, the editorial images as files and the metadata. A footer's horizon from `@zonsh/ui/drawing` takes only its own geometry — in a minimal Vite app, 38 kB less JavaScript (13 kB gzipped) and 63 fewer files in the build. The Illustrations page points to it.
|
|
47
|
+
- 281bf8a: `FeatureList` is drawn like a sheet on the drawing board:
|
|
48
|
+
|
|
49
|
+
- **`grid`:** the columns are divided by vertical rules under the top hairline.
|
|
50
|
+
- **`bento`:** a framed sheet with a crosshair on each corner. A cell is composed by its `span`:
|
|
51
|
+
- `large`: a stage across the top, then a large Licht title.
|
|
52
|
+
- `tall`: the words at the top, the stage below.
|
|
53
|
+
- `wide`: the words in one half, the stage in the other.
|
|
54
|
+
- A small cell keeps its index at the top and its words at the bottom.
|
|
55
|
+
|
|
56
|
+
The `media` sits on a dotted stage that runs to the cell's edges. A spanning cell's title defaults to Licht.
|
|
57
|
+
|
|
58
|
+
- **`rows`:** the picture takes more of the row than the words, and the titles are larger.
|
|
59
|
+
|
|
60
|
+
The new `FeatureFigure` frames a feature's picture: a square region on the blueprint grid (or `texture="dots"`) with a crosshair on each corner, at `ratio` 4 / 3. A new `crosshair-corners` utility marks the four corners of a ruled frame without extra markup.
|
|
61
|
+
|
|
62
|
+
**Breaking (visual):** a bento has an outer frame, and `rows` media is wider than its text. **Migrate:** nothing to change. Wrap a `rows` illustration in `FeatureFigure` with `className="w-full"` in place of a hand-made `surface-container` box.
|
|
63
|
+
|
|
64
|
+
- ddb7bf8: `FeatureList` takes a `layout`, so a page doesn't say every list the same way: `grid` (the three hairline columns, still the default), `bento` (a ruled grid divided by inner hairlines, where `FeatureItem span="wide" | "tall" | "large"` gives one idea more room), `rows` (each item beside its picture, the sides alternating), `index` (a numbered list with large Licht numerals, for steps) and `split` (title left, body right, for specifications and what's included). `FeatureItem` takes `media` — an illustration, a product detail or a small live composition of components — and defaults its title to Licht in `rows` and `index`. Items now wrap their header, title and body in a `feature-item-content` part; the list carries `data-layout`.
|
|
65
|
+
|
|
66
|
+
The marketing guide (`marketing.md`, in the skill, at `/ui/marketing.md` and in llms.txt) is rewritten for landing pages, marketing sites, waitlists, shops and product pages: compose for the product rather than copy zon.sh's outline; five hero variants (split with a figure, product first, centred statement, editorial, with the form) and where the page's one primary goes; a library of section patterns chosen by content, trust without social proof, alternatives to the FAQ accordion and call-to-action bands; and four footer patterns — night CTA, link columns, compact and big wordmark — with code. In the night footer the legal row now sits under the horizon, at the very bottom of the page, instead of above its rim. The skill's index sends agents building those pages to the guide first, and the `Section` docs say the "01 / …" numbering is optional.
|
|
67
|
+
|
|
68
|
+
- 46f4ba5: Fonts ship with the CSS via `@zonsh/fonts`; `zonFonts()` is gone. `@zonsh/ui` now depends on `@zonsh/fonts` (`^0.1.1`), and `@import "@zonsh/ui/styles.css"` (or `styles/core.css`) brings the Licht, Licht Sans and Licht Mono `@font-face` rules with it: the app's bundler (Vite, or Next.js with Turbopack or webpack) copies the WOFF2 files into the build and serves them from the app's own origin. No plugin, proxy or rewrite, and the faces are pinned by the lockfile instead of following zon.sh. The family names are the same, and the size-matched fallbacks stay (Licht Sans's re-measured against its new cuts).
|
|
69
|
+
|
|
70
|
+
Every cut is real now: Licht Sans from 100 to 900 and Licht Mono from 100 to 800, each upright and italic, so Tailwind's `font-thin` … `font-black` and `italic` pick a true face for them; the browser fetches only the cuts a page uses. Licht itself also comes in 100–900, but headlines stay Light by rule: the `h1`–`h4` base rule, the `display` utility, `font-heading` (which now sets `font-weight: 300` too), Prose, Response and the editor's headings set 300 with `font-synthesis: none`, and `<b>`/`<strong>` inside them keep the heading's weight, so nothing renders heavier than before. Don't put a weight utility on Licht text: it would now pick a real heavier cut.
|
|
71
|
+
|
|
72
|
+
`zonFonts()` and `LICHT_ORIGIN` are removed from `@zonsh/ui/vite` (see the entry "Removed before 1.0"). **Migrate:** remove `zonFonts()` from `vite.config.ts`, and the `/licht/fonts/:path*` rewrite from `next.config.ts` or your host. create-zon's templates no longer add either.
|
|
73
|
+
|
|
74
|
+
- 642d1ce: `Graph` says so when it has no nodes: a line in the middle of the canvas — `emptyMessage`, or "Nothing to show yet." (`messages.graph.empty`), "Nothing here yet. Add a node to start." when editable (`emptyEditable`); German in the pack. It doesn't catch the pointer, so the canvas menu still opens. The frame writes `data-empty`. New Empty demo.
|
|
75
|
+
- b04a6a1: Graph: in a frame under 480px wide, a flow with no `direction` set now reads top to bottom, and the minimap is left out. **Breaking:** the default direction changes in narrow frames. **Migrate:** pass `direction="right"` to keep a left-to-right flow on phones.
|
|
76
|
+
- cb8bcd2: The main entry lists its names one by one and leaves out the library's own helpers: anything marked `@internal`, and what a private `_` module shares with a component.
|
|
77
|
+
**Breaking:** `sx`, `triggerSlot` and the `StateClassName` type (class helpers the components compose with) and `bucketPeaks` (an AudioPlayer waveform helper) are no longer exported from `@zonsh/ui`.
|
|
78
|
+
**Migrate:** use `cn` for your own class names — `sx(base, className)` was `(state) => cn(base, typeof className === "function" ? className(state) : className)`, which you can write inline; for waveform peaks use `audioPeaks`, which `bucketPeaks` was a part of.
|
|
79
|
+
- 21a5b87: Every built-in string goes through `labels` and a `LocaleProvider`: `SiteHeader`, `DialogContent`, `DrawerContent`, `ComboboxChip` and `FileDropItem` take `labels` (`Partial<SiteHeaderMessages>`, `{ close }`, `{ close }`, `{ remove }`, `{ remove }`). Their loose props are not kept (see the entry "Removed before 1.0"): `SiteHeader` `navLabel` (use `labels.nav`) and `menuLabels` (use `labels.openMenu`, `closeMenu`, `menu`), `DialogContent` and `DrawerContent` `closeLabel` (use `labels.close`), and `ComboboxChip` and `FileDropItem` `removeLabel` (use `labels.remove`, a function of the chip's text or the file's name).
|
|
80
|
+
- d8d6607: The Lightbox plays a sound in the Audio Player, loaded with the first sound shown, instead of the browser's own controls: the file's name as the title, its size beneath, and a `poster` or `thumbnail` as the artwork.
|
|
81
|
+
- b555ab4: Lightbox opens from code and shows files of any kind. `item` opens the viewer at one file from wherever the app decides (and `null` closes it), among `items` when it is one of them, with `onItemChange` as people move on. `items` takes files of any kind, each shown as what it is by its `kind`, MIME `type` or extension (`lightboxItemKind` says which): an image with zoom and pan as before, a video in the Video Player (loaded with the first video), a sound in a small player, a PDF in the reader handed to `pdfViewer` (`PdfViewer` from `@zonsh/ui/pdf-viewer`, so pdf.js stays out of the main entry; the browser's own viewer without it), a text fetched or given as `text` in a Code Block, and anything else by its name and size with a Download button. A Lightbox inside a Dialog opens over it as a nested dialog, with its black ground: Escape closes the viewer alone and focus goes back to what opened it. `images` is now optional, and `LightboxMessages` has seven new strings for files, in the German pack too.
|
|
82
|
+
- ce2aa87: `Lightbox` has one way in and one way to control it: `items` for what it shows (images or files of any kind) and `index` with `open` to open it from code. `images`, `item` and `onItemChange` are not kept: see the entry "Removed before 1.0".
|
|
83
|
+
- 21a5b87: The locale types are renamed so they don't read as chat messages: `Messages` is now `LocaleMessages`, and `PartialMessages` is now `PartialLocaleMessages`. The old names are not kept: see the entry "Removed before 1.0".
|
|
84
|
+
**Breaking:** code that adds its own namespace by declaration merging must extend the new interface.
|
|
85
|
+
**Migrate:** `declare module "@zonsh/ui" { interface Messages { … } }` becomes `declare module "@zonsh/ui" { interface LocaleMessages { … } }`, and `const nl: Messages = …` becomes `const nl: LocaleMessages = …`.
|
|
86
|
+
- e9783ec: **Breaking:** `lucide-react` is now a peer dependency of `@zonsh/ui` instead of a dependency. The components draw their icons with it and every example imports its icons from it, but under pnpm (and Yarn) an app can't import a package it doesn't list itself, so code copied from the docs failed with "Cannot find module 'lucide-react'". As a peer, package managers install it or ask for it, and the app imports the same copy the components use. The setup steps, the README and the Get started page now install it beside the library, and apps from `create-zon` list it.
|
|
87
|
+
**Migrate:** add it to your app if it isn't there yet — `pnpm add lucide-react` (npm and pnpm install a missing peer by themselves, Yarn warns).
|
|
88
|
+
- 4445fbb: New, in review: `MarkdownEditor`, from `@zonsh/ui/markdown-editor` — a recessed field for formatted text that is stored as markdown: comments, messages, ticket descriptions. It writes like the editors in Notion and Slack, built on Tiptap (ProseMirror): bold shows bold, lists are lists, links are links, code is code, with no markdown marks in sight. `value`, `defaultValue` and `onValueChange` are markdown, read and written with `@tiptap/markdown`; markdown it can't hold as a node, such as a table, is kept as written. A quiet toolbar marks what is on at the caret and has the usual shortcuts (⌘B, ⌘I, ⇧⌘X, ⌘E, ⌘K, ⇧⌘7, ⇧⌘8, ⇧⌘9, ⇧⌘.); markdown typed as you go turns into what it means (`**bold**`, `_italic_`, `` `code` ``, `- `, `1. `, `[ ] `, `> `, `# `, ` ``` `); ⌘K or a click on a link opens a small popover to edit, open or remove it; pasted rich text is cleaned to what markdown holds and pasted markdown is read as markdown. `mentions` takes triggers shaped like `Mentions`' — `@` people, `#` channels — with a suggestion list under the caret and picks drawn as chips (`<span data-slot="mention" data-appearance data-tone data-trigger>`), written to the markdown by `toMarkdown` and read back by `fromMarkdown`. `submitOnEnter` sends the form on Enter, as a chat composer does, outside lists and code; ⌘Enter / Ctrl+Enter sends either way.
|
|
89
|
+
|
|
90
|
+
Writing feels like Notion and Slack: a "Text ▾" block menu in the toolbar turns the line into text or a heading (Heading 1–3) and names what it is; the rest of the toolbar is grouped into marks, lists and blocks; a small bubble of marks (bold, italic, strikethrough, code, link) rises over selected text, Alt+F10 into it; "/" at a line's start opens a menu of blocks — text, headings, lists, a to-do list, quote, code block, divider, and attach files when files are taken — filtered as you type, with Escape leaving the "/" as text (`slashCommands`, default on); an empty line hints "Type / for commands" and an empty heading names its level; Backspace at the start of a heading, quote, code block or list item takes its formatting off before it joins the line above. `toolbar` puts the formatting row on `top` (default), at the `bottom` like Slack's composer, or leaves it out (`none`) like Notion. Task boxes sit centred on their line. The toolbar never scrolls: in a narrow field — a phone — the least-used commands move one by one into a "…" menu, and in the markdown view the Write and Preview tabs take a row of their own above the commands when both don't fit. Text typed at the end of a link is no longer part of it; a URL followed by a space or Enter, or pasted, still becomes a link. The rich text is set compactly, as an input: Licht Sans 14px at 1.5 (16px on touch screens), blocks 6px apart, headings at 20, 17 and 15px. With the caret in a line of text, the block menu starts a new line of the picked kind under it instead of turning what was typed into it; a selection or an empty line is turned into it. Backspace right after a markdown shortcut fired gives the markdown back as typed. `markdownShortcuts={false}` turns typed markdown off, keeping the toolbar, the menus, "/" and paste. The Validation and Disabled examples are one, States. New commands for `run` and `tools`: `paragraph`, `heading1`–`heading3` and `divider`.
|
|
91
|
+
|
|
92
|
+
`mode="markdown"` keeps the markdown view: a textarea whose toolbar types the marks, with lists that carry on with Enter and nest with Tab, and optional Write and Preview tabs (`preview`). `modeToggle` adds an MD toggle to switch views; `mode`, `defaultMode` and `onModeChange` control it. Both views grow with the text from `minRows` to `maxRows`, take pasted, dropped and chosen files (`files`, `upload`, `accept`, `maxSize`, `maxFiles`) — staged below the text, or uploaded with the returned markdown put in at the caret — work inside a `Field` (label, description, invalid, disabled, `name`, `required`), and take their words from a `LocaleProvider`, German included. Parts in `children` reach the editor through `useMarkdownEditor`.
|
|
93
|
+
|
|
94
|
+
The Tiptap packages are optional peer dependencies, needed only for `@zonsh/ui/markdown-editor`: `@tiptap/core`, `@tiptap/pm`, `@tiptap/react`, `@tiptap/starter-kit`, `@tiptap/extension-list`, `@tiptap/extensions` and `@tiptap/markdown`, at one version. Its text's styles are a new part, `@zonsh/ui/styles/editor.css`, which `styles.css` includes.
|
|
95
|
+
|
|
96
|
+
`PromptInput` takes files a browser lists only as clipboard or drop items, as `FileDrop` does.
|
|
97
|
+
|
|
98
|
+
- 1988cc9: New `Mentions` (in review): suggestions at the caret of a textarea or input the app owns — `@` for people, `#` for issues, `/` for commands. Wrap the field (`<Mentions triggers={…}><Textarea /></Mentions>`) or pass a field rendered elsewhere as `inputRef`. Each trigger has its own items, a list filtered by the query or an async function of it, and opens only at a word start; the list sits in the menu material under the caret's line, flips and shifts at the window's edge, and follows the field as it scrolls. ↑ ↓ move, Enter or Tab inserts in place of the trigger and query with undo intact, and Escape closes it keeping the text; the field keeps focus and becomes an ARIA combobox. English and German messages under `mentions`. A picked mention stays marked in the field: per trigger, `appearance` makes it a raised `chip` (the default for `@`), `text` in a medium weight (the default for other triggers) or `none`, and `tone` gives it a category tone; `pattern` marks mentions nobody picked, in the initial or pasted text. A mention edited partway is plain text again. The field keeps its own text, caret and selection; a copy behind it draws the marks. `MentionToken` draws the same mark in text that is only read, and the look lives in the stylesheet on `[data-slot="mention"][data-appearance][data-tone]`, for a rich-text editor's mention nodes too.
|
|
99
|
+
- 0829c17: `MessageAction` takes `copy`: the text to copy (or a function returning it). It is then a `CopyButton` in the same ghost circle with its tooltip — the copy icon turns into a check for a moment, a cross if the clipboard refuses, and "Copied" is announced — with `onCopy` and `onCopyError`. `<MessageAction label="Copy" copy={text} />` replaces a plain action with a clipboard call in `onClick`.
|
|
100
|
+
- 24d1c17: `MessageError` (new): a message that failed — a reply that broke off, a user message that wasn't sent — as a line in the destructive ink with an icon, announced (`role="alert"`), and a "Try again" button with `onRetry` that shows a spinner while `retrying`. Its words are `messages.message` (`failed`, `retry`; German in the pack) or `labels`. New Failed demo.
|
|
101
|
+
- 46efa10: Rows that outgrow a phone fold instead of widening the page:
|
|
102
|
+
|
|
103
|
+
- `Menubar` takes `collapse` (`"auto"` by default, `true`, `false`) and `labels.menu`: a bar that would not fit its row becomes one "Menu" button whose menu lists every menu's items under its name, and comes back when there is room. New `MenubarMessages` (`messages.menubar`).
|
|
104
|
+
- `Breadcrumb` takes `maxItems` (`"auto"` by default, or a count): it folds the pages between the first and the last ones into a "…" menu of links, as many as it takes to stay on one line. New message `breadcrumb.more`. The menu loads the first time a trail folds.
|
|
105
|
+
- `Pagination` takes `compact` (`"auto"` by default, `true`, `false`): Previous, the position in mono ("3 / 12", read as "Page 3 of 12") and Next, where even its shortest row would not fit. New message `pagination.status`.
|
|
106
|
+
- `TabsList` and `ToggleGroup` fade their ends, as a `ScrollArea` does, while they scroll sideways (`data-scroll-fade`), and keep the chosen item clear of the fade.
|
|
107
|
+
- `FilterBar` takes `sheet` (`"phone"` by default, `true`, `false`): on a phone a chip opens its editor in a bottom `Drawer` instead of a popover.
|
|
108
|
+
|
|
109
|
+
The German pack (`@zonsh/ui/messages/de`) has the new messages. A message pack of your own typed as a whole `LocaleMessages` adds `breadcrumb.more`, `pagination.status` and `menubar.menu`; one passed as `messages` (partial) needs nothing.
|
|
110
|
+
|
|
111
|
+
- ddf2835: Custom popups on the desktop, the platform's picker on phones — now by default.
|
|
112
|
+
|
|
113
|
+
**Breaking:** `Select`'s `native` now defaults to `"touch"`: on a phone (a coarse pointer under 768px wide) a Select with plain-text `items` and one value renders a `NativeSelect`, so the platform's own picker opens; elsewhere the popup, as before. A `multiple` select, or one whose labels are elements, keeps the popup. Calendar's month and year dropdowns, DataTable's rows per page and FilterBar's condition follow. **Migrate:** to keep the popup on phones, pass `native={false}`.
|
|
114
|
+
|
|
115
|
+
**Breaking:** `DatePicker` and `DateTimePicker` take `native?: boolean | "touch"`, default `"touch"`: on a phone they render the platform's own `<input type="date">` / `datetime-local` in the field material (same `value`, `onValueChange`, `min`/`max`, `name`, `required`, `disabled`, `readOnly` and `Field`; no placeholder or presets there), and the Calendar popover elsewhere. `DateRangePicker` keeps its popover. **Migrate:** to keep the popover on phones, pass `native={false}`.
|
|
116
|
+
|
|
117
|
+
`DatePicker` takes `min` and `max`: days before or after can't be picked.
|
|
118
|
+
|
|
119
|
+
Scheduler: the editor's days are DatePickers and its row a Select, so a phone gets its own pickers. The editor (loaded the first time it opens) now needs `react-day-picker` and `date-fns`, as DatePicker does; `@zonsh/ui/scheduler` and its menus still load without them. In a Gantt chart, linking tasks is easier to find: the round handle after a bar's end is larger, shows on hover and on the bar in hand, with a "Drag to another task to link" hint (`messages.scheduler.linkHint`); while drawing, the tasks it may go to are outlined and the timeline scrolls near its edges. The room booking demo has a month of bookings.
|
|
120
|
+
|
|
121
|
+
Agent rule 10 and the brand guide say it: custom popups on the desktop, the platform's picker on phones — Select and DatePicker do this by default.
|
|
122
|
+
|
|
123
|
+
The scheduler entry's size budget goes from 108 to 111 KB gzipped: the link handle, its hint and autoscroll, and the editor and menus now loading as two chunks (the menus without the date libraries), which gzip a little less well apart.
|
|
124
|
+
|
|
125
|
+
- 52c5d0f: Navigation is set in Licht Sans. NavigationMenu's top-level links and triggers, and so SiteHeader's links, change from Licht Mono 13px to Licht Sans 14px, matching every other control. The brand rule now gives Licht Mono to labels, numbers and indices only. Breadcrumb, Tabs' underline labels and the eyebrows stay mono.
|
|
126
|
+
- 80a68ae: NavigationMenuLink closes the panel it sits in when chosen (`closeOnClick` now defaults to `true`), so a panel no longer stays open over the next page when a router keeps the document.
|
|
127
|
+
**Breaking:** a NavigationMenu panel whose links should keep it open now closes on click.
|
|
128
|
+
**Migrate:** pass `closeOnClick={false}` to those links.
|
|
129
|
+
- 92b73b5: New `NumberRoll`: a number formatted with `Intl.NumberFormat` in the LocaleProvider's locale whose changed digits roll to their new value like an odometer — up as it grows, down as it falls — while unchanged digits stay still, a place that comes or goes (9.99 → 10.99, 999 → 1,000) opens or closes, and separators and currency signs never roll. The formatted value is its text once, for screen readers and tests; `announce` reads each new value out politely. It never rolls under reduced motion. `Stat` takes `roll` to draw its number value with it. The Shop block's amounts — line totals and quantities, subtotal, delivery, total, the free-delivery amount, the cart count and the sticky total on a phone — now roll as the cart changes.
|
|
130
|
+
- b0ad8a5: The small parts' fixed sizes are tokens now, with zon's values as the defaults, so nothing changes until a theme sets one: `--focus-width` (2px, every focus outline), `--check-size` (18px, Checkbox, Radio and task-list boxes), `--switch-w` / `--switch-h` / `--switch-thumb` (38 / 22 / 18px), `--slider-thumb` (18px, Slider, the media scrubber, Color Picker handles), `--track-h` (6px, Slider, Progress and Meter tracks, times `--density` as before), `--badge-h-sm` / `--badge-h` (16 / 20px), `--kbd-h` (20px), `--tag-h` (22px), `--scroll-thumb` (4px, ScrollArea, times `--density`), `--hairline-opacity` (60%, the components' hairline rules), `--card-space` / `--card-space-sm` / `--card-space-md` (24 / 32 / 40px, `surface-card`'s padding) and `--drag-lift` (1.02, a dragged Sortable item). Theme lists them under "Part sizes".
|
|
131
|
+
- 40314a3: The phone parts answer a finger at once. `AppBar`'s buttons, `ActionSheet`'s choices and Cancel, `SwipeActions` rows and tiles, `BottomNav` items and its action, and `PullToRefresh`'s button show they are pressed the moment a finger lands, not once the browser is sure the touch is not a scroll, and let go as soon as it moves, so a list being scrolled never lights up. A row or a tile darkens with a shade of its own ink: the new `press-shade` utility, which answers `data-pressing`; the button materials sink on `data-pressing` as they do on `:active`.
|
|
132
|
+
|
|
133
|
+
`ActionSheet`: a choice's highlight follows the card's corners. Cancel's, and the first and last choice's where they meet the card, are now 13px, the 20px card less its inset, instead of 7px.
|
|
134
|
+
|
|
135
|
+
`AppBarSearch` gets a clear button once there is text ("Clear search", the new `clear` message, "Suche leeren" in German) that empties the field and keeps the keyboard up, in place of the browser's blue mark; Escape empties the field and, on an empty one, leaves it. The AppBar demos now filter their lists as you type: the field always worked, but the demos never used what was typed.
|
|
136
|
+
|
|
137
|
+
`SwipeActions`: a side with three or more actions never runs one from a full swipe. The swipe only opens the row, and you tap the action you want. One or two actions a side still run the outermost on a full swipe. The first tap on a tile right after a swipe opened the row is no longer swallowed.
|
|
138
|
+
|
|
139
|
+
`BottomNav`: letting go of the capsule's lens is one motion. It sets down (loses its lift) as it shrinks back, instead of after, and the spring ends on the pixel where the lens then rests, so there is no 1px hop or change of width as it settles.
|
|
140
|
+
|
|
141
|
+
- 5eec869: A Phone section, with four new components for the screens of a phone app, and `BottomNav` moved into it (its address is unchanged):
|
|
142
|
+
|
|
143
|
+
- `AppBar` (`AppBarBack`, `AppBarAction`, `AppBarSearch`): the top bar of a phone screen — a back button, the title and up to three actions, sticky and clear of the safe areas, taking the page ground and a hairline as content scrolls under it. `largeTitle` sets the title large under the bar and folds it into the bar with the scroll; `search` puts a field under it.
|
|
144
|
+
- `ActionSheet` (`ActionSheetTrigger`, `ActionSheetContent`, `ActionSheetAction`): a few choices about one thing, sliding up from the bottom on a Base UI Drawer, with a title, a message, at most one destructive action and a separate Cancel; swiped down, Escape or a tap outside dismisses it. On a desktop it opens as a small dialog with the same choices (`presentation`).
|
|
145
|
+
- `SwipeActions`: a list row that slides aside to show leading and trailing actions, opened by a short swipe, run by a full one, springing back otherwise; it never takes a vertical scroll, mirrors right to left, and offers every action in a menu button for the keyboard, screen readers and a mouse.
|
|
146
|
+
- `PullToRefresh`: a scroller that calls `onRefresh` when pulled down past its top, with resistance, a threshold and the Spinner; fingers only by default, with a Refresh button for the keyboard and screen readers.
|
|
147
|
+
|
|
148
|
+
New `LocaleProvider` namespaces `appBar`, `actionSheet`, `swipeActions` and `pullToRefresh`, with German lines in the `de` pack. A new block, Inbox, puts them together on a phone screen.
|
|
149
|
+
|
|
150
|
+
- 6c45416: `PreviewCardDelegate`: one preview card for every element that matches a selector — `<PreviewCardDelegate selector="[data-issue]">{(el) => <PreviewCardContent>…</PreviewCardContent>}</PreviewCardDelegate>`. It listens for hover and focus once, on the document or a `container`, instead of mounting a trigger per element, so pages with hundreds of references stay cheap. It keeps a trigger's timing (600ms to open, 300ms to linger, the card keeps it open), opens for keyboard focus, moves straight to the next match while open, and closes on Esc, a press outside, scrolling or leaving the window. `PreviewCardContent` positions against the matched element when it is rendered inside one.
|
|
151
|
+
- 64e6971: `Quote` takes `size="sm"`: the quote at 18–20px with 24px padding, for quotes side by side or one per slide of a carousel. A class on `Quote` could not reach the text before; for a size between the two, target the text part, `[&_[data-slot=quote-text]]:text-[22px]`.
|
|
152
|
+
- 17d5b52: Code blocks load a built-in set of about 35 common languages (JavaScript, TypeScript, TSX, JSON, HTML, CSS, Markdown, YAML, shell, diff, SQL, Python, Go, Rust and more, under their usual aliases), each as its own lazy chunk, instead of referencing every grammar Shiki ships: an app's build no longer emits hundreds of grammar files (~14 MB) because it uses one `CodeBlock`. New `registerCodeLanguage(names, grammar)` adds a language, still lazily, and `codeLanguages()` lists the names a block colours.
|
|
153
|
+
|
|
154
|
+
**Breaking:** a block in a language outside the built-in set (Elixir, Terraform, …) now shows plain mono until that language is registered.
|
|
155
|
+
**Migrate:** register it once in client code — `registerCodeLanguage(["elixir", "ex"], () => import("shiki/langs/elixir.mjs"))`.
|
|
156
|
+
|
|
157
|
+
- d6383f3: `Message from="other"`: a message from another person, for chats between people — at the start, opposite the user's card, in a flat bubble on the hover fill, at most 80% wide, with its actions on hover or focus. `MessageFrom` now includes `"other"`.
|
|
158
|
+
- d6383f3: New `PageHeader` in Typography: the title block at the top of an app screen — a mono eyebrow, the title as the page's `h1` in Licht at 30/36px, a line under it and the page's actions at the end of the row — so app pages no longer copy `font-heading text-[36px] …` by hand. The Dashboard and Sidebar examples use it.
|
|
159
|
+
- d6383f3: `Sidebar standalone`: inside a `SidebarProvider`, render a plain `<nav>` of rows — a settings page's own section list — instead of a second app-shell panel. The Sidebar docs also explain how a router link's own `aria-current` overrides `current` (TanStack Router `activeOptions={{ exact: true }}`, React Router `end`, Next.js comparing `usePathname()`).
|
|
160
|
+
- d6383f3: New `SidebarSubmenu`: a sidebar row that opens nested rows under it, indented on a hairline from the parent's icon, with a chevron that turns down and a height that glides. `active` marks the parent when one of its rows is the current page and opens it at first; in the icon rail, pressing the parent expands the sidebar and opens the submenu.
|
|
161
|
+
- 635bd83: **Breaking:** `FilterBar`'s `addLabel` prop, deprecated in 0.4.0, is removed in favour of `labels.add`.
|
|
162
|
+
**Migrate:** `<FilterBar addLabel="Add filter" />` becomes `<FilterBar labels={{ add: "Add filter" }} />`.
|
|
163
|
+
- 635bd83: **Breaking:** `NumberField`'s `decrementLabel` and `incrementLabel` props, deprecated in 0.4.0, are removed in favour of `labels.decrement` and `labels.increment`.
|
|
164
|
+
**Migrate:** `<NumberField decrementLabel="Fewer" incrementLabel="More" />` becomes `<NumberField labels={{ decrement: "Fewer", increment: "More" }} />`.
|
|
165
|
+
- 635bd83: **Breaking:** `InputGroupPasswordToggle`'s `labels` prop (`{ show, hide }`), deprecated since 0.2.0, is removed. A toggle keeps one name, and `aria-pressed` says whether the password is shown; only `show` was read.
|
|
166
|
+
**Migrate:** `<InputGroupPasswordToggle labels={{ show: "Passwort zeigen" }} />` becomes `<InputGroupPasswordToggle label="Passwort zeigen" />`.
|
|
167
|
+
- 635bd83: **Breaking:** `TagsInput`'s `removeLabel` prop, deprecated in 0.4.0, is removed in favour of `labels.remove`.
|
|
168
|
+
**Migrate:** `<TagsInput removeLabel={(tag) => "Drop " + tag} />` becomes `<TagsInput labels={{ remove: (tag) => "Drop " + tag }} />`.
|
|
169
|
+
- 635bd83: **Breaking:** `TimeField`'s `segmentLabels` prop, deprecated in 0.4.0, is removed. `labels` takes the same keys and is also set for every TimeField by a `LocaleProvider`.
|
|
170
|
+
**Migrate:** rename the prop — `<TimeField segmentLabels={{ hour: "Stunde" }} />` becomes `<TimeField labels={{ hour: "Stunde" }} />`.
|
|
171
|
+
- 635bd83: **Breaking:** `Toaster`'s `closeLabel` prop, deprecated in 0.4.0, is removed in favour of `labels.close`.
|
|
172
|
+
**Migrate:** `<Toaster closeLabel="Schließen" />` becomes `<Toaster labels={{ close: "Schließen" }} />`.
|
|
173
|
+
- 45e7763: Removed before 1.0: every deprecated name is gone, so 1.0 starts with none. Each was renamed or replaced earlier in this release or before it; the replacement below does the same thing. `docs/versioning.md` now says what 1.0 freezes and how a name is deprecated from then on.
|
|
174
|
+
|
|
175
|
+
**Breaking:** `zonFonts()` and `LICHT_ORIGIN` are removed from `@zonsh/ui/vite`, which keeps `zonThemeScript()`.
|
|
176
|
+
**Migrate:** delete `zonFonts()` and its import from `vite.config.ts`, and any `/licht/fonts/:path*` rewrite: the fonts come with `@zonsh/ui/styles.css`.
|
|
177
|
+
|
|
178
|
+
**Breaking:** `Logo`, `LogoMark`, `LogoLeft`, `LogoRight`, `Wordmark`, `AsciiField` and their props types (`LogoProps`, `LogoArtProps`, `WordmarkProps`, `AsciiFieldProps`) are no longer exported from `@zonsh/ui`.
|
|
179
|
+
**Migrate:** `import { Logo } from "@zonsh/ui"` becomes `import { Logo } from "@zonsh/ui/brand"`.
|
|
180
|
+
|
|
181
|
+
**Breaking:** the stylesheet path `@zonsh/ui/styles/brand.css` is removed.
|
|
182
|
+
**Migrate:** `@import "@zonsh/ui/styles/brand.css";` becomes `@import "@zonsh/ui/brand.css";`, the same file.
|
|
183
|
+
|
|
184
|
+
**Breaking:** `dense` is removed from `Table` and `DataTable`, and so is the `data-dense` attribute they wrote.
|
|
185
|
+
**Migrate:** `<Table dense>` becomes `<Table size="sm">`, and `<DataTable dense>` becomes `<DataTable size="sm">`; in CSS, `[data-dense]` becomes `[data-size="sm"]`.
|
|
186
|
+
|
|
187
|
+
**Breaking:** `CodeBlock`'s `compact` prop and its `data-compact` attribute are removed.
|
|
188
|
+
**Migrate:** `compact` becomes `size="sm"` and `compact={false}` becomes `size="default"`; in CSS, `[data-slot="code-block"][data-compact]` becomes `[data-size="sm"]`.
|
|
189
|
+
|
|
190
|
+
**Breaking:** `Card`'s `variant="default"` and `variant="square"` are removed.
|
|
191
|
+
**Migrate:** `variant="default"` becomes `variant="card"` (or nothing: it is the default), and `variant="square"` becomes `variant="region"`.
|
|
192
|
+
|
|
193
|
+
**Breaking:** `AudioPlayer`'s `variant="row"` and `variant="note"` are removed.
|
|
194
|
+
**Migrate:** `<AudioPlayer variant="row" />` becomes `<AudioPlayer layout="row" />`, and `variant="note"` becomes `layout="note"`.
|
|
195
|
+
|
|
196
|
+
**Breaking:** colour through `variant` is removed from `Alert`, `Badge` and `Tag`: `Alert` has no `variant` (and no `data-variant`, nor the `AlertVariant` type), `Badge`'s `variant` is `default` or `secondary`, and `Tag`'s is `default`, `muted` or `outline`.
|
|
197
|
+
**Migrate:** `<Alert variant="warning">` becomes `<Alert tone="warning">`, `<Badge variant="destructive">` becomes `<Badge tone="destructive">`, and `<Tag variant="success">` becomes `<Tag tone="success">`; `AlertVariant` becomes `AlertTone`, and `[data-slot="alert"][data-variant="warning"]` becomes `[data-slot="alert"][data-tone="warning"]`.
|
|
198
|
+
|
|
199
|
+
**Breaking:** the loose interface-text props are removed: `SiteHeader`'s `navLabel` and `menuLabels`, `DialogContent`'s and `DrawerContent`'s `closeLabel`, and `ComboboxChip`'s and `FileDropItem`'s `removeLabel`.
|
|
200
|
+
**Migrate:** `navLabel="Main"` becomes `labels={{ nav: "Main" }}`; `menuLabels={{ open, close, title }}` becomes `labels={{ openMenu: open, closeMenu: close, menu: title }}`; `closeLabel="Schließen"` becomes `labels={{ close: "Schließen" }}`; `removeLabel` becomes `labels={{ remove: (name) => "Remove " + name }}`, a function of the chip's text or the file's name. Or set them once for the app in a `LocaleProvider`.
|
|
201
|
+
|
|
202
|
+
**Breaking:** `Lightbox`'s `images`, `item` and `onItemChange` are removed.
|
|
203
|
+
**Migrate:** `<Lightbox images={photos}>` becomes `<Lightbox items={photos}>` (an image whose URL ends in an extension that isn't an image's needs `kind: "image"`). To open it from code, `<Lightbox items={files} item={file} onItemChange={setFile} />` becomes `<Lightbox items={files} index={files.indexOf(file)} open={file != null} onIndexChange={(i) => setFile(files[i])} onOpenChange={(open) => !open && setFile(null)} />`. A file that is not in `items` goes in a list of its own: `items={[file]}`.
|
|
204
|
+
|
|
205
|
+
**Breaking:** `DataTable`'s `tableContainerProps` and `virtualize` are removed.
|
|
206
|
+
**Migrate:** `tableContainerProps` becomes `containerProps`, and `virtualize` becomes `virtualized`.
|
|
207
|
+
|
|
208
|
+
**Breaking:** the types `Messages`, `PartialMessages` and `VideoPlayerLabels` are removed.
|
|
209
|
+
**Migrate:** `Messages` becomes `LocaleMessages` (in a `declare module` augmentation too), `PartialMessages` becomes `PartialLocaleMessages`, and `VideoPlayerLabels` becomes `VideoPlayerMessages`.
|
|
210
|
+
|
|
211
|
+
**Breaking:** `ThemeShape` has no `height`.
|
|
212
|
+
**Migrate:** `{ height: 38 }` becomes `{ controlHeight: 38 }`. A preset saved with `height`, as JSON or as a code, still reads.
|
|
213
|
+
|
|
214
|
+
- 3d23339: MarkdownEditor and Mentions are ready (no longer drafts).
|
|
215
|
+
|
|
216
|
+
- MarkdownEditor edits GFM tables: the toolbar's new `table` command and `/table` insert one; Tab and Shift+Tab move between cells (Tab in the last one adds a row), Enter moves down a row, and a "Table" menu over the table adds and deletes rows and columns. Tables used to be kept as their markdown source. They are written back as `| a | b |` rows without padding, a `|` in a cell escaped.
|
|
217
|
+
- A picked image opens a popover to edit its alt text or remove it.
|
|
218
|
+
- `readOnly` shows the text formatted and selectable without the toolbar (it used to keep a disabled toolbar).
|
|
219
|
+
- `maxLength` turns away typing and pasting past that many characters (of the text in the rich view, of the markdown in the markdown view).
|
|
220
|
+
- The toolbar's buttons are 38px on a touch screen.
|
|
221
|
+
- A line holding only an image no longer breaks the rich view.
|
|
222
|
+
- New `MarkdownEditorMessages`: `table`, `column`, `addRowAbove`, `addRowBelow`, `addColumnBefore`, `addColumnAfter`, `deleteRow`, `deleteColumn`, `deleteTable`, `imageAlt`, `imageAltPlaceholder`, `imageRemove`, with German.
|
|
223
|
+
- Mentions and the rich editor's mention and "/" lists are one list now: the same popup, rows and live announcements.
|
|
224
|
+
|
|
225
|
+
- ab64394: Scheduler: a calendar, and the timelines polished.
|
|
226
|
+
|
|
227
|
+
- `layout="calendar"` puts days across and the hours down — `view` `"day"`, `"days"` (with `days`), `"work-week"` and `"week"` — with an all-day row, a now line, working hours (`workHours`) it opens at, and overlapping events laid as Apple and Google Calendar lay them: side by side when they start together, a later one cascading over the earlier, never narrower than 64px, names wrapping at words, times that give way as an event narrows, and "Title, 9 AM" on one line for half an hour. A coloured event is a stripe of its tone over a light tint; the past is quieter, an open or dragged event lifted. Or `view="month"`, whole weeks with bars across days, a dot for each timed event and "+N more" in a popover — on a phone, numbers with dots and the picked day's events listed under the weeks. `"timeline"` shows the same items as a resource timeline (with `rows`) or a Gantt chart. The header has the period's name in Licht, then ‹ Today › and a view switch (a select on a phone when there are more than three) (`views`, `view`, `defaultView`, `onViewChange`); `date` and `onDateChange` set the period.
|
|
228
|
+
- Drag an event to another day or time, drag its edge to resize it, or drag over empty space to draw one: `onItemCreate` gets `{ start, end, allDay }`. Moves snap to `step` minutes (15). From the keyboard, ↑/↓ move an event a step, ←/→ a day (a week with ↑/↓ on the month), Shift moves its end, Alt+Shift its start; every change is said. Times follow the locale's 12- or 24-hour clock, or `hour12`.
|
|
229
|
+
- New: `SchedulerItem.allDay`, the types `SchedulerView`, `SchedulerDraft` and `CalendarView`, and the messages `view`, `days`, `workWeek`, `timeline`, `previous`, `next`, `allDay`, `eventRole`, `more`, `moreLabel`, `showDay`, `instructionsTime`, `instructionsDays`, `instructionsCalendarReadOnly`, `newItem`, `creating` and `nothingOnDay` (in the German pack too).
|
|
230
|
+
- `step` also sets what the Day zoom snaps to (an hour by default, as before).
|
|
231
|
+
- The timelines: the Week zoom's days are 48px wide (from 44) so "Wed 30" fits, and the Day zoom's hours 64px (from 40) so an hour's booking has room for its name. A period's name stays in view as the axis scrolls, today has a mark on the axis, the grid and shading reach the bottom of the frame, and the bar in hand lights its row and its dependency lines, which now leave a bar just inside its end with rounded elbows. A Gantt bar too short for its name writes it after the bar; a phase is a hairline bracket; today is a pill on the axis over a quiet line; bars fade into an edge they run on past; a booking's name goes after it where its lane is free, and in the Day zoom a bar says when it starts; a locked bar sits flat in a dashed edge; every bar shows its whole name and when on hover. The list is at most 40% of the frame (from 42%), and the header wraps its title above the controls on a phone.
|
|
232
|
+
- The scheduler entry's size budget rises from 84.8 to 100 KB gzipped, for the calendar; the German pack's from 5.7 to 6.3 KB, for its new message.
|
|
233
|
+
|
|
234
|
+
- fc4bda4: Scheduler: editing in place, with `editor`.
|
|
235
|
+
|
|
236
|
+
- A calendar no longer makes an event from a single click on empty time. Draw over it instead, or right click it (long press on touch) for "New event here". With `editor`, the new event opens in an editor beside it: title, person or room, date, start and end time (`DatePicker`, `TimeField`), all day, and a category shown as a dot and its name. A click on an event opens the same editor, which can also delete it. Delete (or Backspace) deletes the event in focus.
|
|
237
|
+
- A resource timeline draws bookings over a row's free time the same way, into the same editor (title, room, date, time, category). With `onRowsChange`, its list ends in "Add row", and each row's menu renames or deletes it.
|
|
238
|
+
- A Gantt chart with `editor` adds tasks from its list ("Add task", or a phase's +) and names them where they are listed. A row's menu renames, edits or deletes a task. Drag from the handle after a bar's end to another bar to make that task wait for it. Click a dependency line and press Delete to remove it. From the keyboard, a bar's menu (Shift+F10) lists the tasks it may wait for.
|
|
239
|
+
- Every change comes back through `onItemsChange`. `details.change` can now also be `"create"`, `"edit"`, `"delete"` or `"dependency"`, and `details.source` can be `"editor"`. New props: `editor`, `categories` (`SchedulerCategory`: `id`, `label`, `tone`), `onRowsChange` (`SchedulerRowChangeDetails`) and `createId`. `SchedulerItem` gains `category`, `SchedulerDraft` gains `row`, and the messages have the editor's and the menus' words, in German too. The editor and the menus load the first time one opens.
|
|
240
|
+
- The Week and Month zoom of a timeline fill the frame: when the range is narrower than the frame, the columns stretch, so the timeline no longer stops short of the right edge. A resource timeline's Week shows one week across the frame (days at least 120px wide) where bookings are chips in their days with the name and start time inside, stacked by day. Its Month shows each booked month across the frame: a day with bookings is one cell with how many, on a fill that grows with how booked the day is and a dot for each category, and opens a popover listing them. In the event editor, the All day checkbox now lines up with its label.
|
|
241
|
+
- The scheduler entry's size budget goes up from 100 to 108 KB gzipped, to cover the editing code that loads with it (row editing, drawing, dependencies, the menus' hosts). The editor form and the menus themselves load separately.
|
|
242
|
+
|
|
243
|
+
- 3cb385c: New: `Scheduler`, at its own entry `@zonsh/ui/scheduler` — a timeline of tasks or bookings across days and weeks. `layout="gantt"` draws a project plan: a row per task, bars with their progress, dependencies as hairlines and milestones as diamonds, rows under their phase. `layout="resource"` draws people or rooms, with overlapping bookings stacked in lanes. Day, Week and Month zoom, a time axis in Licht Mono with the locale's week start and weekends, a today line, and a list on the left that stays while the timeline scrolls (drag or arrow keys to widen it). Drag a bar to move it, or an end to resize it, snapping to the hour or the day; in a resource timeline, drag it to another row; on touch, a long press picks it up. From the keyboard, the arrows move a focused bar and Shift with them its end, Alt with ↑/↓ moves a booking to another row, Enter opens its details (`renderDetails`: a popover, or a drawer on a phone). Every change is announced politely. Controlled (`items` + `onItemsChange`) or not (`defaultItems`); `readOnly`, disabled items, `loading` and an empty state. Only the rows on screen are drawn, and a drag moves the bar without a render per frame. German messages are in `@zonsh/ui/messages/de`.
|
|
244
|
+
|
|
245
|
+
Sortable now shares its autoscroll, drag thresholds and announcer with the Scheduler (`lib/drag.ts`); it behaves as before.
|
|
246
|
+
|
|
247
|
+
- 0829c17: `Select` takes `native`: `"touch"` renders a `NativeSelect` — the platform's own picker — on a phone (a coarse primary pointer and a viewport under 768px) and the custom popup everywhere else; `true` renders it everywhere. Same API: `items`, `value`, `defaultValue`, `onValueChange`, `name`, `required`, `disabled`, inside a `Field`; size, width and `aria-*` come from the `SelectTrigger`, the placeholder from `SelectValue`, groups from grouped `items`. A `multiple` select, or one whose labels are elements, keeps the popup. Off by default.
|
|
248
|
+
- 0ec1bbe: A Shop block in the docs and the skill: product cards with a picture at a fixed ratio, a name, one line and a mono price; a product page with variant pickers, quantity and one "Add to cart"; a cart drawer with line items, delivery and totals; and a checkout with delivery or pickup, a pending submit and a confirmation. Prices are kept in minor units and formatted with `fromMinorUnits` and `Intl.NumberFormat`, with guidance on product photos. Composed from existing components; no new exports.
|
|
249
|
+
- df5fb9a: `SiteHeader` takes `pinned`: actions that stay in the bar at every width — a cart, the account, sign in. On a wide bar they sit after `actions`; on a phone, where `actions` move into the menu panel with the links, they stay in the bar beside the menu button (`data-slot="site-header-pinned"`). Before, the only way to keep a cart reachable on a phone was `menu={false}`, which dropped the links there. The docs say where `actions` go on a phone and show a shop with a pinned cart.
|
|
250
|
+
- 3b2021f: `Table`, `DataTable` and `CodeBlock` take `size="sm" | "default"`, the word every control uses for its small size. `size="sm"` on a table is the 30px rows `dense` gave; on a `CodeBlock` it is the one-row block (and `size="default"` keeps the header on one line). Each also writes `data-size`. `dense` is not kept: see the entry "Removed before 1.0".
|
|
251
|
+
- de9263d: `Skeleton` takes the room of what replaces it. A `text` line is now one line of the surrounding text tall (`1lh`), with the bar still painted at the font size (`1em`) in the middle of it, so a placeholder line and the line that replaces it are the same height and nothing shifts when the text arrives. Its height no longer beats yours: an `aspect-*` class or an `aspect-ratio` style now sizes it (before, `<Skeleton className="aspect-video" />` kept a 1em height and let the ratio shrink its width to a sliver), and any `h-*` or `size-*` is painted edge to edge as before. A text Skeleton renders a `<span>` (displayed as a block), so it fits inside a `<p>` or a heading — build placeholders from the content's own wrappers. New `lines` prop: `<Skeleton lines={3} className="text-[13px] leading-snug" />` stands in for a paragraph, the last line shorter.
|
|
252
|
+
|
|
253
|
+
A text Skeleton with no height of its own is now taller than before (the line, not the font size): if you spaced lines with `gap-*` to make up for that, drop the gap. The VideoPlayer's episode placeholders and the DataTable's loading rows now match their rows exactly. The Skeleton docs and the agent rules gain "a placeholder is the size of its content".
|
|
254
|
+
|
|
255
|
+
- 13a770a: Sortable: `SortableDropZone` is a place outside the lists that takes a dragged item — a bin, an archive. While an item is dragged with the pointer it has `data-active`, and `data-over` while the pointer is over it; released there, the lists are unchanged, its `onDrop(item)` is called, `onMoveEnd` reports the zone's id as `zone`, and the copy fades out. Coming over a zone and dropping on it are announced (new `overZone` and `droppedOn` messages, in the German pack too). `Sortable` takes `onDragMove`, called on every pointer move of a drag with the item, the pointer's position, where a release would land and the zone under it. `useSortable()` also returns `zone`. A drop zone takes pointer drops only; give the keyboard the same action on the item.
|
|
256
|
+
- 37ece5b: SortableDropZone: over a zone, the dragged copy glides into its middle and shrinks to fit inside it, following the zone as it grows. Give the zone a larger size under `data-over` to set how big the item shows there.
|
|
257
|
+
- a9bc88a: `Stat` takes `loading`: the label stays, placeholders stand in for the value and the change, and the Stat is `aria-busy` (read "Loading"). A `value` of `null` (or `NaN`) now shows "—", read as "No data", and writes `data-empty` on the value; before, it showed nothing. New words `messages.stat.loading` and `noData`, German in the pack. New States demo.
|
|
258
|
+
- 316e7f0: The stylesheet can be loaded in parts. `@zonsh/ui/styles/core.css` holds the tokens, the Licht faces, the materials and every component's styles except six parts, which are imported on their own: `styles/prose.css` (Prose, Code Block), `styles/ai.css` (Prompt Input, Reasoning, Response), `styles/graph.css`, `styles/pdf.css`, `styles/illustration.css` and `brand.css`. In place of scanning the whole package, `@zonsh/ui/sources/<component>.css` points Tailwind at the files one component is built from. A stylesheet with the core, prose and two components' sources is about a third of the full one. `styles.css` is unchanged: the core, every part and the whole package scanned.
|
|
259
|
+
- 13ddd39: `Suggestions` takes `disabled`, which disables every suggestion in the row — while a reply streams, say. They stay in place and focusable (`aria-disabled`), so the one just picked keeps the focus, and picking does nothing until the row is enabled again. The row writes `data-disabled`. New WhileStreaming demo.
|
|
260
|
+
- 407dc88: New utility `surface-page`: the page ground itself — `--background`, the faint light from above and the two grain layers, fixed to the viewport so they line up with the page's — for a bar content scrolls under, such as an app shell's sticky header. `bg-background` alone is the ground without its grain and light, and in dark mode reads as a visibly darker band; the Sidebar's App shell example used it and now uses `surface-page`, and the agent rules name it. The grain is drawn by `::before` and `::after`, so the element must be positioned (sticky, fixed or relative).
|
|
261
|
+
- 71191a4: **Breaking:** `TableCell`'s `align` is the library's own now, `"start" | "end"` as on `TableHead`, instead of the HTML attribute it fell through to (deprecated in HTML, and ignored by the cell's own classes). `end` sets the cell at the row's end without mono, in either direction; it defaults by `numeric`. In a `fit` table a column's alignment stays its `TableHead`'s.
|
|
262
|
+
**Migrate:** `align="right"` becomes `align="end"`, `align="left"` becomes `align="start"`, and `align="center"` becomes `className="text-center"`.
|
|
263
|
+
- 4ba9a19: Theme presets keep generated text readable on every ground it sits on, not only its own: body and secondary text on the page, raised surfaces, the hovered fill, menus and fields; captions on the page, menus and fields; the focus outline (3:1) and the status colours and tones on all of them. Before, a tinted or lifted ground could leave captions under 4.5:1 in a menu or a field, and secondary text on the hovered fill in dark (1,171 failing pairs over 932 presets across the settings and a spread of brand colours; now none, checked by a new unit test). `ThemeToken` gains `alsoOn`, the other grounds a token must read on.
|
|
264
|
+
Preset codes are new in this release, so no published code changes.
|
|
265
|
+
- aa197dd: New `themePresetFromColor(colour, { neutral?, corners?, density? })`: a whole theme from one brand colour and three plain choices, for people and agents who don't need the theme editor. The primary button, checked controls and focus outline take the colour's hue; `neutral` is `pure` (default), `warm`, `cool` or `tinted`, `corners` is `square`, `subtle`, `default` or `round`, and `density` is `compact`, `default` or `comfortable`. It is built with the editor's generator, so every text colour and the primary's label are kept readable in light and dark, and `encodeThemePreset` (from `@zonsh/ui/theme`) turns it into a preset code. `ThemeProvider`'s `preset` now takes a preset as well as a code: `<ThemeProvider preset={themePresetFromColor("#c2410c", { corners: "round" })}>`. `parseThemeColor` now reads any CSS colour: `rgb()`, `hsl()` and the CSS colour names as well as hex and `oklch()`.
|
|
266
|
+
|
|
267
|
+
The setup prompt, the skill and AGENTS.md now tell an agent to ask once, before building, how the product should look (zon's default, a brand colour with warm or cool greys and round or square corners, or a preset code), and how to apply each; one that can't ask chooses a theme that suits the product and says what it chose. Rule 1 says the primary takes the theme's colour, grey in zon's own.
|
|
268
|
+
|
|
269
|
+
- 4ba9a19: A theme as a file to commit and review: `theme.json`, the preset code with every token written out, one per line in a fixed order, with a format `version`. `themeFromPreset(…).json` writes it (the same bytes for the same theme, every time); `themeFromPreset`, `ThemeProvider` and `ThemeScope` take the file as it is, and a value edited by hand in it wins over the code's. The theme editor's JSON export is now this file (the `apply` selectors it carried are in the prompt). `themeFromPreset(…).css` groups the tokens under comments (Shape, Light, Dark; Canvas & ink, Primary …), one per line. New in `@zonsh/ui/theme`: `isThemeFile` and `THEME_FILE_VERSION`; in `@zonsh/ui`: the `ThemeFile` and `ThemeInput` types.
|
|
270
|
+
- ba43d76: Theme presets: a theme made in the theme editor is now a short code of letters and digits, such as `Z100CC8PWCHOK8M4`, and `themeFromPreset(code)` expands it into the token values for light and dark, the control heights and radii, and a stylesheet (`.css`) to put after `@import "@zonsh/ui/styles.css";`. It is plain code, so a server layout can render it in a `<style>`. `decodeThemePreset`, `encodeThemePreset`, `normalizeThemePreset` and `themePalette` read, write and generate presets, and the colour helpers the editor uses (`themeContrast`, `fixThemeContrast`, `parseThemeColor`, `formatThemeColor`) sit beside them, in the new entry `@zonsh/ui/theme`; `@zonsh/ui` keeps `themeFromPreset`. The format is versioned (`Z1…`), and a version 1 code expands to the same theme in every release.
|
|
271
|
+
|
|
272
|
+
The theme editor is a compact menu of settings beside a large preview. Each row opens its control in a popover: three seed colours (base, theme and accent) that can be picked or left to Shuffle, which stays near the colours you keep; corners in steps of 25% and the control height in steps of 4px (30 to 46). The preset code shows live, with Open preset to paste one. The preview has two pages: a ceramics studio's app in sixteen cards, and the system itself, every token, face and part; the card at the top of the view stays put when the shape changes. Finer sliders and per-token pinning stay under Advanced.
|
|
273
|
+
|
|
274
|
+
- 1423e1a: ThemeProvider takes a `preset`: `<ThemeProvider preset="Z1…">` applies a theme editor preset code to the whole app, putting `themeFromPreset(code).css` in a `<style>` at the end of `<head>` and taking it out when the code changes or the provider unmounts. A code that can't be read leaves zon's own theme and warns once in development.
|
|
275
|
+
- 4ba9a19: `ThemeScope` themes one area of a page: a preset's colours, density and corners, or only light or dark (`scheme`), on a `div` that takes the theme's ground and ink. Menus, selects, popovers, dialogs, drawers, tooltips, toasts and the tour opened inside it portal into an element it keeps at the end of `<body>` with the same theme; `usePortalContainer()` gives that element to popups of your own. `themeFromPreset(theme, { scope })` writes the stylesheet for a `data-theme-scope` area, and `themeScopeStyle(theme, "light" | "dark")` one scheme as an inline style.
|
|
276
|
+
- 16a64ce: New entry `@zonsh/ui/theme`: the theme engine the theme editor is built on — reading and writing preset codes, the generator, the colour and contrast helpers and the geometry tokens (`decodeThemePreset`, `encodeThemePreset`, `normalizeThemePreset`, `themePalette`, `themeShapeTokens`, `themeHeights`, `themeDensity`, `themeTokenGroups`, `zonThemePreset`, `zonThemeTokens`, `THEME_HEIGHTS`, `THEME_CORNERS` …). Plain code, so a server can run it. `@zonsh/ui` keeps what an app applies a theme with: `ThemeProvider`, `themeFromPreset`, `themePresetFromColor` and their types. With a `preset`, `ThemeProvider` now writes the preset's own ground to `<meta name="theme-color">` instead of zon's page tone, so a phone's bars match the themed page.
|
|
277
|
+
- 0c4fa3d: `Timeline` takes `loading` — three placeholder entries after the ones already there, the list `aria-busy` and read once as "Loading" — and `emptyMessage`, shown on the line when there are no entries ("Nothing has happened yet." by default). New words `messages.timeline.loading` and `empty`, German in the pack, and `labels` on `Timeline`. New States demo.
|
|
278
|
+
- fb6aad6: Tippy can be told where to look: `lookAt` (a point on the page, such as the caret in a field), `followPointer` (its eyes on the pointer when it is given nothing else) and `keystrokes` (each key taken with a little bob). Three new moves for beside a sign-in form, ported from the gallery: `watch` (it watches what is typed), `cover` (eyes squeezed shut while a password is shown, peeking now and then) and `away` (face turned away, whistling). Existing props and moves are unchanged.
|
|
279
|
+
- 71191a4: `ToggleGroup` takes `size`: `"sm"` is a 30px track holding 24px segments, beside the other `sm` controls of a dense screen; `"default"` is the 38px track it has always been. The group carries `data-size`.
|
|
280
|
+
- 4fc4536: Colour has one prop name: `tone`, as on `Meter` and `Progress`. `Alert` takes `tone` (`default`, `success`, `warning`, `info`, `destructive`) and writes `data-tone`. `Badge` takes `tone` for a status colour, beside `variant` for its look (`default` or `secondary`). `Tag` splits its look from its colour: `variant` is `default`, `muted` or `outline`, and `tone` is a status colour or a category tone (`blue` … `lime`); it writes `data-tone`. The colour values of `variant` are not kept: see the entry "Removed before 1.0". New shared types `StatusTone` and `CategoryTone`, and `AlertTone` and `TagTone`.
|
|
281
|
+
- 3d23339: Toolbar: `overflow` keeps the row on one line at any width — the buttons that don't fit move into a "…" menu at its end, with their names, shortcuts and toggled state. `ToolbarButton` takes `overflowPriority` (lower folds first; `false` never), `overflowLabel` and `overflowShortcut`. `variant="plain"` drops the surface for a row inside another one. The "…" button's name comes from `labels` or `messages.toolbar` (German included). MarkdownEditor's toolbar uses it.
|
|
282
|
+
- 46efa10: A `touch-target` utility (`material.css`) and a `--touch-target` token (44px): on a coarse pointer, an invisible `::before` widens a small control's tap to 44 × 44px, centred, with nothing drawn and the geometry unchanged. On a touch screen it makes the control `position: relative` and uses its `::before`. `Button` sizes `sm`, `icon` and `icon-sm`, `Checkbox`, `Radio`, `Switch`, the `Slider` thumb, the close button of `Dialog` and `Drawer`, `ToolbarButton`, `Pagination`'s buttons, `Calendar`'s month arrows and the remove buttons of `Combobox` and `TagsInput` chips take it; a chip's remover is clipped to its chip on a touch screen, so it never reaches into the next one.
|
|
283
|
+
- 0eedf0e: Fixes from apps built with the library:
|
|
284
|
+
|
|
285
|
+
- `ThemeToggle` takes `size`: `"default"` (36px) or `"sm"` (30px), to sit beside `size="sm"` buttons in a dense header.
|
|
286
|
+
- `AvatarGroup size="sm"` overlaps its avatars by 4px instead of 8px, so two initials stay readable; give the group the avatars' size.
|
|
287
|
+
- `ItemMedia` (default variant) sizes only icons to 20px: an SVG with its own `size-*`, `h-*` or `w-*` class — a product drawing, an illustration — keeps its size. `variant="image"` fills with an `<svg>` as it does with an `<img>`.
|
|
288
|
+
- A toast no longer covers an open `Drawer`'s actions: each open drawer's footer publishes how far it reaches up (`--drawer-footer-h` on the root) and the `Toaster` stack sits above it.
|
|
289
|
+
- A `fit` table no longer glides on its first paint: in its first half second, and until the fonts have loaded and drawn, a resize lands at once, so rows don't slide over each other while a phone's page settles its widths. New content or fonts no longer leave the next resize gliding from stale positions.
|
|
290
|
+
- `TableGroupHeader`'s `summary` sits at the row's end in a `fit` table too, as it does in a plain one.
|
|
291
|
+
|
|
292
|
+
- 21a5b87: `VideoPlayer` takes its words from a `LocaleProvider`, like every other component: its messages are `messages.videoPlayer`, typed `VideoPlayerMessages`, and the German pack (`@zonsh/ui/messages/de`) now includes them. `labels` still replaces any of them for one player. `VideoPlayerLabels` is not kept: see the entry "Removed before 1.0".
|
|
293
|
+
- 71191a4: `zonThemeScript()` from `@zonsh/ui/vite` takes `preset`, the same theme you give `ThemeProvider` (`themePresetFromColor(…)`, a code or a theme.json file). It writes the theme's stylesheet into `index.html` after the library's and sets `theme-color` to the theme's ground, so a Vite app with a brand colour paints in it from the first frame instead of zon's grey until the app runs. A theme it can't read stops the build with the reason. Import the preset from `@zonsh/ui/theme`, which the Vite config can load. The script itself now goes right after `<meta charset>` rather than before it (first in `<head>` when there is none).
|
|
294
|
+
- 794fce5: `zonThemeScript()` from `@zonsh/ui/vite`: a Vite plugin that puts the no-flash theme script first in `<head>` of `index.html`, so a plain Vite app gets the right scheme on its first paint without pasting anything. It takes the same `storageKey`, `defaultTheme` and `themeColor` options as `createThemeScript`. The Theme page also prints the script itself, written from the source, for pasting by hand, and the setup prompt and skill give the exact line for Vite and for Next.js.
|
|
295
|
+
- 83d0c9b: New `Wordmark`: your own product's lockup for the logo slots — your mark (an inline SVG, an `<img>` or an icon) and the product's name in Licht Light, spaced and sized like `Logo`, as a link with `href` or a router link with `render`. `Logo` and `LogoMark` are zon's own mark, and the docs now say so where they are used: the Sidebar app shells, the CRM, Dashboard, Sign-in and Onboarding blocks and the SiteHeader's app example show a placeholder brand, "Acme", with a note to replace it, and the agent rules gain a twelfth: never ship zon's mark in someone else's product.
|
|
296
|
+
|
|
297
|
+
### Patch Changes
|
|
298
|
+
|
|
299
|
+
- 0829c17: Agent docs: rule 5 now says few cards — page sections, forms, pricing, settings and sign-in on a page are hairline sections, divided lists and regions, not cards; a new rule 10 puts short lists on phones in the native picker (`Select native="touch"` or `NativeSelect`). A new guide, `marketing.md`, captures how a marketing page opens (hero) and ends (night footer) — in the skill, at `/ui/marketing.md` and in llms.txt.
|
|
300
|
+
- a50fb83: Narrow-screen and touch fixes from the browser audit: an `Alert` under 26rem wide puts its `AlertAction` on a row of its own under the description instead of squeezing the copy into a narrow column; a user `MessageText` card stays inside the message's 80% (a voice note in it ran off the screen); an empty `DataTable` whose columns scroll sideways centres its message in the visible part instead of in the full width of the columns; a fitting `Table` or `DataTable` whose first column sizes to its content (a selection checkbox) keeps the padding at the end of its rows on a narrow screen instead of running its last column into the card's edge; and the dense (`sm`) `NativeSelect`, `Combobox` and `NumberField` take 16px text on a touch screen, like `Input` and `InputGroup`, so iOS no longer zooms in when one is focused (the Calendar's month and year menus included).
|
|
301
|
+
- f39485b: Touch and narrow-screen fixes from the browser audit (empty … prompt-input):
|
|
302
|
+
|
|
303
|
+
- `MenuShortcut` (and so `ContextMenuShortcut` and `MenubarShortcut`) is hidden on a touch-only phone or tablet when its keys are written as text too, not only with `keys`: no key can be pressed there.
|
|
304
|
+
- `CommandInput`'s `Esc` close button is a round × on a touch-only phone or tablet, and the default `CommandFooter` ("↑↓ navigate · ↵ open") is left out there. A footer with your own children stays.
|
|
305
|
+
- `CodeBlock` without a header keeps the floating copy button's corner to itself: a long first line is cut before the button and scrolls past beside it instead of under it.
|
|
306
|
+
- `Graph` in a frame under 480px wide, as on a phone: a flow without a `direction` reads down instead of being a thin strip cut off at both ends, the minimap is left out (it covered the controls), and "fit" leaves room for the controls at the bottom so a tall graph no longer ends under them.
|
|
307
|
+
- `MarkdownEditor`'s toolbar no longer sets the field's minimum width: in a grid column on a phone the editor took the width of every command and ran off the screen; it now takes its column and folds its commands as it does elsewhere.
|
|
308
|
+
- `Pagination` keeps to one line on a phone: where the row would not fit its container, the current page shows without neighbours (1 … 4 … 12) and the gap tightens, instead of Next and the last pages wrapping onto a second line.
|
|
309
|
+
- `ComboboxContent` is never taller than the room on its side: with a search field above the list, as in `PhoneInput`'s country picker, the popup flipped above the field on a phone ran 9px off the top of the screen, cutting the search field; now the list gives up the height.
|
|
310
|
+
|
|
311
|
+
- cb8983b: TimeField: a dense (`size="sm"`) field sets its segments at 16px on a touch screen, so iOS Safari does not zoom in when one is focused; still 30px tall.
|
|
312
|
+
|
|
313
|
+
Sources: the site column is at most 28% of the row (still 8rem where there is room), so on a phone a source's title is no longer cut to a few words beside a mostly empty site column.
|
|
314
|
+
|
|
315
|
+
- 5e66ff1: The Hero and Footer blocks are no longer in the docs or the skill; `AsciiField`'s doc no longer shows a `Hero` component that the package never exported.
|
|
316
|
+
- f329e80: BottomNav: the capsule takes the width it has, up to 28rem, and shares it evenly between its items; the current item's pill is as wide as its share.
|
|
317
|
+
- 60f894a: ButtonGroup: an icon button (`size="icon"` or `"icon-sm"`) now joins as a square segment — the height of its row and the buttons' corners on its outer end. It used to keep its own shape, a circle 2px under the control height, so it sat short of its neighbours with a round end.
|
|
318
|
+
- 0829c17: `Button` and `Toggle`: the label's line height is now fixed to its font size at every size. A size class dropped the button's `leading-none` when classes merged, so the label took Tailwind's 20px or whatever its parent set — in a short control (the theme editor's 22px dense height) that line was taller than the button, which grew past its height and set a leading icon and the label on different pixels.
|
|
319
|
+
- 9333562: Control height reaches further: an Item's padding follows it, so an item with a description grows with the controls instead of only one without; the round icon button's size is derived from `--control-h` (2px under it), so setting the three heights alone resizes it too; and BottomNav's bar works its height out where it sits.
|
|
320
|
+
- 0829c17: `Conversation`: opening a `Reasoning` or `Sources` disclosure (or a reply streaming in) no longer shifts the messages sideways. Where scrollbars take room (Windows, Linux, a mouse on macOS), the bar that appeared once the messages outgrew the view narrowed them by its width; the scroller now keeps its room on both sides from the start (`scrollbar-gutter: stable both-edges`), so messages stay centred over the prompt.
|
|
321
|
+
- 39a9ac2: `DataTable` with `fetchRows`: when the server fails before its first answer, the body says it couldn't load the rows and offers "Try again", in place of placeholder rows that waited for ever; a later failure still shows in the footer and keeps the rows. New ServerError demo.
|
|
322
|
+
- ab21d69: Density, tuned for dense and roomy themes. Inside the components, padding, gaps and icons now scale by `--space`: the density in a dense theme, and only as fast as the type above zon's 38px (1.1 spacious, not 1.21), so a spacious theme is taller rather than padded out; a card's padding (`surface-card`) follows it too, tighter in a dense theme. A part inside a field's 3px inset is `--control-inset` tall at every density: ToggleGroup segments, segmented Tabs, TagsInput and Combobox chips and their inputs no longer push a 30px dense field to 32px. The Sidebar's width follows the type (16rem at the default density, about 14.3rem dense, 17.7rem spacious), Textarea's 140px minimum follows the density (110px dense), a small Avatar's initials follow it, and the Scheduler measures its rows again when the theme changes while it is open. The block and app-shell examples set their type in the density sizes (`text-13`), not fixed px.
|
|
323
|
+
- c9411ef: Docs: the common case first, and shorter. Graph, Illustration, Input Group, Input, Item, Kanban, Kbd, Label, Layout, Lightbox, Locale, Logo, Markdown Editor, Mentions, Menu, Menubar, Message, Meter, Money Input, Native Select, Navigation Menu, Number Field, OTP Field, Pagination, PDF Viewer, Phone Input, Popover, Preview Card, Progress, Prompt Input, Quote, Radio Group, Rating, Reasoning, Resizable, Response, Scheduler, Scroll Area, Select and Separator now open with their usage and the props people reach for, with about a third less prose; props tables, keyboard tables and accessibility notes are kept whole.
|
|
324
|
+
- d755f86: Docs: the pages from Settings to Video Player, and the Chat, Contact form, CRM, Dashboard, Onboarding and Pricing blocks, now open on the common case — the base example, one lead paragraph, then Usage with a short example and the three props people use most — with the rest further down and about a third less prose. Every prop, keyboard table, accessibility note and brand rule is kept.
|
|
325
|
+
- 7ba75c2: Docs: the common case first, and shorter. Thirty-eight component pages (Accordion through Form) now open with the most common usage and the props people reach for, with variants, edge cases and API detail further down, and about a third less prose.
|
|
326
|
+
- a64644c: Agent docs: every example now runs as copied. An example used to show only its own function, so the blocks and app shells named helpers they never defined — `SettingsSection` and `useDraft` in Settings, `useCurrentPage` and `CollapseHint` in Sidebar, the frames and sample data of Sign-in, Onboarding, CRM and the rest. Each example now brings the helpers, hooks, sample data and types of its module that it uses, and the imports they need; on a page, a helper several examples share is printed once, with the first. The short layout sketches under Usage say where their helpers are written out, and the Filter Bar sketch defines its row type. The docs site's code view shows the same complete code.
|
|
327
|
+
- e3cd8ae: Docs: a new Recipes guide — fourteen task-shaped recipes, each a goal, complete code using only `@zonsh/ui` exports and a few notes on the choices: a form with server validation, a filtered table with the URL as state, a settings page with save state, a KPI row with sparklines, confirm before delete, async search in a combobox, a command palette wired to routes, a theme from a brand colour, a dense app shell, toasts for async work, a file upload with progress, an AI chat with a streaming reply, a Kanban board and a room booking scheduler. In the skill (`references/recipes.md`), at `/ui/recipes.md`, in llms.txt and on the docs site at `/recipes`. The code of each recipe is a typechecked file, so the docs can't drift from the API.
|
|
328
|
+
- 9e24e75: Conversation: follows a streaming reply, and lets go when the reader scrolls away, in WebKit on a busy page. It now also follows the changes to the messages that make the reply grow, where WebKit's ResizeObserver could stop reporting them and the reply streamed on below the view. A view that layout moves up by a few pixels (a panel folding while the reply grows) no longer reads as the reader scrolling away, unless they are holding the scrollbar. A jump up whose scroll event comes after the next frame, or after a change to the content, still lets go instead of being carried back down by the glide.
|
|
329
|
+
- 9e24e75: Tour: a guide's speech bubble now always measures the step it is for. Moving to the next step, the bubble could be placed with the new step's side against the guide's last spot and stay there — in WebKit, under reduced motion, where nothing moves afterwards to place it again.
|
|
330
|
+
- e35a9cf: A gliding indicator whose bar was hidden (BottomNav from md up, then the window narrowed to a phone) appears in place when the bar shows again, instead of growing from a small pill at the left edge. The package now ships CHANGELOG.md, so the migration notes are in node_modules too.
|
|
331
|
+
- cb8983b: Graph: on a touch-only device the page scrolls past a graph again. One finger scrolls the page, two fingers pan and pinch the graph, as on a map, and a one-finger drag over it shows a short hint, "Use two fingers to move the graph" (`labels.touchHint`, German included). In an `editable` graph one finger still drags a node and draws a connection from its handle; a read-only graph's nodes do not drag there. The frame takes `data-touch` on such a device.
|
|
332
|
+
- 8752ceb: The honest-copy rule in the skill, AGENTS.md, the brand guide and the marketing guide says what it covers: it forbids inventing quotes, ratings, logos and figures, and keeps the ones the owner supplies or the project already has, as they are. Claims an agent cannot know, such as features, data handling, prices or delivery, go in as marked placeholders for the owner to confirm, never as fact.
|
|
333
|
+
- f93faf4: The components take their icons from one internal module instead of importing `lucide-react` in every file, so the icon set can change in one place later. Nothing changes for apps: `lucide-react` is still the peer dependency, and the icons are the same.
|
|
334
|
+
- 60f894a: Kanban block: the drop target for lost deals is now "Mark as lost", like the card's menu — a wider, 64px target while a card is dragged that grows only a little under the card, never past its size; a drop on it is read out as "… marked as lost."
|
|
335
|
+
- 2513e41: Docs: every interactive component now has a Keyboard table (Key | What it does) under Accessibility — menus, Select, Combobox, Command, Tabs, ToggleGroup, Toolbar, Accordion, Dialog, Drawer, Popover, Tooltip, Slider, Radio, Checkbox, Switch, NumberField, OTP, the date and time fields, Calendar, Tree, Table, DataTable, Sortable, Kanban, Carousel, Lightbox, Tour, Resizable, Graph and more — each key taken from the source and Base UI. Checkbox, Radio and Slider say how the label carries the touch target, Message when its actions show, Code Highlight how colour loads; ContextMenu, Conversation, Sources, Suggestions and Toolbar have more examples. A unit test keeps the Keyboard section on every interactive doc.
|
|
336
|
+
- 3a2fe34: Keyboard gaps the Keyboard tables found, fixed and documented:
|
|
337
|
+
|
|
338
|
+
- `Carousel` and `Rating` read the direction from the page, so the arrows swap under `dir="rtl"` without a `DirectionProvider` (and the carousel's slides run that way too).
|
|
339
|
+
- `Rating`: ↑ raises the score and ↓ lowers it, in either direction; it stays a radio group for screen readers.
|
|
340
|
+
- `ColorPicker`: Shift+arrow and Page Up / Page Down step opacity by 10%.
|
|
341
|
+
- `NumberField`: Page Up / Page Down step by `largeStep`, and Enter puts the typed number in (parsed and clamped) with the focus kept.
|
|
342
|
+
- `DataTable`: Shift+Enter or Shift+Space on a header adds it to the sort, and Shift+Space on a row's checkbox ticks a range, as Shift-click does.
|
|
343
|
+
- `Lightbox`: zoomed in, the arrows look around the image; Shift+← / → still change it.
|
|
344
|
+
- `Graph`: without `editable` the arrows never move a node; the arrows pan the view (Shift for further) unless they move a selected node in an editable graph, and + / − zoom; Enter opens a connection's label as it does a node's; a node's menu has Connect to, so nodes can be connected from the keyboard. `GraphMessages` has a new `connectTo` text ("Verbinden mit" in the German pack).
|
|
345
|
+
- `Tour`: ← / → are left to splitters, carousels, a lifted `Sortable` item and `contenteditable="plaintext-only"`.
|
|
346
|
+
- `PromptInput`: Escape in the prompt stops a reply on its way, as the stop button does.
|
|
347
|
+
- `ContextMenu`: opened from the keyboard (the context-menu key, Shift+F10), the menu appears under the focused element instead of where the browser puts the point.
|
|
348
|
+
|
|
349
|
+
- bfe8241: Labels keep their descenders: a button label that slides in or out clips across only, and the truncated mono line under a Graph node and the file name in the Lightbox take a normal line height, so a "g" or a "y" is no longer cut at the bottom.
|
|
350
|
+
- 6325477: Text no longer jumps when the Licht faces arrive. Each family now falls back first to a system face sized to it — "Licht Fallback" (Times New Roman), "Licht Sans Fallback" (Arial) and "Licht Mono Fallback" (Courier New), or their Liberation twins on Linux — with `size-adjust`, `ascent-override`, `descent-override` and `line-gap-override` matched to Licht's width and vertical metrics, so lines keep their length and height through the swap. `--font-heading`, `--font-body` and `--font-mono` name them after the Licht face; where none of those system faces is installed the stack goes on as before.
|
|
351
|
+
- a26fbe0: The Licht fonts now come from `licht` (the same files and `@font-face` rules as `@zonsh/fonts`, which npm marks as moved to `licht`), so installing no longer warns about a deprecated package. Nothing to change in an app: `@import "@zonsh/ui/styles.css"` brings them as before.
|
|
352
|
+
- a60b250: The MCP server is gone: `@zonsh/ui-mcp` is no longer released with the library. The Claude skill inside the package, llms.txt and each component's page as Markdown carry the same docs. The skill and the README no longer point to the server, and where they named its `theme_from_preset` tool, `themeFromPreset(code).css` from `@zonsh/ui` gives the same CSS.
|
|
353
|
+
- ea2cebb: The motion guide (`docs/motion.md`, the skill's `references/motion.md`) now describes the motion as the code has it: the duration factors in use, each kind of motion (state changes, popups, drawers and toasts, gliding indicators, heights, drag, springs, streaming text, loading, arrival, decoration) with its rule, the distances, what reduced motion does for each, what holds still on a phone, a checklist for a new part, and Do / Don't pairs. The docs site shows it at `/ui/motion`, beside the brand guide.
|
|
354
|
+
- 5c3a9b9: Motion follows its own guide (docs/motion.md) everywhere:
|
|
355
|
+
|
|
356
|
+
- Colour and opacity fade on `--duration-fade` across the library — modal backdrops (now leaving in 0.7 of the fade), Lightbox, VideoPlayer's controls, the Menubar surface, Collapsible, Toolbar, Toggle, Switch, Checkbox, Calendar, Graph, links in Response and many triggers' icons — so under reduced motion they fade instead of snapping. The PDF viewer's search bar and the compact Logo's name keep their fade under reduced motion, and a loading toast's ring pulses instead of standing still.
|
|
357
|
+
- New tokens: `--ease-pop` (an overshoot for small marks), `--ease-in` (something leaving unwatched) and `--duration-settle` (decoration's 700ms settle). Hand-typed times and curves in BottomNav, Stepper, Toolbar, Tour, VideoPlayer, Response, Tippy, InputGroup, the illustrations and the blueprint grid now use the tokens.
|
|
358
|
+
- The Menubar surface, the NavigationMenu panel, the OTP ring, the Tour's popover and spotlight and a menu's radio dot glide at the one glide speed (`--duration-glide` on `--ease-glide`).
|
|
359
|
+
- Toasts leave in 0.7 of their arrival. BottomNav's icon springs back within 300ms, and BottomNavAction's focus outline sits at offset 0. Lightbox thumbnails lift 2% over `--duration`, only under a fine pointer.
|
|
360
|
+
- Scripted motion reads the tokens (internal `cssTime()` and `cssEase()` beside `cssDuration()`); NumberField's held-key check now reads `--duration` in either unit. `ease-brand` stays as an alias of `ease-(--ease)`, which the library now uses throughout.
|
|
361
|
+
|
|
362
|
+
- 68aa7a3: `NumberRoll` keeps rolling when the value changes fast. A new value that comes mid-roll used to swap in place, so quick clicks stopped the motion; now each digit rolls on from where it is to the new value — the characters in view stay, the new one joins on the side the value moves to — and lands exactly on the last value, never snapping or starting over. The text stays the exact value throughout, and reduced motion still puts it in place at once.
|
|
363
|
+
|
|
364
|
+
`NumberField` draws its steps with the same engine: the roll is drawn over the input while it moves, and the input, with its caret and selection, shows again once the digits land. A held arrow key or stepper and a fast wheel now keep the digits rolling instead of changing in place after the first step. Typing, pasting and scrubbing still show at once.
|
|
365
|
+
|
|
366
|
+
- 791cdf3: One rule for primary buttons everywhere: one primary per view, read as a screenful on a long page. The marketing guide no longer says "one per page"; the main action is primary where the reader acts on it, the same action asked again elsewhere is secondary, and a section that is its own task (the Pricing plans, a contact form) keeps its one primary a screenful away from the others. The Pricing and Contact form blocks say the same.
|
|
367
|
+
- 3e04c3e: OtpField keeps every digit of a code typed quickly. Its focus ring now keeps its own state, so moving it from slot to slot no longer renders the slots again: when the ring's move was still pending and the page updated during the next keystroke (a listener of its own above the field, as the sign-in demo's Tippy has), the slot was rendered with its old value before Base UI read the new character, and the digit was lost. The root still carries `data-glide` while the ring is shown.
|
|
368
|
+
- a62bc17: `ActionSheet`: the choices run edge to edge across their card, with nothing inset, so a choice's highlight fills the card's width and follows its 20px corners at the top and bottom (square where two choices meet). The Cancel card is now the button itself, not a button inside a card: its highlight and focus ring take the card's own shape.
|
|
369
|
+
|
|
370
|
+
The phone parts give a little under the finger. `AppBar`'s buttons, `ActionSheet`'s choices (their whole card) and Cancel, `SwipeActions` rows and tiles, `BottomNav` items and `PullToRefresh`'s button shrink as they are pressed, to 97% for a small target and 98.5% for a row or card, and spring back when let go. Scale only, written once in the shared press feedback; none under reduced motion. `data-press-group` on a card shrinks the card for a press on any choice in it, and `--press-scale: 1` turns it off for a part with a press scale of its own.
|
|
371
|
+
|
|
372
|
+
`SwipeActions`: a full swipe runs an action only on a side with a single action. With two or more on a side — Archive and Delete — a swipe of any length only opens the row and you tap the one you want, so a long swipe meant to show Archive never deletes. Was: three or more.
|
|
373
|
+
|
|
374
|
+
`BottomNav`: letting go of the lens no longer locks in. One spring, from where the lens is and how fast it moves, carries it onto the item, shrinks it and sets down its lift together, with no dip below its size on the way; its lift is drawn from its size each frame rather than on a separate transition. Let go while moving, it chooses the item the finger was heading for.
|
|
375
|
+
|
|
376
|
+
- 64e6971: Pricing block: the recommended plan stands apart in dark mode too. `theme-dark` alone changes nothing on a dark page, and the lift meant for it lost to the theme's own tokens, so the card looked like the others; it now takes a lighter ground and a brighter edge there. The Usage snippet carries the same class.
|
|
377
|
+
- fd3ecd6: The primary button's edges follow its fill. With a theme's own coloured `--primary-fill`, the outer line (light) and the highlight and inner rim (dark) take the fill's hue instead of a grey or white ring; zon's grey primary looks the same as before. Browsers without relative colours keep the previous edges.
|
|
378
|
+
- d6383f3: Docs: Drawer explains that `DrawerContent` pads, spaces and scrolls its children itself, so there is no `DrawerBody` and no padding to add.
|
|
379
|
+
- d6383f3: Docs: Empty has an Error page example — a 404, 403 or 500 page built from `Empty`, with the code in a mono eyebrow, the title as the page's `h1`, "Go back" and "Back to home".
|
|
380
|
+
- d6383f3: Docs: Item no longer points to an `IndexedList` that doesn't exist; site navigation is `Sidebar` or `NavigationMenu`, and numbered lists are `FeatureList`.
|
|
381
|
+
- d6383f3: Docs: Select says that `SelectTrigger` is full width and at least 10rem wide (`min-w-40`), and how to make a narrow one (`className="w-20 min-w-0"`).
|
|
382
|
+
- d6383f3: Docs: Data Table shows how to render a TanStack Table v8 table (or any other) with the `Table` parts — a checkbox selection column with an indeterminate header, `data-selected` rows and sortable headers with `aria-sort` — since `DataTable` itself needs v9.
|
|
383
|
+
- 6325477: Rating on touch screens: a finger can slide along the row — the stars follow it and the rating is set where it lifts — so a half star (12px wide) is picked without a precise tap; a vertical swipe still scrolls the page. A dense `sm` rating spaces its stars 4px apart on a coarse pointer, so each is a 24px target; the stars keep their size. Each radio carries its value as `data-choice`.
|
|
384
|
+
- 7ce626a: README: the versioning promise is written out instead of linking to a page that is not public.
|
|
385
|
+
- cdc35f5: Reasoning: opened or closed by hand in the second after thinking ends, it stays as the reader left it. The panel used to fold itself anyway when that second was up.
|
|
386
|
+
- a2faf58: The assistant has no face: `Message` docs, the Chat block and the Conversation, Message and AudioPlayer demos no longer put a `LogoMark` avatar beside the assistant's reply, which now runs plain across the full width. `Message` never added a mark or an indent of its own, so nothing changes in the component; `MessageAvatar` stays exported, now documented as rarely needed. Button docs show `bare` in the variant, icon-only and state examples instead of a tab of its own. The Kanban block's Lost target takes no room until a card is dragged — a small pill at the board's corner that grows under the card — and the lost deals sit behind a count in the board's header with Put back for one or all. The Contact form block drops its Compact example (the main layout already stacks in a narrow container), and Onboarding's "On the page" layout is centred.
|
|
387
|
+
- 6c0f80e: The skill and AGENTS.md install `lucide-react` beside the library (`pnpm add @zonsh/ui lucide-react`), as the setup prompt and Get started do again; the setup prompt also says to replace a Vite template's own `src/index.css`, and to keep the release-age exclusion pnpm 11 may add for `licht`.
|
|
388
|
+
- 13567c5: Shop block, redesigned as an editorial shop: the grid is photos in 20px frames with names in Licht and prices in mono under them (no boxed cards), with a category filter; the product page has a gallery that opens in the Lightbox, glaze swatches and sizes as toggle groups, and details, care and terms in an accordion; the cart drawer has photo lines, a free-delivery track and its total pinned to the bottom; checkout is one numbered page with the order beside it (first on a phone), a sticky total on a phone, and a confirmation that says what happens next and empties the cart. Drawn studio pictures stand in for photos as ordinary image URLs. The marketing guide's "Products to buy" pattern follows.
|
|
389
|
+
- 0829c17: `SidebarItem`: in the icon rail only the icon shows. The label started exactly on the row's clip edge, so a glyph's overhang or a fractional pixel ratio leaked it in as small specks beside the icon (next to "Contacts" in the CRM block); in the rail the gap after the icon now grows to a whole row, so the label and any trailing `Kbd` or `Tag` start well past the edge.
|
|
390
|
+
- c364d59: SiteHeader: a link in a dropdown panel closes the panel when it is clicked, as a link in the phone panel already did. With a router link (`render`), the panel no longer stays open over the page it went to.
|
|
391
|
+
- 71191a4: `SiteHeader`'s phone panel, opened by a tap or a click, focuses the panel itself instead of the logo, which opened with a focus outline round it. Opened from the keyboard, focus still goes to the first link.
|
|
392
|
+
- 9fcddc1: The Claude skill ships inside the package at `dist/skills/zon-ui`, at the version it describes: `cp -r node_modules/@zonsh/ui/dist/skills/zon-ui .claude/skills/`.
|
|
393
|
+
- 6deab2d: The bundled skill says Licht comes in one weight, Light, instead of "weight 300 only".
|
|
394
|
+
- f6ba663: States demos where they were missing: `ColorPicker` and `FileDrop` (invalid with a `FieldError`, disabled); a Disabled demo for `Accordion`, `Tabs` and `Collapsible`; and a Pending demo for `AlertDialog` — the confirm `loading`, the dialog held open while it runs and on failure, closed on success.
|
|
395
|
+
|
|
396
|
+
An Empty demo for the plain `Table`: the column heads stay, and one row across every column holds an `Empty`.
|
|
397
|
+
|
|
398
|
+
- cd08b7e: Table `fit` is faster on long tables. A table that isn't virtual measures at most 48 rows (the header, the rows with the longest text in each column and title, and the first 8) instead of a laid-out clone of every row. Shown again at the same width with the same content, as a page kept alive in an `<Activity>` is, it doesn't measure at all. When the columns step, only rows within a view's height of the view glide, and the rest move at once. The Sidebar's hidden scrollbar no longer comes from a `:has()` rule that every element was checked against on every style change. It covers the Sidebar, its shell and its sheet. If you wrap a Sidebar in a scrolling element of your own, use `ScrollArea scrollbar={false}`, or hide that element's scrollbar yourself.
|
|
399
|
+
- 421a1b0: Tag: an icon sits on the same centre as the mono label (it was a pixel low).
|
|
400
|
+
- 281bf8a: `Textarea` keeps its corners at 10px or less, so on a rounder theme the browser's resize handle stays inside the box.
|
|
401
|
+
- 281bf8a: Theme editor: a Brown family for the base and theme colours. It is orange made dark and quiet, a primary for wood, leather or coffee with warm greys.
|
|
402
|
+
The preview's System page shows the bottom nav, as a capsule and as a bar.
|
|
403
|
+
- 7ef8b39: Theme editor: the three seeds are named for what they colour (Greys, Primary and Categories), no longer Base, Theme and Accent.
|
|
404
|
+
- aa41a6d: Theme presets: corners scale as nested radii. The Corners step now scales the button's 12px, and the other radii keep zon's offsets from it — controls 2px less, items 5px less, checkboxes 7px less, cards 8px more — so a card stays in proportion with the buttons inside it. At 100% the radii are zon's own (12 / 10 / 7 / 5 / 20); at 0% every radius is 0, cards included. Preset codes are unchanged: the same step now means this.
|
|
405
|
+
- ffae3df: ToggleGroup: each segment is as wide as its label, not an equal share of the track. "Grid / Table / Split" no longer pads the short labels out to the longest one. A track that fills its row still shares the spare width out evenly.
|
|
406
|
+
- 71191a4: Docs and skill, from apps built on the package alone:
|
|
407
|
+
|
|
408
|
+
- Where a form sits agrees everywhere: on the page under hairlines when it is part of a page, a card only when it is the whole screen on its own (`form.md`, rule 5).
|
|
409
|
+
- `SiteHeader`'s `actions` hold at most one `secondary` or `ghost` call to action, never the primary, as the marketing guide says.
|
|
410
|
+
- The marketing guide names `Wordmark` for your own mark, its waitlist sketch uses `Form` with server errors and `Button loading`, and its split hero lines up with `Container`. Marked placeholders have a look — `<Mono className="text-warning">[To confirm: …]</Mono>` — and the honest-copy rule says which facts need one.
|
|
411
|
+
- Theme: pick a primary away from the status colours and category tones; a Vite theme's no-flash path; a Printing section (light paper, `text-foreground` on a `.theme-light` part, `print:hidden`).
|
|
412
|
+
- Agent docs import a name a demo only spreads (`{...chartAnimation}` in the Dashboard and Chart examples).
|
|
413
|
+
- The Dashboard block's section titles are `Heading level={4} as="h3"`, and its panel grid keeps a phone column at `minmax(0,1fr)`; the Shop block's name is a `Wordmark` and its delivery and pickup rows reach the end of the form, so the price sits at the row's end. `TwoTone`'s first example is in mixed case.
|
|
414
|
+
- `Tag` says it has no `size` and no `render`; `Table` says what a dense theme does to `size="sm"`; `Layout` names `py-(--section-pad)`; the README explains the font files in a build and Vite's 500 kB warning.
|
|
415
|
+
|
|
416
|
+
- 794fce5: The skill, AGENTS.md and Get started say how to move an older app up before adding zon/ui: Tailwind CSS 3 to 4 with `npx @tailwindcss/upgrade`, React 18 and Next.js 14 together with the Next.js upgrade codemod, packages that pin React 18, lucide-react 1.x without brand icons, and what to remove when replacing shadcn/ui and Radix (including its colour variables, which share zon's token names).
|
|
417
|
+
- 2cca6c5: VideoPlayer's movie layout no longer lays subtitles, the skip button and the middle play button over each other on a phone. Below a 576px frame they stack: the skip takes the small size just above the controls (or low in the frame when they step back), the subtitle sits above it, the middle button gives its place to them while subtitles are on or a skip is offered (play and pause stay in the bar), and a line of subtitles hides the title while it shows. On a wider frame a subtitle on the skip's row is narrowed on both sides to stay centred and clear of the button; a 768px frame and up looks as before unless the two would have met.
|
|
418
|
+
- 281bf8a: `Wordmark` centres the product's name on its capital height, so a name like "Acme" sits level with the mark beside it.
|
|
419
|
+
- 7112fc9: Text at 200% and forced colours, now checked on every base demo:
|
|
420
|
+
|
|
421
|
+
- Large text: `Badge` grows with its count (`max(--badge-h, 1.5em)`), `Sidebar` group labels keep their whole line and end in "…", `Table` rows keep their lines apart (never under 1.5 times the type), the `Scheduler`'s day labels end in "…", and the `Spinner`'s text faces follow its size, not the type.
|
|
422
|
+
- Forced colours: keyboard focus on a text field (`Input`, `Textarea`, an input group, a number, tags or OTP field, the editors), a `Resizable` handle and the `Scheduler`'s list edge shows as a `Highlight` outline; a focused `Graph` connection is drawn in `Highlight`.
|
|
423
|
+
- `Scheduler`: keyboard focus on a bar now shows its ring (it was set without an outline style).
|
|
424
|
+
|
|
425
|
+
## 0.5.0
|
|
426
|
+
|
|
427
|
+
### Minor Changes
|
|
428
|
+
|
|
429
|
+
- 25366e2: Motion, reworked after Emil Kowalski's skills for designers and engineers (MIT; the web ones are copied into the repository's `.claude/skills/`). The guide is `docs/motion.md`: in the zon-ui skill as `references/motion.md`, on the site as `/ui/motion.md`, and from the MCP server as the new `get_motion_guide` tool.
|
|
430
|
+
|
|
431
|
+
- **New tokens:**
|
|
432
|
+
- `--ease-glide`, for gliding indicators, opening heights and anything that follows the pointer.
|
|
433
|
+
- `--ease-move`, for moves the interface makes on its own and for loops.
|
|
434
|
+
- `--duration-glide` (240ms) and `--duration-exit` (105ms).
|
|
435
|
+
- `--duration-fade` (150ms), which reduced motion keeps.
|
|
436
|
+
- **Reduced motion means less movement, not no change.** Movement still stops, but fades and colour changes stay:
|
|
437
|
+
- Popups, drawers and toasts fade in place instead of popping.
|
|
438
|
+
- Spinners, skeletons and indeterminate progress pulse gently instead of standing still. Text never pulses: its contrast would dip below what can be read.
|
|
439
|
+
- **Nothing the keyboard does animates:**
|
|
440
|
+
- The command palette opens and closes at once, and its highlight is instant.
|
|
441
|
+
- The Tree's folds jump on a key.
|
|
442
|
+
- NumberField and TimeField still roll their digits for a key, the wheel or a stepper: they show what changed. A held key or stepper now counts in place after the first roll instead of restarting it on every repeat.
|
|
443
|
+
- The Sidebar's ⌘B folds at once.
|
|
444
|
+
- An expandable Button opens at once on keyboard focus.
|
|
445
|
+
- A keyboard clear in InputGroup is instant.
|
|
446
|
+
- **One speed and one curve for every gliding indicator:** Tabs, ToggleGroup, Pagination, Sidebar, BottomNav, Menubar and NavigationMenu, all on `--duration-glide` and `--ease-glide`.
|
|
447
|
+
- **Leaving is quicker than arriving:** popups leave in 0.7 of their arrival, and a drawer closed by a button or Escape closes in 0.7.
|
|
448
|
+
- **Presses show.** Rows and BottomNav items answer pointer-down in the material.
|
|
449
|
+
- **New `chartAnimation` export.** Spread it on a chart's series so a data change settles in 300ms, not Recharts' 1.5s.
|
|
450
|
+
- **Smaller things:**
|
|
451
|
+
- The theme flips in one frame.
|
|
452
|
+
- The Switch thumb travels by transform.
|
|
453
|
+
- Popovers, the Lightbox's pinch zoom and the Graph's zoom keep up with the input, and the Graph's zoom respects reduced motion.
|
|
454
|
+
- The skeleton's sweep no longer repaints.
|
|
455
|
+
- Table fit and Graph tidy move on `--ease-move` within 300ms, and the Tour's spotlight rests when the tour does.
|
|
456
|
+
- PromptInput's send, spinner and stop faces, and ToolCall's status icon, cross-fade.
|
|
457
|
+
- Sortable lifts what it picks up, and autoscrolls at the same speed at any refresh rate.
|
|
458
|
+
- The Blueprint and SpecSheet lights ease toward the pointer.
|
|
459
|
+
- The page grain is still on phones.
|
|
460
|
+
- Message actions show on touch screens.
|
|
461
|
+
- Small inputs are 16px on touch screens, so iOS no longer zooms on focus.
|
|
462
|
+
- Toolbars share one tooltip delay.
|
|
463
|
+
|
|
464
|
+
### Patch Changes
|
|
465
|
+
|
|
466
|
+
- 25366e2: Tabs: switching tabs no longer makes the page jump for a frame. Base UI kept the leaving panel beside the arriving one for one frame, doubling the content's height, so whatever was centred or below moved and the cursor flickered off the tab under it. The leaving panel now hides at once.
|
|
467
|
+
- 25366e2: VideoPlayer: a stream that stops while it plays (an error, or a stall of 15 seconds) loads again by itself from where it stopped, as "Try again" does: after 1, 3, 8 and 15 seconds in turn, with the spinner meanwhile. The error shows only when the last of these fails too. Not at the start, and not for a stream the app feeds in itself (a `blob:` source).
|
|
468
|
+
|
|
469
|
+
## 0.4.1
|
|
470
|
+
|
|
471
|
+
### Patch Changes
|
|
472
|
+
|
|
473
|
+
- 1454b85: Switch: hovering no longer stretches the thumb; only a press does (18 to 25px, towards where it will go). The stretch is the start of the toggle, so on hover it suggested a flip that wasn't coming, and a column of switches twitched as the pointer passed.
|
|
474
|
+
|
|
475
|
+
## 0.4.0
|
|
476
|
+
|
|
477
|
+
Not published to npm: its changes were first released in 0.4.1.
|
|
478
|
+
|
|
479
|
+
### Minor Changes
|
|
480
|
+
|
|
481
|
+
- 2ce2922: New: `BottomNav` and `BottomNavItem`, the bar of three to five places at the bottom of a phone screen. Each item is an icon over a short label; the current one is in the foreground ink on a raised tile that glides to the next item in 300ms, and it is marked `aria-current="page"`. Items are buttons for app state (`value`, `defaultValue`, `onValueChange`), or links with `href` or a router's link through `render` and `current`. A `badge` count or dot sits on the icon and is read after the label in words ("Inbox, 3 new", or your own `badgeLabel`). The bar is the page ground behind a hairline, pads itself clear of the home indicator, and while it is on screen the page reserves its height as `--bottom-nav-h` (and scrolls focused things clear of it). It is hidden from `md` up by default (`breakpoint`), can slide away while the page scrolls down (`hideOnScroll`), and `position="absolute"` pins it inside a preview. German text is in the `de` messages.
|
|
482
|
+
|
|
483
|
+
`Toaster` now lifts its toasts above a `BottomNav`.
|
|
484
|
+
|
|
485
|
+
Fixed: a `Badge` in a `BadgeAnchor` and the `Skeleton` sweep now follow a page set right to left by its `dir` attribute alone. They were written with `:dir(rtl)`, which the CSS build turns into a list of right-to-left languages, so on a page with `dir="rtl"` but no such `lang` the badge sat off its corner and the sweep ran the wrong way.
|
|
486
|
+
|
|
487
|
+
- 8c1f666: **Breaking:** `DialogClose`, `DrawerClose`, `PopoverClose`, `AlertDialogClose`, `CollapsibleTrigger` and `CommandDialog`'s `trigger` no longer set their own `data-slot` on an element they render through `render`. A `Button` rendered there keeps `data-slot="button"` and the styles keyed on it (`collapsible`, `expandable`, the icon button sizes), as the dialog, drawer, popover, tooltip and menu triggers already did. Without `render` they still carry `dialog-close`, `drawer-close`, `popover-close`, `alert-dialog-close` and `collapsible-trigger`.
|
|
488
|
+
**Migrate:** if you selected a rendered close button by its slot, select it by its own: `[data-slot="dialog-close"]` on `<DialogClose render={<Button />} />` becomes `[data-slot="button"]`, or give it a `data-slot` or `id` of your own.
|
|
489
|
+
- b204016: Code is coloured by default, with nothing to set up: a CodeBlock with a `language`, a Response's fenced code and a ToolCall's parameters and result (`highlight={false}` keeps one mono). Shiki is now a dependency, loaded only when a coloured block appears. `CodeHighlightProvider` and `@zonsh/ui/code-highlight` are gone; `zonCodeTheme` stays in `@zonsh/ui`.
|
|
490
|
+
- 406c04a: Out of review and ready: `CopyButton`, `ColorPicker`, `FilterBar`, `TagsInput`, `TimeField`, `Timeline` and `Tree`, and the Kanban, Onboarding and Pricing blocks. Their APIs now follow the versioning policy like every other component's: a break comes only in a minor release, with a migration note.
|
|
491
|
+
- f6fe207: Forms work with React Hook Form, TanStack Form and React 19 actions. `Field` takes an `error` from a library (React Hook Form's `fieldState.error`, TanStack Form's `field.state.meta.errors`, or a message) and a bare `FieldError` shows it, linked to the control. While a field shows one, `Form` hands each submit to `onSubmit`, so the library checks the form again: an error on one field that depended on another no longer blocked every later submit. A bare `FieldError` no longer repeats the browser's message for a problem a `FieldError match` beside it already explains, so `match` messages and the server's errors can share a field. `DatePicker` and `DateRangePicker` take a `ref` to the trigger and an `onBlur`; `TimeField` and `OtpField` take an `inputRef`, for a library to focus them. `FileDrop` is the control of the `Field` it sits in: its label names it, its description and error describe it, and an invalid field marks it. A `ref` passed to `FileDrop` no longer stops paste from working. Form's docs show all three with Zod, and what each control takes from a library.
|
|
492
|
+
- b204016: `Illustration`, `SpecSheet`, `SpecSheetGrid`, `illustrations` and `illustrationKinds` move to their own entry, `@zonsh/ui/illustration`: import them from there. An app that doesn't use them no longer carries the 30 editorial images (about 800 KB) in its build.
|
|
493
|
+
- b204016: Large content stays responsive:
|
|
494
|
+
|
|
495
|
+
- `TableVirtualBody` scrolls a million rows to the last one: past about 15 million pixels the space between rows shrinks to what every browser can draw. Rows not drawn yet are estimated from the drawn ones, so scrolling no longer re-measures the rows below, in any theme; column sizing reads a sample past 50,000 rows.
|
|
496
|
+
- `DataTable` waits for typing to pause before searching 20,000 rows or more.
|
|
497
|
+
- `Combobox` renders only the options in view for a flat list of more than 200.
|
|
498
|
+
- `CommandDialog` lists the 200 best matches, and searches thousands of entries without re-reading each one.
|
|
499
|
+
- `CodeBlock` shows long code at once: past 400 lines it is coloured in slices between frames and laid out only near the view.
|
|
500
|
+
- `Response` streams a long reply at the same cost per word at its end as at its start.
|
|
501
|
+
- `TagsInput` with hundreds of tags no longer redraws them all at each key.
|
|
502
|
+
- `Graph` lays out a large network in a quarter of the time, and moves only the dragged node past 300 nodes.
|
|
503
|
+
- New `downsample` in `@zonsh/ui/chart`: the points of a long series a chart can show, peaks and dips kept.
|
|
504
|
+
- `DataTable` sorts, searches and pages 50,000 rows or more itself, building TanStack rows only for those drawn: a million rows appear in about a second, in a sixth of the memory.
|
|
505
|
+
- New `fetchRows` on `DataTable`: rows from a server, loaded a page or a run at a time as they come into view, with placeholders on their way.
|
|
506
|
+
- New `onRangeChange` on `TableVirtualBody`; ungrouped virtual rows are no longer listed one entry per row, so rows can be filled in where they are.
|
|
507
|
+
- Long `Timeline`s (over 100 entries) lay out only the entries near the view.
|
|
508
|
+
- `Select` warns in development past 500 options, which it draws every time it opens.
|
|
509
|
+
|
|
510
|
+
- 191dba6: LocaleProvider, useLocale and useMessages: every component's interface text and the locale numbers and dates are formatted in, set once for the app; a component's `labels` prop still wins. Pagination reads its text from it, with `labels` typed as `Partial<PaginationMessages>`.
|
|
511
|
+
- 21a375b: Every component's built-in text now comes from `LocaleProvider`: the accessible names, placeholders, empty states, live announcements and button text of about 35 components, each under its own namespace (`messages.dialog`, `messages.dataTable`, `messages.filterBar` …) with an exported `…Messages` interface. The English stays exactly as it was. Components that had no way to change their words take a `labels` prop; `closeLabel`, `removeLabel`, `addLabel`, `segmentLabels` and the other separate label props keep working, and a few are marked deprecated where `labels` now covers them.
|
|
512
|
+
|
|
513
|
+
A German pack ships as `@zonsh/ui/messages/de`: `<LocaleProvider locale="de-DE" messages={de}>`. It is typed as the full `Messages`, so it can't miss a string.
|
|
514
|
+
|
|
515
|
+
The provider's `locale` is now the default of everything that formats — NumberField, Slider, Progress, Meter, TimeField, FilterBar, DataTable's sort order, Chart tooltips and file sizes, which `formatFileSize(bytes, locale?)` writes for a locale. Off Apple keyboards, shortcut key names follow the language too (`messages.kbd`: Strg, Umschalt in German), and `useKeyNames` returns them.
|
|
516
|
+
|
|
517
|
+
- 0aa3e59: New `MoneyInput`: an amount in one currency, with the currency's symbol on the side the locale writes it and the currency's own decimal places (none for yen, two for euros, three for Kuwaiti dinars). The amount is plain while you edit it and grouped for reading on blur; pasted amounts are read in either convention (`1.234,56`, `1,234.56`, `€ 12`), and a digit past the currency's decimal places is refused rather than rounded. The value is an exact decimal string such as `"1234.50"`, never a float, and `onValueChange` also gives it in minor units as a `bigint`; `toMinorUnits` and `fromMinorUnits` convert between the two. `min`, `max`, `allowNegative`, `required` and the three sizes work inside `Field` and `Form`.
|
|
518
|
+
|
|
519
|
+
New `PhoneInput`: an international phone number, a searchable country picker joined to the number in one field. Countries are named in the locale and shown with their ISO and calling codes in mono; the number is grouped as it is typed, and typing or pasting a full `+44 20 7946 0018` switches the country. The value is E.164, and the number's length is checked against a compact built-in table of every country's calling code and national number lengths.
|
|
520
|
+
|
|
521
|
+
- 9f91d87: The page's edges on a phone match the ground. The ground (`html::before`) and its grain now reach a tenth of the window below its bottom edge, so the strip iOS Safari uncovers as its toolbar shrinks no longer shows the grain bare and bright. A new `--page-tone` token holds the ground as one flat colour (`#f9f9f9` light, `#141414` dark, `#0f0f0f` night); `<html>` is painted in it, and `themeScript`, `createThemeScript` and `ThemeProvider` keep `<meta name="theme-color">` at it, making the tag if there is none (opt out with `themeColor: false`; the values are exported as `PAGE_TONE`). For pages that draw edge to edge (`viewport-fit=cover`, an iPhone home-screen app), `Container`, `SiteHeader` and its menu, `Toaster` and `Lightbox` keep clear of the notch, the status bar and the home indicator, as bottom sheets already did.
|
|
522
|
+
|
|
523
|
+
Breaking, in two small ways:
|
|
524
|
+
|
|
525
|
+
- `<body>` no longer paints `--background`; the ground is `html::before`, and `<html>` is painted in `--page-tone`. A page that set its own `body` background still covers the ground as before. A stylesheet that read the colour off `body` should use `var(--background)`.
|
|
526
|
+
- The theme script and `ThemeProvider` now write `<meta name="theme-color">` (the tag with no `media`, made if missing). A page that set its own should pass `themeColor: false` to `createThemeScript` and `themeColor={false}` to `ThemeProvider`.
|
|
527
|
+
|
|
528
|
+
- 4e66cf7: PhoneInput: the country button is rounded and inset like any button in a field (its hover was square and sat 14px in); it keeps `data-slot="input-group-button"` and is marked `data-phone-input-country`. German numbers are grouped as DIN 5008 writes them, the prefix and then the number in one block: `163 7568602`, `30 12345678`.
|
|
529
|
+
|
|
530
|
+
Stepper: moving on animates. The line to the next step fills towards it, a finished step's check pops in, an error's "!" shakes once, the new current step settles as the line arrives and a vertical stepper's content slides in. Still under reduced motion.
|
|
531
|
+
|
|
532
|
+
Sidebar: hovering a row now only brightens its label. The gliding fill is opt-in with `hover="glide"`.
|
|
533
|
+
|
|
534
|
+
- 77a2da0: **Breaking:** Whiteboard is removed: the `@zonsh/ui/whiteboard` entry, its styles, its `whiteboard` messages, and `excalidrawAssets()` and `EXCALIDRAW_LICHT` from `@zonsh/ui/vite`. It was Excalidraw's own app in the zon colours, which never fully followed the design system, kept its interface in English and was by far the heaviest dependency. `@excalidraw/excalidraw` is no longer a peer dependency.
|
|
535
|
+
|
|
536
|
+
**Migrate:** use `@excalidraw/excalidraw` directly where you need a drawing canvas, and drop `excalidrawAssets()` from your Vite config.
|
|
537
|
+
|
|
538
|
+
- b204016: SiteHeader: `align="start"` puts the links right after the logo, with the actions on their own at the end. `menu={false}` leaves out the phone menu, for an app with navigation of its own on phones such as a bottom tab bar: the links show from 48rem up, and the actions stay in the bar at every width.
|
|
539
|
+
- fa349af: Sortable works in grids. `SortableList orientation="grid"` is for items in rows that wrap: dragged, an item takes the slot under the pointer and the items between move slot to slot, from the end of one row to the start of the next (right to left on a right-to-left page); with the keyboard, Left and Right move it by one and Up and Down by a row. Items that wrap move this way whatever the orientation.
|
|
540
|
+
|
|
541
|
+
Over a list whose items are narrower or wider, the copy under the pointer takes their width, and on the drop it glides to the size of its place. A Sortable removed in the middle of a drag now lets go of the page: its listeners, frames, timers and the page's cursor go with it, and nothing is called.
|
|
542
|
+
|
|
543
|
+
- 4700812: Three new components. `Sortable` (with `SortableList`, `SortableItem`, `SortableHandle`, `useSortable`, `useSortableItem` and `moveSortableItem`) reorders one list, a row, or several lists that items move between: a pointer drag with a drop line, a long press on touch, autoscroll near the edges, a keyboard handle that picks an item up and moves it with the arrows, and every move announced in a polite live region. The Kanban block is now built on it, and its values are set in the plain ink. `Lightbox` (with `LightboxGrid` and `LightboxTrigger`) opens images large on a black ground, with previous and next by button, arrow key and swipe, zoom by double click, wheel or pinch, a caption, a counter and an optional download. `Tour` walks through a screen in steps anchored to elements, with an optional spotlight, skipping steps whose targets are not on the page. All three take their text from `LocaleProvider`.
|
|
544
|
+
- 38f5725: Sortable moves things while you drag them. The copy under the pointer is followed by the other items sliding out of the way, so a gap the dragged item's size opens where it will land — in its own list, or in another list, where the gap it left closes up. On release the copy glides into the gap, and a cancel (Escape, or a release off the lists) glides it home while the others slide back. Keyboard and `move()` steps slide the items into their new order too. The slides are transforms on items measured once as a drag starts — nothing is laid out again while the pointer moves, and there is still no drag-and-drop dependency — taking 150ms on `--ease`, and under reduced motion the gap opens at once. The 2px drop line (`data-slot="sortable-indicator"`) is gone, replaced by the gap, and a dragged item is now hidden in its place (`data-dragging`) rather than dimmed. The Kanban block gets all of this.
|
|
545
|
+
- c7b813a: Four new components. `Stepper` shows where someone is in a flow of a few steps: mono indices on round markers joined by hairlines, upcoming, current, complete or with an error in words, in a row or stacked, with finished steps as links back, and the step in mono over a progress track on a phone. `Rating` is a row of stars in the ink on a radio group, with arrow keys, a hover preview, half stars, clearing, three sizes and Field support, and a read-only picture of any score read as "4.5 out of 5". `Stat` sets one product figure as type, with a change coloured only when its direction is good or bad and an inline SVG `Sparkline`, also exported on its own; `StatGroup` puts a row of them in one description list. `DateTimePicker`, in `@zonsh/ui/date-picker`, is a date and a time of day in one field, with a TimeField under the calendar, `min` and `max`, and the trigger formatted for the locale. The Onboarding block's step header is now a Stepper, and the Dashboard's figures are Stats.
|
|
546
|
+
- 16d9da6: `TableHead` in a body or footer row is now that row's header: a `<th scope="row">` set like a cell in the foreground ink, not as an eyebrow. Use it for the cell that names a row. The Pricing block's comparison table uses it, so every feature is the header of its row.
|
|
547
|
+
- 33d90a6: Tippy says the tour. With `TippyGuide`, each step of a `Tour` is Tippy's speech bubble — the tour's popover with a tail to its head — and Tippy stands beside the step's target, pointing at it, while the spotlight stays on the target. Between steps the bubble goes back into its tail, Tippy leaps to the next target, and the next bubble comes out as it lands; under reduced motion Tippy is there at once and the bubble just appears. The bubble is still the tour's dialog, read out and worked the same way.
|
|
548
|
+
|
|
549
|
+
Any guide can do this: `TourGuideState` has a new `place`, which makes the popover the guide's bubble, pointing at an anchor the guide gives (`TourGuidePlacement`, `TourAnchor`). Guides that don't call it keep the ordinary popover.
|
|
550
|
+
|
|
551
|
+
- 137ae9f: Tippy, zon.sh's mascot, at `@zonsh/ui/tippy`: a 64-pixel sprite drawn crisp on a canvas in its three inks, playing 18 moves with weight (`wave`, `jump`, `think`, `success`, `error` and more), each growing out of the last, still under reduced motion and paused off screen. `TippyGuide` walks a `Tour` through with the person: it waves on the first step, leaps after the popover to each new one and lands beside it, and ends with a happy hop and a check on Done. It has its own entry, so the main `@zonsh/ui` entry does not grow.
|
|
552
|
+
- 137ae9f: Tour: moving between steps no longer jumps. The popover glides from one target to the next while its height eases and the words cross-fade, and the spotlight's hole moves with it, taking the new target's size and corners. A target that is off screen is scrolled into view first, with the popover faded out, and the popover appears there once the page stops. The tour opens and closes with the fade and small scale of the other popups, and the dim fades out with it. Under reduced motion it all goes straight to the next target. New `guide` prop: a companion that goes through the tour beside the popover, told the step, the target, the popover and whether it is moving (`TourGuideState`).
|
|
553
|
+
- 3370b11: VideoPlayer: a later change to `defaultQuality` or `defaultAudio` switches the playing title to that version from the same moment, playing or paused as it was, the way the menus do, without calling `onQualityChange` / `onAudioChange`. The viewer's own pick stays until the app changes the prop again. A watch party can move every player to 1080p, or an app step down a quality when the picture keeps stalling.
|
|
554
|
+
|
|
555
|
+
### Patch Changes
|
|
556
|
+
|
|
557
|
+
- 7dd6ba9: ColorPicker shows one preset swatch per colour: a preset that picks the same colour as an earlier one is left out, keeping the first one's label, so React no longer warns about duplicate keys. A translucent preset in a picker without `alpha` is drawn as the opaque colour it picks. The colour inside a `ColorSwatch` has its own `data-slot`, `color-swatch-fill`.
|
|
558
|
+
- 406c04a: ColorPicker: preset swatches take the 7px corners of a swatch button, and the value field is 16px on a phone, so focusing it no longer zooms the page on iOS.
|
|
559
|
+
- 0de1494: Conversation keeps following the reply when a block in it shrinks and grows back between two frames, as a slow frame in Firefox can show it: the view clamped by layout no longer reads as the reader scrolling up, so the "Scroll to the latest message" button no longer appears on its own.
|
|
560
|
+
- 406c04a: CopyButton: a second click while "Copied" still shows is announced again, instead of leaving the live region unchanged.
|
|
561
|
+
- e3f4016: DataTable: a table with `fetchRows` loads its rows under React StrictMode. The second mount used to find the first mount's aborted request still marked as on its way, and never asked again, so the table stayed empty in development.
|
|
562
|
+
- 43437f6: Dependencies: `@base-ui/react` 1.9, `lucide-react` 1.67, `shiki` 4.6, `marked` 18.1.3 and `@tanstack/react-virtual` 3.14.26. The ranges of the optional peers are unchanged.
|
|
563
|
+
- ce777dd: `formatFileSize` moves on to the next unit when the number would read 1024 (a file of 1023.7 KB is "1.0 MB", not "1024 KB"), and a size just under ten reads "10 KB" rather than "10.0 KB".
|
|
564
|
+
- 406c04a: FilterBar: a chip's accessible name has spaces between its words in its markup ("Status is Paid, Shipped"), so it no longer depends on how a browser joins the parts, and two filter bars on one page that filter a field of the same id each open their own editor with the focus in it.
|
|
565
|
+
- 21f4d17: Every word a control shows is now part of its accessible name, so voice control reaches it by what is on screen (WCAG 2.5.3, axe's `label-content-name-mismatch`):
|
|
566
|
+
|
|
567
|
+
- Calendar: a day is named "Friday, October 16, 2026", with the number as the grid draws it, not "16th". A locale's own day label is kept, its "Today" and "selected" included; a `labels.labelDayButton` of your own is used as it is.
|
|
568
|
+
- BottomNav: an item with a count reads "Inbox 3" as drawn, the start of its name "Inbox, 3 new"; the label now comes before the icon in the markup and the icon is still drawn above it.
|
|
569
|
+
- FileDrop: the zone is named by its label and then what it shows ("Add product photos, Drop files here or click to choose …"); the title and the description no longer run together as one word for a screen reader.
|
|
570
|
+
- PdfViewer: a thumbnail shows its page as "1", the number its name "Page 1" says, not "01".
|
|
571
|
+
|
|
572
|
+
- 1a4a14d: Lightbox: a single tap on the black around the image closes the viewer on a touch screen, as a click does with a mouse. It closes at once; a double tap still zooms on the image.
|
|
573
|
+
- 0d72630: Motion that answers an action now ends within 300ms on an ease-out: the Drawer and Toast slide in 300ms (was 450ms), the Logo's name in 240ms (was 420ms), PromptInput's morph in 300ms (was 375ms, ease-in-out), InputGroup's sweep in 300ms (was 330ms), a checkbox's untick eases out, and the Stepper's whole sequence — the line, the check, the next step settling — is done in 300ms (was about 700ms).
|
|
574
|
+
- c4328b5: Pagination lines up at every control height: the page numbers no longer sit a pixel low below 38px, Previous and Next stay square instead of keeping the 38px width of their chevron and padding, and the dense size holds its height at the smallest theme (22px).
|
|
575
|
+
- 396370f: PhoneInput's countries now come from Google's libphonenumber metadata (release v9.0.43, Apache-2.0) instead of a hand-written table: the calling codes, the possible lengths of each country's numbers, trunk prefixes, how countries sharing a code are told apart, and the digit groups of each country's national formats. Lengths changed for 87 countries, mostly wider where the old table missed service and toll-free numbers, and narrower where it was out of date (Benin's numbers are 10 digits now, Nigeria's 10 to 12). Numbers group as libphonenumber writes them nationally (`90 1234 5678` in Japan, `8 912 345 67 89` in Russia); German numbers stay in DIN 5008's prefix-and-number form (`163 7568602`, `30 12345678`), with 015x mobiles after their five-digit network prefix (`1511 2345678`). Jersey, Guernsey, the Isle of Man, Saint Barthélemy and Saint Martin are now recognised from their own prefixes. The table is about 9 KB gzipped, up from 4 KB; `pnpm phone:data` regenerates it.
|
|
576
|
+
- 010cc6e: PhoneInput reads national numbers that start with 0 where 0 is also the trunk prefix whole, instead of dropping the 0 or reading them as international: Rwanda's `06` fixed lines (`06 12 34 56` is `+25006123456`, not `+2506123456`), and freephone and service ranges in Bulgaria (`00800 …`), Indonesia (`001803 …`, `007803 …`), India (`000800 …`), Japan (`0037 …`, `0066 …`, `0078 …`, `00777 …`, `00882 …`), Korea (`00308 …`, `00368 …`, `00798 …`), Thailand (`001800 …`) and Uruguay (`0004 …`), and `00800 …` in Panama and Qatar. Such a value now shows and reads back unchanged, is grouped as libphonenumber writes it nationally (`000 800 123 4567`), and is checked against its own range's lengths. A trunk 0 before any other number is dropped as before (`020 7946 0018`, `0163 7568602`).
|
|
577
|
+
|
|
578
|
+
The international prefixes each country dials instead of `+` now come from libphonenumber too, besides the `00` read everywhere: `001` to `009` in Thailand, the carriers' prefixes in Korea and Australia, `810` in Tajikistan and so on, where before only North America's `011`, Australia's `0011` and Japan's `010` were known. A prefix followed by a 0 (`000 …`) is not read as one, since no calling code starts with 0.
|
|
579
|
+
|
|
580
|
+
- 8c1f666: Fixes from a review of every component:
|
|
581
|
+
|
|
582
|
+
- **Toast:** `toast.loading` updated to a success or an error now closes on its own. The loading toast stays until it is updated or dismissed, as before.
|
|
583
|
+
- **BottomNav:** `labels.count` and `labels.dot` reach the items' badges. **ToolCall:** `labels.parameters`, `result` and `failure` reach `ToolCallInput` and `ToolCallOutput`.
|
|
584
|
+
- **DataTable:** the previous and next page buttons keep focus at the first and last page, as `Pagination` does.
|
|
585
|
+
- **SortableHandle:** a `ref` of your own no longer stops the grip from following a horizontal or grid list.
|
|
586
|
+
- **Tour:** the arrow keys leave a toolbar, a menubar and a ToggleGroup alone.
|
|
587
|
+
- **Command:** the `Esc` button is named "Esc, Close search", with what it shows first.
|
|
588
|
+
- **Separator:** a text `label` is its accessible name; a separator's children are not read.
|
|
589
|
+
- **MessageAvatar:** with a mark as children it keeps `id`, `style` and data attributes. A mark is always 32px.
|
|
590
|
+
- **ChartContainer:** `id` reaches the element.
|
|
591
|
+
- **Right to left:**
|
|
592
|
+
- The Sidebar rail and its cursors sit on the edge next to the page, a floating sidebar keeps its 8px from the viewport, and the icon rail's tooltips open towards the page.
|
|
593
|
+
- ColorPicker's hue and opacity sliders run left to right, as its area does.
|
|
594
|
+
- TagsInput's arrows follow the field's own direction, a `dir="rtl"` page included.
|
|
595
|
+
- InputGroup's password and clear sweeps follow right-to-left text.
|
|
596
|
+
- The paddings and margins of CodeBlock's header, the file input button and the SpecSheet eyebrow are on the logical side.
|
|
597
|
+
- **Select:** the chevron's hover fade uses the brand's duration and easing, and stops under reduced motion.
|
|
598
|
+
- **data-slot:** added to FeatureItem's header, FeatureCallout's icon and label, and a Breadcrumb link rendered through `render` (an element with a slot of its own keeps it).
|
|
599
|
+
- **Docs:**
|
|
600
|
+
- The locale table lists all of its namespaces.
|
|
601
|
+
- AsciiField's `density` range is 0.5–1.6.
|
|
602
|
+
- ToolCallInput and ToolCallOutput document their `label`.
|
|
603
|
+
|
|
604
|
+
- 5ce779d: Tree: Shift+Space selects a range, a modified click on a link row selects it without also opening the link, and the selected link of a single-selection tree is marked as the current page. TimeField: on a 12-hour clock the hour is read with its half of the day ("9 PM"). Combobox: the button that shows the options is named "Show options" again inside a Field, not after the field's label. CopyButton: an icon button keeps its name after copying, so "Copied" is said once, and the rendered element's own click handler runs.
|
|
605
|
+
- 498e12d: More icons mirror right to left: the link-out arrow in Sources, and the PDF viewer's thumbnail panel toggle. The PDF viewer's thumbnail rail, outline indents, toolbar and search field now use logical sides, so they sit right in a right-to-left page.
|
|
606
|
+
- 19c948b: Right to left, for Combobox, Select, NumberField, TimeField, Message, FilterBar and ButtonGroup:
|
|
607
|
+
|
|
608
|
+
- A Combobox list keeps its room beside the scrollbar on the bar's side, the left, as a Select's already did. Select and Combobox options and Select's scroll arrows are written with logical sides.
|
|
609
|
+
- A TimeField's time sits at the field's start, on the right, as typed text does, with the clock icon at the other end; the segments still read left to right (`14 : 30`).
|
|
610
|
+
- A stacked NumberField's rolling digits line up with the number at the start of the field without a `:dir(rtl)` override: the digit roll (NumberField and TimeField) is laid out in the page's direction around a left-to-right run of digits.
|
|
611
|
+
- `MessageActions` hang their buttons' padding past the message's own edge on either side: the left of a user message, the right of an assistant reply.
|
|
612
|
+
- ButtonGroup rounds the outer corners and squares the inner ones on the right sides: the first control is on the right, its neighbours overlap toward it, and the 1px trim and the seam between joined buttons follow. A FilterBar chip, built on ButtonGroup, takes the same corners, and its editor's title is set in from the right.
|
|
613
|
+
|
|
614
|
+
- 0e077a0: Right to left: the sidebar toggle's panel icon mirrors to the side the sidebar is on and keeps its spacing at the right end; the reasoning hairline, a sidebar or tree row's trailing count, a chart tooltip's values and an activity timeline's time sit at the logical end; and the room kept beside a Select's or Command's scrollbar is on the bar's side.
|
|
615
|
+
- b204016: Small control heights: select and combobox options, TagsInput chips, the dense file input and the small round input-group button now follow a theme's control height down to 28px instead of holding their own minimum.
|
|
616
|
+
- 7eabc02: `SidebarInset` reserves a `BottomNav`'s height on a phone (`pb-(--bottom-nav-h)`, which is 0 wherever no bar is shown), so an app shell's page clears the bar without a class of its own. The BottomNav and Sidebar docs show the two together: the bar for the places used daily and a "More" item that opens the sidebar's sheet.
|
|
617
|
+
- 8ae814a: Sidebar: rows rest in the muted ink and a hovered row's label turns full foreground, so the row under the pointer is easy to see, in dark mode too.
|
|
618
|
+
- b204016: SiteHeader: as the page scrolls, the bar takes the page ground itself — its colour, grain and faint light, lined up with the page's — over a hairline, instead of a translucent blur that read as a black band in dark mode. The ground comes in with the scroll, over the bar's own height, so the bar is solid by the time content reaches it.
|
|
619
|
+
- 44d72ca: A fitting `Table` resizes smoothly in Safari: its padding and column gap now follow the width from the fit itself rather than a container query, which made WebKit restyle every cell on each resize (about ten times the work it took Chrome).
|
|
620
|
+
- 406c04a: TagsInput: Backspace moves to the last chip only from an empty input, as documented; with the caret at the start of typed text it no longer jumps away. ← at the start still moves to the chips.
|
|
621
|
+
- 2d1d4f2: Toolbar: when its controls don't fit — a phone, a taller theme — they scroll inside the bar instead of pushing the page wider, as ToggleGroup and Tabs already do.
|
|
622
|
+
- 22aa609: Tour: the popover no longer shows for a moment in the wrong place between steps. The next step's side and offset could be applied against the last step's anchor for a frame (seen in Safari), so the popover jumped there before going to its target; now every placement measures the step the tour is on. A glide also ends when the popover's move does, so on a busy page, where the new place lands a few frames late, it still glides instead of jumping.
|
|
623
|
+
- 406c04a: Tree: a disabled row with an `href` is no longer followed when clicked, as it already wasn't with Enter, and a row's `meta` sits at its end in right-to-left layouts too.
|
|
624
|
+
- a48772d: VideoPlayer: the play or pause icon that answers a toggle comes and goes in 300ms (was 700ms).
|
|
625
|
+
- f43531d: VideoPlayer: the skip buttons, the arrow keys and `J` / `L` show their jump on its side of the picture, as a double tap does (back on the left, ahead on the right), and quick jumps the same way add up there (+10 s, +20 s, +30 s). It stays a second after the last one, with arrows that point the way it went.
|
|
626
|
+
- 30c135d: VideoPlayer: the back arrow and the seasons menu's chevron point the other way on a right-to-left page.
|
|
627
|
+
|
|
628
|
+
## 0.2.0
|
|
629
|
+
|
|
630
|
+
### Minor Changes
|
|
631
|
+
|
|
632
|
+
- ccc9ba8: A Button or Tag label wider than its container ends in "…". Slider thumbs stop at the track's ends (`thumbAlignment="center"` keeps the overhang). On a Mac, the Sidebar, Command, PDF viewer and Whiteboard shortcuts take ⌘ only. A table that scrolls is a tab stop. Right to left, popups follow the page's direction and toasts sit bottom left.
|
|
633
|
+
- ccc9ba8: Light theme: the status colours and the blue, aqua, orange and lime tones are a little darker, so text in them reads at 4.5:1 or better on every grey, selected rows included. Coloured Tag text is deepened to pass on its own tint.
|
|
634
|
+
- ccc9ba8: Forms: every control resets with its form, after `form.reset()` or a React 19 form action. DatePicker and DateRangePicker take `required`, and a disabled one no longer submits its value, like a disabled native input.
|
|
635
|
+
- ccc9ba8: Large data: `TableVirtualBody` renders only the rows in view, DataTable does the same above 100 rows (`virtualize`), and Tree above 500 nodes. DataTable sorts text with accents in their place, or in one language's order with `locale`. Adds `@tanstack/react-virtual`.
|
|
636
|
+
- ccc9ba8: New components, marked draft in the docs while they settle: ColorPicker, CopyButton, TagsInput, TimeField, Timeline and Tree, and FilterBar from `@zonsh/ui/filter-bar`; plus the Kanban, Onboarding and Pricing blocks.
|
|
637
|
+
- ad7819d: NumberField: `steppers="stacked"` puts ▲ and ▼ on top of each other at the end of the field, with the number left-aligned like an Input.
|
|
638
|
+
- ccc9ba8: VideoPlayer: `startTime` to resume, `subtitle` with `onSubtitleChange`, `onAudioChange`, `onQualityChange`, `loading`, an `overlay` for the app's own prompt, `pageShortcuts`, and `volumeStorageKey` to remember the volume. Starting a player with sound pauses the others (`pauseOthers={false}` opts out), scrubbing pauses until release, a tap on the poster starts it and its tooltips are dark. Many fixes, and about half the CPU while a movie plays.
|
|
639
|
+
|
|
640
|
+
### Patch Changes
|
|
641
|
+
|
|
642
|
+
- ccc9ba8: About 150 fixes from a break-test of every component: long words and URLs stay inside alerts, cards, dialogs, toasts and menus; tabs and toggle groups too wide for a phone scroll; Windows high-contrast mode shows checked, selected and current states; right to left lays out correctly; focus no longer drops to the page; NumberField works with input methods; unusual input no longer crashes ToolCall, PromptInput or code highlighting; a streaming code block no longer re-highlights all of it on every update; toasts sent before the Toaster mounts are kept; and `illustrations`, `illustrationKinds` and `zonCodeTheme` work in server components.
|
|
643
|
+
- ccc9ba8: Response: a reply built to stall the markdown parser renders at once (a paragraph too costly to parse shows as plain text), and streaming re-parses only the last blocks. marked 18.1.2.
|