@zonsh/ui 0.5.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (559) 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 +6 -6
  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/audio-player.d.ts +134 -0
  35. package/dist/components/audio-player.js +618 -0
  36. package/dist/components/avatar.d.ts +6 -6
  37. package/dist/components/avatar.js +13 -11
  38. package/dist/components/badge.d.ts +12 -12
  39. package/dist/components/badge.js +7 -5
  40. package/dist/components/bottom-nav.d.ts +53 -11
  41. package/dist/components/bottom-nav.js +388 -23
  42. package/dist/components/breadcrumb.d.ts +11 -2
  43. package/dist/components/breadcrumb.js +60 -6
  44. package/dist/components/button-group.js +5 -1
  45. package/dist/components/button.d.ts +23 -6
  46. package/dist/components/button.js +63 -7
  47. package/dist/components/calendar.js +8 -6
  48. package/dist/components/card.d.ts +10 -8
  49. package/dist/components/card.js +15 -14
  50. package/dist/components/carousel.d.ts +2 -2
  51. package/dist/components/carousel.js +21 -8
  52. package/dist/components/chart.d.ts +27 -1
  53. package/dist/components/chart.js +15 -5
  54. package/dist/components/checkbox.js +2 -2
  55. package/dist/components/code-block.d.ts +9 -2
  56. package/dist/components/code-block.js +26 -7
  57. package/dist/components/collapsible.js +3 -3
  58. package/dist/components/color-picker.d.ts +2 -2
  59. package/dist/components/color-picker.js +5 -5
  60. package/dist/components/combobox.d.ts +26 -7
  61. package/dist/components/combobox.js +32 -13
  62. package/dist/components/command.d.ts +29 -5
  63. package/dist/components/command.js +35 -10
  64. package/dist/components/context-menu.d.ts +5 -2
  65. package/dist/components/context-menu.js +24 -3
  66. package/dist/components/conversation.d.ts +1 -1
  67. package/dist/components/conversation.js +67 -13
  68. package/dist/components/copy-button.d.ts +1 -1
  69. package/dist/components/copy-button.js +1 -1
  70. package/dist/components/data-table.d.ts +6 -6
  71. package/dist/components/data-table.js +41 -15
  72. package/dist/components/date-picker.d.ts +31 -9
  73. package/dist/components/date-picker.js +100 -18
  74. package/dist/components/dialog.d.ts +17 -10
  75. package/dist/components/dialog.js +20 -13
  76. package/dist/components/drawer.d.ts +26 -8
  77. package/dist/components/drawer.js +75 -16
  78. package/dist/components/drawing.d.ts +25 -0
  79. package/dist/components/drawing.js +32 -0
  80. package/dist/components/empty.js +2 -2
  81. package/dist/components/feature-list.d.ts +65 -13
  82. package/dist/components/feature-list.js +116 -15
  83. package/dist/components/field.js +2 -2
  84. package/dist/components/file-drop.d.ts +9 -7
  85. package/dist/components/file-drop.js +8 -43
  86. package/dist/components/filter-bar.d.ts +10 -9
  87. package/dist/components/filter-bar.js +42 -25
  88. package/dist/components/graph.d.ts +19 -3
  89. package/dist/components/graph.js +170 -25
  90. package/dist/components/illustration.js +3 -28
  91. package/dist/components/input-group.d.ts +5 -10
  92. package/dist/components/input-group.js +16 -16
  93. package/dist/components/input.d.ts +2 -2
  94. package/dist/components/input.js +3 -3
  95. package/dist/components/item.d.ts +9 -6
  96. package/dist/components/item.js +13 -8
  97. package/dist/components/kbd.d.ts +1 -1
  98. package/dist/components/kbd.js +1 -1
  99. package/dist/components/lightbox.d.ts +76 -9
  100. package/dist/components/lightbox.js +333 -45
  101. package/dist/components/locale.d.ts +6 -6
  102. package/dist/components/logo.d.ts +21 -1
  103. package/dist/components/logo.js +32 -2
  104. package/dist/components/markdown-editor.d.ts +275 -0
  105. package/dist/components/markdown-editor.js +831 -0
  106. package/dist/components/mentions.d.ts +153 -0
  107. package/dist/components/mentions.js +507 -0
  108. package/dist/components/menu.d.ts +2 -1
  109. package/dist/components/menu.js +5 -4
  110. package/dist/components/menubar.d.ts +23 -5
  111. package/dist/components/menubar.js +97 -22
  112. package/dist/components/message.d.ts +62 -11
  113. package/dist/components/message.js +49 -13
  114. package/dist/components/meter.js +1 -1
  115. package/dist/components/money-input.d.ts +1 -1
  116. package/dist/components/money-input.js +1 -1
  117. package/dist/components/native-select.d.ts +2 -2
  118. package/dist/components/native-select.js +4 -4
  119. package/dist/components/navigation-menu.d.ts +3 -1
  120. package/dist/components/navigation-menu.js +23 -12
  121. package/dist/components/number-field.d.ts +2 -9
  122. package/dist/components/number-field.js +86 -36
  123. package/dist/components/number-roll.d.ts +26 -0
  124. package/dist/components/number-roll.js +81 -0
  125. package/dist/components/otp-field.d.ts +1 -1
  126. package/dist/components/otp-field.js +24 -3
  127. package/dist/components/pagination.d.ts +11 -3
  128. package/dist/components/pagination.js +59 -13
  129. package/dist/components/pdf-viewer.d.ts +1 -1
  130. package/dist/components/pdf-viewer.js +8 -8
  131. package/dist/components/phone-input.d.ts +1 -1
  132. package/dist/components/phone-input.js +2 -2
  133. package/dist/components/popover.js +5 -3
  134. package/dist/components/preview-card.d.ts +37 -2
  135. package/dist/components/preview-card.js +226 -2
  136. package/dist/components/progress.js +1 -1
  137. package/dist/components/prompt-input.d.ts +1 -1
  138. package/dist/components/prompt-input.js +24 -14
  139. package/dist/components/pull-to-refresh.d.ts +50 -0
  140. package/dist/components/pull-to-refresh.js +189 -0
  141. package/dist/components/quote.d.ts +6 -1
  142. package/dist/components/quote.js +3 -2
  143. package/dist/components/radio-group.js +1 -1
  144. package/dist/components/rating.d.ts +4 -1
  145. package/dist/components/rating.js +131 -10
  146. package/dist/components/reasoning.d.ts +1 -1
  147. package/dist/components/reasoning.js +7 -3
  148. package/dist/components/resizable.d.ts +1 -1
  149. package/dist/components/resizable.js +2 -2
  150. package/dist/components/response.d.ts +1 -1
  151. package/dist/components/response.js +18 -6
  152. package/dist/components/scheduler.d.ts +352 -0
  153. package/dist/components/scheduler.js +1717 -0
  154. package/dist/components/scroll-area.js +1 -1
  155. package/dist/components/select.d.ts +17 -4
  156. package/dist/components/select.js +140 -9
  157. package/dist/components/separator.d.ts +1 -1
  158. package/dist/components/separator.js +3 -3
  159. package/dist/components/sidebar.d.ts +44 -3
  160. package/dist/components/sidebar.js +57 -17
  161. package/dist/components/site-header.d.ts +18 -13
  162. package/dist/components/site-header.js +23 -11
  163. package/dist/components/skeleton.d.ts +17 -7
  164. package/dist/components/skeleton.js +22 -7
  165. package/dist/components/slider.js +2 -2
  166. package/dist/components/sortable.d.ts +55 -4
  167. package/dist/components/sortable.js +172 -103
  168. package/dist/components/sources.d.ts +1 -1
  169. package/dist/components/sources.js +2 -2
  170. package/dist/components/spinner.d.ts +4 -4
  171. package/dist/components/spinner.js +4 -4
  172. package/dist/components/stat.d.ts +21 -4
  173. package/dist/components/stat.js +17 -8
  174. package/dist/components/stepper.d.ts +1 -1
  175. package/dist/components/stepper.js +8 -7
  176. package/dist/components/suggestions.d.ts +11 -3
  177. package/dist/components/suggestions.js +10 -4
  178. package/dist/components/swipe-actions.d.ts +66 -0
  179. package/dist/components/swipe-actions.js +292 -0
  180. package/dist/components/switch.js +1 -1
  181. package/dist/components/table.d.ts +12 -6
  182. package/dist/components/table.js +78 -30
  183. package/dist/components/tabs.js +7 -4
  184. package/dist/components/tag.d.ts +19 -20
  185. package/dist/components/tag.js +9 -5
  186. package/dist/components/tags-input.d.ts +2 -7
  187. package/dist/components/tags-input.js +11 -8
  188. package/dist/components/textarea.d.ts +3 -2
  189. package/dist/components/textarea.js +4 -3
  190. package/dist/components/theme.d.ts +49 -6
  191. package/dist/components/theme.js +147 -9
  192. package/dist/components/time-field.d.ts +4 -9
  193. package/dist/components/time-field.js +6 -6
  194. package/dist/components/timeline.d.ts +19 -3
  195. package/dist/components/timeline.js +21 -9
  196. package/dist/components/tippy.d.ts +17 -1
  197. package/dist/components/tippy.js +95 -15
  198. package/dist/components/toast.d.ts +2 -7
  199. package/dist/components/toast.js +12 -8
  200. package/dist/components/toggle-group.d.ts +7 -1
  201. package/dist/components/toggle-group.js +16 -5
  202. package/dist/components/toggle.d.ts +2 -2
  203. package/dist/components/toggle.js +3 -2
  204. package/dist/components/tool-call.d.ts +1 -1
  205. package/dist/components/tool-call.js +4 -4
  206. package/dist/components/toolbar.d.ts +57 -4
  207. package/dist/components/toolbar.js +216 -16
  208. package/dist/components/tooltip.d.ts +1 -1
  209. package/dist/components/tooltip.js +4 -2
  210. package/dist/components/tour.d.ts +1 -1
  211. package/dist/components/tour.js +36 -15
  212. package/dist/components/tree.js +5 -5
  213. package/dist/components/typography.d.ts +31 -8
  214. package/dist/components/typography.js +21 -10
  215. package/dist/components/video-player.d.ts +7 -2
  216. package/dist/components/video-player.js +121 -220
  217. package/dist/index.d.ts +99 -92
  218. package/dist/index.js +99 -92
  219. package/dist/lib/calendar.d.ts +153 -0
  220. package/dist/lib/calendar.js +312 -0
  221. package/dist/lib/cn.d.ts +3 -1
  222. package/dist/lib/cn.js +5 -0
  223. package/dist/lib/code-highlight.d.ts +14 -0
  224. package/dist/lib/code-highlight.js +81 -18
  225. package/dist/lib/drag.d.ts +39 -0
  226. package/dist/lib/drag.js +96 -0
  227. package/dist/lib/editorial-assets.js +16 -8
  228. package/dist/lib/figure/figures/automation.js +25 -6
  229. package/dist/lib/figure/figures/bar-chart.js +6 -1
  230. package/dist/lib/figure/figures/brackets-classic.js +4 -1
  231. package/dist/lib/figure/figures/city.js +12 -2
  232. package/dist/lib/figure/figures/conveyor.js +17 -4
  233. package/dist/lib/figure/figures/database.js +5 -2
  234. package/dist/lib/figure/figures/documents.js +11 -3
  235. package/dist/lib/figure/figures/inbox.js +5 -2
  236. package/dist/lib/figure/figures/laptop.js +3 -1
  237. package/dist/lib/figure/figures/pipeline.js +45 -10
  238. package/dist/lib/figure/figures/platform.js +62 -7
  239. package/dist/lib/figure/figures/server.js +21 -5
  240. package/dist/lib/figure/figures/spreadsheet.js +29 -5
  241. package/dist/lib/figure/kernel.d.ts +4 -2
  242. package/dist/lib/figure/kernel.js +10 -5
  243. package/dist/lib/figure/parts.js +6 -2
  244. package/dist/lib/files.d.ts +31 -0
  245. package/dist/lib/files.js +60 -0
  246. package/dist/lib/gesture.d.ts +70 -0
  247. package/dist/lib/gesture.js +141 -0
  248. package/dist/lib/glide.d.ts +5 -0
  249. package/dist/lib/glide.js +9 -1
  250. package/dist/lib/icons.d.ts +1 -0
  251. package/dist/lib/icons.js +6 -0
  252. package/dist/lib/illustration-library.js +1 -6
  253. package/dist/lib/markdown-edit.d.ts +112 -0
  254. package/dist/lib/markdown-edit.js +557 -0
  255. package/dist/lib/markdown-rich-editor.d.ts +188 -0
  256. package/dist/lib/markdown-rich-editor.js +1153 -0
  257. package/dist/lib/markdown-rich.d.ts +63 -0
  258. package/dist/lib/markdown-rich.js +534 -0
  259. package/dist/lib/mentions.d.ts +100 -0
  260. package/dist/lib/mentions.js +246 -0
  261. package/dist/lib/motion.d.ts +18 -0
  262. package/dist/lib/motion.js +43 -5
  263. package/dist/lib/number-roll.d.ts +89 -0
  264. package/dist/lib/number-roll.js +391 -0
  265. package/dist/lib/platform.d.ts +6 -0
  266. package/dist/lib/platform.js +14 -0
  267. package/dist/lib/portal-container.d.ts +9 -0
  268. package/dist/lib/portal-container.js +10 -0
  269. package/dist/lib/press.d.ts +5 -0
  270. package/dist/lib/press.js +186 -0
  271. package/dist/lib/scheduler.d.ts +128 -0
  272. package/dist/lib/scheduler.js +272 -0
  273. package/dist/lib/scroll-edges.d.ts +9 -0
  274. package/dist/lib/scroll-edges.js +50 -0
  275. package/dist/lib/table-fit.d.ts +1 -1
  276. package/dist/lib/table-fit.js +65 -8
  277. package/dist/lib/theme-preset.d.ts +267 -0
  278. package/dist/lib/theme-preset.js +1046 -0
  279. package/dist/lib/theme-script.d.ts +23 -3
  280. package/dist/lib/theme-script.js +17 -5
  281. package/dist/lib/tippy/sprite.d.ts +36 -4
  282. package/dist/lib/tippy/sprite.js +188 -15
  283. package/dist/lib/tone.d.ts +4 -0
  284. package/dist/lib/tone.js +1 -0
  285. package/dist/messages/de.d.ts +3 -3
  286. package/dist/messages/de.js +274 -3
  287. package/dist/skills/zon-ui/SKILL.md +279 -0
  288. package/dist/skills/zon-ui/references/authoring.md +265 -0
  289. package/dist/skills/zon-ui/references/brand.md +416 -0
  290. package/dist/skills/zon-ui/references/components/accordion.md +199 -0
  291. package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
  292. package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
  293. package/dist/skills/zon-ui/references/components/alert.md +167 -0
  294. package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
  295. package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
  296. package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
  297. package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
  298. package/dist/skills/zon-ui/references/components/avatar.md +98 -0
  299. package/dist/skills/zon-ui/references/components/badge.md +227 -0
  300. package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
  301. package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
  302. package/dist/skills/zon-ui/references/components/button-group.md +216 -0
  303. package/dist/skills/zon-ui/references/components/button.md +309 -0
  304. package/dist/skills/zon-ui/references/components/calendar.md +296 -0
  305. package/dist/skills/zon-ui/references/components/card.md +158 -0
  306. package/dist/skills/zon-ui/references/components/carousel.md +297 -0
  307. package/dist/skills/zon-ui/references/components/chart.md +739 -0
  308. package/dist/skills/zon-ui/references/components/chat.md +417 -0
  309. package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
  310. package/dist/skills/zon-ui/references/components/code-block.md +143 -0
  311. package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
  312. package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
  313. package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
  314. package/dist/skills/zon-ui/references/components/combobox.md +455 -0
  315. package/dist/skills/zon-ui/references/components/command.md +326 -0
  316. package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
  317. package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
  318. package/dist/skills/zon-ui/references/components/conversation.md +146 -0
  319. package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
  320. package/dist/skills/zon-ui/references/components/crm.md +1022 -0
  321. package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
  322. package/dist/skills/zon-ui/references/components/data-table.md +776 -0
  323. package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
  324. package/dist/skills/zon-ui/references/components/dialog.md +335 -0
  325. package/dist/skills/zon-ui/references/components/direction.md +165 -0
  326. package/dist/skills/zon-ui/references/components/drawer.md +276 -0
  327. package/dist/skills/zon-ui/references/components/drawing.md +94 -0
  328. package/dist/skills/zon-ui/references/components/empty.md +225 -0
  329. package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
  330. package/dist/skills/zon-ui/references/components/field.md +209 -0
  331. package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
  332. package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
  333. package/dist/skills/zon-ui/references/components/form.md +970 -0
  334. package/dist/skills/zon-ui/references/components/graph.md +339 -0
  335. package/dist/skills/zon-ui/references/components/illustration.md +497 -0
  336. package/dist/skills/zon-ui/references/components/inbox.md +263 -0
  337. package/dist/skills/zon-ui/references/components/input-group.md +339 -0
  338. package/dist/skills/zon-ui/references/components/input.md +189 -0
  339. package/dist/skills/zon-ui/references/components/item.md +277 -0
  340. package/dist/skills/zon-ui/references/components/kanban.md +626 -0
  341. package/dist/skills/zon-ui/references/components/kbd.md +116 -0
  342. package/dist/skills/zon-ui/references/components/label.md +104 -0
  343. package/dist/skills/zon-ui/references/components/layout.md +291 -0
  344. package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
  345. package/dist/skills/zon-ui/references/components/locale.md +279 -0
  346. package/dist/skills/zon-ui/references/components/logo.md +257 -0
  347. package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
  348. package/dist/skills/zon-ui/references/components/mentions.md +512 -0
  349. package/dist/skills/zon-ui/references/components/menu.md +218 -0
  350. package/dist/skills/zon-ui/references/components/menubar.md +292 -0
  351. package/dist/skills/zon-ui/references/components/message.md +243 -0
  352. package/dist/skills/zon-ui/references/components/meter.md +105 -0
  353. package/dist/skills/zon-ui/references/components/money-input.md +333 -0
  354. package/dist/skills/zon-ui/references/components/native-select.md +197 -0
  355. package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
  356. package/dist/skills/zon-ui/references/components/number-field.md +210 -0
  357. package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
  358. package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
  359. package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
  360. package/dist/skills/zon-ui/references/components/pagination.md +109 -0
  361. package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
  362. package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
  363. package/dist/skills/zon-ui/references/components/popover.md +176 -0
  364. package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
  365. package/dist/skills/zon-ui/references/components/pricing.md +724 -0
  366. package/dist/skills/zon-ui/references/components/progress.md +92 -0
  367. package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
  368. package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
  369. package/dist/skills/zon-ui/references/components/quote.md +115 -0
  370. package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
  371. package/dist/skills/zon-ui/references/components/rating.md +260 -0
  372. package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
  373. package/dist/skills/zon-ui/references/components/resizable.md +213 -0
  374. package/dist/skills/zon-ui/references/components/response.md +170 -0
  375. package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
  376. package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
  377. package/dist/skills/zon-ui/references/components/select.md +351 -0
  378. package/dist/skills/zon-ui/references/components/separator.md +103 -0
  379. package/dist/skills/zon-ui/references/components/settings.md +793 -0
  380. package/dist/skills/zon-ui/references/components/shop.md +1715 -0
  381. package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
  382. package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
  383. package/dist/skills/zon-ui/references/components/site-header.md +303 -0
  384. package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
  385. package/dist/skills/zon-ui/references/components/slider.md +172 -0
  386. package/dist/skills/zon-ui/references/components/sortable.md +405 -0
  387. package/dist/skills/zon-ui/references/components/sources.md +106 -0
  388. package/dist/skills/zon-ui/references/components/spinner.md +222 -0
  389. package/dist/skills/zon-ui/references/components/stat.md +267 -0
  390. package/dist/skills/zon-ui/references/components/stepper.md +285 -0
  391. package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
  392. package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
  393. package/dist/skills/zon-ui/references/components/switch.md +160 -0
  394. package/dist/skills/zon-ui/references/components/table.md +999 -0
  395. package/dist/skills/zon-ui/references/components/tabs.md +258 -0
  396. package/dist/skills/zon-ui/references/components/tag.md +115 -0
  397. package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
  398. package/dist/skills/zon-ui/references/components/textarea.md +95 -0
  399. package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
  400. package/dist/skills/zon-ui/references/components/theme.md +362 -0
  401. package/dist/skills/zon-ui/references/components/time-field.md +222 -0
  402. package/dist/skills/zon-ui/references/components/timeline.md +285 -0
  403. package/dist/skills/zon-ui/references/components/tippy.md +243 -0
  404. package/dist/skills/zon-ui/references/components/toast.md +220 -0
  405. package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
  406. package/dist/skills/zon-ui/references/components/toggle.md +167 -0
  407. package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
  408. package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
  409. package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
  410. package/dist/skills/zon-ui/references/components/tour.md +423 -0
  411. package/dist/skills/zon-ui/references/components/tree.md +481 -0
  412. package/dist/skills/zon-ui/references/components/typography.md +347 -0
  413. package/dist/skills/zon-ui/references/components/video-player.md +386 -0
  414. package/dist/skills/zon-ui/references/marketing.md +467 -0
  415. package/dist/skills/zon-ui/references/motion.md +455 -0
  416. package/dist/skills/zon-ui/references/recipes.md +1232 -0
  417. package/dist/skills/zon-ui/references/tokens.md +866 -0
  418. package/dist/sources/accordion.css +4 -0
  419. package/dist/sources/action-sheet.css +11 -0
  420. package/dist/sources/alert-dialog.css +6 -0
  421. package/dist/sources/alert.css +3 -0
  422. package/dist/sources/app-bar.css +14 -0
  423. package/dist/sources/ascii-field.css +3 -0
  424. package/dist/sources/aspect-ratio.css +3 -0
  425. package/dist/sources/audio-player.css +20 -0
  426. package/dist/sources/avatar.css +3 -0
  427. package/dist/sources/badge.css +3 -0
  428. package/dist/sources/bottom-nav.css +9 -0
  429. package/dist/sources/breadcrumb.css +14 -0
  430. package/dist/sources/button-group.css +3 -0
  431. package/dist/sources/button.css +9 -0
  432. package/dist/sources/calendar.css +13 -0
  433. package/dist/sources/card.css +3 -0
  434. package/dist/sources/carousel.css +11 -0
  435. package/dist/sources/chart.css +5 -0
  436. package/dist/sources/checkbox.css +6 -0
  437. package/dist/sources/code-block.css +13 -0
  438. package/dist/sources/collapsible.css +4 -0
  439. package/dist/sources/color-picker.css +13 -0
  440. package/dist/sources/combobox.css +13 -0
  441. package/dist/sources/command.css +13 -0
  442. package/dist/sources/context-menu.css +12 -0
  443. package/dist/sources/conversation.css +10 -0
  444. package/dist/sources/copy-button.css +10 -0
  445. package/dist/sources/data-table.css +27 -0
  446. package/dist/sources/date-picker.css +20 -0
  447. package/dist/sources/dialog.css +9 -0
  448. package/dist/sources/direction.css +2 -0
  449. package/dist/sources/drawer.css +9 -0
  450. package/dist/sources/drawing.css +5 -0
  451. package/dist/sources/empty.css +3 -0
  452. package/dist/sources/feature-list.css +4 -0
  453. package/dist/sources/field.css +4 -0
  454. package/dist/sources/file-drop.css +15 -0
  455. package/dist/sources/filter-bar.css +30 -0
  456. package/dist/sources/form.css +4 -0
  457. package/dist/sources/graph.css +19 -0
  458. package/dist/sources/illustration.css +28 -0
  459. package/dist/sources/input-group.css +7 -0
  460. package/dist/sources/input.css +3 -0
  461. package/dist/sources/item.css +4 -0
  462. package/dist/sources/kbd.css +5 -0
  463. package/dist/sources/label.css +3 -0
  464. package/dist/sources/layout.css +3 -0
  465. package/dist/sources/lightbox.css +33 -0
  466. package/dist/sources/locale.css +2 -0
  467. package/dist/sources/logo.css +4 -0
  468. package/dist/sources/markdown-editor.css +41 -0
  469. package/dist/sources/mentions.css +13 -0
  470. package/dist/sources/menu.css +11 -0
  471. package/dist/sources/menubar.css +14 -0
  472. package/dist/sources/message.css +16 -0
  473. package/dist/sources/meter.css +4 -0
  474. package/dist/sources/money-input.css +10 -0
  475. package/dist/sources/native-select.css +4 -0
  476. package/dist/sources/navigation-menu.css +8 -0
  477. package/dist/sources/number-field.css +8 -0
  478. package/dist/sources/number-roll.css +6 -0
  479. package/dist/sources/otp-field.css +5 -0
  480. package/dist/sources/pagination.css +11 -0
  481. package/dist/sources/pdf-viewer.css +30 -0
  482. package/dist/sources/phone-input.css +20 -0
  483. package/dist/sources/popover.css +7 -0
  484. package/dist/sources/preview-card.css +7 -0
  485. package/dist/sources/progress.css +4 -0
  486. package/dist/sources/prompt-input.css +15 -0
  487. package/dist/sources/pull-to-refresh.css +14 -0
  488. package/dist/sources/quote.css +3 -0
  489. package/dist/sources/radio-group.css +5 -0
  490. package/dist/sources/rating.css +6 -0
  491. package/dist/sources/reasoning.css +6 -0
  492. package/dist/sources/resizable.css +4 -0
  493. package/dist/sources/response.css +16 -0
  494. package/dist/sources/scheduler.css +44 -0
  495. package/dist/sources/scroll-area.css +3 -0
  496. package/dist/sources/select.css +12 -0
  497. package/dist/sources/separator.css +3 -0
  498. package/dist/sources/sidebar.css +19 -0
  499. package/dist/sources/site-header.css +15 -0
  500. package/dist/sources/skeleton.css +3 -0
  501. package/dist/sources/slider.css +6 -0
  502. package/dist/sources/sortable.css +12 -0
  503. package/dist/sources/sources.css +6 -0
  504. package/dist/sources/spinner.css +6 -0
  505. package/dist/sources/stat.css +9 -0
  506. package/dist/sources/stepper.css +6 -0
  507. package/dist/sources/suggestions.css +10 -0
  508. package/dist/sources/swipe-actions.css +20 -0
  509. package/dist/sources/switch.css +5 -0
  510. package/dist/sources/table.css +7 -0
  511. package/dist/sources/tabs.css +5 -0
  512. package/dist/sources/tag.css +3 -0
  513. package/dist/sources/tags-input.css +6 -0
  514. package/dist/sources/textarea.css +3 -0
  515. package/dist/sources/theme.css +13 -0
  516. package/dist/sources/time-field.css +7 -0
  517. package/dist/sources/timeline.css +7 -0
  518. package/dist/sources/tippy.css +6 -0
  519. package/dist/sources/toast.css +6 -0
  520. package/dist/sources/toggle-group.css +5 -0
  521. package/dist/sources/toggle.css +3 -0
  522. package/dist/sources/tool-call.css +16 -0
  523. package/dist/sources/toolbar.css +14 -0
  524. package/dist/sources/tooltip.css +6 -0
  525. package/dist/sources/tour.css +14 -0
  526. package/dist/sources/tree.css +6 -0
  527. package/dist/sources/typography.css +4 -0
  528. package/dist/sources/video-player.css +21 -0
  529. package/dist/styles/ai.css +3 -0
  530. package/dist/styles/brand.css +98 -0
  531. package/dist/styles/core.css +266 -0
  532. package/dist/styles/editor.css +3 -0
  533. package/dist/styles/expressive.css +35 -56
  534. package/dist/styles/fonts.css +61 -117
  535. package/dist/styles/graph.css +4 -0
  536. package/dist/styles/illustration.css +4 -0
  537. package/dist/styles/index.css +11 -201
  538. package/dist/styles/material.css +138 -12
  539. package/dist/styles/parts/ai.css +18 -13
  540. package/dist/styles/parts/brand.css +2 -2
  541. package/dist/styles/parts/controls.css +29 -20
  542. package/dist/styles/parts/data.css +13 -9
  543. package/dist/styles/parts/editor.css +372 -0
  544. package/dist/styles/parts/feedback.css +32 -2
  545. package/dist/styles/parts/foundations.css +12 -7
  546. package/dist/styles/parts/graph.css +25 -9
  547. package/dist/styles/parts/inputs.css +172 -9
  548. package/dist/styles/parts/isometric.css +6 -5
  549. package/dist/styles/parts/navigation.css +206 -27
  550. package/dist/styles/parts/overlays.css +19 -4
  551. package/dist/styles/parts/pdf.css +2 -2
  552. package/dist/styles/pdf.css +3 -0
  553. package/dist/styles/prose.css +3 -0
  554. package/dist/styles/tokens.css +89 -14
  555. package/dist/theme.d.ts +1 -0
  556. package/dist/theme.js +5 -0
  557. package/dist/vite.d.ts +48 -59
  558. package/dist/vite.js +54 -21
  559. package/package.json +69 -2
@@ -0,0 +1,467 @@
1
+ # Marketing pages: landing pages, waitlists, shops and product pages
2
+
3
+ How to compose a zon marketing page — a home page, a landing page, a waitlist, a shop's front, a
4
+ product or campaign page — from the library. Read it with the brand guide (`brand.md`); this is
5
+ composition, not new rules. Not for app screens: a dashboard or a CRM has its own frame
6
+ (`SidebarProvider`).
7
+
8
+ ## Compose for the product, not for zon.sh
9
+
10
+ zon.sh is **one** page built in this system, not the template for every page. Pages that copy its
11
+ outline — numbered "01 / …" sections, three columns of icons, an FAQ accordion and the night footer
12
+ with the horizon — all look the same, whatever they sell. The system is the material, the type, the
13
+ hairlines and the voice; the outline belongs to the product.
14
+
15
+ 1. **Write the outline from the reader's questions**, in their order: what is it, is it for me, how
16
+ does it work, what does it cost, can I trust it, how do I start. Drop the ones the product doesn't
17
+ need; a waitlist may be three sections, a shop's front two.
18
+ 2. **Pick a pattern per section by its content** (the tables below), not by habit: steps are a
19
+ numbered list, specifications a two-column list, one feature that matters most a bento cell with
20
+ a live preview, a product a card with its photo.
21
+ 3. **Vary the rhythm.** No two neighbouring sections share a shape. Alternate open and dense, text
22
+ and picture, left-aligned and centred; let one section run on a square `surface-container`
23
+ region or the night ground for contrast. Three `FeatureList`s in a row in the same layout is the
24
+ failure this guide exists to prevent.
25
+ 4. **Choose the hero and the footer last**, from the variants below, to fit what the page asks of
26
+ the reader.
27
+
28
+ What the zon.sh outline uses — the "NN / Eyebrow" section label, the isometric figure, the
29
+ accordion FAQ, the night footer — is fine **once, where it fits**. None of it is required. A
30
+ section label can be a plain eyebrow ("How it works"), the heading alone, or nothing.
31
+
32
+ ## Rules
33
+
34
+ - **One primary per view, where the reader acts.** The core rule holds on a long page too: at
35
+ most one primary is in sight at a time, read as a screenful. The page's main action is the
36
+ primary where the reader acts on it. On a waitlist, sign-up or shop that is the hero (the email
37
+ field and its button, "Add to cart"), and the same action asked again further down — the
38
+ footer's included — is `secondary` and leads back to it. On a page that ends in a conversation
39
+ ("Get in touch", "Book a demo"), the primary is the closing call to action, and the hero's
40
+ button is a `secondary` that names its destination ("See the components"). A section that is a
41
+ task of its own — the plans of the `Pricing` block, a contact form — is its own view and keeps
42
+ its one primary ("Start with Team", "Send message"); keep it a screenful away from the page's
43
+ other primary, so two never meet. The header never holds one.
44
+ - **Honest copy.** A plain statement as the headline, its echo in muted ink if it has one; one
45
+ sentence about what the product is as the lead. No pressure copy ("Act now", "Limited spots"),
46
+ no promised results, no invented metrics, customers, logos, quotes, ratings or testimonials. Sample data in
47
+ a product preview reads as sample data. The rule is about inventing: quotes, logos, ratings, team
48
+ and figures the owner gives you, or that the page being redesigned already has, are kept as they
49
+ are. Facts you can't know — how it treats data, privacy and security, prices, dates and delivery,
50
+ platforms and integrations, any number, and features beyond the brief — go in as marked
51
+ placeholders for the owner to confirm, and are listed in your summary, never stated as fact.
52
+ What follows plainly from the brief ("tidy notes" for a notes app) is written as it is. A
53
+ placeholder is mono, in the warning ink, in the sentence where the fact goes:
54
+ `Free while in beta, then <Mono className="text-warning">[To confirm: monthly price]</Mono>.` It
55
+ reads as unfinished on purpose, so nobody ships it by mistake; one search for "To confirm" finds
56
+ them all.
57
+ - **Pictures by meaning, uncoloured.** One figure per view: an `Illustration` from
58
+ `@zonsh/ui/illustration` chosen by meaning (browse `illustrations`), a labelled sample of the
59
+ product built from the library's components, or — in a shop — real photos of the product in
60
+ their frames. Never a photo behind the headline, never a coloured grid or a glow.
61
+ - **Type.** Licht Light (`display`, weight 300) for headlines, mixed case; Licht Sans for leads,
62
+ body and controls; Licht Mono for eyebrows, indices, prices in tables and the legal row.
63
+ - **Size by the section, not the window.** Make the hero and the footer size containers
64
+ (`@container/hero`, `@container`) and step type and spacing with container queries, so they read
65
+ the same full screen, in a column and in a phone-sized frame. On a page that is always the full
66
+ window, `TwoTone` and `Display` (which follow the window) do the same job.
67
+ - **Hairlines before boxes.** Sections are not cards. Objects that stand alone — a product, a plan
68
+ card, a real quote — may be cards; never a row of cards to hold paragraphs.
69
+ - **Your own mark.** For a product that isn't zon, pass `Wordmark` (from `@zonsh/ui/brand`) to
70
+ `SiteHeader`'s `logo`: `<Wordmark href="/" mark={<YourMark />}>Name</Wordmark>` sets your SVG
71
+ mark beside the name in Licht Light, sized and spaced like `Logo`. Use it for the name anywhere a
72
+ logo goes (a shop's bar, a sidebar, above a sign-in card) rather than styling a `<span>`. `Logo`
73
+ is the zon crescent only.
74
+
75
+ ## The page
76
+
77
+ 1. **`SiteHeader`** — sticky; the mark, the site's links, quiet actions (`ThemeToggle`, a cart or
78
+ account button). No primary button in the header.
79
+ 2. **The opening view** — one of the hero variants.
80
+ 3. **Sections** — one idea each, under a hairline, each in the pattern its content calls for.
81
+ 4. **The footer** — one of the footer patterns; its legal row is always the last thing on the page.
82
+
83
+ ## Hero variants
84
+
85
+ | Variant | Looks like | Use it when |
86
+ | ----------------------- | ----------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
87
+ | **Split with a figure** | Eyebrow, two-tone headline, lead, a button on one side; one illustration on the other, on a faint blueprint grid. | The product is an idea or a service with nothing on screen to show yet. |
88
+ | **Product first** | Headline and lead centred above, then a wide sample of the product — a `surface-card` built from real components. | The product is software with an interface; showing it beats describing it. |
89
+ | **Centred statement** | A large centred headline, one lead line, the action, and nothing else; generous space above and below. | The idea fits in one sentence: a manifesto, a launch, a waitlist. |
90
+ | **Editorial** | A very large left-aligned headline over the full column, the lead and the action in a narrow column beside it, under a hairline. | A studio, a publication, a craft product — where the type is the picture. |
91
+ | **With the form** | Any of the above with the conversion in it: an email field and its button in one row (stacked on a phone). | A waitlist, a newsletter, a free sign-up. The button is the view's primary. |
92
+
93
+ Shared rules:
94
+
95
+ - The headline is the page's `h1`; its two lines are spans in one heading, the second in
96
+ `text-muted-foreground` and starting with a space so screen readers keep them apart. 44px, 60px
97
+ once the hero is `@xl` wide (or `Display`, which follows the window).
98
+ - One entrance, on load, with the `ep-reveal` keyframes: the eyebrow and headline rise 12px as they
99
+ fade in, the lead follows at ~100ms, the action at ~160ms rising 8px, the picture only fades.
100
+ Write delays as fractions of `--duration-reveal` (`calc(var(--duration-reveal) * 0.24)`) so
101
+ reduced motion, where it is 0, shows the page at once. The header doesn't animate.
102
+ - A backdrop (`blueprint`, `dots`, `AsciiField`) is decorative (`aria-hidden`,
103
+ `pointer-events-none`) and masked with a radial gradient so it fades out at the edges. Use one at
104
+ most, and not on every page of a site.
105
+
106
+ ### Split with a figure
107
+
108
+ Two columns from `@3xl` (text, then a 20–24rem figure); stacked and centred below that, with the
109
+ figure at most 16rem.
110
+
111
+ ```tsx
112
+ import { Button, Container, Eyebrow, Lead, SiteHeader, ThemeToggle } from "@zonsh/ui";
113
+ import { Logo } from "@zonsh/ui/brand";
114
+ import { Illustration } from "@zonsh/ui/illustration";
115
+
116
+ const reveal = (delay: number, rise = 12) =>
117
+ `[--reveal-distance:${rise}px] animate-[ep-reveal_var(--duration-reveal)_var(--ease)_calc(var(--duration-reveal)*${delay})_both]`;
118
+
119
+ <div className="@container/hero bg-background text-foreground">
120
+ <SiteHeader logo={<Logo href="/" />} links={links} actions={<ThemeToggle />} />
121
+ <main>
122
+ <section aria-labelledby="hero-title" className="relative isolate">
123
+ <div
124
+ aria-hidden
125
+ className="blueprint pointer-events-none absolute inset-0 -z-1 [mask-image:radial-gradient(ellipse_75%_90%_at_50%_45%,#000_35%,transparent_85%)]"
126
+ />
127
+ <Container className="grid items-center gap-10 py-[clamp(2.5rem,5cqw,4rem)] @3xl/hero:grid-cols-[minmax(0,1fr)_minmax(0,20rem)]">
128
+ <div className="flex flex-col items-start gap-5">
129
+ <Eyebrow className={reveal(0)}>zon/ui</Eyebrow>
130
+ <h1 id="hero-title" className={`display text-[44px] @xl/hero:text-[60px] ${reveal(0)}`}>
131
+ <span className="block">Quiet interfaces.</span>
132
+ <span className="block text-muted-foreground"> Built from one material.</span>
133
+ </h1>
134
+ <Lead className={reveal(0.24)}>Base UI components in one monochrome material, set in Licht.</Lead>
135
+ <Button size="lg" variant="secondary" render={<a href="/components" />} nativeButton={false} className={reveal(0.38, 8)}>
136
+ See the components
137
+ </Button>
138
+ </div>
139
+ <Illustration name="iso/platform" className={`w-full max-w-[16rem] justify-self-center @3xl/hero:max-w-none ${reveal(0, 0)}`} />
140
+ </Container>
141
+ </section>
142
+ {/* the page's sections */}
143
+ </main>
144
+ </div>;
145
+ ```
146
+
147
+ ### Product first
148
+
149
+ The headline block is centred and narrow (`max-w-[44rem] mx-auto text-center`); the sample sits
150
+ below it at the full column width, as a `surface-card` labelled with an eyebrow ("Example note",
151
+ "Sample project") so nobody takes it for a real account. Build it from the library — `Item`,
152
+ `Table`, `Checkbox`, `Tag`, `AvatarGroup` — not from a screenshot, so it follows the theme and stays
153
+ sharp. One sample, not a collage of them.
154
+
155
+ ### Centred statement and editorial
156
+
157
+ The centred statement is the headline (`Display`, or `display` at 56–72px), one `Lead` and the
158
+ action, centred, with `py-[clamp(5rem,12cqw,9rem)]` around them and no picture. The editorial hero
159
+ sets the headline left-aligned across the column at 64–96px, then a hairline, then a two-column row
160
+ from `@3xl`: the lead on the left, the action on the right.
161
+
162
+ ### With the form
163
+
164
+ `Form` gives the row what a waitlist needs: the browser's checks with your words, a server error
165
+ under the field it is about, focus on the first problem, and a re-check as people correct it.
166
+
167
+ ```tsx
168
+ import { Button, Field, FieldDescription, FieldError, FieldLabel, Form, Input } from "@zonsh/ui";
169
+ import * as React from "react";
170
+
171
+ function Waitlist() {
172
+ const [errors, setErrors] = React.useState<Record<string, string>>({});
173
+ const [pending, setPending] = React.useState(false);
174
+ const [joined, setJoined] = React.useState<string | null>(null);
175
+ const done = React.useRef<HTMLParagraphElement>(null);
176
+ React.useEffect(() => done.current?.focus(), [joined]);
177
+
178
+ async function join(values: { email?: string }) {
179
+ setPending(true);
180
+ // Your endpoint: it answers { email: "…" } for an address it can't take.
181
+ const result = await joinWaitlist(String(values.email));
182
+ setPending(false);
183
+ if (result.errors) setErrors(result.errors);
184
+ else setJoined(String(values.email));
185
+ }
186
+
187
+ if (joined)
188
+ return (
189
+ <p ref={done} tabIndex={-1} role="status" className="text-foreground-soft">
190
+ You're on the list. We'll write to {joined} when your place opens.
191
+ </p>
192
+ );
193
+ return (
194
+ <Form errors={errors} onFormSubmit={join} className="w-full max-w-md">
195
+ <Field name="email">
196
+ <FieldLabel>Your work email</FieldLabel>
197
+ <div className="flex flex-col gap-2 sm:flex-row">
198
+ <Input
199
+ type="email"
200
+ required
201
+ autoComplete="email"
202
+ placeholder="you@company.com"
203
+ className="sm:flex-1"
204
+ onChange={() => setErrors({})}
205
+ />
206
+ <Button type="submit" loading={pending} loadingLabel="Joining the waitlist">
207
+ Join the waitlist
208
+ </Button>
209
+ </div>
210
+ <FieldDescription>One email when your place opens. No newsletter.</FieldDescription>
211
+ <FieldError match="valueMissing">Enter your email address.</FieldError>
212
+ <FieldError match="typeMismatch">Enter an email address, like you@company.com.</FieldError>
213
+ {errors.email ? <FieldError match>{errors.email}</FieldError> : null}
214
+ </Field>
215
+ </Form>
216
+ );
217
+ }
218
+ ```
219
+
220
+ The field and the button are both 38px (an `Input` has no 46px size, so the button doesn't take
221
+ `size="lg"` here). The form sits on the page, not in a card. After sending, the line that replaces
222
+ it is focused and in a polite live region (`role="status"`).
223
+
224
+ ## Section patterns
225
+
226
+ Choose by what the section holds. Each pattern names the components that build it.
227
+
228
+ | The section holds | Pattern |
229
+ | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
230
+ | Three to six parallel features of the same weight | `FeatureList` `layout="grid"` — the default; use it once per page at most. |
231
+ | One feature that matters most, and a few beside it | `FeatureList` `layout="bento"` — the main one a `large` cell with a live preview built from components. |
232
+ | Features that each need a picture | `FeatureList` `layout="rows"` — text beside an illustration filling a `FeatureFigure`, sides alternating. |
233
+ | Steps in order: how it works, how to start | `FeatureList` `layout="index"` — large Licht numerals. Or `Stepper` for a flow on the page itself. |
234
+ | Specifications, what's included, terms, delivery | `FeatureList` `layout="split"` — title left, body right; or a `Table` when there are columns to compare. |
235
+ | A short list of problems or reasons | `FeatureCalloutList` — a mono key, an em dash, one line each — beside a heading. |
236
+ | One idea to land | A statement: one Licht sentence at 32–48px across the column, nothing else, between hairlines. Your own words, not a quote. |
237
+ | Real figures | Editorial facts (brand guide › Numbers): up to three large Licht numerals with a unit word and one plain sentence. Only numbers that are true and sourced; otherwise leave it out. |
238
+ | Products to buy | A grid of photos, each the object: an `AspectRatio` (1:1 or 4:5) in a 20px frame, under it the name in Licht, the price in mono and one line, the name the one action. No box around them; see the Shop block. |
239
+ | Plans and prices | The `Pricing` block — a period toggle, plans as cards or hairline columns, a comparison table. |
240
+ | A product shown working | A `surface-card` sample built from components, a `VideoPlayer` clip, or a `Carousel` of a few real screens. |
241
+ | Questions people ask | See FAQ below. |
242
+ | A history or a changelog | `Timeline`, the changelog style. |
243
+ | A real quote, with permission | `Quote`. Never invented, never a wall of them. |
244
+
245
+ ### Trust without social proof
246
+
247
+ A new product has no logos or testimonials, and must not invent any. Earn trust with what is true:
248
+
249
+ - **How it works underneath** — an `index` list or a `rows` list of what happens to the reader's
250
+ data, money or order, step by step.
251
+ - **The terms in plain words** — a `split` list: where data is stored, how to cancel, what it costs
252
+ after the trial, how delivery and returns work.
253
+ - **Who makes it** — a short paragraph and a name, a city, a way to reach a person.
254
+ - **Proof you can check** — the public docs, the changelog, a status page, the source, a free plan.
255
+
256
+ ### FAQ, and alternatives to the accordion
257
+
258
+ - **Two to five questions:** answer them in the open — a `split` list with the question as the title
259
+ and the answer as the body. Nobody has to click to read four sentences.
260
+ - **Six to twelve:** an `Accordion` beside a heading (heading left, accordion right from `md`).
261
+ - **More, or grouped:** headings per topic and the questions under each; link to a help page rather
262
+ than growing the page.
263
+ - Better still, answer the question in the section it belongs to (price questions under pricing,
264
+ data questions under privacy) and skip the FAQ.
265
+
266
+ ### Call-to-action bands
267
+
268
+ A page's last section often asks for the action again. Pick one band, not all of them:
269
+
270
+ - **Inline band** — between hairlines: a Licht line on the left, the action on the right, wrapping
271
+ below it on a phone. Quiet; for the middle of a long page.
272
+ - **Region band** — a full-width square `surface-container` region with the headline, one sentence
273
+ and the action centred. For the end of a light page.
274
+ - **Night CTA** — the night footer below. It is the strongest and the most recognisably zon.sh; use
275
+ it on a home page, not on every page of a site.
276
+
277
+ ## Footer patterns
278
+
279
+ Every footer ends with the **legal row** under a hairline: the year and the name, imprint and
280
+ privacy in 11px uppercase mono with 24px targets (`-my-1 inline-flex min-h-6 items-center py-1`),
281
+ and a ghost `icon-sm` "Back to top" button that scrolls up (instantly under reduced motion) and
282
+ moves focus to the page's first control. Nothing comes after it. Keep the footer outside `<main>`
283
+ so it is the page's `contentinfo`, with its links in a `nav` named "Footer".
284
+
285
+ | Pattern | Looks like | Use it for |
286
+ | ------------------ | --------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
287
+ | **Night CTA** | The night ground whatever the theme: the page's closing call to action and one row of Licht links over the horizon drawing; the legal row under the horizon, at the very bottom. | A home page or a launch page that ends in one action. The most dramatic; once per site. |
288
+ | **Link columns** | On the page ground under a hairline: the name and one line on the left, two to four mono-titled link columns on the right, then the legal row. | A site with several pages: product, company, help. The everyday choice. |
289
+ | **Compact** | One line under a hairline: the year and name on one side, a few mono links on the other. | Docs, legal pages, an app's public pages, a single-page waitlist where the hero already carries the action. |
290
+ | **Big wordmark** | A line about the product and a row of links, then the product's name in Licht set across the whole column, then the legal row. | A brand with a strong name and little to link to: a studio, a shop, a launch. |
291
+
292
+ The legal row, shared by the patterns:
293
+
294
+ ```tsx
295
+ import { Button } from "@zonsh/ui";
296
+ import { ArrowUpIcon } from "lucide-react";
297
+
298
+ function backToTop() {
299
+ const reduce = matchMedia("(prefers-reduced-motion: reduce)").matches;
300
+ window.scrollTo({ top: 0, behavior: reduce ? "auto" : "smooth" });
301
+ document.querySelector<HTMLElement>("a[href], button")?.focus({ preventScroll: true });
302
+ }
303
+
304
+ function LegalRow({ name, className = "" }: { name: string; className?: string }) {
305
+ const link = "-my-1 inline-flex min-h-6 items-center py-1 transition-colors duration-(--duration-fade) hover:text-foreground";
306
+ return (
307
+ <div className={`flex items-center justify-between gap-4 font-mono text-[11px] tracking-[0.14em] text-muted-foreground uppercase ${className}`}>
308
+ <div className="flex min-w-0 flex-col gap-x-5 gap-y-2 sm:flex-row sm:items-center">
309
+ <span>© 2026 {name}</span>
310
+ <span className="flex flex-wrap gap-x-5">
311
+ <a href="/imprint" className={link}>Imprint</a>
312
+ <a href="/privacy" className={link}>Privacy</a>
313
+ </span>
314
+ </div>
315
+ <Button size="icon-sm" variant="ghost" aria-label="Back to top" onClick={backToTop}>
316
+ <ArrowUpIcon />
317
+ </Button>
318
+ </div>
319
+ );
320
+ }
321
+ ```
322
+
323
+ Put the hairline on the row inside `Container` (`<Container><LegalRow className="pt-5 pb-6 hairline" /></Container>`),
324
+ not on the `Container` itself, so the rule lines up with the text above it.
325
+
326
+ ### Night CTA
327
+
328
+ - `theme-night` on the footer: the `#040404` ground in either theme. Set `--page-bg` _outside_ the
329
+ night scope; a 128px gradient at the top reads it so the night fades in from the page above.
330
+ - The call to action: a `section` named by its `h2` — 32 / 40 / 48px at `@lg` / `@3xl`, two lines
331
+ like the hero's — one sentence in `text-foreground-soft`, a 46px button (the primary only when
332
+ this is where the reader acts) and at most one `secondary` beside it.
333
+ - Links: one centred row in Licht (`font-heading font-light`, 17px, `text-foreground-soft`, hover
334
+ to `foreground`).
335
+ - The horizon (`DrawingHorizon` from `@zonsh/ui/drawing`, which keeps the other drawings out of the build) is a full-width 2:1 band **in the flow**, pulled up by `37.5cqw` so its rim
336
+ crests just below the links. The legal row comes **after** it, under the horizon: it rises into
337
+ the planet's dark body to sit `max(1.5rem, 8cqw)` below the crest — clear of the rim where it
338
+ curves down to the edges — and is the last thing on the page. Never put the legal row above the
339
+ rim.
340
+
341
+ ```tsx
342
+ import { Button, Container } from "@zonsh/ui";
343
+ import { DrawingHorizon } from "@zonsh/ui/drawing";
344
+ import { ArrowRightIcon } from "lucide-react";
345
+
346
+ <div className="bg-background [--page-bg:var(--background)]">
347
+ <footer className="theme-night @container relative isolate overflow-hidden bg-background text-foreground">
348
+ <div aria-hidden className="pointer-events-none absolute inset-x-0 top-0 h-32 bg-[linear-gradient(to_bottom,var(--page-bg),transparent)]" />
349
+ <Container className="relative pt-16 pb-[max(3rem,6cqw)] text-center">
350
+ <section aria-labelledby="footer-cta" className="mx-auto flex max-w-[44rem] flex-col items-center gap-5">
351
+ <h2 id="footer-cta" className="display text-[32px] @lg:text-[40px] @3xl:text-[48px]">
352
+ <span className="block">Less noise.</span>
353
+ <span className="block text-muted-foreground"> More signal.</span>
354
+ </h2>
355
+ <p className="text-foreground-soft">Tell us what you are working on. We will say plainly whether we can help.</p>
356
+ <Button size="lg" render={<a href="/contact" />} nativeButton={false}>
357
+ Get in touch
358
+ <ArrowRightIcon className="rtl:-scale-x-100" />
359
+ </Button>
360
+ </section>
361
+ <nav aria-label="Footer" className="mt-12">
362
+ <ul className="m-0 flex list-none flex-wrap justify-center gap-x-8 gap-y-3 p-0">
363
+ {links.map((l) => (
364
+ <li key={l.href}>
365
+ <a href={l.href} className="font-heading text-[17px] font-light text-foreground-soft transition-colors duration-(--duration-fade) hover:text-foreground">
366
+ {l.label}
367
+ </a>
368
+ </li>
369
+ ))}
370
+ </ul>
371
+ </nav>
372
+ </Container>
373
+ {/* The horizon, in the flow: its rim crests just under the links. */}
374
+ <DrawingHorizon className="pointer-events-none relative -z-1 -mt-[37.5cqw] aspect-[2/1] w-full" />
375
+ {/* The legal row, under the horizon, at the very bottom. */}
376
+ <Container className="relative mt-[calc(max(1.5rem,8cqw)-12.5cqw)]">
377
+ <LegalRow name="Northwind" className="pt-5 pb-6 hairline" />
378
+ </Container>
379
+ </footer>
380
+ </div>;
381
+ ```
382
+
383
+ ### Link columns
384
+
385
+ ```tsx
386
+ import { Container } from "@zonsh/ui";
387
+ import { Wordmark } from "@zonsh/ui/brand";
388
+
389
+ <footer className="@container">
390
+ <Container>
391
+ <div className="grid gap-12 pt-14 pb-12 hairline @3xl:grid-cols-[minmax(0,2fr)_minmax(0,3fr)]">
392
+ <div className="flex max-w-xs flex-col gap-3">
393
+ <Wordmark href="/" size={22} className="self-start">Northwind</Wordmark>
394
+ <p className="text-[15px] leading-relaxed text-foreground-soft">Deploys and previews for small teams, run from Hamburg.</p>
395
+ </div>
396
+ <nav aria-label="Footer" className="grid grid-cols-2 gap-x-8 gap-y-10 @lg:grid-cols-3">
397
+ {columns.map((col) => (
398
+ <div key={col.title} className="flex flex-col gap-4">
399
+ <h2 className="eyebrow">{col.title}</h2>
400
+ <ul className="m-0 flex list-none flex-col gap-2.5 p-0">
401
+ {col.links.map((l) => (
402
+ <li key={l.href}>
403
+ <a href={l.href} className="text-[15px] text-foreground-soft transition-colors duration-(--duration-fade) hover:text-foreground">{l.label}</a>
404
+ </li>
405
+ ))}
406
+ </ul>
407
+ </div>
408
+ ))}
409
+ </nav>
410
+ </div>
411
+ <LegalRow name="Northwind" className="pt-5 pb-6 hairline" />
412
+ </Container>
413
+ </footer>;
414
+ ```
415
+
416
+ ### Compact
417
+
418
+ ```tsx
419
+ <footer>
420
+ <Container>
421
+ <div className="flex flex-col gap-3 pt-5 pb-6 font-mono text-[11px] tracking-[0.14em] text-muted-foreground uppercase hairline sm:flex-row sm:items-center sm:justify-between">
422
+ <span>© 2026 Northwind</span>
423
+ <nav aria-label="Footer">
424
+ <ul className="m-0 flex list-none flex-wrap items-center gap-x-5 gap-y-2 p-0">
425
+ {/* Docs, Status, Imprint, Privacy — each a link with a 24px target */}
426
+ </ul>
427
+ </nav>
428
+ </div>
429
+ </Container>
430
+ </footer>;
431
+ ```
432
+
433
+ ### Big wordmark
434
+
435
+ The name is decorative (`aria-hidden`; the legal row says it), one line, in Licht Light, sized in
436
+ `cqw` of its own size container so it spans the column at every width. Tune the size to the name:
437
+ `22.5cqw` fits "Northwind"; a shorter name takes more, a longer one less. Never bold it, never
438
+ colour it, never let it scroll sideways.
439
+
440
+ ```tsx
441
+ <footer>
442
+ <Container>
443
+ <div className="flex flex-col gap-8 pt-14 hairline md:flex-row md:items-end md:justify-between">
444
+ <p className="m-0 max-w-sm font-heading text-[24px] leading-[1.2] font-light tracking-[-0.02em] text-foreground-soft">
445
+ Deploys and previews for small teams.
446
+ </p>
447
+ <nav aria-label="Footer">{/* one row of Licht Sans links, 15px */}</nav>
448
+ </div>
449
+ <div aria-hidden className="@container mt-12 mb-8 select-none">
450
+ <p className="m-0 font-heading text-[22.5cqw] leading-[0.78] font-light tracking-[-0.045em] whitespace-nowrap">Northwind</p>
451
+ </div>
452
+ <LegalRow name="Northwind" className="pt-5 pb-6 hairline" />
453
+ </Container>
454
+ </footer>;
455
+ ```
456
+
457
+ ## Accessibility
458
+
459
+ - The hero's headline is the page's `h1`; section and footer headings are `h2`. Each two-line
460
+ headline is one heading.
461
+ - Landmarks: the header (its links a `nav` named "Main", the current page `aria-current`), `<main>`,
462
+ and the footer as `contentinfo` with its own `nav` named "Footer".
463
+ - Grids, figures, gradients, the horizon and a big wordmark are decorative: `aria-hidden`, no
464
+ pointer.
465
+ - A live product sample in a hero or a bento cell holds real controls: label them, and keep them
466
+ few.
467
+ - In a right-to-left page both mirror; arrows point the way the text runs (`rtl:-scale-x-100`).