@videojs/spf 10.0.0-beta.8 → 10.0.0-rc.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (556) hide show
  1. package/README.md +19 -38
  2. package/dist/default/core/actors/create-machine-actor.js +89 -0
  3. package/dist/default/core/actors/create-machine-actor.js.map +1 -0
  4. package/dist/default/core/actors/create-transition-actor.js +44 -0
  5. package/dist/default/core/actors/create-transition-actor.js.map +1 -0
  6. package/dist/default/core/composition/create-composition.js +82 -0
  7. package/dist/default/core/composition/create-composition.js.map +1 -0
  8. package/dist/default/core/composition/share-signals.js +34 -0
  9. package/dist/default/core/composition/share-signals.js.map +1 -0
  10. package/dist/default/core/machine.js +25 -0
  11. package/dist/default/core/machine.js.map +1 -0
  12. package/dist/default/core/reactors/create-machine-reactor.js +84 -0
  13. package/dist/default/core/reactors/create-machine-reactor.js.map +1 -0
  14. package/dist/default/core/signals/effect.js +61 -0
  15. package/dist/default/core/signals/effect.js.map +1 -0
  16. package/dist/default/core/signals/primitives.js +50 -0
  17. package/dist/default/core/signals/primitives.js.map +1 -0
  18. package/dist/default/core/signals/when.js +36 -0
  19. package/dist/default/core/signals/when.js.map +1 -0
  20. package/dist/default/core/tasks/delayed-reschedule.js +27 -0
  21. package/dist/default/core/tasks/delayed-reschedule.js.map +1 -0
  22. package/dist/default/core/tasks/task.js +298 -0
  23. package/dist/default/core/tasks/task.js.map +1 -0
  24. package/dist/default/dom.js +9 -0
  25. package/dist/default/hls-audio.js +3 -0
  26. package/dist/default/hls-background-video.js +3 -0
  27. package/dist/default/hls-video.js +4 -0
  28. package/dist/default/hls.js +10 -0
  29. package/dist/default/index.js +22 -0
  30. package/dist/default/index.js.map +1 -0
  31. package/dist/default/media/abr/quality-selection.js +17 -0
  32. package/dist/default/media/abr/quality-selection.js.map +1 -0
  33. package/dist/default/media/buffer/back-buffer.js +42 -0
  34. package/dist/default/media/buffer/back-buffer.js.map +1 -0
  35. package/dist/default/media/buffer/forward-buffer.js +110 -0
  36. package/dist/default/media/buffer/forward-buffer.js.map +1 -0
  37. package/dist/default/media/dom/capabilities.js +61 -0
  38. package/dist/default/media/dom/capabilities.js.map +1 -0
  39. package/dist/default/media/dom/mse/append-segment.js +58 -0
  40. package/dist/default/media/dom/mse/append-segment.js.map +1 -0
  41. package/dist/default/media/dom/mse/buffer-flusher.js +55 -0
  42. package/dist/default/media/dom/mse/buffer-flusher.js.map +1 -0
  43. package/dist/default/media/dom/mse/duration.js +87 -0
  44. package/dist/default/media/dom/mse/duration.js.map +1 -0
  45. package/dist/default/media/dom/mse/end-of-stream.js +17 -0
  46. package/dist/default/media/dom/mse/end-of-stream.js.map +1 -0
  47. package/dist/default/media/dom/mse/mediasource-setup.js +227 -0
  48. package/dist/default/media/dom/mse/mediasource-setup.js.map +1 -0
  49. package/dist/default/media/dom/screen.js +95 -0
  50. package/dist/default/media/dom/screen.js.map +1 -0
  51. package/dist/default/media/dom/text/resolve-vtt-segment.js +50 -0
  52. package/dist/default/media/dom/text/resolve-vtt-segment.js.map +1 -0
  53. package/dist/default/media/dom/text/text-track-slots.js +61 -0
  54. package/dist/default/media/dom/text/text-track-slots.js.map +1 -0
  55. package/dist/default/media/errors.js +60 -0
  56. package/dist/default/media/errors.js.map +1 -0
  57. package/dist/default/media/hls/parse-attributes.js +131 -0
  58. package/dist/default/media/hls/parse-attributes.js.map +1 -0
  59. package/dist/default/media/hls/parse-media-playlist.js +253 -0
  60. package/dist/default/media/hls/parse-media-playlist.js.map +1 -0
  61. package/dist/default/media/hls/parse-multivariant.js +234 -0
  62. package/dist/default/media/hls/parse-multivariant.js.map +1 -0
  63. package/dist/default/media/hls/reload-policy.js +63 -0
  64. package/dist/default/media/hls/reload-policy.js.map +1 -0
  65. package/dist/default/media/hls/resolve-url.js +9 -0
  66. package/dist/default/media/hls/resolve-url.js.map +1 -0
  67. package/dist/default/media/live-window.js +32 -0
  68. package/dist/default/media/live-window.js.map +1 -0
  69. package/dist/default/media/media-tracks/media-tracks.js +96 -0
  70. package/dist/default/media/media-tracks/media-tracks.js.map +1 -0
  71. package/dist/default/media/mp4/box.js +57 -0
  72. package/dist/default/media/mp4/box.js.map +1 -0
  73. package/dist/default/media/mp4/timestamp-origin.js +95 -0
  74. package/dist/default/media/mp4/timestamp-origin.js.map +1 -0
  75. package/dist/default/media/primitives/resolution.js +26 -0
  76. package/dist/default/media/primitives/resolution.js.map +1 -0
  77. package/dist/default/media/primitives/select-tracks.js +97 -0
  78. package/dist/default/media/primitives/select-tracks.js.map +1 -0
  79. package/dist/default/media/text/parse-vtt-timestamp-map.js +40 -0
  80. package/dist/default/media/text/parse-vtt-timestamp-map.js.map +1 -0
  81. package/dist/default/media/text/resolve-vtt-metadata.js +22 -0
  82. package/dist/default/media/text/resolve-vtt-metadata.js.map +1 -0
  83. package/dist/default/media/types/index.js +42 -0
  84. package/dist/default/media/types/index.js.map +1 -0
  85. package/dist/default/media/utils/cdn.js +50 -0
  86. package/dist/default/media/utils/cdn.js.map +1 -0
  87. package/dist/default/media/utils/preload.js +21 -0
  88. package/dist/default/media/utils/preload.js.map +1 -0
  89. package/dist/default/media/utils/track-selection.js +43 -0
  90. package/dist/default/media/utils/track-selection.js.map +1 -0
  91. package/dist/default/media/utils/tracks.js +146 -0
  92. package/dist/default/media/utils/tracks.js.map +1 -0
  93. package/dist/default/media-tracks.js +2 -0
  94. package/dist/default/network/bandwidth-estimator.js +95 -0
  95. package/dist/default/network/bandwidth-estimator.js.map +1 -0
  96. package/dist/default/network/chunked-stream-iterable.js +47 -0
  97. package/dist/default/network/chunked-stream-iterable.js.map +1 -0
  98. package/dist/default/network/ewma.js +68 -0
  99. package/dist/default/network/ewma.js.map +1 -0
  100. package/dist/default/network/fetch.js +108 -0
  101. package/dist/default/network/fetch.js.map +1 -0
  102. package/dist/default/playback/actors/dom/segment-loader.js +233 -0
  103. package/dist/default/playback/actors/dom/segment-loader.js.map +1 -0
  104. package/dist/default/playback/actors/dom/source-buffer.js +139 -0
  105. package/dist/default/playback/actors/dom/source-buffer.js.map +1 -0
  106. package/dist/default/playback/actors/dom/text-tracks.js +46 -0
  107. package/dist/default/playback/actors/dom/text-tracks.js.map +1 -0
  108. package/dist/default/playback/actors/text-track-segment-loader.js +138 -0
  109. package/dist/default/playback/actors/text-track-segment-loader.js.map +1 -0
  110. package/dist/default/playback/adapters/hls-audio/adapter.js +8 -0
  111. package/dist/default/playback/adapters/hls-audio/adapter.js.map +1 -0
  112. package/dist/default/playback/adapters/hls-audio/mixin.js +178 -0
  113. package/dist/default/playback/adapters/hls-audio/mixin.js.map +1 -0
  114. package/dist/default/playback/adapters/hls-background-video/adapter.js +17 -0
  115. package/dist/default/playback/adapters/hls-background-video/adapter.js.map +1 -0
  116. package/dist/default/playback/adapters/hls-background-video/host.js +56 -0
  117. package/dist/default/playback/adapters/hls-background-video/host.js.map +1 -0
  118. package/dist/default/playback/adapters/hls-background-video/mixin.js +191 -0
  119. package/dist/default/playback/adapters/hls-background-video/mixin.js.map +1 -0
  120. package/dist/default/playback/adapters/hls-video/adapter.js +11 -0
  121. package/dist/default/playback/adapters/hls-video/adapter.js.map +1 -0
  122. package/dist/default/playback/adapters/hls-video/error-surface.js +46 -0
  123. package/dist/default/playback/adapters/hls-video/error-surface.js.map +1 -0
  124. package/dist/default/playback/adapters/hls-video/media-tracks.js +125 -0
  125. package/dist/default/playback/adapters/hls-video/media-tracks.js.map +1 -0
  126. package/dist/default/playback/adapters/hls-video/mixin.js +299 -0
  127. package/dist/default/playback/adapters/hls-video/mixin.js.map +1 -0
  128. package/dist/default/playback/behaviors/calculate-presentation-duration.js +33 -0
  129. package/dist/default/playback/behaviors/calculate-presentation-duration.js.map +1 -0
  130. package/dist/default/playback/behaviors/collect-errors.js +98 -0
  131. package/dist/default/playback/behaviors/collect-errors.js.map +1 -0
  132. package/dist/default/playback/behaviors/derive-cdn-priority.js +61 -0
  133. package/dist/default/playback/behaviors/derive-cdn-priority.js.map +1 -0
  134. package/dist/default/playback/behaviors/dom/airplay.js +188 -0
  135. package/dist/default/playback/behaviors/dom/airplay.js.map +1 -0
  136. package/dist/default/playback/behaviors/dom/apply-start-position.js +81 -0
  137. package/dist/default/playback/behaviors/dom/apply-start-position.js.map +1 -0
  138. package/dist/default/playback/behaviors/dom/end-of-stream.js +97 -0
  139. package/dist/default/playback/behaviors/dom/end-of-stream.js.map +1 -0
  140. package/dist/default/playback/behaviors/dom/load-segments.js +169 -0
  141. package/dist/default/playback/behaviors/dom/load-segments.js.map +1 -0
  142. package/dist/default/playback/behaviors/dom/recover-end-stall.js +72 -0
  143. package/dist/default/playback/behaviors/dom/recover-end-stall.js.map +1 -0
  144. package/dist/default/playback/behaviors/dom/seek-to-live-edge.js +113 -0
  145. package/dist/default/playback/behaviors/dom/seek-to-live-edge.js.map +1 -0
  146. package/dist/default/playback/behaviors/dom/setup-buffer-actors.js +181 -0
  147. package/dist/default/playback/behaviors/dom/setup-buffer-actors.js.map +1 -0
  148. package/dist/default/playback/behaviors/dom/setup-mediasource.js +100 -0
  149. package/dist/default/playback/behaviors/dom/setup-mediasource.js.map +1 -0
  150. package/dist/default/playback/behaviors/dom/setup-text-track-actors.js +40 -0
  151. package/dist/default/playback/behaviors/dom/setup-text-track-actors.js.map +1 -0
  152. package/dist/default/playback/behaviors/dom/sync-live-seekable-range.js +25 -0
  153. package/dist/default/playback/behaviors/dom/sync-live-seekable-range.js.map +1 -0
  154. package/dist/default/playback/behaviors/dom/sync-text-tracks.js +109 -0
  155. package/dist/default/playback/behaviors/dom/sync-text-tracks.js.map +1 -0
  156. package/dist/default/playback/behaviors/dom/track-current-time.js +50 -0
  157. package/dist/default/playback/behaviors/dom/track-current-time.js.map +1 -0
  158. package/dist/default/playback/behaviors/dom/track-load-triggers.js +86 -0
  159. package/dist/default/playback/behaviors/dom/track-load-triggers.js.map +1 -0
  160. package/dist/default/playback/behaviors/dom/track-playback-rate.js +35 -0
  161. package/dist/default/playback/behaviors/dom/track-playback-rate.js.map +1 -0
  162. package/dist/default/playback/behaviors/dom/track-player-resolution.js +53 -0
  163. package/dist/default/playback/behaviors/dom/track-player-resolution.js.map +1 -0
  164. package/dist/default/playback/behaviors/dom/track-screen-resolution.js +28 -0
  165. package/dist/default/playback/behaviors/dom/track-screen-resolution.js.map +1 -0
  166. package/dist/default/playback/behaviors/dom/update-mediasource-duration.js +98 -0
  167. package/dist/default/playback/behaviors/dom/update-mediasource-duration.js.map +1 -0
  168. package/dist/default/playback/behaviors/establish-start-media-time.js +187 -0
  169. package/dist/default/playback/behaviors/establish-start-media-time.js.map +1 -0
  170. package/dist/default/playback/behaviors/resolve-presentation.js +76 -0
  171. package/dist/default/playback/behaviors/resolve-presentation.js.map +1 -0
  172. package/dist/default/playback/behaviors/resolve-track.js +134 -0
  173. package/dist/default/playback/behaviors/resolve-track.js.map +1 -0
  174. package/dist/default/playback/behaviors/select-tracks.js +189 -0
  175. package/dist/default/playback/behaviors/select-tracks.js.map +1 -0
  176. package/dist/default/playback/behaviors/setup-failover-monitor.js +61 -0
  177. package/dist/default/playback/behaviors/setup-failover-monitor.js.map +1 -0
  178. package/dist/default/playback/behaviors/sync-preload.js +59 -0
  179. package/dist/default/playback/behaviors/sync-preload.js.map +1 -0
  180. package/dist/default/playback/behaviors/track-switching.js +407 -0
  181. package/dist/default/playback/behaviors/track-switching.js.map +1 -0
  182. package/dist/default/playback/engines/hls/engine-audio-only.js +94 -0
  183. package/dist/default/playback/engines/hls/engine-audio-only.js.map +1 -0
  184. package/dist/default/playback/engines/hls/engine-background-video.js +87 -0
  185. package/dist/default/playback/engines/hls/engine-background-video.js.map +1 -0
  186. package/dist/default/playback/engines/hls/engine.js +144 -0
  187. package/dist/default/playback/engines/hls/engine.js.map +1 -0
  188. package/dist/default/playback/primitives/error-messages.js +42 -0
  189. package/dist/default/playback/primitives/error-messages.js.map +1 -0
  190. package/dist/default/playback/primitives/failover-fetch.js +37 -0
  191. package/dist/default/playback/primitives/failover-fetch.js.map +1 -0
  192. package/dist/default/playback/primitives/head-peek.js +41 -0
  193. package/dist/default/playback/primitives/head-peek.js.map +1 -0
  194. package/dist/default/playback/primitives/live-window.js +63 -0
  195. package/dist/default/playback/primitives/live-window.js.map +1 -0
  196. package/dist/default/playback/primitives/relocation-pipelines.js +191 -0
  197. package/dist/default/playback/primitives/relocation-pipelines.js.map +1 -0
  198. package/dist/default/playback/primitives/report-track-conditions.js +74 -0
  199. package/dist/default/playback/primitives/report-track-conditions.js.map +1 -0
  200. package/dist/default/playback/primitives/segment-load-pipeline.js +96 -0
  201. package/dist/default/playback/primitives/segment-load-pipeline.js.map +1 -0
  202. package/dist/default/playback/primitives/selection-rules.js +115 -0
  203. package/dist/default/playback/primitives/selection-rules.js.map +1 -0
  204. package/dist/default/playback/primitives/text-segment-load-pipeline.js +36 -0
  205. package/dist/default/playback/primitives/text-segment-load-pipeline.js.map +1 -0
  206. package/dist/default/playback/primitives/track-types.js +53 -0
  207. package/dist/default/playback/primitives/track-types.js.map +1 -0
  208. package/dist/dev/core/actors/actor.d.ts +26 -0
  209. package/dist/dev/core/actors/actor.d.ts.map +1 -0
  210. package/dist/dev/core/actors/create-machine-actor.d.ts +119 -0
  211. package/dist/dev/core/actors/create-machine-actor.d.ts.map +1 -0
  212. package/dist/dev/core/actors/create-machine-actor.js +89 -0
  213. package/dist/dev/core/actors/create-machine-actor.js.map +1 -0
  214. package/dist/dev/core/actors/create-transition-actor.d.ts +37 -0
  215. package/dist/dev/core/actors/create-transition-actor.d.ts.map +1 -0
  216. package/dist/dev/core/actors/create-transition-actor.js +44 -0
  217. package/dist/dev/core/actors/create-transition-actor.js.map +1 -0
  218. package/dist/dev/core/composition/create-composition.d.ts +241 -0
  219. package/dist/dev/core/composition/create-composition.d.ts.map +1 -0
  220. package/dist/dev/core/composition/create-composition.js +82 -0
  221. package/dist/dev/core/composition/create-composition.js.map +1 -0
  222. package/dist/dev/core/composition/share-signals.d.ts +39 -0
  223. package/dist/dev/core/composition/share-signals.d.ts.map +1 -0
  224. package/dist/dev/core/composition/share-signals.js +34 -0
  225. package/dist/dev/core/composition/share-signals.js.map +1 -0
  226. package/dist/dev/core/machine.d.ts +21 -0
  227. package/dist/dev/core/machine.d.ts.map +1 -0
  228. package/dist/dev/core/machine.js +25 -0
  229. package/dist/dev/core/machine.js.map +1 -0
  230. package/dist/dev/core/reactors/create-machine-reactor.d.ts +87 -0
  231. package/dist/dev/core/reactors/create-machine-reactor.d.ts.map +1 -0
  232. package/dist/dev/core/reactors/create-machine-reactor.js +84 -0
  233. package/dist/dev/core/reactors/create-machine-reactor.js.map +1 -0
  234. package/dist/dev/core/signals/effect.d.ts +14 -0
  235. package/dist/dev/core/signals/effect.d.ts.map +1 -0
  236. package/dist/dev/core/signals/effect.js +61 -0
  237. package/dist/dev/core/signals/effect.js.map +1 -0
  238. package/dist/dev/core/signals/primitives.d.ts +44 -0
  239. package/dist/dev/core/signals/primitives.d.ts.map +1 -0
  240. package/dist/dev/core/signals/primitives.js +50 -0
  241. package/dist/dev/core/signals/primitives.js.map +1 -0
  242. package/dist/dev/core/signals/when.js +36 -0
  243. package/dist/dev/core/signals/when.js.map +1 -0
  244. package/dist/dev/core/tasks/delayed-reschedule.js +27 -0
  245. package/dist/dev/core/tasks/delayed-reschedule.js.map +1 -0
  246. package/dist/dev/core/tasks/task.d.ts +144 -0
  247. package/dist/dev/core/tasks/task.d.ts.map +1 -0
  248. package/dist/dev/core/tasks/task.js +298 -0
  249. package/dist/dev/core/tasks/task.js.map +1 -0
  250. package/dist/dev/dom.d.ts +9 -0
  251. package/dist/dev/dom.js +9 -0
  252. package/dist/dev/hls-audio.d.ts +3 -0
  253. package/dist/dev/hls-audio.js +3 -0
  254. package/dist/dev/hls-background-video.d.ts +4 -0
  255. package/dist/dev/hls-background-video.js +3 -0
  256. package/dist/dev/hls-video.d.ts +5 -0
  257. package/dist/dev/hls-video.js +4 -0
  258. package/dist/dev/hls.d.ts +11 -0
  259. package/dist/dev/hls.js +10 -0
  260. package/dist/dev/index.d.ts +23 -0
  261. package/dist/dev/index.d.ts.map +1 -0
  262. package/dist/dev/index.js +22 -0
  263. package/dist/dev/index.js.map +1 -0
  264. package/dist/dev/media/abr/quality-selection.d.ts +19 -0
  265. package/dist/dev/media/abr/quality-selection.d.ts.map +1 -0
  266. package/dist/dev/media/abr/quality-selection.js +17 -0
  267. package/dist/dev/media/abr/quality-selection.js.map +1 -0
  268. package/dist/dev/media/buffer/back-buffer.d.ts +9 -0
  269. package/dist/dev/media/buffer/back-buffer.d.ts.map +1 -0
  270. package/dist/dev/media/buffer/back-buffer.js +42 -0
  271. package/dist/dev/media/buffer/back-buffer.js.map +1 -0
  272. package/dist/dev/media/buffer/forward-buffer.d.ts +9 -0
  273. package/dist/dev/media/buffer/forward-buffer.d.ts.map +1 -0
  274. package/dist/dev/media/buffer/forward-buffer.js +110 -0
  275. package/dist/dev/media/buffer/forward-buffer.js.map +1 -0
  276. package/dist/dev/media/dom/capabilities.js +61 -0
  277. package/dist/dev/media/dom/capabilities.js.map +1 -0
  278. package/dist/dev/media/dom/mse/append-segment.d.ts +16 -0
  279. package/dist/dev/media/dom/mse/append-segment.d.ts.map +1 -0
  280. package/dist/dev/media/dom/mse/append-segment.js +58 -0
  281. package/dist/dev/media/dom/mse/append-segment.js.map +1 -0
  282. package/dist/dev/media/dom/mse/buffer-flusher.d.ts +24 -0
  283. package/dist/dev/media/dom/mse/buffer-flusher.d.ts.map +1 -0
  284. package/dist/dev/media/dom/mse/buffer-flusher.js +55 -0
  285. package/dist/dev/media/dom/mse/buffer-flusher.js.map +1 -0
  286. package/dist/dev/media/dom/mse/duration.js +87 -0
  287. package/dist/dev/media/dom/mse/duration.js.map +1 -0
  288. package/dist/dev/media/dom/mse/end-of-stream.js +17 -0
  289. package/dist/dev/media/dom/mse/end-of-stream.js.map +1 -0
  290. package/dist/dev/media/dom/mse/mediasource-setup.js +227 -0
  291. package/dist/dev/media/dom/mse/mediasource-setup.js.map +1 -0
  292. package/dist/dev/media/dom/screen.d.ts +7 -0
  293. package/dist/dev/media/dom/screen.d.ts.map +1 -0
  294. package/dist/dev/media/dom/screen.js +95 -0
  295. package/dist/dev/media/dom/screen.js.map +1 -0
  296. package/dist/dev/media/dom/text/resolve-vtt-segment.d.ts +6 -0
  297. package/dist/dev/media/dom/text/resolve-vtt-segment.d.ts.map +1 -0
  298. package/dist/dev/media/dom/text/resolve-vtt-segment.js +50 -0
  299. package/dist/dev/media/dom/text/resolve-vtt-segment.js.map +1 -0
  300. package/dist/dev/media/dom/text/text-track-slots.d.ts +24 -0
  301. package/dist/dev/media/dom/text/text-track-slots.d.ts.map +1 -0
  302. package/dist/dev/media/dom/text/text-track-slots.js +61 -0
  303. package/dist/dev/media/dom/text/text-track-slots.js.map +1 -0
  304. package/dist/dev/media/errors.d.ts +68 -0
  305. package/dist/dev/media/errors.d.ts.map +1 -0
  306. package/dist/dev/media/errors.js +60 -0
  307. package/dist/dev/media/errors.js.map +1 -0
  308. package/dist/dev/media/hls/parse-attributes.js +131 -0
  309. package/dist/dev/media/hls/parse-attributes.js.map +1 -0
  310. package/dist/dev/media/hls/parse-media-playlist.js +253 -0
  311. package/dist/dev/media/hls/parse-media-playlist.js.map +1 -0
  312. package/dist/dev/media/hls/parse-multivariant.js +234 -0
  313. package/dist/dev/media/hls/parse-multivariant.js.map +1 -0
  314. package/dist/dev/media/hls/reload-policy.js +63 -0
  315. package/dist/dev/media/hls/reload-policy.js.map +1 -0
  316. package/dist/dev/media/hls/resolve-url.js +9 -0
  317. package/dist/dev/media/hls/resolve-url.js.map +1 -0
  318. package/dist/dev/media/live-window.js +32 -0
  319. package/dist/dev/media/live-window.js.map +1 -0
  320. package/dist/dev/media/media-tracks/media-tracks.d.ts +46 -0
  321. package/dist/dev/media/media-tracks/media-tracks.d.ts.map +1 -0
  322. package/dist/dev/media/media-tracks/media-tracks.js +96 -0
  323. package/dist/dev/media/media-tracks/media-tracks.js.map +1 -0
  324. package/dist/dev/media/mp4/box.js +57 -0
  325. package/dist/dev/media/mp4/box.js.map +1 -0
  326. package/dist/dev/media/mp4/timestamp-origin.js +95 -0
  327. package/dist/dev/media/mp4/timestamp-origin.js.map +1 -0
  328. package/dist/dev/media/primitives/resolution.d.ts +22 -0
  329. package/dist/dev/media/primitives/resolution.d.ts.map +1 -0
  330. package/dist/dev/media/primitives/resolution.js +26 -0
  331. package/dist/dev/media/primitives/resolution.js.map +1 -0
  332. package/dist/dev/media/primitives/select-tracks.js +97 -0
  333. package/dist/dev/media/primitives/select-tracks.js.map +1 -0
  334. package/dist/dev/media/text/parse-vtt-timestamp-map.js +40 -0
  335. package/dist/dev/media/text/parse-vtt-timestamp-map.js.map +1 -0
  336. package/dist/dev/media/text/resolve-vtt-metadata.js +22 -0
  337. package/dist/dev/media/text/resolve-vtt-metadata.js.map +1 -0
  338. package/dist/dev/media/types/index.d.ts +306 -0
  339. package/dist/dev/media/types/index.d.ts.map +1 -0
  340. package/dist/dev/media/types/index.js +42 -0
  341. package/dist/dev/media/types/index.js.map +1 -0
  342. package/dist/dev/media/utils/cdn.d.ts +11 -0
  343. package/dist/dev/media/utils/cdn.d.ts.map +1 -0
  344. package/dist/dev/media/utils/cdn.js +50 -0
  345. package/dist/dev/media/utils/cdn.js.map +1 -0
  346. package/dist/dev/media/utils/preload.js +21 -0
  347. package/dist/dev/media/utils/preload.js.map +1 -0
  348. package/dist/dev/media/utils/track-selection.js +43 -0
  349. package/dist/dev/media/utils/track-selection.js.map +1 -0
  350. package/dist/dev/media/utils/tracks.js +146 -0
  351. package/dist/dev/media/utils/tracks.js.map +1 -0
  352. package/dist/dev/media-tracks.d.ts +3 -0
  353. package/dist/dev/media-tracks.js +2 -0
  354. package/dist/dev/network/bandwidth-estimator.d.ts +48 -0
  355. package/dist/dev/network/bandwidth-estimator.d.ts.map +1 -0
  356. package/dist/dev/network/bandwidth-estimator.js +95 -0
  357. package/dist/dev/network/bandwidth-estimator.js.map +1 -0
  358. package/dist/dev/network/chunked-stream-iterable.js +47 -0
  359. package/dist/dev/network/chunked-stream-iterable.js.map +1 -0
  360. package/dist/dev/network/ewma.js +68 -0
  361. package/dist/dev/network/ewma.js.map +1 -0
  362. package/dist/dev/network/fetch.js +108 -0
  363. package/dist/dev/network/fetch.js.map +1 -0
  364. package/dist/dev/playback/actors/dom/segment-loader.d.ts +44 -0
  365. package/dist/dev/playback/actors/dom/segment-loader.d.ts.map +1 -0
  366. package/dist/dev/playback/actors/dom/segment-loader.js +233 -0
  367. package/dist/dev/playback/actors/dom/segment-loader.js.map +1 -0
  368. package/dist/dev/playback/actors/dom/source-buffer.d.ts +45 -0
  369. package/dist/dev/playback/actors/dom/source-buffer.d.ts.map +1 -0
  370. package/dist/dev/playback/actors/dom/source-buffer.js +139 -0
  371. package/dist/dev/playback/actors/dom/source-buffer.js.map +1 -0
  372. package/dist/dev/playback/actors/dom/text-tracks.d.ts +3 -0
  373. package/dist/dev/playback/actors/dom/text-tracks.js +46 -0
  374. package/dist/dev/playback/actors/dom/text-tracks.js.map +1 -0
  375. package/dist/dev/playback/actors/text-track-segment-loader.d.ts +48 -0
  376. package/dist/dev/playback/actors/text-track-segment-loader.d.ts.map +1 -0
  377. package/dist/dev/playback/actors/text-track-segment-loader.js +138 -0
  378. package/dist/dev/playback/actors/text-track-segment-loader.js.map +1 -0
  379. package/dist/dev/playback/actors/text-tracks.d.ts +30 -0
  380. package/dist/dev/playback/actors/text-tracks.d.ts.map +1 -0
  381. package/dist/dev/playback/adapters/hls-audio/adapter.d.ts +11 -0
  382. package/dist/dev/playback/adapters/hls-audio/adapter.d.ts.map +1 -0
  383. package/dist/dev/playback/adapters/hls-audio/adapter.js +8 -0
  384. package/dist/dev/playback/adapters/hls-audio/adapter.js.map +1 -0
  385. package/dist/dev/playback/adapters/hls-audio/mixin.d.ts +52 -0
  386. package/dist/dev/playback/adapters/hls-audio/mixin.d.ts.map +1 -0
  387. package/dist/dev/playback/adapters/hls-audio/mixin.js +178 -0
  388. package/dist/dev/playback/adapters/hls-audio/mixin.js.map +1 -0
  389. package/dist/dev/playback/adapters/hls-background-video/adapter.d.ts +19 -0
  390. package/dist/dev/playback/adapters/hls-background-video/adapter.d.ts.map +1 -0
  391. package/dist/dev/playback/adapters/hls-background-video/adapter.js +17 -0
  392. package/dist/dev/playback/adapters/hls-background-video/adapter.js.map +1 -0
  393. package/dist/dev/playback/adapters/hls-background-video/host.d.ts +34 -0
  394. package/dist/dev/playback/adapters/hls-background-video/host.d.ts.map +1 -0
  395. package/dist/dev/playback/adapters/hls-background-video/host.js +56 -0
  396. package/dist/dev/playback/adapters/hls-background-video/host.js.map +1 -0
  397. package/dist/dev/playback/adapters/hls-background-video/mixin.d.ts +69 -0
  398. package/dist/dev/playback/adapters/hls-background-video/mixin.d.ts.map +1 -0
  399. package/dist/dev/playback/adapters/hls-background-video/mixin.js +191 -0
  400. package/dist/dev/playback/adapters/hls-background-video/mixin.js.map +1 -0
  401. package/dist/dev/playback/adapters/hls-video/adapter.d.ts +11 -0
  402. package/dist/dev/playback/adapters/hls-video/adapter.d.ts.map +1 -0
  403. package/dist/dev/playback/adapters/hls-video/adapter.js +11 -0
  404. package/dist/dev/playback/adapters/hls-video/adapter.js.map +1 -0
  405. package/dist/dev/playback/adapters/hls-video/error-surface.d.ts +17 -0
  406. package/dist/dev/playback/adapters/hls-video/error-surface.d.ts.map +1 -0
  407. package/dist/dev/playback/adapters/hls-video/error-surface.js +46 -0
  408. package/dist/dev/playback/adapters/hls-video/error-surface.js.map +1 -0
  409. package/dist/dev/playback/adapters/hls-video/media-tracks.d.ts +21 -0
  410. package/dist/dev/playback/adapters/hls-video/media-tracks.d.ts.map +1 -0
  411. package/dist/dev/playback/adapters/hls-video/media-tracks.js +125 -0
  412. package/dist/dev/playback/adapters/hls-video/media-tracks.js.map +1 -0
  413. package/dist/dev/playback/adapters/hls-video/mixin.d.ts +62 -0
  414. package/dist/dev/playback/adapters/hls-video/mixin.d.ts.map +1 -0
  415. package/dist/dev/playback/adapters/hls-video/mixin.js +299 -0
  416. package/dist/dev/playback/adapters/hls-video/mixin.js.map +1 -0
  417. package/dist/dev/playback/behaviors/calculate-presentation-duration.d.ts +23 -0
  418. package/dist/dev/playback/behaviors/calculate-presentation-duration.d.ts.map +1 -0
  419. package/dist/dev/playback/behaviors/calculate-presentation-duration.js +33 -0
  420. package/dist/dev/playback/behaviors/calculate-presentation-duration.js.map +1 -0
  421. package/dist/dev/playback/behaviors/collect-errors.d.ts +2 -0
  422. package/dist/dev/playback/behaviors/collect-errors.js +98 -0
  423. package/dist/dev/playback/behaviors/collect-errors.js.map +1 -0
  424. package/dist/dev/playback/behaviors/derive-cdn-priority.js +61 -0
  425. package/dist/dev/playback/behaviors/derive-cdn-priority.js.map +1 -0
  426. package/dist/dev/playback/behaviors/dom/airplay.js +188 -0
  427. package/dist/dev/playback/behaviors/dom/airplay.js.map +1 -0
  428. package/dist/dev/playback/behaviors/dom/apply-start-position.js +81 -0
  429. package/dist/dev/playback/behaviors/dom/apply-start-position.js.map +1 -0
  430. package/dist/dev/playback/behaviors/dom/end-of-stream.js +97 -0
  431. package/dist/dev/playback/behaviors/dom/end-of-stream.js.map +1 -0
  432. package/dist/dev/playback/behaviors/dom/load-segments.d.ts +69 -0
  433. package/dist/dev/playback/behaviors/dom/load-segments.d.ts.map +1 -0
  434. package/dist/dev/playback/behaviors/dom/load-segments.js +169 -0
  435. package/dist/dev/playback/behaviors/dom/load-segments.js.map +1 -0
  436. package/dist/dev/playback/behaviors/dom/recover-end-stall.js +72 -0
  437. package/dist/dev/playback/behaviors/dom/recover-end-stall.js.map +1 -0
  438. package/dist/dev/playback/behaviors/dom/seek-to-live-edge.js +113 -0
  439. package/dist/dev/playback/behaviors/dom/seek-to-live-edge.js.map +1 -0
  440. package/dist/dev/playback/behaviors/dom/setup-buffer-actors.js +181 -0
  441. package/dist/dev/playback/behaviors/dom/setup-buffer-actors.js.map +1 -0
  442. package/dist/dev/playback/behaviors/dom/setup-mediasource.js +100 -0
  443. package/dist/dev/playback/behaviors/dom/setup-mediasource.js.map +1 -0
  444. package/dist/dev/playback/behaviors/dom/setup-text-track-actors.d.ts +28 -0
  445. package/dist/dev/playback/behaviors/dom/setup-text-track-actors.d.ts.map +1 -0
  446. package/dist/dev/playback/behaviors/dom/setup-text-track-actors.js +40 -0
  447. package/dist/dev/playback/behaviors/dom/setup-text-track-actors.js.map +1 -0
  448. package/dist/dev/playback/behaviors/dom/sync-live-seekable-range.js +25 -0
  449. package/dist/dev/playback/behaviors/dom/sync-live-seekable-range.js.map +1 -0
  450. package/dist/dev/playback/behaviors/dom/sync-text-tracks.js +109 -0
  451. package/dist/dev/playback/behaviors/dom/sync-text-tracks.js.map +1 -0
  452. package/dist/dev/playback/behaviors/dom/track-current-time.d.ts +33 -0
  453. package/dist/dev/playback/behaviors/dom/track-current-time.d.ts.map +1 -0
  454. package/dist/dev/playback/behaviors/dom/track-current-time.js +50 -0
  455. package/dist/dev/playback/behaviors/dom/track-current-time.js.map +1 -0
  456. package/dist/dev/playback/behaviors/dom/track-load-triggers.d.ts +41 -0
  457. package/dist/dev/playback/behaviors/dom/track-load-triggers.d.ts.map +1 -0
  458. package/dist/dev/playback/behaviors/dom/track-load-triggers.js +86 -0
  459. package/dist/dev/playback/behaviors/dom/track-load-triggers.js.map +1 -0
  460. package/dist/dev/playback/behaviors/dom/track-playback-rate.d.ts +33 -0
  461. package/dist/dev/playback/behaviors/dom/track-playback-rate.d.ts.map +1 -0
  462. package/dist/dev/playback/behaviors/dom/track-playback-rate.js +35 -0
  463. package/dist/dev/playback/behaviors/dom/track-playback-rate.js.map +1 -0
  464. package/dist/dev/playback/behaviors/dom/track-player-resolution.d.ts +8 -0
  465. package/dist/dev/playback/behaviors/dom/track-player-resolution.d.ts.map +1 -0
  466. package/dist/dev/playback/behaviors/dom/track-player-resolution.js +53 -0
  467. package/dist/dev/playback/behaviors/dom/track-player-resolution.js.map +1 -0
  468. package/dist/dev/playback/behaviors/dom/track-screen-resolution.js +28 -0
  469. package/dist/dev/playback/behaviors/dom/track-screen-resolution.js.map +1 -0
  470. package/dist/dev/playback/behaviors/dom/update-mediasource-duration.js +98 -0
  471. package/dist/dev/playback/behaviors/dom/update-mediasource-duration.js.map +1 -0
  472. package/dist/dev/playback/behaviors/establish-start-media-time.d.ts +32 -0
  473. package/dist/dev/playback/behaviors/establish-start-media-time.d.ts.map +1 -0
  474. package/dist/dev/playback/behaviors/establish-start-media-time.js +187 -0
  475. package/dist/dev/playback/behaviors/establish-start-media-time.js.map +1 -0
  476. package/dist/dev/playback/behaviors/resolve-presentation.d.ts +8 -0
  477. package/dist/dev/playback/behaviors/resolve-presentation.d.ts.map +1 -0
  478. package/dist/dev/playback/behaviors/resolve-presentation.js +76 -0
  479. package/dist/dev/playback/behaviors/resolve-presentation.js.map +1 -0
  480. package/dist/dev/playback/behaviors/resolve-track.js +134 -0
  481. package/dist/dev/playback/behaviors/resolve-track.js.map +1 -0
  482. package/dist/dev/playback/behaviors/select-tracks.d.ts +61 -0
  483. package/dist/dev/playback/behaviors/select-tracks.d.ts.map +1 -0
  484. package/dist/dev/playback/behaviors/select-tracks.js +189 -0
  485. package/dist/dev/playback/behaviors/select-tracks.js.map +1 -0
  486. package/dist/dev/playback/behaviors/setup-failover-monitor.d.ts +11 -0
  487. package/dist/dev/playback/behaviors/setup-failover-monitor.d.ts.map +1 -0
  488. package/dist/dev/playback/behaviors/setup-failover-monitor.js +61 -0
  489. package/dist/dev/playback/behaviors/setup-failover-monitor.js.map +1 -0
  490. package/dist/dev/playback/behaviors/sync-preload.js +59 -0
  491. package/dist/dev/playback/behaviors/sync-preload.js.map +1 -0
  492. package/dist/dev/playback/behaviors/track-switching.d.ts +110 -0
  493. package/dist/dev/playback/behaviors/track-switching.d.ts.map +1 -0
  494. package/dist/dev/playback/behaviors/track-switching.js +407 -0
  495. package/dist/dev/playback/behaviors/track-switching.js.map +1 -0
  496. package/dist/dev/playback/engines/hls/engine-audio-only.d.ts +160 -0
  497. package/dist/dev/playback/engines/hls/engine-audio-only.d.ts.map +1 -0
  498. package/dist/dev/playback/engines/hls/engine-audio-only.js +94 -0
  499. package/dist/dev/playback/engines/hls/engine-audio-only.js.map +1 -0
  500. package/dist/dev/playback/engines/hls/engine-background-video.d.ts +131 -0
  501. package/dist/dev/playback/engines/hls/engine-background-video.d.ts.map +1 -0
  502. package/dist/dev/playback/engines/hls/engine-background-video.js +87 -0
  503. package/dist/dev/playback/engines/hls/engine-background-video.js.map +1 -0
  504. package/dist/dev/playback/engines/hls/engine.d.ts +289 -0
  505. package/dist/dev/playback/engines/hls/engine.d.ts.map +1 -0
  506. package/dist/dev/playback/engines/hls/engine.js +144 -0
  507. package/dist/dev/playback/engines/hls/engine.js.map +1 -0
  508. package/dist/dev/playback/primitives/derive-start-media-time.d.ts +16 -0
  509. package/dist/dev/playback/primitives/derive-start-media-time.d.ts.map +1 -0
  510. package/dist/dev/playback/primitives/error-messages.js +42 -0
  511. package/dist/dev/playback/primitives/error-messages.js.map +1 -0
  512. package/dist/dev/playback/primitives/failover-fetch.js +37 -0
  513. package/dist/dev/playback/primitives/failover-fetch.js.map +1 -0
  514. package/dist/dev/playback/primitives/head-peek.js +41 -0
  515. package/dist/dev/playback/primitives/head-peek.js.map +1 -0
  516. package/dist/dev/playback/primitives/live-window.js +63 -0
  517. package/dist/dev/playback/primitives/live-window.js.map +1 -0
  518. package/dist/dev/playback/primitives/relocation-pipelines.js +191 -0
  519. package/dist/dev/playback/primitives/relocation-pipelines.js.map +1 -0
  520. package/dist/dev/playback/primitives/report-track-conditions.d.ts +8 -0
  521. package/dist/dev/playback/primitives/report-track-conditions.d.ts.map +1 -0
  522. package/dist/dev/playback/primitives/report-track-conditions.js +74 -0
  523. package/dist/dev/playback/primitives/report-track-conditions.js.map +1 -0
  524. package/dist/dev/playback/primitives/segment-load-pipeline.d.ts +2 -0
  525. package/dist/dev/playback/primitives/segment-load-pipeline.js +96 -0
  526. package/dist/dev/playback/primitives/segment-load-pipeline.js.map +1 -0
  527. package/dist/dev/playback/primitives/selection-rules.d.ts +66 -0
  528. package/dist/dev/playback/primitives/selection-rules.d.ts.map +1 -0
  529. package/dist/dev/playback/primitives/selection-rules.js +115 -0
  530. package/dist/dev/playback/primitives/selection-rules.js.map +1 -0
  531. package/dist/dev/playback/primitives/source-buffer-messages.d.ts +40 -0
  532. package/dist/dev/playback/primitives/source-buffer-messages.d.ts.map +1 -0
  533. package/dist/dev/playback/primitives/text-segment-load-pipeline.d.ts +56 -0
  534. package/dist/dev/playback/primitives/text-segment-load-pipeline.d.ts.map +1 -0
  535. package/dist/dev/playback/primitives/text-segment-load-pipeline.js +36 -0
  536. package/dist/dev/playback/primitives/text-segment-load-pipeline.js.map +1 -0
  537. package/dist/dev/playback/primitives/text-track-messages.d.ts +14 -0
  538. package/dist/dev/playback/primitives/text-track-messages.d.ts.map +1 -0
  539. package/dist/dev/playback/primitives/track-types.js +53 -0
  540. package/dist/dev/playback/primitives/track-types.js.map +1 -0
  541. package/package.json +60 -41
  542. package/dist/adapter-CE86m9Eh.d.ts +0 -717
  543. package/dist/adapter-CE86m9Eh.d.ts.map +0 -1
  544. package/dist/adapter-ClnRGbQf.js +0 -3539
  545. package/dist/adapter-ClnRGbQf.js.map +0 -1
  546. package/dist/dom/index.d.ts +0 -221
  547. package/dist/dom/index.d.ts.map +0 -1
  548. package/dist/dom/index.js +0 -38
  549. package/dist/dom/index.js.map +0 -1
  550. package/dist/dom/playback-engine/index.d.ts +0 -2
  551. package/dist/dom/playback-engine/index.js +0 -4
  552. package/dist/index.d.ts +0 -13
  553. package/dist/index.d.ts.map +0 -1
  554. package/dist/index.js +0 -3
  555. package/dist/src-DRsS_H80.js +0 -14
  556. package/dist/src-DRsS_H80.js.map +0 -1
@@ -1,3539 +0,0 @@
1
- import { listen } from "@videojs/utils/dom";
2
- import { isNil } from "@videojs/utils/predicate";
3
-
4
- //#region src/core/state/create-state.ts
5
- /**
6
- * Reactive state container with selectors, custom equality, and batched updates.
7
- *
8
- * Manages both immutable state values and mutable object references (e.g., HTMLMediaElement).
9
- */
10
- const STATE_SYMBOL = Symbol("@videojs/spf/state");
11
- /**
12
- * Default equality function using Object.is.
13
- */
14
- function defaultEquality(a, b) {
15
- return Object.is(a, b);
16
- }
17
- /**
18
- * State container implementation.
19
- */
20
- var StateContainer = class {
21
- [STATE_SYMBOL] = true;
22
- #current;
23
- #pending = null;
24
- #pendingFlush = false;
25
- #equalityFn;
26
- #listeners = /* @__PURE__ */ new Set();
27
- #selectorListeners = /* @__PURE__ */ new Set();
28
- constructor(initial, config) {
29
- this.#current = typeof initial === "object" && initial !== null ? { ...initial } : initial;
30
- this.#equalityFn = config?.equalityFn ?? defaultEquality;
31
- }
32
- get current() {
33
- return this.#pending ?? this.#current;
34
- }
35
- patch(partial) {
36
- const base = this.#pending ?? this.#current;
37
- if (typeof base !== "object" || base === null) {
38
- const value = partial;
39
- if (!Object.is(base, value)) {
40
- this.#pending = value;
41
- this.#scheduleFlush();
42
- }
43
- return;
44
- }
45
- const next = { ...base };
46
- let changed = false;
47
- for (const key in partial) {
48
- if (!Object.hasOwn(partial, key)) continue;
49
- const value = partial[key];
50
- if (!Object.is(base[key], value)) {
51
- next[key] = value;
52
- changed = true;
53
- }
54
- }
55
- if (changed) {
56
- this.#pending = next;
57
- this.#scheduleFlush();
58
- }
59
- }
60
- subscribe(selectorOrListener, maybeListener, options) {
61
- if (maybeListener === void 0) {
62
- const listener$1 = selectorOrListener;
63
- this.#listeners.add(listener$1);
64
- listener$1(this.current);
65
- return () => {
66
- this.#listeners.delete(listener$1);
67
- };
68
- }
69
- const selector = selectorOrListener;
70
- const listener = maybeListener;
71
- const entry = {
72
- selector,
73
- listener,
74
- options: options ?? {}
75
- };
76
- this.#selectorListeners.add(entry);
77
- listener(selector(this.current));
78
- return () => {
79
- this.#selectorListeners.delete(entry);
80
- };
81
- }
82
- flush() {
83
- if (this.#pending === null) return;
84
- const prev = this.#current;
85
- const next = this.#pending;
86
- this.#pending = null;
87
- this.#pendingFlush = false;
88
- if (this.#equalityFn(prev, next)) return;
89
- this.#current = next;
90
- for (const listener of this.#listeners) listener(this.#current);
91
- for (const entry of this.#selectorListeners) {
92
- const prevSelected = entry.selector(prev);
93
- const nextSelected = entry.selector(this.#current);
94
- if (!(entry.options.equalityFn ?? Object.is)(prevSelected, nextSelected)) entry.listener(nextSelected);
95
- }
96
- }
97
- #scheduleFlush() {
98
- if (this.#pendingFlush) return;
99
- this.#pendingFlush = true;
100
- queueMicrotask(() => this.flush());
101
- }
102
- };
103
- /**
104
- * Create a reactive state container.
105
- *
106
- * @example
107
- * ```typescript
108
- * const state = createState({ count: 0 });
109
- *
110
- * // Subscribe to changes
111
- * state.subscribe((current, prev) => {
112
- * console.log('Changed:', prev, '->', current);
113
- * });
114
- *
115
- * // Updates are batched
116
- * state.patch({ count: 1 });
117
- * state.patch({ count: 2 });
118
- * // Only one notification fires (with count: 2)
119
- * ```
120
- *
121
- * @example Selector subscriptions
122
- * ```typescript
123
- * const state = createState({ count: 0, name: 'test' });
124
- *
125
- * // Only notified when count changes
126
- * state.subscribe(
127
- * s => s.count,
128
- * (current, prev) => console.log(current, prev)
129
- * );
130
- * ```
131
- *
132
- * @example Custom equality
133
- * ```typescript
134
- * const state = createState(
135
- * { count: 0, name: 'test' },
136
- * { equalityFn: (a, b) => a.count === b.count }
137
- * );
138
- * ```
139
- */
140
- function createState(initial, config) {
141
- return new StateContainer(initial, config);
142
- }
143
-
144
- //#endregion
145
- //#region src/core/hls/parse-attributes.ts
146
- /**
147
- * Parse HLS attribute list from a tag line.
148
- * Handles both quoted and unquoted values.
149
- */
150
- function parseAttributeList(line) {
151
- const attributes = /* @__PURE__ */ new Map();
152
- for (const match of line.matchAll(/([A-Z0-9-]+)=(?:"([^"]*)"|([^,]*))/g)) {
153
- const key = match[1];
154
- const value = match[2] ?? match[3] ?? "";
155
- if (key) attributes.set(key, value);
156
- }
157
- return attributes;
158
- }
159
- /**
160
- * Parse RESOLUTION attribute value (WIDTHxHEIGHT).
161
- */
162
- function parseResolution(value) {
163
- const match = /^(\d+)x(\d+)$/.exec(value);
164
- if (!match) return null;
165
- return {
166
- width: Number.parseInt(match[1], 10),
167
- height: Number.parseInt(match[2], 10)
168
- };
169
- }
170
- /**
171
- * Parse FRAME-RATE attribute to rational frame rate.
172
- */
173
- function parseFrameRate(value) {
174
- const fps = Number.parseFloat(value);
175
- if (Number.isNaN(fps) || fps <= 0) return void 0;
176
- if (Math.abs(fps - 23.976) < .01) return {
177
- frameRateNumerator: 24e3,
178
- frameRateDenominator: 1001
179
- };
180
- if (Math.abs(fps - 29.97) < .01) return {
181
- frameRateNumerator: 3e4,
182
- frameRateDenominator: 1001
183
- };
184
- if (Math.abs(fps - 59.94) < .01) return {
185
- frameRateNumerator: 6e4,
186
- frameRateDenominator: 1001
187
- };
188
- if (fps % 1 === 0) return { frameRateNumerator: Math.round(fps) };
189
- return { frameRateNumerator: Math.round(fps) };
190
- }
191
- /**
192
- * Parse CODECS attribute into separate video and audio codecs.
193
- */
194
- function parseCodecs(codecs) {
195
- const parts = codecs.split(",").map((s) => s.trim());
196
- const result = {};
197
- for (const codec of parts) if (codec.startsWith("avc1.") || codec.startsWith("hvc1.") || codec.startsWith("hev1.")) result.video = codec;
198
- else if (codec.startsWith("mp4a.")) result.audio = codec;
199
- return result;
200
- }
201
- /**
202
- * Parse #EXTINF duration value.
203
- */
204
- function parseExtInfDuration(value) {
205
- const durationPart = value.split(",")[0] ?? value;
206
- const duration = Number.parseFloat(durationPart);
207
- return Number.isNaN(duration) ? 0 : duration;
208
- }
209
- /**
210
- * Parse BYTERANGE attribute value.
211
- * Format: "length[@offset]"
212
- * If offset is omitted, it continues from the previous byte range end.
213
- */
214
- function parseByteRange(value, previousEnd) {
215
- const match = /^(\d+)(?:@(\d+))?$/.exec(value);
216
- if (!match) return null;
217
- const length = Number.parseInt(match[1], 10);
218
- if (Number.isNaN(length)) return null;
219
- let start;
220
- if (match[2] !== void 0) {
221
- start = Number.parseInt(match[2], 10);
222
- if (Number.isNaN(start)) return null;
223
- } else if (previousEnd !== void 0) start = previousEnd;
224
- else return null;
225
- return {
226
- start,
227
- end: start + length - 1
228
- };
229
- }
230
- /**
231
- * Create AttributeList from raw attribute string.
232
- */
233
- function createAttributeList(line) {
234
- const map = parseAttributeList(line);
235
- return {
236
- get(key) {
237
- return map.get(key);
238
- },
239
- getInt(key, defaultValue) {
240
- const value = map.get(key);
241
- if (value === void 0) return defaultValue;
242
- const parsed = Number.parseInt(value, 10);
243
- return Number.isNaN(parsed) ? defaultValue : parsed;
244
- },
245
- getFloat(key, defaultValue) {
246
- const value = map.get(key);
247
- if (value === void 0) return defaultValue;
248
- const parsed = Number.parseFloat(value);
249
- return Number.isNaN(parsed) ? defaultValue : parsed;
250
- },
251
- getBool(key) {
252
- return map.get(key) === "YES";
253
- },
254
- getResolution(key) {
255
- const value = map.get(key);
256
- if (!value) return void 0;
257
- return parseResolution(value) ?? void 0;
258
- },
259
- getFrameRate(key) {
260
- const value = map.get(key);
261
- if (!value) return void 0;
262
- return parseFrameRate(value);
263
- }
264
- };
265
- }
266
- /**
267
- * Match a tag and extract its attributes.
268
- * Returns null if the line doesn't match the tag.
269
- */
270
- function matchTag(line, tag) {
271
- const prefix = `#${tag}:`;
272
- if (!line.startsWith(prefix)) return null;
273
- return createAttributeList(line.slice(prefix.length));
274
- }
275
-
276
- //#endregion
277
- //#region src/core/hls/resolve-url.ts
278
- /**
279
- * Resolve a potentially relative URL against a base URL using native URL API.
280
- */
281
- function resolveUrl(url, baseUrl) {
282
- return new URL(url, baseUrl).href;
283
- }
284
-
285
- //#endregion
286
- //#region src/core/hls/parse-media-playlist.ts
287
- /**
288
- * Parse HLS media playlist and resolve track with segments.
289
- *
290
- * Takes an unresolved track (from multivariant playlist) and media playlist text,
291
- * returns a HAM-compliant resolved track with segments.
292
- *
293
- * @param text - Media playlist text content
294
- * @param unresolved - Unresolved track from parseMultivariantPlaylist
295
- * @returns Resolved track with segments (type inferred from input)
296
- */
297
- function parseMediaPlaylist(text, unresolved) {
298
- const lines = text.split(/\r?\n/);
299
- const baseUrl = unresolved.url;
300
- const segments = [];
301
- let initSegmentUrl;
302
- let initSegmentByteRange;
303
- let currentDuration = 0;
304
- let currentByteRange;
305
- let currentTime = 0;
306
- let segmentIndex = 0;
307
- let previousByteRangeEnd;
308
- for (const line of lines) {
309
- const trimmed = line.trim();
310
- if (!trimmed || trimmed.startsWith("#") && !trimmed.startsWith("#EXT")) continue;
311
- if (trimmed === "#EXTM3U" || trimmed.startsWith("#EXT-X-VERSION:") || trimmed.startsWith("#EXT-X-TARGETDURATION:") || trimmed.startsWith("#EXT-X-PLAYLIST-TYPE:") || trimmed.startsWith("#EXT-X-INDEPENDENT-SEGMENTS")) continue;
312
- const mapAttrs = matchTag(trimmed, "EXT-X-MAP");
313
- if (mapAttrs) {
314
- const uri = mapAttrs.get("URI");
315
- if (uri) {
316
- initSegmentUrl = resolveUrl(uri, baseUrl);
317
- const byteRangeStr = mapAttrs.get("BYTERANGE");
318
- if (byteRangeStr) initSegmentByteRange = parseByteRange(byteRangeStr, 0) ?? void 0;
319
- }
320
- continue;
321
- }
322
- if (trimmed.startsWith("#EXTINF:")) {
323
- currentDuration = parseExtInfDuration(trimmed.slice(8));
324
- continue;
325
- }
326
- if (trimmed.startsWith("#EXT-X-BYTERANGE:")) {
327
- currentByteRange = parseByteRange(trimmed.slice(17), previousByteRangeEnd) ?? void 0;
328
- continue;
329
- }
330
- if (trimmed === "#EXT-X-ENDLIST") continue;
331
- if (!trimmed.startsWith("#") && currentDuration > 0) {
332
- const segment = {
333
- id: `segment-${segmentIndex}`,
334
- url: resolveUrl(trimmed, baseUrl),
335
- duration: currentDuration,
336
- startTime: currentTime
337
- };
338
- if (currentByteRange) {
339
- segment.byteRange = currentByteRange;
340
- previousByteRangeEnd = currentByteRange.end + 1;
341
- } else previousByteRangeEnd = void 0;
342
- segments.push(segment);
343
- currentTime += currentDuration;
344
- segmentIndex++;
345
- currentDuration = 0;
346
- currentByteRange = void 0;
347
- }
348
- }
349
- const totalDuration = currentTime;
350
- const initialization = unresolved.type === "text" && !initSegmentUrl ? void 0 : initSegmentUrl ? {
351
- url: initSegmentUrl,
352
- ...initSegmentByteRange ? { byteRange: initSegmentByteRange } : {}
353
- } : { url: "" };
354
- return {
355
- ...unresolved,
356
- startTime: 0,
357
- duration: totalDuration,
358
- segments,
359
- initialization
360
- };
361
- }
362
-
363
- //#endregion
364
- //#region src/core/utils/generate-id.ts
365
- /**
366
- * Generate unique ID for HAM objects.
367
- *
368
- * Uses timestamp + random number for sufficient uniqueness.
369
- * IDs are strings without decimals.
370
- *
371
- * @returns Unique string ID in format: timestamp-random
372
- *
373
- * @example
374
- * ```ts
375
- * const id = generateId(); // "1738423156789-542891"
376
- * ```
377
- */
378
- function generateId() {
379
- return `${Date.now()}-${Math.floor(Math.random() * 1e6)}`;
380
- }
381
-
382
- //#endregion
383
- //#region src/core/hls/parse-multivariant.ts
384
- /**
385
- * Parse HLS multivariant playlist into a Presentation.
386
- *
387
- * Returns Presentation with partially resolved tracks (no segment information).
388
- * Tracks contain metadata from multivariant playlist (bandwidth, resolution, codecs)
389
- * but segment information is added when media playlists are fetched.
390
- *
391
- * @param text - Raw playlist text content
392
- * @param unresolved - Unresolved presentation (contains URL for base URL resolution)
393
- * @returns Presentation with partially resolved tracks (duration is undefined)
394
- */
395
- function parseMultivariantPlaylist(text, unresolved) {
396
- const baseUrl = unresolved.url;
397
- const lines = text.split(/\r?\n/);
398
- const streams = [];
399
- const audioRenditions = [];
400
- const subtitleRenditions = [];
401
- let pendingStreamInfo = null;
402
- for (const line of lines) {
403
- const trimmed = line.trim();
404
- if (!trimmed || trimmed.startsWith("#") && !trimmed.startsWith("#EXT")) continue;
405
- if (trimmed === "#EXTM3U" || trimmed.startsWith("#EXT-X-VERSION:") || trimmed.startsWith("#EXT-X-INDEPENDENT-SEGMENTS")) continue;
406
- const mediaAttrs = matchTag(trimmed, "EXT-X-MEDIA");
407
- if (mediaAttrs) {
408
- const type = mediaAttrs.get("TYPE");
409
- const groupId = mediaAttrs.get("GROUP-ID");
410
- const name = mediaAttrs.get("NAME");
411
- if (type === "AUDIO" && groupId && name) {
412
- const uri = mediaAttrs.get("URI");
413
- audioRenditions.push({
414
- groupId,
415
- name,
416
- language: mediaAttrs.get("LANGUAGE"),
417
- uri: uri ? resolveUrl(uri, baseUrl) : void 0,
418
- default: mediaAttrs.getBool("DEFAULT"),
419
- autoselect: mediaAttrs.getBool("AUTOSELECT")
420
- });
421
- }
422
- if (type === "SUBTITLES" && groupId && name) {
423
- const uri = mediaAttrs.get("URI");
424
- if (uri) subtitleRenditions.push({
425
- groupId,
426
- name,
427
- language: mediaAttrs.get("LANGUAGE"),
428
- uri: resolveUrl(uri, baseUrl),
429
- default: mediaAttrs.getBool("DEFAULT"),
430
- autoselect: mediaAttrs.getBool("AUTOSELECT"),
431
- forced: mediaAttrs.getBool("FORCED")
432
- });
433
- }
434
- continue;
435
- }
436
- const streamInfAttrs = matchTag(trimmed, "EXT-X-STREAM-INF");
437
- if (streamInfAttrs) {
438
- pendingStreamInfo = {
439
- bandwidth: streamInfAttrs.getInt("BANDWIDTH", 0),
440
- resolution: streamInfAttrs.getResolution("RESOLUTION"),
441
- codecs: streamInfAttrs.get("CODECS"),
442
- frameRate: streamInfAttrs.getFrameRate("FRAME-RATE"),
443
- audioGroupId: streamInfAttrs.get("AUDIO")
444
- };
445
- continue;
446
- }
447
- if (!trimmed.startsWith("#") && pendingStreamInfo) {
448
- streams.push({
449
- ...pendingStreamInfo,
450
- uri: resolveUrl(trimmed, baseUrl)
451
- });
452
- pendingStreamInfo = null;
453
- }
454
- }
455
- const videoStreams = [];
456
- const audioOnlyStreams = [];
457
- for (const stream of streams) {
458
- if (!stream.codecs) {
459
- videoStreams.push(stream);
460
- continue;
461
- }
462
- const parsedCodecs = parseCodecs(stream.codecs);
463
- if (stream.codecs.split(",").length === 1) if (parsedCodecs.audio && !parsedCodecs.video) audioOnlyStreams.push(stream);
464
- else videoStreams.push(stream);
465
- else videoStreams.push(stream);
466
- }
467
- const videoTracks = videoStreams.map((stream) => {
468
- const codecs = stream.codecs ? parseCodecs(stream.codecs) : void 0;
469
- const track = {
470
- type: "video",
471
- id: generateId(),
472
- url: stream.uri,
473
- bandwidth: stream.bandwidth,
474
- mimeType: "video/mp4",
475
- codecs: []
476
- };
477
- if (stream.resolution?.width !== void 0) track.width = stream.resolution.width;
478
- if (stream.resolution?.height !== void 0) track.height = stream.resolution.height;
479
- if (codecs?.video) track.codecs = [codecs.video];
480
- if (stream.frameRate) track.frameRate = stream.frameRate;
481
- if (stream.audioGroupId) track.audioGroupId = stream.audioGroupId;
482
- return track;
483
- });
484
- const audioOnlyTracks = audioOnlyStreams.map((stream) => {
485
- const codecs = stream.codecs ? parseCodecs(stream.codecs) : void 0;
486
- return {
487
- type: "audio",
488
- id: generateId(),
489
- url: stream.uri,
490
- bandwidth: stream.bandwidth,
491
- mimeType: "audio/mp4",
492
- codecs: codecs?.audio ? [codecs.audio] : [],
493
- groupId: stream.audioGroupId || "default",
494
- name: "Default",
495
- sampleRate: 48e3,
496
- channels: 2
497
- };
498
- });
499
- const audioTracks = [...audioRenditions.map((rendition) => {
500
- let audioCodecs;
501
- for (const stream of streams) if (stream.audioGroupId === rendition.groupId && stream.codecs) {
502
- const codecs = parseCodecs(stream.codecs);
503
- if (codecs.audio) {
504
- audioCodecs = [codecs.audio];
505
- break;
506
- }
507
- }
508
- const track = {
509
- type: "audio",
510
- id: generateId(),
511
- url: rendition.uri ?? "",
512
- groupId: rendition.groupId,
513
- name: rendition.name,
514
- mimeType: "audio/mp4",
515
- bandwidth: 0,
516
- sampleRate: 48e3,
517
- channels: 2,
518
- codecs: []
519
- };
520
- if (rendition.language) track.language = rendition.language;
521
- if (audioCodecs) track.codecs = audioCodecs;
522
- if (rendition.default) track.default = rendition.default;
523
- if (rendition.autoselect) track.autoselect = rendition.autoselect;
524
- return track;
525
- }), ...audioOnlyTracks];
526
- const textTracks = subtitleRenditions.map((rendition) => {
527
- const track = {
528
- type: "text",
529
- id: generateId(),
530
- url: rendition.uri,
531
- groupId: rendition.groupId,
532
- label: rendition.name,
533
- kind: "subtitles",
534
- mimeType: "text/vtt",
535
- bandwidth: 0
536
- };
537
- if (rendition.language) track.language = rendition.language;
538
- if (rendition.default && rendition.autoselect) track.default = true;
539
- if (rendition.autoselect) track.autoselect = rendition.autoselect;
540
- if (rendition.forced) track.forced = rendition.forced;
541
- return track;
542
- });
543
- const selectionSets = [];
544
- if (videoTracks.length > 0) {
545
- const videoSwitchingSet = {
546
- id: generateId(),
547
- type: "video",
548
- tracks: videoTracks
549
- };
550
- const videoSelectionSet = {
551
- id: generateId(),
552
- type: "video",
553
- switchingSets: [videoSwitchingSet]
554
- };
555
- selectionSets.push(videoSelectionSet);
556
- }
557
- if (audioTracks.length > 0) {
558
- const audioSwitchingSet = {
559
- id: generateId(),
560
- type: "audio",
561
- tracks: audioTracks
562
- };
563
- const audioSelectionSet = {
564
- id: generateId(),
565
- type: "audio",
566
- switchingSets: [audioSwitchingSet]
567
- };
568
- selectionSets.push(audioSelectionSet);
569
- }
570
- if (textTracks.length > 0) {
571
- const textSwitchingSet = {
572
- id: generateId(),
573
- type: "text",
574
- tracks: textTracks
575
- };
576
- const textSelectionSet = {
577
- id: generateId(),
578
- type: "text",
579
- switchingSets: [textSwitchingSet]
580
- };
581
- selectionSets.push(textSelectionSet);
582
- }
583
- return {
584
- id: generateId(),
585
- url: unresolved.url,
586
- startTime: 0,
587
- selectionSets
588
- };
589
- }
590
-
591
- //#endregion
592
- //#region src/core/abr/ewma.ts
593
- /**
594
- * Exponentially Weighted Moving Average (EWMA)
595
- *
596
- * Pure functional implementation of EWMA calculations.
597
- * Based on Shaka Player's EWMA algorithm.
598
- */
599
- /**
600
- * Calculate alpha (decay factor) from half-life.
601
- *
602
- * Alpha determines how quickly old data "expires":
603
- * - alpha close to 1 = slow decay (long memory)
604
- * - alpha close to 0 = fast decay (short memory)
605
- *
606
- * @param halfLife - The quantity of prior samples (by weight) that make up
607
- * half of the new estimate. Must be positive.
608
- * @returns Alpha value between 0 and 1
609
- *
610
- * @example
611
- * const alpha = calculateAlpha(2); // ≈ 0.7071 for 2-second half-life
612
- */
613
- function calculateAlpha(halfLife) {
614
- return Math.exp(Math.log(.5) / halfLife);
615
- }
616
- /**
617
- * Calculate exponentially weighted moving average.
618
- *
619
- * Updates an estimate by blending a new value with the previous estimate,
620
- * weighted by the sample duration. Longer samples have more influence.
621
- *
622
- * @param prevEstimate - Previous EWMA estimate
623
- * @param value - New sample value to incorporate
624
- * @param weight - Sample weight (typically duration in seconds)
625
- * @param halfLife - Half-life for decay (typically 2-5 seconds)
626
- * @returns Updated EWMA estimate
627
- *
628
- * @example
629
- * let estimate = 0;
630
- * estimate = calculateEwma(estimate, 1_000_000, 1, 2); // First sample
631
- * estimate = calculateEwma(estimate, 2_000_000, 1, 2); // Second sample
632
- */
633
- function calculateEwma(prevEstimate, value, weight, halfLife) {
634
- const adjAlpha = calculateAlpha(halfLife) ** weight;
635
- return value * (1 - adjAlpha) + adjAlpha * prevEstimate;
636
- }
637
- /**
638
- * Apply zero-factor correction to EWMA estimate.
639
- *
640
- * The zero-factor correction compensates for bias when starting from zero.
641
- * Without this correction, early estimates would be artificially low.
642
- *
643
- * As totalWeight increases, the correction factor approaches 1, meaning
644
- * the estimate becomes more reliable and needs less correction.
645
- *
646
- * @param estimate - Raw EWMA estimate (uncorrected)
647
- * @param totalWeight - Accumulated weight from all samples
648
- * @param halfLife - Half-life used in EWMA calculation
649
- * @returns Corrected estimate, or 0 if totalWeight is 0
650
- *
651
- * @example
652
- * const raw = calculateEwma(0, 1_000_000, 1, 2);
653
- * const corrected = applyZeroFactor(raw, 1, 2); // ≈ 1_000_000
654
- */
655
- function applyZeroFactor(estimate, totalWeight, halfLife) {
656
- if (totalWeight === 0) return 0;
657
- return estimate / (1 - calculateAlpha(halfLife) ** totalWeight);
658
- }
659
-
660
- //#endregion
661
- //#region src/core/abr/bandwidth-estimator.ts
662
- /**
663
- * Default bandwidth estimator configuration.
664
- *
665
- * Values match Shaka Player defaults based on experimentation.
666
- */
667
- const DEFAULT_BANDWIDTH_CONFIG = {
668
- fastHalfLife: 2,
669
- slowHalfLife: 5,
670
- minTotalBytes: 128e3,
671
- minBytes: 16e3,
672
- minDuration: 5
673
- };
674
- /**
675
- * Add a bandwidth sample from a segment download.
676
- *
677
- * Samples are filtered based on:
678
- * - Minimum bytes (filters TTFB-dominated small segments)
679
- * - Minimum duration (filters cached responses)
680
- *
681
- * Valid samples update both fast and slow EWMA estimates.
682
- *
683
- * @param state - Current estimator state
684
- * @param durationMs - Download duration in milliseconds
685
- * @param numBytes - Number of bytes downloaded
686
- * @param config - Optional estimator configuration (uses defaults if not provided)
687
- * @returns New estimator state with sample incorporated (or unchanged if filtered)
688
- *
689
- * @example
690
- * let state = { fastEstimate: 0, fastTotalWeight: 0, ... };
691
- * // Sample: 1MB in 1 second
692
- * state = sampleBandwidth(state, 1000, 1_000_000);
693
- */
694
- function sampleBandwidth(state, durationMs, numBytes, config = DEFAULT_BANDWIDTH_CONFIG) {
695
- const updatedBytesSampled = state.bytesSampled + numBytes;
696
- if (numBytes < config.minBytes) return {
697
- ...state,
698
- bytesSampled: updatedBytesSampled
699
- };
700
- if (durationMs < config.minDuration) return {
701
- ...state,
702
- bytesSampled: updatedBytesSampled
703
- };
704
- const bandwidth = 8e3 * numBytes / durationMs;
705
- const weight = durationMs / 1e3;
706
- return {
707
- fastEstimate: calculateEwma(state.fastEstimate, bandwidth, weight, config.fastHalfLife),
708
- fastTotalWeight: state.fastTotalWeight + weight,
709
- slowEstimate: calculateEwma(state.slowEstimate, bandwidth, weight, config.slowHalfLife),
710
- slowTotalWeight: state.slowTotalWeight + weight,
711
- bytesSampled: updatedBytesSampled
712
- };
713
- }
714
- /**
715
- * Get the current bandwidth estimate.
716
- *
717
- * Returns the **minimum** of the fast and slow EWMA estimates.
718
- * This provides the key asymmetric behavior:
719
- * - When bandwidth drops, fast EWMA reacts first and dominates (quick adaptation)
720
- * - When bandwidth rises, slow EWMA lags behind and dominates (slow adaptation)
721
- *
722
- * Uses default estimate until enough data has been sampled.
723
- *
724
- * @param state - Current estimator state
725
- * @param defaultEstimate - Fallback estimate before sufficient samples (bps)
726
- * @param config - Optional estimator configuration (uses defaults if not provided)
727
- * @returns Bandwidth estimate in bits per second
728
- *
729
- * @example
730
- * const estimate = getBandwidthEstimate(state, 5_000_000); // 5 Mbps default
731
- */
732
- function getBandwidthEstimate(state, defaultEstimate, config = DEFAULT_BANDWIDTH_CONFIG) {
733
- if (state.bytesSampled < config.minTotalBytes) return defaultEstimate;
734
- const fastEstimate = applyZeroFactor(state.fastEstimate, state.fastTotalWeight, config.fastHalfLife);
735
- const slowEstimate = applyZeroFactor(state.slowEstimate, state.slowTotalWeight, config.slowHalfLife);
736
- return Math.min(fastEstimate, slowEstimate);
737
- }
738
-
739
- //#endregion
740
- //#region src/core/abr/quality-selection.ts
741
- /**
742
- * Default quality selection configuration.
743
- * Values match Shaka Player upgrade threshold (0.85 = 15% headroom).
744
- */
745
- const DEFAULT_QUALITY_CONFIG = { safetyMargin: .85 };
746
- /**
747
- * Select the best video track based on current bandwidth estimate.
748
- *
749
- * Selects the highest quality track where bandwidth is sufficient with safety margin:
750
- * - currentBandwidth >= track.bandwidth / safetyMargin
751
- * - Default safetyMargin 0.85 means track uses ≤85% of bandwidth (15% headroom)
752
- * - At same bandwidth, prefers higher resolution
753
- *
754
- * @param tracks - Available video tracks (can be unsorted)
755
- * @param currentBandwidth - Current bandwidth estimate in bits per second
756
- * @param config - Optional quality selection configuration
757
- * @returns Selected track, or undefined if no tracks available
758
- *
759
- * @example
760
- * const tracks = [
761
- * { id: '360p', bandwidth: 500_000, ... },
762
- * { id: '720p', bandwidth: 2_000_000, ... },
763
- * { id: '1080p', bandwidth: 4_000_000, ... },
764
- * ];
765
- *
766
- * // With 2.5 Mbps, selects 720p (1080p needs 4M/0.85 = 4.7 Mbps)
767
- * const selected = selectQuality(tracks, 2_500_000);
768
- */
769
- function selectQuality(tracks, currentBandwidth, config = DEFAULT_QUALITY_CONFIG) {
770
- if (tracks.length === 0) return;
771
- const sortedTracks = tracks.slice().sort((a, b) => a.bandwidth - b.bandwidth);
772
- let chosen;
773
- for (const track of sortedTracks) if (currentBandwidth >= track.bandwidth / config.safetyMargin) {
774
- if (!chosen || track.bandwidth > chosen.bandwidth || track.bandwidth === chosen.bandwidth && hasHigherResolution(track, chosen)) chosen = track;
775
- }
776
- return chosen ?? sortedTracks[0];
777
- }
778
- /**
779
- * Check if track A has higher resolution than track B.
780
- * Compares by total pixel count (width × height).
781
- *
782
- * @param trackA - First track to compare
783
- * @param trackB - Second track to compare
784
- * @returns True if trackA has more pixels than trackB
785
- */
786
- function hasHigherResolution(trackA, trackB) {
787
- return (trackA.width ?? 0) * (trackA.height ?? 0) > (trackB.width ?? 0) * (trackB.height ?? 0);
788
- }
789
-
790
- //#endregion
791
- //#region src/core/buffer/back-buffer.ts
792
- /**
793
- * Default back buffer configuration.
794
- */
795
- const DEFAULT_BACK_BUFFER_CONFIG = { keepSegments: 2 };
796
- /**
797
- * Calculate back buffer flush point.
798
- *
799
- * Determines where to flush old segments from the back buffer.
800
- * Keeps a fixed number of segments behind the current playback position.
801
- *
802
- * Algorithm:
803
- * 1. Find segments before currentTime
804
- * 2. Count back N segments (keepSegments)
805
- * 3. Return startTime of segment N+1 back (flush everything before this)
806
- *
807
- * @param segments - Available segments (should be sorted by startTime)
808
- * @param currentTime - Current playback position in seconds
809
- * @param config - Optional back buffer configuration
810
- * @returns Time in seconds to flush up to (flush range: [0, flushEnd))
811
- *
812
- * @example
813
- * const segments = [
814
- * { startTime: 0, duration: 6, ... },
815
- * { startTime: 6, duration: 6, ... },
816
- * { startTime: 12, duration: 6, ... },
817
- * { startTime: 18, duration: 6, ... },
818
- * ];
819
- *
820
- * // Playing at 18s, keep 2 segments
821
- * const flushEnd = calculateBackBufferFlushPoint(segments, 18);
822
- * // Returns 6 (flush [0, 6), keep [6-18))
823
- */
824
- function calculateBackBufferFlushPoint(segments, currentTime, config = DEFAULT_BACK_BUFFER_CONFIG) {
825
- if (segments.length === 0) return 0;
826
- const segmentsBefore = segments.filter((seg) => seg.startTime < currentTime);
827
- if (segmentsBefore.length === 0) return 0;
828
- const segmentsToFlush = segmentsBefore.length - config.keepSegments;
829
- if (segmentsToFlush <= 0) return 0;
830
- if (segmentsToFlush >= segmentsBefore.length) return currentTime;
831
- return segmentsBefore[segmentsToFlush].startTime;
832
- }
833
-
834
- //#endregion
835
- //#region src/core/buffer/forward-buffer.ts
836
- /**
837
- * Default forward buffer configuration.
838
- */
839
- const DEFAULT_FORWARD_BUFFER_CONFIG = { bufferDuration: 30 };
840
- /**
841
- * Get segments that need to be loaded for forward buffer.
842
- *
843
- * Determines which segments to load to maintain target buffer duration.
844
- * Handles discontiguous buffering (gaps after seeks).
845
- *
846
- * Algorithm:
847
- * 1. Calculate target time: currentTime + bufferDuration
848
- * 2. Find all segments in range [currentTime, targetTime)
849
- * 3. Filter out segments already buffered at that time position
850
- * 4. Return segments to load (fills gaps + extends to target)
851
- *
852
- * @param segments - All available segments from playlist
853
- * @param bufferedSegments - Segments already buffered (ordered by startTime)
854
- * @param currentTime - Current playback position in seconds
855
- * @param config - Optional forward buffer configuration
856
- * @returns Array of segments to load (empty if buffer is sufficient)
857
- *
858
- * @example
859
- * // After seek: buffered [0-12, 18-30], playing at 7s
860
- * const toLoad = getSegmentsToLoad(segments, buffered, 7, { bufferDuration: 24 });
861
- * // Returns [seg-12, seg-30] (fills gap, extends to target 31s)
862
- */
863
- /**
864
- * Calculate the start time from which to flush forward buffer content.
865
- *
866
- * Content that starts at or beyond `currentTime + bufferDuration` is no
867
- * longer needed for the current playback position and should be removed
868
- * from the SourceBuffer. This prevents unbounded accumulation of scattered
869
- * SourceBuffer content after seeks, which can cause QuotaExceededError on
870
- * long-form content.
871
- *
872
- * Returns `Infinity` when nothing needs flushing (no buffered segments
873
- * exist beyond the threshold).
874
- *
875
- * @param bufferedSegments - Segments currently tracked in the buffer model
876
- * @param currentTime - Current playback position in seconds
877
- * @param config - Optional forward buffer configuration
878
- * @returns Start time to flush from (flush range: [flushStart, Infinity)),
879
- * or Infinity if no flush is needed
880
- *
881
- * @example
882
- * // Playing at 0s, buffered [0,6,12,18,24,30,36], bufferDuration=30
883
- * const flushStart = calculateForwardFlushPoint(segments, 0);
884
- * // Returns 30 — flush [30, Infinity), keep [0, 30)
885
- */
886
- function calculateForwardFlushPoint(bufferedSegments, currentTime, config = DEFAULT_FORWARD_BUFFER_CONFIG) {
887
- if (bufferedSegments.length === 0) return Infinity;
888
- const threshold = currentTime + config.bufferDuration;
889
- const beyond = bufferedSegments.filter((seg) => seg.startTime >= threshold);
890
- if (beyond.length === 0) return Infinity;
891
- return Math.min(...beyond.map((seg) => seg.startTime));
892
- }
893
- function getSegmentsToLoad(segments, bufferedSegments, currentTime, config = DEFAULT_FORWARD_BUFFER_CONFIG) {
894
- if (segments.length === 0) return [];
895
- const targetTime = currentTime + config.bufferDuration;
896
- const bufferedStartTimes = new Set(bufferedSegments.map((seg) => seg.startTime));
897
- return segments.filter((seg) => {
898
- const segmentEnd = seg.startTime + seg.duration;
899
- const isInRange = seg.startTime < targetTime && segmentEnd > currentTime;
900
- const isNotBuffered = !bufferedStartTimes.has(seg.startTime);
901
- return isInRange && isNotBuffered;
902
- });
903
- }
904
-
905
- //#endregion
906
- //#region src/core/types/index.ts
907
- function isResolvedTrack(track) {
908
- return "segments" in track;
909
- }
910
- /**
911
- * Check if a presentation has duration (at least one track resolved).
912
- * Narrows type to include required duration.
913
- */
914
- function hasPresentationDuration(presentation) {
915
- return presentation.duration !== void 0;
916
- }
917
-
918
- //#endregion
919
- //#region src/dom/media/mediasource-setup.ts
920
- /**
921
- * MediaSource Setup
922
- *
923
- * Utilities for creating and configuring MediaSource/ManagedMediaSource
924
- * for MSE (Media Source Extensions) playback.
925
- *
926
- * Global ManagedMediaSource types are defined in ./mediasource.d.ts
927
- */
928
- /**
929
- * Check if MediaSource API is supported.
930
- */
931
- function supportsMediaSource() {
932
- return typeof MediaSource !== "undefined";
933
- }
934
- /**
935
- * Check if ManagedMediaSource API is supported.
936
- * ManagedMediaSource is a newer Safari API with better lifecycle management.
937
- */
938
- function supportsManagedMediaSource() {
939
- return typeof ManagedMediaSource !== "undefined";
940
- }
941
- /**
942
- * Create a MediaSource or ManagedMediaSource instance.
943
- *
944
- * @param options - Creation options
945
- * @returns A MediaSource or ManagedMediaSource instance
946
- * @throws Error if no MediaSource API is available
947
- *
948
- * @example
949
- * const mediaSource = createMediaSource();
950
- * const mediaElement = document.querySelector('video');
951
- * attachMediaSource(mediaSource, mediaElement);
952
- */
953
- function createMediaSource(options = {}) {
954
- const { preferManaged = false } = options;
955
- if (preferManaged && supportsManagedMediaSource()) return new ManagedMediaSource();
956
- if (supportsMediaSource()) return new MediaSource();
957
- throw new Error("MediaSource API is not supported");
958
- }
959
- /**
960
- * Attach a MediaSource to an HTMLMediaElement.
961
- *
962
- * Uses srcObject for ManagedMediaSource (Safari), or createObjectURL for regular MediaSource.
963
- *
964
- * @param mediaSource - The MediaSource to attach
965
- * @param mediaElement - The media element to attach to
966
- * @returns Object with URL and detach function
967
- *
968
- * @example
969
- * const mediaSource = createMediaSource();
970
- * const { detach } = attachMediaSource(mediaSource, videoElement);
971
- * await waitForSourceOpen(mediaSource);
972
- * // Use mediaSource...
973
- * // Later, to clean up:
974
- * detach();
975
- */
976
- function attachMediaSource(mediaSource, mediaElement) {
977
- if (supportsManagedMediaSource() && mediaSource instanceof ManagedMediaSource) {
978
- mediaElement.disableRemotePlayback = true;
979
- mediaElement.srcObject = mediaSource;
980
- const detach$1 = () => {
981
- mediaElement.srcObject = null;
982
- mediaElement.load();
983
- };
984
- return {
985
- url: "",
986
- detach: detach$1
987
- };
988
- }
989
- const url = URL.createObjectURL(mediaSource);
990
- mediaElement.src = url;
991
- const detach = () => {
992
- mediaElement.removeAttribute("src");
993
- mediaElement.load();
994
- URL.revokeObjectURL(url);
995
- };
996
- return {
997
- url,
998
- detach
999
- };
1000
- }
1001
- /**
1002
- * Wait for a MediaSource to reach the 'open' state.
1003
- * Resolves immediately if already open.
1004
- *
1005
- * @param mediaSource - The MediaSource to wait for
1006
- * @param signal - Optional AbortSignal for cancellation
1007
- * @returns Promise that resolves when the MediaSource is open
1008
- *
1009
- * @example
1010
- * const mediaSource = createMediaSource();
1011
- * attachMediaSource(mediaSource, videoElement);
1012
- * await waitForSourceOpen(mediaSource);
1013
- * // MediaSource is now ready for SourceBuffer creation
1014
- */
1015
- function waitForSourceOpen(mediaSource, signal) {
1016
- return new Promise((resolve, reject) => {
1017
- if (mediaSource.readyState === "open") {
1018
- resolve();
1019
- return;
1020
- }
1021
- if (signal?.aborted) {
1022
- reject(new DOMException("Aborted", "AbortError"));
1023
- return;
1024
- }
1025
- const controller = new AbortController();
1026
- const options = { signal: controller.signal };
1027
- mediaSource.addEventListener("sourceopen", () => {
1028
- controller.abort();
1029
- resolve();
1030
- }, options);
1031
- signal?.addEventListener("abort", () => {
1032
- controller.abort();
1033
- reject(new DOMException("Aborted", "AbortError"));
1034
- }, options);
1035
- });
1036
- }
1037
- /**
1038
- * Create a SourceBuffer on a MediaSource.
1039
- *
1040
- * @param mediaSource - The MediaSource (must be in 'open' state)
1041
- * @param mimeCodec - MIME type with codecs (e.g., 'video/mp4; codecs="avc1.42E01E"')
1042
- * @returns The created SourceBuffer
1043
- * @throws Error if MediaSource is not open or codec is unsupported
1044
- *
1045
- * @example
1046
- * await waitForSourceOpen(mediaSource);
1047
- * const buffer = createSourceBuffer(mediaSource, 'video/mp4; codecs="avc1.42E01E"');
1048
- */
1049
- function createSourceBuffer(mediaSource, mimeCodec) {
1050
- if (mediaSource.readyState !== "open") throw new Error("MediaSource is not open");
1051
- if (!isCodecSupported(mimeCodec)) throw new Error(`Codec not supported: ${mimeCodec}`);
1052
- return mediaSource.addSourceBuffer(mimeCodec);
1053
- }
1054
- /**
1055
- * Check if a codec is supported.
1056
- *
1057
- * @param mimeCodec - MIME type with codecs string
1058
- * @returns True if the codec is supported
1059
- *
1060
- * @example
1061
- * if (isCodecSupported('video/mp4; codecs="avc1.42E01E"')) {
1062
- * // Create source buffer
1063
- * }
1064
- */
1065
- function isCodecSupported(mimeCodec) {
1066
- if (!supportsMediaSource()) return false;
1067
- return MediaSource.isTypeSupported(mimeCodec);
1068
- }
1069
-
1070
- //#endregion
1071
- //#region src/dom/network/chunked-stream-iterable.ts
1072
- const DEFAULT_MIN_CHUNK_SIZE = 2 ** 17;
1073
- /**
1074
- * Adapts a `ReadableStream<Uint8Array>` (e.g. `response.body`) into an
1075
- * `AsyncIterable<Uint8Array>` that yields chunks no smaller than
1076
- * `minChunkSize` bytes. Smaller network chunks are accumulated and yielded
1077
- * together once the threshold is met. Any remainder is flushed on stream end.
1078
- *
1079
- * Errors from the underlying stream propagate naturally — the reader lock is
1080
- * always released via `finally`.
1081
- */
1082
- var ChunkedStreamIterable = class {
1083
- minChunkSize;
1084
- #readableStream;
1085
- constructor(readableStream, { minChunkSize = DEFAULT_MIN_CHUNK_SIZE } = {}) {
1086
- this.#readableStream = readableStream;
1087
- this.minChunkSize = minChunkSize;
1088
- }
1089
- async *[Symbol.asyncIterator]() {
1090
- let pending;
1091
- const reader = this.#readableStream.getReader();
1092
- try {
1093
- while (true) {
1094
- const { done, value } = await reader.read();
1095
- if (done) {
1096
- if (pending) yield pending;
1097
- break;
1098
- }
1099
- pending = pending ? concat(pending, value) : value;
1100
- if (pending.length >= this.minChunkSize) {
1101
- yield pending;
1102
- pending = void 0;
1103
- }
1104
- }
1105
- } finally {
1106
- reader.releaseLock();
1107
- }
1108
- }
1109
- };
1110
- function concat(a, b) {
1111
- const result = new Uint8Array(a.length + b.length);
1112
- result.set(a);
1113
- result.set(b, a.length);
1114
- return result;
1115
- }
1116
-
1117
- //#endregion
1118
- //#region src/dom/network/fetch.ts
1119
- /**
1120
- * Fetch resolvable from AddressableObject.
1121
- *
1122
- * Handles byte range requests if byteRange is present.
1123
- * Returns native fetch Response for composability (can extract text, stream, etc.).
1124
- *
1125
- * @param addressable - Resource to fetch (url + optional byteRange)
1126
- * @returns Promise resolving to Response
1127
- *
1128
- * @example
1129
- * const response = await fetchResolvable({ url: 'https://example.com/segment.m4s' });
1130
- * const text = await getResponseText(response);
1131
- *
1132
- * @example
1133
- * // With byte range
1134
- * const response = await fetchResolvable({
1135
- * url: 'https://example.com/file.mp4',
1136
- * byteRange: { start: 1000, end: 1999 }
1137
- * });
1138
- */
1139
- async function fetchResolvable(addressable, options) {
1140
- const headers = new Headers(options?.headers);
1141
- if (addressable.byteRange) {
1142
- const { start, end } = addressable.byteRange;
1143
- headers.set("Range", `bytes=${start}-${end}`);
1144
- }
1145
- const request = new Request(addressable.url, {
1146
- method: "GET",
1147
- headers,
1148
- ...options
1149
- });
1150
- return fetch(request);
1151
- }
1152
- /**
1153
- * Extract text from Response.
1154
- *
1155
- * Accepts minimal Response-like object (just needs text() method).
1156
- * Returns promise from response.text().
1157
- *
1158
- * @param response - Response-like object with text() method
1159
- * @returns Promise resolving to text content
1160
- *
1161
- * @example
1162
- * const response = await fetchResolvable(addressable);
1163
- * const text = await getResponseText(response);
1164
- */
1165
- function getResponseText(response) {
1166
- return response.text();
1167
- }
1168
-
1169
- //#endregion
1170
- //#region src/core/events/create-event-stream.ts
1171
- /**
1172
- * Minimal event stream with Observable-like shape.
1173
- *
1174
- * Simple Subject/Observable-like implementation for dispatching discrete events.
1175
- * Events are dispatched synchronously to all subscribers.
1176
- */
1177
- const EVENT_STREAM_SYMBOL = Symbol("@videojs/event-stream");
1178
- /**
1179
- * Creates a minimal event stream for dispatching discrete events.
1180
- *
1181
- * Events are dispatched synchronously to all subscribers.
1182
- * Conforms to Observable-like shape for future compatibility.
1183
- *
1184
- * Events must have a 'type' property for discriminated union type narrowing.
1185
- *
1186
- * @example
1187
- * ```ts
1188
- * type Action = { type: 'PLAY' } | { type: 'PAUSE' };
1189
- * const events = createEventStream<Action>();
1190
- *
1191
- * events.subscribe((action) => {
1192
- * if (action.type === 'PLAY') {
1193
- * // Type narrowed to { type: 'PLAY' }
1194
- * }
1195
- * });
1196
- *
1197
- * events.dispatch({ type: 'PLAY' });
1198
- * ```
1199
- */
1200
- function createEventStream() {
1201
- const subscribers = /* @__PURE__ */ new Set();
1202
- return {
1203
- [EVENT_STREAM_SYMBOL]: true,
1204
- dispatch(event) {
1205
- const current = Array.from(subscribers);
1206
- for (const listener of current) listener(event);
1207
- },
1208
- subscribe(listener) {
1209
- subscribers.add(listener);
1210
- return () => subscribers.delete(listener);
1211
- }
1212
- };
1213
- }
1214
-
1215
- //#endregion
1216
- //#region src/core/reactive/combine-latest.ts
1217
- /**
1218
- * Combines multiple Observable sources into a single Observable.
1219
- *
1220
- * Emits an array of latest values whenever any source emits.
1221
- * Only emits after all sources have emitted at least once.
1222
- *
1223
- * Supports selector-based subscriptions (fires only when the selected value
1224
- * changes, per the optional equalityFn) mirroring the createState API.
1225
- *
1226
- * @param sources - Array of Observable sources
1227
- * @returns Combined Observable
1228
- *
1229
- * @example
1230
- * ```ts
1231
- * const state = createState({ count: 0 });
1232
- * const events = createEventStream<Action>();
1233
- *
1234
- * combineLatest([state, events]).subscribe(([state, event]) => {
1235
- * if (event.type === 'PLAY' && state.count > 0) {
1236
- * // React to event + state condition
1237
- * }
1238
- * });
1239
- * ```
1240
- *
1241
- * @example Selector subscription
1242
- * ```ts
1243
- * combineLatest([state, owners]).subscribe(
1244
- * ([s, o]) => deriveKey(s, o),
1245
- * (key) => { ... },
1246
- * { equalityFn: keyEq }
1247
- * );
1248
- * ```
1249
- */
1250
- function combineLatest(sources) {
1251
- const subscribeToSources = (listener) => {
1252
- const latest = new Array(sources.length);
1253
- const hasValue = new Array(sources.length).fill(false);
1254
- const unsubscribers = [];
1255
- for (let i = 0; i < sources.length; i++) {
1256
- const unsubscribe = sources[i].subscribe((value) => {
1257
- latest[i] = value;
1258
- hasValue[i] = true;
1259
- if (hasValue.every((has) => has)) listener([...latest]);
1260
- });
1261
- unsubscribers.push(unsubscribe);
1262
- }
1263
- return () => {
1264
- for (const unsubscribe of unsubscribers) unsubscribe();
1265
- };
1266
- };
1267
- return { subscribe(listenerOrSelector, maybeListener, options) {
1268
- if (maybeListener === void 0) return subscribeToSources(listenerOrSelector);
1269
- const selector = listenerOrSelector;
1270
- const listener = maybeListener;
1271
- const equalityFn = options?.equalityFn ?? Object.is;
1272
- let prevSelected;
1273
- let initialized = false;
1274
- return subscribeToSources((values) => {
1275
- const nextSelected = selector(values);
1276
- if (!initialized || !equalityFn(prevSelected, nextSelected)) {
1277
- prevSelected = nextSelected;
1278
- initialized = true;
1279
- listener(nextSelected);
1280
- }
1281
- });
1282
- } };
1283
- }
1284
-
1285
- //#endregion
1286
- //#region src/core/features/resolve-presentation.ts
1287
- /**
1288
- * Type guard to check if presentation is unresolved.
1289
- */
1290
- function isUnresolved(presentation) {
1291
- return presentation !== void 0 && "url" in presentation && !("id" in presentation);
1292
- }
1293
- function canResolve$1(state) {
1294
- return isUnresolved(state.presentation);
1295
- }
1296
- /**
1297
- * Determines if resolution conditions are met based on preload policy and event.
1298
- *
1299
- * Resolution conditions:
1300
- * - State-driven: preload is 'auto' or 'metadata'
1301
- * - Event-driven: play event
1302
- *
1303
- * @param state - Current presentation state
1304
- * @param event - Current action/event
1305
- * @returns true if resolution conditions are met
1306
- */
1307
- function shouldResolve$1(state, event) {
1308
- const { preload } = state;
1309
- return ["auto", "metadata"].includes(preload) || event.type === "play";
1310
- }
1311
- /**
1312
- * Syncs preload attribute from mediaElement to state.
1313
- *
1314
- * Watches the owners state for mediaElement changes and copies the
1315
- * preload attribute to the immutable state.
1316
- *
1317
- * @param state - Immutable state container
1318
- * @param owners - Mutable platform objects container
1319
- * @returns Cleanup function to stop syncing
1320
- */
1321
- function syncPreloadAttribute(state, owners) {
1322
- return owners.subscribe((current) => {
1323
- const preload = current.mediaElement?.preload || void 0;
1324
- state.patch({ preload });
1325
- });
1326
- }
1327
- /**
1328
- * Resolves unresolved presentations using reactive composition.
1329
- *
1330
- * Uses combineLatest to compose state + events, enabling both state-driven
1331
- * and event-driven resolution triggers.
1332
- *
1333
- * Triggers resolution when:
1334
- * - State-driven: Unresolved presentation + preload allows (auto/metadata)
1335
- * - Event-driven: PLAY event when preload="none"
1336
- *
1337
- * @example
1338
- * ```ts
1339
- * const state = createState({ presentation: undefined, preload: 'auto' });
1340
- * const events = createEventStream<PresentationAction>();
1341
- *
1342
- * const cleanup = resolvePresentation({ state, events });
1343
- *
1344
- * // State-driven: resolves immediately when preload allows
1345
- * state.patch({ presentation: { url: 'http://example.com/playlist.m3u8' } });
1346
- *
1347
- * // Event-driven: resolves on PLAY when preload="none"
1348
- * state.patch({ preload: 'none', presentation: { url: '...' } });
1349
- * events.dispatch({ type: 'PLAY' });
1350
- * ```
1351
- */
1352
- function resolvePresentation({ state, events }) {
1353
- let resolving = false;
1354
- let abortController = null;
1355
- const cleanup = combineLatest([state, events]).subscribe(async ([currentState, event]) => {
1356
- if (!canResolve$1(currentState) || !shouldResolve$1(currentState, event) || resolving) return;
1357
- try {
1358
- resolving = true;
1359
- abortController = new AbortController();
1360
- const { presentation } = currentState;
1361
- const parsed = parseMultivariantPlaylist(await getResponseText(await fetchResolvable(presentation, { signal: abortController.signal })), presentation);
1362
- state.patch({ presentation: parsed });
1363
- } catch (error) {
1364
- if (error instanceof Error && error.name === "AbortError") return;
1365
- throw error;
1366
- } finally {
1367
- resolving = false;
1368
- abortController = null;
1369
- }
1370
- });
1371
- return () => {
1372
- abortController?.abort();
1373
- cleanup();
1374
- };
1375
- }
1376
-
1377
- //#endregion
1378
- //#region src/core/features/quality-switching.ts
1379
- /**
1380
- * Default quality switching configuration.
1381
- */
1382
- const DEFAULT_SWITCHING_CONFIG = {
1383
- safetyMargin: .85,
1384
- minUpgradeInterval: 8e3,
1385
- defaultBandwidth: 5e6
1386
- };
1387
- /**
1388
- * Get all video tracks from a presentation's first switching set.
1389
- * Returns [] when the presentation is still unresolved (no selectionSets yet).
1390
- */
1391
- function getVideoTracks(presentation) {
1392
- return (presentation.selectionSets?.find((s) => s.type === "video"))?.switchingSets[0]?.tracks ?? [];
1393
- }
1394
- /**
1395
- * Quality switching orchestration (F9).
1396
- *
1397
- * Reacts to bandwidth estimate changes and updates `selectedVideoTrackId`
1398
- * when a different quality is optimal:
1399
- *
1400
- * - **Downgrades** happen immediately to avoid buffering stalls.
1401
- * - **Upgrades** are gated by `minUpgradeInterval` to prevent oscillation.
1402
- * - The first switch (from any track, or no track) is always immediate.
1403
- *
1404
- * Smooth switching is handled downstream: when `selectedVideoTrackId` changes,
1405
- * `resolveTrack` fetches the new playlist and `loadSegments` reloads the init
1406
- * segment, then appends media segments from the current position in the new
1407
- * quality. The browser's SourceBuffer replaces the overlapping buffered range.
1408
- *
1409
- * @example
1410
- * const cleanup = switchQuality({ state });
1411
- * // Later, when done:
1412
- * cleanup();
1413
- */
1414
- function switchQuality({ state }, config = {}) {
1415
- const safetyMargin = config.safetyMargin ?? DEFAULT_SWITCHING_CONFIG.safetyMargin;
1416
- const minUpgradeInterval = config.minUpgradeInterval ?? DEFAULT_SWITCHING_CONFIG.minUpgradeInterval;
1417
- const defaultBandwidth = config.defaultBandwidth ?? DEFAULT_SWITCHING_CONFIG.defaultBandwidth;
1418
- let lastUpgradeTime = Date.now();
1419
- let firstMeaningfulFire = true;
1420
- return state.subscribe((currentState) => {
1421
- const { presentation, bandwidthState, selectedVideoTrackId, abrDisabled } = currentState;
1422
- if (abrDisabled === true) return;
1423
- if (!presentation || !bandwidthState) return;
1424
- const videoTracks = getVideoTracks(presentation);
1425
- if (videoTracks.length === 0) return;
1426
- const isFirst = firstMeaningfulFire;
1427
- firstMeaningfulFire = false;
1428
- const optimal = selectQuality(videoTracks, getBandwidthEstimate(bandwidthState, defaultBandwidth), { safetyMargin });
1429
- if (!optimal || optimal.id === selectedVideoTrackId) return;
1430
- const currentTrack = videoTracks.find((t) => t.id === selectedVideoTrackId);
1431
- if (!currentTrack || optimal.bandwidth > currentTrack.bandwidth) {
1432
- const now = Date.now();
1433
- if (!isFirst && now - lastUpgradeTime < minUpgradeInterval) return;
1434
- lastUpgradeTime = now;
1435
- }
1436
- state.patch({ selectedVideoTrackId: optimal.id });
1437
- });
1438
- }
1439
-
1440
- //#endregion
1441
- //#region src/core/utils/track-selection.ts
1442
- /**
1443
- * Map track type to selected track ID property key in state.
1444
- */
1445
- const SelectedTrackIdKeyByType = {
1446
- video: "selectedVideoTrackId",
1447
- audio: "selectedAudioTrackId",
1448
- text: "selectedTextTrackId"
1449
- };
1450
- /**
1451
- * Get selected track from state by type.
1452
- * Returns properly typed track (partially or fully resolved) or undefined.
1453
- * Type parameter T is inferred from the type argument.
1454
- *
1455
- * @example
1456
- * const videoTrack = getSelectedTrack(state, 'video');
1457
- * if (videoTrack && isResolvedTrack(videoTrack)) {
1458
- * // videoTrack is VideoTrack
1459
- * }
1460
- */
1461
- function getSelectedTrack(state, type) {
1462
- const { presentation } = state;
1463
- /** @TODO Consider moving and reusing isUnresolved(presentation) (CJP) */
1464
- if (!presentation || !("id" in presentation)) return void 0;
1465
- const trackId = state[SelectedTrackIdKeyByType[type]];
1466
- return presentation.selectionSets.find(({ type: selectionSetType }) => selectionSetType === type)?.switchingSets[0]?.tracks.find(({ id }) => id === trackId);
1467
- }
1468
-
1469
- //#endregion
1470
- //#region src/dom/features/segment-loader-actor.ts
1471
- /**
1472
- * Creates a SegmentLoaderActor for one track type (video or audio).
1473
- *
1474
- * Receives load assignments via `send()` and owns all execution: planning,
1475
- * removes, fetches, and appends. Coordinates with the SourceBufferActor for
1476
- * all physical SourceBuffer operations.
1477
- *
1478
- * Planning (Cases 1–3) happens in `send()` on every incoming message, producing
1479
- * an ordered LoadTask list. The runner drains that list sequentially. When a new
1480
- * message arrives mid-run, send() replans and either continues the in-flight
1481
- * operation (if still needed) or preempts it.
1482
- *
1483
- * @param sourceBufferActor - Shared SourceBufferActor reference (not owned)
1484
- * @param fetchBytes - Tracked fetch closure (owns throughput sampling for segments).
1485
- * Accepts an optional `minChunkSize` in options; init segments pass `Infinity`
1486
- * so the entire body accumulates as one chunk before appending.
1487
- */
1488
- function createSegmentLoaderActor(sourceBufferActor, fetchBytes) {
1489
- let pendingTasks = null;
1490
- let inFlightInitTrackId = null;
1491
- let inFlightSegmentId = null;
1492
- let abortController = null;
1493
- let running = false;
1494
- let destroyed = false;
1495
- const getBufferedSegments = (allSegments) => {
1496
- const bufferedIds = new Set(sourceBufferActor.snapshot.context.segments.filter((s) => !s.partial).map((s) => s.id));
1497
- return allSegments.filter((s) => bufferedIds.has(s.id));
1498
- };
1499
- /**
1500
- * Translate a load message into an ordered LoadTask list based on committed
1501
- * actor state. In-flight awareness is handled separately in send().
1502
- *
1503
- * @todo Rename alongside LoadTask (e.g. planOps).
1504
- *
1505
- * Case 1 — Removes: forward and back buffer flush points, segment-aligned.
1506
- * No flush on track switch: appending new content overwrites existing buffer
1507
- * ranges, and the actor's time-aligned deduplication keeps the segment model
1508
- * accurate as new segments arrive.
1509
- *
1510
- * Case 2 — Init: schedule if not yet committed for this track.
1511
- *
1512
- * Case 3 — Segments: all segments in the load window not yet committed.
1513
- */
1514
- const planTasks = (message) => {
1515
- const { track, range } = message;
1516
- const actorCtx = sourceBufferActor.snapshot.context;
1517
- const bufferedSegments = getBufferedSegments(track.segments);
1518
- const currentTime = range?.start ?? 0;
1519
- const tasks = [];
1520
- if (range) {
1521
- const forwardFlushStart = calculateForwardFlushPoint(bufferedSegments, currentTime);
1522
- if (forwardFlushStart < Infinity) tasks.push({
1523
- type: "remove",
1524
- start: forwardFlushStart,
1525
- end: Infinity
1526
- });
1527
- const backFlushEnd = calculateBackBufferFlushPoint(bufferedSegments, currentTime);
1528
- if (backFlushEnd > 0) tasks.push({
1529
- type: "remove",
1530
- start: 0,
1531
- end: backFlushEnd
1532
- });
1533
- }
1534
- if (actorCtx.initTrackId !== track.id) tasks.push({
1535
- type: "append-init",
1536
- meta: { trackId: track.id },
1537
- url: track.initialization.url,
1538
- ...track.initialization.byteRange !== void 0 && { byteRange: track.initialization.byteRange }
1539
- });
1540
- if (range) {
1541
- const EPSILON = 1e-4;
1542
- const segmentsToLoad = getSegmentsToLoad(track.segments, bufferedSegments, currentTime).filter((seg) => {
1543
- const existing = actorCtx.segments.find((s) => Math.abs(s.startTime - seg.startTime) < EPSILON);
1544
- if (existing?.partial) return true;
1545
- if (!existing?.trackBandwidth || !track.bandwidth) return true;
1546
- return track.bandwidth > existing.trackBandwidth;
1547
- });
1548
- for (const segment of segmentsToLoad) tasks.push({
1549
- type: "append-segment",
1550
- meta: {
1551
- id: segment.id,
1552
- startTime: segment.startTime,
1553
- duration: segment.duration,
1554
- trackId: track.id,
1555
- trackBandwidth: track.bandwidth
1556
- },
1557
- url: segment.url,
1558
- ...segment.byteRange !== void 0 && { byteRange: segment.byteRange }
1559
- });
1560
- }
1561
- return tasks;
1562
- };
1563
- /**
1564
- * Execute a single LoadTask: fetch (if needed) then forward to SourceBufferActor.
1565
- * Sets/clears in-flight tracking around async operations so send() can make
1566
- * accurate continue/preempt decisions at any point during execution.
1567
- *
1568
- * @todo Rename alongside LoadTask (e.g. executeOp).
1569
- */
1570
- const executeLoadTask = async (task) => {
1571
- const signal = abortController.signal;
1572
- try {
1573
- if (task.type === "remove") {
1574
- await sourceBufferActor.send(task, signal);
1575
- return;
1576
- }
1577
- if (task.type === "append-init") {
1578
- inFlightInitTrackId = task.meta.trackId;
1579
- if (!signal.aborted) {
1580
- const data = await fetchBytes(task, {
1581
- signal,
1582
- minChunkSize: Infinity
1583
- });
1584
- const isTrackSwitch = pendingTasks?.some((t) => t.type === "append-init" && t.meta.trackId !== task.meta.trackId);
1585
- if (!signal.aborted || !isTrackSwitch) {
1586
- const appendSignal = signal.aborted ? new AbortController().signal : signal;
1587
- await sourceBufferActor.send({
1588
- type: "append-init",
1589
- data,
1590
- meta: task.meta
1591
- }, appendSignal);
1592
- }
1593
- }
1594
- return;
1595
- }
1596
- inFlightSegmentId = task.meta.id;
1597
- if (!signal.aborted) {
1598
- const stream = await fetchBytes(task, { signal });
1599
- if (!signal.aborted) await sourceBufferActor.send({
1600
- type: "append-segment",
1601
- data: stream,
1602
- meta: task.meta
1603
- }, signal);
1604
- }
1605
- } finally {
1606
- inFlightInitTrackId = null;
1607
- inFlightSegmentId = null;
1608
- }
1609
- };
1610
- /**
1611
- * Drain the scheduled task list sequentially.
1612
- * After each task completes, checks for a pending replacement plan from send().
1613
- * If the signal was aborted and no new plan arrived, stops immediately.
1614
- */
1615
- const runScheduled = async (initialTasks) => {
1616
- running = true;
1617
- abortController = new AbortController();
1618
- let scheduled = initialTasks;
1619
- while (scheduled.length > 0 && !destroyed) {
1620
- const task = scheduled[0];
1621
- scheduled = scheduled.slice(1);
1622
- try {
1623
- await executeLoadTask(task);
1624
- } catch (error) {
1625
- if (error instanceof Error && error.name === "AbortError") {} else {
1626
- console.error("Unexpected error in segment loader:", error);
1627
- scheduled = [];
1628
- }
1629
- }
1630
- if (pendingTasks !== null) {
1631
- scheduled = pendingTasks;
1632
- pendingTasks = null;
1633
- abortController = new AbortController();
1634
- } else if (abortController.signal.aborted) break;
1635
- }
1636
- abortController = null;
1637
- running = false;
1638
- };
1639
- return {
1640
- send(message) {
1641
- if (destroyed) return;
1642
- const allTasks = planTasks(message);
1643
- if (!running) {
1644
- if (allTasks.length === 0) return;
1645
- runScheduled(allTasks);
1646
- return;
1647
- }
1648
- if (inFlightSegmentId !== null && allTasks.some((t) => t.type === "append-segment" && t.meta.id === inFlightSegmentId) || inFlightInitTrackId !== null && allTasks.some((t) => t.type === "append-init" && t.meta.trackId === inFlightInitTrackId)) pendingTasks = allTasks.filter((t) => !(t.type === "append-segment" && t.meta.id === inFlightSegmentId) && !(t.type === "append-init" && t.meta.trackId === inFlightInitTrackId));
1649
- else {
1650
- pendingTasks = allTasks;
1651
- abortController?.abort();
1652
- }
1653
- },
1654
- destroy() {
1655
- destroyed = true;
1656
- abortController?.abort();
1657
- }
1658
- };
1659
- }
1660
-
1661
- //#endregion
1662
- //#region src/dom/features/load-segments.ts
1663
- const ActorKeyByType = {
1664
- video: "videoBufferActor",
1665
- audio: "audioBufferActor"
1666
- };
1667
- function createTrackedFetch(throughput, onSample) {
1668
- return async (addressable, options) => {
1669
- const { minChunkSize,...fetchOptions } = options ?? {};
1670
- const response = await fetchResolvable(addressable, fetchOptions);
1671
- if (!response.body) throw new Error("Response has no body");
1672
- const body = response.body;
1673
- return { [Symbol.asyncIterator]: async function* () {
1674
- let chunkStart = performance.now();
1675
- for await (const chunk of new ChunkedStreamIterable(body, ...minChunkSize !== void 0 ? [{ minChunkSize }] : [])) {
1676
- const elapsed = performance.now() - chunkStart;
1677
- const next = sampleBandwidth(throughput.current, elapsed, chunk.byteLength);
1678
- throughput.patch(next);
1679
- throughput.flush();
1680
- onSample?.(next);
1681
- yield chunk;
1682
- chunkStart = performance.now();
1683
- }
1684
- } };
1685
- };
1686
- }
1687
- /**
1688
- * Non-tracking fetch: eagerly starts the request and returns the response body
1689
- * as a lazy chunk iterable. Used for audio tracks which don't sample bandwidth.
1690
- * Pass `minChunkSize: Infinity` to accumulate the full body as a single chunk
1691
- * (equivalent to arrayBuffer() but through the same streaming path).
1692
- */
1693
- async function fetchStream(addressable, options) {
1694
- const { minChunkSize,...fetchOptions } = options ?? {};
1695
- const response = await fetchResolvable(addressable, fetchOptions);
1696
- if (!response.body) throw new Error("Response has no body");
1697
- return new ChunkedStreamIterable(response.body, ...minChunkSize !== void 0 ? [{ minChunkSize }] : []);
1698
- }
1699
- function selectLoadingInputs([segmentsCanLoad, state], type) {
1700
- const { playbackInitiated, preload, currentTime } = state;
1701
- return {
1702
- playbackInitiated,
1703
- preload,
1704
- currentTime,
1705
- track: getSelectedTrack(state, type),
1706
- segmentsCanLoad
1707
- };
1708
- }
1709
- /**
1710
- * Equality function encoding the condition hierarchy for relevant changes.
1711
- *
1712
- * Pre-play (!playbackInitiated):
1713
- * Only preload changes matter. currentTime and resolvedTrackId are ignored
1714
- * (track changes not supported pre-play; currentTime value is used at
1715
- * trigger time but changes don't re-trigger).
1716
- *
1717
- * playbackInitiated transition:
1718
- * Always fires (handled in the subscriber; preload='auto' suppression
1719
- * applied there since equality functions have no memory of prior values).
1720
- *
1721
- * Post-play (playbackInitiated):
1722
- * resolvedTrackId changes (track switch or previously-unresolved track
1723
- * resolving) and currentTime changes both trigger. preload is irrelevant.
1724
- */
1725
- const segmentStartFor = (currentTime, track) => {
1726
- if (currentTime == null) return void 0;
1727
- return track?.segments.find(({ startTime, duration }, i, segments) => currentTime >= startTime && (currentTime < startTime + duration || i === segments.length - 1))?.startTime;
1728
- };
1729
- /**
1730
- * Returns true when the inputs are equal (no meaningful change — don't fire).
1731
- * Returns false when the inputs differ in a way that requires a new message.
1732
- *
1733
- * This IS the shouldLoadSegments logic, expressed as an equality function.
1734
- */
1735
- function loadingInputsEq(prevState, curState) {
1736
- if (!curState.segmentsCanLoad) return true;
1737
- if (!curState.playbackInitiated) {
1738
- if (curState.preload === "none") return true;
1739
- return curState.preload === prevState.preload;
1740
- }
1741
- if (!prevState.playbackInitiated && curState.playbackInitiated) {
1742
- if (prevState.preload !== "auto") return false;
1743
- }
1744
- if (!curState.track || !isResolvedTrack(curState.track)) return true;
1745
- if (prevState.track?.id !== curState.track.id && isResolvedTrack(curState.track)) return false;
1746
- return segmentStartFor(prevState.currentTime, curState.track) === segmentStartFor(curState.currentTime, curState.track);
1747
- }
1748
- /**
1749
- * Load segments orchestration — Reactor layer.
1750
- *
1751
- * Sends typed load messages to a SegmentLoaderActor when relevant conditions
1752
- * change. Uses targeted subscriptions rather than broad combineLatest so only
1753
- * meaningful state changes trigger evaluation.
1754
- *
1755
- * Condition hierarchy (see SegmentLoadingKey for detail):
1756
- *
1757
- * !playbackInitiated
1758
- * preload==='none' (or unset) → dormant; no trigger
1759
- * preload==='metadata' → trigger on transition to 'metadata'
1760
- * preload==='auto' → trigger on transition to 'auto'
1761
- *
1762
- * !playbackInitiated → playbackInitiated
1763
- * preload !== 'auto' → trigger (message shape changes)
1764
- * preload === 'auto' → suppressed (was already full-range mode;
1765
- * let segmentStart take over post-play)
1766
- * KNOWN LIMITATION: seek-before-play with
1767
- * preload='auto' is not supported — if the
1768
- * user seeks before pressing play, the
1769
- * first re-send is delayed until the next
1770
- * segment boundary crossing post-play.
1771
- *
1772
- * playbackInitiated
1773
- * resolvedTrackId changes → trigger
1774
- * segmentStart(currentTime) changes → trigger (segment boundary only)
1775
- *
1776
- * @example
1777
- * const cleanup = loadSegments({ state, owners }, { type: 'video' });
1778
- */
1779
- function loadSegments({ state, owners }, config) {
1780
- const { type } = config;
1781
- const actorKey = ActorKeyByType[type];
1782
- const initialBandwidth = state.current.bandwidthState;
1783
- const throughput = createState(initialBandwidth ?? {
1784
- fastEstimate: 0,
1785
- fastTotalWeight: 0,
1786
- slowEstimate: 0,
1787
- slowTotalWeight: 0,
1788
- bytesSampled: 0
1789
- });
1790
- const fetchBytes = type === "video" ? createTrackedFetch(throughput, initialBandwidth !== void 0 ? (next) => {
1791
- state.patch({ bandwidthState: next });
1792
- state.flush();
1793
- } : void 0) : fetchStream;
1794
- const segmentLoader = createState(void 0);
1795
- const unsubActorLifecycle = owners.subscribe((o) => o[actorKey], (actor) => {
1796
- if (actor) segmentLoader.patch(createSegmentLoaderActor(actor, fetchBytes));
1797
- else if (!actor && segmentLoader.current) {
1798
- segmentLoader.current.destroy();
1799
- segmentLoader.patch(void 0);
1800
- }
1801
- return () => {
1802
- segmentLoader.current?.destroy();
1803
- segmentLoader.patch(void 0);
1804
- };
1805
- });
1806
- const segmentsCanLoad = createState(false);
1807
- const unsubscribeCanLoadSegments = combineLatest([state, segmentLoader]).subscribe(([currentState, currentSegmentLoader]) => {
1808
- const track = getSelectedTrack(currentState, type);
1809
- const trackResolved = !!track && isResolvedTrack(track);
1810
- const segmentLoaderActorExists = !!currentSegmentLoader;
1811
- segmentsCanLoad.patch(trackResolved && segmentLoaderActorExists);
1812
- });
1813
- const unsubscribeShouldLoadSegments = combineLatest([segmentsCanLoad, state]).subscribe(([segmentsCanLoad$1, state$1]) => selectLoadingInputs([segmentsCanLoad$1, state$1], type), ({ preload, playbackInitiated, currentTime, track }) => {
1814
- if (!(preload === "auto" || !!playbackInitiated))
1815
- /** @ts-expect-error */
1816
- segmentLoader.current?.send({
1817
- type: "load",
1818
- track
1819
- });
1820
- else segmentLoader.current?.send({
1821
- type: "load",
1822
- track,
1823
- range: {
1824
- start: currentTime,
1825
- end: currentTime + DEFAULT_FORWARD_BUFFER_CONFIG.bufferDuration
1826
- }
1827
- });
1828
- }, { equalityFn: loadingInputsEq });
1829
- return () => {
1830
- unsubscribeCanLoadSegments();
1831
- unsubscribeShouldLoadSegments();
1832
- unsubActorLifecycle();
1833
- };
1834
- }
1835
-
1836
- //#endregion
1837
- //#region src/dom/text/parse-vtt-segment.ts
1838
- /**
1839
- * Parse a VTT segment using browser's native parser.
1840
- *
1841
- * Creates a dummy video element with a track element to leverage
1842
- * the browser's optimized VTT parsing. Returns parsed VTTCue objects.
1843
- */
1844
- let dummyVideo = null;
1845
- function ensureDummyVideo() {
1846
- if (!dummyVideo) {
1847
- dummyVideo = document.createElement("video");
1848
- dummyVideo.muted = true;
1849
- dummyVideo.preload = "none";
1850
- dummyVideo.style.display = "none";
1851
- dummyVideo.crossOrigin = "anonymous";
1852
- }
1853
- return dummyVideo;
1854
- }
1855
- function parseVttSegment(url) {
1856
- const video = ensureDummyVideo();
1857
- const track = document.createElement("track");
1858
- track.kind = "subtitles";
1859
- track.default = true;
1860
- return new Promise((resolve, reject) => {
1861
- const onLoad = () => {
1862
- const cues = [];
1863
- const textTrack = track.track;
1864
- if (textTrack.cues) for (let i = 0; i < textTrack.cues.length; i++) {
1865
- const cue = textTrack.cues[i];
1866
- if (cue) cues.push(cue);
1867
- }
1868
- cleanup();
1869
- resolve(cues);
1870
- };
1871
- const onError = () => {
1872
- cleanup();
1873
- reject(/* @__PURE__ */ new Error(`Failed to load VTT segment: ${url}`));
1874
- };
1875
- const cleanup = () => {
1876
- track.removeEventListener("load", onLoad);
1877
- track.removeEventListener("error", onError);
1878
- video.removeChild(track);
1879
- };
1880
- track.addEventListener("load", onLoad);
1881
- track.addEventListener("error", onError);
1882
- video.appendChild(track);
1883
- track.src = url;
1884
- });
1885
- }
1886
- function destroyVttParser() {
1887
- dummyVideo = null;
1888
- }
1889
-
1890
- //#endregion
1891
- //#region src/dom/features/load-text-track-cues.ts
1892
- function isDuplicateCue(cue, textTrack) {
1893
- const { cues } = textTrack;
1894
- if (!cues) return false;
1895
- for (let i = 0; i < cues.length; i++) {
1896
- const existing = cues[i];
1897
- if (existing.startTime === cue.startTime && existing.endTime === cue.endTime && existing.text === cue.text) return true;
1898
- }
1899
- return false;
1900
- }
1901
- const loadVttSegmentTask = async ({ segment }, context) => {
1902
- const cues = await parseVttSegment(segment.url);
1903
- for (const cue of cues) if (!isDuplicateCue(cue, context.textTrack)) context.textTrack.addCue(cue);
1904
- };
1905
- /**
1906
- * Load text track cues task (composite - orchestrates VTT segment subtasks).
1907
- */
1908
- const loadTextTrackCuesTask = async ({ currentState }, context) => {
1909
- const track = findSelectedTextTrack(currentState);
1910
- if (!track || !isResolvedTrack(track)) return;
1911
- const { segments } = track;
1912
- if (segments.length === 0) return;
1913
- const trackId = track.id;
1914
- const loadedIds = new Set((currentState.textBufferState?.[trackId]?.segments ?? []).map((s) => s.id));
1915
- const segmentsToLoad = getSegmentsToLoad(segments, segments.filter((s) => loadedIds.has(s.id)), currentState.currentTime ?? 0).filter((s) => !loadedIds.has(s.id));
1916
- if (segmentsToLoad.length === 0) return;
1917
- for (const segment of segmentsToLoad) {
1918
- if (context.signal.aborted) break;
1919
- try {
1920
- await loadVttSegmentTask({ segment }, { textTrack: context.textTrack });
1921
- const latest = context.state.current.textBufferState ?? {};
1922
- const trackState = latest[trackId] ?? { segments: [] };
1923
- context.state.patch({ textBufferState: {
1924
- ...latest,
1925
- [trackId]: { segments: [...trackState.segments, { id: segment.id }] }
1926
- } });
1927
- } catch (error) {
1928
- if (error instanceof Error && error.name === "AbortError") break;
1929
- console.error("Failed to load VTT segment:", error);
1930
- }
1931
- }
1932
- if (context.textTrack.mode === "showing" && context.textTrack.cues) Array.from(context.textTrack.cues).forEach((cue) => {
1933
- context.textTrack.addCue(cue);
1934
- });
1935
- await new Promise((resolve) => requestAnimationFrame(resolve));
1936
- };
1937
- /**
1938
- * Find the selected text track in the presentation.
1939
- */
1940
- function findSelectedTextTrack(state) {
1941
- if (!state.presentation || !state.selectedTextTrackId) return;
1942
- const textSet = state.presentation.selectionSets.find((set) => set.type === "text");
1943
- if (!textSet?.switchingSets?.[0]?.tracks) return;
1944
- return textSet.switchingSets[0].tracks.find((t) => t.id === state.selectedTextTrackId);
1945
- }
1946
- /**
1947
- * Get the browser's TextTrack object for the selected text track.
1948
- *
1949
- * Retrieves the live TextTrack interface from the track element in owners,
1950
- * which is used for adding cues, checking mode, and managing track state.
1951
- *
1952
- * Note: Returns the DOM TextTrack interface (HTMLTrackElement.track),
1953
- * not the presentation Track metadata type.
1954
- *
1955
- * @param state - Current playback state (track selection)
1956
- * @param owners - DOM owners containing track elements map
1957
- * @returns DOM TextTrack interface or undefined if not found
1958
- */
1959
- function getSelectedTextTrackFromOwners(state, owners) {
1960
- const trackId = state.selectedTextTrackId;
1961
- if (!trackId || !owners.textTracks) return;
1962
- return owners.textTracks.get(trackId)?.track;
1963
- }
1964
- /**
1965
- * Check if we can load text track cues.
1966
- *
1967
- * Requires:
1968
- * - Selected text track ID exists
1969
- * - Track elements map exists
1970
- * - Track element exists for selected track
1971
- */
1972
- function canLoadTextTrackCues(state, owners) {
1973
- return !!state.selectedTextTrackId && !!owners.textTracks && owners.textTracks.has(state.selectedTextTrackId);
1974
- }
1975
- /**
1976
- * Check if we should load text track cues.
1977
- *
1978
- * Only load if:
1979
- * - Track is resolved (has segments)
1980
- * - Track has at least one segment
1981
- * - Track element exists
1982
- */
1983
- function shouldLoadTextTrackCues(state, owners) {
1984
- if (!canLoadTextTrackCues(state, owners)) return false;
1985
- const track = findSelectedTextTrack(state);
1986
- if (!track || !isResolvedTrack(track) || track.segments.length === 0) return false;
1987
- if (!getSelectedTextTrackFromOwners(state, owners)) return false;
1988
- return true;
1989
- }
1990
- /**
1991
- * Load text track cues orchestration.
1992
- *
1993
- * Triggers when:
1994
- * - Text track is selected
1995
- * - Track is resolved (has segments)
1996
- * - Track element exists
1997
- *
1998
- * Fetches and parses VTT segments within the forward buffer window, then adds
1999
- * cues to the track incrementally. Continues on segment errors to provide
2000
- * partial subtitles.
2001
- *
2002
- * @example
2003
- * const cleanup = loadTextTrackCues({ state, owners });
2004
- */
2005
- function loadTextTrackCues({ state, owners }) {
2006
- let currentTask = null;
2007
- let abortController = null;
2008
- let lastTrackId;
2009
- const cleanup = combineLatest([state, owners]).subscribe(async ([currentState, currentOwners]) => {
2010
- if (currentState.selectedTextTrackId !== lastTrackId) {
2011
- lastTrackId = currentState.selectedTextTrackId;
2012
- abortController?.abort();
2013
- currentTask = null;
2014
- }
2015
- if (currentTask) return;
2016
- if (!shouldLoadTextTrackCues(currentState, currentOwners)) return;
2017
- const textTrack = getSelectedTextTrackFromOwners(currentState, currentOwners);
2018
- if (!textTrack) return;
2019
- abortController = new AbortController();
2020
- currentTask = loadTextTrackCuesTask({ currentState }, {
2021
- signal: abortController.signal,
2022
- textTrack,
2023
- state
2024
- }).finally(() => {
2025
- currentTask = null;
2026
- });
2027
- });
2028
- return () => {
2029
- abortController?.abort();
2030
- cleanup();
2031
- };
2032
- }
2033
-
2034
- //#endregion
2035
- //#region src/dom/features/track-current-time.ts
2036
- /**
2037
- * Track current playback position from the media element.
2038
- *
2039
- * Mirrors `mediaElement.currentTime` into reactive state on:
2040
- * - `timeupdate` — fires during playback (~4 Hz)
2041
- * - `seeking` — fires when a seek begins; per spec, `currentTime` is
2042
- * already at the new position when this event dispatches, so buffer
2043
- * management can react immediately rather than waiting for `timeupdate`,
2044
- * which does not fire while paused.
2045
- *
2046
- * Also syncs immediately when a media element becomes available.
2047
- *
2048
- * @example
2049
- * const cleanup = trackCurrentTime({ state, owners });
2050
- */
2051
- function trackCurrentTime({ state, owners }) {
2052
- let lastMediaElement;
2053
- let removeListeners = null;
2054
- const unsubscribe = owners.subscribe((currentOwners) => {
2055
- const { mediaElement } = currentOwners;
2056
- if (mediaElement === lastMediaElement) return;
2057
- removeListeners?.();
2058
- removeListeners = null;
2059
- lastMediaElement = mediaElement;
2060
- if (!mediaElement) return;
2061
- state.patch({ currentTime: mediaElement.currentTime });
2062
- const sync = () => state.patch({ currentTime: mediaElement.currentTime });
2063
- const removeTimeupdate = listen(mediaElement, "timeupdate", sync);
2064
- const removeSeeking = listen(mediaElement, "seeking", sync);
2065
- removeListeners = () => {
2066
- removeTimeupdate();
2067
- removeSeeking();
2068
- };
2069
- });
2070
- return () => {
2071
- removeListeners?.();
2072
- unsubscribe();
2073
- };
2074
- }
2075
-
2076
- //#endregion
2077
- //#region src/dom/features/track-playback-initiated.ts
2078
- /**
2079
- * Track whether playback has been initiated by the user.
2080
- *
2081
- * Sets `state.playbackInitiated = true` when the media element fires a `play`
2082
- * event (via `element.play()`, native controls, or autoplay) and simultaneously
2083
- * dispatches `{ type: 'play' }` to the event stream so `resolvePresentation`
2084
- * can react.
2085
- *
2086
- * Resets `state.playbackInitiated = false` when `presentation.url` changes,
2087
- * so a new source with `preload="none"` won't load segments until play is
2088
- * triggered again.
2089
- *
2090
- * This flag is used by `shouldLoadSegments` to allow segment loading after
2091
- * play is initiated regardless of the initial `preload` setting — `preload`
2092
- * is a startup hint, not a runtime gate.
2093
- *
2094
- * @example
2095
- * const cleanup = trackPlaybackInitiated({ state, owners, events });
2096
- */
2097
- function trackPlaybackInitiated({ state, owners, events }) {
2098
- let lastMediaElement;
2099
- let removeListener = null;
2100
- let lastPresentationUrl;
2101
- const unsubscribeState = state.subscribe((currentState) => {
2102
- const url = currentState.presentation?.url;
2103
- if (url !== lastPresentationUrl) {
2104
- if (lastPresentationUrl !== void 0) state.patch({ playbackInitiated: false });
2105
- lastPresentationUrl = url;
2106
- }
2107
- });
2108
- const unsubscribeOwners = owners.subscribe((currentOwners) => {
2109
- const { mediaElement } = currentOwners;
2110
- if (mediaElement === lastMediaElement) return;
2111
- removeListener?.();
2112
- removeListener = null;
2113
- lastMediaElement = mediaElement;
2114
- if (!mediaElement) return;
2115
- removeListener = listen(mediaElement, "play", () => {
2116
- state.patch({ playbackInitiated: true });
2117
- events.dispatch({ type: "play" });
2118
- });
2119
- });
2120
- return () => {
2121
- removeListener?.();
2122
- unsubscribeState();
2123
- unsubscribeOwners();
2124
- };
2125
- }
2126
-
2127
- //#endregion
2128
- //#region src/dom/media/append-segment.ts
2129
- /**
2130
- * Append media data to a SourceBuffer.
2131
- *
2132
- * Accepts either a full ArrayBuffer (single append) or an AsyncIterable of
2133
- * Uint8Array chunks (one append per chunk, in order). Waits for `updateend`
2134
- * between each call so appends are serialized correctly.
2135
- *
2136
- * Errors from the SourceBuffer (`error` event) or from the iterable are
2137
- * propagated as rejections.
2138
- */
2139
- async function appendSegment(sourceBuffer, data, signal) {
2140
- if (data instanceof ArrayBuffer) await appendChunk(sourceBuffer, data);
2141
- else for await (const chunk of data) {
2142
- if (signal?.aborted) throw signal.reason ?? new DOMException("Aborted", "AbortError");
2143
- await appendChunk(sourceBuffer, chunk);
2144
- }
2145
- }
2146
- async function appendChunk(sourceBuffer, data) {
2147
- if (sourceBuffer.updating) await new Promise((resolve) => {
2148
- const onUpdateEnd = () => {
2149
- sourceBuffer.removeEventListener("updateend", onUpdateEnd);
2150
- resolve();
2151
- };
2152
- sourceBuffer.addEventListener("updateend", onUpdateEnd);
2153
- });
2154
- return new Promise((resolve, reject) => {
2155
- const onUpdateEnd = () => {
2156
- cleanup();
2157
- resolve();
2158
- };
2159
- const onError = (event) => {
2160
- cleanup();
2161
- reject(/* @__PURE__ */ new Error(`SourceBuffer append error: ${event.type}`));
2162
- };
2163
- const cleanup = () => {
2164
- sourceBuffer.removeEventListener("updateend", onUpdateEnd);
2165
- sourceBuffer.removeEventListener("error", onError);
2166
- };
2167
- sourceBuffer.addEventListener("updateend", onUpdateEnd);
2168
- sourceBuffer.addEventListener("error", onError);
2169
- try {
2170
- sourceBuffer.appendBuffer(data);
2171
- } catch (error) {
2172
- cleanup();
2173
- reject(error);
2174
- }
2175
- });
2176
- }
2177
-
2178
- //#endregion
2179
- //#region src/dom/media/buffer-flusher.ts
2180
- /**
2181
- * Buffer flusher helper (P12)
2182
- *
2183
- * Removes a time range from a SourceBuffer to manage memory.
2184
- */
2185
- /**
2186
- * Remove a time range from a SourceBuffer.
2187
- *
2188
- * Waits for the SourceBuffer to be ready (not updating), then removes
2189
- * the specified range. Returns a promise that resolves when removal completes.
2190
- *
2191
- * @param sourceBuffer - The SourceBuffer to remove data from
2192
- * @param start - Start of the time range to remove (seconds)
2193
- * @param end - End of the time range to remove (seconds)
2194
- * @returns Promise that resolves when removal completes
2195
- *
2196
- * @example
2197
- * await flushBuffer(videoSourceBuffer, 0, 30);
2198
- */
2199
- async function flushBuffer(sourceBuffer, start, end) {
2200
- if (sourceBuffer.updating) await new Promise((resolve) => {
2201
- const onUpdateEnd = () => {
2202
- sourceBuffer.removeEventListener("updateend", onUpdateEnd);
2203
- resolve();
2204
- };
2205
- sourceBuffer.addEventListener("updateend", onUpdateEnd);
2206
- });
2207
- return new Promise((resolve, reject) => {
2208
- const onUpdateEnd = () => {
2209
- cleanup();
2210
- resolve();
2211
- };
2212
- const onError = (event) => {
2213
- cleanup();
2214
- reject(/* @__PURE__ */ new Error(`SourceBuffer remove error: ${event.type}`));
2215
- };
2216
- const cleanup = () => {
2217
- sourceBuffer.removeEventListener("updateend", onUpdateEnd);
2218
- sourceBuffer.removeEventListener("error", onError);
2219
- };
2220
- sourceBuffer.addEventListener("updateend", onUpdateEnd);
2221
- sourceBuffer.addEventListener("error", onError);
2222
- try {
2223
- sourceBuffer.remove(start, end);
2224
- } catch (error) {
2225
- cleanup();
2226
- reject(error);
2227
- }
2228
- });
2229
- }
2230
-
2231
- //#endregion
2232
- //#region src/core/features/calculate-presentation-duration.ts
2233
- /**
2234
- * Check if we can calculate presentation duration (have required data).
2235
- */
2236
- function canCalculateDuration(state) {
2237
- if (!state.presentation) return false;
2238
- return !!(state.selectedVideoTrackId || state.selectedAudioTrackId);
2239
- }
2240
- /**
2241
- * Check if we should calculate presentation duration (conditions met).
2242
- */
2243
- function shouldCalculateDuration(state) {
2244
- if (!canCalculateDuration(state)) return false;
2245
- const { presentation } = state;
2246
- if (presentation.duration !== void 0) return false;
2247
- const videoTrack = state.selectedVideoTrackId ? getSelectedTrack(state, "video") : void 0;
2248
- const audioTrack = state.selectedAudioTrackId ? getSelectedTrack(state, "audio") : void 0;
2249
- return !!(videoTrack && isResolvedTrack(videoTrack) || audioTrack && isResolvedTrack(audioTrack));
2250
- }
2251
- /**
2252
- * Get duration from the first resolved track (prefer video, fallback to audio).
2253
- */
2254
- function getDurationFromResolvedTracks(state) {
2255
- const videoTrack = state.selectedVideoTrackId ? getSelectedTrack(state, "video") : void 0;
2256
- if (videoTrack && isResolvedTrack(videoTrack)) return videoTrack.duration;
2257
- const audioTrack = state.selectedAudioTrackId ? getSelectedTrack(state, "audio") : void 0;
2258
- if (audioTrack && isResolvedTrack(audioTrack)) return audioTrack.duration;
2259
- }
2260
- /**
2261
- * Calculate and set presentation duration from resolved tracks.
2262
- */
2263
- function calculatePresentationDuration({ state }) {
2264
- return combineLatest([state]).subscribe(([currentState]) => {
2265
- if (!shouldCalculateDuration(currentState)) return;
2266
- const duration = getDurationFromResolvedTracks(currentState);
2267
- if (duration === void 0 || !Number.isFinite(duration)) return;
2268
- const { presentation } = currentState;
2269
- state.patch({ presentation: {
2270
- ...presentation,
2271
- duration
2272
- } });
2273
- });
2274
- }
2275
-
2276
- //#endregion
2277
- //#region src/core/task.ts
2278
- /**
2279
- * Generic reusable task that wraps an async run function.
2280
- *
2281
- * Owns its own AbortController so it can always be aborted independently.
2282
- * Optionally composes an external AbortSignal so that a parent's cancellation
2283
- * propagates into the task's work without requiring the caller to track the
2284
- * task separately.
2285
- *
2286
- * Ordering guarantee: `value` is written before `status` transitions to `'done'`;
2287
- * `error` is written before `status` transitions to `'error'`. Any reader
2288
- * observing `status === 'done'` is guaranteed `value` is already present.
2289
- */
2290
- var Task = class {
2291
- id;
2292
- #runFn;
2293
- #abortController = new AbortController();
2294
- #signal;
2295
- #status = "pending";
2296
- #value = void 0;
2297
- #error = void 0;
2298
- constructor(runFn, config) {
2299
- this.#runFn = runFn;
2300
- const rawId = config?.id;
2301
- this.id = typeof rawId === "function" ? rawId() : rawId ?? generateId();
2302
- this.#signal = config?.signal ? AbortSignal.any([this.#abortController.signal, config.signal]) : this.#abortController.signal;
2303
- }
2304
- get status() {
2305
- return this.#status;
2306
- }
2307
- get value() {
2308
- return this.#value;
2309
- }
2310
- get error() {
2311
- return this.#error;
2312
- }
2313
- async run() {
2314
- this.#status = "running";
2315
- try {
2316
- const result = await this.#runFn(this.#signal);
2317
- this.#value = result;
2318
- this.#status = "done";
2319
- return result;
2320
- } catch (e) {
2321
- this.#error = e;
2322
- this.#status = "error";
2323
- throw e;
2324
- }
2325
- }
2326
- abort() {
2327
- this.#abortController.abort();
2328
- }
2329
- };
2330
- /**
2331
- * Runs tasks concurrently, deduplicated by task id.
2332
- *
2333
- * If a task with a given id is already in flight, subsequent schedule() calls
2334
- * for that id are silently ignored until the first completes. Tasks are stored
2335
- * so abortAll() can cancel any in-flight work (e.g. on engine cleanup).
2336
- */
2337
- var ConcurrentRunner = class {
2338
- #pending = /* @__PURE__ */ new Map();
2339
- schedule(task) {
2340
- if (this.#pending.has(task.id)) return;
2341
- this.#pending.set(task.id, task);
2342
- task.run().catch((error) => {
2343
- if (!(error instanceof Error && error.name === "AbortError")) throw error;
2344
- }).finally(() => {
2345
- this.#pending.delete(task.id);
2346
- });
2347
- }
2348
- abortAll() {
2349
- for (const task of this.#pending.values()) task.abort();
2350
- this.#pending.clear();
2351
- }
2352
- };
2353
- /**
2354
- * Runs tasks one at a time in submission order.
2355
- *
2356
- * Each schedule() call returns a Promise that resolves or rejects with the
2357
- * task's result when it is eventually executed. Tasks wait in queue until the
2358
- * prior task completes.
2359
- *
2360
- * Serialization is achieved by chaining each task's run() onto the tail of a
2361
- * shared promise chain — no explicit queue or drain loop needed.
2362
- *
2363
- * abortAll() aborts all pending (not yet started) tasks and the currently
2364
- * in-flight task. Pending tasks still run briefly but receive an aborted
2365
- * signal and are expected to exit early.
2366
- */
2367
- var SerialRunner = class {
2368
- #chain = Promise.resolve();
2369
- #pending = /* @__PURE__ */ new Set();
2370
- #current = null;
2371
- schedule(task) {
2372
- const t = task;
2373
- this.#pending.add(t);
2374
- const result = this.#chain.then(() => {
2375
- this.#pending.delete(t);
2376
- this.#current = t;
2377
- return task.run();
2378
- }).finally(() => {
2379
- this.#current = null;
2380
- });
2381
- this.#chain = result.then(() => {}, () => {});
2382
- return result;
2383
- }
2384
- abortAll() {
2385
- for (const task of this.#pending) task.abort();
2386
- this.#pending.clear();
2387
- this.#current?.abort();
2388
- }
2389
- destroy() {
2390
- this.abortAll();
2391
- }
2392
- };
2393
-
2394
- //#endregion
2395
- //#region src/core/features/resolve-track.ts
2396
- function canResolve(state, config) {
2397
- const track = getSelectedTrack(state, config.type);
2398
- if (!track) return false;
2399
- return !isResolvedTrack(track);
2400
- }
2401
- /**
2402
- * Determines if track resolution conditions are met.
2403
- *
2404
- * Currently always returns true - conditions are checked by canResolveTrack()
2405
- * and resolving flag. Kept as placeholder for future conditional logic.
2406
- *
2407
- * @param state - Current track resolution state
2408
- * @param event - Current action/event
2409
- * @returns true (conditions checked elsewhere)
2410
- */
2411
- function shouldResolve(_state, _event) {
2412
- return true;
2413
- }
2414
- /**
2415
- * Updates a track within a presentation (immutably).
2416
- * Generic - works for video, audio, or text tracks.
2417
- */
2418
- function updateTrackInPresentation(presentation, resolvedTrack) {
2419
- const trackId = resolvedTrack.id;
2420
- return {
2421
- ...presentation,
2422
- selectionSets: presentation.selectionSets.map((selectionSet) => ({
2423
- ...selectionSet,
2424
- switchingSets: selectionSet.switchingSets.map((switchingSet) => ({
2425
- ...switchingSet,
2426
- tracks: switchingSet.tracks.map((track) => track.id === trackId ? resolvedTrack : track)
2427
- }))
2428
- }))
2429
- };
2430
- }
2431
- /**
2432
- * Resolves unresolved tracks using reactive composition.
2433
- *
2434
- * The subscribe closure is pure scheduling logic: it checks conditions and
2435
- * creates a Task for the selected track when appropriate. The ConcurrentRunner
2436
- * handles all concurrency concerns — deduplication, parallel execution, and
2437
- * cleanup.
2438
- *
2439
- * Generic version that works for video, audio, or text tracks based on config.
2440
- * Type parameter T is inferred from config.type (use 'as const' for inference).
2441
- */
2442
- function resolveTrack({ state, events }, config) {
2443
- const runner = new ConcurrentRunner();
2444
- const cleanup = combineLatest([state, events]).subscribe(([currentState, event]) => {
2445
- if (!canResolve(currentState, config) || !shouldResolve(currentState, event)) return;
2446
- const track = getSelectedTrack(currentState, config.type);
2447
- if (!track) return;
2448
- const resolvedTrack = track;
2449
- runner.schedule(new Task(async (signal) => {
2450
- const mediaTrack = parseMediaPlaylist(await getResponseText(await fetchResolvable(resolvedTrack, { signal })), resolvedTrack);
2451
- const latestPresentation = state.current.presentation;
2452
- const updatedPresentation = updateTrackInPresentation(latestPresentation, mediaTrack);
2453
- state.patch({ presentation: updatedPresentation });
2454
- }, { id: track.id }));
2455
- });
2456
- return () => {
2457
- runner.abortAll();
2458
- cleanup();
2459
- };
2460
- }
2461
-
2462
- //#endregion
2463
- //#region src/core/features/select-tracks.ts
2464
- /**
2465
- * Pick text track to activate.
2466
- *
2467
- * Selection priority (if enabled):
2468
- * 1. User preference (preferredSubtitleLanguage)
2469
- * 2. DEFAULT track (if enableDefaultTrack is true and track has DEFAULT=YES + AUTOSELECT=YES)
2470
- * 3. No auto-selection (user opt-in)
2471
- *
2472
- * By default, FORCED tracks are excluded per Apple's HLS spec.
2473
- *
2474
- * @param presentation - Presentation with text tracks
2475
- * @param config - Selection configuration
2476
- * @returns Track ID or undefined (no auto-selection)
2477
- */
2478
- function pickTextTrack(presentation, config) {
2479
- const textSet = presentation.selectionSets.find((set) => set.type === "text");
2480
- if (!textSet?.switchingSets?.[0]?.tracks.length) return void 0;
2481
- const tracks = textSet.switchingSets[0].tracks;
2482
- const availableTracks = config.includeForcedTracks ? tracks : tracks.filter((track) => !track.forced);
2483
- if (availableTracks.length === 0) return void 0;
2484
- const { preferredSubtitleLanguage, enableDefaultTrack = false } = config;
2485
- if (preferredSubtitleLanguage) {
2486
- const languageMatch = availableTracks.find((track) => track.language === preferredSubtitleLanguage);
2487
- if (languageMatch) return languageMatch.id;
2488
- }
2489
- if (enableDefaultTrack) {
2490
- const defaultTrack = availableTracks.find((track) => track.default === true);
2491
- if (defaultTrack) return defaultTrack.id;
2492
- }
2493
- }
2494
- /**
2495
- * Check if we can select a track of the given type.
2496
- *
2497
- * Returns true when:
2498
- * - Presentation exists
2499
- * - Has tracks of the specified type
2500
- *
2501
- * Generic over track type - works for video, audio, or text.
2502
- */
2503
- function canSelectTrack(state, config) {
2504
- return !!state?.presentation?.selectionSets?.find(({ type }) => type === config.type)?.switchingSets?.[0]?.tracks.length;
2505
- }
2506
- /**
2507
- * Check if we should select a track of the given type.
2508
- *
2509
- * Returns true when:
2510
- * - Track of this type is not already selected
2511
- *
2512
- * Generic over track type - works for video, audio, or text.
2513
- *
2514
- * @TODO figure out reactive model for ABR cases - right now we're only selecting
2515
- * if we have nothing selected (CJP)
2516
- */
2517
- function shouldSelectTrack(state, config) {
2518
- return !state[SelectedTrackIdKeyByType[config.type]];
2519
- }
2520
- /**
2521
- * Select video track orchestration.
2522
- *
2523
- * Selects video track when:
2524
- * - Presentation exists
2525
- * - No video track is selected yet
2526
- *
2527
- * Uses bandwidth-based quality selection algorithm.
2528
- *
2529
- * @example
2530
- * const cleanup = selectVideoTrack(
2531
- * { state, owners, events },
2532
- * { initialBandwidth: 2_000_000 }
2533
- * );
2534
- */
2535
- function selectVideoTrack({ state }, config = { type: "video" }) {
2536
- let selecting = false;
2537
- return state.subscribe(async (currentState) => {
2538
- if (!canSelectTrack(currentState, config) || !shouldSelectTrack(currentState, config) || selecting) return;
2539
- try {
2540
- selecting = true;
2541
- const selectedTrackId = currentState.presentation?.selectionSets.find(({ type }) => type === config.type)?.switchingSets[0]?.tracks[0]?.id;
2542
- if (selectedTrackId) {
2543
- const selectedTrackKey = SelectedTrackIdKeyByType[config.type];
2544
- state.patch({ [selectedTrackKey]: selectedTrackId });
2545
- }
2546
- } finally {
2547
- selecting = false;
2548
- }
2549
- });
2550
- }
2551
- /**
2552
- * Select audio track orchestration.
2553
- *
2554
- * Selects audio track when:
2555
- * - Presentation exists
2556
- * - No audio track is selected yet
2557
- *
2558
- * Uses language and preference-based selection.
2559
- *
2560
- * @example
2561
- * const cleanup = selectAudioTrack(
2562
- * { state, owners, events },
2563
- * { preferredAudioLanguage: 'en' }
2564
- * );
2565
- */
2566
- function selectAudioTrack({ state }, config = { type: "audio" }) {
2567
- let selecting = false;
2568
- return state.subscribe(async (currentState) => {
2569
- if (!canSelectTrack(currentState, config) || !shouldSelectTrack(currentState, config) || selecting) return;
2570
- try {
2571
- selecting = true;
2572
- const selectedTrackId = currentState.presentation?.selectionSets.find(({ type }) => type === "audio")?.switchingSets[0]?.tracks[0]?.id;
2573
- if (selectedTrackId) state.patch({ selectedAudioTrackId: selectedTrackId });
2574
- } finally {
2575
- selecting = false;
2576
- }
2577
- });
2578
- }
2579
- /**
2580
- * Select text track orchestration.
2581
- *
2582
- * Selects text track when:
2583
- * - Presentation exists
2584
- * - No text track is selected yet
2585
- *
2586
- * Note: Currently does not auto-select (user opt-in).
2587
- *
2588
- * @example
2589
- * const cleanup = selectTextTrack({ state, owners, events }, {});
2590
- */
2591
- function selectTextTrack({ state }, config = { type: "text" }) {
2592
- let selecting = false;
2593
- return state.subscribe(async (currentState) => {
2594
- if (!canSelectTrack(currentState, config) || !shouldSelectTrack(currentState, config) || selecting) return;
2595
- try {
2596
- selecting = true;
2597
- const selectedTextTrackId = pickTextTrack(currentState.presentation, config);
2598
- if (selectedTextTrackId) state.patch({ selectedTextTrackId });
2599
- } finally {
2600
- selecting = false;
2601
- }
2602
- });
2603
- }
2604
-
2605
- //#endregion
2606
- //#region src/dom/features/end-of-stream.ts
2607
- /**
2608
- * Check if the last segment of a track has been appended to a SourceBuffer.
2609
- *
2610
- * Checks by segment ID rather than a pipeline flag, so it is robust across
2611
- * quality switches (different tracks have different segment IDs) and
2612
- * back-buffer flushes (flushed segment IDs are removed from the model).
2613
- */
2614
- function isLastSegmentAppended(segments, actor) {
2615
- if (segments.length === 0) return true;
2616
- const lastSeg = segments[segments.length - 1];
2617
- if (!lastSeg) return false;
2618
- return actor?.snapshot.context.segments.some((s) => s.id === lastSeg.id && !s.partial) ?? false;
2619
- }
2620
- /**
2621
- * Check if the last segment has been appended for each selected track.
2622
- *
2623
- * Handles video-only, audio-only, and video+audio scenarios.
2624
- * A track with no segments (e.g. unresolved) is considered not ready.
2625
- */
2626
- function hasLastSegmentLoaded(state, owners) {
2627
- const videoTrack = state.selectedVideoTrackId ? getSelectedTrack(state, "video") : void 0;
2628
- const audioTrack = state.selectedAudioTrackId ? getSelectedTrack(state, "audio") : void 0;
2629
- if (videoTrack && !isResolvedTrack(videoTrack)) return false;
2630
- if (audioTrack && !isResolvedTrack(audioTrack)) return false;
2631
- if (videoTrack && isResolvedTrack(videoTrack)) {
2632
- if (!isLastSegmentAppended(videoTrack.segments, owners.videoBufferActor)) return false;
2633
- }
2634
- if (audioTrack && isResolvedTrack(audioTrack)) {
2635
- if (!isLastSegmentAppended(audioTrack.segments, owners.audioBufferActor)) return false;
2636
- }
2637
- return true;
2638
- }
2639
- /**
2640
- * Check if we can call endOfStream.
2641
- */
2642
- function canEndStream(state, owners) {
2643
- return !!(owners.mediaSource && state.presentation);
2644
- }
2645
- /**
2646
- * Check if we should call endOfStream.
2647
- */
2648
- function shouldEndStream(state, owners) {
2649
- if (!canEndStream(state, owners)) return false;
2650
- const { mediaSource, mediaElement } = owners;
2651
- if (mediaSource.readyState !== "open") return false;
2652
- if (mediaElement && mediaElement.readyState < HTMLMediaElement.HAVE_METADATA) return false;
2653
- const hasVideoTrack = !!state.selectedVideoTrackId;
2654
- const hasAudioTrack = !!state.selectedAudioTrackId;
2655
- if (hasVideoTrack && !owners.videoBuffer) return false;
2656
- if (hasAudioTrack && !owners.audioBuffer) return false;
2657
- if (owners.videoBufferActor?.snapshot.status === "updating") return false;
2658
- if (owners.audioBufferActor?.snapshot.status === "updating") return false;
2659
- if (!hasLastSegmentLoaded(state, owners)) return false;
2660
- if (mediaElement) {
2661
- const videoTrack = hasVideoTrack ? getSelectedTrack(state, "video") : void 0;
2662
- const audioTrack = hasAudioTrack ? getSelectedTrack(state, "audio") : void 0;
2663
- const refTrack = videoTrack && isResolvedTrack(videoTrack) ? videoTrack : audioTrack && isResolvedTrack(audioTrack) ? audioTrack : void 0;
2664
- if (refTrack && refTrack.segments.length > 0) {
2665
- const lastSeg = refTrack.segments[refTrack.segments.length - 1];
2666
- if (mediaElement.currentTime < lastSeg.startTime) return false;
2667
- }
2668
- }
2669
- return true;
2670
- }
2671
- /**
2672
- * Wait for all currently-updating SourceBufferActors to finish.
2673
- * Uses actor status rather than raw SourceBuffer.updating so the wait is
2674
- * aligned with the same abstraction that owns all buffer operations.
2675
- */
2676
- function waitForSourceBuffersReady$1(owners) {
2677
- const updatingActors = [owners.videoBufferActor, owners.audioBufferActor].filter((actor) => actor !== void 0 && actor.snapshot.status === "updating");
2678
- if (updatingActors.length === 0) return Promise.resolve();
2679
- return Promise.all(updatingActors.map((actor) => new Promise((resolve) => {
2680
- const unsub = actor.subscribe((snapshot) => {
2681
- if (snapshot.status !== "updating") {
2682
- unsub();
2683
- resolve();
2684
- }
2685
- });
2686
- }))).then(() => void 0);
2687
- }
2688
- /**
2689
- * Get the highest buffered end time across all active SourceBuffers.
2690
- * Used to set the final duration from actual container timestamps rather
2691
- * than playlist metadata, which handles both shorter and longer cases.
2692
- */
2693
- function getMaxBufferedEnd$1(owners) {
2694
- let max = 0;
2695
- for (const buf of [owners.videoBuffer, owners.audioBuffer]) if (buf && buf.buffered.length > 0) {
2696
- const end = buf.buffered.end(buf.buffered.length - 1);
2697
- if (end > max) max = end;
2698
- }
2699
- return max;
2700
- }
2701
- /**
2702
- * End of stream task (module-level, pure).
2703
- * Sets the final duration from actual buffered end time, then calls endOfStream().
2704
- */
2705
- const endOfStreamTask = async ({ currentOwners }, _context) => {
2706
- const { mediaSource } = currentOwners;
2707
- if (mediaSource.readyState === "ended") return;
2708
- await waitForSourceBuffersReady$1(currentOwners);
2709
- if (mediaSource.readyState !== "open") return;
2710
- const bufferedEnd = getMaxBufferedEnd$1(currentOwners);
2711
- if (bufferedEnd > 0) mediaSource.duration = bufferedEnd;
2712
- mediaSource.endOfStream();
2713
- await new Promise((resolve) => requestAnimationFrame(resolve));
2714
- };
2715
- /**
2716
- * Call endOfStream when the last segment has been appended.
2717
- * This signals to the browser that the stream is complete.
2718
- *
2719
- * Per the MSE spec, appendBuffer() remains valid after endOfStream() —
2720
- * seeks that require re-appending earlier segments will still work.
2721
- * What becomes blocked is calling endOfStream() again, addSourceBuffer(),
2722
- * and MediaSource.duration updates.
2723
- */
2724
- function endOfStream({ state, owners }) {
2725
- let hasEnded = false;
2726
- let destroyed = false;
2727
- const activeActorUnsubs = [];
2728
- const runEvaluate = async () => {
2729
- if (destroyed) return;
2730
- const currentState = state.current;
2731
- const currentOwners = owners.current;
2732
- if (hasEnded) {
2733
- if (currentOwners.mediaSource?.readyState !== "open") return;
2734
- hasEnded = false;
2735
- }
2736
- if (!shouldEndStream(currentState, currentOwners)) return;
2737
- hasEnded = true;
2738
- try {
2739
- await endOfStreamTask({ currentOwners }, {});
2740
- } catch (error) {
2741
- console.error("Failed to call endOfStream:", error);
2742
- }
2743
- };
2744
- const cleanupOwners = owners.subscribe((currentOwners) => {
2745
- activeActorUnsubs.forEach((u) => u());
2746
- activeActorUnsubs.length = 0;
2747
- for (const actor of [currentOwners.videoBufferActor, currentOwners.audioBufferActor]) {
2748
- if (!actor) continue;
2749
- let isFirst = true;
2750
- activeActorUnsubs.push(actor.subscribe(() => {
2751
- if (isFirst) {
2752
- isFirst = false;
2753
- return;
2754
- }
2755
- runEvaluate();
2756
- }));
2757
- }
2758
- });
2759
- const cleanupCombineLatest = combineLatest([state, owners]).subscribe(async () => runEvaluate());
2760
- return () => {
2761
- destroyed = true;
2762
- activeActorUnsubs.forEach((u) => u());
2763
- cleanupOwners();
2764
- cleanupCombineLatest();
2765
- };
2766
- }
2767
-
2768
- //#endregion
2769
- //#region src/dom/features/setup-mediasource.ts
2770
- /**
2771
- * Check if we have the minimum requirements to create MediaSource.
2772
- */
2773
- function canSetup(state, owners) {
2774
- return !isNil(owners.mediaElement) && !isNil(state.presentation?.url);
2775
- }
2776
- /**
2777
- * Check if we should proceed with MediaSource creation.
2778
- * Placeholder for future conditions (e.g., checking if already created).
2779
- */
2780
- function shouldSetup(_state, owners) {
2781
- return isNil(owners.mediaSource);
2782
- }
2783
- /**
2784
- * Setup MediaSource orchestration.
2785
- *
2786
- * Creates and attaches MediaSource when:
2787
- * - mediaElement exists in owners
2788
- * - presentation.url exists in state
2789
- *
2790
- * Updates owners.mediaSource after successful setup.
2791
- */
2792
- function setupMediaSource({ state, owners }) {
2793
- let settingUp = false;
2794
- let abortController = null;
2795
- const unsubscribe = combineLatest([state, owners]).subscribe(async ([currentState, currentOwners]) => {
2796
- if (!canSetup(currentState, currentOwners) || !shouldSetup(currentState, currentOwners) || settingUp) return;
2797
- try {
2798
- settingUp = true;
2799
- abortController = new AbortController();
2800
- const mediaSource = createMediaSource({ preferManaged: true });
2801
- attachMediaSource(mediaSource, currentOwners.mediaElement);
2802
- await waitForSourceOpen(mediaSource, abortController.signal);
2803
- owners.patch({ mediaSource });
2804
- } catch (error) {
2805
- if (error instanceof DOMException && error.name === "AbortError") return;
2806
- throw error;
2807
- } finally {
2808
- settingUp = false;
2809
- }
2810
- });
2811
- return () => {
2812
- abortController?.abort();
2813
- unsubscribe();
2814
- };
2815
- }
2816
-
2817
- //#endregion
2818
- //#region src/dom/media/source-buffer-actor.ts
2819
- /**
2820
- * Thrown when a message is sent to the actor in a state that does not
2821
- * accept messages (currently: 'updating').
2822
- */
2823
- var SourceBufferActorError = class extends Error {
2824
- constructor(message) {
2825
- super(message);
2826
- this.name = "SourceBufferActorError";
2827
- }
2828
- };
2829
- function snapshotBuffered(buffered) {
2830
- const ranges = [];
2831
- for (let i = 0; i < buffered.length; i++) ranges.push({
2832
- start: buffered.start(i),
2833
- end: buffered.end(i)
2834
- });
2835
- return ranges;
2836
- }
2837
- function appendInitTask(message, { signal, getCtx, sourceBuffer }) {
2838
- return new Task(async (taskSignal) => {
2839
- const ctx = getCtx();
2840
- if (taskSignal.aborted) return ctx;
2841
- await appendSegment(sourceBuffer, message.data);
2842
- return {
2843
- ...ctx,
2844
- initTrackId: message.meta.trackId
2845
- };
2846
- }, { signal });
2847
- }
2848
- function appendSegmentTask(message, { signal, getCtx, sourceBuffer, onPartialContext }) {
2849
- return new Task(async (taskSignal) => {
2850
- const ctx = getCtx();
2851
- if (taskSignal.aborted) return ctx;
2852
- const { meta } = message;
2853
- const EPSILON = 1e-4;
2854
- const filtered = ctx.segments.filter((s) => Math.abs(s.startTime - meta.startTime) >= EPSILON);
2855
- if (!(message.data instanceof ArrayBuffer)) onPartialContext({
2856
- ...ctx,
2857
- segments: [...filtered, {
2858
- id: meta.id,
2859
- startTime: meta.startTime,
2860
- duration: meta.duration,
2861
- trackId: meta.trackId,
2862
- ...meta.trackBandwidth !== void 0 && { trackBandwidth: meta.trackBandwidth },
2863
- partial: true
2864
- }],
2865
- bufferedRanges: ctx.bufferedRanges
2866
- });
2867
- await appendSegment(sourceBuffer, message.data, taskSignal);
2868
- return {
2869
- ...ctx,
2870
- segments: [...filtered, {
2871
- id: meta.id,
2872
- startTime: meta.startTime,
2873
- duration: meta.duration,
2874
- trackId: meta.trackId,
2875
- ...meta.trackBandwidth !== void 0 && { trackBandwidth: meta.trackBandwidth }
2876
- }],
2877
- bufferedRanges: snapshotBuffered(sourceBuffer.buffered)
2878
- };
2879
- }, { signal });
2880
- }
2881
- function removeTask(message, { signal, getCtx, sourceBuffer }) {
2882
- return new Task(async (taskSignal) => {
2883
- const ctx = getCtx();
2884
- if (taskSignal.aborted) return ctx;
2885
- await flushBuffer(sourceBuffer, message.start, message.end);
2886
- const bufferedRanges = snapshotBuffered(sourceBuffer.buffered);
2887
- const filtered = ctx.segments.filter((s) => {
2888
- const midpoint = s.startTime + s.duration / 2;
2889
- return bufferedRanges.some((r) => midpoint >= r.start && midpoint < r.end);
2890
- });
2891
- return {
2892
- ...ctx,
2893
- segments: filtered,
2894
- bufferedRanges
2895
- };
2896
- }, { signal });
2897
- }
2898
- const messageTaskFactories = {
2899
- "append-init": appendInitTask,
2900
- "append-segment": appendSegmentTask,
2901
- remove: removeTask
2902
- };
2903
- function messageToTask(message, options) {
2904
- const factory = messageTaskFactories[message.type];
2905
- return factory(message, options);
2906
- }
2907
- function createSourceBufferActor(sourceBuffer, initialContext) {
2908
- const state = createState({
2909
- status: "idle",
2910
- context: {
2911
- segments: [],
2912
- bufferedRanges: [],
2913
- initTrackId: void 0,
2914
- ...initialContext
2915
- }
2916
- });
2917
- const runner = new SerialRunner();
2918
- function applyResult(newContext) {
2919
- const status = state.current.status === "destroyed" ? "destroyed" : "idle";
2920
- state.patch({
2921
- status,
2922
- context: newContext
2923
- });
2924
- state.flush();
2925
- }
2926
- function handleError(e) {
2927
- const status = state.current.status === "destroyed" ? "destroyed" : "idle";
2928
- state.patch({ status });
2929
- state.flush();
2930
- throw e;
2931
- }
2932
- return {
2933
- get snapshot() {
2934
- return state.current;
2935
- },
2936
- subscribe(listener) {
2937
- return state.subscribe(listener);
2938
- },
2939
- send(message, signal) {
2940
- if (state.current.status !== "idle") return Promise.reject(new SourceBufferActorError(`send() called while actor is ${state.current.status}`));
2941
- state.patch({ status: "updating" });
2942
- const onPartialContext = (ctx) => {
2943
- state.patch({
2944
- status: "updating",
2945
- context: ctx
2946
- });
2947
- state.flush();
2948
- };
2949
- const task = messageToTask(message, {
2950
- signal,
2951
- getCtx: () => state.current.context,
2952
- sourceBuffer,
2953
- onPartialContext
2954
- });
2955
- return runner.schedule(task).then(applyResult).catch(handleError);
2956
- },
2957
- batch(messages, signal) {
2958
- if (state.current.status !== "idle") return Promise.reject(new SourceBufferActorError(`batch() called while actor is ${state.current.status}`));
2959
- if (messages.length === 0) return Promise.resolve();
2960
- state.patch({ status: "updating" });
2961
- let workingCtx = state.current.context;
2962
- const onPartialContext = (ctx) => {
2963
- state.patch({
2964
- status: "updating",
2965
- context: ctx
2966
- });
2967
- state.flush();
2968
- };
2969
- for (const message of messages.slice(0, -1)) {
2970
- const task = messageToTask(message, {
2971
- signal,
2972
- getCtx: () => workingCtx,
2973
- sourceBuffer,
2974
- onPartialContext
2975
- });
2976
- runner.schedule(task).then((newCtx) => {
2977
- workingCtx = newCtx;
2978
- });
2979
- }
2980
- const lastTask = messageToTask(messages[messages.length - 1], {
2981
- signal,
2982
- getCtx: () => workingCtx,
2983
- sourceBuffer,
2984
- onPartialContext
2985
- });
2986
- return runner.schedule(lastTask).then(applyResult).catch(handleError);
2987
- },
2988
- destroy() {
2989
- state.patch({ status: "destroyed" });
2990
- state.flush();
2991
- runner.destroy();
2992
- }
2993
- };
2994
- }
2995
-
2996
- //#endregion
2997
- //#region src/dom/features/setup-sourcebuffer.ts
2998
- /**
2999
- * Build MIME codec string from track metadata.
3000
- *
3001
- * @param track - Resolved track with mimeType and codecs
3002
- * @returns MIME codec string (e.g., 'video/mp4; codecs="avc1.42E01E,mp4a.40.2"')
3003
- *
3004
- * @example
3005
- * buildMimeCodec({ mimeType: 'video/mp4', codecs: ['avc1.42E01E'] })
3006
- * // => 'video/mp4; codecs="avc1.42E01E"'
3007
- */
3008
- function buildMimeCodec(track) {
3009
- const codecString = track.codecs?.join(",") ?? "";
3010
- return `${track.mimeType}; codecs="${codecString}"`;
3011
- }
3012
- /**
3013
- * Setup all needed SourceBuffers as a single coordinated operation.
3014
- *
3015
- * Waits until ALL selected tracks (video and/or audio) are resolved with
3016
- * codecs, then creates every SourceBuffer in one synchronous block before
3017
- * patching owners. This guarantees that downstream consumers (e.g.
3018
- * loadSegments) never see a partial set of SourceBuffers — preventing the
3019
- * Firefox bug where appending to a video SourceBuffer before the audio
3020
- * SourceBuffer exists causes mozHasAudio to be permanently false.
3021
- *
3022
- * Handles video-only, audio-only, and combined presentations correctly:
3023
- * only the tracks that are actually selected are waited on and created.
3024
- *
3025
- * @example
3026
- * const cleanup = setupSourceBuffers({ state, owners });
3027
- */
3028
- function setupSourceBuffers({ state, owners }) {
3029
- let setupDone = false;
3030
- return combineLatest([state, owners]).subscribe(async ([currentState, currentOwners]) => {
3031
- if (setupDone) return;
3032
- if (!currentOwners.mediaSource) return;
3033
- const videoSelected = !!currentState.selectedVideoTrackId;
3034
- const audioSelected = !!currentState.selectedAudioTrackId;
3035
- if (!videoSelected && !audioSelected) return;
3036
- const videoTrack = videoSelected ? getSelectedTrack(currentState, "video") : null;
3037
- const audioTrack = audioSelected ? getSelectedTrack(currentState, "audio") : null;
3038
- if (videoSelected && (!videoTrack || !isResolvedTrack(videoTrack) || !videoTrack.codecs?.length)) return;
3039
- if (audioSelected && (!audioTrack || !isResolvedTrack(audioTrack) || !audioTrack.codecs?.length)) return;
3040
- setupDone = true;
3041
- const patch = {};
3042
- if (videoSelected && videoTrack && isResolvedTrack(videoTrack)) {
3043
- const buffer = createSourceBuffer(currentOwners.mediaSource, buildMimeCodec(videoTrack));
3044
- patch.videoBuffer = buffer;
3045
- patch.videoBufferActor = createSourceBufferActor(buffer);
3046
- }
3047
- if (audioSelected && audioTrack && isResolvedTrack(audioTrack)) {
3048
- const buffer = createSourceBuffer(currentOwners.mediaSource, buildMimeCodec(audioTrack));
3049
- patch.audioBuffer = buffer;
3050
- patch.audioBufferActor = createSourceBufferActor(buffer);
3051
- }
3052
- owners.patch(patch);
3053
- await new Promise((resolve) => requestAnimationFrame(resolve));
3054
- });
3055
- }
3056
-
3057
- //#endregion
3058
- //#region src/dom/features/setup-text-tracks.ts
3059
- /**
3060
- * Get all text tracks from presentation.
3061
- */
3062
- function getTextTracks(presentation) {
3063
- if (!presentation?.selectionSets) return [];
3064
- const textSet = presentation.selectionSets.find((set) => set.type === "text");
3065
- if (!textSet?.switchingSets?.[0]?.tracks) return [];
3066
- return textSet.switchingSets[0].tracks;
3067
- }
3068
- /**
3069
- * Check if we can setup text tracks.
3070
- *
3071
- * Requires:
3072
- * - mediaElement exists
3073
- * - presentation has text tracks to setup
3074
- */
3075
- function canSetupTextTracks(state, owners) {
3076
- return !!owners.mediaElement && !!getTextTracks(state.presentation).length;
3077
- }
3078
- /**
3079
- * Check if we should setup text tracks (not already set up).
3080
- */
3081
- function shouldSetupTextTracks(owners) {
3082
- return !owners.textTracks;
3083
- }
3084
- /**
3085
- * Create a track element for a text track.
3086
- *
3087
- * Note: We use DOM <track> elements instead of the TextTrack JS API
3088
- * because there's no way to remove TextTracks added via addTextTrack().
3089
- */
3090
- function createTrackElement(track) {
3091
- const trackElement = document.createElement("track");
3092
- trackElement.id = track.id;
3093
- trackElement.kind = track.kind;
3094
- trackElement.label = track.label;
3095
- if (track.language) trackElement.srclang = track.language;
3096
- if (track.default) trackElement.default = true;
3097
- trackElement.src = track.url;
3098
- return trackElement;
3099
- }
3100
- /**
3101
- * Setup text tracks orchestration.
3102
- *
3103
- * Triggers when:
3104
- * - mediaElement exists
3105
- * - presentation is resolved (has text tracks)
3106
- *
3107
- * Creates <track> elements for all text tracks and adds them as children
3108
- * to the media element. This allows the browser's native text track rendering.
3109
- *
3110
- * Note: Uses DOM track elements instead of TextTrack API because tracks
3111
- * added via addTextTrack() cannot be removed.
3112
- *
3113
- * @example
3114
- * const cleanup = setupTextTracks({ state, owners });
3115
- */
3116
- function setupTextTracks({ state, owners }) {
3117
- let hasSetup = false;
3118
- let createdTracks = [];
3119
- const unsubscribe = combineLatest([state, owners]).subscribe(([s, o]) => {
3120
- if (hasSetup) return;
3121
- if (!canSetupTextTracks(s, o) || !shouldSetupTextTracks(o)) return;
3122
- hasSetup = true;
3123
- const textTracks = getTextTracks(s.presentation);
3124
- if (textTracks.length === 0) return;
3125
- const trackMap = /* @__PURE__ */ new Map();
3126
- for (const track of textTracks) {
3127
- const trackElement = createTrackElement(track);
3128
- o.mediaElement.appendChild(trackElement);
3129
- trackMap.set(track.id, trackElement);
3130
- createdTracks.push(trackElement);
3131
- }
3132
- owners.patch({ textTracks: trackMap });
3133
- });
3134
- return () => {
3135
- for (const trackElement of createdTracks) trackElement.remove();
3136
- createdTracks = [];
3137
- unsubscribe();
3138
- };
3139
- }
3140
-
3141
- //#endregion
3142
- //#region src/dom/features/sync-selected-text-track-from-dom.ts
3143
- /**
3144
- * Sync selectedTextTrackId from DOM text track mode changes.
3145
- *
3146
- * Listens to the `change` event on `media.textTracks` and updates
3147
- * `selectedTextTrackId` when external code (e.g. the captions button via
3148
- * `toggleSubtitles()`) changes a subtitle/caption track mode to 'showing'.
3149
- *
3150
- * This bridges the core store's `toggleSubtitles()` with SPF's reactive text
3151
- * track pipeline (`syncTextTrackModes`, `loadTextTrackCues`). Without this
3152
- * bridge, direct DOM mode changes would be immediately overridden by
3153
- * `syncTextTrackModes` on the next SPF state update.
3154
- *
3155
- * When a subtitle/caption track's mode is 'showing', its DOM `id` — which
3156
- * matches the SPF track ID set by `setupTextTracks` — is written to
3157
- * `selectedTextTrackId`. When no subtitle/caption track is 'showing',
3158
- * `selectedTextTrackId` is cleared along with the deselected track's
3159
- * `textBufferState` entry — setting mode to 'disabled' clears native cues from
3160
- * the track element, so the buffer must be reset to re-fetch cues on re-enable.
3161
- *
3162
- * @example
3163
- * const cleanup = syncSelectedTextTrackFromDom({ state, owners });
3164
- */
3165
- function syncSelectedTextTrackFromDom({ state, owners }) {
3166
- let lastMediaElement;
3167
- let removeListener = null;
3168
- const unsubscribe = owners.subscribe((currentOwners) => {
3169
- const { mediaElement } = currentOwners;
3170
- if (mediaElement === lastMediaElement) return;
3171
- removeListener?.();
3172
- removeListener = null;
3173
- lastMediaElement = mediaElement;
3174
- if (!mediaElement) return;
3175
- const sync = () => {
3176
- const newId = Array.from(mediaElement.textTracks).find((t) => t.mode === "showing" && (t.kind === "subtitles" || t.kind === "captions"))?.id || void 0;
3177
- const current = state.current;
3178
- if (current.selectedTextTrackId === newId) return;
3179
- if (newId) state.patch({ selectedTextTrackId: newId });
3180
- else {
3181
- const prevId = current.selectedTextTrackId;
3182
- if (prevId && current.textBufferState?.[prevId]) {
3183
- const next = { ...current.textBufferState };
3184
- delete next[prevId];
3185
- state.patch({
3186
- selectedTextTrackId: void 0,
3187
- textBufferState: next
3188
- });
3189
- } else state.patch({ selectedTextTrackId: void 0 });
3190
- }
3191
- };
3192
- removeListener = listen(mediaElement.textTracks, "change", sync);
3193
- });
3194
- return () => {
3195
- removeListener?.();
3196
- unsubscribe();
3197
- };
3198
- }
3199
-
3200
- //#endregion
3201
- //#region src/dom/features/sync-text-track-modes.ts
3202
- /**
3203
- * Check if we can sync text track modes.
3204
- *
3205
- * Requires:
3206
- * - textTracks map exists (track elements created)
3207
- */
3208
- function canSyncTextTrackModes(owners) {
3209
- return !!owners.textTracks && owners.textTracks.size > 0;
3210
- }
3211
- /**
3212
- * Sync text track modes orchestration.
3213
- *
3214
- * Manages track element modes based on selectedTextTrackId:
3215
- * - Selected track: mode = "showing"
3216
- * - Other tracks: mode = "hidden"
3217
- * - No selection: all tracks mode = "hidden"
3218
- *
3219
- * Note: Uses "hidden" instead of "disabled" for non-selected tracks
3220
- * so they remain available in the browser's track menu.
3221
- *
3222
- * @example
3223
- * const cleanup = syncTextTrackModes({ state, owners });
3224
- */
3225
- function syncTextTrackModes({ state, owners }) {
3226
- return combineLatest([state, owners]).subscribe(([s, o]) => {
3227
- if (!canSyncTextTrackModes(o)) return;
3228
- const selectedId = s.selectedTextTrackId;
3229
- for (const [trackId, trackElement] of o.textTracks) if (trackId === selectedId) trackElement.track.mode = "showing";
3230
- else trackElement.track.mode = "hidden";
3231
- });
3232
- }
3233
-
3234
- //#endregion
3235
- //#region src/dom/features/update-duration.ts
3236
- /**
3237
- * Check if we can update MediaSource duration (have required data).
3238
- */
3239
- function canUpdateDuration(state, owners) {
3240
- return !!(owners.mediaSource && state.presentation && hasPresentationDuration(state.presentation));
3241
- }
3242
- /**
3243
- * Get the maximum buffered end time across all SourceBuffers.
3244
- */
3245
- function getMaxBufferedEnd(owners) {
3246
- let maxEnd = 0;
3247
- const buffers = [owners.videoSourceBuffer, owners.audioSourceBuffer].filter((buf) => buf !== void 0);
3248
- for (const buffer of buffers) {
3249
- const { buffered } = buffer;
3250
- if (buffered.length > 0) {
3251
- const end = buffered.end(buffered.length - 1);
3252
- if (end > maxEnd) maxEnd = end;
3253
- }
3254
- }
3255
- return maxEnd;
3256
- }
3257
- /**
3258
- * Check if we should update MediaSource duration (conditions met).
3259
- */
3260
- function shouldUpdateDuration(state, owners) {
3261
- if (!canUpdateDuration(state, owners)) return false;
3262
- const { mediaSource } = owners;
3263
- const { presentation } = state;
3264
- if (mediaSource.readyState !== "open") return false;
3265
- const duration = presentation.duration;
3266
- if (!Number.isFinite(duration) || Number.isNaN(duration) || duration <= 0) return false;
3267
- return Number.isNaN(mediaSource.duration);
3268
- }
3269
- /**
3270
- * Wait for all currently-updating SourceBuffers to finish.
3271
- *
3272
- * The MSE spec forbids setting MediaSource.duration while any attached
3273
- * SourceBuffer has updating === true. This defers until all are idle.
3274
- */
3275
- function waitForSourceBuffersReady(owners) {
3276
- const updating = [owners.videoSourceBuffer, owners.audioSourceBuffer].filter((buf) => buf?.updating === true);
3277
- if (updating.length === 0) return Promise.resolve();
3278
- return Promise.all(updating.map((buf) => new Promise((resolve) => buf.addEventListener("updateend", () => resolve(), { once: true })))).then(() => void 0);
3279
- }
3280
- /**
3281
- * Update MediaSource duration when presentation duration becomes available.
3282
- */
3283
- function updateDuration({ state, owners }) {
3284
- let destroyed = false;
3285
- const unsubscribe = combineLatest([state, owners]).subscribe(async ([currentState, currentOwners]) => {
3286
- if (!shouldUpdateDuration(currentState, currentOwners)) return;
3287
- const { mediaSource } = currentOwners;
3288
- await waitForSourceBuffersReady(currentOwners);
3289
- if (destroyed || mediaSource.readyState !== "open") return;
3290
- let duration = currentState.presentation.duration;
3291
- const maxBufferedEnd = getMaxBufferedEnd(currentOwners);
3292
- if (maxBufferedEnd > duration) duration = maxBufferedEnd;
3293
- mediaSource.duration = duration;
3294
- });
3295
- return () => {
3296
- destroyed = true;
3297
- unsubscribe();
3298
- };
3299
- }
3300
-
3301
- //#endregion
3302
- //#region src/dom/playback-engine/engine.ts
3303
- /**
3304
- * Create a POC playback engine.
3305
- *
3306
- * Wires together all orchestrations to create a reactive playback pipeline:
3307
- * 1. Resolve presentation (multivariant playlist)
3308
- * 2. Select initial video and audio tracks
3309
- * 3. Resolve selected tracks (media playlists)
3310
- * 4. Setup MediaSource
3311
- * 5. Setup SourceBuffers for video and audio
3312
- *
3313
- * Note: This is a POC - does not yet load/append segments.
3314
- *
3315
- * @param config - Playback engine configuration
3316
- * @returns Playback engine instance with state, owners, and destroy function
3317
- *
3318
- * @example
3319
- * const engine = createPlaybackEngine({
3320
- * initialBandwidth: 2_000_000,
3321
- * preferredAudioLanguage: 'en',
3322
- * });
3323
- *
3324
- * // Initialize by patching state and owners
3325
- * engine.owners.patch({ mediaElement: document.querySelector('video') });
3326
- * engine.state.patch({
3327
- * presentation: { url: 'https://example.com/playlist.m3u8' },
3328
- * preload: 'auto',
3329
- * });
3330
- *
3331
- * // Inspect state
3332
- * console.log(engine.state.current);
3333
- *
3334
- * // Cleanup
3335
- * engine.destroy();
3336
- */
3337
- function createPlaybackEngine(config = {}) {
3338
- const state = createState({ bandwidthState: {
3339
- fastEstimate: 0,
3340
- fastTotalWeight: 0,
3341
- slowEstimate: 0,
3342
- slowTotalWeight: 0,
3343
- bytesSampled: 0
3344
- } });
3345
- const owners = createState({});
3346
- const events = createEventStream();
3347
- const cleanups = [
3348
- syncPreloadAttribute(state, owners),
3349
- trackPlaybackInitiated({
3350
- state,
3351
- owners,
3352
- events
3353
- }),
3354
- resolvePresentation({
3355
- state,
3356
- events
3357
- }),
3358
- selectVideoTrack({
3359
- state,
3360
- owners,
3361
- events
3362
- }, {
3363
- type: "video",
3364
- ...config.initialBandwidth !== void 0 && { initialBandwidth: config.initialBandwidth }
3365
- }),
3366
- selectAudioTrack({
3367
- state,
3368
- owners,
3369
- events
3370
- }, {
3371
- type: "audio",
3372
- ...config.preferredAudioLanguage !== void 0 && { preferredAudioLanguage: config.preferredAudioLanguage }
3373
- }),
3374
- selectTextTrack({
3375
- state,
3376
- owners,
3377
- events
3378
- }, {
3379
- type: "text",
3380
- ...config.preferredSubtitleLanguage !== void 0 && { preferredSubtitleLanguage: config.preferredSubtitleLanguage },
3381
- ...config.includeForcedTracks !== void 0 && { includeForcedTracks: config.includeForcedTracks },
3382
- ...config.enableDefaultTrack !== void 0 && { enableDefaultTrack: config.enableDefaultTrack }
3383
- }),
3384
- resolveTrack({
3385
- state,
3386
- events
3387
- }, { type: "video" }),
3388
- resolveTrack({
3389
- state,
3390
- events
3391
- }, { type: "audio" }),
3392
- resolveTrack({
3393
- state,
3394
- events
3395
- }, { type: "text" }),
3396
- calculatePresentationDuration({ state }),
3397
- setupMediaSource({
3398
- state,
3399
- owners
3400
- }),
3401
- updateDuration({
3402
- state,
3403
- owners
3404
- }),
3405
- setupSourceBuffers({
3406
- state,
3407
- owners
3408
- }),
3409
- trackCurrentTime({
3410
- state,
3411
- owners
3412
- }),
3413
- switchQuality({ state }),
3414
- loadSegments({
3415
- state,
3416
- owners
3417
- }, { type: "video" }),
3418
- loadSegments({
3419
- state,
3420
- owners
3421
- }, { type: "audio" }),
3422
- endOfStream({
3423
- state,
3424
- owners
3425
- }),
3426
- setupTextTracks({
3427
- state,
3428
- owners
3429
- }),
3430
- syncTextTrackModes({
3431
- state,
3432
- owners
3433
- }),
3434
- syncSelectedTextTrackFromDom({
3435
- state,
3436
- owners
3437
- }),
3438
- loadTextTrackCues({
3439
- state,
3440
- owners
3441
- })
3442
- ];
3443
- events.dispatch({ type: "@@INITIALIZE@@" });
3444
- return {
3445
- state,
3446
- owners,
3447
- events,
3448
- destroy: () => {
3449
- cleanups.forEach((cleanup) => cleanup());
3450
- destroyVttParser();
3451
- }
3452
- };
3453
- }
3454
-
3455
- //#endregion
3456
- //#region src/dom/playback-engine/adapter.ts
3457
- /**
3458
- * HTMLMediaElement-compatible adapter for the SPF playback engine.
3459
- *
3460
- * Implements the src/play() contract per the WHATWG HTML spec so that SPF can
3461
- * be used anywhere a media element API is expected.
3462
- *
3463
- * A new engine is created on every src assignment — this fully tears down all
3464
- * state, SourceBuffers, and in-flight requests from the previous source before
3465
- * the next one begins. The media element reference is preserved across src
3466
- * changes and re-applied to the new engine automatically.
3467
- *
3468
- * @example
3469
- * const media = new SpfMedia({ preferredAudioLanguage: 'en' });
3470
- * media.attach(document.querySelector('video'));
3471
- * media.src = 'https://stream.mux.com/abc123.m3u8';
3472
- *
3473
- * // Change source — old engine is destroyed, new one starts clean:
3474
- * media.src = 'https://stream.mux.com/xyz456.m3u8';
3475
- *
3476
- * // Explicit teardown:
3477
- * media.destroy();
3478
- */
3479
- var SpfMedia = class {
3480
- #engine;
3481
- #config;
3482
- /** Pending loadstart listener from a deferred play() retry, if any. */
3483
- #loadstartListener = null;
3484
- constructor(config = {}) {
3485
- this.#config = config;
3486
- this.#engine = createPlaybackEngine(config);
3487
- }
3488
- get engine() {
3489
- return this.#engine;
3490
- }
3491
- attach(mediaElement) {
3492
- this.#engine.owners.patch({ mediaElement });
3493
- }
3494
- detach() {
3495
- this.#cancelPendingPlay();
3496
- this.#engine.owners.patch({ mediaElement: void 0 });
3497
- }
3498
- destroy() {
3499
- this.#cancelPendingPlay();
3500
- this.#engine.destroy();
3501
- }
3502
- get src() {
3503
- return this.#engine.state.current.presentation?.url ?? "";
3504
- }
3505
- set src(value) {
3506
- const prevMediaElement = this.#engine.owners.current.mediaElement;
3507
- this.#cancelPendingPlay();
3508
- this.#engine.destroy();
3509
- this.#engine = createPlaybackEngine(this.#config);
3510
- if (prevMediaElement) this.#engine.owners.patch({ mediaElement: prevMediaElement });
3511
- if (value) this.#engine.state.patch({ presentation: { url: value } });
3512
- }
3513
- play() {
3514
- const { mediaElement } = this.#engine.owners.current;
3515
- if (!mediaElement) return Promise.reject(/* @__PURE__ */ new Error("SpfMedia: no media element attached"));
3516
- this.#engine.state.patch({ playbackInitiated: true });
3517
- return mediaElement.play().catch((err) => {
3518
- if (this.src) return new Promise((resolve, reject) => {
3519
- const listener = () => {
3520
- this.#loadstartListener = null;
3521
- mediaElement.play().then(resolve, reject);
3522
- };
3523
- this.#loadstartListener = listener;
3524
- mediaElement.addEventListener("loadstart", listener, { once: true });
3525
- });
3526
- throw err;
3527
- });
3528
- }
3529
- #cancelPendingPlay() {
3530
- if (!this.#loadstartListener) return;
3531
- const { mediaElement } = this.#engine.owners.current;
3532
- mediaElement?.removeEventListener("loadstart", this.#loadstartListener);
3533
- this.#loadstartListener = null;
3534
- }
3535
- };
3536
-
3537
- //#endregion
3538
- export { trackPlaybackInitiated as a, destroyVttParser as c, appendSegment as i, parseVttSegment as l, createPlaybackEngine as n, trackCurrentTime as o, flushBuffer as r, loadTextTrackCues as s, SpfMedia as t, loadSegments as u };
3539
- //# sourceMappingURL=adapter-ClnRGbQf.js.map