@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,497 @@
1
+ # Illustrations
2
+
3
+ Every illustration zon uses, in one library: each entry has an id, a meaning and tags, ships as static SVG where it is a vector, and renders inline with one component that follows the theme. Isometric figures answer the pointer. The studio above browses them all (arrow keys step) and downloads their files.
4
+
5
+ ## Usage
6
+
7
+ ```tsx
8
+ import { Illustration } from "@zonsh/ui/illustration";
9
+
10
+ <Illustration name="iso/automation" className="w-64" />
11
+ <Illustration name="iso/brackets" title="The zon mark" />
12
+ <Illustration name="drawing/horizon" className="absolute inset-x-0 bottom-0 h-1/2" />
13
+ <div className="size-48"><Illustration name="editorial/automation" /></div>
14
+ ```
15
+
16
+ - `name` — the entry's id, typed.
17
+ - `title` — an accessible name when the picture carries meaning; omit it for decoration.
18
+ - `className` — width for figures and drawings; sheets and editorial images fill the parent.
19
+
20
+ It is its own entry, `@zonsh/ui/illustration`, so an app that never imports it carries none of its files. Importing it takes the whole library (each figure as its own chunk, the editorial images, the metadata). **For one or two drawings, import from `@zonsh/ui/drawing`** ([Drawing](drawing.md)): `<DrawingHorizon />` adds a few kilobytes and nothing else.
21
+
22
+ ```tsx
23
+ import { DrawingHorizon } from "@zonsh/ui/drawing";
24
+
25
+ <DrawingHorizon className="pointer-events-none absolute inset-x-0 bottom-0 aspect-[2/1] h-auto w-full" />;
26
+
27
+ // Static files, for slides, documents and other sites
28
+ <img src="/illustrations/iso/server.svg" alt="" /> // copied from @zonsh/ui/assets/illustrations/
29
+ ```
30
+
31
+ `illustrations` lists every entry (`id`, `kind`, `title`, `meaning`, `tags`, `variants`, `motion`, `files`) for galleries, pickers and agents.
32
+
33
+ ## The library
34
+
35
+ Ids are `<kind>/<name>`, kebab-case, named for what is drawn; what it _means_ is metadata.
36
+
37
+ | Kind | Ids | What it is |
38
+ | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
39
+ | `iso` | `brackets` `brackets-classic` `server` `database` `laptop` `monitor` `documents` `spreadsheet` `conveyor` `bar-chart` `inbox` `platform` `automation` `pipeline` `timeline` `city` | Line figures in isometric that answer the pointer: one hairline stroke, rounded solids, one bright edge. |
40
+ | `drawing` | `eclipse` `crescent` `horizon` `nib-study` `elevation-guides` `bracket-construction` | Monochrome constructions from the light table. Ink in `currentColor`, knock out with `--background`. |
41
+ | `sheet` | `totality` `stress-axis` `crescent` `vertical-metrics` `limb` `construction` | A drawing pinned to a night or paper spec sheet with mono captions, crosshairs and a title block. |
42
+ | `editorial` | `problem` `automation` `custom-software` `assistant` `integration` `digitalization` `process-discovery` `process-analysis` `process-concept` `process-prototype` `process-development` `process-testing` `process-maintenance` `bracket-left` `bracket-right` | The black line-art raster images shared with zon.sh, shipped as webp (1254px with a 640px companion; the two brackets are tall, 975px high with a 640px-high companion) and inverted in dark mode. |
43
+
44
+ ## When to use
45
+
46
+ - **Pick by meaning, not looks** (`illustrations[].meaning`), beside the sentence it illustrates.
47
+ - **`iso/…`** on product and marketing surfaces: features, empty states, a 404. They are one family with the editorial line art.
48
+ - **`drawing/…`** for brand and craft moments: covers, about pages, closing sections. `drawing/horizon` grounds a closing call to action; in a footer the legal row sits under it (the night footer in `marketing.md`).
49
+ - **`sheet/…`** when the drawing is the subject: a specimen, a study, a cover.
50
+ - **`editorial/…`** for section openers, steps in a sequence, article headers. `editorial/bracket-left` and `-right` are the hand-drawn mark, cropped to one height: set them apart with the wordmark between (the zon.sh footer). Size them by height; never stretch one alone.
51
+ - Not as icons (`lucide-react`) or the logo (`Logo`); `drawing/bracket-construction` is a drawing _of_ the mark.
52
+
53
+ ## Examples
54
+
55
+ ### Browse
56
+
57
+ A carousel by kind; arrow keys work while it has focus.
58
+
59
+ ```tsx
60
+ import { Button, Tag, ToggleGroup, ToggleGroupItem } from "@zonsh/ui";
61
+ import { Illustration, illustrationKinds, illustrations, type IllustrationInfo } from "@zonsh/ui/illustration";
62
+ import { Carousel, CarouselContent, CarouselDots, CarouselItem, CarouselNext, CarouselPrevious } from "@zonsh/ui/carousel";
63
+ import { ArrowUpRightIcon, DownloadIcon } from "lucide-react";
64
+ import { useState } from "react";
65
+
66
+ /**
67
+ * Where the docs site serves the static files (`@zonsh/ui/assets/illustrations/` in the package), the
68
+ * editorial images among them: an entry's `src` is a `file:` URL on a server no bundler built.
69
+ */
70
+ const FILES = `${import.meta.env.BASE_URL}illustrations/`;
71
+
72
+ type KindFilter = "all" | IllustrationInfo["kind"];
73
+
74
+ function KindFilter({ value, onChange }: { value: KindFilter; onChange: (kind: KindFilter) => void }) {
75
+ return (
76
+ <ToggleGroup
77
+ aria-label="Kind"
78
+ value={[value]}
79
+ onValueChange={(v) => onChange((v[0] ?? "all") as KindFilter)}
80
+ className="max-w-full overflow-x-auto"
81
+ >
82
+ <ToggleGroupItem value="all">All</ToggleGroupItem>
83
+ {illustrationKinds.map((k) => (
84
+ <ToggleGroupItem key={k.id} value={k.id}>
85
+ {k.title}
86
+ </ToggleGroupItem>
87
+ ))}
88
+ </ToggleGroup>
89
+ );
90
+ }
91
+
92
+ /** Every entry in the same 4:3 box: drawings float in it, fixed-ratio sheets and images fit it. */
93
+ function Art({ entry }: { entry: IllustrationInfo }) {
94
+ const fit = entry.aspect ? (entry.aspect >= 4 / 3 ? "w-full" : "h-full w-auto") : "max-h-full";
95
+ return (
96
+ <div className={`flex aspect-[4/3] w-full items-center justify-center ${entry.aspect ? "" : "p-[8%]"}`}>
97
+ <Illustration name={entry.id} priority className={entry.id === "drawing/horizon" ? "h-full" : fit} />
98
+ </div>
99
+ );
100
+ }
101
+
102
+ function EntryInfo({ entry }: { entry: IllustrationInfo }) {
103
+ return (
104
+ <div className="flex min-w-0 flex-col gap-4">
105
+ <div className="flex flex-col gap-1.5">
106
+ <p className="eyebrow">{illustrationKinds.find((k) => k.id === entry.kind)?.title}</p>
107
+ <h3 className="display text-[28px]">{entry.title}</h3>
108
+ <code className="font-mono text-[13px] text-foreground-soft">{`<Illustration name="${entry.id}" />`}</code>
109
+ </div>
110
+ <p className="text-foreground-soft">{entry.meaning}</p>
111
+ <dl className="grid grid-cols-[6rem_minmax(0,1fr)] gap-x-4 gap-y-2 border-t border-border/60 pt-4 text-sm">
112
+ <dt className="font-mono text-xs text-muted-foreground uppercase">Variants</dt>
113
+ <dd className="m-0 font-mono text-[13px]">{entry.variants.join(" · ")}</dd>
114
+ <dt className="font-mono text-xs text-muted-foreground uppercase">Motion</dt>
115
+ <dd className="m-0">{entry.motion ?? "Static"}</dd>
116
+ <dt className="font-mono text-xs text-muted-foreground uppercase">Tags</dt>
117
+ <dd className="m-0 flex flex-wrap gap-1.5">
118
+ {entry.tags.map((t) => (
119
+ <Tag key={t} variant="muted">
120
+ {t}
121
+ </Tag>
122
+ ))}
123
+ </dd>
124
+ </dl>
125
+ <div className="flex flex-wrap gap-2">
126
+ {entry.files.map((f) => (
127
+ <Button
128
+ key={f.path}
129
+ size="sm"
130
+ variant="secondary"
131
+ nativeButton={false}
132
+ render={<a href={FILES + f.path} download aria-label={`Download ${f.path}`} />}
133
+ >
134
+ <DownloadIcon />
135
+ {f.path.split("/").pop()}
136
+ </Button>
137
+ ))}
138
+ {entry.src ? (
139
+ <Button
140
+ size="sm"
141
+ variant="secondary"
142
+ nativeButton={false}
143
+ render={<a href={`${FILES}editorial/${entry.name}.webp`} />}
144
+ >
145
+ Open on zon.sh
146
+ <ArrowUpRightIcon className="rtl:-scale-x-100" />
147
+ </Button>
148
+ ) : null}
149
+ </div>
150
+ </div>
151
+ );
152
+ }
153
+
154
+ /* ── Studio ─────────────────────────────────────────────────────────────────── */
155
+
156
+ export function Browse() {
157
+ const [kind, setKind] = useState<KindFilter>("all");
158
+ const shown = illustrations.filter((e) => kind === "all" || e.kind === kind);
159
+
160
+ return (
161
+ <div className="@container flex w-full max-w-4xl flex-col gap-6">
162
+ <KindFilter value={kind} onChange={setKind} />
163
+ <Carousel key={kind} aria-label="Illustration library" className="w-full">
164
+ <CarouselContent>
165
+ {shown.map((e) => (
166
+ <CarouselItem key={e.id} aria-label={e.title}>
167
+ <div className="grid items-center gap-8 @2xl:grid-cols-[minmax(0,1.1fr)_minmax(0,1fr)]">
168
+ <Art entry={e} />
169
+ <EntryInfo entry={e} />
170
+ </div>
171
+ </CarouselItem>
172
+ ))}
173
+ </CarouselContent>
174
+ <div className="flex items-center justify-between gap-4 border-t border-border/60 pt-4">
175
+ <CarouselDots variant="index" />
176
+ <div className="flex gap-2">
177
+ <CarouselPrevious />
178
+ <CarouselNext />
179
+ </div>
180
+ </div>
181
+ </Carousel>
182
+ </div>
183
+ );
184
+ }
185
+ ```
186
+
187
+ ### Variants
188
+
189
+ The first is the default. Drawings have `guides`, `plain`, `filled`; isometric figures have one look.
190
+
191
+ ```tsx
192
+ import { Illustration } from "@zonsh/ui/illustration";
193
+
194
+ export function Variants() {
195
+ const pairs = [
196
+ ["drawing/eclipse", "default"],
197
+ ["drawing/eclipse", "guides"],
198
+ ["drawing/bracket-construction", "default"],
199
+ ["drawing/bracket-construction", "filled"],
200
+ ] as const;
201
+ return (
202
+ <div className="@container w-full">
203
+ <div className="grid w-full grid-cols-2 gap-x-6 gap-y-8 @lg:grid-cols-3">
204
+ {pairs.map(([name, variant]) => (
205
+ <figure key={name + variant} className="m-0 flex flex-col items-center gap-3">
206
+ <div className="flex aspect-square w-full items-center justify-center p-4">
207
+ <Illustration name={name} variant={variant} className="max-h-full" />
208
+ </div>
209
+ <figcaption className="font-mono text-[11px] text-muted-foreground">
210
+ {name} · {variant}
211
+ </figcaption>
212
+ </figure>
213
+ ))}
214
+ </div>
215
+ </div>
216
+ );
217
+ }
218
+ ```
219
+
220
+ ### Light and dark
221
+
222
+ Figures draw with `--fig-*` (from `--foreground` and `--background`), drawings ink with `currentColor`, editorial images invert — all following the nearest theme, `.theme-dark` regions included.
223
+
224
+ ```tsx
225
+ import { Illustration } from "@zonsh/ui/illustration";
226
+
227
+ export function Themes() {
228
+ return (
229
+ <div className="@container w-full">
230
+ <div className="grid w-full gap-4 @xl:grid-cols-2">
231
+ {(["theme-light", "theme-dark"] as const).map((theme) => (
232
+ <div
233
+ key={theme}
234
+ className={`${theme} grid grid-cols-3 items-center gap-4 border border-field-edge bg-background p-6 text-foreground`}
235
+ >
236
+ <Illustration name="iso/server" />
237
+ <Illustration name="drawing/crescent" />
238
+ <Illustration name="editorial/integration" priority />
239
+ </div>
240
+ ))}
241
+ </div>
242
+ </div>
243
+ );
244
+ }
245
+ ```
246
+
247
+ ### Hover to play
248
+
249
+ `data-iso-trigger` on any ancestor (a link, a card) makes the figure read the pointer anywhere over it.
250
+
251
+ ```tsx
252
+ import { Illustration } from "@zonsh/ui/illustration";
253
+ import { ArrowRightIcon } from "lucide-react";
254
+
255
+ export function HoverCards() {
256
+ const items = [
257
+ { name: "iso/conveyor", title: "Fulfilment", body: "Every order picked, packed and sent in turn." },
258
+ { name: "iso/automation", title: "Builds", body: "Each push runs through the same checks." },
259
+ { name: "iso/laptop", title: "Workspace", body: "Notes, files and projects in one place." },
260
+ ] as const;
261
+ return (
262
+ <div className="@container w-full">
263
+ <div className="grid w-full gap-6 @2xl:grid-cols-3">
264
+ {items.map((it) => (
265
+ <a
266
+ key={it.title}
267
+ href="#features"
268
+ data-iso-trigger
269
+ className="group flex flex-col gap-4 border-t border-border/70 pt-6 focus-ring"
270
+ >
271
+ <div className="flex h-44 items-center justify-center">
272
+ <Illustration name={it.name} className="max-h-full" />
273
+ </div>
274
+ <p className="font-medium">{it.title}</p>
275
+ <p className="text-sm text-foreground-soft">{it.body}</p>
276
+ <span className="flex items-center gap-1.5 font-mono text-xs text-muted-foreground transition-colors group-hover:text-foreground">
277
+ Explore
278
+ <ArrowRightIcon className="size-3.5 transition-transform group-hover:translate-x-0.5 rtl:-scale-x-100 rtl:group-hover:-translate-x-0.5" />
279
+ </span>
280
+ </a>
281
+ ))}
282
+ </div>
283
+ </div>
284
+ );
285
+ }
286
+ ```
287
+
288
+ ### In context
289
+
290
+ ```tsx
291
+ import { Button } from "@zonsh/ui";
292
+ import { Illustration } from "@zonsh/ui/illustration";
293
+ import { ArrowRightIcon } from "lucide-react";
294
+
295
+ export function InContext() {
296
+ return (
297
+ <div className="@container w-full">
298
+ <section className="grid w-full items-center gap-10 @3xl:grid-cols-[1fr_1.1fr]">
299
+ <div className="flex flex-col gap-5">
300
+ <p className="eyebrow">Workspace</p>
301
+ <h3 className="display text-[36px] @xl:text-[44px]">
302
+ <span className="block">Everything you are working on,</span>
303
+ <span className="block text-muted-foreground">in one place.</span>
304
+ </h3>
305
+ <p className="max-w-[36ch] text-foreground-soft">
306
+ Notes, files and projects side by side, on whichever device is closest.
307
+ </p>
308
+ <div>
309
+ <Button variant="secondary">
310
+ Take the tour
311
+ <ArrowRightIcon className="rtl:-scale-x-100" />
312
+ </Button>
313
+ </div>
314
+ </div>
315
+ <Illustration
316
+ name="iso/laptop"
317
+ title="An open laptop showing a dashboard"
318
+ className="mx-auto max-w-md"
319
+ />
320
+ </section>
321
+ </div>
322
+ );
323
+ }
324
+ ```
325
+
326
+ ### Editorial line art
327
+
328
+ The image fills its box with `object-contain` and 6% breathing room, so size the parent.
329
+
330
+ ```tsx
331
+ import { Illustration } from "@zonsh/ui/illustration";
332
+
333
+ export function EditorialRow() {
334
+ return (
335
+ <div className="@container w-full max-w-2xl">
336
+ <article className="relative w-full overflow-hidden border-y border-border/70 py-8 pr-36 @xl:pr-48">
337
+ <div className="absolute top-4 right-0 size-32 @xl:size-44">
338
+ <Illustration name="editorial/automation" priority />
339
+ </div>
340
+ <p className="eyebrow">01</p>
341
+ <h3 className="mt-3 display text-[28px]">Routines that run themselves</h3>
342
+ <p className="mt-3 max-w-[40ch] text-foreground-soft">
343
+ Set up a weekly backup or a monthly export once, and it runs on schedule while you get on with the
344
+ day.
345
+ </p>
346
+ </article>
347
+ </div>
348
+ );
349
+ }
350
+ ```
351
+
352
+ ### Light table
353
+
354
+ `SpecSheet` frames the `sheet/…` entries; `SpecSheetGrid` is a 12-column bento of square cells, each sheet spanning `c` × `r`. A sheet has no width of its own.
355
+
356
+ ```tsx
357
+ import { Illustration, SpecSheet, SpecSheetGrid } from "@zonsh/ui/illustration";
358
+
359
+ export function LightTable() {
360
+ return (
361
+ <SpecSheetGrid>
362
+ <SpecSheet tone="night" c={7} r={5} index="05.1" eyebrow="The o, at totality" lit marks>
363
+ <Illustration name="drawing/eclipse" />
364
+ </SpecSheet>
365
+ <SpecSheet tone="paper" c={5} r={5} index="05.2" eyebrow="Stress axis 14°" lit>
366
+ <Illustration name="drawing/nib-study" />
367
+ </SpecSheet>
368
+ <SpecSheet tone="night" c={4} r={4} index="05.3" eyebrow="Crescent" lit>
369
+ <Illustration name="drawing/crescent" />
370
+ </SpecSheet>
371
+ <SpecSheet tone="paper" c={8} r={4} index="05.4" eyebrow="Vertical metrics" lit>
372
+ <Illustration name="drawing/elevation-guides" />
373
+ </SpecSheet>
374
+ <SpecSheet tone="night" c={12} r={3} index="05.5" eyebrow="Limb" drawingClassName="p-0">
375
+ <Illustration name="drawing/horizon" className="h-full" />
376
+ </SpecSheet>
377
+ </SpecSheetGrid>
378
+ );
379
+ }
380
+ ```
381
+
382
+ ### Static and active
383
+
384
+ `animate={false}` keeps a figure still at rest (print, PDFs, screenshots); `active` holds the pointer over its centre, for a parent that controls emphasis, like a selected step.
385
+
386
+ ```tsx
387
+ import { Illustration } from "@zonsh/ui/illustration";
388
+
389
+ export function StaticAndActive() {
390
+ return (
391
+ <div className="grid w-full grid-cols-3 items-center gap-6">
392
+ <Illustration name="iso/bar-chart" animate={false} />
393
+ <Illustration name="iso/database" animate={false} />
394
+ <Illustration name="iso/server" active />
395
+ </div>
396
+ );
397
+ }
398
+ ```
399
+
400
+ ## Motion
401
+
402
+ Only `iso/…` entries move. They are instruments, not animations: they answer the pointer on their drawn parts and return to a drawn rest pose when it leaves, 140ms later so an edge doesn't flicker.
403
+
404
+ - **By distance.** The pointer is projected onto the ground or read against fixed bands (a unit's height, a column's place); parts answer through a falloff of 1, .31 at 42% of the reach, .09 at its edge. Hit areas never move.
405
+ - **Two clocks.** A spring (k 100, c 18) follows the pointer; a 700ms `cubic-bezier(.32, .72, 0, 1)` settles the chosen part, staggered 30–60ms outward.
406
+ - **One bright edge**, the only highlight: at rest it marks where to look, then moves to what the pointer chooses.
407
+ - **Drawn with less.** Each solid is the hull of two rounded rings — silhouette and one dim crease — with plates in the page colour. No words inside a figure.
408
+ - **Cheap.** Code loads with the first figure; one shared frame loop runs only while something moves on screen. Under reduced motion they answer without easing.
409
+
410
+ | Figure | How it answers |
411
+ | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
412
+ | `iso/brackets` | As the pointer comes near, the arms drop onto the plinth, one after the other; they rise back when it leaves |
413
+ | `iso/brackets-classic` | The first, solid mark: ink brackets on a white plinth; on hover they open apart like the website logo |
414
+ | `iso/server` | The pointer's height pulls a unit out; above the rack it lifts the lid and the fans spin |
415
+ | `iso/database` | The pointer's height opens the stack at that level |
416
+ | `iso/laptop` | The pointer's height sets the lid on its hinge |
417
+ | `iso/monitor` | A cursor follows the pointer across the chart |
418
+ | `iso/documents` | The top page lifts and the signature writes itself as far as the pointer moves across |
419
+ | `iso/spreadsheet` | Cells near the pointer rise; at the loose cell it settles back into place |
420
+ | `iso/conveyor` | Runs on its own: the press stamps the mark on each crate |
421
+ | `iso/bar-chart` | The pointer brushes the columns; click adds a block, right-click takes one |
422
+ | `iso/inbox` | The pointer's height opens the flap; the letter slides out |
423
+ | `iso/platform` | Modules near the pointer rise; click a tile to plug one in (it drops in) or take it out (it lifts away and fades) |
424
+ | `iso/automation` | Pulses run to each step, which lights up as one lands — it fills, hops and sends out a ripple; the nearest step rises and streams |
425
+ | `iso/pipeline` | Runs on its own: blocks flow and get processed, the dashboard takes each reading |
426
+ | `iso/timeline` | The pointer picks a step; it rises and the marker travels there |
427
+ | `iso/city` | The nearest building rises and pulses run to the systems it talks to |
428
+
429
+ On a surface other than `--background`, set `--fig-plate` to its colour so plates stay opaque. Drawings, sheets and editorial images are still by design.
430
+
431
+ ## Static files
432
+
433
+ `pnpm agents` (via `pnpm illustrations`) exports every vector entry to `packages/ui/assets/illustrations/<kind>/<name>[-<variant>][-dark].svg`, also served by this site at `/illustrations/…`:
434
+
435
+ | File | Look |
436
+ | --------------------------- | --------------------------------------------------------------------------------- |
437
+ | `iso/server.svg` | Default variant, for light backgrounds |
438
+ | `iso/server-dark.svg` | Default variant, for dark backgrounds |
439
+ | `sheet/totality.svg` | Sheets keep their own night or paper ground, so they have one file each |
440
+ | `editorial/automation.webp` | The raster line art at 1254px; `automation-640.webp` beside it serves 1x displays |
441
+
442
+ Isometric SVGs carry their ambient motion as CSS, so they move in an `<img>` (not under reduced motion); hover and entrance motion need the component. Text in drawings and sheets is Licht Mono and Licht with fallbacks. Editorial files are kept by hand in `assets/illustrations/editorial/` — the same files zon.sh shows.
443
+
444
+ ### Adding an entry
445
+
446
+ In `packages/ui/src/lib/`: a figure in `figure/figures/` on the kernel (`figure/kernel.ts` lists the ten rules every figure follows), listed in `figure/catalog.ts`, or a drawing function in `illustration-drawings.ts`. Add it to `illustration-library.ts` with id, title, meaning and tags and run `pnpm agents`; everything else picks it up.
447
+
448
+ ## Props
449
+
450
+ ### Illustration
451
+
452
+ | Prop | Type | Default |
453
+ | -------------------- | -------------------------------------------------------------------------------------- | ----------------- |
454
+ | `name` | `IllustrationName`: every id, e.g. `"iso/server"`, `"drawing/eclipse"`, `"sheet/limb"` | — |
455
+ | `variant` | the entry's variants: drawings `"default"` plus their own | the first variant |
456
+ | `title` | `string`: accessible name; omit for decorative use (`aria-hidden`) | — |
457
+ | `animate` | `boolean`: iso only; `false` draws the rest pose and keeps it still | `true` |
458
+ | `active` | `boolean`: iso only; hold the pointer over the figure's centre | — |
459
+ | `priority` | `boolean`: editorial only; load eagerly with high priority instead of lazily | `false` |
460
+ | `className`, `style` | on the root (`<svg>`, the sheet's `<figure>` or the `<img>`) | — |
461
+
462
+ Figures and drawings take the parent's width and their own height; sheets and editorial images fill the parent's width.
463
+
464
+ ### SpecSheet
465
+
466
+ | Prop | Type | Default |
467
+ | ------------------ | ----------------------------------------------- | ------------------ |
468
+ | `tone` | `"night" \| "paper"`; neither follows the theme | `"night"` |
469
+ | `index`, `eyebrow` | mono captions, top left and top right | — |
470
+ | `titleBlock` | `{ label, value }[]`, bottom right | — |
471
+ | `marks` | corner crosshairs | `false` |
472
+ | `grain` | still film grain | `tone === "night"` |
473
+ | `lit` | light-table highlight that follows the pointer | `false` |
474
+ | `c`, `r` | columns × rows inside `SpecSheetGrid` | 6 × 4 |
475
+ | `drawingClassName` | classes for the drawing area (`p-0` to bleed) | — |
476
+
477
+ ## Brand rules
478
+
479
+ - **Do** pick the entry whose meaning matches the copy beside it; one illustration per idea.
480
+ - **Do** keep one illustrated object per composition, with generous space around it.
481
+ - **Do** add new illustrations to the library, never as a one-off component or a file in an app.
482
+ - **Don't** recolour anything or add status or category colours: colour would read as meaning they do not carry.
483
+ - **Don't** scale isometric figures below ~240px wide; their silhouettes stop reading.
484
+ - **Don't** put several animated objects side by side: ambient motion is for one focal point.
485
+ - **Don't** give a sheet a radius, a shadow or the card material: it is pinned to the wall, not lifted off it.
486
+ - Never redraw the brackets: `iso/brackets` and `drawing/bracket-construction` use the logo's exact geometry.
487
+
488
+ ## Accessibility
489
+
490
+ - Decorative by default: `aria-hidden` (editorial images get `alt=""`). Pass `title` when the illustration carries meaning the text doesn't.
491
+ - Isometric figures with a `title` are named images. Under `prefers-reduced-motion` they still answer the pointer, without easing; nothing essential depends on them.
492
+ - Sheets keep their captions as real text in a `<figure>`; the drawing inside stays decorative.
493
+
494
+ ---
495
+
496
+ - Import: `import { Illustration, illustrations, illustrationKinds, SpecSheet, SpecSheetGrid } from "@zonsh/ui/illustration"`
497
+ - Source: `packages/ui/src/components/illustration.tsx`