@videojs/spf 10.0.0-beta.23 → 10.0.0-beta.25

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 (516) hide show
  1. package/dist/default/background-video.js +3 -0
  2. package/dist/{dev/core → default/core/actors}/create-machine-actor.js +3 -3
  3. package/dist/default/core/actors/create-machine-actor.js.map +1 -0
  4. package/dist/default/core/{create-transition-actor.js → actors/create-transition-actor.js} +3 -3
  5. package/dist/default/core/actors/create-transition-actor.js.map +1 -0
  6. package/dist/default/core/composition/create-composition.js +85 -0
  7. package/dist/default/core/composition/create-composition.js.map +1 -0
  8. package/dist/default/core/composition/share-signals.js +39 -0
  9. package/dist/default/core/composition/share-signals.js.map +1 -0
  10. package/dist/{dev/core → default/core/reactors}/create-machine-reactor.js +4 -4
  11. package/dist/default/core/reactors/create-machine-reactor.js.map +1 -0
  12. package/dist/default/core/signals/primitives.js +33 -11
  13. package/dist/default/core/signals/primitives.js.map +1 -1
  14. package/dist/default/core/{task.js → tasks/task.js} +2 -2
  15. package/dist/default/core/tasks/task.js.map +1 -0
  16. package/dist/default/dom.js +9 -10
  17. package/dist/default/hls.js +5 -0
  18. package/dist/default/index.js +12 -3
  19. package/dist/default/index.js.map +1 -1
  20. package/dist/default/media/abr/quality-selection.js +21 -0
  21. package/dist/default/media/abr/quality-selection.js.map +1 -0
  22. package/dist/default/{core → media}/buffer/back-buffer.js +2 -2
  23. package/dist/default/media/buffer/back-buffer.js.map +1 -0
  24. package/dist/{dev/core → default/media}/buffer/forward-buffer.js +14 -2
  25. package/dist/default/media/buffer/forward-buffer.js.map +1 -0
  26. package/dist/default/media/dom/capabilities.js +70 -0
  27. package/dist/default/media/dom/capabilities.js.map +1 -0
  28. package/dist/{dev/dom/media → default/media/dom/mse}/append-segment.js +1 -1
  29. package/dist/default/media/dom/mse/append-segment.js.map +1 -0
  30. package/dist/default/{dom/media → media/dom/mse}/buffer-flusher.js +1 -1
  31. package/dist/default/media/dom/mse/buffer-flusher.js.map +1 -0
  32. package/dist/default/media/dom/mse/duration.js +78 -0
  33. package/dist/default/media/dom/mse/duration.js.map +1 -0
  34. package/dist/default/media/dom/mse/end-of-stream.js +20 -0
  35. package/dist/default/media/dom/mse/end-of-stream.js.map +1 -0
  36. package/dist/default/{dom/media → media/dom/mse}/mediasource-setup.js +63 -18
  37. package/dist/default/media/dom/mse/mediasource-setup.js.map +1 -0
  38. package/dist/default/{dom/text/parse-vtt-segment.js → media/dom/text/resolve-vtt-segment.js} +5 -5
  39. package/dist/default/media/dom/text/resolve-vtt-segment.js.map +1 -0
  40. package/dist/default/media/dom/text/text-track-slots.js +69 -0
  41. package/dist/default/media/dom/text/text-track-slots.js.map +1 -0
  42. package/dist/{dev/core → default/media}/hls/parse-attributes.js +17 -3
  43. package/dist/default/media/hls/parse-attributes.js.map +1 -0
  44. package/dist/{dev/core → default/media}/hls/parse-media-playlist.js +25 -2
  45. package/dist/default/media/hls/parse-media-playlist.js.map +1 -0
  46. package/dist/{dev/core → default/media}/hls/parse-multivariant.js +17 -8
  47. package/dist/default/media/hls/parse-multivariant.js.map +1 -0
  48. package/dist/default/{core → media}/hls/resolve-url.js +1 -1
  49. package/dist/default/media/hls/resolve-url.js.map +1 -0
  50. package/dist/default/media/primitives/select-tracks.js +130 -0
  51. package/dist/default/media/primitives/select-tracks.js.map +1 -0
  52. package/dist/default/media/types/index.js +36 -0
  53. package/dist/default/media/types/index.js.map +1 -0
  54. package/dist/default/media/utils/cdn.js +56 -0
  55. package/dist/default/media/utils/cdn.js.map +1 -0
  56. package/dist/default/media/utils/preload.js +22 -0
  57. package/dist/default/media/utils/preload.js.map +1 -0
  58. package/dist/default/media/utils/track-selection.js +47 -0
  59. package/dist/default/media/utils/track-selection.js.map +1 -0
  60. package/dist/default/media/utils/tracks.js +130 -0
  61. package/dist/default/media/utils/tracks.js.map +1 -0
  62. package/dist/default/{core/abr → network}/bandwidth-estimator.js +6 -5
  63. package/dist/default/network/bandwidth-estimator.js.map +1 -0
  64. package/dist/{dev/dom → default}/network/chunked-stream-iterable.js +1 -1
  65. package/dist/default/network/chunked-stream-iterable.js.map +1 -0
  66. package/dist/{dev/core/abr → default/network}/ewma.js +1 -1
  67. package/dist/default/network/ewma.js.map +1 -0
  68. package/dist/default/network/fetch.js +115 -0
  69. package/dist/default/network/fetch.js.map +1 -0
  70. package/dist/default/{dom/features/segment-loader-actor.js → playback/actors/dom/segment-loader.js} +63 -23
  71. package/dist/default/playback/actors/dom/segment-loader.js.map +1 -0
  72. package/dist/default/{dom/media/source-buffer-actor.js → playback/actors/dom/source-buffer.js} +10 -9
  73. package/dist/default/playback/actors/dom/source-buffer.js.map +1 -0
  74. package/dist/{dev/dom/features/text-tracks-actor.js → default/playback/actors/dom/text-tracks.js} +7 -3
  75. package/dist/default/playback/actors/dom/text-tracks.js.map +1 -0
  76. package/dist/default/playback/actors/text-track-segment-loader.js +135 -0
  77. package/dist/default/playback/actors/text-track-segment-loader.js.map +1 -0
  78. package/dist/default/playback/behaviors/calculate-presentation-duration.js +36 -0
  79. package/dist/default/playback/behaviors/calculate-presentation-duration.js.map +1 -0
  80. package/dist/default/playback/behaviors/derive-cdn-priority.js +68 -0
  81. package/dist/default/playback/behaviors/derive-cdn-priority.js.map +1 -0
  82. package/dist/default/playback/behaviors/dom/end-of-stream.js +90 -0
  83. package/dist/default/playback/behaviors/dom/end-of-stream.js.map +1 -0
  84. package/dist/default/playback/behaviors/dom/load-segments.js +177 -0
  85. package/dist/default/playback/behaviors/dom/load-segments.js.map +1 -0
  86. package/dist/default/playback/behaviors/dom/setup-buffer-actors.js +192 -0
  87. package/dist/default/playback/behaviors/dom/setup-buffer-actors.js.map +1 -0
  88. package/dist/default/playback/behaviors/dom/setup-mediasource.js +89 -0
  89. package/dist/default/playback/behaviors/dom/setup-mediasource.js.map +1 -0
  90. package/dist/default/playback/behaviors/dom/setup-text-track-actors.js +54 -0
  91. package/dist/default/playback/behaviors/dom/setup-text-track-actors.js.map +1 -0
  92. package/dist/default/playback/behaviors/dom/sync-text-tracks.js +124 -0
  93. package/dist/default/playback/behaviors/dom/sync-text-tracks.js.map +1 -0
  94. package/dist/default/playback/behaviors/dom/track-current-time.js +52 -0
  95. package/dist/default/playback/behaviors/dom/track-current-time.js.map +1 -0
  96. package/dist/default/playback/behaviors/dom/track-load-triggers.js +94 -0
  97. package/dist/default/playback/behaviors/dom/track-load-triggers.js.map +1 -0
  98. package/dist/default/playback/behaviors/dom/track-playback-rate.js +37 -0
  99. package/dist/default/playback/behaviors/dom/track-playback-rate.js.map +1 -0
  100. package/dist/default/playback/behaviors/dom/update-mediasource-duration.js +90 -0
  101. package/dist/default/playback/behaviors/dom/update-mediasource-duration.js.map +1 -0
  102. package/dist/default/playback/behaviors/resolve-presentation.js +85 -0
  103. package/dist/default/playback/behaviors/resolve-presentation.js.map +1 -0
  104. package/dist/default/playback/behaviors/resolve-track.js +120 -0
  105. package/dist/default/playback/behaviors/resolve-track.js.map +1 -0
  106. package/dist/default/playback/behaviors/select-tracks.js +101 -0
  107. package/dist/default/playback/behaviors/select-tracks.js.map +1 -0
  108. package/dist/default/playback/behaviors/setup-failover-monitor.js +66 -0
  109. package/dist/default/playback/behaviors/setup-failover-monitor.js.map +1 -0
  110. package/dist/default/playback/behaviors/sync-preload.js +59 -0
  111. package/dist/default/playback/behaviors/sync-preload.js.map +1 -0
  112. package/dist/default/playback/behaviors/track-switching.js +341 -0
  113. package/dist/default/playback/behaviors/track-switching.js.map +1 -0
  114. package/dist/default/playback/engines/background-video/adapter.js +158 -0
  115. package/dist/default/playback/engines/background-video/adapter.js.map +1 -0
  116. package/dist/default/playback/engines/background-video/engine.js +75 -0
  117. package/dist/default/playback/engines/background-video/engine.js.map +1 -0
  118. package/dist/default/playback/engines/hls/adapter-audio-only.js +119 -0
  119. package/dist/default/playback/engines/hls/adapter-audio-only.js.map +1 -0
  120. package/dist/default/{dom/playback-engine → playback/engines/hls}/adapter.js +40 -26
  121. package/dist/default/playback/engines/hls/adapter.js.map +1 -0
  122. package/dist/default/playback/engines/hls/engine-audio-only.js +80 -0
  123. package/dist/default/playback/engines/hls/engine-audio-only.js.map +1 -0
  124. package/dist/default/playback/engines/hls/engine.js +115 -0
  125. package/dist/default/playback/engines/hls/engine.js.map +1 -0
  126. package/dist/default/playback/primitives/failover-fetch.js +42 -0
  127. package/dist/default/playback/primitives/failover-fetch.js.map +1 -0
  128. package/dist/default/playback/primitives/track-types.js +61 -0
  129. package/dist/default/playback/primitives/track-types.js.map +1 -0
  130. package/dist/dev/background-video.d.ts +3 -0
  131. package/dist/dev/background-video.js +3 -0
  132. package/dist/dev/core/{actor.d.ts → actors/actor.d.ts} +2 -2
  133. package/dist/dev/core/actors/actor.d.ts.map +1 -0
  134. package/dist/dev/core/actors/create-machine-actor.d.ts +125 -0
  135. package/dist/dev/core/actors/create-machine-actor.d.ts.map +1 -0
  136. package/dist/{default/core → dev/core/actors}/create-machine-actor.js +3 -3
  137. package/dist/dev/core/actors/create-machine-actor.js.map +1 -0
  138. package/dist/dev/core/actors/create-transition-actor.d.ts +42 -0
  139. package/dist/dev/core/actors/create-transition-actor.d.ts.map +1 -0
  140. package/dist/dev/core/{create-transition-actor.js → actors/create-transition-actor.js} +3 -3
  141. package/dist/dev/core/actors/create-transition-actor.js.map +1 -0
  142. package/dist/dev/core/composition/create-composition.d.ts +274 -0
  143. package/dist/dev/core/composition/create-composition.d.ts.map +1 -0
  144. package/dist/dev/core/composition/create-composition.js +85 -0
  145. package/dist/dev/core/composition/create-composition.js.map +1 -0
  146. package/dist/dev/core/composition/share-signals.d.ts +47 -0
  147. package/dist/dev/core/composition/share-signals.d.ts.map +1 -0
  148. package/dist/dev/core/composition/share-signals.js +39 -0
  149. package/dist/dev/core/composition/share-signals.js.map +1 -0
  150. package/dist/dev/core/machine.d.ts +0 -1
  151. package/dist/dev/core/machine.d.ts.map +1 -1
  152. package/dist/dev/core/reactors/create-machine-reactor.d.ts +93 -0
  153. package/dist/dev/core/reactors/create-machine-reactor.d.ts.map +1 -0
  154. package/dist/{default/core → dev/core/reactors}/create-machine-reactor.js +4 -4
  155. package/dist/dev/core/reactors/create-machine-reactor.js.map +1 -0
  156. package/dist/dev/core/signals/primitives.d.ts +38 -1
  157. package/dist/dev/core/signals/primitives.d.ts.map +1 -1
  158. package/dist/dev/core/signals/primitives.js +33 -11
  159. package/dist/dev/core/signals/primitives.js.map +1 -1
  160. package/dist/dev/core/tasks/task.d.ts +115 -0
  161. package/dist/dev/core/tasks/task.d.ts.map +1 -0
  162. package/dist/dev/core/{task.js → tasks/task.js} +2 -2
  163. package/dist/dev/core/tasks/task.js.map +1 -0
  164. package/dist/dev/dom.d.ts +9 -10
  165. package/dist/dev/dom.js +9 -10
  166. package/dist/dev/hls.d.ts +5 -0
  167. package/dist/dev/hls.js +5 -0
  168. package/dist/dev/index.d.ts +15 -3
  169. package/dist/dev/index.d.ts.map +1 -1
  170. package/dist/dev/index.js +12 -3
  171. package/dist/dev/index.js.map +1 -1
  172. package/dist/dev/media/abr/quality-selection.d.ts +22 -0
  173. package/dist/dev/media/abr/quality-selection.d.ts.map +1 -0
  174. package/dist/dev/media/abr/quality-selection.js +21 -0
  175. package/dist/dev/media/abr/quality-selection.js.map +1 -0
  176. package/dist/dev/media/buffer/back-buffer.d.ts +14 -0
  177. package/dist/dev/media/buffer/back-buffer.d.ts.map +1 -0
  178. package/dist/dev/{core → media}/buffer/back-buffer.js +2 -2
  179. package/dist/dev/media/buffer/back-buffer.js.map +1 -0
  180. package/dist/dev/media/buffer/forward-buffer.d.ts +14 -0
  181. package/dist/dev/media/buffer/forward-buffer.d.ts.map +1 -0
  182. package/dist/{default/core → dev/media}/buffer/forward-buffer.js +14 -2
  183. package/dist/dev/media/buffer/forward-buffer.js.map +1 -0
  184. package/dist/dev/media/dom/capabilities.js +70 -0
  185. package/dist/dev/media/dom/capabilities.js.map +1 -0
  186. package/dist/dev/{dom/media → media/dom/mse}/append-segment.d.ts +1 -1
  187. package/dist/dev/media/dom/mse/append-segment.d.ts.map +1 -0
  188. package/dist/{default/dom/media → dev/media/dom/mse}/append-segment.js +1 -1
  189. package/dist/dev/media/dom/mse/append-segment.js.map +1 -0
  190. package/dist/dev/{dom/media → media/dom/mse}/buffer-flusher.d.ts +1 -1
  191. package/dist/dev/media/dom/mse/buffer-flusher.d.ts.map +1 -0
  192. package/dist/dev/{dom/media → media/dom/mse}/buffer-flusher.js +1 -1
  193. package/dist/dev/media/dom/mse/buffer-flusher.js.map +1 -0
  194. package/dist/dev/media/dom/mse/duration.js +78 -0
  195. package/dist/dev/media/dom/mse/duration.js.map +1 -0
  196. package/dist/dev/media/dom/mse/end-of-stream.js +20 -0
  197. package/dist/dev/media/dom/mse/end-of-stream.js.map +1 -0
  198. package/dist/dev/{dom/media → media/dom/mse}/mediasource-setup.js +63 -18
  199. package/dist/dev/media/dom/mse/mediasource-setup.js.map +1 -0
  200. package/dist/dev/media/dom/text/resolve-vtt-segment.d.ts +12 -0
  201. package/dist/dev/media/dom/text/resolve-vtt-segment.d.ts.map +1 -0
  202. package/dist/dev/{dom/text/parse-vtt-segment.js → media/dom/text/resolve-vtt-segment.js} +5 -5
  203. package/dist/dev/media/dom/text/resolve-vtt-segment.js.map +1 -0
  204. package/dist/dev/media/dom/text/text-track-slots.d.ts +31 -0
  205. package/dist/dev/media/dom/text/text-track-slots.d.ts.map +1 -0
  206. package/dist/dev/media/dom/text/text-track-slots.js +69 -0
  207. package/dist/dev/media/dom/text/text-track-slots.js.map +1 -0
  208. package/dist/{default/core → dev/media}/hls/parse-attributes.js +17 -3
  209. package/dist/dev/media/hls/parse-attributes.js.map +1 -0
  210. package/dist/{default/core → dev/media}/hls/parse-media-playlist.js +25 -2
  211. package/dist/dev/media/hls/parse-media-playlist.js.map +1 -0
  212. package/dist/{default/core → dev/media}/hls/parse-multivariant.js +17 -8
  213. package/dist/dev/media/hls/parse-multivariant.js.map +1 -0
  214. package/dist/dev/{core → media}/hls/resolve-url.js +1 -1
  215. package/dist/dev/media/hls/resolve-url.js.map +1 -0
  216. package/dist/dev/media/primitives/select-tracks.d.ts +36 -0
  217. package/dist/dev/media/primitives/select-tracks.d.ts.map +1 -0
  218. package/dist/dev/media/primitives/select-tracks.js +130 -0
  219. package/dist/dev/media/primitives/select-tracks.js.map +1 -0
  220. package/dist/dev/{core → media}/types/index.d.ts +55 -3
  221. package/dist/dev/media/types/index.d.ts.map +1 -0
  222. package/dist/dev/media/types/index.js +36 -0
  223. package/dist/dev/media/types/index.js.map +1 -0
  224. package/dist/dev/media/utils/cdn.d.ts +13 -0
  225. package/dist/dev/media/utils/cdn.d.ts.map +1 -0
  226. package/dist/dev/media/utils/cdn.js +56 -0
  227. package/dist/dev/media/utils/cdn.js.map +1 -0
  228. package/dist/dev/media/utils/preload.js +22 -0
  229. package/dist/dev/media/utils/preload.js.map +1 -0
  230. package/dist/dev/media/utils/track-selection.js +47 -0
  231. package/dist/dev/media/utils/track-selection.js.map +1 -0
  232. package/dist/dev/media/utils/tracks.js +130 -0
  233. package/dist/dev/media/utils/tracks.js.map +1 -0
  234. package/dist/dev/{core/abr → network}/bandwidth-estimator.d.ts +17 -2
  235. package/dist/dev/network/bandwidth-estimator.d.ts.map +1 -0
  236. package/dist/dev/{core/abr → network}/bandwidth-estimator.js +6 -5
  237. package/dist/dev/network/bandwidth-estimator.js.map +1 -0
  238. package/dist/{default/dom → dev}/network/chunked-stream-iterable.js +1 -1
  239. package/dist/dev/network/chunked-stream-iterable.js.map +1 -0
  240. package/dist/{default/core/abr → dev/network}/ewma.js +1 -1
  241. package/dist/dev/network/ewma.js.map +1 -0
  242. package/dist/dev/network/fetch.js +115 -0
  243. package/dist/dev/network/fetch.js.map +1 -0
  244. package/dist/dev/playback/actors/dom/segment-loader.d.ts +36 -0
  245. package/dist/dev/playback/actors/dom/segment-loader.d.ts.map +1 -0
  246. package/dist/dev/{dom/features/segment-loader-actor.js → playback/actors/dom/segment-loader.js} +63 -23
  247. package/dist/dev/playback/actors/dom/segment-loader.js.map +1 -0
  248. package/dist/dev/{dom/media/source-buffer-actor.d.ts → playback/actors/dom/source-buffer.d.ts} +20 -5
  249. package/dist/dev/playback/actors/dom/source-buffer.d.ts.map +1 -0
  250. package/dist/dev/{dom/media/source-buffer-actor.js → playback/actors/dom/source-buffer.js} +10 -9
  251. package/dist/dev/playback/actors/dom/source-buffer.js.map +1 -0
  252. package/dist/dev/playback/actors/dom/text-tracks.d.ts +1 -0
  253. package/dist/{default/dom/features/text-tracks-actor.js → dev/playback/actors/dom/text-tracks.js} +7 -3
  254. package/dist/dev/playback/actors/dom/text-tracks.js.map +1 -0
  255. package/dist/dev/playback/actors/text-track-segment-loader.d.ts +59 -0
  256. package/dist/dev/playback/actors/text-track-segment-loader.d.ts.map +1 -0
  257. package/dist/dev/playback/actors/text-track-segment-loader.js +135 -0
  258. package/dist/dev/playback/actors/text-track-segment-loader.js.map +1 -0
  259. package/dist/dev/playback/actors/text-tracks.d.ts +42 -0
  260. package/dist/dev/playback/actors/text-tracks.d.ts.map +1 -0
  261. package/dist/dev/playback/behaviors/calculate-presentation-duration.d.ts +25 -0
  262. package/dist/dev/playback/behaviors/calculate-presentation-duration.d.ts.map +1 -0
  263. package/dist/dev/playback/behaviors/calculate-presentation-duration.js +36 -0
  264. package/dist/dev/playback/behaviors/calculate-presentation-duration.js.map +1 -0
  265. package/dist/dev/playback/behaviors/derive-cdn-priority.js +68 -0
  266. package/dist/dev/playback/behaviors/derive-cdn-priority.js.map +1 -0
  267. package/dist/dev/playback/behaviors/dom/end-of-stream.js +90 -0
  268. package/dist/dev/playback/behaviors/dom/end-of-stream.js.map +1 -0
  269. package/dist/dev/playback/behaviors/dom/load-segments.d.ts +62 -0
  270. package/dist/dev/playback/behaviors/dom/load-segments.d.ts.map +1 -0
  271. package/dist/dev/playback/behaviors/dom/load-segments.js +177 -0
  272. package/dist/dev/playback/behaviors/dom/load-segments.js.map +1 -0
  273. package/dist/dev/playback/behaviors/dom/setup-buffer-actors.js +192 -0
  274. package/dist/dev/playback/behaviors/dom/setup-buffer-actors.js.map +1 -0
  275. package/dist/dev/playback/behaviors/dom/setup-mediasource.js +89 -0
  276. package/dist/dev/playback/behaviors/dom/setup-mediasource.js.map +1 -0
  277. package/dist/dev/playback/behaviors/dom/setup-text-track-actors.d.ts +31 -0
  278. package/dist/dev/playback/behaviors/dom/setup-text-track-actors.d.ts.map +1 -0
  279. package/dist/dev/playback/behaviors/dom/setup-text-track-actors.js +54 -0
  280. package/dist/dev/playback/behaviors/dom/setup-text-track-actors.js.map +1 -0
  281. package/dist/dev/playback/behaviors/dom/sync-text-tracks.js +124 -0
  282. package/dist/dev/playback/behaviors/dom/sync-text-tracks.js.map +1 -0
  283. package/dist/dev/playback/behaviors/dom/track-current-time.d.ts +34 -0
  284. package/dist/dev/playback/behaviors/dom/track-current-time.d.ts.map +1 -0
  285. package/dist/dev/playback/behaviors/dom/track-current-time.js +52 -0
  286. package/dist/dev/playback/behaviors/dom/track-current-time.js.map +1 -0
  287. package/dist/dev/playback/behaviors/dom/track-load-triggers.d.ts +48 -0
  288. package/dist/dev/playback/behaviors/dom/track-load-triggers.d.ts.map +1 -0
  289. package/dist/dev/playback/behaviors/dom/track-load-triggers.js +94 -0
  290. package/dist/dev/playback/behaviors/dom/track-load-triggers.js.map +1 -0
  291. package/dist/dev/playback/behaviors/dom/track-playback-rate.d.ts +34 -0
  292. package/dist/dev/playback/behaviors/dom/track-playback-rate.d.ts.map +1 -0
  293. package/dist/dev/playback/behaviors/dom/track-playback-rate.js +37 -0
  294. package/dist/dev/playback/behaviors/dom/track-playback-rate.js.map +1 -0
  295. package/dist/dev/playback/behaviors/dom/update-mediasource-duration.js +90 -0
  296. package/dist/dev/playback/behaviors/dom/update-mediasource-duration.js.map +1 -0
  297. package/dist/dev/playback/behaviors/resolve-presentation.d.ts +7 -0
  298. package/dist/dev/playback/behaviors/resolve-presentation.d.ts.map +1 -0
  299. package/dist/dev/playback/behaviors/resolve-presentation.js +85 -0
  300. package/dist/dev/playback/behaviors/resolve-presentation.js.map +1 -0
  301. package/dist/dev/playback/behaviors/resolve-track.js +120 -0
  302. package/dist/dev/playback/behaviors/resolve-track.js.map +1 -0
  303. package/dist/dev/playback/behaviors/select-tracks.d.ts +13 -0
  304. package/dist/dev/playback/behaviors/select-tracks.d.ts.map +1 -0
  305. package/dist/dev/playback/behaviors/select-tracks.js +101 -0
  306. package/dist/dev/playback/behaviors/select-tracks.js.map +1 -0
  307. package/dist/dev/playback/behaviors/setup-failover-monitor.d.ts +12 -0
  308. package/dist/dev/playback/behaviors/setup-failover-monitor.d.ts.map +1 -0
  309. package/dist/dev/playback/behaviors/setup-failover-monitor.js +66 -0
  310. package/dist/dev/playback/behaviors/setup-failover-monitor.js.map +1 -0
  311. package/dist/dev/playback/behaviors/sync-preload.js +59 -0
  312. package/dist/dev/playback/behaviors/sync-preload.js.map +1 -0
  313. package/dist/dev/playback/behaviors/track-switching.js +341 -0
  314. package/dist/dev/playback/behaviors/track-switching.js.map +1 -0
  315. package/dist/dev/playback/engines/background-video/adapter.d.ts +60 -0
  316. package/dist/dev/playback/engines/background-video/adapter.d.ts.map +1 -0
  317. package/dist/dev/playback/engines/background-video/adapter.js +158 -0
  318. package/dist/dev/playback/engines/background-video/adapter.js.map +1 -0
  319. package/dist/dev/playback/engines/background-video/engine.d.ts +107 -0
  320. package/dist/dev/playback/engines/background-video/engine.d.ts.map +1 -0
  321. package/dist/dev/playback/engines/background-video/engine.js +75 -0
  322. package/dist/dev/playback/engines/background-video/engine.js.map +1 -0
  323. package/dist/dev/playback/engines/hls/adapter-audio-only.d.ts +45 -0
  324. package/dist/dev/playback/engines/hls/adapter-audio-only.d.ts.map +1 -0
  325. package/dist/dev/playback/engines/hls/adapter-audio-only.js +119 -0
  326. package/dist/dev/playback/engines/hls/adapter-audio-only.js.map +1 -0
  327. package/dist/dev/{dom/playback-engine → playback/engines/hls}/adapter.d.ts +13 -12
  328. package/dist/dev/playback/engines/hls/adapter.d.ts.map +1 -0
  329. package/dist/dev/{dom/playback-engine → playback/engines/hls}/adapter.js +40 -26
  330. package/dist/dev/playback/engines/hls/adapter.js.map +1 -0
  331. package/dist/dev/playback/engines/hls/engine-audio-only.d.ts +127 -0
  332. package/dist/dev/playback/engines/hls/engine-audio-only.d.ts.map +1 -0
  333. package/dist/dev/playback/engines/hls/engine-audio-only.js +80 -0
  334. package/dist/dev/playback/engines/hls/engine-audio-only.js.map +1 -0
  335. package/dist/dev/playback/engines/hls/engine.d.ts +236 -0
  336. package/dist/dev/playback/engines/hls/engine.d.ts.map +1 -0
  337. package/dist/dev/playback/engines/hls/engine.js +115 -0
  338. package/dist/dev/playback/engines/hls/engine.js.map +1 -0
  339. package/dist/dev/playback/primitives/failover-fetch.js +42 -0
  340. package/dist/dev/playback/primitives/failover-fetch.js.map +1 -0
  341. package/dist/dev/playback/primitives/track-types.js +61 -0
  342. package/dist/dev/playback/primitives/track-types.js.map +1 -0
  343. package/package.json +12 -7
  344. package/dist/default/core/abr/bandwidth-estimator.js.map +0 -1
  345. package/dist/default/core/abr/ewma.js.map +0 -1
  346. package/dist/default/core/abr/quality-selection.js +0 -53
  347. package/dist/default/core/abr/quality-selection.js.map +0 -1
  348. package/dist/default/core/buffer/back-buffer.js.map +0 -1
  349. package/dist/default/core/buffer/forward-buffer.js.map +0 -1
  350. package/dist/default/core/create-machine-actor.js.map +0 -1
  351. package/dist/default/core/create-machine-reactor.js.map +0 -1
  352. package/dist/default/core/create-transition-actor.js.map +0 -1
  353. package/dist/default/core/features/calculate-presentation-duration.js +0 -53
  354. package/dist/default/core/features/calculate-presentation-duration.js.map +0 -1
  355. package/dist/default/core/features/quality-switching.js +0 -69
  356. package/dist/default/core/features/quality-switching.js.map +0 -1
  357. package/dist/default/core/features/resolve-presentation.js +0 -73
  358. package/dist/default/core/features/resolve-presentation.js.map +0 -1
  359. package/dist/default/core/features/resolve-track.js +0 -66
  360. package/dist/default/core/features/resolve-track.js.map +0 -1
  361. package/dist/default/core/features/select-tracks.js +0 -130
  362. package/dist/default/core/features/select-tracks.js.map +0 -1
  363. package/dist/default/core/features/sync-preload-attribute.js +0 -26
  364. package/dist/default/core/features/sync-preload-attribute.js.map +0 -1
  365. package/dist/default/core/hls/parse-attributes.js.map +0 -1
  366. package/dist/default/core/hls/parse-media-playlist.js.map +0 -1
  367. package/dist/default/core/hls/parse-multivariant.js.map +0 -1
  368. package/dist/default/core/hls/resolve-url.js.map +0 -1
  369. package/dist/default/core/task.js.map +0 -1
  370. package/dist/default/core/types/index.js +0 -15
  371. package/dist/default/core/types/index.js.map +0 -1
  372. package/dist/default/core/utils/generate-id.js +0 -21
  373. package/dist/default/core/utils/generate-id.js.map +0 -1
  374. package/dist/default/core/utils/track-selection.js +0 -39
  375. package/dist/default/core/utils/track-selection.js.map +0 -1
  376. package/dist/default/dom/features/end-of-stream.js +0 -145
  377. package/dist/default/dom/features/end-of-stream.js.map +0 -1
  378. package/dist/default/dom/features/load-segments.js +0 -192
  379. package/dist/default/dom/features/load-segments.js.map +0 -1
  380. package/dist/default/dom/features/load-text-track-cues.js +0 -104
  381. package/dist/default/dom/features/load-text-track-cues.js.map +0 -1
  382. package/dist/default/dom/features/segment-loader-actor.js.map +0 -1
  383. package/dist/default/dom/features/setup-mediasource.js +0 -48
  384. package/dist/default/dom/features/setup-mediasource.js.map +0 -1
  385. package/dist/default/dom/features/setup-sourcebuffer.js +0 -78
  386. package/dist/default/dom/features/setup-sourcebuffer.js.map +0 -1
  387. package/dist/default/dom/features/sync-text-tracks.js +0 -95
  388. package/dist/default/dom/features/sync-text-tracks.js.map +0 -1
  389. package/dist/default/dom/features/text-track-segment-loader-actor.js +0 -55
  390. package/dist/default/dom/features/text-track-segment-loader-actor.js.map +0 -1
  391. package/dist/default/dom/features/text-tracks-actor.js.map +0 -1
  392. package/dist/default/dom/features/track-current-time.js +0 -49
  393. package/dist/default/dom/features/track-current-time.js.map +0 -1
  394. package/dist/default/dom/features/track-playback-initiated.js +0 -66
  395. package/dist/default/dom/features/track-playback-initiated.js.map +0 -1
  396. package/dist/default/dom/features/track-playback-rate.js +0 -32
  397. package/dist/default/dom/features/track-playback-rate.js.map +0 -1
  398. package/dist/default/dom/features/update-duration.js +0 -78
  399. package/dist/default/dom/features/update-duration.js.map +0 -1
  400. package/dist/default/dom/media/append-segment.js.map +0 -1
  401. package/dist/default/dom/media/buffer-flusher.js.map +0 -1
  402. package/dist/default/dom/media/mediasource-setup.js.map +0 -1
  403. package/dist/default/dom/media/source-buffer-actor.js.map +0 -1
  404. package/dist/default/dom/network/chunked-stream-iterable.js.map +0 -1
  405. package/dist/default/dom/network/fetch.js +0 -54
  406. package/dist/default/dom/network/fetch.js.map +0 -1
  407. package/dist/default/dom/playback-engine/adapter.js.map +0 -1
  408. package/dist/default/dom/playback-engine/engine.js +0 -142
  409. package/dist/default/dom/playback-engine/engine.js.map +0 -1
  410. package/dist/default/dom/playback-engine.js +0 -4
  411. package/dist/default/dom/text/parse-vtt-segment.js.map +0 -1
  412. package/dist/dev/core/abr/bandwidth-estimator.d.ts.map +0 -1
  413. package/dist/dev/core/abr/bandwidth-estimator.js.map +0 -1
  414. package/dist/dev/core/abr/ewma.js.map +0 -1
  415. package/dist/dev/core/abr/quality-selection.js +0 -53
  416. package/dist/dev/core/abr/quality-selection.js.map +0 -1
  417. package/dist/dev/core/actor.d.ts.map +0 -1
  418. package/dist/dev/core/buffer/back-buffer.js.map +0 -1
  419. package/dist/dev/core/buffer/forward-buffer.js.map +0 -1
  420. package/dist/dev/core/create-machine-actor.d.ts +0 -12
  421. package/dist/dev/core/create-machine-actor.d.ts.map +0 -1
  422. package/dist/dev/core/create-machine-actor.js.map +0 -1
  423. package/dist/dev/core/create-machine-reactor.d.ts +0 -8
  424. package/dist/dev/core/create-machine-reactor.d.ts.map +0 -1
  425. package/dist/dev/core/create-machine-reactor.js.map +0 -1
  426. package/dist/dev/core/create-transition-actor.d.ts +0 -23
  427. package/dist/dev/core/create-transition-actor.d.ts.map +0 -1
  428. package/dist/dev/core/create-transition-actor.js.map +0 -1
  429. package/dist/dev/core/features/calculate-presentation-duration.js +0 -53
  430. package/dist/dev/core/features/calculate-presentation-duration.js.map +0 -1
  431. package/dist/dev/core/features/quality-switching.js +0 -69
  432. package/dist/dev/core/features/quality-switching.js.map +0 -1
  433. package/dist/dev/core/features/resolve-presentation.js +0 -73
  434. package/dist/dev/core/features/resolve-presentation.js.map +0 -1
  435. package/dist/dev/core/features/resolve-track.js +0 -66
  436. package/dist/dev/core/features/resolve-track.js.map +0 -1
  437. package/dist/dev/core/features/select-tracks.js +0 -130
  438. package/dist/dev/core/features/select-tracks.js.map +0 -1
  439. package/dist/dev/core/features/sync-preload-attribute.js +0 -26
  440. package/dist/dev/core/features/sync-preload-attribute.js.map +0 -1
  441. package/dist/dev/core/hls/parse-attributes.js.map +0 -1
  442. package/dist/dev/core/hls/parse-media-playlist.js.map +0 -1
  443. package/dist/dev/core/hls/parse-multivariant.js.map +0 -1
  444. package/dist/dev/core/hls/resolve-url.js.map +0 -1
  445. package/dist/dev/core/task.js.map +0 -1
  446. package/dist/dev/core/types/index.d.ts.map +0 -1
  447. package/dist/dev/core/types/index.js +0 -15
  448. package/dist/dev/core/types/index.js.map +0 -1
  449. package/dist/dev/core/utils/generate-id.js +0 -21
  450. package/dist/dev/core/utils/generate-id.js.map +0 -1
  451. package/dist/dev/core/utils/track-selection.d.ts +0 -16
  452. package/dist/dev/core/utils/track-selection.d.ts.map +0 -1
  453. package/dist/dev/core/utils/track-selection.js +0 -39
  454. package/dist/dev/core/utils/track-selection.js.map +0 -1
  455. package/dist/dev/dom/features/end-of-stream.js +0 -145
  456. package/dist/dev/dom/features/end-of-stream.js.map +0 -1
  457. package/dist/dev/dom/features/load-segments.d.ts +0 -72
  458. package/dist/dev/dom/features/load-segments.d.ts.map +0 -1
  459. package/dist/dev/dom/features/load-segments.js +0 -192
  460. package/dist/dev/dom/features/load-segments.js.map +0 -1
  461. package/dist/dev/dom/features/load-text-track-cues.d.ts +0 -85
  462. package/dist/dev/dom/features/load-text-track-cues.d.ts.map +0 -1
  463. package/dist/dev/dom/features/load-text-track-cues.js +0 -104
  464. package/dist/dev/dom/features/load-text-track-cues.js.map +0 -1
  465. package/dist/dev/dom/features/segment-loader-actor.d.ts +0 -1
  466. package/dist/dev/dom/features/segment-loader-actor.js.map +0 -1
  467. package/dist/dev/dom/features/setup-mediasource.js +0 -48
  468. package/dist/dev/dom/features/setup-mediasource.js.map +0 -1
  469. package/dist/dev/dom/features/setup-sourcebuffer.d.ts +0 -9
  470. package/dist/dev/dom/features/setup-sourcebuffer.d.ts.map +0 -1
  471. package/dist/dev/dom/features/setup-sourcebuffer.js +0 -78
  472. package/dist/dev/dom/features/setup-sourcebuffer.js.map +0 -1
  473. package/dist/dev/dom/features/sync-text-tracks.js +0 -95
  474. package/dist/dev/dom/features/sync-text-tracks.js.map +0 -1
  475. package/dist/dev/dom/features/text-track-segment-loader-actor.d.ts +0 -12
  476. package/dist/dev/dom/features/text-track-segment-loader-actor.d.ts.map +0 -1
  477. package/dist/dev/dom/features/text-track-segment-loader-actor.js +0 -55
  478. package/dist/dev/dom/features/text-track-segment-loader-actor.js.map +0 -1
  479. package/dist/dev/dom/features/text-tracks-actor.d.ts +0 -31
  480. package/dist/dev/dom/features/text-tracks-actor.d.ts.map +0 -1
  481. package/dist/dev/dom/features/text-tracks-actor.js.map +0 -1
  482. package/dist/dev/dom/features/track-current-time.d.ts +0 -40
  483. package/dist/dev/dom/features/track-current-time.d.ts.map +0 -1
  484. package/dist/dev/dom/features/track-current-time.js +0 -49
  485. package/dist/dev/dom/features/track-current-time.js.map +0 -1
  486. package/dist/dev/dom/features/track-playback-initiated.d.ts +0 -46
  487. package/dist/dev/dom/features/track-playback-initiated.d.ts.map +0 -1
  488. package/dist/dev/dom/features/track-playback-initiated.js +0 -66
  489. package/dist/dev/dom/features/track-playback-initiated.js.map +0 -1
  490. package/dist/dev/dom/features/track-playback-rate.d.ts +0 -34
  491. package/dist/dev/dom/features/track-playback-rate.d.ts.map +0 -1
  492. package/dist/dev/dom/features/track-playback-rate.js +0 -32
  493. package/dist/dev/dom/features/track-playback-rate.js.map +0 -1
  494. package/dist/dev/dom/features/update-duration.js +0 -78
  495. package/dist/dev/dom/features/update-duration.js.map +0 -1
  496. package/dist/dev/dom/media/append-segment.d.ts.map +0 -1
  497. package/dist/dev/dom/media/append-segment.js.map +0 -1
  498. package/dist/dev/dom/media/buffer-flusher.d.ts.map +0 -1
  499. package/dist/dev/dom/media/buffer-flusher.js.map +0 -1
  500. package/dist/dev/dom/media/mediasource-setup.js.map +0 -1
  501. package/dist/dev/dom/media/source-buffer-actor.d.ts.map +0 -1
  502. package/dist/dev/dom/media/source-buffer-actor.js.map +0 -1
  503. package/dist/dev/dom/network/chunked-stream-iterable.js.map +0 -1
  504. package/dist/dev/dom/network/fetch.js +0 -54
  505. package/dist/dev/dom/network/fetch.js.map +0 -1
  506. package/dist/dev/dom/playback-engine/adapter.d.ts.map +0 -1
  507. package/dist/dev/dom/playback-engine/adapter.js.map +0 -1
  508. package/dist/dev/dom/playback-engine/engine.d.ts +0 -124
  509. package/dist/dev/dom/playback-engine/engine.d.ts.map +0 -1
  510. package/dist/dev/dom/playback-engine/engine.js +0 -142
  511. package/dist/dev/dom/playback-engine/engine.js.map +0 -1
  512. package/dist/dev/dom/playback-engine.d.ts +0 -4
  513. package/dist/dev/dom/playback-engine.js +0 -4
  514. package/dist/dev/dom/text/parse-vtt-segment.d.ts +0 -12
  515. package/dist/dev/dom/text/parse-vtt-segment.d.ts.map +0 -1
  516. package/dist/dev/dom/text/parse-vtt-segment.js.map +0 -1
@@ -0,0 +1,90 @@
1
+ import { computed } from "../../../core/signals/primitives.js";
2
+ import { defineBehavior } from "../../../core/composition/create-composition.js";
3
+ import { createMachineReactor } from "../../../core/reactors/create-machine-reactor.js";
4
+ import { waitForMediaSourceOpen } from "../../../media/dom/mse/mediasource-setup.js";
5
+ import { getMaxBufferedEnd, shouldUpdateDuration, waitForSourceBuffersReady } from "../../../media/dom/mse/duration.js";
6
+ //#region src/playback/behaviors/dom/update-mediasource-duration.ts
7
+ /**
8
+ * **Propagate `presentation.duration` to `mediaSource.duration` — exactly
9
+ * once per MediaSource.**
10
+ *
11
+ * When the presentation has a valid positive duration (including `Infinity`
12
+ * for live) and a MediaSource is in context, writes the value through to
13
+ * `mediaSource.duration` on initial setup — once, while `mediaSource.duration`
14
+ * is still `NaN`. Once any non-NaN value is present (set by us, or by
15
+ * `endOfStream` from the buffered end), the behavior leaves the property
16
+ * alone; re-syncing a drift against `presentation.duration` would race with
17
+ * concurrent `appendBuffer()` calls.
18
+ *
19
+ * The entry resolves three async preconditions in order before writing:
20
+ *
21
+ * 1. **MediaSource open** — `waitForMediaSourceOpen` defers until the first
22
+ * `sourceopen` event (or any readyState transition, since `'ended'` /
23
+ * `'closed'` mean we've missed the window and should bail).
24
+ * 2. **All SourceBuffers idle** — `waitForSourceBuffersReady` defers per
25
+ * the MSE-spec rule that `duration` cannot be set while any buffer has
26
+ * `updating === true`.
27
+ * 3. **Buffered-range clamp** — `getMaxBufferedEnd` ensures the written
28
+ * duration is at least the highest buffered end (MSE spec disallows
29
+ * a smaller `duration` than any buffered range).
30
+ *
31
+ * The buffer-set helpers operate across `mediaSource.sourceBuffers` (the
32
+ * canonical aggregate), so the behavior composes uniformly across
33
+ * audio-only, video-only, and mixed configurations.
34
+ *
35
+ * Single-positive-state reactor (`'preconditions-unmet'` ↔ `'duration-writable'`):
36
+ * state derivation is purely signal-driven (presentation validity +
37
+ * mediaSource existence). MediaSource lifecycle state (`readyState`) and
38
+ * the `duration` itself are non-signal DOM properties resolved inside the
39
+ * entry's async sequence. The state-exit cleanup aborts the in-flight
40
+ * wait, so source resets and behavior destroy structurally cancel the
41
+ * pending write. A post-await re-check of `mediaSource.readyState ===
42
+ * 'open'` covers the narrow race where `endOfStream()` synchronously
43
+ * transitions readyState to `'ended'` between our `waitForMediaSourceOpen`
44
+ * resolution and the `mediaSource.duration` write.
45
+ *
46
+ * Downstream of `calculatePresentationDuration` (which writes
47
+ * `presentation.duration`); concurrent with `endOfStream` (which may later
48
+ * write `mediaSource.duration` — the "exactly once" contract keeps us out
49
+ * of that path).
50
+ */
51
+ function deriveState(presentation, mediaSource) {
52
+ return shouldUpdateDuration(presentation, mediaSource) ? "duration-writable" : "preconditions-unmet";
53
+ }
54
+ function updateMediaSourceDurationSetup({ state, context }) {
55
+ const derivedStateSignal = computed(() => deriveState(state.presentation.get(), context.mediaSource.get()));
56
+ return createMachineReactor({
57
+ initial: "preconditions-unmet",
58
+ monitor: () => derivedStateSignal.get(),
59
+ states: {
60
+ "preconditions-unmet": {},
61
+ "duration-writable": { entry: () => {
62
+ const presentation = state.presentation.get();
63
+ const mediaSource = context.mediaSource.get();
64
+ if (!Number.isNaN(mediaSource.duration)) return;
65
+ const controller = new AbortController();
66
+ const writeWhenReady = async () => {
67
+ await waitForMediaSourceOpen(mediaSource, controller.signal);
68
+ if (controller.signal.aborted) return;
69
+ if (mediaSource.readyState !== "open") return;
70
+ await waitForSourceBuffersReady(mediaSource.sourceBuffers, controller.signal);
71
+ if (controller.signal.aborted) return;
72
+ if (mediaSource.readyState !== "open") return;
73
+ const maxBufferedEnd = getMaxBufferedEnd(mediaSource.sourceBuffers);
74
+ mediaSource.duration = maxBufferedEnd > presentation.duration ? maxBufferedEnd : presentation.duration;
75
+ };
76
+ writeWhenReady();
77
+ return () => controller.abort();
78
+ } }
79
+ }
80
+ });
81
+ }
82
+ const updateMediaSourceDuration = defineBehavior({
83
+ stateKeys: ["presentation"],
84
+ contextKeys: ["mediaSource"],
85
+ setup: updateMediaSourceDurationSetup
86
+ });
87
+ //#endregion
88
+ export { updateMediaSourceDuration };
89
+
90
+ //# sourceMappingURL=update-mediasource-duration.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"update-mediasource-duration.js","names":[],"sources":["../../../../../src/playback/behaviors/dom/update-mediasource-duration.ts"],"sourcesContent":["/**\n * **Propagate `presentation.duration` to `mediaSource.duration` — exactly\n * once per MediaSource.**\n *\n * When the presentation has a valid positive duration (including `Infinity`\n * for live) and a MediaSource is in context, writes the value through to\n * `mediaSource.duration` on initial setup — once, while `mediaSource.duration`\n * is still `NaN`. Once any non-NaN value is present (set by us, or by\n * `endOfStream` from the buffered end), the behavior leaves the property\n * alone; re-syncing a drift against `presentation.duration` would race with\n * concurrent `appendBuffer()` calls.\n *\n * The entry resolves three async preconditions in order before writing:\n *\n * 1. **MediaSource open** — `waitForMediaSourceOpen` defers until the first\n * `sourceopen` event (or any readyState transition, since `'ended'` /\n * `'closed'` mean we've missed the window and should bail).\n * 2. **All SourceBuffers idle** — `waitForSourceBuffersReady` defers per\n * the MSE-spec rule that `duration` cannot be set while any buffer has\n * `updating === true`.\n * 3. **Buffered-range clamp** — `getMaxBufferedEnd` ensures the written\n * duration is at least the highest buffered end (MSE spec disallows\n * a smaller `duration` than any buffered range).\n *\n * The buffer-set helpers operate across `mediaSource.sourceBuffers` (the\n * canonical aggregate), so the behavior composes uniformly across\n * audio-only, video-only, and mixed configurations.\n *\n * Single-positive-state reactor (`'preconditions-unmet'` ↔ `'duration-writable'`):\n * state derivation is purely signal-driven (presentation validity +\n * mediaSource existence). MediaSource lifecycle state (`readyState`) and\n * the `duration` itself are non-signal DOM properties resolved inside the\n * entry's async sequence. The state-exit cleanup aborts the in-flight\n * wait, so source resets and behavior destroy structurally cancel the\n * pending write. A post-await re-check of `mediaSource.readyState ===\n * 'open'` covers the narrow race where `endOfStream()` synchronously\n * transitions readyState to `'ended'` between our `waitForMediaSourceOpen`\n * resolution and the `mediaSource.duration` write.\n *\n * Downstream of `calculatePresentationDuration` (which writes\n * `presentation.duration`); concurrent with `endOfStream` (which may later\n * write `mediaSource.duration` — the \"exactly once\" contract keeps us out\n * of that path).\n */\nimport { defineBehavior } from '../../../core/composition/create-composition';\nimport type { Reactor } from '../../../core/reactors/create-machine-reactor';\nimport { createMachineReactor } from '../../../core/reactors/create-machine-reactor';\nimport { computed, type ReadonlySignal } from '../../../core/signals/primitives';\nimport { getMaxBufferedEnd, shouldUpdateDuration, waitForSourceBuffersReady } from '../../../media/dom/mse/duration';\nimport { waitForMediaSourceOpen } from '../../../media/dom/mse/mediasource-setup';\nimport type { MaybeResolvedPresentation } from '../../../media/types';\n\ntype DurationFsmState = 'preconditions-unmet' | 'duration-writable';\n\nfunction deriveState(\n presentation: MaybeResolvedPresentation | undefined,\n mediaSource: MediaSource | undefined\n): DurationFsmState {\n return shouldUpdateDuration(presentation, mediaSource) ? 'duration-writable' : 'preconditions-unmet';\n}\n\nfunction updateMediaSourceDurationSetup({\n state,\n context,\n}: {\n state: { presentation: ReadonlySignal<MaybeResolvedPresentation | undefined> };\n context: { mediaSource: ReadonlySignal<MediaSource | undefined> };\n}): Reactor<DurationFsmState | 'destroying' | 'destroyed'> {\n // Purely signal-driven derivation: only `presentation` validity and\n // `mediaSource` existence. MediaSource lifecycle (`readyState`),\n // its attached `sourceBuffers`, and `mediaSource.duration` itself are\n // non-signal DOM properties consumed inside the entry — none of them\n // sneak into `computed(...)`.\n const derivedStateSignal = computed(() => deriveState(state.presentation.get(), context.mediaSource.get()));\n\n return createMachineReactor<DurationFsmState>({\n initial: 'preconditions-unmet',\n monitor: () => derivedStateSignal.get(),\n states: {\n 'preconditions-unmet': {},\n\n 'duration-writable': {\n // entry body is auto-untracked. The state machine handles source\n // resets via deriveState; this entry resolves the MediaSource\n // lifecycle preconditions in sequence and binds its cleanup\n // (abort) to state exit + destroy.\n entry: () => {\n const presentation = state.presentation.get()!;\n const mediaSource = context.mediaSource.get()!;\n\n // Idempotency: someone (us on a prior entry, or concurrent\n // `endOfStream`) has already written. No-op and leave the state\n // alone — the next source-reset transition will produce a fresh\n // entry against the new MediaSource (whose `duration` starts at\n // `NaN` again).\n if (!Number.isNaN(mediaSource.duration)) return;\n\n const controller = new AbortController();\n\n const writeWhenReady = async () => {\n await waitForMediaSourceOpen(mediaSource, controller.signal);\n if (controller.signal.aborted) return;\n // `waitForMediaSourceOpen` resolves on any readyState transition\n // out of 'closed'; if we landed in 'ended' / 'closed' instead of\n // 'open', the write window is gone.\n if (mediaSource.readyState !== 'open') return;\n\n await waitForSourceBuffersReady(mediaSource.sourceBuffers, controller.signal);\n if (controller.signal.aborted) return;\n\n // Narrow race: `endOfStream()` synchronously transitions\n // readyState to 'ended' AND writes `mediaSource.duration`\n // between our `waitForMediaSourceOpen` resolution and here.\n // Re-read the DOM property to catch this window.\n if (mediaSource.readyState !== 'open') return;\n\n // MSE spec: duration cannot be less than any buffered range.\n // Re-read sourceBuffers after the await so any buffer added\n // during the wait is included in the clamp.\n const maxBufferedEnd = getMaxBufferedEnd(mediaSource.sourceBuffers);\n const duration = maxBufferedEnd > presentation.duration! ? maxBufferedEnd : presentation.duration!;\n mediaSource.duration = duration;\n };\n\n writeWhenReady();\n\n return () => controller.abort();\n },\n },\n },\n });\n}\n\nexport const updateMediaSourceDuration = defineBehavior({\n stateKeys: ['presentation'],\n contextKeys: ['mediaSource'],\n setup: updateMediaSourceDurationSetup,\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsDA,SAAS,YACP,cACA,aACkB;AAClB,QAAO,qBAAqB,cAAc,YAAY,GAAG,sBAAsB;;AAGjF,SAAS,+BAA+B,EACtC,OACA,WAIyD;CAMzD,MAAM,qBAAqB,eAAe,YAAY,MAAM,aAAa,KAAK,EAAE,QAAQ,YAAY,KAAK,CAAC,CAAC;AAE3G,QAAO,qBAAuC;EAC5C,SAAS;EACT,eAAe,mBAAmB,KAAK;EACvC,QAAQ;GACN,uBAAuB,EAAE;GAEzB,qBAAqB,EAKnB,aAAa;IACX,MAAM,eAAe,MAAM,aAAa,KAAK;IAC7C,MAAM,cAAc,QAAQ,YAAY,KAAK;AAO7C,QAAI,CAAC,OAAO,MAAM,YAAY,SAAS,CAAE;IAEzC,MAAM,aAAa,IAAI,iBAAiB;IAExC,MAAM,iBAAiB,YAAY;AACjC,WAAM,uBAAuB,aAAa,WAAW,OAAO;AAC5D,SAAI,WAAW,OAAO,QAAS;AAI/B,SAAI,YAAY,eAAe,OAAQ;AAEvC,WAAM,0BAA0B,YAAY,eAAe,WAAW,OAAO;AAC7E,SAAI,WAAW,OAAO,QAAS;AAM/B,SAAI,YAAY,eAAe,OAAQ;KAKvC,MAAM,iBAAiB,kBAAkB,YAAY,cAAc;AAEnE,iBAAY,WADK,iBAAiB,aAAa,WAAY,iBAAiB,aAAa;;AAI3F,oBAAgB;AAEhB,iBAAa,WAAW,OAAO;MAElC;GACF;EACF,CAAC;;AAGJ,MAAa,4BAA4B,eAAe;CACtD,WAAW,CAAC,eAAe;CAC3B,aAAa,CAAC,cAAc;CAC5B,OAAO;CACR,CAAC"}
@@ -0,0 +1,7 @@
1
+ import { MaybeResolvedPresentation, Presentation } from "../../media/types/index.js";
2
+
3
+ //#region src/playback/behaviors/resolve-presentation.d.ts
4
+ type ParsePresentation = (text: string, presentation: MaybeResolvedPresentation) => Presentation;
5
+ //#endregion
6
+ export { ParsePresentation };
7
+ //# sourceMappingURL=resolve-presentation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolve-presentation.d.ts","names":[],"sources":["../../../../src/playback/behaviors/resolve-presentation.ts"],"mappings":";;;KAiDY,iBAAA,IAAqB,IAAA,UAAc,YAAA,EAAc,yBAAA,KAA8B,YAAA"}
@@ -0,0 +1,85 @@
1
+ import { computed } from "../../core/signals/primitives.js";
2
+ import { defineBehavior } from "../../core/composition/create-composition.js";
3
+ import { createMachineReactor } from "../../core/reactors/create-machine-reactor.js";
4
+ import { isResolvedPresentation } from "../../media/types/index.js";
5
+ import { fetchResolvable, getResponseText } from "../../network/fetch.js";
6
+ import { isBlockingPreload } from "../../media/utils/preload.js";
7
+ //#region src/playback/behaviors/resolve-presentation.ts
8
+ /**
9
+ * **Resolve an unresolved presentation by fetching and parsing its manifest.**
10
+ *
11
+ * Reads `state.presentation`; when it holds `{ url }` (unresolved) and the
12
+ * preload / load-activation gate is met, fetches the manifest, parses it via
13
+ * the **required** `config.parsePresentation`, and writes the resolved
14
+ * `Presentation` back to the same slot. The behavior is format-neutral: the
15
+ * composing engine wires in its parser (e.g. the HLS engine supplies the
16
+ * multivariant-playlist parser).
17
+ *
18
+ * Source-identity-driven, expressed as a 4-state machine:
19
+ *
20
+ * ```
21
+ * 'preconditions-unmet' → 'idle' → 'resolving' → 'resolved'
22
+ * ```
23
+ *
24
+ * - `'preconditions-unmet'`: no presentation, or presentation has no URL.
25
+ * - `'idle'`: URL present, unresolved, gate unmet (blocking preload + no
26
+ * load-activation). Waits for the gate to open.
27
+ * - `'resolving'`: URL present, unresolved, gate met. Entry starts the fetch
28
+ * and returns the AbortController — the reactor calls `.abort()` on state
29
+ * exit, so source change / gate-close / destroy all cancel cleanly.
30
+ * - `'resolved'`: `state.presentation` holds a resolved `Presentation`.
31
+ *
32
+ * Gate semantics: `state.preload` (or `config.defaultPreload`, default
33
+ * `'metadata'`, when state.preload is unset) blocks resolution when its
34
+ * value is `'none'` (see `isBlockingPreload` in `media/utils/preload`).
35
+ * `state.loadActivated` is an override — true bypasses the preload gate
36
+ * entirely.
37
+ *
38
+ * Multi-writer with the engine adapter, which writes the initial unresolved
39
+ * `{ url }` to `state.presentation` from src input. Different domains
40
+ * (config-input vs. derived state via fetch) — legitimate multi-writer.
41
+ */
42
+ function deriveState(presentation, preload, loadActivated, defaultPreload) {
43
+ if (!presentation?.url) return "preconditions-unmet";
44
+ if (isResolvedPresentation(presentation)) return "resolved";
45
+ return !!loadActivated || !isBlockingPreload(preload, defaultPreload) ? "resolving" : "idle";
46
+ }
47
+ function resolvePresentationSetup({ state, config }) {
48
+ const { parsePresentation } = config;
49
+ const defaultPreload = config.defaultPreload ?? "metadata";
50
+ const derivedStateSignal = computed(() => deriveState(state.presentation.get(), state.preload.get(), state.loadActivated.get(), defaultPreload));
51
+ return createMachineReactor({
52
+ initial: "preconditions-unmet",
53
+ monitor: () => derivedStateSignal.get(),
54
+ states: {
55
+ "preconditions-unmet": {},
56
+ idle: {},
57
+ resolving: { entry: () => {
58
+ const presentation = state.presentation.get();
59
+ const ac = new AbortController();
60
+ fetchResolvable(presentation, { signal: ac.signal }).then((response) => getResponseText(response)).then((text) => {
61
+ const parsed = parsePresentation(text, presentation);
62
+ state.presentation.set(parsed);
63
+ }).catch((error) => {
64
+ if (error instanceof Error && error.name === "AbortError") return;
65
+ console.error("[resolvePresentation] manifest fetch/parse failed:", error);
66
+ });
67
+ return ac;
68
+ } },
69
+ resolved: {}
70
+ }
71
+ });
72
+ }
73
+ const resolvePresentation = defineBehavior({
74
+ stateKeys: [
75
+ "presentation",
76
+ "preload",
77
+ "loadActivated"
78
+ ],
79
+ contextKeys: [],
80
+ setup: resolvePresentationSetup
81
+ });
82
+ //#endregion
83
+ export { resolvePresentation };
84
+
85
+ //# sourceMappingURL=resolve-presentation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolve-presentation.js","names":[],"sources":["../../../../src/playback/behaviors/resolve-presentation.ts"],"sourcesContent":["/**\n * **Resolve an unresolved presentation by fetching and parsing its manifest.**\n *\n * Reads `state.presentation`; when it holds `{ url }` (unresolved) and the\n * preload / load-activation gate is met, fetches the manifest, parses it via\n * the **required** `config.parsePresentation`, and writes the resolved\n * `Presentation` back to the same slot. The behavior is format-neutral: the\n * composing engine wires in its parser (e.g. the HLS engine supplies the\n * multivariant-playlist parser).\n *\n * Source-identity-driven, expressed as a 4-state machine:\n *\n * ```\n * 'preconditions-unmet' → 'idle' → 'resolving' → 'resolved'\n * ```\n *\n * - `'preconditions-unmet'`: no presentation, or presentation has no URL.\n * - `'idle'`: URL present, unresolved, gate unmet (blocking preload + no\n * load-activation). Waits for the gate to open.\n * - `'resolving'`: URL present, unresolved, gate met. Entry starts the fetch\n * and returns the AbortController — the reactor calls `.abort()` on state\n * exit, so source change / gate-close / destroy all cancel cleanly.\n * - `'resolved'`: `state.presentation` holds a resolved `Presentation`.\n *\n * Gate semantics: `state.preload` (or `config.defaultPreload`, default\n * `'metadata'`, when state.preload is unset) blocks resolution when its\n * value is `'none'` (see `isBlockingPreload` in `media/utils/preload`).\n * `state.loadActivated` is an override — true bypasses the preload gate\n * entirely.\n *\n * Multi-writer with the engine adapter, which writes the initial unresolved\n * `{ url }` to `state.presentation` from src input. Different domains\n * (config-input vs. derived state via fetch) — legitimate multi-writer.\n */\nimport { defineBehavior } from '../../core/composition/create-composition';\nimport type { Reactor } from '../../core/reactors/create-machine-reactor';\nimport { createMachineReactor } from '../../core/reactors/create-machine-reactor';\nimport { computed, type ReadonlySignal, type Signal } from '../../core/signals/primitives';\nimport { isResolvedPresentation, type MaybeResolvedPresentation, type Presentation } from '../../media/types';\nimport { DEFAULT_PRELOAD, isBlockingPreload, type StandardPreload } from '../../media/utils/preload';\nimport { fetchResolvable, getResponseText } from '../../network/fetch';\n\nexport interface PresentationState {\n presentation?: MaybeResolvedPresentation;\n preload?: 'auto' | 'metadata' | 'none' | undefined;\n /** True once a preload-overriding event has fired for the current source — enables resolution regardless of preload. */\n loadActivated?: boolean;\n}\n\nexport type ParsePresentation = (text: string, presentation: MaybeResolvedPresentation) => Presentation;\n\nexport interface ResolvePresentationConfig {\n /**\n * Parses a manifest body into a resolved `Presentation`. **Required** —\n * the behavior is format-neutral and the composing engine supplies its\n * own parser (HLS, DASH, etc.).\n */\n parsePresentation: ParsePresentation;\n /**\n * Fallback used when `state.preload` is unset (undefined / empty) for the\n * resolution-gate decision. Defaults to `'metadata'`, matching\n * `syncPreload`'s own `defaultPreload`.\n */\n defaultPreload?: StandardPreload;\n}\n\nexport type ResolvePresentationState = 'preconditions-unmet' | 'idle' | 'resolving' | 'resolved';\n\nfunction deriveState(\n presentation: MaybeResolvedPresentation | undefined,\n preload: PresentationState['preload'],\n loadActivated: boolean | undefined,\n defaultPreload: StandardPreload\n): ResolvePresentationState {\n if (!presentation?.url) return 'preconditions-unmet';\n if (isResolvedPresentation(presentation)) return 'resolved';\n const gateOpen = !!loadActivated || !isBlockingPreload(preload, defaultPreload);\n return gateOpen ? 'resolving' : 'idle';\n}\n\nfunction resolvePresentationSetup({\n state,\n config,\n}: {\n state: {\n presentation: Signal<PresentationState['presentation']>;\n preload: ReadonlySignal<PresentationState['preload']>;\n loadActivated: ReadonlySignal<PresentationState['loadActivated']>;\n };\n config: ResolvePresentationConfig;\n}): Reactor<ResolvePresentationState | 'destroying' | 'destroyed'> {\n const { parsePresentation } = config;\n const defaultPreload: StandardPreload = config.defaultPreload ?? DEFAULT_PRELOAD;\n\n const derivedStateSignal = computed(() =>\n deriveState(state.presentation.get(), state.preload.get(), state.loadActivated.get(), defaultPreload)\n );\n\n return createMachineReactor<ResolvePresentationState>({\n initial: 'preconditions-unmet',\n monitor: () => derivedStateSignal.get(),\n states: {\n 'preconditions-unmet': {},\n idle: {},\n resolving: {\n entry: () => {\n const presentation = state.presentation.get()!;\n const ac = new AbortController();\n\n fetchResolvable(presentation, { signal: ac.signal })\n .then((response) => getResponseText(response))\n .then((text) => {\n const parsed = parsePresentation(text, presentation);\n state.presentation.set(parsed);\n })\n .catch((error) => {\n if (error instanceof Error && error.name === 'AbortError') return;\n // TODO(error-management): route to a state-error slot once one exists.\n console.error('[resolvePresentation] manifest fetch/parse failed:', error);\n });\n\n return ac;\n },\n },\n resolved: {},\n },\n });\n}\n\nexport const resolvePresentation = defineBehavior({\n stateKeys: ['presentation', 'preload', 'loadActivated'],\n contextKeys: [],\n setup: resolvePresentationSetup,\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoEA,SAAS,YACP,cACA,SACA,eACA,gBAC0B;AAC1B,KAAI,CAAC,cAAc,IAAK,QAAO;AAC/B,KAAI,uBAAuB,aAAa,CAAE,QAAO;AAEjD,QADiB,CAAC,CAAC,iBAAiB,CAAC,kBAAkB,SAAS,eAAe,GAC7D,cAAc;;AAGlC,SAAS,yBAAyB,EAChC,OACA,UAQiE;CACjE,MAAM,EAAE,sBAAsB;CAC9B,MAAM,iBAAkC,OAAO,kBAAA;CAE/C,MAAM,qBAAqB,eACzB,YAAY,MAAM,aAAa,KAAK,EAAE,MAAM,QAAQ,KAAK,EAAE,MAAM,cAAc,KAAK,EAAE,eAAe,CACtG;AAED,QAAO,qBAA+C;EACpD,SAAS;EACT,eAAe,mBAAmB,KAAK;EACvC,QAAQ;GACN,uBAAuB,EAAE;GACzB,MAAM,EAAE;GACR,WAAW,EACT,aAAa;IACX,MAAM,eAAe,MAAM,aAAa,KAAK;IAC7C,MAAM,KAAK,IAAI,iBAAiB;AAEhC,oBAAgB,cAAc,EAAE,QAAQ,GAAG,QAAQ,CAAC,CACjD,MAAM,aAAa,gBAAgB,SAAS,CAAC,CAC7C,MAAM,SAAS;KACd,MAAM,SAAS,kBAAkB,MAAM,aAAa;AACpD,WAAM,aAAa,IAAI,OAAO;MAC9B,CACD,OAAO,UAAU;AAChB,SAAI,iBAAiB,SAAS,MAAM,SAAS,aAAc;AAE3D,aAAQ,MAAM,sDAAsD,MAAM;MAC1E;AAEJ,WAAO;MAEV;GACD,UAAU,EAAE;GACb;EACF,CAAC;;AAGJ,MAAa,sBAAsB,eAAe;CAChD,WAAW;EAAC;EAAgB;EAAW;EAAgB;CACvD,aAAa,EAAE;CACf,OAAO;CACR,CAAC"}
@@ -0,0 +1,120 @@
1
+ import { computed, peek, update } from "../../core/signals/primitives.js";
2
+ import { defineBehavior } from "../../core/composition/create-composition.js";
3
+ import { ConcurrentRunner, Task } from "../../core/tasks/task.js";
4
+ import { createMachineReactor } from "../../core/reactors/create-machine-reactor.js";
5
+ import { isResolvedPresentation, isResolvedTrack } from "../../media/types/index.js";
6
+ import { applyContainerMimeType, findTrack, updateTrackInPresentation } from "../../media/utils/tracks.js";
7
+ import { AUDIO_TYPE_CONFIG, TEXT_TYPE_CONFIG, VIDEO_TYPE_CONFIG } from "../primitives/track-types.js";
8
+ import { NON_FMP4_CONTAINER_MIMES, parseMediaPlaylist } from "../../media/hls/parse-media-playlist.js";
9
+ import { fetchResolvableText } from "../../network/fetch.js";
10
+ import { failoverFetch } from "../primitives/failover-fetch.js";
11
+ //#region src/playback/behaviors/resolve-track.ts
12
+ function setupTrackResolution({ state, config: { selectedKey, findTrackToResolve, fetchResolvableText: fetchResolvableText$1 = fetchResolvableText } }) {
13
+ const runner = new ConcurrentRunner();
14
+ const derivedStateSignal = computed(() => isResolvedPresentation(state.presentation.get()) ? "presentation-resolved" : "presentation-unresolved");
15
+ return createMachineReactor({
16
+ initial: "presentation-unresolved",
17
+ monitor: () => derivedStateSignal.get(),
18
+ states: {
19
+ "presentation-unresolved": {},
20
+ "presentation-resolved": {
21
+ entry: () => () => runner.abortAll(),
22
+ effects: [() => {
23
+ const presentation = peek(state.presentation);
24
+ const trackId = state[selectedKey].get();
25
+ if (!presentation || !trackId) return;
26
+ const track = findTrackToResolve(presentation, trackId);
27
+ if (!track || isResolvedTrack(track)) return;
28
+ runner.schedule(new Task(async (signal) => {
29
+ const mediaTrack = parseMediaPlaylist(await fetchResolvableText$1(track, { signal }), track);
30
+ update(state.presentation, (current) => {
31
+ if (!isResolvedPresentation(current)) return current;
32
+ const patched = updateTrackInPresentation(current, mediaTrack);
33
+ return NON_FMP4_CONTAINER_MIMES.has(mediaTrack.mimeType) ? applyContainerMimeType(patched, mediaTrack.type, mediaTrack.mimeType) : patched;
34
+ });
35
+ }, { id: track.id }));
36
+ }]
37
+ }
38
+ }
39
+ });
40
+ }
41
+ const VIDEO_TRACK_RESOLUTION_CONFIG = {
42
+ ...VIDEO_TYPE_CONFIG,
43
+ findTrackToResolve: (presentation, trackId) => findTrack(presentation, "video", trackId)
44
+ };
45
+ const AUDIO_TRACK_RESOLUTION_CONFIG = {
46
+ ...AUDIO_TYPE_CONFIG,
47
+ findTrackToResolve: (presentation, trackId) => findTrack(presentation, "audio", trackId)
48
+ };
49
+ const TEXT_TRACK_RESOLUTION_CONFIG = {
50
+ ...TEXT_TYPE_CONFIG,
51
+ findTrackToResolve: (presentation, trackId) => findTrack(presentation, "text", trackId)
52
+ };
53
+ /**
54
+ * Resolve unresolved video tracks. Schedules a fetch task whenever the
55
+ * selected video track is partially resolved, parses the manifest, and
56
+ * writes the resolved track back into `state.presentation`.
57
+ */
58
+ const resolveVideoTrack = defineBehavior({
59
+ stateKeys: ["presentation", "selectedVideoTrackId"],
60
+ contextKeys: [],
61
+ setup: ({ state, config = {} }) => {
62
+ const trackConfig = {
63
+ ...VIDEO_TRACK_RESOLUTION_CONFIG,
64
+ ...config
65
+ };
66
+ return setupTrackResolution({
67
+ state,
68
+ config: {
69
+ ...trackConfig,
70
+ fetchResolvableText: failoverFetch(fetchResolvableText, state, trackConfig)
71
+ }
72
+ });
73
+ }
74
+ });
75
+ /**
76
+ * Resolve unresolved audio tracks. Same shape as `resolveVideoTrack`,
77
+ * narrowed to audio.
78
+ */
79
+ const resolveAudioTrack = defineBehavior({
80
+ stateKeys: ["presentation", "selectedAudioTrackId"],
81
+ contextKeys: [],
82
+ setup: ({ state, config = {} }) => {
83
+ const trackConfig = {
84
+ ...AUDIO_TRACK_RESOLUTION_CONFIG,
85
+ ...config
86
+ };
87
+ return setupTrackResolution({
88
+ state,
89
+ config: {
90
+ ...trackConfig,
91
+ fetchResolvableText: failoverFetch(fetchResolvableText, state, trackConfig)
92
+ }
93
+ });
94
+ }
95
+ });
96
+ /**
97
+ * Resolve unresolved text tracks. Same shape as `resolveVideoTrack`,
98
+ * narrowed to text.
99
+ */
100
+ const resolveTextTrack = defineBehavior({
101
+ stateKeys: ["presentation", "selectedTextTrackId"],
102
+ contextKeys: [],
103
+ setup: ({ state, config = {} }) => {
104
+ const trackConfig = {
105
+ ...TEXT_TRACK_RESOLUTION_CONFIG,
106
+ ...config
107
+ };
108
+ return setupTrackResolution({
109
+ state,
110
+ config: {
111
+ ...trackConfig,
112
+ fetchResolvableText: failoverFetch(fetchResolvableText, state, trackConfig)
113
+ }
114
+ });
115
+ }
116
+ });
117
+ //#endregion
118
+ export { resolveAudioTrack, resolveTextTrack, resolveVideoTrack };
119
+
120
+ //# sourceMappingURL=resolve-track.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolve-track.js","names":["defaultFetchResolvableText","fetchResolvableText"],"sources":["../../../../src/playback/behaviors/resolve-track.ts"],"sourcesContent":["import { defineBehavior } from '../../core/composition/create-composition';\nimport { createMachineReactor } from '../../core/reactors/create-machine-reactor';\nimport { computed, peek, type ReadonlySignal, type Signal, update } from '../../core/signals/primitives';\nimport { ConcurrentRunner, Task } from '../../core/tasks/task';\nimport { NON_FMP4_CONTAINER_MIMES, parseMediaPlaylist } from '../../media/hls/parse-media-playlist';\nimport type { MaybeResolvedPresentation, PartiallyResolvedTrack, ResolvedTrack } from '../../media/types';\nimport { isResolvedPresentation, isResolvedTrack } from '../../media/types';\nimport type { GetCdnId } from '../../media/utils/cdn';\nimport { applyContainerMimeType, findTrack, updateTrackInPresentation } from '../../media/utils/tracks';\nimport { fetchResolvableText as defaultFetchResolvableText, type FetchText } from '../../network/fetch';\nimport { failoverFetch } from '../primitives/failover-fetch';\nimport { AUDIO_TYPE_CONFIG, TEXT_TYPE_CONFIG, VIDEO_TYPE_CONFIG } from '../primitives/track-types';\n\n// ============================================================================\n// Specialization helper\n//\n// `setupTrackResolution` has the same shape as a Behavior `setup` function:\n// `({ state, config }) => cleanup`. Each `resolveXTrack` export below calls it\n// from inside its own `defineBehavior` setup, supplying its per-type config\n// inline. The orchestration — gate on a selection, short-circuit when the\n// track is already resolved or missing, schedule the fetch+parse, and patch\n// the resolved track back into `state.presentation` — is shared.\n// ============================================================================\n\n/**\n * State shape for track resolution. Uses `MaybeResolvedPresentation` so it\n * matches the engine's slot type; resolution narrows internally.\n */\nexport interface ResolveTrackState {\n presentation?: MaybeResolvedPresentation;\n selectedVideoTrackId?: string;\n selectedAudioTrackId?: string;\n selectedTextTrackId?: string;\n failedCdns?: string[];\n}\n\ntype SelectedTrackKey = 'selectedVideoTrackId' | 'selectedAudioTrackId' | 'selectedTextTrackId';\n\ntype ResolveTrackStateMap<K extends SelectedTrackKey> = {\n presentation: Signal<ResolveTrackState['presentation']>;\n} & { [P in K]: ReadonlySignal<ResolveTrackState[P]> };\n\ninterface TrackResolutionConfig<K extends SelectedTrackKey> {\n selectedKey: K;\n findTrackToResolve: (\n presentation: MaybeResolvedPresentation,\n trackId: string\n ) => PartiallyResolvedTrack | ResolvedTrack | undefined;\n /** Fetch a track's media-playlist text — already failover-decorated by the behavior. */\n fetchResolvableText?: FetchText;\n}\n\n/**\n * Engine-config slice each `resolve*` behavior reads to build its failover-\n * decorated playlist fetch.\n */\ninterface ResolveTrackConfig {\n /** CDN-id derivation for the failover trip; defaults to origin-based `getCdnId`. */\n getCdnId?: GetCdnId;\n}\n\nfunction setupTrackResolution<K extends SelectedTrackKey>({\n state,\n config: { selectedKey, findTrackToResolve, fetchResolvableText = defaultFetchResolvableText },\n}: {\n state: ResolveTrackStateMap<K>;\n config: TrackResolutionConfig<K>;\n}) {\n // NOTE: This can/maybe will be pulled into a per-use case factory (e.g. something like createTaskRunner() with args TBD),\n // likely eventually passed down via config or a new \"definitions\" argument. This will allow us to decide if we want our task runner/scheduler\n // to e.g. run concurrently (like we currently are), serially with a queue, or abort the previous task and replace it with the newly scheduled one. (CJP).\n const runner = new ConcurrentRunner();\n\n // Reactor states model the FSM the previous effect-based body was\n // hand-rolling. 'presentation-resolved' is entered when the\n // presentation is fully parsed (has a Ham id + selectionSets); leaving\n // it (presentation cleared or reset to an unresolved value) aborts all\n // in-flight tasks via the entry-cleanup. Most URL changes go through\n // 'presentation-unresolved' naturally (set undefined → set new partial\n // → re-parse), so the common case is covered by state-exit alone; the\n // task body's commit-time id check covers the pathological\n // resolved→resolved-without-unresolved transition.\n const derivedStateSignal = computed(() =>\n isResolvedPresentation(state.presentation.get())\n ? ('presentation-resolved' as const)\n : ('presentation-unresolved' as const)\n );\n\n return createMachineReactor({\n initial: 'presentation-unresolved',\n monitor: () => derivedStateSignal.get(),\n states: {\n 'presentation-unresolved': {},\n 'presentation-resolved': {\n // `entry` runs on state entry; the function it returns is the\n // state-exit cleanup. Returning `() => runner.abortAll()` binds\n // abort-of-in-flight-resolutions to leaving 'presentation-resolved'\n // (presentation cleared/reset, or behavior destroyed) —\n // source-change cancellation expressed structurally through the\n // state machine.\n entry: () => () => runner.abortAll(),\n effects: [\n () => {\n // The reactor's state transitions handle relevant presentation\n // changes (presentation-resolved ↔ presentation-unresolved);\n // within 'presentation-resolved' we peek (untracked read) so\n // internal updates (segments added by sibling tasks) don't\n // re-fire the effect.\n const presentation = peek(state.presentation);\n const trackId = state[selectedKey].get();\n if (!presentation || !trackId) return;\n\n const track = findTrackToResolve(presentation, trackId);\n if (!track || isResolvedTrack(track)) return;\n\n runner.schedule(\n // NOTE: This can/maybe will be pulled into a per-use case factory (e.g. something like createResolveTrackTask(track, context, config)),\n // likely eventually passed down via config or a new \"definitions\" argument (CJP).\n new Task(\n async (signal) => {\n // `fetchResolvableText` is the behavior's failover-decorated\n // fetch: it trips the CDN on a failed fetch (network error or\n // non-OK status). A parse failure is a content issue, not a\n // CDN-availability one, so it doesn't trip.\n const text = await fetchResolvableText(track, { signal });\n const mediaTrack = parseMediaPlaylist(text, track);\n\n // Updater handles undefined inputs by returning current\n // unchanged; isResolvedPresentation narrows for the patch.\n // State-exit on resolving→unresolved fires runner.abortAll\n // before any URL change settles, and per the Fetch spec the\n // signal abort cancels in-flight body reads — so by the\n // time we reach this point the presentation we resolved\n // against is the live one.\n update(state.presentation, (current) => {\n if (!isResolvedPresentation(current)) return current;\n const patched = updateTrackInPresentation(current, mediaTrack);\n // Container is uniform within a type (an ABR ladder shares\n // its container), so a detected non-fMP4 rendition (TS,\n // raw AAC) implies every rendition of *this* type matches —\n // relabel them all from one resolved playlist instead of\n // fetching each. Scoped to this track's own type: never cross\n // audio↔video (mixed-container sources exist, e.g. muxed-TS\n // video + raw-.aac audio), which also keeps per-type\n // resolutions' writes disjoint (no race).\n return NON_FMP4_CONTAINER_MIMES.has(mediaTrack.mimeType)\n ? applyContainerMimeType(patched, mediaTrack.type, mediaTrack.mimeType)\n : patched;\n });\n },\n { id: track.id }\n )\n );\n },\n ],\n },\n },\n });\n}\n\n// ============================================================================\n// Per-helper-per-type configs — defaults that variants spread engine config over\n// ============================================================================\n\nconst VIDEO_TRACK_RESOLUTION_CONFIG = {\n ...VIDEO_TYPE_CONFIG,\n findTrackToResolve: (presentation: MaybeResolvedPresentation, trackId: string) =>\n findTrack(presentation, 'video', trackId),\n} as const;\n\nconst AUDIO_TRACK_RESOLUTION_CONFIG = {\n ...AUDIO_TYPE_CONFIG,\n findTrackToResolve: (presentation: MaybeResolvedPresentation, trackId: string) =>\n findTrack(presentation, 'audio', trackId),\n} as const;\n\nconst TEXT_TRACK_RESOLUTION_CONFIG = {\n ...TEXT_TYPE_CONFIG,\n findTrackToResolve: (presentation: MaybeResolvedPresentation, trackId: string) =>\n findTrack(presentation, 'text', trackId),\n} as const;\n\n// ============================================================================\n// Specialized exports — one per track type\n// ============================================================================\n\n/**\n * Resolve unresolved video tracks. Schedules a fetch task whenever the\n * selected video track is partially resolved, parses the manifest, and\n * writes the resolved track back into `state.presentation`.\n */\nexport const resolveVideoTrack = defineBehavior({\n stateKeys: ['presentation', 'selectedVideoTrackId'],\n contextKeys: [],\n setup: ({\n state,\n config = {},\n }: {\n state: ResolveTrackStateMap<'selectedVideoTrackId'>;\n config?: ResolveTrackConfig;\n }) => {\n // Engine `config` layers over the per-type defaults (mirrors the other\n // per-type variants, see track-types.ts); `failoverFetch` reads its\n // `selectedKey` + `getCdnId` from the merged result. `fetchResolvableText`\n // is then placed AFTER the spread so the failover-decorated fetch wins —\n // unlike segments, playlists expose no overridable per-type fetch.\n const trackConfig = { ...VIDEO_TRACK_RESOLUTION_CONFIG, ...config };\n return setupTrackResolution({\n state,\n config: { ...trackConfig, fetchResolvableText: failoverFetch(defaultFetchResolvableText, state, trackConfig) },\n });\n },\n});\n\n/**\n * Resolve unresolved audio tracks. Same shape as `resolveVideoTrack`,\n * narrowed to audio.\n */\nexport const resolveAudioTrack = defineBehavior({\n stateKeys: ['presentation', 'selectedAudioTrackId'],\n contextKeys: [],\n setup: ({\n state,\n config = {},\n }: {\n state: ResolveTrackStateMap<'selectedAudioTrackId'>;\n config?: ResolveTrackConfig;\n }) => {\n // Key order is load-bearing — see resolveVideoTrack.\n const trackConfig = { ...AUDIO_TRACK_RESOLUTION_CONFIG, ...config };\n return setupTrackResolution({\n state,\n config: { ...trackConfig, fetchResolvableText: failoverFetch(defaultFetchResolvableText, state, trackConfig) },\n });\n },\n});\n\n/**\n * Resolve unresolved text tracks. Same shape as `resolveVideoTrack`,\n * narrowed to text.\n */\nexport const resolveTextTrack = defineBehavior({\n stateKeys: ['presentation', 'selectedTextTrackId'],\n contextKeys: [],\n setup: ({\n state,\n config = {},\n }: {\n state: ResolveTrackStateMap<'selectedTextTrackId'>;\n config?: ResolveTrackConfig;\n }) => {\n // Key order is load-bearing — see resolveVideoTrack.\n const trackConfig = { ...TEXT_TRACK_RESOLUTION_CONFIG, ...config };\n return setupTrackResolution({\n state,\n config: { ...trackConfig, fetchResolvableText: failoverFetch(defaultFetchResolvableText, state, trackConfig) },\n });\n },\n});\n"],"mappings":";;;;;;;;;;;AA6DA,SAAS,qBAAiD,EACxD,OACA,QAAQ,EAAE,aAAa,oBAAoB,qBAAA,wBAAsBA,yBAIhE;CAID,MAAM,SAAS,IAAI,kBAAkB;CAWrC,MAAM,qBAAqB,eACzB,uBAAuB,MAAM,aAAa,KAAK,CAAC,GAC3C,0BACA,0BACN;AAED,QAAO,qBAAqB;EAC1B,SAAS;EACT,eAAe,mBAAmB,KAAK;EACvC,QAAQ;GACN,2BAA2B,EAAE;GAC7B,yBAAyB;IAOvB,mBAAmB,OAAO,UAAU;IACpC,SAAS,OACD;KAMJ,MAAM,eAAe,KAAK,MAAM,aAAa;KAC7C,MAAM,UAAU,MAAM,aAAa,KAAK;AACxC,SAAI,CAAC,gBAAgB,CAAC,QAAS;KAE/B,MAAM,QAAQ,mBAAmB,cAAc,QAAQ;AACvD,SAAI,CAAC,SAAS,gBAAgB,MAAM,CAAE;AAEtC,YAAO,SAGL,IAAI,KACF,OAAO,WAAW;MAMhB,MAAM,aAAa,mBADN,MAAMC,sBAAoB,OAAO,EAAE,QAAQ,CAAC,EACb,MAAM;AASlD,aAAO,MAAM,eAAe,YAAY;AACtC,WAAI,CAAC,uBAAuB,QAAQ,CAAE,QAAO;OAC7C,MAAM,UAAU,0BAA0B,SAAS,WAAW;AAS9D,cAAO,yBAAyB,IAAI,WAAW,SAAS,GACpD,uBAAuB,SAAS,WAAW,MAAM,WAAW,SAAS,GACrE;QACJ;QAEJ,EAAE,IAAI,MAAM,IAAI,CACjB,CACF;MAEJ;IACF;GACF;EACF,CAAC;;AAOJ,MAAM,gCAAgC;CACpC,GAAG;CACH,qBAAqB,cAAyC,YAC5D,UAAU,cAAc,SAAS,QAAQ;CAC5C;AAED,MAAM,gCAAgC;CACpC,GAAG;CACH,qBAAqB,cAAyC,YAC5D,UAAU,cAAc,SAAS,QAAQ;CAC5C;AAED,MAAM,+BAA+B;CACnC,GAAG;CACH,qBAAqB,cAAyC,YAC5D,UAAU,cAAc,QAAQ,QAAQ;CAC3C;;;;;;AAWD,MAAa,oBAAoB,eAAe;CAC9C,WAAW,CAAC,gBAAgB,uBAAuB;CACnD,aAAa,EAAE;CACf,QAAQ,EACN,OACA,SAAS,EAAE,OAIP;EAMJ,MAAM,cAAc;GAAE,GAAG;GAA+B,GAAG;GAAQ;AACnE,SAAO,qBAAqB;GAC1B;GACA,QAAQ;IAAE,GAAG;IAAa,qBAAqB,cAAcD,qBAA4B,OAAO,YAAY;IAAE;GAC/G,CAAC;;CAEL,CAAC;;;;;AAMF,MAAa,oBAAoB,eAAe;CAC9C,WAAW,CAAC,gBAAgB,uBAAuB;CACnD,aAAa,EAAE;CACf,QAAQ,EACN,OACA,SAAS,EAAE,OAIP;EAEJ,MAAM,cAAc;GAAE,GAAG;GAA+B,GAAG;GAAQ;AACnE,SAAO,qBAAqB;GAC1B;GACA,QAAQ;IAAE,GAAG;IAAa,qBAAqB,cAAcA,qBAA4B,OAAO,YAAY;IAAE;GAC/G,CAAC;;CAEL,CAAC;;;;;AAMF,MAAa,mBAAmB,eAAe;CAC7C,WAAW,CAAC,gBAAgB,sBAAsB;CAClD,aAAa,EAAE;CACf,QAAQ,EACN,OACA,SAAS,EAAE,OAIP;EAEJ,MAAM,cAAc;GAAE,GAAG;GAA8B,GAAG;GAAQ;AAClE,SAAO,qBAAqB;GAC1B;GACA,QAAQ;IAAE,GAAG;IAAa,qBAAqB,cAAcA,qBAA4B,OAAO,YAAY;IAAE;GAC/G,CAAC;;CAEL,CAAC"}
@@ -0,0 +1,13 @@
1
+ import { TrackPicker, VideoSelectionConfig } from "../../media/primitives/select-tracks.js";
2
+
3
+ //#region src/playback/behaviors/select-tracks.d.ts
4
+ /**
5
+ * Config for `selectVideoTrack`. Pass `picker` to fully override selection
6
+ * logic; otherwise the default `pickFirstTrackId` is used.
7
+ */
8
+ interface SelectVideoTrackConfig extends VideoSelectionConfig {
9
+ picker?: TrackPicker<SelectVideoTrackConfig>;
10
+ }
11
+ //#endregion
12
+ export { SelectVideoTrackConfig };
13
+ //# sourceMappingURL=select-tracks.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"select-tracks.d.ts","names":[],"sources":["../../../../src/playback/behaviors/select-tracks.ts"],"mappings":";;;;;;;UA0IiB,sBAAA,SAA+B,oBAAA;EAC9C,MAAA,GAAS,WAAA,CAAY,sBAAA;AAAA"}
@@ -0,0 +1,101 @@
1
+ import { computed } from "../../core/signals/primitives.js";
2
+ import { defineBehavior } from "../../core/composition/create-composition.js";
3
+ import { createMachineReactor } from "../../core/reactors/create-machine-reactor.js";
4
+ import { isResolvedPresentation } from "../../media/types/index.js";
5
+ import { AUDIO_TYPE_CONFIG, VIDEO_TYPE_CONFIG } from "../primitives/track-types.js";
6
+ import { pickAudioTrack, pickFirstTrackId } from "../../media/primitives/select-tracks.js";
7
+ //#region src/playback/behaviors/select-tracks.ts
8
+ /**
9
+ * **Default audio/video track selection on src load / unselect on src unload.**
10
+ * When a presentation is resolved, sets `selectedVideoTrackId` /
11
+ * `selectedAudioTrackId` to a per-type-picker default if no selection already
12
+ * exists. When the presentation is unset/reset (transitions back to unresolved),
13
+ * clears the selection so a stale id from the previous source doesn't persist.
14
+ *
15
+ * Lifecycle-driven: each transition fires its work once. Does not police the
16
+ * selection between transitions; external writes (user picks, ABR, programmatic
17
+ * filter-driven re-picks) are left alone.
18
+ *
19
+ * Picker is config-driven: each per-type export wires a sensible default
20
+ * (`pickAudioTrack` for audio — three-tier language-aware; `pickFirstTrackId`
21
+ * for video) and the caller can supply their own via `config.picker` for custom
22
+ * selection logic. The behavior's `config` is forwarded to the picker as its
23
+ * second argument, so options like `preferredAudioLanguage` reach the picker
24
+ * without an intermediate wrapping layer.
25
+ *
26
+ * Compose `selectVideoTrack` for the simple "pick a default video track"
27
+ * behavior, or `switchVideoTrack` (`./track-switching.ts`) for the
28
+ * ABR-driven variant. Compose `selectAudioTrack` for the simple default
29
+ * pick, or `switchAudioTrack` (`./track-switching.ts`) for the
30
+ * filter-reactive + mid-stream-flush slot-owner variant — when audio-abr
31
+ * lands, `switchAudioTrack` extends into `switchAudioQuality`. Compose
32
+ * only one per type — they're alternatives, not stackable (each writes
33
+ * the same `selected*TrackId` slot). The simple variants tree-shake out
34
+ * the heavier machinery (bandwidth estimator, quality selection, flush
35
+ * orchestration).
36
+ *
37
+ * Text selection has no simple variant here — it's owned by `switchTextTrack`
38
+ * (`./track-switching.ts`), which resolves standing `userTextTrackSelection`
39
+ * intent against the constrained, CDN-scoped renditions.
40
+ */
41
+ function setupTrackSelection({ state, config: { selectedKey, picker, pickerConfig } }) {
42
+ const derivedStateSignal = computed(() => isResolvedPresentation(state.presentation.get()) ? "presentation-resolved" : "presentation-unresolved");
43
+ return createMachineReactor({
44
+ initial: "presentation-unresolved",
45
+ monitor: () => derivedStateSignal.get(),
46
+ states: {
47
+ "presentation-unresolved": {},
48
+ "presentation-resolved": { entry: () => {
49
+ if (!state[selectedKey].get()) {
50
+ const id = picker(state.presentation.get(), pickerConfig);
51
+ if (id) state[selectedKey].set(id);
52
+ }
53
+ return () => state[selectedKey].set(void 0);
54
+ } }
55
+ }
56
+ });
57
+ }
58
+ /** Default video picker: first track in the video selection set. */
59
+ const defaultVideoPicker = (presentation) => pickFirstTrackId(presentation, "video");
60
+ /**
61
+ * Select a video track when a presentation loads. Clears the selection on
62
+ * src unload.
63
+ *
64
+ * This is the simple, non-ABR counterpart to `switchVideoTrack` — compose
65
+ * one or the other, not both (both write `selectedVideoTrackId`). Composing
66
+ * `selectVideoTrack` alone tree-shakes out the ABR code path
67
+ * (bandwidth-estimator, quality-selection); use it for sources without
68
+ * meaningful quality variants, test setups, or players that intentionally
69
+ * pin a quality.
70
+ *
71
+ * @example
72
+ * const reactor = selectVideoTrack.setup({ state });
73
+ */
74
+ const selectVideoTrack = defineBehavior({
75
+ stateKeys: ["presentation", "selectedVideoTrackId"],
76
+ contextKeys: [],
77
+ setup: ({ state, config }) => setupTrackSelection({
78
+ state,
79
+ config: {
80
+ selectedKey: VIDEO_TYPE_CONFIG.selectedKey,
81
+ picker: config?.picker ?? defaultVideoPicker,
82
+ pickerConfig: config
83
+ }
84
+ })
85
+ });
86
+ defineBehavior({
87
+ stateKeys: ["presentation", "selectedAudioTrackId"],
88
+ contextKeys: [],
89
+ setup: ({ state, config }) => setupTrackSelection({
90
+ state,
91
+ config: {
92
+ selectedKey: AUDIO_TYPE_CONFIG.selectedKey,
93
+ picker: config?.picker ?? pickAudioTrack,
94
+ pickerConfig: config
95
+ }
96
+ })
97
+ });
98
+ //#endregion
99
+ export { selectVideoTrack };
100
+
101
+ //# sourceMappingURL=select-tracks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"select-tracks.js","names":[],"sources":["../../../../src/playback/behaviors/select-tracks.ts"],"sourcesContent":["/**\n * **Default audio/video track selection on src load / unselect on src unload.**\n * When a presentation is resolved, sets `selectedVideoTrackId` /\n * `selectedAudioTrackId` to a per-type-picker default if no selection already\n * exists. When the presentation is unset/reset (transitions back to unresolved),\n * clears the selection so a stale id from the previous source doesn't persist.\n *\n * Lifecycle-driven: each transition fires its work once. Does not police the\n * selection between transitions; external writes (user picks, ABR, programmatic\n * filter-driven re-picks) are left alone.\n *\n * Picker is config-driven: each per-type export wires a sensible default\n * (`pickAudioTrack` for audio — three-tier language-aware; `pickFirstTrackId`\n * for video) and the caller can supply their own via `config.picker` for custom\n * selection logic. The behavior's `config` is forwarded to the picker as its\n * second argument, so options like `preferredAudioLanguage` reach the picker\n * without an intermediate wrapping layer.\n *\n * Compose `selectVideoTrack` for the simple \"pick a default video track\"\n * behavior, or `switchVideoTrack` (`./track-switching.ts`) for the\n * ABR-driven variant. Compose `selectAudioTrack` for the simple default\n * pick, or `switchAudioTrack` (`./track-switching.ts`) for the\n * filter-reactive + mid-stream-flush slot-owner variant — when audio-abr\n * lands, `switchAudioTrack` extends into `switchAudioQuality`. Compose\n * only one per type — they're alternatives, not stackable (each writes\n * the same `selected*TrackId` slot). The simple variants tree-shake out\n * the heavier machinery (bandwidth estimator, quality selection, flush\n * orchestration).\n *\n * Text selection has no simple variant here — it's owned by `switchTextTrack`\n * (`./track-switching.ts`), which resolves standing `userTextTrackSelection`\n * intent against the constrained, CDN-scoped renditions.\n */\n\nimport { defineBehavior } from '../../core/composition/create-composition';\nimport { createMachineReactor } from '../../core/reactors/create-machine-reactor';\nimport { computed, type ReadonlySignal, type Signal } from '../../core/signals/primitives';\nimport {\n type AudioSelectionConfig,\n pickAudioTrack,\n pickFirstTrackId,\n type TrackPicker,\n type TrackSelectionState,\n type VideoSelectionConfig,\n} from '../../media/primitives/select-tracks';\nimport { isResolvedPresentation } from '../../media/types';\nimport { AUDIO_TYPE_CONFIG, VIDEO_TYPE_CONFIG } from '../primitives/track-types';\n\n// ============================================================================\n// Specialization helper\n//\n// `setupTrackSelection` has the same shape as a Behavior `setup` function:\n// `({ state, config }) => Reactor`. Each `selectXTrack` export below calls\n// it from inside its own `defineBehavior` setup, supplying its per-type\n// `selectedKey`, default picker, and forwarded picker config. The lifecycle\n// — pick on entering 'presentation-resolved' if not already selected; clear\n// on entering 'presentation-unresolved' — is shared.\n// ============================================================================\n\ntype SelectedTrackKey = 'selectedVideoTrackId' | 'selectedAudioTrackId';\n\ntype SelectStateMap<K extends SelectedTrackKey> = {\n presentation: ReadonlySignal<TrackSelectionState['presentation']>;\n} & { [P in K]: Signal<TrackSelectionState[P]> };\n\ninterface TrackSelectionSetupConfig<K extends SelectedTrackKey, PickerConfig> {\n selectedKey: K;\n picker: TrackPicker<PickerConfig>;\n pickerConfig?: PickerConfig;\n}\n\nfunction setupTrackSelection<K extends SelectedTrackKey, PickerConfig>({\n state,\n config: { selectedKey, picker, pickerConfig },\n}: {\n state: SelectStateMap<K>;\n config: TrackSelectionSetupConfig<K, PickerConfig>;\n}) {\n const derivedStateSignal = computed(() =>\n isResolvedPresentation(state.presentation.get())\n ? ('presentation-resolved' as const)\n : ('presentation-unresolved' as const)\n );\n\n return createMachineReactor({\n initial: 'presentation-unresolved',\n monitor: () => derivedStateSignal.get(),\n states: {\n 'presentation-unresolved': {},\n 'presentation-resolved': {\n // Entry: pick a default on entering presentation-resolved if none\n // is set. External writes (user picks, ABR) that already populated\n // the slot are left alone.\n //\n // The returned cleanup runs on state exit — which fires on src\n // unload (presentation-resolved → presentation-unresolved) AND on\n // behavior destroy (presentation-resolved → destroying →\n // destroyed). Putting the clear here rather than as\n // presentation-unresolved.entry is more cohesive (operation +\n // cleanup co-located) and correctly covers destroy (destroy\n // doesn't pass through presentation-unresolved).\n entry: () => {\n if (!state[selectedKey].get()) {\n // `state.presentation.get()` is non-null inside this entry —\n // the reactor's `'presentation-resolved'` gate is exactly\n // `isResolvedPresentation(state.presentation.get())`, which\n // requires a truthy Presentation.\n const id = picker(state.presentation.get()!, pickerConfig);\n if (id) state[selectedKey].set(id);\n }\n return () => state[selectedKey].set(undefined);\n },\n },\n },\n });\n}\n\n// ============================================================================\n// Default pickers\n//\n// Each variant resolves its picker as `config?.picker ?? <default>` and\n// forwards the whole engine config as `pickerConfig`, so a rich picker\n// (`pickAudioTrack`) reads its options directly. Audio uses its primitive\n// picker as-is; video adapts `pickFirstTrackId` (positional `type` arg) into\n// the `TrackPicker` shape.\n// ============================================================================\n\n/** Default video picker: first track in the video selection set. */\nconst defaultVideoPicker: TrackPicker = (presentation) => pickFirstTrackId(presentation, 'video');\n\n// ============================================================================\n// Specialized exports — one per track type\n// ============================================================================\n\n/**\n * Config for `selectVideoTrack`. Pass `picker` to fully override selection\n * logic; otherwise the default `pickFirstTrackId` is used.\n */\nexport interface SelectVideoTrackConfig extends VideoSelectionConfig {\n picker?: TrackPicker<SelectVideoTrackConfig>;\n}\n\n/**\n * Select a video track when a presentation loads. Clears the selection on\n * src unload.\n *\n * This is the simple, non-ABR counterpart to `switchVideoTrack` — compose\n * one or the other, not both (both write `selectedVideoTrackId`). Composing\n * `selectVideoTrack` alone tree-shakes out the ABR code path\n * (bandwidth-estimator, quality-selection); use it for sources without\n * meaningful quality variants, test setups, or players that intentionally\n * pin a quality.\n *\n * @example\n * const reactor = selectVideoTrack.setup({ state });\n */\nexport const selectVideoTrack = defineBehavior({\n stateKeys: ['presentation', 'selectedVideoTrackId'],\n contextKeys: [],\n setup: ({ state, config }: { state: SelectStateMap<'selectedVideoTrackId'>; config?: SelectVideoTrackConfig }) =>\n setupTrackSelection({\n state,\n config: {\n selectedKey: VIDEO_TYPE_CONFIG.selectedKey,\n picker: config?.picker ?? defaultVideoPicker,\n pickerConfig: config,\n },\n }),\n});\n\n/**\n * Config for `selectAudioTrack`. Pass `picker` to fully override selection\n * logic; otherwise the default `pickAudioTrack` is used (three-tier:\n * `preferredAudioLanguage` → `DEFAULT=YES` → first track).\n */\nexport interface SelectAudioTrackConfig extends AudioSelectionConfig {\n picker?: TrackPicker<SelectAudioTrackConfig>;\n}\n\n/**\n * Select an audio track when a presentation loads. Clears the selection\n * on src unload.\n *\n * This is the simple, lifecycle-only counterpart to `switchAudioTrack`\n * (in `./track-switching.ts`) — compose one or the other, not both\n * (both write `selectedAudioTrackId`). `switchAudioTrack` adds\n * filter-reactivity (`userAudioTrackSelection`) and mid-stream-flush\n * orchestration; `selectAudioTrack` covers the default-on-load case\n * without those. Use this variant for test setups, audio-only flows\n * that don't expose language switching, or composition variants that\n * intentionally pin a track.\n *\n * @example\n * const reactor = selectAudioTrack.setup({ state });\n *\n * @example\n * // Custom picker with language preference\n * const reactor = selectAudioTrack.setup({\n * state,\n * config: { preferredAudioLanguage: 'en', picker: myLanguageAwarePicker },\n * });\n */\nexport const selectAudioTrack = defineBehavior({\n stateKeys: ['presentation', 'selectedAudioTrackId'],\n contextKeys: [],\n setup: ({ state, config }: { state: SelectStateMap<'selectedAudioTrackId'>; config?: SelectAudioTrackConfig }) =>\n setupTrackSelection({\n state,\n config: {\n selectedKey: AUDIO_TYPE_CONFIG.selectedKey,\n picker: config?.picker ?? pickAudioTrack,\n pickerConfig: config,\n },\n }),\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuEA,SAAS,oBAA8D,EACrE,OACA,QAAQ,EAAE,aAAa,QAAQ,kBAI9B;CACD,MAAM,qBAAqB,eACzB,uBAAuB,MAAM,aAAa,KAAK,CAAC,GAC3C,0BACA,0BACN;AAED,QAAO,qBAAqB;EAC1B,SAAS;EACT,eAAe,mBAAmB,KAAK;EACvC,QAAQ;GACN,2BAA2B,EAAE;GAC7B,yBAAyB,EAYvB,aAAa;AACX,QAAI,CAAC,MAAM,aAAa,KAAK,EAAE;KAK7B,MAAM,KAAK,OAAO,MAAM,aAAa,KAAK,EAAG,aAAa;AAC1D,SAAI,GAAI,OAAM,aAAa,IAAI,GAAG;;AAEpC,iBAAa,MAAM,aAAa,IAAI,KAAA,EAAU;MAEjD;GACF;EACF,CAAC;;;AAcJ,MAAM,sBAAmC,iBAAiB,iBAAiB,cAAc,QAAQ;;;;;;;;;;;;;;;AA4BjG,MAAa,mBAAmB,eAAe;CAC7C,WAAW,CAAC,gBAAgB,uBAAuB;CACnD,aAAa,EAAE;CACf,QAAQ,EAAE,OAAO,aACf,oBAAoB;EAClB;EACA,QAAQ;GACN,aAAa,kBAAkB;GAC/B,QAAQ,QAAQ,UAAU;GAC1B,cAAc;GACf;EACF,CAAC;CACL,CAAC;AAkC8B,eAAe;CAC7C,WAAW,CAAC,gBAAgB,uBAAuB;CACnD,aAAa,EAAE;CACf,QAAQ,EAAE,OAAO,aACf,oBAAoB;EAClB;EACA,QAAQ;GACN,aAAa,kBAAkB;GAC/B,QAAQ,QAAQ,UAAU;GAC1B,cAAc;GACf;EACF,CAAC;CACL,CAAC"}
@@ -0,0 +1,12 @@
1
+ //#region src/playback/behaviors/setup-failover-monitor.d.ts
2
+ /**
3
+ * Failover policy: how long a CDN stays excluded after a failed fetch trips it.
4
+ * Supplied via engine config.
5
+ */
6
+ interface FailoverMonitorConfig {
7
+ /** How long a tripped CDN stays excluded, in milliseconds. */
8
+ cooldownMs: number;
9
+ }
10
+ //#endregion
11
+ export { FailoverMonitorConfig };
12
+ //# sourceMappingURL=setup-failover-monitor.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"setup-failover-monitor.d.ts","names":[],"sources":["../../../../src/playback/behaviors/setup-failover-monitor.ts"],"mappings":";;;;;UA0BiB,qBAAA;;EAEf,UAAA;AAAA"}
@@ -0,0 +1,66 @@
1
+ import { computed, update } from "../../core/signals/primitives.js";
2
+ import { defineBehavior } from "../../core/composition/create-composition.js";
3
+ import { createMachineReactor } from "../../core/reactors/create-machine-reactor.js";
4
+ import { isResolvedPresentation } from "../../media/types/index.js";
5
+ //#region src/playback/behaviors/setup-failover-monitor.ts
6
+ /**
7
+ * **CDN failover cooldown.** The expiry half of multi-CDN failover. Fetch sites
8
+ * own the *trip*: on a failed fetch they add the failing CDN (origin) to the
9
+ * `failedCdns` state signal directly. This behavior owns the *expiry*: while a
10
+ * presentation is resolved, it watches `failedCdns` and, for each CDN that
11
+ * appears, schedules a timer to remove it once its cooldown lapses.
12
+ * `track-switching`'s `excludeFailedCdns` constraint prunes a failed CDN's
13
+ * tracks and the active-CDN scope falls to the next one — and back, once the
14
+ * cooldown removes it here.
15
+ *
16
+ * Lifecycle is per-source: timers + `failedCdns` are cleared on exit (a new
17
+ * source starts with a clean slate). Policy (cooldown) is engine config. This is
18
+ * the minimal `network-resilience` slice — a single failure trips a CDN, since
19
+ * transient blips are the retry layer's job (it sits below the fetch sites, so
20
+ * anything that reaches `failedCdns` is already terminal).
21
+ */
22
+ const DEFAULT_FAILOVER_MONITOR_CONFIG = { cooldownMs: 3e5 };
23
+ /**
24
+ * Expire failed CDNs from `failedCdns` once their cooldown lapses, for the
25
+ * resolved source.
26
+ *
27
+ * @example
28
+ * const reactor = setupFailoverMonitor.setup({ state });
29
+ */
30
+ const setupFailoverMonitor = defineBehavior({
31
+ stateKeys: ["presentation", "failedCdns"],
32
+ contextKeys: [],
33
+ setup: ({ state, config = {} }) => {
34
+ const cooldownMs = config.failover?.cooldownMs ?? DEFAULT_FAILOVER_MONITOR_CONFIG.cooldownMs;
35
+ const timers = /* @__PURE__ */ new Map();
36
+ const derivedStateSignal = computed(() => isResolvedPresentation(state.presentation.get()) ? "presentation-resolved" : "presentation-unresolved");
37
+ return createMachineReactor({
38
+ initial: "presentation-unresolved",
39
+ monitor: () => derivedStateSignal.get(),
40
+ states: {
41
+ "presentation-unresolved": {},
42
+ "presentation-resolved": {
43
+ entry: () => () => {
44
+ timers.forEach((timer) => clearTimeout(timer));
45
+ timers.clear();
46
+ state.failedCdns.set(void 0);
47
+ },
48
+ effects: [() => {
49
+ (state.failedCdns.get() ?? []).forEach((cdn) => {
50
+ if (timers.has(cdn)) return;
51
+ const timer = setTimeout(() => {
52
+ timers.delete(cdn);
53
+ update(state.failedCdns, (current) => current?.filter((c) => c !== cdn));
54
+ }, cooldownMs);
55
+ timers.set(cdn, timer);
56
+ });
57
+ }]
58
+ }
59
+ }
60
+ });
61
+ }
62
+ });
63
+ //#endregion
64
+ export { setupFailoverMonitor };
65
+
66
+ //# sourceMappingURL=setup-failover-monitor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"setup-failover-monitor.js","names":[],"sources":["../../../../src/playback/behaviors/setup-failover-monitor.ts"],"sourcesContent":["/**\n * **CDN failover cooldown.** The expiry half of multi-CDN failover. Fetch sites\n * own the *trip*: on a failed fetch they add the failing CDN (origin) to the\n * `failedCdns` state signal directly. This behavior owns the *expiry*: while a\n * presentation is resolved, it watches `failedCdns` and, for each CDN that\n * appears, schedules a timer to remove it once its cooldown lapses.\n * `track-switching`'s `excludeFailedCdns` constraint prunes a failed CDN's\n * tracks and the active-CDN scope falls to the next one — and back, once the\n * cooldown removes it here.\n *\n * Lifecycle is per-source: timers + `failedCdns` are cleared on exit (a new\n * source starts with a clean slate). Policy (cooldown) is engine config. This is\n * the minimal `network-resilience` slice — a single failure trips a CDN, since\n * transient blips are the retry layer's job (it sits below the fetch sites, so\n * anything that reaches `failedCdns` is already terminal).\n */\n\nimport { defineBehavior } from '../../core/composition/create-composition';\nimport { createMachineReactor } from '../../core/reactors/create-machine-reactor';\nimport { computed, type ReadonlySignal, type Signal, update } from '../../core/signals/primitives';\nimport { isResolvedPresentation, type MaybeResolvedPresentation } from '../../media/types';\n\n/**\n * Failover policy: how long a CDN stays excluded after a failed fetch trips it.\n * Supplied via engine config.\n */\nexport interface FailoverMonitorConfig {\n /** How long a tripped CDN stays excluded, in milliseconds. */\n cooldownMs: number;\n}\n\nexport const DEFAULT_FAILOVER_MONITOR_CONFIG: FailoverMonitorConfig = {\n // 5 minutes — a CDN outage is an infrastructure problem that outlasts a\n // transient blip, so re-probing it sooner mostly re-trips. Matches the\n // prevailing prior-art default (ExoPlayer's location exclusion, hls.js's\n // content-steering penalty box).\n cooldownMs: 300_000,\n};\n\nexport interface SetupFailoverMonitorState {\n presentation?: MaybeResolvedPresentation;\n failedCdns?: string[];\n}\n\nexport interface SetupFailoverMonitorConfig {\n /** Failover policy (cooldown); defaults to `DEFAULT_FAILOVER_MONITOR_CONFIG`. */\n failover?: Partial<FailoverMonitorConfig>;\n}\n\n/**\n * Expire failed CDNs from `failedCdns` once their cooldown lapses, for the\n * resolved source.\n *\n * @example\n * const reactor = setupFailoverMonitor.setup({ state });\n */\nexport const setupFailoverMonitor = defineBehavior({\n stateKeys: ['presentation', 'failedCdns'],\n contextKeys: [],\n setup: ({\n state,\n config = {},\n }: {\n state: {\n presentation: ReadonlySignal<SetupFailoverMonitorState['presentation']>;\n failedCdns: Signal<SetupFailoverMonitorState['failedCdns']>;\n };\n config?: SetupFailoverMonitorConfig;\n }) => {\n const cooldownMs = config.failover?.cooldownMs ?? DEFAULT_FAILOVER_MONITOR_CONFIG.cooldownMs;\n // CDN id → its pending cooldown-removal timer. Shared by the `effects`\n // scheduler (adds a timer per newly-failed CDN) and the exit cleanup\n // (clears them). Per-source: emptied on exit, so it re-enters clean.\n const timers = new Map<string, ReturnType<typeof setTimeout>>();\n const derivedStateSignal = computed(() =>\n isResolvedPresentation(state.presentation.get())\n ? ('presentation-resolved' as const)\n : ('presentation-unresolved' as const)\n );\n\n return createMachineReactor({\n initial: 'presentation-unresolved',\n monitor: () => derivedStateSignal.get(),\n states: {\n 'presentation-unresolved': {},\n 'presentation-resolved': {\n // Cleanup-binds-to-setup: on exit (src unload + destroy) clear the\n // pending timers and reset `failedCdns` for the next source.\n entry: () => () => {\n timers.forEach((timer) => clearTimeout(timer));\n timers.clear();\n state.failedCdns.set(undefined);\n },\n effects: [\n () => {\n const failed = state.failedCdns.get() ?? [];\n failed.forEach((cdn) => {\n // Idempotent: a CDN already counting down keeps its original\n // deadline (re-failing it mid-cooldown doesn't extend it).\n if (timers.has(cdn)) return;\n const timer = setTimeout(() => {\n timers.delete(cdn);\n update(state.failedCdns, (current) => current?.filter((c) => c !== cdn));\n }, cooldownMs);\n timers.set(cdn, timer);\n });\n },\n ],\n },\n },\n });\n },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA+BA,MAAa,kCAAyD,EAKpE,YAAY,KACb;;;;;;;;AAmBD,MAAa,uBAAuB,eAAe;CACjD,WAAW,CAAC,gBAAgB,aAAa;CACzC,aAAa,EAAE;CACf,QAAQ,EACN,OACA,SAAS,EAAE,OAOP;EACJ,MAAM,aAAa,OAAO,UAAU,cAAc,gCAAgC;EAIlF,MAAM,yBAAS,IAAI,KAA4C;EAC/D,MAAM,qBAAqB,eACzB,uBAAuB,MAAM,aAAa,KAAK,CAAC,GAC3C,0BACA,0BACN;AAED,SAAO,qBAAqB;GAC1B,SAAS;GACT,eAAe,mBAAmB,KAAK;GACvC,QAAQ;IACN,2BAA2B,EAAE;IAC7B,yBAAyB;KAGvB,mBAAmB;AACjB,aAAO,SAAS,UAAU,aAAa,MAAM,CAAC;AAC9C,aAAO,OAAO;AACd,YAAM,WAAW,IAAI,KAAA,EAAU;;KAEjC,SAAS,OACD;AAEJ,OADe,MAAM,WAAW,KAAK,IAAI,EAAE,EACpC,SAAS,QAAQ;AAGtB,WAAI,OAAO,IAAI,IAAI,CAAE;OACrB,MAAM,QAAQ,iBAAiB;AAC7B,eAAO,OAAO,IAAI;AAClB,eAAO,MAAM,aAAa,YAAY,SAAS,QAAQ,MAAM,MAAM,IAAI,CAAC;UACvE,WAAW;AACd,cAAO,IAAI,KAAK,MAAM;QACtB;OAEL;KACF;IACF;GACF,CAAC;;CAEL,CAAC"}