@zonsh/ui 0.5.0 → 0.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +639 -0
- package/README.md +49 -21
- package/dist/brand.d.ts +3 -0
- package/dist/brand.js +7 -0
- package/dist/components/_breadcrumb-more.d.ts +6 -0
- package/dist/components/_breadcrumb-more.js +5 -0
- package/dist/components/_drawing-svg.d.ts +11 -0
- package/dist/components/_drawing-svg.js +30 -0
- package/dist/components/_media.d.ts +159 -0
- package/dist/components/_media.js +266 -0
- package/dist/components/_overlay.d.ts +8 -5
- package/dist/components/_overlay.js +11 -6
- package/dist/components/_scheduler-calendar.d.ts +71 -0
- package/dist/components/_scheduler-calendar.js +940 -0
- package/dist/components/_scheduler-editor.d.ts +29 -0
- package/dist/components/_scheduler-editor.js +111 -0
- package/dist/components/_scheduler-menu.d.ts +16 -0
- package/dist/components/_scheduler-menu.js +18 -0
- package/dist/components/_scheduler-parts.d.ts +164 -0
- package/dist/components/_scheduler-parts.js +327 -0
- package/dist/components/_suggest-list.d.ts +142 -0
- package/dist/components/_suggest-list.js +159 -0
- package/dist/components/_toolbar-more.d.ts +24 -0
- package/dist/components/_toolbar-more.js +25 -0
- package/dist/components/accordion.d.ts +1 -1
- package/dist/components/accordion.js +6 -6
- package/dist/components/action-sheet.d.ts +88 -0
- package/dist/components/action-sheet.js +124 -0
- package/dist/components/alert-dialog.js +3 -1
- package/dist/components/alert.d.ts +11 -18
- package/dist/components/alert.js +9 -6
- package/dist/components/app-bar.d.ts +93 -0
- package/dist/components/app-bar.js +175 -0
- package/dist/components/audio-player.d.ts +134 -0
- package/dist/components/audio-player.js +618 -0
- package/dist/components/avatar.d.ts +6 -6
- package/dist/components/avatar.js +13 -11
- package/dist/components/badge.d.ts +12 -12
- package/dist/components/badge.js +7 -5
- package/dist/components/bottom-nav.d.ts +53 -11
- package/dist/components/bottom-nav.js +388 -23
- package/dist/components/breadcrumb.d.ts +11 -2
- package/dist/components/breadcrumb.js +60 -6
- package/dist/components/button-group.js +5 -1
- package/dist/components/button.d.ts +23 -6
- package/dist/components/button.js +63 -7
- package/dist/components/calendar.js +8 -6
- package/dist/components/card.d.ts +10 -8
- package/dist/components/card.js +15 -14
- package/dist/components/carousel.d.ts +2 -2
- package/dist/components/carousel.js +21 -8
- package/dist/components/chart.d.ts +27 -1
- package/dist/components/chart.js +15 -5
- package/dist/components/checkbox.js +2 -2
- package/dist/components/code-block.d.ts +9 -2
- package/dist/components/code-block.js +26 -7
- package/dist/components/collapsible.js +3 -3
- package/dist/components/color-picker.d.ts +2 -2
- package/dist/components/color-picker.js +5 -5
- package/dist/components/combobox.d.ts +26 -7
- package/dist/components/combobox.js +32 -13
- package/dist/components/command.d.ts +29 -5
- package/dist/components/command.js +35 -10
- package/dist/components/context-menu.d.ts +5 -2
- package/dist/components/context-menu.js +24 -3
- package/dist/components/conversation.d.ts +1 -1
- package/dist/components/conversation.js +67 -13
- package/dist/components/copy-button.d.ts +1 -1
- package/dist/components/copy-button.js +1 -1
- package/dist/components/data-table.d.ts +6 -6
- package/dist/components/data-table.js +41 -15
- package/dist/components/date-picker.d.ts +31 -9
- package/dist/components/date-picker.js +100 -18
- package/dist/components/dialog.d.ts +17 -10
- package/dist/components/dialog.js +20 -13
- package/dist/components/drawer.d.ts +26 -8
- package/dist/components/drawer.js +75 -16
- package/dist/components/drawing.d.ts +25 -0
- package/dist/components/drawing.js +32 -0
- package/dist/components/empty.js +2 -2
- package/dist/components/feature-list.d.ts +65 -13
- package/dist/components/feature-list.js +116 -15
- package/dist/components/field.js +2 -2
- package/dist/components/file-drop.d.ts +9 -7
- package/dist/components/file-drop.js +8 -43
- package/dist/components/filter-bar.d.ts +10 -9
- package/dist/components/filter-bar.js +42 -25
- package/dist/components/graph.d.ts +19 -3
- package/dist/components/graph.js +170 -25
- package/dist/components/illustration.js +3 -28
- package/dist/components/input-group.d.ts +5 -10
- package/dist/components/input-group.js +16 -16
- package/dist/components/input.d.ts +2 -2
- package/dist/components/input.js +3 -3
- package/dist/components/item.d.ts +9 -6
- package/dist/components/item.js +13 -8
- package/dist/components/kbd.d.ts +1 -1
- package/dist/components/kbd.js +1 -1
- package/dist/components/lightbox.d.ts +76 -9
- package/dist/components/lightbox.js +333 -45
- package/dist/components/locale.d.ts +6 -6
- package/dist/components/logo.d.ts +21 -1
- package/dist/components/logo.js +32 -2
- package/dist/components/markdown-editor.d.ts +275 -0
- package/dist/components/markdown-editor.js +831 -0
- package/dist/components/mentions.d.ts +153 -0
- package/dist/components/mentions.js +507 -0
- package/dist/components/menu.d.ts +2 -1
- package/dist/components/menu.js +5 -4
- package/dist/components/menubar.d.ts +23 -5
- package/dist/components/menubar.js +97 -22
- package/dist/components/message.d.ts +62 -11
- package/dist/components/message.js +49 -13
- package/dist/components/meter.js +1 -1
- package/dist/components/money-input.d.ts +1 -1
- package/dist/components/money-input.js +1 -1
- package/dist/components/native-select.d.ts +2 -2
- package/dist/components/native-select.js +4 -4
- package/dist/components/navigation-menu.d.ts +3 -1
- package/dist/components/navigation-menu.js +23 -12
- package/dist/components/number-field.d.ts +2 -9
- package/dist/components/number-field.js +86 -36
- package/dist/components/number-roll.d.ts +26 -0
- package/dist/components/number-roll.js +81 -0
- package/dist/components/otp-field.d.ts +1 -1
- package/dist/components/otp-field.js +24 -3
- package/dist/components/pagination.d.ts +11 -3
- package/dist/components/pagination.js +59 -13
- package/dist/components/pdf-viewer.d.ts +1 -1
- package/dist/components/pdf-viewer.js +8 -8
- package/dist/components/phone-input.d.ts +1 -1
- package/dist/components/phone-input.js +2 -2
- package/dist/components/popover.js +5 -3
- package/dist/components/preview-card.d.ts +37 -2
- package/dist/components/preview-card.js +226 -2
- package/dist/components/progress.js +1 -1
- package/dist/components/prompt-input.d.ts +1 -1
- package/dist/components/prompt-input.js +24 -14
- package/dist/components/pull-to-refresh.d.ts +50 -0
- package/dist/components/pull-to-refresh.js +189 -0
- package/dist/components/quote.d.ts +6 -1
- package/dist/components/quote.js +3 -2
- package/dist/components/radio-group.js +1 -1
- package/dist/components/rating.d.ts +4 -1
- package/dist/components/rating.js +131 -10
- package/dist/components/reasoning.d.ts +1 -1
- package/dist/components/reasoning.js +7 -3
- package/dist/components/resizable.d.ts +1 -1
- package/dist/components/resizable.js +2 -2
- package/dist/components/response.d.ts +1 -1
- package/dist/components/response.js +18 -6
- package/dist/components/scheduler.d.ts +352 -0
- package/dist/components/scheduler.js +1717 -0
- package/dist/components/scroll-area.js +1 -1
- package/dist/components/select.d.ts +17 -4
- package/dist/components/select.js +140 -9
- package/dist/components/separator.d.ts +1 -1
- package/dist/components/separator.js +3 -3
- package/dist/components/sidebar.d.ts +44 -3
- package/dist/components/sidebar.js +57 -17
- package/dist/components/site-header.d.ts +18 -13
- package/dist/components/site-header.js +23 -11
- package/dist/components/skeleton.d.ts +17 -7
- package/dist/components/skeleton.js +22 -7
- package/dist/components/slider.js +2 -2
- package/dist/components/sortable.d.ts +55 -4
- package/dist/components/sortable.js +172 -103
- package/dist/components/sources.d.ts +1 -1
- package/dist/components/sources.js +2 -2
- package/dist/components/spinner.d.ts +4 -4
- package/dist/components/spinner.js +4 -4
- package/dist/components/stat.d.ts +21 -4
- package/dist/components/stat.js +17 -8
- package/dist/components/stepper.d.ts +1 -1
- package/dist/components/stepper.js +8 -7
- package/dist/components/suggestions.d.ts +11 -3
- package/dist/components/suggestions.js +10 -4
- package/dist/components/swipe-actions.d.ts +66 -0
- package/dist/components/swipe-actions.js +292 -0
- package/dist/components/switch.js +1 -1
- package/dist/components/table.d.ts +12 -6
- package/dist/components/table.js +78 -30
- package/dist/components/tabs.js +7 -4
- package/dist/components/tag.d.ts +19 -20
- package/dist/components/tag.js +9 -5
- package/dist/components/tags-input.d.ts +2 -7
- package/dist/components/tags-input.js +11 -8
- package/dist/components/textarea.d.ts +3 -2
- package/dist/components/textarea.js +4 -3
- package/dist/components/theme.d.ts +49 -6
- package/dist/components/theme.js +147 -9
- package/dist/components/time-field.d.ts +4 -9
- package/dist/components/time-field.js +6 -6
- package/dist/components/timeline.d.ts +19 -3
- package/dist/components/timeline.js +21 -9
- package/dist/components/tippy.d.ts +17 -1
- package/dist/components/tippy.js +95 -15
- package/dist/components/toast.d.ts +2 -7
- package/dist/components/toast.js +12 -8
- package/dist/components/toggle-group.d.ts +7 -1
- package/dist/components/toggle-group.js +16 -5
- package/dist/components/toggle.d.ts +2 -2
- package/dist/components/toggle.js +3 -2
- package/dist/components/tool-call.d.ts +1 -1
- package/dist/components/tool-call.js +4 -4
- package/dist/components/toolbar.d.ts +57 -4
- package/dist/components/toolbar.js +216 -16
- package/dist/components/tooltip.d.ts +1 -1
- package/dist/components/tooltip.js +4 -2
- package/dist/components/tour.d.ts +1 -1
- package/dist/components/tour.js +36 -15
- package/dist/components/tree.js +5 -5
- package/dist/components/typography.d.ts +31 -8
- package/dist/components/typography.js +21 -10
- package/dist/components/video-player.d.ts +7 -2
- package/dist/components/video-player.js +121 -220
- package/dist/index.d.ts +99 -92
- package/dist/index.js +99 -92
- package/dist/lib/calendar.d.ts +153 -0
- package/dist/lib/calendar.js +312 -0
- package/dist/lib/cn.d.ts +3 -1
- package/dist/lib/cn.js +5 -0
- package/dist/lib/code-highlight.d.ts +14 -0
- package/dist/lib/code-highlight.js +81 -18
- package/dist/lib/drag.d.ts +39 -0
- package/dist/lib/drag.js +96 -0
- package/dist/lib/editorial-assets.js +16 -8
- package/dist/lib/figure/figures/automation.js +25 -6
- package/dist/lib/figure/figures/bar-chart.js +6 -1
- package/dist/lib/figure/figures/brackets-classic.js +4 -1
- package/dist/lib/figure/figures/city.js +12 -2
- package/dist/lib/figure/figures/conveyor.js +17 -4
- package/dist/lib/figure/figures/database.js +5 -2
- package/dist/lib/figure/figures/documents.js +11 -3
- package/dist/lib/figure/figures/inbox.js +5 -2
- package/dist/lib/figure/figures/laptop.js +3 -1
- package/dist/lib/figure/figures/pipeline.js +45 -10
- package/dist/lib/figure/figures/platform.js +62 -7
- package/dist/lib/figure/figures/server.js +21 -5
- package/dist/lib/figure/figures/spreadsheet.js +29 -5
- package/dist/lib/figure/kernel.d.ts +4 -2
- package/dist/lib/figure/kernel.js +10 -5
- package/dist/lib/figure/parts.js +6 -2
- package/dist/lib/files.d.ts +31 -0
- package/dist/lib/files.js +60 -0
- package/dist/lib/gesture.d.ts +70 -0
- package/dist/lib/gesture.js +141 -0
- package/dist/lib/glide.d.ts +5 -0
- package/dist/lib/glide.js +9 -1
- package/dist/lib/icons.d.ts +1 -0
- package/dist/lib/icons.js +6 -0
- package/dist/lib/illustration-library.js +1 -6
- package/dist/lib/markdown-edit.d.ts +112 -0
- package/dist/lib/markdown-edit.js +557 -0
- package/dist/lib/markdown-rich-editor.d.ts +188 -0
- package/dist/lib/markdown-rich-editor.js +1153 -0
- package/dist/lib/markdown-rich.d.ts +63 -0
- package/dist/lib/markdown-rich.js +534 -0
- package/dist/lib/mentions.d.ts +100 -0
- package/dist/lib/mentions.js +246 -0
- package/dist/lib/motion.d.ts +18 -0
- package/dist/lib/motion.js +43 -5
- package/dist/lib/number-roll.d.ts +89 -0
- package/dist/lib/number-roll.js +391 -0
- package/dist/lib/platform.d.ts +6 -0
- package/dist/lib/platform.js +14 -0
- package/dist/lib/portal-container.d.ts +9 -0
- package/dist/lib/portal-container.js +10 -0
- package/dist/lib/press.d.ts +5 -0
- package/dist/lib/press.js +186 -0
- package/dist/lib/scheduler.d.ts +128 -0
- package/dist/lib/scheduler.js +272 -0
- package/dist/lib/scroll-edges.d.ts +9 -0
- package/dist/lib/scroll-edges.js +50 -0
- package/dist/lib/table-fit.d.ts +1 -1
- package/dist/lib/table-fit.js +65 -8
- package/dist/lib/theme-preset.d.ts +267 -0
- package/dist/lib/theme-preset.js +1046 -0
- package/dist/lib/theme-script.d.ts +23 -3
- package/dist/lib/theme-script.js +17 -5
- package/dist/lib/tippy/sprite.d.ts +36 -4
- package/dist/lib/tippy/sprite.js +188 -15
- package/dist/lib/tone.d.ts +4 -0
- package/dist/lib/tone.js +1 -0
- package/dist/messages/de.d.ts +3 -3
- package/dist/messages/de.js +274 -3
- package/dist/skills/zon-ui/SKILL.md +279 -0
- package/dist/skills/zon-ui/references/authoring.md +265 -0
- package/dist/skills/zon-ui/references/brand.md +416 -0
- package/dist/skills/zon-ui/references/components/accordion.md +199 -0
- package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
- package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
- package/dist/skills/zon-ui/references/components/alert.md +167 -0
- package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
- package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
- package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
- package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
- package/dist/skills/zon-ui/references/components/avatar.md +98 -0
- package/dist/skills/zon-ui/references/components/badge.md +227 -0
- package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
- package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
- package/dist/skills/zon-ui/references/components/button-group.md +216 -0
- package/dist/skills/zon-ui/references/components/button.md +309 -0
- package/dist/skills/zon-ui/references/components/calendar.md +296 -0
- package/dist/skills/zon-ui/references/components/card.md +158 -0
- package/dist/skills/zon-ui/references/components/carousel.md +297 -0
- package/dist/skills/zon-ui/references/components/chart.md +739 -0
- package/dist/skills/zon-ui/references/components/chat.md +417 -0
- package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
- package/dist/skills/zon-ui/references/components/code-block.md +143 -0
- package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
- package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
- package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
- package/dist/skills/zon-ui/references/components/combobox.md +455 -0
- package/dist/skills/zon-ui/references/components/command.md +326 -0
- package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
- package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
- package/dist/skills/zon-ui/references/components/conversation.md +146 -0
- package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
- package/dist/skills/zon-ui/references/components/crm.md +1022 -0
- package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
- package/dist/skills/zon-ui/references/components/data-table.md +776 -0
- package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
- package/dist/skills/zon-ui/references/components/dialog.md +335 -0
- package/dist/skills/zon-ui/references/components/direction.md +165 -0
- package/dist/skills/zon-ui/references/components/drawer.md +276 -0
- package/dist/skills/zon-ui/references/components/drawing.md +94 -0
- package/dist/skills/zon-ui/references/components/empty.md +225 -0
- package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
- package/dist/skills/zon-ui/references/components/field.md +209 -0
- package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
- package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
- package/dist/skills/zon-ui/references/components/form.md +970 -0
- package/dist/skills/zon-ui/references/components/graph.md +339 -0
- package/dist/skills/zon-ui/references/components/illustration.md +497 -0
- package/dist/skills/zon-ui/references/components/inbox.md +263 -0
- package/dist/skills/zon-ui/references/components/input-group.md +339 -0
- package/dist/skills/zon-ui/references/components/input.md +189 -0
- package/dist/skills/zon-ui/references/components/item.md +277 -0
- package/dist/skills/zon-ui/references/components/kanban.md +626 -0
- package/dist/skills/zon-ui/references/components/kbd.md +116 -0
- package/dist/skills/zon-ui/references/components/label.md +104 -0
- package/dist/skills/zon-ui/references/components/layout.md +291 -0
- package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
- package/dist/skills/zon-ui/references/components/locale.md +279 -0
- package/dist/skills/zon-ui/references/components/logo.md +257 -0
- package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
- package/dist/skills/zon-ui/references/components/mentions.md +512 -0
- package/dist/skills/zon-ui/references/components/menu.md +218 -0
- package/dist/skills/zon-ui/references/components/menubar.md +292 -0
- package/dist/skills/zon-ui/references/components/message.md +243 -0
- package/dist/skills/zon-ui/references/components/meter.md +105 -0
- package/dist/skills/zon-ui/references/components/money-input.md +333 -0
- package/dist/skills/zon-ui/references/components/native-select.md +197 -0
- package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
- package/dist/skills/zon-ui/references/components/number-field.md +210 -0
- package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
- package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
- package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
- package/dist/skills/zon-ui/references/components/pagination.md +109 -0
- package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
- package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
- package/dist/skills/zon-ui/references/components/popover.md +176 -0
- package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
- package/dist/skills/zon-ui/references/components/pricing.md +724 -0
- package/dist/skills/zon-ui/references/components/progress.md +92 -0
- package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
- package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
- package/dist/skills/zon-ui/references/components/quote.md +115 -0
- package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
- package/dist/skills/zon-ui/references/components/rating.md +260 -0
- package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
- package/dist/skills/zon-ui/references/components/resizable.md +213 -0
- package/dist/skills/zon-ui/references/components/response.md +170 -0
- package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
- package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
- package/dist/skills/zon-ui/references/components/select.md +351 -0
- package/dist/skills/zon-ui/references/components/separator.md +103 -0
- package/dist/skills/zon-ui/references/components/settings.md +793 -0
- package/dist/skills/zon-ui/references/components/shop.md +1715 -0
- package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
- package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
- package/dist/skills/zon-ui/references/components/site-header.md +303 -0
- package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
- package/dist/skills/zon-ui/references/components/slider.md +172 -0
- package/dist/skills/zon-ui/references/components/sortable.md +405 -0
- package/dist/skills/zon-ui/references/components/sources.md +106 -0
- package/dist/skills/zon-ui/references/components/spinner.md +222 -0
- package/dist/skills/zon-ui/references/components/stat.md +267 -0
- package/dist/skills/zon-ui/references/components/stepper.md +285 -0
- package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
- package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
- package/dist/skills/zon-ui/references/components/switch.md +160 -0
- package/dist/skills/zon-ui/references/components/table.md +999 -0
- package/dist/skills/zon-ui/references/components/tabs.md +258 -0
- package/dist/skills/zon-ui/references/components/tag.md +115 -0
- package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
- package/dist/skills/zon-ui/references/components/textarea.md +95 -0
- package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
- package/dist/skills/zon-ui/references/components/theme.md +362 -0
- package/dist/skills/zon-ui/references/components/time-field.md +222 -0
- package/dist/skills/zon-ui/references/components/timeline.md +285 -0
- package/dist/skills/zon-ui/references/components/tippy.md +243 -0
- package/dist/skills/zon-ui/references/components/toast.md +220 -0
- package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
- package/dist/skills/zon-ui/references/components/toggle.md +167 -0
- package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
- package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
- package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
- package/dist/skills/zon-ui/references/components/tour.md +423 -0
- package/dist/skills/zon-ui/references/components/tree.md +481 -0
- package/dist/skills/zon-ui/references/components/typography.md +347 -0
- package/dist/skills/zon-ui/references/components/video-player.md +386 -0
- package/dist/skills/zon-ui/references/marketing.md +467 -0
- package/dist/skills/zon-ui/references/motion.md +455 -0
- package/dist/skills/zon-ui/references/recipes.md +1232 -0
- package/dist/skills/zon-ui/references/tokens.md +866 -0
- package/dist/sources/accordion.css +4 -0
- package/dist/sources/action-sheet.css +11 -0
- package/dist/sources/alert-dialog.css +6 -0
- package/dist/sources/alert.css +3 -0
- package/dist/sources/app-bar.css +14 -0
- package/dist/sources/ascii-field.css +3 -0
- package/dist/sources/aspect-ratio.css +3 -0
- package/dist/sources/audio-player.css +20 -0
- package/dist/sources/avatar.css +3 -0
- package/dist/sources/badge.css +3 -0
- package/dist/sources/bottom-nav.css +9 -0
- package/dist/sources/breadcrumb.css +14 -0
- package/dist/sources/button-group.css +3 -0
- package/dist/sources/button.css +9 -0
- package/dist/sources/calendar.css +13 -0
- package/dist/sources/card.css +3 -0
- package/dist/sources/carousel.css +11 -0
- package/dist/sources/chart.css +5 -0
- package/dist/sources/checkbox.css +6 -0
- package/dist/sources/code-block.css +13 -0
- package/dist/sources/collapsible.css +4 -0
- package/dist/sources/color-picker.css +13 -0
- package/dist/sources/combobox.css +13 -0
- package/dist/sources/command.css +13 -0
- package/dist/sources/context-menu.css +12 -0
- package/dist/sources/conversation.css +10 -0
- package/dist/sources/copy-button.css +10 -0
- package/dist/sources/data-table.css +27 -0
- package/dist/sources/date-picker.css +20 -0
- package/dist/sources/dialog.css +9 -0
- package/dist/sources/direction.css +2 -0
- package/dist/sources/drawer.css +9 -0
- package/dist/sources/drawing.css +5 -0
- package/dist/sources/empty.css +3 -0
- package/dist/sources/feature-list.css +4 -0
- package/dist/sources/field.css +4 -0
- package/dist/sources/file-drop.css +15 -0
- package/dist/sources/filter-bar.css +30 -0
- package/dist/sources/form.css +4 -0
- package/dist/sources/graph.css +19 -0
- package/dist/sources/illustration.css +28 -0
- package/dist/sources/input-group.css +7 -0
- package/dist/sources/input.css +3 -0
- package/dist/sources/item.css +4 -0
- package/dist/sources/kbd.css +5 -0
- package/dist/sources/label.css +3 -0
- package/dist/sources/layout.css +3 -0
- package/dist/sources/lightbox.css +33 -0
- package/dist/sources/locale.css +2 -0
- package/dist/sources/logo.css +4 -0
- package/dist/sources/markdown-editor.css +41 -0
- package/dist/sources/mentions.css +13 -0
- package/dist/sources/menu.css +11 -0
- package/dist/sources/menubar.css +14 -0
- package/dist/sources/message.css +16 -0
- package/dist/sources/meter.css +4 -0
- package/dist/sources/money-input.css +10 -0
- package/dist/sources/native-select.css +4 -0
- package/dist/sources/navigation-menu.css +8 -0
- package/dist/sources/number-field.css +8 -0
- package/dist/sources/number-roll.css +6 -0
- package/dist/sources/otp-field.css +5 -0
- package/dist/sources/pagination.css +11 -0
- package/dist/sources/pdf-viewer.css +30 -0
- package/dist/sources/phone-input.css +20 -0
- package/dist/sources/popover.css +7 -0
- package/dist/sources/preview-card.css +7 -0
- package/dist/sources/progress.css +4 -0
- package/dist/sources/prompt-input.css +15 -0
- package/dist/sources/pull-to-refresh.css +14 -0
- package/dist/sources/quote.css +3 -0
- package/dist/sources/radio-group.css +5 -0
- package/dist/sources/rating.css +6 -0
- package/dist/sources/reasoning.css +6 -0
- package/dist/sources/resizable.css +4 -0
- package/dist/sources/response.css +16 -0
- package/dist/sources/scheduler.css +44 -0
- package/dist/sources/scroll-area.css +3 -0
- package/dist/sources/select.css +12 -0
- package/dist/sources/separator.css +3 -0
- package/dist/sources/sidebar.css +19 -0
- package/dist/sources/site-header.css +15 -0
- package/dist/sources/skeleton.css +3 -0
- package/dist/sources/slider.css +6 -0
- package/dist/sources/sortable.css +12 -0
- package/dist/sources/sources.css +6 -0
- package/dist/sources/spinner.css +6 -0
- package/dist/sources/stat.css +9 -0
- package/dist/sources/stepper.css +6 -0
- package/dist/sources/suggestions.css +10 -0
- package/dist/sources/swipe-actions.css +20 -0
- package/dist/sources/switch.css +5 -0
- package/dist/sources/table.css +7 -0
- package/dist/sources/tabs.css +5 -0
- package/dist/sources/tag.css +3 -0
- package/dist/sources/tags-input.css +6 -0
- package/dist/sources/textarea.css +3 -0
- package/dist/sources/theme.css +13 -0
- package/dist/sources/time-field.css +7 -0
- package/dist/sources/timeline.css +7 -0
- package/dist/sources/tippy.css +6 -0
- package/dist/sources/toast.css +6 -0
- package/dist/sources/toggle-group.css +5 -0
- package/dist/sources/toggle.css +3 -0
- package/dist/sources/tool-call.css +16 -0
- package/dist/sources/toolbar.css +14 -0
- package/dist/sources/tooltip.css +6 -0
- package/dist/sources/tour.css +14 -0
- package/dist/sources/tree.css +6 -0
- package/dist/sources/typography.css +4 -0
- package/dist/sources/video-player.css +21 -0
- package/dist/styles/ai.css +3 -0
- package/dist/styles/brand.css +98 -0
- package/dist/styles/core.css +266 -0
- package/dist/styles/editor.css +3 -0
- package/dist/styles/expressive.css +35 -56
- package/dist/styles/fonts.css +61 -117
- package/dist/styles/graph.css +4 -0
- package/dist/styles/illustration.css +4 -0
- package/dist/styles/index.css +11 -201
- package/dist/styles/material.css +138 -12
- package/dist/styles/parts/ai.css +18 -13
- package/dist/styles/parts/brand.css +2 -2
- package/dist/styles/parts/controls.css +29 -20
- package/dist/styles/parts/data.css +13 -9
- package/dist/styles/parts/editor.css +372 -0
- package/dist/styles/parts/feedback.css +32 -2
- package/dist/styles/parts/foundations.css +12 -7
- package/dist/styles/parts/graph.css +25 -9
- package/dist/styles/parts/inputs.css +172 -9
- package/dist/styles/parts/isometric.css +6 -5
- package/dist/styles/parts/navigation.css +206 -27
- package/dist/styles/parts/overlays.css +19 -4
- package/dist/styles/parts/pdf.css +2 -2
- package/dist/styles/pdf.css +3 -0
- package/dist/styles/prose.css +3 -0
- package/dist/styles/tokens.css +89 -14
- package/dist/theme.d.ts +1 -0
- package/dist/theme.js +5 -0
- package/dist/vite.d.ts +48 -59
- package/dist/vite.js +54 -21
- package/package.json +69 -2
|
@@ -0,0 +1,416 @@
|
|
|
1
|
+
# zon — Brand guidelines
|
|
2
|
+
|
|
3
|
+
Version: 1.2 / October 2026
|
|
4
|
+
|
|
5
|
+
Status: the canonical brand guide. It lives in the zon/ui repository as `docs/brand.md`; zon.sh/ui renders it (Brand), and zon.sh/ui/brand.md is the file itself, for copy and download. Change it here only.
|
|
6
|
+
|
|
7
|
+
Brand portal: `zon.sh/ui` (the components and this guide) · `zon.sh/ui/brand.md` (this guide as Markdown)
|
|
8
|
+
|
|
9
|
+
Audience: designers, developers, writers, and AI assistants.
|
|
10
|
+
|
|
11
|
+
## Instructions for AI assistants
|
|
12
|
+
|
|
13
|
+
Use this document as the design brief when creating zon materials. Preserve the identity described here; do not substitute a generic SaaS aesthetic. Follow the user's current instructions if they override this guide. This document describes design, not authorization to publish, modify infrastructure, or perform external actions.
|
|
14
|
+
|
|
15
|
+
Read `packages/ui/src/styles/tokens.css` and `fonts.css` in `@zonsh/ui` before implementing changes. They are the source of truth for live tokens and font files. Import components from `@zonsh/ui` rather than recreating controls. Preserve keyboard focus, labels, disabled states, responsive behavior, and reduced-motion support.
|
|
16
|
+
|
|
17
|
+
For a new composition:
|
|
18
|
+
|
|
19
|
+
1. Start with monochrome surfaces and one clear hierarchy; add colour only where it carries a status or a category. Group with hairlines and whitespace; make something a card only when it can be picked up, moved or opened on its own.
|
|
20
|
+
2. Use Licht for expressive headlines, Licht Sans for reading, controls and navigation, and Licht Mono for small labels and technical details.
|
|
21
|
+
3. Use the zon mark as supplied, with generous space around it.
|
|
22
|
+
4. Choose a single primary action; use the shared layered button treatment.
|
|
23
|
+
5. Keep body text readable and the layout spacious in both themes.
|
|
24
|
+
6. Describe a concrete problem and outcome. Do not invent customer results, metrics, testimonials, ratings, logos, awards, or certifications. Content the owner supplies, or that the project already has, is kept as it is. A claim you cannot know (what the product does, how it treats data, prices, delivery) is written as a placeholder for the owner to confirm, never stated as fact.
|
|
25
|
+
7. Preview desktop and mobile, light and dark, keyboard navigation, and reduced motion before release.
|
|
26
|
+
|
|
27
|
+
## 01 — Brand foundation
|
|
28
|
+
|
|
29
|
+
Name: **zon** — always lowercase, also at the start of a sentence. The domain is zon.sh.
|
|
30
|
+
|
|
31
|
+
zon.sh is home to Licht, its own typeface (zon.sh/licht), the gallery (zon.sh/gallery) and this component library, zon/ui (zon.sh/ui).
|
|
32
|
+
|
|
33
|
+
> zon's positioning, tagline and values belong here. This guide does not invent them: write them in before using it as a brief for marketing copy.
|
|
34
|
+
|
|
35
|
+
Visual interpretation: human warmth in the serif headlines; technical clarity in the monospace details; calm confidence in the monochrome palette, with a few quiet colours that carry meaning. Depth is subtle, spacing is generous, and decoration has a purpose.
|
|
36
|
+
|
|
37
|
+
## 02 — Logo
|
|
38
|
+
|
|
39
|
+
The zon mark is a crescent moon: a circle with an offset circle cut out, so the light is widest at the foot and thins to two tips around a 30° opening, the whole turned 14°. It is flat and in one colour: the ink, `#141414`, on a light ground and the light, `#f6f6f4`, on a dark one.
|
|
40
|
+
|
|
41
|
+
In code, the mark comes from `@zonsh/ui`:
|
|
42
|
+
|
|
43
|
+
- `Logo`: the lockup, the mark beside the wordmark; `variant="compact"` is the header logo, whose name slides out on hover; `product="ui"` sets the product lockup, "zon/ui".
|
|
44
|
+
- `LogoMark`: the mark alone. Its colour is the token `--logo`, which follows the theme.
|
|
45
|
+
- `LogoLeft`, `LogoRight`: the two brackets, kept as art (the Spinner's `brackets` face, the bracket illustrations, the AsciiField's default shape). They are not the logo.
|
|
46
|
+
|
|
47
|
+
For documents, slides and other sites, use the files on zon.sh: `zon.sh/logo.svg` and `zon.sh/logo.png` (1024px, transparent) are the light crescent, for dark grounds; `zon.sh/logo-ink.svg` and `zon.sh/logo-ink.png` are the ink one, for light grounds. The favicon, `zon.sh/favicon.svg`, follows the system scheme: the ink in light mode, the light in dark mode. Link previews use `zon.sh/og.png`, the crescent on the site's dark ground.
|
|
48
|
+
|
|
49
|
+
Use the supplied artwork. Do not redraw the mark, stretch it, rotate it further, mirror it, recolour it, or add outlines, shadows or a glow. It is flat, and the 14° turn is part of it.
|
|
50
|
+
|
|
51
|
+
The wordmark is **zon** in Licht, the Light face, lowercase, as every headline: the lockup and the hero speak the same voice. Its x-height is centred on the moon. The name must remain accessible even when visually hidden.
|
|
52
|
+
|
|
53
|
+
Recommended usage rules:
|
|
54
|
+
|
|
55
|
+
- Leave clear space of a quarter of the mark's height around it.
|
|
56
|
+
- Start at 16px for the mark and 20px for the lockup; check smaller applications individually.
|
|
57
|
+
- Place the mark on a quiet, solid surface; on busy imagery, give it a calm area of its own.
|
|
58
|
+
- In code, `size` is the moon's height.
|
|
59
|
+
|
|
60
|
+
## 03 — Color system
|
|
61
|
+
|
|
62
|
+
Surfaces, controls and type are monochrome: the page, cards, buttons (the primary included), fields, headlines and body copy. Colour comes in as small marks that carry meaning, never as decoration or as a brand accent.
|
|
63
|
+
|
|
64
|
+
**Status colours** have a fixed meaning everywhere:
|
|
65
|
+
|
|
66
|
+
| Token | Light | Dark | Means |
|
|
67
|
+
| --------------- | -------------------------- | --------------------------- | ---------------------------------------------------- |
|
|
68
|
+
| `--success` | `oklch(0.505 0.133 152)` | `oklch(0.76 0.16 152)` | Done, saved, sent, connected |
|
|
69
|
+
| `--warning` | `oklch(0.53 0.12 65)` | `oklch(0.78 0.15 75)` | Needs attention soon: nearly full, partial, expiring |
|
|
70
|
+
| `--info` | `oklch(0.52 0.15 250)` | `oklch(0.74 0.14 245)` | Neutral news: new, selected, unsaved, in progress |
|
|
71
|
+
| `--destructive` | `oklch(0.55 0.224 27.325)` | `oklch(0.704 0.191 22.216)` | Error, failed, a destructive action |
|
|
72
|
+
|
|
73
|
+
**Category tones** have no fixed meaning. The app decides what each one stands for — a file type, a phase, a kind of item — and keeps it the same everywhere:
|
|
74
|
+
|
|
75
|
+
| Token | Light | Dark |
|
|
76
|
+
| ---------------- | ----------------------- | ---------------------- |
|
|
77
|
+
| `--tone-blue` | `oklch(0.52 0.15 250)` | `oklch(0.74 0.14 245)` |
|
|
78
|
+
| `--tone-aqua` | `oklch(0.51 0.09 195)` | `oklch(0.78 0.12 195)` |
|
|
79
|
+
| `--tone-violet` | `oklch(0.53 0.17 300)` | `oklch(0.75 0.15 300)` |
|
|
80
|
+
| `--tone-magenta` | `oklch(0.54 0.2 340)` | `oklch(0.74 0.18 340)` |
|
|
81
|
+
| `--tone-orange` | `oklch(0.535 0.153 45)` | `oklch(0.76 0.15 50)` |
|
|
82
|
+
| `--tone-lime` | `oklch(0.51 0.13 130)` | `oklch(0.8 0.16 130)` |
|
|
83
|
+
|
|
84
|
+
All ten sit at about the same lightness, so none shouts over the others or over the greys, and each reads at 4.5:1 or better as text on its theme's page. Tailwind utilities follow the names: `text-warning`, `bg-info/10`, `border-tone-violet/30`.
|
|
85
|
+
|
|
86
|
+
How to use them:
|
|
87
|
+
|
|
88
|
+
- **Colour carries meaning.** A status, or a category people need to tell apart at a glance. Never decoration, emphasis or branding.
|
|
89
|
+
- **Small marks only.** Tag text, a 6px dot, an icon, a bar or meter segment, a 1px edge, a 10–20% tint behind its own text. Never a coloured button, card, page, section or headline.
|
|
90
|
+
- **Never colour alone.** Pair it with text, an icon or a legend, so it reads in greyscale, in forced colours and for people who cannot tell the hues apart.
|
|
91
|
+
- **One meaning per colour.** Within an app, a tone always means the same kind, and a status colour only its status. Do not mix tones and status colours in one set of marks; they would read as one scale.
|
|
92
|
+
- **Few per view.** Most of a screen stays grey. If everything is coloured, nothing is.
|
|
93
|
+
|
|
94
|
+
The components carry this for you: `Tag` (tinted status and tone variants), `Badge`, `Alert` and `toast` (status), `Progress` and `Meter` (`tone`), and `ChartContainer` (`palette="tones"`).
|
|
95
|
+
|
|
96
|
+
Core CSS tokens from `tokens.css`:
|
|
97
|
+
|
|
98
|
+
| Token | Light | Dark | Purpose |
|
|
99
|
+
| ---------------------- | ------------------ | -------------------- | ------------------ |
|
|
100
|
+
| `--background` | `oklch(0.99 0 0)` | `oklch(0.07 0 0)` | Page canvas |
|
|
101
|
+
| `--foreground` | `oklch(0.145 0 0)` | `oklch(0.985 0 0)` | Main text |
|
|
102
|
+
| `--foreground-soft` | `oklch(0.37 0 0)` | `oklch(0.75 0 0)` | Secondary text |
|
|
103
|
+
| `--muted-foreground` | `oklch(0.556 0 0)` | `oklch(0.66 0 0)` | Supporting text |
|
|
104
|
+
| `--card` | `oklch(1 0 0)` | `oklch(0.115 0 0)` | Card surface |
|
|
105
|
+
| `--primary` | `oklch(0.205 0 0)` | `oklch(0.985 0 0)` | Semantic primary |
|
|
106
|
+
| `--primary-foreground` | `oklch(0.985 0 0)` | `oklch(0.145 0 0)` | Text on primary |
|
|
107
|
+
| `--border` | `oklch(0.922 0 0)` | `oklch(1 0 0 / 10%)` | Dividers |
|
|
108
|
+
| `--control-surface` | `#f5f5f5` | `#1e1e1e` | Secondary buttons |
|
|
109
|
+
| `--control-hover` | `#ebebeb` | `#2a2a2a` | Hover surface |
|
|
110
|
+
| `--field-surface` | `#ffffff` | `#161616` | Form field fill |
|
|
111
|
+
| `--field-edge` | `#d4d4d4` | `#393939` | Form field outline |
|
|
112
|
+
| `--control-focus` | `#737373` | `#999999` | Keyboard focus |
|
|
113
|
+
|
|
114
|
+
Primary buttons have a specific layered treatment: their base fill is `#292929` in light mode and `#cbcbcb` in dark mode — the dark fill mirrors the light one by perceived contrast, so its glow and rim have room to read. Do not replace these with a flat `--primary` fill when reproducing the button.
|
|
115
|
+
|
|
116
|
+
Prefer semantic CSS variables over copied color literals in new website components. Do not use low-contrast decorative grays for essential text. Check the actual foreground/background pair at its final size; a token alone does not guarantee accessible contrast.
|
|
117
|
+
|
|
118
|
+
## 04 — Typography
|
|
119
|
+
|
|
120
|
+
| Role | Family | Application |
|
|
121
|
+
| ------------------ | ---------- | ------------------------------------------------------------- |
|
|
122
|
+
| Display / headings | Licht | Hero text, section titles, editorial statements, the wordmark |
|
|
123
|
+
| Body / controls | Licht Sans | Paragraphs, buttons, form fields, dropdowns, navigation |
|
|
124
|
+
| UI / technical | Licht Mono | Small labels, numbers, indices, ASCII art |
|
|
125
|
+
|
|
126
|
+
All three faces are our own: Licht, Licht Sans and Licht Mono. Never hotlink them, or any
|
|
127
|
+
future face, from a third-party host: that leaks the visitor's IP before consent.
|
|
128
|
+
|
|
129
|
+
They ship as a package, `licht`, and `@zonsh/ui` depends on it: `@import
|
|
130
|
+
"@zonsh/ui/styles.css"` brings the @font-face rules, and the app's bundler copies the WOFF2 files
|
|
131
|
+
into its build, so the browser only ever requests them from the site itself. Nothing to set up:
|
|
132
|
+
no proxy, no rewrite, no plugin. A new Licht release is a new version of `licht`, taken
|
|
133
|
+
up by a new `@zonsh/ui`; the lockfile pins the faces, so a release never changes a site (or this
|
|
134
|
+
repository's screenshots) by itself.
|
|
135
|
+
|
|
136
|
+
Licht implementation note: headlines are set in Licht Light (weight 300), and only Light.
|
|
137
|
+
`licht` has Licht's real cuts from 100 to 900, upright and italic, but hierarchy comes from
|
|
138
|
+
scale, never from weight: the heading rules and the `font-heading` and `display` utilities set 300
|
|
139
|
+
and turn font synthesis off, and a bold word in a headline keeps its Light. Never put a weight
|
|
140
|
+
utility on Licht text. Licht Sans and Licht Mono are different: they have real cuts from 100 to
|
|
141
|
+
900 (Licht Mono to 800), one file each, each with an italic, and Tailwind's `font-*` weight
|
|
142
|
+
utilities and `italic` pick them.
|
|
143
|
+
|
|
144
|
+
Font files: the portal offers the faces for download under **Assets**. Licht, Licht Sans and
|
|
145
|
+
Licht Mono are ours, so their terms are ours to set; decide them
|
|
146
|
+
before treating the portal download as a public release. The portal is public and
|
|
147
|
+
unauthenticated, so treat anything listed there as published.
|
|
148
|
+
|
|
149
|
+
Current website scale (`Display`, `Heading`, `Lead`, `Text`, `Eyebrow` in `@zonsh/ui`):
|
|
150
|
+
|
|
151
|
+
- Hero: 48px on small screens, 60px at `sm`, 72px at `md`; line height 1.03.
|
|
152
|
+
- Section headings: typically 30–48px; line height around 1.05–1.1.
|
|
153
|
+
- Body default: 17px; line height 1.6. Hero supporting copy: 18–20px.
|
|
154
|
+
- UI controls: typically 14px. Input text stays at least 16px on mobile.
|
|
155
|
+
- Eyebrows: 12px Licht Mono, uppercase, tracking 0.18em, muted.
|
|
156
|
+
- Heading tracking: -0.02em.
|
|
157
|
+
|
|
158
|
+
Use mixed case for headlines. Reserve all caps for short labels. Keep long copy in Licht Sans, not Licht or monospace. Preserve German characters: Ä Ö Ü ä ö ü ß. Let headings wrap naturally on small screens.
|
|
159
|
+
|
|
160
|
+
### Numbers
|
|
161
|
+
|
|
162
|
+
A number is typography, not a widget. Set it with the type you already have — `Stat` sets a
|
|
163
|
+
product figure exactly as below — and spend the effort on whether the number deserves to be there.
|
|
164
|
+
|
|
165
|
+
- **Editorial facts** (marketing pages, specimens): a large Licht numeral (64–88px, line height 1,
|
|
166
|
+
`tabular-nums`) with a small Licht unit word beside it and one plain sentence below. Three at
|
|
167
|
+
most, between hairlines.
|
|
168
|
+
- **Product figures** (dashboards, reports): Licht Mono, `tabular-nums`, an eyebrow label above.
|
|
169
|
+
In a dashboard, use `<dl>` with `<dt>` labels and `<dd>` values.
|
|
170
|
+
- **In a sentence**: put the figure in mono inside running text when the sentence is the point.
|
|
171
|
+
|
|
172
|
+
```tsx
|
|
173
|
+
<p className="flex items-baseline gap-2">
|
|
174
|
+
<span className="font-heading text-[72px] leading-none font-light tabular-nums">173</span>
|
|
175
|
+
<span className="font-heading text-xl font-light text-foreground-soft">glyphs</span>
|
|
176
|
+
</p>
|
|
177
|
+
```
|
|
178
|
+
|
|
179
|
+
- **Only real numbers.** Never invent savings, percentages, customer counts or growth figures. If a
|
|
180
|
+
number isn't measured and supportable, write the sentence without it.
|
|
181
|
+
- **Say where it comes from** when it isn't obvious ("in the last 30 days", "per week").
|
|
182
|
+
- **One unit, said plainly**: "3 h", "42 s", "1,284 downloads" — no "10x", no "up to". Keep the unit in
|
|
183
|
+
the same text as the number, so it is read together.
|
|
184
|
+
- **Few and large, or many and small.** Three editorial facts, or a dense row of mono figures —
|
|
185
|
+
never a wall of big numbers.
|
|
186
|
+
- Licht numerals stay weight 300; never bold a number for emphasis — size does that. Use
|
|
187
|
+
`tabular-nums` for anything that changes or sits in a column.
|
|
188
|
+
|
|
189
|
+
## 05 — Buttons and form controls
|
|
190
|
+
|
|
191
|
+
Reuse `Button`, `Input`, `Textarea`, `Select`, `ToggleGroup`, `Checkbox`, `Field` and `Form` from `@zonsh/ui`.
|
|
192
|
+
|
|
193
|
+
### Surfaces: regions, cards and tables
|
|
194
|
+
|
|
195
|
+
The default way to group content is a hairline rule and whitespace, not a box. Content
|
|
196
|
+
sections are separated by `border-t border-border/60` with generous padding and
|
|
197
|
+
`last:border-b`, and nothing is enclosed — a `plain` card is exactly that: a top rule and
|
|
198
|
+
padding, with no background, no radius and no border around it. Follow that.
|
|
199
|
+
Do not wrap content in a card because it feels tidier; whitespace and a fine rule carry
|
|
200
|
+
the structure, and boxing every group flattens the hierarchy instead of clarifying it.
|
|
201
|
+
|
|
202
|
+
A `card` (the default variant) exists for **objects only** — things that could be picked up, moved or opened
|
|
203
|
+
on their own (a quote card, a product, a deal on a board, a dialog, a table). A part of the page is
|
|
204
|
+
a `region`; a `plain` one is just a top rule and padding.
|
|
205
|
+
The default way to group content is still a hairline and whitespace, so reach for a card last.
|
|
206
|
+
|
|
207
|
+
**Fewer cards.** A page section, a form, a pricing table, a settings page and a sign-in form
|
|
208
|
+
on a page are not cards: they _are_ the page. Build them from hairline sections (`Section`,
|
|
209
|
+
`Separator`, `hairline`), whitespace and type hierarchy — a Licht heading, a mono eyebrow, muted
|
|
210
|
+
help text — with divided lists (`Item` rows under hairlines) and two-column rows, the label and
|
|
211
|
+
its description on the left and the control on the right. When a part needs a ground of its own,
|
|
212
|
+
make it a square `surface-container` region. Never put a card inside a card, and never a row of
|
|
213
|
+
identical cards where a divided list would do.
|
|
214
|
+
|
|
215
|
+
Every surface that encloses something shares one **material**: a `--field-edge` border,
|
|
216
|
+
a 160° gradient fill, and an inset top highlight. That is what makes a surface feel like
|
|
217
|
+
part of this system rather than a plain bordered box. Do not build a flat container.
|
|
218
|
+
|
|
219
|
+
```css
|
|
220
|
+
/* .surface-container — the shared material */
|
|
221
|
+
border: 1px solid var(--field-edge);
|
|
222
|
+
background: linear-gradient(160deg, var(--control-surface), var(--field-surface) 55%);
|
|
223
|
+
box-shadow: inset 0 1px 0 var(--control-highlight);
|
|
224
|
+
```
|
|
225
|
+
|
|
226
|
+
**Radius then says what kind of thing it is.** Three tiers, nothing in between:
|
|
227
|
+
|
|
228
|
+
- **Controls are rounded to the control vocabulary.** Buttons 12px, inputs and select
|
|
229
|
+
triggers 10px, select items and swatch buttons 7px, icon buttons fully round, menus,
|
|
230
|
+
toasts and expandable panels 12px. Never introduce a new radius for a control.
|
|
231
|
+
- **Regions are square.** A region is part of the page: panels, specimen sheets,
|
|
232
|
+
posters, covers, grids, sections. It takes the material above and `border-radius: 0`.
|
|
233
|
+
The border already separates it from the page; rounding would make it look detachable
|
|
234
|
+
when it is not.
|
|
235
|
+
- **Objects are cards, at 20px.** A card is a discrete thing sitting _on_ the page
|
|
236
|
+
rather than a region _of_ it — a quote card, a product, a dialog, a table.
|
|
237
|
+
It takes the material plus 20px radius, responsive padding, and a soft drop shadow
|
|
238
|
+
that lifts it off the page.
|
|
239
|
+
|
|
240
|
+
```css
|
|
241
|
+
/* .surface-card — material, plus object geometry. Tables use this too. */
|
|
242
|
+
border-radius: 20px;
|
|
243
|
+
padding: 24px; /* 32px at sm, 40px at md */
|
|
244
|
+
box-shadow:
|
|
245
|
+
inset 0 1px 0 var(--control-highlight),
|
|
246
|
+
0 4px 16px rgb(0 0 0 / 0.04);
|
|
247
|
+
```
|
|
248
|
+
|
|
249
|
+
The one thing that skips the material is a surface whose fill _is_ the content: a
|
|
250
|
+
colour swatch, an image cover, a logo shown on a fixed light or dark ground. Those
|
|
251
|
+
keep their own flat background and take only the border. Everything else gets it.
|
|
252
|
+
|
|
253
|
+
Use `Card` — `variant="region"` or the default `card` (the `surface-container` and `surface-card`
|
|
254
|
+
utilities) — rather than re-deriving either. The `0 4px 16px` at 4% black is the only drop shadow in the system and it
|
|
255
|
+
belongs to cards alone: the rule against heavy floating shadows still holds everywhere else,
|
|
256
|
+
and a region never gets one.
|
|
257
|
+
|
|
258
|
+
Deciding between the two: ask whether the thing could be picked up and moved somewhere
|
|
259
|
+
else on its own. A quote card, a product card, a data table could. A section panel, a
|
|
260
|
+
specimen sheet, a page cover could not — they are that part of the page. When genuinely
|
|
261
|
+
unsure, prefer the region: the default way to group content here is still a rule and
|
|
262
|
+
whitespace, and boxing every group flattens the hierarchy rather than clarifying it.
|
|
263
|
+
|
|
264
|
+
A form that stands alone as an object — in a dialog, or the one thing on an otherwise empty
|
|
265
|
+
screen — may be a `Card`, and then carries exactly the card treatment. A form on a page is not.
|
|
266
|
+
Two things apply to every card:
|
|
267
|
+
|
|
268
|
+
- **Padding belongs to the card**, not the call site. It used to be applied by each
|
|
269
|
+
usage, and the two usages had already drifted to different values.
|
|
270
|
+
- **The `--field-edge` border is what ties a card to its contents.** A card holding
|
|
271
|
+
inputs wears the same edge as the inputs. Reaching for `--border` instead is the most
|
|
272
|
+
common way to make a card look subtly foreign to what is inside it.
|
|
273
|
+
|
|
274
|
+
**On phones, the native picker.** Custom popups on the desktop, the platform's own picker on a
|
|
275
|
+
phone: it is larger, scrolls natively and is what the thumb expects. `Select` and `DatePicker`
|
|
276
|
+
(and `DateTimePicker`) do this by default (`native="touch"`): a `NativeSelect`, or a native date
|
|
277
|
+
field, when the pointer is coarse and the screen is phone-sized, and the custom popup everywhere
|
|
278
|
+
else. Use `NativeSelect` outright in plain forms. Keep the custom popup on a phone too
|
|
279
|
+
(`native={false}`) only for multiple choice, options with icons or descriptions, and a date range.
|
|
280
|
+
|
|
281
|
+
`ToggleGroup` is the segmented control. Use it for 2–5 short, mutually exclusive options where comparing them is the point — a `Select` hides the alternatives behind a click, which is the wrong trade when seeing them side by side is the value. Past five options, or when the labels are long, go back to `Select`. It renders as a recessed track holding one raised, current segment: field treatment outside, secondary-button treatment on the active item.
|
|
282
|
+
|
|
283
|
+
Current geometry:
|
|
284
|
+
|
|
285
|
+
- Text buttons: 12px corner radius.
|
|
286
|
+
- Icon buttons (`size="icon"`): circular, `9999px` radius.
|
|
287
|
+
- Inputs / textareas / select triggers: 10px radius (`--radius-control`).
|
|
288
|
+
- Select menus: 12px radius; items: 7px radius, at least 38px tall.
|
|
289
|
+
- Navigation and sidebar rows: 12px radius, 38px tall, matching text buttons.
|
|
290
|
+
- Cards, tables and the form panel: 20px radius, 24/32/40px padding, soft drop shadow.
|
|
291
|
+
- Regions (section panels, covers, specimen sheets, posters, grids): square, no shadow.
|
|
292
|
+
- Checkboxes: 18 × 18px, 5px radius.
|
|
293
|
+
|
|
294
|
+
Control heights use three steps and nothing in between:
|
|
295
|
+
|
|
296
|
+
- **30px, dense.** For compact, data-heavy surfaces: toolbars, table rows, filter bars,
|
|
297
|
+
settings panels, admin and dashboard screens — anywhere controls are stacked close
|
|
298
|
+
enough that 38px would push the content off screen. Reach for it by the surface being
|
|
299
|
+
dense, not by the control being minor: a dense screen uses 30px throughout rather than
|
|
300
|
+
mixing steps. Set with `size="sm"` on `Button`, `Select` and `Input`. A segmented
|
|
301
|
+
control's inner segments already sit at 30px, so a dense `ToggleGroup` needs no change.
|
|
302
|
+
- **38px, the default.** Inputs, default select triggers, select menu items, default
|
|
303
|
+
buttons, and navigation or sidebar rows. This is the height to reach for on ordinary
|
|
304
|
+
marketing and content pages, unless there is a reason not to.
|
|
305
|
+
- **46px, prominent.** Reserved for the calls to action that carry a page: the hero
|
|
306
|
+
pair, a floating CTA, and section-closing CTAs (`size="lg"`).
|
|
307
|
+
- Icon-only buttons are circular and 2px under the default height (36 × 36px at zon's); they are a shape, not a step on this scale.
|
|
308
|
+
- A segmented control is 38px overall. Its segments are 30px inside a 3px track, which is
|
|
309
|
+
internal geometry rather than a separate step — the control is what sits on the grid.
|
|
310
|
+
- Textareas: at least 140px tall; allow vertical resizing.
|
|
311
|
+
|
|
312
|
+
Set every one of these with `min-height`, never by padding a box until it happens to
|
|
313
|
+
measure right. Padding-derived heights resolve against `line-height`, so they drift the
|
|
314
|
+
moment a font or size changes — that is how this system previously ended up with select
|
|
315
|
+
items at 40px, sidebar rows at 41px, hero buttons at 46px and a floating CTA at 48px, none
|
|
316
|
+
of them deliberate. Do not add a third height, and do not override one of these with a
|
|
317
|
+
utility class such as `h-12` on the element.
|
|
318
|
+
|
|
319
|
+
**Density** moves the whole ladder, not one control. A theme sets it from Dense to Spacious
|
|
320
|
+
(30 / 34 / 38 / 42 / 46px default controls; zon's own is 38): the three steps keep their
|
|
321
|
+
proportions (24 / 30 / 36 at Dense), and the padding, gaps and type inside every component
|
|
322
|
+
follow, the type by half as much and never under 10px. The steps keep their jobs at every
|
|
323
|
+
density — `size="sm"` is still the dense surface and `size="lg"` still the call to action — and
|
|
324
|
+
what the brand fixes in px stays: checkboxes, radios, switches, slider thumbs and badges.
|
|
325
|
+
|
|
326
|
+
Primary buttons use a fine dark outer stroke, an inner highlight, and subtle top/bottom shading. Secondary buttons use a quiet surface with inset highlights. Fields are recessed. Keep this dimensionality restrained; do not add glow, animated gradients, thick outlines, or heavy floating shadows.
|
|
327
|
+
|
|
328
|
+
This applies to **every** interactive surface, not only the components listed above. Navigation rows, sidebar items, tabs, cards that respond to a pointer, and anything else that lights up on hover or marks itself as current must use the same raised treatment as a secondary button (`material-raised`, or `material-row` for surfaces that are flat at rest), and must not invent a flat fill:
|
|
329
|
+
|
|
330
|
+
```css
|
|
331
|
+
background-color: var(--control-surface); /* var(--control-hover) while hovered */
|
|
332
|
+
background-image: linear-gradient(180deg, var(--control-inner-edge), transparent);
|
|
333
|
+
box-shadow:
|
|
334
|
+
0 0 0 1px var(--control-edge),
|
|
335
|
+
inset 0 1px 0 var(--control-highlight),
|
|
336
|
+
inset 0 0 0 1px var(--control-inner-edge);
|
|
337
|
+
```
|
|
338
|
+
|
|
339
|
+
Three mistakes to avoid. Do not swap `background` alone with no outer stroke and no `--control-highlight` inset, which reads as a flat block next to a real button. Do not use `--control-surface` as a hover or current state, because it is the _resting_ fill of a secondary button and the row ends up dimmer than an untouched control; `--control-hover` is the hovered fill. Do not omit the 150ms transition on `background-color`, `color`, and `box-shadow`, or the surface will snap while every neighbouring control eases.
|
|
340
|
+
|
|
341
|
+
State guidance:
|
|
342
|
+
|
|
343
|
+
- Hover: short surface-color changes on hover-capable devices.
|
|
344
|
+
- Pressed: inset shadow rather than layout movement.
|
|
345
|
+
- Focus-visible: 2px `--control-focus` outline sitting flush on the control (`outline-offset: 0`). Text fields — inputs, textareas, input groups — take a softer focus edge instead: the 1px border shifts halfway to `--control-focus`, with no ring, because a ring on every click is noise and the caret already marks where typing goes. An open select takes the same softer edge; a field that is a button (a select's trigger) keeps the ring for keyboard focus, which a click never shows. Never add an outline offset, a detached halo, or a gap between the control and its focus ring. Never hide keyboard focus on anything without a caret.
|
|
346
|
+
- Disabled: noninteractive, visually subdued.
|
|
347
|
+
- Error: use destructive color plus a readable error message, not color alone.
|
|
348
|
+
- Every icon-only button needs an accessible name. Every field needs a visible label.
|
|
349
|
+
- Touch: on a touch screen every control under 44px takes a 44 × 44px tap area around it (`touch-target`), with nothing drawn; the geometry stays 30 / 38 / 46.
|
|
350
|
+
|
|
351
|
+
Primary labels name the outcome in a few words: “Save changes”, “Create project”, “Get started”, “Send message”. Secondary actions describe their destination, e.g. “See the components”.
|
|
352
|
+
|
|
353
|
+
## 06 — Layout, imagery, icons, and motion
|
|
354
|
+
|
|
355
|
+
Website content container: `Container` / `container-page` — `max-w-7xl` (80rem / 1280px), centered. Horizontal padding: 24px, then 40px at `sm`, then 64px at `lg`.
|
|
356
|
+
|
|
357
|
+
Section spacing token: `--section-pad: clamp(3.5rem, 7vw, 7rem)`.
|
|
358
|
+
|
|
359
|
+
The page ground of zon.sh is `--background` under a still film grain and, in dark, a faint light from above. It is zon.sh's own look, not the design system's: a zon.sh page imports `@zonsh/ui/brand.css` after `@zonsh/ui/styles.css` to get it, and an app built on the library without it stands on plain `--background`. Never recreate the grain by hand.
|
|
360
|
+
|
|
361
|
+
Recommended spacing rhythm: 4, 8, 12, 16, 24, 32, 48, 64, 96px. Use whitespace and fine rules to separate content; avoid making every paragraph a card.
|
|
362
|
+
|
|
363
|
+
Use the illustration library (`Illustration`): the editorial line art of zon.sh, the isometric objects, the light-table drawings and the spec sheets, all line art in the current ink and all bracket-aware — keep them uncoloured. ASCII (`AsciiField`) is a supporting visual language, not a type treatment for body text. Preserve the logo's silhouette in illustrative interpretations. Avoid generic neon AI graphics or unsubstantiated product screenshots.
|
|
364
|
+
|
|
365
|
+
Icons come from `lucide-react`. Keep a consistent outline style, typically 16–20px in controls with the library's default 2px stroke. Do not mix filled and outlined icon families arbitrarily.
|
|
366
|
+
|
|
367
|
+
Motion should clarify interaction or reveal content gently; [docs/motion.md](motion.md) has the details:
|
|
368
|
+
|
|
369
|
+
- Control transition: 150ms, `cubic-bezier(0.16, 1, 0.3, 1)` (`--ease`); gliding indicators 240ms on a softer ease-out (`--ease-glide`); moves the interface makes on its own ease in and out (`--ease-move`).
|
|
370
|
+
- Only what someone sees now and then moves. Nothing the keyboard does animates (but for the digit roll and the OTP ring, which show what a key changed), and what is seen all day moves little and fast.
|
|
371
|
+
- Leaving is quicker than arriving. Motion that answers an action ends within 300ms.
|
|
372
|
+
- A press shows in the material, never as movement.
|
|
373
|
+
- The logo reveal uses short opacity and spacing transitions.
|
|
374
|
+
- Respect `prefers-reduced-motion`: movement stops, fades stay. Readable content must not depend on animation.
|
|
375
|
+
- The page never smooth-scrolls on its own (no `scroll-behavior: smooth`): the reader's own scroll
|
|
376
|
+
is theirs. A scroll the interface makes for them (a jump to a section, a table of contents keeping
|
|
377
|
+
its current entry in view, a carousel, a conversation following a reply) may glide, and jumps
|
|
378
|
+
under reduced motion.
|
|
379
|
+
- Keep mobile hero blobs static, as in the current performance treatment.
|
|
380
|
+
- Do not add continuous large blur/filter animations to mobile pages.
|
|
381
|
+
|
|
382
|
+
## 07 — Voice and writing
|
|
383
|
+
|
|
384
|
+
Less noise, more signal: say it once, plainly, and stop. Be precise, quiet, direct and practical. Prefer the concrete word and the short sentence; leave out what does not help the reader. Write in clear English, or natural German where a page needs it, with the same factual promise in both.
|
|
385
|
+
|
|
386
|
+
zon.sh itself writes in lowercase — “less noise. more signal.” — as part of its look. In product copy and documentation, use sentence case; keep the name **zon** lowercase in running text. Short mono labels set everything in capitals, the name included (`ZON.SH`).
|
|
387
|
+
|
|
388
|
+
Say: “Install the package and import the components you need.”
|
|
389
|
+
|
|
390
|
+
Avoid: “Unlock limitless potential with revolutionary AI.”
|
|
391
|
+
|
|
392
|
+
Say: “Every component is documented once, for people and agents.”
|
|
393
|
+
|
|
394
|
+
Avoid: “The ultimate one-size-fits-all platform.”
|
|
395
|
+
|
|
396
|
+
German example: “Weniger Rauschen. Mehr Signal.”
|
|
397
|
+
|
|
398
|
+
Avoid unsupported guarantees, invented numbers, jargon-heavy sentences, pressure tactics, and excessive superlatives.
|
|
399
|
+
|
|
400
|
+
The rule is about inventing, not about deleting. Quotes, ratings, logos, team photos and figures that the owner supplies, or that the page being redesigned already has, are theirs: keep them as they are (fix an obvious typo), and point out any that look like placeholders. What nobody has told you — a feature, what happens to people's data, a price, a delivery time — goes in as a marked placeholder ("[Confirm: notes are deleted after 30 days]") and on a list for the owner, not as a plain statement of fact.
|
|
401
|
+
|
|
402
|
+
zon/ui is for any product — a shop, a notebook, a course, a dashboard, a tool for one person. Write copy for the product at hand, not for zon's own site, and in examples vary the domain so no single trade becomes the house style.
|
|
403
|
+
|
|
404
|
+
## 08 — Assets and handoff
|
|
405
|
+
|
|
406
|
+
In code, use the assets that ship with `@zonsh/ui`. For everything else, use the mark on zon.sh (`logo.svg`, `logo.png`).
|
|
407
|
+
|
|
408
|
+
This Markdown file is the portable AI/design handoff. zon.sh/ui renders this exact file, and zon.sh/ui/brand.md serves it for copy and download. Keep it in sync when changing brand tokens or component conventions, and keep it here — it is the only copy.
|
|
409
|
+
|
|
410
|
+
### Accessibility: contrast themes and large text
|
|
411
|
+
|
|
412
|
+
- **Forced colours.** In a contrast theme (Windows) the browser paints with a few system colours and drops the material's fills, gradients and shadows. Every state must survive that: focus is an outline (in `Highlight`), a chosen radio, an "on" switch, the current tab and a progress value take system colours (`Highlight`, `CanvasText`), icons ink with `currentColor`, and disabled controls stay dimmed. Never carry a state in a fill or a shadow alone.
|
|
413
|
+
- **Text at 200%.** Text set twice as large, with nothing else changed, must stay whole: labels grow their controls or end in "…", lines keep their spacing, and the page never scrolls sideways at a desktop width.
|
|
414
|
+
- **Narrow screens.** A row that runs out of room folds (one menu for a menubar, "…" in a breadcrumb, a compact pager) or scrolls inside itself with faded ends; it never widens the page.
|
|
415
|
+
|
|
416
|
+
Final review: logo integrity, correct fonts and weights, theme contrast, responsive line wrapping, keyboard focus, disabled/error states, reduced motion, accurate claims, and current export assets.
|
|
@@ -0,0 +1,199 @@
|
|
|
1
|
+
# Accordion
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Accordion, AccordionItem, AccordionPanel, AccordionTrigger } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
const faq = [
|
|
7
|
+
{
|
|
8
|
+
q: "Can I learn at my own pace?",
|
|
9
|
+
a: "Yes. Every lesson is recorded and stays available, so you can pause for a week and pick up exactly where you left off.",
|
|
10
|
+
},
|
|
11
|
+
{
|
|
12
|
+
q: "What if I miss a live session?",
|
|
13
|
+
a: "The recording is posted the same evening, and you can ask questions about it in the course forum.",
|
|
14
|
+
},
|
|
15
|
+
{
|
|
16
|
+
q: "Can I get a refund?",
|
|
17
|
+
a: "Within 14 days of buying the course, as long as you have watched fewer than a third of the lessons. Write to us and we will refund you in full.",
|
|
18
|
+
},
|
|
19
|
+
];
|
|
20
|
+
|
|
21
|
+
export function Faq() {
|
|
22
|
+
return (
|
|
23
|
+
<Accordion className="max-w-2xl">
|
|
24
|
+
{faq.map((item) => (
|
|
25
|
+
<AccordionItem key={item.q} value={item.q}>
|
|
26
|
+
<AccordionTrigger>{item.q}</AccordionTrigger>
|
|
27
|
+
<AccordionPanel>{item.a}</AccordionPanel>
|
|
28
|
+
</AccordionItem>
|
|
29
|
+
))}
|
|
30
|
+
</Accordion>
|
|
31
|
+
);
|
|
32
|
+
}
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
Questions or steps that open in place, separated by hairlines, with no boxes. Titles are 18px Licht Sans with an optional mono index; a plus turns into × when open.
|
|
36
|
+
|
|
37
|
+
## Usage
|
|
38
|
+
|
|
39
|
+
```tsx
|
|
40
|
+
import { Accordion, AccordionItem, AccordionPanel, AccordionTrigger } from "@zonsh/ui";
|
|
41
|
+
|
|
42
|
+
<Accordion>
|
|
43
|
+
<AccordionItem value="start">
|
|
44
|
+
<AccordionTrigger>Can I learn at my own pace?</AccordionTrigger>
|
|
45
|
+
<AccordionPanel>Yes. Every lesson is recorded and stays available.</AccordionPanel>
|
|
46
|
+
</AccordionItem>
|
|
47
|
+
</Accordion>;
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
The props you'll reach for: `multiple`, `defaultValue`, and `index` on the trigger.
|
|
51
|
+
|
|
52
|
+
## When to use
|
|
53
|
+
|
|
54
|
+
- FAQs, numbered steps, product details people scan by title.
|
|
55
|
+
- `size="display"` (Licht) when the titles are the headline.
|
|
56
|
+
- One hidden block is a `Collapsible`.
|
|
57
|
+
- Not for content everyone needs; skimmers miss what's closed.
|
|
58
|
+
|
|
59
|
+
## Examples
|
|
60
|
+
|
|
61
|
+
### Steps
|
|
62
|
+
|
|
63
|
+
`index` and `size="display"`; `inset` lines the panel up with the title.
|
|
64
|
+
|
|
65
|
+
```tsx
|
|
66
|
+
import { Accordion, AccordionItem, AccordionPanel, AccordionTrigger } from "@zonsh/ui";
|
|
67
|
+
|
|
68
|
+
const steps = [
|
|
69
|
+
{
|
|
70
|
+
title: "Choose",
|
|
71
|
+
body: "Pick the photos you want from your albums; duplicates and blurry shots are flagged.",
|
|
72
|
+
},
|
|
73
|
+
{
|
|
74
|
+
title: "Arrange",
|
|
75
|
+
body: "Drag them onto pages, choose a layout for each spread and add captions where they help.",
|
|
76
|
+
},
|
|
77
|
+
{
|
|
78
|
+
title: "Proof",
|
|
79
|
+
body: "Page through a full preview at print size and fix anything that is cropped too tight.",
|
|
80
|
+
},
|
|
81
|
+
{ title: "Print", body: "Choose paper and binding, and the book is printed and posted to you." },
|
|
82
|
+
];
|
|
83
|
+
|
|
84
|
+
export function Steps() {
|
|
85
|
+
return (
|
|
86
|
+
<Accordion size="display" defaultValue={["Choose"]} className="max-w-3xl">
|
|
87
|
+
{steps.map((step, i) => (
|
|
88
|
+
<AccordionItem key={step.title} value={step.title}>
|
|
89
|
+
<AccordionTrigger index={String(i + 1).padStart(2, "0")}>{step.title}</AccordionTrigger>
|
|
90
|
+
<AccordionPanel inset>{step.body}</AccordionPanel>
|
|
91
|
+
</AccordionItem>
|
|
92
|
+
))}
|
|
93
|
+
</Accordion>
|
|
94
|
+
);
|
|
95
|
+
}
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
### Multiple
|
|
99
|
+
|
|
100
|
+
`multiple` lets several panels open.
|
|
101
|
+
|
|
102
|
+
```tsx
|
|
103
|
+
import { Accordion, AccordionItem, AccordionPanel, AccordionTrigger } from "@zonsh/ui";
|
|
104
|
+
|
|
105
|
+
// faq: as in the first example on this page that uses them.
|
|
106
|
+
|
|
107
|
+
export function Multiple() {
|
|
108
|
+
return (
|
|
109
|
+
<Accordion multiple defaultValue={[faq[0]?.q]} className="max-w-2xl">
|
|
110
|
+
{faq.map((item) => (
|
|
111
|
+
<AccordionItem key={item.q} value={item.q}>
|
|
112
|
+
<AccordionTrigger>{item.q}</AccordionTrigger>
|
|
113
|
+
<AccordionPanel>{item.a}</AccordionPanel>
|
|
114
|
+
</AccordionItem>
|
|
115
|
+
))}
|
|
116
|
+
</Accordion>
|
|
117
|
+
);
|
|
118
|
+
}
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
### Disabled
|
|
122
|
+
|
|
123
|
+
A disabled item stays in place at half opacity, shut and unfocusable; say in the title when it opens. `disabled` on the `Accordion` shuts every item.
|
|
124
|
+
|
|
125
|
+
```tsx
|
|
126
|
+
import { Accordion, AccordionItem, AccordionPanel, AccordionTrigger } from "@zonsh/ui";
|
|
127
|
+
|
|
128
|
+
export function Disabled() {
|
|
129
|
+
return (
|
|
130
|
+
<Accordion className="max-w-2xl">
|
|
131
|
+
<AccordionItem value="syllabus">
|
|
132
|
+
<AccordionTrigger>What does the course cover?</AccordionTrigger>
|
|
133
|
+
<AccordionPanel>
|
|
134
|
+
Twelve weeks of watercolour: washes, layering, colour mixing and painting outdoors, with a finished
|
|
135
|
+
piece every fortnight.
|
|
136
|
+
</AccordionPanel>
|
|
137
|
+
</AccordionItem>
|
|
138
|
+
<AccordionItem value="certificate" disabled>
|
|
139
|
+
<AccordionTrigger>Your certificate (after the last lesson)</AccordionTrigger>
|
|
140
|
+
<AccordionPanel>Download your certificate as a PDF.</AccordionPanel>
|
|
141
|
+
</AccordionItem>
|
|
142
|
+
<AccordionItem value="materials">
|
|
143
|
+
<AccordionTrigger>Which materials do I need?</AccordionTrigger>
|
|
144
|
+
<AccordionPanel>
|
|
145
|
+
A starter set of twelve pans, two round brushes and a block of cold-pressed paper. The list in the
|
|
146
|
+
first lesson names brands at three prices.
|
|
147
|
+
</AccordionPanel>
|
|
148
|
+
</AccordionItem>
|
|
149
|
+
</Accordion>
|
|
150
|
+
);
|
|
151
|
+
}
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
## Props
|
|
155
|
+
|
|
156
|
+
| Prop | Type | Default |
|
|
157
|
+
| ------------------------------------------------- | --------------------------------------- | ----------- |
|
|
158
|
+
| `Accordion.size` | `"default" \| "display"` | `"default"` |
|
|
159
|
+
| `Accordion.multiple` | `boolean` | `false` |
|
|
160
|
+
| `Accordion.defaultValue` | `any[]` | — |
|
|
161
|
+
| `Accordion.value` / `onValueChange` | controlled open items | — |
|
|
162
|
+
| `AccordionItem.value` | `any` | auto |
|
|
163
|
+
| `AccordionItem.disabled` / `Accordion.disabled` | `boolean` | `false` |
|
|
164
|
+
| `AccordionTrigger.index` | `ReactNode` — e.g. `"01"` | — |
|
|
165
|
+
| `AccordionTrigger.headerProps` | props for the `<h3>` wrapper | — |
|
|
166
|
+
| `AccordionPanel.inset` | `boolean` — align with an indexed title | `false` |
|
|
167
|
+
| `AccordionPanel.keepMounted` / `hiddenUntilFound` | `boolean` | `false` |
|
|
168
|
+
|
|
169
|
+
Other Base UI `Accordion` props are forwarded. Data attributes: `data-size` on the root, `data-open` on items and panels, `data-panel-open` on the trigger, `data-disabled` on a disabled item and its trigger.
|
|
170
|
+
|
|
171
|
+
## Brand rules
|
|
172
|
+
|
|
173
|
+
- **Do** let the hairline and whitespace carry the structure.
|
|
174
|
+
- **Do** write titles as the question or the step, specific and short.
|
|
175
|
+
- **Don't** put the accordion, or each item, in a `Card`.
|
|
176
|
+
- **Don't** swap the plus for a chevron or add a fill on hover.
|
|
177
|
+
- **Don't** use Licht for long titles; `display` is for short editorial headings.
|
|
178
|
+
|
|
179
|
+
## Accessibility
|
|
180
|
+
|
|
181
|
+
- Each trigger is a `<button>` inside an `<h3>`, with `aria-expanded` and `aria-controls`.
|
|
182
|
+
- The index is read as part of the button text, so keep it short.
|
|
183
|
+
- The height opens and closes in `--duration-glide` (240ms) on `--ease-glide`, and is instant under `prefers-reduced-motion`.
|
|
184
|
+
|
|
185
|
+
### Keyboard
|
|
186
|
+
|
|
187
|
+
| Key | What it does |
|
|
188
|
+
| ------------- | ------------------------------------------------ |
|
|
189
|
+
| Tab | Moves to the next trigger, or into an open panel |
|
|
190
|
+
| Shift+Tab | Moves back |
|
|
191
|
+
| Enter / Space | Opens or closes the focused item |
|
|
192
|
+
|
|
193
|
+
Each trigger is its own Tab stop; arrow keys don't move between them (following the APG).
|
|
194
|
+
|
|
195
|
+
---
|
|
196
|
+
|
|
197
|
+
- Import: `import { Accordion, AccordionItem, AccordionTrigger, AccordionPanel } from "@zonsh/ui"`
|
|
198
|
+
- Source: `packages/ui/src/components/accordion.tsx`
|
|
199
|
+
- Primitive: `@base-ui/react/accordion` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/accordion.md`)
|