@zonsh/ui 0.4.1 → 0.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +639 -0
- package/README.md +49 -21
- package/dist/brand.d.ts +3 -0
- package/dist/brand.js +7 -0
- package/dist/components/_breadcrumb-more.d.ts +6 -0
- package/dist/components/_breadcrumb-more.js +5 -0
- package/dist/components/_drawing-svg.d.ts +11 -0
- package/dist/components/_drawing-svg.js +30 -0
- package/dist/components/_media.d.ts +159 -0
- package/dist/components/_media.js +266 -0
- package/dist/components/_overlay.d.ts +8 -5
- package/dist/components/_overlay.js +11 -6
- package/dist/components/_scheduler-calendar.d.ts +71 -0
- package/dist/components/_scheduler-calendar.js +940 -0
- package/dist/components/_scheduler-editor.d.ts +29 -0
- package/dist/components/_scheduler-editor.js +111 -0
- package/dist/components/_scheduler-menu.d.ts +16 -0
- package/dist/components/_scheduler-menu.js +18 -0
- package/dist/components/_scheduler-parts.d.ts +164 -0
- package/dist/components/_scheduler-parts.js +327 -0
- package/dist/components/_suggest-list.d.ts +142 -0
- package/dist/components/_suggest-list.js +159 -0
- package/dist/components/_toolbar-more.d.ts +24 -0
- package/dist/components/_toolbar-more.js +25 -0
- package/dist/components/accordion.d.ts +1 -1
- package/dist/components/accordion.js +7 -7
- package/dist/components/action-sheet.d.ts +88 -0
- package/dist/components/action-sheet.js +124 -0
- package/dist/components/alert-dialog.js +3 -1
- package/dist/components/alert.d.ts +11 -18
- package/dist/components/alert.js +9 -6
- package/dist/components/app-bar.d.ts +93 -0
- package/dist/components/app-bar.js +175 -0
- package/dist/components/ascii-field.js +2 -1
- package/dist/components/audio-player.d.ts +134 -0
- package/dist/components/audio-player.js +618 -0
- package/dist/components/avatar.d.ts +6 -6
- package/dist/components/avatar.js +13 -11
- package/dist/components/badge.d.ts +12 -12
- package/dist/components/badge.js +7 -5
- package/dist/components/bottom-nav.d.ts +53 -11
- package/dist/components/bottom-nav.js +389 -24
- package/dist/components/breadcrumb.d.ts +11 -2
- package/dist/components/breadcrumb.js +60 -6
- package/dist/components/button-group.js +5 -1
- package/dist/components/button.d.ts +23 -6
- package/dist/components/button.js +64 -8
- package/dist/components/calendar.js +8 -6
- package/dist/components/card.d.ts +10 -8
- package/dist/components/card.js +15 -14
- package/dist/components/carousel.d.ts +2 -2
- package/dist/components/carousel.js +21 -8
- package/dist/components/chart.d.ts +38 -1
- package/dist/components/chart.js +27 -5
- package/dist/components/checkbox.js +2 -2
- package/dist/components/code-block.d.ts +9 -2
- package/dist/components/code-block.js +26 -7
- package/dist/components/collapsible.js +4 -4
- package/dist/components/color-picker.d.ts +2 -2
- package/dist/components/color-picker.js +5 -5
- package/dist/components/combobox.d.ts +26 -7
- package/dist/components/combobox.js +32 -13
- package/dist/components/command.d.ts +29 -5
- package/dist/components/command.js +37 -12
- package/dist/components/context-menu.d.ts +5 -2
- package/dist/components/context-menu.js +24 -3
- package/dist/components/conversation.d.ts +1 -1
- package/dist/components/conversation.js +77 -16
- package/dist/components/copy-button.d.ts +1 -1
- package/dist/components/copy-button.js +8 -6
- package/dist/components/data-table.d.ts +6 -6
- package/dist/components/data-table.js +41 -15
- package/dist/components/date-picker.d.ts +31 -9
- package/dist/components/date-picker.js +100 -18
- package/dist/components/dialog.d.ts +17 -10
- package/dist/components/dialog.js +20 -13
- package/dist/components/drawer.d.ts +26 -8
- package/dist/components/drawer.js +75 -16
- package/dist/components/drawing.d.ts +25 -0
- package/dist/components/drawing.js +32 -0
- package/dist/components/empty.js +2 -2
- package/dist/components/feature-list.d.ts +65 -13
- package/dist/components/feature-list.js +116 -15
- package/dist/components/field.js +2 -2
- package/dist/components/file-drop.d.ts +9 -7
- package/dist/components/file-drop.js +8 -43
- package/dist/components/filter-bar.d.ts +10 -9
- package/dist/components/filter-bar.js +42 -25
- package/dist/components/graph.d.ts +19 -3
- package/dist/components/graph.js +190 -28
- package/dist/components/illustration.js +53 -31
- package/dist/components/input-group.d.ts +6 -11
- package/dist/components/input-group.js +21 -19
- package/dist/components/input.d.ts +2 -2
- package/dist/components/input.js +3 -3
- package/dist/components/item.d.ts +9 -6
- package/dist/components/item.js +13 -8
- package/dist/components/kbd.d.ts +1 -1
- package/dist/components/kbd.js +1 -1
- package/dist/components/layout.d.ts +2 -1
- package/dist/components/layout.js +55 -11
- package/dist/components/lightbox.d.ts +76 -9
- package/dist/components/lightbox.js +354 -48
- package/dist/components/locale.d.ts +6 -6
- package/dist/components/logo.d.ts +21 -1
- package/dist/components/logo.js +32 -2
- package/dist/components/markdown-editor.d.ts +275 -0
- package/dist/components/markdown-editor.js +831 -0
- package/dist/components/mentions.d.ts +153 -0
- package/dist/components/mentions.js +507 -0
- package/dist/components/menu.d.ts +2 -1
- package/dist/components/menu.js +5 -4
- package/dist/components/menubar.d.ts +23 -5
- package/dist/components/menubar.js +153 -31
- package/dist/components/message.d.ts +62 -11
- package/dist/components/message.js +51 -14
- package/dist/components/meter.js +1 -1
- package/dist/components/money-input.d.ts +1 -1
- package/dist/components/money-input.js +1 -1
- package/dist/components/native-select.d.ts +2 -2
- package/dist/components/native-select.js +4 -4
- package/dist/components/navigation-menu.d.ts +3 -1
- package/dist/components/navigation-menu.js +23 -10
- package/dist/components/number-field.d.ts +2 -9
- package/dist/components/number-field.js +90 -26
- package/dist/components/number-roll.d.ts +26 -0
- package/dist/components/number-roll.js +81 -0
- package/dist/components/otp-field.d.ts +1 -1
- package/dist/components/otp-field.js +24 -3
- package/dist/components/pagination.d.ts +11 -3
- package/dist/components/pagination.js +59 -13
- package/dist/components/pdf-viewer.d.ts +1 -1
- package/dist/components/pdf-viewer.js +8 -8
- package/dist/components/phone-input.d.ts +1 -1
- package/dist/components/phone-input.js +2 -2
- package/dist/components/popover.js +5 -3
- package/dist/components/preview-card.d.ts +37 -2
- package/dist/components/preview-card.js +226 -2
- package/dist/components/progress.js +1 -1
- package/dist/components/prompt-input.d.ts +1 -1
- package/dist/components/prompt-input.js +35 -17
- package/dist/components/pull-to-refresh.d.ts +50 -0
- package/dist/components/pull-to-refresh.js +189 -0
- package/dist/components/quote.d.ts +6 -1
- package/dist/components/quote.js +3 -2
- package/dist/components/radio-group.js +8 -3
- package/dist/components/rating.d.ts +4 -1
- package/dist/components/rating.js +131 -10
- package/dist/components/reasoning.d.ts +1 -1
- package/dist/components/reasoning.js +7 -3
- package/dist/components/resizable.d.ts +1 -1
- package/dist/components/resizable.js +2 -2
- package/dist/components/response.d.ts +4 -3
- package/dist/components/response.js +39 -15
- package/dist/components/scheduler.d.ts +352 -0
- package/dist/components/scheduler.js +1717 -0
- package/dist/components/scroll-area.js +1 -1
- package/dist/components/select.d.ts +17 -4
- package/dist/components/select.js +140 -9
- package/dist/components/separator.d.ts +1 -1
- package/dist/components/separator.js +3 -3
- package/dist/components/sidebar.d.ts +44 -3
- package/dist/components/sidebar.js +90 -31
- package/dist/components/site-header.d.ts +18 -13
- package/dist/components/site-header.js +26 -9
- package/dist/components/skeleton.d.ts +18 -8
- package/dist/components/skeleton.js +23 -8
- package/dist/components/slider.js +2 -2
- package/dist/components/sortable.d.ts +55 -4
- package/dist/components/sortable.js +187 -94
- package/dist/components/sources.d.ts +1 -1
- package/dist/components/sources.js +2 -2
- package/dist/components/spinner.d.ts +4 -4
- package/dist/components/spinner.js +4 -4
- package/dist/components/stat.d.ts +21 -4
- package/dist/components/stat.js +17 -8
- package/dist/components/stepper.d.ts +1 -1
- package/dist/components/stepper.js +8 -7
- package/dist/components/suggestions.d.ts +11 -3
- package/dist/components/suggestions.js +10 -4
- package/dist/components/swipe-actions.d.ts +66 -0
- package/dist/components/swipe-actions.js +292 -0
- package/dist/components/switch.js +1 -1
- package/dist/components/table.d.ts +13 -7
- package/dist/components/table.js +124 -23
- package/dist/components/tabs.js +15 -8
- package/dist/components/tag.d.ts +19 -20
- package/dist/components/tag.js +9 -5
- package/dist/components/tags-input.d.ts +2 -7
- package/dist/components/tags-input.js +11 -8
- package/dist/components/textarea.d.ts +3 -2
- package/dist/components/textarea.js +4 -3
- package/dist/components/theme.d.ts +50 -7
- package/dist/components/theme.js +168 -12
- package/dist/components/time-field.d.ts +6 -10
- package/dist/components/time-field.js +19 -9
- package/dist/components/timeline.d.ts +19 -3
- package/dist/components/timeline.js +21 -9
- package/dist/components/tippy.d.ts +17 -1
- package/dist/components/tippy.js +95 -15
- package/dist/components/toast.d.ts +2 -7
- package/dist/components/toast.js +12 -8
- package/dist/components/toggle-group.d.ts +7 -1
- package/dist/components/toggle-group.js +17 -5
- package/dist/components/toggle.d.ts +2 -2
- package/dist/components/toggle.js +3 -2
- package/dist/components/tool-call.d.ts +1 -1
- package/dist/components/tool-call.js +8 -3
- package/dist/components/toolbar.d.ts +57 -4
- package/dist/components/toolbar.js +219 -16
- package/dist/components/tooltip.d.ts +5 -3
- package/dist/components/tooltip.js +14 -6
- package/dist/components/tour.d.ts +1 -1
- package/dist/components/tour.js +70 -24
- package/dist/components/tree.js +33 -10
- package/dist/components/typography.d.ts +31 -8
- package/dist/components/typography.js +21 -10
- package/dist/components/video-player.d.ts +7 -2
- package/dist/components/video-player.js +182 -225
- package/dist/index.d.ts +99 -92
- package/dist/index.js +99 -92
- package/dist/lib/calendar.d.ts +153 -0
- package/dist/lib/calendar.js +312 -0
- package/dist/lib/cn.d.ts +3 -1
- package/dist/lib/cn.js +5 -0
- package/dist/lib/code-highlight.d.ts +14 -0
- package/dist/lib/code-highlight.js +81 -18
- package/dist/lib/drag.d.ts +39 -0
- package/dist/lib/drag.js +96 -0
- package/dist/lib/editorial-assets.js +16 -8
- package/dist/lib/figure/figures/automation.js +25 -6
- package/dist/lib/figure/figures/bar-chart.js +6 -1
- package/dist/lib/figure/figures/brackets-classic.js +4 -1
- package/dist/lib/figure/figures/city.js +12 -2
- package/dist/lib/figure/figures/conveyor.js +17 -4
- package/dist/lib/figure/figures/database.js +5 -2
- package/dist/lib/figure/figures/documents.js +11 -3
- package/dist/lib/figure/figures/inbox.js +5 -2
- package/dist/lib/figure/figures/laptop.js +3 -1
- package/dist/lib/figure/figures/pipeline.js +45 -10
- package/dist/lib/figure/figures/platform.js +62 -7
- package/dist/lib/figure/figures/server.js +21 -5
- package/dist/lib/figure/figures/spreadsheet.js +29 -5
- package/dist/lib/figure/kernel.d.ts +4 -2
- package/dist/lib/figure/kernel.js +10 -5
- package/dist/lib/figure/parts.js +6 -2
- package/dist/lib/files.d.ts +31 -0
- package/dist/lib/files.js +60 -0
- package/dist/lib/gesture.d.ts +70 -0
- package/dist/lib/gesture.js +141 -0
- package/dist/lib/glide.d.ts +10 -4
- package/dist/lib/glide.js +14 -5
- package/dist/lib/icons.d.ts +1 -0
- package/dist/lib/icons.js +6 -0
- package/dist/lib/illustration-library.js +1 -6
- package/dist/lib/markdown-edit.d.ts +112 -0
- package/dist/lib/markdown-edit.js +557 -0
- package/dist/lib/markdown-rich-editor.d.ts +188 -0
- package/dist/lib/markdown-rich-editor.js +1153 -0
- package/dist/lib/markdown-rich.d.ts +63 -0
- package/dist/lib/markdown-rich.js +534 -0
- package/dist/lib/mentions.d.ts +100 -0
- package/dist/lib/mentions.js +246 -0
- package/dist/lib/motion.d.ts +18 -0
- package/dist/lib/motion.js +43 -5
- package/dist/lib/number-roll.d.ts +89 -0
- package/dist/lib/number-roll.js +391 -0
- package/dist/lib/platform.d.ts +6 -0
- package/dist/lib/platform.js +14 -0
- package/dist/lib/portal-container.d.ts +9 -0
- package/dist/lib/portal-container.js +10 -0
- package/dist/lib/press.d.ts +5 -0
- package/dist/lib/press.js +186 -0
- package/dist/lib/scheduler.d.ts +128 -0
- package/dist/lib/scheduler.js +272 -0
- package/dist/lib/scroll-edges.d.ts +9 -0
- package/dist/lib/scroll-edges.js +50 -0
- package/dist/lib/table-fit.d.ts +4 -3
- package/dist/lib/table-fit.js +92 -25
- package/dist/lib/theme-preset.d.ts +267 -0
- package/dist/lib/theme-preset.js +1046 -0
- package/dist/lib/theme-script.d.ts +23 -3
- package/dist/lib/theme-script.js +17 -5
- package/dist/lib/tippy/sprite.d.ts +36 -4
- package/dist/lib/tippy/sprite.js +188 -15
- package/dist/lib/tone.d.ts +4 -0
- package/dist/lib/tone.js +1 -0
- package/dist/messages/de.d.ts +3 -3
- package/dist/messages/de.js +274 -3
- package/dist/skills/zon-ui/SKILL.md +279 -0
- package/dist/skills/zon-ui/references/authoring.md +265 -0
- package/dist/skills/zon-ui/references/brand.md +416 -0
- package/dist/skills/zon-ui/references/components/accordion.md +199 -0
- package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
- package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
- package/dist/skills/zon-ui/references/components/alert.md +167 -0
- package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
- package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
- package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
- package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
- package/dist/skills/zon-ui/references/components/avatar.md +98 -0
- package/dist/skills/zon-ui/references/components/badge.md +227 -0
- package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
- package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
- package/dist/skills/zon-ui/references/components/button-group.md +216 -0
- package/dist/skills/zon-ui/references/components/button.md +309 -0
- package/dist/skills/zon-ui/references/components/calendar.md +296 -0
- package/dist/skills/zon-ui/references/components/card.md +158 -0
- package/dist/skills/zon-ui/references/components/carousel.md +297 -0
- package/dist/skills/zon-ui/references/components/chart.md +739 -0
- package/dist/skills/zon-ui/references/components/chat.md +417 -0
- package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
- package/dist/skills/zon-ui/references/components/code-block.md +143 -0
- package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
- package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
- package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
- package/dist/skills/zon-ui/references/components/combobox.md +455 -0
- package/dist/skills/zon-ui/references/components/command.md +326 -0
- package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
- package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
- package/dist/skills/zon-ui/references/components/conversation.md +146 -0
- package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
- package/dist/skills/zon-ui/references/components/crm.md +1022 -0
- package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
- package/dist/skills/zon-ui/references/components/data-table.md +776 -0
- package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
- package/dist/skills/zon-ui/references/components/dialog.md +335 -0
- package/dist/skills/zon-ui/references/components/direction.md +165 -0
- package/dist/skills/zon-ui/references/components/drawer.md +276 -0
- package/dist/skills/zon-ui/references/components/drawing.md +94 -0
- package/dist/skills/zon-ui/references/components/empty.md +225 -0
- package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
- package/dist/skills/zon-ui/references/components/field.md +209 -0
- package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
- package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
- package/dist/skills/zon-ui/references/components/form.md +970 -0
- package/dist/skills/zon-ui/references/components/graph.md +339 -0
- package/dist/skills/zon-ui/references/components/illustration.md +497 -0
- package/dist/skills/zon-ui/references/components/inbox.md +263 -0
- package/dist/skills/zon-ui/references/components/input-group.md +339 -0
- package/dist/skills/zon-ui/references/components/input.md +189 -0
- package/dist/skills/zon-ui/references/components/item.md +277 -0
- package/dist/skills/zon-ui/references/components/kanban.md +626 -0
- package/dist/skills/zon-ui/references/components/kbd.md +116 -0
- package/dist/skills/zon-ui/references/components/label.md +104 -0
- package/dist/skills/zon-ui/references/components/layout.md +291 -0
- package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
- package/dist/skills/zon-ui/references/components/locale.md +279 -0
- package/dist/skills/zon-ui/references/components/logo.md +257 -0
- package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
- package/dist/skills/zon-ui/references/components/mentions.md +512 -0
- package/dist/skills/zon-ui/references/components/menu.md +218 -0
- package/dist/skills/zon-ui/references/components/menubar.md +292 -0
- package/dist/skills/zon-ui/references/components/message.md +243 -0
- package/dist/skills/zon-ui/references/components/meter.md +105 -0
- package/dist/skills/zon-ui/references/components/money-input.md +333 -0
- package/dist/skills/zon-ui/references/components/native-select.md +197 -0
- package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
- package/dist/skills/zon-ui/references/components/number-field.md +210 -0
- package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
- package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
- package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
- package/dist/skills/zon-ui/references/components/pagination.md +109 -0
- package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
- package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
- package/dist/skills/zon-ui/references/components/popover.md +176 -0
- package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
- package/dist/skills/zon-ui/references/components/pricing.md +724 -0
- package/dist/skills/zon-ui/references/components/progress.md +92 -0
- package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
- package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
- package/dist/skills/zon-ui/references/components/quote.md +115 -0
- package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
- package/dist/skills/zon-ui/references/components/rating.md +260 -0
- package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
- package/dist/skills/zon-ui/references/components/resizable.md +213 -0
- package/dist/skills/zon-ui/references/components/response.md +170 -0
- package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
- package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
- package/dist/skills/zon-ui/references/components/select.md +351 -0
- package/dist/skills/zon-ui/references/components/separator.md +103 -0
- package/dist/skills/zon-ui/references/components/settings.md +793 -0
- package/dist/skills/zon-ui/references/components/shop.md +1715 -0
- package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
- package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
- package/dist/skills/zon-ui/references/components/site-header.md +303 -0
- package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
- package/dist/skills/zon-ui/references/components/slider.md +172 -0
- package/dist/skills/zon-ui/references/components/sortable.md +405 -0
- package/dist/skills/zon-ui/references/components/sources.md +106 -0
- package/dist/skills/zon-ui/references/components/spinner.md +222 -0
- package/dist/skills/zon-ui/references/components/stat.md +267 -0
- package/dist/skills/zon-ui/references/components/stepper.md +285 -0
- package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
- package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
- package/dist/skills/zon-ui/references/components/switch.md +160 -0
- package/dist/skills/zon-ui/references/components/table.md +999 -0
- package/dist/skills/zon-ui/references/components/tabs.md +258 -0
- package/dist/skills/zon-ui/references/components/tag.md +115 -0
- package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
- package/dist/skills/zon-ui/references/components/textarea.md +95 -0
- package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
- package/dist/skills/zon-ui/references/components/theme.md +362 -0
- package/dist/skills/zon-ui/references/components/time-field.md +222 -0
- package/dist/skills/zon-ui/references/components/timeline.md +285 -0
- package/dist/skills/zon-ui/references/components/tippy.md +243 -0
- package/dist/skills/zon-ui/references/components/toast.md +220 -0
- package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
- package/dist/skills/zon-ui/references/components/toggle.md +167 -0
- package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
- package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
- package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
- package/dist/skills/zon-ui/references/components/tour.md +423 -0
- package/dist/skills/zon-ui/references/components/tree.md +481 -0
- package/dist/skills/zon-ui/references/components/typography.md +347 -0
- package/dist/skills/zon-ui/references/components/video-player.md +386 -0
- package/dist/skills/zon-ui/references/marketing.md +467 -0
- package/dist/skills/zon-ui/references/motion.md +455 -0
- package/dist/skills/zon-ui/references/recipes.md +1232 -0
- package/dist/skills/zon-ui/references/tokens.md +866 -0
- package/dist/sources/accordion.css +4 -0
- package/dist/sources/action-sheet.css +11 -0
- package/dist/sources/alert-dialog.css +6 -0
- package/dist/sources/alert.css +3 -0
- package/dist/sources/app-bar.css +14 -0
- package/dist/sources/ascii-field.css +3 -0
- package/dist/sources/aspect-ratio.css +3 -0
- package/dist/sources/audio-player.css +20 -0
- package/dist/sources/avatar.css +3 -0
- package/dist/sources/badge.css +3 -0
- package/dist/sources/bottom-nav.css +9 -0
- package/dist/sources/breadcrumb.css +14 -0
- package/dist/sources/button-group.css +3 -0
- package/dist/sources/button.css +9 -0
- package/dist/sources/calendar.css +13 -0
- package/dist/sources/card.css +3 -0
- package/dist/sources/carousel.css +11 -0
- package/dist/sources/chart.css +5 -0
- package/dist/sources/checkbox.css +6 -0
- package/dist/sources/code-block.css +13 -0
- package/dist/sources/collapsible.css +4 -0
- package/dist/sources/color-picker.css +13 -0
- package/dist/sources/combobox.css +13 -0
- package/dist/sources/command.css +13 -0
- package/dist/sources/context-menu.css +12 -0
- package/dist/sources/conversation.css +10 -0
- package/dist/sources/copy-button.css +10 -0
- package/dist/sources/data-table.css +27 -0
- package/dist/sources/date-picker.css +20 -0
- package/dist/sources/dialog.css +9 -0
- package/dist/sources/direction.css +2 -0
- package/dist/sources/drawer.css +9 -0
- package/dist/sources/drawing.css +5 -0
- package/dist/sources/empty.css +3 -0
- package/dist/sources/feature-list.css +4 -0
- package/dist/sources/field.css +4 -0
- package/dist/sources/file-drop.css +15 -0
- package/dist/sources/filter-bar.css +30 -0
- package/dist/sources/form.css +4 -0
- package/dist/sources/graph.css +19 -0
- package/dist/sources/illustration.css +28 -0
- package/dist/sources/input-group.css +7 -0
- package/dist/sources/input.css +3 -0
- package/dist/sources/item.css +4 -0
- package/dist/sources/kbd.css +5 -0
- package/dist/sources/label.css +3 -0
- package/dist/sources/layout.css +3 -0
- package/dist/sources/lightbox.css +33 -0
- package/dist/sources/locale.css +2 -0
- package/dist/sources/logo.css +4 -0
- package/dist/sources/markdown-editor.css +41 -0
- package/dist/sources/mentions.css +13 -0
- package/dist/sources/menu.css +11 -0
- package/dist/sources/menubar.css +14 -0
- package/dist/sources/message.css +16 -0
- package/dist/sources/meter.css +4 -0
- package/dist/sources/money-input.css +10 -0
- package/dist/sources/native-select.css +4 -0
- package/dist/sources/navigation-menu.css +8 -0
- package/dist/sources/number-field.css +8 -0
- package/dist/sources/number-roll.css +6 -0
- package/dist/sources/otp-field.css +5 -0
- package/dist/sources/pagination.css +11 -0
- package/dist/sources/pdf-viewer.css +30 -0
- package/dist/sources/phone-input.css +20 -0
- package/dist/sources/popover.css +7 -0
- package/dist/sources/preview-card.css +7 -0
- package/dist/sources/progress.css +4 -0
- package/dist/sources/prompt-input.css +15 -0
- package/dist/sources/pull-to-refresh.css +14 -0
- package/dist/sources/quote.css +3 -0
- package/dist/sources/radio-group.css +5 -0
- package/dist/sources/rating.css +6 -0
- package/dist/sources/reasoning.css +6 -0
- package/dist/sources/resizable.css +4 -0
- package/dist/sources/response.css +16 -0
- package/dist/sources/scheduler.css +44 -0
- package/dist/sources/scroll-area.css +3 -0
- package/dist/sources/select.css +12 -0
- package/dist/sources/separator.css +3 -0
- package/dist/sources/sidebar.css +19 -0
- package/dist/sources/site-header.css +15 -0
- package/dist/sources/skeleton.css +3 -0
- package/dist/sources/slider.css +6 -0
- package/dist/sources/sortable.css +12 -0
- package/dist/sources/sources.css +6 -0
- package/dist/sources/spinner.css +6 -0
- package/dist/sources/stat.css +9 -0
- package/dist/sources/stepper.css +6 -0
- package/dist/sources/suggestions.css +10 -0
- package/dist/sources/swipe-actions.css +20 -0
- package/dist/sources/switch.css +5 -0
- package/dist/sources/table.css +7 -0
- package/dist/sources/tabs.css +5 -0
- package/dist/sources/tag.css +3 -0
- package/dist/sources/tags-input.css +6 -0
- package/dist/sources/textarea.css +3 -0
- package/dist/sources/theme.css +13 -0
- package/dist/sources/time-field.css +7 -0
- package/dist/sources/timeline.css +7 -0
- package/dist/sources/tippy.css +6 -0
- package/dist/sources/toast.css +6 -0
- package/dist/sources/toggle-group.css +5 -0
- package/dist/sources/toggle.css +3 -0
- package/dist/sources/tool-call.css +16 -0
- package/dist/sources/toolbar.css +14 -0
- package/dist/sources/tooltip.css +6 -0
- package/dist/sources/tour.css +14 -0
- package/dist/sources/tree.css +6 -0
- package/dist/sources/typography.css +4 -0
- package/dist/sources/video-player.css +21 -0
- package/dist/styles/ai.css +3 -0
- package/dist/styles/brand.css +98 -0
- package/dist/styles/core.css +266 -0
- package/dist/styles/editor.css +3 -0
- package/dist/styles/expressive.css +75 -77
- package/dist/styles/fonts.css +61 -117
- package/dist/styles/graph.css +4 -0
- package/dist/styles/illustration.css +4 -0
- package/dist/styles/index.css +11 -193
- package/dist/styles/material.css +177 -31
- package/dist/styles/parts/ai.css +20 -14
- package/dist/styles/parts/brand.css +2 -2
- package/dist/styles/parts/controls.css +51 -38
- package/dist/styles/parts/data.css +43 -11
- package/dist/styles/parts/editor.css +372 -0
- package/dist/styles/parts/feedback.css +75 -15
- package/dist/styles/parts/foundations.css +12 -7
- package/dist/styles/parts/graph.css +25 -9
- package/dist/styles/parts/inputs.css +172 -9
- package/dist/styles/parts/isometric.css +6 -5
- package/dist/styles/parts/navigation.css +237 -25
- package/dist/styles/parts/overlays.css +110 -8
- package/dist/styles/parts/pdf.css +15 -9
- package/dist/styles/pdf.css +3 -0
- package/dist/styles/prose.css +3 -0
- package/dist/styles/tokens.css +105 -15
- package/dist/theme.d.ts +1 -0
- package/dist/theme.js +5 -0
- package/dist/vite.d.ts +48 -59
- package/dist/vite.js +54 -21
- package/package.json +69 -2
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
# Kbd
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Kbd, KbdGroup } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
export function Keys() {
|
|
7
|
+
return (
|
|
8
|
+
<div className="flex flex-wrap items-center gap-4">
|
|
9
|
+
<KbdGroup>
|
|
10
|
+
<Kbd>
|
|
11
|
+
<span aria-hidden>⌘</span>
|
|
12
|
+
<span className="sr-only">Command</span>
|
|
13
|
+
</Kbd>
|
|
14
|
+
<Kbd>K</Kbd>
|
|
15
|
+
</KbdGroup>
|
|
16
|
+
<KbdGroup>
|
|
17
|
+
<Kbd>Ctrl</Kbd>
|
|
18
|
+
<Kbd>Shift</Kbd>
|
|
19
|
+
<Kbd>P</Kbd>
|
|
20
|
+
</KbdGroup>
|
|
21
|
+
<Kbd>Esc</Kbd>
|
|
22
|
+
<Kbd>/</Kbd>
|
|
23
|
+
</div>
|
|
24
|
+
);
|
|
25
|
+
}
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
A raised mini key: Licht Mono 11px, 20px tall, 5px radius. `KbdGroup` lays out a chord; `KbdShortcut` writes one for the reader's device.
|
|
29
|
+
|
|
30
|
+
## Usage
|
|
31
|
+
|
|
32
|
+
```tsx
|
|
33
|
+
import { Kbd, KbdGroup, KbdShortcut } from "@zonsh/ui";
|
|
34
|
+
|
|
35
|
+
<KbdShortcut keys={["mod", "K"]} /> // ⌘ K on a Mac, Ctrl K elsewhere
|
|
36
|
+
|
|
37
|
+
<KbdGroup>
|
|
38
|
+
<Kbd>⌘</Kbd>
|
|
39
|
+
<Kbd>K</Kbd>
|
|
40
|
+
</KbdGroup>;
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
Use `KbdShortcut` for any shortcut with a modifier.
|
|
44
|
+
|
|
45
|
+
## When to use
|
|
46
|
+
|
|
47
|
+
- Shortcuts in menus, tooltips, sidebars and docs.
|
|
48
|
+
- Not code (`CodeBlock`) or labels (`Tag`).
|
|
49
|
+
|
|
50
|
+
## Examples
|
|
51
|
+
|
|
52
|
+
### In text
|
|
53
|
+
|
|
54
|
+
```tsx
|
|
55
|
+
import { Kbd } from "@zonsh/ui";
|
|
56
|
+
|
|
57
|
+
export function InText() {
|
|
58
|
+
return (
|
|
59
|
+
<p className="m-0 text-[15px] text-foreground-soft">
|
|
60
|
+
Press <Kbd>/</Kbd> to search the documentation, or <Kbd>Esc</Kbd> to close it.
|
|
61
|
+
</p>
|
|
62
|
+
);
|
|
63
|
+
}
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
### For the device
|
|
67
|
+
|
|
68
|
+
`mod` is ⌘ on a Mac, iPhone or iPad and Ctrl elsewhere; `shift`, `alt`, `ctrl`, `enter` become ⇧ ⌥ ⌃ ↵ on Apple keyboards. On a touch-only device `KbdShortcut` renders nothing. `useShortcutKeys()` returns `{ mod: "⌘" | "Ctrl", hasKeyboard }`. Handle the key the hint shows — `metaKey` on Apple, `ctrlKey` elsewhere — never either: on a Mac, Ctrl+B and Ctrl+K move the caret. The Sidebar's ⌘B / Ctrl+B works this way.
|
|
69
|
+
|
|
70
|
+
```tsx
|
|
71
|
+
import { KbdShortcut, useShortcutKeys } from "@zonsh/ui";
|
|
72
|
+
|
|
73
|
+
/** Shortcuts written for the device: ⌘ on Apple, Ctrl elsewhere; nothing on a touch-only phone. */
|
|
74
|
+
export function ForTheDevice() {
|
|
75
|
+
const { hasKeyboard } = useShortcutKeys();
|
|
76
|
+
return (
|
|
77
|
+
<div className="flex flex-col gap-3 text-sm text-foreground-soft">
|
|
78
|
+
{/* On a phone the shortcuts render nothing: say so, or the labels look orphaned. */}
|
|
79
|
+
{!hasKeyboard && (
|
|
80
|
+
<p className="m-0 font-mono text-xs text-muted-foreground">No keyboard here, so no shortcuts.</p>
|
|
81
|
+
)}
|
|
82
|
+
<p className="m-0 flex items-center gap-2">
|
|
83
|
+
Search <KbdShortcut keys={["mod", "K"]} />
|
|
84
|
+
</p>
|
|
85
|
+
<p className="m-0 flex items-center gap-2">
|
|
86
|
+
Redo <KbdShortcut keys={["mod", "shift", "Z"]} />
|
|
87
|
+
</p>
|
|
88
|
+
<p className="m-0 flex items-center gap-2">
|
|
89
|
+
Send <KbdShortcut keys={["mod", "enter"]} />
|
|
90
|
+
</p>
|
|
91
|
+
</div>
|
|
92
|
+
);
|
|
93
|
+
}
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
## Props
|
|
97
|
+
|
|
98
|
+
`Kbd` and `KbdGroup` forward all `<kbd>` props; no variants. `KbdShortcut` takes `keys` (one string per key) and forwards the rest to its `KbdGroup`.
|
|
99
|
+
|
|
100
|
+
Off Apple keyboards the modifier names come from `messages.kbd` (`ctrl`, `shift`, `alt`, `enter`) — German prints Strg and Umschalt. `KbdShortcut` and `MenuShortcut` use them; `useKeyNames()` returns them for your own `formatShortcut(keys, mod, names)`.
|
|
101
|
+
|
|
102
|
+
## Brand rules
|
|
103
|
+
|
|
104
|
+
- **Do** use one `Kbd` per key and the platform's symbols; never write ⌘ for everyone.
|
|
105
|
+
- **Don't** put words or sentences in a key.
|
|
106
|
+
- **Don't** make keys interactive.
|
|
107
|
+
|
|
108
|
+
## Accessibility
|
|
109
|
+
|
|
110
|
+
- Renders `<kbd>`, which screen readers announce as keyboard input.
|
|
111
|
+
- Symbols like ⌘ are read inconsistently; where it matters add a hidden name: `<Kbd><span aria-hidden>⌘</span><span className="sr-only">Command</span></Kbd>`.
|
|
112
|
+
|
|
113
|
+
---
|
|
114
|
+
|
|
115
|
+
- Import: `import { Kbd, KbdGroup, KbdShortcut, useShortcutKeys, useKeyNames } from "@zonsh/ui"`
|
|
116
|
+
- Source: `packages/ui/src/components/kbd.tsx`
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
# Label
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Label, Switch } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
export function Basic() {
|
|
7
|
+
return (
|
|
8
|
+
<Label>
|
|
9
|
+
<Switch defaultChecked />
|
|
10
|
+
Show archived projects
|
|
11
|
+
</Label>
|
|
12
|
+
);
|
|
13
|
+
}
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
A plain `<label>` in Licht Sans 14px medium. A wrapped switch or checkbox sits 10px beside the text, and the whole label is the click target. It dims to 55% when its control is disabled — nested, a `peer` just before it, or a `group` ancestor with `data-disabled`.
|
|
17
|
+
|
|
18
|
+
**Inside forms, use `FieldLabel`:** `Field` wires label, description, error and validation state; `Label` does none of that.
|
|
19
|
+
|
|
20
|
+
## Usage
|
|
21
|
+
|
|
22
|
+
```tsx
|
|
23
|
+
import { Label, Switch } from "@zonsh/ui";
|
|
24
|
+
|
|
25
|
+
<Label>
|
|
26
|
+
<Switch defaultChecked />
|
|
27
|
+
Show archived projects
|
|
28
|
+
</Label>;
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
Wrap the control, or point at it with `htmlFor`.
|
|
32
|
+
|
|
33
|
+
## When to use
|
|
34
|
+
|
|
35
|
+
- A control outside a form: a toolbar switch, a table-header checkbox, a side-panel filter.
|
|
36
|
+
- A native or third-party input that cannot sit in `Field` (`htmlFor`).
|
|
37
|
+
- Anything submitted, validated or described: `Field` + `FieldLabel`.
|
|
38
|
+
|
|
39
|
+
## Examples
|
|
40
|
+
|
|
41
|
+
### Disabled
|
|
42
|
+
|
|
43
|
+
```tsx
|
|
44
|
+
import { Checkbox, Label } from "@zonsh/ui";
|
|
45
|
+
|
|
46
|
+
export function Disabled() {
|
|
47
|
+
return (
|
|
48
|
+
<div className="flex flex-col gap-4">
|
|
49
|
+
<Label>
|
|
50
|
+
<Checkbox defaultChecked />
|
|
51
|
+
Include draft articles
|
|
52
|
+
</Label>
|
|
53
|
+
<Label>
|
|
54
|
+
<Checkbox disabled />
|
|
55
|
+
Include deleted articles
|
|
56
|
+
</Label>
|
|
57
|
+
</div>
|
|
58
|
+
);
|
|
59
|
+
}
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
### Peer control
|
|
63
|
+
|
|
64
|
+
With `htmlFor`, give the control `peer` and place the label after it (`flex-col-reverse` puts it back on top).
|
|
65
|
+
|
|
66
|
+
```tsx
|
|
67
|
+
import { Input, Label } from "@zonsh/ui";
|
|
68
|
+
|
|
69
|
+
export function PeerControl() {
|
|
70
|
+
return (
|
|
71
|
+
<div className="flex max-w-xs flex-col-reverse gap-2">
|
|
72
|
+
<Input id="workspace-name" defaultValue="Field notes" disabled className="peer" />
|
|
73
|
+
<Label htmlFor="workspace-name">Workspace name</Label>
|
|
74
|
+
</div>
|
|
75
|
+
);
|
|
76
|
+
}
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
## Props
|
|
80
|
+
|
|
81
|
+
| Prop | Type | Default |
|
|
82
|
+
| --------- | ----------------------------------------- | ------- |
|
|
83
|
+
| `htmlFor` | `string` — the id of the control | — |
|
|
84
|
+
| `render` | `ReactElement \| (props) => ReactElement` | — |
|
|
85
|
+
|
|
86
|
+
All `<label>` props are forwarded. Data attribute: `data-slot="label"`.
|
|
87
|
+
|
|
88
|
+
## Brand rules
|
|
89
|
+
|
|
90
|
+
- **Do** use mixed case and say what the control does: "Show archived projects".
|
|
91
|
+
- **Do** use `FieldLabel` inside forms.
|
|
92
|
+
- **Don't** set labels in Licht Mono or uppercase (that is eyebrows).
|
|
93
|
+
- **Don't** hide the label and rely on a placeholder.
|
|
94
|
+
|
|
95
|
+
## Accessibility
|
|
96
|
+
|
|
97
|
+
- Every control needs a visible label: wrap the control, or point at it with `htmlFor`.
|
|
98
|
+
- `Switch` and `Checkbox` render a hidden native input, so a wrapping label toggles and names them.
|
|
99
|
+
- Dimming is visual only; the control itself carries `disabled` / `data-disabled` for assistive technology.
|
|
100
|
+
|
|
101
|
+
---
|
|
102
|
+
|
|
103
|
+
- Import: `import { Label } from "@zonsh/ui"`
|
|
104
|
+
- Source: `packages/ui/src/components/label.tsx`
|
|
@@ -0,0 +1,291 @@
|
|
|
1
|
+
# Layout
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Heading, Section, Text } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
export function Sections() {
|
|
7
|
+
return (
|
|
8
|
+
<div className="@container w-full">
|
|
9
|
+
<Section index={1} label="The idea">
|
|
10
|
+
<div className="grid gap-4 @2xl:grid-cols-2 @2xl:gap-12">
|
|
11
|
+
<Heading>Your photos, in one quiet place</Heading>
|
|
12
|
+
<Text tone="soft">
|
|
13
|
+
Every photo from your phone, your camera and that old hard drive, sorted by date and place, with
|
|
14
|
+
nothing asking for your attention.
|
|
15
|
+
</Text>
|
|
16
|
+
</div>
|
|
17
|
+
</Section>
|
|
18
|
+
<Section index={2} label="How it works" last>
|
|
19
|
+
<div className="grid gap-4 @2xl:grid-cols-2 @2xl:gap-12">
|
|
20
|
+
<Heading>Backups you can forget about</Heading>
|
|
21
|
+
<Text tone="soft">
|
|
22
|
+
New photos upload when you are on Wi-Fi, duplicates are set aside for you to check, and the
|
|
23
|
+
originals are kept at full resolution.
|
|
24
|
+
</Text>
|
|
25
|
+
</div>
|
|
26
|
+
</Section>
|
|
27
|
+
</div>
|
|
28
|
+
);
|
|
29
|
+
}
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
Pages built from whitespace and fine rules: one centred column (`Container`), bands split by a hairline and generous padding (`Section`, never a box), and a drawing-board layer of rails, crosshair marks and the blueprint grid. Everything decorative is `aria-hidden`, ignores the pointer and holds still under reduced motion.
|
|
33
|
+
|
|
34
|
+
## Usage
|
|
35
|
+
|
|
36
|
+
```tsx
|
|
37
|
+
import { Container, Section, Heading, Text } from "@zonsh/ui";
|
|
38
|
+
|
|
39
|
+
<Container>
|
|
40
|
+
<Section index={1} label="The idea">
|
|
41
|
+
<Heading>Your photos, in one quiet place</Heading>
|
|
42
|
+
<Text>Sorted by date and place, with nothing asking for your attention.</Text>
|
|
43
|
+
</Section>
|
|
44
|
+
<Section index={2} label="How it works" last>
|
|
45
|
+
…
|
|
46
|
+
</Section>
|
|
47
|
+
</Container>;
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
On `Section`: `label` (eyebrow), `index` (zero-padded: "01 / THE IDEA") and `last` (adds the closing bottom rule).
|
|
51
|
+
|
|
52
|
+
## When to use
|
|
53
|
+
|
|
54
|
+
- `Container` — every horizontal band of the page: max 1280px, 24px gutters, 40px at `sm`, 64px at `lg`.
|
|
55
|
+
- `Section` — the default grouping: a top hairline, `--section-pad` above and below (56–112px). Number sections only when order means something (a sequence, a long reference page); otherwise a plain `label` or none. A marketing page that numbers every section reads as a copy of zon.sh (see `marketing.md`). A band of your own that should keep the same rhythm (a closing call to action) takes the token directly: `py-(--section-pad)`.
|
|
56
|
+
- `Grid` + `GridItem` — the 12-column page grid with responsive spans.
|
|
57
|
+
- `Rails` — two vertical hairlines framing a column.
|
|
58
|
+
- `PlusMark` / `Crosshairs` — 11px crosshairs where two rules meet.
|
|
59
|
+
- `Blueprint` — the drawing-board grid behind headlines and art; a light eases after the pointer.
|
|
60
|
+
- `DotField` — a quieter 24px dot texture.
|
|
61
|
+
- `Grain` — film grain for large or dark expressive regions; it moves only on a desktop (fine hovering pointer, 48rem wide, motion allowed).
|
|
62
|
+
- The page ground — zon.sh's still grain behind everything, opt-in with `brand.css` (below).
|
|
63
|
+
- `Divider` — a hairline inside a column, optionally with a short mono label.
|
|
64
|
+
|
|
65
|
+
Spacing follows one rhythm: **4, 8, 12, 16, 24, 32, 48, 64, 96px**.
|
|
66
|
+
|
|
67
|
+
## Examples
|
|
68
|
+
|
|
69
|
+
### Grid layout
|
|
70
|
+
|
|
71
|
+
`span` is mobile-first; each breakpoint inherits the one before it.
|
|
72
|
+
|
|
73
|
+
```tsx
|
|
74
|
+
import { Eyebrow, Grid, GridItem, Heading, Text } from "@zonsh/ui";
|
|
75
|
+
|
|
76
|
+
export function GridLayout() {
|
|
77
|
+
const cells = [
|
|
78
|
+
["Line", "Confident strokes, one page at a time."],
|
|
79
|
+
["Light", "Shading, shadow and form."],
|
|
80
|
+
["Colour", "Mixing, harmony and restraint."],
|
|
81
|
+
] as const;
|
|
82
|
+
return (
|
|
83
|
+
<Grid>
|
|
84
|
+
<GridItem span={{ base: 12, md: 4 }}>
|
|
85
|
+
<Eyebrow>Courses</Eyebrow>
|
|
86
|
+
</GridItem>
|
|
87
|
+
<GridItem span={{ base: 12, md: 8 }}>
|
|
88
|
+
<Heading level={3}>Three places to start if you are new to drawing.</Heading>
|
|
89
|
+
</GridItem>
|
|
90
|
+
{cells.map(([title, body]) => (
|
|
91
|
+
<GridItem key={title} span={{ base: 12, sm: 6, lg: 4 }} className="pt-6 hairline">
|
|
92
|
+
<Heading level={4}>{title}</Heading>
|
|
93
|
+
<Text tone="soft" size="sm" className="mt-2">
|
|
94
|
+
{body}
|
|
95
|
+
</Text>
|
|
96
|
+
</GridItem>
|
|
97
|
+
))}
|
|
98
|
+
</Grid>
|
|
99
|
+
);
|
|
100
|
+
}
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
### Rails and marks
|
|
104
|
+
|
|
105
|
+
`Crosshairs` marks a square region's corners where its border meets the rails.
|
|
106
|
+
|
|
107
|
+
```tsx
|
|
108
|
+
import { Crosshairs, Eyebrow, Heading, Rails, Text } from "@zonsh/ui";
|
|
109
|
+
|
|
110
|
+
export function RailsAndMarks() {
|
|
111
|
+
return (
|
|
112
|
+
<Rails className="@container w-full px-6 py-12 @2xl:px-12">
|
|
113
|
+
<div className="relative border border-field-edge p-8 @2xl:p-12">
|
|
114
|
+
<Crosshairs />
|
|
115
|
+
<Eyebrow>Plan · 01</Eyebrow>
|
|
116
|
+
<Heading level={3} className="mt-4">
|
|
117
|
+
A square region, marked at its corners.
|
|
118
|
+
</Heading>
|
|
119
|
+
<Text tone="soft" className="mt-3 max-w-[52ch]">
|
|
120
|
+
Crosshairs sit exactly on the corner intersections of a 1px border.
|
|
121
|
+
</Text>
|
|
122
|
+
</div>
|
|
123
|
+
</Rails>
|
|
124
|
+
);
|
|
125
|
+
}
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
### Marks
|
|
129
|
+
|
|
130
|
+
A `PlusMark` where an inner rule meets the border, offset -6px so its lines land on the rules.
|
|
131
|
+
|
|
132
|
+
```tsx
|
|
133
|
+
import { Eyebrow, PlusMark, Text } from "@zonsh/ui";
|
|
134
|
+
|
|
135
|
+
export function Marks() {
|
|
136
|
+
return (
|
|
137
|
+
<div className="@container w-full">
|
|
138
|
+
<div className="relative grid border border-field-edge @xl:grid-cols-2">
|
|
139
|
+
<div className="p-8 @xl:border-r @xl:border-field-edge">
|
|
140
|
+
<Eyebrow>Before</Eyebrow>
|
|
141
|
+
<Text tone="soft" className="mt-3">
|
|
142
|
+
Bookings are scattered across emails, PDFs and screenshots.
|
|
143
|
+
</Text>
|
|
144
|
+
</div>
|
|
145
|
+
<div className="border-t border-field-edge p-8 @xl:border-t-0">
|
|
146
|
+
<Eyebrow>After</Eyebrow>
|
|
147
|
+
<Text tone="soft" className="mt-3">
|
|
148
|
+
Flights, stays and tickets sit in one itinerary, in order.
|
|
149
|
+
</Text>
|
|
150
|
+
</div>
|
|
151
|
+
<PlusMark className="-top-[6px] left-1/2 -ml-[6px] hidden @xl:block" />
|
|
152
|
+
<PlusMark className="-bottom-[6px] left-1/2 -ml-[6px] hidden @xl:block" />
|
|
153
|
+
</div>
|
|
154
|
+
</div>
|
|
155
|
+
);
|
|
156
|
+
}
|
|
157
|
+
```
|
|
158
|
+
|
|
159
|
+
### Blueprint hero
|
|
160
|
+
|
|
161
|
+
Touch and reduced-motion users see the grid static.
|
|
162
|
+
|
|
163
|
+
```tsx
|
|
164
|
+
import { Blueprint, Container, Display, Eyebrow, Lead } from "@zonsh/ui";
|
|
165
|
+
|
|
166
|
+
export function BlueprintHero() {
|
|
167
|
+
return (
|
|
168
|
+
<Blueprint className="@container w-full overflow-hidden border border-field-edge">
|
|
169
|
+
<Container className="py-24 @3xl:py-32">
|
|
170
|
+
<Eyebrow>zon.sh</Eyebrow>
|
|
171
|
+
<Display className="mt-6 max-w-3xl">Less noise. More signal.</Display>
|
|
172
|
+
<Lead className="mt-6">Move a mouse across the grid: it lights up under the pointer.</Lead>
|
|
173
|
+
</Container>
|
|
174
|
+
</Blueprint>
|
|
175
|
+
);
|
|
176
|
+
}
|
|
177
|
+
```
|
|
178
|
+
|
|
179
|
+
### Textures
|
|
180
|
+
|
|
181
|
+
```tsx
|
|
182
|
+
import { Blueprint, DotField, Grain } from "@zonsh/ui";
|
|
183
|
+
|
|
184
|
+
export function Textures() {
|
|
185
|
+
return (
|
|
186
|
+
<div className="@container w-full">
|
|
187
|
+
<div className="grid gap-6 @2xl:grid-cols-3">
|
|
188
|
+
<Blueprint cell={32} className="h-48 border border-field-edge" />
|
|
189
|
+
<DotField className="h-48 border border-field-edge" />
|
|
190
|
+
<div className="relative h-48 overflow-hidden border border-field-edge bg-background">
|
|
191
|
+
<Grain />
|
|
192
|
+
<span className="absolute bottom-4 left-4 eyebrow">Grain</span>
|
|
193
|
+
</div>
|
|
194
|
+
</div>
|
|
195
|
+
</div>
|
|
196
|
+
);
|
|
197
|
+
}
|
|
198
|
+
```
|
|
199
|
+
|
|
200
|
+
### Page ground
|
|
201
|
+
|
|
202
|
+
Without it the page is plain `--background`. The zon.sh ground is one line after `styles.css`:
|
|
203
|
+
|
|
204
|
+
```css
|
|
205
|
+
@import "@zonsh/ui/styles.css";
|
|
206
|
+
@import "@zonsh/ui/brand.css";
|
|
207
|
+
```
|
|
208
|
+
|
|
209
|
+
It gives `<body>` still Grain fixed to the viewport with a faint light from above (`--page-glow`), and the same in the bars on the ground (`surface-page`, `SiteHeader`, `BottomNav`). It sits beneath all content, so cards, fields and text stay clean. Keep page-level wrappers transparent — any `bg-background` between body and content covers it; overlays that replace the page keep their fill. Dark grounds blend with overlay and screen; light ones multiply at `--page-grain-opacity` (0.1). It never moves, so needs no reduced-motion fallback.
|
|
210
|
+
|
|
211
|
+
To drop the grain but keep the ground and its light:
|
|
212
|
+
|
|
213
|
+
```css
|
|
214
|
+
body::before,
|
|
215
|
+
body::after {
|
|
216
|
+
content: none;
|
|
217
|
+
}
|
|
218
|
+
```
|
|
219
|
+
|
|
220
|
+
### Phone edges
|
|
221
|
+
|
|
222
|
+
A phone browser's status bar, toolbar and (on iPhone) the strip uncovered as the toolbar shrinks are not drawn by the page. With `brand.css` they match the ground:
|
|
223
|
+
|
|
224
|
+
- **The ground reaches past the window.** The ground (`html::before`) and its grain run a tenth of the window below the bottom edge; grain never extends past the ground under it.
|
|
225
|
+
- **The browser's bars take the page tone.** `--page-tone` is the ground as one flat colour (`#f9f9f9` light, `#141414` dark). `<html>` is painted in it (in `--background` without `brand.css`), and `themeScript` and `ThemeProvider` keep `<meta name="theme-color">` at it (`PAGE_TONE`, see Theme).
|
|
226
|
+
- **Edge to edge as a home-screen app.** On an iPhone home screen the page can draw under the status bar too, with two tags in `<head>`:
|
|
227
|
+
|
|
228
|
+
```html
|
|
229
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
|
|
230
|
+
<meta name="apple-mobile-web-app-status-bar-style" content="black-translucent" />
|
|
231
|
+
```
|
|
232
|
+
|
|
233
|
+
The page then runs under the notch and home indicator too. The library keeps clear: `Container` pads at least the side safe area, `SiteHeader` sits below the status bar, `Drawer` sheets and `Toaster` above the home indicator, `Lightbox` controls clear on every side. Add the inset to anything of your own pinned to an edge: `bottom: calc(1rem + env(safe-area-inset-bottom, 0px))` (0 without `viewport-fit=cover`).
|
|
234
|
+
|
|
235
|
+
### Dividers
|
|
236
|
+
|
|
237
|
+
```tsx
|
|
238
|
+
import { Divider, Text } from "@zonsh/ui";
|
|
239
|
+
|
|
240
|
+
export function Dividers() {
|
|
241
|
+
return (
|
|
242
|
+
<div className="flex max-w-xl flex-col gap-10">
|
|
243
|
+
<Text>Write a few lines every day; the habit matters more than the length.</Text>
|
|
244
|
+
<Divider />
|
|
245
|
+
<Text>Start from a blank page, or pick a template.</Text>
|
|
246
|
+
<Divider label="or" />
|
|
247
|
+
<Text>Import your notes from another app.</Text>
|
|
248
|
+
</div>
|
|
249
|
+
);
|
|
250
|
+
}
|
|
251
|
+
```
|
|
252
|
+
|
|
253
|
+
## Props
|
|
254
|
+
|
|
255
|
+
| Component | Prop | Type | Default |
|
|
256
|
+
| ----------- | ------------- | ----------------------------------------------------------- | ----------- |
|
|
257
|
+
| `Container` | `as` | `"div" \| "section" \| "main" \| "header" \| "footer" \| …` | `"div"` |
|
|
258
|
+
| `Section` | `label` | `ReactNode` — eyebrow label | — |
|
|
259
|
+
| `Section` | `index` | `number \| string` — numbers are zero-padded | — |
|
|
260
|
+
| `Section` | `last` | `boolean` — adds the closing bottom rule | `false` |
|
|
261
|
+
| `Section` | `as` | region tag | `"section"` |
|
|
262
|
+
| `GridItem` | `span` | `1–12 \| { base?, sm?, md?, lg? }` | `12` |
|
|
263
|
+
| `Rails` | `as` | region tag | `"div"` |
|
|
264
|
+
| `Blueprint` | `cell` | `number` (px) `\| string` — grid cell size | `64` |
|
|
265
|
+
| `Blueprint` | `interactive` | `boolean` — light the grid under the pointer | `true` |
|
|
266
|
+
| `Divider` | `label` | `ReactNode` — centred mono label | — |
|
|
267
|
+
|
|
268
|
+
Other HTML attributes are forwarded. `Blueprint` exposes `data-lit="true|false"` and the CSS variables `--mx`, `--my` (pointer position) and `--cell`. `Section` sets `data-last` when it closes a run.
|
|
269
|
+
|
|
270
|
+
## Brand rules
|
|
271
|
+
|
|
272
|
+
- **Do** group with a hairline and whitespace first. Reach for a surface only when the thing could be picked up and moved on its own.
|
|
273
|
+
- **Do** keep to the spacing rhythm: 4, 8, 12, 16, 24, 32, 48, 64, 96.
|
|
274
|
+
- **Do** use one texture per composition: Blueprint _or_ DotField _or_ Grain. The page ground is not a composition's texture, so it sits under any of them.
|
|
275
|
+
- **Don't** nest `Container`s; the gutters double.
|
|
276
|
+
- **Don't** paint a flat `bg-background` at the page's edges, or pin something to an edge without its safe-area inset: the browser's bars and the uncovered strip are the ground's colour, and on a home-screen app the status bar and home indicator sit over the page.
|
|
277
|
+
- **Don't** put `Crosshairs` on rounded cards. They mark the corners of square regions.
|
|
278
|
+
- **Don't** scatter `PlusMark`s as ornament. A mark sits where two lines meet.
|
|
279
|
+
- **Don't** set reading text over the lit area of a Blueprint or over moving Grain. The still page ground is made to sit under text.
|
|
280
|
+
|
|
281
|
+
## Accessibility
|
|
282
|
+
|
|
283
|
+
- `PlusMark`, `Crosshairs`, `Grain`, and `DotField` / `Blueprint` without children are `aria-hidden` and `pointer-events: none`.
|
|
284
|
+
- The pointer light runs only for hover-capable fine pointers with `prefers-reduced-motion: no-preference`; Grain stops animating under reduced motion.
|
|
285
|
+
- `Divider` without a label is a `role="separator"`. With a label, the rules are hidden and the label is read as text.
|
|
286
|
+
- `Section` is a `<section>`. Give it an accessible name (`aria-labelledby` pointing at its heading) when it should appear as a landmark.
|
|
287
|
+
|
|
288
|
+
---
|
|
289
|
+
|
|
290
|
+
- Import: `import { Container, Section, Grid, GridItem, Rails, PlusMark, Crosshairs, Blueprint } from "@zonsh/ui"`
|
|
291
|
+
- Source: `packages/ui/src/components/layout.tsx`
|