@zonsh/ui 0.5.0 → 0.6.1

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 +643 -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,112 @@
1
+ # Aspect Ratio
2
+
3
+ ```tsx
4
+ import { AspectRatio } from "@zonsh/ui";
5
+ import { Illustration } from "@zonsh/ui/illustration";
6
+
7
+ export function Basic() {
8
+ return (
9
+ <AspectRatio ratio={16 / 9} className="max-w-xl surface-container">
10
+ <Illustration name="editorial/automation" priority />
11
+ </AspectRatio>
12
+ );
13
+ }
14
+ ```
15
+
16
+ A full-width box that keeps its proportions; its direct child fills it, so the media never sets the height. It has no surface or radius — give it the material of what it is.
17
+
18
+ ## Usage
19
+
20
+ ```tsx
21
+ import { AspectRatio } from "@zonsh/ui";
22
+ import { Illustration } from "@zonsh/ui/illustration";
23
+
24
+ <AspectRatio ratio={16 / 9}>
25
+ <Illustration name="editorial/integration" />
26
+ </AspectRatio>;
27
+ ```
28
+
29
+ The one prop is `ratio` (width ÷ height: `16 / 9`, `4 / 3`, `1`). An unusable ratio (0, negative, `NaN`, `Infinity`) falls back to square.
30
+
31
+ ## When to use
32
+
33
+ - Illustrations, covers, screenshots and video embeds whose height follows their width.
34
+ - Reserving space before media loads.
35
+ - Not for text: it must grow with its length.
36
+
37
+ ## Examples
38
+
39
+ ### Ratios
40
+
41
+ ```tsx
42
+ import { AspectRatio } from "@zonsh/ui";
43
+
44
+ export function Ratios() {
45
+ return (
46
+ <div className="grid w-full max-w-2xl grid-cols-3 items-start gap-4">
47
+ {[
48
+ { label: "1 / 1", ratio: 1 },
49
+ { label: "4 / 3", ratio: 4 / 3 },
50
+ { label: "16 / 9", ratio: 16 / 9 },
51
+ ].map(({ label, ratio }) => (
52
+ <figure key={label} className="m-0 flex flex-col gap-2">
53
+ <AspectRatio ratio={ratio} className="blueprint border border-field-edge [--cell:16px]">
54
+ <div className="flex items-center justify-center font-mono text-xs text-muted-foreground">
55
+ {label}
56
+ </div>
57
+ </AspectRatio>
58
+ </figure>
59
+ ))}
60
+ </div>
61
+ );
62
+ }
63
+ ```
64
+
65
+ ### In a card
66
+
67
+ A card cover: `[--card-padding:0] overflow-hidden` on the card, then pad the content.
68
+
69
+ ```tsx
70
+ import { AspectRatio, Card, CardDescription, CardHeader, CardTitle } from "@zonsh/ui";
71
+ import { Illustration } from "@zonsh/ui/illustration";
72
+
73
+ export function InCard() {
74
+ return (
75
+ <Card className="max-w-sm gap-0 overflow-hidden [--card-padding:0]">
76
+ <AspectRatio ratio={4 / 3} className="border-b border-field-edge">
77
+ <Illustration name="editorial/integration" priority />
78
+ </AspectRatio>
79
+ <CardHeader className="p-6">
80
+ <CardTitle>Writing for the web</CardTitle>
81
+ <CardDescription>
82
+ A short course on clear headlines, scannable paragraphs and links that say where they go.
83
+ </CardDescription>
84
+ </CardHeader>
85
+ </Card>
86
+ );
87
+ }
88
+ ```
89
+
90
+ ## Props
91
+
92
+ | Prop | Type | Default |
93
+ | ------- | ---------------------------------------- | ------- |
94
+ | `ratio` | `number` — width ÷ height, e.g. `16 / 9` | `1` |
95
+
96
+ All `<div>` props are forwarded; `style` is merged after the ratio. The direct child gets `absolute inset-0 size-full`. Add `object-cover` to a photo that should crop to fill; illustrations keep their `object-contain`. Data attribute: `data-slot="aspect-ratio"`.
97
+
98
+ ## Brand rules
99
+
100
+ - **Do** take the radius of what it is: none for a region, `rounded-card` only when the box is itself an object.
101
+ - **Do** frame a region with `surface-container` or a `--field-edge` border, not a shadow.
102
+ - **Don't** give the child a fixed height; the ratio sets it.
103
+ - **Don't** stretch the logo or an illustration to fill a ratio — keep `object-contain`.
104
+
105
+ ## Accessibility
106
+
107
+ - `AspectRatio` adds no semantics. The media inside needs its own `alt` (or `alt=""` / `aria-hidden` when decorative), and video needs captions.
108
+
109
+ ---
110
+
111
+ - Import: `import { AspectRatio } from "@zonsh/ui"`
112
+ - Source: `packages/ui/src/components/aspect-ratio.tsx`
@@ -0,0 +1,231 @@
1
+ # Audio Player
2
+
3
+ ```tsx
4
+ import { AudioPlayer } from "@zonsh/ui";
5
+
6
+ const FILES = `${import.meta.env.BASE_URL}files`;
7
+
8
+ /** The eclipse clip's score, as 120 peaks: computed once with `audioPeaks` and kept with the file. */
9
+ const SCORE_PEAKS = [
10
+ 0.04, 0.08, 0.11, 0.12, 0.11, 0.11, 0.12, 0.13, 0.17, 0.2, 0.21, 0.22, 0.22, 0.21, 0.21, 0.22, 0.23, 0.24,
11
+ 0.24, 0.25, 0.26, 0.28, 0.28, 0.28, 0.25, 0.21, 0.17, 0.16, 0.19, 0.28, 0.34, 0.38, 0.4, 0.4, 0.39, 0.36,
12
+ 0.31, 0.24, 0.18, 0.16, 0.17, 0.26, 1, 0.76, 0.66, 0.54, 0.46, 0.45, 0.43, 0.37, 0.33, 0.34, 0.32, 0.31,
13
+ 0.28, 0.3, 0.31, 0.28, 0.23, 0.18, 0.18, 0.21, 0.32, 0.42, 0.5, 0.53, 0.55, 0.53, 0.49, 0.4, 0.31, 0.21,
14
+ 0.15, 0.16, 0.19, 0.23, 0.27, 0.36, 0.54, 0.52, 0.47, 0.43, 0.43, 0.39, 0.39, 0.36, 0.36, 0.45, 0.33, 0.3,
15
+ 0.27, 0.22, 0.16, 0.13, 0.14, 0.2, 0.26, 0.32, 0.36, 0.39, 0.39, 0.38, 0.35, 0.28, 0.2, 0.14, 0.12, 0.12,
16
+ 0.14, 0.14, 0.13, 0.12, 0.11, 0.08, 0.07, 0.06, 0.05, 0.03, 0.02, 0.01,
17
+ ];
18
+
19
+ export function Basic() {
20
+ return (
21
+ <div className="w-full max-w-md">
22
+ <AudioPlayer
23
+ src={`${FILES}/eclipse-score.m4a`}
24
+ title="Totality"
25
+ artist="Score for the eclipse short"
26
+ artwork={`${FILES}/eclipse-poster.jpg`}
27
+ peaks={SCORE_PEAKS}
28
+ />
29
+ </div>
30
+ );
31
+ }
32
+ ```
33
+
34
+ The browser's `<audio>` with its controls in the zon material — a sibling of the `VideoPlayer`. The waveform is the scrubber: 2px bars, played in foreground ink, the rest muted. Hovering shows the time under the pointer; a click jumps, a drag scrubs. A round raised play button anchors it, times sit at the waveform's ends in mono, and speed ("1×") and volume stay quiet.
35
+
36
+ ## Usage
37
+
38
+ ```tsx
39
+ import { AudioPlayer } from "@zonsh/ui";
40
+
41
+ <AudioPlayer
42
+ src={[
43
+ { src: "/media/lecture-4.webm", type: "audio/webm; codecs=opus" },
44
+ { src: "/media/lecture-4.m4a", type: "audio/mp4" },
45
+ ]}
46
+ title="Lecture 4 — Orbits, recap"
47
+ artist="Mon 6 Oct"
48
+ peaks={lecture.peaks}
49
+ />;
50
+ ```
51
+
52
+ The props you'll reach for: `src`, `title`, `peaks`.
53
+
54
+ ## When to use
55
+
56
+ - **`AudioPlayer`** for audio people listen to on purpose: a voice note, a lecture, a podcast, a track.
57
+ - **`variant="card"`** (default) for one recording on its own.
58
+ - **`layout="row"`** for a list of recordings, one per row under hairlines.
59
+ - **`layout="note"`** for a voice message inside a chat `Message`.
60
+ - **`variant="plain"`** without a surface: in a dialog, a sheet or on the Lightbox. **`variant="region"`** for a square surface, part of the page.
61
+ - **`VideoPlayer`** for anything with a picture. A sound with a still image is audio: give the image as `artwork`.
62
+ - Interface sounds: a plain `<audio>` without controls, played from your own button. A player asks people to do something.
63
+
64
+ ## Examples
65
+
66
+ ### Without peaks
67
+
68
+ Without `peaks` the waveform is a regular pattern made from the URL — stable per file, plainly not the sound. Pass real peaks where the shape helps people find their place, or `peaks="auto"` to decode the file in the browser once on screen.
69
+
70
+ ```tsx
71
+ import { AudioPlayer } from "@zonsh/ui";
72
+
73
+ // FILES: as in the first example on this page that uses them.
74
+
75
+ export function Placeholder() {
76
+ return (
77
+ <div className="w-full max-w-md">
78
+ {/* No peaks: a quiet pattern made from the URL stands in for the waveform. */}
79
+ <AudioPlayer src={`${FILES}/eclipse-chimes.m4a`} title="Voice note from Jonas" artist="Today, 09:41" />
80
+ </div>
81
+ );
82
+ }
83
+ ```
84
+
85
+ ### List
86
+
87
+ One line each; under 384px the waveform steps out. `preload="none"` loads nothing until played, and `duration` shows the length meanwhile. Playing one pauses the one before.
88
+
89
+ ```tsx
90
+ import { AudioPlayer } from "@zonsh/ui";
91
+
92
+ // FILES, SCORE_PEAKS: as in the first example on this page that uses them.
93
+
94
+ const RECORDINGS = [
95
+ {
96
+ id: "orbits",
97
+ title: "Lecture 4 — Orbits, recap",
98
+ date: "Mon 6 Oct",
99
+ file: "eclipse-score.m4a",
100
+ peaks: SCORE_PEAKS,
101
+ },
102
+ { id: "shadow", title: "Office hours: the Moon's shadow", date: "Wed 8 Oct", file: "eclipse-chimes.m4a" },
103
+ { id: "lab", title: "Lab notes, pinhole projector", date: "Thu 9 Oct", file: "eclipse-score.m4a" },
104
+ ];
105
+
106
+ export function List() {
107
+ return (
108
+ <ul className="w-full max-w-2xl divide-y divide-border/60 border-y border-border/60">
109
+ {RECORDINGS.map((r) => (
110
+ <li key={r.id} className="py-2.5">
111
+ <AudioPlayer
112
+ layout="row"
113
+ src={`${FILES}/${r.file}`}
114
+ title={r.title}
115
+ artist={r.date}
116
+ peaks={r.peaks}
117
+ // Nothing loads until it's played; the length is known from the list.
118
+ preload="none"
119
+ duration={12}
120
+ />
121
+ </li>
122
+ ))}
123
+ </ul>
124
+ );
125
+ }
126
+ ```
127
+
128
+ ### Voice note
129
+
130
+ The smallest: at most 384px wide, no surface, for a message card or an assistant's reply.
131
+
132
+ ```tsx
133
+ import { AudioPlayer, Message, MessageContent, MessageText } from "@zonsh/ui";
134
+
135
+ // FILES, SCORE_PEAKS: as in the first example on this page that uses them.
136
+
137
+ export function VoiceNote() {
138
+ return (
139
+ <div className="flex w-full max-w-2xl flex-col gap-6">
140
+ <Message from="user">
141
+ <MessageContent>
142
+ {/* The user's card holds it: a voice note has no surface of its own. */}
143
+ <MessageText className="[--card-padding:6px_10px_6px_6px]">
144
+ <AudioPlayer layout="note" src={`${FILES}/eclipse-chimes.m4a`} aria-label="Voice note" />
145
+ </MessageText>
146
+ </MessageContent>
147
+ </Message>
148
+ <Message from="assistant">
149
+ <MessageContent>
150
+ <MessageText>Here is the score for the eclipse short, as a preview:</MessageText>
151
+ <AudioPlayer
152
+ layout="note"
153
+ src={`${FILES}/eclipse-score.m4a`}
154
+ peaks={SCORE_PEAKS}
155
+ aria-label="Score preview"
156
+ />
157
+ </MessageContent>
158
+ </Message>
159
+ </div>
160
+ );
161
+ }
162
+ ```
163
+
164
+ ## Props
165
+
166
+ | Prop | Type | Default |
167
+ | -------------------------------- | --------------------------------------------------------------------------------------------------- | -------------------------------------- |
168
+ | `src` | `string \| { src, type? }[]`: one URL, or encodings in order | — |
169
+ | `title` | `string`: shown in Licht Sans, and the player's accessible name | — |
170
+ | `artist` | `string`: a muted line under the title — who, or when | — |
171
+ | `artwork` | `string`: a square image beside the title | — |
172
+ | `peaks` | `number[] \| "auto"`: from 0 to 1, or decoded in the browser once on screen | a pattern from the URL |
173
+ | `duration` | `number`: seconds, shown until the file's own length is known | — |
174
+ | `variant` | `"card" \| "region" \| "plain"`: the surface | `"card"`; `"plain"` in a row or a note |
175
+ | `layout` | `"default" \| "row" \| "note"` | `"default"` |
176
+ | `size` | `"default" \| "sm"`: the play button a step smaller | `"default"` |
177
+ | `autoPlay` | `boolean` | `false` |
178
+ | `loop` | `boolean` | `false` |
179
+ | `preload` | `"none" \| "metadata" \| "auto"` | `"metadata"` |
180
+ | `volumeStorageKey` | `string`: keeps the listener's volume and mute in localStorage under this key | — |
181
+ | `pauseOthers` | `boolean`: starting it with sound pauses the other players with sound | `true` |
182
+ | `speeds` | `number[] \| false`: the speed menu | `[0.5, 0.75, 1, 1.25, 1.5, 2]` |
183
+ | `onPlay` / `onPause` / `onEnded` | `() => void` | — |
184
+ | `onTimeUpdate` | `(seconds: number) => void`: as the playhead moves | — |
185
+ | `audioRef` | `Ref<HTMLAudioElement>`: the element, for anything else | — |
186
+ | `labels` | `Partial<AudioPlayerMessages>`: the player's words, over a LocaleProvider's | English |
187
+
188
+ Other props go to the root `div`; an `aria-label` there names a player without a title. Data attributes: `data-size`, `data-variant`, `data-layout`, `data-playing` while playing, `data-ready` once the length is known. The waveform sets `--audio-progress` (0 to 1) on the root as it plays, for anything of yours that should follow it, and has `data-placeholder` while it draws the pattern.
189
+
190
+ ## Brand rules
191
+
192
+ - **Do** title a recording by what it is ("Lecture 4 — Orbits, recap"), with a date or speaker as `artist`.
193
+ - **Do** compute peaks once and store them; never decode a file on every page view.
194
+ - **Don't** colour the waveform or the play button: played is foreground ink, the rest muted, as on every slider.
195
+ - **Don't** present the placeholder as the sound; where the shape matters, give real `peaks`.
196
+ - **Don't** autoplay; let people press play.
197
+ - **Don't** put the card in a card: use `layout="row"` in a list, `layout="note"` in a message, `variant="plain"` in a dialog.
198
+
199
+ ## Another language
200
+
201
+ The words come from a LocaleProvider's `audioPlayer` messages (German ships in `@zonsh/ui/messages/de`); `labels` replaces any of them for one player. Lengths of time are functions, so each language says them its own way.
202
+
203
+ ## Accessibility
204
+
205
+ - The player is a group named by its `title` (with the `artist`) or `aria-label`, and takes focus, so the shortcuts work after a click on it; tabbed to, it shows the focus ring.
206
+ - Play's name says what it does now ("Play", "Pause", "Play again"); mute says "Mute" or "Unmute"; the speed menu names its rate ("Speed, 1.5×").
207
+ - The waveform is a native range input named "Seek" that reads its value in words: "42 seconds of 3 minutes 15 seconds". The bars are for the eye only; with keyboard focus a ring goes round them and the playhead line shows.
208
+ - The timeline runs left to right on right-to-left pages too.
209
+ - A file that can't play says so in words and disables play.
210
+ - In forced colours, the played part takes the system highlight.
211
+ - Only the playhead moves (position, not motion); decoded peaks grow from the pattern, which reduced motion turns off.
212
+ - The volume button opens a popover with mute and the slider; on touch screens, where the device's buttons set volume, it isn't shown. `M` mutes from the keyboard.
213
+
214
+ ### Keyboard
215
+
216
+ With focus anywhere in the player:
217
+
218
+ | Keys | Action |
219
+ | -------------- | ------------------------- |
220
+ | `Space` / `K` | Play or pause |
221
+ | `←` / `→` | Back or forward 5 seconds |
222
+ | `↑` / `↓` | Volume up or down |
223
+ | `Home` / `End` | To the start or the end |
224
+ | `M` | Mute or unmute |
225
+
226
+ A control that was clicked rather than tabbed to hands its keys to the player: `Space` then plays or pauses instead of pressing it again. On the scrubber and the volume, the arrows, `Home` and `End` are the slider's; on the scrubber the arrows step five seconds and Page Up/Down ten.
227
+
228
+ ---
229
+
230
+ - Import: `import { AudioPlayer, audioPeaks } from "@zonsh/ui"`
231
+ - Source: `packages/ui/src/components/audio-player.tsx`
@@ -0,0 +1,98 @@
1
+ # Avatar
2
+
3
+ ```tsx
4
+ import { Avatar } from "@zonsh/ui";
5
+
6
+ export function Sizes() {
7
+ return (
8
+ <div className="flex items-center gap-4">
9
+ <Avatar size="sm" name="Anna Becker" />
10
+ <Avatar name="Jonas Weber" />
11
+ <Avatar size="lg" name="Lea Schmitz" />
12
+ </div>
13
+ );
14
+ }
15
+ ```
16
+
17
+ A person as a round image with a `--field-edge` ring, and mono initials from `name` while it loads or if it fails. 24, 32 and 40px; 80px (`xl`) for a profile page, 128px (`2xl`) for a picker.
18
+
19
+ ## Usage
20
+
21
+ ```tsx
22
+ import { Avatar, AvatarGroup } from "@zonsh/ui";
23
+
24
+ <Avatar name="Malik Mardan" src="/team/malik.jpg" />
25
+
26
+ <AvatarGroup max={3}>
27
+ <Avatar name="…" />
28
+ </AvatarGroup>;
29
+ ```
30
+
31
+ The props you'll reach for: `name`, `src`, `size`.
32
+
33
+ ## When to use
34
+
35
+ - The signed-in user, workspace members, a note's author — real people only, never stock faces.
36
+
37
+ ## Examples
38
+
39
+ ### Group
40
+
41
+ Past `max`, the rest collapse into `+N`.
42
+
43
+ ```tsx
44
+ import { Avatar, AvatarGroup } from "@zonsh/ui";
45
+
46
+ export function Group() {
47
+ return (
48
+ <div className="flex flex-col items-start gap-4">
49
+ <AvatarGroup max={3}>
50
+ <Avatar name="Anna Becker" />
51
+ <Avatar name="Jonas Weber" />
52
+ <Avatar name="Lea Schmitz" />
53
+ <Avatar name="Tom Fischer" />
54
+ <Avatar name="Mia Wagner" />
55
+ </AvatarGroup>
56
+ {/* Small: give the group the size too, so they overlap less and both initials show. */}
57
+ <AvatarGroup max={3} size="sm">
58
+ <Avatar size="sm" name="Anna Becker" />
59
+ <Avatar size="sm" name="Jonas Weber" />
60
+ <Avatar size="sm" name="Lea Schmitz" />
61
+ <Avatar size="sm" name="Tom Fischer" />
62
+ </AvatarGroup>
63
+ </div>
64
+ );
65
+ }
66
+ ```
67
+
68
+ ## Props
69
+
70
+ | Prop | Type | Default |
71
+ | ------------------- | -------------------------------------------- | ----------- |
72
+ | `Avatar.src` | `string` | — |
73
+ | `Avatar.name` | `string` — `alt` and initials | — |
74
+ | `Avatar.fallback` | `ReactNode` — overrides initials | derived |
75
+ | `Avatar.size` | `"sm" \| "default" \| "lg" \| "xl" \| "2xl"` | `"default"` |
76
+ | `Avatar.imageProps` | Base UI `Avatar.Image` props | — |
77
+ | `AvatarGroup.max` | `number` — then `+N` | — |
78
+ | `AvatarGroup.size` | the avatars' size: the overlap and the `+N` | `"default"` |
79
+
80
+ Other Base UI `Avatar.Root` props are forwarded.
81
+
82
+ ## Brand rules
83
+
84
+ - **Do** match sizes within a group.
85
+ - **Do** use a status colour for a presence dot only with a text equivalent (a `Badge` with a label); never colour alone.
86
+ - **Don't** colour avatars for decoration: no per-person background colours. A person is not a category.
87
+ - **Don't** show placeholder people in marketing material.
88
+
89
+ ## Accessibility
90
+
91
+ - The image's `alt` is `name`. The initials fallback is hidden from screen readers in favour of the full name.
92
+ - Omit `name` beside a visible name.
93
+
94
+ ---
95
+
96
+ - Import: `import { Avatar, AvatarGroup } from "@zonsh/ui"`
97
+ - Source: `packages/ui/src/components/avatar.tsx`
98
+ - Primitive: `@base-ui/react/avatar` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/avatar.md`)
@@ -0,0 +1,227 @@
1
+ # Badge
2
+
3
+ ```tsx
4
+ import { Badge, BadgeAnchor, Button } from "@zonsh/ui";
5
+ import { BellIcon } from "lucide-react";
6
+
7
+ export function Basic() {
8
+ return (
9
+ <BadgeAnchor>
10
+ <Button size="icon" variant="secondary" aria-label="Notifications, 3 unread">
11
+ <BellIcon />
12
+ </Button>
13
+ <Badge count={3} aria-hidden />
14
+ </BadgeAnchor>
15
+ );
16
+ }
17
+ ```
18
+
19
+ A round count or flag on an object: unread notifications on a bell, a person online, a new page. 20px tall (16px `sm`), Licht Mono tabular numerals, primary fill by default. `BadgeAnchor` pins it to the corner of an icon button, avatar or card, with a 2px cut-out in the page colour.
20
+
21
+ ## Usage
22
+
23
+ ```tsx
24
+ import { Badge, BadgeAnchor, Button } from "@zonsh/ui";
25
+ import { BellIcon } from "lucide-react";
26
+
27
+ <BadgeAnchor>
28
+ <Button size="icon" variant="secondary" aria-label="Notifications, 3 unread">
29
+ <BellIcon />
30
+ </Button>
31
+ <Badge count={3} aria-hidden />
32
+ </BadgeAnchor>;
33
+ ```
34
+
35
+ The props you'll reach for: `count`, `dot` (with `label`) and `variant`.
36
+
37
+ ## When to use
38
+
39
+ - A count on an icon button or avatar: `default` when it needs attention, `secondary` when it informs.
40
+ - A "NEW" marker beside a nav item or heading, as a `secondary` badge.
41
+ - A status dot on an avatar: online (`success`), away (`warning`), syncing (`info`), failed (`destructive`).
42
+ - A `Tag` names something ("TypeScript", "Draft") beside a title; a number or dot about an object is a badge. Progress is `Progress` or `Meter`.
43
+
44
+ ## Examples
45
+
46
+ ### Variants
47
+
48
+ `default` takes the primary fill, `secondary` the raised key surface. `tone` is a status colour, only for done, attention soon, news or failed.
49
+
50
+ ```tsx
51
+ import { Badge } from "@zonsh/ui";
52
+
53
+ export function Variants() {
54
+ return (
55
+ <div className="flex flex-wrap items-center gap-3">
56
+ <Badge count={4} />
57
+ <Badge variant="secondary" count={12} />
58
+ <Badge tone="success" count={2} label="sent" />
59
+ <Badge tone="warning" count={4} label="expiring" />
60
+ <Badge tone="info" count={6} label="new" />
61
+ <Badge tone="destructive" count={1} label="failed" />
62
+ <Badge variant="secondary">NEW</Badge>
63
+ </div>
64
+ );
65
+ }
66
+ ```
67
+
68
+ ### Counts
69
+
70
+ `count` caps at `max`: 128 reads "99+". Zero renders nothing. Use `size="sm"` on 30px controls.
71
+
72
+ ```tsx
73
+ import { Badge, BadgeAnchor, Button } from "@zonsh/ui";
74
+ import { BellIcon, InboxIcon, MessageSquareIcon } from "lucide-react";
75
+
76
+ export function Counts() {
77
+ return (
78
+ <div className="flex flex-wrap items-center gap-6">
79
+ <BadgeAnchor>
80
+ <Button size="icon" variant="secondary" aria-label="Messages, 8 unread">
81
+ <MessageSquareIcon />
82
+ </Button>
83
+ <Badge count={8} aria-hidden />
84
+ </BadgeAnchor>
85
+ <BadgeAnchor>
86
+ <Button size="icon" variant="secondary" aria-label="Inbox, 128 unread">
87
+ <InboxIcon />
88
+ </Button>
89
+ <Badge count={128} aria-hidden />
90
+ </BadgeAnchor>
91
+ <BadgeAnchor>
92
+ <Button size="icon-sm" variant="ghost" aria-label="Notifications, 5 unread">
93
+ <BellIcon />
94
+ </Button>
95
+ <Badge size="sm" variant="secondary" count={5} aria-hidden />
96
+ </BadgeAnchor>
97
+ <BadgeAnchor>
98
+ <Button size="icon" variant="secondary" aria-label="Notifications">
99
+ <BellIcon />
100
+ </Button>
101
+ <Badge count={0} aria-hidden />
102
+ </BadgeAnchor>
103
+ </div>
104
+ );
105
+ }
106
+ ```
107
+
108
+ ### Status dot
109
+
110
+ On an avatar use `placement="bottom-end"`. A dot always needs a `label`: colour alone tells a screen reader, or someone colour-blind, nothing.
111
+
112
+ ```tsx
113
+ import { Avatar, Badge, BadgeAnchor } from "@zonsh/ui";
114
+
115
+ export function StatusDot() {
116
+ return (
117
+ <div className="flex flex-wrap items-center gap-6">
118
+ <BadgeAnchor placement="bottom-end">
119
+ <Avatar size="lg" name="Anna Becker" />
120
+ <Badge dot tone="success" label="Online" />
121
+ </BadgeAnchor>
122
+ <BadgeAnchor placement="bottom-end">
123
+ <Avatar size="lg" name="Jonas Weber" />
124
+ <Badge dot tone="warning" label="Away" />
125
+ </BadgeAnchor>
126
+ <BadgeAnchor placement="bottom-end">
127
+ <Avatar size="lg" name="Lea Schmitz" />
128
+ <Badge dot tone="destructive" label="Sync failed" />
129
+ </BadgeAnchor>
130
+ <BadgeAnchor>
131
+ <Avatar name="Anna Becker" />
132
+ <Badge size="sm" count={2} label="unread messages" />
133
+ </BadgeAnchor>
134
+ </div>
135
+ );
136
+ }
137
+ ```
138
+
139
+ ### New marker
140
+
141
+ A small `secondary` badge after the text. One short word in capitals.
142
+
143
+ ```tsx
144
+ import { Badge, Button } from "@zonsh/ui";
145
+ import { ScrollTextIcon } from "lucide-react";
146
+
147
+ export function NewMarker() {
148
+ return (
149
+ <div className="flex flex-col items-start gap-4">
150
+ <p className="flex items-center gap-2 text-[15px]">
151
+ Document intake for scanned orders
152
+ <Badge variant="secondary" size="sm">
153
+ NEW
154
+ </Badge>
155
+ </p>
156
+ <Button variant="ghost">
157
+ <ScrollTextIcon />
158
+ Changelog
159
+ <Badge variant="secondary" size="sm">
160
+ NEW
161
+ </Badge>
162
+ </Button>
163
+ </div>
164
+ );
165
+ }
166
+ ```
167
+
168
+ ### On a card
169
+
170
+ `shape="rect"` pins the badge just inside the corner of a button or card. On a surface other than the page, set `--badge-cutout` to that surface's colour.
171
+
172
+ ```tsx
173
+ import { Badge, BadgeAnchor, Button } from "@zonsh/ui";
174
+ import { InboxIcon } from "lucide-react";
175
+
176
+ export function OnACard() {
177
+ return (
178
+ <div className="flex flex-wrap items-center gap-4 surface-card [--badge-cutout:var(--control-surface)] [--card-padding:24px]">
179
+ <BadgeAnchor shape="rect">
180
+ <Button variant="secondary">
181
+ <InboxIcon />
182
+ Review requests
183
+ </Button>
184
+ <Badge count={6} aria-hidden />
185
+ </BadgeAnchor>
186
+ <p className="min-w-40 flex-1 text-sm text-muted-foreground">6 requests wait for a reply.</p>
187
+ </div>
188
+ );
189
+ }
190
+ ```
191
+
192
+ ## Props
193
+
194
+ | Component | Prop | Type | Default |
195
+ | ------------- | ----------- | ------------------------------------------------------------------------------ | ----------- |
196
+ | `Badge` | `variant` | `"default" \| "secondary"` | `"default"` |
197
+ | `Badge` | `tone` | `"success" \| "warning" \| "info" \| "destructive"` — status only | — |
198
+ | `Badge` | `size` | `"sm"` (16px, dot 8px) \| `"default"` (20px, dot 10px) | `"default"` |
199
+ | `Badge` | `count` | `number` — zero, less or `NaN` renders nothing | — |
200
+ | `Badge` | `max` | `number` — above it the badge reads "99+" | `99` |
201
+ | `Badge` | `dot` | `boolean` — a dot with no text | `false` |
202
+ | `Badge` | `label` | `string` — screen-reader text, required with `dot` | — |
203
+ | `BadgeAnchor` | `shape` | `"circle" \| "rect"` | `"circle"` |
204
+ | `BadgeAnchor` | `placement` | `"top-end" \| "bottom-end"` | `"top-end"` |
205
+
206
+ Both render a `<span>`. `children` on `Badge` shows a word instead of a count. `BadgeAnchor` never outgrows its container: a long label ends in "…", badge still on the corner. Data attributes: badge `data-variant`, `data-tone`, `data-size`, `data-dot`; anchor `data-shape`, `data-placement`. CSS variable: `--badge-cutout` (default `--background`).
207
+
208
+ ## Brand rules
209
+
210
+ - **Do** keep most badges monochrome. A status colour means its status, nothing else.
211
+ - **Do** put a count on the object it counts, with `BadgeAnchor`, not floating beside it.
212
+ - **Don't** colour a "NEW" marker or a plain count to make it pop.
213
+ - **Don't** use a badge as a label for a thing ("TypeScript", "Draft"). That is a `Tag`.
214
+ - **Don't** show a badge for zero.
215
+
216
+ ## Accessibility
217
+
218
+ - A count on an icon button belongs in the button's `aria-label` ("Notifications, 3 unread"); hide the badge with `aria-hidden` so it is not read twice.
219
+ - A standalone badge reads its text; add `label` for context ("2 sent").
220
+ - A status dot needs `label` ("Online", "Sync failed"); colour is never the only signal.
221
+ - Announce a live count change from the control's label or a `role="status"` region, not the badge.
222
+ - The badge ignores the pointer; the control keeps its full click target.
223
+
224
+ ---
225
+
226
+ - Import: `import { Badge, BadgeAnchor } from "@zonsh/ui"`
227
+ - Source: `packages/ui/src/components/badge.tsx`