@zonsh/ui 0.4.1 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (562) hide show
  1. package/CHANGELOG.md +639 -0
  2. package/README.md +49 -21
  3. package/dist/brand.d.ts +3 -0
  4. package/dist/brand.js +7 -0
  5. package/dist/components/_breadcrumb-more.d.ts +6 -0
  6. package/dist/components/_breadcrumb-more.js +5 -0
  7. package/dist/components/_drawing-svg.d.ts +11 -0
  8. package/dist/components/_drawing-svg.js +30 -0
  9. package/dist/components/_media.d.ts +159 -0
  10. package/dist/components/_media.js +266 -0
  11. package/dist/components/_overlay.d.ts +8 -5
  12. package/dist/components/_overlay.js +11 -6
  13. package/dist/components/_scheduler-calendar.d.ts +71 -0
  14. package/dist/components/_scheduler-calendar.js +940 -0
  15. package/dist/components/_scheduler-editor.d.ts +29 -0
  16. package/dist/components/_scheduler-editor.js +111 -0
  17. package/dist/components/_scheduler-menu.d.ts +16 -0
  18. package/dist/components/_scheduler-menu.js +18 -0
  19. package/dist/components/_scheduler-parts.d.ts +164 -0
  20. package/dist/components/_scheduler-parts.js +327 -0
  21. package/dist/components/_suggest-list.d.ts +142 -0
  22. package/dist/components/_suggest-list.js +159 -0
  23. package/dist/components/_toolbar-more.d.ts +24 -0
  24. package/dist/components/_toolbar-more.js +25 -0
  25. package/dist/components/accordion.d.ts +1 -1
  26. package/dist/components/accordion.js +7 -7
  27. package/dist/components/action-sheet.d.ts +88 -0
  28. package/dist/components/action-sheet.js +124 -0
  29. package/dist/components/alert-dialog.js +3 -1
  30. package/dist/components/alert.d.ts +11 -18
  31. package/dist/components/alert.js +9 -6
  32. package/dist/components/app-bar.d.ts +93 -0
  33. package/dist/components/app-bar.js +175 -0
  34. package/dist/components/ascii-field.js +2 -1
  35. package/dist/components/audio-player.d.ts +134 -0
  36. package/dist/components/audio-player.js +618 -0
  37. package/dist/components/avatar.d.ts +6 -6
  38. package/dist/components/avatar.js +13 -11
  39. package/dist/components/badge.d.ts +12 -12
  40. package/dist/components/badge.js +7 -5
  41. package/dist/components/bottom-nav.d.ts +53 -11
  42. package/dist/components/bottom-nav.js +389 -24
  43. package/dist/components/breadcrumb.d.ts +11 -2
  44. package/dist/components/breadcrumb.js +60 -6
  45. package/dist/components/button-group.js +5 -1
  46. package/dist/components/button.d.ts +23 -6
  47. package/dist/components/button.js +64 -8
  48. package/dist/components/calendar.js +8 -6
  49. package/dist/components/card.d.ts +10 -8
  50. package/dist/components/card.js +15 -14
  51. package/dist/components/carousel.d.ts +2 -2
  52. package/dist/components/carousel.js +21 -8
  53. package/dist/components/chart.d.ts +38 -1
  54. package/dist/components/chart.js +27 -5
  55. package/dist/components/checkbox.js +2 -2
  56. package/dist/components/code-block.d.ts +9 -2
  57. package/dist/components/code-block.js +26 -7
  58. package/dist/components/collapsible.js +4 -4
  59. package/dist/components/color-picker.d.ts +2 -2
  60. package/dist/components/color-picker.js +5 -5
  61. package/dist/components/combobox.d.ts +26 -7
  62. package/dist/components/combobox.js +32 -13
  63. package/dist/components/command.d.ts +29 -5
  64. package/dist/components/command.js +37 -12
  65. package/dist/components/context-menu.d.ts +5 -2
  66. package/dist/components/context-menu.js +24 -3
  67. package/dist/components/conversation.d.ts +1 -1
  68. package/dist/components/conversation.js +77 -16
  69. package/dist/components/copy-button.d.ts +1 -1
  70. package/dist/components/copy-button.js +8 -6
  71. package/dist/components/data-table.d.ts +6 -6
  72. package/dist/components/data-table.js +41 -15
  73. package/dist/components/date-picker.d.ts +31 -9
  74. package/dist/components/date-picker.js +100 -18
  75. package/dist/components/dialog.d.ts +17 -10
  76. package/dist/components/dialog.js +20 -13
  77. package/dist/components/drawer.d.ts +26 -8
  78. package/dist/components/drawer.js +75 -16
  79. package/dist/components/drawing.d.ts +25 -0
  80. package/dist/components/drawing.js +32 -0
  81. package/dist/components/empty.js +2 -2
  82. package/dist/components/feature-list.d.ts +65 -13
  83. package/dist/components/feature-list.js +116 -15
  84. package/dist/components/field.js +2 -2
  85. package/dist/components/file-drop.d.ts +9 -7
  86. package/dist/components/file-drop.js +8 -43
  87. package/dist/components/filter-bar.d.ts +10 -9
  88. package/dist/components/filter-bar.js +42 -25
  89. package/dist/components/graph.d.ts +19 -3
  90. package/dist/components/graph.js +190 -28
  91. package/dist/components/illustration.js +53 -31
  92. package/dist/components/input-group.d.ts +6 -11
  93. package/dist/components/input-group.js +21 -19
  94. package/dist/components/input.d.ts +2 -2
  95. package/dist/components/input.js +3 -3
  96. package/dist/components/item.d.ts +9 -6
  97. package/dist/components/item.js +13 -8
  98. package/dist/components/kbd.d.ts +1 -1
  99. package/dist/components/kbd.js +1 -1
  100. package/dist/components/layout.d.ts +2 -1
  101. package/dist/components/layout.js +55 -11
  102. package/dist/components/lightbox.d.ts +76 -9
  103. package/dist/components/lightbox.js +354 -48
  104. package/dist/components/locale.d.ts +6 -6
  105. package/dist/components/logo.d.ts +21 -1
  106. package/dist/components/logo.js +32 -2
  107. package/dist/components/markdown-editor.d.ts +275 -0
  108. package/dist/components/markdown-editor.js +831 -0
  109. package/dist/components/mentions.d.ts +153 -0
  110. package/dist/components/mentions.js +507 -0
  111. package/dist/components/menu.d.ts +2 -1
  112. package/dist/components/menu.js +5 -4
  113. package/dist/components/menubar.d.ts +23 -5
  114. package/dist/components/menubar.js +153 -31
  115. package/dist/components/message.d.ts +62 -11
  116. package/dist/components/message.js +51 -14
  117. package/dist/components/meter.js +1 -1
  118. package/dist/components/money-input.d.ts +1 -1
  119. package/dist/components/money-input.js +1 -1
  120. package/dist/components/native-select.d.ts +2 -2
  121. package/dist/components/native-select.js +4 -4
  122. package/dist/components/navigation-menu.d.ts +3 -1
  123. package/dist/components/navigation-menu.js +23 -10
  124. package/dist/components/number-field.d.ts +2 -9
  125. package/dist/components/number-field.js +90 -26
  126. package/dist/components/number-roll.d.ts +26 -0
  127. package/dist/components/number-roll.js +81 -0
  128. package/dist/components/otp-field.d.ts +1 -1
  129. package/dist/components/otp-field.js +24 -3
  130. package/dist/components/pagination.d.ts +11 -3
  131. package/dist/components/pagination.js +59 -13
  132. package/dist/components/pdf-viewer.d.ts +1 -1
  133. package/dist/components/pdf-viewer.js +8 -8
  134. package/dist/components/phone-input.d.ts +1 -1
  135. package/dist/components/phone-input.js +2 -2
  136. package/dist/components/popover.js +5 -3
  137. package/dist/components/preview-card.d.ts +37 -2
  138. package/dist/components/preview-card.js +226 -2
  139. package/dist/components/progress.js +1 -1
  140. package/dist/components/prompt-input.d.ts +1 -1
  141. package/dist/components/prompt-input.js +35 -17
  142. package/dist/components/pull-to-refresh.d.ts +50 -0
  143. package/dist/components/pull-to-refresh.js +189 -0
  144. package/dist/components/quote.d.ts +6 -1
  145. package/dist/components/quote.js +3 -2
  146. package/dist/components/radio-group.js +8 -3
  147. package/dist/components/rating.d.ts +4 -1
  148. package/dist/components/rating.js +131 -10
  149. package/dist/components/reasoning.d.ts +1 -1
  150. package/dist/components/reasoning.js +7 -3
  151. package/dist/components/resizable.d.ts +1 -1
  152. package/dist/components/resizable.js +2 -2
  153. package/dist/components/response.d.ts +4 -3
  154. package/dist/components/response.js +39 -15
  155. package/dist/components/scheduler.d.ts +352 -0
  156. package/dist/components/scheduler.js +1717 -0
  157. package/dist/components/scroll-area.js +1 -1
  158. package/dist/components/select.d.ts +17 -4
  159. package/dist/components/select.js +140 -9
  160. package/dist/components/separator.d.ts +1 -1
  161. package/dist/components/separator.js +3 -3
  162. package/dist/components/sidebar.d.ts +44 -3
  163. package/dist/components/sidebar.js +90 -31
  164. package/dist/components/site-header.d.ts +18 -13
  165. package/dist/components/site-header.js +26 -9
  166. package/dist/components/skeleton.d.ts +18 -8
  167. package/dist/components/skeleton.js +23 -8
  168. package/dist/components/slider.js +2 -2
  169. package/dist/components/sortable.d.ts +55 -4
  170. package/dist/components/sortable.js +187 -94
  171. package/dist/components/sources.d.ts +1 -1
  172. package/dist/components/sources.js +2 -2
  173. package/dist/components/spinner.d.ts +4 -4
  174. package/dist/components/spinner.js +4 -4
  175. package/dist/components/stat.d.ts +21 -4
  176. package/dist/components/stat.js +17 -8
  177. package/dist/components/stepper.d.ts +1 -1
  178. package/dist/components/stepper.js +8 -7
  179. package/dist/components/suggestions.d.ts +11 -3
  180. package/dist/components/suggestions.js +10 -4
  181. package/dist/components/swipe-actions.d.ts +66 -0
  182. package/dist/components/swipe-actions.js +292 -0
  183. package/dist/components/switch.js +1 -1
  184. package/dist/components/table.d.ts +13 -7
  185. package/dist/components/table.js +124 -23
  186. package/dist/components/tabs.js +15 -8
  187. package/dist/components/tag.d.ts +19 -20
  188. package/dist/components/tag.js +9 -5
  189. package/dist/components/tags-input.d.ts +2 -7
  190. package/dist/components/tags-input.js +11 -8
  191. package/dist/components/textarea.d.ts +3 -2
  192. package/dist/components/textarea.js +4 -3
  193. package/dist/components/theme.d.ts +50 -7
  194. package/dist/components/theme.js +168 -12
  195. package/dist/components/time-field.d.ts +6 -10
  196. package/dist/components/time-field.js +19 -9
  197. package/dist/components/timeline.d.ts +19 -3
  198. package/dist/components/timeline.js +21 -9
  199. package/dist/components/tippy.d.ts +17 -1
  200. package/dist/components/tippy.js +95 -15
  201. package/dist/components/toast.d.ts +2 -7
  202. package/dist/components/toast.js +12 -8
  203. package/dist/components/toggle-group.d.ts +7 -1
  204. package/dist/components/toggle-group.js +17 -5
  205. package/dist/components/toggle.d.ts +2 -2
  206. package/dist/components/toggle.js +3 -2
  207. package/dist/components/tool-call.d.ts +1 -1
  208. package/dist/components/tool-call.js +8 -3
  209. package/dist/components/toolbar.d.ts +57 -4
  210. package/dist/components/toolbar.js +219 -16
  211. package/dist/components/tooltip.d.ts +5 -3
  212. package/dist/components/tooltip.js +14 -6
  213. package/dist/components/tour.d.ts +1 -1
  214. package/dist/components/tour.js +70 -24
  215. package/dist/components/tree.js +33 -10
  216. package/dist/components/typography.d.ts +31 -8
  217. package/dist/components/typography.js +21 -10
  218. package/dist/components/video-player.d.ts +7 -2
  219. package/dist/components/video-player.js +182 -225
  220. package/dist/index.d.ts +99 -92
  221. package/dist/index.js +99 -92
  222. package/dist/lib/calendar.d.ts +153 -0
  223. package/dist/lib/calendar.js +312 -0
  224. package/dist/lib/cn.d.ts +3 -1
  225. package/dist/lib/cn.js +5 -0
  226. package/dist/lib/code-highlight.d.ts +14 -0
  227. package/dist/lib/code-highlight.js +81 -18
  228. package/dist/lib/drag.d.ts +39 -0
  229. package/dist/lib/drag.js +96 -0
  230. package/dist/lib/editorial-assets.js +16 -8
  231. package/dist/lib/figure/figures/automation.js +25 -6
  232. package/dist/lib/figure/figures/bar-chart.js +6 -1
  233. package/dist/lib/figure/figures/brackets-classic.js +4 -1
  234. package/dist/lib/figure/figures/city.js +12 -2
  235. package/dist/lib/figure/figures/conveyor.js +17 -4
  236. package/dist/lib/figure/figures/database.js +5 -2
  237. package/dist/lib/figure/figures/documents.js +11 -3
  238. package/dist/lib/figure/figures/inbox.js +5 -2
  239. package/dist/lib/figure/figures/laptop.js +3 -1
  240. package/dist/lib/figure/figures/pipeline.js +45 -10
  241. package/dist/lib/figure/figures/platform.js +62 -7
  242. package/dist/lib/figure/figures/server.js +21 -5
  243. package/dist/lib/figure/figures/spreadsheet.js +29 -5
  244. package/dist/lib/figure/kernel.d.ts +4 -2
  245. package/dist/lib/figure/kernel.js +10 -5
  246. package/dist/lib/figure/parts.js +6 -2
  247. package/dist/lib/files.d.ts +31 -0
  248. package/dist/lib/files.js +60 -0
  249. package/dist/lib/gesture.d.ts +70 -0
  250. package/dist/lib/gesture.js +141 -0
  251. package/dist/lib/glide.d.ts +10 -4
  252. package/dist/lib/glide.js +14 -5
  253. package/dist/lib/icons.d.ts +1 -0
  254. package/dist/lib/icons.js +6 -0
  255. package/dist/lib/illustration-library.js +1 -6
  256. package/dist/lib/markdown-edit.d.ts +112 -0
  257. package/dist/lib/markdown-edit.js +557 -0
  258. package/dist/lib/markdown-rich-editor.d.ts +188 -0
  259. package/dist/lib/markdown-rich-editor.js +1153 -0
  260. package/dist/lib/markdown-rich.d.ts +63 -0
  261. package/dist/lib/markdown-rich.js +534 -0
  262. package/dist/lib/mentions.d.ts +100 -0
  263. package/dist/lib/mentions.js +246 -0
  264. package/dist/lib/motion.d.ts +18 -0
  265. package/dist/lib/motion.js +43 -5
  266. package/dist/lib/number-roll.d.ts +89 -0
  267. package/dist/lib/number-roll.js +391 -0
  268. package/dist/lib/platform.d.ts +6 -0
  269. package/dist/lib/platform.js +14 -0
  270. package/dist/lib/portal-container.d.ts +9 -0
  271. package/dist/lib/portal-container.js +10 -0
  272. package/dist/lib/press.d.ts +5 -0
  273. package/dist/lib/press.js +186 -0
  274. package/dist/lib/scheduler.d.ts +128 -0
  275. package/dist/lib/scheduler.js +272 -0
  276. package/dist/lib/scroll-edges.d.ts +9 -0
  277. package/dist/lib/scroll-edges.js +50 -0
  278. package/dist/lib/table-fit.d.ts +4 -3
  279. package/dist/lib/table-fit.js +92 -25
  280. package/dist/lib/theme-preset.d.ts +267 -0
  281. package/dist/lib/theme-preset.js +1046 -0
  282. package/dist/lib/theme-script.d.ts +23 -3
  283. package/dist/lib/theme-script.js +17 -5
  284. package/dist/lib/tippy/sprite.d.ts +36 -4
  285. package/dist/lib/tippy/sprite.js +188 -15
  286. package/dist/lib/tone.d.ts +4 -0
  287. package/dist/lib/tone.js +1 -0
  288. package/dist/messages/de.d.ts +3 -3
  289. package/dist/messages/de.js +274 -3
  290. package/dist/skills/zon-ui/SKILL.md +279 -0
  291. package/dist/skills/zon-ui/references/authoring.md +265 -0
  292. package/dist/skills/zon-ui/references/brand.md +416 -0
  293. package/dist/skills/zon-ui/references/components/accordion.md +199 -0
  294. package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
  295. package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
  296. package/dist/skills/zon-ui/references/components/alert.md +167 -0
  297. package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
  298. package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
  299. package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
  300. package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
  301. package/dist/skills/zon-ui/references/components/avatar.md +98 -0
  302. package/dist/skills/zon-ui/references/components/badge.md +227 -0
  303. package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
  304. package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
  305. package/dist/skills/zon-ui/references/components/button-group.md +216 -0
  306. package/dist/skills/zon-ui/references/components/button.md +309 -0
  307. package/dist/skills/zon-ui/references/components/calendar.md +296 -0
  308. package/dist/skills/zon-ui/references/components/card.md +158 -0
  309. package/dist/skills/zon-ui/references/components/carousel.md +297 -0
  310. package/dist/skills/zon-ui/references/components/chart.md +739 -0
  311. package/dist/skills/zon-ui/references/components/chat.md +417 -0
  312. package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
  313. package/dist/skills/zon-ui/references/components/code-block.md +143 -0
  314. package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
  315. package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
  316. package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
  317. package/dist/skills/zon-ui/references/components/combobox.md +455 -0
  318. package/dist/skills/zon-ui/references/components/command.md +326 -0
  319. package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
  320. package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
  321. package/dist/skills/zon-ui/references/components/conversation.md +146 -0
  322. package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
  323. package/dist/skills/zon-ui/references/components/crm.md +1022 -0
  324. package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
  325. package/dist/skills/zon-ui/references/components/data-table.md +776 -0
  326. package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
  327. package/dist/skills/zon-ui/references/components/dialog.md +335 -0
  328. package/dist/skills/zon-ui/references/components/direction.md +165 -0
  329. package/dist/skills/zon-ui/references/components/drawer.md +276 -0
  330. package/dist/skills/zon-ui/references/components/drawing.md +94 -0
  331. package/dist/skills/zon-ui/references/components/empty.md +225 -0
  332. package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
  333. package/dist/skills/zon-ui/references/components/field.md +209 -0
  334. package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
  335. package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
  336. package/dist/skills/zon-ui/references/components/form.md +970 -0
  337. package/dist/skills/zon-ui/references/components/graph.md +339 -0
  338. package/dist/skills/zon-ui/references/components/illustration.md +497 -0
  339. package/dist/skills/zon-ui/references/components/inbox.md +263 -0
  340. package/dist/skills/zon-ui/references/components/input-group.md +339 -0
  341. package/dist/skills/zon-ui/references/components/input.md +189 -0
  342. package/dist/skills/zon-ui/references/components/item.md +277 -0
  343. package/dist/skills/zon-ui/references/components/kanban.md +626 -0
  344. package/dist/skills/zon-ui/references/components/kbd.md +116 -0
  345. package/dist/skills/zon-ui/references/components/label.md +104 -0
  346. package/dist/skills/zon-ui/references/components/layout.md +291 -0
  347. package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
  348. package/dist/skills/zon-ui/references/components/locale.md +279 -0
  349. package/dist/skills/zon-ui/references/components/logo.md +257 -0
  350. package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
  351. package/dist/skills/zon-ui/references/components/mentions.md +512 -0
  352. package/dist/skills/zon-ui/references/components/menu.md +218 -0
  353. package/dist/skills/zon-ui/references/components/menubar.md +292 -0
  354. package/dist/skills/zon-ui/references/components/message.md +243 -0
  355. package/dist/skills/zon-ui/references/components/meter.md +105 -0
  356. package/dist/skills/zon-ui/references/components/money-input.md +333 -0
  357. package/dist/skills/zon-ui/references/components/native-select.md +197 -0
  358. package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
  359. package/dist/skills/zon-ui/references/components/number-field.md +210 -0
  360. package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
  361. package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
  362. package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
  363. package/dist/skills/zon-ui/references/components/pagination.md +109 -0
  364. package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
  365. package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
  366. package/dist/skills/zon-ui/references/components/popover.md +176 -0
  367. package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
  368. package/dist/skills/zon-ui/references/components/pricing.md +724 -0
  369. package/dist/skills/zon-ui/references/components/progress.md +92 -0
  370. package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
  371. package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
  372. package/dist/skills/zon-ui/references/components/quote.md +115 -0
  373. package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
  374. package/dist/skills/zon-ui/references/components/rating.md +260 -0
  375. package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
  376. package/dist/skills/zon-ui/references/components/resizable.md +213 -0
  377. package/dist/skills/zon-ui/references/components/response.md +170 -0
  378. package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
  379. package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
  380. package/dist/skills/zon-ui/references/components/select.md +351 -0
  381. package/dist/skills/zon-ui/references/components/separator.md +103 -0
  382. package/dist/skills/zon-ui/references/components/settings.md +793 -0
  383. package/dist/skills/zon-ui/references/components/shop.md +1715 -0
  384. package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
  385. package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
  386. package/dist/skills/zon-ui/references/components/site-header.md +303 -0
  387. package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
  388. package/dist/skills/zon-ui/references/components/slider.md +172 -0
  389. package/dist/skills/zon-ui/references/components/sortable.md +405 -0
  390. package/dist/skills/zon-ui/references/components/sources.md +106 -0
  391. package/dist/skills/zon-ui/references/components/spinner.md +222 -0
  392. package/dist/skills/zon-ui/references/components/stat.md +267 -0
  393. package/dist/skills/zon-ui/references/components/stepper.md +285 -0
  394. package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
  395. package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
  396. package/dist/skills/zon-ui/references/components/switch.md +160 -0
  397. package/dist/skills/zon-ui/references/components/table.md +999 -0
  398. package/dist/skills/zon-ui/references/components/tabs.md +258 -0
  399. package/dist/skills/zon-ui/references/components/tag.md +115 -0
  400. package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
  401. package/dist/skills/zon-ui/references/components/textarea.md +95 -0
  402. package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
  403. package/dist/skills/zon-ui/references/components/theme.md +362 -0
  404. package/dist/skills/zon-ui/references/components/time-field.md +222 -0
  405. package/dist/skills/zon-ui/references/components/timeline.md +285 -0
  406. package/dist/skills/zon-ui/references/components/tippy.md +243 -0
  407. package/dist/skills/zon-ui/references/components/toast.md +220 -0
  408. package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
  409. package/dist/skills/zon-ui/references/components/toggle.md +167 -0
  410. package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
  411. package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
  412. package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
  413. package/dist/skills/zon-ui/references/components/tour.md +423 -0
  414. package/dist/skills/zon-ui/references/components/tree.md +481 -0
  415. package/dist/skills/zon-ui/references/components/typography.md +347 -0
  416. package/dist/skills/zon-ui/references/components/video-player.md +386 -0
  417. package/dist/skills/zon-ui/references/marketing.md +467 -0
  418. package/dist/skills/zon-ui/references/motion.md +455 -0
  419. package/dist/skills/zon-ui/references/recipes.md +1232 -0
  420. package/dist/skills/zon-ui/references/tokens.md +866 -0
  421. package/dist/sources/accordion.css +4 -0
  422. package/dist/sources/action-sheet.css +11 -0
  423. package/dist/sources/alert-dialog.css +6 -0
  424. package/dist/sources/alert.css +3 -0
  425. package/dist/sources/app-bar.css +14 -0
  426. package/dist/sources/ascii-field.css +3 -0
  427. package/dist/sources/aspect-ratio.css +3 -0
  428. package/dist/sources/audio-player.css +20 -0
  429. package/dist/sources/avatar.css +3 -0
  430. package/dist/sources/badge.css +3 -0
  431. package/dist/sources/bottom-nav.css +9 -0
  432. package/dist/sources/breadcrumb.css +14 -0
  433. package/dist/sources/button-group.css +3 -0
  434. package/dist/sources/button.css +9 -0
  435. package/dist/sources/calendar.css +13 -0
  436. package/dist/sources/card.css +3 -0
  437. package/dist/sources/carousel.css +11 -0
  438. package/dist/sources/chart.css +5 -0
  439. package/dist/sources/checkbox.css +6 -0
  440. package/dist/sources/code-block.css +13 -0
  441. package/dist/sources/collapsible.css +4 -0
  442. package/dist/sources/color-picker.css +13 -0
  443. package/dist/sources/combobox.css +13 -0
  444. package/dist/sources/command.css +13 -0
  445. package/dist/sources/context-menu.css +12 -0
  446. package/dist/sources/conversation.css +10 -0
  447. package/dist/sources/copy-button.css +10 -0
  448. package/dist/sources/data-table.css +27 -0
  449. package/dist/sources/date-picker.css +20 -0
  450. package/dist/sources/dialog.css +9 -0
  451. package/dist/sources/direction.css +2 -0
  452. package/dist/sources/drawer.css +9 -0
  453. package/dist/sources/drawing.css +5 -0
  454. package/dist/sources/empty.css +3 -0
  455. package/dist/sources/feature-list.css +4 -0
  456. package/dist/sources/field.css +4 -0
  457. package/dist/sources/file-drop.css +15 -0
  458. package/dist/sources/filter-bar.css +30 -0
  459. package/dist/sources/form.css +4 -0
  460. package/dist/sources/graph.css +19 -0
  461. package/dist/sources/illustration.css +28 -0
  462. package/dist/sources/input-group.css +7 -0
  463. package/dist/sources/input.css +3 -0
  464. package/dist/sources/item.css +4 -0
  465. package/dist/sources/kbd.css +5 -0
  466. package/dist/sources/label.css +3 -0
  467. package/dist/sources/layout.css +3 -0
  468. package/dist/sources/lightbox.css +33 -0
  469. package/dist/sources/locale.css +2 -0
  470. package/dist/sources/logo.css +4 -0
  471. package/dist/sources/markdown-editor.css +41 -0
  472. package/dist/sources/mentions.css +13 -0
  473. package/dist/sources/menu.css +11 -0
  474. package/dist/sources/menubar.css +14 -0
  475. package/dist/sources/message.css +16 -0
  476. package/dist/sources/meter.css +4 -0
  477. package/dist/sources/money-input.css +10 -0
  478. package/dist/sources/native-select.css +4 -0
  479. package/dist/sources/navigation-menu.css +8 -0
  480. package/dist/sources/number-field.css +8 -0
  481. package/dist/sources/number-roll.css +6 -0
  482. package/dist/sources/otp-field.css +5 -0
  483. package/dist/sources/pagination.css +11 -0
  484. package/dist/sources/pdf-viewer.css +30 -0
  485. package/dist/sources/phone-input.css +20 -0
  486. package/dist/sources/popover.css +7 -0
  487. package/dist/sources/preview-card.css +7 -0
  488. package/dist/sources/progress.css +4 -0
  489. package/dist/sources/prompt-input.css +15 -0
  490. package/dist/sources/pull-to-refresh.css +14 -0
  491. package/dist/sources/quote.css +3 -0
  492. package/dist/sources/radio-group.css +5 -0
  493. package/dist/sources/rating.css +6 -0
  494. package/dist/sources/reasoning.css +6 -0
  495. package/dist/sources/resizable.css +4 -0
  496. package/dist/sources/response.css +16 -0
  497. package/dist/sources/scheduler.css +44 -0
  498. package/dist/sources/scroll-area.css +3 -0
  499. package/dist/sources/select.css +12 -0
  500. package/dist/sources/separator.css +3 -0
  501. package/dist/sources/sidebar.css +19 -0
  502. package/dist/sources/site-header.css +15 -0
  503. package/dist/sources/skeleton.css +3 -0
  504. package/dist/sources/slider.css +6 -0
  505. package/dist/sources/sortable.css +12 -0
  506. package/dist/sources/sources.css +6 -0
  507. package/dist/sources/spinner.css +6 -0
  508. package/dist/sources/stat.css +9 -0
  509. package/dist/sources/stepper.css +6 -0
  510. package/dist/sources/suggestions.css +10 -0
  511. package/dist/sources/swipe-actions.css +20 -0
  512. package/dist/sources/switch.css +5 -0
  513. package/dist/sources/table.css +7 -0
  514. package/dist/sources/tabs.css +5 -0
  515. package/dist/sources/tag.css +3 -0
  516. package/dist/sources/tags-input.css +6 -0
  517. package/dist/sources/textarea.css +3 -0
  518. package/dist/sources/theme.css +13 -0
  519. package/dist/sources/time-field.css +7 -0
  520. package/dist/sources/timeline.css +7 -0
  521. package/dist/sources/tippy.css +6 -0
  522. package/dist/sources/toast.css +6 -0
  523. package/dist/sources/toggle-group.css +5 -0
  524. package/dist/sources/toggle.css +3 -0
  525. package/dist/sources/tool-call.css +16 -0
  526. package/dist/sources/toolbar.css +14 -0
  527. package/dist/sources/tooltip.css +6 -0
  528. package/dist/sources/tour.css +14 -0
  529. package/dist/sources/tree.css +6 -0
  530. package/dist/sources/typography.css +4 -0
  531. package/dist/sources/video-player.css +21 -0
  532. package/dist/styles/ai.css +3 -0
  533. package/dist/styles/brand.css +98 -0
  534. package/dist/styles/core.css +266 -0
  535. package/dist/styles/editor.css +3 -0
  536. package/dist/styles/expressive.css +75 -77
  537. package/dist/styles/fonts.css +61 -117
  538. package/dist/styles/graph.css +4 -0
  539. package/dist/styles/illustration.css +4 -0
  540. package/dist/styles/index.css +11 -193
  541. package/dist/styles/material.css +177 -31
  542. package/dist/styles/parts/ai.css +20 -14
  543. package/dist/styles/parts/brand.css +2 -2
  544. package/dist/styles/parts/controls.css +51 -38
  545. package/dist/styles/parts/data.css +43 -11
  546. package/dist/styles/parts/editor.css +372 -0
  547. package/dist/styles/parts/feedback.css +75 -15
  548. package/dist/styles/parts/foundations.css +12 -7
  549. package/dist/styles/parts/graph.css +25 -9
  550. package/dist/styles/parts/inputs.css +172 -9
  551. package/dist/styles/parts/isometric.css +6 -5
  552. package/dist/styles/parts/navigation.css +237 -25
  553. package/dist/styles/parts/overlays.css +110 -8
  554. package/dist/styles/parts/pdf.css +15 -9
  555. package/dist/styles/pdf.css +3 -0
  556. package/dist/styles/prose.css +3 -0
  557. package/dist/styles/tokens.css +105 -15
  558. package/dist/theme.d.ts +1 -0
  559. package/dist/theme.js +5 -0
  560. package/dist/vite.d.ts +48 -59
  561. package/dist/vite.js +54 -21
  562. 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.