@zonsh/ui 0.5.0 → 0.6.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +643 -0
- package/README.md +49 -21
- package/dist/brand.d.ts +3 -0
- package/dist/brand.js +7 -0
- package/dist/components/_breadcrumb-more.d.ts +6 -0
- package/dist/components/_breadcrumb-more.js +5 -0
- package/dist/components/_drawing-svg.d.ts +11 -0
- package/dist/components/_drawing-svg.js +30 -0
- package/dist/components/_media.d.ts +159 -0
- package/dist/components/_media.js +266 -0
- package/dist/components/_overlay.d.ts +8 -5
- package/dist/components/_overlay.js +11 -6
- package/dist/components/_scheduler-calendar.d.ts +71 -0
- package/dist/components/_scheduler-calendar.js +940 -0
- package/dist/components/_scheduler-editor.d.ts +29 -0
- package/dist/components/_scheduler-editor.js +111 -0
- package/dist/components/_scheduler-menu.d.ts +16 -0
- package/dist/components/_scheduler-menu.js +18 -0
- package/dist/components/_scheduler-parts.d.ts +164 -0
- package/dist/components/_scheduler-parts.js +327 -0
- package/dist/components/_suggest-list.d.ts +142 -0
- package/dist/components/_suggest-list.js +159 -0
- package/dist/components/_toolbar-more.d.ts +24 -0
- package/dist/components/_toolbar-more.js +25 -0
- package/dist/components/accordion.d.ts +1 -1
- package/dist/components/accordion.js +6 -6
- package/dist/components/action-sheet.d.ts +88 -0
- package/dist/components/action-sheet.js +124 -0
- package/dist/components/alert-dialog.js +3 -1
- package/dist/components/alert.d.ts +11 -18
- package/dist/components/alert.js +9 -6
- package/dist/components/app-bar.d.ts +93 -0
- package/dist/components/app-bar.js +175 -0
- package/dist/components/audio-player.d.ts +134 -0
- package/dist/components/audio-player.js +618 -0
- package/dist/components/avatar.d.ts +6 -6
- package/dist/components/avatar.js +13 -11
- package/dist/components/badge.d.ts +12 -12
- package/dist/components/badge.js +7 -5
- package/dist/components/bottom-nav.d.ts +53 -11
- package/dist/components/bottom-nav.js +388 -23
- package/dist/components/breadcrumb.d.ts +11 -2
- package/dist/components/breadcrumb.js +60 -6
- package/dist/components/button-group.js +5 -1
- package/dist/components/button.d.ts +23 -6
- package/dist/components/button.js +63 -7
- package/dist/components/calendar.js +8 -6
- package/dist/components/card.d.ts +10 -8
- package/dist/components/card.js +15 -14
- package/dist/components/carousel.d.ts +2 -2
- package/dist/components/carousel.js +21 -8
- package/dist/components/chart.d.ts +27 -1
- package/dist/components/chart.js +15 -5
- package/dist/components/checkbox.js +2 -2
- package/dist/components/code-block.d.ts +9 -2
- package/dist/components/code-block.js +26 -7
- package/dist/components/collapsible.js +3 -3
- package/dist/components/color-picker.d.ts +2 -2
- package/dist/components/color-picker.js +5 -5
- package/dist/components/combobox.d.ts +26 -7
- package/dist/components/combobox.js +32 -13
- package/dist/components/command.d.ts +29 -5
- package/dist/components/command.js +35 -10
- package/dist/components/context-menu.d.ts +5 -2
- package/dist/components/context-menu.js +24 -3
- package/dist/components/conversation.d.ts +1 -1
- package/dist/components/conversation.js +67 -13
- package/dist/components/copy-button.d.ts +1 -1
- package/dist/components/copy-button.js +1 -1
- package/dist/components/data-table.d.ts +6 -6
- package/dist/components/data-table.js +41 -15
- package/dist/components/date-picker.d.ts +31 -9
- package/dist/components/date-picker.js +100 -18
- package/dist/components/dialog.d.ts +17 -10
- package/dist/components/dialog.js +20 -13
- package/dist/components/drawer.d.ts +26 -8
- package/dist/components/drawer.js +75 -16
- package/dist/components/drawing.d.ts +25 -0
- package/dist/components/drawing.js +32 -0
- package/dist/components/empty.js +2 -2
- package/dist/components/feature-list.d.ts +65 -13
- package/dist/components/feature-list.js +116 -15
- package/dist/components/field.js +2 -2
- package/dist/components/file-drop.d.ts +9 -7
- package/dist/components/file-drop.js +8 -43
- package/dist/components/filter-bar.d.ts +10 -9
- package/dist/components/filter-bar.js +42 -25
- package/dist/components/graph.d.ts +19 -3
- package/dist/components/graph.js +170 -25
- package/dist/components/illustration.js +3 -28
- package/dist/components/input-group.d.ts +5 -10
- package/dist/components/input-group.js +16 -16
- package/dist/components/input.d.ts +2 -2
- package/dist/components/input.js +3 -3
- package/dist/components/item.d.ts +9 -6
- package/dist/components/item.js +13 -8
- package/dist/components/kbd.d.ts +1 -1
- package/dist/components/kbd.js +1 -1
- package/dist/components/lightbox.d.ts +76 -9
- package/dist/components/lightbox.js +333 -45
- package/dist/components/locale.d.ts +6 -6
- package/dist/components/logo.d.ts +21 -1
- package/dist/components/logo.js +32 -2
- package/dist/components/markdown-editor.d.ts +275 -0
- package/dist/components/markdown-editor.js +831 -0
- package/dist/components/mentions.d.ts +153 -0
- package/dist/components/mentions.js +507 -0
- package/dist/components/menu.d.ts +2 -1
- package/dist/components/menu.js +5 -4
- package/dist/components/menubar.d.ts +23 -5
- package/dist/components/menubar.js +97 -22
- package/dist/components/message.d.ts +62 -11
- package/dist/components/message.js +49 -13
- package/dist/components/meter.js +1 -1
- package/dist/components/money-input.d.ts +1 -1
- package/dist/components/money-input.js +1 -1
- package/dist/components/native-select.d.ts +2 -2
- package/dist/components/native-select.js +4 -4
- package/dist/components/navigation-menu.d.ts +3 -1
- package/dist/components/navigation-menu.js +23 -12
- package/dist/components/number-field.d.ts +2 -9
- package/dist/components/number-field.js +86 -36
- package/dist/components/number-roll.d.ts +26 -0
- package/dist/components/number-roll.js +81 -0
- package/dist/components/otp-field.d.ts +1 -1
- package/dist/components/otp-field.js +24 -3
- package/dist/components/pagination.d.ts +11 -3
- package/dist/components/pagination.js +59 -13
- package/dist/components/pdf-viewer.d.ts +1 -1
- package/dist/components/pdf-viewer.js +8 -8
- package/dist/components/phone-input.d.ts +1 -1
- package/dist/components/phone-input.js +2 -2
- package/dist/components/popover.js +5 -3
- package/dist/components/preview-card.d.ts +37 -2
- package/dist/components/preview-card.js +226 -2
- package/dist/components/progress.js +1 -1
- package/dist/components/prompt-input.d.ts +1 -1
- package/dist/components/prompt-input.js +24 -14
- package/dist/components/pull-to-refresh.d.ts +50 -0
- package/dist/components/pull-to-refresh.js +189 -0
- package/dist/components/quote.d.ts +6 -1
- package/dist/components/quote.js +3 -2
- package/dist/components/radio-group.js +1 -1
- package/dist/components/rating.d.ts +4 -1
- package/dist/components/rating.js +131 -10
- package/dist/components/reasoning.d.ts +1 -1
- package/dist/components/reasoning.js +7 -3
- package/dist/components/resizable.d.ts +1 -1
- package/dist/components/resizable.js +2 -2
- package/dist/components/response.d.ts +1 -1
- package/dist/components/response.js +18 -6
- package/dist/components/scheduler.d.ts +352 -0
- package/dist/components/scheduler.js +1717 -0
- package/dist/components/scroll-area.js +1 -1
- package/dist/components/select.d.ts +17 -4
- package/dist/components/select.js +140 -9
- package/dist/components/separator.d.ts +1 -1
- package/dist/components/separator.js +3 -3
- package/dist/components/sidebar.d.ts +44 -3
- package/dist/components/sidebar.js +57 -17
- package/dist/components/site-header.d.ts +18 -13
- package/dist/components/site-header.js +23 -11
- package/dist/components/skeleton.d.ts +17 -7
- package/dist/components/skeleton.js +22 -7
- package/dist/components/slider.js +2 -2
- package/dist/components/sortable.d.ts +55 -4
- package/dist/components/sortable.js +172 -103
- package/dist/components/sources.d.ts +1 -1
- package/dist/components/sources.js +2 -2
- package/dist/components/spinner.d.ts +4 -4
- package/dist/components/spinner.js +4 -4
- package/dist/components/stat.d.ts +21 -4
- package/dist/components/stat.js +17 -8
- package/dist/components/stepper.d.ts +1 -1
- package/dist/components/stepper.js +8 -7
- package/dist/components/suggestions.d.ts +11 -3
- package/dist/components/suggestions.js +10 -4
- package/dist/components/swipe-actions.d.ts +66 -0
- package/dist/components/swipe-actions.js +292 -0
- package/dist/components/switch.js +1 -1
- package/dist/components/table.d.ts +12 -6
- package/dist/components/table.js +78 -30
- package/dist/components/tabs.js +7 -4
- package/dist/components/tag.d.ts +19 -20
- package/dist/components/tag.js +9 -5
- package/dist/components/tags-input.d.ts +2 -7
- package/dist/components/tags-input.js +11 -8
- package/dist/components/textarea.d.ts +3 -2
- package/dist/components/textarea.js +4 -3
- package/dist/components/theme.d.ts +49 -6
- package/dist/components/theme.js +147 -9
- package/dist/components/time-field.d.ts +4 -9
- package/dist/components/time-field.js +6 -6
- package/dist/components/timeline.d.ts +19 -3
- package/dist/components/timeline.js +21 -9
- package/dist/components/tippy.d.ts +17 -1
- package/dist/components/tippy.js +95 -15
- package/dist/components/toast.d.ts +2 -7
- package/dist/components/toast.js +12 -8
- package/dist/components/toggle-group.d.ts +7 -1
- package/dist/components/toggle-group.js +16 -5
- package/dist/components/toggle.d.ts +2 -2
- package/dist/components/toggle.js +3 -2
- package/dist/components/tool-call.d.ts +1 -1
- package/dist/components/tool-call.js +4 -4
- package/dist/components/toolbar.d.ts +57 -4
- package/dist/components/toolbar.js +216 -16
- package/dist/components/tooltip.d.ts +1 -1
- package/dist/components/tooltip.js +4 -2
- package/dist/components/tour.d.ts +1 -1
- package/dist/components/tour.js +36 -15
- package/dist/components/tree.js +5 -5
- package/dist/components/typography.d.ts +31 -8
- package/dist/components/typography.js +21 -10
- package/dist/components/video-player.d.ts +7 -2
- package/dist/components/video-player.js +121 -220
- package/dist/index.d.ts +99 -92
- package/dist/index.js +99 -92
- package/dist/lib/calendar.d.ts +153 -0
- package/dist/lib/calendar.js +312 -0
- package/dist/lib/cn.d.ts +3 -1
- package/dist/lib/cn.js +5 -0
- package/dist/lib/code-highlight.d.ts +14 -0
- package/dist/lib/code-highlight.js +81 -18
- package/dist/lib/drag.d.ts +39 -0
- package/dist/lib/drag.js +96 -0
- package/dist/lib/editorial-assets.js +16 -8
- package/dist/lib/figure/figures/automation.js +25 -6
- package/dist/lib/figure/figures/bar-chart.js +6 -1
- package/dist/lib/figure/figures/brackets-classic.js +4 -1
- package/dist/lib/figure/figures/city.js +12 -2
- package/dist/lib/figure/figures/conveyor.js +17 -4
- package/dist/lib/figure/figures/database.js +5 -2
- package/dist/lib/figure/figures/documents.js +11 -3
- package/dist/lib/figure/figures/inbox.js +5 -2
- package/dist/lib/figure/figures/laptop.js +3 -1
- package/dist/lib/figure/figures/pipeline.js +45 -10
- package/dist/lib/figure/figures/platform.js +62 -7
- package/dist/lib/figure/figures/server.js +21 -5
- package/dist/lib/figure/figures/spreadsheet.js +29 -5
- package/dist/lib/figure/kernel.d.ts +4 -2
- package/dist/lib/figure/kernel.js +10 -5
- package/dist/lib/figure/parts.js +6 -2
- package/dist/lib/files.d.ts +31 -0
- package/dist/lib/files.js +60 -0
- package/dist/lib/gesture.d.ts +70 -0
- package/dist/lib/gesture.js +141 -0
- package/dist/lib/glide.d.ts +5 -0
- package/dist/lib/glide.js +9 -1
- package/dist/lib/icons.d.ts +1 -0
- package/dist/lib/icons.js +6 -0
- package/dist/lib/illustration-library.js +1 -6
- package/dist/lib/markdown-edit.d.ts +112 -0
- package/dist/lib/markdown-edit.js +557 -0
- package/dist/lib/markdown-rich-editor.d.ts +188 -0
- package/dist/lib/markdown-rich-editor.js +1153 -0
- package/dist/lib/markdown-rich.d.ts +63 -0
- package/dist/lib/markdown-rich.js +534 -0
- package/dist/lib/mentions.d.ts +100 -0
- package/dist/lib/mentions.js +246 -0
- package/dist/lib/motion.d.ts +18 -0
- package/dist/lib/motion.js +43 -5
- package/dist/lib/number-roll.d.ts +89 -0
- package/dist/lib/number-roll.js +391 -0
- package/dist/lib/platform.d.ts +6 -0
- package/dist/lib/platform.js +14 -0
- package/dist/lib/portal-container.d.ts +9 -0
- package/dist/lib/portal-container.js +10 -0
- package/dist/lib/press.d.ts +5 -0
- package/dist/lib/press.js +186 -0
- package/dist/lib/scheduler.d.ts +128 -0
- package/dist/lib/scheduler.js +272 -0
- package/dist/lib/scroll-edges.d.ts +9 -0
- package/dist/lib/scroll-edges.js +50 -0
- package/dist/lib/table-fit.d.ts +1 -1
- package/dist/lib/table-fit.js +65 -8
- package/dist/lib/theme-preset.d.ts +267 -0
- package/dist/lib/theme-preset.js +1046 -0
- package/dist/lib/theme-script.d.ts +23 -3
- package/dist/lib/theme-script.js +17 -5
- package/dist/lib/tippy/sprite.d.ts +36 -4
- package/dist/lib/tippy/sprite.js +188 -15
- package/dist/lib/tone.d.ts +4 -0
- package/dist/lib/tone.js +1 -0
- package/dist/messages/de.d.ts +3 -3
- package/dist/messages/de.js +274 -3
- package/dist/skills/zon-ui/SKILL.md +279 -0
- package/dist/skills/zon-ui/references/authoring.md +265 -0
- package/dist/skills/zon-ui/references/brand.md +416 -0
- package/dist/skills/zon-ui/references/components/accordion.md +199 -0
- package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
- package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
- package/dist/skills/zon-ui/references/components/alert.md +167 -0
- package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
- package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
- package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
- package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
- package/dist/skills/zon-ui/references/components/avatar.md +98 -0
- package/dist/skills/zon-ui/references/components/badge.md +227 -0
- package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
- package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
- package/dist/skills/zon-ui/references/components/button-group.md +216 -0
- package/dist/skills/zon-ui/references/components/button.md +309 -0
- package/dist/skills/zon-ui/references/components/calendar.md +296 -0
- package/dist/skills/zon-ui/references/components/card.md +158 -0
- package/dist/skills/zon-ui/references/components/carousel.md +297 -0
- package/dist/skills/zon-ui/references/components/chart.md +739 -0
- package/dist/skills/zon-ui/references/components/chat.md +417 -0
- package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
- package/dist/skills/zon-ui/references/components/code-block.md +143 -0
- package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
- package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
- package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
- package/dist/skills/zon-ui/references/components/combobox.md +455 -0
- package/dist/skills/zon-ui/references/components/command.md +326 -0
- package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
- package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
- package/dist/skills/zon-ui/references/components/conversation.md +146 -0
- package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
- package/dist/skills/zon-ui/references/components/crm.md +1022 -0
- package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
- package/dist/skills/zon-ui/references/components/data-table.md +776 -0
- package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
- package/dist/skills/zon-ui/references/components/dialog.md +335 -0
- package/dist/skills/zon-ui/references/components/direction.md +165 -0
- package/dist/skills/zon-ui/references/components/drawer.md +276 -0
- package/dist/skills/zon-ui/references/components/drawing.md +94 -0
- package/dist/skills/zon-ui/references/components/empty.md +225 -0
- package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
- package/dist/skills/zon-ui/references/components/field.md +209 -0
- package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
- package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
- package/dist/skills/zon-ui/references/components/form.md +970 -0
- package/dist/skills/zon-ui/references/components/graph.md +339 -0
- package/dist/skills/zon-ui/references/components/illustration.md +497 -0
- package/dist/skills/zon-ui/references/components/inbox.md +263 -0
- package/dist/skills/zon-ui/references/components/input-group.md +339 -0
- package/dist/skills/zon-ui/references/components/input.md +189 -0
- package/dist/skills/zon-ui/references/components/item.md +277 -0
- package/dist/skills/zon-ui/references/components/kanban.md +626 -0
- package/dist/skills/zon-ui/references/components/kbd.md +116 -0
- package/dist/skills/zon-ui/references/components/label.md +104 -0
- package/dist/skills/zon-ui/references/components/layout.md +291 -0
- package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
- package/dist/skills/zon-ui/references/components/locale.md +279 -0
- package/dist/skills/zon-ui/references/components/logo.md +257 -0
- package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
- package/dist/skills/zon-ui/references/components/mentions.md +512 -0
- package/dist/skills/zon-ui/references/components/menu.md +218 -0
- package/dist/skills/zon-ui/references/components/menubar.md +292 -0
- package/dist/skills/zon-ui/references/components/message.md +243 -0
- package/dist/skills/zon-ui/references/components/meter.md +105 -0
- package/dist/skills/zon-ui/references/components/money-input.md +333 -0
- package/dist/skills/zon-ui/references/components/native-select.md +197 -0
- package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
- package/dist/skills/zon-ui/references/components/number-field.md +210 -0
- package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
- package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
- package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
- package/dist/skills/zon-ui/references/components/pagination.md +109 -0
- package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
- package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
- package/dist/skills/zon-ui/references/components/popover.md +176 -0
- package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
- package/dist/skills/zon-ui/references/components/pricing.md +724 -0
- package/dist/skills/zon-ui/references/components/progress.md +92 -0
- package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
- package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
- package/dist/skills/zon-ui/references/components/quote.md +115 -0
- package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
- package/dist/skills/zon-ui/references/components/rating.md +260 -0
- package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
- package/dist/skills/zon-ui/references/components/resizable.md +213 -0
- package/dist/skills/zon-ui/references/components/response.md +170 -0
- package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
- package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
- package/dist/skills/zon-ui/references/components/select.md +351 -0
- package/dist/skills/zon-ui/references/components/separator.md +103 -0
- package/dist/skills/zon-ui/references/components/settings.md +793 -0
- package/dist/skills/zon-ui/references/components/shop.md +1715 -0
- package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
- package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
- package/dist/skills/zon-ui/references/components/site-header.md +303 -0
- package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
- package/dist/skills/zon-ui/references/components/slider.md +172 -0
- package/dist/skills/zon-ui/references/components/sortable.md +405 -0
- package/dist/skills/zon-ui/references/components/sources.md +106 -0
- package/dist/skills/zon-ui/references/components/spinner.md +222 -0
- package/dist/skills/zon-ui/references/components/stat.md +267 -0
- package/dist/skills/zon-ui/references/components/stepper.md +285 -0
- package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
- package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
- package/dist/skills/zon-ui/references/components/switch.md +160 -0
- package/dist/skills/zon-ui/references/components/table.md +999 -0
- package/dist/skills/zon-ui/references/components/tabs.md +258 -0
- package/dist/skills/zon-ui/references/components/tag.md +115 -0
- package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
- package/dist/skills/zon-ui/references/components/textarea.md +95 -0
- package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
- package/dist/skills/zon-ui/references/components/theme.md +362 -0
- package/dist/skills/zon-ui/references/components/time-field.md +222 -0
- package/dist/skills/zon-ui/references/components/timeline.md +285 -0
- package/dist/skills/zon-ui/references/components/tippy.md +243 -0
- package/dist/skills/zon-ui/references/components/toast.md +220 -0
- package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
- package/dist/skills/zon-ui/references/components/toggle.md +167 -0
- package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
- package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
- package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
- package/dist/skills/zon-ui/references/components/tour.md +423 -0
- package/dist/skills/zon-ui/references/components/tree.md +481 -0
- package/dist/skills/zon-ui/references/components/typography.md +347 -0
- package/dist/skills/zon-ui/references/components/video-player.md +386 -0
- package/dist/skills/zon-ui/references/marketing.md +467 -0
- package/dist/skills/zon-ui/references/motion.md +455 -0
- package/dist/skills/zon-ui/references/recipes.md +1232 -0
- package/dist/skills/zon-ui/references/tokens.md +866 -0
- package/dist/sources/accordion.css +4 -0
- package/dist/sources/action-sheet.css +11 -0
- package/dist/sources/alert-dialog.css +6 -0
- package/dist/sources/alert.css +3 -0
- package/dist/sources/app-bar.css +14 -0
- package/dist/sources/ascii-field.css +3 -0
- package/dist/sources/aspect-ratio.css +3 -0
- package/dist/sources/audio-player.css +20 -0
- package/dist/sources/avatar.css +3 -0
- package/dist/sources/badge.css +3 -0
- package/dist/sources/bottom-nav.css +9 -0
- package/dist/sources/breadcrumb.css +14 -0
- package/dist/sources/button-group.css +3 -0
- package/dist/sources/button.css +9 -0
- package/dist/sources/calendar.css +13 -0
- package/dist/sources/card.css +3 -0
- package/dist/sources/carousel.css +11 -0
- package/dist/sources/chart.css +5 -0
- package/dist/sources/checkbox.css +6 -0
- package/dist/sources/code-block.css +13 -0
- package/dist/sources/collapsible.css +4 -0
- package/dist/sources/color-picker.css +13 -0
- package/dist/sources/combobox.css +13 -0
- package/dist/sources/command.css +13 -0
- package/dist/sources/context-menu.css +12 -0
- package/dist/sources/conversation.css +10 -0
- package/dist/sources/copy-button.css +10 -0
- package/dist/sources/data-table.css +27 -0
- package/dist/sources/date-picker.css +20 -0
- package/dist/sources/dialog.css +9 -0
- package/dist/sources/direction.css +2 -0
- package/dist/sources/drawer.css +9 -0
- package/dist/sources/drawing.css +5 -0
- package/dist/sources/empty.css +3 -0
- package/dist/sources/feature-list.css +4 -0
- package/dist/sources/field.css +4 -0
- package/dist/sources/file-drop.css +15 -0
- package/dist/sources/filter-bar.css +30 -0
- package/dist/sources/form.css +4 -0
- package/dist/sources/graph.css +19 -0
- package/dist/sources/illustration.css +28 -0
- package/dist/sources/input-group.css +7 -0
- package/dist/sources/input.css +3 -0
- package/dist/sources/item.css +4 -0
- package/dist/sources/kbd.css +5 -0
- package/dist/sources/label.css +3 -0
- package/dist/sources/layout.css +3 -0
- package/dist/sources/lightbox.css +33 -0
- package/dist/sources/locale.css +2 -0
- package/dist/sources/logo.css +4 -0
- package/dist/sources/markdown-editor.css +41 -0
- package/dist/sources/mentions.css +13 -0
- package/dist/sources/menu.css +11 -0
- package/dist/sources/menubar.css +14 -0
- package/dist/sources/message.css +16 -0
- package/dist/sources/meter.css +4 -0
- package/dist/sources/money-input.css +10 -0
- package/dist/sources/native-select.css +4 -0
- package/dist/sources/navigation-menu.css +8 -0
- package/dist/sources/number-field.css +8 -0
- package/dist/sources/number-roll.css +6 -0
- package/dist/sources/otp-field.css +5 -0
- package/dist/sources/pagination.css +11 -0
- package/dist/sources/pdf-viewer.css +30 -0
- package/dist/sources/phone-input.css +20 -0
- package/dist/sources/popover.css +7 -0
- package/dist/sources/preview-card.css +7 -0
- package/dist/sources/progress.css +4 -0
- package/dist/sources/prompt-input.css +15 -0
- package/dist/sources/pull-to-refresh.css +14 -0
- package/dist/sources/quote.css +3 -0
- package/dist/sources/radio-group.css +5 -0
- package/dist/sources/rating.css +6 -0
- package/dist/sources/reasoning.css +6 -0
- package/dist/sources/resizable.css +4 -0
- package/dist/sources/response.css +16 -0
- package/dist/sources/scheduler.css +44 -0
- package/dist/sources/scroll-area.css +3 -0
- package/dist/sources/select.css +12 -0
- package/dist/sources/separator.css +3 -0
- package/dist/sources/sidebar.css +19 -0
- package/dist/sources/site-header.css +15 -0
- package/dist/sources/skeleton.css +3 -0
- package/dist/sources/slider.css +6 -0
- package/dist/sources/sortable.css +12 -0
- package/dist/sources/sources.css +6 -0
- package/dist/sources/spinner.css +6 -0
- package/dist/sources/stat.css +9 -0
- package/dist/sources/stepper.css +6 -0
- package/dist/sources/suggestions.css +10 -0
- package/dist/sources/swipe-actions.css +20 -0
- package/dist/sources/switch.css +5 -0
- package/dist/sources/table.css +7 -0
- package/dist/sources/tabs.css +5 -0
- package/dist/sources/tag.css +3 -0
- package/dist/sources/tags-input.css +6 -0
- package/dist/sources/textarea.css +3 -0
- package/dist/sources/theme.css +13 -0
- package/dist/sources/time-field.css +7 -0
- package/dist/sources/timeline.css +7 -0
- package/dist/sources/tippy.css +6 -0
- package/dist/sources/toast.css +6 -0
- package/dist/sources/toggle-group.css +5 -0
- package/dist/sources/toggle.css +3 -0
- package/dist/sources/tool-call.css +16 -0
- package/dist/sources/toolbar.css +14 -0
- package/dist/sources/tooltip.css +6 -0
- package/dist/sources/tour.css +14 -0
- package/dist/sources/tree.css +6 -0
- package/dist/sources/typography.css +4 -0
- package/dist/sources/video-player.css +21 -0
- package/dist/styles/ai.css +3 -0
- package/dist/styles/brand.css +98 -0
- package/dist/styles/core.css +266 -0
- package/dist/styles/editor.css +3 -0
- package/dist/styles/expressive.css +35 -56
- package/dist/styles/fonts.css +61 -117
- package/dist/styles/graph.css +4 -0
- package/dist/styles/illustration.css +4 -0
- package/dist/styles/index.css +11 -201
- package/dist/styles/material.css +138 -12
- package/dist/styles/parts/ai.css +18 -13
- package/dist/styles/parts/brand.css +2 -2
- package/dist/styles/parts/controls.css +29 -20
- package/dist/styles/parts/data.css +13 -9
- package/dist/styles/parts/editor.css +372 -0
- package/dist/styles/parts/feedback.css +32 -2
- package/dist/styles/parts/foundations.css +12 -7
- package/dist/styles/parts/graph.css +25 -9
- package/dist/styles/parts/inputs.css +172 -9
- package/dist/styles/parts/isometric.css +6 -5
- package/dist/styles/parts/navigation.css +206 -27
- package/dist/styles/parts/overlays.css +19 -4
- package/dist/styles/parts/pdf.css +2 -2
- package/dist/styles/pdf.css +3 -0
- package/dist/styles/prose.css +3 -0
- package/dist/styles/tokens.css +89 -14
- package/dist/theme.d.ts +1 -0
- package/dist/theme.js +5 -0
- package/dist/vite.d.ts +48 -59
- package/dist/vite.js +54 -21
- package/package.json +69 -2
|
@@ -0,0 +1,562 @@
|
|
|
1
|
+
# Contact form
|
|
2
|
+
|
|
3
|
+
```tsx
|
|
4
|
+
import { Button, Checkbox, Eyebrow, FeatureCallout, FeatureCalloutList, Field, FieldError, FieldLabel, Fieldset, FieldsetLegend, Form, FormActions, Heading, Input, Mono, Select, SelectContent, SelectItem, SelectTrigger, SelectValue, Text, Textarea, TwoTone } from "@zonsh/ui";
|
|
5
|
+
import { CircleCheckIcon, InboxIcon, MailIcon, MessagesSquareIcon } from "lucide-react";
|
|
6
|
+
import * as React from "react";
|
|
7
|
+
|
|
8
|
+
const TAKEN = "taken@example.com";
|
|
9
|
+
|
|
10
|
+
const topics = [
|
|
11
|
+
{ value: "general", label: "General question" },
|
|
12
|
+
{ value: "billing", label: "Billing" },
|
|
13
|
+
{ value: "problem", label: "Report a problem" },
|
|
14
|
+
{ value: "feedback", label: "Feedback" },
|
|
15
|
+
{ value: "other", label: "Something else" },
|
|
16
|
+
];
|
|
17
|
+
|
|
18
|
+
interface Sent {
|
|
19
|
+
name: string;
|
|
20
|
+
email: string;
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
/** A pretend round trip that never resolves after unmount, so no state is set on a dead tree. */
|
|
24
|
+
function useFakeRequest() {
|
|
25
|
+
const timer = React.useRef<ReturnType<typeof setTimeout> | undefined>(undefined);
|
|
26
|
+
React.useEffect(() => () => clearTimeout(timer.current), []);
|
|
27
|
+
return React.useCallback(
|
|
28
|
+
(ms: number) =>
|
|
29
|
+
new Promise<void>((resolve) => {
|
|
30
|
+
clearTimeout(timer.current);
|
|
31
|
+
timer.current = setTimeout(resolve, ms);
|
|
32
|
+
}),
|
|
33
|
+
[],
|
|
34
|
+
);
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
function firstName(value: unknown) {
|
|
38
|
+
return (
|
|
39
|
+
String(value ?? "")
|
|
40
|
+
.trim()
|
|
41
|
+
.split(/\s+/)[0] ?? ""
|
|
42
|
+
);
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
/** The submit button: keeps its width while pending, with the spinner laid over the label. */
|
|
46
|
+
function SubmitButton({ pending, children }: { pending: boolean; children: React.ReactNode }) {
|
|
47
|
+
return (
|
|
48
|
+
<Button type="submit" size="lg" loading={pending} loadingLabel="Sending your message">
|
|
49
|
+
{children}
|
|
50
|
+
</Button>
|
|
51
|
+
);
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
/** Replaces the form once it is sent. Focus moves here so keyboard and screen reader users follow.
|
|
55
|
+
* The form leaves at once; the confirmation fades in and rises 8px. Focus does not scroll the
|
|
56
|
+
* page to it: it is only brought into view as far as it has to be. It sits on the page like the
|
|
57
|
+
* form did, under the same hairline. */
|
|
58
|
+
function Confirmation({ sent, onReset }: { sent: Sent; onReset: () => void }) {
|
|
59
|
+
const ref = React.useRef<HTMLElement>(null);
|
|
60
|
+
const id = React.useId();
|
|
61
|
+
React.useEffect(() => {
|
|
62
|
+
const node = ref.current;
|
|
63
|
+
if (!node) return;
|
|
64
|
+
node.focus({ preventScroll: true });
|
|
65
|
+
node.scrollIntoView({ block: "nearest" });
|
|
66
|
+
}, []);
|
|
67
|
+
|
|
68
|
+
return (
|
|
69
|
+
<section
|
|
70
|
+
ref={ref}
|
|
71
|
+
tabIndex={-1}
|
|
72
|
+
aria-labelledby={id}
|
|
73
|
+
className="flex w-full flex-col items-start gap-5 border-t border-border/60 pt-6 transition-[opacity,translate] duration-[calc(var(--duration-fade)*4/3),calc(var(--duration)*4/3)] ease-(--ease) starting:translate-y-2 starting:opacity-0"
|
|
74
|
+
>
|
|
75
|
+
<p className="m-0 flex items-center gap-2 font-mono text-xs tracking-[0.08em] text-success uppercase">
|
|
76
|
+
<CircleCheckIcon aria-hidden className="size-4" />
|
|
77
|
+
Message sent
|
|
78
|
+
</p>
|
|
79
|
+
{/* What people typed can be one long word: it wraps instead of widening the page. */}
|
|
80
|
+
<Heading level={3} id={id} className="wrap-anywhere">
|
|
81
|
+
Thank you{sent.name ? `, ${sent.name}` : ""}.
|
|
82
|
+
</Heading>
|
|
83
|
+
<Text tone="soft">
|
|
84
|
+
We read every message ourselves and reply to <Mono className="wrap-anywhere">{sent.email}</Mono>.
|
|
85
|
+
There is nothing else to do for now.
|
|
86
|
+
</Text>
|
|
87
|
+
<Button variant="secondary" onClick={onReset}>
|
|
88
|
+
Send another message
|
|
89
|
+
</Button>
|
|
90
|
+
</section>
|
|
91
|
+
);
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
function ConsentField() {
|
|
95
|
+
return (
|
|
96
|
+
<Field name="consent">
|
|
97
|
+
<FieldLabel>
|
|
98
|
+
<Checkbox required />
|
|
99
|
+
<span>
|
|
100
|
+
I agree that you store these details to answer my message, as described in the{" "}
|
|
101
|
+
<a href="#" className="link">
|
|
102
|
+
privacy policy
|
|
103
|
+
</a>
|
|
104
|
+
.
|
|
105
|
+
</span>
|
|
106
|
+
</FieldLabel>
|
|
107
|
+
<FieldError match="valueMissing" className="ps-7">
|
|
108
|
+
Tick this box so we are allowed to reply.
|
|
109
|
+
</FieldError>
|
|
110
|
+
</Field>
|
|
111
|
+
);
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
/** Its own inline box, so it keeps its side of the label when the label's words run the other way. */
|
|
115
|
+
function OptionalMark() {
|
|
116
|
+
return (
|
|
117
|
+
<span className="ms-2 inline-block font-mono text-11 font-normal tracking-[0.08em] text-muted-foreground uppercase">
|
|
118
|
+
Optional
|
|
119
|
+
</span>
|
|
120
|
+
);
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
/** The form on the page, under hairlines; `card` sets it in a 20px card instead. */
|
|
124
|
+
export function ContactForm({ card = false }: { card?: boolean }) {
|
|
125
|
+
const request = useFakeRequest();
|
|
126
|
+
const emailRef = React.useRef<HTMLInputElement>(null);
|
|
127
|
+
const [pending, setPending] = React.useState(false);
|
|
128
|
+
const [errors, setErrors] = React.useState<Record<string, string>>({});
|
|
129
|
+
const [sent, setSent] = React.useState<Sent | null>(null);
|
|
130
|
+
const [again, setAgain] = React.useState(false);
|
|
131
|
+
|
|
132
|
+
// A server error lands on its field: move focus there so it is read out with the message.
|
|
133
|
+
React.useEffect(() => {
|
|
134
|
+
if (errors.email) emailRef.current?.focus();
|
|
135
|
+
}, [errors]);
|
|
136
|
+
|
|
137
|
+
async function submit(values: Record<string, unknown>) {
|
|
138
|
+
if (pending) return;
|
|
139
|
+
setPending(true);
|
|
140
|
+
setErrors({});
|
|
141
|
+
await request(900);
|
|
142
|
+
setPending(false);
|
|
143
|
+
const email = String(values.email ?? "").trim();
|
|
144
|
+
if (email.toLowerCase() === TAKEN) {
|
|
145
|
+
setErrors({
|
|
146
|
+
email:
|
|
147
|
+
"We already have an open conversation with this address. Reply to our last email, or use another address.",
|
|
148
|
+
});
|
|
149
|
+
return;
|
|
150
|
+
}
|
|
151
|
+
setSent({ name: firstName(values.name), email });
|
|
152
|
+
}
|
|
153
|
+
|
|
154
|
+
return (
|
|
155
|
+
<div className="@container w-full max-w-5xl">
|
|
156
|
+
<div className="grid gap-10 @3xl:grid-cols-[minmax(0,5fr)_minmax(0,7fr)] @3xl:gap-14">
|
|
157
|
+
<div className="flex flex-col gap-8">
|
|
158
|
+
<div className="flex flex-col gap-5">
|
|
159
|
+
<Eyebrow>Contact</Eyebrow>
|
|
160
|
+
<TwoTone>
|
|
161
|
+
{"Send us a message."}
|
|
162
|
+
{"A person will read it."}
|
|
163
|
+
</TwoTone>
|
|
164
|
+
<Text tone="soft">
|
|
165
|
+
Questions, problems and ideas are all welcome. A few lines are enough; we will ask if we need
|
|
166
|
+
more.
|
|
167
|
+
</Text>
|
|
168
|
+
</div>
|
|
169
|
+
<div className="flex flex-col gap-4 border-t border-border/60 pt-6">
|
|
170
|
+
<h3 className="m-0 eyebrow">What happens next</h3>
|
|
171
|
+
<FeatureCalloutList>
|
|
172
|
+
<FeatureCallout icon={<InboxIcon />} label="We read it">
|
|
173
|
+
A person reads your message before anyone replies.
|
|
174
|
+
</FeatureCallout>
|
|
175
|
+
<FeatureCallout icon={<MailIcon />} label="We reply by email">
|
|
176
|
+
With an answer, or with questions if we need more to go on.
|
|
177
|
+
</FeatureCallout>
|
|
178
|
+
<FeatureCallout icon={<MessagesSquareIcon />} label="We follow up">
|
|
179
|
+
If you reported a problem, we write again once it is fixed.
|
|
180
|
+
</FeatureCallout>
|
|
181
|
+
</FeatureCalloutList>
|
|
182
|
+
</div>
|
|
183
|
+
</div>
|
|
184
|
+
|
|
185
|
+
<div className="flex min-w-0 flex-col gap-3">
|
|
186
|
+
{sent ? (
|
|
187
|
+
<Confirmation
|
|
188
|
+
sent={sent}
|
|
189
|
+
onReset={() => {
|
|
190
|
+
setSent(null);
|
|
191
|
+
setAgain(true);
|
|
192
|
+
}}
|
|
193
|
+
/>
|
|
194
|
+
) : (
|
|
195
|
+
// On the page, not in a card: two fieldsets, each under a hairline with an eyebrow legend.
|
|
196
|
+
// The legend floats, so it sits below the fieldset's top rule instead of on it.
|
|
197
|
+
<Form
|
|
198
|
+
className={card ? "@container gap-8 surface-card" : "@container gap-8"}
|
|
199
|
+
errors={errors}
|
|
200
|
+
onFormSubmit={submit}
|
|
201
|
+
>
|
|
202
|
+
<Fieldset className="gap-5 border-t border-border/60 pt-6">
|
|
203
|
+
<FieldsetLegend className="float-left mb-0 w-full">About you</FieldsetLegend>
|
|
204
|
+
<div className="grid gap-5 @md:grid-cols-2">
|
|
205
|
+
<Field name="name">
|
|
206
|
+
<FieldLabel>Your name</FieldLabel>
|
|
207
|
+
<Input required autoComplete="name" placeholder="Alex Weber" autoFocus={again} />
|
|
208
|
+
<FieldError match="valueMissing">Tell us what to call you.</FieldError>
|
|
209
|
+
</Field>
|
|
210
|
+
<Field name="email">
|
|
211
|
+
<FieldLabel>Email</FieldLabel>
|
|
212
|
+
<Input
|
|
213
|
+
ref={emailRef}
|
|
214
|
+
required
|
|
215
|
+
type="email"
|
|
216
|
+
autoComplete="email"
|
|
217
|
+
placeholder="alex@example.com"
|
|
218
|
+
onChange={() => {
|
|
219
|
+
if (errors.email) setErrors({});
|
|
220
|
+
}}
|
|
221
|
+
/>
|
|
222
|
+
<FieldError match="valueMissing">We need an email address to reply to.</FieldError>
|
|
223
|
+
<FieldError match="typeMismatch">
|
|
224
|
+
That does not look like an email address. Check the part after the @.
|
|
225
|
+
</FieldError>
|
|
226
|
+
{errors.email ? <FieldError match>{errors.email}</FieldError> : null}
|
|
227
|
+
</Field>
|
|
228
|
+
</div>
|
|
229
|
+
|
|
230
|
+
<Field name="reference">
|
|
231
|
+
<FieldLabel>
|
|
232
|
+
Order or account number
|
|
233
|
+
<OptionalMark />
|
|
234
|
+
</FieldLabel>
|
|
235
|
+
<Input autoComplete="off" placeholder="A-10482" />
|
|
236
|
+
</Field>
|
|
237
|
+
</Fieldset>
|
|
238
|
+
|
|
239
|
+
<Fieldset className="gap-5 border-t border-border/60 pt-6">
|
|
240
|
+
<FieldsetLegend className="float-left mb-0 w-full">Your message</FieldsetLegend>
|
|
241
|
+
<Field name="topic">
|
|
242
|
+
<FieldLabel>What is it about?</FieldLabel>
|
|
243
|
+
<Select items={topics} required>
|
|
244
|
+
<SelectTrigger>
|
|
245
|
+
<SelectValue placeholder="Choose the closest fit" />
|
|
246
|
+
</SelectTrigger>
|
|
247
|
+
<SelectContent>
|
|
248
|
+
{topics.map((topic) => (
|
|
249
|
+
<SelectItem key={topic.value} value={topic.value}>
|
|
250
|
+
{topic.label}
|
|
251
|
+
</SelectItem>
|
|
252
|
+
))}
|
|
253
|
+
</SelectContent>
|
|
254
|
+
</Select>
|
|
255
|
+
<FieldError match="valueMissing">Pick one. "Something else" is a fine answer.</FieldError>
|
|
256
|
+
</Field>
|
|
257
|
+
|
|
258
|
+
<Field name="message">
|
|
259
|
+
<FieldLabel>Your message</FieldLabel>
|
|
260
|
+
<Textarea
|
|
261
|
+
required
|
|
262
|
+
minLength={20}
|
|
263
|
+
placeholder="How can we help? If something went wrong, what did you expect to happen?"
|
|
264
|
+
/>
|
|
265
|
+
<FieldError match="valueMissing">
|
|
266
|
+
A sentence or two helps us answer the first time.
|
|
267
|
+
</FieldError>
|
|
268
|
+
<FieldError match="tooShort">
|
|
269
|
+
A little more detail, please: at least 20 characters.
|
|
270
|
+
</FieldError>
|
|
271
|
+
</Field>
|
|
272
|
+
</Fieldset>
|
|
273
|
+
|
|
274
|
+
<div className="flex flex-col gap-6 border-t border-border/60 pt-6">
|
|
275
|
+
<ConsentField />
|
|
276
|
+
|
|
277
|
+
<FormActions>
|
|
278
|
+
<SubmitButton pending={pending}>Send message</SubmitButton>
|
|
279
|
+
</FormActions>
|
|
280
|
+
</div>
|
|
281
|
+
</Form>
|
|
282
|
+
)}
|
|
283
|
+
<p className="m-0 font-mono text-xs text-muted-foreground">
|
|
284
|
+
Demo: nothing is sent. Use {TAKEN} to see an error from the server.
|
|
285
|
+
</p>
|
|
286
|
+
</div>
|
|
287
|
+
</div>
|
|
288
|
+
</div>
|
|
289
|
+
);
|
|
290
|
+
}
|
|
291
|
+
```
|
|
292
|
+
|
|
293
|
+
A contact section: a two-tone Licht headline and what happens after sending on the left; on the right the form, on the page, in two hairline fieldsets, then consent and submit. Submit empty for the client checks, send from `taken@example.com` for a server error on the email field, or send properly to see the confirmation. Nothing is sent.
|
|
294
|
+
|
|
295
|
+
## Usage
|
|
296
|
+
|
|
297
|
+
- **`Form` with `errors` and `onFormSubmit`** — checks, values by field name, server errors under their fields.
|
|
298
|
+
- **`Fieldset` + `Field`** — hairline groups; a visible label and one `FieldError` per problem.
|
|
299
|
+
- **`FormActions` + `Button loading`** — the one primary, keeping its width while it sends.
|
|
300
|
+
|
|
301
|
+
Adapt the fields, topics and "what happens next" lines — promise only what you keep.
|
|
302
|
+
|
|
303
|
+
```tsx
|
|
304
|
+
import { Button, Field, FieldError, FieldLabel, Fieldset, FieldsetLegend, Form, FormActions, Input, TwoTone } from "@zonsh/ui";
|
|
305
|
+
|
|
306
|
+
// A sketch: `Confirmation`, `submit` and the state are written out in full in the example above.
|
|
307
|
+
<div className="@container">
|
|
308
|
+
<div className="grid gap-10 @3xl:grid-cols-[minmax(0,5fr)_minmax(0,7fr)]">
|
|
309
|
+
<TwoTone>
|
|
310
|
+
{"Send us a message."}
|
|
311
|
+
{"A person will read it."}
|
|
312
|
+
</TwoTone>
|
|
313
|
+
{sent ? (
|
|
314
|
+
<Confirmation sent={sent} onReset={() => setSent(null)} />
|
|
315
|
+
) : (
|
|
316
|
+
<Form className="gap-8" errors={errors} onFormSubmit={submit}>
|
|
317
|
+
<Fieldset className="gap-5 border-t border-border/60 pt-6">
|
|
318
|
+
<FieldsetLegend>About you</FieldsetLegend>
|
|
319
|
+
<Field name="email">
|
|
320
|
+
<FieldLabel>Email</FieldLabel>
|
|
321
|
+
<Input required type="email" autoComplete="email" />
|
|
322
|
+
<FieldError match="valueMissing">We need an email address to reply to.</FieldError>
|
|
323
|
+
<FieldError match="typeMismatch">That does not look like an email address.</FieldError>
|
|
324
|
+
{errors.email ? <FieldError match>{errors.email}</FieldError> : null}
|
|
325
|
+
</Field>
|
|
326
|
+
</Fieldset>
|
|
327
|
+
{/* Your message: topic Select, message Textarea; consent Checkbox under a hairline */}
|
|
328
|
+
<FormActions>
|
|
329
|
+
<Button type="submit" size="lg" loading={pending} loadingLabel="Sending your message">
|
|
330
|
+
Send message
|
|
331
|
+
</Button>
|
|
332
|
+
</FormActions>
|
|
333
|
+
</Form>
|
|
334
|
+
)}
|
|
335
|
+
</div>
|
|
336
|
+
</div>;
|
|
337
|
+
```
|
|
338
|
+
|
|
339
|
+
Return server errors as `{ email: "…" }` and pass them to `errors`; render them with `<FieldError match>` so they don't double the client messages, and clear one when its field changes. Two columns from `@3xl` of its container, so it stacks in a narrow pane too.
|
|
340
|
+
|
|
341
|
+
## When to use
|
|
342
|
+
|
|
343
|
+
- The contact or support section closing a page, or a `/contact` page; it stacks in a narrow column or dialog.
|
|
344
|
+
- A call to action with no fields is one button linking to the form; don't repeat the form.
|
|
345
|
+
|
|
346
|
+
## Examples
|
|
347
|
+
|
|
348
|
+
### Card
|
|
349
|
+
|
|
350
|
+
In a 20px card, where the form is the one thing on the page to fill in.
|
|
351
|
+
|
|
352
|
+
```tsx
|
|
353
|
+
import { Button, Checkbox, Eyebrow, FeatureCallout, FeatureCalloutList, Field, FieldError, FieldLabel, Fieldset, FieldsetLegend, Form, FormActions, Heading, Input, Mono, Select, SelectContent, SelectItem, SelectTrigger, SelectValue, Text, Textarea, TwoTone } from "@zonsh/ui";
|
|
354
|
+
import { CircleCheckIcon, InboxIcon, MailIcon, MessagesSquareIcon } from "lucide-react";
|
|
355
|
+
import * as React from "react";
|
|
356
|
+
|
|
357
|
+
// TAKEN, topics, Sent, useFakeRequest, firstName, SubmitButton, Confirmation, ConsentField, OptionalMark: as in the first example on this page that uses them.
|
|
358
|
+
|
|
359
|
+
/** The form on the page, under hairlines; `card` sets it in a 20px card instead. */
|
|
360
|
+
function ContactForm({ card = false }: { card?: boolean }) {
|
|
361
|
+
const request = useFakeRequest();
|
|
362
|
+
const emailRef = React.useRef<HTMLInputElement>(null);
|
|
363
|
+
const [pending, setPending] = React.useState(false);
|
|
364
|
+
const [errors, setErrors] = React.useState<Record<string, string>>({});
|
|
365
|
+
const [sent, setSent] = React.useState<Sent | null>(null);
|
|
366
|
+
const [again, setAgain] = React.useState(false);
|
|
367
|
+
|
|
368
|
+
// A server error lands on its field: move focus there so it is read out with the message.
|
|
369
|
+
React.useEffect(() => {
|
|
370
|
+
if (errors.email) emailRef.current?.focus();
|
|
371
|
+
}, [errors]);
|
|
372
|
+
|
|
373
|
+
async function submit(values: Record<string, unknown>) {
|
|
374
|
+
if (pending) return;
|
|
375
|
+
setPending(true);
|
|
376
|
+
setErrors({});
|
|
377
|
+
await request(900);
|
|
378
|
+
setPending(false);
|
|
379
|
+
const email = String(values.email ?? "").trim();
|
|
380
|
+
if (email.toLowerCase() === TAKEN) {
|
|
381
|
+
setErrors({
|
|
382
|
+
email:
|
|
383
|
+
"We already have an open conversation with this address. Reply to our last email, or use another address.",
|
|
384
|
+
});
|
|
385
|
+
return;
|
|
386
|
+
}
|
|
387
|
+
setSent({ name: firstName(values.name), email });
|
|
388
|
+
}
|
|
389
|
+
|
|
390
|
+
return (
|
|
391
|
+
<div className="@container w-full max-w-5xl">
|
|
392
|
+
<div className="grid gap-10 @3xl:grid-cols-[minmax(0,5fr)_minmax(0,7fr)] @3xl:gap-14">
|
|
393
|
+
<div className="flex flex-col gap-8">
|
|
394
|
+
<div className="flex flex-col gap-5">
|
|
395
|
+
<Eyebrow>Contact</Eyebrow>
|
|
396
|
+
<TwoTone>
|
|
397
|
+
{"Send us a message."}
|
|
398
|
+
{"A person will read it."}
|
|
399
|
+
</TwoTone>
|
|
400
|
+
<Text tone="soft">
|
|
401
|
+
Questions, problems and ideas are all welcome. A few lines are enough; we will ask if we need
|
|
402
|
+
more.
|
|
403
|
+
</Text>
|
|
404
|
+
</div>
|
|
405
|
+
<div className="flex flex-col gap-4 border-t border-border/60 pt-6">
|
|
406
|
+
<h3 className="m-0 eyebrow">What happens next</h3>
|
|
407
|
+
<FeatureCalloutList>
|
|
408
|
+
<FeatureCallout icon={<InboxIcon />} label="We read it">
|
|
409
|
+
A person reads your message before anyone replies.
|
|
410
|
+
</FeatureCallout>
|
|
411
|
+
<FeatureCallout icon={<MailIcon />} label="We reply by email">
|
|
412
|
+
With an answer, or with questions if we need more to go on.
|
|
413
|
+
</FeatureCallout>
|
|
414
|
+
<FeatureCallout icon={<MessagesSquareIcon />} label="We follow up">
|
|
415
|
+
If you reported a problem, we write again once it is fixed.
|
|
416
|
+
</FeatureCallout>
|
|
417
|
+
</FeatureCalloutList>
|
|
418
|
+
</div>
|
|
419
|
+
</div>
|
|
420
|
+
|
|
421
|
+
<div className="flex min-w-0 flex-col gap-3">
|
|
422
|
+
{sent ? (
|
|
423
|
+
<Confirmation
|
|
424
|
+
sent={sent}
|
|
425
|
+
onReset={() => {
|
|
426
|
+
setSent(null);
|
|
427
|
+
setAgain(true);
|
|
428
|
+
}}
|
|
429
|
+
/>
|
|
430
|
+
) : (
|
|
431
|
+
// On the page, not in a card: two fieldsets, each under a hairline with an eyebrow legend.
|
|
432
|
+
// The legend floats, so it sits below the fieldset's top rule instead of on it.
|
|
433
|
+
<Form
|
|
434
|
+
className={card ? "@container gap-8 surface-card" : "@container gap-8"}
|
|
435
|
+
errors={errors}
|
|
436
|
+
onFormSubmit={submit}
|
|
437
|
+
>
|
|
438
|
+
<Fieldset className="gap-5 border-t border-border/60 pt-6">
|
|
439
|
+
<FieldsetLegend className="float-left mb-0 w-full">About you</FieldsetLegend>
|
|
440
|
+
<div className="grid gap-5 @md:grid-cols-2">
|
|
441
|
+
<Field name="name">
|
|
442
|
+
<FieldLabel>Your name</FieldLabel>
|
|
443
|
+
<Input required autoComplete="name" placeholder="Alex Weber" autoFocus={again} />
|
|
444
|
+
<FieldError match="valueMissing">Tell us what to call you.</FieldError>
|
|
445
|
+
</Field>
|
|
446
|
+
<Field name="email">
|
|
447
|
+
<FieldLabel>Email</FieldLabel>
|
|
448
|
+
<Input
|
|
449
|
+
ref={emailRef}
|
|
450
|
+
required
|
|
451
|
+
type="email"
|
|
452
|
+
autoComplete="email"
|
|
453
|
+
placeholder="alex@example.com"
|
|
454
|
+
onChange={() => {
|
|
455
|
+
if (errors.email) setErrors({});
|
|
456
|
+
}}
|
|
457
|
+
/>
|
|
458
|
+
<FieldError match="valueMissing">We need an email address to reply to.</FieldError>
|
|
459
|
+
<FieldError match="typeMismatch">
|
|
460
|
+
That does not look like an email address. Check the part after the @.
|
|
461
|
+
</FieldError>
|
|
462
|
+
{errors.email ? <FieldError match>{errors.email}</FieldError> : null}
|
|
463
|
+
</Field>
|
|
464
|
+
</div>
|
|
465
|
+
|
|
466
|
+
<Field name="reference">
|
|
467
|
+
<FieldLabel>
|
|
468
|
+
Order or account number
|
|
469
|
+
<OptionalMark />
|
|
470
|
+
</FieldLabel>
|
|
471
|
+
<Input autoComplete="off" placeholder="A-10482" />
|
|
472
|
+
</Field>
|
|
473
|
+
</Fieldset>
|
|
474
|
+
|
|
475
|
+
<Fieldset className="gap-5 border-t border-border/60 pt-6">
|
|
476
|
+
<FieldsetLegend className="float-left mb-0 w-full">Your message</FieldsetLegend>
|
|
477
|
+
<Field name="topic">
|
|
478
|
+
<FieldLabel>What is it about?</FieldLabel>
|
|
479
|
+
<Select items={topics} required>
|
|
480
|
+
<SelectTrigger>
|
|
481
|
+
<SelectValue placeholder="Choose the closest fit" />
|
|
482
|
+
</SelectTrigger>
|
|
483
|
+
<SelectContent>
|
|
484
|
+
{topics.map((topic) => (
|
|
485
|
+
<SelectItem key={topic.value} value={topic.value}>
|
|
486
|
+
{topic.label}
|
|
487
|
+
</SelectItem>
|
|
488
|
+
))}
|
|
489
|
+
</SelectContent>
|
|
490
|
+
</Select>
|
|
491
|
+
<FieldError match="valueMissing">Pick one. "Something else" is a fine answer.</FieldError>
|
|
492
|
+
</Field>
|
|
493
|
+
|
|
494
|
+
<Field name="message">
|
|
495
|
+
<FieldLabel>Your message</FieldLabel>
|
|
496
|
+
<Textarea
|
|
497
|
+
required
|
|
498
|
+
minLength={20}
|
|
499
|
+
placeholder="How can we help? If something went wrong, what did you expect to happen?"
|
|
500
|
+
/>
|
|
501
|
+
<FieldError match="valueMissing">
|
|
502
|
+
A sentence or two helps us answer the first time.
|
|
503
|
+
</FieldError>
|
|
504
|
+
<FieldError match="tooShort">
|
|
505
|
+
A little more detail, please: at least 20 characters.
|
|
506
|
+
</FieldError>
|
|
507
|
+
</Field>
|
|
508
|
+
</Fieldset>
|
|
509
|
+
|
|
510
|
+
<div className="flex flex-col gap-6 border-t border-border/60 pt-6">
|
|
511
|
+
<ConsentField />
|
|
512
|
+
|
|
513
|
+
<FormActions>
|
|
514
|
+
<SubmitButton pending={pending}>Send message</SubmitButton>
|
|
515
|
+
</FormActions>
|
|
516
|
+
</div>
|
|
517
|
+
</Form>
|
|
518
|
+
)}
|
|
519
|
+
<p className="m-0 font-mono text-xs text-muted-foreground">
|
|
520
|
+
Demo: nothing is sent. Use {TAKEN} to see an error from the server.
|
|
521
|
+
</p>
|
|
522
|
+
</div>
|
|
523
|
+
</div>
|
|
524
|
+
</div>
|
|
525
|
+
);
|
|
526
|
+
}
|
|
527
|
+
|
|
528
|
+
export function Card() {
|
|
529
|
+
return <ContactForm card />;
|
|
530
|
+
}
|
|
531
|
+
```
|
|
532
|
+
|
|
533
|
+
## The parts
|
|
534
|
+
|
|
535
|
+
| Part | Page | Job |
|
|
536
|
+
| -------------------------------------- | ------------ | ---------------------------------------------------------------------------- |
|
|
537
|
+
| `Form`, `FormActions` | Form | Runs the checks on submit, maps server errors by name, holds the submit |
|
|
538
|
+
| `Field`, `FieldLabel`, `FieldError` | Field | A visible label for every control and a specific message for each problem |
|
|
539
|
+
| `Fieldset`, `FieldsetLegend` | Field | The two groups of the form, each named by an eyebrow legend under a hairline |
|
|
540
|
+
| `Input` | Input | Name, email and the optional order or account number |
|
|
541
|
+
| `Select` | Select | The topic, with "Something else" as a real answer |
|
|
542
|
+
| `Textarea` | Textarea | The message, at least 140px and resizable |
|
|
543
|
+
| `Checkbox` | Checkbox | Consent, with the privacy policy linked in its label |
|
|
544
|
+
| `Button` | Button | The one primary, which keeps its width while it is `loading` |
|
|
545
|
+
| `TwoTone`, `Eyebrow`, `Text`, `Mono` | Typography | The headline pair, the section label and the reading copy |
|
|
546
|
+
| `FeatureCalloutList`, `FeatureCallout` | Feature List | What happens after sending, as mono-keyed lines under a hairline |
|
|
547
|
+
|
|
548
|
+
## Brand rules
|
|
549
|
+
|
|
550
|
+
- **Do** keep one primary: "Send message". "Send another message" and a "Contact us" button elsewhere are `secondary`.
|
|
551
|
+
- **Do** say what happens after sending, and nothing you cannot keep: no reply times, no "trusted by", no numbers.
|
|
552
|
+
- **Do** mark the optional field, not the required ones, and accept "Something else" as a topic.
|
|
553
|
+
- **Do** use the success green only with its icon and the words "Message sent"; the rest of the confirmation stays neutral.
|
|
554
|
+
- **Don't** box the form or its column; headline, whitespace and hairlines carry the structure.
|
|
555
|
+
- **Don't** disable the submit to signal errors. Let people submit and show what is missing, field by field.
|
|
556
|
+
|
|
557
|
+
## Accessibility
|
|
558
|
+
|
|
559
|
+
- Every control has a visible `FieldLabel`; placeholders are examples. Each error is linked to its control through `aria-describedby` and uses colour and text.
|
|
560
|
+
- On an invalid submit, focus moves to the first invalid field; a server error moves focus to its field, so its message is read with it.
|
|
561
|
+
- While sending, the submit is `aria-busy` and its spinner says "Sending your message"; repeat clicks are ignored.
|
|
562
|
+
- The confirmation is a labelled region that takes focus when it replaces the form; it fades in and rises 8px, the form leaves at once, and it scrolls only as far as needed. "Send another message" returns focus to the first field.
|