@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,116 @@
1
+ # Kbd
2
+
3
+ ```tsx
4
+ import { Kbd, KbdGroup } from "@zonsh/ui";
5
+
6
+ export function Keys() {
7
+ return (
8
+ <div className="flex flex-wrap items-center gap-4">
9
+ <KbdGroup>
10
+ <Kbd>
11
+ <span aria-hidden>⌘</span>
12
+ <span className="sr-only">Command</span>
13
+ </Kbd>
14
+ <Kbd>K</Kbd>
15
+ </KbdGroup>
16
+ <KbdGroup>
17
+ <Kbd>Ctrl</Kbd>
18
+ <Kbd>Shift</Kbd>
19
+ <Kbd>P</Kbd>
20
+ </KbdGroup>
21
+ <Kbd>Esc</Kbd>
22
+ <Kbd>/</Kbd>
23
+ </div>
24
+ );
25
+ }
26
+ ```
27
+
28
+ A raised mini key: Licht Mono 11px, 20px tall, 5px radius. `KbdGroup` lays out a chord; `KbdShortcut` writes one for the reader's device.
29
+
30
+ ## Usage
31
+
32
+ ```tsx
33
+ import { Kbd, KbdGroup, KbdShortcut } from "@zonsh/ui";
34
+
35
+ <KbdShortcut keys={["mod", "K"]} /> // ⌘ K on a Mac, Ctrl K elsewhere
36
+
37
+ <KbdGroup>
38
+ <Kbd>⌘</Kbd>
39
+ <Kbd>K</Kbd>
40
+ </KbdGroup>;
41
+ ```
42
+
43
+ Use `KbdShortcut` for any shortcut with a modifier.
44
+
45
+ ## When to use
46
+
47
+ - Shortcuts in menus, tooltips, sidebars and docs.
48
+ - Not code (`CodeBlock`) or labels (`Tag`).
49
+
50
+ ## Examples
51
+
52
+ ### In text
53
+
54
+ ```tsx
55
+ import { Kbd } from "@zonsh/ui";
56
+
57
+ export function InText() {
58
+ return (
59
+ <p className="m-0 text-[15px] text-foreground-soft">
60
+ Press <Kbd>/</Kbd> to search the documentation, or <Kbd>Esc</Kbd> to close it.
61
+ </p>
62
+ );
63
+ }
64
+ ```
65
+
66
+ ### For the device
67
+
68
+ `mod` is ⌘ on a Mac, iPhone or iPad and Ctrl elsewhere; `shift`, `alt`, `ctrl`, `enter` become ⇧ ⌥ ⌃ ↵ on Apple keyboards. On a touch-only device `KbdShortcut` renders nothing. `useShortcutKeys()` returns `{ mod: "⌘" | "Ctrl", hasKeyboard }`. Handle the key the hint shows — `metaKey` on Apple, `ctrlKey` elsewhere — never either: on a Mac, Ctrl+B and Ctrl+K move the caret. The Sidebar's ⌘B / Ctrl+B works this way.
69
+
70
+ ```tsx
71
+ import { KbdShortcut, useShortcutKeys } from "@zonsh/ui";
72
+
73
+ /** Shortcuts written for the device: ⌘ on Apple, Ctrl elsewhere; nothing on a touch-only phone. */
74
+ export function ForTheDevice() {
75
+ const { hasKeyboard } = useShortcutKeys();
76
+ return (
77
+ <div className="flex flex-col gap-3 text-sm text-foreground-soft">
78
+ {/* On a phone the shortcuts render nothing: say so, or the labels look orphaned. */}
79
+ {!hasKeyboard && (
80
+ <p className="m-0 font-mono text-xs text-muted-foreground">No keyboard here, so no shortcuts.</p>
81
+ )}
82
+ <p className="m-0 flex items-center gap-2">
83
+ Search <KbdShortcut keys={["mod", "K"]} />
84
+ </p>
85
+ <p className="m-0 flex items-center gap-2">
86
+ Redo <KbdShortcut keys={["mod", "shift", "Z"]} />
87
+ </p>
88
+ <p className="m-0 flex items-center gap-2">
89
+ Send <KbdShortcut keys={["mod", "enter"]} />
90
+ </p>
91
+ </div>
92
+ );
93
+ }
94
+ ```
95
+
96
+ ## Props
97
+
98
+ `Kbd` and `KbdGroup` forward all `<kbd>` props; no variants. `KbdShortcut` takes `keys` (one string per key) and forwards the rest to its `KbdGroup`.
99
+
100
+ Off Apple keyboards the modifier names come from `messages.kbd` (`ctrl`, `shift`, `alt`, `enter`) — German prints Strg and Umschalt. `KbdShortcut` and `MenuShortcut` use them; `useKeyNames()` returns them for your own `formatShortcut(keys, mod, names)`.
101
+
102
+ ## Brand rules
103
+
104
+ - **Do** use one `Kbd` per key and the platform's symbols; never write ⌘ for everyone.
105
+ - **Don't** put words or sentences in a key.
106
+ - **Don't** make keys interactive.
107
+
108
+ ## Accessibility
109
+
110
+ - Renders `<kbd>`, which screen readers announce as keyboard input.
111
+ - Symbols like ⌘ are read inconsistently; where it matters add a hidden name: `<Kbd><span aria-hidden>⌘</span><span className="sr-only">Command</span></Kbd>`.
112
+
113
+ ---
114
+
115
+ - Import: `import { Kbd, KbdGroup, KbdShortcut, useShortcutKeys, useKeyNames } from "@zonsh/ui"`
116
+ - Source: `packages/ui/src/components/kbd.tsx`
@@ -0,0 +1,104 @@
1
+ # Label
2
+
3
+ ```tsx
4
+ import { Label, Switch } from "@zonsh/ui";
5
+
6
+ export function Basic() {
7
+ return (
8
+ <Label>
9
+ <Switch defaultChecked />
10
+ Show archived projects
11
+ </Label>
12
+ );
13
+ }
14
+ ```
15
+
16
+ A plain `<label>` in Licht Sans 14px medium. A wrapped switch or checkbox sits 10px beside the text, and the whole label is the click target. It dims to 55% when its control is disabled — nested, a `peer` just before it, or a `group` ancestor with `data-disabled`.
17
+
18
+ **Inside forms, use `FieldLabel`:** `Field` wires label, description, error and validation state; `Label` does none of that.
19
+
20
+ ## Usage
21
+
22
+ ```tsx
23
+ import { Label, Switch } from "@zonsh/ui";
24
+
25
+ <Label>
26
+ <Switch defaultChecked />
27
+ Show archived projects
28
+ </Label>;
29
+ ```
30
+
31
+ Wrap the control, or point at it with `htmlFor`.
32
+
33
+ ## When to use
34
+
35
+ - A control outside a form: a toolbar switch, a table-header checkbox, a side-panel filter.
36
+ - A native or third-party input that cannot sit in `Field` (`htmlFor`).
37
+ - Anything submitted, validated or described: `Field` + `FieldLabel`.
38
+
39
+ ## Examples
40
+
41
+ ### Disabled
42
+
43
+ ```tsx
44
+ import { Checkbox, Label } from "@zonsh/ui";
45
+
46
+ export function Disabled() {
47
+ return (
48
+ <div className="flex flex-col gap-4">
49
+ <Label>
50
+ <Checkbox defaultChecked />
51
+ Include draft articles
52
+ </Label>
53
+ <Label>
54
+ <Checkbox disabled />
55
+ Include deleted articles
56
+ </Label>
57
+ </div>
58
+ );
59
+ }
60
+ ```
61
+
62
+ ### Peer control
63
+
64
+ With `htmlFor`, give the control `peer` and place the label after it (`flex-col-reverse` puts it back on top).
65
+
66
+ ```tsx
67
+ import { Input, Label } from "@zonsh/ui";
68
+
69
+ export function PeerControl() {
70
+ return (
71
+ <div className="flex max-w-xs flex-col-reverse gap-2">
72
+ <Input id="workspace-name" defaultValue="Field notes" disabled className="peer" />
73
+ <Label htmlFor="workspace-name">Workspace name</Label>
74
+ </div>
75
+ );
76
+ }
77
+ ```
78
+
79
+ ## Props
80
+
81
+ | Prop | Type | Default |
82
+ | --------- | ----------------------------------------- | ------- |
83
+ | `htmlFor` | `string` — the id of the control | — |
84
+ | `render` | `ReactElement \| (props) => ReactElement` | — |
85
+
86
+ All `<label>` props are forwarded. Data attribute: `data-slot="label"`.
87
+
88
+ ## Brand rules
89
+
90
+ - **Do** use mixed case and say what the control does: "Show archived projects".
91
+ - **Do** use `FieldLabel` inside forms.
92
+ - **Don't** set labels in Licht Mono or uppercase (that is eyebrows).
93
+ - **Don't** hide the label and rely on a placeholder.
94
+
95
+ ## Accessibility
96
+
97
+ - Every control needs a visible label: wrap the control, or point at it with `htmlFor`.
98
+ - `Switch` and `Checkbox` render a hidden native input, so a wrapping label toggles and names them.
99
+ - Dimming is visual only; the control itself carries `disabled` / `data-disabled` for assistive technology.
100
+
101
+ ---
102
+
103
+ - Import: `import { Label } from "@zonsh/ui"`
104
+ - Source: `packages/ui/src/components/label.tsx`
@@ -0,0 +1,291 @@
1
+ # Layout
2
+
3
+ ```tsx
4
+ import { Heading, Section, Text } from "@zonsh/ui";
5
+
6
+ export function Sections() {
7
+ return (
8
+ <div className="@container w-full">
9
+ <Section index={1} label="The idea">
10
+ <div className="grid gap-4 @2xl:grid-cols-2 @2xl:gap-12">
11
+ <Heading>Your photos, in one quiet place</Heading>
12
+ <Text tone="soft">
13
+ Every photo from your phone, your camera and that old hard drive, sorted by date and place, with
14
+ nothing asking for your attention.
15
+ </Text>
16
+ </div>
17
+ </Section>
18
+ <Section index={2} label="How it works" last>
19
+ <div className="grid gap-4 @2xl:grid-cols-2 @2xl:gap-12">
20
+ <Heading>Backups you can forget about</Heading>
21
+ <Text tone="soft">
22
+ New photos upload when you are on Wi-Fi, duplicates are set aside for you to check, and the
23
+ originals are kept at full resolution.
24
+ </Text>
25
+ </div>
26
+ </Section>
27
+ </div>
28
+ );
29
+ }
30
+ ```
31
+
32
+ Pages built from whitespace and fine rules: one centred column (`Container`), bands split by a hairline and generous padding (`Section`, never a box), and a drawing-board layer of rails, crosshair marks and the blueprint grid. Everything decorative is `aria-hidden`, ignores the pointer and holds still under reduced motion.
33
+
34
+ ## Usage
35
+
36
+ ```tsx
37
+ import { Container, Section, Heading, Text } from "@zonsh/ui";
38
+
39
+ <Container>
40
+ <Section index={1} label="The idea">
41
+ <Heading>Your photos, in one quiet place</Heading>
42
+ <Text>Sorted by date and place, with nothing asking for your attention.</Text>
43
+ </Section>
44
+ <Section index={2} label="How it works" last>
45
+ …
46
+ </Section>
47
+ </Container>;
48
+ ```
49
+
50
+ On `Section`: `label` (eyebrow), `index` (zero-padded: "01 / THE IDEA") and `last` (adds the closing bottom rule).
51
+
52
+ ## When to use
53
+
54
+ - `Container` — every horizontal band of the page: max 1280px, 24px gutters, 40px at `sm`, 64px at `lg`.
55
+ - `Section` — the default grouping: a top hairline, `--section-pad` above and below (56–112px). Number sections only when order means something (a sequence, a long reference page); otherwise a plain `label` or none. A marketing page that numbers every section reads as a copy of zon.sh (see `marketing.md`). A band of your own that should keep the same rhythm (a closing call to action) takes the token directly: `py-(--section-pad)`.
56
+ - `Grid` + `GridItem` — the 12-column page grid with responsive spans.
57
+ - `Rails` — two vertical hairlines framing a column.
58
+ - `PlusMark` / `Crosshairs` — 11px crosshairs where two rules meet.
59
+ - `Blueprint` — the drawing-board grid behind headlines and art; a light eases after the pointer.
60
+ - `DotField` — a quieter 24px dot texture.
61
+ - `Grain` — film grain for large or dark expressive regions; it moves only on a desktop (fine hovering pointer, 48rem wide, motion allowed).
62
+ - The page ground — zon.sh's still grain behind everything, opt-in with `brand.css` (below).
63
+ - `Divider` — a hairline inside a column, optionally with a short mono label.
64
+
65
+ Spacing follows one rhythm: **4, 8, 12, 16, 24, 32, 48, 64, 96px**.
66
+
67
+ ## Examples
68
+
69
+ ### Grid layout
70
+
71
+ `span` is mobile-first; each breakpoint inherits the one before it.
72
+
73
+ ```tsx
74
+ import { Eyebrow, Grid, GridItem, Heading, Text } from "@zonsh/ui";
75
+
76
+ export function GridLayout() {
77
+ const cells = [
78
+ ["Line", "Confident strokes, one page at a time."],
79
+ ["Light", "Shading, shadow and form."],
80
+ ["Colour", "Mixing, harmony and restraint."],
81
+ ] as const;
82
+ return (
83
+ <Grid>
84
+ <GridItem span={{ base: 12, md: 4 }}>
85
+ <Eyebrow>Courses</Eyebrow>
86
+ </GridItem>
87
+ <GridItem span={{ base: 12, md: 8 }}>
88
+ <Heading level={3}>Three places to start if you are new to drawing.</Heading>
89
+ </GridItem>
90
+ {cells.map(([title, body]) => (
91
+ <GridItem key={title} span={{ base: 12, sm: 6, lg: 4 }} className="pt-6 hairline">
92
+ <Heading level={4}>{title}</Heading>
93
+ <Text tone="soft" size="sm" className="mt-2">
94
+ {body}
95
+ </Text>
96
+ </GridItem>
97
+ ))}
98
+ </Grid>
99
+ );
100
+ }
101
+ ```
102
+
103
+ ### Rails and marks
104
+
105
+ `Crosshairs` marks a square region's corners where its border meets the rails.
106
+
107
+ ```tsx
108
+ import { Crosshairs, Eyebrow, Heading, Rails, Text } from "@zonsh/ui";
109
+
110
+ export function RailsAndMarks() {
111
+ return (
112
+ <Rails className="@container w-full px-6 py-12 @2xl:px-12">
113
+ <div className="relative border border-field-edge p-8 @2xl:p-12">
114
+ <Crosshairs />
115
+ <Eyebrow>Plan · 01</Eyebrow>
116
+ <Heading level={3} className="mt-4">
117
+ A square region, marked at its corners.
118
+ </Heading>
119
+ <Text tone="soft" className="mt-3 max-w-[52ch]">
120
+ Crosshairs sit exactly on the corner intersections of a 1px border.
121
+ </Text>
122
+ </div>
123
+ </Rails>
124
+ );
125
+ }
126
+ ```
127
+
128
+ ### Marks
129
+
130
+ A `PlusMark` where an inner rule meets the border, offset -6px so its lines land on the rules.
131
+
132
+ ```tsx
133
+ import { Eyebrow, PlusMark, Text } from "@zonsh/ui";
134
+
135
+ export function Marks() {
136
+ return (
137
+ <div className="@container w-full">
138
+ <div className="relative grid border border-field-edge @xl:grid-cols-2">
139
+ <div className="p-8 @xl:border-r @xl:border-field-edge">
140
+ <Eyebrow>Before</Eyebrow>
141
+ <Text tone="soft" className="mt-3">
142
+ Bookings are scattered across emails, PDFs and screenshots.
143
+ </Text>
144
+ </div>
145
+ <div className="border-t border-field-edge p-8 @xl:border-t-0">
146
+ <Eyebrow>After</Eyebrow>
147
+ <Text tone="soft" className="mt-3">
148
+ Flights, stays and tickets sit in one itinerary, in order.
149
+ </Text>
150
+ </div>
151
+ <PlusMark className="-top-[6px] left-1/2 -ml-[6px] hidden @xl:block" />
152
+ <PlusMark className="-bottom-[6px] left-1/2 -ml-[6px] hidden @xl:block" />
153
+ </div>
154
+ </div>
155
+ );
156
+ }
157
+ ```
158
+
159
+ ### Blueprint hero
160
+
161
+ Touch and reduced-motion users see the grid static.
162
+
163
+ ```tsx
164
+ import { Blueprint, Container, Display, Eyebrow, Lead } from "@zonsh/ui";
165
+
166
+ export function BlueprintHero() {
167
+ return (
168
+ <Blueprint className="@container w-full overflow-hidden border border-field-edge">
169
+ <Container className="py-24 @3xl:py-32">
170
+ <Eyebrow>zon.sh</Eyebrow>
171
+ <Display className="mt-6 max-w-3xl">Less noise. More signal.</Display>
172
+ <Lead className="mt-6">Move a mouse across the grid: it lights up under the pointer.</Lead>
173
+ </Container>
174
+ </Blueprint>
175
+ );
176
+ }
177
+ ```
178
+
179
+ ### Textures
180
+
181
+ ```tsx
182
+ import { Blueprint, DotField, Grain } from "@zonsh/ui";
183
+
184
+ export function Textures() {
185
+ return (
186
+ <div className="@container w-full">
187
+ <div className="grid gap-6 @2xl:grid-cols-3">
188
+ <Blueprint cell={32} className="h-48 border border-field-edge" />
189
+ <DotField className="h-48 border border-field-edge" />
190
+ <div className="relative h-48 overflow-hidden border border-field-edge bg-background">
191
+ <Grain />
192
+ <span className="absolute bottom-4 left-4 eyebrow">Grain</span>
193
+ </div>
194
+ </div>
195
+ </div>
196
+ );
197
+ }
198
+ ```
199
+
200
+ ### Page ground
201
+
202
+ Without it the page is plain `--background`. The zon.sh ground is one line after `styles.css`:
203
+
204
+ ```css
205
+ @import "@zonsh/ui/styles.css";
206
+ @import "@zonsh/ui/brand.css";
207
+ ```
208
+
209
+ It gives `<body>` still Grain fixed to the viewport with a faint light from above (`--page-glow`), and the same in the bars on the ground (`surface-page`, `SiteHeader`, `BottomNav`). It sits beneath all content, so cards, fields and text stay clean. Keep page-level wrappers transparent — any `bg-background` between body and content covers it; overlays that replace the page keep their fill. Dark grounds blend with overlay and screen; light ones multiply at `--page-grain-opacity` (0.1). It never moves, so needs no reduced-motion fallback.
210
+
211
+ To drop the grain but keep the ground and its light:
212
+
213
+ ```css
214
+ body::before,
215
+ body::after {
216
+ content: none;
217
+ }
218
+ ```
219
+
220
+ ### Phone edges
221
+
222
+ A phone browser's status bar, toolbar and (on iPhone) the strip uncovered as the toolbar shrinks are not drawn by the page. With `brand.css` they match the ground:
223
+
224
+ - **The ground reaches past the window.** The ground (`html::before`) and its grain run a tenth of the window below the bottom edge; grain never extends past the ground under it.
225
+ - **The browser's bars take the page tone.** `--page-tone` is the ground as one flat colour (`#f9f9f9` light, `#141414` dark). `<html>` is painted in it (in `--background` without `brand.css`), and `themeScript` and `ThemeProvider` keep `<meta name="theme-color">` at it (`PAGE_TONE`, see Theme).
226
+ - **Edge to edge as a home-screen app.** On an iPhone home screen the page can draw under the status bar too, with two tags in `<head>`:
227
+
228
+ ```html
229
+ <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
230
+ <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent" />
231
+ ```
232
+
233
+ The page then runs under the notch and home indicator too. The library keeps clear: `Container` pads at least the side safe area, `SiteHeader` sits below the status bar, `Drawer` sheets and `Toaster` above the home indicator, `Lightbox` controls clear on every side. Add the inset to anything of your own pinned to an edge: `bottom: calc(1rem + env(safe-area-inset-bottom, 0px))` (0 without `viewport-fit=cover`).
234
+
235
+ ### Dividers
236
+
237
+ ```tsx
238
+ import { Divider, Text } from "@zonsh/ui";
239
+
240
+ export function Dividers() {
241
+ return (
242
+ <div className="flex max-w-xl flex-col gap-10">
243
+ <Text>Write a few lines every day; the habit matters more than the length.</Text>
244
+ <Divider />
245
+ <Text>Start from a blank page, or pick a template.</Text>
246
+ <Divider label="or" />
247
+ <Text>Import your notes from another app.</Text>
248
+ </div>
249
+ );
250
+ }
251
+ ```
252
+
253
+ ## Props
254
+
255
+ | Component | Prop | Type | Default |
256
+ | ----------- | ------------- | ----------------------------------------------------------- | ----------- |
257
+ | `Container` | `as` | `"div" \| "section" \| "main" \| "header" \| "footer" \| …` | `"div"` |
258
+ | `Section` | `label` | `ReactNode` — eyebrow label | — |
259
+ | `Section` | `index` | `number \| string` — numbers are zero-padded | — |
260
+ | `Section` | `last` | `boolean` — adds the closing bottom rule | `false` |
261
+ | `Section` | `as` | region tag | `"section"` |
262
+ | `GridItem` | `span` | `1–12 \| { base?, sm?, md?, lg? }` | `12` |
263
+ | `Rails` | `as` | region tag | `"div"` |
264
+ | `Blueprint` | `cell` | `number` (px) `\| string` — grid cell size | `64` |
265
+ | `Blueprint` | `interactive` | `boolean` — light the grid under the pointer | `true` |
266
+ | `Divider` | `label` | `ReactNode` — centred mono label | — |
267
+
268
+ Other HTML attributes are forwarded. `Blueprint` exposes `data-lit="true|false"` and the CSS variables `--mx`, `--my` (pointer position) and `--cell`. `Section` sets `data-last` when it closes a run.
269
+
270
+ ## Brand rules
271
+
272
+ - **Do** group with a hairline and whitespace first. Reach for a surface only when the thing could be picked up and moved on its own.
273
+ - **Do** keep to the spacing rhythm: 4, 8, 12, 16, 24, 32, 48, 64, 96.
274
+ - **Do** use one texture per composition: Blueprint _or_ DotField _or_ Grain. The page ground is not a composition's texture, so it sits under any of them.
275
+ - **Don't** nest `Container`s; the gutters double.
276
+ - **Don't** paint a flat `bg-background` at the page's edges, or pin something to an edge without its safe-area inset: the browser's bars and the uncovered strip are the ground's colour, and on a home-screen app the status bar and home indicator sit over the page.
277
+ - **Don't** put `Crosshairs` on rounded cards. They mark the corners of square regions.
278
+ - **Don't** scatter `PlusMark`s as ornament. A mark sits where two lines meet.
279
+ - **Don't** set reading text over the lit area of a Blueprint or over moving Grain. The still page ground is made to sit under text.
280
+
281
+ ## Accessibility
282
+
283
+ - `PlusMark`, `Crosshairs`, `Grain`, and `DotField` / `Blueprint` without children are `aria-hidden` and `pointer-events: none`.
284
+ - The pointer light runs only for hover-capable fine pointers with `prefers-reduced-motion: no-preference`; Grain stops animating under reduced motion.
285
+ - `Divider` without a label is a `role="separator"`. With a label, the rules are hidden and the label is read as text.
286
+ - `Section` is a `<section>`. Give it an accessible name (`aria-labelledby` pointing at its heading) when it should appear as a landmark.
287
+
288
+ ---
289
+
290
+ - Import: `import { Container, Section, Grid, GridItem, Rails, PlusMark, Crosshairs, Blueprint } from "@zonsh/ui"`
291
+ - Source: `packages/ui/src/components/layout.tsx`