@videojs/spf 10.0.0-beta.30 → 10.0.0-beta.32

package/dist/dev/playback/adapters/hls-background-video/host.js

@@ -1,24 +1,20 @@
 //#region src/playback/adapters/hls-background-video/host.ts
 /**
-* The `<video>` binding a background video uses: somewhere to keep the attached
-* element, and the four properties the Media fixes on it.
+* The `<video>` binding a background video uses: somewhere to keep the attached element, and the four properties the
+* Media fixes on it.
 *
-* That is the whole surface anything here reaches. The engine drives playback,
-* the element exposes `src` and nothing else, and the background player
-* subscribes to no store features, so nothing asks a background video for
-* `currentTime`, `play()`, picture-in-picture, fullscreen, forwarded events, or
-* media components. Holding the host to what is reachable is what keeps this
-* entry free of `@videojs/media`, and small enough to suit a component whose
-* whole pitch is its size.
+* That is the whole surface anything here reaches. The engine drives playback, the element exposes `src` and nothing
+* else, and the background player subscribes to no store features, so nothing asks a background video for
+* `currentTime`, `play()`, picture-in-picture, fullscreen, forwarded events, or media components. Holding the host to
+* what is reachable is what keeps this entry free of `@videojs/media`, and small enough to suit a component whose whole
+* pitch is its size.
 *
-* An `EventTarget`, because a Media is one: the store and the element layers
-* take anything they attach as an event source, and inheriting the three methods
-* satisfies that for free rather than by stubbing them.
+* An `EventTarget`, because a Media is one: the store and the element layers take anything they attach as an event
+* source, and inheriting the three methods satisfies that for free rather than by stubbing them.
 *
-* ⚠️ It still implements too little to carry the rest of the media surface, which
-* bounds what may consume it: a store feature reading a property outside this set
-* gets `undefined` rather than an error. A Media needing more of that surface
-* belongs on a host that provides it.
+* ⚠️ It still implements too little to carry the rest of the media surface, which bounds what may consume it: a store
+* feature reading a property outside this set gets `undefined` rather than an error. A Media needing more of that
+* surface belongs on a host that provides it.
 */
 var BackgroundVideoHost = class extends EventTarget {
 	#target = null;

package/dist/dev/playback/adapters/hls-background-video/host.js.map

@@ -1 +1 @@
-{"version":3,"file":"host.js","names":["#target"],"sources":["../../../../../src/playback/adapters/hls-background-video/host.ts"],"sourcesContent":["/**\n * The `<video>` binding a background video uses: somewhere to keep the attached\n * element, and the four properties the Media fixes on it.\n *\n * That is the whole surface anything here reaches. The engine drives playback,\n * the element exposes `src` and nothing else, and the background player\n * subscribes to no store features, so nothing asks a background video for\n * `currentTime`, `play()`, picture-in-picture, fullscreen, forwarded events, or\n * media components. Holding the host to what is reachable is what keeps this\n * entry free of `@videojs/media`, and small enough to suit a component whose\n * whole pitch is its size.\n *\n * An `EventTarget`, because a Media is one: the store and the element layers\n * take anything they attach as an event source, and inheriting the three methods\n * satisfies that for free rather than by stubbing them.\n *\n * ⚠️ It still implements too little to carry the rest of the media surface, which\n * bounds what may consume it: a store feature reading a property outside this set\n * gets `undefined` rather than an error. A Media needing more of that surface\n * belongs on a host that provides it.\n */\nexport class BackgroundVideoHost extends EventTarget {\n  #target: HTMLVideoElement | null = null;\n\n  attach(target: HTMLVideoElement): void {\n    if (!target || this.#target === target) return;\n    this.#target = target;\n  }\n\n  detach(): void {\n    this.#target = null;\n  }\n\n  // Read back off the element rather than stored, so they describe what is\n  // playing instead of what was asked for — see the adapter's note on why the\n  // Media declares none of these itself.\n  get loop(): boolean {\n    return this.#target?.loop ?? false;\n  }\n\n  set loop(value: boolean) {\n    if (this.#target) this.#target.loop = value;\n  }\n\n  get muted(): boolean {\n    return this.#target?.muted ?? false;\n  }\n\n  set muted(value: boolean) {\n    if (this.#target) this.#target.muted = value;\n  }\n\n  get autoplay(): boolean {\n    return this.#target?.autoplay ?? false;\n  }\n\n  set autoplay(value: boolean) {\n    if (this.#target) this.#target.autoplay = value;\n  }\n\n  get preload(): HTMLVideoElement['preload'] {\n    return this.#target?.preload ?? 'metadata';\n  }\n\n  set preload(value: HTMLVideoElement['preload']) {\n    if (this.#target) this.#target.preload = value;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAqBA,IAAa,sBAAb,cAAyC,YAAY;CACnD,UAAmC;CAEnC,OAAO,QAAgC;EACrC,IAAI,CAAC,UAAU,KAAKA,YAAY,QAAQ;EACxC,KAAKA,UAAU;CACjB;CAEA,SAAe;EACb,KAAKA,UAAU;CACjB;CAKA,IAAI,OAAgB;EAClB,OAAO,KAAKA,SAAS,QAAQ;CAC/B;CAEA,IAAI,KAAK,OAAgB;EACvB,IAAI,KAAKA,SAAS,KAAKA,QAAQ,OAAO;CACxC;CAEA,IAAI,QAAiB;EACnB,OAAO,KAAKA,SAAS,SAAS;CAChC;CAEA,IAAI,MAAM,OAAgB;EACxB,IAAI,KAAKA,SAAS,KAAKA,QAAQ,QAAQ;CACzC;CAEA,IAAI,WAAoB;EACtB,OAAO,KAAKA,SAAS,YAAY;CACnC;CAEA,IAAI,SAAS,OAAgB;EAC3B,IAAI,KAAKA,SAAS,KAAKA,QAAQ,WAAW;CAC5C;CAEA,IAAI,UAAuC;EACzC,OAAO,KAAKA,SAAS,WAAW;CAClC;CAEA,IAAI,QAAQ,OAAoC;EAC9C,IAAI,KAAKA,SAAS,KAAKA,QAAQ,UAAU;CAC3C;AACF"}
+{"version":3,"file":"host.js","names":["#target"],"sources":["../../../../../src/playback/adapters/hls-background-video/host.ts"],"sourcesContent":["/**\n * The `<video>` binding a background video uses: somewhere to keep the attached element, and the four properties the\n * Media fixes on it.\n *\n * That is the whole surface anything here reaches. The engine drives playback, the element exposes `src` and nothing\n * else, and the background player subscribes to no store features, so nothing asks a background video for\n * `currentTime`, `play()`, picture-in-picture, fullscreen, forwarded events, or media components. Holding the host to\n * what is reachable is what keeps this entry free of `@videojs/media`, and small enough to suit a component whose whole\n * pitch is its size.\n *\n * An `EventTarget`, because a Media is one: the store and the element layers take anything they attach as an event\n * source, and inheriting the three methods satisfies that for free rather than by stubbing them.\n *\n * ⚠️ It still implements too little to carry the rest of the media surface, which bounds what may consume it: a store\n * feature reading a property outside this set gets `undefined` rather than an error. A Media needing more of that\n * surface belongs on a host that provides it.\n */\nexport class BackgroundVideoHost extends EventTarget {\n  #target: HTMLVideoElement | null = null;\n\n  attach(target: HTMLVideoElement): void {\n    if (!target || this.#target === target) return;\n\n    this.#target = target;\n  }\n\n  detach(): void {\n    this.#target = null;\n  }\n\n  // Read back off the element rather than stored, so they describe what is\n  // playing instead of what was asked for — see the adapter's note on why the\n  // Media declares none of these itself.\n  get loop(): boolean {\n    return this.#target?.loop ?? false;\n  }\n\n  set loop(value: boolean) {\n    if (this.#target) this.#target.loop = value;\n  }\n\n  get muted(): boolean {\n    return this.#target?.muted ?? false;\n  }\n\n  set muted(value: boolean) {\n    if (this.#target) this.#target.muted = value;\n  }\n\n  get autoplay(): boolean {\n    return this.#target?.autoplay ?? false;\n  }\n\n  set autoplay(value: boolean) {\n    if (this.#target) this.#target.autoplay = value;\n  }\n\n  get preload(): HTMLVideoElement['preload'] {\n    return this.#target?.preload ?? 'metadata';\n  }\n\n  set preload(value: HTMLVideoElement['preload']) {\n    if (this.#target) this.#target.preload = value;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAiBA,IAAa,sBAAb,cAAyC,YAAY;CACnD,UAAmC;CAEnC,OAAO,QAAgC;EACrC,IAAI,CAAC,UAAU,KAAKA,YAAY,QAAQ;EAExC,KAAKA,UAAU;CACjB;CAEA,SAAe;EACb,KAAKA,UAAU;CACjB;CAKA,IAAI,OAAgB;EAClB,OAAO,KAAKA,SAAS,QAAQ;CAC/B;CAEA,IAAI,KAAK,OAAgB;EACvB,IAAI,KAAKA,SAAS,KAAKA,QAAQ,OAAO;CACxC;CAEA,IAAI,QAAiB;EACnB,OAAO,KAAKA,SAAS,SAAS;CAChC;CAEA,IAAI,MAAM,OAAgB;EACxB,IAAI,KAAKA,SAAS,KAAKA,QAAQ,QAAQ;CACzC;CAEA,IAAI,WAAoB;EACtB,OAAO,KAAKA,SAAS,YAAY;CACnC;CAEA,IAAI,SAAS,OAAgB;EAC3B,IAAI,KAAKA,SAAS,KAAKA,QAAQ,WAAW;CAC5C;CAEA,IAAI,UAAuC;EACzC,OAAO,KAAKA,SAAS,WAAW;CAClC;CAEA,IAAI,QAAQ,OAAoC;EAC9C,IAAI,KAAKA,SAAS,KAAKA,QAAQ,UAAU;CAC3C;AACF"}

package/dist/dev/playback/adapters/hls-background-video/media.d.ts

@@ -3,16 +3,13 @@ import { BackgroundVideoHost } from "./host.js";
 //#region src/playback/adapters/hls-background-video/media.d.ts
 declare const HlsBackgroundVideoMediaBase: import("@videojs/utils/types").MixinReturn<typeof BackgroundVideoHost, HlsBackgroundVideoMediaAPI>;
 /**
- * The background-video Media, bound to a `<video>` through
- * {@link BackgroundVideoHost}.
+ * The background-video Media, bound to a `<video>` through {@link BackgroundVideoHost}.
  *
- * That host carries the attached element and the four properties `attach` fixes,
- * which is all this Media's surface needs, and it is local — so this entry has
- * no `@videojs/media` dependency.
+ * That host carries the attached element and the four properties `attach` fixes, which is all this Media's surface
+ * needs, and it is local — so this entry has no `@videojs/media` dependency.
  *
- * No `MediaTracksMixin`, unlike `HlsVideoMedia`: the engine subtracts audio and
- * text entirely and pins one video rendition for the session, so there are no
- * track lists for a consumer to project or switch between.
+ * No `MediaTracksMixin`, unlike `HlsVideoMedia`: the engine subtracts audio and text entirely and pins one video
+ * rendition for the session, so there are no track lists for a consumer to project or switch between.
  */
 declare class HlsBackgroundVideoMedia extends HlsBackgroundVideoMediaBase {}
 //#endregion

package/dist/dev/playback/adapters/hls-background-video/media.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"media.d.ts","names":[],"sources":["../../../../../src/playback/adapters/hls-background-video/media.ts"],"mappings":";;;cAGM,4DAA2B,mBAAA,qBAAA;;;;;;;;;;;;;cAcpB,gCAAgC"}
+{"version":3,"file":"media.d.ts","names":[],"sources":["../../../../../src/playback/adapters/hls-background-video/media.ts"],"mappings":";;;cAGM,4DAA2B,mBAAA,qBAAA;;;;;;;;;;cAWpB,gCAAgC"}

package/dist/dev/playback/adapters/hls-background-video/media.js

@@ -3,16 +3,13 @@ import { BackgroundVideoHost } from "./host.js";
 //#region src/playback/adapters/hls-background-video/media.ts
 const HlsBackgroundVideoMediaBase = HlsBackgroundVideoMediaMixin(BackgroundVideoHost);
 /**
-* The background-video Media, bound to a `<video>` through
-* {@link BackgroundVideoHost}.
+* The background-video Media, bound to a `<video>` through {@link BackgroundVideoHost}.
 *
-* That host carries the attached element and the four properties `attach` fixes,
-* which is all this Media's surface needs, and it is local — so this entry has
-* no `@videojs/media` dependency.
+* That host carries the attached element and the four properties `attach` fixes, which is all this Media's surface
+* needs, and it is local — so this entry has no `@videojs/media` dependency.
 *
-* No `MediaTracksMixin`, unlike `HlsVideoMedia`: the engine subtracts audio and
-* text entirely and pins one video rendition for the session, so there are no
-* track lists for a consumer to project or switch between.
+* No `MediaTracksMixin`, unlike `HlsVideoMedia`: the engine subtracts audio and text entirely and pins one video
+* rendition for the session, so there are no track lists for a consumer to project or switch between.
 */
 var HlsBackgroundVideoMedia = class extends HlsBackgroundVideoMediaBase {};
 //#endregion

package/dist/dev/playback/adapters/hls-background-video/media.js.map

@@ -1 +1 @@
-{"version":3,"file":"media.js","names":[],"sources":["../../../../../src/playback/adapters/hls-background-video/media.ts"],"sourcesContent":["import { HlsBackgroundVideoMediaMixin } from './adapter';\nimport { BackgroundVideoHost } from './host';\n\nconst HlsBackgroundVideoMediaBase = HlsBackgroundVideoMediaMixin(BackgroundVideoHost);\n\n/**\n * The background-video Media, bound to a `<video>` through\n * {@link BackgroundVideoHost}.\n *\n * That host carries the attached element and the four properties `attach` fixes,\n * which is all this Media's surface needs, and it is local — so this entry has\n * no `@videojs/media` dependency.\n *\n * No `MediaTracksMixin`, unlike `HlsVideoMedia`: the engine subtracts audio and\n * text entirely and pins one video rendition for the session, so there are no\n * track lists for a consumer to project or switch between.\n */\nexport class HlsBackgroundVideoMedia extends HlsBackgroundVideoMediaBase {}\n"],"mappings":";;;AAGA,MAAM,8BAA8B,6BAA6B,mBAAmB;;;;;;;;;;;;;AAcpF,IAAa,0BAAb,cAA6C,4BAA4B,CAAC"}
+{"version":3,"file":"media.js","names":[],"sources":["../../../../../src/playback/adapters/hls-background-video/media.ts"],"sourcesContent":["import { HlsBackgroundVideoMediaMixin } from './adapter';\nimport { BackgroundVideoHost } from './host';\n\nconst HlsBackgroundVideoMediaBase = HlsBackgroundVideoMediaMixin(BackgroundVideoHost);\n\n/**\n * The background-video Media, bound to a `<video>` through {@link BackgroundVideoHost}.\n *\n * That host carries the attached element and the four properties `attach` fixes, which is all this Media's surface\n * needs, and it is local — so this entry has no `@videojs/media` dependency.\n *\n * No `MediaTracksMixin`, unlike `HlsVideoMedia`: the engine subtracts audio and text entirely and pins one video\n * rendition for the session, so there are no track lists for a consumer to project or switch between.\n */\nexport class HlsBackgroundVideoMedia extends HlsBackgroundVideoMediaBase {}\n"],"mappings":";;;AAGA,MAAM,8BAA8B,6BAA6B,mBAAmB;;;;;;;;;;AAWpF,IAAa,0BAAb,cAA6C,4BAA4B,CAAC"}

package/dist/dev/playback/adapters/hls-video/adapter.d.ts

@@ -5,9 +5,8 @@ import { MediaStreamType } from "@videojs/media";
 import { Constructor, MixinReturn } from "@videojs/utils/types";
 //#region src/playback/adapters/hls-video/adapter.d.ts
 /**
- * The media-level stream type: the engine's detected stream type (`'live'` /
- * `'on-demand'`) plus `'unknown'` for "no playlist parsed yet." `@videojs/media`'s
- * {@link MediaStreamType} itself, kept under its own name because that is what
+ * The media-level stream type: the engine's detected stream type (`'live'` / `'on-demand'`) plus `'unknown'` for "no
+ * playlist parsed yet." `@videojs/media`'s {@link MediaStreamType} itself, kept under its own name because that is what
  * this adapter's `streamType` property is documented against.
  */
 type HlsVideoMediaStreamType = MediaStreamType;
@@ -31,22 +30,21 @@ interface HlsVideoMediaAPI extends HlsVideoMediaProps {
 /**
  * Mixin that adds SPF playback engine behavior to any base class.
  *
- * Implements the src/play() contract per the WHATWG HTML spec so that SPF can
- * be used anywhere a media element API is expected.
+ * Implements the src/play() contract per the WHATWG HTML spec so that SPF can be used anywhere a media element API is
+ * expected.
  *
- * A single engine instance is created at construction and recycled across src
- * changes.
+ * A single engine instance is created at construction and recycled across src changes.
+ *
+ * @example
+ *   class HlsVideoMedia extends HlsVideoMediaMixin(HTMLVideoElementHost) {}
+ *
+ *   const media = new HlsVideoMedia();
+ *   media.attach(document.querySelector('video'));
+ *   media.src = 'https://stream.mux.com/abc123.m3u8';
  *
  * @fires streamtypechange - Fired when the detected stream type changes. Read `streamType` for the new value.
  * @fires targetlivewindowchange - Fired when the target live window changes. Read `targetLiveWindow` for the new value.
  * @fires error - Fired when a fatal condition is reported. Read `error` for it.
- *
- * @example
- * class HlsVideoMedia extends HlsVideoMediaMixin(HTMLVideoElementHost) {}
- *
- * const media = new HlsVideoMedia();
- * media.attach(document.querySelector('video'));
- * media.src = 'https://stream.mux.com/abc123.m3u8';
  */
 declare function HlsVideoMediaMixin<Base extends Constructor<any>>(BaseClass: Base): MixinReturn<Base, HlsVideoMediaAPI> & {
   readonly alternativeMediaSuggestion: string | undefined;

package/dist/dev/playback/adapters/hls-video/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","names":[],"sources":["../../../../../src/playback/adapters/hls-video/adapter.ts"],"mappings":";;;;;;;;;;;;KA6CY,0BAA0B;UAIrB;EACf;EACA;EACA;EACA,YAAY;;cAGD,2BAA2B;UAOvB,yBAAyB;WAC/B,QAAQ,YAAY,qBAAqB;WACzC,OAAO;WACP;WACA;EACT,OAAO,cAAc;EACrB;EACA;EACA,QAAQ;;;;;;;;;;;;;;;;;;;;;;iBA+DM,mBAAmB,aAAa,kBAAkB,WAAW,OAuXpC,YAAY,MAAM;WAC9C;;;;;WAA4B;;;cAK5B,6BAA6B"}
+{"version":3,"file":"adapter.d.ts","names":[],"sources":["../../../../../src/playback/adapters/hls-video/adapter.ts"],"mappings":";;;;;;;;;;;KA6CY,0BAA0B;UAIrB;EACf;EACA;EACA;EACA,YAAY;;cAGD,2BAA2B;UAOvB,yBAAyB;WAC/B,QAAQ,YAAY,qBAAqB;WACzC,OAAO;WACP;WACA;EACT,OAAO,cAAc;EACrB;EACA;EACA,QAAQ;;;;;;;;;;;;;;;;;;;;;iBA8DM,mBAAmB,aAAa,kBAAkB,WAAW,OA2XpC,YAAY,MAAM;WAC9C;;;;;WAA4B;;;cAK5B,6BAA6B"}

package/dist/dev/playback/adapters/hls-video/adapter.js

@@ -16,9 +16,8 @@ const hlsVideoMediaDefaultProps = {
 	streamType: MediaStreamTypes.UNKNOWN
 };
 /**
-* `targetLiveWindow` per the media-ui-extensions live-edge proposal: `NaN` for
-* on-demand (or nothing resolved yet), `0` for standard sliding-window live,
-* `Infinity` for DVR (`#EXT-X-PLAYLIST-TYPE:EVENT` — the window grows from the
+* `targetLiveWindow` per the media-ui-extensions live-edge proposal: `NaN` for on-demand (or nothing resolved yet), `0`
+* for standard sliding-window live, `Infinity` for DVR (`#EXT-X-PLAYLIST-TYPE:EVENT` — the window grows from the
 * start). Read from the timeline-bearing track's playlist metadata.
 */
 function deriveTargetLiveWindow(presentation, trackId) {
@@ -31,51 +30,45 @@ function deriveTargetLiveWindow(presentation, trackId) {
 	return deriveStreamType(metadata) === "live" ? 0 : NaN;
 }
 /**
-* Which reported conditions this composition treats as **fatal** — the ones that
-* reach `error` and fire `'error'`. Severity isn't part of an SVTA code
-* (§Approach: "impact varies with player implementation"), and here it also
-* varies by composition, so it's decided at this boundary rather than by the
-* reporter.
+* Which reported conditions this composition treats as **fatal** — the ones that reach `error` and fire `'error'`.
+* Severity isn't part of an SVTA code (§Approach: "impact varies with player implementation"), and here it also varies
+* by composition, so it's decided at this boundary rather than by the reporter.
 *
-* An allow-list, deliberately: only *verdicts* are here. The per-rendition causes
-* `resolve-track` reports (unsupported format, unsupported DRM) stay in the
-* sequence as context — one unplayable rendition doesn't fail the source, and
+* An allow-list, deliberately: only _verdicts_ are here. The per-rendition causes `resolve-track` reports (unsupported
+* format, unsupported DRM) stay in the sequence as context — one unplayable rendition doesn't fail the source, and
 * promoting a cause would put a dialog over a mixed source that goes on to play.
 */
 const FATAL_SVTA_CODES = /* @__PURE__ */ new Set([SVTA_NO_SUPPORTED_VIDEO_TRACK, SVTA_NO_SUPPORTED_AUDIO_TRACK]);
 /**
 * Mixin that adds SPF playback engine behavior to any base class.
 *
-* Implements the src/play() contract per the WHATWG HTML spec so that SPF can
-* be used anywhere a media element API is expected.
+* Implements the src/play() contract per the WHATWG HTML spec so that SPF can be used anywhere a media element API is
+* expected.
 *
-* A single engine instance is created at construction and recycled across src
-* changes.
+* A single engine instance is created at construction and recycled across src changes.
+*
+* @example
+*   class HlsVideoMedia extends HlsVideoMediaMixin(HTMLVideoElementHost) {}
+*
+*   const media = new HlsVideoMedia();
+*   media.attach(document.querySelector('video'));
+*   media.src = 'https://stream.mux.com/abc123.m3u8';
 *
 * @fires streamtypechange - Fired when the detected stream type changes. Read `streamType` for the new value.
 * @fires targetlivewindowchange - Fired when the target live window changes. Read `targetLiveWindow` for the new value.
 * @fires error - Fired when a fatal condition is reported. Read `error` for it.
-*
-* @example
-* class HlsVideoMedia extends HlsVideoMediaMixin(HTMLVideoElementHost) {}
-*
-* const media = new HlsVideoMedia();
-* media.attach(document.querySelector('video'));
-* media.src = 'https://stream.mux.com/abc123.m3u8';
 */
 function HlsVideoMediaMixin(BaseClass) {
 	class HlsVideoMediaImpl extends BaseClass {
 		/**
-		* A complete sentence naming the Media to reach for when this one can't play
-		* a source — `Try the hls.js-backed Mux media instead: import the hls-js
-		* flavor in place of the spf one.` Appended to the copy this adapter
-		* surfaces, and to the notices it logs. Name the flavor, not an import path:
-		* a Media is reached through several packages, each with its own counterpart.
+		* A complete sentence naming the Media to reach for when this one can't play a source — `Try the hls.js-backed Mux
+		* media instead: import the hls-js flavor in place of the spf one.` Appended to the copy this adapter surfaces, and
+		* to the notices it logs. Name the flavor, not an import path: a Media is reached through several packages, each
+		* with its own counterpart.
 		*
-		* Empty here: `hls-video` has no better-equipped sibling to point at.
-		* A Media that does (a Mux Video built on this engine, whose hls.js-backed
-		* counterpart plays MPEG-TS and DRM) overrides this static, and its copy gains
-		* the second sentence with no other change.
+		* Empty here: `hls-video` has no better-equipped sibling to point at. A Media that does (a Mux Video built on this
+		* engine, whose hls.js-backed counterpart plays MPEG-TS and DRM) overrides this static, and its copy gains the
+		* second sentence with no other change.
 		*/
 		static get alternativeMediaSuggestion() {}
 		#engine;
@@ -88,9 +81,8 @@ function HlsVideoMediaMixin(BaseClass) {
 		#targetLiveWindow = NaN;
 		#error = null;
 		/**
-		* The *reported* condition currently surfaced, which is what the re-fire
-		* latch keys on. Not `#error.code`: that's the code this adapter chose to
-		* surface, and a later cause can change the choice for a condition already
+		* The _reported_ condition currently surfaced, which is what the re-fire latch keys on. Not `#error.code`: that's
+		* the code this adapter chose to surface, and a later cause can change the choice for a condition already
 		* announced.
 		*/
 		#reportedCode = null;
@@ -117,27 +109,23 @@ function HlsVideoMediaMixin(BaseClass) {
 			});
 		}
 		/**
-		* Underlying playback engine — the low-level SPF reactive composition that
-		* drives playback. An advanced escape hatch for direct engine access;
-		* normal playback is driven through this element's own properties and
-		* methods.
+		* Underlying playback engine — the low-level SPF reactive composition that drives playback. An advanced escape
+		* hatch for direct engine access; normal playback is driven through this element's own properties and methods.
 		*/
 		get engine() {
 			return this.#engine;
 		}
 		/**
-		* The current fatal error, or `null`. Only *fatal* conditions appear here —
-		* the engine reports non-fatal ones too (they stay in `engine.state.errors`),
-		* and promoting them would tell a consumer playback had failed when it
+		* The current fatal error, or `null`. Only _fatal_ conditions appear here — the engine reports non-fatal ones too
+		* (they stay in `engine.state.errors`), and promoting them would tell a consumer playback had failed when it
 		* hadn't. Resets per source. Fires `'error'` when set.
 		*/
 		get error() {
 			return this.#error;
 		}
 		/**
-		* The source's stream type — `'live'`, `'on-demand'`, or `'unknown'` until
-		* a media playlist has been parsed. Setting a non-`'unknown'` value pins a
-		* user override (detection stops updating it); setting `'unknown'` reverts
+		* The source's stream type — `'live'`, `'on-demand'`, or `'unknown'` until a media playlist has been parsed.
+		* Setting a non-`'unknown'` value pins a user override (detection stops updating it); setting `'unknown'` reverts
 		* to the engine's detected value.
 		*/
 		get streamType() {
@@ -153,12 +141,10 @@ function HlsVideoMediaMixin(BaseClass) {
 			this.#updateStreamType(value);
 		}
 		/**
-		* Presentation time marking the start of the live-edge window — playback at
-		* `currentTime >= liveEdgeStart` counts as "at the live edge" (the same
-		* target the engine's `seekToLiveEdge` seeks to: window end − HOLD-BACK).
-		* `NaN` when the stream isn't live or nothing is resolved yet. Derived at
-		* read time from the engine's live window — no change event; re-read on
-		* `timeupdate`/`progress` (as the store's live feature does).
+		* Presentation time marking the start of the live-edge window — playback at `currentTime >= liveEdgeStart` counts
+		* as "at the live edge" (the same target the engine's `seekToLiveEdge` seeks to: window end − HOLD-BACK). `NaN`
+		* when the stream isn't live or nothing is resolved yet. Derived at read time from the engine's live window — no
+		* change event; re-read on `timeupdate`/`progress` (as the store's live feature does).
 		*/
 		get liveEdgeStart() {
 			return getLiveEdge({
@@ -167,9 +153,8 @@ function HlsVideoMediaMixin(BaseClass) {
 			})?.liveEdgeStart ?? NaN;
 		}
 		/**
-		* The target live window: `NaN` for on-demand (or unknown), `0` for
-		* standard sliding-window live, `Infinity` for DVR
-		* (`#EXT-X-PLAYLIST-TYPE:EVENT`). Fires `targetlivewindowchange` on change.
+		* The target live window: `NaN` for on-demand (or unknown), `0` for standard sliding-window live, `Infinity` for
+		* DVR (`#EXT-X-PLAYLIST-TYPE:EVENT`). Fires `targetlivewindowchange` on change.
 		*/
 		get targetLiveWindow() {
 			return this.#targetLiveWindow;
@@ -264,14 +249,12 @@ function HlsVideoMediaMixin(BaseClass) {
 			return withAlternativeMediaSuggestion(message, this);
 		}
 		/**
-		* Log what this engine is delivering differently from what the playlist asked
-		* for. Neither condition stops playback, so neither is an error — they go to
-		* the console rather than the error surface.
+		* Log what this engine is delivering differently from what the playlist asked for. Neither condition stops
+		* playback, so neither is an error — they go to the console rather than the error surface.
 		*
-		* Once per source, not per parse: a live playlist reloads every target
-		* duration, and the timeline track re-parses on each one. Keyed on the notice
-		* rather than latched with a boolean so the two are independent, and cleared
-		* when the presentation unresolves so the next source starts quiet.
+		* Once per source, not per parse: a live playlist reloads every target duration, and the timeline track re-parses
+		* on each one. Keyed on the notice rather than latched with a boolean so the two are independent, and cleared when
+		* the presentation unresolves so the next source starts quiet.
 		*/
 		#reportDeliveryNotices(presentation) {
 			if (!isResolvedPresentation(presentation)) {

package/dist/dev/playback/adapters/hls-video/adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.js","names":["#engine","#config","#createEngine","#stopLiveSync","#signals","#setDetectedStreamType","#setTargetLiveWindow","#reportDeliveryNotices","#stopErrorSync","#setError","#error","#streamType","#isUserStreamType","#updateStreamType","#targetLiveWindow","#reportedCode","#withSuggestion","#cancelPendingPlay","#preload","#disableRemotePlayback","#loadstartListener","#noticed"],"sources":["../../../../../src/playback/adapters/hls-video/adapter.ts"],"sourcesContent":["import { type MediaStreamType, MediaStreamTypes } from '@videojs/media';\nimport type { Constructor, MixinReturn } from '@videojs/utils/types';\nimport type { Composition } from '../../../core/composition/create-composition';\nimport { effect } from '../../../core/signals/effect';\nimport {\n  SVTA_NO_SUPPORTED_AUDIO_TRACK,\n  SVTA_NO_SUPPORTED_VIDEO_TRACK,\n  SVTA_UNSUPPORTED_PLAYBACK_FEATURE,\n  type SvtaError,\n} from '../../../media/errors';\nimport { resolveLiveLatency } from '../../../media/hls/reload-policy';\nimport {\n  deriveStreamType,\n  getMediaPlaylistMetadata,\n  isResolvedPresentation,\n  isResolvedTrack,\n  type MaybeResolvedPresentation,\n} from '../../../media/types';\nimport { findTrackById } from '../../../media/utils/tracks';\nimport {\n  createHlsVideoEngine,\n  type HlsVideoEngineConfig,\n  type HlsVideoEngineContext,\n  type HlsVideoEngineSignals,\n  type HlsVideoEngineState,\n} from '../../engines/hls/engine';\nimport {\n  DVR_EXPERIMENTAL_MESSAGE,\n  LOW_LATENCY_UNSUPPORTED_MESSAGE,\n  UNSUPPORTED_PLAYBACK_FEATURE_MESSAGE,\n} from '../../primitives/error-messages';\nimport { getLiveEdge, type LiveWindowState, liveTrackId } from '../../primitives/live-window';\nimport {\n  firstFatal,\n  type HlsVideoMediaError,\n  hasUnsupportedFeatureCause,\n  withAlternativeMediaSuggestion,\n} from './error-surface';\n\n/**\n * The media-level stream type: the engine's detected stream type (`'live'` /\n * `'on-demand'`) plus `'unknown'` for \"no playlist parsed yet.\" `@videojs/media`'s\n * {@link MediaStreamType} itself, kept under its own name because that is what\n * this adapter's `streamType` property is documented against.\n */\nexport type HlsVideoMediaStreamType = MediaStreamType;\n\nexport type { HlsVideoMediaError } from './error-surface';\n\nexport interface HlsVideoMediaProps {\n  src: string;\n  preload: '' | 'none' | 'metadata' | 'auto';\n  disableRemotePlayback: boolean;\n  streamType: HlsVideoMediaStreamType;\n}\n\nexport const hlsVideoMediaDefaultProps: HlsVideoMediaProps = {\n  src: '',\n  preload: '',\n  disableRemotePlayback: false,\n  streamType: MediaStreamTypes.UNKNOWN,\n};\n\nexport interface HlsVideoMediaAPI extends HlsVideoMediaProps {\n  readonly engine: Composition<HlsVideoEngineState, HlsVideoEngineContext>;\n  readonly error: HlsVideoMediaError | null;\n  readonly liveEdgeStart: number;\n  readonly targetLiveWindow: number;\n  attach(mediaElement: HTMLMediaElement): void;\n  detach(): void;\n  destroy(): void;\n  play(): Promise<void>;\n}\n\n/**\n * `targetLiveWindow` per the media-ui-extensions live-edge proposal: `NaN` for\n * on-demand (or nothing resolved yet), `0` for standard sliding-window live,\n * `Infinity` for DVR (`#EXT-X-PLAYLIST-TYPE:EVENT` — the window grows from the\n * start). Read from the timeline-bearing track's playlist metadata.\n */\nfunction deriveTargetLiveWindow(\n  presentation: MaybeResolvedPresentation | undefined,\n  trackId: string | undefined\n): number {\n  if (!isResolvedPresentation(presentation) || !trackId) return Number.NaN;\n  const track = findTrackById(presentation, trackId);\n  if (!track || !isResolvedTrack(track)) return Number.NaN;\n  const metadata = getMediaPlaylistMetadata(track);\n  if (!metadata) return Number.NaN;\n  if (metadata.playlistType === 'EVENT') return Number.POSITIVE_INFINITY;\n  return deriveStreamType(metadata) === 'live' ? 0 : Number.NaN;\n}\n\n// ============================================================================\n// Error surface\n// ============================================================================\n\n/**\n * Which reported conditions this composition treats as **fatal** — the ones that\n * reach `error` and fire `'error'`. Severity isn't part of an SVTA code\n * (§Approach: \"impact varies with player implementation\"), and here it also\n * varies by composition, so it's decided at this boundary rather than by the\n * reporter.\n *\n * An allow-list, deliberately: only *verdicts* are here. The per-rendition causes\n * `resolve-track` reports (unsupported format, unsupported DRM) stay in the\n * sequence as context — one unplayable rendition doesn't fail the source, and\n * promoting a cause would put a dialog over a mixed source that goes on to play.\n */\nconst FATAL_SVTA_CODES: ReadonlySet<number> = new Set<number>([\n  SVTA_NO_SUPPORTED_VIDEO_TRACK,\n  SVTA_NO_SUPPORTED_AUDIO_TRACK,\n]);\n\n/**\n * Mixin that adds SPF playback engine behavior to any base class.\n *\n * Implements the src/play() contract per the WHATWG HTML spec so that SPF can\n * be used anywhere a media element API is expected.\n *\n * A single engine instance is created at construction and recycled across src\n * changes.\n *\n * @fires streamtypechange - Fired when the detected stream type changes. Read `streamType` for the new value.\n * @fires targetlivewindowchange - Fired when the target live window changes. Read `targetLiveWindow` for the new value.\n * @fires error - Fired when a fatal condition is reported. Read `error` for it.\n *\n * @example\n * class HlsVideoMedia extends HlsVideoMediaMixin(HTMLVideoElementHost) {}\n *\n * const media = new HlsVideoMedia();\n * media.attach(document.querySelector('video'));\n * media.src = 'https://stream.mux.com/abc123.m3u8';\n */\nexport function HlsVideoMediaMixin<Base extends Constructor<any>>(BaseClass: Base) {\n  class HlsVideoMediaImpl extends BaseClass {\n    /**\n     * A complete sentence naming the Media to reach for when this one can't play\n     * a source — `Try the hls.js-backed Mux media instead: import the hls-js\n     * flavor in place of the spf one.` Appended to the copy this adapter\n     * surfaces, and to the notices it logs. Name the flavor, not an import path:\n     * a Media is reached through several packages, each with its own counterpart.\n     *\n     * Empty here: `hls-video` has no better-equipped sibling to point at.\n     * A Media that does (a Mux Video built on this engine, whose hls.js-backed\n     * counterpart plays MPEG-TS and DRM) overrides this static, and its copy gains\n     * the second sentence with no other change.\n     */\n    static get alternativeMediaSuggestion(): string | undefined {\n      return undefined;\n    }\n\n    readonly #engine: Composition<HlsVideoEngineState, HlsVideoEngineContext>;\n    #config: HlsVideoEngineConfig;\n    #signals!: HlsVideoEngineSignals;\n    #preload: '' | 'none' | 'metadata' | 'auto' = hlsVideoMediaDefaultProps.preload;\n    #disableRemotePlayback: boolean = hlsVideoMediaDefaultProps.disableRemotePlayback;\n    #streamType: HlsVideoMediaStreamType = hlsVideoMediaDefaultProps.streamType;\n    #isUserStreamType = false;\n    #targetLiveWindow = Number.NaN;\n    #error: HlsVideoMediaError | null = null;\n    /**\n     * The *reported* condition currently surfaced, which is what the re-fire\n     * latch keys on. Not `#error.code`: that's the code this adapter chose to\n     * surface, and a later cause can change the choice for a condition already\n     * announced.\n     */\n    #reportedCode: number | null = null;\n    /** Notices already logged for the current source; cleared when it unloads. */\n    #noticed = new Set<string>();\n    #stopLiveSync: () => void;\n    #stopErrorSync: () => void;\n\n    /** Pending loadstart listener from a deferred play() retry, if any. */\n    #loadstartListener: (() => void) | null = null;\n\n    constructor(...args: any[]) {\n      super(...args);\n\n      const { config } = args?.[0] ?? {};\n      this.#config = config;\n      this.#engine = this.#createEngine();\n\n      // Mirror the engine's live/stream-type detection onto the media surface,\n      // firing the change events the store features listen for. One effect over\n      // the presentation + selection signals; `liveEdgeStart` is deliberately\n      // NOT cached here — it's derived at read time (the store re-reads it on\n      // `timeupdate`/`progress`), so a sliding window needs no event churn.\n      this.#stopLiveSync = effect(() => {\n        const presentation = this.#signals.state.presentation.get();\n        this.#setDetectedStreamType(presentation?.streamType ?? MediaStreamTypes.UNKNOWN);\n        this.#setTargetLiveWindow(deriveTargetLiveWindow(presentation, liveTrackId(this.#signals.state)));\n        this.#reportDeliveryNotices(presentation);\n      });\n\n      // Promote the first fatal condition out of the engine's reported sequence\n      // onto the media surface. Clearing rides the same signal: `collectErrors`\n      // resets the slot per source, so a new source starts with no error without\n      // this needing its own source-change hook.\n      this.#stopErrorSync = effect(() => {\n        const errors = this.#signals.state.errors.get();\n        this.#setError(firstFatal(errors, FATAL_SVTA_CODES), errors);\n      });\n    }\n\n    /**\n     * Underlying playback engine — the low-level SPF reactive composition that\n     * drives playback. An advanced escape hatch for direct engine access;\n     * normal playback is driven through this element's own properties and\n     * methods.\n     */\n    get engine(): Composition<HlsVideoEngineState, HlsVideoEngineContext> {\n      return this.#engine;\n    }\n\n    // -------------------------------------------------------------------------\n    // Live surface — streamType / targetLiveWindow / liveEdgeStart\n    // (the MediaStreamTypeCapability + MediaLiveCapability contract the player\n    // store's stream-type and live features consume)\n    // -------------------------------------------------------------------------\n\n    /**\n     * The current fatal error, or `null`. Only *fatal* conditions appear here —\n     * the engine reports non-fatal ones too (they stay in `engine.state.errors`),\n     * and promoting them would tell a consumer playback had failed when it\n     * hadn't. Resets per source. Fires `'error'` when set.\n     */\n    get error(): HlsVideoMediaError | null {\n      return this.#error;\n    }\n\n    /**\n     * The source's stream type — `'live'`, `'on-demand'`, or `'unknown'` until\n     * a media playlist has been parsed. Setting a non-`'unknown'` value pins a\n     * user override (detection stops updating it); setting `'unknown'` reverts\n     * to the engine's detected value.\n     */\n    get streamType(): HlsVideoMediaStreamType {\n      return this.#streamType;\n    }\n\n    set streamType(value: HlsVideoMediaStreamType) {\n      if (value === MediaStreamTypes.UNKNOWN) {\n        this.#isUserStreamType = false;\n        this.#updateStreamType(this.#signals.state.presentation.get()?.streamType ?? MediaStreamTypes.UNKNOWN);\n        return;\n      }\n      this.#isUserStreamType = true;\n      this.#updateStreamType(value);\n    }\n\n    /**\n     * Presentation time marking the start of the live-edge window — playback at\n     * `currentTime >= liveEdgeStart` counts as \"at the live edge\" (the same\n     * target the engine's `seekToLiveEdge` seeks to: window end − HOLD-BACK).\n     * `NaN` when the stream isn't live or nothing is resolved yet. Derived at\n     * read time from the engine's live window — no change event; re-read on\n     * `timeupdate`/`progress` (as the store's live feature does).\n     */\n    get liveEdgeStart(): number {\n      const edge = getLiveEdge({\n        state: this.#signals.state as LiveWindowState,\n        config: { resolveLiveLatency },\n      });\n      return edge?.liveEdgeStart ?? Number.NaN;\n    }\n\n    /**\n     * The target live window: `NaN` for on-demand (or unknown), `0` for\n     * standard sliding-window live, `Infinity` for DVR\n     * (`#EXT-X-PLAYLIST-TYPE:EVENT`). Fires `targetlivewindowchange` on change.\n     */\n    get targetLiveWindow(): number {\n      return this.#targetLiveWindow;\n    }\n\n    #setDetectedStreamType(value: HlsVideoMediaStreamType): void {\n      if (this.#isUserStreamType) return;\n      this.#updateStreamType(value);\n    }\n\n    #updateStreamType(value: HlsVideoMediaStreamType): void {\n      if (this.#streamType === value) return;\n      this.#streamType = value;\n      // Optional-chained: with an EventTarget-less base (`HlsVideoMediaElement`\n      // standalone) there's nowhere to dispatch; hosts forward it to listeners.\n      this.dispatchEvent?.(new Event('streamtypechange'));\n    }\n\n    #setTargetLiveWindow(value: number): void {\n      if (Object.is(this.#targetLiveWindow, value)) return;\n      this.#targetLiveWindow = value;\n      this.dispatchEvent?.(new Event('targetlivewindowchange'));\n    }\n\n    #setError(reported: SvtaError | undefined, errors: readonly SvtaError[] | undefined): void {\n      if (!reported) {\n        // Cleared (new source). No event: `'error'` announces a failure, and\n        // consumers reset their own copy on source change.\n        this.#error = null;\n        this.#reportedCode = null;\n        return;\n      }\n      // Keyed on the code, not the object: a later append re-runs this effect\n      // with an equal-but-new array, and re-firing `'error'` for a condition\n      // already surfaced would look like a second failure.\n      if (this.#reportedCode === reported.code) return;\n      this.#reportedCode = reported.code;\n\n      // A verdict says a type emptied; the causes say whether anything could\n      // have played it. When they include something this engine simply doesn't\n      // implement, that's the more useful thing to tell a consumer, so it\n      // replaces the verdict's code on the surface.\n      const unsupported = hasUnsupportedFeatureCause(errors);\n      if (unsupported) {\n        // The only place this engine explains itself in prose, and it's a\n        // console: the viewer-facing sentence is the consumer's to localize from\n        // the code. Conditions ride along structured so the specifics stay\n        // inspectable.\n        console.error(this.#withSuggestion(UNSUPPORTED_PLAYBACK_FEATURE_MESSAGE), { conditions: errors });\n      }\n\n      this.#error = {\n        code: unsupported ? SVTA_UNSUPPORTED_PLAYBACK_FEATURE : reported.code,\n        message: reported.message ?? '',\n        ...(reported.data === undefined ? {} : { data: reported.data }),\n      };\n      this.dispatchEvent?.(new Event('error'));\n    }\n\n    // -------------------------------------------------------------------------\n    // Media element lifecycle\n    // -------------------------------------------------------------------------\n\n    attach(mediaElement: HTMLMediaElement): void {\n      super.attach?.(mediaElement);\n      this.#signals.context.mediaElement.set(mediaElement);\n    }\n\n    detach(): void {\n      this.#cancelPendingPlay();\n      this.#signals.context.mediaElement.set(undefined);\n      super.detach?.();\n    }\n\n    destroy(): void {\n      this.#cancelPendingPlay();\n      this.#stopLiveSync();\n      this.#stopErrorSync();\n      this.#engine.destroy();\n    }\n\n    // -------------------------------------------------------------------------\n    // preload — synchronous IDL attribute (WHATWG §4.8.11.2)\n    // -------------------------------------------------------------------------\n\n    /** Preload type (`'none'` / `'metadata'` / `'auto'`). */\n    get preload(): '' | 'none' | 'metadata' | 'auto' {\n      return this.#preload;\n    }\n\n    set preload(value: '' | 'none' | 'metadata' | 'auto') {\n      this.#preload = value;\n      if (value) {\n        this.#signals.state.preload.set(value);\n      }\n      // value = '' resets the IDL mirror (so `get preload` reflects '') but does\n      // not patch state — the engine keeps its current preload until an explicit\n      // W3C value replaces it.\n    }\n\n    // -------------------------------------------------------------------------\n    // disableRemotePlayback — synchronous IDL attribute (WHATWG Remote Playback)\n    // Author intent for whether the AirPlay/remote picker is offered. Mirrors\n    // the DOM attribute name; the value flows to `state.disableRemotePlayback`,\n    // which `setupAirPlay` reads to honor an explicit opt-out. The underlying\n    // <video>'s own `disableRemotePlayback` stays programmatically managed\n    // (ManagedMediaSource needs it `true` to open; AirPlay flips it `false` once\n    // the source is open), so author intent and the effective flag stay distinct.\n    // -------------------------------------------------------------------------\n\n    get disableRemotePlayback(): boolean {\n      return this.#disableRemotePlayback;\n    }\n\n    set disableRemotePlayback(value: boolean) {\n      this.#disableRemotePlayback = value;\n      this.#signals.state.disableRemotePlayback.set(value);\n    }\n\n    // -------------------------------------------------------------------------\n    // src — synchronous IDL attribute (WHATWG §4.8.11.2)\n    // Each assignment overwrites the engine's presentation state in place. The\n    // resolver FSM routes back through teardown → rebuild on the same engine,\n    // mirroring how the browser's load algorithm resets media state on src change\n    // — without recreating the engine or re-capturing its signals. Setting an\n    // empty src un-resolves the presentation, tearing the current source down to\n    // the engine's fresh-but-attached \"no source\" state.\n    // -------------------------------------------------------------------------\n\n    get src(): string {\n      return this.#signals.state.presentation.get()?.url ?? '';\n    }\n\n    set src(value: string) {\n      // Assigning the URL already playing is not a request to reload it. The\n      // presentation is set from a fresh object every time, so re-resolving an\n      // unchanged URL restarts playback — which is what a caller changing only\n      // the parts of a structured source that describe images, rather than the\n      // stream, would get. The hls.js Media draws the same line: it announces\n      // every source change and loads only when the URL or engine config moves.\n      if (value === this.src) return;\n\n      this.#cancelPendingPlay();\n      this.#signals.state.presentation.set(value ? { url: value } : undefined);\n    }\n\n    // -------------------------------------------------------------------------\n    // play() — WHATWG §4.8.11.8\n    // Delegates to the attached media element's native play().\n    // -------------------------------------------------------------------------\n\n    play(): Promise<void> {\n      const mediaElement = this.#signals.context.mediaElement.get();\n      if (!mediaElement) {\n        return Promise.reject(new Error('HlsVideoMediaElement: no media element attached'));\n      }\n\n      // Signal play intent — enables loading even with preload=\"none\"\n      this.#signals.state.loadActivated.set(true);\n\n      return mediaElement.play().catch((err: unknown) => {\n        // If we have a pending HLS source, the rejection may be because MSE\n        // hasn't attached a blob URL yet. Wait for loadstart (src assigned\n        // by MSE setup) and retry once.\n        if (this.src) {\n          return new Promise<void>((resolve, reject) => {\n            const listener = () => {\n              this.#loadstartListener = null;\n              mediaElement.play().then(resolve, reject);\n            };\n            this.#loadstartListener = listener;\n            mediaElement.addEventListener('loadstart', listener, { once: true });\n          });\n        }\n        throw err;\n      });\n    }\n\n    // -------------------------------------------------------------------------\n    // Private\n    // -------------------------------------------------------------------------\n\n    /** `message`, plus the alternative-Media sentence when this class names one. */\n    #withSuggestion(message: string): string {\n      return withAlternativeMediaSuggestion(message, this);\n    }\n\n    /**\n     * Log what this engine is delivering differently from what the playlist asked\n     * for. Neither condition stops playback, so neither is an error — they go to\n     * the console rather than the error surface.\n     *\n     * Once per source, not per parse: a live playlist reloads every target\n     * duration, and the timeline track re-parses on each one. Keyed on the notice\n     * rather than latched with a boolean so the two are independent, and cleared\n     * when the presentation unresolves so the next source starts quiet.\n     */\n    #reportDeliveryNotices(presentation: MaybeResolvedPresentation | undefined): void {\n      if (!isResolvedPresentation(presentation)) {\n        this.#noticed.clear();\n        return;\n      }\n\n      const trackId = liveTrackId(this.#signals.state);\n      const track = trackId ? findTrackById(presentation, trackId) : undefined;\n      if (!track || !isResolvedTrack(track)) return;\n      const metadata = getMediaPlaylistMetadata(track);\n      if (!metadata) return;\n\n      if (metadata.lowLatency && !this.#noticed.has('lowLatency')) {\n        this.#noticed.add('lowLatency');\n        console.warn(this.#withSuggestion(LOW_LATENCY_UNSUPPORTED_MESSAGE));\n      }\n      if (metadata.playlistType === 'EVENT' && !this.#noticed.has('dvr')) {\n        this.#noticed.add('dvr');\n        console.warn(this.#withSuggestion(DVR_EXPERIMENTAL_MESSAGE));\n      }\n    }\n\n    #createEngine(): Composition<HlsVideoEngineState, HlsVideoEngineContext> {\n      return createHlsVideoEngine({\n        ...this.#config,\n        onSignalsReady: (signals) => {\n          this.#signals = signals;\n        },\n      });\n    }\n\n    #cancelPendingPlay(): void {\n      if (!this.#loadstartListener) return;\n      const mediaElement = this.#signals.context.mediaElement.get();\n      mediaElement?.removeEventListener('loadstart', this.#loadstartListener);\n      this.#loadstartListener = null;\n    }\n  }\n\n  // `MixinReturn` sources statics from `Base`, so the adapter's own static needs\n  // adding back to the type or callers can't read it.\n  return HlsVideoMediaImpl as unknown as MixinReturn<Base, HlsVideoMediaAPI> & {\n    readonly alternativeMediaSuggestion: string | undefined;\n  };\n}\n\n/** Standalone SPF media adapter with no base class. */\nexport class HlsVideoMediaElement extends HlsVideoMediaMixin(class {}) {}\n"],"mappings":"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"}
+{"version":3,"file":"adapter.js","names":["#engine","#config","#createEngine","#stopLiveSync","#signals","#setDetectedStreamType","#setTargetLiveWindow","#reportDeliveryNotices","#stopErrorSync","#setError","#error","#streamType","#isUserStreamType","#updateStreamType","#targetLiveWindow","#reportedCode","#withSuggestion","#cancelPendingPlay","#preload","#disableRemotePlayback","#loadstartListener","#noticed"],"sources":["../../../../../src/playback/adapters/hls-video/adapter.ts"],"sourcesContent":["import { type MediaStreamType, MediaStreamTypes } from '@videojs/media';\nimport type { Constructor, MixinReturn } from '@videojs/utils/types';\n\nimport type { Composition } from '../../../core/composition/create-composition';\nimport { effect } from '../../../core/signals/effect';\nimport {\n  SVTA_NO_SUPPORTED_AUDIO_TRACK,\n  SVTA_NO_SUPPORTED_VIDEO_TRACK,\n  SVTA_UNSUPPORTED_PLAYBACK_FEATURE,\n  type SvtaError,\n} from '../../../media/errors';\nimport { resolveLiveLatency } from '../../../media/hls/reload-policy';\nimport {\n  deriveStreamType,\n  getMediaPlaylistMetadata,\n  isResolvedPresentation,\n  isResolvedTrack,\n  type MaybeResolvedPresentation,\n} from '../../../media/types';\nimport { findTrackById } from '../../../media/utils/tracks';\nimport {\n  createHlsVideoEngine,\n  type HlsVideoEngineConfig,\n  type HlsVideoEngineContext,\n  type HlsVideoEngineSignals,\n  type HlsVideoEngineState,\n} from '../../engines/hls/engine';\nimport {\n  DVR_EXPERIMENTAL_MESSAGE,\n  LOW_LATENCY_UNSUPPORTED_MESSAGE,\n  UNSUPPORTED_PLAYBACK_FEATURE_MESSAGE,\n} from '../../primitives/error-messages';\nimport { getLiveEdge, type LiveWindowState, liveTrackId } from '../../primitives/live-window';\nimport {\n  firstFatal,\n  type HlsVideoMediaError,\n  hasUnsupportedFeatureCause,\n  withAlternativeMediaSuggestion,\n} from './error-surface';\n\n/**\n * The media-level stream type: the engine's detected stream type (`'live'` / `'on-demand'`) plus `'unknown'` for \"no\n * playlist parsed yet.\" `@videojs/media`'s {@link MediaStreamType} itself, kept under its own name because that is what\n * this adapter's `streamType` property is documented against.\n */\nexport type HlsVideoMediaStreamType = MediaStreamType;\n\nexport type { HlsVideoMediaError } from './error-surface';\n\nexport interface HlsVideoMediaProps {\n  src: string;\n  preload: '' | 'none' | 'metadata' | 'auto';\n  disableRemotePlayback: boolean;\n  streamType: HlsVideoMediaStreamType;\n}\n\nexport const hlsVideoMediaDefaultProps: HlsVideoMediaProps = {\n  src: '',\n  preload: '',\n  disableRemotePlayback: false,\n  streamType: MediaStreamTypes.UNKNOWN,\n};\n\nexport interface HlsVideoMediaAPI extends HlsVideoMediaProps {\n  readonly engine: Composition<HlsVideoEngineState, HlsVideoEngineContext>;\n  readonly error: HlsVideoMediaError | null;\n  readonly liveEdgeStart: number;\n  readonly targetLiveWindow: number;\n  attach(mediaElement: HTMLMediaElement): void;\n  detach(): void;\n  destroy(): void;\n  play(): Promise<void>;\n}\n\n/**\n * `targetLiveWindow` per the media-ui-extensions live-edge proposal: `NaN` for on-demand (or nothing resolved yet), `0`\n * for standard sliding-window live, `Infinity` for DVR (`#EXT-X-PLAYLIST-TYPE:EVENT` — the window grows from the\n * start). Read from the timeline-bearing track's playlist metadata.\n */\nfunction deriveTargetLiveWindow(\n  presentation: MaybeResolvedPresentation | undefined,\n  trackId: string | undefined\n): number {\n  if (!isResolvedPresentation(presentation) || !trackId) return Number.NaN;\n\n  const track = findTrackById(presentation, trackId);\n  if (!track || !isResolvedTrack(track)) return Number.NaN;\n\n  const metadata = getMediaPlaylistMetadata(track);\n  if (!metadata) return Number.NaN;\n\n  if (metadata.playlistType === 'EVENT') return Number.POSITIVE_INFINITY;\n\n  return deriveStreamType(metadata) === 'live' ? 0 : Number.NaN;\n}\n\n// ============================================================================\n// Error surface\n// ============================================================================\n\n/**\n * Which reported conditions this composition treats as **fatal** — the ones that reach `error` and fire `'error'`.\n * Severity isn't part of an SVTA code (§Approach: \"impact varies with player implementation\"), and here it also varies\n * by composition, so it's decided at this boundary rather than by the reporter.\n *\n * An allow-list, deliberately: only _verdicts_ are here. The per-rendition causes `resolve-track` reports (unsupported\n * format, unsupported DRM) stay in the sequence as context — one unplayable rendition doesn't fail the source, and\n * promoting a cause would put a dialog over a mixed source that goes on to play.\n */\nconst FATAL_SVTA_CODES: ReadonlySet<number> = new Set<number>([\n  SVTA_NO_SUPPORTED_VIDEO_TRACK,\n  SVTA_NO_SUPPORTED_AUDIO_TRACK,\n]);\n\n/**\n * Mixin that adds SPF playback engine behavior to any base class.\n *\n * Implements the src/play() contract per the WHATWG HTML spec so that SPF can be used anywhere a media element API is\n * expected.\n *\n * A single engine instance is created at construction and recycled across src changes.\n *\n * @example\n *   class HlsVideoMedia extends HlsVideoMediaMixin(HTMLVideoElementHost) {}\n *\n *   const media = new HlsVideoMedia();\n *   media.attach(document.querySelector('video'));\n *   media.src = 'https://stream.mux.com/abc123.m3u8';\n *\n * @fires streamtypechange - Fired when the detected stream type changes. Read `streamType` for the new value.\n * @fires targetlivewindowchange - Fired when the target live window changes. Read `targetLiveWindow` for the new value.\n * @fires error - Fired when a fatal condition is reported. Read `error` for it.\n */\nexport function HlsVideoMediaMixin<Base extends Constructor<any>>(BaseClass: Base) {\n  class HlsVideoMediaImpl extends BaseClass {\n    /**\n     * A complete sentence naming the Media to reach for when this one can't play a source — `Try the hls.js-backed Mux\n     * media instead: import the hls-js flavor in place of the spf one.` Appended to the copy this adapter surfaces, and\n     * to the notices it logs. Name the flavor, not an import path: a Media is reached through several packages, each\n     * with its own counterpart.\n     *\n     * Empty here: `hls-video` has no better-equipped sibling to point at. A Media that does (a Mux Video built on this\n     * engine, whose hls.js-backed counterpart plays MPEG-TS and DRM) overrides this static, and its copy gains the\n     * second sentence with no other change.\n     */\n    static get alternativeMediaSuggestion(): string | undefined {\n      return undefined;\n    }\n\n    readonly #engine: Composition<HlsVideoEngineState, HlsVideoEngineContext>;\n    #config: HlsVideoEngineConfig;\n    #signals!: HlsVideoEngineSignals;\n    #preload: '' | 'none' | 'metadata' | 'auto' = hlsVideoMediaDefaultProps.preload;\n    #disableRemotePlayback: boolean = hlsVideoMediaDefaultProps.disableRemotePlayback;\n    #streamType: HlsVideoMediaStreamType = hlsVideoMediaDefaultProps.streamType;\n    #isUserStreamType = false;\n    #targetLiveWindow = Number.NaN;\n    #error: HlsVideoMediaError | null = null;\n    /**\n     * The _reported_ condition currently surfaced, which is what the re-fire latch keys on. Not `#error.code`: that's\n     * the code this adapter chose to surface, and a later cause can change the choice for a condition already\n     * announced.\n     */\n    #reportedCode: number | null = null;\n    /** Notices already logged for the current source; cleared when it unloads. */\n    #noticed = new Set<string>();\n    #stopLiveSync: () => void;\n    #stopErrorSync: () => void;\n\n    /** Pending loadstart listener from a deferred play() retry, if any. */\n    #loadstartListener: (() => void) | null = null;\n\n    constructor(...args: any[]) {\n      super(...args);\n\n      const { config } = args?.[0] ?? {};\n\n      this.#config = config;\n      this.#engine = this.#createEngine();\n\n      // Mirror the engine's live/stream-type detection onto the media surface,\n      // firing the change events the store features listen for. One effect over\n      // the presentation + selection signals; `liveEdgeStart` is deliberately\n      // NOT cached here — it's derived at read time (the store re-reads it on\n      // `timeupdate`/`progress`), so a sliding window needs no event churn.\n      this.#stopLiveSync = effect(() => {\n        const presentation = this.#signals.state.presentation.get();\n\n        this.#setDetectedStreamType(presentation?.streamType ?? MediaStreamTypes.UNKNOWN);\n        this.#setTargetLiveWindow(deriveTargetLiveWindow(presentation, liveTrackId(this.#signals.state)));\n        this.#reportDeliveryNotices(presentation);\n      });\n\n      // Promote the first fatal condition out of the engine's reported sequence\n      // onto the media surface. Clearing rides the same signal: `collectErrors`\n      // resets the slot per source, so a new source starts with no error without\n      // this needing its own source-change hook.\n      this.#stopErrorSync = effect(() => {\n        const errors = this.#signals.state.errors.get();\n\n        this.#setError(firstFatal(errors, FATAL_SVTA_CODES), errors);\n      });\n    }\n\n    /**\n     * Underlying playback engine — the low-level SPF reactive composition that drives playback. An advanced escape\n     * hatch for direct engine access; normal playback is driven through this element's own properties and methods.\n     */\n    get engine(): Composition<HlsVideoEngineState, HlsVideoEngineContext> {\n      return this.#engine;\n    }\n\n    // -------------------------------------------------------------------------\n    // Live surface — streamType / targetLiveWindow / liveEdgeStart\n    // (the MediaStreamTypeCapability + MediaLiveCapability contract the player\n    // store's stream-type and live features consume)\n    // -------------------------------------------------------------------------\n\n    /**\n     * The current fatal error, or `null`. Only _fatal_ conditions appear here — the engine reports non-fatal ones too\n     * (they stay in `engine.state.errors`), and promoting them would tell a consumer playback had failed when it\n     * hadn't. Resets per source. Fires `'error'` when set.\n     */\n    get error(): HlsVideoMediaError | null {\n      return this.#error;\n    }\n\n    /**\n     * The source's stream type — `'live'`, `'on-demand'`, or `'unknown'` until a media playlist has been parsed.\n     * Setting a non-`'unknown'` value pins a user override (detection stops updating it); setting `'unknown'` reverts\n     * to the engine's detected value.\n     */\n    get streamType(): HlsVideoMediaStreamType {\n      return this.#streamType;\n    }\n\n    set streamType(value: HlsVideoMediaStreamType) {\n      if (value === MediaStreamTypes.UNKNOWN) {\n        this.#isUserStreamType = false;\n        this.#updateStreamType(this.#signals.state.presentation.get()?.streamType ?? MediaStreamTypes.UNKNOWN);\n        return;\n      }\n\n      this.#isUserStreamType = true;\n      this.#updateStreamType(value);\n    }\n\n    /**\n     * Presentation time marking the start of the live-edge window — playback at `currentTime >= liveEdgeStart` counts\n     * as \"at the live edge\" (the same target the engine's `seekToLiveEdge` seeks to: window end − HOLD-BACK). `NaN`\n     * when the stream isn't live or nothing is resolved yet. Derived at read time from the engine's live window — no\n     * change event; re-read on `timeupdate`/`progress` (as the store's live feature does).\n     */\n    get liveEdgeStart(): number {\n      const edge = getLiveEdge({\n        state: this.#signals.state as LiveWindowState,\n        config: { resolveLiveLatency },\n      });\n\n      return edge?.liveEdgeStart ?? Number.NaN;\n    }\n\n    /**\n     * The target live window: `NaN` for on-demand (or unknown), `0` for standard sliding-window live, `Infinity` for\n     * DVR (`#EXT-X-PLAYLIST-TYPE:EVENT`). Fires `targetlivewindowchange` on change.\n     */\n    get targetLiveWindow(): number {\n      return this.#targetLiveWindow;\n    }\n\n    #setDetectedStreamType(value: HlsVideoMediaStreamType): void {\n      if (this.#isUserStreamType) return;\n\n      this.#updateStreamType(value);\n    }\n\n    #updateStreamType(value: HlsVideoMediaStreamType): void {\n      if (this.#streamType === value) return;\n\n      this.#streamType = value;\n      // Optional-chained: with an EventTarget-less base (`HlsVideoMediaElement`\n      // standalone) there's nowhere to dispatch; hosts forward it to listeners.\n      this.dispatchEvent?.(new Event('streamtypechange'));\n    }\n\n    #setTargetLiveWindow(value: number): void {\n      if (Object.is(this.#targetLiveWindow, value)) return;\n\n      this.#targetLiveWindow = value;\n      this.dispatchEvent?.(new Event('targetlivewindowchange'));\n    }\n\n    #setError(reported: SvtaError | undefined, errors: readonly SvtaError[] | undefined): void {\n      if (!reported) {\n        // Cleared (new source). No event: `'error'` announces a failure, and\n        // consumers reset their own copy on source change.\n        this.#error = null;\n        this.#reportedCode = null;\n        return;\n      }\n\n      // Keyed on the code, not the object: a later append re-runs this effect\n      // with an equal-but-new array, and re-firing `'error'` for a condition\n      // already surfaced would look like a second failure.\n      if (this.#reportedCode === reported.code) return;\n\n      this.#reportedCode = reported.code;\n\n      // A verdict says a type emptied; the causes say whether anything could\n      // have played it. When they include something this engine simply doesn't\n      // implement, that's the more useful thing to tell a consumer, so it\n      // replaces the verdict's code on the surface.\n      const unsupported = hasUnsupportedFeatureCause(errors);\n\n      if (unsupported) {\n        // The only place this engine explains itself in prose, and it's a\n        // console: the viewer-facing sentence is the consumer's to localize from\n        // the code. Conditions ride along structured so the specifics stay\n        // inspectable.\n        console.error(this.#withSuggestion(UNSUPPORTED_PLAYBACK_FEATURE_MESSAGE), { conditions: errors });\n      }\n\n      this.#error = {\n        code: unsupported ? SVTA_UNSUPPORTED_PLAYBACK_FEATURE : reported.code,\n        message: reported.message ?? '',\n        ...(reported.data === undefined ? {} : { data: reported.data }),\n      };\n      this.dispatchEvent?.(new Event('error'));\n    }\n\n    // -------------------------------------------------------------------------\n    // Media element lifecycle\n    // -------------------------------------------------------------------------\n\n    attach(mediaElement: HTMLMediaElement): void {\n      super.attach?.(mediaElement);\n      this.#signals.context.mediaElement.set(mediaElement);\n    }\n\n    detach(): void {\n      this.#cancelPendingPlay();\n      this.#signals.context.mediaElement.set(undefined);\n      super.detach?.();\n    }\n\n    destroy(): void {\n      this.#cancelPendingPlay();\n      this.#stopLiveSync();\n      this.#stopErrorSync();\n      this.#engine.destroy();\n    }\n\n    // -------------------------------------------------------------------------\n    // preload — synchronous IDL attribute (WHATWG §4.8.11.2)\n    // -------------------------------------------------------------------------\n\n    /** Preload type (`'none'` / `'metadata'` / `'auto'`). */\n    get preload(): '' | 'none' | 'metadata' | 'auto' {\n      return this.#preload;\n    }\n\n    set preload(value: '' | 'none' | 'metadata' | 'auto') {\n      this.#preload = value;\n\n      if (value) {\n        this.#signals.state.preload.set(value);\n      }\n      // value = '' resets the IDL mirror (so `get preload` reflects '') but does\n      // not patch state — the engine keeps its current preload until an explicit\n      // W3C value replaces it.\n    }\n\n    // -------------------------------------------------------------------------\n    // disableRemotePlayback — synchronous IDL attribute (WHATWG Remote Playback)\n    // Author intent for whether the AirPlay/remote picker is offered. Mirrors\n    // the DOM attribute name; the value flows to `state.disableRemotePlayback`,\n    // which `setupAirPlay` reads to honor an explicit opt-out. The underlying\n    // <video>'s own `disableRemotePlayback` stays programmatically managed\n    // (ManagedMediaSource needs it `true` to open; AirPlay flips it `false` once\n    // the source is open), so author intent and the effective flag stay distinct.\n    // -------------------------------------------------------------------------\n\n    get disableRemotePlayback(): boolean {\n      return this.#disableRemotePlayback;\n    }\n\n    set disableRemotePlayback(value: boolean) {\n      this.#disableRemotePlayback = value;\n      this.#signals.state.disableRemotePlayback.set(value);\n    }\n\n    // -------------------------------------------------------------------------\n    // src — synchronous IDL attribute (WHATWG §4.8.11.2)\n    // Each assignment overwrites the engine's presentation state in place. The\n    // resolver FSM routes back through teardown → rebuild on the same engine,\n    // mirroring how the browser's load algorithm resets media state on src change\n    // — without recreating the engine or re-capturing its signals. Setting an\n    // empty src un-resolves the presentation, tearing the current source down to\n    // the engine's fresh-but-attached \"no source\" state.\n    // -------------------------------------------------------------------------\n\n    get src(): string {\n      return this.#signals.state.presentation.get()?.url ?? '';\n    }\n\n    set src(value: string) {\n      // Assigning the URL already playing is not a request to reload it. The\n      // presentation is set from a fresh object every time, so re-resolving an\n      // unchanged URL restarts playback — which is what a caller changing only\n      // the parts of a structured source that describe images, rather than the\n      // stream, would get. The hls.js Media draws the same line: it announces\n      // every source change and loads only when the URL or engine config moves.\n      if (value === this.src) return;\n\n      this.#cancelPendingPlay();\n      this.#signals.state.presentation.set(value ? { url: value } : undefined);\n    }\n\n    // -------------------------------------------------------------------------\n    // play() — WHATWG §4.8.11.8\n    // Delegates to the attached media element's native play().\n    // -------------------------------------------------------------------------\n\n    play(): Promise<void> {\n      const mediaElement = this.#signals.context.mediaElement.get();\n      if (!mediaElement) return Promise.reject(new Error('HlsVideoMediaElement: no media element attached'));\n\n      // Signal play intent — enables loading even with preload=\"none\"\n      this.#signals.state.loadActivated.set(true);\n\n      return mediaElement.play().catch((err: unknown) => {\n        // If we have a pending HLS source, the rejection may be because MSE\n        // hasn't attached a blob URL yet. Wait for loadstart (src assigned\n        // by MSE setup) and retry once.\n        if (this.src) {\n          return new Promise<void>((resolve, reject) => {\n            const listener = () => {\n              this.#loadstartListener = null;\n              mediaElement.play().then(resolve, reject);\n            };\n\n            this.#loadstartListener = listener;\n            mediaElement.addEventListener('loadstart', listener, { once: true });\n          });\n        }\n\n        throw err;\n      });\n    }\n\n    // -------------------------------------------------------------------------\n    // Private\n    // -------------------------------------------------------------------------\n\n    /** `message`, plus the alternative-Media sentence when this class names one. */\n    #withSuggestion(message: string): string {\n      return withAlternativeMediaSuggestion(message, this);\n    }\n\n    /**\n     * Log what this engine is delivering differently from what the playlist asked for. Neither condition stops\n     * playback, so neither is an error — they go to the console rather than the error surface.\n     *\n     * Once per source, not per parse: a live playlist reloads every target duration, and the timeline track re-parses\n     * on each one. Keyed on the notice rather than latched with a boolean so the two are independent, and cleared when\n     * the presentation unresolves so the next source starts quiet.\n     */\n    #reportDeliveryNotices(presentation: MaybeResolvedPresentation | undefined): void {\n      if (!isResolvedPresentation(presentation)) {\n        this.#noticed.clear();\n        return;\n      }\n\n      const trackId = liveTrackId(this.#signals.state);\n      const track = trackId ? findTrackById(presentation, trackId) : undefined;\n      if (!track || !isResolvedTrack(track)) return;\n\n      const metadata = getMediaPlaylistMetadata(track);\n      if (!metadata) return;\n\n      if (metadata.lowLatency && !this.#noticed.has('lowLatency')) {\n        this.#noticed.add('lowLatency');\n        console.warn(this.#withSuggestion(LOW_LATENCY_UNSUPPORTED_MESSAGE));\n      }\n\n      if (metadata.playlistType === 'EVENT' && !this.#noticed.has('dvr')) {\n        this.#noticed.add('dvr');\n        console.warn(this.#withSuggestion(DVR_EXPERIMENTAL_MESSAGE));\n      }\n    }\n\n    #createEngine(): Composition<HlsVideoEngineState, HlsVideoEngineContext> {\n      return createHlsVideoEngine({\n        ...this.#config,\n        onSignalsReady: (signals) => {\n          this.#signals = signals;\n        },\n      });\n    }\n\n    #cancelPendingPlay(): void {\n      if (!this.#loadstartListener) return;\n\n      const mediaElement = this.#signals.context.mediaElement.get();\n\n      mediaElement?.removeEventListener('loadstart', this.#loadstartListener);\n      this.#loadstartListener = null;\n    }\n  }\n\n  // `MixinReturn` sources statics from `Base`, so the adapter's own static needs\n  // adding back to the type or callers can't read it.\n  return HlsVideoMediaImpl as unknown as MixinReturn<Base, HlsVideoMediaAPI> & {\n    readonly alternativeMediaSuggestion: string | undefined;\n  };\n}\n\n/** Standalone SPF media adapter with no base class. */\nexport class HlsVideoMediaElement extends HlsVideoMediaMixin(class {}) {}\n"],"mappings":"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"}

package/dist/dev/playback/adapters/hls-video/error-surface.d.ts

@@ -1,12 +1,11 @@
 import { ErrorLike } from "@videojs/media";
 //#region src/playback/adapters/hls-video/error-surface.d.ts
 /**
- * The error shape a media surface exposes: `@videojs/media`'s {@link ErrorLike}
- * plus the reporter context the engine carries alongside a condition.
+ * The error shape a media surface exposes: `@videojs/media`'s {@link ErrorLike} plus the reporter context the engine
+ * carries alongside a condition.
  *
- * `code` is the **SVTA code**, not a `MediaError.MEDIA_ERR_*` value. Consumers
- * that map codes to copy currently only know 1–5, so an SVTA code falls through
- * to showing `message`; an extensible code lookup above the engine is the
+ * `code` is the **SVTA code**, not a `MediaError.MEDIA_ERR_*` value. Consumers that map codes to copy currently only
+ * know 1–5, so an SVTA code falls through to showing `message`; an extensible code lookup above the engine is the
  * follow-up that fixes it.
  */
 interface HlsVideoMediaError extends ErrorLike {

package/dist/dev/playback/adapters/hls-video/error-surface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-surface.d.ts","names":[],"sources":["../../../../../src/playback/adapters/hls-video/error-surface.ts"],"mappings":";;;;;;;;;;;UAkCiB,2BAA2B;;WAEjC"}
+{"version":3,"file":"error-surface.d.ts","names":[],"sources":["../../../../../src/playback/adapters/hls-video/error-surface.ts"],"mappings":";;;;;;;;;;UA8BiB,2BAA2B;;WAEjC"}

package/dist/dev/playback/adapters/hls-video/error-surface.js

@@ -3,10 +3,9 @@ import { SVTA_UNSUPPORTED_AUDIO_FORMAT, SVTA_UNSUPPORTED_DRM_SYSTEM, SVTA_UNSUPP
 /**
 * `message`, plus the alternative-Media sentence when `media`'s class names one.
 *
-* Read off the class rather than passed in so a subclass can point at a
-* better-equipped sibling — the SPF Mux Medias name the hls.js-backed one, which
-* plays the MPEG-TS and DRM sources SPF doesn't — without either adapter knowing
-* that sibling exists.
+* Read off the class rather than passed in so a subclass can point at a better-equipped sibling — the SPF Mux Medias
+* name the hls.js-backed one, which plays the MPEG-TS and DRM sources SPF doesn't — without either adapter knowing that
+* sibling exists.
 */
 function withAlternativeMediaSuggestion(message, media) {
 	const { alternativeMediaSuggestion } = media.constructor;
@@ -18,13 +17,12 @@ function firstFatal(errors, fatalCodes) {
 	return errors?.find((error) => fatalCodes.has(error.code));
 }
 /**
-* The causes that mean the engine has no pipeline for what the source delivers —
-* a container it can't append, or encryption it can't decrypt.
+* The causes that mean the engine has no pipeline for what the source delivers — a container it can't append, or
+* encryption it can't decrypt.
 *
-* What these have in common is that no retry, no other CDN, and no other
-* rendition of the same source fixes them: the source needs a capability this
-* engine doesn't have. That's the distinction the surfaced code exists to draw,
-* and it's why the set is these three rather than "every cause".
+* What these have in common is that no retry, no other CDN, and no other rendition of the same source fixes them: the
+* source needs a capability this engine doesn't have. That's the distinction the surfaced code exists to draw, and it's
+* why the set is these three rather than "every cause".
 */
 const UNSUPPORTED_FEATURE_CAUSES = /* @__PURE__ */ new Set([
 	SVTA_UNSUPPORTED_VIDEO_FORMAT,
@@ -32,15 +30,12 @@ const UNSUPPORTED_FEATURE_CAUSES = /* @__PURE__ */ new Set([
 	SVTA_UNSUPPORTED_DRM_SYSTEM
 ]);
 /**
-* Whether anything in the sequence is a cause of the "we don't implement this"
-* kind.
+* Whether anything in the sequence is a cause of the "we don't implement this" kind.
 *
-* Deliberately `some` over the whole sequence rather than a per-type match
-* against the verdict. A verdict means one type's candidates emptied, but the
-* *reason* the source is unplayable can sit on another type — an audio-only
-* source whose sole rendition is encrypted empties the audio candidates, and a
-* video source with encrypted video empties the video ones. Both are the same
-* answer to the viewer, so both get the same code.
+* Deliberately `some` over the whole sequence rather than a per-type match against the verdict. A verdict means one
+* type's candidates emptied, but the _reason_ the source is unplayable can sit on another type — an audio-only source
+* whose sole rendition is encrypted empties the audio candidates, and a video source with encrypted video empties the
+* video ones. Both are the same answer to the viewer, so both get the same code.
 */
 function hasUnsupportedFeatureCause(errors) {
 	return errors?.some((error) => UNSUPPORTED_FEATURE_CAUSES.has(error.code)) ?? false;

package/dist/dev/playback/adapters/hls-video/error-surface.js.map

@@ -1 +1 @@
-{"version":3,"file":"error-surface.js","names":[],"sources":["../../../../../src/playback/adapters/hls-video/error-surface.ts"],"sourcesContent":["/**\n * The shared half of promoting reported conditions onto a media surface.\n *\n * Every adapter that has one does the same things: pick the first condition it\n * treats as fatal, latch it so a later append doesn't re-fire, and name a\n * better-equipped Media when its own class points at one. Only the *policy*\n * differs — which codes are fatal, which the video, audio-only, and background\n * adapters each answer differently — so that stays with each adapter and\n * everything else lives here.\n *\n * `firstFatal` is the part all three share. The `ErrorLike` mapping below it is\n * for the two that feed a store and a dialog; the background adapter surfaces the\n * reported condition unmapped, so it takes the picker and nothing else.\n *\n * See `internal/design/spf/features/errors.md` for the causes-vs-verdicts split\n * this rests on.\n */\nimport type { ErrorLike } from '@videojs/media';\nimport {\n  SVTA_UNSUPPORTED_AUDIO_FORMAT,\n  SVTA_UNSUPPORTED_DRM_SYSTEM,\n  SVTA_UNSUPPORTED_VIDEO_FORMAT,\n  type SvtaError,\n} from '../../../media/errors';\n\n/**\n * The error shape a media surface exposes: `@videojs/media`'s {@link ErrorLike}\n * plus the reporter context the engine carries alongside a condition.\n *\n * `code` is the **SVTA code**, not a `MediaError.MEDIA_ERR_*` value. Consumers\n * that map codes to copy currently only know 1–5, so an SVTA code falls through\n * to showing `message`; an extensible code lookup above the engine is the\n * follow-up that fixes it.\n */\nexport interface HlsVideoMediaError extends ErrorLike {\n  /** Reporter context (which selection emptied, which track, …). */\n  readonly data?: unknown;\n}\n\n/**\n * `message`, plus the alternative-Media sentence when `media`'s class names one.\n *\n * Read off the class rather than passed in so a subclass can point at a\n * better-equipped sibling — the SPF Mux Medias name the hls.js-backed one, which\n * plays the MPEG-TS and DRM sources SPF doesn't — without either adapter knowing\n * that sibling exists.\n */\nexport function withAlternativeMediaSuggestion(message: string, media: object): string {\n  const { alternativeMediaSuggestion } = media.constructor as { alternativeMediaSuggestion?: string };\n  const suggestion = alternativeMediaSuggestion?.trim();\n\n  return suggestion ? `${message} ${suggestion}` : message;\n}\n\n/** The first condition `fatalCodes` covers — the root cause, not its consequences. */\nexport function firstFatal(\n  errors: readonly SvtaError[] | undefined,\n  fatalCodes: ReadonlySet<number>\n): SvtaError | undefined {\n  return errors?.find((error) => fatalCodes.has(error.code));\n}\n\n/**\n * The causes that mean the engine has no pipeline for what the source delivers —\n * a container it can't append, or encryption it can't decrypt.\n *\n * What these have in common is that no retry, no other CDN, and no other\n * rendition of the same source fixes them: the source needs a capability this\n * engine doesn't have. That's the distinction the surfaced code exists to draw,\n * and it's why the set is these three rather than \"every cause\".\n */\nconst UNSUPPORTED_FEATURE_CAUSES: ReadonlySet<number> = new Set<number>([\n  SVTA_UNSUPPORTED_VIDEO_FORMAT,\n  SVTA_UNSUPPORTED_AUDIO_FORMAT,\n  SVTA_UNSUPPORTED_DRM_SYSTEM,\n]);\n\n/**\n * Whether anything in the sequence is a cause of the \"we don't implement this\"\n * kind.\n *\n * Deliberately `some` over the whole sequence rather than a per-type match\n * against the verdict. A verdict means one type's candidates emptied, but the\n * *reason* the source is unplayable can sit on another type — an audio-only\n * source whose sole rendition is encrypted empties the audio candidates, and a\n * video source with encrypted video empties the video ones. Both are the same\n * answer to the viewer, so both get the same code.\n */\nexport function hasUnsupportedFeatureCause(errors: readonly SvtaError[] | undefined): boolean {\n  return errors?.some((error) => UNSUPPORTED_FEATURE_CAUSES.has(error.code)) ?? false;\n}\n"],"mappings":";;;;;;;;;;AA+CA,SAAgB,+BAA+B,SAAiB,OAAuB;CACrF,MAAM,EAAE,+BAA+B,MAAM;CAC7C,MAAM,aAAa,4BAA4B,KAAK;CAEpD,OAAO,aAAa,GAAG,QAAQ,GAAG,eAAe;AACnD;;AAGA,SAAgB,WACd,QACA,YACuB;CACvB,OAAO,QAAQ,MAAM,UAAU,WAAW,IAAI,MAAM,IAAI,CAAC;AAC3D;;;;;;;;;;AAWA,MAAM,6CAAkD,IAAI,IAAY;CACtE;CACA;CACA;AACF,CAAC;;;;;;;;;;;;AAaD,SAAgB,2BAA2B,QAAmD;CAC5F,OAAO,QAAQ,MAAM,UAAU,2BAA2B,IAAI,MAAM,IAAI,CAAC,KAAK;AAChF"}
+{"version":3,"file":"error-surface.js","names":[],"sources":["../../../../../src/playback/adapters/hls-video/error-surface.ts"],"sourcesContent":["/**\n * The shared half of promoting reported conditions onto a media surface.\n *\n * Every adapter that has one does the same things: pick the first condition it treats as fatal, latch it so a later\n * append doesn't re-fire, and name a better-equipped Media when its own class points at one. Only the _policy_ differs\n * — which codes are fatal, which the video, audio-only, and background adapters each answer differently — so that stays\n * with each adapter and everything else lives here.\n *\n * `firstFatal` is the part all three share. The `ErrorLike` mapping below it is for the two that feed a store and a\n * dialog; the background adapter surfaces the reported condition unmapped, so it takes the picker and nothing else.\n *\n * See `internal/design/spf/features/errors.md` for the causes-vs-verdicts split this rests on.\n */\nimport type { ErrorLike } from '@videojs/media';\n\nimport {\n  SVTA_UNSUPPORTED_AUDIO_FORMAT,\n  SVTA_UNSUPPORTED_DRM_SYSTEM,\n  SVTA_UNSUPPORTED_VIDEO_FORMAT,\n  type SvtaError,\n} from '../../../media/errors';\n\n/**\n * The error shape a media surface exposes: `@videojs/media`'s {@link ErrorLike} plus the reporter context the engine\n * carries alongside a condition.\n *\n * `code` is the **SVTA code**, not a `MediaError.MEDIA_ERR_*` value. Consumers that map codes to copy currently only\n * know 1–5, so an SVTA code falls through to showing `message`; an extensible code lookup above the engine is the\n * follow-up that fixes it.\n */\nexport interface HlsVideoMediaError extends ErrorLike {\n  /** Reporter context (which selection emptied, which track, …). */\n  readonly data?: unknown;\n}\n\n/**\n * `message`, plus the alternative-Media sentence when `media`'s class names one.\n *\n * Read off the class rather than passed in so a subclass can point at a better-equipped sibling — the SPF Mux Medias\n * name the hls.js-backed one, which plays the MPEG-TS and DRM sources SPF doesn't — without either adapter knowing that\n * sibling exists.\n */\nexport function withAlternativeMediaSuggestion(message: string, media: object): string {\n  const { alternativeMediaSuggestion } = media.constructor as { alternativeMediaSuggestion?: string };\n  const suggestion = alternativeMediaSuggestion?.trim();\n\n  return suggestion ? `${message} ${suggestion}` : message;\n}\n\n/** The first condition `fatalCodes` covers — the root cause, not its consequences. */\nexport function firstFatal(\n  errors: readonly SvtaError[] | undefined,\n  fatalCodes: ReadonlySet<number>\n): SvtaError | undefined {\n  return errors?.find((error) => fatalCodes.has(error.code));\n}\n\n/**\n * The causes that mean the engine has no pipeline for what the source delivers — a container it can't append, or\n * encryption it can't decrypt.\n *\n * What these have in common is that no retry, no other CDN, and no other rendition of the same source fixes them: the\n * source needs a capability this engine doesn't have. That's the distinction the surfaced code exists to draw, and it's\n * why the set is these three rather than \"every cause\".\n */\nconst UNSUPPORTED_FEATURE_CAUSES: ReadonlySet<number> = new Set<number>([\n  SVTA_UNSUPPORTED_VIDEO_FORMAT,\n  SVTA_UNSUPPORTED_AUDIO_FORMAT,\n  SVTA_UNSUPPORTED_DRM_SYSTEM,\n]);\n\n/**\n * Whether anything in the sequence is a cause of the \"we don't implement this\" kind.\n *\n * Deliberately `some` over the whole sequence rather than a per-type match against the verdict. A verdict means one\n * type's candidates emptied, but the _reason_ the source is unplayable can sit on another type — an audio-only source\n * whose sole rendition is encrypted empties the audio candidates, and a video source with encrypted video empties the\n * video ones. Both are the same answer to the viewer, so both get the same code.\n */\nexport function hasUnsupportedFeatureCause(errors: readonly SvtaError[] | undefined): boolean {\n  return errors?.some((error) => UNSUPPORTED_FEATURE_CAUSES.has(error.code)) ?? false;\n}\n"],"mappings":";;;;;;;;;AA0CA,SAAgB,+BAA+B,SAAiB,OAAuB;CACrF,MAAM,EAAE,+BAA+B,MAAM;CAC7C,MAAM,aAAa,4BAA4B,KAAK;CAEpD,OAAO,aAAa,GAAG,QAAQ,GAAG,eAAe;AACnD;;AAGA,SAAgB,WACd,QACA,YACuB;CACvB,OAAO,QAAQ,MAAM,UAAU,WAAW,IAAI,MAAM,IAAI,CAAC;AAC3D;;;;;;;;;AAUA,MAAM,6CAAkD,IAAI,IAAY;CACtE;CACA;CACA;AACF,CAAC;;;;;;;;;AAUD,SAAgB,2BAA2B,QAAmD;CAC5F,OAAO,QAAQ,MAAM,UAAU,2BAA2B,IAAI,MAAM,IAAI,CAAC,KAAK;AAChF"}