@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,296 @@
|
|
|
1
|
+
# Calendar
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Calendar } from "@zonsh/ui/calendar";
|
|
5
|
+
import { addDays, startOfToday } from "date-fns";
|
|
6
|
+
import * as React from "react";
|
|
7
|
+
|
|
8
|
+
/** A calendar shown inline is an object on the page, so it sits on a card. */
|
|
9
|
+
const card = "surface-card w-fit [--card-padding:4px]";
|
|
10
|
+
|
|
11
|
+
export function Basic() {
|
|
12
|
+
const [date, setDate] = React.useState<Date | undefined>(() => addDays(startOfToday(), 3));
|
|
13
|
+
return (
|
|
14
|
+
<div className={card}>
|
|
15
|
+
<Calendar mode="single" selected={date} onSelect={setDate} />
|
|
16
|
+
</div>
|
|
17
|
+
);
|
|
18
|
+
}
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
react-day-picker v10 in the zon material: a Licht caption, mono weekday eyebrows and 38px days with 7px corners. Today has a dot, the selection takes the primary fill, a range's middle sits on the hover fill, and disabled days are struck through. It has no surface of its own: in a `DatePicker` it sits in the popover; inline on a page, put it on a card.
|
|
22
|
+
|
|
23
|
+
## Usage
|
|
24
|
+
|
|
25
|
+
Calendar has its own entry, `@zonsh/ui/calendar`, and needs the optional dependency `react-day-picker`.
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
pnpm add react-day-picker
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
```tsx
|
|
32
|
+
import { Calendar } from "@zonsh/ui/calendar";
|
|
33
|
+
|
|
34
|
+
const [date, setDate] = React.useState<Date>();
|
|
35
|
+
|
|
36
|
+
<Calendar mode="single" selected={date} onSelect={setDate} />;
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
The props you'll reach for: `mode`, `selected` / `onSelect`, `disabled`.
|
|
40
|
+
|
|
41
|
+
## When to use
|
|
42
|
+
|
|
43
|
+
- A date where the weekday and its neighbours matter: a call, a delivery, a workshop; a range (`mode="range"`) or several days (`mode="multiple"`).
|
|
44
|
+
- In a form, use `DatePicker`, which opens the calendar from a field.
|
|
45
|
+
- Dates people know by heart (a birthday) are faster typed; if you must use a calendar, use `captionLayout="dropdown"`.
|
|
46
|
+
|
|
47
|
+
## Examples
|
|
48
|
+
|
|
49
|
+
### Range
|
|
50
|
+
|
|
51
|
+
Two months side by side; where they do not fit they stack, each arrow staying with its month.
|
|
52
|
+
|
|
53
|
+
```tsx
|
|
54
|
+
import { Calendar, type DateRange } from "@zonsh/ui/calendar";
|
|
55
|
+
import { addDays, startOfToday } from "date-fns";
|
|
56
|
+
import * as React from "react";
|
|
57
|
+
|
|
58
|
+
// card: as in the first example on this page that uses them.
|
|
59
|
+
|
|
60
|
+
export function Range() {
|
|
61
|
+
const [range, setRange] = React.useState<DateRange | undefined>(() => ({
|
|
62
|
+
from: addDays(startOfToday(), 2),
|
|
63
|
+
to: addDays(startOfToday(), 9),
|
|
64
|
+
}));
|
|
65
|
+
return (
|
|
66
|
+
<div className={card}>
|
|
67
|
+
<Calendar mode="range" numberOfMonths={2} selected={range} onSelect={setRange} />
|
|
68
|
+
</div>
|
|
69
|
+
);
|
|
70
|
+
}
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
### Multiple days
|
|
74
|
+
|
|
75
|
+
`max` limits how many days can be picked.
|
|
76
|
+
|
|
77
|
+
```tsx
|
|
78
|
+
import { Calendar } from "@zonsh/ui/calendar";
|
|
79
|
+
import { addDays, startOfToday } from "date-fns";
|
|
80
|
+
import * as React from "react";
|
|
81
|
+
|
|
82
|
+
// card: as in the first example on this page that uses them.
|
|
83
|
+
|
|
84
|
+
export function Multiple() {
|
|
85
|
+
const [days, setDays] = React.useState<Date[] | undefined>(() => [
|
|
86
|
+
addDays(startOfToday(), 1),
|
|
87
|
+
addDays(startOfToday(), 3),
|
|
88
|
+
addDays(startOfToday(), 8),
|
|
89
|
+
]);
|
|
90
|
+
return (
|
|
91
|
+
<div className={card}>
|
|
92
|
+
<Calendar
|
|
93
|
+
mode="multiple"
|
|
94
|
+
max={5}
|
|
95
|
+
selected={days}
|
|
96
|
+
onSelect={setDays}
|
|
97
|
+
footer={`${days?.length ?? 0} of 5 workshop days picked.`}
|
|
98
|
+
/>
|
|
99
|
+
</div>
|
|
100
|
+
);
|
|
101
|
+
}
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
### Month and year menus
|
|
105
|
+
|
|
106
|
+
`captionLayout="dropdown"` replaces the caption with month and year dropdowns; set `startMonth` and `endMonth` to the range people need. By default (`dropdown="native"`) they are dense `NativeSelect`s, so phones show their own picker.
|
|
107
|
+
|
|
108
|
+
```tsx
|
|
109
|
+
import { Calendar } from "@zonsh/ui/calendar";
|
|
110
|
+
import * as React from "react";
|
|
111
|
+
|
|
112
|
+
// card: as in the first example on this page that uses them.
|
|
113
|
+
|
|
114
|
+
export function Dropdowns() {
|
|
115
|
+
const [date, setDate] = React.useState<Date | undefined>();
|
|
116
|
+
return (
|
|
117
|
+
<div className={card}>
|
|
118
|
+
<Calendar
|
|
119
|
+
mode="single"
|
|
120
|
+
captionLayout="dropdown"
|
|
121
|
+
startMonth={new Date(2015, 0)}
|
|
122
|
+
endMonth={new Date(2030, 11)}
|
|
123
|
+
selected={date}
|
|
124
|
+
onSelect={setDate}
|
|
125
|
+
/>
|
|
126
|
+
</div>
|
|
127
|
+
);
|
|
128
|
+
}
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
### Custom dropdowns
|
|
132
|
+
|
|
133
|
+
`dropdown="custom"` draws them with our `Select`, for desktop surfaces where the native list looks out of place. Months outside `startMonth`/`endMonth` are disabled in both.
|
|
134
|
+
|
|
135
|
+
```tsx
|
|
136
|
+
import { Calendar } from "@zonsh/ui/calendar";
|
|
137
|
+
import * as React from "react";
|
|
138
|
+
|
|
139
|
+
// card: as in the first example on this page that uses them.
|
|
140
|
+
|
|
141
|
+
export function CustomDropdowns() {
|
|
142
|
+
const [date, setDate] = React.useState<Date | undefined>();
|
|
143
|
+
return (
|
|
144
|
+
<div className={card}>
|
|
145
|
+
<Calendar
|
|
146
|
+
mode="single"
|
|
147
|
+
captionLayout="dropdown"
|
|
148
|
+
dropdown="custom"
|
|
149
|
+
startMonth={new Date(2015, 0)}
|
|
150
|
+
endMonth={new Date(2030, 11)}
|
|
151
|
+
selected={date}
|
|
152
|
+
onSelect={setDate}
|
|
153
|
+
/>
|
|
154
|
+
</div>
|
|
155
|
+
);
|
|
156
|
+
}
|
|
157
|
+
```
|
|
158
|
+
|
|
159
|
+
### Locale and week start
|
|
160
|
+
|
|
161
|
+
A `react-day-picker/locale` locale sets the names, the first weekday (Monday in German) and the accessible labels; `date-fns/locale` locales work but keep English labels. `weekStartsOn` overrides the first day.
|
|
162
|
+
|
|
163
|
+
Weekdays are tracked capitals only in scripts with case (Latin, Greek, Cyrillic, Armenian); others stay untracked so joined letters hold together. Short names too wide for the column (Arabic's) switch to narrow ones: س ح ن. Your own `formatters.formatWeekdayName` is left alone.
|
|
164
|
+
|
|
165
|
+
```tsx
|
|
166
|
+
import { Calendar } from "@zonsh/ui/calendar";
|
|
167
|
+
import { startOfToday } from "date-fns";
|
|
168
|
+
import { de } from "react-day-picker/locale";
|
|
169
|
+
import * as React from "react";
|
|
170
|
+
|
|
171
|
+
// card: as in the first example on this page that uses them.
|
|
172
|
+
|
|
173
|
+
export function Locale() {
|
|
174
|
+
const [date, setDate] = React.useState<Date | undefined>(() => startOfToday());
|
|
175
|
+
return (
|
|
176
|
+
<div className="flex flex-wrap gap-6">
|
|
177
|
+
<figure className="m-0 flex flex-col gap-2">
|
|
178
|
+
<figcaption className="text-center eyebrow">US · weeks start Sunday</figcaption>
|
|
179
|
+
<div className={card}>
|
|
180
|
+
<Calendar mode="single" selected={date} onSelect={setDate} />
|
|
181
|
+
</div>
|
|
182
|
+
</figure>
|
|
183
|
+
<figure className="m-0 flex flex-col gap-2">
|
|
184
|
+
<figcaption className="text-center eyebrow">DE · weeks start Monday</figcaption>
|
|
185
|
+
<div className={card}>
|
|
186
|
+
<Calendar mode="single" locale={de} selected={date} onSelect={setDate} />
|
|
187
|
+
</div>
|
|
188
|
+
</figure>
|
|
189
|
+
</div>
|
|
190
|
+
);
|
|
191
|
+
}
|
|
192
|
+
```
|
|
193
|
+
|
|
194
|
+
### Disabled days
|
|
195
|
+
|
|
196
|
+
`disabled` takes matchers: `{ before: date }`, `{ dayOfWeek: [0, 6] }`, a date, a range or a function.
|
|
197
|
+
|
|
198
|
+
```tsx
|
|
199
|
+
import { Calendar } from "@zonsh/ui/calendar";
|
|
200
|
+
import { startOfToday } from "date-fns";
|
|
201
|
+
import * as React from "react";
|
|
202
|
+
|
|
203
|
+
// card: as in the first example on this page that uses them.
|
|
204
|
+
|
|
205
|
+
export function DisabledDays() {
|
|
206
|
+
const [date, setDate] = React.useState<Date | undefined>();
|
|
207
|
+
return (
|
|
208
|
+
<div className={card}>
|
|
209
|
+
<Calendar
|
|
210
|
+
mode="single"
|
|
211
|
+
selected={date}
|
|
212
|
+
onSelect={setDate}
|
|
213
|
+
weekStartsOn={1}
|
|
214
|
+
disabled={[{ before: startOfToday() }, { dayOfWeek: [0, 6] }]}
|
|
215
|
+
footer="Calls run Monday to Friday."
|
|
216
|
+
/>
|
|
217
|
+
</div>
|
|
218
|
+
);
|
|
219
|
+
}
|
|
220
|
+
```
|
|
221
|
+
|
|
222
|
+
### Week numbers
|
|
223
|
+
|
|
224
|
+
```tsx
|
|
225
|
+
import { Calendar } from "@zonsh/ui/calendar";
|
|
226
|
+
import { de } from "react-day-picker/locale";
|
|
227
|
+
|
|
228
|
+
// card: as in the first example on this page that uses them.
|
|
229
|
+
|
|
230
|
+
export function WeekNumbers() {
|
|
231
|
+
return (
|
|
232
|
+
<div className={card}>
|
|
233
|
+
<Calendar locale={de} showWeekNumber />
|
|
234
|
+
</div>
|
|
235
|
+
);
|
|
236
|
+
}
|
|
237
|
+
```
|
|
238
|
+
|
|
239
|
+
## Props
|
|
240
|
+
|
|
241
|
+
`Calendar` takes every react-day-picker `DayPicker` prop and sets these defaults:
|
|
242
|
+
|
|
243
|
+
| Prop | Type | Default |
|
|
244
|
+
| ----------------- | ---------------------------------------------------------------- | ----------- |
|
|
245
|
+
| `mode` | `"single" \| "multiple" \| "range"` | — |
|
|
246
|
+
| `selected` | `Date` \| `Date[]` \| `DateRange` | — |
|
|
247
|
+
| `onSelect` | `(selected, triggerDate, modifiers, event) => void` | — |
|
|
248
|
+
| `showOutsideDays` | `boolean` | `true` |
|
|
249
|
+
| `captionLayout` | `"label" \| "dropdown" \| "dropdown-months" \| "dropdown-years"` | `"label"` |
|
|
250
|
+
| `dropdown` | `"native" \| "custom"` — how the caption dropdowns are drawn | `"native"` |
|
|
251
|
+
| `numberOfMonths` | `number` | `1` |
|
|
252
|
+
| `locale` | a date-fns or `react-day-picker/locale` locale | `enUS` |
|
|
253
|
+
| `weekStartsOn` | `0`–`6` | from locale |
|
|
254
|
+
| `disabled` | `Matcher \| Matcher[]` | — |
|
|
255
|
+
|
|
256
|
+
Also forwarded: `month` / `defaultMonth` / `onMonthChange`, `startMonth` / `endMonth`, `min` / `max`, `required`, `showWeekNumber`, `fixedWeeks`, `footer`, `timeZone`, `modifiers`, `components` and `classNames` (merged with ours per part). The module also exports the `DateRange`, `CalendarLocale` and `CalendarMatcher` types. Data attributes on each day button: `data-selected-single`, `data-range-start`, `data-range-middle`, `data-range-end`, `data-today`, `data-outside`, `data-disabled`.
|
|
257
|
+
|
|
258
|
+
## Brand rules
|
|
259
|
+
|
|
260
|
+
- **Do** keep the selected day on the primary fill — the one dark object in the grid.
|
|
261
|
+
- **Do** put an inline calendar on a card; inside a popover it needs nothing more.
|
|
262
|
+
- **Do** use `react-day-picker/locale` locales so labels match the page.
|
|
263
|
+
- **Do** keep `dropdown="native"` for forms used mostly on phones; `custom` for desktop surfaces where the native list breaks the material.
|
|
264
|
+
- **Don't** fill day cells with colour. Use `disabled` or a `modifiers` class; to tell event kinds apart, a small category-colour dot named in a legend.
|
|
265
|
+
- **Don't** make cells smaller than 38px — they are the tap targets.
|
|
266
|
+
|
|
267
|
+
## Accessibility
|
|
268
|
+
|
|
269
|
+
- The month is a `grid`, one Tab stop.
|
|
270
|
+
- Right to left (a `DirectionProvider` or `dir="rtl"`), the grid, the previous/next buttons and the arrow keys all mirror.
|
|
271
|
+
- Each day has a full label ("Today, Monday, October 5th, 2026, selected") from the locale's `labels`.
|
|
272
|
+
- The caption is a live region: month changes are announced.
|
|
273
|
+
- Disabled days are not focusable, and struck through, not only muted.
|
|
274
|
+
- The today dot is decorative; "Today" is part of the label.
|
|
275
|
+
- In forced colours, selected days and ranges take the system Highlight; the today dot keeps its ink.
|
|
276
|
+
|
|
277
|
+
### Keyboard
|
|
278
|
+
|
|
279
|
+
| Key | What it does |
|
|
280
|
+
| ------------------------------- | -------------------------------------------------------------------------- |
|
|
281
|
+
| Tab | Moves between the month buttons, the month and year dropdowns and the grid |
|
|
282
|
+
| Enter / Space | Picks the focused day (in a range, its start, then its end) |
|
|
283
|
+
| ← / → | Moves a day back or forward (swapped right to left) |
|
|
284
|
+
| ↑ / ↓ | Moves a week back or forward |
|
|
285
|
+
| Shift+← / Shift+→ | Moves a month back or forward (swapped right to left) |
|
|
286
|
+
| Shift+↑ / Shift+↓ | Moves a year back or forward |
|
|
287
|
+
| Page Up / Page Down | Moves a month back or forward |
|
|
288
|
+
| Shift+Page Up / Shift+Page Down | Moves a year back or forward |
|
|
289
|
+
| Home / End | Moves to the first or last day of the week |
|
|
290
|
+
|
|
291
|
+
The grid's Tab stop is the day last focused, the selected day, today, or else the first day that can be picked. Moving past the month turns the page; disabled days are skipped.
|
|
292
|
+
|
|
293
|
+
---
|
|
294
|
+
|
|
295
|
+
- Import: `import { Calendar } from "@zonsh/ui/calendar"`
|
|
296
|
+
- Source: `packages/ui/src/components/calendar.tsx`
|
|
@@ -0,0 +1,158 @@
|
|
|
1
|
+
# Cards
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Button, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from "@zonsh/ui";
|
|
5
|
+
import { ArrowRightIcon } from "lucide-react";
|
|
6
|
+
|
|
7
|
+
export function ObjectCard() {
|
|
8
|
+
return (
|
|
9
|
+
<Card render={<article />} className="max-w-md">
|
|
10
|
+
<CardHeader>
|
|
11
|
+
<CardTitle>Typography basics</CardTitle>
|
|
12
|
+
<CardDescription>Six short lessons on choosing and pairing typefaces.</CardDescription>
|
|
13
|
+
</CardHeader>
|
|
14
|
+
<CardContent>
|
|
15
|
+
Learn how to set a readable line length, build a type scale and pair a serif with a sans. Each lesson
|
|
16
|
+
takes about ten minutes and ends with a small exercise you can check yourself.
|
|
17
|
+
</CardContent>
|
|
18
|
+
<CardFooter>
|
|
19
|
+
<Button>
|
|
20
|
+
Start course
|
|
21
|
+
<ArrowRightIcon className="rtl:-scale-x-100" />
|
|
22
|
+
</Button>
|
|
23
|
+
</CardFooter>
|
|
24
|
+
</Card>
|
|
25
|
+
);
|
|
26
|
+
}
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
A `Card` is an object with its own padding, a 20px radius and the one soft shadow; its footer holds one primary at most. `variant` gives three kinds, in the order to reach for them:
|
|
30
|
+
|
|
31
|
+
1. **`plain` — no box.** A top hairline and whitespace. The default way to group content.
|
|
32
|
+
2. **`region` — a part of the page** (a section panel, a specimen sheet, a cover): the `surface-container` material with **square** corners, no shadow.
|
|
33
|
+
3. **`card` — an object** _on_ the page (a quote, a pricing option, a form panel): the same material, a 20px radius, 24/32/40px padding and `0 4px 16px #0000000a`, the only drop shadow in the system.
|
|
34
|
+
|
|
35
|
+
## Usage
|
|
36
|
+
|
|
37
|
+
```tsx
|
|
38
|
+
import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@zonsh/ui";
|
|
39
|
+
|
|
40
|
+
<Card>
|
|
41
|
+
<CardHeader>
|
|
42
|
+
<CardTitle>Typography basics</CardTitle>
|
|
43
|
+
<CardDescription>Six short lessons on choosing and pairing typefaces.</CardDescription>
|
|
44
|
+
</CardHeader>
|
|
45
|
+
<CardContent>…</CardContent>
|
|
46
|
+
</Card>;
|
|
47
|
+
|
|
48
|
+
<Card variant="region" render={<section />}>…</Card>;
|
|
49
|
+
|
|
50
|
+
<Card variant="plain">…</Card>;
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
The props you'll reach for: `variant`, `render` (`<article />`, `<section />`), and `[--card-padding:0]` for full-bleed contents.
|
|
54
|
+
|
|
55
|
+
## When to use
|
|
56
|
+
|
|
57
|
+
| Ask, in this order | If yes | It looks like |
|
|
58
|
+
| ------------------------------------------------ | -------- | -------------------------------------------------- |
|
|
59
|
+
| Would a hairline rule and whitespace do? | `plain` | a top rule and space — no box |
|
|
60
|
+
| Is it a part _of_ the page — a section, a sheet? | `region` | the material, square, no shadow |
|
|
61
|
+
| Is it a thing _on_ the page — a quote, a form? | `card` | the material, 20px, its own padding, a soft shadow |
|
|
62
|
+
|
|
63
|
+
Could it be picked up and moved elsewhere on its own? A quote, a pricing card, a data table could — `card`. A section panel or page cover could not — `region`. When unsure, prefer a region. For features and steps in a grid, `FeatureList` adds a mono index and an icon to `plain`. A card holding inputs shares their `--field-edge` border.
|
|
64
|
+
|
|
65
|
+
## Examples
|
|
66
|
+
|
|
67
|
+
### Kinds
|
|
68
|
+
|
|
69
|
+
The same content as each kind.
|
|
70
|
+
|
|
71
|
+
```tsx
|
|
72
|
+
import { Card, CardDescription, CardHeader, CardTitle } from "@zonsh/ui";
|
|
73
|
+
|
|
74
|
+
const kinds = [
|
|
75
|
+
{ variant: "card", caption: "card · an object on the page" },
|
|
76
|
+
{ variant: "region", caption: "region · a part of the page" },
|
|
77
|
+
{ variant: "plain", caption: "plain · no box, a hairline" },
|
|
78
|
+
] as const;
|
|
79
|
+
|
|
80
|
+
/** The same content as each kind of card. */
|
|
81
|
+
export function Kinds() {
|
|
82
|
+
return (
|
|
83
|
+
// Columns by the room the example has, not the window: one per row in a narrow frame.
|
|
84
|
+
<div className="@container w-full max-w-5xl">
|
|
85
|
+
<div className="grid gap-6 @2xl:grid-cols-3">
|
|
86
|
+
{kinds.map((k) => (
|
|
87
|
+
<figure key={k.variant} className="m-0 flex flex-col gap-3">
|
|
88
|
+
<figcaption className="eyebrow">{k.caption}</figcaption>
|
|
89
|
+
<Card variant={k.variant} className="flex-1">
|
|
90
|
+
<CardHeader>
|
|
91
|
+
<CardTitle>Shared folders</CardTitle>
|
|
92
|
+
<CardDescription>
|
|
93
|
+
Invite people to a folder and decide who can edit and who can only read.
|
|
94
|
+
</CardDescription>
|
|
95
|
+
</CardHeader>
|
|
96
|
+
</Card>
|
|
97
|
+
</figure>
|
|
98
|
+
))}
|
|
99
|
+
</div>
|
|
100
|
+
</div>
|
|
101
|
+
);
|
|
102
|
+
}
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
### Form panel
|
|
106
|
+
|
|
107
|
+
```tsx
|
|
108
|
+
import { Button, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Field, FieldLabel, Input } from "@zonsh/ui";
|
|
109
|
+
|
|
110
|
+
export function FormPanel() {
|
|
111
|
+
return (
|
|
112
|
+
<Card className="max-w-md">
|
|
113
|
+
<CardHeader>
|
|
114
|
+
<CardTitle>New project</CardTitle>
|
|
115
|
+
<CardDescription>Give it a name now; you can change it later.</CardDescription>
|
|
116
|
+
</CardHeader>
|
|
117
|
+
<CardContent className="flex flex-col gap-4">
|
|
118
|
+
<Field>
|
|
119
|
+
<FieldLabel>Project name</FieldLabel>
|
|
120
|
+
<Input placeholder="my-app" />
|
|
121
|
+
</Field>
|
|
122
|
+
</CardContent>
|
|
123
|
+
<CardFooter>
|
|
124
|
+
<Button>Create project</Button>
|
|
125
|
+
</CardFooter>
|
|
126
|
+
</Card>
|
|
127
|
+
);
|
|
128
|
+
}
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
## Props
|
|
132
|
+
|
|
133
|
+
| Prop | Type | Default |
|
|
134
|
+
| ------------------ | ---------------------------------------------------------------------------------------------------- | -------- |
|
|
135
|
+
| `Card.variant` | `"card" \| "region" \| "plain"` | `"card"` |
|
|
136
|
+
| `Card.render` | `ReactElement` — e.g. `<article />`, `<section />` | `<div>` |
|
|
137
|
+
| `CardTitle.render` | `ReactElement` — another heading level | `<h3>` |
|
|
138
|
+
|
|
139
|
+
`CardHeader`, `CardDescription`, `CardContent` and `CardFooter` are plain elements; all forward props. Padding comes from `--card-padding`: set `[--card-padding:0]` for full bleed, never `p-0`. Data attributes: `data-slot="card"` with `data-variant`.
|
|
140
|
+
|
|
141
|
+
## Brand rules
|
|
142
|
+
|
|
143
|
+
- **Do** default to a hairline and whitespace (`plain`); box only when the thing is an object or a part of the page.
|
|
144
|
+
- **Do** let the card own its padding — never pad a `Card` at the call site.
|
|
145
|
+
- **Don't** round a part of the page or give it a shadow — it would look detachable. It is a `region`.
|
|
146
|
+
- **Don't** put `plain` cards inside a card, or "upgrade" a `plain` group to a `card`.
|
|
147
|
+
- **Don't** use `--border` for a card's edge; it is `--field-edge`, like the inputs inside it.
|
|
148
|
+
- **Don't** make a whole card hoverable with a flat fill. Link its title, or use the raised material.
|
|
149
|
+
|
|
150
|
+
## Accessibility
|
|
151
|
+
|
|
152
|
+
- Give a standalone card a `CardTitle`, and render self-contained content as `<article>`.
|
|
153
|
+
- Render a `region` as `<section>` with a heading, so it appears in the outline.
|
|
154
|
+
|
|
155
|
+
---
|
|
156
|
+
|
|
157
|
+
- Import: `import { Card, CardHeader, CardTitle, CardDescription, CardContent, CardFooter } from "@zonsh/ui"`
|
|
158
|
+
- Source: `packages/ui/src/components/card.tsx`
|