@zonsh/ui 0.5.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (559) hide show
  1. package/CHANGELOG.md +639 -0
  2. package/README.md +49 -21
  3. package/dist/brand.d.ts +3 -0
  4. package/dist/brand.js +7 -0
  5. package/dist/components/_breadcrumb-more.d.ts +6 -0
  6. package/dist/components/_breadcrumb-more.js +5 -0
  7. package/dist/components/_drawing-svg.d.ts +11 -0
  8. package/dist/components/_drawing-svg.js +30 -0
  9. package/dist/components/_media.d.ts +159 -0
  10. package/dist/components/_media.js +266 -0
  11. package/dist/components/_overlay.d.ts +8 -5
  12. package/dist/components/_overlay.js +11 -6
  13. package/dist/components/_scheduler-calendar.d.ts +71 -0
  14. package/dist/components/_scheduler-calendar.js +940 -0
  15. package/dist/components/_scheduler-editor.d.ts +29 -0
  16. package/dist/components/_scheduler-editor.js +111 -0
  17. package/dist/components/_scheduler-menu.d.ts +16 -0
  18. package/dist/components/_scheduler-menu.js +18 -0
  19. package/dist/components/_scheduler-parts.d.ts +164 -0
  20. package/dist/components/_scheduler-parts.js +327 -0
  21. package/dist/components/_suggest-list.d.ts +142 -0
  22. package/dist/components/_suggest-list.js +159 -0
  23. package/dist/components/_toolbar-more.d.ts +24 -0
  24. package/dist/components/_toolbar-more.js +25 -0
  25. package/dist/components/accordion.d.ts +1 -1
  26. package/dist/components/accordion.js +6 -6
  27. package/dist/components/action-sheet.d.ts +88 -0
  28. package/dist/components/action-sheet.js +124 -0
  29. package/dist/components/alert-dialog.js +3 -1
  30. package/dist/components/alert.d.ts +11 -18
  31. package/dist/components/alert.js +9 -6
  32. package/dist/components/app-bar.d.ts +93 -0
  33. package/dist/components/app-bar.js +175 -0
  34. package/dist/components/audio-player.d.ts +134 -0
  35. package/dist/components/audio-player.js +618 -0
  36. package/dist/components/avatar.d.ts +6 -6
  37. package/dist/components/avatar.js +13 -11
  38. package/dist/components/badge.d.ts +12 -12
  39. package/dist/components/badge.js +7 -5
  40. package/dist/components/bottom-nav.d.ts +53 -11
  41. package/dist/components/bottom-nav.js +388 -23
  42. package/dist/components/breadcrumb.d.ts +11 -2
  43. package/dist/components/breadcrumb.js +60 -6
  44. package/dist/components/button-group.js +5 -1
  45. package/dist/components/button.d.ts +23 -6
  46. package/dist/components/button.js +63 -7
  47. package/dist/components/calendar.js +8 -6
  48. package/dist/components/card.d.ts +10 -8
  49. package/dist/components/card.js +15 -14
  50. package/dist/components/carousel.d.ts +2 -2
  51. package/dist/components/carousel.js +21 -8
  52. package/dist/components/chart.d.ts +27 -1
  53. package/dist/components/chart.js +15 -5
  54. package/dist/components/checkbox.js +2 -2
  55. package/dist/components/code-block.d.ts +9 -2
  56. package/dist/components/code-block.js +26 -7
  57. package/dist/components/collapsible.js +3 -3
  58. package/dist/components/color-picker.d.ts +2 -2
  59. package/dist/components/color-picker.js +5 -5
  60. package/dist/components/combobox.d.ts +26 -7
  61. package/dist/components/combobox.js +32 -13
  62. package/dist/components/command.d.ts +29 -5
  63. package/dist/components/command.js +35 -10
  64. package/dist/components/context-menu.d.ts +5 -2
  65. package/dist/components/context-menu.js +24 -3
  66. package/dist/components/conversation.d.ts +1 -1
  67. package/dist/components/conversation.js +67 -13
  68. package/dist/components/copy-button.d.ts +1 -1
  69. package/dist/components/copy-button.js +1 -1
  70. package/dist/components/data-table.d.ts +6 -6
  71. package/dist/components/data-table.js +41 -15
  72. package/dist/components/date-picker.d.ts +31 -9
  73. package/dist/components/date-picker.js +100 -18
  74. package/dist/components/dialog.d.ts +17 -10
  75. package/dist/components/dialog.js +20 -13
  76. package/dist/components/drawer.d.ts +26 -8
  77. package/dist/components/drawer.js +75 -16
  78. package/dist/components/drawing.d.ts +25 -0
  79. package/dist/components/drawing.js +32 -0
  80. package/dist/components/empty.js +2 -2
  81. package/dist/components/feature-list.d.ts +65 -13
  82. package/dist/components/feature-list.js +116 -15
  83. package/dist/components/field.js +2 -2
  84. package/dist/components/file-drop.d.ts +9 -7
  85. package/dist/components/file-drop.js +8 -43
  86. package/dist/components/filter-bar.d.ts +10 -9
  87. package/dist/components/filter-bar.js +42 -25
  88. package/dist/components/graph.d.ts +19 -3
  89. package/dist/components/graph.js +170 -25
  90. package/dist/components/illustration.js +3 -28
  91. package/dist/components/input-group.d.ts +5 -10
  92. package/dist/components/input-group.js +16 -16
  93. package/dist/components/input.d.ts +2 -2
  94. package/dist/components/input.js +3 -3
  95. package/dist/components/item.d.ts +9 -6
  96. package/dist/components/item.js +13 -8
  97. package/dist/components/kbd.d.ts +1 -1
  98. package/dist/components/kbd.js +1 -1
  99. package/dist/components/lightbox.d.ts +76 -9
  100. package/dist/components/lightbox.js +333 -45
  101. package/dist/components/locale.d.ts +6 -6
  102. package/dist/components/logo.d.ts +21 -1
  103. package/dist/components/logo.js +32 -2
  104. package/dist/components/markdown-editor.d.ts +275 -0
  105. package/dist/components/markdown-editor.js +831 -0
  106. package/dist/components/mentions.d.ts +153 -0
  107. package/dist/components/mentions.js +507 -0
  108. package/dist/components/menu.d.ts +2 -1
  109. package/dist/components/menu.js +5 -4
  110. package/dist/components/menubar.d.ts +23 -5
  111. package/dist/components/menubar.js +97 -22
  112. package/dist/components/message.d.ts +62 -11
  113. package/dist/components/message.js +49 -13
  114. package/dist/components/meter.js +1 -1
  115. package/dist/components/money-input.d.ts +1 -1
  116. package/dist/components/money-input.js +1 -1
  117. package/dist/components/native-select.d.ts +2 -2
  118. package/dist/components/native-select.js +4 -4
  119. package/dist/components/navigation-menu.d.ts +3 -1
  120. package/dist/components/navigation-menu.js +23 -12
  121. package/dist/components/number-field.d.ts +2 -9
  122. package/dist/components/number-field.js +86 -36
  123. package/dist/components/number-roll.d.ts +26 -0
  124. package/dist/components/number-roll.js +81 -0
  125. package/dist/components/otp-field.d.ts +1 -1
  126. package/dist/components/otp-field.js +24 -3
  127. package/dist/components/pagination.d.ts +11 -3
  128. package/dist/components/pagination.js +59 -13
  129. package/dist/components/pdf-viewer.d.ts +1 -1
  130. package/dist/components/pdf-viewer.js +8 -8
  131. package/dist/components/phone-input.d.ts +1 -1
  132. package/dist/components/phone-input.js +2 -2
  133. package/dist/components/popover.js +5 -3
  134. package/dist/components/preview-card.d.ts +37 -2
  135. package/dist/components/preview-card.js +226 -2
  136. package/dist/components/progress.js +1 -1
  137. package/dist/components/prompt-input.d.ts +1 -1
  138. package/dist/components/prompt-input.js +24 -14
  139. package/dist/components/pull-to-refresh.d.ts +50 -0
  140. package/dist/components/pull-to-refresh.js +189 -0
  141. package/dist/components/quote.d.ts +6 -1
  142. package/dist/components/quote.js +3 -2
  143. package/dist/components/radio-group.js +1 -1
  144. package/dist/components/rating.d.ts +4 -1
  145. package/dist/components/rating.js +131 -10
  146. package/dist/components/reasoning.d.ts +1 -1
  147. package/dist/components/reasoning.js +7 -3
  148. package/dist/components/resizable.d.ts +1 -1
  149. package/dist/components/resizable.js +2 -2
  150. package/dist/components/response.d.ts +1 -1
  151. package/dist/components/response.js +18 -6
  152. package/dist/components/scheduler.d.ts +352 -0
  153. package/dist/components/scheduler.js +1717 -0
  154. package/dist/components/scroll-area.js +1 -1
  155. package/dist/components/select.d.ts +17 -4
  156. package/dist/components/select.js +140 -9
  157. package/dist/components/separator.d.ts +1 -1
  158. package/dist/components/separator.js +3 -3
  159. package/dist/components/sidebar.d.ts +44 -3
  160. package/dist/components/sidebar.js +57 -17
  161. package/dist/components/site-header.d.ts +18 -13
  162. package/dist/components/site-header.js +23 -11
  163. package/dist/components/skeleton.d.ts +17 -7
  164. package/dist/components/skeleton.js +22 -7
  165. package/dist/components/slider.js +2 -2
  166. package/dist/components/sortable.d.ts +55 -4
  167. package/dist/components/sortable.js +172 -103
  168. package/dist/components/sources.d.ts +1 -1
  169. package/dist/components/sources.js +2 -2
  170. package/dist/components/spinner.d.ts +4 -4
  171. package/dist/components/spinner.js +4 -4
  172. package/dist/components/stat.d.ts +21 -4
  173. package/dist/components/stat.js +17 -8
  174. package/dist/components/stepper.d.ts +1 -1
  175. package/dist/components/stepper.js +8 -7
  176. package/dist/components/suggestions.d.ts +11 -3
  177. package/dist/components/suggestions.js +10 -4
  178. package/dist/components/swipe-actions.d.ts +66 -0
  179. package/dist/components/swipe-actions.js +292 -0
  180. package/dist/components/switch.js +1 -1
  181. package/dist/components/table.d.ts +12 -6
  182. package/dist/components/table.js +78 -30
  183. package/dist/components/tabs.js +7 -4
  184. package/dist/components/tag.d.ts +19 -20
  185. package/dist/components/tag.js +9 -5
  186. package/dist/components/tags-input.d.ts +2 -7
  187. package/dist/components/tags-input.js +11 -8
  188. package/dist/components/textarea.d.ts +3 -2
  189. package/dist/components/textarea.js +4 -3
  190. package/dist/components/theme.d.ts +49 -6
  191. package/dist/components/theme.js +147 -9
  192. package/dist/components/time-field.d.ts +4 -9
  193. package/dist/components/time-field.js +6 -6
  194. package/dist/components/timeline.d.ts +19 -3
  195. package/dist/components/timeline.js +21 -9
  196. package/dist/components/tippy.d.ts +17 -1
  197. package/dist/components/tippy.js +95 -15
  198. package/dist/components/toast.d.ts +2 -7
  199. package/dist/components/toast.js +12 -8
  200. package/dist/components/toggle-group.d.ts +7 -1
  201. package/dist/components/toggle-group.js +16 -5
  202. package/dist/components/toggle.d.ts +2 -2
  203. package/dist/components/toggle.js +3 -2
  204. package/dist/components/tool-call.d.ts +1 -1
  205. package/dist/components/tool-call.js +4 -4
  206. package/dist/components/toolbar.d.ts +57 -4
  207. package/dist/components/toolbar.js +216 -16
  208. package/dist/components/tooltip.d.ts +1 -1
  209. package/dist/components/tooltip.js +4 -2
  210. package/dist/components/tour.d.ts +1 -1
  211. package/dist/components/tour.js +36 -15
  212. package/dist/components/tree.js +5 -5
  213. package/dist/components/typography.d.ts +31 -8
  214. package/dist/components/typography.js +21 -10
  215. package/dist/components/video-player.d.ts +7 -2
  216. package/dist/components/video-player.js +121 -220
  217. package/dist/index.d.ts +99 -92
  218. package/dist/index.js +99 -92
  219. package/dist/lib/calendar.d.ts +153 -0
  220. package/dist/lib/calendar.js +312 -0
  221. package/dist/lib/cn.d.ts +3 -1
  222. package/dist/lib/cn.js +5 -0
  223. package/dist/lib/code-highlight.d.ts +14 -0
  224. package/dist/lib/code-highlight.js +81 -18
  225. package/dist/lib/drag.d.ts +39 -0
  226. package/dist/lib/drag.js +96 -0
  227. package/dist/lib/editorial-assets.js +16 -8
  228. package/dist/lib/figure/figures/automation.js +25 -6
  229. package/dist/lib/figure/figures/bar-chart.js +6 -1
  230. package/dist/lib/figure/figures/brackets-classic.js +4 -1
  231. package/dist/lib/figure/figures/city.js +12 -2
  232. package/dist/lib/figure/figures/conveyor.js +17 -4
  233. package/dist/lib/figure/figures/database.js +5 -2
  234. package/dist/lib/figure/figures/documents.js +11 -3
  235. package/dist/lib/figure/figures/inbox.js +5 -2
  236. package/dist/lib/figure/figures/laptop.js +3 -1
  237. package/dist/lib/figure/figures/pipeline.js +45 -10
  238. package/dist/lib/figure/figures/platform.js +62 -7
  239. package/dist/lib/figure/figures/server.js +21 -5
  240. package/dist/lib/figure/figures/spreadsheet.js +29 -5
  241. package/dist/lib/figure/kernel.d.ts +4 -2
  242. package/dist/lib/figure/kernel.js +10 -5
  243. package/dist/lib/figure/parts.js +6 -2
  244. package/dist/lib/files.d.ts +31 -0
  245. package/dist/lib/files.js +60 -0
  246. package/dist/lib/gesture.d.ts +70 -0
  247. package/dist/lib/gesture.js +141 -0
  248. package/dist/lib/glide.d.ts +5 -0
  249. package/dist/lib/glide.js +9 -1
  250. package/dist/lib/icons.d.ts +1 -0
  251. package/dist/lib/icons.js +6 -0
  252. package/dist/lib/illustration-library.js +1 -6
  253. package/dist/lib/markdown-edit.d.ts +112 -0
  254. package/dist/lib/markdown-edit.js +557 -0
  255. package/dist/lib/markdown-rich-editor.d.ts +188 -0
  256. package/dist/lib/markdown-rich-editor.js +1153 -0
  257. package/dist/lib/markdown-rich.d.ts +63 -0
  258. package/dist/lib/markdown-rich.js +534 -0
  259. package/dist/lib/mentions.d.ts +100 -0
  260. package/dist/lib/mentions.js +246 -0
  261. package/dist/lib/motion.d.ts +18 -0
  262. package/dist/lib/motion.js +43 -5
  263. package/dist/lib/number-roll.d.ts +89 -0
  264. package/dist/lib/number-roll.js +391 -0
  265. package/dist/lib/platform.d.ts +6 -0
  266. package/dist/lib/platform.js +14 -0
  267. package/dist/lib/portal-container.d.ts +9 -0
  268. package/dist/lib/portal-container.js +10 -0
  269. package/dist/lib/press.d.ts +5 -0
  270. package/dist/lib/press.js +186 -0
  271. package/dist/lib/scheduler.d.ts +128 -0
  272. package/dist/lib/scheduler.js +272 -0
  273. package/dist/lib/scroll-edges.d.ts +9 -0
  274. package/dist/lib/scroll-edges.js +50 -0
  275. package/dist/lib/table-fit.d.ts +1 -1
  276. package/dist/lib/table-fit.js +65 -8
  277. package/dist/lib/theme-preset.d.ts +267 -0
  278. package/dist/lib/theme-preset.js +1046 -0
  279. package/dist/lib/theme-script.d.ts +23 -3
  280. package/dist/lib/theme-script.js +17 -5
  281. package/dist/lib/tippy/sprite.d.ts +36 -4
  282. package/dist/lib/tippy/sprite.js +188 -15
  283. package/dist/lib/tone.d.ts +4 -0
  284. package/dist/lib/tone.js +1 -0
  285. package/dist/messages/de.d.ts +3 -3
  286. package/dist/messages/de.js +274 -3
  287. package/dist/skills/zon-ui/SKILL.md +279 -0
  288. package/dist/skills/zon-ui/references/authoring.md +265 -0
  289. package/dist/skills/zon-ui/references/brand.md +416 -0
  290. package/dist/skills/zon-ui/references/components/accordion.md +199 -0
  291. package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
  292. package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
  293. package/dist/skills/zon-ui/references/components/alert.md +167 -0
  294. package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
  295. package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
  296. package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
  297. package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
  298. package/dist/skills/zon-ui/references/components/avatar.md +98 -0
  299. package/dist/skills/zon-ui/references/components/badge.md +227 -0
  300. package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
  301. package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
  302. package/dist/skills/zon-ui/references/components/button-group.md +216 -0
  303. package/dist/skills/zon-ui/references/components/button.md +309 -0
  304. package/dist/skills/zon-ui/references/components/calendar.md +296 -0
  305. package/dist/skills/zon-ui/references/components/card.md +158 -0
  306. package/dist/skills/zon-ui/references/components/carousel.md +297 -0
  307. package/dist/skills/zon-ui/references/components/chart.md +739 -0
  308. package/dist/skills/zon-ui/references/components/chat.md +417 -0
  309. package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
  310. package/dist/skills/zon-ui/references/components/code-block.md +143 -0
  311. package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
  312. package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
  313. package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
  314. package/dist/skills/zon-ui/references/components/combobox.md +455 -0
  315. package/dist/skills/zon-ui/references/components/command.md +326 -0
  316. package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
  317. package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
  318. package/dist/skills/zon-ui/references/components/conversation.md +146 -0
  319. package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
  320. package/dist/skills/zon-ui/references/components/crm.md +1022 -0
  321. package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
  322. package/dist/skills/zon-ui/references/components/data-table.md +776 -0
  323. package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
  324. package/dist/skills/zon-ui/references/components/dialog.md +335 -0
  325. package/dist/skills/zon-ui/references/components/direction.md +165 -0
  326. package/dist/skills/zon-ui/references/components/drawer.md +276 -0
  327. package/dist/skills/zon-ui/references/components/drawing.md +94 -0
  328. package/dist/skills/zon-ui/references/components/empty.md +225 -0
  329. package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
  330. package/dist/skills/zon-ui/references/components/field.md +209 -0
  331. package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
  332. package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
  333. package/dist/skills/zon-ui/references/components/form.md +970 -0
  334. package/dist/skills/zon-ui/references/components/graph.md +339 -0
  335. package/dist/skills/zon-ui/references/components/illustration.md +497 -0
  336. package/dist/skills/zon-ui/references/components/inbox.md +263 -0
  337. package/dist/skills/zon-ui/references/components/input-group.md +339 -0
  338. package/dist/skills/zon-ui/references/components/input.md +189 -0
  339. package/dist/skills/zon-ui/references/components/item.md +277 -0
  340. package/dist/skills/zon-ui/references/components/kanban.md +626 -0
  341. package/dist/skills/zon-ui/references/components/kbd.md +116 -0
  342. package/dist/skills/zon-ui/references/components/label.md +104 -0
  343. package/dist/skills/zon-ui/references/components/layout.md +291 -0
  344. package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
  345. package/dist/skills/zon-ui/references/components/locale.md +279 -0
  346. package/dist/skills/zon-ui/references/components/logo.md +257 -0
  347. package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
  348. package/dist/skills/zon-ui/references/components/mentions.md +512 -0
  349. package/dist/skills/zon-ui/references/components/menu.md +218 -0
  350. package/dist/skills/zon-ui/references/components/menubar.md +292 -0
  351. package/dist/skills/zon-ui/references/components/message.md +243 -0
  352. package/dist/skills/zon-ui/references/components/meter.md +105 -0
  353. package/dist/skills/zon-ui/references/components/money-input.md +333 -0
  354. package/dist/skills/zon-ui/references/components/native-select.md +197 -0
  355. package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
  356. package/dist/skills/zon-ui/references/components/number-field.md +210 -0
  357. package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
  358. package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
  359. package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
  360. package/dist/skills/zon-ui/references/components/pagination.md +109 -0
  361. package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
  362. package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
  363. package/dist/skills/zon-ui/references/components/popover.md +176 -0
  364. package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
  365. package/dist/skills/zon-ui/references/components/pricing.md +724 -0
  366. package/dist/skills/zon-ui/references/components/progress.md +92 -0
  367. package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
  368. package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
  369. package/dist/skills/zon-ui/references/components/quote.md +115 -0
  370. package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
  371. package/dist/skills/zon-ui/references/components/rating.md +260 -0
  372. package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
  373. package/dist/skills/zon-ui/references/components/resizable.md +213 -0
  374. package/dist/skills/zon-ui/references/components/response.md +170 -0
  375. package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
  376. package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
  377. package/dist/skills/zon-ui/references/components/select.md +351 -0
  378. package/dist/skills/zon-ui/references/components/separator.md +103 -0
  379. package/dist/skills/zon-ui/references/components/settings.md +793 -0
  380. package/dist/skills/zon-ui/references/components/shop.md +1715 -0
  381. package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
  382. package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
  383. package/dist/skills/zon-ui/references/components/site-header.md +303 -0
  384. package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
  385. package/dist/skills/zon-ui/references/components/slider.md +172 -0
  386. package/dist/skills/zon-ui/references/components/sortable.md +405 -0
  387. package/dist/skills/zon-ui/references/components/sources.md +106 -0
  388. package/dist/skills/zon-ui/references/components/spinner.md +222 -0
  389. package/dist/skills/zon-ui/references/components/stat.md +267 -0
  390. package/dist/skills/zon-ui/references/components/stepper.md +285 -0
  391. package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
  392. package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
  393. package/dist/skills/zon-ui/references/components/switch.md +160 -0
  394. package/dist/skills/zon-ui/references/components/table.md +999 -0
  395. package/dist/skills/zon-ui/references/components/tabs.md +258 -0
  396. package/dist/skills/zon-ui/references/components/tag.md +115 -0
  397. package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
  398. package/dist/skills/zon-ui/references/components/textarea.md +95 -0
  399. package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
  400. package/dist/skills/zon-ui/references/components/theme.md +362 -0
  401. package/dist/skills/zon-ui/references/components/time-field.md +222 -0
  402. package/dist/skills/zon-ui/references/components/timeline.md +285 -0
  403. package/dist/skills/zon-ui/references/components/tippy.md +243 -0
  404. package/dist/skills/zon-ui/references/components/toast.md +220 -0
  405. package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
  406. package/dist/skills/zon-ui/references/components/toggle.md +167 -0
  407. package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
  408. package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
  409. package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
  410. package/dist/skills/zon-ui/references/components/tour.md +423 -0
  411. package/dist/skills/zon-ui/references/components/tree.md +481 -0
  412. package/dist/skills/zon-ui/references/components/typography.md +347 -0
  413. package/dist/skills/zon-ui/references/components/video-player.md +386 -0
  414. package/dist/skills/zon-ui/references/marketing.md +467 -0
  415. package/dist/skills/zon-ui/references/motion.md +455 -0
  416. package/dist/skills/zon-ui/references/recipes.md +1232 -0
  417. package/dist/skills/zon-ui/references/tokens.md +866 -0
  418. package/dist/sources/accordion.css +4 -0
  419. package/dist/sources/action-sheet.css +11 -0
  420. package/dist/sources/alert-dialog.css +6 -0
  421. package/dist/sources/alert.css +3 -0
  422. package/dist/sources/app-bar.css +14 -0
  423. package/dist/sources/ascii-field.css +3 -0
  424. package/dist/sources/aspect-ratio.css +3 -0
  425. package/dist/sources/audio-player.css +20 -0
  426. package/dist/sources/avatar.css +3 -0
  427. package/dist/sources/badge.css +3 -0
  428. package/dist/sources/bottom-nav.css +9 -0
  429. package/dist/sources/breadcrumb.css +14 -0
  430. package/dist/sources/button-group.css +3 -0
  431. package/dist/sources/button.css +9 -0
  432. package/dist/sources/calendar.css +13 -0
  433. package/dist/sources/card.css +3 -0
  434. package/dist/sources/carousel.css +11 -0
  435. package/dist/sources/chart.css +5 -0
  436. package/dist/sources/checkbox.css +6 -0
  437. package/dist/sources/code-block.css +13 -0
  438. package/dist/sources/collapsible.css +4 -0
  439. package/dist/sources/color-picker.css +13 -0
  440. package/dist/sources/combobox.css +13 -0
  441. package/dist/sources/command.css +13 -0
  442. package/dist/sources/context-menu.css +12 -0
  443. package/dist/sources/conversation.css +10 -0
  444. package/dist/sources/copy-button.css +10 -0
  445. package/dist/sources/data-table.css +27 -0
  446. package/dist/sources/date-picker.css +20 -0
  447. package/dist/sources/dialog.css +9 -0
  448. package/dist/sources/direction.css +2 -0
  449. package/dist/sources/drawer.css +9 -0
  450. package/dist/sources/drawing.css +5 -0
  451. package/dist/sources/empty.css +3 -0
  452. package/dist/sources/feature-list.css +4 -0
  453. package/dist/sources/field.css +4 -0
  454. package/dist/sources/file-drop.css +15 -0
  455. package/dist/sources/filter-bar.css +30 -0
  456. package/dist/sources/form.css +4 -0
  457. package/dist/sources/graph.css +19 -0
  458. package/dist/sources/illustration.css +28 -0
  459. package/dist/sources/input-group.css +7 -0
  460. package/dist/sources/input.css +3 -0
  461. package/dist/sources/item.css +4 -0
  462. package/dist/sources/kbd.css +5 -0
  463. package/dist/sources/label.css +3 -0
  464. package/dist/sources/layout.css +3 -0
  465. package/dist/sources/lightbox.css +33 -0
  466. package/dist/sources/locale.css +2 -0
  467. package/dist/sources/logo.css +4 -0
  468. package/dist/sources/markdown-editor.css +41 -0
  469. package/dist/sources/mentions.css +13 -0
  470. package/dist/sources/menu.css +11 -0
  471. package/dist/sources/menubar.css +14 -0
  472. package/dist/sources/message.css +16 -0
  473. package/dist/sources/meter.css +4 -0
  474. package/dist/sources/money-input.css +10 -0
  475. package/dist/sources/native-select.css +4 -0
  476. package/dist/sources/navigation-menu.css +8 -0
  477. package/dist/sources/number-field.css +8 -0
  478. package/dist/sources/number-roll.css +6 -0
  479. package/dist/sources/otp-field.css +5 -0
  480. package/dist/sources/pagination.css +11 -0
  481. package/dist/sources/pdf-viewer.css +30 -0
  482. package/dist/sources/phone-input.css +20 -0
  483. package/dist/sources/popover.css +7 -0
  484. package/dist/sources/preview-card.css +7 -0
  485. package/dist/sources/progress.css +4 -0
  486. package/dist/sources/prompt-input.css +15 -0
  487. package/dist/sources/pull-to-refresh.css +14 -0
  488. package/dist/sources/quote.css +3 -0
  489. package/dist/sources/radio-group.css +5 -0
  490. package/dist/sources/rating.css +6 -0
  491. package/dist/sources/reasoning.css +6 -0
  492. package/dist/sources/resizable.css +4 -0
  493. package/dist/sources/response.css +16 -0
  494. package/dist/sources/scheduler.css +44 -0
  495. package/dist/sources/scroll-area.css +3 -0
  496. package/dist/sources/select.css +12 -0
  497. package/dist/sources/separator.css +3 -0
  498. package/dist/sources/sidebar.css +19 -0
  499. package/dist/sources/site-header.css +15 -0
  500. package/dist/sources/skeleton.css +3 -0
  501. package/dist/sources/slider.css +6 -0
  502. package/dist/sources/sortable.css +12 -0
  503. package/dist/sources/sources.css +6 -0
  504. package/dist/sources/spinner.css +6 -0
  505. package/dist/sources/stat.css +9 -0
  506. package/dist/sources/stepper.css +6 -0
  507. package/dist/sources/suggestions.css +10 -0
  508. package/dist/sources/swipe-actions.css +20 -0
  509. package/dist/sources/switch.css +5 -0
  510. package/dist/sources/table.css +7 -0
  511. package/dist/sources/tabs.css +5 -0
  512. package/dist/sources/tag.css +3 -0
  513. package/dist/sources/tags-input.css +6 -0
  514. package/dist/sources/textarea.css +3 -0
  515. package/dist/sources/theme.css +13 -0
  516. package/dist/sources/time-field.css +7 -0
  517. package/dist/sources/timeline.css +7 -0
  518. package/dist/sources/tippy.css +6 -0
  519. package/dist/sources/toast.css +6 -0
  520. package/dist/sources/toggle-group.css +5 -0
  521. package/dist/sources/toggle.css +3 -0
  522. package/dist/sources/tool-call.css +16 -0
  523. package/dist/sources/toolbar.css +14 -0
  524. package/dist/sources/tooltip.css +6 -0
  525. package/dist/sources/tour.css +14 -0
  526. package/dist/sources/tree.css +6 -0
  527. package/dist/sources/typography.css +4 -0
  528. package/dist/sources/video-player.css +21 -0
  529. package/dist/styles/ai.css +3 -0
  530. package/dist/styles/brand.css +98 -0
  531. package/dist/styles/core.css +266 -0
  532. package/dist/styles/editor.css +3 -0
  533. package/dist/styles/expressive.css +35 -56
  534. package/dist/styles/fonts.css +61 -117
  535. package/dist/styles/graph.css +4 -0
  536. package/dist/styles/illustration.css +4 -0
  537. package/dist/styles/index.css +11 -201
  538. package/dist/styles/material.css +138 -12
  539. package/dist/styles/parts/ai.css +18 -13
  540. package/dist/styles/parts/brand.css +2 -2
  541. package/dist/styles/parts/controls.css +29 -20
  542. package/dist/styles/parts/data.css +13 -9
  543. package/dist/styles/parts/editor.css +372 -0
  544. package/dist/styles/parts/feedback.css +32 -2
  545. package/dist/styles/parts/foundations.css +12 -7
  546. package/dist/styles/parts/graph.css +25 -9
  547. package/dist/styles/parts/inputs.css +172 -9
  548. package/dist/styles/parts/isometric.css +6 -5
  549. package/dist/styles/parts/navigation.css +206 -27
  550. package/dist/styles/parts/overlays.css +19 -4
  551. package/dist/styles/parts/pdf.css +2 -2
  552. package/dist/styles/pdf.css +3 -0
  553. package/dist/styles/prose.css +3 -0
  554. package/dist/styles/tokens.css +89 -14
  555. package/dist/theme.d.ts +1 -0
  556. package/dist/theme.js +5 -0
  557. package/dist/vite.d.ts +48 -59
  558. package/dist/vite.js +54 -21
  559. package/package.json +69 -2
@@ -0,0 +1,276 @@
1
+ # Drawer
2
+
3
+ ```tsx
4
+ import { Button, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerTitle, DrawerTrigger } from "@zonsh/ui";
5
+
6
+ export function BottomSheet() {
7
+ return (
8
+ <Drawer>
9
+ <DrawerTrigger render={<Button variant="secondary" />}>Add photos</DrawerTrigger>
10
+ <DrawerContent>
11
+ <DrawerHeader>
12
+ <DrawerTitle>Add photos to "Lisbon, May"</DrawerTitle>
13
+ <DrawerDescription>
14
+ Upload from this device, or pick from photos you already have.
15
+ </DrawerDescription>
16
+ </DrawerHeader>
17
+ <DrawerFooter>
18
+ <DrawerClose render={<Button variant="secondary" />}>Choose from library</DrawerClose>
19
+ <DrawerClose render={<Button />}>Upload photos</DrawerClose>
20
+ </DrawerFooter>
21
+ </DrawerContent>
22
+ </Drawer>
23
+ );
24
+ }
25
+ ```
26
+
27
+ A panel that slides in from an edge and follows the finger. It wears the card material; its geometry says where it lives: the **bottom sheet** has 20px top corners and a grab handle, the **side panel** a square edge against the viewport. The backdrop fades with the swipe (`--drawer-swipe-progress`); content clears the bottom safe area.
28
+
29
+ ## Usage
30
+
31
+ ```tsx
32
+ import {
33
+ Button,
34
+ Drawer,
35
+ DrawerClose,
36
+ DrawerContent,
37
+ DrawerDescription,
38
+ DrawerFooter,
39
+ DrawerHeader,
40
+ DrawerTitle,
41
+ DrawerTrigger,
42
+ } from "@zonsh/ui";
43
+
44
+ <Drawer side="right">
45
+ <DrawerTrigger render={<Button variant="secondary" />}>Notification settings</DrawerTrigger>
46
+ <DrawerContent>
47
+ <DrawerHeader>
48
+ <DrawerTitle>Notifications</DrawerTitle>
49
+ <DrawerDescription>Choose what reaches your inbox.</DrawerDescription>
50
+ </DrawerHeader>
51
+ …
52
+ <DrawerFooter>
53
+ <DrawerClose render={<Button />}>Done</DrawerClose>
54
+ </DrawerFooter>
55
+ </DrawerContent>
56
+ </Drawer>;
57
+ ```
58
+
59
+ The props you'll reach for: `side` and `open` / `onOpenChange` on `Drawer`, and `size` on `DrawerContent`.
60
+
61
+ There is no `DrawerBody`: `DrawerContent` stacks its children 24px apart, pads them (24px, 32px from `sm`) and scrolls them, so header, content and footer go straight inside. Don't add `px-6` or a scroll wrapper. Pull edge-to-edge content out with `-mx-6 sm:-mx-8`. `DrawerFooter` sits at the bottom of a side panel.
62
+
63
+ ## When to use
64
+
65
+ - `side="bottom"` — mobile tasks from the thumb: share options, filters, a short form.
66
+ - `size="full"` — a bottom sheet edge to edge, for wide content and tables. Add `snapPoints` (with `fullHeight`) for a peek-then-expand sheet.
67
+ - `side="right"` / `"left"` — settings, filters or a detail view on desktop. 416px wide, 480px from 1280px; a `w-*` class sets your own.
68
+ - Not when nothing needs a gesture: a centred task is a `Dialog`.
69
+ - On phones, in place of a `Dialog` or a `Popover` that holds a form or a long list (see "On phones" in [Dialog](dialog.md) and [Popover](popover.md)); `FilterBar` opens its editors in one there.
70
+
71
+ ## Examples
72
+
73
+ ### Full width
74
+
75
+ Edge to edge, with handle and top corners. Keep reading content in a centred `max-w-3xl` column.
76
+
77
+ ```tsx
78
+ import { Button, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerTitle, DrawerTrigger } from "@zonsh/ui";
79
+
80
+ const releaseSections = [
81
+ [
82
+ "New",
83
+ "Folders can now be shared with people outside your workspace. They see only that folder, and you can revoke access at any time.",
84
+ ],
85
+ [
86
+ "Improved",
87
+ "Search looks inside attachments as well as notes, and results appear as you type instead of after you press Enter.",
88
+ ],
89
+ [
90
+ "Fixed",
91
+ "Notes edited offline on two devices no longer overwrite each other; both versions are kept and marked for you to merge.",
92
+ ],
93
+ [
94
+ "Changed",
95
+ "The old export format is gone. Export now writes Markdown files with your folders kept as directories.",
96
+ ],
97
+ [
98
+ "Upgrading",
99
+ "Nothing to do: the app updates itself the next time it starts. Notes stay exactly where they are.",
100
+ ],
101
+ [
102
+ "Known issues",
103
+ "Very large attachments can take a while to index after the update. Search fills in as indexing finishes.",
104
+ ],
105
+ ] as const;
106
+
107
+ export function FullWidth() {
108
+ return (
109
+ <Drawer>
110
+ <DrawerTrigger render={<Button variant="secondary" />}>Read the release notes</DrawerTrigger>
111
+ <DrawerContent size="full">
112
+ <DrawerHeader className="mx-auto w-full max-w-3xl">
113
+ <DrawerTitle>Version 2.4</DrawerTitle>
114
+ <DrawerDescription>What changed in this release.</DrawerDescription>
115
+ </DrawerHeader>
116
+ <div className="mx-auto grid w-full max-w-3xl gap-6 text-[15px] leading-relaxed text-foreground-soft sm:grid-cols-2">
117
+ {releaseSections.map(([title, body], index) => (
118
+ <section key={index} className="flex flex-col gap-1">
119
+ <h3 className="m-0 font-body text-[15px] font-medium text-foreground">{title}</h3>
120
+ <p className="m-0">{body}</p>
121
+ </section>
122
+ ))}
123
+ </div>
124
+ <DrawerFooter className="mx-auto w-full max-w-3xl">
125
+ <DrawerClose render={<Button variant="secondary" />}>Close</DrawerClose>
126
+ <DrawerClose render={<Button />}>Update now</DrawerClose>
127
+ </DrawerFooter>
128
+ </DrawerContent>
129
+ </Drawer>
130
+ );
131
+ }
132
+ ```
133
+
134
+ ### Side panel
135
+
136
+ `side` sets the placement and the swipe direction. Sides are the screen's, also right to left, where only the panel's contents mirror.
137
+
138
+ ```tsx
139
+ import { Button, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerTitle, DrawerTrigger, Switch } from "@zonsh/ui";
140
+
141
+ export function SidePanel() {
142
+ return (
143
+ <div className="flex flex-wrap gap-3">
144
+ {(["left", "right"] as const).map((side) => (
145
+ <Drawer key={side} side={side}>
146
+ <DrawerTrigger render={<Button variant="secondary" />}>
147
+ Notification settings ({side})
148
+ </DrawerTrigger>
149
+ <DrawerContent>
150
+ <DrawerHeader>
151
+ <DrawerTitle>Notifications</DrawerTitle>
152
+ <DrawerDescription>
153
+ Choose what reaches your inbox. Swipe the panel away to close it.
154
+ </DrawerDescription>
155
+ </DrawerHeader>
156
+ <div className="flex flex-col gap-4 text-sm">
157
+ <label className="flex items-center justify-between gap-4">
158
+ Weekly project summary
159
+ <Switch defaultChecked />
160
+ </label>
161
+ <label className="flex items-center justify-between gap-4">
162
+ A sync fails
163
+ <Switch defaultChecked />
164
+ </label>
165
+ <label className="flex items-center justify-between gap-4">
166
+ Someone comments on your article
167
+ <Switch />
168
+ </label>
169
+ </div>
170
+ <DrawerFooter>
171
+ <DrawerClose render={<Button />}>Done</DrawerClose>
172
+ </DrawerFooter>
173
+ </DrawerContent>
174
+ </Drawer>
175
+ ))}
176
+ </div>
177
+ );
178
+ }
179
+ ```
180
+
181
+ ### Snap points
182
+
183
+ 0–1 are fractions of the viewport height; larger numbers or `"px"`/`"rem"` strings are fixed heights. Pair with `fullHeight` so the body scrolls to its end at the peek height.
184
+
185
+ ```tsx
186
+ import { Button, Drawer, DrawerContent, DrawerDescription, DrawerHeader, DrawerTitle, DrawerTrigger, Field, FieldLabel, Input } from "@zonsh/ui";
187
+
188
+ const snapPoints = ["220px", 1];
189
+
190
+ export function SnapPoints() {
191
+ return (
192
+ <Drawer snapPoints={snapPoints}>
193
+ <DrawerTrigger render={<Button variant="secondary" />}>Trip notes</DrawerTrigger>
194
+ <DrawerContent fullHeight>
195
+ <DrawerHeader>
196
+ <DrawerTitle>Trip notes</DrawerTitle>
197
+ <DrawerDescription>Drag the sheet up for the full view, or down to dismiss it.</DrawerDescription>
198
+ </DrawerHeader>
199
+ <div className="flex flex-col gap-4 text-[15px] leading-relaxed text-foreground-soft">
200
+ {Array.from({ length: 8 }, (_, index) => (
201
+ <p key={index} className="m-0">
202
+ Day {index + 1}: the old town in the morning, lunch by the river, and an early night before the
203
+ next train.
204
+ </p>
205
+ ))}
206
+ </div>
207
+ <Field>
208
+ <FieldLabel>Add a note</FieldLabel>
209
+ <Input placeholder="What did you do today?" />
210
+ </Field>
211
+ </DrawerContent>
212
+ </Drawer>
213
+ );
214
+ }
215
+ ```
216
+
217
+ ## Dragging
218
+
219
+ The sheet follows the pointer 1:1 (an inline transform, plus `--drawer-swipe-movement-*`). On release it settles, snaps to the nearest point, or leaves — past half its size or on a flick — over a duration scaled by `--drawer-swipe-strength`. Dragging past the top is damped.
220
+
221
+ - **Touch** drags from anywhere; a scrolling body scrolls first and hands over at its top.
222
+ - **Mouse** drags from anywhere but a control (buttons, links, inputs, labels) or a scrolling body, so text stays selectable. The 28px handle band always starts a drag.
223
+ - `data-base-ui-swipe-ignore` keeps an element (a chart, a map) from starting a swipe.
224
+
225
+ Motion: `styles/parts/overlays.css`. Data attributes: `data-side` and `data-size` (bottom sheets) on the popup, plus Base UI's `data-swiping`, `data-expanded`, `data-swipe-direction`.
226
+
227
+ ## Props
228
+
229
+ | Prop | Type | Default |
230
+ | ---------------------------------------- | ----------------------------------------------------------------------------- | ----------------------- |
231
+ | `Drawer.side` | `"bottom" \| "right" \| "left"` | `"bottom"` |
232
+ | `Drawer.swipeDirection` | `"down" \| "up" \| "left" \| "right"` — overrides the one derived from `side` | from `side` |
233
+ | `Drawer.snapPoints` | `(number \| string)[]` | — |
234
+ | `Drawer.snapPoint` / `onSnapPointChange` | controlled snap point | — |
235
+ | `Drawer.open` / `onOpenChange` | controlled state | — |
236
+ | `DrawerContent.size` | `"default" \| "full"` — bottom sheets: centred (≤672px) or full width | `"default"` |
237
+ | `DrawerContent.fullHeight` | `boolean` — bottom sheets: fixed full height, body scrolls (for snap points) | `false` |
238
+ | `DrawerContent.showCloseButton` | `boolean` | `true` |
239
+ | `DrawerContent.showHandle` | `boolean` | `true` on bottom sheets |
240
+ | `DrawerContent.labels` | `{ close? }` — the close button's name | `"Close"` |
241
+ | `DrawerContent.portal` | `Drawer.Portal` props | — |
242
+
243
+ `Drawer` wraps Base UI `Drawer.Root` and forwards its props (`modal`, `snapToSequentialPoints`, `handle`, …). `DrawerContent` renders Portal → Backdrop → Viewport → Popup → handle band → body.
244
+
245
+ The close button's name defaults to `messages.drawer.close`.
246
+
247
+ ## Brand rules
248
+
249
+ - **Do** use the bottom sheet on mobile and the side panel on desktop.
250
+ - **Do** keep the card material; inputs share its `--field-edge`.
251
+ - **Don't** round the edge against the viewport or float the panel off it.
252
+ - **Don't** add blur to the backdrop or a heavier shadow.
253
+ - **Don't** hide the only way to close behind a gesture; keep the close button unless the footer has a close action.
254
+
255
+ ## Accessibility
256
+
257
+ - Modal by default: focus is trapped, the page is inert and scroll-locked, and focus returns to the trigger on close.
258
+ - Swipe is never the only way out; keep `DrawerClose` or the corner button.
259
+ - `DrawerTitle` labels the panel; the grab handle is decorative (`aria-hidden`).
260
+ - Under reduced motion the slide is instant (`--duration` is 0).
261
+
262
+ ### Keyboard
263
+
264
+ | Key | What it does |
265
+ | --------------- | ----------------------------------------------------------------------------------- |
266
+ | Enter / Space | Opens the drawer from its trigger |
267
+ | Tab / Shift+Tab | Moves through the panel's controls; in the default modal drawer, focus stays inside |
268
+ | Escape | Closes the drawer and returns focus to the trigger |
269
+
270
+ Swiping and snap points have no keys of their own; the panel's controls reach every state.
271
+
272
+ ---
273
+
274
+ - Import: `import { Drawer, DrawerTrigger, DrawerContent, DrawerHeader, DrawerTitle, DrawerDescription, DrawerFooter, DrawerClose } from "@zonsh/ui"`
275
+ - Source: `packages/ui/src/components/drawer.tsx`
276
+ - Primitive: `@base-ui/react/drawer` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/drawer.md`)
@@ -0,0 +1,94 @@
1
+ # Drawing
2
+
3
+ ```tsx
4
+ import { DrawingHorizon } from "@zonsh/ui/drawing";
5
+
6
+ /** The horizon as the ground of a closing section, on the night ground. */
7
+ export function Horizon() {
8
+ return (
9
+ <section className="theme-night relative w-full overflow-hidden bg-background px-6 pt-16 pb-[28%] text-center text-foreground">
10
+ <p className="relative z-1 display text-[32px]">Ready when you are</p>
11
+ <DrawingHorizon className="pointer-events-none absolute inset-x-0 bottom-0 aspect-[2/1] h-auto w-full" />
12
+ </section>
13
+ );
14
+ }
15
+ ```
16
+
17
+ The [illustration library](illustration.md)'s drawings, one component each, from `@zonsh/ui/drawing`. They draw what `<Illustration name="drawing/…" />` draws — monochrome lines in `currentColor`, following the theme — but a build takes only the drawings it imports, where `Illustration` brings in the whole library.
18
+
19
+ ## Usage
20
+
21
+ ```tsx
22
+ import { DrawingHorizon } from "@zonsh/ui/drawing";
23
+
24
+ <footer className="theme-night relative overflow-hidden bg-background">
25
+ {/* … */}
26
+ <DrawingHorizon className="pointer-events-none absolute inset-x-0 bottom-0 aspect-[2/1] h-auto w-full" />
27
+ </footer>;
28
+ ```
29
+
30
+ The props you'll reach for: `className` (size it by width), `variant`, and `title` when it carries meaning.
31
+
32
+ ## When to use
33
+
34
+ - **One or two drawings on a page** — a horizon under a footer, an eclipse on a cover.
35
+ - Isometric figures, sheets, editorial images or a name picked at runtime: `Illustration` from `@zonsh/ui/illustration`.
36
+ - Not as icons or a logo. `DrawingBracketConstruction` is a drawing _of_ zon's mark, for zon's own pages.
37
+
38
+ ## Examples
39
+
40
+ ### Variants
41
+
42
+ Each takes its library entry's variants; the first is the default.
43
+
44
+ ```tsx
45
+ import { DrawingCrescent, DrawingEclipse } from "@zonsh/ui/drawing";
46
+
47
+ /** Two drawings with their variants, each at its own size. */
48
+ export function Variants() {
49
+ return (
50
+ <div className="grid w-full grid-cols-2 items-center gap-8 sm:grid-cols-4">
51
+ <DrawingEclipse />
52
+ <DrawingEclipse variant="guides" />
53
+ <DrawingCrescent />
54
+ <DrawingCrescent variant="guides" title="A crescent with its construction lines" />
55
+ </div>
56
+ );
57
+ }
58
+ ```
59
+
60
+ ## Props
61
+
62
+ | Component | Variants | Library id |
63
+ | ---------------------------- | ------------------- | ------------------------------ |
64
+ | `DrawingHorizon` | `default` | `drawing/horizon` |
65
+ | `DrawingEclipse` | `default`, `guides` | `drawing/eclipse` |
66
+ | `DrawingCrescent` | `default`, `guides` | `drawing/crescent` |
67
+ | `DrawingNibStudy` | `default`, `plain` | `drawing/nib-study` |
68
+ | `DrawingElevationGuides` | `default`, `plain` | `drawing/elevation-guides` |
69
+ | `DrawingBracketConstruction` | `default`, `filled` | `drawing/bracket-construction` |
70
+
71
+ Every one takes:
72
+
73
+ | Prop | Type | Default |
74
+ | ----------- | -------------------------------------------------- | ----------- |
75
+ | `variant` | the drawing's variants | `"default"` |
76
+ | `title` | `string` — accessible name; omit it for decoration | — |
77
+ | `className` | `string` — size it by width; the height follows | — |
78
+ | `style` | `CSSProperties` | — |
79
+
80
+ The SVG carries `data-slot="illustration"`, `data-kind="drawing"`, `data-name` (the library id) and `data-variant`, like the same drawing drawn by `Illustration`.
81
+
82
+ ## Brand rules
83
+
84
+ - **Do** pick a drawing for what it means (see the [library](illustration.md)): the horizon closes a page, the crescent begins one.
85
+ - **Don't** colour a drawing or give it a box: it is line art on the ground it sits on.
86
+
87
+ ## Accessibility
88
+
89
+ - Decorative by default (`aria-hidden`). Give it a `title` when it carries meaning the text beside it does not; it becomes an `img` with that name.
90
+
91
+ ---
92
+
93
+ - Import: `import { DrawingHorizon, DrawingEclipse, DrawingCrescent, DrawingNibStudy, DrawingElevationGuides, DrawingBracketConstruction } from "@zonsh/ui/drawing"`
94
+ - Source: `packages/ui/src/components/drawing.tsx`
@@ -0,0 +1,225 @@
1
+ # Empty
2
+
3
+ ```tsx
4
+ import { Button, Empty, EmptyActions, EmptyDescription, EmptyMedia, EmptyTitle } from "@zonsh/ui";
5
+ import { FolderIcon, PlusIcon } from "lucide-react";
6
+
7
+ export function Basic() {
8
+ return (
9
+ <Empty>
10
+ <EmptyMedia>
11
+ <FolderIcon />
12
+ </EmptyMedia>
13
+ <EmptyTitle>No projects yet</EmptyTitle>
14
+ <EmptyDescription>
15
+ A project keeps the pages, files and notes for one piece of work together. Start from scratch or from
16
+ a template.
17
+ </EmptyDescription>
18
+ <EmptyActions>
19
+ <Button>
20
+ <PlusIcon />
21
+ Create project
22
+ </Button>
23
+ <Button variant="secondary">Browse templates</Button>
24
+ </EmptyActions>
25
+ </Empty>
26
+ );
27
+ }
28
+ ```
29
+
30
+ What a list, search or dashboard shows before there is anything in it: a raised icon well (or an illustration), a Licht title, a sentence on what belongs here and the action that puts it there. It has no box of its own — it fills whatever would hold the content.
31
+
32
+ ## Usage
33
+
34
+ ```tsx
35
+ import { Button, Empty, EmptyActions, EmptyDescription, EmptyMedia, EmptyTitle } from "@zonsh/ui";
36
+ import { FolderIcon } from "lucide-react";
37
+
38
+ <Empty>
39
+ <EmptyMedia>
40
+ <FolderIcon />
41
+ </EmptyMedia>
42
+ <EmptyTitle>No projects yet</EmptyTitle>
43
+ <EmptyDescription>Start from scratch or from a template.</EmptyDescription>
44
+ <EmptyActions>
45
+ <Button>Create project</Button>
46
+ </EmptyActions>
47
+ </Empty>;
48
+ ```
49
+
50
+ The props you'll reach for: `EmptyMedia.variant`, `EmptyTitle.render` (the heading level), and the parts themselves.
51
+
52
+ ## When to use
53
+
54
+ - A list with no rows yet — say what will appear and offer the action that creates the first.
55
+ - A search with no results — repeat the query and offer to clear it.
56
+ - A dashboard before its first sync — an illustration and the setup step.
57
+ - Not for a failed load inside a page: use a destructive `Alert` with a retry. A whole page that can't be shown is an empty state (see Error page).
58
+ - Not for loading: use `Skeleton`.
59
+
60
+ ## Examples
61
+
62
+ ### No results
63
+
64
+ Repeat the query and offer a `ghost` action to clear it.
65
+
66
+ ```tsx
67
+ import { Button, Card, Empty, EmptyActions, EmptyDescription, EmptyMedia, EmptyTitle, Input } from "@zonsh/ui";
68
+ import { SearchIcon, SearchXIcon } from "lucide-react";
69
+ import * as React from "react";
70
+
71
+ export function NoResults() {
72
+ const [query, setQuery] = React.useState("Lisboa 2019");
73
+ return (
74
+ <Card className="max-w-2xl gap-0 [--card-padding:0]">
75
+ <div className="border-b border-field-edge p-4">
76
+ <div className="relative">
77
+ <SearchIcon className="pointer-events-none absolute start-3 top-1/2 size-4 -translate-y-1/2 text-muted-foreground" />
78
+ <Input
79
+ aria-label="Search photos"
80
+ value={query}
81
+ onChange={(event) => setQuery(event.target.value)}
82
+ className="ps-9"
83
+ />
84
+ </div>
85
+ </div>
86
+ <Empty>
87
+ <EmptyMedia>
88
+ <SearchXIcon />
89
+ </EmptyMedia>
90
+ <EmptyTitle>No photos match “{query || "…"}”</EmptyTitle>
91
+ <EmptyDescription>Check the spelling, or search by place, person or date instead.</EmptyDescription>
92
+ <EmptyActions>
93
+ <Button variant="ghost" onClick={() => setQuery("")}>
94
+ Clear search
95
+ </Button>
96
+ </EmptyActions>
97
+ </Empty>
98
+ </Card>
99
+ );
100
+ }
101
+ ```
102
+
103
+ ### With illustration
104
+
105
+ `EmptyMedia variant="illustration"` is a bare slot up to 220px wide for an `<Illustration>` from the library. Here it sits in a region (`Card variant="region"`).
106
+
107
+ ```tsx
108
+ import { Button, Card, Empty, EmptyActions, EmptyDescription, EmptyMedia, EmptyTitle } from "@zonsh/ui";
109
+ import { Illustration } from "@zonsh/ui/illustration";
110
+
111
+ export function WithIllustration() {
112
+ return (
113
+ <Card variant="region" className="max-w-2xl [--card-padding:0]">
114
+ <Empty>
115
+ <EmptyMedia variant="illustration">
116
+ <Illustration name="drawing/bracket-construction" variant="filled" />
117
+ </EmptyMedia>
118
+ <EmptyTitle>Connect your first calendar</EmptyTitle>
119
+ <EmptyDescription>
120
+ Link the calendars you already use — work, home, the school's — and your week fills in from the next
121
+ sync.
122
+ </EmptyDescription>
123
+ <EmptyActions>
124
+ <Button>Add a calendar</Button>
125
+ <Button variant="link" nativeButton={false} render={<a href="#calendars" />}>
126
+ See supported calendars
127
+ </Button>
128
+ </EmptyActions>
129
+ </Empty>
130
+ </Card>
131
+ );
132
+ }
133
+ ```
134
+
135
+ ### Quiet
136
+
137
+ Nothing to do — a clear inbox: no media, no actions, a smaller title.
138
+
139
+ ```tsx
140
+ import { Empty, EmptyDescription, EmptyTitle } from "@zonsh/ui";
141
+
142
+ export function Quiet() {
143
+ return (
144
+ <Empty className="py-8 @3xl:py-10">
145
+ <EmptyTitle className="text-[20px] @2xl:text-[22px]">No comments yet</EmptyTitle>
146
+ <EmptyDescription>Comments on your drafts appear here.</EmptyDescription>
147
+ </Empty>
148
+ );
149
+ }
150
+ ```
151
+
152
+ ### Error page
153
+
154
+ A 404, 403 or 500 is an empty state for the page: the code in a mono `Eyebrow`, the title as `h1` (`render={<h1 />}`), what happened and what to do, then "Go back" (`secondary`) and "Back to home" (primary). Keep it inside the app shell. No jokes, no broken robots.
155
+
156
+ ```tsx
157
+ import { Button, Empty, EmptyActions, EmptyDescription, EmptyTitle, Eyebrow } from "@zonsh/ui";
158
+
159
+ const errorPages = {
160
+ "404": {
161
+ title: "This page doesn't exist",
162
+ body: "The link may be old, or the page was moved or deleted. Check the address, or start again from home.",
163
+ },
164
+ "403": {
165
+ title: "You don't have access to this page",
166
+ body: "It belongs to a workspace you're not a member of. Ask its owner to invite you, or switch workspace.",
167
+ },
168
+ "500": {
169
+ title: "Something went wrong on our side",
170
+ body: "The page couldn't load. Nothing you did caused it, and trying again in a minute usually works.",
171
+ },
172
+ } as const;
173
+
174
+ export function ErrorPage({ code = "404" }: { code?: keyof typeof errorPages }) {
175
+ const page = errorPages[code];
176
+ return (
177
+ <div className="flex min-h-[28rem] w-full items-center justify-center">
178
+ <Empty>
179
+ <Eyebrow className="mb-3">Error {code}</Eyebrow>
180
+ <EmptyTitle render={<h1 />}>{page.title}</EmptyTitle>
181
+ <EmptyDescription>{page.body}</EmptyDescription>
182
+ <EmptyActions>
183
+ <Button variant="secondary" onClick={() => history.back()}>
184
+ Go back
185
+ </Button>
186
+ <Button render={<a href="/" />} nativeButton={false}>
187
+ Back to home
188
+ </Button>
189
+ </EmptyActions>
190
+ </Empty>
191
+ </div>
192
+ );
193
+ }
194
+ ```
195
+
196
+ ## Props
197
+
198
+ | Part | Renders | Notes |
199
+ | ------------------ | ------- | ----------------------------------------------------------------------------------- |
200
+ | `Empty` | `div` | Centred column, 48px (64px from `md`) vertical padding. |
201
+ | `EmptyMedia` | `div` | `variant`: `"icon"` (default, 46px raised well) or `"illustration"`. `aria-hidden`. |
202
+ | `EmptyTitle` | `h3` | Licht 24/28px. `render` changes the element (`render={<h2 />}`). |
203
+ | `EmptyDescription` | `div` | Muted 15px, 46ch wide; links take the brand underline. |
204
+ | `EmptyActions` | `div` | A centred, wrapping row of buttons. |
205
+
206
+ All parts forward their element's props. Data attributes: `data-slot`, and `data-variant` on `EmptyMedia`.
207
+
208
+ ## Brand rules
209
+
210
+ - **Do** say what is missing and how to add it: "No projects yet" + "Create project".
211
+ - **Do** keep at most one primary in `EmptyActions`; the rest are `secondary`, `ghost` or `link`.
212
+ - **Don't** box it: `Empty` goes inside the container that would hold the content, not a card of its own.
213
+ - **Don't** be cute or alarmed. No exclamation marks, no mascots, no invented numbers ("Teams save 10 hours a week").
214
+ - **Don't** colour the icon well; it is the raised key surface in foreground ink.
215
+
216
+ ## Accessibility
217
+
218
+ - `EmptyTitle` is a real heading; pick the level that fits the outline with `render`.
219
+ - `EmptyMedia` is `aria-hidden`; the title and description carry the meaning.
220
+ - After a search, announce the result count in a `role="status"` element.
221
+
222
+ ---
223
+
224
+ - Import: `import { Empty, EmptyMedia, EmptyTitle, EmptyDescription, EmptyActions } from "@zonsh/ui"`
225
+ - Source: `packages/ui/src/components/empty.tsx`