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

package/dist/dev/playback/engines/hls/engine-audio-only.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine-audio-only.js","names":[],"sources":["../../../../../src/playback/engines/hls/engine-audio-only.ts"],"sourcesContent":["import {\n  type Composition,\n  type ContextSignals,\n  createComposition,\n  type StateSignals,\n} from '../../../core/composition/create-composition';\nimport { makeShareSignals, type ShareSignalsConfig } from '../../../core/composition/share-signals';\nimport type { BackBufferConfig } from '../../../media/buffer/back-buffer';\nimport type { ForwardBufferConfig } from '../../../media/buffer/forward-buffer';\nimport { canPlayTrack } from '../../../media/dom/capabilities';\nimport { attachMediaSourceAsSourceElement } from '../../../media/dom/mse/mediasource-setup';\nimport type { SvtaError } from '../../../media/errors';\nimport { parseMultivariantPlaylist } from '../../../media/hls/parse-multivariant';\nimport type { AudioTrack, CanPlayTrack, MaybeResolvedPresentation, MediaContainerData } from '../../../media/types';\nimport type { GetCdnId } from '../../../media/utils/cdn';\nimport { getResolvedSelectedTrackDuration } from '../../../media/utils/track-selection';\nimport type { SegmentLoaderActor } from '../../actors/dom/segment-loader';\nimport type { SourceBufferActor } from '../../actors/dom/source-buffer';\nimport {\n  calculatePresentationDuration,\n  type PresentationDurationResolver,\n} from '../../behaviors/calculate-presentation-duration';\nimport { collectErrors } from '../../behaviors/collect-errors';\nimport { deriveCdnPriority } from '../../behaviors/derive-cdn-priority';\nimport { setupAirPlay } from '../../behaviors/dom/airplay';\nimport { applyStartPosition } from '../../behaviors/dom/apply-start-position';\nimport { endOfStream } from '../../behaviors/dom/end-of-stream';\nimport { loadAudioSegments } from '../../behaviors/dom/load-segments';\nimport { recoverEndStall } from '../../behaviors/dom/recover-end-stall';\nimport { setupAudioBufferActors } from '../../behaviors/dom/setup-buffer-actors';\nimport { setupMediaSource } from '../../behaviors/dom/setup-mediasource';\nimport { trackCurrentTime } from '../../behaviors/dom/track-current-time';\nimport { trackLoadTriggers } from '../../behaviors/dom/track-load-triggers';\nimport { updateMediaSourceDuration } from '../../behaviors/dom/update-mediasource-duration';\n// Non-zero-PTS relocation (spike): remove this import, the composed reactor, the\n// `audioMessagePipelines` finalConfig entry, the `mediaContainerData` state slot,\n// and the `deriveStartMediaTime` config field to drop relocation from audio-only.\nimport {\n  type DeriveStartMediaTime,\n  deriveSharedMinStartMediaTime,\n  establishStartMediaTime,\n} from '../../behaviors/establish-start-media-time';\nimport { type ParsePresentation, resolvePresentation } from '../../behaviors/resolve-presentation';\nimport { resolveAudioTrack } from '../../behaviors/resolve-track';\nimport { type FailoverMonitorConfig, setupFailoverMonitor } from '../../behaviors/setup-failover-monitor';\nimport { syncPreload } from '../../behaviors/sync-preload';\nimport { switchAudioTrack } from '../../behaviors/track-switching';\nimport { relocationPipelinesFor } from '../../primitives/relocation-pipelines';\nimport {\n  type ReportUnsupportedTrackConditions,\n  reportUnsupportedTrackConditions,\n} from '../../primitives/report-track-conditions';\n\n// ============================================================================\n// Audio-Only HLS Engine State & Context\n// ============================================================================\n\n/**\n * State shape for the audio-only HLS playback engine.\n *\n * Subset of `HlsVideoEngineState` covering only the slots written and read\n * by audio-side behaviors. Video and text-track slots are absent —\n * subtractive composition removes the behaviors that declare them.\n */\nexport interface HlsAudioEngineState {\n  presentation?: MaybeResolvedPresentation;\n  preload?: 'auto' | 'metadata' | 'none';\n  selectedAudioTrackId?: string;\n  // Non-zero-PTS relocation (spike): transient per-track container data owned by\n  // `establishStartMediaTime`. Remove with the composed reactor.\n  mediaContainerData?: Record<string, MediaContainerData>;\n  /**\n   * Consumer-driven constraint narrowing the audio candidate set. Sibling\n   * of `userVideoTrackSelection` in the default engine. Partial-track\n   * shape — `{ language: 'es' }`, `{ id: 'audio-en' }`, etc.\n   * `selectAudioTrack` reads this and re-picks when it changes.\n   * Multi-language-audio Tier 2 programmatic-write path.\n   */\n  userAudioTrackSelection?: Partial<AudioTrack>;\n  /**\n   * The CDNs the source is served from, in manifest priority order (mirrors\n   * HLS content steering's `PATHWAY-PRIORITY`). Owned by `deriveCdnPriority`,\n   * read by `track-switching`'s `preferActiveCdn` scope. Only meaningful for\n   * redundant-stream sources; a single-CDN source has one entry.\n   */\n  cdnPriority?: string[];\n  /**\n   * CDN ids currently in failover cooldown — read by `track-switching`'s\n   * `excludeFailedCdns` constraint, which prunes their tracks so the active-CDN\n   * scope falls to the next CDN. Empty / absent means all CDNs are eligible.\n   */\n  failedCdns?: string[];\n  /**\n   * Conditions reported during playback, in order — appended by whichever\n   * behavior detects one, owned and cleared per source by `collectErrors`.\n   * Severity is decided above the engine. Audio-only makes an all-audio-pruned\n   * source unrecoverable: there's no video fallback to fall back to.\n   */\n  errors?: SvtaError[];\n  currentTime?: number;\n  loadActivated?: boolean;\n  /**\n   * One-shot command: start the current source at this position\n   * (presentation-timeline seconds). Written by consumers or by\n   * `setupAirPlay`'s session-end snapshot; consumed (cleared) by\n   * `applyStartPosition` once the element seeks. See\n   * `behaviors/dom/apply-start-position.ts`.\n   */\n  startPosition?: number;\n  /**\n   * Intent-level loading policy: initiate no new loading work while `true`.\n   * Written by `setupAirPlay` (the only behavior declaring the key) while a\n   * remote-playback session owns presentation; observed by `loadAudioSegments`\n   * (parks in `'dormant'`) and by `setupMediaSource` (a pending rebuild\n   * waits). See `SegmentLoadingState['loadingSuspended']`.\n   */\n  loadingSuspended?: boolean;\n  /**\n   * Author intent for the AirPlay/remote-playback picker, written by the media\n   * adapter's `disableRemotePlayback` IDL property. `true` is an explicit\n   * opt-out: `setupAirPlay` reads it at attach and sets nothing up, leaving the\n   * element's remote playback disabled. Distinct from the underlying media\n   * element's own `disableRemotePlayback`, which stays programmatically managed\n   * (ManagedMediaSource / AirPlay).\n   */\n  disableRemotePlayback?: boolean;\n}\n\n/**\n * Context shape for the audio-only HLS playback engine.\n *\n * Subset of `HlsVideoEngineContext` covering only the platform objects and\n * actor refs managed by audio-side behaviors.\n */\nexport interface HlsAudioEngineContext {\n  mediaElement?: HTMLMediaElement | undefined;\n  mediaSource?: MediaSource;\n  audioBufferActor?: SourceBufferActor;\n  audioSegmentLoaderActor?: SegmentLoaderActor;\n}\n\nexport type HlsAudioEngineSignals = {\n  state: StateSignals<HlsAudioEngineState>;\n  context: ContextSignals<HlsAudioEngineContext>;\n};\n\n/**\n * Configuration for the audio-only HLS playback engine.\n *\n * Subset of `HlsVideoEngineConfig` — video-quality, bandwidth-estimator,\n * and text-track config fields are omitted (no behavior consumes them).\n */\nexport interface HlsAudioEngineConfig extends ShareSignalsConfig<HlsAudioEngineState, HlsAudioEngineContext> {\n  preferredAudioLanguage?: string;\n  /**\n   * Codec capability probe read by `track-switching`'s `excludeUnplayableTracks`\n   * constraint. Defaults to the `MediaSource.isTypeSupported`-backed\n   * `canPlayTrack`; override to force-exclude a codec. Mirrors the default\n   * engine — without it, capability probing (and TS / raw-AAC detection) would\n   * be inert for audio-only playback.\n   */\n  canPlayTrack?: CanPlayTrack;\n  /**\n   * Conditions reported about each rendition as it resolves — the *causes* behind\n   * a later verdict, and the copy a verdict reuses when they agree. Defaults to\n   * {@link reportUnsupportedTrackConditions}, which reports non-fMP4 containers\n   * and encryption; supply your own to report a different set (a provider that\n   * never ships MPEG-TS can drop that check) or `() => []` to report nothing.\n   */\n  reportUnsupportedTrackConditions?: ReportUnsupportedTrackConditions;\n  resolveDuration?: PresentationDurationResolver;\n  parsePresentation?: ParsePresentation;\n  forwardBuffer?: Partial<ForwardBufferConfig>;\n  backBuffer?: Partial<BackBufferConfig>;\n  /** Multi-CDN failover monitor tuning. Defaults: `DEFAULT_FAILOVER_MONITOR_CONFIG`. */\n  failover?: Partial<FailoverMonitorConfig>;\n  /**\n   * Derive a CDN grouping key from a track URL (used by `cdnPriority`, the\n   * failover trip, and the track-switching CDN rules — one function read by all).\n   * Defaults to the URL origin; override to key on e.g. Mux's `cdn=` param.\n   */\n  getCdnId?: GetCdnId;\n  /** Non-zero-PTS relocation (spike): the reduce seam (tier knob); defaults to per-track own. */\n  deriveStartMediaTime?: DeriveStartMediaTime;\n}\n\n// ============================================================================\n// Audio-Only HLS Playback Engine\n// ============================================================================\n\n// Materializes input slots no composed behavior produces — `userAudioTrackSelection`\n// (switchAudioTrack only reads it) and `disableRemotePlayback` (setupAirPlay only\n// reads it) — in addition to forwarding refs. `failedCdns` is owned by\n// `setupFailoverMonitor`, so it's already materialized and reachable on the\n// `onSignalsReady` refs without being listed here.\nconst shareSignals = makeShareSignals<HlsAudioEngineState, HlsAudioEngineContext>([\n  'userAudioTrackSelection',\n  'disableRemotePlayback',\n]);\n\n/**\n * Create an audio-only HLS playback engine.\n *\n * Subtractive composition variant of `createHlsVideoEngine`: omits\n * video-side behaviors (`resolveVideoTrack`, `switchVideoTrack`,\n * `setupVideoBufferActors`, `loadVideoSegments`) and text-track behaviors\n * (`switchTextTrack`, `resolveTextTrack`, `syncTextTracks`,\n * `setupTextTrackActors`, `loadTextTrackSegments`). The remaining audio\n * pipeline composes unchanged.\n *\n * Handles both truly audio-only HLS sources (no video stream-inf) and\n * mixed-AV HLS sources where the audio rendition is selected and video /\n * subtitle renditions are ignored at composition time. The variant decision\n * is encoded by adapter choice; this engine does not branch on source\n * shape.\n *\n * @example\n * ```ts\n * let signals: HlsAudioEngineSignals;\n * const engine = createHlsAudioEngine({\n *   preferredAudioLanguage: 'en',\n *   onSignalsReady: (refs) => {\n *     signals = refs;\n *   },\n * });\n *\n * signals.context.mediaElement.set(audioEl);\n * signals.state.presentation.set({ url: 'https://example.com/stream.m3u8' });\n * ```\n */\nexport function createHlsAudioEngine(\n  config: HlsAudioEngineConfig = {}\n): Composition<HlsAudioEngineState, HlsAudioEngineContext> {\n  const deriveStartMediaTime = config.deriveStartMediaTime ?? deriveSharedMinStartMediaTime;\n  const finalConfig = {\n    ...config,\n    deriveStartMediaTime,\n    // Baked (not user-overridable): this engine composes `setupAirPlay`,\n    // whose native fallback `<source>` requires the MSE attachment to keep\n    // sibling source alternatives part of resource selection. The helper's\n    // `video/mp4` source type is inert here — resource selection probes it\n    // with `canPlayType`, which answers `'maybe'` on an audio element too.\n    attachMediaSource: attachMediaSourceAsSourceElement,\n    canPlayTrack: config.canPlayTrack ?? canPlayTrack,\n    reportUnsupportedTrackConditions: config.reportUnsupportedTrackConditions ?? reportUnsupportedTrackConditions,\n    resolveDuration: config.resolveDuration ?? getResolvedSelectedTrackDuration,\n    parsePresentation: config.parsePresentation ?? parseMultivariantPlaylist,\n    // Non-zero-PTS relocation (spike): pair the audio loader with the relocation steps\n    // `establishStartMediaTime` derives from; same `deriveStartMediaTime` seam. Remove\n    // with the reactor.\n    audioMessagePipelines: relocationPipelinesFor('audio', deriveStartMediaTime),\n  };\n\n  return createComposition(\n    [\n      syncPreload,\n      trackLoadTriggers,\n      resolvePresentation,\n\n      // Session-level CDN priority for redundant-stream sources. Owns\n      // `cdnPriority`; switchAudioTrack's preferActiveCdn scope reads it. No-op\n      // for single-CDN sources.\n      //\n      // With a single track type there's no cross-type coherence to enforce and\n      // the first pick is the primary CDN regardless, so composition order is\n      // not load-bearing here today. It earns its place for forward-consistency\n      // with the default engine and for future failover / steering, where the\n      // active CDN changes dynamically (and selection stays reactive either way).\n      deriveCdnPriority,\n\n      // CDN failover cooldown: watches `failedCdns` (tripped directly by audio\n      // track resolution on a failed media-playlist fetch) and removes each CDN\n      // once its cooldown lapses.\n      setupFailoverMonitor,\n\n      // Owns `errors` and its per-source lifecycle; reporters append into it.\n      collectErrors,\n\n      // Audio track selection — slot owner with filter reactivity.\n      // Mid-stream flush on language switch is handled in segment-loader's\n      // planTasks, not here.\n      switchAudioTrack,\n\n      // Resolve selected tracks — audio only.\n      resolveAudioTrack,\n\n      // Presentation duration\n      calculatePresentationDuration,\n\n      // MSE setup. Single audio buffer; no video buffer to coordinate with,\n      // so the Firefox `mozHasAudio` registration ordering is moot here.\n      setupMediaSource,\n      updateMediaSourceDuration,\n\n      // Non-zero-PTS relocation (spike): establishes per-track startMediaTime;\n      // MUST precede setupAudioBufferActors. Remove this line + the import + the\n      // finalConfig/state entries to drop relocation. (Selection is optional in the\n      // reactor, so it works with only audio in scope.)\n      establishStartMediaTime,\n\n      setupAudioBufferActors,\n\n      // AirPlay/MSE bridge (WebKit only; no-op elsewhere). Audio-only sources\n      // AirPlay to audio receivers (HomePod, AirPlay speakers) through the same\n      // native-HLS fallback `<source>`; `webkitCurrentPlaybackTargetIsWireless`\n      // and the picker are HTMLMediaElement-level, so an `<audio>` host is\n      // AirPlay-capable on the same terms as a `<video>` one.\n      setupAirPlay,\n\n      // Playback tracking\n      trackCurrentTime,\n      // After trackCurrentTime: the one-shot currentTime seed must land after\n      // the mirror's attach-time sync (see apply-start-position.ts).\n      applyStartPosition,\n\n      // Segment loading — audio only.\n      loadAudioSegments,\n\n      // End of stream coordination. `endOfStream` iterates buffer actors via\n      // `[videoBufferActor, audioBufferActor].filter(Boolean)` and reads\n      // `mediaSource.sourceBuffers` aggregately — composes unchanged with\n      // only audio in scope.\n      endOfStream,\n      // Force native `ended` if Chrome freezes the playhead short of the buffered end\n      // after `endOfStream`. Inert for a clean-ending single-track source.\n      recoverEndStall,\n\n      // Adapter signal callback.\n      shareSignals,\n    ],\n    {\n      config: finalConfig,\n    }\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmMA,MAAM,eAAe,iBAA6D,CAChF,2BACA,uBACF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCD,SAAgB,qBACd,SAA+B,CAAC,GACyB;CACzD,MAAM,uBAAuB,OAAO,wBAAwB;CAC5D,MAAM,cAAc;EAClB,GAAG;EACH;EAMA,mBAAmB;EACnB,cAAc,OAAO,gBAAgB;EACrC,kCAAkC,OAAO,oCAAoC;EAC7E,iBAAiB,OAAO,mBAAmB;EAC3C,mBAAmB,OAAO,qBAAqB;EAI/C,uBAAuB,uBAAuB,SAAS,oBAAoB;CAC7E;CAEA,OAAO,kBACL;EACE;EACA;EACA;EAWA;EAKA;EAGA;EAKA;EAGA;EAGA;EAIA;EACA;EAMA;EAEA;EAOA;EAGA;EAGA;EAGA;EAMA;EAGA;EAGA;CACF,GACA,EACE,QAAQ,YACV,CACF;AACF"}
+{"version":3,"file":"engine-audio-only.js","names":[],"sources":["../../../../../src/playback/engines/hls/engine-audio-only.ts"],"sourcesContent":["import {\n  type Composition,\n  type ContextSignals,\n  createComposition,\n  type StateSignals,\n} from '../../../core/composition/create-composition';\nimport { makeShareSignals, type ShareSignalsConfig } from '../../../core/composition/share-signals';\nimport type { BackBufferConfig } from '../../../media/buffer/back-buffer';\nimport type { ForwardBufferConfig } from '../../../media/buffer/forward-buffer';\nimport { canPlayTrack } from '../../../media/dom/capabilities';\nimport { attachMediaSourceAsSourceElement } from '../../../media/dom/mse/mediasource-setup';\nimport type { SvtaError } from '../../../media/errors';\nimport { parseMultivariantPlaylist } from '../../../media/hls/parse-multivariant';\nimport type { AudioTrack, CanPlayTrack, MaybeResolvedPresentation, MediaContainerData } from '../../../media/types';\nimport type { GetCdnId } from '../../../media/utils/cdn';\nimport { getResolvedSelectedTrackDuration } from '../../../media/utils/track-selection';\nimport type { SegmentLoaderActor } from '../../actors/dom/segment-loader';\nimport type { SourceBufferActor } from '../../actors/dom/source-buffer';\nimport {\n  calculatePresentationDuration,\n  type PresentationDurationResolver,\n} from '../../behaviors/calculate-presentation-duration';\nimport { collectErrors } from '../../behaviors/collect-errors';\nimport { deriveCdnPriority } from '../../behaviors/derive-cdn-priority';\nimport { setupAirPlay } from '../../behaviors/dom/airplay';\nimport { applyStartPosition } from '../../behaviors/dom/apply-start-position';\nimport { endOfStream } from '../../behaviors/dom/end-of-stream';\nimport { loadAudioSegments } from '../../behaviors/dom/load-segments';\nimport { recoverEndStall } from '../../behaviors/dom/recover-end-stall';\nimport { setupAudioBufferActors } from '../../behaviors/dom/setup-buffer-actors';\nimport { setupMediaSource } from '../../behaviors/dom/setup-mediasource';\nimport { trackCurrentTime } from '../../behaviors/dom/track-current-time';\nimport { trackLoadTriggers } from '../../behaviors/dom/track-load-triggers';\nimport { updateMediaSourceDuration } from '../../behaviors/dom/update-mediasource-duration';\n// Non-zero-PTS relocation (spike): remove this import, the composed reactor, the\n// `audioMessagePipelines` finalConfig entry, the `mediaContainerData` state slot,\n// and the `deriveStartMediaTime` config field to drop relocation from audio-only.\nimport {\n  type DeriveStartMediaTime,\n  deriveSharedMinStartMediaTime,\n  establishStartMediaTime,\n} from '../../behaviors/establish-start-media-time';\nimport { type ParsePresentation, resolvePresentation } from '../../behaviors/resolve-presentation';\nimport { resolveAudioTrack } from '../../behaviors/resolve-track';\nimport { type FailoverMonitorConfig, setupFailoverMonitor } from '../../behaviors/setup-failover-monitor';\nimport { syncPreload } from '../../behaviors/sync-preload';\nimport { switchAudioTrack } from '../../behaviors/track-switching';\nimport { relocationPipelinesFor } from '../../primitives/relocation-pipelines';\nimport {\n  type ReportUnsupportedTrackConditions,\n  reportUnsupportedTrackConditions,\n} from '../../primitives/report-track-conditions';\n\n// ============================================================================\n// Audio-Only HLS Engine State & Context\n// ============================================================================\n\n/**\n * State shape for the audio-only HLS playback engine.\n *\n * Subset of `HlsVideoEngineState` covering only the slots written and read by audio-side behaviors. Video and\n * text-track slots are absent — subtractive composition removes the behaviors that declare them.\n */\nexport interface HlsAudioEngineState {\n  presentation?: MaybeResolvedPresentation;\n  preload?: 'auto' | 'metadata' | 'none';\n  selectedAudioTrackId?: string;\n  // Non-zero-PTS relocation (spike): transient per-track container data owned by\n  // `establishStartMediaTime`. Remove with the composed reactor.\n  mediaContainerData?: Record<string, MediaContainerData>;\n  /**\n   * Consumer-driven constraint narrowing the audio candidate set. Sibling of `userVideoTrackSelection` in the default\n   * engine. Partial-track shape — `{ language: 'es' }`, `{ id: 'audio-en' }`, etc. `selectAudioTrack` reads this and\n   * re-picks when it changes. Multi-language-audio Tier 2 programmatic-write path.\n   */\n  userAudioTrackSelection?: Partial<AudioTrack>;\n  /**\n   * The CDNs the source is served from, in manifest priority order (mirrors HLS content steering's `PATHWAY-PRIORITY`).\n   * Owned by `deriveCdnPriority`, read by `track-switching`'s `preferActiveCdn` scope. Only meaningful for\n   * redundant-stream sources; a single-CDN source has one entry.\n   */\n  cdnPriority?: string[];\n  /**\n   * CDN ids currently in failover cooldown — read by `track-switching`'s `excludeFailedCdns` constraint, which prunes\n   * their tracks so the active-CDN scope falls to the next CDN. Empty / absent means all CDNs are eligible.\n   */\n  failedCdns?: string[];\n  /**\n   * Conditions reported during playback, in order — appended by whichever behavior detects one, owned and cleared per\n   * source by `collectErrors`. Severity is decided above the engine. Audio-only makes an all-audio-pruned source\n   * unrecoverable: there's no video fallback to fall back to.\n   */\n  errors?: SvtaError[];\n  currentTime?: number;\n  loadActivated?: boolean;\n  /**\n   * One-shot command: start the current source at this position (presentation-timeline seconds). Written by consumers\n   * or by `setupAirPlay`'s session-end snapshot; consumed (cleared) by `applyStartPosition` once the element seeks. See\n   * `behaviors/dom/apply-start-position.ts`.\n   */\n  startPosition?: number;\n  /**\n   * Intent-level loading policy: initiate no new loading work while `true`. Written by `setupAirPlay` (the only\n   * behavior declaring the key) while a remote-playback session owns presentation; observed by `loadAudioSegments`\n   * (parks in `'dormant'`) and by `setupMediaSource` (a pending rebuild waits). See\n   * `SegmentLoadingState['loadingSuspended']`.\n   */\n  loadingSuspended?: boolean;\n  /**\n   * Author intent for the AirPlay/remote-playback picker, written by the media adapter's `disableRemotePlayback` IDL\n   * property. `true` is an explicit opt-out: `setupAirPlay` reads it at attach and sets nothing up, leaving the\n   * element's remote playback disabled. Distinct from the underlying media element's own `disableRemotePlayback`, which\n   * stays programmatically managed (ManagedMediaSource / AirPlay).\n   */\n  disableRemotePlayback?: boolean;\n}\n\n/**\n * Context shape for the audio-only HLS playback engine.\n *\n * Subset of `HlsVideoEngineContext` covering only the platform objects and actor refs managed by audio-side behaviors.\n */\nexport interface HlsAudioEngineContext {\n  mediaElement?: HTMLMediaElement | undefined;\n  mediaSource?: MediaSource;\n  audioBufferActor?: SourceBufferActor;\n  audioSegmentLoaderActor?: SegmentLoaderActor;\n}\n\nexport type HlsAudioEngineSignals = {\n  state: StateSignals<HlsAudioEngineState>;\n  context: ContextSignals<HlsAudioEngineContext>;\n};\n\n/**\n * Configuration for the audio-only HLS playback engine.\n *\n * Subset of `HlsVideoEngineConfig` — video-quality, bandwidth-estimator, and text-track config fields are omitted (no\n * behavior consumes them).\n */\nexport interface HlsAudioEngineConfig extends ShareSignalsConfig<HlsAudioEngineState, HlsAudioEngineContext> {\n  preferredAudioLanguage?: string;\n  /**\n   * Codec capability probe read by `track-switching`'s `excludeUnplayableTracks` constraint. Defaults to the\n   * `MediaSource.isTypeSupported`-backed `canPlayTrack`; override to force-exclude a codec. Mirrors the default engine\n   * — without it, capability probing (and TS / raw-AAC detection) would be inert for audio-only playback.\n   */\n  canPlayTrack?: CanPlayTrack;\n  /**\n   * Codec families the initial audio pick prefers on a mixed-codec source (`preferCodecFamilies` scope) — the family it\n   * lands in is then sticky for the source's lifetime (`stickToSelectedCodecs`; SPF implements no\n   * `SourceBuffer.changeType()`). Defaults to `DEFAULT_PREFERRED_CODECS` (AAC, plus video 4CCs inert here); pass `[]`\n   * to disable.\n   */\n  preferredCodecs?: string[];\n  /**\n   * Conditions reported about each rendition as it resolves — the _causes_ behind a later verdict, and the copy a\n   * verdict reuses when they agree. Defaults to {@link reportUnsupportedTrackConditions}, which reports non-fMP4\n   * containers and encryption; supply your own to report a different set (a provider that never ships MPEG-TS can drop\n   * that check) or `() => []` to report nothing.\n   */\n  reportUnsupportedTrackConditions?: ReportUnsupportedTrackConditions;\n  resolveDuration?: PresentationDurationResolver;\n  parsePresentation?: ParsePresentation;\n  forwardBuffer?: Partial<ForwardBufferConfig>;\n  backBuffer?: Partial<BackBufferConfig>;\n  /** Multi-CDN failover monitor tuning. Defaults: `DEFAULT_FAILOVER_MONITOR_CONFIG`. */\n  failover?: Partial<FailoverMonitorConfig>;\n  /**\n   * Derive a CDN grouping key from a track URL (used by `cdnPriority`, the failover trip, and the track-switching CDN\n   * rules — one function read by all). Defaults to the URL origin; override to key on e.g. Mux's `cdn=` param.\n   */\n  getCdnId?: GetCdnId;\n  /** Non-zero-PTS relocation (spike): the reduce seam (tier knob); defaults to per-track own. */\n  deriveStartMediaTime?: DeriveStartMediaTime;\n}\n\n// ============================================================================\n// Audio-Only HLS Playback Engine\n// ============================================================================\n\n// Materializes input slots no composed behavior produces — `userAudioTrackSelection`\n// (switchAudioTrack only reads it) and `disableRemotePlayback` (setupAirPlay only\n// reads it) — in addition to forwarding refs. `failedCdns` is owned by\n// `setupFailoverMonitor`, so it's already materialized and reachable on the\n// `onSignalsReady` refs without being listed here.\nconst shareSignals = makeShareSignals<HlsAudioEngineState, HlsAudioEngineContext>([\n  'userAudioTrackSelection',\n  'disableRemotePlayback',\n]);\n\n/**\n * Create an audio-only HLS playback engine.\n *\n * Subtractive composition variant of `createHlsVideoEngine`: omits video-side behaviors (`resolveVideoTrack`,\n * `switchVideoTrack`, `setupVideoBufferActors`, `loadVideoSegments`) and text-track behaviors (`switchTextTrack`,\n * `resolveTextTrack`, `syncTextTracks`, `setupTextTrackActors`, `loadTextTrackSegments`). The remaining audio pipeline\n * composes unchanged.\n *\n * Handles both truly audio-only HLS sources (no video stream-inf) and mixed-AV HLS sources where the audio rendition is\n * selected and video / subtitle renditions are ignored at composition time. The variant decision is encoded by adapter\n * choice; this engine does not branch on source shape.\n *\n * @example\n *   ```ts\n *   let signals: HlsAudioEngineSignals;\n *   const engine = createHlsAudioEngine({\n *     preferredAudioLanguage: 'en',\n *     onSignalsReady: (refs) => {\n *       signals = refs;\n *     },\n *   });\n *\n *   signals.context.mediaElement.set(audioEl);\n *   signals.state.presentation.set({ url: 'https://example.com/stream.m3u8' });\n *   ```;\n */\nexport function createHlsAudioEngine(\n  config: HlsAudioEngineConfig = {}\n): Composition<HlsAudioEngineState, HlsAudioEngineContext> {\n  const deriveStartMediaTime = config.deriveStartMediaTime ?? deriveSharedMinStartMediaTime;\n  const finalConfig = {\n    ...config,\n    deriveStartMediaTime,\n    // Baked (not user-overridable): this engine composes `setupAirPlay`,\n    // whose native fallback `<source>` requires the MSE attachment to keep\n    // sibling source alternatives part of resource selection. The helper's\n    // `video/mp4` source type is inert here — resource selection probes it\n    // with `canPlayType`, which answers `'maybe'` on an audio element too.\n    attachMediaSource: attachMediaSourceAsSourceElement,\n    canPlayTrack: config.canPlayTrack ?? canPlayTrack,\n    reportUnsupportedTrackConditions: config.reportUnsupportedTrackConditions ?? reportUnsupportedTrackConditions,\n    resolveDuration: config.resolveDuration ?? getResolvedSelectedTrackDuration,\n    parsePresentation: config.parsePresentation ?? parseMultivariantPlaylist,\n    // Non-zero-PTS relocation (spike): pair the audio loader with the relocation steps\n    // `establishStartMediaTime` derives from; same `deriveStartMediaTime` seam. Remove\n    // with the reactor.\n    audioMessagePipelines: relocationPipelinesFor('audio', deriveStartMediaTime),\n  };\n\n  return createComposition(\n    [\n      syncPreload,\n      trackLoadTriggers,\n      resolvePresentation,\n\n      // Session-level CDN priority for redundant-stream sources. Owns\n      // `cdnPriority`; switchAudioTrack's preferActiveCdn scope reads it. No-op\n      // for single-CDN sources.\n      //\n      // With a single track type there's no cross-type coherence to enforce and\n      // the first pick is the primary CDN regardless, so composition order is\n      // not load-bearing here today. It earns its place for forward-consistency\n      // with the default engine and for future failover / steering, where the\n      // active CDN changes dynamically (and selection stays reactive either way).\n      deriveCdnPriority,\n\n      // CDN failover cooldown: watches `failedCdns` (tripped directly by audio\n      // track resolution on a failed media-playlist fetch) and removes each CDN\n      // once its cooldown lapses.\n      setupFailoverMonitor,\n\n      // Owns `errors` and its per-source lifecycle; reporters append into it.\n      collectErrors,\n\n      // Audio track selection — slot owner with filter reactivity.\n      // Mid-stream flush on language switch is handled in segment-loader's\n      // planTasks, not here.\n      switchAudioTrack,\n\n      // Resolve selected tracks — audio only.\n      resolveAudioTrack,\n\n      // Presentation duration\n      calculatePresentationDuration,\n\n      // MSE setup. Single audio buffer; no video buffer to coordinate with,\n      // so the Firefox `mozHasAudio` registration ordering is moot here.\n      setupMediaSource,\n      updateMediaSourceDuration,\n\n      // Non-zero-PTS relocation (spike): establishes per-track startMediaTime;\n      // MUST precede setupAudioBufferActors. Remove this line + the import + the\n      // finalConfig/state entries to drop relocation. (Selection is optional in the\n      // reactor, so it works with only audio in scope.)\n      establishStartMediaTime,\n\n      setupAudioBufferActors,\n\n      // AirPlay/MSE bridge (WebKit only; no-op elsewhere). Audio-only sources\n      // AirPlay to audio receivers (HomePod, AirPlay speakers) through the same\n      // native-HLS fallback `<source>`; `webkitCurrentPlaybackTargetIsWireless`\n      // and the picker are HTMLMediaElement-level, so an `<audio>` host is\n      // AirPlay-capable on the same terms as a `<video>` one.\n      setupAirPlay,\n\n      // Playback tracking\n      trackCurrentTime,\n      // After trackCurrentTime: the one-shot currentTime seed must land after\n      // the mirror's attach-time sync (see apply-start-position.ts).\n      applyStartPosition,\n\n      // Segment loading — audio only.\n      loadAudioSegments,\n\n      // End of stream coordination. `endOfStream` iterates buffer actors via\n      // `[videoBufferActor, audioBufferActor].filter(Boolean)` and reads\n      // `mediaSource.sourceBuffers` aggregately — composes unchanged with\n      // only audio in scope.\n      endOfStream,\n      // Force native `ended` if Chrome freezes the playhead short of the buffered end\n      // after `endOfStream`. Inert for a clean-ending single-track source.\n      recoverEndStall,\n\n      // Adapter signal callback.\n      shareSignals,\n    ],\n    {\n      config: finalConfig,\n    }\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0LA,MAAM,eAAe,iBAA6D,CAChF,2BACA,uBACF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BD,SAAgB,qBACd,SAA+B,CAAC,GACyB;CACzD,MAAM,uBAAuB,OAAO,wBAAwB;CAC5D,MAAM,cAAc;EAClB,GAAG;EACH;EAMA,mBAAmB;EACnB,cAAc,OAAO,gBAAgB;EACrC,kCAAkC,OAAO,oCAAoC;EAC7E,iBAAiB,OAAO,mBAAmB;EAC3C,mBAAmB,OAAO,qBAAqB;EAI/C,uBAAuB,uBAAuB,SAAS,oBAAoB;CAC7E;CAEA,OAAO,kBACL;EACE;EACA;EACA;EAWA;EAKA;EAGA;EAKA;EAGA;EAGA;EAIA;EACA;EAMA;EAEA;EAOA;EAGA;EAGA;EAGA;EAMA;EAGA;EAGA;CACF,GACA,EACE,QAAQ,YACV,CACF;AACF"}

package/dist/dev/playback/engines/hls/engine-background-video.d.ts

@@ -12,43 +12,36 @@ import { SelectVideoTrackConfig } from "../../behaviors/select-tracks.js";
 /**
  * State shape for the background-video playback engine.
  *
- * Mostly narrower than `HlsVideoEngineState`: audio/text track slots are absent
- * because their selection/resolution behaviors are subtracted. `bandwidthState`
- * is present because `setupVideoBufferActors` declares it and `loadVideoSegments`
- * samples into it (wasted work in this variant — a Phase 3 alt-impl will skip
- * sampling).
+ * Mostly narrower than `HlsVideoEngineState`: audio/text track slots are absent because their selection/resolution
+ * behaviors are subtracted. `bandwidthState` is present because `setupVideoBufferActors` declares it and
+ * `loadVideoSegments` samples into it (wasted work in this variant — a Phase 3 alt-impl will skip sampling).
  *
- * `screenResolution` is the one slot this variant has and the HLS video engine
- * doesn't, because the screen-size cap is being built here first. It generalizes
- * — the cap is a selection rule both engines can compose — so expect the slot to
+ * `screenResolution` is the one slot this variant has and the HLS video engine doesn't, because the screen-size cap is
+ * being built here first. It generalizes — the cap is a selection rule both engines can compose — so expect the slot to
  * appear there too rather than staying variant-specific.
  */
 interface BackgroundVideoEngineState {
   /**
-   * The presentation being played. A caller writes `{ url }`;
-   * `resolvePresentation` parses the manifest and populates the rest.
+   * The presentation being played. A caller writes `{ url }`; `resolvePresentation` parses the manifest and populates
+   * the rest.
    */
   presentation?: MaybeResolvedPresentation;
   preload?: 'auto' | 'metadata' | 'none';
   selectedVideoTrackId?: string;
   loadActivated?: boolean;
   /**
-   * The screen's pixel dimensions, or `undefined` where there is none to read.
-   * Written by `trackScreenResolution`, read by the `screenResolutionCap`
-   * selection rule — which treats `undefined` as "don't cap".
+   * The screen's pixel dimensions, or `undefined` where there is none to read. Written by `trackScreenResolution`, read
+   * by the `screenResolutionCap` selection rule — which treats `undefined` as "don't cap".
    */
   screenResolution?: ScreenResolution;
   /**
-   * Conditions reported while this source is loaded — the per-rendition causes
-   * `resolveVideoTrack` reports and the verdict `selectVideoTrack` reports when
-   * the constraints prune every rendition. Owned and cleared per source by
+   * Conditions reported while this source is loaded — the per-rendition causes `resolveVideoTrack` reports and the
+   * verdict `selectVideoTrack` reports when the constraints prune every rendition. Owned and cleared per source by
    * `collectErrors`; the adapter derives which are fatal.
    */
   errors?: SvtaError[];
 }
-/**
- * Context shape for the background-video engine.
- */
+/** Context shape for the background-video engine. */
 interface BackgroundVideoEngineContext {
   mediaElement?: HTMLMediaElement | undefined;
   mediaSource?: MediaSource;
@@ -56,10 +49,8 @@ interface BackgroundVideoEngineContext {
   videoSegmentLoaderActor?: SegmentLoaderActor;
 }
 /**
- * The composition signal refs handed to `onSignalsReady` callers — the
- * canonical way to drive the engine externally (writes) or observe its
- * state (reads) without touching `composition.state` / `composition.context`
- * directly.
+ * The composition signal refs handed to `onSignalsReady` callers — the canonical way to drive the engine externally
+ * (writes) or observe its state (reads) without touching `composition.state` / `composition.context` directly.
  */
 type BackgroundVideoEngineSignals = {
   state: StateSignals<BackgroundVideoEngineState>;
@@ -68,89 +59,71 @@ type BackgroundVideoEngineSignals = {
 /**
  * Configuration for the background-video engine.
  *
- * Each option is consumed by the appropriate behavior — the engine itself
- * has no config beyond what its behaviors read. Compared to
- * `HlsVideoEngineConfig`, audio/text/ABR/bandwidth/quality knobs are
- * dropped: the variant subtracts the behaviors that read them.
+ * Each option is consumed by the appropriate behavior — the engine itself has no config beyond what its behaviors read.
+ * Compared to `HlsVideoEngineConfig`, audio/text/ABR/bandwidth/quality knobs are dropped: the variant subtracts the
+ * behaviors that read them.
  */
 interface BackgroundVideoEngineConfig extends ShareSignalsConfig<BackgroundVideoEngineState, BackgroundVideoEngineContext> {
   /**
-   * Hard-constraint pre-pass handed to `selectVideoTrack`. Defaults to
-   * `[excludeUnplayableTracks, reportAbsentTrackType(2011)]` — prune the renditions
-   * this environment can't decode, then report 2011 if nothing is left (this engine
-   * composes only video, so a source with none playable can never play).
+   * Hard-constraint pre-pass handed to `selectVideoTrack`. Defaults to `[excludeUnplayableTracks,
+   * reportAbsentTrackType(2011)]` — prune the renditions this environment can't decode, then report 2011 if nothing is
+   * left (this engine composes only video, so a source with none playable can never play).
    */
   constraints?: SelectVideoTrackConfig['constraints'];
   /**
-   * Selection-rule chain handed to `selectVideoTrack`. Defaults to
-   * `[screenResolutionCap, preferHighestResolution]` — narrows to the renditions
-   * that fit the screen, takes the largest of those, and pins it for the session.
+   * Selection-rule chain handed to `selectVideoTrack`. Defaults to `[screenResolutionCap, preferHighestResolution]` —
+   * narrows to the renditions that fit the screen, takes the largest of those, and pins it for the session.
    *
-   * The cap sits ahead of the ranker because a scope that narrows first wins over
-   * one applied later; pass `[preferHighestResolution]` alone to opt out and always
-   * pin the largest rendition on offer.
+   * The cap sits ahead of the ranker because a scope that narrows first wins over one applied later; pass
+   * `[preferHighestResolution]` alone to opt out and always pin the largest rendition on offer.
    */
   rules?: readonly NonNullable<SelectVideoTrackConfig['rules']>[number][];
-  /**
-   * Manifest parser handed to `resolvePresentation`. Defaults to the HLS
-   * multivariant-playlist parser.
-   */
+  /** Manifest parser handed to `resolvePresentation`. Defaults to the HLS multivariant-playlist parser. */
   parsePresentation?: ParsePresentation;
-  /**
-   * Whether `state.screenResolution` is reported in device pixels. Read by
-   * `trackScreenResolution`; defaults to `true`.
-   */
+  /** Whether `state.screenResolution` is reported in device pixels. Read by `trackScreenResolution`; defaults to `true`. */
   useDevicePixelRatio?: boolean;
   /**
-   * Codec/container capability probe read by `selectVideoTrack`'s constraint
-   * pre-pass. Defaults to the DOM `canPlayTrack`; override to force-exclude a
-   * codec.
+   * Codec/container capability probe read by `selectVideoTrack`'s constraint pre-pass. Defaults to the DOM
+   * `canPlayTrack`; override to force-exclude a codec.
    */
   canPlayTrack?: CanPlayTrack;
   /**
-   * Per-rendition condition reporting, called by `resolveVideoTrack` once a
-   * media playlist parses. Defaults to
-   * {@link reportUnsupportedTrackConditions}, which reports non-fMP4 containers
-   * (1004) and encryption (4008).
+   * Per-rendition condition reporting, called by `resolveVideoTrack` once a media playlist parses. Defaults to
+   * {@link reportUnsupportedTrackConditions}, which reports non-fMP4 containers (1004) and encryption (4008).
    */
   reportUnsupportedTrackConditions?: ReportUnsupportedTrackConditions;
 }
 /**
  * Create a background-video playback engine.
  *
- * Subtractive composition over the HLS engine baseline:
- * audio-side, text-side, ABR-driven, preload-monitoring, and play/seek
- * load-trigger behaviors are removed. `selectVideoTrack` (with a
- * highest-resolution rule by default) replaces `switchVideoQuality`, pinning
- * a single rendition for the session. The initial state seeds
- * `loadActivated: true` so the composition behaves as if preload has
- * already been activated — appropriate for ambient / hero / GIF-replacement
+ * Subtractive composition over the HLS engine baseline: audio-side, text-side, ABR-driven, preload-monitoring, and
+ * play/seek load-trigger behaviors are removed. `selectVideoTrack` (with a highest-resolution rule by default) replaces
+ * `switchVideoQuality`, pinning a single rendition for the session. The initial state seeds `loadActivated: true` so
+ * the composition behaves as if preload has already been activated — appropriate for ambient / hero / GIF-replacement
  * surfaces that should start loading the moment a src is set.
  *
- * Error reporting is *not* subtracted: `collectErrors` owns the sequence,
- * `resolveVideoTrack` reports per-rendition causes, and `selectVideoTrack`
- * reports the video verdict when nothing survives its constraints. Without them
- * every unplayable source here is a silent stall — an unsupported container,
- * encryption this engine can't decrypt, and an undecodable codec all leave
- * `HTMLMediaElement.error` null on both Chromium and WebKit.
+ * Error reporting is _not_ subtracted: `collectErrors` owns the sequence, `resolveVideoTrack` reports per-rendition
+ * causes, and `selectVideoTrack` reports the video verdict when nothing survives its constraints. Without them every
+ * unplayable source here is a silent stall — an unsupported container, encryption this engine can't decrypt, and an
+ * undecodable codec all leave `HTMLMediaElement.error` null on both Chromium and WebKit.
  *
- * Native `loop` / `muted` / `autoplay` are adapter concerns and live on
- * `HlsBackgroundVideoMediaElement` rather than the engine.
+ * Native `loop` / `muted` / `autoplay` are adapter concerns and live on `HlsBackgroundVideoMediaElement` rather than
+ * the engine.
  *
  * @example
- * ```ts
- * let signals: BackgroundVideoEngineSignals;
- * const engine = createBackgroundVideoEngine({
- *   onSignalsReady: (refs) => {
- *     signals = refs;
- *   },
- * });
+ *   ```ts
+ *   let signals: BackgroundVideoEngineSignals;
+ *   const engine = createBackgroundVideoEngine({
+ *     onSignalsReady: (refs) => {
+ *       signals = refs;
+ *     },
+ *   });
  *
- * signals.context.mediaElement.set(videoEl);
- * signals.state.presentation.set({ url: 'https://example.com/stream.m3u8' });
+ *   signals.context.mediaElement.set(videoEl);
+ *   signals.state.presentation.set({ url: 'https://example.com/stream.m3u8' });
  *
- * await engine.destroy();
- * ```
+ *   await engine.destroy();
+ *   ```;
  */
 declare function createBackgroundVideoEngine(config?: BackgroundVideoEngineConfig): Composition<BackgroundVideoEngineState, BackgroundVideoEngineContext>;
 //#endregion

package/dist/dev/playback/engines/hls/engine-background-video.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine-background-video.d.ts","names":[],"sources":["../../../../../src/playback/engines/hls/engine-background-video.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;UAwDiB;;;;;EAKf,eAAe;EACf;EACA;EACA;;;;;;EAMA,mBAAmB;;;;;;;EAOnB,SAAS;;;;;UAMM;EACf,eAAe;EACf,cAAc;EACd,mBAAmB;EACnB,0BAA0B;;;;;;;;KAShB;EACV,OAAO,aAAa;EACpB,SAAS,eAAe;;;;;;;;;;UAWT,oCACP,mBAAmB,4BAA4B;;;;;;;EAOvD,cAAc;;;;;;;;;;EAUd,iBAAiB,YAAY;;;;;EAK7B,oBAAoB;;;;;EAKpB;;;;;;EAMA,eAAe;;;;;;;EAOf,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8CrB,4BACd,SAAQ,8BACP,YAAY,4BAA4B"}
+{"version":3,"file":"engine-background-video.d.ts","names":[],"sources":["../../../../../src/playback/engines/hls/engine-background-video.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;UAqDiB;;;;;EAKf,eAAe;EACf;EACA;EACA;;;;;EAKA,mBAAmB;;;;;;EAMnB,SAAS;;;UAIM;EACf,eAAe;EACf,cAAc;EACd,mBAAmB;EACnB,0BAA0B;;;;;;KAOhB;EACV,OAAO,aAAa;EACpB,SAAS,eAAe;;;;;;;;;UAUT,oCAAoC,mBACnD,4BACA;;;;;;EAOA,cAAc;;;;;;;;EAQd,iBAAiB,YAAY;;EAE7B,oBAAoB;;EAEpB;;;;;EAKA,eAAe;;;;;EAKf,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyCrB,4BACd,SAAQ,8BACP,YAAY,4BAA4B"}

package/dist/dev/playback/engines/hls/engine-background-video.js

@@ -5,11 +5,11 @@ import { trackCurrentTime } from "../../behaviors/dom/track-current-time.js";
 import "../../../media/errors.js";
 import { excludeUnplayableTracks } from "../../primitives/selection-rules.js";
 import { preferHighestResolution, screenResolutionCap, selectVideoTrack } from "../../behaviors/select-tracks.js";
+import { collectErrors, reportAbsentTrackType } from "../../behaviors/collect-errors.js";
 import { canPlayTrack } from "../../../media/dom/capabilities.js";
 import { parseMultivariantPlaylist } from "../../../media/hls/parse-multivariant.js";
 import { getResolvedSelectedTrackDuration } from "../../../media/utils/track-selection.js";
 import { calculatePresentationDuration } from "../../behaviors/calculate-presentation-duration.js";
-import { collectErrors, reportAbsentTrackType } from "../../behaviors/collect-errors.js";
 import { endOfStream } from "../../behaviors/dom/end-of-stream.js";
 import { setupVideoBufferActors } from "../../behaviors/dom/setup-buffer-actors.js";
 import { setupMediaSource } from "../../behaviors/dom/setup-mediasource.js";
@@ -23,39 +23,34 @@ const shareSignals = makeShareSignals();
 /**
 * Create a background-video playback engine.
 *
-* Subtractive composition over the HLS engine baseline:
-* audio-side, text-side, ABR-driven, preload-monitoring, and play/seek
-* load-trigger behaviors are removed. `selectVideoTrack` (with a
-* highest-resolution rule by default) replaces `switchVideoQuality`, pinning
-* a single rendition for the session. The initial state seeds
-* `loadActivated: true` so the composition behaves as if preload has
-* already been activated — appropriate for ambient / hero / GIF-replacement
+* Subtractive composition over the HLS engine baseline: audio-side, text-side, ABR-driven, preload-monitoring, and
+* play/seek load-trigger behaviors are removed. `selectVideoTrack` (with a highest-resolution rule by default) replaces
+* `switchVideoQuality`, pinning a single rendition for the session. The initial state seeds `loadActivated: true` so
+* the composition behaves as if preload has already been activated — appropriate for ambient / hero / GIF-replacement
 * surfaces that should start loading the moment a src is set.
 *
-* Error reporting is *not* subtracted: `collectErrors` owns the sequence,
-* `resolveVideoTrack` reports per-rendition causes, and `selectVideoTrack`
-* reports the video verdict when nothing survives its constraints. Without them
-* every unplayable source here is a silent stall — an unsupported container,
-* encryption this engine can't decrypt, and an undecodable codec all leave
-* `HTMLMediaElement.error` null on both Chromium and WebKit.
+* Error reporting is _not_ subtracted: `collectErrors` owns the sequence, `resolveVideoTrack` reports per-rendition
+* causes, and `selectVideoTrack` reports the video verdict when nothing survives its constraints. Without them every
+* unplayable source here is a silent stall — an unsupported container, encryption this engine can't decrypt, and an
+* undecodable codec all leave `HTMLMediaElement.error` null on both Chromium and WebKit.
 *
-* Native `loop` / `muted` / `autoplay` are adapter concerns and live on
-* `HlsBackgroundVideoMediaElement` rather than the engine.
+* Native `loop` / `muted` / `autoplay` are adapter concerns and live on `HlsBackgroundVideoMediaElement` rather than
+* the engine.
 *
 * @example
-* ```ts
-* let signals: BackgroundVideoEngineSignals;
-* const engine = createBackgroundVideoEngine({
-*   onSignalsReady: (refs) => {
-*     signals = refs;
-*   },
-* });
+*   ```ts
+*   let signals: BackgroundVideoEngineSignals;
+*   const engine = createBackgroundVideoEngine({
+*     onSignalsReady: (refs) => {
+*       signals = refs;
+*     },
+*   });
 *
-* signals.context.mediaElement.set(videoEl);
-* signals.state.presentation.set({ url: 'https://example.com/stream.m3u8' });
+*   signals.context.mediaElement.set(videoEl);
+*   signals.state.presentation.set({ url: 'https://example.com/stream.m3u8' });
 *
-* await engine.destroy();
-* ```
+*   await engine.destroy();
+*   ```;
 */
 function createBackgroundVideoEngine(config = {}) {
 	const finalConfig = {

package/dist/dev/playback/engines/hls/engine-background-video.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine-background-video.js","names":[],"sources":["../../../../../src/playback/engines/hls/engine-background-video.ts"],"sourcesContent":["import {\n  type Composition,\n  type ContextSignals,\n  createComposition,\n  type StateSignals,\n} from '../../../core/composition/create-composition';\nimport { makeShareSignals, type ShareSignalsConfig } from '../../../core/composition/share-signals';\nimport { canPlayTrack } from '../../../media/dom/capabilities';\nimport type { ScreenResolution } from '../../../media/dom/screen';\nimport { SVTA_NO_SUPPORTED_VIDEO_TRACK, type SvtaError } from '../../../media/errors';\nimport { parseMultivariantPlaylist } from '../../../media/hls/parse-multivariant';\nimport type { CanPlayTrack, MaybeResolvedPresentation } from '../../../media/types';\nimport { getResolvedSelectedTrackDuration } from '../../../media/utils/track-selection';\nimport type { SegmentLoaderActor } from '../../actors/dom/segment-loader';\nimport type { SourceBufferActor } from '../../actors/dom/source-buffer';\nimport { calculatePresentationDuration } from '../../behaviors/calculate-presentation-duration';\nimport { collectErrors, reportAbsentTrackType } from '../../behaviors/collect-errors';\nimport { endOfStream } from '../../behaviors/dom/end-of-stream';\nimport { loadVideoSegments } from '../../behaviors/dom/load-segments';\nimport { setupVideoBufferActors } from '../../behaviors/dom/setup-buffer-actors';\nimport { setupMediaSource } from '../../behaviors/dom/setup-mediasource';\nimport { trackCurrentTime } from '../../behaviors/dom/track-current-time';\nimport { trackScreenResolution } from '../../behaviors/dom/track-screen-resolution';\nimport { updateMediaSourceDuration } from '../../behaviors/dom/update-mediasource-duration';\nimport { type ParsePresentation, resolvePresentation } from '../../behaviors/resolve-presentation';\nimport { resolveVideoTrack } from '../../behaviors/resolve-track';\nimport {\n  preferHighestResolution,\n  type SelectVideoTrackConfig,\n  screenResolutionCap,\n  selectVideoTrack,\n} from '../../behaviors/select-tracks';\nimport {\n  type ReportUnsupportedTrackConditions,\n  reportUnsupportedTrackConditions,\n} from '../../primitives/report-track-conditions';\nimport { excludeUnplayableTracks } from '../../primitives/selection-rules';\n\n// ============================================================================\n// Background-video engine state & context\n// ============================================================================\n\n/**\n * State shape for the background-video playback engine.\n *\n * Mostly narrower than `HlsVideoEngineState`: audio/text track slots are absent\n * because their selection/resolution behaviors are subtracted. `bandwidthState`\n * is present because `setupVideoBufferActors` declares it and `loadVideoSegments`\n * samples into it (wasted work in this variant — a Phase 3 alt-impl will skip\n * sampling).\n *\n * `screenResolution` is the one slot this variant has and the HLS video engine\n * doesn't, because the screen-size cap is being built here first. It generalizes\n * — the cap is a selection rule both engines can compose — so expect the slot to\n * appear there too rather than staying variant-specific.\n */\nexport interface BackgroundVideoEngineState {\n  /**\n   * The presentation being played. A caller writes `{ url }`;\n   * `resolvePresentation` parses the manifest and populates the rest.\n   */\n  presentation?: MaybeResolvedPresentation;\n  preload?: 'auto' | 'metadata' | 'none';\n  selectedVideoTrackId?: string;\n  loadActivated?: boolean;\n  /**\n   * The screen's pixel dimensions, or `undefined` where there is none to read.\n   * Written by `trackScreenResolution`, read by the `screenResolutionCap`\n   * selection rule — which treats `undefined` as \"don't cap\".\n   */\n  screenResolution?: ScreenResolution;\n  /**\n   * Conditions reported while this source is loaded — the per-rendition causes\n   * `resolveVideoTrack` reports and the verdict `selectVideoTrack` reports when\n   * the constraints prune every rendition. Owned and cleared per source by\n   * `collectErrors`; the adapter derives which are fatal.\n   */\n  errors?: SvtaError[];\n}\n\n/**\n * Context shape for the background-video engine.\n */\nexport interface BackgroundVideoEngineContext {\n  mediaElement?: HTMLMediaElement | undefined;\n  mediaSource?: MediaSource;\n  videoBufferActor?: SourceBufferActor;\n  videoSegmentLoaderActor?: SegmentLoaderActor;\n}\n\n/**\n * The composition signal refs handed to `onSignalsReady` callers — the\n * canonical way to drive the engine externally (writes) or observe its\n * state (reads) without touching `composition.state` / `composition.context`\n * directly.\n */\nexport type BackgroundVideoEngineSignals = {\n  state: StateSignals<BackgroundVideoEngineState>;\n  context: ContextSignals<BackgroundVideoEngineContext>;\n};\n\n/**\n * Configuration for the background-video engine.\n *\n * Each option is consumed by the appropriate behavior — the engine itself\n * has no config beyond what its behaviors read. Compared to\n * `HlsVideoEngineConfig`, audio/text/ABR/bandwidth/quality knobs are\n * dropped: the variant subtracts the behaviors that read them.\n */\nexport interface BackgroundVideoEngineConfig\n  extends ShareSignalsConfig<BackgroundVideoEngineState, BackgroundVideoEngineContext> {\n  /**\n   * Hard-constraint pre-pass handed to `selectVideoTrack`. Defaults to\n   * `[excludeUnplayableTracks, reportAbsentTrackType(2011)]` — prune the renditions\n   * this environment can't decode, then report 2011 if nothing is left (this engine\n   * composes only video, so a source with none playable can never play).\n   */\n  constraints?: SelectVideoTrackConfig['constraints'];\n  /**\n   * Selection-rule chain handed to `selectVideoTrack`. Defaults to\n   * `[screenResolutionCap, preferHighestResolution]` — narrows to the renditions\n   * that fit the screen, takes the largest of those, and pins it for the session.\n   *\n   * The cap sits ahead of the ranker because a scope that narrows first wins over\n   * one applied later; pass `[preferHighestResolution]` alone to opt out and always\n   * pin the largest rendition on offer.\n   */\n  rules?: readonly NonNullable<SelectVideoTrackConfig['rules']>[number][];\n  /**\n   * Manifest parser handed to `resolvePresentation`. Defaults to the HLS\n   * multivariant-playlist parser.\n   */\n  parsePresentation?: ParsePresentation;\n  /**\n   * Whether `state.screenResolution` is reported in device pixels. Read by\n   * `trackScreenResolution`; defaults to `true`.\n   */\n  useDevicePixelRatio?: boolean;\n  /**\n   * Codec/container capability probe read by `selectVideoTrack`'s constraint\n   * pre-pass. Defaults to the DOM `canPlayTrack`; override to force-exclude a\n   * codec.\n   */\n  canPlayTrack?: CanPlayTrack;\n  /**\n   * Per-rendition condition reporting, called by `resolveVideoTrack` once a\n   * media playlist parses. Defaults to\n   * {@link reportUnsupportedTrackConditions}, which reports non-fMP4 containers\n   * (1004) and encryption (4008).\n   */\n  reportUnsupportedTrackConditions?: ReportUnsupportedTrackConditions;\n}\n\n// ============================================================================\n// Background-video playback engine\n// ============================================================================\n\nconst shareSignals = makeShareSignals<BackgroundVideoEngineState, BackgroundVideoEngineContext>();\n\n/**\n * Create a background-video playback engine.\n *\n * Subtractive composition over the HLS engine baseline:\n * audio-side, text-side, ABR-driven, preload-monitoring, and play/seek\n * load-trigger behaviors are removed. `selectVideoTrack` (with a\n * highest-resolution rule by default) replaces `switchVideoQuality`, pinning\n * a single rendition for the session. The initial state seeds\n * `loadActivated: true` so the composition behaves as if preload has\n * already been activated — appropriate for ambient / hero / GIF-replacement\n * surfaces that should start loading the moment a src is set.\n *\n * Error reporting is *not* subtracted: `collectErrors` owns the sequence,\n * `resolveVideoTrack` reports per-rendition causes, and `selectVideoTrack`\n * reports the video verdict when nothing survives its constraints. Without them\n * every unplayable source here is a silent stall — an unsupported container,\n * encryption this engine can't decrypt, and an undecodable codec all leave\n * `HTMLMediaElement.error` null on both Chromium and WebKit.\n *\n * Native `loop` / `muted` / `autoplay` are adapter concerns and live on\n * `HlsBackgroundVideoMediaElement` rather than the engine.\n *\n * @example\n * ```ts\n * let signals: BackgroundVideoEngineSignals;\n * const engine = createBackgroundVideoEngine({\n *   onSignalsReady: (refs) => {\n *     signals = refs;\n *   },\n * });\n *\n * signals.context.mediaElement.set(videoEl);\n * signals.state.presentation.set({ url: 'https://example.com/stream.m3u8' });\n *\n * await engine.destroy();\n * ```\n */\nexport function createBackgroundVideoEngine(\n  config: BackgroundVideoEngineConfig = {}\n): Composition<BackgroundVideoEngineState, BackgroundVideoEngineContext> {\n  const finalConfig = {\n    ...config,\n    constraints: config.constraints ?? [excludeUnplayableTracks, reportAbsentTrackType(SVTA_NO_SUPPORTED_VIDEO_TRACK)],\n    rules: config.rules ?? [screenResolutionCap, preferHighestResolution],\n    parsePresentation: config.parsePresentation ?? parseMultivariantPlaylist,\n    resolveDuration: getResolvedSelectedTrackDuration,\n    canPlayTrack: config.canPlayTrack ?? canPlayTrack,\n    reportUnsupportedTrackConditions: config.reportUnsupportedTrackConditions ?? reportUnsupportedTrackConditions,\n  };\n\n  return createComposition(\n    [\n      resolvePresentation,\n      // Presentation duration\n      calculatePresentationDuration,\n\n      // Owns `errors` and its per-source lifecycle; reporters append into it.\n      collectErrors,\n\n      // Track selection - pinned single-rendition pick on presentation resolve,\n      // unpinned again if the constraint pre-pass later prunes every rendition\n      // (which is how a container relabel reaches a pick already made).\n      selectVideoTrack,\n      // Resolve selected video track (fetch its media playlist)\n      resolveVideoTrack,\n      // Segment loading — video-only.\n      loadVideoSegments,\n\n      // MSE setup — video-only.\n      setupMediaSource,\n      updateMediaSourceDuration,\n      setupVideoBufferActors,\n\n      // Playback tracking\n      trackCurrentTime,\n\n      // Environment tracking — the signal source for a screen-size rendition\n      // cap. Independent of the presentation, so it sits outside the\n      // resolve/select/load sequence above.\n      trackScreenResolution,\n\n      // End of stream coordination\n      endOfStream,\n\n      // Behavior whose sole purpose is to expose signal refs via a callback\n      // (e.g. to an adapter). Listed last so initial signal setup has run\n      // before the callback fires.\n      shareSignals,\n    ],\n    {\n      config: finalConfig,\n      initialState: {\n        // Note: Set to true until we add preload configuration\n        loadActivated: true,\n      },\n    }\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA6JA,MAAM,eAAe,iBAA2E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuChG,SAAgB,4BACd,SAAsC,CAAC,GACgC;CACvE,MAAM,cAAc;EAClB,GAAG;EACH,aAAa,OAAO,eAAe,CAAC,yBAAyB,sBAAA,IAAmD,CAAC;EACjH,OAAO,OAAO,SAAS,CAAC,qBAAqB,uBAAuB;EACpE,mBAAmB,OAAO,qBAAqB;EAC/C,iBAAiB;EACjB,cAAc,OAAO,gBAAgB;EACrC,kCAAkC,OAAO,oCAAoC;CAC/E;CAEA,OAAO,kBACL;EACE;EAEA;EAGA;EAKA;EAEA;EAEA;EAGA;EACA;EACA;EAGA;EAKA;EAGA;EAKA;CACF,GACA;EACE,QAAQ;EACR,cAAc,EAEZ,eAAe,KACjB;CACF,CACF;AACF"}
+{"version":3,"file":"engine-background-video.js","names":[],"sources":["../../../../../src/playback/engines/hls/engine-background-video.ts"],"sourcesContent":["import {\n  type Composition,\n  type ContextSignals,\n  createComposition,\n  type StateSignals,\n} from '../../../core/composition/create-composition';\nimport { makeShareSignals, type ShareSignalsConfig } from '../../../core/composition/share-signals';\nimport { canPlayTrack } from '../../../media/dom/capabilities';\nimport type { ScreenResolution } from '../../../media/dom/screen';\nimport { SVTA_NO_SUPPORTED_VIDEO_TRACK, type SvtaError } from '../../../media/errors';\nimport { parseMultivariantPlaylist } from '../../../media/hls/parse-multivariant';\nimport type { CanPlayTrack, MaybeResolvedPresentation } from '../../../media/types';\nimport { getResolvedSelectedTrackDuration } from '../../../media/utils/track-selection';\nimport type { SegmentLoaderActor } from '../../actors/dom/segment-loader';\nimport type { SourceBufferActor } from '../../actors/dom/source-buffer';\nimport { calculatePresentationDuration } from '../../behaviors/calculate-presentation-duration';\nimport { collectErrors, reportAbsentTrackType } from '../../behaviors/collect-errors';\nimport { endOfStream } from '../../behaviors/dom/end-of-stream';\nimport { loadVideoSegments } from '../../behaviors/dom/load-segments';\nimport { setupVideoBufferActors } from '../../behaviors/dom/setup-buffer-actors';\nimport { setupMediaSource } from '../../behaviors/dom/setup-mediasource';\nimport { trackCurrentTime } from '../../behaviors/dom/track-current-time';\nimport { trackScreenResolution } from '../../behaviors/dom/track-screen-resolution';\nimport { updateMediaSourceDuration } from '../../behaviors/dom/update-mediasource-duration';\nimport { type ParsePresentation, resolvePresentation } from '../../behaviors/resolve-presentation';\nimport { resolveVideoTrack } from '../../behaviors/resolve-track';\nimport {\n  preferHighestResolution,\n  type SelectVideoTrackConfig,\n  screenResolutionCap,\n  selectVideoTrack,\n} from '../../behaviors/select-tracks';\nimport {\n  type ReportUnsupportedTrackConditions,\n  reportUnsupportedTrackConditions,\n} from '../../primitives/report-track-conditions';\nimport { excludeUnplayableTracks } from '../../primitives/selection-rules';\n\n// ============================================================================\n// Background-video engine state & context\n// ============================================================================\n\n/**\n * State shape for the background-video playback engine.\n *\n * Mostly narrower than `HlsVideoEngineState`: audio/text track slots are absent because their selection/resolution\n * behaviors are subtracted. `bandwidthState` is present because `setupVideoBufferActors` declares it and\n * `loadVideoSegments` samples into it (wasted work in this variant — a Phase 3 alt-impl will skip sampling).\n *\n * `screenResolution` is the one slot this variant has and the HLS video engine doesn't, because the screen-size cap is\n * being built here first. It generalizes — the cap is a selection rule both engines can compose — so expect the slot to\n * appear there too rather than staying variant-specific.\n */\nexport interface BackgroundVideoEngineState {\n  /**\n   * The presentation being played. A caller writes `{ url }`; `resolvePresentation` parses the manifest and populates\n   * the rest.\n   */\n  presentation?: MaybeResolvedPresentation;\n  preload?: 'auto' | 'metadata' | 'none';\n  selectedVideoTrackId?: string;\n  loadActivated?: boolean;\n  /**\n   * The screen's pixel dimensions, or `undefined` where there is none to read. Written by `trackScreenResolution`, read\n   * by the `screenResolutionCap` selection rule — which treats `undefined` as \"don't cap\".\n   */\n  screenResolution?: ScreenResolution;\n  /**\n   * Conditions reported while this source is loaded — the per-rendition causes `resolveVideoTrack` reports and the\n   * verdict `selectVideoTrack` reports when the constraints prune every rendition. Owned and cleared per source by\n   * `collectErrors`; the adapter derives which are fatal.\n   */\n  errors?: SvtaError[];\n}\n\n/** Context shape for the background-video engine. */\nexport interface BackgroundVideoEngineContext {\n  mediaElement?: HTMLMediaElement | undefined;\n  mediaSource?: MediaSource;\n  videoBufferActor?: SourceBufferActor;\n  videoSegmentLoaderActor?: SegmentLoaderActor;\n}\n\n/**\n * The composition signal refs handed to `onSignalsReady` callers — the canonical way to drive the engine externally\n * (writes) or observe its state (reads) without touching `composition.state` / `composition.context` directly.\n */\nexport type BackgroundVideoEngineSignals = {\n  state: StateSignals<BackgroundVideoEngineState>;\n  context: ContextSignals<BackgroundVideoEngineContext>;\n};\n\n/**\n * Configuration for the background-video engine.\n *\n * Each option is consumed by the appropriate behavior — the engine itself has no config beyond what its behaviors read.\n * Compared to `HlsVideoEngineConfig`, audio/text/ABR/bandwidth/quality knobs are dropped: the variant subtracts the\n * behaviors that read them.\n */\nexport interface BackgroundVideoEngineConfig extends ShareSignalsConfig<\n  BackgroundVideoEngineState,\n  BackgroundVideoEngineContext\n> {\n  /**\n   * Hard-constraint pre-pass handed to `selectVideoTrack`. Defaults to `[excludeUnplayableTracks,\n   * reportAbsentTrackType(2011)]` — prune the renditions this environment can't decode, then report 2011 if nothing is\n   * left (this engine composes only video, so a source with none playable can never play).\n   */\n  constraints?: SelectVideoTrackConfig['constraints'];\n  /**\n   * Selection-rule chain handed to `selectVideoTrack`. Defaults to `[screenResolutionCap, preferHighestResolution]` —\n   * narrows to the renditions that fit the screen, takes the largest of those, and pins it for the session.\n   *\n   * The cap sits ahead of the ranker because a scope that narrows first wins over one applied later; pass\n   * `[preferHighestResolution]` alone to opt out and always pin the largest rendition on offer.\n   */\n  rules?: readonly NonNullable<SelectVideoTrackConfig['rules']>[number][];\n  /** Manifest parser handed to `resolvePresentation`. Defaults to the HLS multivariant-playlist parser. */\n  parsePresentation?: ParsePresentation;\n  /** Whether `state.screenResolution` is reported in device pixels. Read by `trackScreenResolution`; defaults to `true`. */\n  useDevicePixelRatio?: boolean;\n  /**\n   * Codec/container capability probe read by `selectVideoTrack`'s constraint pre-pass. Defaults to the DOM\n   * `canPlayTrack`; override to force-exclude a codec.\n   */\n  canPlayTrack?: CanPlayTrack;\n  /**\n   * Per-rendition condition reporting, called by `resolveVideoTrack` once a media playlist parses. Defaults to\n   * {@link reportUnsupportedTrackConditions}, which reports non-fMP4 containers (1004) and encryption (4008).\n   */\n  reportUnsupportedTrackConditions?: ReportUnsupportedTrackConditions;\n}\n\n// ============================================================================\n// Background-video playback engine\n// ============================================================================\n\nconst shareSignals = makeShareSignals<BackgroundVideoEngineState, BackgroundVideoEngineContext>();\n\n/**\n * Create a background-video playback engine.\n *\n * Subtractive composition over the HLS engine baseline: audio-side, text-side, ABR-driven, preload-monitoring, and\n * play/seek load-trigger behaviors are removed. `selectVideoTrack` (with a highest-resolution rule by default) replaces\n * `switchVideoQuality`, pinning a single rendition for the session. The initial state seeds `loadActivated: true` so\n * the composition behaves as if preload has already been activated — appropriate for ambient / hero / GIF-replacement\n * surfaces that should start loading the moment a src is set.\n *\n * Error reporting is _not_ subtracted: `collectErrors` owns the sequence, `resolveVideoTrack` reports per-rendition\n * causes, and `selectVideoTrack` reports the video verdict when nothing survives its constraints. Without them every\n * unplayable source here is a silent stall — an unsupported container, encryption this engine can't decrypt, and an\n * undecodable codec all leave `HTMLMediaElement.error` null on both Chromium and WebKit.\n *\n * Native `loop` / `muted` / `autoplay` are adapter concerns and live on `HlsBackgroundVideoMediaElement` rather than\n * the engine.\n *\n * @example\n *   ```ts\n *   let signals: BackgroundVideoEngineSignals;\n *   const engine = createBackgroundVideoEngine({\n *     onSignalsReady: (refs) => {\n *       signals = refs;\n *     },\n *   });\n *\n *   signals.context.mediaElement.set(videoEl);\n *   signals.state.presentation.set({ url: 'https://example.com/stream.m3u8' });\n *\n *   await engine.destroy();\n *   ```;\n */\nexport function createBackgroundVideoEngine(\n  config: BackgroundVideoEngineConfig = {}\n): Composition<BackgroundVideoEngineState, BackgroundVideoEngineContext> {\n  const finalConfig = {\n    ...config,\n    constraints: config.constraints ?? [excludeUnplayableTracks, reportAbsentTrackType(SVTA_NO_SUPPORTED_VIDEO_TRACK)],\n    rules: config.rules ?? [screenResolutionCap, preferHighestResolution],\n    parsePresentation: config.parsePresentation ?? parseMultivariantPlaylist,\n    resolveDuration: getResolvedSelectedTrackDuration,\n    canPlayTrack: config.canPlayTrack ?? canPlayTrack,\n    reportUnsupportedTrackConditions: config.reportUnsupportedTrackConditions ?? reportUnsupportedTrackConditions,\n  };\n\n  return createComposition(\n    [\n      resolvePresentation,\n      // Presentation duration\n      calculatePresentationDuration,\n\n      // Owns `errors` and its per-source lifecycle; reporters append into it.\n      collectErrors,\n\n      // Track selection - pinned single-rendition pick on presentation resolve,\n      // unpinned again if the constraint pre-pass later prunes every rendition\n      // (which is how a container relabel reaches a pick already made).\n      selectVideoTrack,\n      // Resolve selected video track (fetch its media playlist)\n      resolveVideoTrack,\n      // Segment loading — video-only.\n      loadVideoSegments,\n\n      // MSE setup — video-only.\n      setupMediaSource,\n      updateMediaSourceDuration,\n      setupVideoBufferActors,\n\n      // Playback tracking\n      trackCurrentTime,\n\n      // Environment tracking — the signal source for a screen-size rendition\n      // cap. Independent of the presentation, so it sits outside the\n      // resolve/select/load sequence above.\n      trackScreenResolution,\n\n      // End of stream coordination\n      endOfStream,\n\n      // Behavior whose sole purpose is to expose signal refs via a callback\n      // (e.g. to an adapter). Listed last so initial signal setup has run\n      // before the callback fires.\n      shareSignals,\n    ],\n    {\n      config: finalConfig,\n      initialState: {\n        // Note: Set to true until we add preload configuration\n        loadActivated: true,\n      },\n    }\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAyIA,MAAM,eAAe,iBAA2E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkChG,SAAgB,4BACd,SAAsC,CAAC,GACgC;CACvE,MAAM,cAAc;EAClB,GAAG;EACH,aAAa,OAAO,eAAe,CAAC,yBAAyB,sBAAA,IAAmD,CAAC;EACjH,OAAO,OAAO,SAAS,CAAC,qBAAqB,uBAAuB;EACpE,mBAAmB,OAAO,qBAAqB;EAC/C,iBAAiB;EACjB,cAAc,OAAO,gBAAgB;EACrC,kCAAkC,OAAO,oCAAoC;CAC/E;CAEA,OAAO,kBACL;EACE;EAEA;EAGA;EAKA;EAEA;EAEA;EAGA;EACA;EACA;EAGA;EAKA;EAGA;EAKA;CACF,GACA;EACE,QAAQ;EACR,cAAc,EAEZ,eAAe,KACjB;CACF,CACF;AACF"}