@zonsh/ui 0.4.1 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (562) hide show
  1. package/CHANGELOG.md +639 -0
  2. package/README.md +49 -21
  3. package/dist/brand.d.ts +3 -0
  4. package/dist/brand.js +7 -0
  5. package/dist/components/_breadcrumb-more.d.ts +6 -0
  6. package/dist/components/_breadcrumb-more.js +5 -0
  7. package/dist/components/_drawing-svg.d.ts +11 -0
  8. package/dist/components/_drawing-svg.js +30 -0
  9. package/dist/components/_media.d.ts +159 -0
  10. package/dist/components/_media.js +266 -0
  11. package/dist/components/_overlay.d.ts +8 -5
  12. package/dist/components/_overlay.js +11 -6
  13. package/dist/components/_scheduler-calendar.d.ts +71 -0
  14. package/dist/components/_scheduler-calendar.js +940 -0
  15. package/dist/components/_scheduler-editor.d.ts +29 -0
  16. package/dist/components/_scheduler-editor.js +111 -0
  17. package/dist/components/_scheduler-menu.d.ts +16 -0
  18. package/dist/components/_scheduler-menu.js +18 -0
  19. package/dist/components/_scheduler-parts.d.ts +164 -0
  20. package/dist/components/_scheduler-parts.js +327 -0
  21. package/dist/components/_suggest-list.d.ts +142 -0
  22. package/dist/components/_suggest-list.js +159 -0
  23. package/dist/components/_toolbar-more.d.ts +24 -0
  24. package/dist/components/_toolbar-more.js +25 -0
  25. package/dist/components/accordion.d.ts +1 -1
  26. package/dist/components/accordion.js +7 -7
  27. package/dist/components/action-sheet.d.ts +88 -0
  28. package/dist/components/action-sheet.js +124 -0
  29. package/dist/components/alert-dialog.js +3 -1
  30. package/dist/components/alert.d.ts +11 -18
  31. package/dist/components/alert.js +9 -6
  32. package/dist/components/app-bar.d.ts +93 -0
  33. package/dist/components/app-bar.js +175 -0
  34. package/dist/components/ascii-field.js +2 -1
  35. package/dist/components/audio-player.d.ts +134 -0
  36. package/dist/components/audio-player.js +618 -0
  37. package/dist/components/avatar.d.ts +6 -6
  38. package/dist/components/avatar.js +13 -11
  39. package/dist/components/badge.d.ts +12 -12
  40. package/dist/components/badge.js +7 -5
  41. package/dist/components/bottom-nav.d.ts +53 -11
  42. package/dist/components/bottom-nav.js +389 -24
  43. package/dist/components/breadcrumb.d.ts +11 -2
  44. package/dist/components/breadcrumb.js +60 -6
  45. package/dist/components/button-group.js +5 -1
  46. package/dist/components/button.d.ts +23 -6
  47. package/dist/components/button.js +64 -8
  48. package/dist/components/calendar.js +8 -6
  49. package/dist/components/card.d.ts +10 -8
  50. package/dist/components/card.js +15 -14
  51. package/dist/components/carousel.d.ts +2 -2
  52. package/dist/components/carousel.js +21 -8
  53. package/dist/components/chart.d.ts +38 -1
  54. package/dist/components/chart.js +27 -5
  55. package/dist/components/checkbox.js +2 -2
  56. package/dist/components/code-block.d.ts +9 -2
  57. package/dist/components/code-block.js +26 -7
  58. package/dist/components/collapsible.js +4 -4
  59. package/dist/components/color-picker.d.ts +2 -2
  60. package/dist/components/color-picker.js +5 -5
  61. package/dist/components/combobox.d.ts +26 -7
  62. package/dist/components/combobox.js +32 -13
  63. package/dist/components/command.d.ts +29 -5
  64. package/dist/components/command.js +37 -12
  65. package/dist/components/context-menu.d.ts +5 -2
  66. package/dist/components/context-menu.js +24 -3
  67. package/dist/components/conversation.d.ts +1 -1
  68. package/dist/components/conversation.js +77 -16
  69. package/dist/components/copy-button.d.ts +1 -1
  70. package/dist/components/copy-button.js +8 -6
  71. package/dist/components/data-table.d.ts +6 -6
  72. package/dist/components/data-table.js +41 -15
  73. package/dist/components/date-picker.d.ts +31 -9
  74. package/dist/components/date-picker.js +100 -18
  75. package/dist/components/dialog.d.ts +17 -10
  76. package/dist/components/dialog.js +20 -13
  77. package/dist/components/drawer.d.ts +26 -8
  78. package/dist/components/drawer.js +75 -16
  79. package/dist/components/drawing.d.ts +25 -0
  80. package/dist/components/drawing.js +32 -0
  81. package/dist/components/empty.js +2 -2
  82. package/dist/components/feature-list.d.ts +65 -13
  83. package/dist/components/feature-list.js +116 -15
  84. package/dist/components/field.js +2 -2
  85. package/dist/components/file-drop.d.ts +9 -7
  86. package/dist/components/file-drop.js +8 -43
  87. package/dist/components/filter-bar.d.ts +10 -9
  88. package/dist/components/filter-bar.js +42 -25
  89. package/dist/components/graph.d.ts +19 -3
  90. package/dist/components/graph.js +190 -28
  91. package/dist/components/illustration.js +53 -31
  92. package/dist/components/input-group.d.ts +6 -11
  93. package/dist/components/input-group.js +21 -19
  94. package/dist/components/input.d.ts +2 -2
  95. package/dist/components/input.js +3 -3
  96. package/dist/components/item.d.ts +9 -6
  97. package/dist/components/item.js +13 -8
  98. package/dist/components/kbd.d.ts +1 -1
  99. package/dist/components/kbd.js +1 -1
  100. package/dist/components/layout.d.ts +2 -1
  101. package/dist/components/layout.js +55 -11
  102. package/dist/components/lightbox.d.ts +76 -9
  103. package/dist/components/lightbox.js +354 -48
  104. package/dist/components/locale.d.ts +6 -6
  105. package/dist/components/logo.d.ts +21 -1
  106. package/dist/components/logo.js +32 -2
  107. package/dist/components/markdown-editor.d.ts +275 -0
  108. package/dist/components/markdown-editor.js +831 -0
  109. package/dist/components/mentions.d.ts +153 -0
  110. package/dist/components/mentions.js +507 -0
  111. package/dist/components/menu.d.ts +2 -1
  112. package/dist/components/menu.js +5 -4
  113. package/dist/components/menubar.d.ts +23 -5
  114. package/dist/components/menubar.js +153 -31
  115. package/dist/components/message.d.ts +62 -11
  116. package/dist/components/message.js +51 -14
  117. package/dist/components/meter.js +1 -1
  118. package/dist/components/money-input.d.ts +1 -1
  119. package/dist/components/money-input.js +1 -1
  120. package/dist/components/native-select.d.ts +2 -2
  121. package/dist/components/native-select.js +4 -4
  122. package/dist/components/navigation-menu.d.ts +3 -1
  123. package/dist/components/navigation-menu.js +23 -10
  124. package/dist/components/number-field.d.ts +2 -9
  125. package/dist/components/number-field.js +90 -26
  126. package/dist/components/number-roll.d.ts +26 -0
  127. package/dist/components/number-roll.js +81 -0
  128. package/dist/components/otp-field.d.ts +1 -1
  129. package/dist/components/otp-field.js +24 -3
  130. package/dist/components/pagination.d.ts +11 -3
  131. package/dist/components/pagination.js +59 -13
  132. package/dist/components/pdf-viewer.d.ts +1 -1
  133. package/dist/components/pdf-viewer.js +8 -8
  134. package/dist/components/phone-input.d.ts +1 -1
  135. package/dist/components/phone-input.js +2 -2
  136. package/dist/components/popover.js +5 -3
  137. package/dist/components/preview-card.d.ts +37 -2
  138. package/dist/components/preview-card.js +226 -2
  139. package/dist/components/progress.js +1 -1
  140. package/dist/components/prompt-input.d.ts +1 -1
  141. package/dist/components/prompt-input.js +35 -17
  142. package/dist/components/pull-to-refresh.d.ts +50 -0
  143. package/dist/components/pull-to-refresh.js +189 -0
  144. package/dist/components/quote.d.ts +6 -1
  145. package/dist/components/quote.js +3 -2
  146. package/dist/components/radio-group.js +8 -3
  147. package/dist/components/rating.d.ts +4 -1
  148. package/dist/components/rating.js +131 -10
  149. package/dist/components/reasoning.d.ts +1 -1
  150. package/dist/components/reasoning.js +7 -3
  151. package/dist/components/resizable.d.ts +1 -1
  152. package/dist/components/resizable.js +2 -2
  153. package/dist/components/response.d.ts +4 -3
  154. package/dist/components/response.js +39 -15
  155. package/dist/components/scheduler.d.ts +352 -0
  156. package/dist/components/scheduler.js +1717 -0
  157. package/dist/components/scroll-area.js +1 -1
  158. package/dist/components/select.d.ts +17 -4
  159. package/dist/components/select.js +140 -9
  160. package/dist/components/separator.d.ts +1 -1
  161. package/dist/components/separator.js +3 -3
  162. package/dist/components/sidebar.d.ts +44 -3
  163. package/dist/components/sidebar.js +90 -31
  164. package/dist/components/site-header.d.ts +18 -13
  165. package/dist/components/site-header.js +26 -9
  166. package/dist/components/skeleton.d.ts +18 -8
  167. package/dist/components/skeleton.js +23 -8
  168. package/dist/components/slider.js +2 -2
  169. package/dist/components/sortable.d.ts +55 -4
  170. package/dist/components/sortable.js +187 -94
  171. package/dist/components/sources.d.ts +1 -1
  172. package/dist/components/sources.js +2 -2
  173. package/dist/components/spinner.d.ts +4 -4
  174. package/dist/components/spinner.js +4 -4
  175. package/dist/components/stat.d.ts +21 -4
  176. package/dist/components/stat.js +17 -8
  177. package/dist/components/stepper.d.ts +1 -1
  178. package/dist/components/stepper.js +8 -7
  179. package/dist/components/suggestions.d.ts +11 -3
  180. package/dist/components/suggestions.js +10 -4
  181. package/dist/components/swipe-actions.d.ts +66 -0
  182. package/dist/components/swipe-actions.js +292 -0
  183. package/dist/components/switch.js +1 -1
  184. package/dist/components/table.d.ts +13 -7
  185. package/dist/components/table.js +124 -23
  186. package/dist/components/tabs.js +15 -8
  187. package/dist/components/tag.d.ts +19 -20
  188. package/dist/components/tag.js +9 -5
  189. package/dist/components/tags-input.d.ts +2 -7
  190. package/dist/components/tags-input.js +11 -8
  191. package/dist/components/textarea.d.ts +3 -2
  192. package/dist/components/textarea.js +4 -3
  193. package/dist/components/theme.d.ts +50 -7
  194. package/dist/components/theme.js +168 -12
  195. package/dist/components/time-field.d.ts +6 -10
  196. package/dist/components/time-field.js +19 -9
  197. package/dist/components/timeline.d.ts +19 -3
  198. package/dist/components/timeline.js +21 -9
  199. package/dist/components/tippy.d.ts +17 -1
  200. package/dist/components/tippy.js +95 -15
  201. package/dist/components/toast.d.ts +2 -7
  202. package/dist/components/toast.js +12 -8
  203. package/dist/components/toggle-group.d.ts +7 -1
  204. package/dist/components/toggle-group.js +17 -5
  205. package/dist/components/toggle.d.ts +2 -2
  206. package/dist/components/toggle.js +3 -2
  207. package/dist/components/tool-call.d.ts +1 -1
  208. package/dist/components/tool-call.js +8 -3
  209. package/dist/components/toolbar.d.ts +57 -4
  210. package/dist/components/toolbar.js +219 -16
  211. package/dist/components/tooltip.d.ts +5 -3
  212. package/dist/components/tooltip.js +14 -6
  213. package/dist/components/tour.d.ts +1 -1
  214. package/dist/components/tour.js +70 -24
  215. package/dist/components/tree.js +33 -10
  216. package/dist/components/typography.d.ts +31 -8
  217. package/dist/components/typography.js +21 -10
  218. package/dist/components/video-player.d.ts +7 -2
  219. package/dist/components/video-player.js +182 -225
  220. package/dist/index.d.ts +99 -92
  221. package/dist/index.js +99 -92
  222. package/dist/lib/calendar.d.ts +153 -0
  223. package/dist/lib/calendar.js +312 -0
  224. package/dist/lib/cn.d.ts +3 -1
  225. package/dist/lib/cn.js +5 -0
  226. package/dist/lib/code-highlight.d.ts +14 -0
  227. package/dist/lib/code-highlight.js +81 -18
  228. package/dist/lib/drag.d.ts +39 -0
  229. package/dist/lib/drag.js +96 -0
  230. package/dist/lib/editorial-assets.js +16 -8
  231. package/dist/lib/figure/figures/automation.js +25 -6
  232. package/dist/lib/figure/figures/bar-chart.js +6 -1
  233. package/dist/lib/figure/figures/brackets-classic.js +4 -1
  234. package/dist/lib/figure/figures/city.js +12 -2
  235. package/dist/lib/figure/figures/conveyor.js +17 -4
  236. package/dist/lib/figure/figures/database.js +5 -2
  237. package/dist/lib/figure/figures/documents.js +11 -3
  238. package/dist/lib/figure/figures/inbox.js +5 -2
  239. package/dist/lib/figure/figures/laptop.js +3 -1
  240. package/dist/lib/figure/figures/pipeline.js +45 -10
  241. package/dist/lib/figure/figures/platform.js +62 -7
  242. package/dist/lib/figure/figures/server.js +21 -5
  243. package/dist/lib/figure/figures/spreadsheet.js +29 -5
  244. package/dist/lib/figure/kernel.d.ts +4 -2
  245. package/dist/lib/figure/kernel.js +10 -5
  246. package/dist/lib/figure/parts.js +6 -2
  247. package/dist/lib/files.d.ts +31 -0
  248. package/dist/lib/files.js +60 -0
  249. package/dist/lib/gesture.d.ts +70 -0
  250. package/dist/lib/gesture.js +141 -0
  251. package/dist/lib/glide.d.ts +10 -4
  252. package/dist/lib/glide.js +14 -5
  253. package/dist/lib/icons.d.ts +1 -0
  254. package/dist/lib/icons.js +6 -0
  255. package/dist/lib/illustration-library.js +1 -6
  256. package/dist/lib/markdown-edit.d.ts +112 -0
  257. package/dist/lib/markdown-edit.js +557 -0
  258. package/dist/lib/markdown-rich-editor.d.ts +188 -0
  259. package/dist/lib/markdown-rich-editor.js +1153 -0
  260. package/dist/lib/markdown-rich.d.ts +63 -0
  261. package/dist/lib/markdown-rich.js +534 -0
  262. package/dist/lib/mentions.d.ts +100 -0
  263. package/dist/lib/mentions.js +246 -0
  264. package/dist/lib/motion.d.ts +18 -0
  265. package/dist/lib/motion.js +43 -5
  266. package/dist/lib/number-roll.d.ts +89 -0
  267. package/dist/lib/number-roll.js +391 -0
  268. package/dist/lib/platform.d.ts +6 -0
  269. package/dist/lib/platform.js +14 -0
  270. package/dist/lib/portal-container.d.ts +9 -0
  271. package/dist/lib/portal-container.js +10 -0
  272. package/dist/lib/press.d.ts +5 -0
  273. package/dist/lib/press.js +186 -0
  274. package/dist/lib/scheduler.d.ts +128 -0
  275. package/dist/lib/scheduler.js +272 -0
  276. package/dist/lib/scroll-edges.d.ts +9 -0
  277. package/dist/lib/scroll-edges.js +50 -0
  278. package/dist/lib/table-fit.d.ts +4 -3
  279. package/dist/lib/table-fit.js +92 -25
  280. package/dist/lib/theme-preset.d.ts +267 -0
  281. package/dist/lib/theme-preset.js +1046 -0
  282. package/dist/lib/theme-script.d.ts +23 -3
  283. package/dist/lib/theme-script.js +17 -5
  284. package/dist/lib/tippy/sprite.d.ts +36 -4
  285. package/dist/lib/tippy/sprite.js +188 -15
  286. package/dist/lib/tone.d.ts +4 -0
  287. package/dist/lib/tone.js +1 -0
  288. package/dist/messages/de.d.ts +3 -3
  289. package/dist/messages/de.js +274 -3
  290. package/dist/skills/zon-ui/SKILL.md +279 -0
  291. package/dist/skills/zon-ui/references/authoring.md +265 -0
  292. package/dist/skills/zon-ui/references/brand.md +416 -0
  293. package/dist/skills/zon-ui/references/components/accordion.md +199 -0
  294. package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
  295. package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
  296. package/dist/skills/zon-ui/references/components/alert.md +167 -0
  297. package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
  298. package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
  299. package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
  300. package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
  301. package/dist/skills/zon-ui/references/components/avatar.md +98 -0
  302. package/dist/skills/zon-ui/references/components/badge.md +227 -0
  303. package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
  304. package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
  305. package/dist/skills/zon-ui/references/components/button-group.md +216 -0
  306. package/dist/skills/zon-ui/references/components/button.md +309 -0
  307. package/dist/skills/zon-ui/references/components/calendar.md +296 -0
  308. package/dist/skills/zon-ui/references/components/card.md +158 -0
  309. package/dist/skills/zon-ui/references/components/carousel.md +297 -0
  310. package/dist/skills/zon-ui/references/components/chart.md +739 -0
  311. package/dist/skills/zon-ui/references/components/chat.md +417 -0
  312. package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
  313. package/dist/skills/zon-ui/references/components/code-block.md +143 -0
  314. package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
  315. package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
  316. package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
  317. package/dist/skills/zon-ui/references/components/combobox.md +455 -0
  318. package/dist/skills/zon-ui/references/components/command.md +326 -0
  319. package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
  320. package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
  321. package/dist/skills/zon-ui/references/components/conversation.md +146 -0
  322. package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
  323. package/dist/skills/zon-ui/references/components/crm.md +1022 -0
  324. package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
  325. package/dist/skills/zon-ui/references/components/data-table.md +776 -0
  326. package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
  327. package/dist/skills/zon-ui/references/components/dialog.md +335 -0
  328. package/dist/skills/zon-ui/references/components/direction.md +165 -0
  329. package/dist/skills/zon-ui/references/components/drawer.md +276 -0
  330. package/dist/skills/zon-ui/references/components/drawing.md +94 -0
  331. package/dist/skills/zon-ui/references/components/empty.md +225 -0
  332. package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
  333. package/dist/skills/zon-ui/references/components/field.md +209 -0
  334. package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
  335. package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
  336. package/dist/skills/zon-ui/references/components/form.md +970 -0
  337. package/dist/skills/zon-ui/references/components/graph.md +339 -0
  338. package/dist/skills/zon-ui/references/components/illustration.md +497 -0
  339. package/dist/skills/zon-ui/references/components/inbox.md +263 -0
  340. package/dist/skills/zon-ui/references/components/input-group.md +339 -0
  341. package/dist/skills/zon-ui/references/components/input.md +189 -0
  342. package/dist/skills/zon-ui/references/components/item.md +277 -0
  343. package/dist/skills/zon-ui/references/components/kanban.md +626 -0
  344. package/dist/skills/zon-ui/references/components/kbd.md +116 -0
  345. package/dist/skills/zon-ui/references/components/label.md +104 -0
  346. package/dist/skills/zon-ui/references/components/layout.md +291 -0
  347. package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
  348. package/dist/skills/zon-ui/references/components/locale.md +279 -0
  349. package/dist/skills/zon-ui/references/components/logo.md +257 -0
  350. package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
  351. package/dist/skills/zon-ui/references/components/mentions.md +512 -0
  352. package/dist/skills/zon-ui/references/components/menu.md +218 -0
  353. package/dist/skills/zon-ui/references/components/menubar.md +292 -0
  354. package/dist/skills/zon-ui/references/components/message.md +243 -0
  355. package/dist/skills/zon-ui/references/components/meter.md +105 -0
  356. package/dist/skills/zon-ui/references/components/money-input.md +333 -0
  357. package/dist/skills/zon-ui/references/components/native-select.md +197 -0
  358. package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
  359. package/dist/skills/zon-ui/references/components/number-field.md +210 -0
  360. package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
  361. package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
  362. package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
  363. package/dist/skills/zon-ui/references/components/pagination.md +109 -0
  364. package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
  365. package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
  366. package/dist/skills/zon-ui/references/components/popover.md +176 -0
  367. package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
  368. package/dist/skills/zon-ui/references/components/pricing.md +724 -0
  369. package/dist/skills/zon-ui/references/components/progress.md +92 -0
  370. package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
  371. package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
  372. package/dist/skills/zon-ui/references/components/quote.md +115 -0
  373. package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
  374. package/dist/skills/zon-ui/references/components/rating.md +260 -0
  375. package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
  376. package/dist/skills/zon-ui/references/components/resizable.md +213 -0
  377. package/dist/skills/zon-ui/references/components/response.md +170 -0
  378. package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
  379. package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
  380. package/dist/skills/zon-ui/references/components/select.md +351 -0
  381. package/dist/skills/zon-ui/references/components/separator.md +103 -0
  382. package/dist/skills/zon-ui/references/components/settings.md +793 -0
  383. package/dist/skills/zon-ui/references/components/shop.md +1715 -0
  384. package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
  385. package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
  386. package/dist/skills/zon-ui/references/components/site-header.md +303 -0
  387. package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
  388. package/dist/skills/zon-ui/references/components/slider.md +172 -0
  389. package/dist/skills/zon-ui/references/components/sortable.md +405 -0
  390. package/dist/skills/zon-ui/references/components/sources.md +106 -0
  391. package/dist/skills/zon-ui/references/components/spinner.md +222 -0
  392. package/dist/skills/zon-ui/references/components/stat.md +267 -0
  393. package/dist/skills/zon-ui/references/components/stepper.md +285 -0
  394. package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
  395. package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
  396. package/dist/skills/zon-ui/references/components/switch.md +160 -0
  397. package/dist/skills/zon-ui/references/components/table.md +999 -0
  398. package/dist/skills/zon-ui/references/components/tabs.md +258 -0
  399. package/dist/skills/zon-ui/references/components/tag.md +115 -0
  400. package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
  401. package/dist/skills/zon-ui/references/components/textarea.md +95 -0
  402. package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
  403. package/dist/skills/zon-ui/references/components/theme.md +362 -0
  404. package/dist/skills/zon-ui/references/components/time-field.md +222 -0
  405. package/dist/skills/zon-ui/references/components/timeline.md +285 -0
  406. package/dist/skills/zon-ui/references/components/tippy.md +243 -0
  407. package/dist/skills/zon-ui/references/components/toast.md +220 -0
  408. package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
  409. package/dist/skills/zon-ui/references/components/toggle.md +167 -0
  410. package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
  411. package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
  412. package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
  413. package/dist/skills/zon-ui/references/components/tour.md +423 -0
  414. package/dist/skills/zon-ui/references/components/tree.md +481 -0
  415. package/dist/skills/zon-ui/references/components/typography.md +347 -0
  416. package/dist/skills/zon-ui/references/components/video-player.md +386 -0
  417. package/dist/skills/zon-ui/references/marketing.md +467 -0
  418. package/dist/skills/zon-ui/references/motion.md +455 -0
  419. package/dist/skills/zon-ui/references/recipes.md +1232 -0
  420. package/dist/skills/zon-ui/references/tokens.md +866 -0
  421. package/dist/sources/accordion.css +4 -0
  422. package/dist/sources/action-sheet.css +11 -0
  423. package/dist/sources/alert-dialog.css +6 -0
  424. package/dist/sources/alert.css +3 -0
  425. package/dist/sources/app-bar.css +14 -0
  426. package/dist/sources/ascii-field.css +3 -0
  427. package/dist/sources/aspect-ratio.css +3 -0
  428. package/dist/sources/audio-player.css +20 -0
  429. package/dist/sources/avatar.css +3 -0
  430. package/dist/sources/badge.css +3 -0
  431. package/dist/sources/bottom-nav.css +9 -0
  432. package/dist/sources/breadcrumb.css +14 -0
  433. package/dist/sources/button-group.css +3 -0
  434. package/dist/sources/button.css +9 -0
  435. package/dist/sources/calendar.css +13 -0
  436. package/dist/sources/card.css +3 -0
  437. package/dist/sources/carousel.css +11 -0
  438. package/dist/sources/chart.css +5 -0
  439. package/dist/sources/checkbox.css +6 -0
  440. package/dist/sources/code-block.css +13 -0
  441. package/dist/sources/collapsible.css +4 -0
  442. package/dist/sources/color-picker.css +13 -0
  443. package/dist/sources/combobox.css +13 -0
  444. package/dist/sources/command.css +13 -0
  445. package/dist/sources/context-menu.css +12 -0
  446. package/dist/sources/conversation.css +10 -0
  447. package/dist/sources/copy-button.css +10 -0
  448. package/dist/sources/data-table.css +27 -0
  449. package/dist/sources/date-picker.css +20 -0
  450. package/dist/sources/dialog.css +9 -0
  451. package/dist/sources/direction.css +2 -0
  452. package/dist/sources/drawer.css +9 -0
  453. package/dist/sources/drawing.css +5 -0
  454. package/dist/sources/empty.css +3 -0
  455. package/dist/sources/feature-list.css +4 -0
  456. package/dist/sources/field.css +4 -0
  457. package/dist/sources/file-drop.css +15 -0
  458. package/dist/sources/filter-bar.css +30 -0
  459. package/dist/sources/form.css +4 -0
  460. package/dist/sources/graph.css +19 -0
  461. package/dist/sources/illustration.css +28 -0
  462. package/dist/sources/input-group.css +7 -0
  463. package/dist/sources/input.css +3 -0
  464. package/dist/sources/item.css +4 -0
  465. package/dist/sources/kbd.css +5 -0
  466. package/dist/sources/label.css +3 -0
  467. package/dist/sources/layout.css +3 -0
  468. package/dist/sources/lightbox.css +33 -0
  469. package/dist/sources/locale.css +2 -0
  470. package/dist/sources/logo.css +4 -0
  471. package/dist/sources/markdown-editor.css +41 -0
  472. package/dist/sources/mentions.css +13 -0
  473. package/dist/sources/menu.css +11 -0
  474. package/dist/sources/menubar.css +14 -0
  475. package/dist/sources/message.css +16 -0
  476. package/dist/sources/meter.css +4 -0
  477. package/dist/sources/money-input.css +10 -0
  478. package/dist/sources/native-select.css +4 -0
  479. package/dist/sources/navigation-menu.css +8 -0
  480. package/dist/sources/number-field.css +8 -0
  481. package/dist/sources/number-roll.css +6 -0
  482. package/dist/sources/otp-field.css +5 -0
  483. package/dist/sources/pagination.css +11 -0
  484. package/dist/sources/pdf-viewer.css +30 -0
  485. package/dist/sources/phone-input.css +20 -0
  486. package/dist/sources/popover.css +7 -0
  487. package/dist/sources/preview-card.css +7 -0
  488. package/dist/sources/progress.css +4 -0
  489. package/dist/sources/prompt-input.css +15 -0
  490. package/dist/sources/pull-to-refresh.css +14 -0
  491. package/dist/sources/quote.css +3 -0
  492. package/dist/sources/radio-group.css +5 -0
  493. package/dist/sources/rating.css +6 -0
  494. package/dist/sources/reasoning.css +6 -0
  495. package/dist/sources/resizable.css +4 -0
  496. package/dist/sources/response.css +16 -0
  497. package/dist/sources/scheduler.css +44 -0
  498. package/dist/sources/scroll-area.css +3 -0
  499. package/dist/sources/select.css +12 -0
  500. package/dist/sources/separator.css +3 -0
  501. package/dist/sources/sidebar.css +19 -0
  502. package/dist/sources/site-header.css +15 -0
  503. package/dist/sources/skeleton.css +3 -0
  504. package/dist/sources/slider.css +6 -0
  505. package/dist/sources/sortable.css +12 -0
  506. package/dist/sources/sources.css +6 -0
  507. package/dist/sources/spinner.css +6 -0
  508. package/dist/sources/stat.css +9 -0
  509. package/dist/sources/stepper.css +6 -0
  510. package/dist/sources/suggestions.css +10 -0
  511. package/dist/sources/swipe-actions.css +20 -0
  512. package/dist/sources/switch.css +5 -0
  513. package/dist/sources/table.css +7 -0
  514. package/dist/sources/tabs.css +5 -0
  515. package/dist/sources/tag.css +3 -0
  516. package/dist/sources/tags-input.css +6 -0
  517. package/dist/sources/textarea.css +3 -0
  518. package/dist/sources/theme.css +13 -0
  519. package/dist/sources/time-field.css +7 -0
  520. package/dist/sources/timeline.css +7 -0
  521. package/dist/sources/tippy.css +6 -0
  522. package/dist/sources/toast.css +6 -0
  523. package/dist/sources/toggle-group.css +5 -0
  524. package/dist/sources/toggle.css +3 -0
  525. package/dist/sources/tool-call.css +16 -0
  526. package/dist/sources/toolbar.css +14 -0
  527. package/dist/sources/tooltip.css +6 -0
  528. package/dist/sources/tour.css +14 -0
  529. package/dist/sources/tree.css +6 -0
  530. package/dist/sources/typography.css +4 -0
  531. package/dist/sources/video-player.css +21 -0
  532. package/dist/styles/ai.css +3 -0
  533. package/dist/styles/brand.css +98 -0
  534. package/dist/styles/core.css +266 -0
  535. package/dist/styles/editor.css +3 -0
  536. package/dist/styles/expressive.css +75 -77
  537. package/dist/styles/fonts.css +61 -117
  538. package/dist/styles/graph.css +4 -0
  539. package/dist/styles/illustration.css +4 -0
  540. package/dist/styles/index.css +11 -193
  541. package/dist/styles/material.css +177 -31
  542. package/dist/styles/parts/ai.css +20 -14
  543. package/dist/styles/parts/brand.css +2 -2
  544. package/dist/styles/parts/controls.css +51 -38
  545. package/dist/styles/parts/data.css +43 -11
  546. package/dist/styles/parts/editor.css +372 -0
  547. package/dist/styles/parts/feedback.css +75 -15
  548. package/dist/styles/parts/foundations.css +12 -7
  549. package/dist/styles/parts/graph.css +25 -9
  550. package/dist/styles/parts/inputs.css +172 -9
  551. package/dist/styles/parts/isometric.css +6 -5
  552. package/dist/styles/parts/navigation.css +237 -25
  553. package/dist/styles/parts/overlays.css +110 -8
  554. package/dist/styles/parts/pdf.css +15 -9
  555. package/dist/styles/pdf.css +3 -0
  556. package/dist/styles/prose.css +3 -0
  557. package/dist/styles/tokens.css +105 -15
  558. package/dist/theme.d.ts +1 -0
  559. package/dist/theme.js +5 -0
  560. package/dist/vite.d.ts +48 -59
  561. package/dist/vite.js +54 -21
  562. package/package.json +69 -2
@@ -0,0 +1,175 @@
1
+ "use client";
2
+ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import * as React from "react";
4
+ import { ChevronLeftIcon, SearchIcon, XIcon } from "../lib/icons.js";
5
+ import { cn } from "../lib/cn.js";
6
+ import { mergeRefs } from "../lib/merge-refs.js";
7
+ import { usePressFeedback } from "../lib/press.js";
8
+ import { Button } from "./button.js";
9
+ import { InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, } from "./input-group.js";
10
+ import { useMessages } from "./locale.js";
11
+ const defaultMessages = {
12
+ back: "Back",
13
+ backTo: (title) => `Back to ${title}`,
14
+ search: "Search",
15
+ clear: "Clear search",
16
+ };
17
+ /** Scroll (px) over which the bar takes the page ground. */
18
+ const GROUND_SPAN = 8;
19
+ const clamp01 = (n) => Math.min(1, Math.max(0, n));
20
+ /** The nearest ancestor that scrolls vertically, or `null` for the window. */
21
+ function scrollParent(from) {
22
+ const page = document.scrollingElement ?? document.documentElement;
23
+ for (let el = from.parentElement; el && el !== page && el !== document.body; el = el.parentElement) {
24
+ if (/auto|scroll/.test(getComputedStyle(el).overflowY))
25
+ return el;
26
+ }
27
+ return null;
28
+ }
29
+ /**
30
+ * Ties the bar to the scroll position of whatever it scrolls in (its nearest scrolling ancestor,
31
+ * or the window): `--app-bar-ground` (the page ground, in over the first 8px), `--app-bar-title`
32
+ * (the small title, in as the large one goes under the bar) and `--app-bar-line` (the hairline,
33
+ * once it has). Written straight to the element once a frame, never through React.
34
+ */
35
+ function useScrollLink(header, large, forced) {
36
+ React.useEffect(() => {
37
+ const bar = header.current;
38
+ if (!bar)
39
+ return;
40
+ const set = (ground, title, line) => {
41
+ bar.style.setProperty("--app-bar-ground", ground.toFixed(3));
42
+ bar.style.setProperty("--app-bar-title", title.toFixed(3));
43
+ bar.style.setProperty("--app-bar-line", line.toFixed(3));
44
+ bar.toggleAttribute("data-scrolled", line >= 1);
45
+ bar.toggleAttribute("data-collapsed", title >= 1);
46
+ };
47
+ if (forced !== undefined) {
48
+ const on = forced ? 1 : 0;
49
+ set(on, large.current ? on : 1, on);
50
+ return;
51
+ }
52
+ const scroller = scrollParent(bar);
53
+ const read = () => (scroller ? scroller.scrollTop : window.scrollY);
54
+ let frame = 0;
55
+ const update = () => {
56
+ frame = 0;
57
+ const y = Math.max(0, read());
58
+ const ground = clamp01(y / GROUND_SPAN);
59
+ const span = large.current?.offsetHeight ?? 0;
60
+ if (!span) {
61
+ set(ground, 1, ground);
62
+ return;
63
+ }
64
+ // The small title comes in over the last 40% of the large one's way under the bar, and the
65
+ // hairline over its last 8px: the bar is drawn whole once the large title has gone.
66
+ const collapse = clamp01(y / span);
67
+ set(ground, clamp01((collapse - 0.6) / 0.4), clamp01((y - span + GROUND_SPAN) / GROUND_SPAN));
68
+ };
69
+ const schedule = () => {
70
+ if (!frame)
71
+ frame = requestAnimationFrame(update);
72
+ };
73
+ update();
74
+ const target = scroller ?? window;
75
+ target.addEventListener("scroll", schedule, { passive: true });
76
+ window.addEventListener("resize", schedule);
77
+ return () => {
78
+ if (frame)
79
+ cancelAnimationFrame(frame);
80
+ target.removeEventListener("scroll", schedule);
81
+ window.removeEventListener("resize", schedule);
82
+ };
83
+ }, [header, large, forced]);
84
+ }
85
+ /**
86
+ * AppBar — the top bar of a phone screen: a back button at the start, the title, and up to three
87
+ * actions at the end, sticky at the top of what scrolls, clear of the status bar and the rounded
88
+ * corners (safe-area insets). Over the content it takes the page ground and a hairline, as
89
+ * SiteHeader does, tied to the scroll position. With `largeTitle` the title sits large under the
90
+ * bar and folds into it as the screen scrolls; `search` puts a field under it.
91
+ *
92
+ * Put it first inside the element that scrolls (or the page), as a sibling of the content: it
93
+ * renders the bar and, with `largeTitle` or `search`, the large header after it, so the bar can
94
+ * stick while the large title scrolls away. The rule people break: a row of more than three
95
+ * actions — the rest belong in a menu behind one.
96
+ */
97
+ export function AppBar({ title, largeTitle = false, back, actions, search, headingLevel = 1, scrolled, className, style, ref, ...props }) {
98
+ const own = React.useRef(null);
99
+ const largeRef = React.useRef(null);
100
+ useScrollLink(own, largeRef, scrolled);
101
+ const Heading = `h${headingLevel}`;
102
+ const initial = scrolled ? 1 : 0;
103
+ return (_jsxs(_Fragment, { children: [_jsxs("header", { ref: mergeRefs(own, ref), "data-slot": "app-bar", "data-large-title": largeTitle ? "" : undefined, className: cn("sticky top-0 isolate z-30 border-b border-transparent font-body text-foreground", "ps-[env(safe-area-inset-left,0px)] pe-[env(safe-area-inset-right,0px)] pt-[env(safe-area-inset-top,0px)]", className), style: {
104
+ "--app-bar-ground": initial,
105
+ "--app-bar-title": largeTitle ? initial : 1,
106
+ "--app-bar-line": initial,
107
+ ...style,
108
+ }, ...props, children: [_jsx("div", { "data-slot": "app-bar-ground", "aria-hidden": true }), _jsxs("div", { "data-slot": "app-bar-row", className: "grid min-h-14 grid-cols-[minmax(0,1fr)_auto_minmax(0,1fr)] items-center gap-2 px-2", children: [_jsx("div", { "data-slot": "app-bar-leading", className: "flex min-w-0 items-center justify-start", children: back }), largeTitle ? (_jsx("div", { "data-slot": "app-bar-title", "aria-hidden": true, className: "max-w-[min(60vw,20rem)] truncate text-center text-16 font-medium opacity-(--app-bar-title)", children: title })) : (_jsx(Heading, { "data-slot": "app-bar-title", className: "max-w-[min(60vw,20rem)] truncate text-center text-16 font-medium", children: title })), _jsx("div", { "data-slot": "app-bar-actions", className: "flex min-w-0 items-center justify-end gap-1", children: actions })] }), !largeTitle && search && (_jsx("div", { "data-slot": "app-bar-search-row", className: "px-4 pb-3", children: search }))] }), largeTitle && (_jsxs("div", { "data-slot": "app-bar-large", className: "ps-[env(safe-area-inset-left,0px)] pe-[env(safe-area-inset-right,0px)]", children: [_jsx("div", { ref: largeRef, "data-slot": "app-bar-large-title", className: "px-4 pt-1 pb-3", children: _jsx(Heading, { className: "font-heading text-34 leading-[1.1] font-light tracking-[-0.02em] break-words text-foreground", children: title }) }), search && (_jsx("div", { "data-slot": "app-bar-search-row", className: "px-4 pb-3", children: search }))] }))] }));
109
+ }
110
+ /**
111
+ * The back button at the start of an AppBar: a chevron, with the previous screen's title beside
112
+ * it when there is room for one. A ghost button, so it lifts on hover and sinks on press; the
113
+ * chevron points the other way right to left.
114
+ */
115
+ export function AppBarBack({ children, href, labels, render, className, ...props }) {
116
+ const text = useMessages("appBar", defaultMessages, labels);
117
+ const titled = children !== undefined && children !== null && children !== false;
118
+ const name = !titled ? text.back : typeof children === "string" ? text.backTo(children) : undefined;
119
+ const link = render ?? (href ? _jsx("a", { href: href }) : undefined);
120
+ usePressFeedback();
121
+ return (_jsxs(Button, { "data-slot": "app-bar-back", "data-press": "", variant: "ghost", size: titled ? "default" : "icon", "aria-label": name, render: link, nativeButton: link ? false : undefined, className: cn(titled && "max-w-full gap-1 ps-1.5 pe-3", className), ...props, children: [_jsx(ChevronLeftIcon, { "aria-hidden": true, className: "size-5 shrink-0 rtl:-scale-x-100" }), titled && _jsx("span", { className: "truncate", children: children })] }));
122
+ }
123
+ /** A round, icon-only ghost button at the end of an AppBar, named by its `label`. */
124
+ export function AppBarAction({ icon, label, className, ...props }) {
125
+ usePressFeedback();
126
+ return (_jsx(Button, { "data-slot": "app-bar-action", "data-press": "", variant: "ghost", size: "icon", "aria-label": label, className: cn("[&_svg]:size-5", className), ...props, children: icon }));
127
+ }
128
+ /** Sets an input's value as typing would, so React's `onChange` hears it (a controlled field too). */
129
+ function setInputValue(input, next) {
130
+ const setter = Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, "value")?.set;
131
+ setter?.call(input, next);
132
+ input.dispatchEvent(new Event("input", { bubbles: true }));
133
+ }
134
+ /**
135
+ * The search field under an AppBar's title: a recessed field with a magnifier, 16px text so a
136
+ * phone does not zoom in, and the keyboard's Search key. Filter as `onChange` reports the text
137
+ * (controlled with `value`, or not). Once there is text, a clear button empties it and keeps the
138
+ * keyboard up; Escape empties it too, and on an empty field lets it go. Every other prop goes to
139
+ * the input.
140
+ */
141
+ export function AppBarSearch({ labels, groupClassName, placeholder, value, defaultValue, onChange, onKeyDown, className, ref, ...props }) {
142
+ const text = useMessages("appBar", defaultMessages, labels);
143
+ const inputRef = React.useRef(null);
144
+ const [own, setOwn] = React.useState(() => String(defaultValue ?? ""));
145
+ const filled = (value !== undefined ? String(value) : own).length > 0;
146
+ usePressFeedback();
147
+ const clear = () => {
148
+ const input = inputRef.current;
149
+ if (!input)
150
+ return;
151
+ setInputValue(input, "");
152
+ input.focus();
153
+ };
154
+ return (_jsx("div", { "data-slot": "app-bar-search", children: _jsxs(InputGroup, { className: cn(
155
+ // The browser's own clear mark gives way to the clear button below, in the zon ink.
156
+ "[&_input::-webkit-search-cancel-button]:appearance-none [&_input::-webkit-search-decoration]:appearance-none", groupClassName), children: [_jsx(InputGroupAddon, { children: _jsx(SearchIcon, { "aria-hidden": true }) }), _jsx(InputGroupInput, { ref: mergeRefs(inputRef, ref), type: "search", enterKeyHint: "search", autoComplete: "off", placeholder: placeholder ?? text.search, "aria-label": placeholder ?? text.search, value: value, defaultValue: defaultValue, onChange: (event) => {
157
+ if (value === undefined)
158
+ setOwn(event.target.value);
159
+ onChange?.(event);
160
+ }, onKeyDown: (event) => {
161
+ onKeyDown?.(event);
162
+ if (event.defaultPrevented || event.key !== "Escape")
163
+ return;
164
+ // Escape empties the field; on an empty one it puts the keyboard away. Either way it
165
+ // goes no further (a sheet or dialog around the screen stays open).
166
+ event.preventDefault();
167
+ event.stopPropagation();
168
+ if (event.currentTarget.value)
169
+ clear();
170
+ else
171
+ event.currentTarget.blur();
172
+ }, className: className, ...props }), filled && (_jsx(InputGroupAddon, { align: "inline-end", children: _jsx(InputGroupButton, { "data-slot": "app-bar-search-clear", "data-press": "", variant: "ghost", size: "icon-sm", "aria-label": text.clear,
173
+ // Keeps the focus, and the phone's keyboard, in the field.
174
+ onMouseDown: (event) => event.preventDefault(), onClick: clear, children: _jsx(XIcon, { "aria-hidden": true }) }) }))] }) }));
175
+ }
@@ -347,7 +347,8 @@ export function AsciiField({ density = 1, intensity = 1, mask = "brackets", spre
347
347
  draw(0, false);
348
348
  }
349
349
  function onPointerMove(e) {
350
- if (isStill() || e.pointerType === "touch")
350
+ // Off screen (or stopped) nothing is drawn: skip the layout read every move would cost.
351
+ if (!onScreen || !raf || e.pointerType === "touch" || isStill())
351
352
  return;
352
353
  const rect = root.getBoundingClientRect();
353
354
  const x = e.clientX - rect.left;
@@ -0,0 +1,134 @@
1
+ import * as React from "react";
2
+ /** One encoding of the audio. List the smaller, more modern one first: Opus, then AAC or MP3. */
3
+ export interface AudioSource {
4
+ src: string;
5
+ /** The MIME type, e.g. `audio/webm; codecs=opus` or `audio/mp4`, so the browser skips what it cannot play. */
6
+ type?: string;
7
+ }
8
+ /** The player's words: its controls' names, tooltips and menu, and what it says in words. */
9
+ export interface AudioPlayerMessages {
10
+ /** The player's name when it has no `title`. */
11
+ player: string;
12
+ play: string;
13
+ pause: string;
14
+ playAgain: string;
15
+ mute: string;
16
+ unmute: string;
17
+ volume: string;
18
+ seek: string;
19
+ /** A length of time in words, for screen readers: "1 minute 15 seconds". */
20
+ duration: (seconds: number) => string;
21
+ /** The scrubber's value, from two `duration`s: "42 seconds of 3 minutes 15 seconds". */
22
+ position: (time: string, total: string) => string;
23
+ speed: string;
24
+ normalSpeed: string;
25
+ /** A playback rate: "1.5×". */
26
+ rate: (rate: number) => string;
27
+ /** While it waits for the file. */
28
+ loading: string;
29
+ error: string;
30
+ }
31
+ declare module "./locale" {
32
+ interface LocaleMessages {
33
+ audioPlayer: AudioPlayerMessages;
34
+ }
35
+ }
36
+ /** The three surfaces. */
37
+ declare const playerVariants: {
38
+ readonly card: "rounded-card surface-card [--card-padding:--spacing(4)]";
39
+ readonly region: "rounded-none surface-container p-4";
40
+ readonly plain: "";
41
+ };
42
+ /** The surface: a 20px `card`, a square `region`, or `plain` with none. */
43
+ export type AudioPlayerVariant = keyof typeof playerVariants;
44
+ /** The arrangement: the stacked `default`, a one-line `row`, or a voice `note`. */
45
+ export type AudioPlayerLayout = "default" | "row" | "note";
46
+ export interface AudioPlayerProps extends Omit<React.ComponentProps<"div">, "children" | "title" | "onPlay" | "onPause" | "onEnded" | "onTimeUpdate"> {
47
+ /** The audio: one URL, or several encodings for the browser to choose from. */
48
+ src?: string | AudioSource[];
49
+ /** What it is: shown in Licht Sans, and the player's accessible name. */
50
+ title?: string;
51
+ /** Who made it, or when: a muted line under the title. */
52
+ artist?: string;
53
+ /** A square image beside the title: a cover, a speaker's photo. Decorative; the title names it. */
54
+ artwork?: string;
55
+ /**
56
+ * The waveform's peaks, each from 0 to 1, in order (100 to 400 is plenty): compute them once,
57
+ * on the server or with `audioPeaks`, and keep them with the file. `"auto"` decodes the file in
58
+ * the browser once the player is on screen (a URL on another origin needs CORS). Without them
59
+ * the waveform is a quiet, regular pattern made from the URL: the same for the same file, and
60
+ * plainly not a picture of the sound.
61
+ */
62
+ peaks?: readonly number[] | "auto";
63
+ /**
64
+ * The length in seconds, shown until the file's own is known: with `preload="none"`, a list
65
+ * can show every length without loading every file.
66
+ */
67
+ duration?: number;
68
+ /**
69
+ * The surface. `card`: a 20px object. `region`: a part of the page, square. `plain`: no surface,
70
+ * for a dialog, a list, a message or the lightbox. Defaults to `card` in the `default` layout
71
+ * and `plain` in a `row` or a `note`.
72
+ */
73
+ variant?: AudioPlayerVariant;
74
+ /**
75
+ * `default`: the title and artwork over a large play button and the waveform. `row`: one line
76
+ * for lists and history. `note`: a voice note, for a chat message.
77
+ */
78
+ layout?: AudioPlayerLayout;
79
+ /** `default`: the card's play button is 46px, a row's and a note's 38px. `sm`: one step smaller. */
80
+ size?: "default" | "sm";
81
+ autoPlay?: boolean;
82
+ loop?: boolean;
83
+ /** How much the browser loads before the first play. */
84
+ preload?: "none" | "metadata" | "auto";
85
+ /**
86
+ * Remembers the listener's volume and mute in localStorage under this key, as
87
+ * `{"volume":0.8,"muted":false}` (the same as `VideoPlayer`'s), and starts with them.
88
+ */
89
+ volumeStorageKey?: string;
90
+ /**
91
+ * Playing it pauses the other players on the page that are playing with sound, audio and video
92
+ * alike, and they it. `false` keeps it out of that: it plays alongside the others.
93
+ */
94
+ pauseOthers?: boolean;
95
+ /** Playback speeds in the speed menu. `false` hides the menu. */
96
+ speeds?: readonly number[] | false;
97
+ onPlay?: () => void;
98
+ onPause?: () => void;
99
+ onEnded?: () => void;
100
+ /** Called as the playhead moves, in seconds. */
101
+ onTimeUpdate?: (time: number) => void;
102
+ /** The `<audio>` element, for anything the player does not wrap. */
103
+ audioRef?: React.Ref<HTMLAudioElement>;
104
+ /** The player's words, for another language; a LocaleProvider's `audioPlayer` messages otherwise. */
105
+ labels?: Partial<AudioPlayerMessages>;
106
+ }
107
+ /**
108
+ * AudioPlayer — a recording or a track in the zon material, in place of the browser's own
109
+ * `<audio controls>`. The waveform is the scrubber: the part played in the foreground ink, moving
110
+ * smoothly while it plays, the moment under the pointer and its time shown above it; a round
111
+ * raised play button leads, and the times sit at the waveform's ends in Licht Mono.
112
+ *
113
+ * Three layouts: the `default`, with the title and artwork over the play button and the
114
+ * waveform, the speed and a volume popover tucked to the side; a one-line `row` for lists; and a
115
+ * `note` for a voice message in a chat. Each sits on one of three surfaces (`variant`): a 20px
116
+ * `card` (the default layout's own), a square `region`, or `plain`, with none (a row's and a
117
+ * note's). One player
118
+ * plays with sound at a time: starting one pauses the others on the page, video players too.
119
+ *
120
+ * The rule people break: autoplaying. Browsers block audio that starts on its own, and people
121
+ * leave pages that talk at them. Let them press play.
122
+ */
123
+ export declare function AudioPlayer({ src, title, artist, artwork, peaks: peaksProp, duration: durationHint, size, variant: variantProp, layout: layoutProp, autoPlay, loop, preload, volumeStorageKey, pauseOthers, speeds, onPlay, onPause, onEnded, onTimeUpdate, audioRef, labels: labelOverrides, className, ref, onKeyDown, onPointerDown, ...props }: AudioPlayerProps): React.JSX.Element;
124
+ /**
125
+ * The peaks of an audio file, for `AudioPlayer`'s `peaks`: `bars` values from 0 to 1, the loudest
126
+ * 1. Decodes the whole file with Web Audio in the browser, so run it once — when the file is
127
+ * uploaded, say — and keep the result with it rather than on every page view. A URL is fetched
128
+ * (it needs CORS when it's on another origin).
129
+ */
130
+ export declare function audioPeaks(source: string | Blob | ArrayBuffer, options?: {
131
+ bars?: number;
132
+ signal?: AbortSignal;
133
+ }): Promise<number[]>;
134
+ export {};