@zonsh/ui 0.5.0 → 0.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +639 -0
- package/README.md +49 -21
- package/dist/brand.d.ts +3 -0
- package/dist/brand.js +7 -0
- package/dist/components/_breadcrumb-more.d.ts +6 -0
- package/dist/components/_breadcrumb-more.js +5 -0
- package/dist/components/_drawing-svg.d.ts +11 -0
- package/dist/components/_drawing-svg.js +30 -0
- package/dist/components/_media.d.ts +159 -0
- package/dist/components/_media.js +266 -0
- package/dist/components/_overlay.d.ts +8 -5
- package/dist/components/_overlay.js +11 -6
- package/dist/components/_scheduler-calendar.d.ts +71 -0
- package/dist/components/_scheduler-calendar.js +940 -0
- package/dist/components/_scheduler-editor.d.ts +29 -0
- package/dist/components/_scheduler-editor.js +111 -0
- package/dist/components/_scheduler-menu.d.ts +16 -0
- package/dist/components/_scheduler-menu.js +18 -0
- package/dist/components/_scheduler-parts.d.ts +164 -0
- package/dist/components/_scheduler-parts.js +327 -0
- package/dist/components/_suggest-list.d.ts +142 -0
- package/dist/components/_suggest-list.js +159 -0
- package/dist/components/_toolbar-more.d.ts +24 -0
- package/dist/components/_toolbar-more.js +25 -0
- package/dist/components/accordion.d.ts +1 -1
- package/dist/components/accordion.js +6 -6
- package/dist/components/action-sheet.d.ts +88 -0
- package/dist/components/action-sheet.js +124 -0
- package/dist/components/alert-dialog.js +3 -1
- package/dist/components/alert.d.ts +11 -18
- package/dist/components/alert.js +9 -6
- package/dist/components/app-bar.d.ts +93 -0
- package/dist/components/app-bar.js +175 -0
- package/dist/components/audio-player.d.ts +134 -0
- package/dist/components/audio-player.js +618 -0
- package/dist/components/avatar.d.ts +6 -6
- package/dist/components/avatar.js +13 -11
- package/dist/components/badge.d.ts +12 -12
- package/dist/components/badge.js +7 -5
- package/dist/components/bottom-nav.d.ts +53 -11
- package/dist/components/bottom-nav.js +388 -23
- package/dist/components/breadcrumb.d.ts +11 -2
- package/dist/components/breadcrumb.js +60 -6
- package/dist/components/button-group.js +5 -1
- package/dist/components/button.d.ts +23 -6
- package/dist/components/button.js +63 -7
- package/dist/components/calendar.js +8 -6
- package/dist/components/card.d.ts +10 -8
- package/dist/components/card.js +15 -14
- package/dist/components/carousel.d.ts +2 -2
- package/dist/components/carousel.js +21 -8
- package/dist/components/chart.d.ts +27 -1
- package/dist/components/chart.js +15 -5
- package/dist/components/checkbox.js +2 -2
- package/dist/components/code-block.d.ts +9 -2
- package/dist/components/code-block.js +26 -7
- package/dist/components/collapsible.js +3 -3
- package/dist/components/color-picker.d.ts +2 -2
- package/dist/components/color-picker.js +5 -5
- package/dist/components/combobox.d.ts +26 -7
- package/dist/components/combobox.js +32 -13
- package/dist/components/command.d.ts +29 -5
- package/dist/components/command.js +35 -10
- package/dist/components/context-menu.d.ts +5 -2
- package/dist/components/context-menu.js +24 -3
- package/dist/components/conversation.d.ts +1 -1
- package/dist/components/conversation.js +67 -13
- package/dist/components/copy-button.d.ts +1 -1
- package/dist/components/copy-button.js +1 -1
- package/dist/components/data-table.d.ts +6 -6
- package/dist/components/data-table.js +41 -15
- package/dist/components/date-picker.d.ts +31 -9
- package/dist/components/date-picker.js +100 -18
- package/dist/components/dialog.d.ts +17 -10
- package/dist/components/dialog.js +20 -13
- package/dist/components/drawer.d.ts +26 -8
- package/dist/components/drawer.js +75 -16
- package/dist/components/drawing.d.ts +25 -0
- package/dist/components/drawing.js +32 -0
- package/dist/components/empty.js +2 -2
- package/dist/components/feature-list.d.ts +65 -13
- package/dist/components/feature-list.js +116 -15
- package/dist/components/field.js +2 -2
- package/dist/components/file-drop.d.ts +9 -7
- package/dist/components/file-drop.js +8 -43
- package/dist/components/filter-bar.d.ts +10 -9
- package/dist/components/filter-bar.js +42 -25
- package/dist/components/graph.d.ts +19 -3
- package/dist/components/graph.js +170 -25
- package/dist/components/illustration.js +3 -28
- package/dist/components/input-group.d.ts +5 -10
- package/dist/components/input-group.js +16 -16
- package/dist/components/input.d.ts +2 -2
- package/dist/components/input.js +3 -3
- package/dist/components/item.d.ts +9 -6
- package/dist/components/item.js +13 -8
- package/dist/components/kbd.d.ts +1 -1
- package/dist/components/kbd.js +1 -1
- package/dist/components/lightbox.d.ts +76 -9
- package/dist/components/lightbox.js +333 -45
- package/dist/components/locale.d.ts +6 -6
- package/dist/components/logo.d.ts +21 -1
- package/dist/components/logo.js +32 -2
- package/dist/components/markdown-editor.d.ts +275 -0
- package/dist/components/markdown-editor.js +831 -0
- package/dist/components/mentions.d.ts +153 -0
- package/dist/components/mentions.js +507 -0
- package/dist/components/menu.d.ts +2 -1
- package/dist/components/menu.js +5 -4
- package/dist/components/menubar.d.ts +23 -5
- package/dist/components/menubar.js +97 -22
- package/dist/components/message.d.ts +62 -11
- package/dist/components/message.js +49 -13
- package/dist/components/meter.js +1 -1
- package/dist/components/money-input.d.ts +1 -1
- package/dist/components/money-input.js +1 -1
- package/dist/components/native-select.d.ts +2 -2
- package/dist/components/native-select.js +4 -4
- package/dist/components/navigation-menu.d.ts +3 -1
- package/dist/components/navigation-menu.js +23 -12
- package/dist/components/number-field.d.ts +2 -9
- package/dist/components/number-field.js +86 -36
- package/dist/components/number-roll.d.ts +26 -0
- package/dist/components/number-roll.js +81 -0
- package/dist/components/otp-field.d.ts +1 -1
- package/dist/components/otp-field.js +24 -3
- package/dist/components/pagination.d.ts +11 -3
- package/dist/components/pagination.js +59 -13
- package/dist/components/pdf-viewer.d.ts +1 -1
- package/dist/components/pdf-viewer.js +8 -8
- package/dist/components/phone-input.d.ts +1 -1
- package/dist/components/phone-input.js +2 -2
- package/dist/components/popover.js +5 -3
- package/dist/components/preview-card.d.ts +37 -2
- package/dist/components/preview-card.js +226 -2
- package/dist/components/progress.js +1 -1
- package/dist/components/prompt-input.d.ts +1 -1
- package/dist/components/prompt-input.js +24 -14
- package/dist/components/pull-to-refresh.d.ts +50 -0
- package/dist/components/pull-to-refresh.js +189 -0
- package/dist/components/quote.d.ts +6 -1
- package/dist/components/quote.js +3 -2
- package/dist/components/radio-group.js +1 -1
- package/dist/components/rating.d.ts +4 -1
- package/dist/components/rating.js +131 -10
- package/dist/components/reasoning.d.ts +1 -1
- package/dist/components/reasoning.js +7 -3
- package/dist/components/resizable.d.ts +1 -1
- package/dist/components/resizable.js +2 -2
- package/dist/components/response.d.ts +1 -1
- package/dist/components/response.js +18 -6
- package/dist/components/scheduler.d.ts +352 -0
- package/dist/components/scheduler.js +1717 -0
- package/dist/components/scroll-area.js +1 -1
- package/dist/components/select.d.ts +17 -4
- package/dist/components/select.js +140 -9
- package/dist/components/separator.d.ts +1 -1
- package/dist/components/separator.js +3 -3
- package/dist/components/sidebar.d.ts +44 -3
- package/dist/components/sidebar.js +57 -17
- package/dist/components/site-header.d.ts +18 -13
- package/dist/components/site-header.js +23 -11
- package/dist/components/skeleton.d.ts +17 -7
- package/dist/components/skeleton.js +22 -7
- package/dist/components/slider.js +2 -2
- package/dist/components/sortable.d.ts +55 -4
- package/dist/components/sortable.js +172 -103
- package/dist/components/sources.d.ts +1 -1
- package/dist/components/sources.js +2 -2
- package/dist/components/spinner.d.ts +4 -4
- package/dist/components/spinner.js +4 -4
- package/dist/components/stat.d.ts +21 -4
- package/dist/components/stat.js +17 -8
- package/dist/components/stepper.d.ts +1 -1
- package/dist/components/stepper.js +8 -7
- package/dist/components/suggestions.d.ts +11 -3
- package/dist/components/suggestions.js +10 -4
- package/dist/components/swipe-actions.d.ts +66 -0
- package/dist/components/swipe-actions.js +292 -0
- package/dist/components/switch.js +1 -1
- package/dist/components/table.d.ts +12 -6
- package/dist/components/table.js +78 -30
- package/dist/components/tabs.js +7 -4
- package/dist/components/tag.d.ts +19 -20
- package/dist/components/tag.js +9 -5
- package/dist/components/tags-input.d.ts +2 -7
- package/dist/components/tags-input.js +11 -8
- package/dist/components/textarea.d.ts +3 -2
- package/dist/components/textarea.js +4 -3
- package/dist/components/theme.d.ts +49 -6
- package/dist/components/theme.js +147 -9
- package/dist/components/time-field.d.ts +4 -9
- package/dist/components/time-field.js +6 -6
- package/dist/components/timeline.d.ts +19 -3
- package/dist/components/timeline.js +21 -9
- package/dist/components/tippy.d.ts +17 -1
- package/dist/components/tippy.js +95 -15
- package/dist/components/toast.d.ts +2 -7
- package/dist/components/toast.js +12 -8
- package/dist/components/toggle-group.d.ts +7 -1
- package/dist/components/toggle-group.js +16 -5
- package/dist/components/toggle.d.ts +2 -2
- package/dist/components/toggle.js +3 -2
- package/dist/components/tool-call.d.ts +1 -1
- package/dist/components/tool-call.js +4 -4
- package/dist/components/toolbar.d.ts +57 -4
- package/dist/components/toolbar.js +216 -16
- package/dist/components/tooltip.d.ts +1 -1
- package/dist/components/tooltip.js +4 -2
- package/dist/components/tour.d.ts +1 -1
- package/dist/components/tour.js +36 -15
- package/dist/components/tree.js +5 -5
- package/dist/components/typography.d.ts +31 -8
- package/dist/components/typography.js +21 -10
- package/dist/components/video-player.d.ts +7 -2
- package/dist/components/video-player.js +121 -220
- package/dist/index.d.ts +99 -92
- package/dist/index.js +99 -92
- package/dist/lib/calendar.d.ts +153 -0
- package/dist/lib/calendar.js +312 -0
- package/dist/lib/cn.d.ts +3 -1
- package/dist/lib/cn.js +5 -0
- package/dist/lib/code-highlight.d.ts +14 -0
- package/dist/lib/code-highlight.js +81 -18
- package/dist/lib/drag.d.ts +39 -0
- package/dist/lib/drag.js +96 -0
- package/dist/lib/editorial-assets.js +16 -8
- package/dist/lib/figure/figures/automation.js +25 -6
- package/dist/lib/figure/figures/bar-chart.js +6 -1
- package/dist/lib/figure/figures/brackets-classic.js +4 -1
- package/dist/lib/figure/figures/city.js +12 -2
- package/dist/lib/figure/figures/conveyor.js +17 -4
- package/dist/lib/figure/figures/database.js +5 -2
- package/dist/lib/figure/figures/documents.js +11 -3
- package/dist/lib/figure/figures/inbox.js +5 -2
- package/dist/lib/figure/figures/laptop.js +3 -1
- package/dist/lib/figure/figures/pipeline.js +45 -10
- package/dist/lib/figure/figures/platform.js +62 -7
- package/dist/lib/figure/figures/server.js +21 -5
- package/dist/lib/figure/figures/spreadsheet.js +29 -5
- package/dist/lib/figure/kernel.d.ts +4 -2
- package/dist/lib/figure/kernel.js +10 -5
- package/dist/lib/figure/parts.js +6 -2
- package/dist/lib/files.d.ts +31 -0
- package/dist/lib/files.js +60 -0
- package/dist/lib/gesture.d.ts +70 -0
- package/dist/lib/gesture.js +141 -0
- package/dist/lib/glide.d.ts +5 -0
- package/dist/lib/glide.js +9 -1
- package/dist/lib/icons.d.ts +1 -0
- package/dist/lib/icons.js +6 -0
- package/dist/lib/illustration-library.js +1 -6
- package/dist/lib/markdown-edit.d.ts +112 -0
- package/dist/lib/markdown-edit.js +557 -0
- package/dist/lib/markdown-rich-editor.d.ts +188 -0
- package/dist/lib/markdown-rich-editor.js +1153 -0
- package/dist/lib/markdown-rich.d.ts +63 -0
- package/dist/lib/markdown-rich.js +534 -0
- package/dist/lib/mentions.d.ts +100 -0
- package/dist/lib/mentions.js +246 -0
- package/dist/lib/motion.d.ts +18 -0
- package/dist/lib/motion.js +43 -5
- package/dist/lib/number-roll.d.ts +89 -0
- package/dist/lib/number-roll.js +391 -0
- package/dist/lib/platform.d.ts +6 -0
- package/dist/lib/platform.js +14 -0
- package/dist/lib/portal-container.d.ts +9 -0
- package/dist/lib/portal-container.js +10 -0
- package/dist/lib/press.d.ts +5 -0
- package/dist/lib/press.js +186 -0
- package/dist/lib/scheduler.d.ts +128 -0
- package/dist/lib/scheduler.js +272 -0
- package/dist/lib/scroll-edges.d.ts +9 -0
- package/dist/lib/scroll-edges.js +50 -0
- package/dist/lib/table-fit.d.ts +1 -1
- package/dist/lib/table-fit.js +65 -8
- package/dist/lib/theme-preset.d.ts +267 -0
- package/dist/lib/theme-preset.js +1046 -0
- package/dist/lib/theme-script.d.ts +23 -3
- package/dist/lib/theme-script.js +17 -5
- package/dist/lib/tippy/sprite.d.ts +36 -4
- package/dist/lib/tippy/sprite.js +188 -15
- package/dist/lib/tone.d.ts +4 -0
- package/dist/lib/tone.js +1 -0
- package/dist/messages/de.d.ts +3 -3
- package/dist/messages/de.js +274 -3
- package/dist/skills/zon-ui/SKILL.md +279 -0
- package/dist/skills/zon-ui/references/authoring.md +265 -0
- package/dist/skills/zon-ui/references/brand.md +416 -0
- package/dist/skills/zon-ui/references/components/accordion.md +199 -0
- package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
- package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
- package/dist/skills/zon-ui/references/components/alert.md +167 -0
- package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
- package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
- package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
- package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
- package/dist/skills/zon-ui/references/components/avatar.md +98 -0
- package/dist/skills/zon-ui/references/components/badge.md +227 -0
- package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
- package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
- package/dist/skills/zon-ui/references/components/button-group.md +216 -0
- package/dist/skills/zon-ui/references/components/button.md +309 -0
- package/dist/skills/zon-ui/references/components/calendar.md +296 -0
- package/dist/skills/zon-ui/references/components/card.md +158 -0
- package/dist/skills/zon-ui/references/components/carousel.md +297 -0
- package/dist/skills/zon-ui/references/components/chart.md +739 -0
- package/dist/skills/zon-ui/references/components/chat.md +417 -0
- package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
- package/dist/skills/zon-ui/references/components/code-block.md +143 -0
- package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
- package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
- package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
- package/dist/skills/zon-ui/references/components/combobox.md +455 -0
- package/dist/skills/zon-ui/references/components/command.md +326 -0
- package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
- package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
- package/dist/skills/zon-ui/references/components/conversation.md +146 -0
- package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
- package/dist/skills/zon-ui/references/components/crm.md +1022 -0
- package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
- package/dist/skills/zon-ui/references/components/data-table.md +776 -0
- package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
- package/dist/skills/zon-ui/references/components/dialog.md +335 -0
- package/dist/skills/zon-ui/references/components/direction.md +165 -0
- package/dist/skills/zon-ui/references/components/drawer.md +276 -0
- package/dist/skills/zon-ui/references/components/drawing.md +94 -0
- package/dist/skills/zon-ui/references/components/empty.md +225 -0
- package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
- package/dist/skills/zon-ui/references/components/field.md +209 -0
- package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
- package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
- package/dist/skills/zon-ui/references/components/form.md +970 -0
- package/dist/skills/zon-ui/references/components/graph.md +339 -0
- package/dist/skills/zon-ui/references/components/illustration.md +497 -0
- package/dist/skills/zon-ui/references/components/inbox.md +263 -0
- package/dist/skills/zon-ui/references/components/input-group.md +339 -0
- package/dist/skills/zon-ui/references/components/input.md +189 -0
- package/dist/skills/zon-ui/references/components/item.md +277 -0
- package/dist/skills/zon-ui/references/components/kanban.md +626 -0
- package/dist/skills/zon-ui/references/components/kbd.md +116 -0
- package/dist/skills/zon-ui/references/components/label.md +104 -0
- package/dist/skills/zon-ui/references/components/layout.md +291 -0
- package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
- package/dist/skills/zon-ui/references/components/locale.md +279 -0
- package/dist/skills/zon-ui/references/components/logo.md +257 -0
- package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
- package/dist/skills/zon-ui/references/components/mentions.md +512 -0
- package/dist/skills/zon-ui/references/components/menu.md +218 -0
- package/dist/skills/zon-ui/references/components/menubar.md +292 -0
- package/dist/skills/zon-ui/references/components/message.md +243 -0
- package/dist/skills/zon-ui/references/components/meter.md +105 -0
- package/dist/skills/zon-ui/references/components/money-input.md +333 -0
- package/dist/skills/zon-ui/references/components/native-select.md +197 -0
- package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
- package/dist/skills/zon-ui/references/components/number-field.md +210 -0
- package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
- package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
- package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
- package/dist/skills/zon-ui/references/components/pagination.md +109 -0
- package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
- package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
- package/dist/skills/zon-ui/references/components/popover.md +176 -0
- package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
- package/dist/skills/zon-ui/references/components/pricing.md +724 -0
- package/dist/skills/zon-ui/references/components/progress.md +92 -0
- package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
- package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
- package/dist/skills/zon-ui/references/components/quote.md +115 -0
- package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
- package/dist/skills/zon-ui/references/components/rating.md +260 -0
- package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
- package/dist/skills/zon-ui/references/components/resizable.md +213 -0
- package/dist/skills/zon-ui/references/components/response.md +170 -0
- package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
- package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
- package/dist/skills/zon-ui/references/components/select.md +351 -0
- package/dist/skills/zon-ui/references/components/separator.md +103 -0
- package/dist/skills/zon-ui/references/components/settings.md +793 -0
- package/dist/skills/zon-ui/references/components/shop.md +1715 -0
- package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
- package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
- package/dist/skills/zon-ui/references/components/site-header.md +303 -0
- package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
- package/dist/skills/zon-ui/references/components/slider.md +172 -0
- package/dist/skills/zon-ui/references/components/sortable.md +405 -0
- package/dist/skills/zon-ui/references/components/sources.md +106 -0
- package/dist/skills/zon-ui/references/components/spinner.md +222 -0
- package/dist/skills/zon-ui/references/components/stat.md +267 -0
- package/dist/skills/zon-ui/references/components/stepper.md +285 -0
- package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
- package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
- package/dist/skills/zon-ui/references/components/switch.md +160 -0
- package/dist/skills/zon-ui/references/components/table.md +999 -0
- package/dist/skills/zon-ui/references/components/tabs.md +258 -0
- package/dist/skills/zon-ui/references/components/tag.md +115 -0
- package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
- package/dist/skills/zon-ui/references/components/textarea.md +95 -0
- package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
- package/dist/skills/zon-ui/references/components/theme.md +362 -0
- package/dist/skills/zon-ui/references/components/time-field.md +222 -0
- package/dist/skills/zon-ui/references/components/timeline.md +285 -0
- package/dist/skills/zon-ui/references/components/tippy.md +243 -0
- package/dist/skills/zon-ui/references/components/toast.md +220 -0
- package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
- package/dist/skills/zon-ui/references/components/toggle.md +167 -0
- package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
- package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
- package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
- package/dist/skills/zon-ui/references/components/tour.md +423 -0
- package/dist/skills/zon-ui/references/components/tree.md +481 -0
- package/dist/skills/zon-ui/references/components/typography.md +347 -0
- package/dist/skills/zon-ui/references/components/video-player.md +386 -0
- package/dist/skills/zon-ui/references/marketing.md +467 -0
- package/dist/skills/zon-ui/references/motion.md +455 -0
- package/dist/skills/zon-ui/references/recipes.md +1232 -0
- package/dist/skills/zon-ui/references/tokens.md +866 -0
- package/dist/sources/accordion.css +4 -0
- package/dist/sources/action-sheet.css +11 -0
- package/dist/sources/alert-dialog.css +6 -0
- package/dist/sources/alert.css +3 -0
- package/dist/sources/app-bar.css +14 -0
- package/dist/sources/ascii-field.css +3 -0
- package/dist/sources/aspect-ratio.css +3 -0
- package/dist/sources/audio-player.css +20 -0
- package/dist/sources/avatar.css +3 -0
- package/dist/sources/badge.css +3 -0
- package/dist/sources/bottom-nav.css +9 -0
- package/dist/sources/breadcrumb.css +14 -0
- package/dist/sources/button-group.css +3 -0
- package/dist/sources/button.css +9 -0
- package/dist/sources/calendar.css +13 -0
- package/dist/sources/card.css +3 -0
- package/dist/sources/carousel.css +11 -0
- package/dist/sources/chart.css +5 -0
- package/dist/sources/checkbox.css +6 -0
- package/dist/sources/code-block.css +13 -0
- package/dist/sources/collapsible.css +4 -0
- package/dist/sources/color-picker.css +13 -0
- package/dist/sources/combobox.css +13 -0
- package/dist/sources/command.css +13 -0
- package/dist/sources/context-menu.css +12 -0
- package/dist/sources/conversation.css +10 -0
- package/dist/sources/copy-button.css +10 -0
- package/dist/sources/data-table.css +27 -0
- package/dist/sources/date-picker.css +20 -0
- package/dist/sources/dialog.css +9 -0
- package/dist/sources/direction.css +2 -0
- package/dist/sources/drawer.css +9 -0
- package/dist/sources/drawing.css +5 -0
- package/dist/sources/empty.css +3 -0
- package/dist/sources/feature-list.css +4 -0
- package/dist/sources/field.css +4 -0
- package/dist/sources/file-drop.css +15 -0
- package/dist/sources/filter-bar.css +30 -0
- package/dist/sources/form.css +4 -0
- package/dist/sources/graph.css +19 -0
- package/dist/sources/illustration.css +28 -0
- package/dist/sources/input-group.css +7 -0
- package/dist/sources/input.css +3 -0
- package/dist/sources/item.css +4 -0
- package/dist/sources/kbd.css +5 -0
- package/dist/sources/label.css +3 -0
- package/dist/sources/layout.css +3 -0
- package/dist/sources/lightbox.css +33 -0
- package/dist/sources/locale.css +2 -0
- package/dist/sources/logo.css +4 -0
- package/dist/sources/markdown-editor.css +41 -0
- package/dist/sources/mentions.css +13 -0
- package/dist/sources/menu.css +11 -0
- package/dist/sources/menubar.css +14 -0
- package/dist/sources/message.css +16 -0
- package/dist/sources/meter.css +4 -0
- package/dist/sources/money-input.css +10 -0
- package/dist/sources/native-select.css +4 -0
- package/dist/sources/navigation-menu.css +8 -0
- package/dist/sources/number-field.css +8 -0
- package/dist/sources/number-roll.css +6 -0
- package/dist/sources/otp-field.css +5 -0
- package/dist/sources/pagination.css +11 -0
- package/dist/sources/pdf-viewer.css +30 -0
- package/dist/sources/phone-input.css +20 -0
- package/dist/sources/popover.css +7 -0
- package/dist/sources/preview-card.css +7 -0
- package/dist/sources/progress.css +4 -0
- package/dist/sources/prompt-input.css +15 -0
- package/dist/sources/pull-to-refresh.css +14 -0
- package/dist/sources/quote.css +3 -0
- package/dist/sources/radio-group.css +5 -0
- package/dist/sources/rating.css +6 -0
- package/dist/sources/reasoning.css +6 -0
- package/dist/sources/resizable.css +4 -0
- package/dist/sources/response.css +16 -0
- package/dist/sources/scheduler.css +44 -0
- package/dist/sources/scroll-area.css +3 -0
- package/dist/sources/select.css +12 -0
- package/dist/sources/separator.css +3 -0
- package/dist/sources/sidebar.css +19 -0
- package/dist/sources/site-header.css +15 -0
- package/dist/sources/skeleton.css +3 -0
- package/dist/sources/slider.css +6 -0
- package/dist/sources/sortable.css +12 -0
- package/dist/sources/sources.css +6 -0
- package/dist/sources/spinner.css +6 -0
- package/dist/sources/stat.css +9 -0
- package/dist/sources/stepper.css +6 -0
- package/dist/sources/suggestions.css +10 -0
- package/dist/sources/swipe-actions.css +20 -0
- package/dist/sources/switch.css +5 -0
- package/dist/sources/table.css +7 -0
- package/dist/sources/tabs.css +5 -0
- package/dist/sources/tag.css +3 -0
- package/dist/sources/tags-input.css +6 -0
- package/dist/sources/textarea.css +3 -0
- package/dist/sources/theme.css +13 -0
- package/dist/sources/time-field.css +7 -0
- package/dist/sources/timeline.css +7 -0
- package/dist/sources/tippy.css +6 -0
- package/dist/sources/toast.css +6 -0
- package/dist/sources/toggle-group.css +5 -0
- package/dist/sources/toggle.css +3 -0
- package/dist/sources/tool-call.css +16 -0
- package/dist/sources/toolbar.css +14 -0
- package/dist/sources/tooltip.css +6 -0
- package/dist/sources/tour.css +14 -0
- package/dist/sources/tree.css +6 -0
- package/dist/sources/typography.css +4 -0
- package/dist/sources/video-player.css +21 -0
- package/dist/styles/ai.css +3 -0
- package/dist/styles/brand.css +98 -0
- package/dist/styles/core.css +266 -0
- package/dist/styles/editor.css +3 -0
- package/dist/styles/expressive.css +35 -56
- package/dist/styles/fonts.css +61 -117
- package/dist/styles/graph.css +4 -0
- package/dist/styles/illustration.css +4 -0
- package/dist/styles/index.css +11 -201
- package/dist/styles/material.css +138 -12
- package/dist/styles/parts/ai.css +18 -13
- package/dist/styles/parts/brand.css +2 -2
- package/dist/styles/parts/controls.css +29 -20
- package/dist/styles/parts/data.css +13 -9
- package/dist/styles/parts/editor.css +372 -0
- package/dist/styles/parts/feedback.css +32 -2
- package/dist/styles/parts/foundations.css +12 -7
- package/dist/styles/parts/graph.css +25 -9
- package/dist/styles/parts/inputs.css +172 -9
- package/dist/styles/parts/isometric.css +6 -5
- package/dist/styles/parts/navigation.css +206 -27
- package/dist/styles/parts/overlays.css +19 -4
- package/dist/styles/parts/pdf.css +2 -2
- package/dist/styles/pdf.css +3 -0
- package/dist/styles/prose.css +3 -0
- package/dist/styles/tokens.css +89 -14
- package/dist/theme.d.ts +1 -0
- package/dist/theme.js +5 -0
- package/dist/vite.d.ts +48 -59
- package/dist/vite.js +54 -21
- package/package.json +69 -2
|
@@ -0,0 +1,189 @@
|
|
|
1
|
+
# Input
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Input } from "@zonsh/ui";
|
|
5
|
+
|
|
6
|
+
/** The input on its own: only the box. It is named by aria-label here; in a form, by a Field. */
|
|
7
|
+
export function Basic() {
|
|
8
|
+
return (
|
|
9
|
+
<div className="w-full max-w-md">
|
|
10
|
+
<Input type="email" aria-label="Email" autoComplete="email" placeholder="alex@example.com" />
|
|
11
|
+
</div>
|
|
12
|
+
);
|
|
13
|
+
}
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
Single-line entry in the recessed **field material**, 38px tall (30px with `size="sm"`). It fills its column (28–36rem suits most forms). It has no label or error of its own: in a form it goes in a `Field`; alone (a toolbar search, a table filter) it needs an `aria-label`.
|
|
17
|
+
|
|
18
|
+
## Usage
|
|
19
|
+
|
|
20
|
+
```tsx
|
|
21
|
+
import { Field, FieldLabel, Input } from "@zonsh/ui";
|
|
22
|
+
|
|
23
|
+
// In a form: the Field gives it its label.
|
|
24
|
+
<Field>
|
|
25
|
+
<FieldLabel>Email</FieldLabel>
|
|
26
|
+
<Input type="email" autoComplete="email" />
|
|
27
|
+
</Field>;
|
|
28
|
+
|
|
29
|
+
// On its own: name it with aria-label.
|
|
30
|
+
<Input type="search" aria-label="Search orders" />;
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
The props you'll reach for: `type`, `autoComplete` and `size`.
|
|
34
|
+
|
|
35
|
+
## When to use
|
|
36
|
+
|
|
37
|
+
- Short, single-line answers: a name, an email, a URL, a filter.
|
|
38
|
+
- Longer than a sentence: `Textarea`. Numbers: `NumberField`. Choosing from a list: `Select` or `Combobox`.
|
|
39
|
+
|
|
40
|
+
## Examples
|
|
41
|
+
|
|
42
|
+
### Types
|
|
43
|
+
|
|
44
|
+
`type` sets the phone keyboard, the browser's checks and autofill; pair it with `autoComplete` (`"current-password"` or `"new-password"` for passwords). A show/hide toggle is `InputGroup` with `InputGroupPasswordToggle`.
|
|
45
|
+
|
|
46
|
+
```tsx
|
|
47
|
+
import { Input } from "@zonsh/ui";
|
|
48
|
+
import * as React from "react";
|
|
49
|
+
|
|
50
|
+
/** A mono note under an example, naming what it shows. Not a label: the inputs name themselves. */
|
|
51
|
+
function Note({ children }: { children: React.ReactNode }) {
|
|
52
|
+
return <p className="m-0 font-mono text-[11px] tracking-[0.04em] text-muted-foreground">{children}</p>;
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
function Example({ note, children }: { note: React.ReactNode; children: React.ReactNode }) {
|
|
56
|
+
return (
|
|
57
|
+
<div className="flex flex-col gap-2">
|
|
58
|
+
{children}
|
|
59
|
+
<Note>{note}</Note>
|
|
60
|
+
</div>
|
|
61
|
+
);
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
export function Types() {
|
|
65
|
+
return (
|
|
66
|
+
// Columns by the room the example has, not the screen: one column in a narrow frame.
|
|
67
|
+
<div className="@container w-full max-w-2xl">
|
|
68
|
+
<div className="grid gap-6 @lg:grid-cols-2">
|
|
69
|
+
<Example note='type="text"'>
|
|
70
|
+
<Input aria-label="Full name" autoComplete="name" placeholder="Alex Weber" />
|
|
71
|
+
</Example>
|
|
72
|
+
<Example note='type="email"'>
|
|
73
|
+
<Input type="email" aria-label="Email" autoComplete="email" placeholder="alex@example.com" />
|
|
74
|
+
</Example>
|
|
75
|
+
<Example note='type="password"'>
|
|
76
|
+
<Input
|
|
77
|
+
type="password"
|
|
78
|
+
aria-label="Password"
|
|
79
|
+
autoComplete="current-password"
|
|
80
|
+
defaultValue="correct horse"
|
|
81
|
+
/>
|
|
82
|
+
</Example>
|
|
83
|
+
<Example note='type="url"'>
|
|
84
|
+
<Input type="url" aria-label="Website" autoComplete="url" placeholder="https://example.com" />
|
|
85
|
+
</Example>
|
|
86
|
+
<Example note='type="tel"'>
|
|
87
|
+
<Input type="tel" aria-label="Phone" autoComplete="tel" placeholder="+49 221 123456" />
|
|
88
|
+
</Example>
|
|
89
|
+
<Example note='type="search"'>
|
|
90
|
+
<Input type="search" aria-label="Search orders" placeholder="Search orders…" />
|
|
91
|
+
</Example>
|
|
92
|
+
<div className="@lg:col-span-2">
|
|
93
|
+
<Example note='type="file"'>
|
|
94
|
+
<Input type="file" aria-label="Attachment" />
|
|
95
|
+
</Example>
|
|
96
|
+
</div>
|
|
97
|
+
</div>
|
|
98
|
+
</div>
|
|
99
|
+
);
|
|
100
|
+
}
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
### Sizes
|
|
104
|
+
|
|
105
|
+
30px only when the whole surface is dense.
|
|
106
|
+
|
|
107
|
+
```tsx
|
|
108
|
+
import { Input } from "@zonsh/ui";
|
|
109
|
+
import * as React from "react";
|
|
110
|
+
|
|
111
|
+
// Note, Example: as in the first example on this page that uses them.
|
|
112
|
+
|
|
113
|
+
export function Sizes() {
|
|
114
|
+
return (
|
|
115
|
+
<div className="flex w-full max-w-md flex-col gap-6">
|
|
116
|
+
<Example note='size="sm" · 30px, for dense surfaces'>
|
|
117
|
+
<Input size="sm" aria-label="Filter orders" placeholder="Filter orders" />
|
|
118
|
+
</Example>
|
|
119
|
+
<Example note="default · 38px, everywhere else">
|
|
120
|
+
<Input aria-label="Filter orders" placeholder="Filter orders" />
|
|
121
|
+
</Example>
|
|
122
|
+
</div>
|
|
123
|
+
);
|
|
124
|
+
}
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
### States
|
|
128
|
+
|
|
129
|
+
Read-only is quieter, not dimmed — no fill, softer ink — and still focusable and copyable. Disabled is dimmed and skipped by the keyboard. `aria-invalid` gives the destructive border (a `Field`'s `invalid` sets it, with a message).
|
|
130
|
+
|
|
131
|
+
```tsx
|
|
132
|
+
import { Input } from "@zonsh/ui";
|
|
133
|
+
import * as React from "react";
|
|
134
|
+
|
|
135
|
+
// Note, Example: as in the first example on this page that uses them.
|
|
136
|
+
|
|
137
|
+
export function States() {
|
|
138
|
+
return (
|
|
139
|
+
// Columns by the room the example has, not the screen: one column in a narrow frame.
|
|
140
|
+
<div className="@container w-full max-w-2xl">
|
|
141
|
+
<div className="grid gap-6 @lg:grid-cols-2">
|
|
142
|
+
<Example note="empty, with a placeholder">
|
|
143
|
+
<Input aria-label="Project name" placeholder="my-app" />
|
|
144
|
+
</Example>
|
|
145
|
+
<Example note="filled">
|
|
146
|
+
<Input aria-label="Project name" defaultValue="storefront" />
|
|
147
|
+
</Example>
|
|
148
|
+
<Example note="readOnly">
|
|
149
|
+
<Input aria-label="Project ID" readOnly defaultValue="prj-2026-014" />
|
|
150
|
+
</Example>
|
|
151
|
+
<Example note="disabled">
|
|
152
|
+
<Input aria-label="Project ID" disabled defaultValue="prj-2026-014" />
|
|
153
|
+
</Example>
|
|
154
|
+
<Example note='aria-invalid="true"'>
|
|
155
|
+
<Input aria-label="Email" aria-invalid defaultValue="alex@example" />
|
|
156
|
+
</Example>
|
|
157
|
+
</div>
|
|
158
|
+
</div>
|
|
159
|
+
);
|
|
160
|
+
}
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
## Props
|
|
164
|
+
|
|
165
|
+
| Component | Prop | Type | Default |
|
|
166
|
+
| --------- | ------ | ------------------- | ----------- |
|
|
167
|
+
| `Input` | `size` | `"sm" \| "default"` | `"default"` |
|
|
168
|
+
|
|
169
|
+
Every native `<input>` prop is forwarded, plus Base UI's `onValueChange`. Data attributes: `data-size`, `data-invalid`, `data-valid`, `data-disabled`.
|
|
170
|
+
|
|
171
|
+
## Brand rules
|
|
172
|
+
|
|
173
|
+
- **Do** keep 16px text on mobile, which avoids iOS zoom (built in).
|
|
174
|
+
- **Do** use `type` and `autoComplete` so browsers can help.
|
|
175
|
+
- **Do** set the width on the column (`Field` or `Form`), not on the input.
|
|
176
|
+
- **Don't** set the height with `h-*` or padding. Use `size`.
|
|
177
|
+
- **Don't** give fields a flat fill or a thick outline. They are recessed.
|
|
178
|
+
|
|
179
|
+
## Accessibility
|
|
180
|
+
|
|
181
|
+
- In a form, always inside a `Field` with a visible `FieldLabel`; on its own, give it an `aria-label`.
|
|
182
|
+
- Focus takes a softer edge, halfway from `--field-edge` to `--control-focus`, with no ring.
|
|
183
|
+
- Placeholder text is `--control-muted`: use it for examples, never for instructions people need.
|
|
184
|
+
|
|
185
|
+
---
|
|
186
|
+
|
|
187
|
+
- Import: `import { Input } from "@zonsh/ui"`
|
|
188
|
+
- Source: `packages/ui/src/components/input.tsx`
|
|
189
|
+
- Primitive: `@base-ui/react/input` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/input.md`)
|
|
@@ -0,0 +1,277 @@
|
|
|
1
|
+
# Item
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Button, Item, ItemActions, ItemContent, ItemDescription, ItemMedia, ItemTitle } from "@zonsh/ui";
|
|
5
|
+
import { ShoppingBagIcon } from "lucide-react";
|
|
6
|
+
|
|
7
|
+
export function Basic() {
|
|
8
|
+
return (
|
|
9
|
+
<Item variant="outline" className="max-w-xl">
|
|
10
|
+
<ItemMedia variant="icon">
|
|
11
|
+
<ShoppingBagIcon />
|
|
12
|
+
</ItemMedia>
|
|
13
|
+
<ItemContent>
|
|
14
|
+
<ItemTitle>Order emails</ItemTitle>
|
|
15
|
+
<ItemDescription>A receipt goes to the customer as soon as an order is paid.</ItemDescription>
|
|
16
|
+
</ItemContent>
|
|
17
|
+
<ItemActions>
|
|
18
|
+
<Button size="sm" variant="secondary">
|
|
19
|
+
Configure
|
|
20
|
+
</Button>
|
|
21
|
+
</ItemActions>
|
|
22
|
+
</Item>
|
|
23
|
+
);
|
|
24
|
+
}
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
A row for one thing — a person, a file, a setting: media, a title over a muted description, actions. As a link or button it lifts on hover; a static item doesn't.
|
|
28
|
+
|
|
29
|
+
## Usage
|
|
30
|
+
|
|
31
|
+
```tsx
|
|
32
|
+
import { Button, Item, ItemActions, ItemContent, ItemDescription, ItemMedia, ItemTitle } from "@zonsh/ui";
|
|
33
|
+
import { ShoppingBagIcon } from "lucide-react";
|
|
34
|
+
|
|
35
|
+
<Item variant="outline">
|
|
36
|
+
<ItemMedia variant="icon">
|
|
37
|
+
<ShoppingBagIcon />
|
|
38
|
+
</ItemMedia>
|
|
39
|
+
<ItemContent>
|
|
40
|
+
<ItemTitle>Order emails</ItemTitle>
|
|
41
|
+
<ItemDescription>A receipt goes to the customer as soon as an order is paid.</ItemDescription>
|
|
42
|
+
</ItemContent>
|
|
43
|
+
<ItemActions>
|
|
44
|
+
<Button size="sm" variant="secondary">
|
|
45
|
+
Configure
|
|
46
|
+
</Button>
|
|
47
|
+
</ItemActions>
|
|
48
|
+
</Item>;
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
The props you'll use: `variant`, `size` and `render` (a link, an `<li>`, a `<label>`).
|
|
52
|
+
|
|
53
|
+
## When to use
|
|
54
|
+
|
|
55
|
+
- `default` — flat rows divided by `ItemSeparator` hairlines. The usual choice.
|
|
56
|
+
- `outline` — a 12px `--field-edge` border, for one row that stands alone.
|
|
57
|
+
- `raised` — the key surface, for rows that are actions or destinations.
|
|
58
|
+
- `size="sm"` — dense settings and admin screens.
|
|
59
|
+
- Columns of data: `Table`. Navigation: `Sidebar` or `NavigationMenu`. A numbered list of features or steps: `FeatureList`.
|
|
60
|
+
|
|
61
|
+
## Examples
|
|
62
|
+
|
|
63
|
+
### Variants
|
|
64
|
+
|
|
65
|
+
```tsx
|
|
66
|
+
import { Item, ItemActions, ItemContent, ItemDescription, ItemMedia, ItemTitle } from "@zonsh/ui";
|
|
67
|
+
import { FileTextIcon } from "lucide-react";
|
|
68
|
+
|
|
69
|
+
export function Variants() {
|
|
70
|
+
return (
|
|
71
|
+
<div className="flex w-full max-w-xl flex-col gap-4">
|
|
72
|
+
{(["default", "outline", "raised"] as const).map((variant) => (
|
|
73
|
+
<Item key={variant} variant={variant}>
|
|
74
|
+
<ItemMedia>
|
|
75
|
+
<FileTextIcon />
|
|
76
|
+
</ItemMedia>
|
|
77
|
+
<ItemContent>
|
|
78
|
+
<ItemTitle>Reading list</ItemTitle>
|
|
79
|
+
<ItemDescription>Updated on 12 September</ItemDescription>
|
|
80
|
+
</ItemContent>
|
|
81
|
+
<ItemActions>
|
|
82
|
+
<span className="font-mono text-xs text-muted-foreground">{variant}</span>
|
|
83
|
+
</ItemActions>
|
|
84
|
+
</Item>
|
|
85
|
+
))}
|
|
86
|
+
</div>
|
|
87
|
+
);
|
|
88
|
+
}
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
### Group
|
|
92
|
+
|
|
93
|
+
`ItemGroup render={<ul />}`, each `Item render={<li />}`; flat items align with the hairlines.
|
|
94
|
+
|
|
95
|
+
```tsx
|
|
96
|
+
import { Avatar, Item, ItemActions, ItemContent, ItemDescription, ItemGroup, ItemMedia, ItemSeparator, ItemTitle, Tag } from "@zonsh/ui";
|
|
97
|
+
import * as React from "react";
|
|
98
|
+
|
|
99
|
+
const people = [
|
|
100
|
+
{ name: "Lena Brandt", role: "Engineering", email: "lena@example.com" },
|
|
101
|
+
{ name: "Jonas Weber", role: "Support", email: "jonas@example.com" },
|
|
102
|
+
{ name: "Aylin Kaya", role: "Design", email: "aylin@example.com" },
|
|
103
|
+
];
|
|
104
|
+
|
|
105
|
+
export function Group() {
|
|
106
|
+
return (
|
|
107
|
+
<ItemGroup render={<ul />} className="max-w-xl gap-0">
|
|
108
|
+
{people.map((person, i) => (
|
|
109
|
+
<React.Fragment key={person.email}>
|
|
110
|
+
{i > 0 && <ItemSeparator />}
|
|
111
|
+
<Item render={<li />} className="px-0">
|
|
112
|
+
<ItemMedia>
|
|
113
|
+
<Avatar name={person.name} size="lg" />
|
|
114
|
+
</ItemMedia>
|
|
115
|
+
<ItemContent>
|
|
116
|
+
<ItemTitle>{person.name}</ItemTitle>
|
|
117
|
+
<ItemDescription>{person.email}</ItemDescription>
|
|
118
|
+
</ItemContent>
|
|
119
|
+
<ItemActions>
|
|
120
|
+
<Tag variant="muted">{person.role}</Tag>
|
|
121
|
+
</ItemActions>
|
|
122
|
+
</Item>
|
|
123
|
+
</React.Fragment>
|
|
124
|
+
))}
|
|
125
|
+
</ItemGroup>
|
|
126
|
+
);
|
|
127
|
+
}
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
### As link
|
|
131
|
+
|
|
132
|
+
`render={<a href="…" />}` makes the whole row the link; keep buttons out of it.
|
|
133
|
+
|
|
134
|
+
```tsx
|
|
135
|
+
import { Item, ItemActions, ItemContent, ItemDescription, ItemGroup, ItemMedia, ItemTitle, Tag } from "@zonsh/ui";
|
|
136
|
+
import { CalendarIcon, ChevronRightIcon, ImageIcon, MailIcon } from "lucide-react";
|
|
137
|
+
|
|
138
|
+
const integrations = [
|
|
139
|
+
{ icon: CalendarIcon, name: "Calendar", detail: "Work and family calendars", status: "Connected" },
|
|
140
|
+
{ icon: ImageIcon, name: "Photos", detail: "Backed up every night", status: "Connected" },
|
|
141
|
+
{ icon: MailIcon, name: "Mail", detail: "Not set up yet", status: undefined },
|
|
142
|
+
];
|
|
143
|
+
|
|
144
|
+
export function AsLink() {
|
|
145
|
+
return (
|
|
146
|
+
<ItemGroup className="max-w-xl">
|
|
147
|
+
{integrations.map(({ icon: Icon, name, detail, status }) => (
|
|
148
|
+
<Item key={name} variant="raised" render={<a href={`#${name.toLowerCase()}`} />}>
|
|
149
|
+
<ItemMedia variant="icon">
|
|
150
|
+
<Icon />
|
|
151
|
+
</ItemMedia>
|
|
152
|
+
<ItemContent>
|
|
153
|
+
<ItemTitle>
|
|
154
|
+
{name}
|
|
155
|
+
{status && (
|
|
156
|
+
<Tag variant="outline" dot>
|
|
157
|
+
{status}
|
|
158
|
+
</Tag>
|
|
159
|
+
)}
|
|
160
|
+
</ItemTitle>
|
|
161
|
+
<ItemDescription>{detail}</ItemDescription>
|
|
162
|
+
</ItemContent>
|
|
163
|
+
<ItemActions>
|
|
164
|
+
<ChevronRightIcon className="size-4 text-muted-foreground rtl:rotate-180" />
|
|
165
|
+
</ItemActions>
|
|
166
|
+
</Item>
|
|
167
|
+
))}
|
|
168
|
+
</ItemGroup>
|
|
169
|
+
);
|
|
170
|
+
}
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
### Dense settings
|
|
174
|
+
|
|
175
|
+
`size="sm"` rows rendered as `<label>`, so a click anywhere toggles the switch.
|
|
176
|
+
|
|
177
|
+
```tsx
|
|
178
|
+
import { Item, ItemActions, ItemContent, ItemGroup, ItemMedia, ItemSeparator, ItemTitle, Switch } from "@zonsh/ui";
|
|
179
|
+
import { BellOffIcon, ShieldCheckIcon } from "lucide-react";
|
|
180
|
+
|
|
181
|
+
export function Dense() {
|
|
182
|
+
return (
|
|
183
|
+
<ItemGroup className="max-w-md gap-0">
|
|
184
|
+
<Item size="sm" render={<label />}>
|
|
185
|
+
<ItemMedia>
|
|
186
|
+
<ShieldCheckIcon className="size-4" />
|
|
187
|
+
</ItemMedia>
|
|
188
|
+
<ItemContent>
|
|
189
|
+
<ItemTitle>Two-step sign-in</ItemTitle>
|
|
190
|
+
</ItemContent>
|
|
191
|
+
<ItemActions>
|
|
192
|
+
<Switch defaultChecked />
|
|
193
|
+
</ItemActions>
|
|
194
|
+
</Item>
|
|
195
|
+
<ItemSeparator />
|
|
196
|
+
<Item size="sm" render={<label />}>
|
|
197
|
+
<ItemMedia>
|
|
198
|
+
<BellOffIcon className="size-4" />
|
|
199
|
+
</ItemMedia>
|
|
200
|
+
<ItemContent>
|
|
201
|
+
<ItemTitle>Pause all notifications</ItemTitle>
|
|
202
|
+
</ItemContent>
|
|
203
|
+
<ItemActions>
|
|
204
|
+
<Switch />
|
|
205
|
+
</ItemActions>
|
|
206
|
+
</Item>
|
|
207
|
+
</ItemGroup>
|
|
208
|
+
);
|
|
209
|
+
}
|
|
210
|
+
```
|
|
211
|
+
|
|
212
|
+
### Thumbnail
|
|
213
|
+
|
|
214
|
+
`ItemMedia variant="image"`.
|
|
215
|
+
|
|
216
|
+
```tsx
|
|
217
|
+
import { Button, Item, ItemActions, ItemContent, ItemDescription, ItemMedia, ItemTitle } from "@zonsh/ui";
|
|
218
|
+
import { LogoMark } from "@zonsh/ui/brand";
|
|
219
|
+
|
|
220
|
+
export function Thumbnail() {
|
|
221
|
+
return (
|
|
222
|
+
<Item variant="outline" className="max-w-xl">
|
|
223
|
+
<ItemMedia variant="image" className="flex items-center justify-center bg-field-surface">
|
|
224
|
+
<LogoMark size={22} />
|
|
225
|
+
</ItemMedia>
|
|
226
|
+
<ItemContent>
|
|
227
|
+
<ItemTitle>zon-mark.svg</ItemTitle>
|
|
228
|
+
<ItemDescription>SVG · the zon mark</ItemDescription>
|
|
229
|
+
</ItemContent>
|
|
230
|
+
<ItemActions>
|
|
231
|
+
<Button size="sm" variant="ghost">
|
|
232
|
+
Download
|
|
233
|
+
</Button>
|
|
234
|
+
</ItemActions>
|
|
235
|
+
</Item>
|
|
236
|
+
);
|
|
237
|
+
}
|
|
238
|
+
```
|
|
239
|
+
|
|
240
|
+
## Props
|
|
241
|
+
|
|
242
|
+
| Prop | Type | Default |
|
|
243
|
+
| --------- | ---------------------------------------------------------------------------------------- | ----------- |
|
|
244
|
+
| `variant` | `"default" \| "outline" \| "raised"` | `"default"` |
|
|
245
|
+
| `size` | `"default" \| "sm"` | `"default"` |
|
|
246
|
+
| `render` | `ReactElement \| (props) => ReactElement` — e.g. `<a href="…" />`, `<li />`, `<label />` | — |
|
|
247
|
+
|
|
248
|
+
| Part | Renders | Notes |
|
|
249
|
+
| ----------------- | ----------- | ----------------------------------------------------------------------------------------- |
|
|
250
|
+
| `ItemMedia` | `div` | `variant`: `"default"` (as is: icons 20px; an SVG with its own `size-*`, `h-*` or `w-*` keeps it), `"icon"` (32px raised key), `"image"` (40px, an `<img>` or `<svg>` filling it). |
|
|
251
|
+
| `ItemContent` | `div` | The text column; takes the remaining width. |
|
|
252
|
+
| `ItemTitle` | `div` | 14px medium; a `Tag` can sit inline beside it. |
|
|
253
|
+
| `ItemDescription` | `p` | 13px muted, clamped at two lines. |
|
|
254
|
+
| `ItemActions` | `div` | Small buttons, a `Switch`, a `Tag`, a chevron. |
|
|
255
|
+
| `ItemGroup` | `div` | A stack with 4px gaps; accepts `render`. |
|
|
256
|
+
| `ItemSeparator` | `Separator` | The hairline rule between items. |
|
|
257
|
+
|
|
258
|
+
Minimum heights: 46px, `sm` 38px. Data attributes: `data-slot`, `data-variant`, `data-size`.
|
|
259
|
+
|
|
260
|
+
## Brand rules
|
|
261
|
+
|
|
262
|
+
- **Do** group with hairlines first; use `outline` or `raised` only for a lone row or an action.
|
|
263
|
+
- **Do** keep icons lucide, in the text's ink, one size down a list.
|
|
264
|
+
- **Don't** nest interactive controls inside an item that is a link.
|
|
265
|
+
- **Don't** colour the media wells; a status goes in a `Tag` with words.
|
|
266
|
+
- **Don't** set a height; the sizes use `min-height`.
|
|
267
|
+
|
|
268
|
+
## Accessibility
|
|
269
|
+
|
|
270
|
+
- An item rendered as a link or button gets the 2px flush focus outline and needs a clear text name (its title).
|
|
271
|
+
- Use `<ul>`/`<li>` through `render` when the items form a list, so screen readers announce the count.
|
|
272
|
+
- Decorative media should be `aria-hidden` or have an empty `alt`; an avatar's name is already in the title.
|
|
273
|
+
|
|
274
|
+
---
|
|
275
|
+
|
|
276
|
+
- Import: `import { Item, ItemMedia, ItemContent, ItemTitle, ItemDescription, ItemActions, ItemGroup, ItemSeparator } from "@zonsh/ui"`
|
|
277
|
+
- Source: `packages/ui/src/components/item.tsx`
|