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

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

@@ -3,12 +3,18 @@ import { makeShareSignals } from "../../../core/composition/share-signals.js";
 import { loadAudioSegments } from "../../behaviors/dom/load-segments.js";
 import { trackCurrentTime } from "../../behaviors/dom/track-current-time.js";
 import { trackLoadTriggers } from "../../behaviors/dom/track-load-triggers.js";
+import { deriveSharedMinStartMediaTime, establishStartMediaTime } from "../../behaviors/establish-start-media-time.js";
+import { attachMediaSourceAsSourceElement } from "../../../media/dom/mse/mediasource-setup.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 } from "../../behaviors/collect-errors.js";
 import { deriveCdnPriority } from "../../behaviors/derive-cdn-priority.js";
+import { setupAirPlay } from "../../behaviors/dom/airplay.js";
+import { applyStartPosition } from "../../behaviors/dom/apply-start-position.js";
 import { endOfStream } from "../../behaviors/dom/end-of-stream.js";
+import { recoverEndStall } from "../../behaviors/dom/recover-end-stall.js";
 import { setupAudioBufferActors } from "../../behaviors/dom/setup-buffer-actors.js";
 import { setupMediaSource } from "../../behaviors/dom/setup-mediasource.js";
 import { updateMediaSourceDuration } from "../../behaviors/dom/update-mediasource-duration.js";
@@ -17,12 +23,14 @@ import { resolveAudioTrack } from "../../behaviors/resolve-track.js";
 import { setupFailoverMonitor } from "../../behaviors/setup-failover-monitor.js";
 import { syncPreload } from "../../behaviors/sync-preload.js";
 import { switchAudioTrack } from "../../behaviors/track-switching.js";
+import { relocationPipelinesFor } from "../../primitives/relocation-pipelines.js";
+import { reportUnsupportedTrackConditions } from "../../primitives/report-track-conditions.js";
 //#region src/playback/engines/hls/engine-audio-only.ts
-const shareSignals = makeShareSignals(["userAudioTrackSelection"]);
+const shareSignals = makeShareSignals(["userAudioTrackSelection", "disableRemotePlayback"]);
 /**
 * Create an audio-only HLS playback engine.
 *
-* Subtractive composition variant of `createSimpleHlsEngine`: omits
+* Subtractive composition variant of `createHlsVideoEngine`: omits
 * video-side behaviors (`resolveVideoTrack`, `switchVideoTrack`,
 * `setupVideoBufferActors`, `loadVideoSegments`) and text-track behaviors
 * (`switchTextTrack`, `resolveTextTrack`, `syncTextTracks`,
@@ -37,8 +45,8 @@ const shareSignals = makeShareSignals(["userAudioTrackSelection"]);
 *
 * @example
 * ```ts
-* let signals: SimpleHlsAudioOnlyEngineSignals;
-* const engine = createHlsAudioOnlyEngine({
+* let signals: HlsAudioEngineSignals;
+* const engine = createHlsAudioEngine({
 *   preferredAudioLanguage: 'en',
 *   onSignalsReady: (refs) => {
 *     signals = refs;
@@ -49,12 +57,17 @@ const shareSignals = makeShareSignals(["userAudioTrackSelection"]);
 * signals.state.presentation.set({ url: 'https://example.com/stream.m3u8' });
 * ```
 */
-function createHlsAudioOnlyEngine(config = {}) {
+function createHlsAudioEngine(config = {}) {
+	const deriveStartMediaTime = config.deriveStartMediaTime ?? deriveSharedMinStartMediaTime;
 	const finalConfig = {
 		...config,
+		deriveStartMediaTime,
+		attachMediaSource: attachMediaSourceAsSourceElement,
 		canPlayTrack: config.canPlayTrack ?? canPlayTrack,
+		reportUnsupportedTrackConditions: config.reportUnsupportedTrackConditions ?? reportUnsupportedTrackConditions,
 		resolveDuration: config.resolveDuration ?? getResolvedSelectedTrackDuration,
-		parsePresentation: config.parsePresentation ?? parseMultivariantPlaylist
+		parsePresentation: config.parsePresentation ?? parseMultivariantPlaylist,
+		audioMessagePipelines: relocationPipelinesFor("audio", deriveStartMediaTime)
 	};
 	return createComposition([
 		syncPreload,
@@ -62,19 +75,24 @@ function createHlsAudioOnlyEngine(config = {}) {
 		resolvePresentation,
 		deriveCdnPriority,
 		setupFailoverMonitor,
+		collectErrors,
 		switchAudioTrack,
 		resolveAudioTrack,
 		calculatePresentationDuration,
 		setupMediaSource,
 		updateMediaSourceDuration,
+		establishStartMediaTime,
 		setupAudioBufferActors,
+		setupAirPlay,
 		trackCurrentTime,
+		applyStartPosition,
 		loadAudioSegments,
 		endOfStream,
+		recoverEndStall,
 		shareSignals
 	], { config: finalConfig });
 }
 //#endregion
-export { createHlsAudioOnlyEngine };
+export { createHlsAudioEngine };
 
 //# sourceMappingURL=engine-audio-only.js.map

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 { parseMultivariantPlaylist } from '../../../media/hls/parse-multivariant';\nimport type { AudioTrack, CanPlayTrack, MaybeResolvedPresentation } 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 { deriveCdnPriority } from '../../behaviors/derive-cdn-priority';\nimport { endOfStream } from '../../behaviors/dom/end-of-stream';\nimport { loadAudioSegments } from '../../behaviors/dom/load-segments';\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';\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';\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 `SimpleHlsEngineState` 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 SimpleHlsAudioOnlyEngineState {\n  presentation?: MaybeResolvedPresentation;\n  preload?: 'auto' | 'metadata' | 'none';\n  selectedAudioTrackId?: string;\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  currentTime?: number;\n  loadActivated?: boolean;\n}\n\n/**\n * Context shape for the audio-only HLS playback engine.\n *\n * Subset of `SimpleHlsEngineContext` covering only the platform objects and\n * actor refs managed by audio-side behaviors.\n */\nexport interface SimpleHlsAudioOnlyEngineContext {\n  mediaElement?: HTMLMediaElement | undefined;\n  mediaSource?: MediaSource;\n  audioBufferActor?: SourceBufferActor;\n  audioSegmentLoaderActor?: SegmentLoaderActor;\n}\n\nexport type SimpleHlsAudioOnlyEngineSignals = {\n  state: StateSignals<SimpleHlsAudioOnlyEngineState>;\n  context: ContextSignals<SimpleHlsAudioOnlyEngineContext>;\n};\n\n/**\n * Configuration for the audio-only HLS playback engine.\n *\n * Subset of `SimpleHlsEngineConfig` — video-quality, bandwidth-estimator,\n * and text-track config fields are omitted (no behavior consumes them).\n */\nexport interface SimpleHlsAudioOnlyEngineConfig\n  extends ShareSignalsConfig<SimpleHlsAudioOnlyEngineState, SimpleHlsAudioOnlyEngineContext> {\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  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}\n\n// ============================================================================\n// Audio-Only HLS Playback Engine\n// ============================================================================\n\n// Materializes input slots no composed behavior produces — `userAudioTrackSelection`\n// (switchAudioTrack only reads it) — in addition to forwarding refs. `failedCdns`\n// is owned by `setupFailoverMonitor`, so it's already materialized and reachable\n// on the `onSignalsReady` refs without being listed here.\nconst shareSignals = makeShareSignals<SimpleHlsAudioOnlyEngineState, SimpleHlsAudioOnlyEngineContext>([\n  'userAudioTrackSelection',\n]);\n\n/**\n * Create an audio-only HLS playback engine.\n *\n * Subtractive composition variant of `createSimpleHlsEngine`: 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: SimpleHlsAudioOnlyEngineSignals;\n * const engine = createHlsAudioOnlyEngine({\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 createHlsAudioOnlyEngine(\n  config: SimpleHlsAudioOnlyEngineConfig = {}\n): Composition<SimpleHlsAudioOnlyEngineState, SimpleHlsAudioOnlyEngineContext> {\n  const finalConfig = {\n    ...config,\n    canPlayTrack: config.canPlayTrack ?? canPlayTrack,\n    resolveDuration: config.resolveDuration ?? getResolvedSelectedTrackDuration,\n    parsePresentation: config.parsePresentation ?? parseMultivariantPlaylist,\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      // 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      setupAudioBufferActors,\n\n      // Playback tracking\n      trackCurrentTime,\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\n      // Adapter signal callback.\n      shareSignals,\n    ],\n    {\n      config: finalConfig,\n    }\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAmIA,MAAM,eAAe,iBAAiF,CACpG,0BACD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCF,SAAgB,yBACd,SAAyC,EAAE,EACkC;CAC7E,MAAM,cAAc;EAClB,GAAG;EACH,cAAc,OAAO,gBAAgB;EACrC,iBAAiB,OAAO,mBAAmB;EAC3C,mBAAmB,OAAO,qBAAqB;EAChD;AAED,QAAO,kBACL;EACE;EACA;EACA;EAWA;EAKA;EAKA;EAGA;EAGA;EAIA;EACA;EACA;EAGA;EAGA;EAMA;EAGA;EACD,EACD,EACE,QAAQ,aACT,CACF"}
+{"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"}

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

@@ -1,17 +1,16 @@
+import { MaybeResolvedPresentation } from "../../../media/types/index.js";
 import { Composition, ContextSignals, StateSignals } from "../../../core/composition/create-composition.js";
 import { ShareSignalsConfig } from "../../../core/composition/share-signals.js";
-import { MaybeResolvedPresentation } from "../../../media/types/index.js";
 import { SourceBufferActor } from "../../actors/dom/source-buffer.js";
 import { SegmentLoaderActor } from "../../actors/dom/segment-loader.js";
-import { TrackPicker } from "../../../media/primitives/select-tracks.js";
 import { ParsePresentation } from "../../behaviors/resolve-presentation.js";
+import { TrackPicker } from "../../../media/primitives/select-tracks.js";
 import { SelectVideoTrackConfig } from "../../behaviors/select-tracks.js";
-
-//#region src/playback/engines/background-video/engine.d.ts
+//#region src/playback/engines/hls/engine-background-video.d.ts
 /**
  * State shape for the background-video playback engine.
  *
- * Narrower than `SimpleHlsEngineState`: audio/text track slots are absent
+ * 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
@@ -51,7 +50,7 @@ type BackgroundVideoEngineSignals = {
  *
  * Each option is consumed by the appropriate behavior — the engine itself
  * has no config beyond what its behaviors read. Compared to
- * `SimpleHlsEngineConfig`, audio/text/ABR/bandwidth/quality knobs are
+ * `HlsVideoEngineConfig`, audio/text/ABR/bandwidth/quality knobs are
  * dropped: the variant subtracts the behaviors that read them.
  */
 interface BackgroundVideoEngineConfig extends ShareSignalsConfig<BackgroundVideoEngineState, BackgroundVideoEngineContext> {
@@ -61,7 +60,7 @@ interface BackgroundVideoEngineConfig extends ShareSignalsConfig<BackgroundVideo
    * presentation resolve and pins it for the session. Override for
    * mobile-aware or content-aware caps.
    *
-   * Adapters (e.g. `BackgroundVideoMediaElement`) install their own
+   * Adapters (e.g. `HlsBackgroundVideoMediaElement`) install their own
    * picker; this default applies when the engine is constructed directly.
    */
   picker?: TrackPicker<SelectVideoTrackConfig>;
@@ -84,7 +83,7 @@ interface BackgroundVideoEngineConfig extends ShareSignalsConfig<BackgroundVideo
  * surfaces that should start loading the moment a src is set.
  *
  * Native `loop` / `muted` / `autoplay` are adapter concerns and live on
- * `BackgroundVideoMediaElement` rather than the engine.
+ * `HlsBackgroundVideoMediaElement` rather than the engine.
  *
  * @example
  * ```ts
@@ -104,4 +103,4 @@ interface BackgroundVideoEngineConfig extends ShareSignalsConfig<BackgroundVideo
 declare function createBackgroundVideoEngine(config?: BackgroundVideoEngineConfig): Composition<BackgroundVideoEngineState, BackgroundVideoEngineContext>;
 //#endregion
 export { BackgroundVideoEngineConfig, BackgroundVideoEngineContext, BackgroundVideoEngineSignals, BackgroundVideoEngineState, createBackgroundVideoEngine };
-//# sourceMappingURL=engine.d.ts.map
+//# sourceMappingURL=engine-background-video.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine-background-video.d.ts","names":[],"sources":["../../../../../src/playback/engines/hls/engine-background-video.ts"],"mappings":";;;;;;;;;;;;;;;;;;UAqCiB;;;;;EAKf,eAAe;EACf;EACA;EACA;;;;;UAMe;EACf,eAAe;EACf,cAAc;EACd,mBAAmB;EACnB,0BAA0B;;;;;;;;KAShB;EACV,OAAO,aAAa;EACpB,SAAS,eAAe;;;;;;;;;;UAWT,oCACP,mBAAmB,4BAA4B;;;;;;;;;;EAUvD,SAAS,YAAY;;;;;EAKrB,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuCN,4BACd,SAAQ,8BACP,YAAY,4BAA4B"}

package/dist/{default/playback/engines/background-video/engine.js → dev/playback/engines/hls/engine-background-video.js}

@@ -13,7 +13,7 @@ import { resolvePresentation } from "../../behaviors/resolve-presentation.js";
 import { resolveVideoTrack } from "../../behaviors/resolve-track.js";
 import { pickHighestResolutionVideoTrack } from "../../../media/primitives/select-tracks.js";
 import { selectVideoTrack } from "../../behaviors/select-tracks.js";
-//#region src/playback/engines/background-video/engine.ts
+//#region src/playback/engines/hls/engine-background-video.ts
 const shareSignals = makeShareSignals();
 /**
 * Create a background-video playback engine.
@@ -28,7 +28,7 @@ const shareSignals = makeShareSignals();
 * surfaces that should start loading the moment a src is set.
 *
 * Native `loop` / `muted` / `autoplay` are adapter concerns and live on
-* `BackgroundVideoMediaElement` rather than the engine.
+* `HlsBackgroundVideoMediaElement` rather than the engine.
 *
 * @example
 * ```ts
@@ -72,4 +72,4 @@ function createBackgroundVideoEngine(config = {}) {
 //#endregion
 export { createBackgroundVideoEngine };
 
-//# sourceMappingURL=engine.js.map
+//# sourceMappingURL=engine-background-video.js.map

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

@@ -0,0 +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 { parseMultivariantPlaylist } from '../../../media/hls/parse-multivariant';\nimport { pickHighestResolutionVideoTrack, type TrackPicker } from '../../../media/primitives/select-tracks';\nimport type { 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 { 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 { updateMediaSourceDuration } from '../../behaviors/dom/update-mediasource-duration';\nimport { type ParsePresentation, resolvePresentation } from '../../behaviors/resolve-presentation';\nimport { resolveVideoTrack } from '../../behaviors/resolve-track';\nimport { type SelectVideoTrackConfig, selectVideoTrack } from '../../behaviors/select-tracks';\n\n// ============================================================================\n// Background-video engine state & context\n// ============================================================================\n\n/**\n * State shape for the background-video playback engine.\n *\n * 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 */\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\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   * Track picker handed to `selectVideoTrack`. Default:\n   * `pickHighestResolutionVideoTrack` — picks the highest-resolution variant on\n   * presentation resolve and pins it for the session. Override for\n   * mobile-aware or content-aware caps.\n   *\n   * Adapters (e.g. `HlsBackgroundVideoMediaElement`) install their own\n   * picker; this default applies when the engine is constructed directly.\n   */\n  picker?: TrackPicker<SelectVideoTrackConfig>;\n  /**\n   * Manifest parser handed to `resolvePresentation`. Defaults to the HLS\n   * multivariant-playlist parser.\n   */\n  parsePresentation?: ParsePresentation;\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 * max-resolution picker 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 * 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    picker: config.picker ?? pickHighestResolutionVideoTrack,\n    parsePresentation: config.parsePresentation ?? parseMultivariantPlaylist,\n    resolveDuration: getResolvedSelectedTrackDuration,\n  };\n\n  return createComposition(\n    [\n      resolvePresentation,\n      // Presentation duration\n      calculatePresentationDuration,\n\n      // Track selection - pinned single-rendition pick on presentation resolve.\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      // 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":";;;;;;;;;;;;;;;;AAoGA,MAAM,eAAe,iBAA2E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgChG,SAAgB,4BACd,SAAsC,CAAC,GACgC;CACvE,MAAM,cAAc;EAClB,GAAG;EACH,QAAQ,OAAO,UAAU;EACzB,mBAAmB,OAAO,qBAAqB;EAC/C,iBAAiB;CACnB;CAEA,OAAO,kBACL;EACE;EAEA;EAGA;EAEA;EAEA;EAGA;EACA;EACA;EAGA;EAGA;EAKA;CACF,GACA;EACE,QAAQ;EACR,cAAc,EAEZ,eAAe,KACjB;CACF,CACF;AACF"}

package/dist/dev/playback/engines/hls/engine.d.ts

@@ -1,20 +1,26 @@
+import { AudioTrack, CanPlayTrack, MaybeResolvedPresentation, MediaContainerData, ResolvedTrack, TextTrack, VideoTrack } from "../../../media/types/index.js";
 import { Composition, ContextSignals, StateSignals } from "../../../core/composition/create-composition.js";
 import { ShareSignalsConfig } from "../../../core/composition/share-signals.js";
-import { AudioTrack, CanPlayTrack, MaybeResolvedPresentation, TextTrack, VideoTrack } from "../../../media/types/index.js";
+import { Reschedule } from "../../../core/tasks/task.js";
 import { BackBufferConfig } from "../../../media/buffer/back-buffer.js";
 import { ForwardBufferConfig } from "../../../media/buffer/forward-buffer.js";
 import { SourceBufferActor } from "../../actors/dom/source-buffer.js";
 import { SegmentLoaderActor } from "../../actors/dom/segment-loader.js";
+import { TextTrackSegmentResolver } from "../../primitives/text-segment-load-pipeline.js";
 import { TextTracksActor } from "../../actors/text-tracks.js";
-import { TextTrackSegmentLoaderActor, TextTrackSegmentResolver } from "../../actors/text-track-segment-loader.js";
+import { TextTrackSegmentLoaderActor } from "../../actors/text-track-segment-loader.js";
+import { SvtaError } from "../../../media/errors.js";
+import { GetCdnId } from "../../../media/utils/cdn.js";
+import { PresentationDurationResolver } from "../../behaviors/calculate-presentation-duration.js";
+import { DeriveStartMediaTime } from "../../primitives/derive-start-media-time.js";
+import "../../behaviors/establish-start-media-time.js";
 import { ParsePresentation } from "../../behaviors/resolve-presentation.js";
+import { FailoverMonitorConfig } from "../../behaviors/setup-failover-monitor.js";
+import { ReportUnsupportedTrackConditions } from "../../primitives/report-track-conditions.js";
 import { QualityConfig } from "../../../media/abr/quality-selection.js";
 import { addSubtitlesTracksToMedia, getShowingSubtitlesTrackFromMedia, removeAllSubtitlesTracksFromMedia } from "../../../media/dom/text/text-track-slots.js";
-import { GetCdnId } from "../../../media/utils/cdn.js";
 import { BandwidthConfig, BandwidthState } from "../../../network/bandwidth-estimator.js";
-import { PresentationDurationResolver } from "../../behaviors/calculate-presentation-duration.js";
-import { FailoverMonitorConfig } from "../../behaviors/setup-failover-monitor.js";
-
+import "../../actors/dom/text-tracks.js";
 //#region src/playback/engines/hls/engine.d.ts
 /**
  * State shape for the HLS playback engine.
@@ -23,7 +29,7 @@ import { FailoverMonitorConfig } from "../../behaviors/setup-failover-monitor.js
  * the HLS engine. Each behavior declares its own state interface; this
  * type satisfies all of them.
  */
-interface SimpleHlsEngineState {
+interface HlsVideoEngineState {
   /**
    * The presentation being played. A caller writes `{ url }`;
    * `resolvePresentation` parses the manifest and populates the rest.
@@ -34,6 +40,7 @@ interface SimpleHlsEngineState {
   selectedAudioTrackId?: string;
   selectedTextTrackId?: string;
   bandwidthState?: BandwidthState;
+  mediaContainerData?: Record<string, MediaContainerData>;
   userVideoTrackSelection?: Partial<VideoTrack>;
   /**
    * Consumer-driven constraint narrowing the audio candidate set. Sibling
@@ -69,15 +76,49 @@ interface SimpleHlsEngineState {
    * means all CDNs are eligible.
    */
   failedCdns?: string[];
+  /**
+   * Conditions reported during playback, in the order encountered — appended by
+   * whichever behavior detects one (`emitError`), owned and cleared per source by
+   * `collectErrors`. Carries no severity: which of these is fatal is decided
+   * above the engine, at the adapter. See
+   * `internal/design/spf/features/errors.md`.
+   */
+  errors?: SvtaError[];
   currentTime?: number;
   loadActivated?: boolean;
+  /**
+   * One-shot command: start the current source at this position
+   * (presentation-timeline seconds). Written by consumers or by
+   * `setupAirPlay`'s session-end snapshot; consumed (cleared) by
+   * `applyStartPosition` once the element seeks. See
+   * `behaviors/dom/apply-start-position.ts`.
+   */
+  startPosition?: number;
+  /**
+   * Intent-level loading policy: initiate no new loading work while `true`.
+   * Written by `setupAirPlay` (the only behavior declaring the key) while a
+   * remote-playback session owns presentation; observed by the
+   * `loadXSegments` dispatchers (park in `'dormant'`) and by
+   * `setupMediaSource` (a pending rebuild waits). See
+   * `SegmentLoadingState['loadingSuspended']`.
+   */
+  loadingSuspended?: boolean;
+  /**
+   * Author intent for the AirPlay/remote-playback picker, written by the media
+   * adapter's `disableRemotePlayback` IDL property. `true` is an explicit
+   * opt-out: `setupAirPlay` reads it at attach and sets nothing up, leaving the
+   * element's remote playback disabled. Distinct from the underlying
+   * `<video>.disableRemotePlayback`, which stays programmatically managed
+   * (ManagedMediaSource / AirPlay).
+   */
+  disableRemotePlayback?: boolean;
 }
 /**
  * Context shape for the HLS playback engine.
  *
  * Platform objects and actor references managed by HLS behaviors.
  */
-interface SimpleHlsEngineContext {
+interface HlsVideoEngineContext {
   mediaElement?: HTMLMediaElement | undefined;
   mediaSource?: MediaSource;
   videoBufferActor?: SourceBufferActor;
@@ -93,9 +134,9 @@ interface SimpleHlsEngineContext {
  * state (reads) without touching `composition.state` / `composition.context`
  * directly.
  */
-type SimpleHlsEngineSignals = {
-  state: StateSignals<SimpleHlsEngineState>;
-  context: ContextSignals<SimpleHlsEngineContext>;
+type HlsVideoEngineSignals = {
+  state: StateSignals<HlsVideoEngineState>;
+  context: ContextSignals<HlsVideoEngineContext>;
 };
 /**
  * Configuration for the HLS playback engine.
@@ -103,7 +144,7 @@ type SimpleHlsEngineSignals = {
  * Each option is consumed by the appropriate behavior — the engine itself
  * has no config beyond what its behaviors read.
  */
-interface SimpleHlsEngineConfig extends ShareSignalsConfig<SimpleHlsEngineState, SimpleHlsEngineContext> {
+interface HlsVideoEngineConfig extends ShareSignalsConfig<HlsVideoEngineState, HlsVideoEngineContext> {
   /**
    * Bandwidth estimate in bps to use before enough samples have been
    * collected. Default: `DEFAULT_INITIAL_BANDWIDTH` (5 Mbps).
@@ -117,6 +158,14 @@ interface SimpleHlsEngineConfig extends ShareSignalsConfig<SimpleHlsEngineState,
    * codec).
    */
   canPlayTrack?: CanPlayTrack;
+  /**
+   * Conditions reported about each rendition as it resolves — the *causes* behind
+   * a later verdict, and the copy a verdict reuses when they agree. Defaults to
+   * {@link reportUnsupportedTrackConditions}, which reports non-fMP4 containers
+   * and encryption; supply your own to report a different set (a provider that
+   * never ships MPEG-TS can drop that check) or `() => []` to report nothing.
+   */
+  reportUnsupportedTrackConditions?: ReportUnsupportedTrackConditions;
   preferredAudioLanguage?: string;
   preferredSubtitleLanguage?: string;
   includeForcedTracks?: boolean;
@@ -203,6 +252,31 @@ interface SimpleHlsEngineConfig extends ShareSignalsConfig<SimpleHlsEngineState,
    * key on something else (e.g. Mux's `cdn=` query param).
    */
   getCdnId?: GetCdnId;
+  /**
+   * Non-zero-PTS relocation (spike): the reduce seam consumed by the
+   * `establishStartMediaTime` reactor. Defaults to per-track own origin (Tier 1);
+   * a Tier-2 variant returns the shared `min` across selected A/V. Relocation is
+   * composed into the standard engine below — see the marked block — so this only
+   * needs setting to swap the tier policy. See
+   * `internal/design/spf/presentation-timeline-model.md`.
+   */
+  deriveStartMediaTime?: DeriveStartMediaTime;
+  /**
+   * Proximity window (seconds) for the `recoverEndStall` behavior — how close the
+   * playhead must be to the reachable buffered end for a `waiting` to be treated as the
+   * end-of-stream freeze and nudged to `ended`. Defaults to `0.2`. See
+   * `behaviors/dom/recover-end-stall`.
+   */
+  endStallNudgeWindow?: number;
+  /**
+   * Live media-playlist re-run policy for the resolve* loaders' `RecurringRunner`:
+   * returns a promise that resolves when the playlist should reload, or `null` to
+   * stop. Defaults to `mediaPlaylistReloadDelay` (target-duration cadence, half on
+   * an unchanged window, stop on `#EXT-X-ENDLIST`) composed with a cancellable
+   * `sleep`. Inert for VoD (a complete playlist stops it after the first resolve).
+   * Override to tune live reload timing.
+   */
+  reschedule?: Reschedule<ResolvedTrack>;
 }
 /**
  * Create an HLS playback engine.
@@ -213,8 +287,8 @@ interface SimpleHlsEngineConfig extends ShareSignalsConfig<SimpleHlsEngineState,
  *
  * @example
  * ```ts
- * let signals: SimpleHlsEngineSignals;
- * const engine = createSimpleHlsEngine({
+ * let signals: HlsVideoEngineSignals;
+ * const engine = createHlsVideoEngine({
  *   initialBandwidth: 2_000_000,
  *   preferredAudioLanguage: 'en',
  *   onSignalsReady: (refs) => {
@@ -230,7 +304,7 @@ interface SimpleHlsEngineConfig extends ShareSignalsConfig<SimpleHlsEngineState,
  * await engine.destroy();
  * ```
  */
-declare function createSimpleHlsEngine(config?: SimpleHlsEngineConfig): Composition<SimpleHlsEngineState, SimpleHlsEngineContext>;
+declare function createHlsVideoEngine(config?: HlsVideoEngineConfig): Composition<HlsVideoEngineState, HlsVideoEngineContext>;
 //#endregion
-export { SimpleHlsEngineConfig, SimpleHlsEngineContext, SimpleHlsEngineSignals, SimpleHlsEngineState, createSimpleHlsEngine };
+export { HlsVideoEngineConfig, HlsVideoEngineContext, HlsVideoEngineSignals, HlsVideoEngineState, createHlsVideoEngine };
 //# sourceMappingURL=engine.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","names":[],"sources":["../../../../../src/playback/engines/hls/engine.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAyDA;;;;UAAiB,oBAAA;EAWmB;;;;EANlC,YAAA,GAAe,yBAAA;EACf,OAAA;EACA,oBAAA;EACA,oBAAA;EACA,mBAAA;EACA,cAAA,GAAiB,cAAA;EACjB,uBAAA,GAA0B,OAAA,CAAQ,UAAA;EAJlC;;;;;;EAWA,uBAAA,GAA0B,OAAA,CAAQ,UAAA;EAPA;;;;;;;;EAgBlC,sBAAA,GAAyB,OAAA,CAAQ,SAAA;EAmBjC;;;;AASF;;;;;EAlBE,WAAA;EAsBmB;;;;;;;EAdnB,UAAA;EACA,WAAA;EACA,aAAA;AAAA;;;;;;UAQe,sBAAA;EACf,YAAA,GAAe,gBAAA;EACf,WAAA,GAAc,WAAA;EACd,gBAAA,GAAmB,iBAAA;EACnB,gBAAA,GAAmB,iBAAA;EACnB,uBAAA,GAA0B,kBAAA;EAC1B,uBAAA,GAA0B,kBAAA;EAC1B,eAAA,GAAkB,eAAA;EAClB,2BAAA,GAA8B,2BAAA;AAAA;;;;;;;KASpB,sBAAA;EACV,KAAA,EAAO,YAAA,CAAa,oBAAA;EACpB,OAAA,EAAS,cAAA,CAAe,sBAAA;AAAA;;;;;;;UAST,qBAAA,SAA8B,kBAAA,CAAmB,oBAAA,EAAsB,sBAAA;EAAjD;;;;EAKrC,gBAAA;EAkBmD;;;;;;;EAVnD,YAAA,GAAe,YAAA;EACf,sBAAA;EACA,yBAAA;EACA,mBAAA;EACA,kBAAA;EA6DY;;;;;EAvDZ,uBAAA,GAA0B,wBAAA,CAAyB,MAAA;EAvBN;;;;;;;;EAgC7C,eAAA,GAAkB,4BAAA;EAlBlB;;;;;EAwBA,iBAAA,GAAoB,iBAAA;EAf+B;;;;;EAqBnD,yBAAA,UAAmC,yBAAA;EAAA;;;;;EAMnC,iCAAA,UAA2C,iCAAA;EAc3B;;;;;EARhB,iCAAA,UAA2C,iCAAA;EAsB/B;;;;;;;EAdZ,aAAA,GAAgB,OAAA,CAAQ,mBAAA;EAmCxB;;;;AAgDF;;EA5EE,UAAA,GAAa,OAAA,CAAQ,gBAAA;EA6Eb;;;;;;EAtER,SAAA,GAAY,OAAA,CAAQ,eAAA;EAsEpB;;;;;EAhEA,OAAA,GAAU,OAAA,CAAQ,aAAA;;;;;;;EAOlB,QAAA,GAAW,OAAA,CAAQ,qBAAA;;;;;;;;EAQnB,QAAA,GAAW,QAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgDG,qBAAA,CACd,MAAA,GAAQ,qBAAA,GACP,WAAA,CAAY,oBAAA,EAAsB,sBAAA"}
+{"version":3,"file":"engine.d.ts","names":[],"sources":["../../../../../src/playback/engines/hls/engine.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA4FiB;;;;;EAKf,eAAe;EACf;EACA;EACA;EACA;EACA,iBAAiB;EAGjB,qBAAqB,eAAe;EACpC,0BAA0B,QAAQ;;;;;;;EAOlC,0BAA0B,QAAQ;;;;;;;;;EASlC,yBAAyB,QAAQ;;;;;;;;;;EAUjC;;;;;;;;EAQA;;;;;;;;EAQA,SAAS;EACT;EACA;;;;;;;;EAQA;;;;;;;;;EASA;;;;;;;;;EASA;;;;;;;UAQe;EACf,eAAe;EACf,cAAc;EACd,mBAAmB;EACnB,mBAAmB;EACnB,0BAA0B;EAC1B,0BAA0B;EAC1B,kBAAkB;EAClB,8BAA8B;;;;;;;;KASpB;EACV,OAAO,aAAa;EACpB,SAAS,eAAe;;;;;;;;UAST,6BAA6B,mBAAmB,qBAAqB;;;;;EAKpF;;;;;;;;EAQA,eAAe;;;;;;;;EAQf,mCAAmC;EACnC;EACA;EACA;EACA;;;;;;EAMA,0BAA0B,yBAAyB;;;;;;;;;EASnD,kBAAkB;;;;;;EAMlB,oBAAoB;;;;;;EAMpB,mCAAmC;;;;;;EAMnC,2CAA2C;;;;;;EAM3C,2CAA2C;;;;;;;;EAQ3C,gBAAgB,QAAQ;;;;;;;EAOxB,aAAa,QAAQ;;;;;;;EAOrB,YAAY,QAAQ;;;;;;EAMpB,UAAU,QAAQ;;;;;;;EAOlB,WAAW,QAAQ;;;;;;;;EAQnB,WAAW;;;;;;;;;EASX,uBAAuB;;;;;;;EAOvB;;;;;;;;;EASA,aAAa,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiDV,qBACd,SAAQ,uBACP,YAAY,qBAAqB"}

package/dist/dev/playback/engines/hls/engine.js

@@ -5,15 +5,25 @@ import { loadAudioSegments, loadTextTrackSegments, loadVideoSegments } from "../
 import { setupTextTrackActors } from "../../behaviors/dom/setup-text-track-actors.js";
 import { trackCurrentTime } from "../../behaviors/dom/track-current-time.js";
 import { trackLoadTriggers } from "../../behaviors/dom/track-load-triggers.js";
+import { deriveSharedMinStartMediaTime, establishStartMediaTime, gateFirstParseOnAnchor } from "../../behaviors/establish-start-media-time.js";
+import { delayedReschedule } from "../../../core/tasks/delayed-reschedule.js";
+import { attachMediaSourceAsSourceElement } from "../../../media/dom/mse/mediasource-setup.js";
 import { canPlayTrack } from "../../../media/dom/capabilities.js";
 import { addSubtitlesTracksToMedia, getShowingSubtitlesTrackFromMedia, removeAllSubtitlesTracksFromMedia } from "../../../media/dom/text/text-track-slots.js";
 import { parseMultivariantPlaylist } from "../../../media/hls/parse-multivariant.js";
+import { mediaPlaylistReloadDelay, resolveLiveLatency } from "../../../media/hls/reload-policy.js";
 import { getResolvedSelectedTrackDuration } from "../../../media/utils/track-selection.js";
 import { calculatePresentationDuration } from "../../behaviors/calculate-presentation-duration.js";
+import { collectErrors } from "../../behaviors/collect-errors.js";
 import { deriveCdnPriority } from "../../behaviors/derive-cdn-priority.js";
+import { setupAirPlay } from "../../behaviors/dom/airplay.js";
+import { applyStartPosition } from "../../behaviors/dom/apply-start-position.js";
 import { endOfStream } from "../../behaviors/dom/end-of-stream.js";
+import { recoverEndStall } from "../../behaviors/dom/recover-end-stall.js";
+import { seekToLiveEdge } from "../../behaviors/dom/seek-to-live-edge.js";
 import { setupAudioBufferActors, setupVideoBufferActors } from "../../behaviors/dom/setup-buffer-actors.js";
 import { setupMediaSource } from "../../behaviors/dom/setup-mediasource.js";
+import { syncLiveSeekableRange } from "../../behaviors/dom/sync-live-seekable-range.js";
 import { syncTextTracks } from "../../behaviors/dom/sync-text-tracks.js";
 import { updateMediaSourceDuration } from "../../behaviors/dom/update-mediasource-duration.js";
 import { resolvePresentation } from "../../behaviors/resolve-presentation.js";
@@ -21,6 +31,8 @@ import { resolveAudioTrack, resolveTextTrack, resolveVideoTrack } from "../../be
 import { setupFailoverMonitor } from "../../behaviors/setup-failover-monitor.js";
 import { syncPreload } from "../../behaviors/sync-preload.js";
 import { switchAudioTrack, switchTextTrack, switchVideoTrack } from "../../behaviors/track-switching.js";
+import { relocatingTextPipelines, relocationPipelinesFor } from "../../primitives/relocation-pipelines.js";
+import { reportUnsupportedTrackConditions } from "../../primitives/report-track-conditions.js";
 //#region src/playback/engines/hls/engine.ts
 /**
 * Generic `shareSignals` instantiated against the HLS engine's full state
@@ -34,7 +46,8 @@ import { switchAudioTrack, switchTextTrack, switchVideoTrack } from "../../behav
 const shareSignals = makeShareSignals([
 	"userVideoTrackSelection",
 	"userAudioTrackSelection",
-	"userTextTrackSelection"
+	"userTextTrackSelection",
+	"disableRemotePlayback"
 ]);
 /**
 * Create an HLS playback engine.
@@ -45,8 +58,8 @@ const shareSignals = makeShareSignals([
 *
 * @example
 * ```ts
-* let signals: SimpleHlsEngineSignals;
-* const engine = createSimpleHlsEngine({
+* let signals: HlsVideoEngineSignals;
+* const engine = createHlsVideoEngine({
 *   initialBandwidth: 2_000_000,
 *   preferredAudioLanguage: 'en',
 *   onSignalsReady: (refs) => {
@@ -62,16 +75,26 @@ const shareSignals = makeShareSignals([
 * await engine.destroy();
 * ```
 */
-function createSimpleHlsEngine(config = {}) {
+function createHlsVideoEngine(config = {}) {
+	const deriveStartMediaTime = config.deriveStartMediaTime ?? deriveSharedMinStartMediaTime;
 	const finalConfig = {
 		...config,
+		deriveStartMediaTime,
+		attachMediaSource: attachMediaSourceAsSourceElement,
 		canPlayTrack: config.canPlayTrack ?? canPlayTrack,
+		reportUnsupportedTrackConditions: config.reportUnsupportedTrackConditions ?? reportUnsupportedTrackConditions,
 		resolveTextTrackSegment: config.resolveTextTrackSegment ?? resolveVttSegment,
+		textMessagePipelines: relocatingTextPipelines,
 		resolveDuration: config.resolveDuration ?? getResolvedSelectedTrackDuration,
 		parsePresentation: config.parsePresentation ?? parseMultivariantPlaylist,
 		addSubtitlesTracksToMedia: config.addSubtitlesTracksToMedia ?? addSubtitlesTracksToMedia,
 		getShowingSubtitlesTrackFromMedia: config.getShowingSubtitlesTrackFromMedia ?? getShowingSubtitlesTrackFromMedia,
-		removeAllSubtitlesTracksFromMedia: config.removeAllSubtitlesTracksFromMedia ?? removeAllSubtitlesTracksFromMedia
+		removeAllSubtitlesTracksFromMedia: config.removeAllSubtitlesTracksFromMedia ?? removeAllSubtitlesTracksFromMedia,
+		videoMessagePipelines: relocationPipelinesFor("video", deriveStartMediaTime),
+		audioMessagePipelines: relocationPipelinesFor("audio", deriveStartMediaTime),
+		gateFirstParse: gateFirstParseOnAnchor,
+		resolveLiveLatency,
+		reschedule: config.reschedule ?? delayedReschedule(mediaPlaylistReloadDelay)
 	};
 	return createComposition([
 		syncPreload,
@@ -79,21 +102,28 @@ function createSimpleHlsEngine(config = {}) {
 		resolvePresentation,
 		deriveCdnPriority,
 		setupFailoverMonitor,
+		collectErrors,
 		resolveVideoTrack,
 		resolveAudioTrack,
 		resolveTextTrack,
 		calculatePresentationDuration,
 		setupMediaSource,
 		updateMediaSourceDuration,
+		establishStartMediaTime,
 		setupVideoBufferActors,
 		setupAudioBufferActors,
+		setupAirPlay,
 		trackCurrentTime,
+		applyStartPosition,
 		switchVideoTrack,
 		switchAudioTrack,
 		switchTextTrack,
 		loadVideoSegments,
 		loadAudioSegments,
+		syncLiveSeekableRange,
+		seekToLiveEdge,
 		endOfStream,
+		recoverEndStall,
 		syncTextTracks,
 		setupTextTrackActors,
 		loadTextTrackSegments,
@@ -110,6 +140,6 @@ function createSimpleHlsEngine(config = {}) {
 	});
 }
 //#endregion
-export { createSimpleHlsEngine };
+export { createHlsVideoEngine };
 
 //# sourceMappingURL=engine.js.map