@mattebox/player 0.11.0 → 0.12.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 (334) hide show
  1. package/dist/announcer.d.ts +6 -3
  2. package/dist/announcer.d.ts.map +1 -1
  3. package/dist/announcer.js +17 -14
  4. package/dist/announcer.js.map +1 -1
  5. package/dist/cdn/mattebox-player.min.js +3 -3
  6. package/dist/controls/airplay.js +1 -2
  7. package/dist/controls/chapters.js +1 -2
  8. package/dist/controls/cues.js +1 -2
  9. package/dist/controls/fullscreen.js +1 -2
  10. package/dist/controls/icons.js +1 -2
  11. package/dist/controls/markers.d.ts +2 -15
  12. package/dist/controls/markers.d.ts.map +1 -1
  13. package/dist/controls/markers.js +1 -2
  14. package/dist/controls/markers.js.map +1 -1
  15. package/dist/controls/menu.js +1 -2
  16. package/dist/controls/native-tracks.js +1 -2
  17. package/dist/controls/pip.js +1 -2
  18. package/dist/controls/quality-names.js +1 -2
  19. package/dist/controls/ranges.js +1 -2
  20. package/dist/controls/session.js +1 -2
  21. package/dist/controls/slider.js +1 -2
  22. package/dist/controls/time.js +1 -2
  23. package/dist/controls/track-names.d.ts +3 -2
  24. package/dist/controls/track-names.d.ts.map +1 -1
  25. package/dist/controls/track-names.js +5 -5
  26. package/dist/controls/track-names.js.map +1 -1
  27. package/dist/dom.js +1 -2
  28. package/dist/element-entry.d.ts +4 -1
  29. package/dist/element-entry.d.ts.map +1 -1
  30. package/dist/element-entry.js +1 -2
  31. package/dist/element-entry.js.map +1 -1
  32. package/dist/element.d.ts +90 -6
  33. package/dist/element.d.ts.map +1 -1
  34. package/dist/element.js +212 -30
  35. package/dist/element.js.map +1 -1
  36. package/dist/elements/airplay-button.js +2 -3
  37. package/dist/elements/airplay-button.js.map +1 -1
  38. package/dist/elements/audio-menu.d.ts +3 -2
  39. package/dist/elements/audio-menu.d.ts.map +1 -1
  40. package/dist/elements/audio-menu.js +18 -12
  41. package/dist/elements/audio-menu.js.map +1 -1
  42. package/dist/elements/chapters-menu.d.ts +2 -1
  43. package/dist/elements/chapters-menu.d.ts.map +1 -1
  44. package/dist/elements/chapters-menu.js +2 -3
  45. package/dist/elements/chapters-menu.js.map +1 -1
  46. package/dist/elements/component.d.ts +9 -0
  47. package/dist/elements/component.d.ts.map +1 -1
  48. package/dist/elements/component.js +16 -2
  49. package/dist/elements/component.js.map +1 -1
  50. package/dist/elements/control-bar.js +1 -2
  51. package/dist/elements/current-time.js +1 -2
  52. package/dist/elements/drm-badge.js +4 -5
  53. package/dist/elements/drm-badge.js.map +1 -1
  54. package/dist/elements/duration.js +1 -2
  55. package/dist/elements/error-screen.d.ts +9 -0
  56. package/dist/elements/error-screen.d.ts.map +1 -1
  57. package/dist/elements/error-screen.js +54 -12
  58. package/dist/elements/error-screen.js.map +1 -1
  59. package/dist/elements/fullscreen-button.js +2 -3
  60. package/dist/elements/fullscreen-button.js.map +1 -1
  61. package/dist/elements/live-button.js +3 -4
  62. package/dist/elements/live-button.js.map +1 -1
  63. package/dist/elements/marker-button.d.ts.map +1 -1
  64. package/dist/elements/marker-button.js +7 -6
  65. package/dist/elements/marker-button.js.map +1 -1
  66. package/dist/elements/menu-element.d.ts +3 -2
  67. package/dist/elements/menu-element.d.ts.map +1 -1
  68. package/dist/elements/menu-element.js +3 -4
  69. package/dist/elements/menu-element.js.map +1 -1
  70. package/dist/elements/mute-button.js +2 -3
  71. package/dist/elements/mute-button.js.map +1 -1
  72. package/dist/elements/pip-button.js +2 -3
  73. package/dist/elements/pip-button.js.map +1 -1
  74. package/dist/elements/play-button.js +2 -3
  75. package/dist/elements/play-button.js.map +1 -1
  76. package/dist/elements/quality-menu.d.ts +2 -1
  77. package/dist/elements/quality-menu.d.ts.map +1 -1
  78. package/dist/elements/quality-menu.js +3 -4
  79. package/dist/elements/quality-menu.js.map +1 -1
  80. package/dist/elements/remaining-time.js +1 -2
  81. package/dist/elements/scan-button.d.ts.map +1 -1
  82. package/dist/elements/scan-button.js +2 -3
  83. package/dist/elements/scan-button.js.map +1 -1
  84. package/dist/elements/seek-bar.d.ts +2 -0
  85. package/dist/elements/seek-bar.d.ts.map +1 -1
  86. package/dist/elements/seek-bar.js +10 -7
  87. package/dist/elements/seek-bar.js.map +1 -1
  88. package/dist/elements/shared.js +1 -2
  89. package/dist/elements/skip-button.d.ts.map +1 -1
  90. package/dist/elements/skip-button.js +2 -3
  91. package/dist/elements/skip-button.js.map +1 -1
  92. package/dist/elements/spacer.js +1 -2
  93. package/dist/elements/speed-menu.d.ts +2 -1
  94. package/dist/elements/speed-menu.d.ts.map +1 -1
  95. package/dist/elements/speed-menu.js +3 -4
  96. package/dist/elements/speed-menu.js.map +1 -1
  97. package/dist/elements/spinner.d.ts +1 -1
  98. package/dist/elements/spinner.js +2 -4
  99. package/dist/elements/spinner.js.map +1 -1
  100. package/dist/elements/start-button.d.ts.map +1 -1
  101. package/dist/elements/start-button.js +2 -4
  102. package/dist/elements/start-button.js.map +1 -1
  103. package/dist/elements/subtitles-menu.d.ts +2 -1
  104. package/dist/elements/subtitles-menu.d.ts.map +1 -1
  105. package/dist/elements/subtitles-menu.js +51 -22
  106. package/dist/elements/subtitles-menu.js.map +1 -1
  107. package/dist/elements/time-element.js +1 -2
  108. package/dist/elements/title.d.ts.map +1 -1
  109. package/dist/elements/title.js +11 -5
  110. package/dist/elements/title.js.map +1 -1
  111. package/dist/elements/video-menu.d.ts +2 -1
  112. package/dist/elements/video-menu.d.ts.map +1 -1
  113. package/dist/elements/video-menu.js +12 -12
  114. package/dist/elements/video-menu.js.map +1 -1
  115. package/dist/elements/volume-slider.js +2 -3
  116. package/dist/elements/volume-slider.js.map +1 -1
  117. package/dist/elements/volume.js +1 -2
  118. package/dist/entries/airplay-button.js +1 -2
  119. package/dist/entries/audio-menu.js +1 -2
  120. package/dist/entries/chapters-menu.js +1 -2
  121. package/dist/entries/control-bar.js +1 -2
  122. package/dist/entries/current-time.js +1 -2
  123. package/dist/entries/drm-badge.js +1 -2
  124. package/dist/entries/duration.js +1 -2
  125. package/dist/entries/error-screen.js +1 -2
  126. package/dist/entries/fullscreen-button.js +1 -2
  127. package/dist/entries/live-button.js +1 -2
  128. package/dist/entries/marker-button.js +1 -2
  129. package/dist/entries/mute-button.js +1 -2
  130. package/dist/entries/pip-button.js +1 -2
  131. package/dist/entries/play-button.js +1 -2
  132. package/dist/entries/quality-menu.js +1 -2
  133. package/dist/entries/remaining-time.js +1 -2
  134. package/dist/entries/scan-button.js +1 -2
  135. package/dist/entries/seek-bar.js +1 -2
  136. package/dist/entries/skip-button.js +1 -2
  137. package/dist/entries/spacer.js +1 -2
  138. package/dist/entries/speed-menu.js +1 -2
  139. package/dist/entries/spinner.js +1 -2
  140. package/dist/entries/start-button.js +1 -2
  141. package/dist/entries/subtitles-menu.js +1 -2
  142. package/dist/entries/title.js +1 -2
  143. package/dist/entries/video-menu.js +1 -2
  144. package/dist/entries/volume-slider.js +1 -2
  145. package/dist/entries/volume.js +1 -2
  146. package/dist/es2015/_virtual/{_@oxc-project_runtime@0.154.0 → _@oxc-project_runtime@0.155.0}/helpers/esm/asyncToGenerator.js +1 -2
  147. package/dist/es2015/_virtual/{_@oxc-project_runtime@0.154.0 → _@oxc-project_runtime@0.155.0}/helpers/esm/defineProperty.js +1 -2
  148. package/dist/es2015/_virtual/{_@oxc-project_runtime@0.154.0 → _@oxc-project_runtime@0.155.0}/helpers/esm/objectSpread2.js +1 -2
  149. package/dist/es2015/_virtual/{_@oxc-project_runtime@0.154.0 → _@oxc-project_runtime@0.155.0}/helpers/esm/toPrimitive.js +1 -2
  150. package/dist/es2015/_virtual/{_@oxc-project_runtime@0.154.0 → _@oxc-project_runtime@0.155.0}/helpers/esm/toPropertyKey.js +1 -2
  151. package/dist/es2015/_virtual/{_@oxc-project_runtime@0.154.0 → _@oxc-project_runtime@0.155.0}/helpers/esm/typeof.js +1 -2
  152. package/dist/es2015/announcer.js +18 -15
  153. package/dist/es2015/controls/airplay.js +1 -2
  154. package/dist/es2015/controls/chapters.js +2 -3
  155. package/dist/es2015/controls/cues.js +1 -2
  156. package/dist/es2015/controls/fullscreen.js +1 -2
  157. package/dist/es2015/controls/icons.js +1 -2
  158. package/dist/es2015/controls/markers.js +1 -2
  159. package/dist/es2015/controls/menu.js +2 -3
  160. package/dist/es2015/controls/native-tracks.js +1 -2
  161. package/dist/es2015/controls/pip.js +1 -2
  162. package/dist/es2015/controls/quality-names.js +1 -2
  163. package/dist/es2015/controls/ranges.js +1 -2
  164. package/dist/es2015/controls/session.js +1 -2
  165. package/dist/es2015/controls/slider.js +1 -2
  166. package/dist/es2015/controls/time.js +1 -2
  167. package/dist/es2015/controls/track-names.js +5 -5
  168. package/dist/es2015/dom.js +1 -2
  169. package/dist/es2015/element-entry.js +1 -2
  170. package/dist/es2015/element.js +227 -37
  171. package/dist/es2015/elements/airplay-button.js +2 -4
  172. package/dist/es2015/elements/audio-menu.js +18 -16
  173. package/dist/es2015/elements/chapters-menu.js +2 -3
  174. package/dist/es2015/elements/component.js +18 -2
  175. package/dist/es2015/elements/control-bar.js +1 -2
  176. package/dist/es2015/elements/current-time.js +1 -2
  177. package/dist/es2015/elements/drm-badge.js +5 -7
  178. package/dist/es2015/elements/duration.js +1 -2
  179. package/dist/es2015/elements/error-screen.js +56 -13
  180. package/dist/es2015/elements/fullscreen-button.js +2 -4
  181. package/dist/es2015/elements/live-button.js +3 -5
  182. package/dist/es2015/elements/marker-button.js +8 -7
  183. package/dist/es2015/elements/menu-element.js +3 -8
  184. package/dist/es2015/elements/mute-button.js +3 -4
  185. package/dist/es2015/elements/pip-button.js +2 -4
  186. package/dist/es2015/elements/play-button.js +2 -4
  187. package/dist/es2015/elements/quality-menu.js +4 -5
  188. package/dist/es2015/elements/remaining-time.js +1 -2
  189. package/dist/es2015/elements/scan-button.js +3 -4
  190. package/dist/es2015/elements/seek-bar.js +12 -11
  191. package/dist/es2015/elements/shared.js +1 -2
  192. package/dist/es2015/elements/skip-button.js +2 -4
  193. package/dist/es2015/elements/spacer.js +1 -2
  194. package/dist/es2015/elements/speed-menu.js +4 -5
  195. package/dist/es2015/elements/spinner.js +2 -5
  196. package/dist/es2015/elements/start-button.js +3 -5
  197. package/dist/es2015/elements/subtitles-menu.js +53 -31
  198. package/dist/es2015/elements/time-element.js +1 -2
  199. package/dist/es2015/elements/title.js +12 -6
  200. package/dist/es2015/elements/video-menu.js +12 -12
  201. package/dist/es2015/elements/volume-slider.js +3 -4
  202. package/dist/es2015/elements/volume.js +1 -2
  203. package/dist/es2015/entries/airplay-button.js +1 -2
  204. package/dist/es2015/entries/audio-menu.js +1 -2
  205. package/dist/es2015/entries/chapters-menu.js +1 -2
  206. package/dist/es2015/entries/control-bar.js +1 -2
  207. package/dist/es2015/entries/current-time.js +1 -2
  208. package/dist/es2015/entries/drm-badge.js +1 -2
  209. package/dist/es2015/entries/duration.js +1 -2
  210. package/dist/es2015/entries/error-screen.js +1 -2
  211. package/dist/es2015/entries/fullscreen-button.js +1 -2
  212. package/dist/es2015/entries/live-button.js +1 -2
  213. package/dist/es2015/entries/marker-button.js +1 -2
  214. package/dist/es2015/entries/mute-button.js +1 -2
  215. package/dist/es2015/entries/pip-button.js +1 -2
  216. package/dist/es2015/entries/play-button.js +1 -2
  217. package/dist/es2015/entries/quality-menu.js +1 -2
  218. package/dist/es2015/entries/remaining-time.js +1 -2
  219. package/dist/es2015/entries/scan-button.js +1 -2
  220. package/dist/es2015/entries/seek-bar.js +1 -2
  221. package/dist/es2015/entries/skip-button.js +1 -2
  222. package/dist/es2015/entries/spacer.js +1 -2
  223. package/dist/es2015/entries/speed-menu.js +1 -2
  224. package/dist/es2015/entries/spinner.js +1 -2
  225. package/dist/es2015/entries/start-button.js +1 -2
  226. package/dist/es2015/entries/subtitles-menu.js +1 -2
  227. package/dist/es2015/entries/title.js +1 -2
  228. package/dist/es2015/entries/video-menu.js +1 -2
  229. package/dist/es2015/entries/volume-slider.js +1 -2
  230. package/dist/es2015/entries/volume.js +1 -2
  231. package/dist/es2015/host.js +1 -2
  232. package/dist/es2015/ids.js +33 -0
  233. package/dist/es2015/index.js +2 -1
  234. package/dist/es2015/labels.js +1 -2
  235. package/dist/es2015/locales/ar.js +75 -0
  236. package/dist/es2015/locales/ca.js +75 -0
  237. package/dist/es2015/locales/de.js +75 -0
  238. package/dist/es2015/locales/es.js +75 -0
  239. package/dist/es2015/locales/fr.js +75 -0
  240. package/dist/es2015/locales/hi.js +75 -0
  241. package/dist/es2015/locales/it.js +75 -0
  242. package/dist/es2015/locales/ja.js +75 -0
  243. package/dist/es2015/locales/ko.js +75 -0
  244. package/dist/es2015/locales/pt.js +75 -0
  245. package/dist/es2015/locales/zh.js +75 -0
  246. package/dist/es2015/locales.js +61 -0
  247. package/dist/es2015/namespaces.js +1 -2
  248. package/dist/es2015/presets.js +2 -3
  249. package/dist/es2015/style.js +1 -2
  250. package/dist/es2015/surface.js +12 -4
  251. package/dist/es2015/tags.js +1 -2
  252. package/dist/es2015/text.js +15 -0
  253. package/dist/es2015/trackers.js +43 -0
  254. package/dist/es2015/video-sources.js +2 -3
  255. package/dist/host.d.ts +40 -1
  256. package/dist/host.d.ts.map +1 -1
  257. package/dist/host.js +1 -2
  258. package/dist/host.js.map +1 -1
  259. package/dist/ids.d.ts +19 -0
  260. package/dist/ids.d.ts.map +1 -0
  261. package/dist/ids.js +34 -0
  262. package/dist/ids.js.map +1 -0
  263. package/dist/index.d.ts +8 -1
  264. package/dist/index.d.ts.map +1 -1
  265. package/dist/index.js +2 -1
  266. package/dist/labels.js +1 -2
  267. package/dist/locales/ar.d.ts +75 -0
  268. package/dist/locales/ar.d.ts.map +1 -0
  269. package/dist/locales/ar.js +77 -0
  270. package/dist/locales/ar.js.map +1 -0
  271. package/dist/locales/ca.d.ts +75 -0
  272. package/dist/locales/ca.d.ts.map +1 -0
  273. package/dist/locales/ca.js +77 -0
  274. package/dist/locales/ca.js.map +1 -0
  275. package/dist/locales/de.d.ts +75 -0
  276. package/dist/locales/de.d.ts.map +1 -0
  277. package/dist/locales/de.js +77 -0
  278. package/dist/locales/de.js.map +1 -0
  279. package/dist/locales/es.d.ts +75 -0
  280. package/dist/locales/es.d.ts.map +1 -0
  281. package/dist/locales/es.js +77 -0
  282. package/dist/locales/es.js.map +1 -0
  283. package/dist/locales/fr.d.ts +75 -0
  284. package/dist/locales/fr.d.ts.map +1 -0
  285. package/dist/locales/fr.js +77 -0
  286. package/dist/locales/fr.js.map +1 -0
  287. package/dist/locales/hi.d.ts +75 -0
  288. package/dist/locales/hi.d.ts.map +1 -0
  289. package/dist/locales/hi.js +77 -0
  290. package/dist/locales/hi.js.map +1 -0
  291. package/dist/locales/it.d.ts +75 -0
  292. package/dist/locales/it.d.ts.map +1 -0
  293. package/dist/locales/it.js +77 -0
  294. package/dist/locales/it.js.map +1 -0
  295. package/dist/locales/ja.d.ts +75 -0
  296. package/dist/locales/ja.d.ts.map +1 -0
  297. package/dist/locales/ja.js +77 -0
  298. package/dist/locales/ja.js.map +1 -0
  299. package/dist/locales/ko.d.ts +75 -0
  300. package/dist/locales/ko.d.ts.map +1 -0
  301. package/dist/locales/ko.js +77 -0
  302. package/dist/locales/ko.js.map +1 -0
  303. package/dist/locales/pt.d.ts +75 -0
  304. package/dist/locales/pt.d.ts.map +1 -0
  305. package/dist/locales/pt.js +77 -0
  306. package/dist/locales/pt.js.map +1 -0
  307. package/dist/locales/zh.d.ts +75 -0
  308. package/dist/locales/zh.d.ts.map +1 -0
  309. package/dist/locales/zh.js +77 -0
  310. package/dist/locales/zh.js.map +1 -0
  311. package/dist/locales.d.ts +27 -0
  312. package/dist/locales.d.ts.map +1 -0
  313. package/dist/locales.js +48 -0
  314. package/dist/locales.js.map +1 -0
  315. package/dist/messages.d.ts +167 -0
  316. package/dist/messages.d.ts.map +1 -0
  317. package/dist/namespaces.js +1 -2
  318. package/dist/presets.js +1 -2
  319. package/dist/style.js +1 -2
  320. package/dist/surface.d.ts +4 -1
  321. package/dist/surface.d.ts.map +1 -1
  322. package/dist/surface.js +12 -4
  323. package/dist/surface.js.map +1 -1
  324. package/dist/tags.js +1 -2
  325. package/dist/text.d.ts +14 -0
  326. package/dist/text.d.ts.map +1 -0
  327. package/dist/text.js +16 -0
  328. package/dist/text.js.map +1 -0
  329. package/dist/trackers.d.ts +18 -0
  330. package/dist/trackers.d.ts.map +1 -0
  331. package/dist/trackers.js +45 -0
  332. package/dist/trackers.js.map +1 -0
  333. package/dist/video-sources.js +1 -2
  334. package/package.json +11 -3
@@ -1,7 +1,10 @@
1
+ import type { Messages } from './messages.js';
1
2
  export interface Announcer {
2
3
  readonly root: HTMLElement;
3
- /** Says the phrase of `label-<name>`, else `fallback`. */
4
- say(name: string, fallback: string, track?: string): void;
4
+ /** Says the phrase of `label-<name>`, else the language's `id`, else `fallback`. */
5
+ say(name: string, id: keyof Messages, fallback: string, track?: string): void;
6
+ /** Says `text` as it is: words the page gave, such as a block's. */
7
+ tell(text: string): void;
5
8
  }
6
- export declare function announcer(host: HTMLElement): Announcer;
9
+ export declare function announcer(host: HTMLElement, word: (id: keyof Messages) => string | undefined): Announcer;
7
10
  //# sourceMappingURL=announcer.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"announcer.d.ts","sourceRoot":"","sources":["../src/announcer.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,0DAA0D;IAC1D,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3D;AASD,wBAAgB,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,CAkBtD"}
1
+ {"version":3,"file":"announcer.d.ts","sourceRoot":"","sources":["../src/announcer.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,oFAAoF;IACpF,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9E,oEAAoE;IACpE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AASD,wBAAgB,SAAS,CACvB,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,QAAQ,KAAK,MAAM,GAAG,SAAS,GAC/C,SAAS,CAqBX"}
package/dist/announcer.js CHANGED
@@ -1,6 +1,6 @@
1
1
  import { el } from "./dom.js";
2
2
  import { fill } from "./labels.js";
3
- //#region src/announcer.ts
3
+ // src/announcer.ts
4
4
  /**
5
5
  * The live region: what changed on the player, said to a screen reader.
6
6
  * A shortcut key or a remote changes the playback with no focused control
@@ -11,8 +11,9 @@ import { fill } from "./labels.js";
11
11
  * Every phrase is an attribute on the player, `label-playing`,
12
12
  * `label-paused`, `label-loading`, `label-error`, `label-audio`,
13
13
  * `label-subtitles` and `label-subtitles-off`; `{track}` in the last
14
- * three's text is the track's name. `announce="off"` keeps it quiet, for
15
- * a page that announces on its own.
14
+ * three's text is the track's name. Without the attribute, the phrase
15
+ * comes from the player's language, else English. `announce="off"` keeps
16
+ * it quiet, for a page that announces on its own.
16
17
  */
17
18
  /**
18
19
  * A screen reader reads a live region when its text changes, so the same
@@ -20,25 +21,27 @@ import { fill } from "./labels.js";
20
21
  * first. The delay lets the reader see the empty region.
21
22
  */
22
23
  const REFILL_MS = 100;
23
- function announcer(host) {
24
+ function announcer(host, word) {
24
25
  const root = el("div", "announcer");
25
26
  root.setAttribute("role", "status");
26
27
  root.setAttribute("aria-live", "polite");
27
28
  let timer;
29
+ const tell = (text) => {
30
+ if (host.getAttribute("announce") === "off") return;
31
+ root.textContent = "";
32
+ clearTimeout(timer);
33
+ timer = setTimeout(() => {
34
+ root.textContent = text;
35
+ }, REFILL_MS);
36
+ };
28
37
  return {
29
38
  root,
30
- say(name, fallback, track = "") {
31
- if (host.getAttribute("announce") === "off") return;
32
- const text = fill(host.getAttribute(`label-${name}`) ?? fallback, { track });
33
- root.textContent = "";
34
- clearTimeout(timer);
35
- timer = setTimeout(() => {
36
- root.textContent = text;
37
- }, REFILL_MS);
38
- }
39
+ say(name, id, fallback, track = "") {
40
+ tell(fill(host.getAttribute(`label-${name}`) ?? word(id) ?? fallback, { track }));
41
+ },
42
+ tell
39
43
  };
40
44
  }
41
- //#endregion
42
45
  export { announcer };
43
46
 
44
47
  //# sourceMappingURL=announcer.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"announcer.js","names":[],"sources":["../src/announcer.ts"],"sourcesContent":["/**\n * The live region: what changed on the player, said to a screen reader.\n * A shortcut key or a remote changes the playback with no focused control\n * to read, so the element says it here: play, pause, loading, a fatal\n * error and a track change (WCAG 2.2 SC 4.1.3, Status Messages). Vidstack's\n * media announcer says the same things.\n *\n * Every phrase is an attribute on the player, `label-playing`,\n * `label-paused`, `label-loading`, `label-error`, `label-audio`,\n * `label-subtitles` and `label-subtitles-off`; `{track}` in the last\n * three's text is the track's name. `announce=\"off\"` keeps it quiet, for\n * a page that announces on its own.\n */\nimport { el } from './dom.js';\nimport { fill } from './labels.js';\n\nexport interface Announcer {\n readonly root: HTMLElement;\n /** Says the phrase of `label-<name>`, else `fallback`. */\n say(name: string, fallback: string, track?: string): void;\n}\n\n/**\n * A screen reader reads a live region when its text changes, so the same\n * phrase twice in a row, such as two pauses, has to empty the region\n * first. The delay lets the reader see the empty region.\n */\nconst REFILL_MS = 100;\n\nexport function announcer(host: HTMLElement): Announcer {\n const root = el('div', 'announcer');\n root.setAttribute('role', 'status');\n // role=\"status\" implies it; some older screen readers read only the attribute.\n root.setAttribute('aria-live', 'polite');\n let timer: ReturnType<typeof setTimeout> | undefined;\n return {\n root,\n say(name, fallback, track = '') {\n if (host.getAttribute('announce') === 'off') return;\n const text = fill(host.getAttribute(`label-${name}`) ?? fallback, { track });\n root.textContent = '';\n clearTimeout(timer);\n timer = setTimeout(() => {\n root.textContent = text;\n }, REFILL_MS);\n },\n };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA2BA,MAAM,YAAY;AAElB,SAAgB,UAAU,MAA8B;CACtD,MAAM,OAAO,GAAG,OAAO,WAAW;CAClC,KAAK,aAAa,QAAQ,QAAQ;CAElC,KAAK,aAAa,aAAa,QAAQ;CACvC,IAAI;CACJ,OAAO;EACL;EACA,IAAI,MAAM,UAAU,QAAQ,IAAI;GAC9B,IAAI,KAAK,aAAa,UAAU,MAAM,OAAO;GAC7C,MAAM,OAAO,KAAK,KAAK,aAAa,SAAS,MAAM,KAAK,UAAU,EAAE,MAAM,CAAC;GAC3E,KAAK,cAAc;GACnB,aAAa,KAAK;GAClB,QAAQ,iBAAiB;IACvB,KAAK,cAAc;GACrB,GAAG,SAAS;EACd;CACF;AACF"}
1
+ {"version":3,"file":"announcer.js","names":[],"sources":["../src/announcer.ts"],"sourcesContent":["/**\n * The live region: what changed on the player, said to a screen reader.\n * A shortcut key or a remote changes the playback with no focused control\n * to read, so the element says it here: play, pause, loading, a fatal\n * error and a track change (WCAG 2.2 SC 4.1.3, Status Messages). Vidstack's\n * media announcer says the same things.\n *\n * Every phrase is an attribute on the player, `label-playing`,\n * `label-paused`, `label-loading`, `label-error`, `label-audio`,\n * `label-subtitles` and `label-subtitles-off`; `{track}` in the last\n * three's text is the track's name. Without the attribute, the phrase\n * comes from the player's language, else English. `announce=\"off\"` keeps\n * it quiet, for a page that announces on its own.\n */\nimport { el } from './dom.js';\nimport { fill } from './labels.js';\nimport type { Messages } from './messages.js';\n\nexport interface Announcer {\n readonly root: HTMLElement;\n /** Says the phrase of `label-<name>`, else the language's `id`, else `fallback`. */\n say(name: string, id: keyof Messages, fallback: string, track?: string): void;\n /** Says `text` as it is: words the page gave, such as a block's. */\n tell(text: string): void;\n}\n\n/**\n * A screen reader reads a live region when its text changes, so the same\n * phrase twice in a row, such as two pauses, has to empty the region\n * first. The delay lets the reader see the empty region.\n */\nconst REFILL_MS = 100;\n\nexport function announcer(\n host: HTMLElement,\n word: (id: keyof Messages) => string | undefined,\n): Announcer {\n const root = el('div', 'announcer');\n root.setAttribute('role', 'status');\n // role=\"status\" implies it; some older screen readers read only the attribute.\n root.setAttribute('aria-live', 'polite');\n let timer: ReturnType<typeof setTimeout> | undefined;\n const tell = (text: string): void => {\n if (host.getAttribute('announce') === 'off') return;\n root.textContent = '';\n clearTimeout(timer);\n timer = setTimeout(() => {\n root.textContent = text;\n }, REFILL_MS);\n };\n return {\n root,\n say(name, id, fallback, track = '') {\n tell(fill(host.getAttribute(`label-${name}`) ?? word(id) ?? fallback, { track }));\n },\n tell,\n };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AA+BA,MAAM,YAAY;AAElB,SAAgB,UACd,MACA,MACW;CACX,MAAM,OAAO,GAAG,OAAO,WAAW;CAClC,KAAK,aAAa,QAAQ,QAAQ;CAElC,KAAK,aAAa,aAAa,QAAQ;CACvC,IAAI;CACJ,MAAM,QAAQ,SAAuB;EACnC,IAAI,KAAK,aAAa,UAAU,MAAM,OAAO;EAC7C,KAAK,cAAc;EACnB,aAAa,KAAK;EAClB,QAAQ,iBAAiB;GACvB,KAAK,cAAc;EACrB,GAAG,SAAS;CACd;CACA,OAAO;EACL;EACA,IAAI,MAAM,IAAI,UAAU,QAAQ,IAAI;GAClC,KAAK,KAAK,KAAK,aAAa,SAAS,MAAM,KAAK,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,CAAC,CAAC;EAClF;EACA;CACF;AACF"}