@zonsh/ui 0.5.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (559) hide show
  1. package/CHANGELOG.md +639 -0
  2. package/README.md +49 -21
  3. package/dist/brand.d.ts +3 -0
  4. package/dist/brand.js +7 -0
  5. package/dist/components/_breadcrumb-more.d.ts +6 -0
  6. package/dist/components/_breadcrumb-more.js +5 -0
  7. package/dist/components/_drawing-svg.d.ts +11 -0
  8. package/dist/components/_drawing-svg.js +30 -0
  9. package/dist/components/_media.d.ts +159 -0
  10. package/dist/components/_media.js +266 -0
  11. package/dist/components/_overlay.d.ts +8 -5
  12. package/dist/components/_overlay.js +11 -6
  13. package/dist/components/_scheduler-calendar.d.ts +71 -0
  14. package/dist/components/_scheduler-calendar.js +940 -0
  15. package/dist/components/_scheduler-editor.d.ts +29 -0
  16. package/dist/components/_scheduler-editor.js +111 -0
  17. package/dist/components/_scheduler-menu.d.ts +16 -0
  18. package/dist/components/_scheduler-menu.js +18 -0
  19. package/dist/components/_scheduler-parts.d.ts +164 -0
  20. package/dist/components/_scheduler-parts.js +327 -0
  21. package/dist/components/_suggest-list.d.ts +142 -0
  22. package/dist/components/_suggest-list.js +159 -0
  23. package/dist/components/_toolbar-more.d.ts +24 -0
  24. package/dist/components/_toolbar-more.js +25 -0
  25. package/dist/components/accordion.d.ts +1 -1
  26. package/dist/components/accordion.js +6 -6
  27. package/dist/components/action-sheet.d.ts +88 -0
  28. package/dist/components/action-sheet.js +124 -0
  29. package/dist/components/alert-dialog.js +3 -1
  30. package/dist/components/alert.d.ts +11 -18
  31. package/dist/components/alert.js +9 -6
  32. package/dist/components/app-bar.d.ts +93 -0
  33. package/dist/components/app-bar.js +175 -0
  34. package/dist/components/audio-player.d.ts +134 -0
  35. package/dist/components/audio-player.js +618 -0
  36. package/dist/components/avatar.d.ts +6 -6
  37. package/dist/components/avatar.js +13 -11
  38. package/dist/components/badge.d.ts +12 -12
  39. package/dist/components/badge.js +7 -5
  40. package/dist/components/bottom-nav.d.ts +53 -11
  41. package/dist/components/bottom-nav.js +388 -23
  42. package/dist/components/breadcrumb.d.ts +11 -2
  43. package/dist/components/breadcrumb.js +60 -6
  44. package/dist/components/button-group.js +5 -1
  45. package/dist/components/button.d.ts +23 -6
  46. package/dist/components/button.js +63 -7
  47. package/dist/components/calendar.js +8 -6
  48. package/dist/components/card.d.ts +10 -8
  49. package/dist/components/card.js +15 -14
  50. package/dist/components/carousel.d.ts +2 -2
  51. package/dist/components/carousel.js +21 -8
  52. package/dist/components/chart.d.ts +27 -1
  53. package/dist/components/chart.js +15 -5
  54. package/dist/components/checkbox.js +2 -2
  55. package/dist/components/code-block.d.ts +9 -2
  56. package/dist/components/code-block.js +26 -7
  57. package/dist/components/collapsible.js +3 -3
  58. package/dist/components/color-picker.d.ts +2 -2
  59. package/dist/components/color-picker.js +5 -5
  60. package/dist/components/combobox.d.ts +26 -7
  61. package/dist/components/combobox.js +32 -13
  62. package/dist/components/command.d.ts +29 -5
  63. package/dist/components/command.js +35 -10
  64. package/dist/components/context-menu.d.ts +5 -2
  65. package/dist/components/context-menu.js +24 -3
  66. package/dist/components/conversation.d.ts +1 -1
  67. package/dist/components/conversation.js +67 -13
  68. package/dist/components/copy-button.d.ts +1 -1
  69. package/dist/components/copy-button.js +1 -1
  70. package/dist/components/data-table.d.ts +6 -6
  71. package/dist/components/data-table.js +41 -15
  72. package/dist/components/date-picker.d.ts +31 -9
  73. package/dist/components/date-picker.js +100 -18
  74. package/dist/components/dialog.d.ts +17 -10
  75. package/dist/components/dialog.js +20 -13
  76. package/dist/components/drawer.d.ts +26 -8
  77. package/dist/components/drawer.js +75 -16
  78. package/dist/components/drawing.d.ts +25 -0
  79. package/dist/components/drawing.js +32 -0
  80. package/dist/components/empty.js +2 -2
  81. package/dist/components/feature-list.d.ts +65 -13
  82. package/dist/components/feature-list.js +116 -15
  83. package/dist/components/field.js +2 -2
  84. package/dist/components/file-drop.d.ts +9 -7
  85. package/dist/components/file-drop.js +8 -43
  86. package/dist/components/filter-bar.d.ts +10 -9
  87. package/dist/components/filter-bar.js +42 -25
  88. package/dist/components/graph.d.ts +19 -3
  89. package/dist/components/graph.js +170 -25
  90. package/dist/components/illustration.js +3 -28
  91. package/dist/components/input-group.d.ts +5 -10
  92. package/dist/components/input-group.js +16 -16
  93. package/dist/components/input.d.ts +2 -2
  94. package/dist/components/input.js +3 -3
  95. package/dist/components/item.d.ts +9 -6
  96. package/dist/components/item.js +13 -8
  97. package/dist/components/kbd.d.ts +1 -1
  98. package/dist/components/kbd.js +1 -1
  99. package/dist/components/lightbox.d.ts +76 -9
  100. package/dist/components/lightbox.js +333 -45
  101. package/dist/components/locale.d.ts +6 -6
  102. package/dist/components/logo.d.ts +21 -1
  103. package/dist/components/logo.js +32 -2
  104. package/dist/components/markdown-editor.d.ts +275 -0
  105. package/dist/components/markdown-editor.js +831 -0
  106. package/dist/components/mentions.d.ts +153 -0
  107. package/dist/components/mentions.js +507 -0
  108. package/dist/components/menu.d.ts +2 -1
  109. package/dist/components/menu.js +5 -4
  110. package/dist/components/menubar.d.ts +23 -5
  111. package/dist/components/menubar.js +97 -22
  112. package/dist/components/message.d.ts +62 -11
  113. package/dist/components/message.js +49 -13
  114. package/dist/components/meter.js +1 -1
  115. package/dist/components/money-input.d.ts +1 -1
  116. package/dist/components/money-input.js +1 -1
  117. package/dist/components/native-select.d.ts +2 -2
  118. package/dist/components/native-select.js +4 -4
  119. package/dist/components/navigation-menu.d.ts +3 -1
  120. package/dist/components/navigation-menu.js +23 -12
  121. package/dist/components/number-field.d.ts +2 -9
  122. package/dist/components/number-field.js +86 -36
  123. package/dist/components/number-roll.d.ts +26 -0
  124. package/dist/components/number-roll.js +81 -0
  125. package/dist/components/otp-field.d.ts +1 -1
  126. package/dist/components/otp-field.js +24 -3
  127. package/dist/components/pagination.d.ts +11 -3
  128. package/dist/components/pagination.js +59 -13
  129. package/dist/components/pdf-viewer.d.ts +1 -1
  130. package/dist/components/pdf-viewer.js +8 -8
  131. package/dist/components/phone-input.d.ts +1 -1
  132. package/dist/components/phone-input.js +2 -2
  133. package/dist/components/popover.js +5 -3
  134. package/dist/components/preview-card.d.ts +37 -2
  135. package/dist/components/preview-card.js +226 -2
  136. package/dist/components/progress.js +1 -1
  137. package/dist/components/prompt-input.d.ts +1 -1
  138. package/dist/components/prompt-input.js +24 -14
  139. package/dist/components/pull-to-refresh.d.ts +50 -0
  140. package/dist/components/pull-to-refresh.js +189 -0
  141. package/dist/components/quote.d.ts +6 -1
  142. package/dist/components/quote.js +3 -2
  143. package/dist/components/radio-group.js +1 -1
  144. package/dist/components/rating.d.ts +4 -1
  145. package/dist/components/rating.js +131 -10
  146. package/dist/components/reasoning.d.ts +1 -1
  147. package/dist/components/reasoning.js +7 -3
  148. package/dist/components/resizable.d.ts +1 -1
  149. package/dist/components/resizable.js +2 -2
  150. package/dist/components/response.d.ts +1 -1
  151. package/dist/components/response.js +18 -6
  152. package/dist/components/scheduler.d.ts +352 -0
  153. package/dist/components/scheduler.js +1717 -0
  154. package/dist/components/scroll-area.js +1 -1
  155. package/dist/components/select.d.ts +17 -4
  156. package/dist/components/select.js +140 -9
  157. package/dist/components/separator.d.ts +1 -1
  158. package/dist/components/separator.js +3 -3
  159. package/dist/components/sidebar.d.ts +44 -3
  160. package/dist/components/sidebar.js +57 -17
  161. package/dist/components/site-header.d.ts +18 -13
  162. package/dist/components/site-header.js +23 -11
  163. package/dist/components/skeleton.d.ts +17 -7
  164. package/dist/components/skeleton.js +22 -7
  165. package/dist/components/slider.js +2 -2
  166. package/dist/components/sortable.d.ts +55 -4
  167. package/dist/components/sortable.js +172 -103
  168. package/dist/components/sources.d.ts +1 -1
  169. package/dist/components/sources.js +2 -2
  170. package/dist/components/spinner.d.ts +4 -4
  171. package/dist/components/spinner.js +4 -4
  172. package/dist/components/stat.d.ts +21 -4
  173. package/dist/components/stat.js +17 -8
  174. package/dist/components/stepper.d.ts +1 -1
  175. package/dist/components/stepper.js +8 -7
  176. package/dist/components/suggestions.d.ts +11 -3
  177. package/dist/components/suggestions.js +10 -4
  178. package/dist/components/swipe-actions.d.ts +66 -0
  179. package/dist/components/swipe-actions.js +292 -0
  180. package/dist/components/switch.js +1 -1
  181. package/dist/components/table.d.ts +12 -6
  182. package/dist/components/table.js +78 -30
  183. package/dist/components/tabs.js +7 -4
  184. package/dist/components/tag.d.ts +19 -20
  185. package/dist/components/tag.js +9 -5
  186. package/dist/components/tags-input.d.ts +2 -7
  187. package/dist/components/tags-input.js +11 -8
  188. package/dist/components/textarea.d.ts +3 -2
  189. package/dist/components/textarea.js +4 -3
  190. package/dist/components/theme.d.ts +49 -6
  191. package/dist/components/theme.js +147 -9
  192. package/dist/components/time-field.d.ts +4 -9
  193. package/dist/components/time-field.js +6 -6
  194. package/dist/components/timeline.d.ts +19 -3
  195. package/dist/components/timeline.js +21 -9
  196. package/dist/components/tippy.d.ts +17 -1
  197. package/dist/components/tippy.js +95 -15
  198. package/dist/components/toast.d.ts +2 -7
  199. package/dist/components/toast.js +12 -8
  200. package/dist/components/toggle-group.d.ts +7 -1
  201. package/dist/components/toggle-group.js +16 -5
  202. package/dist/components/toggle.d.ts +2 -2
  203. package/dist/components/toggle.js +3 -2
  204. package/dist/components/tool-call.d.ts +1 -1
  205. package/dist/components/tool-call.js +4 -4
  206. package/dist/components/toolbar.d.ts +57 -4
  207. package/dist/components/toolbar.js +216 -16
  208. package/dist/components/tooltip.d.ts +1 -1
  209. package/dist/components/tooltip.js +4 -2
  210. package/dist/components/tour.d.ts +1 -1
  211. package/dist/components/tour.js +36 -15
  212. package/dist/components/tree.js +5 -5
  213. package/dist/components/typography.d.ts +31 -8
  214. package/dist/components/typography.js +21 -10
  215. package/dist/components/video-player.d.ts +7 -2
  216. package/dist/components/video-player.js +121 -220
  217. package/dist/index.d.ts +99 -92
  218. package/dist/index.js +99 -92
  219. package/dist/lib/calendar.d.ts +153 -0
  220. package/dist/lib/calendar.js +312 -0
  221. package/dist/lib/cn.d.ts +3 -1
  222. package/dist/lib/cn.js +5 -0
  223. package/dist/lib/code-highlight.d.ts +14 -0
  224. package/dist/lib/code-highlight.js +81 -18
  225. package/dist/lib/drag.d.ts +39 -0
  226. package/dist/lib/drag.js +96 -0
  227. package/dist/lib/editorial-assets.js +16 -8
  228. package/dist/lib/figure/figures/automation.js +25 -6
  229. package/dist/lib/figure/figures/bar-chart.js +6 -1
  230. package/dist/lib/figure/figures/brackets-classic.js +4 -1
  231. package/dist/lib/figure/figures/city.js +12 -2
  232. package/dist/lib/figure/figures/conveyor.js +17 -4
  233. package/dist/lib/figure/figures/database.js +5 -2
  234. package/dist/lib/figure/figures/documents.js +11 -3
  235. package/dist/lib/figure/figures/inbox.js +5 -2
  236. package/dist/lib/figure/figures/laptop.js +3 -1
  237. package/dist/lib/figure/figures/pipeline.js +45 -10
  238. package/dist/lib/figure/figures/platform.js +62 -7
  239. package/dist/lib/figure/figures/server.js +21 -5
  240. package/dist/lib/figure/figures/spreadsheet.js +29 -5
  241. package/dist/lib/figure/kernel.d.ts +4 -2
  242. package/dist/lib/figure/kernel.js +10 -5
  243. package/dist/lib/figure/parts.js +6 -2
  244. package/dist/lib/files.d.ts +31 -0
  245. package/dist/lib/files.js +60 -0
  246. package/dist/lib/gesture.d.ts +70 -0
  247. package/dist/lib/gesture.js +141 -0
  248. package/dist/lib/glide.d.ts +5 -0
  249. package/dist/lib/glide.js +9 -1
  250. package/dist/lib/icons.d.ts +1 -0
  251. package/dist/lib/icons.js +6 -0
  252. package/dist/lib/illustration-library.js +1 -6
  253. package/dist/lib/markdown-edit.d.ts +112 -0
  254. package/dist/lib/markdown-edit.js +557 -0
  255. package/dist/lib/markdown-rich-editor.d.ts +188 -0
  256. package/dist/lib/markdown-rich-editor.js +1153 -0
  257. package/dist/lib/markdown-rich.d.ts +63 -0
  258. package/dist/lib/markdown-rich.js +534 -0
  259. package/dist/lib/mentions.d.ts +100 -0
  260. package/dist/lib/mentions.js +246 -0
  261. package/dist/lib/motion.d.ts +18 -0
  262. package/dist/lib/motion.js +43 -5
  263. package/dist/lib/number-roll.d.ts +89 -0
  264. package/dist/lib/number-roll.js +391 -0
  265. package/dist/lib/platform.d.ts +6 -0
  266. package/dist/lib/platform.js +14 -0
  267. package/dist/lib/portal-container.d.ts +9 -0
  268. package/dist/lib/portal-container.js +10 -0
  269. package/dist/lib/press.d.ts +5 -0
  270. package/dist/lib/press.js +186 -0
  271. package/dist/lib/scheduler.d.ts +128 -0
  272. package/dist/lib/scheduler.js +272 -0
  273. package/dist/lib/scroll-edges.d.ts +9 -0
  274. package/dist/lib/scroll-edges.js +50 -0
  275. package/dist/lib/table-fit.d.ts +1 -1
  276. package/dist/lib/table-fit.js +65 -8
  277. package/dist/lib/theme-preset.d.ts +267 -0
  278. package/dist/lib/theme-preset.js +1046 -0
  279. package/dist/lib/theme-script.d.ts +23 -3
  280. package/dist/lib/theme-script.js +17 -5
  281. package/dist/lib/tippy/sprite.d.ts +36 -4
  282. package/dist/lib/tippy/sprite.js +188 -15
  283. package/dist/lib/tone.d.ts +4 -0
  284. package/dist/lib/tone.js +1 -0
  285. package/dist/messages/de.d.ts +3 -3
  286. package/dist/messages/de.js +274 -3
  287. package/dist/skills/zon-ui/SKILL.md +279 -0
  288. package/dist/skills/zon-ui/references/authoring.md +265 -0
  289. package/dist/skills/zon-ui/references/brand.md +416 -0
  290. package/dist/skills/zon-ui/references/components/accordion.md +199 -0
  291. package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
  292. package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
  293. package/dist/skills/zon-ui/references/components/alert.md +167 -0
  294. package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
  295. package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
  296. package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
  297. package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
  298. package/dist/skills/zon-ui/references/components/avatar.md +98 -0
  299. package/dist/skills/zon-ui/references/components/badge.md +227 -0
  300. package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
  301. package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
  302. package/dist/skills/zon-ui/references/components/button-group.md +216 -0
  303. package/dist/skills/zon-ui/references/components/button.md +309 -0
  304. package/dist/skills/zon-ui/references/components/calendar.md +296 -0
  305. package/dist/skills/zon-ui/references/components/card.md +158 -0
  306. package/dist/skills/zon-ui/references/components/carousel.md +297 -0
  307. package/dist/skills/zon-ui/references/components/chart.md +739 -0
  308. package/dist/skills/zon-ui/references/components/chat.md +417 -0
  309. package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
  310. package/dist/skills/zon-ui/references/components/code-block.md +143 -0
  311. package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
  312. package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
  313. package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
  314. package/dist/skills/zon-ui/references/components/combobox.md +455 -0
  315. package/dist/skills/zon-ui/references/components/command.md +326 -0
  316. package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
  317. package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
  318. package/dist/skills/zon-ui/references/components/conversation.md +146 -0
  319. package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
  320. package/dist/skills/zon-ui/references/components/crm.md +1022 -0
  321. package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
  322. package/dist/skills/zon-ui/references/components/data-table.md +776 -0
  323. package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
  324. package/dist/skills/zon-ui/references/components/dialog.md +335 -0
  325. package/dist/skills/zon-ui/references/components/direction.md +165 -0
  326. package/dist/skills/zon-ui/references/components/drawer.md +276 -0
  327. package/dist/skills/zon-ui/references/components/drawing.md +94 -0
  328. package/dist/skills/zon-ui/references/components/empty.md +225 -0
  329. package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
  330. package/dist/skills/zon-ui/references/components/field.md +209 -0
  331. package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
  332. package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
  333. package/dist/skills/zon-ui/references/components/form.md +970 -0
  334. package/dist/skills/zon-ui/references/components/graph.md +339 -0
  335. package/dist/skills/zon-ui/references/components/illustration.md +497 -0
  336. package/dist/skills/zon-ui/references/components/inbox.md +263 -0
  337. package/dist/skills/zon-ui/references/components/input-group.md +339 -0
  338. package/dist/skills/zon-ui/references/components/input.md +189 -0
  339. package/dist/skills/zon-ui/references/components/item.md +277 -0
  340. package/dist/skills/zon-ui/references/components/kanban.md +626 -0
  341. package/dist/skills/zon-ui/references/components/kbd.md +116 -0
  342. package/dist/skills/zon-ui/references/components/label.md +104 -0
  343. package/dist/skills/zon-ui/references/components/layout.md +291 -0
  344. package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
  345. package/dist/skills/zon-ui/references/components/locale.md +279 -0
  346. package/dist/skills/zon-ui/references/components/logo.md +257 -0
  347. package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
  348. package/dist/skills/zon-ui/references/components/mentions.md +512 -0
  349. package/dist/skills/zon-ui/references/components/menu.md +218 -0
  350. package/dist/skills/zon-ui/references/components/menubar.md +292 -0
  351. package/dist/skills/zon-ui/references/components/message.md +243 -0
  352. package/dist/skills/zon-ui/references/components/meter.md +105 -0
  353. package/dist/skills/zon-ui/references/components/money-input.md +333 -0
  354. package/dist/skills/zon-ui/references/components/native-select.md +197 -0
  355. package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
  356. package/dist/skills/zon-ui/references/components/number-field.md +210 -0
  357. package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
  358. package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
  359. package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
  360. package/dist/skills/zon-ui/references/components/pagination.md +109 -0
  361. package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
  362. package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
  363. package/dist/skills/zon-ui/references/components/popover.md +176 -0
  364. package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
  365. package/dist/skills/zon-ui/references/components/pricing.md +724 -0
  366. package/dist/skills/zon-ui/references/components/progress.md +92 -0
  367. package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
  368. package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
  369. package/dist/skills/zon-ui/references/components/quote.md +115 -0
  370. package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
  371. package/dist/skills/zon-ui/references/components/rating.md +260 -0
  372. package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
  373. package/dist/skills/zon-ui/references/components/resizable.md +213 -0
  374. package/dist/skills/zon-ui/references/components/response.md +170 -0
  375. package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
  376. package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
  377. package/dist/skills/zon-ui/references/components/select.md +351 -0
  378. package/dist/skills/zon-ui/references/components/separator.md +103 -0
  379. package/dist/skills/zon-ui/references/components/settings.md +793 -0
  380. package/dist/skills/zon-ui/references/components/shop.md +1715 -0
  381. package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
  382. package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
  383. package/dist/skills/zon-ui/references/components/site-header.md +303 -0
  384. package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
  385. package/dist/skills/zon-ui/references/components/slider.md +172 -0
  386. package/dist/skills/zon-ui/references/components/sortable.md +405 -0
  387. package/dist/skills/zon-ui/references/components/sources.md +106 -0
  388. package/dist/skills/zon-ui/references/components/spinner.md +222 -0
  389. package/dist/skills/zon-ui/references/components/stat.md +267 -0
  390. package/dist/skills/zon-ui/references/components/stepper.md +285 -0
  391. package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
  392. package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
  393. package/dist/skills/zon-ui/references/components/switch.md +160 -0
  394. package/dist/skills/zon-ui/references/components/table.md +999 -0
  395. package/dist/skills/zon-ui/references/components/tabs.md +258 -0
  396. package/dist/skills/zon-ui/references/components/tag.md +115 -0
  397. package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
  398. package/dist/skills/zon-ui/references/components/textarea.md +95 -0
  399. package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
  400. package/dist/skills/zon-ui/references/components/theme.md +362 -0
  401. package/dist/skills/zon-ui/references/components/time-field.md +222 -0
  402. package/dist/skills/zon-ui/references/components/timeline.md +285 -0
  403. package/dist/skills/zon-ui/references/components/tippy.md +243 -0
  404. package/dist/skills/zon-ui/references/components/toast.md +220 -0
  405. package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
  406. package/dist/skills/zon-ui/references/components/toggle.md +167 -0
  407. package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
  408. package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
  409. package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
  410. package/dist/skills/zon-ui/references/components/tour.md +423 -0
  411. package/dist/skills/zon-ui/references/components/tree.md +481 -0
  412. package/dist/skills/zon-ui/references/components/typography.md +347 -0
  413. package/dist/skills/zon-ui/references/components/video-player.md +386 -0
  414. package/dist/skills/zon-ui/references/marketing.md +467 -0
  415. package/dist/skills/zon-ui/references/motion.md +455 -0
  416. package/dist/skills/zon-ui/references/recipes.md +1232 -0
  417. package/dist/skills/zon-ui/references/tokens.md +866 -0
  418. package/dist/sources/accordion.css +4 -0
  419. package/dist/sources/action-sheet.css +11 -0
  420. package/dist/sources/alert-dialog.css +6 -0
  421. package/dist/sources/alert.css +3 -0
  422. package/dist/sources/app-bar.css +14 -0
  423. package/dist/sources/ascii-field.css +3 -0
  424. package/dist/sources/aspect-ratio.css +3 -0
  425. package/dist/sources/audio-player.css +20 -0
  426. package/dist/sources/avatar.css +3 -0
  427. package/dist/sources/badge.css +3 -0
  428. package/dist/sources/bottom-nav.css +9 -0
  429. package/dist/sources/breadcrumb.css +14 -0
  430. package/dist/sources/button-group.css +3 -0
  431. package/dist/sources/button.css +9 -0
  432. package/dist/sources/calendar.css +13 -0
  433. package/dist/sources/card.css +3 -0
  434. package/dist/sources/carousel.css +11 -0
  435. package/dist/sources/chart.css +5 -0
  436. package/dist/sources/checkbox.css +6 -0
  437. package/dist/sources/code-block.css +13 -0
  438. package/dist/sources/collapsible.css +4 -0
  439. package/dist/sources/color-picker.css +13 -0
  440. package/dist/sources/combobox.css +13 -0
  441. package/dist/sources/command.css +13 -0
  442. package/dist/sources/context-menu.css +12 -0
  443. package/dist/sources/conversation.css +10 -0
  444. package/dist/sources/copy-button.css +10 -0
  445. package/dist/sources/data-table.css +27 -0
  446. package/dist/sources/date-picker.css +20 -0
  447. package/dist/sources/dialog.css +9 -0
  448. package/dist/sources/direction.css +2 -0
  449. package/dist/sources/drawer.css +9 -0
  450. package/dist/sources/drawing.css +5 -0
  451. package/dist/sources/empty.css +3 -0
  452. package/dist/sources/feature-list.css +4 -0
  453. package/dist/sources/field.css +4 -0
  454. package/dist/sources/file-drop.css +15 -0
  455. package/dist/sources/filter-bar.css +30 -0
  456. package/dist/sources/form.css +4 -0
  457. package/dist/sources/graph.css +19 -0
  458. package/dist/sources/illustration.css +28 -0
  459. package/dist/sources/input-group.css +7 -0
  460. package/dist/sources/input.css +3 -0
  461. package/dist/sources/item.css +4 -0
  462. package/dist/sources/kbd.css +5 -0
  463. package/dist/sources/label.css +3 -0
  464. package/dist/sources/layout.css +3 -0
  465. package/dist/sources/lightbox.css +33 -0
  466. package/dist/sources/locale.css +2 -0
  467. package/dist/sources/logo.css +4 -0
  468. package/dist/sources/markdown-editor.css +41 -0
  469. package/dist/sources/mentions.css +13 -0
  470. package/dist/sources/menu.css +11 -0
  471. package/dist/sources/menubar.css +14 -0
  472. package/dist/sources/message.css +16 -0
  473. package/dist/sources/meter.css +4 -0
  474. package/dist/sources/money-input.css +10 -0
  475. package/dist/sources/native-select.css +4 -0
  476. package/dist/sources/navigation-menu.css +8 -0
  477. package/dist/sources/number-field.css +8 -0
  478. package/dist/sources/number-roll.css +6 -0
  479. package/dist/sources/otp-field.css +5 -0
  480. package/dist/sources/pagination.css +11 -0
  481. package/dist/sources/pdf-viewer.css +30 -0
  482. package/dist/sources/phone-input.css +20 -0
  483. package/dist/sources/popover.css +7 -0
  484. package/dist/sources/preview-card.css +7 -0
  485. package/dist/sources/progress.css +4 -0
  486. package/dist/sources/prompt-input.css +15 -0
  487. package/dist/sources/pull-to-refresh.css +14 -0
  488. package/dist/sources/quote.css +3 -0
  489. package/dist/sources/radio-group.css +5 -0
  490. package/dist/sources/rating.css +6 -0
  491. package/dist/sources/reasoning.css +6 -0
  492. package/dist/sources/resizable.css +4 -0
  493. package/dist/sources/response.css +16 -0
  494. package/dist/sources/scheduler.css +44 -0
  495. package/dist/sources/scroll-area.css +3 -0
  496. package/dist/sources/select.css +12 -0
  497. package/dist/sources/separator.css +3 -0
  498. package/dist/sources/sidebar.css +19 -0
  499. package/dist/sources/site-header.css +15 -0
  500. package/dist/sources/skeleton.css +3 -0
  501. package/dist/sources/slider.css +6 -0
  502. package/dist/sources/sortable.css +12 -0
  503. package/dist/sources/sources.css +6 -0
  504. package/dist/sources/spinner.css +6 -0
  505. package/dist/sources/stat.css +9 -0
  506. package/dist/sources/stepper.css +6 -0
  507. package/dist/sources/suggestions.css +10 -0
  508. package/dist/sources/swipe-actions.css +20 -0
  509. package/dist/sources/switch.css +5 -0
  510. package/dist/sources/table.css +7 -0
  511. package/dist/sources/tabs.css +5 -0
  512. package/dist/sources/tag.css +3 -0
  513. package/dist/sources/tags-input.css +6 -0
  514. package/dist/sources/textarea.css +3 -0
  515. package/dist/sources/theme.css +13 -0
  516. package/dist/sources/time-field.css +7 -0
  517. package/dist/sources/timeline.css +7 -0
  518. package/dist/sources/tippy.css +6 -0
  519. package/dist/sources/toast.css +6 -0
  520. package/dist/sources/toggle-group.css +5 -0
  521. package/dist/sources/toggle.css +3 -0
  522. package/dist/sources/tool-call.css +16 -0
  523. package/dist/sources/toolbar.css +14 -0
  524. package/dist/sources/tooltip.css +6 -0
  525. package/dist/sources/tour.css +14 -0
  526. package/dist/sources/tree.css +6 -0
  527. package/dist/sources/typography.css +4 -0
  528. package/dist/sources/video-player.css +21 -0
  529. package/dist/styles/ai.css +3 -0
  530. package/dist/styles/brand.css +98 -0
  531. package/dist/styles/core.css +266 -0
  532. package/dist/styles/editor.css +3 -0
  533. package/dist/styles/expressive.css +35 -56
  534. package/dist/styles/fonts.css +61 -117
  535. package/dist/styles/graph.css +4 -0
  536. package/dist/styles/illustration.css +4 -0
  537. package/dist/styles/index.css +11 -201
  538. package/dist/styles/material.css +138 -12
  539. package/dist/styles/parts/ai.css +18 -13
  540. package/dist/styles/parts/brand.css +2 -2
  541. package/dist/styles/parts/controls.css +29 -20
  542. package/dist/styles/parts/data.css +13 -9
  543. package/dist/styles/parts/editor.css +372 -0
  544. package/dist/styles/parts/feedback.css +32 -2
  545. package/dist/styles/parts/foundations.css +12 -7
  546. package/dist/styles/parts/graph.css +25 -9
  547. package/dist/styles/parts/inputs.css +172 -9
  548. package/dist/styles/parts/isometric.css +6 -5
  549. package/dist/styles/parts/navigation.css +206 -27
  550. package/dist/styles/parts/overlays.css +19 -4
  551. package/dist/styles/parts/pdf.css +2 -2
  552. package/dist/styles/pdf.css +3 -0
  553. package/dist/styles/prose.css +3 -0
  554. package/dist/styles/tokens.css +89 -14
  555. package/dist/theme.d.ts +1 -0
  556. package/dist/theme.js +5 -0
  557. package/dist/vite.d.ts +48 -59
  558. package/dist/vite.js +54 -21
  559. package/package.json +69 -2
@@ -0,0 +1,386 @@
1
+ # Video Player
2
+
3
+ ```tsx
4
+ import { VideoPlayer } from "@zonsh/ui";
5
+
6
+ const FILES = `${import.meta.env.BASE_URL}files`;
7
+
8
+ /** The WebM and the MP4 of one file name. */
9
+ const encodings = (name: string) => [
10
+ { src: `${FILES}/${name}.webm`, type: "video/webm" },
11
+ { src: `${FILES}/${name}.mp4`, type: "video/mp4" },
12
+ ];
13
+
14
+ const ECLIPSE = encodings("eclipse");
15
+
16
+ export function Basic() {
17
+ return (
18
+ // As large as the stage allows at 16:9 (the width or the height, whichever runs out first),
19
+ // and never under 640px wide unless the stage is.
20
+ <div className="[container-type:size] flex size-full min-h-80 items-center justify-center">
21
+ <VideoPlayer
22
+ className="w-[max(min(100cqw,calc(100cqh*16/9)),min(100cqw,40rem))]"
23
+ src={ECLIPSE}
24
+ poster={`${FILES}/eclipse-poster.jpg`}
25
+ title="A total solar eclipse, drawn as two discs"
26
+ tracks={[{ src: `${FILES}/eclipse.en.vtt`, label: "English", srcLang: "en", default: true }]}
27
+ />
28
+ </div>
29
+ );
30
+ }
31
+ ```
32
+
33
+ A player for video files on the browser's own `<video>`, letterboxed on black in a square frame (`variant="card"` makes it a 20px object). Before the first play: the poster and a round play button. Then a dark control bar floats over the picture in the menu material (play, mono time, a scrubber with the buffered range and a time under the pointer, volume, speed, subtitles, picture in picture, full screen; audio and quality with several versions) and steps back with the pointer while it plays, until movement, a key or focus. Play and pause flash large in the middle. Subtitles are drawn by the player in Licht Sans on a dark plate, above the controls.
34
+
35
+ ## Usage
36
+
37
+ ```tsx
38
+ import { VideoPlayer } from "@zonsh/ui";
39
+
40
+ <VideoPlayer
41
+ src={[
42
+ { src: "/media/walkthrough.webm", type: "video/webm" },
43
+ { src: "/media/walkthrough.mp4", type: "video/mp4" },
44
+ ]}
45
+ poster="/media/walkthrough.jpg"
46
+ title="Setting up your first project"
47
+ tracks={[{ src: "/media/walkthrough.en.vtt", label: "English", srcLang: "en", default: true }]}
48
+ />;
49
+ ```
50
+
51
+ - `src` — one URL, or encodings in order of preference.
52
+ - `poster` — the image before the first play; always give one.
53
+ - `tracks` — WebVTT subtitle files (`default: true` turns one on).
54
+
55
+ ## When to use
56
+
57
+ - A video watched on purpose: a walkthrough, a lesson, a talk. `layout="movie"` for a film, an episode or a lecture; `variant="card"` for a clip that stands alone in a grid.
58
+ - Ambient motion in a hero: an `AspectRatio` with a muted looping `<video>`, no player.
59
+ - YouTube or Vimeo: the host's embed. This plays files and streams the browser opens itself.
60
+
61
+ ## Examples
62
+
63
+ ### Movie
64
+
65
+ `layout="movie"` lays the controls on a dark fade, the title at the top in Licht. A row of 38px controls: play, ten seconds back and forward, volume and time on the left; episodes, subtitles, audio, quality, speed, picture in picture and full screen on the right. Beneath, a full-width timeline ends in the time left ("−18:56"). From a 768px frame the controls take the prominent size (46px buttons, larger icons, a thicker timeline).
66
+
67
+ `previews` shows a still above the time when hovering the timeline or dragging: a whole image, or a sprite-sheet tile with `x` and `y` (Jellyfin's trickplay, a WebVTT thumbnail track).
68
+
69
+ `segments` marks stretches to pass over (an intro, a recap). While one plays, a secondary button with its `label` sits above the controls at the right and jumps to its end; it stays for 15 seconds of playback while a lighter fill runs down (holding while paused). `onSkip` replaces the jump, for "Next episode" over the credits. `auto` skips unasked: `"now"` as playback runs into it (a jump into it shows the button instead, so the player never fights the viewer), `"countdown"` once a 10-second fill runs down; moving the playhead declines the countdown, leaving a plain skip.
70
+
71
+ For a full-screen player, `onBack` puts a back arrow before the title and `onNext` adds a next control after the skip buttons (named by `labels.next`). A track the browser can't read, such as Blu-ray PGS subtitles, brings its own `render`: while chosen it gets the `<video>` and a layer over the picture, under the controls, to draw into; the player calls what `render` returns to stop. ASS override tags (`{\fad(250,0)}`) and lines repeated by layered effects are dropped.
72
+
73
+ For a series, `seasons` adds an Episodes button: a list over the picture, a season at a time, opened at `currentEpisode` marked as playing. Each episode shows a still with progress watched, number, title, length and a line or two; choosing one calls `onEpisodeSelect`. With several seasons the season's name leads to the list of them. A season without `episodes` shows placeholder rows and calls `onSeasonOpen` to load them.
74
+
75
+ `versions` lists the same video in other languages or resolutions, each naming its `audio`, `quality` or both; a menu appears for whichever differs, and switching resumes at the same moment and play state. `qualityDetail` stands beside a quality in mono ("24 Mbit/s"). Audio and subtitles (with Off) share one button whose menu stays open while you set both. Here the audio column switches the clip's score and its chimes alone.
76
+
77
+ ```tsx
78
+ import { VideoPlayer, type VideoEpisode, type VideoSeason } from "@zonsh/ui";
79
+ import { useState } from "react";
80
+
81
+ // FILES, encodings, ECLIPSE: as in the first example on this page that uses them.
82
+
83
+ /** The clip's stills: one every half second, in a 6 × 4 sheet of 320 × 180 tiles. */
84
+ const previews = (time: number) => {
85
+ const index = Math.min(23, Math.max(0, Math.floor(time * 2)));
86
+ return {
87
+ src: `${FILES}/eclipse-previews.jpg`,
88
+ width: 320,
89
+ height: 180,
90
+ x: (index % 6) * 320,
91
+ y: Math.floor(index / 6) * 180,
92
+ };
93
+ };
94
+
95
+ /** A short series around the clip, for the episode list: the clip is its second episode. */
96
+ const STILL = `${FILES}/eclipse-poster.jpg`;
97
+
98
+ const SEASON_ONE: VideoEpisode[] = [
99
+ {
100
+ id: "first-contact",
101
+ number: 1,
102
+ title: "First contact",
103
+ description: "The Moon's edge touches the Sun, and the light starts to thin.",
104
+ duration: "1 min",
105
+ progress: 1,
106
+ image: STILL,
107
+ },
108
+ {
109
+ id: "totality",
110
+ number: 2,
111
+ title: "Totality",
112
+ description: "The last bead of sunlight goes out, and the corona shows.",
113
+ duration: "1 min",
114
+ progress: 0.4,
115
+ image: STILL,
116
+ },
117
+ {
118
+ id: "diamond-ring",
119
+ number: 3,
120
+ title: "Diamond ring",
121
+ description: "One point of the Sun breaks through, and the day comes back.",
122
+ duration: "1 min",
123
+ image: STILL,
124
+ },
125
+ ];
126
+
127
+ /** Fetched when the season is opened, the way an app would load it. */
128
+ const SEASON_TWO: VideoEpisode[] = [
129
+ {
130
+ id: "ring-of-fire",
131
+ number: 1,
132
+ title: "Ring of fire",
133
+ description: "Too far away to cover the Sun, the Moon leaves a burning ring.",
134
+ duration: "1 min",
135
+ image: STILL,
136
+ },
137
+ {
138
+ id: "crescents",
139
+ number: 2,
140
+ title: "Crescents",
141
+ description: "Under the trees, every gap between the leaves throws a little crescent.",
142
+ duration: "1 min",
143
+ image: STILL,
144
+ },
145
+ ];
146
+
147
+ export function Movie() {
148
+ const [episode, setEpisode] = useState("totality");
149
+ const [secondSeason, setSecondSeason] = useState<VideoEpisode[]>();
150
+ const seasons: VideoSeason[] = [
151
+ { id: "1", label: "Season 1", episodes: SEASON_ONE },
152
+ { id: "2", label: "Season 2", count: SEASON_TWO.length, episodes: secondSeason },
153
+ ];
154
+ return (
155
+ <div className="[container-type:size] flex size-full min-h-80 items-center justify-center">
156
+ <VideoPlayer
157
+ layout="movie"
158
+ className="w-[max(min(100cqw,calc(100cqh*16/9)),min(100cqw,40rem))]"
159
+ title="Totality"
160
+ poster={`${FILES}/eclipse-poster.jpg`}
161
+ versions={[
162
+ { audio: "Score", quality: "2160p", src: ECLIPSE },
163
+ { audio: "Score", quality: "1080p", src: encodings("eclipse-1080p") },
164
+ { audio: "Score", quality: "720p", src: encodings("eclipse-720p") },
165
+ { audio: "Chimes only", quality: "2160p", src: encodings("eclipse-chimes") },
166
+ { audio: "Chimes only", quality: "1080p", src: encodings("eclipse-chimes-1080p") },
167
+ { audio: "Chimes only", quality: "720p", src: encodings("eclipse-chimes-720p") },
168
+ ]}
169
+ tracks={[
170
+ { src: `${FILES}/eclipse.en.vtt`, label: "English", srcLang: "en", default: true },
171
+ { src: `${FILES}/eclipse.de.vtt`, label: "Deutsch", srcLang: "de" },
172
+ ]}
173
+ previews={previews}
174
+ segments={[{ start: 0, end: 5.5, label: "Skip to totality" }]}
175
+ seasons={seasons}
176
+ currentEpisode={episode}
177
+ onSeasonOpen={() => setTimeout(() => setSecondSeason(SEASON_TWO), 800)}
178
+ onEpisodeSelect={setEpisode}
179
+ />
180
+ </div>
181
+ );
182
+ }
183
+ ```
184
+
185
+ ### Narrow
186
+
187
+ Below 448px the scrubber takes its own row above the buttons, the volume slider folds into the mute button, and picture in picture steps out. Subtitles sit above both rows.
188
+
189
+ The movie layout keeps one row, adding lesser buttons as room allows: play, mute, subtitles and full screen always; episodes from 256px; skip buttons, quality and picture in picture from 448px; speed from 512px; the time from 576px (before that, at the timeline's start); the volume slider from 616px.
190
+
191
+ Below 576px (an upright phone) title, middle button, subtitle and skip stack instead of overlapping: the skip goes small at the right above the controls, the subtitle above it, and the middle play button gives way (play stays in the bar). A showing subtitle moves the title aside and keeps clear of the back arrow. On a wider frame the subtitle shares the skip's row, narrowed to stay centred.
192
+
193
+ ```tsx
194
+ import { VideoPlayer } from "@zonsh/ui";
195
+
196
+ // FILES, encodings, ECLIPSE: as in the first example on this page that uses them.
197
+
198
+ export function Narrow() {
199
+ return (
200
+ <div className="w-full max-w-xs">
201
+ <VideoPlayer
202
+ src={ECLIPSE}
203
+ poster={`${FILES}/eclipse-poster.jpg`}
204
+ title="A total solar eclipse, drawn as two discs"
205
+ />
206
+ </div>
207
+ );
208
+ }
209
+ ```
210
+
211
+ ### Minimal
212
+
213
+ `speeds={false}` and `pictureInPicture={false}` take those controls out; `aspectRatio` sets the frame.
214
+
215
+ ```tsx
216
+ import { VideoPlayer } from "@zonsh/ui";
217
+
218
+ // FILES, encodings, ECLIPSE: as in the first example on this page that uses them.
219
+
220
+ export function Minimal() {
221
+ return (
222
+ <div className="w-full max-w-md">
223
+ <VideoPlayer
224
+ src={ECLIPSE}
225
+ poster={`${FILES}/eclipse-poster.jpg`}
226
+ title="Course preview: how an eclipse lines up"
227
+ aspectRatio={4 / 3}
228
+ speeds={false}
229
+ pictureInPicture={false}
230
+ />
231
+ </div>
232
+ );
233
+ }
234
+ ```
235
+
236
+ ## Touch
237
+
238
+ A tap starts the first play; after that a tap shows or hides the controls, with play and pause in the middle. A double tap on the left or right third jumps 10 seconds back or ahead, and more taps add to it; in the middle it does nothing.
239
+
240
+ Every asked-for jump shows its total briefly on its side; jumps the same way within a second add up (+10 s, +20 s).
241
+
242
+ ## Another title in the same player
243
+
244
+ Change the sources (`versions` or `src`), `tracks`, `startTime` and `currentEpisode` together and the next title plays in place, keeping full screen, picture in picture, volume and focus, from `startTime` with its `defaultAudio`, `defaultQuality` and subtitle choice. Set `loading` while it is prepared.
245
+
246
+ Changing `defaultQuality` (or `defaultAudio`) mid-title switches as the menu does, without calling `onQualityChange`: a watch party moving everyone to 1080p, or stepping down when the picture stalls. The viewer's own pick stays until the prop changes again.
247
+
248
+ ## Several players on a page
249
+
250
+ Starting a player with sound (or unmuting a playing one) pauses the others playing with sound. Muted players and ones at volume 0 play on, so quiet clips in a grid never stop. `pauseOthers={false}` opts a player out (a second camera, a commentary) both ways.
251
+
252
+ ## Remembered volume
253
+
254
+ `volumeStorageKey` keeps the viewer's volume and mute in localStorage; players sharing a key share a level.
255
+
256
+ - The value is JSON, `{"volume":0.8,"muted":false}` with volume 0 to 1. Anything else is ignored and replaced at the viewer's next change.
257
+ - Read after mount, so server and first render agree.
258
+ - A stored value never unmutes a `muted` or `autoPlay` player: it takes the level and stays muted until the viewer unmutes.
259
+ - Only the viewer's own changes are kept; unusable storage leaves the defaults.
260
+
261
+ ## Where the player can't draw
262
+
263
+ iOS full screen, picture in picture and AirPlay show the bare video; there the chosen text subtitles are drawn by the browser in the system's caption style, and tracks with their own `render` can't follow. Where Safari finds an AirPlay screen nearby, an AirPlay button appears.
264
+
265
+ ## Errors
266
+
267
+ A slow subtitle file never holds the picture back: the video plays, a note says the subtitles are coming, and they join once loaded; a server error is retried a few times, a 404 let go at once with its note. A stream that stops (an error, or a 15-second stall) reloads from where it stopped after 1, 3, 8 and 15 seconds, with the spinner; the error shows only when the last try fails. It keeps the title bar and back arrow and offers _Try again_ and, with versions, the next quality. Of several encodings in `src`, one that can't play hands over to the next.
268
+
269
+ ## Without a length
270
+
271
+ A live stream or a recording without a length (a MediaRecorder WebM): the timeline rests, total and time left stay out, the arrows, `J` and `L` step as far as the browser can seek, and `End` and `0`–`9` wait for a length.
272
+
273
+ ## Keyboard
274
+
275
+ With focus anywhere in the player (with `pageShortcuts`, also while nothing on the page has focus):
276
+
277
+ | Keys | Action |
278
+ | -------------- | -------------------------- |
279
+ | `Space` / `K` | Play or pause |
280
+ | `←` / `→` | Back or forward 5 seconds |
281
+ | `J` / `L` | Back or forward 10 seconds |
282
+ | `↑` / `↓` | Volume up or down |
283
+ | `Home` / `End` | To the start or the end |
284
+ | `0`–`9` | To that tenth of the video |
285
+ | `M` | Mute or unmute |
286
+ | `C` | Subtitles on or off |
287
+ | `F` | Full screen |
288
+
289
+ 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.
290
+
291
+ `↑` unmutes. `↓` on a muted player keeps it muted and lowers the level it comes back at.
292
+
293
+ On the scrubber the arrows step 5 seconds and Page Up/Down 10, without holding the video. On the scrubber and volume, `Space` and digits still work the player; arrows, `Home` and `End` are the slider's.
294
+
295
+ ## Scrubbing
296
+
297
+ Dragging the scrubber holds the frame under the thumb and plays on when let go, firing neither `onPause` nor `onPlay`. Let go within 0.1 s of the end, it ends at once with `onPause` then `onEnded`, even on a stream still fetching; Play starts over. A video paused before the drag stays paused; `Space` during a drag hands play and pause back to the viewer.
298
+
299
+ ## Props
300
+
301
+ | Prop | Type | Default |
302
+ | --------------------------------- | ----------------------------------------------------------------------------------------- | ------------------------------ |
303
+ | `src` | `string \| { src, type? }[]`: one URL, or encodings in order | — |
304
+ | `versions` | `{ src, audio?, quality?, qualityDetail? }[]`: dubs and resolutions, in place of `src` | — |
305
+ | `defaultAudio` / `defaultQuality` | `string`: the version to start with; changed later, the player switches to it in place | the first version's |
306
+ | `layout` | `"default" \| "movie"` | `"default"` |
307
+ | `poster` | `string`: the image before the first play | — |
308
+ | `title` | `string`: the accessible name, and the movie layout's heading | `"Video player"` |
309
+ | `tracks` | `{ src, label, srcLang, kind?, default?, render? }[]`: WebVTT files, or drawn by `render` | `[]` |
310
+ | `subtitle` | `number`: the track shown, by its place in `tracks` (-1: off), set by the app | the first `default` track |
311
+ | `onSubtitleChange` | `(index) => void`: the viewer chose a subtitle track (-1: off) | — |
312
+ | `onAudioChange` | `(audio) => void`: the viewer chose another audio | — |
313
+ | `onQualityChange` | `(quality) => void`: the viewer chose another quality | — |
314
+ | `loading` | `boolean`: a spinner over the picture while the app prepares what plays next | `false` |
315
+ | `overlay` | `ReactNode`: the app's own prompt over everything, also in full screen | — |
316
+ | `previews` | `(seconds) => { src, width, height, x?, y? } \| undefined`: timeline stills | — |
317
+ | `segments` | `{ start, end, label, onSkip?, auto? }[]`: stretches to offer a skip over, in seconds | `[]` |
318
+ | `subtitleScale` | `number`: the subtitles' size against the default, which grows with the player's width | `1` |
319
+ | `onBack` | `() => void`: movie layout, a back arrow before the title | — |
320
+ | `onNext` | `() => void`: movie layout, a control that plays what comes next | — |
321
+ | `seasons` | `{ id, label, episodes?, count? }[]`: a series' episodes, behind an Episodes button | `[]` |
322
+ | `currentEpisode` | `string`: the `id` of the episode playing | — |
323
+ | `onEpisodeSelect` | `(id) => void`: plays the episode chosen in the list | — |
324
+ | `onSeasonOpen` | `(id) => void`: a season without `episodes` was opened; load them | — |
325
+ | `labels` | `Partial<VideoPlayerMessages>`: the player's words, over a LocaleProvider's | English |
326
+ | `variant` | `"region" \| "card" \| "plain"` | `"region"` |
327
+ | `aspectRatio` | `number`: width over height of the frame | `16 / 9` |
328
+ | `startTime` | `number`: seconds; the video loads from there (to resume), not from the start | — |
329
+ | `autoPlay` | `boolean`: only with `muted` | `false` |
330
+ | `loop` | `boolean` | `false` |
331
+ | `muted` | `boolean`: start muted | `false` |
332
+ | `volumeStorageKey` | `string`: keeps the viewer's volume and mute in localStorage under this key | — |
333
+ | `pauseOthers` | `boolean`: starting it with sound pauses the other players with sound | `true` |
334
+ | `speeds` | `number[] \| false`: the speed menu | `[0.5, 0.75, 1, 1.25, 1.5, 2]` |
335
+ | `pictureInPicture` | `boolean`: where the browser supports it | `true` |
336
+ | `fullscreen` | `boolean`: where the browser supports it | `true` |
337
+ | `pageShortcuts` | `boolean`: shortcuts work while nothing has focus, for a player that is the page | `false` |
338
+ | `onPlay` / `onPause` / `onEnded` | `() => void` | — |
339
+ | `onTimeChange` | `(seconds: number) => void`: as the playhead moves | — |
340
+ | `videoRef` | `Ref<HTMLVideoElement>`: the element, for anything else; a callback's cleanup runs | — |
341
+
342
+ Other props go to the root `div`; its `ref` and `onFocus` join the player's own. Data attributes: `data-layout`, `data-variant`, `data-playing`, `data-fullscreen`, and `data-idle` while the controls have stepped back.
343
+
344
+ ## Brand rules
345
+
346
+ - **Do** give every video a poster. A black frame before the first play looks broken.
347
+ - **Do** ship subtitles for anything with speech, on by default where people likely watch without sound.
348
+ - **Do** label a skip by what it passes over ("Skip intro", "Skip recap"), and only where the stretch is known, never guessed.
349
+ - **Do** name audio by language as people say it ("Deutsch") and quality by lines ("1080p").
350
+ - **Don't** autoplay with sound; autoplay only `muted`, where the video is the point of the page.
351
+ - **Don't** colour the scrubber or the play button. Progress is the foreground ink on the recessed track, like every slider.
352
+ - **Don't** round the default frame or give it a shadow; only `card` is an object.
353
+ - **Don't** put the player in a card inside a card. In a dialog, use `variant="plain"`.
354
+
355
+ ## Another language
356
+
357
+ Words come from a LocaleProvider's `videoPlayer` messages (German in `@zonsh/ui/messages/de`); `labels` overrides any for one player. Lengths of time are functions, so each language phrases them its own way.
358
+
359
+ ```tsx
360
+ <VideoPlayer
361
+ labels={{
362
+ play: "Wiedergabe",
363
+ pause: "Pause",
364
+ skipBack: (s) => `${s} Sekunden zurück`,
365
+ duration: (s) => `${Math.floor(s / 60)} Minuten ${Math.floor(s % 60)} Sekunden`,
366
+ position: (time, total) => `${time} von ${total}`,
367
+ // …
368
+ }}
369
+ />
370
+ ```
371
+
372
+ ## Accessibility
373
+
374
+ - The player is a labelled group (`title` names it) and takes focus, so shortcuts work after a click on the picture; tabbed to, it shows the focus ring.
375
+ - Every control is a real button named for what it does now ("Pause", "Unmute", "Hide subtitles", "Leave picture in picture"); a changing name doesn't also report a pressed state. AirPlay, named the same either way, reports `aria-pressed`. Menus name their current choice ("Subtitles, Deutsch", "Quality, 1080p").
376
+ - The scrubber is a native range input that reads its value in words: "1 minute 15 seconds of 3 minutes".
377
+ - Keyboard focus on a control keeps the controls (and the movie fade and title) up while playing.
378
+ - An expired skip is gone for the keyboard and screen readers too.
379
+ - The timeline runs left to right on a right-to-left page, as media timelines do; each subtitle line takes its own direction, so Arabic or Hebrew reads from the right.
380
+ - In a contrast theme (Windows), the played timeline and the volume take the system highlight, and the thumbs an edge.
381
+ - WebVTT subtitles are drawn as text, in the page's fonts.
382
+
383
+ ---
384
+
385
+ - Import: `import { VideoPlayer } from "@zonsh/ui"`
386
+ - Source: `packages/ui/src/components/video-player.tsx`