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

package/dist/default/playback/adapters/mux-audio/media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","names":[],"sources":["../../../../../src/playback/adapters/mux-audio/media.ts"],"sourcesContent":["// Deliberately the mixin's own module, not `../mux-video`: that barrel reaches\n// `MuxVideoMedia`, and through it `HlsVideoMedia` and the full HLS engine. The\n// mixin alone carries no engine, which is what keeps this entry point\n// audio-only. Same shape as `hls-audio` importing its error surface\n// from `../hls-video`.\n\nimport { HlsAudioMedia } from '../hls-audio/media';\nimport { MuxMediaMixin } from '../mux-video/adapter';\n\nconst MuxAudioMediaBase = MuxMediaMixin(HlsAudioMedia);\n\n/**\n * The Mux Media over the SPF audio-only HLS engine.\n *\n * Same Mux surface as the video flavor — `src`, the structured `source`, and the\n * derived `contentData` all come from the shared mixin — over the subtractive\n * engine, so only the audio renditions of whatever the playback ID names are\n * fetched. That is the one place this diverges from the hls.js-backed\n * `<mux-audio>`, which runs the full engine and downloads video renditions it\n * never shows.\n *\n * `contentData` is kept rather than dropped, for the same reason its hls.js\n * counterpart has it: a playback ID played as audio is usually a *video* asset,\n * whose poster and storyboard exist and which an audio skin may well want. The\n * element ignores it either way. Mux publishes neither for a genuinely\n * audio-only asset, so those URLs 404 — see the known shortcoming on the video\n * flavor, which shares the derivation.\n */\nexport class MuxAudioMedia extends MuxAudioMediaBase {}\n"],"mappings":";;;AASA,MAAM,oBAAoB,cAAc,aAAa;;;;;;;;;;;;;;;;;;AAmBrD,IAAa,gBAAb,cAAmC,kBAAkB,CAAC"}

package/dist/default/playback/adapters/mux-video/adapter.js

@@ -0,0 +1,92 @@
+import { createMuxPosterURL, createMuxStoryboardURL, createMuxVideoURL, parseMuxVideoURL } from "@videojs/media/dom/mux/source";
+//#region src/playback/adapters/mux-video/adapter.ts
+const muxMediaDefaultProps = {
+	src: "",
+	source: null
+};
+/**
+* Mux identity over any SPF Media: the structured `source`, the `src` derived
+* from it, and the image URLs it describes.
+*
+* Everything here is Mux identity, so it carries no engine and both flavors get
+* it unchanged — the video Media over the full HLS engine, the audio-only Media
+* over the subtractive one. A mixin rather than a shared base class because each
+* flavor extends a different SPF Media, so there is no common class to put this
+* on, only a common `src` accessor to write through.
+*
+* Unlike the hls.js-backed `MuxMedia`, there is no inherited `source` to
+* delegate to — the SPF Medias know only `src` — so this owns the structured
+* source and dispatches `sourcechange` itself.
+*
+* @fires sourcechange - Fired when `source` changes, either directly or by parsing a new `src`. Read `source` for the new value.
+*/
+function MuxMediaMixin(BaseClass) {
+	class MuxMediaImpl extends BaseClass {
+		/**
+		* Named on the error copy when this engine can't play a source: the
+		* hls.js-backed Mux Media plays the MPEG-TS and DRM-protected sources that
+		* SPF does not, and it backs both `<mux-video>` and `<mux-audio>`.
+		*
+		* Names the flavor rather than an import path, because one Media is reached
+		* through three of them — `@videojs/html`, `@videojs/react`, and this package
+		* — and each has a different counterpart. The flavor suffix is the one thing
+		* common to the layers a consumer imports elements and components from.
+		*/
+		static get alternativeMediaSuggestion() {
+			return "Try the hls.js-backed Mux media instead: import the `hls-js` flavor in place of the `spf` one.";
+		}
+		#source = muxMediaDefaultProps.source;
+		/**
+		* Media source URL. Setting a Mux stream URL
+		* (`https://stream.mux.com/<playback-id>.m3u8?...`) extracts the playback ID
+		* and query params into `source`; other URLs are kept as a plain `source.src`.
+		*
+		* Only playback options carry over. Mux identity comes from the URL, and the
+		* signed `poster`, `storyboard`, and `drm` tokens are scoped to a playback ID,
+		* so carrying them onto a different source would build rejected URLs.
+		*/
+		get src() {
+			return super.src;
+		}
+		set src(value) {
+			if (super.src === value) return;
+			this.source = parseMuxVideoURL(value) ?? (value ? { src: value } : null);
+		}
+		/**
+		* Structured Mux source. Setting it derives `src` from the playback ID, custom
+		* domain, and `playback` params (appended as `snake_case` query params). A
+		* `playback.token` replaces all other params — signed URLs bake them into the
+		* token.
+		*/
+		get source() {
+			return this.#source;
+		}
+		set source(value) {
+			const source = value ?? null;
+			if (source === this.#source) return;
+			this.#source = source;
+			super.src = source && (createMuxVideoURL(source) ?? source.src) || "";
+			this.dispatchEvent?.(new Event("sourcechange"));
+		}
+		/**
+		* Image URLs `source` describes rather than plays: `poster` from its `poster`
+		* params, `storyboard` from its `storyboard` params.
+		*
+		* Read-only and re-derived on read, so read it again after `sourcechange`.
+		* Nothing here is applied for you.
+		*/
+		get contentData() {
+			const poster = createMuxPosterURL(this.#source);
+			const storyboard = createMuxStoryboardURL(this.#source);
+			return {
+				...poster && { poster },
+				...storyboard && { storyboard }
+			};
+		}
+	}
+	return MuxMediaImpl;
+}
+//#endregion
+export { MuxMediaMixin, muxMediaDefaultProps };
+
+//# sourceMappingURL=adapter.js.map

package/dist/default/playback/adapters/mux-video/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","names":["#source"],"sources":["../../../../../src/playback/adapters/mux-video/adapter.ts"],"sourcesContent":["import {\n  createMuxPosterURL,\n  createMuxStoryboardURL,\n  createMuxVideoURL,\n  type MuxContentData,\n  type MuxSourceBase,\n  parseMuxVideoURL,\n} from '@videojs/media/dom/mux/source';\nimport type { Constructor, MixinReturn } from '@videojs/utils/types';\n\nexport interface MuxMediaProps {\n  src: string;\n  source: MuxSourceBase | null;\n}\n\nexport const muxMediaDefaultProps: MuxMediaProps = {\n  src: '',\n  source: null,\n};\n\nexport interface MuxMediaAPI extends MuxMediaProps {\n  readonly contentData: MuxContentData;\n}\n\n/**\n * Mux identity over any SPF Media: the structured `source`, the `src` derived\n * from it, and the image URLs it describes.\n *\n * Everything here is Mux identity, so it carries no engine and both flavors get\n * it unchanged — the video Media over the full HLS engine, the audio-only Media\n * over the subtractive one. A mixin rather than a shared base class because each\n * flavor extends a different SPF Media, so there is no common class to put this\n * on, only a common `src` accessor to write through.\n *\n * Unlike the hls.js-backed `MuxMedia`, there is no inherited `source` to\n * delegate to — the SPF Medias know only `src` — so this owns the structured\n * source and dispatches `sourcechange` itself.\n *\n * @fires sourcechange - Fired when `source` changes, either directly or by parsing a new `src`. Read `source` for the new value.\n */\nexport function MuxMediaMixin<Base extends Constructor<any>>(BaseClass: Base) {\n  class MuxMediaImpl extends BaseClass {\n    /**\n     * Named on the error copy when this engine can't play a source: the\n     * hls.js-backed Mux Media plays the MPEG-TS and DRM-protected sources that\n     * SPF does not, and it backs both `<mux-video>` and `<mux-audio>`.\n     *\n     * Names the flavor rather than an import path, because one Media is reached\n     * through three of them — `@videojs/html`, `@videojs/react`, and this package\n     * — and each has a different counterpart. The flavor suffix is the one thing\n     * common to the layers a consumer imports elements and components from.\n     */\n    static get alternativeMediaSuggestion(): string | undefined {\n      return 'Try the hls.js-backed Mux media instead: import the `hls-js` flavor in place of the `spf` one.';\n    }\n\n    #source: MuxSourceBase | null = muxMediaDefaultProps.source;\n\n    /**\n     * Media source URL. Setting a Mux stream URL\n     * (`https://stream.mux.com/<playback-id>.m3u8?...`) extracts the playback ID\n     * and query params into `source`; other URLs are kept as a plain `source.src`.\n     *\n     * Only playback options carry over. Mux identity comes from the URL, and the\n     * signed `poster`, `storyboard`, and `drm` tokens are scoped to a playback ID,\n     * so carrying them onto a different source would build rejected URLs.\n     */\n    get src(): string {\n      return super.src;\n    }\n\n    set src(value: string) {\n      // A URL already describing the current source leaves it alone. The elements\n      // reflect the derived `src` back to the host, and re-deriving would drop the\n      // params a Mux URL does not carry, such as `poster`.\n      if (super.src === value) return;\n\n      this.source = parseMuxVideoURL(value) ?? (value ? { src: value } : null);\n    }\n\n    /**\n     * Structured Mux source. Setting it derives `src` from the playback ID, custom\n     * domain, and `playback` params (appended as `snake_case` query params). A\n     * `playback.token` replaces all other params — signed URLs bake them into the\n     * token.\n     */\n    get source(): MuxSourceBase | null {\n      return this.#source;\n    }\n\n    set source(value: MuxSourceBase | null) {\n      const source = value ?? null;\n      // Changing anything takes a new object, so handing the same one back costs\n      // nothing.\n      if (source === this.#source) return;\n\n      this.#source = source;\n      super.src = (source && (createMuxVideoURL(source) ?? source.src)) || '';\n\n      this.dispatchEvent?.(new Event('sourcechange'));\n    }\n\n    /**\n     * Image URLs `source` describes rather than plays: `poster` from its `poster`\n     * params, `storyboard` from its `storyboard` params.\n     *\n     * Read-only and re-derived on read, so read it again after `sourcechange`.\n     * Nothing here is applied for you.\n     */\n    get contentData(): MuxContentData {\n      const poster = createMuxPosterURL(this.#source);\n      const storyboard = createMuxStoryboardURL(this.#source);\n\n      return {\n        ...(poster && { poster }),\n        ...(storyboard && { storyboard }),\n      };\n    }\n  }\n\n  // `MixinReturn` sources statics from `Base`, so this mixin's own needs adding\n  // back to the type or callers can't read it.\n  return MuxMediaImpl as unknown as MixinReturn<Base, MuxMediaAPI> & {\n    readonly alternativeMediaSuggestion: string | undefined;\n  };\n}\n"],"mappings":";;AAeA,MAAa,uBAAsC;CACjD,KAAK;CACL,QAAQ;AACV;;;;;;;;;;;;;;;;;AAsBA,SAAgB,cAA6C,WAAiB;CAC5E,MAAM,qBAAqB,UAAU;;;;;;;;;;;EAWnC,WAAW,6BAAiD;GAC1D,OAAO;EACT;EAEA,UAAgC,qBAAqB;;;;;;;;;;EAWrD,IAAI,MAAc;GAChB,OAAO,MAAM;EACf;EAEA,IAAI,IAAI,OAAe;GAIrB,IAAI,MAAM,QAAQ,OAAO;GAEzB,KAAK,SAAS,iBAAiB,KAAK,MAAM,QAAQ,EAAE,KAAK,MAAM,IAAI;EACrE;;;;;;;EAQA,IAAI,SAA+B;GACjC,OAAO,KAAKA;EACd;EAEA,IAAI,OAAO,OAA6B;GACtC,MAAM,SAAS,SAAS;GAGxB,IAAI,WAAW,KAAKA,SAAS;GAE7B,KAAKA,UAAU;GACf,MAAM,MAAO,WAAW,kBAAkB,MAAM,KAAK,OAAO,QAAS;GAErE,KAAK,gBAAgB,IAAI,MAAM,cAAc,CAAC;EAChD;;;;;;;;EASA,IAAI,cAA8B;GAChC,MAAM,SAAS,mBAAmB,KAAKA,OAAO;GAC9C,MAAM,aAAa,uBAAuB,KAAKA,OAAO;GAEtD,OAAO;IACL,GAAI,UAAU,EAAE,OAAO;IACvB,GAAI,cAAc,EAAE,WAAW;GACjC;EACF;CACF;CAIA,OAAO;AAGT"}

package/dist/default/playback/adapters/mux-video/media.js

@@ -0,0 +1,23 @@
+import { HlsVideoMedia } from "../hls-video/media.js";
+import { MuxMediaMixin } from "./adapter.js";
+//#region src/playback/adapters/mux-video/media.ts
+const MuxVideoMediaBase = MuxMediaMixin(HlsVideoMedia);
+/**
+* The Mux Media over the SPF HLS engine.
+*
+* Mirrors `@videojs/media/dom/mux`'s hls.js-backed `MuxMedia` — same class shape,
+* same `src`/`source` relationship, same derived `contentData` — over a different
+* engine, though named for the flavor rather than sharing that class's name. It
+* carries no `engine` or `preferPlayback`: SPF publishes no
+* engine-shaped config for a consumer to pass, so the source is Mux identity and
+* nothing else.
+*
+* `source.drm` is accepted but inert. SPF prunes encrypted renditions and reports
+* unsupported DRM, and `alternativeMediaSuggestion` points at the hls.js-backed
+* import, so a protected source fails with copy that says where to go.
+*/
+var MuxVideoMedia = class extends MuxVideoMediaBase {};
+//#endregion
+export { MuxVideoMedia };
+
+//# sourceMappingURL=media.js.map

package/dist/default/playback/adapters/mux-video/media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","names":[],"sources":["../../../../../src/playback/adapters/mux-video/media.ts"],"sourcesContent":["import { HlsVideoMedia } from '../hls-video/media';\nimport { MuxMediaMixin } from './adapter';\n\nconst MuxVideoMediaBase = MuxMediaMixin(HlsVideoMedia);\n\n/**\n * The Mux Media over the SPF HLS engine.\n *\n * Mirrors `@videojs/media/dom/mux`'s hls.js-backed `MuxMedia` — same class shape,\n * same `src`/`source` relationship, same derived `contentData` — over a different\n * engine, though named for the flavor rather than sharing that class's name. It\n * carries no `engine` or `preferPlayback`: SPF publishes no\n * engine-shaped config for a consumer to pass, so the source is Mux identity and\n * nothing else.\n *\n * `source.drm` is accepted but inert. SPF prunes encrypted renditions and reports\n * unsupported DRM, and `alternativeMediaSuggestion` points at the hls.js-backed\n * import, so a protected source fails with copy that says where to go.\n */\nexport class MuxVideoMedia extends MuxVideoMediaBase {}\n"],"mappings":";;;AAGA,MAAM,oBAAoB,cAAc,aAAa;;;;;;;;;;;;;;;AAgBrD,IAAa,gBAAb,cAAmC,kBAAkB,CAAC"}

package/dist/default/playback/behaviors/calculate-presentation-duration.js.map

@@ -1 +1 @@
-{"version":3,"file":"calculate-presentation-duration.js","names":[],"sources":["../../../../src/playback/behaviors/calculate-presentation-duration.ts"],"sourcesContent":["/**\n * **Populate presentation duration via a config-supplied resolver.**\n *\n * Once a presentation is in place and its `duration` is still undefined,\n * calls `config.resolveDuration(state)` whenever a tracked slot changes. The\n * resolver decides what counts as \"duration is now derivable\" for the variant\n * in play; the behavior itself stays variant-agnostic:\n *\n * - **VoD** — derive from the first resolved selected track's `duration`\n *   (video preferred, audio fallback). The HLS engine wires\n *   `getResolvedSelectedTrackDuration` from `media/utils/track-selection.ts`\n *   as the default. Audio-only falls out of the same resolver naturally\n *   (no video selected → audio is the first resolved track).\n * - **Live** — return `Number.POSITIVE_INFINITY` once the presentation is\n *   established as live. This is the MSE-spec value for `mediaSource.duration`\n *   under live playback; downstream `updateMediaSourceDuration` propagates it through.\n *\n * Validation: writes whatever the resolver returns as long as it's a positive\n * number, including `Infinity`. `undefined` / `NaN` / `<= 0` are skipped.\n *\n * Fires at most once per presentation — an already-set `duration` is never\n * overwritten, and the next reset arrives structurally when a new\n * (unresolved) presentation replaces the current one. The resolver may\n * return `undefined` while duration is still indeterminate; subsequent\n * tracked-slot changes re-run the effect until the resolver commits a value.\n *\n * Downstream of `resolveVideoTrack` / `resolveAudioTrack`; upstream of\n * `updateMediaSourceDuration` (which writes the value through to `mediaSource.duration`).\n */\nimport type { Behavior } from '../../core/composition/create-composition';\nimport { effect } from '../../core/signals/effect';\nimport { type ReadonlySignal, type Signal, untrack, update } from '../../core/signals/primitives';\nimport type { MaybeResolvedPresentation } from '../../media/types';\n\n/**\n * Input shape passed to the duration resolver. Represents the union of\n * track-selection slots the default `getResolvedSelectedTrackDuration`\n * resolver inspects to pick a representative resolved track. Variants\n * that compose neither audio nor video selection still satisfy this\n * shape — the missing fields read as `undefined` and the resolver\n * falls through.\n */\nexport interface PresentationDurationState {\n  presentation?: MaybeResolvedPresentation;\n  selectedVideoTrackId?: string;\n  selectedAudioTrackId?: string;\n}\n\n/**\n * Resolver supplied via `config.resolveDuration`. Returns the duration to\n * write to `presentation.duration`, or `undefined` when it isn't yet\n * derivable. Positive `Infinity` is the canonical live value.\n */\nexport type PresentationDurationResolver = (state: PresentationDurationState) => number | undefined;\n\nexport interface PresentationDurationConfig {\n  resolveDuration: PresentationDurationResolver;\n}\n\nfunction calculatePresentationDurationSetup({\n  state,\n  config,\n}: {\n  state: {\n    presentation: Signal<PresentationDurationState['presentation']>;\n    // selectedVideoTrackId / selectedAudioTrackId are read defensively —\n    // they are *not* declared in this behavior's stateKeys. The slots are\n    // contributed by other behaviors (`switchVideoTrack` writes the\n    // video slot in the default engine; `selectAudioTrack` writes the\n    // audio slot) which compose conditionally per engine variant. Treating\n    // each signal as optional lets calculatePresentationDuration stay\n    // variant-agnostic — it feeds whatever's present to the resolver and\n    // lets the resolver decide.\n    selectedVideoTrackId?: ReadonlySignal<PresentationDurationState['selectedVideoTrackId']>;\n    selectedAudioTrackId?: ReadonlySignal<PresentationDurationState['selectedAudioTrackId']>;\n  };\n  config: PresentationDurationConfig;\n}): () => void {\n  return effect(() => {\n    const presentation = state.presentation.get();\n    if (!presentation || presentation.duration !== undefined) return;\n\n    // presentation drives the effect; selection-only changes can't yield a\n    // writable duration on their own (resolver returns undefined until a\n    // track resolves, at which point resolve-track writes back through\n    // state.presentation anyway), so we read the rest untracked.\n    const resolverInput: PresentationDurationState = untrack(() => ({\n      presentation,\n      selectedVideoTrackId: state.selectedVideoTrackId?.get(),\n      selectedAudioTrackId: state.selectedAudioTrackId?.get(),\n    }));\n    const duration = config.resolveDuration(resolverInput);\n    if (duration === undefined || Number.isNaN(duration) || duration <= 0) return;\n\n    // Patch-object form requires `T extends object`; `state.presentation`'s\n    // T is `MaybeResolvedPresentation | undefined`, which doesn't satisfy\n    // the constraint. The guard at the top of the effect already\n    // established that the slot holds a defined value, so cast to narrow\n    // the signal type and use the cleaner merge form.\n    update(state.presentation as Signal<MaybeResolvedPresentation>, { duration });\n  });\n}\n\n/**\n * `calculatePresentationDuration` uses a manual `Behavior<>` literal\n * (rather than `defineBehavior`) so it can declare just `presentation`\n * in its stateKeys while the typed setup-param shape includes the\n * optional `selectedVideoTrackId` / `selectedAudioTrackId` reads used\n * at runtime. Mirrors the pattern in `endOfStream` for the same\n * reason: the behavior is uniform-across-tracks and reads slots\n * contributed by other behaviors, so it shouldn't leak those slot\n * declarations into variants that don't compose the contributors.\n */\nexport const calculatePresentationDuration: Behavior<\n  { presentation: Signal<PresentationDurationState['presentation']> },\n  Record<string, never>,\n  PresentationDurationConfig\n> = {\n  stateKeys: ['presentation'],\n  contextKeys: [],\n  setup: calculatePresentationDurationSetup,\n};\n"],"mappings":";;;AA2DA,SAAS,mCAAmC,EAC1C,OACA,UAgBa;AACb,QAAO,aAAa;EAClB,MAAM,eAAe,MAAM,aAAa,KAAK;AAC7C,MAAI,CAAC,gBAAgB,aAAa,aAAa,KAAA,EAAW;EAM1D,MAAM,gBAA2C,eAAe;GAC9D;GACA,sBAAsB,MAAM,sBAAsB,KAAK;GACvD,sBAAsB,MAAM,sBAAsB,KAAK;GACxD,EAAE;EACH,MAAM,WAAW,OAAO,gBAAgB,cAAc;AACtD,MAAI,aAAa,KAAA,KAAa,OAAO,MAAM,SAAS,IAAI,YAAY,EAAG;AAOvE,SAAO,MAAM,cAAmD,EAAE,UAAU,CAAC;GAC7E;;;;;;;;;;;;AAaJ,MAAa,gCAIT;CACF,WAAW,CAAC,eAAe;CAC3B,aAAa,EAAE;CACf,OAAO;CACR"}
+{"version":3,"file":"calculate-presentation-duration.js","names":[],"sources":["../../../../src/playback/behaviors/calculate-presentation-duration.ts"],"sourcesContent":["/**\n * **Populate presentation duration via a config-supplied resolver.**\n *\n * Once a presentation is in place and its `duration` is still undefined,\n * calls `config.resolveDuration(state)` whenever a tracked slot changes. The\n * resolver decides what counts as \"duration is now derivable\" for the variant\n * in play; the behavior itself stays variant-agnostic:\n *\n * - **VoD** — derive from the first resolved selected track's `duration`\n *   (video preferred, audio fallback). The HLS engine wires\n *   `getResolvedSelectedTrackDuration` from `media/utils/track-selection.ts`\n *   as the default. Audio-only falls out of the same resolver naturally\n *   (no video selected → audio is the first resolved track).\n * - **Live** — return `Number.POSITIVE_INFINITY` once the presentation is\n *   established as live. This is the MSE-spec value for `mediaSource.duration`\n *   under live playback; downstream `updateMediaSourceDuration` propagates it through.\n *\n * Validation: writes whatever the resolver returns as long as it's a positive\n * number, including `Infinity`. `undefined` / `NaN` / `<= 0` are skipped.\n *\n * Fires at most once per presentation — an already-set `duration` is never\n * overwritten, and the next reset arrives structurally when a new\n * (unresolved) presentation replaces the current one. The resolver may\n * return `undefined` while duration is still indeterminate; subsequent\n * tracked-slot changes re-run the effect until the resolver commits a value.\n *\n * Downstream of `resolveVideoTrack` / `resolveAudioTrack`; upstream of\n * `updateMediaSourceDuration` (which writes the value through to `mediaSource.duration`).\n */\nimport type { Behavior } from '../../core/composition/create-composition';\nimport { effect } from '../../core/signals/effect';\nimport { type ReadonlySignal, type Signal, untrack, update } from '../../core/signals/primitives';\nimport type { MaybeResolvedPresentation } from '../../media/types';\n\n/**\n * Input shape passed to the duration resolver. Represents the union of\n * track-selection slots the default `getResolvedSelectedTrackDuration`\n * resolver inspects to pick a representative resolved track. Variants\n * that compose neither audio nor video selection still satisfy this\n * shape — the missing fields read as `undefined` and the resolver\n * falls through.\n */\nexport interface PresentationDurationState {\n  presentation?: MaybeResolvedPresentation;\n  selectedVideoTrackId?: string;\n  selectedAudioTrackId?: string;\n}\n\n/**\n * Resolver supplied via `config.resolveDuration`. Returns the duration to\n * write to `presentation.duration`, or `undefined` when it isn't yet\n * derivable. Positive `Infinity` is the canonical live value.\n */\nexport type PresentationDurationResolver = (state: PresentationDurationState) => number | undefined;\n\nexport interface PresentationDurationConfig {\n  resolveDuration: PresentationDurationResolver;\n}\n\nfunction calculatePresentationDurationSetup({\n  state,\n  config,\n}: {\n  state: {\n    presentation: Signal<PresentationDurationState['presentation']>;\n    // selectedVideoTrackId / selectedAudioTrackId are read defensively —\n    // they are *not* declared in this behavior's stateKeys. The slots are\n    // contributed by other behaviors (`switchVideoTrack` writes the\n    // video slot in the default engine; `selectAudioTrack` writes the\n    // audio slot) which compose conditionally per engine variant. Treating\n    // each signal as optional lets calculatePresentationDuration stay\n    // variant-agnostic — it feeds whatever's present to the resolver and\n    // lets the resolver decide.\n    selectedVideoTrackId?: ReadonlySignal<PresentationDurationState['selectedVideoTrackId']>;\n    selectedAudioTrackId?: ReadonlySignal<PresentationDurationState['selectedAudioTrackId']>;\n  };\n  config: PresentationDurationConfig;\n}): () => void {\n  return effect(() => {\n    const presentation = state.presentation.get();\n    if (!presentation || presentation.duration !== undefined) return;\n\n    // presentation drives the effect; selection-only changes can't yield a\n    // writable duration on their own (resolver returns undefined until a\n    // track resolves, at which point resolve-track writes back through\n    // state.presentation anyway), so we read the rest untracked.\n    const resolverInput: PresentationDurationState = untrack(() => ({\n      presentation,\n      selectedVideoTrackId: state.selectedVideoTrackId?.get(),\n      selectedAudioTrackId: state.selectedAudioTrackId?.get(),\n    }));\n    const duration = config.resolveDuration(resolverInput);\n    if (duration === undefined || Number.isNaN(duration) || duration <= 0) return;\n\n    // Patch-object form requires `T extends object`; `state.presentation`'s\n    // T is `MaybeResolvedPresentation | undefined`, which doesn't satisfy\n    // the constraint. The guard at the top of the effect already\n    // established that the slot holds a defined value, so cast to narrow\n    // the signal type and use the cleaner merge form.\n    update(state.presentation as Signal<MaybeResolvedPresentation>, { duration });\n  });\n}\n\n/**\n * `calculatePresentationDuration` uses a manual `Behavior<>` literal\n * (rather than `defineBehavior`) so it can declare just `presentation`\n * in its stateKeys while the typed setup-param shape includes the\n * optional `selectedVideoTrackId` / `selectedAudioTrackId` reads used\n * at runtime. Mirrors the pattern in `endOfStream` for the same\n * reason: the behavior is uniform-across-tracks and reads slots\n * contributed by other behaviors, so it shouldn't leak those slot\n * declarations into variants that don't compose the contributors.\n */\nexport const calculatePresentationDuration: Behavior<\n  { presentation: Signal<PresentationDurationState['presentation']> },\n  Record<string, never>,\n  PresentationDurationConfig\n> = {\n  stateKeys: ['presentation'],\n  contextKeys: [],\n  setup: calculatePresentationDurationSetup,\n};\n"],"mappings":";;;AA2DA,SAAS,mCAAmC,EAC1C,OACA,UAgBa;CACb,OAAO,aAAa;EAClB,MAAM,eAAe,MAAM,aAAa,IAAI;EAC5C,IAAI,CAAC,gBAAgB,aAAa,aAAa,KAAA,GAAW;EAM1D,MAAM,gBAA2C,eAAe;GAC9D;GACA,sBAAsB,MAAM,sBAAsB,IAAI;GACtD,sBAAsB,MAAM,sBAAsB,IAAI;EACxD,EAAE;EACF,MAAM,WAAW,OAAO,gBAAgB,aAAa;EACrD,IAAI,aAAa,KAAA,KAAa,OAAO,MAAM,QAAQ,KAAK,YAAY,GAAG;EAOvE,OAAO,MAAM,cAAmD,EAAE,SAAS,CAAC;CAC9E,CAAC;AACH;;;;;;;;;;;AAYA,MAAa,gCAIT;CACF,WAAW,CAAC,cAAc;CAC1B,aAAa,CAAC;CACd,OAAO;AACT"}

package/dist/default/playback/behaviors/collect-errors.js

@@ -0,0 +1,77 @@
+import { computed, update } from "../../core/signals/primitives.js";
+import { defineBehavior } from "../../core/composition/create-composition.js";
+import { createMachineReactor } from "../../core/reactors/create-machine-reactor.js";
+import { isResolvedPresentation } from "../../media/types/index.js";
+//#region src/playback/behaviors/collect-errors.ts
+/**
+* **Owns the engine's error sequence.** Reporters append through
+* {@link emitError}; this behavior owns the slot and its per-source lifecycle,
+* clearing it on exit so a new source starts clean and the sequence can't grow
+* unbounded across a session.
+*
+* Same split as `setupFailoverMonitor` and `failedCdns`: writes come from
+* wherever the condition is detected, one behavior owns the slot. Deliberately
+* has no `effects` — it holds no policy and derives nothing. Severity is decided
+* at the adapter, not here (see `internal/design/spf/features/errors.md`), which
+* is why this is a lifecycle owner rather than an error *handler*.
+*
+* Clearing binds to *exit* of `presentation-resolved`, mirroring the sibling
+* mixins' clear-on-teardown (`emptied` / `MEDIA_DETACHED`). A live reload swaps
+* the presentation object without leaving the resolved state, so it doesn't
+* clear — only an actual source change or destroy does. Known gap: a
+* resolved→resolved source swap that never passes through unresolved carries the
+* prior source's errors forward; `resolve-track` guards the same transition with
+* a commit-time id check, and doing likewise here is a follow-up.
+*
+* The vocabulary itself ({@link SvtaError} and the codes) is DOM- and
+* signal-free in `media/errors`; only the write seam lives here, with the slot
+* it writes.
+*/
+/**
+* Append `error` to the engine's error sequence. No-op when no owner is
+* composed. Replaces the array rather than mutating it, so signal consumers
+* notify; duplicates are kept, since a repeated condition is a real observation.
+* Writes go through `update` so concurrent reporters can't lose each other's
+* appends.
+*
+* Every emission is logged, deliberately *before* the owner check. A condition
+* emitted with no `collectErrors` composed is dropped on the floor — that's the
+* case where a log is the only evidence it happened at all, so gating the log on
+* the same check would hide exactly what's worth seeing. Emissions that *are*
+* collected still get logged, because reaching `state.errors` is no guarantee of
+* reaching a person: only *verdicts* are promoted to the media surface, so every
+* cause (and any non-fatal notice) is otherwise invisible outside a debugger.
+*
+* Ungated rather than `__DEV__`-only, matching the other reporting paths in this
+* package (`resolve-presentation`, `track-switching`, the segment actors).
+*/
+function emitError(state, error) {
+	console.error("[spf] reported condition", error);
+	if (!state.errors) return;
+	update(state.errors, (errors) => [...errors ?? [], error]);
+}
+/**
+* Own `errors` for the resolved source's lifetime.
+*
+* @example
+* const reactor = collectErrors.setup({ state });
+*/
+const collectErrors = defineBehavior({
+	stateKeys: ["presentation", "errors"],
+	contextKeys: [],
+	setup: ({ state }) => {
+		const derivedStateSignal = computed(() => isResolvedPresentation(state.presentation.get()) ? "presentation-resolved" : "presentation-unresolved");
+		return createMachineReactor({
+			initial: "presentation-unresolved",
+			monitor: () => derivedStateSignal.get(),
+			states: {
+				"presentation-unresolved": {},
+				"presentation-resolved": { entry: () => () => state.errors.set(void 0) }
+			}
+		});
+	}
+});
+//#endregion
+export { collectErrors, emitError };
+
+//# sourceMappingURL=collect-errors.js.map

package/dist/default/playback/behaviors/collect-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-errors.js","names":[],"sources":["../../../../src/playback/behaviors/collect-errors.ts"],"sourcesContent":["/**\n * **Owns the engine's error sequence.** Reporters append through\n * {@link emitError}; this behavior owns the slot and its per-source lifecycle,\n * clearing it on exit so a new source starts clean and the sequence can't grow\n * unbounded across a session.\n *\n * Same split as `setupFailoverMonitor` and `failedCdns`: writes come from\n * wherever the condition is detected, one behavior owns the slot. Deliberately\n * has no `effects` — it holds no policy and derives nothing. Severity is decided\n * at the adapter, not here (see `internal/design/spf/features/errors.md`), which\n * is why this is a lifecycle owner rather than an error *handler*.\n *\n * Clearing binds to *exit* of `presentation-resolved`, mirroring the sibling\n * mixins' clear-on-teardown (`emptied` / `MEDIA_DETACHED`). A live reload swaps\n * the presentation object without leaving the resolved state, so it doesn't\n * clear — only an actual source change or destroy does. Known gap: a\n * resolved→resolved source swap that never passes through unresolved carries the\n * prior source's errors forward; `resolve-track` guards the same transition with\n * a commit-time id check, and doing likewise here is a follow-up.\n *\n * The vocabulary itself ({@link SvtaError} and the codes) is DOM- and\n * signal-free in `media/errors`; only the write seam lives here, with the slot\n * it writes.\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 type { SvtaError } from '../../media/errors';\nimport { isResolvedPresentation, type MaybeResolvedPresentation } from '../../media/types';\n\nexport interface CollectErrorsState {\n  presentation?: MaybeResolvedPresentation;\n  errors?: SvtaError[];\n}\n\n/**\n * State an error reporter writes into. The slot is *optional*: a behavior reports\n * through this seam without declaring ownership in its own typed slice, and\n * emission no-ops when `collectErrors` isn't composed. Same contract as\n * `failedCdns` / `failoverFetch`.\n */\nexport interface ErrorEmitterState {\n  errors?: Signal<SvtaError[] | undefined>;\n}\n\n/**\n * Append `error` to the engine's error sequence. No-op when no owner is\n * composed. Replaces the array rather than mutating it, so signal consumers\n * notify; duplicates are kept, since a repeated condition is a real observation.\n * Writes go through `update` so concurrent reporters can't lose each other's\n * appends.\n *\n * Every emission is logged, deliberately *before* the owner check. A condition\n * emitted with no `collectErrors` composed is dropped on the floor — that's the\n * case where a log is the only evidence it happened at all, so gating the log on\n * the same check would hide exactly what's worth seeing. Emissions that *are*\n * collected still get logged, because reaching `state.errors` is no guarantee of\n * reaching a person: only *verdicts* are promoted to the media surface, so every\n * cause (and any non-fatal notice) is otherwise invisible outside a debugger.\n *\n * Ungated rather than `__DEV__`-only, matching the other reporting paths in this\n * package (`resolve-presentation`, `track-switching`, the segment actors).\n */\nexport function emitError(state: ErrorEmitterState, error: SvtaError): void {\n  console.error('[spf] reported condition', error);\n  if (!state.errors) return;\n  update(state.errors, (errors) => [...(errors ?? []), error]);\n}\n\n/**\n * Own `errors` for the resolved source's lifetime.\n *\n * @example\n * const reactor = collectErrors.setup({ state });\n */\nexport const collectErrors = defineBehavior({\n  stateKeys: ['presentation', 'errors'],\n  contextKeys: [],\n  setup: ({\n    state,\n  }: {\n    state: {\n      presentation: ReadonlySignal<CollectErrorsState['presentation']>;\n      errors: Signal<CollectErrorsState['errors']>;\n    };\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          // Cleanup-binds-to-setup: reset for the next source on exit (src\n          // unload + destroy).\n          entry: () => () => state.errors.set(undefined),\n        },\n      },\n    });\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgEA,SAAgB,UAAU,OAA0B,OAAwB;CAC1E,QAAQ,MAAM,4BAA4B,KAAK;CAC/C,IAAI,CAAC,MAAM,QAAQ;CACnB,OAAO,MAAM,SAAS,WAAW,CAAC,GAAI,UAAU,CAAC,GAAI,KAAK,CAAC;AAC7D;;;;;;;AAQA,MAAa,gBAAgB,eAAe;CAC1C,WAAW,CAAC,gBAAgB,QAAQ;CACpC,aAAa,CAAC;CACd,QAAQ,EACN,YAMI;EACJ,MAAM,qBAAqB,eACzB,uBAAuB,MAAM,aAAa,IAAI,CAAC,IAC1C,0BACA,yBACP;EAEA,OAAO,qBAAqB;GAC1B,SAAS;GACT,eAAe,mBAAmB,IAAI;GACtC,QAAQ;IACN,2BAA2B,CAAC;IAC5B,yBAAyB,EAGvB,mBAAmB,MAAM,OAAO,IAAI,KAAA,CAAS,EAC/C;GACF;EACF,CAAC;CACH;AACF,CAAC"}

package/dist/default/playback/behaviors/derive-cdn-priority.js.map

@@ -1 +1 @@
-{"version":3,"file":"derive-cdn-priority.js","names":["getCdnId","defaultGetCdnId"],"sources":["../../../../src/playback/behaviors/derive-cdn-priority.ts"],"sourcesContent":["/**\n * **Session-level CDN priority.** While a presentation is resolved, owns the\n * `cdnPriority` signal: the distinct CDNs the source is served from (origin of\n * each track's URL), in manifest priority order — most-preferred first. Cleared\n * on src unload. The name mirrors HLS content steering's `PATHWAY-PRIORITY`.\n *\n * Redundant-stream sources (e.g. Mux's `?redundant_streams=true`) list the same\n * content on multiple hosts, so the candidate tracks already include one variant\n * per CDN. This behavior publishes *which* CDNs exist and their priority; the\n * `preferActiveCdn` scope rule in `track-switching` reads `cdnPriority` and\n * narrows each type's candidates to the first CDN with surviving tracks — so\n * video / audio / text all resolve from one host (the shared list is the\n * per-presentation coherence guarantee).\n *\n * The \"active\" CDN is not stored — it's derived by the scope as the\n * highest-priority entry in `cdnPriority` that still has tracks after the\n * constraints pre-pass. That makes failover a pure consequence of the (future)\n * failed-CDN constraint: when the primary's tracks are pruned during cooldown,\n * the scope falls to the next CDN; when the primary recovers, it snaps back.\n * Content steering, when it lands, reorders `cdnPriority` (pathway priority as a\n * sort key).\n *\n * Lifecycle: `'presentation-unresolved'` ↔ `'presentation-resolved'`, mirroring\n * `setupTrackSwitching`. The resolved state owns the signal; its entry-returned\n * cleanup clears it on exit (canonical cleanup-binds-to-setup per `reactors.md`).\n */\n\nimport { defineBehavior } from '../../core/composition/create-composition';\nimport { createMachineReactor } from '../../core/reactors/create-machine-reactor';\nimport { computed, peek, type ReadonlySignal, type Signal } from '../../core/signals/primitives';\nimport { isResolvedPresentation, type MaybeResolvedPresentation } from '../../media/types';\nimport { getCdnId as defaultGetCdnId, type GetCdnId, getOrderedCdnIds } from '../../media/utils/cdn';\n\nexport interface DeriveCdnPriorityState {\n  presentation?: MaybeResolvedPresentation;\n  cdnPriority?: string[];\n}\n\nconst samePriority = (a: string[] | undefined, b: string[]): boolean =>\n  !!a && a.length === b.length && a.every((cdn, i) => cdn === b[i]);\n\n/**\n * Manage `cdnPriority`: publish the manifest-ordered CDN list on src load, clear\n * on src unload.\n *\n * @example\n * const reactor = deriveCdnPriority.setup({ state });\n */\nexport const deriveCdnPriority = defineBehavior({\n  stateKeys: ['presentation', 'cdnPriority'],\n  contextKeys: [],\n  setup: ({\n    state,\n    config = {},\n  }: {\n    state: {\n      presentation: ReadonlySignal<DeriveCdnPriorityState['presentation']>;\n      cdnPriority: Signal<DeriveCdnPriorityState['cdnPriority']>;\n    };\n    config?: { getCdnId?: GetCdnId };\n  }) => {\n    const getCdnId = config.getCdnId ?? defaultGetCdnId;\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: the CDN priority list is valid for exactly\n          // 'presentation-resolved'. Clear fires on exit (src unload + destroy).\n          entry: () => () => state.cdnPriority.set(undefined),\n          effects: [\n            () => {\n              const presentation = state.presentation.get();\n              if (!isResolvedPresentation(presentation)) return;\n              const next = getOrderedCdnIds(presentation, getCdnId);\n              // Skip the write when the CDN set is unchanged — a live reload swaps\n              // in a new presentation object with the same hosts, and re-setting a\n              // fresh array would re-fire the scope for an identical result.\n              // `peek` reads without subscribing, so this never self-triggers.\n              if (!samePriority(peek(state.cdnPriority), next)) state.cdnPriority.set(next);\n            },\n          ],\n        },\n      },\n    });\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,MAAM,gBAAgB,GAAyB,MAC7C,CAAC,CAAC,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,KAAK,MAAM,QAAQ,EAAE,GAAG;;;;;;;;AASnE,MAAa,oBAAoB,eAAe;CAC9C,WAAW,CAAC,gBAAgB,cAAc;CAC1C,aAAa,EAAE;CACf,QAAQ,EACN,OACA,SAAS,EAAE,OAOP;EACJ,MAAMA,aAAW,OAAO,YAAYC;EACpC,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,MAAM,YAAY,IAAI,KAAA,EAAU;KACnD,SAAS,OACD;MACJ,MAAM,eAAe,MAAM,aAAa,KAAK;AAC7C,UAAI,CAAC,uBAAuB,aAAa,CAAE;MAC3C,MAAM,OAAO,iBAAiB,cAAcD,WAAS;AAKrD,UAAI,CAAC,aAAa,KAAK,MAAM,YAAY,EAAE,KAAK,CAAE,OAAM,YAAY,IAAI,KAAK;OAEhF;KACF;IACF;GACF,CAAC;;CAEL,CAAC"}
+{"version":3,"file":"derive-cdn-priority.js","names":["getCdnId","defaultGetCdnId"],"sources":["../../../../src/playback/behaviors/derive-cdn-priority.ts"],"sourcesContent":["/**\n * **Session-level CDN priority.** While a presentation is resolved, owns the\n * `cdnPriority` signal: the distinct CDNs the source is served from (origin of\n * each track's URL), in manifest priority order — most-preferred first. Cleared\n * on src unload. The name mirrors HLS content steering's `PATHWAY-PRIORITY`.\n *\n * Redundant-stream sources (e.g. Mux's `?redundant_streams=true`) list the same\n * content on multiple hosts, so the candidate tracks already include one variant\n * per CDN. This behavior publishes *which* CDNs exist and their priority; the\n * `preferActiveCdn` scope rule in `track-switching` reads `cdnPriority` and\n * narrows each type's candidates to the first CDN with surviving tracks — so\n * video / audio / text all resolve from one host (the shared list is the\n * per-presentation coherence guarantee).\n *\n * The \"active\" CDN is not stored — it's derived by the scope as the\n * highest-priority entry in `cdnPriority` that still has tracks after the\n * constraints pre-pass. That makes failover a pure consequence of the (future)\n * failed-CDN constraint: when the primary's tracks are pruned during cooldown,\n * the scope falls to the next CDN; when the primary recovers, it snaps back.\n * Content steering, when it lands, reorders `cdnPriority` (pathway priority as a\n * sort key).\n *\n * Lifecycle: `'presentation-unresolved'` ↔ `'presentation-resolved'`, mirroring\n * `setupTrackSwitching`. The resolved state owns the signal; its entry-returned\n * cleanup clears it on exit (canonical cleanup-binds-to-setup per `reactors.md`).\n */\n\nimport { defineBehavior } from '../../core/composition/create-composition';\nimport { createMachineReactor } from '../../core/reactors/create-machine-reactor';\nimport { computed, peek, type ReadonlySignal, type Signal } from '../../core/signals/primitives';\nimport { isResolvedPresentation, type MaybeResolvedPresentation } from '../../media/types';\nimport { getCdnId as defaultGetCdnId, type GetCdnId, getOrderedCdnIds } from '../../media/utils/cdn';\n\nexport interface DeriveCdnPriorityState {\n  presentation?: MaybeResolvedPresentation;\n  cdnPriority?: string[];\n}\n\nconst samePriority = (a: string[] | undefined, b: string[]): boolean =>\n  !!a && a.length === b.length && a.every((cdn, i) => cdn === b[i]);\n\n/**\n * Manage `cdnPriority`: publish the manifest-ordered CDN list on src load, clear\n * on src unload.\n *\n * @example\n * const reactor = deriveCdnPriority.setup({ state });\n */\nexport const deriveCdnPriority = defineBehavior({\n  stateKeys: ['presentation', 'cdnPriority'],\n  contextKeys: [],\n  setup: ({\n    state,\n    config = {},\n  }: {\n    state: {\n      presentation: ReadonlySignal<DeriveCdnPriorityState['presentation']>;\n      cdnPriority: Signal<DeriveCdnPriorityState['cdnPriority']>;\n    };\n    config?: { getCdnId?: GetCdnId };\n  }) => {\n    const getCdnId = config.getCdnId ?? defaultGetCdnId;\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: the CDN priority list is valid for exactly\n          // 'presentation-resolved'. Clear fires on exit (src unload + destroy).\n          entry: () => () => state.cdnPriority.set(undefined),\n          effects: [\n            () => {\n              const presentation = state.presentation.get();\n              if (!isResolvedPresentation(presentation)) return;\n              const next = getOrderedCdnIds(presentation, getCdnId);\n              // Skip the write when the CDN set is unchanged — a live reload swaps\n              // in a new presentation object with the same hosts, and re-setting a\n              // fresh array would re-fire the scope for an identical result.\n              // `peek` reads without subscribing, so this never self-triggers.\n              if (!samePriority(peek(state.cdnPriority), next)) state.cdnPriority.set(next);\n            },\n          ],\n        },\n      },\n    });\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,MAAM,gBAAgB,GAAyB,MAC7C,CAAC,CAAC,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,KAAK,MAAM,QAAQ,EAAE,EAAE;;;;;;;;AASlE,MAAa,oBAAoB,eAAe;CAC9C,WAAW,CAAC,gBAAgB,aAAa;CACzC,aAAa,CAAC;CACd,QAAQ,EACN,OACA,SAAS,CAAC,QAON;EACJ,MAAMA,aAAW,OAAO,YAAYC;EACpC,MAAM,qBAAqB,eACzB,uBAAuB,MAAM,aAAa,IAAI,CAAC,IAC1C,0BACA,yBACP;EAEA,OAAO,qBAAqB;GAC1B,SAAS;GACT,eAAe,mBAAmB,IAAI;GACtC,QAAQ;IACN,2BAA2B,CAAC;IAC5B,yBAAyB;KAGvB,mBAAmB,MAAM,YAAY,IAAI,KAAA,CAAS;KAClD,SAAS,OACD;MACJ,MAAM,eAAe,MAAM,aAAa,IAAI;MAC5C,IAAI,CAAC,uBAAuB,YAAY,GAAG;MAC3C,MAAM,OAAO,iBAAiB,cAAcD,UAAQ;MAKpD,IAAI,CAAC,aAAa,KAAK,MAAM,WAAW,GAAG,IAAI,GAAG,MAAM,YAAY,IAAI,IAAI;KAC9E,CACF;IACF;GACF;EACF,CAAC;CACH;AACF,CAAC"}

package/dist/default/playback/behaviors/dom/airplay.js

@@ -0,0 +1,211 @@
+import { computed, peek } from "../../../core/signals/primitives.js";
+import { defineBehavior } from "../../../core/composition/create-composition.js";
+import { effect } from "../../../core/signals/effect.js";
+import { createMachineReactor } from "../../../core/reactors/create-machine-reactor.js";
+import { isWebKitAirPlayCapable, listen } from "@videojs/utils/dom";
+//#region src/playback/behaviors/dom/airplay.ts
+/**
+* **Bridge MSE playback to AirPlay on WebKit.**
+* MSE streams can't be handed to an AirPlay receiver directly.
+* The WebKit-recommended workaround is to append a fallback
+* `<source type="application/x-mpegURL">` carrying the original manifest URL:
+* Safari exposes the AirPlay picker and, when a wireless target is selected,
+* plays that native-HLS source on the receiver. The session state (WebKit's
+* wireless flag, falling edge debounced — see `REMOTE_INACTIVE_SETTLE_MS`) is
+* written straight to its policy consequences, declared here so the
+* cause→policy mapping stays with the feature:
+*
+* - `state.loadingSuspended` — held while the session is live. Observed by
+*   the `loadXSegments` dispatchers (no fetching alongside the receiver) and
+*   by `setupMediaSource` (its post-close rebuild waits — attaching runs
+*   `element.load()` under the live receiver, which destroys a session still
+*   being established). The suspension this behavior holds doubles as its own
+*   session fact — same writer, same edges.
+* - `state.startPosition` — one-shot command: the position is captured from
+*   the element at the session's settled end (still receiver-mirrored) and
+*   written once the rebuild's `load()` resets the element (its `'emptied'`),
+*   so `applyStartPosition` applies it to the rebuilt source — never to the
+*   pre-rebuild element — and starts it where the receiver left off. The
+*   playing state rides the same snapshot but stays behavior-local: this
+*   behavior itself calls `play()` once the command has been *consumed* — i.e.
+*   after the seek — when the receiver was playing at session end. The whole
+*   restore is bound to the presentation the session owned and retracted if
+*   that changes.
+*
+* A source change during a live session releases the hold rather than deferring
+* until the session ends, so the rebuild runs and WebKit switches the receiver
+* to the newly-built AirPlay alternate. Measured, not contracted — see the
+* effect below.
+* https://webkit.org/blog/15036/how-to-use-media-source-extensions-with-airplay/
+*
+* Single-positive-state reactor (`'preconditions-unmet'` ↔ `'airplay-capable'`):
+* gated on a WebKit-AirPlay-capable media element being in scope. The entry —
+* gated on `context.mediaSource` — appends the fallback `<source>` (kept
+* current from `state.presentation`) and enables the AirPlay picker once the
+* MediaSource is open, removing the source the moment the MediaSource detaches
+* so it never survives an MSE teardown. State-exit cleanup (author opt-out,
+* detach, source reset, behavior destroy) removes the source and restores the
+* element's `disableRemotePlayback` default. No-op on non-WebKit platforms
+* (Chromium, Firefox) — `deriveState` never leaves `'preconditions-unmet'`.
+*
+* MMS and AirPlay want *opposite* values of `disableRemotePlayback` on the same
+* element, so it is **sequenced**:
+*
+* - **MMS needs `true` to open.** `setupMediaSource` sets
+*   `disableRemotePlayback = true` when it attaches a ManagedMediaSource —
+*   Safari won't fire `sourceopen` (and MSE playback never starts) otherwise.
+* - **AirPlay needs `false` to offer the picker.** Flipping to `false` *before*
+*   the source opens would prevent `sourceopen`, so the flip is gated on
+*   `context.mediaSource` — which `setupMediaSource` publishes exactly once the
+*   MS is open. Re-fires per source (the slot clears + republishes on reset).
+* - **Author opt-out wins.** `state.disableRemotePlayback` is the author's
+*   intent, written only by the media adapter's IDL property; MMS/programmatic
+*   code touch the element's own `disableRemotePlayback` instead. A `true`
+*   there is unambiguously the author's choice to disable remote playback, so
+*   it holds the machine in `'preconditions-unmet'` and nothing is set up.
+*/
+/**
+* How long WebKit's wireless flag must read *inactive* before the
+* session-driven `loadingSuspended` clears.
+*
+* Measured on Safari 26.4 (macOS): when an AirPlay session engages, Safari
+* closes the ManagedMediaSource and — while its pipeline switches to the
+* native-HLS fallback source — transiently reports
+* `webkitCurrentPlaybackTargetIsWireless === false`, firing the changed
+* event. Trusting an instantaneous inactive reading would release
+* `setupMediaSource`'s rebuild hold mid-handoff; its recovery `load()` then
+* destroys the very session being established. Rising edges apply
+* immediately; only the falling edge waits out this settle window.
+*/
+const REMOTE_INACTIVE_SETTLE_MS = 1e3;
+function deriveState(mediaElement, authorDisabledRemotePlayback) {
+	if (!mediaElement || !isWebKitAirPlayCapable(mediaElement)) return "preconditions-unmet";
+	if (authorDisabledRemotePlayback) return "preconditions-unmet";
+	return "airplay-capable";
+}
+function setupAirPlaySetup({ state, context }) {
+	const derivedStateSignal = computed(() => deriveState(context.mediaElement.get(), state.disableRemotePlayback.get()));
+	return createMachineReactor({
+		initial: "preconditions-unmet",
+		monitor: () => derivedStateSignal.get(),
+		states: {
+			"preconditions-unmet": {},
+			"airplay-capable": { entry: () => {
+				const mediaElement = context.mediaElement.get();
+				const isSessionActive = () => !!mediaElement.webkitCurrentPlaybackTargetIsWireless;
+				let settleTimer;
+				let sessionPresentationUrl;
+				let pendingRestore;
+				/** Presentation an already-written `state.startPosition` belongs to. */
+				let restoreOwnerUrl;
+				let resumeWhenRestored = false;
+				const sync = () => {
+					if (isSessionActive()) {
+						clearTimeout(settleTimer);
+						settleTimer = void 0;
+						if (!peek(state.loadingSuspended)) sessionPresentationUrl = peek(state.presentation)?.url;
+						state.loadingSuspended.set(true);
+					} else if (peek(state.loadingSuspended)) settleTimer ??= setTimeout(() => {
+						settleTimer = void 0;
+						const stillActive = isSessionActive();
+						if (!stillActive) {
+							const ownerUrl = sessionPresentationUrl;
+							sessionPresentationUrl = void 0;
+							if (peek(state.presentation)?.url === ownerUrl) pendingRestore = {
+								position: mediaElement.currentTime,
+								wasPlaying: !mediaElement.paused,
+								presentationUrl: ownerUrl
+							};
+						}
+						state.loadingSuspended.set(stillActive);
+					}, REMOTE_INACTIVE_SETTLE_MS);
+					else state.loadingSuspended.set(false);
+				};
+				const listenerCleanup = new AbortController();
+				listen(mediaElement, "webkitcurrentplaybacktargetiswirelesschanged", sync, { signal: listenerCleanup.signal });
+				listen(mediaElement, "emptied", () => {
+					if (!pendingRestore) return;
+					const { position, wasPlaying, presentationUrl } = pendingRestore;
+					pendingRestore = void 0;
+					if (peek(state.presentation)?.url !== presentationUrl) return;
+					state.startPosition.set(position);
+					restoreOwnerUrl = presentationUrl;
+					resumeWhenRestored = wasPlaying;
+				}, { signal: listenerCleanup.signal });
+				const disposeSourceChangeEnd = effect(() => {
+					const url = state.presentation.get()?.url;
+					if (!peek(state.loadingSuspended) || url === sessionPresentationUrl) return;
+					sessionPresentationUrl = void 0;
+					clearTimeout(settleTimer);
+					settleTimer = void 0;
+					state.loadingSuspended.set(false);
+				});
+				const disposeRestoreWatch = effect(() => {
+					const url = state.presentation.get()?.url;
+					const position = state.startPosition.get();
+					if (!restoreOwnerUrl) return;
+					if (url !== restoreOwnerUrl) {
+						restoreOwnerUrl = void 0;
+						resumeWhenRestored = false;
+						if (position !== void 0) state.startPosition.set(void 0);
+						return;
+					}
+					if (position !== void 0) return;
+					restoreOwnerUrl = void 0;
+					if (!resumeWhenRestored) return;
+					resumeWhenRestored = false;
+					mediaElement.play().catch((err) => {
+						console.warn("[setupAirPlay] session-end resume play() rejected — staying paused:", err);
+					});
+				});
+				let sourceEl = null;
+				const disposeSource = effect(() => {
+					const hasMediaSource = !!context.mediaSource.get();
+					const sessionActive = !!state.loadingSuspended.get();
+					const url = state.presentation.get()?.url ?? "";
+					if (!hasMediaSource && !sessionActive) {
+						sourceEl?.remove();
+						sourceEl = null;
+					} else if (hasMediaSource && (!sourceEl || sourceEl.parentNode !== mediaElement)) {
+						sourceEl = document.createElement("source");
+						sourceEl.type = "application/x-mpegURL";
+						mediaElement.append(sourceEl);
+						mediaElement.disableRemotePlayback = false;
+					}
+					if (sourceEl) sourceEl.src = url;
+				});
+				sync();
+				return () => {
+					disposeSource();
+					disposeSourceChangeEnd();
+					disposeRestoreWatch();
+					listenerCleanup.abort();
+					clearTimeout(settleTimer);
+					sourceEl?.remove();
+					sourceEl = null;
+					mediaElement.disableRemotePlayback = true;
+					state.loadingSuspended.set(false);
+					if (restoreOwnerUrl) {
+						restoreOwnerUrl = void 0;
+						resumeWhenRestored = false;
+						if (peek(state.startPosition) !== void 0) state.startPosition.set(void 0);
+					}
+				};
+			} }
+		}
+	});
+}
+const setupAirPlay = defineBehavior({
+	stateKeys: [
+		"presentation",
+		"disableRemotePlayback",
+		"loadingSuspended",
+		"startPosition"
+	],
+	contextKeys: ["mediaElement", "mediaSource"],
+	setup: setupAirPlaySetup
+});
+//#endregion
+export { setupAirPlay };
+
+//# sourceMappingURL=airplay.js.map

package/dist/default/playback/behaviors/dom/airplay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"airplay.js","names":[],"sources":["../../../../../src/playback/behaviors/dom/airplay.ts"],"sourcesContent":["/**\n * **Bridge MSE playback to AirPlay on WebKit.**\n * MSE streams can't be handed to an AirPlay receiver directly.\n * The WebKit-recommended workaround is to append a fallback\n * `<source type=\"application/x-mpegURL\">` carrying the original manifest URL:\n * Safari exposes the AirPlay picker and, when a wireless target is selected,\n * plays that native-HLS source on the receiver. The session state (WebKit's\n * wireless flag, falling edge debounced — see `REMOTE_INACTIVE_SETTLE_MS`) is\n * written straight to its policy consequences, declared here so the\n * cause→policy mapping stays with the feature:\n *\n * - `state.loadingSuspended` — held while the session is live. Observed by\n *   the `loadXSegments` dispatchers (no fetching alongside the receiver) and\n *   by `setupMediaSource` (its post-close rebuild waits — attaching runs\n *   `element.load()` under the live receiver, which destroys a session still\n *   being established). The suspension this behavior holds doubles as its own\n *   session fact — same writer, same edges.\n * - `state.startPosition` — one-shot command: the position is captured from\n *   the element at the session's settled end (still receiver-mirrored) and\n *   written once the rebuild's `load()` resets the element (its `'emptied'`),\n *   so `applyStartPosition` applies it to the rebuilt source — never to the\n *   pre-rebuild element — and starts it where the receiver left off. The\n *   playing state rides the same snapshot but stays behavior-local: this\n *   behavior itself calls `play()` once the command has been *consumed* — i.e.\n *   after the seek — when the receiver was playing at session end. The whole\n *   restore is bound to the presentation the session owned and retracted if\n *   that changes.\n *\n * A source change during a live session releases the hold rather than deferring\n * until the session ends, so the rebuild runs and WebKit switches the receiver\n * to the newly-built AirPlay alternate. Measured, not contracted — see the\n * effect below.\n * https://webkit.org/blog/15036/how-to-use-media-source-extensions-with-airplay/\n *\n * Single-positive-state reactor (`'preconditions-unmet'` ↔ `'airplay-capable'`):\n * gated on a WebKit-AirPlay-capable media element being in scope. The entry —\n * gated on `context.mediaSource` — appends the fallback `<source>` (kept\n * current from `state.presentation`) and enables the AirPlay picker once the\n * MediaSource is open, removing the source the moment the MediaSource detaches\n * so it never survives an MSE teardown. State-exit cleanup (author opt-out,\n * detach, source reset, behavior destroy) removes the source and restores the\n * element's `disableRemotePlayback` default. No-op on non-WebKit platforms\n * (Chromium, Firefox) — `deriveState` never leaves `'preconditions-unmet'`.\n *\n * MMS and AirPlay want *opposite* values of `disableRemotePlayback` on the same\n * element, so it is **sequenced**:\n *\n * - **MMS needs `true` to open.** `setupMediaSource` sets\n *   `disableRemotePlayback = true` when it attaches a ManagedMediaSource —\n *   Safari won't fire `sourceopen` (and MSE playback never starts) otherwise.\n * - **AirPlay needs `false` to offer the picker.** Flipping to `false` *before*\n *   the source opens would prevent `sourceopen`, so the flip is gated on\n *   `context.mediaSource` — which `setupMediaSource` publishes exactly once the\n *   MS is open. Re-fires per source (the slot clears + republishes on reset).\n * - **Author opt-out wins.** `state.disableRemotePlayback` is the author's\n *   intent, written only by the media adapter's IDL property; MMS/programmatic\n *   code touch the element's own `disableRemotePlayback` instead. A `true`\n *   there is unambiguously the author's choice to disable remote playback, so\n *   it holds the machine in `'preconditions-unmet'` and nothing is set up.\n */\n\nimport { isWebKitAirPlayCapable, listen, type WebKitVideoElement } from '@videojs/utils/dom';\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 { effect } from '../../../core/signals/effect';\nimport { computed, peek, type ReadonlySignal, type Signal } from '../../../core/signals/primitives';\nimport type { MaybeResolvedPresentation } from '../../../media/types';\nimport type { StartPositionState } from './apply-start-position';\nimport type { SegmentLoadingState } from './load-segments';\n\n/**\n * How long WebKit's wireless flag must read *inactive* before the\n * session-driven `loadingSuspended` clears.\n *\n * Measured on Safari 26.4 (macOS): when an AirPlay session engages, Safari\n * closes the ManagedMediaSource and — while its pipeline switches to the\n * native-HLS fallback source — transiently reports\n * `webkitCurrentPlaybackTargetIsWireless === false`, firing the changed\n * event. Trusting an instantaneous inactive reading would release\n * `setupMediaSource`'s rebuild hold mid-handoff; its recovery `load()` then\n * destroys the very session being established. Rising edges apply\n * immediately; only the falling edge waits out this settle window.\n */\nconst REMOTE_INACTIVE_SETTLE_MS = 1000;\n\ntype AirPlayFsmState = 'preconditions-unmet' | 'airplay-capable';\n\nfunction deriveState(\n  mediaElement: HTMLMediaElement | undefined,\n  authorDisabledRemotePlayback: boolean | undefined\n): AirPlayFsmState {\n  if (!mediaElement || !isWebKitAirPlayCapable(mediaElement)) return 'preconditions-unmet';\n  if (authorDisabledRemotePlayback) return 'preconditions-unmet';\n  return 'airplay-capable';\n}\n\nfunction setupAirPlaySetup({\n  state,\n  context,\n}: {\n  state: {\n    presentation: ReadonlySignal<MaybeResolvedPresentation | undefined>;\n    disableRemotePlayback: ReadonlySignal<boolean | undefined>;\n    loadingSuspended: Signal<SegmentLoadingState['loadingSuspended']>;\n    startPosition: Signal<StartPositionState['startPosition']>;\n  };\n  context: {\n    mediaElement: ReadonlySignal<HTMLMediaElement | undefined>;\n    mediaSource: ReadonlySignal<MediaSource | undefined>;\n  };\n}): Reactor<AirPlayFsmState | 'destroying' | 'destroyed'> {\n  const derivedStateSignal = computed(() => deriveState(context.mediaElement.get(), state.disableRemotePlayback.get()));\n\n  return createMachineReactor<AirPlayFsmState>({\n    initial: 'preconditions-unmet',\n    monitor: () => derivedStateSignal.get(),\n    states: {\n      'preconditions-unmet': {},\n\n      'airplay-capable': {\n        entry: () => {\n          const mediaElement = context.mediaElement.get() as WebKitVideoElement;\n\n          // WebKit's wireless flag is the only session signal. The standard\n          // Remote Playback API's `remote.state` is deliberately not consulted:\n          // it doesn't track AirPlay sessions reliably on WebKit (same reason\n          // `remotePlaybackFeature` in @videojs/core skips it), and a stale\n          // `'connected'` would pin `loadingSuspended` on — stranding the\n          // rebuild in a way the settle window below can't recover from.\n          const isSessionActive = () => !!mediaElement.webkitCurrentPlaybackTargetIsWireless;\n\n          let settleTimer: ReturnType<typeof setTimeout> | undefined;\n          // Session-end restore. The position/playing snapshot is taken at the\n          // settled falling edge (the element still mirrors the receiver) but\n          // acted on only at the element's next `'emptied'` — once the\n          // rebuild's `load()` has reset the element. Writing it earlier would\n          // hand `applyStartPosition` a command against the pre-rebuild element\n          // (readyState still >= HAVE_METADATA), which it would apply and\n          // consume before the rebuilt source exists.\n          //\n          // The restore is bound to the presentation the session owned, and\n          // that identity is re-checked at *every* async hop — settle timer,\n          // `'emptied'`, and the outstanding-command effect below. Checking at\n          // only one hop leaves the others open: a source change inside the\n          // settle window, or between `'emptied'` and the element becoming\n          // seekable, would otherwise strand the old session's position (and an\n          // unrequested `play()`) on the new source.\n          let sessionPresentationUrl: string | undefined;\n          let pendingRestore:\n            | { position: number; wasPlaying: boolean; presentationUrl: string | undefined }\n            | undefined;\n          /** Presentation an already-written `state.startPosition` belongs to. */\n          let restoreOwnerUrl: string | undefined;\n          let resumeWhenRestored = false;\n\n          const sync = () => {\n            if (isSessionActive()) {\n              clearTimeout(settleTimer);\n              settleTimer = undefined;\n              // Rising edge — the presentation the receiver is taking over.\n              if (!peek(state.loadingSuspended)) sessionPresentationUrl = peek(state.presentation)?.url;\n              state.loadingSuspended.set(true);\n            } else if (peek(state.loadingSuspended)) {\n              // Falling edge: don't trust an instantaneous inactive reading —\n              // re-check once the flag has settled.\n              settleTimer ??= setTimeout(() => {\n                settleTimer = undefined;\n                const stillActive = isSessionActive();\n                if (!stillActive) {\n                  const ownerUrl = sessionPresentationUrl;\n                  sessionPresentationUrl = undefined;\n                  // Snapshot only while the session's own presentation is still\n                  // current. `currentTime` here belongs to that presentation —\n                  // during a session `setupMediaSource` has already torn down,\n                  // so a source change inside this window resets neither the\n                  // element nor its position, and pairing that position with the\n                  // incoming URL would smuggle it onto the new source.\n                  if (peek(state.presentation)?.url === ownerUrl) {\n                    pendingRestore = {\n                      position: mediaElement.currentTime,\n                      wasPlaying: !mediaElement.paused,\n                      presentationUrl: ownerUrl,\n                    };\n                  }\n                }\n                state.loadingSuspended.set(stillActive);\n              }, REMOTE_INACTIVE_SETTLE_MS);\n            } else {\n              state.loadingSuspended.set(false);\n            }\n          };\n          const listenerCleanup = new AbortController();\n          listen(mediaElement, 'webkitcurrentplaybacktargetiswirelesschanged', sync, {\n            signal: listenerCleanup.signal,\n          });\n          listen(\n            mediaElement,\n            'emptied',\n            () => {\n              if (!pendingRestore) return;\n              const { position, wasPlaying, presentationUrl } = pendingRestore;\n              pendingRestore = undefined;\n              if (peek(state.presentation)?.url !== presentationUrl) return;\n              state.startPosition.set(position);\n              restoreOwnerUrl = presentationUrl;\n              resumeWhenRestored = wasPlaying;\n            },\n            { signal: listenerCleanup.signal }\n          );\n\n          // A source change during a live session releases the hold, letting the\n          // rebuild run instead of waiting for the session to end.\n          //\n          // Doing nothing is not a neutral choice — it silently defers the\n          // change. `<source>` children are only consulted while resource\n          // selection runs, so the effect below rewriting the fallback's `src`\n          // does nothing to what the receiver is already playing, and the\n          // rebuild is held by `loadingSuspended`, so the receiver stays on the\n          // outgoing stream until the user disengages.\n          //\n          // Releasing the hold lets the rebuild proceed, and the receiver ends\n          // up on the new stream — measured on Safari 26.4. Note where the\n          // handover actually happens, because it is not the rebuild's `load()`:\n          // clearing the hold also makes the source effect below see an inactive\n          // session with no `context.mediaSource`, so it drops the fallback, and\n          // the rebuild's resource selection runs with the MSE source alone. The\n          // switch comes afterwards, when that effect re-creates the fallback\n          // against the new presentation once the MediaSource opens and WebKit\n          // moves the live session onto the newly-appeared alternate.\n          //\n          // That leaves a window where an active session has no compatible\n          // alternate on the element, and it survives it. Holding the fallback\n          // across the rebuild instead would close the window and make the\n          // handover selection-driven, but it swaps a measured path for an\n          // argued one — don't without a device pass.\n          //\n          // Measured, not contracted: this is under-specified territory, so\n          // nothing here depends on the handover succeeding. If a UA drops the\n          // session instead, the falling edge runs its ordinary course; the\n          // restore is suppressed either way because the snapshot is bound to\n          // the presentation the session owned.\n          //\n          // Note this is *not* an attempt to end the session. Setting\n          // `disableRemotePlayback = true` was tried: the Remote Playback API\n          // requires it to disconnect (spec §5.3.2) but WebKit does not honor\n          // that for AirPlay — the session survived, measured on Safari 26.4.\n          // Deliberately not written here, so that behavior can't silently flip\n          // to \"receiver drops\" if WebKit ever implements the disconnect.\n          const disposeSourceChangeEnd = effect(() => {\n            const url = state.presentation.get()?.url;\n            // `loadingSuspended` is this behavior's own session fact; peeked so\n            // clearing it below doesn't re-trigger.\n            if (!peek(state.loadingSuspended) || url === sessionPresentationUrl) return;\n            sessionPresentationUrl = undefined;\n            clearTimeout(settleTimer);\n            settleTimer = undefined;\n            state.loadingSuspended.set(false);\n          });\n\n          // Watches an outstanding restore command to its end. Two outcomes:\n          //\n          // - **Consumed** (`startPosition` back to `undefined`): the element is\n          //   at the restored position, so resuming is safe. Keying the resume\n          //   off consumption rather than off `'loadedmetadata'` orders it after\n          //   `applyStartPosition`'s seek — arming a listener for the same event\n          //   would put `play()` ahead of the seek, since this behavior registers\n          //   synchronously while `applyStartPosition` only reaches its state a\n          //   microtask later. The rebuild's load algorithm forced `paused =\n          //   true`; a rejection here (autoplay policy) degrades to\n          //   paused-at-position. Requires a `startPosition` consumer in the\n          //   composition (`applyStartPosition`) — without one the position is\n          //   never restored either, so resuming would be wrong anyway.\n          // - **Superseded** (presentation changed): retract the command and\n          //   disarm, so neither the seek nor the resume reaches the new source.\n          const disposeRestoreWatch = effect(() => {\n            const url = state.presentation.get()?.url;\n            const position = state.startPosition.get();\n            if (!restoreOwnerUrl) return;\n\n            if (url !== restoreOwnerUrl) {\n              restoreOwnerUrl = undefined;\n              resumeWhenRestored = false;\n              if (position !== undefined) state.startPosition.set(undefined);\n              return;\n            }\n\n            if (position !== undefined) return;\n            restoreOwnerUrl = undefined;\n            if (!resumeWhenRestored) return;\n            resumeWhenRestored = false;\n            mediaElement.play().catch((err) => {\n              console.warn('[setupAirPlay] session-end resume play() rejected — staying paused:', err);\n            });\n          });\n\n          // This effect combines:\n          // - adding a native HLS fallback source when the mediaSource is\n          //   attached / removing it when it's detached — UNLESS a session is\n          //   live: during an AirPlay session the engine detaches its dead\n          //   MediaSource (see setupMediaSource's sourceclose recovery) while\n          //   the receiver is playing exactly this fallback source, so it\n          //   must survive until the session's falling edge (the rebuild's\n          //   republish then adopts it again).\n          // - keeping this sourceEl's src in sync with the current presentation.\n          // The created source is also cleaned on state exit.\n          // The dependence on context.mediaSource means the source is appended\n          // only after the MMS has been attached and opened (therefore we can\n          // flip disableRemotePlayback). Being in this state also implies\n          // that the author has not disabled remote playback.\n          let sourceEl: HTMLSourceElement | null = null;\n          const disposeSource = effect(() => {\n            const hasMediaSource = !!context.mediaSource.get();\n            const sessionActive = !!state.loadingSuspended.get();\n            const url = state.presentation.get()?.url ?? '';\n\n            if (!hasMediaSource && !sessionActive) {\n              sourceEl?.remove();\n              sourceEl = null;\n            } else if (hasMediaSource && (!sourceEl || sourceEl.parentNode !== mediaElement)) {\n              sourceEl = document.createElement('source');\n              sourceEl.type = 'application/x-mpegURL';\n              mediaElement.append(sourceEl);\n              mediaElement.disableRemotePlayback = false;\n            }\n            if (sourceEl) sourceEl.src = url;\n          });\n\n          // AirPlay may already be active at (re)attach.\n          sync();\n\n          return () => {\n            disposeSource();\n            disposeSourceChangeEnd();\n            disposeRestoreWatch();\n            listenerCleanup.abort();\n            clearTimeout(settleTimer);\n            sourceEl?.remove();\n            sourceEl = null;\n            // Undo the picker enable: hand the element back to its MMS-default\n            // `disableRemotePlayback = true`.\n            mediaElement.disableRemotePlayback = true;\n            // Don't strand the engine held/suspended if we tear down\n            // mid-session (author opt-out, detach, destroy).\n            state.loadingSuspended.set(false);\n            // Nor leave a restore command behind for the next source to apply.\n            if (restoreOwnerUrl) {\n              restoreOwnerUrl = undefined;\n              resumeWhenRestored = false;\n              if (peek(state.startPosition) !== undefined) state.startPosition.set(undefined);\n            }\n          };\n        },\n      },\n    },\n  });\n}\n\nexport const setupAirPlay = defineBehavior({\n  stateKeys: ['presentation', 'disableRemotePlayback', 'loadingSuspended', 'startPosition'],\n  contextKeys: ['mediaElement', 'mediaSource'],\n  setup: setupAirPlaySetup,\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoFA,MAAM,4BAA4B;AAIlC,SAAS,YACP,cACA,8BACiB;CACjB,IAAI,CAAC,gBAAgB,CAAC,uBAAuB,YAAY,GAAG,OAAO;CACnE,IAAI,8BAA8B,OAAO;CACzC,OAAO;AACT;AAEA,SAAS,kBAAkB,EACzB,OACA,WAYwD;CACxD,MAAM,qBAAqB,eAAe,YAAY,QAAQ,aAAa,IAAI,GAAG,MAAM,sBAAsB,IAAI,CAAC,CAAC;CAEpH,OAAO,qBAAsC;EAC3C,SAAS;EACT,eAAe,mBAAmB,IAAI;EACtC,QAAQ;GACN,uBAAuB,CAAC;GAExB,mBAAmB,EACjB,aAAa;IACX,MAAM,eAAe,QAAQ,aAAa,IAAI;IAQ9C,MAAM,wBAAwB,CAAC,CAAC,aAAa;IAE7C,IAAI;IAgBJ,IAAI;IACJ,IAAI;;IAIJ,IAAI;IACJ,IAAI,qBAAqB;IAEzB,MAAM,aAAa;KACjB,IAAI,gBAAgB,GAAG;MACrB,aAAa,WAAW;MACxB,cAAc,KAAA;MAEd,IAAI,CAAC,KAAK,MAAM,gBAAgB,GAAG,yBAAyB,KAAK,MAAM,YAAY,CAAC,EAAE;MACtF,MAAM,iBAAiB,IAAI,IAAI;KACjC,OAAO,IAAI,KAAK,MAAM,gBAAgB,GAGpC,gBAAgB,iBAAiB;MAC/B,cAAc,KAAA;MACd,MAAM,cAAc,gBAAgB;MACpC,IAAI,CAAC,aAAa;OAChB,MAAM,WAAW;OACjB,yBAAyB,KAAA;OAOzB,IAAI,KAAK,MAAM,YAAY,CAAC,EAAE,QAAQ,UACpC,iBAAiB;QACf,UAAU,aAAa;QACvB,YAAY,CAAC,aAAa;QAC1B,iBAAiB;OACnB;MAEJ;MACA,MAAM,iBAAiB,IAAI,WAAW;KACxC,GAAG,yBAAyB;UAE5B,MAAM,iBAAiB,IAAI,KAAK;IAEpC;IACA,MAAM,kBAAkB,IAAI,gBAAgB;IAC5C,OAAO,cAAc,gDAAgD,MAAM,EACzE,QAAQ,gBAAgB,OAC1B,CAAC;IACD,OACE,cACA,iBACM;KACJ,IAAI,CAAC,gBAAgB;KACrB,MAAM,EAAE,UAAU,YAAY,oBAAoB;KAClD,iBAAiB,KAAA;KACjB,IAAI,KAAK,MAAM,YAAY,CAAC,EAAE,QAAQ,iBAAiB;KACvD,MAAM,cAAc,IAAI,QAAQ;KAChC,kBAAkB;KAClB,qBAAqB;IACvB,GACA,EAAE,QAAQ,gBAAgB,OAAO,CACnC;IAwCA,MAAM,yBAAyB,aAAa;KAC1C,MAAM,MAAM,MAAM,aAAa,IAAI,CAAC,EAAE;KAGtC,IAAI,CAAC,KAAK,MAAM,gBAAgB,KAAK,QAAQ,wBAAwB;KACrE,yBAAyB,KAAA;KACzB,aAAa,WAAW;KACxB,cAAc,KAAA;KACd,MAAM,iBAAiB,IAAI,KAAK;IAClC,CAAC;IAiBD,MAAM,sBAAsB,aAAa;KACvC,MAAM,MAAM,MAAM,aAAa,IAAI,CAAC,EAAE;KACtC,MAAM,WAAW,MAAM,cAAc,IAAI;KACzC,IAAI,CAAC,iBAAiB;KAEtB,IAAI,QAAQ,iBAAiB;MAC3B,kBAAkB,KAAA;MAClB,qBAAqB;MACrB,IAAI,aAAa,KAAA,GAAW,MAAM,cAAc,IAAI,KAAA,CAAS;MAC7D;KACF;KAEA,IAAI,aAAa,KAAA,GAAW;KAC5B,kBAAkB,KAAA;KAClB,IAAI,CAAC,oBAAoB;KACzB,qBAAqB;KACrB,aAAa,KAAK,CAAC,CAAC,OAAO,QAAQ;MACjC,QAAQ,KAAK,uEAAuE,GAAG;KACzF,CAAC;IACH,CAAC;IAgBD,IAAI,WAAqC;IACzC,MAAM,gBAAgB,aAAa;KACjC,MAAM,iBAAiB,CAAC,CAAC,QAAQ,YAAY,IAAI;KACjD,MAAM,gBAAgB,CAAC,CAAC,MAAM,iBAAiB,IAAI;KACnD,MAAM,MAAM,MAAM,aAAa,IAAI,CAAC,EAAE,OAAO;KAE7C,IAAI,CAAC,kBAAkB,CAAC,eAAe;MACrC,UAAU,OAAO;MACjB,WAAW;KACb,OAAO,IAAI,mBAAmB,CAAC,YAAY,SAAS,eAAe,eAAe;MAChF,WAAW,SAAS,cAAc,QAAQ;MAC1C,SAAS,OAAO;MAChB,aAAa,OAAO,QAAQ;MAC5B,aAAa,wBAAwB;KACvC;KACA,IAAI,UAAU,SAAS,MAAM;IAC/B,CAAC;IAGD,KAAK;IAEL,aAAa;KACX,cAAc;KACd,uBAAuB;KACvB,oBAAoB;KACpB,gBAAgB,MAAM;KACtB,aAAa,WAAW;KACxB,UAAU,OAAO;KACjB,WAAW;KAGX,aAAa,wBAAwB;KAGrC,MAAM,iBAAiB,IAAI,KAAK;KAEhC,IAAI,iBAAiB;MACnB,kBAAkB,KAAA;MAClB,qBAAqB;MACrB,IAAI,KAAK,MAAM,aAAa,MAAM,KAAA,GAAW,MAAM,cAAc,IAAI,KAAA,CAAS;KAChF;IACF;GACF,EACF;EACF;CACF,CAAC;AACH;AAEA,MAAa,eAAe,eAAe;CACzC,WAAW;EAAC;EAAgB;EAAyB;EAAoB;CAAe;CACxF,aAAa,CAAC,gBAAgB,aAAa;CAC3C,OAAO;AACT,CAAC"}