@videojs/spf 10.0.0-beta.9 → 10.0.0-rc.2

package/dist/default/playback/behaviors/track-switching.js

@@ -0,0 +1,407 @@
+import { computed, peek } from "../../core/signals/primitives.js";
+import { defineBehavior } from "../../core/composition/create-composition.js";
+import { createMachineReactor } from "../../core/reactors/create-machine-reactor.js";
+import { isResolvedPresentation } from "../../media/types/index.js";
+import { getCodecFamilies, getTracksByType } from "../../media/utils/tracks.js";
+import { SVTA_NO_SUPPORTED_AUDIO_TRACK, SVTA_NO_SUPPORTED_VIDEO_TRACK } from "../../media/errors.js";
+import { matchesPartialTrack, pickTextTrackFromTracks, smallestCoveringPixelArea, tracksUnderPixelArea } from "../../media/primitives/select-tracks.js";
+import { applyConstraints, applyRules, excludeUnplayableTracks, preferCodecFamilies, sameCandidateSet } from "../primitives/selection-rules.js";
+import { DEFAULT_QUALITY_CONFIG, resolutionArea } from "../../media/abr/quality-selection.js";
+import { getCdnId } from "../../media/utils/cdn.js";
+import { DEFAULT_BANDWIDTH_CONFIG, getBandwidthEstimate } from "../../network/bandwidth-estimator.js";
+import { emitError } from "./collect-errors.js";
+//#region src/playback/behaviors/track-switching.ts
+/**
+* **Per-type track selection as a rule chain.** While a presentation is resolved, owns that type's
+* `selected{Video,Audio,Text}TrackId` signal: pick a default, react to user intent and algorithmic ranking, and clear
+* it on src unload.
+*
+* Selection runs in two stages. First a **hard-constraints pre-pass** (`applyConstraints`) prunes the unplayable from
+* the candidate set — the failed-CDN constraint (`excludeFailedCdns`, failover cooldown), the capability constraint
+* (`excludeUnplayableTracks`, codec support), and the codec-family sticky constraint (`stickToSelectedCodecs`, no
+* `SourceBuffer.changeType()` — see its note). Then a small ordered chain of rules (`applyRules`) picks among the
+* survivors. Each constraint/rule reads the signals it needs at apply time, so the effect subscribes to exactly what
+* was consulted. The chain runs most authoritative first:
+*
+* 1. **user intent** — a soft filter on `user*TrackSelection`: narrow to the partial-track match; an empty match falls
+*    through to the full set.
+* 2. **codec-family preference** — a soft filter on `preferredCodecs` (`preferCodecFamilies`, default AVC/AAC): on a
+*    mixed-codec source, narrow which family the _initial_ pick — the one the sticky constraint then holds — lands in.
+*    Behind user intent so an explicit initial pick may land anywhere; inert once the constraint narrows to a
+*    non-preferred family.
+* 3. **active CDN** — a soft filter on `cdnPriority` (`preferActiveCdn`): narrow to the highest-priority CDN that still
+*    has tracks; an empty match falls through. Shared by video and audio, so every type stays on one CDN
+*    (`deriveCdnPriority` owns the list). No-op for non-redundant sources.
+* 4. **player resolution** — a soft filter on `playerResolution` (`playerResolutionCap`, video only): narrow to the
+*    smallest rendition tier covering the player element, plus everything below it. No-op without a measurement. Ahead
+*    of the ranker but behind the CDN scope, so the cap chooses _within_ a host rather than between hosts.
+* 5. **ranking** — the terminal sort: `rankByBandwidth`, shared by video and audio. Fitting tracks (within the throughput
+*    threshold) first, highest bitrate first; over-throughput tracks after, least-over first. Hysteresis via boosting
+*    the current track's sort weight by `upgradeMargin`.
+*
+* The composer's early-bail (one survivor → stop) is load-bearing: a user selection that narrows to a single track is
+* the pick without the ranker running, so the bandwidth estimate is never read and the effect doesn't re-fire on
+* bandwidth while that choice holds.
+*
+* Lifecycle: `'presentation-unresolved'` ↔ `'presentation-resolved'`. The resolved state owns the signal; its
+* entry-returned cleanup clears it on exit (canonical cleanup-binds-to-setup per `reactors.md`).
+*
+* The pick is the chain's result mapped to a slot value by `resolveSelection` (default: the head,
+* `applyRules(...)[0]`). Each variant supplies its **constraints + rule chain (+ optional resolveSelection)** via
+* config; `setupTrackSwitching` owns only the lifecycle and runs what it's given. Video and audio run constraints
+* `[excludeFailedCdns, excludeUnplayableTracks, stickToSelectedCodecs]` then rules `[filterByUserSelection,
+* preferCodecFamilies, preferActiveCdn, rankByBandwidth]` and take the head; video inserts `playerResolutionCap` after
+* the active-CDN scope, and `switchVideoTrack` also accepts ABR tuning config, `switchAudioTrack` takes none.
+* `switchTextTrack` differs — selection is _optional_ (captions are opt-in / off-able), so it runs
+* `[excludeFailedCdns]` + `[preferActiveCdn]` and supplies a text terminal (`pickResolvedTextTrack`) that resolves
+* standing user intent (`userTextTrackSelection`, incl. `'off'`) and may yield no selection. (The active-CDN _scope_ is
+* the sticky-pick half of multi-CDN; the failed-CDN _constraint_ is the failover half — prune the cooled-down CDN, the
+* scope falls to the next.)
+*
+* When the pre-pass prunes a type that _has_ tracks to empty, the behavior clears the selection (so a now-unplayable
+* pick can't linger and stall) and reports the type's `noSupportedTrackCode`. Which constraint emptied the set is
+* deliberately not consulted — the behavior reads no constraint's state, so the chain stays composable. A type with no
+* tracks at all is left alone; that's a legitimate source shape, not a failure. The late `createSourceBuffer` check
+* stays as the structural backstop.
+*
+* Deferred: audio's preferred-language / default-track selection as standing soft-filter rules (previously the
+* empty-slot picker, dropped in the move to the rule chain).
+*/
+/** Default initial-bandwidth value before bandwidth measurements arrive. */
+const DEFAULT_INITIAL_BANDWIDTH = 5e6;
+/**
+* User intent — a soft filter. Narrows to tracks matching the partial-track selection in `user*TrackSelection`; an
+* empty match falls through (the composer skips it) to the unfiltered set — e.g. a stale id from a previous source.
+*/
+function filterByUserSelection(tracks, { state, config }) {
+	const key = config.userSelectionKey;
+	if (!key) return tracks;
+	const filter = state[key]?.get();
+	return filter ? tracks.filter((track) => matchesPartialTrack(track, filter)) : tracks;
+}
+/**
+* Player-resolution cap — a soft filter, video only. Narrows to the renditions worth delivering at the player element's
+* rendered size, so a small embed doesn't pull segments nobody can perceive. The tighter sibling of
+* `screenResolutionCap`: the element's box, not the screen behind it.
+*
+* The cap is the _smallest tier that still covers the player_, and everything at or below it survives — not "everything
+* at or below the player's area," which under-serves a player falling between two tiers. Take an 800×450 player against
+* a 360p/720p/1080p ladder: only 360p is below it, so capping at the player's area would hold an 800-px-wide box to a
+* 640-px-wide picture. The honest answer is the tier above, 720p, with 360p left in for the ranker.
+* `smallestCoveringPixelArea` picks that cap; `tracksUnderPixelArea` — the same filter `screenResolutionCap` narrows
+* with — applies it.
+*
+* Renditions declaring no width or height compare as area `0` and are never capped out — they can't be judged against
+* the player, and dropping them could strand a source whose renditions all omit it.
+*
+* Runs _after_ `preferActiveCdn`, so it narrows within the host already chosen. Ahead of it, a cap that pruned every
+* rendition of the preferred CDN would leave the scope to fall to the next one with survivors — a size preference
+* silently moving playback to another host. Redundant streams normally mirror the same ladder, which makes that a
+* nonstandard-but-legal mismatch across CDNs rather than an everyday case; the ordering costs nothing either way.
+*
+* Reading `state.playerResolution` through its signal is what subscribes the chain to resizes; `undefined` — no signal
+* composed, or nothing to measure — means "don't cap" rather than a cap of zero, so the chain proceeds unnarrowed.
+*/
+function playerResolutionCap(tracks, { state }) {
+	const playerResolution = state.playerResolution?.get();
+	if (!playerResolution) return tracks;
+	const cap = smallestCoveringPixelArea(tracks, playerResolution.width * playerResolution.height);
+	return tracksUnderPixelArea(tracks, cap);
+}
+/**
+* Failed-CDN constraint — a _hard_ filter (constraints pre-pass), shared by video and audio. Removes tracks served from
+* a CDN currently in failover cooldown (`failedCdns`, written by the failover monitor). Removed tracks are never
+* attempted; the scope then narrows to the next surviving CDN in `cdnPriority`, and snaps back to the primary once it
+* leaves cooldown.
+*
+* Passes everything through when there's no `failedCdns` signal/value. When it prunes _every_ track (all CDNs cooled
+* down), the empty result is preserved (per `applyConstraints`) — "nothing playable," which clears the selection (no
+* pick); a later CDN recovery refills the candidate set and re-picks.
+*/
+function excludeFailedCdns(tracks, { state, config }) {
+	const failed = state.failedCdns?.get();
+	if (!failed?.length) return tracks;
+	const getCdnId$1 = config.getCdnId ?? getCdnId;
+	const failedSet = new Set(failed);
+	return tracks.filter((track) => !failedSet.has(getCdnId$1(track.url)));
+}
+/**
+* Active-CDN scope — a soft filter, shared by video and audio. Narrows to the highest-priority CDN in `cdnPriority`
+* (owned by `deriveCdnPriority`) that still has tracks, so every track type stays on one CDN. A redundant-streams
+* source lists the same renditions on multiple hosts; this keeps the pick on one host rather than letting the ranker
+* drift across them.
+*
+* "Active" is derived, not stored: constraints run before the rule chain, so a failed CDN's tracks are already pruned
+* by the time this runs — "first CDN with survivors" _is_ the active CDN, and it falls through to the next on failover
+* (and snaps back to the primary when it recovers). Content steering reorders `cdnPriority`; this rule just honors the
+* order.
+*
+* Soft-filter semantics: passes through when there's no `cdnPriority` signal/value (no preference) or when nothing
+* matches (`applyRules` skips an empty result). Non-redundant sources have one CDN, so the narrow is a no-op.
+*
+* The CDN-id derivation defaults to origin-based `getCdnId`, overridable via the `getCdnId` config — it must match the
+* one `deriveCdnPriority` used to build `cdnPriority`, or no track's CDN would ever equal an entry.
+*/
+function preferActiveCdn(tracks, { state, config }) {
+	const cdnPriority = state.cdnPriority?.get();
+	if (!cdnPriority?.length) return tracks;
+	const getCdnId$2 = config.getCdnId ?? getCdnId;
+	for (const cdn of cdnPriority) {
+		const tracksUsingCdn = tracks.filter((track) => getCdnId$2(track.url) === cdn);
+		if (tracksUsingCdn.length) return tracksUsingCdn;
+	}
+	return tracks;
+}
+/**
+* Codec-family sticky constraint — a _hard_ filter for the constraints pre-pass, shared by video and audio, and the
+* reason the re-evaluating variants can run ABR over a mixed-codec source at all: SPF implements no
+* `SourceBuffer.changeType()`, so once segments of the selected track's codec families are what a buffer was created
+* for, a pick outside them could never play — constraint semantics ("can't play here"), not preference. Removes the
+* candidates whose codec-family set doesn't _equal_ the selected track's (set-equality so a muxed `hvc1,mp4a` rendition
+* can't pass as a match for `avc1,mp4a` on its audio half). Purely relational: the lock _is_ the current selection's
+* families, no state of its own. Pruned pre-pass, a cross-family user selection mid-stream never reaches the user
+* filter, which falls through unhonored instead of killing playback. Before any selection exists (the initial pick) it
+* removes nothing, which is what leaves the initial family choice to the rule chain (user intent, then
+* `preferCodecFamilies`).
+*
+* The selected track's families come from the _presentation's_ track list, not the already-pruned candidates: a CDN
+* entering cooldown may prune the current track itself while same-family renditions survive on another host, and the
+* lock must carry over to them. Removes nothing when: no selection yet, a selection the presentation no longer carries,
+* or a selected track without codecs (then no candidate's compatibility is decidable — same inertness as
+* `preferCodecFamilies` on a codec-less ladder).
+*
+* When the selected family genuinely vanishes from the playable set, the pre-pass empties: the behavior reports the
+* type's no-supported-track code and clears the selection — an explicable stop instead of a cross-family append
+* surfacing as an opaque decode error. Clearing also releases the lock (it keys on the live selection), so a following
+* pick may land in the surviving family on freshly-created buffer actors; whether the append layer survives that
+* rebuild is the changeType gap, out of this constraint's hands. If `changeType` support ever lands, this constraint is
+* what relaxes.
+*
+* Reading the selection here — a slot the picking effect itself writes, from inside the candidate-set computed — is
+* safe only because the effect scheduler revalidates an effect's sources after each run; see `core/signals/effect.ts`
+* (`revalidateSources`) for the lost-wakeup it prevents.
+*
+* Composed only into the re-evaluating `switch*` variants: the pinned `selectVideoTrack` (background compositions)
+* evaluates once and never re-picks, so it's immune by construction.
+*/
+function stickToSelectedCodecs(tracks, { state, config }) {
+	const currentId = state[config.selectionKey].get();
+	if (!currentId) return tracks;
+	const presentation = state.presentation.get();
+	if (!isResolvedPresentation(presentation)) return tracks;
+	const current = config.getTracks(presentation).find((track) => track.id === currentId);
+	const families = current && getCodecFamilies(current);
+	if (!families) return tracks;
+	return tracks.filter((track) => {
+		const candidateFamilies = getCodecFamilies(track);
+		return !!candidateFamilies && candidateFamilies.length === families.length && candidateFamilies.every((family) => families.includes(family));
+	});
+}
+/**
+* Bandwidth ranking — the terminal sort, shared by video and audio. Orders by the throughput estimate: tracks within
+* the bandwidth threshold first (fitting), highest bitrate first; then over-threshold tracks, least-over first. The
+* head is the best-quality track that fits, falling back to the smallest over-throughput track when nothing fits.
+*
+* Hysteresis without temporal state: the current track's effective bitrate is boosted by `upgradeMargin` in the fitting
+* sort, so a higher track only outranks it once it clears `current.bitrate * upgradeMargin` (no flapping on marginal
+* bandwidth gains). Downgrades fall out for free — a current track over the threshold isn't in the fitting set to be
+* boosted, so the best fit (a downgrade) wins immediately. Equal-bitrate tracks break by resolution (higher `width ×
+* height` first), so an equal-bitrate ladder never picks a lower- quality rendition by manifest order; audio tracks
+* carry no dimensions, so they area-compare equal and a stable sort keeps their candidate order (e.g. same-bitrate
+* language variants). Early-bail skips this rule when a prior one narrowed to a single track, so the estimate is
+* neither read nor subscribed while that holds.
+*/
+function rankByBandwidth(tracks, { state, config }) {
+	const safetyMargin = config.quality?.safetyMargin ?? DEFAULT_QUALITY_CONFIG.safetyMargin;
+	const upgradeMargin = config.quality?.upgradeMargin ?? DEFAULT_QUALITY_CONFIG.upgradeMargin;
+	const initialBandwidth = config.initialBandwidth ?? 5e6;
+	const bandwidthConfig = {
+		...DEFAULT_BANDWIDTH_CONFIG,
+		...config.bandwidth
+	};
+	if (!state.bandwidthState) console.debug("[track-switching] rankByBandwidth: no bandwidthState signal in composition; ranking on initialBandwidth");
+	const threshold = getBandwidthEstimate(state.bandwidthState?.get(), initialBandwidth, bandwidthConfig) * safetyMargin;
+	const currentId = state[config.selectionKey].get();
+	const bitrate = (track) => track.bandwidth ?? 0;
+	const rank = (track) => track.id === currentId ? bitrate(track) * upgradeMargin : bitrate(track);
+	const fitting = tracks.filter((track) => bitrate(track) <= threshold).sort((a, b) => rank(b) - rank(a) || resolutionArea(b) - resolutionArea(a));
+	const over = tracks.filter((track) => bitrate(track) > threshold).sort((a, b) => bitrate(a) - bitrate(b) || resolutionArea(b) - resolutionArea(a));
+	return [...fitting, ...over];
+}
+/**
+* Default final pick: the chain head. `applyRules` never narrows to nothing and early-bails to a single survivor, so
+* video and audio always converge to a track and the head is the pick.
+*/
+function selectChainHead(candidates) {
+	return candidates[0].id;
+}
+/**
+* Terminal pick for text — the `resolveSelection` the text variant supplies. Resolves the standing
+* `userTextTrackSelection` intent against the chain's survivors (already CDN-failover-pruned and active-CDN-scoped):
+*
+* - `'off'` → no selection (clear the slot). Sticky through re-evaluation, so a live refresh or failover re-run can't
+*   re-assert a default.
+* - Explicit `Partial<TextTrack>` → narrow to the match (language-based). A stale pick whose match is gone (e.g. the
+*   language dropped on a source change) falls through to the default policy.
+* - Auto (`undefined`) → the opt-in default policy (`preferredSubtitleLanguage` → `DEFAULT=YES + AUTOSELECT=YES` → none),
+*   via `pickTextTrackFromTracks`.
+*
+* Returning `undefined` is a real outcome (captions are opt-in), which is why the text variant relies on
+* `setupTrackSwitching`'s no-selection seam.
+*/
+function pickResolvedTextTrack(candidates, { state, config }) {
+	const intent = state.userTextTrackSelection?.get();
+	if (intent === "off") return void 0;
+	if (intent) {
+		const matched = candidates.filter((track) => matchesPartialTrack(track, intent));
+		if (matched.length) return matched[0].id;
+	}
+	return pickTextTrackFromTracks(candidates, config);
+}
+function setupTrackSwitching(deps) {
+	const { state, config } = deps;
+	const { selectionKey, getTracks, rules, resolveSelection = selectChainHead, noSupportedTrackCode } = config;
+	const derivedStateSignal = computed(() => isResolvedPresentation(state.presentation.get()) ? "presentation-resolved" : "presentation-unresolved");
+	const candidateSet = computed(() => {
+		const presentation = state.presentation.get();
+		if (!isResolvedPresentation(presentation)) return [];
+		return applyConstraints(config.constraints ?? [], getTracks(presentation), deps);
+	}, { equals: sameCandidateSet });
+	return createMachineReactor({
+		initial: "presentation-unresolved",
+		monitor: () => derivedStateSignal.get(),
+		states: {
+			"presentation-unresolved": {},
+			"presentation-resolved": {
+				entry: () => () => state[selectionKey].set(void 0),
+				effects: [() => {
+					const tracks = candidateSet.get();
+					if (!tracks.length) {
+						const presentation = peek(state.presentation);
+						if (isResolvedPresentation(presentation) && getTracks(presentation).length > 0) {
+							if (noSupportedTrackCode !== void 0) emitError(state, {
+								code: noSupportedTrackCode,
+								data: { selectionKey }
+							});
+							state[selectionKey].set(void 0);
+						}
+						return;
+					}
+					const candidates = applyRules(rules, tracks, deps);
+					if (!candidates.length) {
+						console.error("[track-switching] applyRules returned no candidates");
+						return;
+					}
+					state[selectionKey].set(resolveSelection(candidates, deps));
+				}]
+			}
+		}
+	});
+}
+/**
+* Manage `selectedVideoTrackId`: pick a default on src load, dynamically adjust based on bandwidth, clear on src
+* unload. Honors `userVideoTrackSelection` as a partial-track constraint on candidates; short-circuits ABR when the
+* constraint narrows to a single track.
+*
+* @example
+*   const reactor = switchVideoTrack.setup({ state });
+*/
+const switchVideoTrack = defineBehavior({
+	stateKeys: ["presentation", "selectedVideoTrackId"],
+	contextKeys: [],
+	setup: ({ state, config, ...otherProps }) => setupTrackSwitching({
+		...otherProps,
+		state,
+		config: {
+			...config,
+			selectionKey: "selectedVideoTrackId",
+			userSelectionKey: "userVideoTrackSelection",
+			getTracks: (presentation) => getTracksByType(presentation, "video"),
+			constraints: [
+				excludeFailedCdns,
+				excludeUnplayableTracks,
+				stickToSelectedCodecs
+			],
+			rules: [
+				filterByUserSelection,
+				preferCodecFamilies,
+				preferActiveCdn,
+				playerResolutionCap,
+				rankByBandwidth
+			],
+			noSupportedTrackCode: SVTA_NO_SUPPORTED_VIDEO_TRACK
+		}
+	})
+});
+/**
+* Manage `selectedAudioTrackId`: pick a default on src load, narrow by `userAudioTrackSelection` filter, re-pick on
+* filter change, clear on src unload.
+*
+* Mid-stream flush on language switch is handled by the segment-loader's `planTasks` (see
+* `playback/actors/dom/segment-loader.ts`) — not this behavior. Same split as the video pipeline: slot owner writes;
+* loader orchestrates segment + flush plans.
+*
+* @example
+*   const reactor = switchAudioTrack.setup({ state });
+*/
+const switchAudioTrack = defineBehavior({
+	stateKeys: ["presentation", "selectedAudioTrackId"],
+	contextKeys: [],
+	setup: ({ state, config, ...otherProps }) => setupTrackSwitching({
+		...otherProps,
+		state,
+		config: {
+			...config,
+			selectionKey: "selectedAudioTrackId",
+			userSelectionKey: "userAudioTrackSelection",
+			getTracks: (presentation) => getTracksByType(presentation, "audio"),
+			constraints: [
+				excludeFailedCdns,
+				excludeUnplayableTracks,
+				stickToSelectedCodecs
+			],
+			rules: [
+				filterByUserSelection,
+				preferCodecFamilies,
+				preferActiveCdn,
+				rankByBandwidth
+			],
+			noSupportedTrackCode: SVTA_NO_SUPPORTED_AUDIO_TRACK
+		}
+	})
+});
+/**
+* Manage `selectedTextTrackId` as the single-writer **output** of standing user intent (`userTextTrackSelection`)
+* resolved against the playable, CDN-scoped text renditions: clear on src unload; re-resolve when a CDN fails or
+* recovers.
+*
+* Unlike video/audio, the selection is _optional_ — captions are opt-in and the user can turn them off — so the chain
+* skips the bandwidth ranker and the shared user-selection filter, and supplies a text-specific terminal
+* (`pickResolvedTextTrack`) that may resolve to no-selection via `setupTrackSwitching`'s `resolveSelection` seam.
+* Constraints are failed-CDN only (`excludeUnplayableTracks`/`canPlayTrack` is MSE-based — the wrong probe for text,
+* whose playability is SPF-parser support); the active-CDN scope co-locates captions with the surviving CDN on
+* failover.
+*
+* @example
+*   const reactor = switchTextTrack.setup({ state, config: { preferredSubtitleLanguage: 'en' } });
+*/
+const switchTextTrack = defineBehavior({
+	stateKeys: ["presentation", "selectedTextTrackId"],
+	contextKeys: [],
+	setup: ({ state, config, ...otherProps }) => setupTrackSwitching({
+		...otherProps,
+		state,
+		config: {
+			...config,
+			selectionKey: "selectedTextTrackId",
+			getTracks: (presentation) => getTracksByType(presentation, "text"),
+			constraints: [excludeFailedCdns],
+			rules: [preferActiveCdn],
+			resolveSelection: pickResolvedTextTrack
+		}
+	})
+});
+//#endregion
+export { DEFAULT_INITIAL_BANDWIDTH, setupTrackSwitching, stickToSelectedCodecs, switchAudioTrack, switchTextTrack, switchVideoTrack };
+
+//# sourceMappingURL=track-switching.js.map

package/dist/default/playback/behaviors/track-switching.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track-switching.js","names":["getCdnId","defaultGetCdnId"],"sources":["../../../../src/playback/behaviors/track-switching.ts"],"sourcesContent":["/**\n * **Per-type track selection as a rule chain.** While a presentation is resolved, owns that type's\n * `selected{Video,Audio,Text}TrackId` signal: pick a default, react to user intent and algorithmic ranking, and clear\n * it on src unload.\n *\n * Selection runs in two stages. First a **hard-constraints pre-pass** (`applyConstraints`) prunes the unplayable from\n * the candidate set — the failed-CDN constraint (`excludeFailedCdns`, failover cooldown), the capability constraint\n * (`excludeUnplayableTracks`, codec support), and the codec-family sticky constraint (`stickToSelectedCodecs`, no\n * `SourceBuffer.changeType()` — see its note). Then a small ordered chain of rules (`applyRules`) picks among the\n * survivors. Each constraint/rule reads the signals it needs at apply time, so the effect subscribes to exactly what\n * was consulted. The chain runs most authoritative first:\n *\n * 1. **user intent** — a soft filter on `user*TrackSelection`: narrow to the partial-track match; an empty match falls\n *    through to the full set.\n * 2. **codec-family preference** — a soft filter on `preferredCodecs` (`preferCodecFamilies`, default AVC/AAC): on a\n *    mixed-codec source, narrow which family the _initial_ pick — the one the sticky constraint then holds — lands in.\n *    Behind user intent so an explicit initial pick may land anywhere; inert once the constraint narrows to a\n *    non-preferred family.\n * 3. **active CDN** — a soft filter on `cdnPriority` (`preferActiveCdn`): narrow to the highest-priority CDN that still\n *    has tracks; an empty match falls through. Shared by video and audio, so every type stays on one CDN\n *    (`deriveCdnPriority` owns the list). No-op for non-redundant sources.\n * 4. **player resolution** — a soft filter on `playerResolution` (`playerResolutionCap`, video only): narrow to the\n *    smallest rendition tier covering the player element, plus everything below it. No-op without a measurement. Ahead\n *    of the ranker but behind the CDN scope, so the cap chooses _within_ a host rather than between hosts.\n * 5. **ranking** — the terminal sort: `rankByBandwidth`, shared by video and audio. Fitting tracks (within the throughput\n *    threshold) first, highest bitrate first; over-throughput tracks after, least-over first. Hysteresis via boosting\n *    the current track's sort weight by `upgradeMargin`.\n *\n * The composer's early-bail (one survivor → stop) is load-bearing: a user selection that narrows to a single track is\n * the pick without the ranker running, so the bandwidth estimate is never read and the effect doesn't re-fire on\n * bandwidth while that choice holds.\n *\n * Lifecycle: `'presentation-unresolved'` ↔ `'presentation-resolved'`. The resolved state owns the signal; its\n * entry-returned cleanup clears it on exit (canonical cleanup-binds-to-setup per `reactors.md`).\n *\n * The pick is the chain's result mapped to a slot value by `resolveSelection` (default: the head,\n * `applyRules(...)[0]`). Each variant supplies its **constraints + rule chain (+ optional resolveSelection)** via\n * config; `setupTrackSwitching` owns only the lifecycle and runs what it's given. Video and audio run constraints\n * `[excludeFailedCdns, excludeUnplayableTracks, stickToSelectedCodecs]` then rules `[filterByUserSelection,\n * preferCodecFamilies, preferActiveCdn, rankByBandwidth]` and take the head; video inserts `playerResolutionCap` after\n * the active-CDN scope, and `switchVideoTrack` also accepts ABR tuning config, `switchAudioTrack` takes none.\n * `switchTextTrack` differs — selection is _optional_ (captions are opt-in / off-able), so it runs\n * `[excludeFailedCdns]` + `[preferActiveCdn]` and supplies a text terminal (`pickResolvedTextTrack`) that resolves\n * standing user intent (`userTextTrackSelection`, incl. `'off'`) and may yield no selection. (The active-CDN _scope_ is\n * the sticky-pick half of multi-CDN; the failed-CDN _constraint_ is the failover half — prune the cooled-down CDN, the\n * scope falls to the next.)\n *\n * When the pre-pass prunes a type that _has_ tracks to empty, the behavior clears the selection (so a now-unplayable\n * pick can't linger and stall) and reports the type's `noSupportedTrackCode`. Which constraint emptied the set is\n * deliberately not consulted — the behavior reads no constraint's state, so the chain stays composable. A type with no\n * tracks at all is left alone; that's a legitimate source shape, not a failure. The late `createSourceBuffer` check\n * stays as the structural backstop.\n *\n * Deferred: audio's preferred-language / default-track selection as standing soft-filter rules (previously the\n * empty-slot picker, dropped in the move to the rule chain).\n */\n\nimport { type AnySlotMap, defineBehavior } from '../../core/composition/create-composition';\nimport { createMachineReactor } from '../../core/reactors/create-machine-reactor';\nimport { computed, peek, type ReadonlySignal, type Signal } from '../../core/signals/primitives';\nimport { DEFAULT_QUALITY_CONFIG, type QualityConfig, resolutionArea } from '../../media/abr/quality-selection';\nimport { SVTA_NO_SUPPORTED_AUDIO_TRACK, SVTA_NO_SUPPORTED_VIDEO_TRACK } from '../../media/errors';\nimport type { Resolution } from '../../media/primitives/resolution';\nimport {\n  matchesPartialTrack,\n  pickTextTrackFromTracks,\n  smallestCoveringPixelArea,\n  type TextSelectionConfig,\n  tracksUnderPixelArea,\n} from '../../media/primitives/select-tracks';\nimport {\n  type AudioTrack,\n  type CanPlayTrack,\n  isResolvedPresentation,\n  type MaybeResolvedPresentation,\n  type PartiallyResolvedAudioTrack,\n  type PartiallyResolvedTextTrack,\n  type PartiallyResolvedVideoTrack,\n  type TextTrack,\n  type VideoTrack,\n} from '../../media/types';\nimport { getCdnId as defaultGetCdnId, type GetCdnId } from '../../media/utils/cdn';\nimport { getCodecFamilies, getTracksByType } from '../../media/utils/tracks';\nimport type { BandwidthConfig, BandwidthState } from '../../network/bandwidth-estimator';\nimport { DEFAULT_BANDWIDTH_CONFIG, getBandwidthEstimate } from '../../network/bandwidth-estimator';\nimport type { SelectionRule, SelectionRuleDeps } from '../primitives/selection-rules';\nimport {\n  applyConstraints,\n  applyRules,\n  excludeUnplayableTracks,\n  preferCodecFamilies,\n  sameCandidateSet,\n} from '../primitives/selection-rules';\nimport { type ErrorEmitterState, emitError } from './collect-errors';\n\n// ============================================================================\n// State + Config\n// ============================================================================\n\n/**\n * The slots `setupTrackSwitching` itself owns: the `presentation` gate it reads and the per-type `selected*TrackId` it\n * writes. Rule-only inputs are deliberately absent — `user*TrackSelection` and `bandwidthState` belong to whoever\n * materializes them (the embedder via `shareSignals`, the buffer-actor sampler), and each rule declares the signal it\n * consults as an optional slot on its own deps map, so the behavior never assumes a rule's signal exists.\n */\nexport interface TrackSwitchingState {\n  presentation?: MaybeResolvedPresentation;\n  selectedVideoTrackId?: string;\n  selectedAudioTrackId?: string;\n  selectedTextTrackId?: string;\n}\n\n/**\n * Config for `switchVideoTrack` — the ABR tuning read by its ranker rule (`rankByBandwidth`). `quality.safetyMargin` is\n * the bandwidth-headroom multiplier; `quality.upgradeMargin` the hysteresis ratio gating upgrades; `bandwidth` tunes\n * the estimator; `initialBandwidth` is the pre-sample fallback. Defaults: `DEFAULT_QUALITY_CONFIG` (0.85 / 1.15),\n * `DEFAULT_BANDWIDTH_CONFIG`, `DEFAULT_INITIAL_BANDWIDTH` (5 Mbps).\n */\nexport interface SwitchVideoTrackConfig {\n  quality?: Partial<QualityConfig>;\n  bandwidth?: Partial<BandwidthConfig>;\n  initialBandwidth?: number;\n  /** Override CDN-id derivation (shared by the CDN scope + failover constraint). */\n  getCdnId?: GetCdnId;\n  /**\n   * Codec capability probe read by the `excludeUnplayableTracks` hard constraint — drops renditions this environment\n   * can't decode before selection runs. Injected (rather than imported) so the DOM-free behavior never reaches a DOM\n   * API directly; the engine defaults it to the `MediaSource.isTypeSupported`-backed `canPlayTrack`. Absent → no codec\n   * filtering (the constraint passes everything through).\n   */\n  canPlayTrack?: CanPlayTrack;\n  /**\n   * Codec families (RFC 6381 4CCs, e.g. `'avc1'` / `'hvc1'` / `'mp4a'`) the initial pick prefers on a mixed-codec\n   * source, read by the `preferCodecFamilies` scope. With no `SourceBuffer.changeType()`, the initial family is the one\n   * `stickToSelectedCodecs` holds for the source's lifetime, so this decides which family that is. Cross-cutting like\n   * `getCdnId` — one list serves video and audio (each type's rule matches only the families its tracks carry).\n   * Defaults to `DEFAULT_PREFERRED_CODECS` (AVC + AAC); pass `[]` to disable.\n   */\n  preferredCodecs?: string[];\n}\n\n/** Default initial-bandwidth value before bandwidth measurements arrive. */\nexport const DEFAULT_INITIAL_BANDWIDTH = 5_000_000;\n\n// ============================================================================\n// Rule chain\n// ============================================================================\n\n// Re-exported so a consumer typing against this module's rules doesn't need a\n// second import; the definitions live in `../primitives/selection-rules` so the\n// simple `selectVideoTrack` variant can share them without pulling the ABR path\n// in with them. See that module's note.\nexport type { CodecPreferenceConfig, SelectionRule, SelectionRuleDeps } from '../primitives/selection-rules';\nexport {\n  applyConstraints,\n  applyRules,\n  DEFAULT_PREFERRED_CODECS,\n  excludeUnplayableTracks,\n  preferCodecFamilies,\n} from '../primitives/selection-rules';\n\n// ============================================================================\n// Specialization helper\n//\n// `setupTrackSwitching` has the same shape as a Behavior `setup` function:\n// `({ state, config }) => Reactor`. Each `switchXTrack` export below calls\n// it from inside its own `defineBehavior` setup. Its generics — `S` (selection\n// slot key), `T` (candidate track type), `C` (the concrete config the variant\n// builds) — all infer from the passed `state` + `config`, so the variants need\n// no explicit type arguments. `C extends TrackSwitchingConfig<S, T>` lets the\n// variant's richer config (rule-specific fields included) flow through the\n// helper untouched; the rules read those fields off their own config views.\n//\n// -- Design note: why narrow `SelectionKey` / `UserSelectionKey` unions ----\n// Goal we did not reach: have callers \"fully pass in\" the slot keys, with\n// the helper enforcing zero internal knowledge of which literals are valid.\n// What blocks it: indexing a mapped-type intersection by a generic key.\n// When `S extends keyof TrackSwitchingState` (or `string`), TS conservatively\n// treats `state[selectionKey]` as the union of every possible match across\n// the intersected mapped portions — including the fixed-key signal\n// (`presentation`) — and widens to their value-type union.\n// The sibling pattern hits the same constraint and answers it the same way:\n// `SelectedTrackKey` in `select-tracks.ts` is a hardcoded narrow union for\n// the same reason.\n//\n// Current pick is the narrow-union route because it matches siblings and\n// the unions read as documentation (\"these are the slots this helper\n// manages\") rather than restriction. Extending to a new track-switching\n// axis is one literal per union.\n// --------------------------------------------------------------------------\n// ============================================================================\n\n/**\n * Minimum candidate-track shape consumed by the helper and its rules: an `id` (the pick), a `url` (the active-CDN scope\n * derives the CDN from it), an optional `bandwidth` (the ranker's throughput sort), and optional `width`/`height` (the\n * ranker's equal-bitrate tie-break — absent on audio, so audio candidates area-compare equal). Every\n * resolved/partially-resolved video track carries them all; audio tracks omit the dimensions.\n */\ntype SwitchableTrack = {\n  id: string;\n  url: string;\n  bandwidth?: number;\n  width?: number;\n  height?: number;\n  // Read by the capability constraint to probe codec support. Optional on the\n  // minimal shape; every resolved/partially-resolved video & audio candidate\n  // carries them, and an absent `mimeType` makes a track unprobeable (kept).\n  mimeType?: string;\n  codecs?: string[];\n};\n\n/**\n * Map the rule chain's surviving candidates to the final selection id, or `undefined` for a deliberate no-selection.\n * Defaults to the chain head (`selectChainHead`) — the always-pick contract video and audio rely on (`applyRules`\n * guarantees a non-empty result, so the head is always there). A variant whose selection is legitimately optional\n * (text: opt-in captions, explicit off) supplies its own picker that may return `undefined`; the helper writes that\n * straight through to the slot, clearing it.\n */\nexport type ResolveSelection<T extends SwitchableTrack, State = unknown, Context = unknown, Config = unknown> = (\n  candidates: readonly T[],\n  deps: SelectionRuleDeps<State, Context, Config>\n) => string | undefined;\n\ntype SelectionKey = 'selectedVideoTrackId' | 'selectedAudioTrackId' | 'selectedTextTrackId';\ntype UserSelectionKey = 'userVideoTrackSelection' | 'userAudioTrackSelection';\n\n// Each mapped value references `P` so TS keeps the per-key dependency and\n// resolves `state[selectionKey]` to the right arm. `T` (track type) stays out\n// of the state map (it flows through `TrackSwitchingConfig` instead).\n//\n// Only the behavior's own lifecycle signals are required here: the presentation\n// gate and the selection slot it writes. Signals a *rule* reads but the\n// behavior doesn't — `user*TrackSelection` (the user-selection filter) and\n// `bandwidthState` (the bandwidth ranker) — are NOT here; each rule declares\n// the signal it needs as *optional* on its own deps and reads it defensively,\n// so the behavior never assumes a rule-only signal exists. Those slots are\n// materialized by whoever owns them: `shareSignals` for the consumer-input\n// `user*TrackSelection`, the buffer-actor sampler for `bandwidthState`.\nexport type TrackSwitchingStateMap<S extends SelectionKey> = {\n  presentation: ReadonlySignal<TrackSwitchingState['presentation']>;\n} & { [P in S]: Signal<TrackSwitchingState[P]> };\n\n/**\n * The lifecycle map plus the _optional_ `errors` slot reporters append to. Owned by `collectErrors`; optional so a\n * composition without it still type-checks and emission no-ops. The behavior reads no constraint's state — see\n * `noSupportedTrackCode`.\n */\ntype TrackSwitchingReporterStateMap<S extends SelectionKey> = TrackSwitchingStateMap<S> & ErrorEmitterState;\n\n/**\n * Config `setupTrackSwitching` itself reads — its own wiring: which selection slot to write and clear (`selectionKey`),\n * how to enumerate candidate tracks (`getTracks`), the optional **hard-constraints pre-pass** (`constraints`, applied\n * before the chain to prune the unplayable), and the **rule chain** to run (`rules`), and how to map the chain's\n * survivors to the final pick (`resolveSelection`, defaulting to the chain head). Rule-/constraint-specific config is\n * deliberately absent — each declares the fields it reads as _optional_ on its own config view (`UserSelectionConfig`,\n * `BandwidthRankerConfig`), so the behavior never enumerates them. The variant builds the concrete config as this base\n * plus whatever its chain consults; it flows through untouched as the `C` type param on `setupTrackSwitching`.\n */\ninterface TrackSwitchingConfig<S extends SelectionKey, T extends SwitchableTrack> {\n  selectionKey: S;\n  getTracks: (presentation: MaybeResolvedPresentation) => readonly T[];\n  constraints?: readonly SelectionRule<T, TrackSwitchingStateMap<S>, AnySlotMap, TrackSwitchingConfig<S, T>>[];\n  rules: readonly SelectionRule<T, TrackSwitchingStateMap<S>, AnySlotMap, TrackSwitchingConfig<S, T>>[];\n  /**\n   * Map the chain's surviving candidates to the final selection id. Optional — absent means the chain head\n   * (`selectChainHead`), the always-pick path video and audio use. A variant with optional selection (text) supplies\n   * one that may return `undefined`.\n   */\n  resolveSelection?: ResolveSelection<T, TrackSwitchingStateMap<S>, AnySlotMap, TrackSwitchingConfig<S, T>>;\n  /**\n   * SVTA code to report when this type _has_ tracks but the constraints pruned every one. Per-variant because the\n   * condition isn't universally an error: video and audio supply {@link SVTA_NO_SUPPORTED_VIDEO_TRACK} /\n   * {@link SVTA_NO_SUPPORTED_AUDIO_TRACK}, while text supplies none — an unavailable subtitle track is a legitimate\n   * outcome, not a playback failure. Absent → the selection still clears, nothing is reported.\n   */\n  noSupportedTrackCode?: number;\n}\n\n/**\n * State the user-selection filter reads: the lifecycle map plus an _optional_ user-selection slot (keyed by `U`),\n * holding a partial-track description to match against the candidates (`Partial<T>` — `{ id }`, `{ language }`, `{\n * height }`, …). The slot exists only when the composition provides it (materialized by `shareSignals`); the filter\n * reads it defensively and no-ops when it's absent (no user override).\n */\ntype UserSelectionStateMap<\n  S extends SelectionKey,\n  U extends UserSelectionKey,\n  T extends SwitchableTrack,\n> = TrackSwitchingStateMap<S> & {\n  [P in U]?: ReadonlySignal<Partial<T> | undefined>;\n};\n\n/**\n * Config the user-selection filter reads: `userSelectionKey` names the state slot holding the user's selection.\n * _Optional_ on the rule's view — the base config doesn't carry it, so an unwired key means \"no user selection\" and the\n * filter passes through. The variants always supply it.\n */\ntype UserSelectionConfig<\n  S extends SelectionKey,\n  U extends UserSelectionKey,\n  T extends SwitchableTrack,\n> = TrackSwitchingConfig<S, T> & { userSelectionKey?: U };\n\n/**\n * State the bandwidth ranker reads: the lifecycle map plus an _optional_ `bandwidthState`. The signal exists only when\n * the composition includes a bandwidth sampler; the ranker reads it defensively and falls back to `initialBandwidth`\n * (with a debug note) when it's absent.\n */\ntype BandwidthRankerStateMap<S extends SelectionKey> = TrackSwitchingStateMap<S> & {\n  bandwidthState?: ReadonlySignal<BandwidthState | undefined>;\n};\n\n/**\n * Config the bandwidth ranker reads: the ABR tuning in `SwitchVideoTrackConfig` (`quality` / `bandwidth` /\n * `initialBandwidth`), all optional with defaults.\n */\ntype BandwidthRankerConfig<S extends SelectionKey, T extends SwitchableTrack> = TrackSwitchingConfig<S, T> &\n  SwitchVideoTrackConfig;\n\n/**\n * State the player-resolution cap reads: TrackSwitchingStateMap plus the _optional_ player measurement, manifested by\n * `trackPlayerResolution`.\n */\ntype PlayerResolutionCapStateMap<S extends SelectionKey> = TrackSwitchingStateMap<S> & {\n  playerResolution?: ReadonlySignal<Resolution | undefined>;\n};\n\n/**\n * State the active-CDN scope reads: the lifecycle map plus an _optional_ `cdnPriority` — the manifest-ordered CDN list\n * (most-preferred first). The signal exists only when the composition includes `deriveCdnPriority` (which materializes\n * + owns it); the scope reads it defensively and passes through when it's absent (no CDN preference).\n */\ntype CdnScopeStateMap<S extends SelectionKey> = TrackSwitchingStateMap<S> & {\n  cdnPriority?: ReadonlySignal<string[] | undefined>;\n};\n\n/**\n * State the failed-CDN constraint reads: the lifecycle map plus an _optional_ `failedCdns` — the CDN ids currently in\n * failover cooldown. The signal exists only when the composition includes a failover monitor (or an external driver);\n * the constraint reads it defensively and excludes nothing when it's absent.\n */\ntype CdnConstraintStateMap<S extends SelectionKey> = TrackSwitchingStateMap<S> & {\n  failedCdns?: ReadonlySignal<string[] | undefined>;\n};\n\n/**\n * Config the CDN rules read: the base config plus an _optional_ `getCdnId` override. Both `excludeFailedCdns` and\n * `preferActiveCdn` derive a track's CDN from its URL; the override must be the _same_ one `deriveCdnPriority` and the\n * failover trip use, or the keys stop matching. Optional → defaults to the origin-based `getCdnId`, so the base config\n * (without it) stays assignable.\n */\ntype CdnRuleConfig<S extends SelectionKey, T extends SwitchableTrack> = TrackSwitchingConfig<S, T> & {\n  getCdnId?: GetCdnId;\n};\n\ntype VideoTrackCandidate = PartiallyResolvedVideoTrack | VideoTrack;\ntype AudioTrackCandidate = PartiallyResolvedAudioTrack | AudioTrack;\ntype TextTrackCandidate = PartiallyResolvedTextTrack | TextTrack;\n\n// ----------------------------------------------------------------------------\n// Rules — defined outside the behavior closure, parameterized only by their\n// deps. Each is generic over the slot keys + track type; the variant's\n// concrete keys instantiate it where the chain is assembled.\n// ----------------------------------------------------------------------------\n\n/**\n * User intent — a soft filter. Narrows to tracks matching the partial-track selection in `user*TrackSelection`; an\n * empty match falls through (the composer skips it) to the unfiltered set — e.g. a stale id from a previous source.\n */\nfunction filterByUserSelection<S extends SelectionKey, U extends UserSelectionKey, T extends SwitchableTrack>(\n  tracks: readonly T[],\n  { state, config }: SelectionRuleDeps<UserSelectionStateMap<S, U, T>, AnySlotMap, UserSelectionConfig<S, U, T>>\n): readonly T[] {\n  const key = config.userSelectionKey;\n  if (!key) return tracks;\n\n  const filter = state[key]?.get();\n\n  return filter ? tracks.filter((track) => matchesPartialTrack(track, filter)) : tracks;\n}\n\n/**\n * Player-resolution cap — a soft filter, video only. Narrows to the renditions worth delivering at the player element's\n * rendered size, so a small embed doesn't pull segments nobody can perceive. The tighter sibling of\n * `screenResolutionCap`: the element's box, not the screen behind it.\n *\n * The cap is the _smallest tier that still covers the player_, and everything at or below it survives — not \"everything\n * at or below the player's area,\" which under-serves a player falling between two tiers. Take an 800×450 player against\n * a 360p/720p/1080p ladder: only 360p is below it, so capping at the player's area would hold an 800-px-wide box to a\n * 640-px-wide picture. The honest answer is the tier above, 720p, with 360p left in for the ranker.\n * `smallestCoveringPixelArea` picks that cap; `tracksUnderPixelArea` — the same filter `screenResolutionCap` narrows\n * with — applies it.\n *\n * Renditions declaring no width or height compare as area `0` and are never capped out — they can't be judged against\n * the player, and dropping them could strand a source whose renditions all omit it.\n *\n * Runs _after_ `preferActiveCdn`, so it narrows within the host already chosen. Ahead of it, a cap that pruned every\n * rendition of the preferred CDN would leave the scope to fall to the next one with survivors — a size preference\n * silently moving playback to another host. Redundant streams normally mirror the same ladder, which makes that a\n * nonstandard-but-legal mismatch across CDNs rather than an everyday case; the ordering costs nothing either way.\n *\n * Reading `state.playerResolution` through its signal is what subscribes the chain to resizes; `undefined` — no signal\n * composed, or nothing to measure — means \"don't cap\" rather than a cap of zero, so the chain proceeds unnarrowed.\n */\nfunction playerResolutionCap<S extends SelectionKey, T extends SwitchableTrack>(\n  tracks: readonly T[],\n  { state }: SelectionRuleDeps<PlayerResolutionCapStateMap<S>, AnySlotMap, TrackSwitchingConfig<S, T>>\n): readonly T[] {\n  const playerResolution = state.playerResolution?.get();\n  if (!playerResolution) return tracks;\n\n  // A player larger than every rendition has no covering tier, so the cap is\n  // `undefined` and the filter's unbounded default narrows nothing.\n  const cap = smallestCoveringPixelArea(tracks, playerResolution.width * playerResolution.height);\n\n  return tracksUnderPixelArea(tracks, cap);\n}\n\n/**\n * Failed-CDN constraint — a _hard_ filter (constraints pre-pass), shared by video and audio. Removes tracks served from\n * a CDN currently in failover cooldown (`failedCdns`, written by the failover monitor). Removed tracks are never\n * attempted; the scope then narrows to the next surviving CDN in `cdnPriority`, and snaps back to the primary once it\n * leaves cooldown.\n *\n * Passes everything through when there's no `failedCdns` signal/value. When it prunes _every_ track (all CDNs cooled\n * down), the empty result is preserved (per `applyConstraints`) — \"nothing playable,\" which clears the selection (no\n * pick); a later CDN recovery refills the candidate set and re-picks.\n */\nfunction excludeFailedCdns<S extends SelectionKey, T extends SwitchableTrack>(\n  tracks: readonly T[],\n  { state, config }: SelectionRuleDeps<CdnConstraintStateMap<S>, AnySlotMap, CdnRuleConfig<S, T>>\n): readonly T[] {\n  const failed = state.failedCdns?.get();\n  if (!failed?.length) return tracks;\n\n  const getCdnId = config.getCdnId ?? defaultGetCdnId;\n  const failedSet = new Set(failed);\n\n  return tracks.filter((track) => !failedSet.has(getCdnId(track.url)));\n}\n\n/**\n * Active-CDN scope — a soft filter, shared by video and audio. Narrows to the highest-priority CDN in `cdnPriority`\n * (owned by `deriveCdnPriority`) that still has tracks, so every track type stays on one CDN. A redundant-streams\n * source lists the same renditions on multiple hosts; this keeps the pick on one host rather than letting the ranker\n * drift across them.\n *\n * \"Active\" is derived, not stored: constraints run before the rule chain, so a failed CDN's tracks are already pruned\n * by the time this runs — \"first CDN with survivors\" _is_ the active CDN, and it falls through to the next on failover\n * (and snaps back to the primary when it recovers). Content steering reorders `cdnPriority`; this rule just honors the\n * order.\n *\n * Soft-filter semantics: passes through when there's no `cdnPriority` signal/value (no preference) or when nothing\n * matches (`applyRules` skips an empty result). Non-redundant sources have one CDN, so the narrow is a no-op.\n *\n * The CDN-id derivation defaults to origin-based `getCdnId`, overridable via the `getCdnId` config — it must match the\n * one `deriveCdnPriority` used to build `cdnPriority`, or no track's CDN would ever equal an entry.\n */\nfunction preferActiveCdn<S extends SelectionKey, T extends SwitchableTrack>(\n  tracks: readonly T[],\n  { state, config }: SelectionRuleDeps<CdnScopeStateMap<S>, AnySlotMap, CdnRuleConfig<S, T>>\n): readonly T[] {\n  const cdnPriority = state.cdnPriority?.get();\n  if (!cdnPriority?.length) return tracks;\n\n  const getCdnId = config.getCdnId ?? defaultGetCdnId;\n\n  for (const cdn of cdnPriority) {\n    const tracksUsingCdn = tracks.filter((track) => getCdnId(track.url) === cdn);\n    if (tracksUsingCdn.length) return tracksUsingCdn;\n  }\n\n  return tracks;\n}\n\n/**\n * Codec-family sticky constraint — a _hard_ filter for the constraints pre-pass, shared by video and audio, and the\n * reason the re-evaluating variants can run ABR over a mixed-codec source at all: SPF implements no\n * `SourceBuffer.changeType()`, so once segments of the selected track's codec families are what a buffer was created\n * for, a pick outside them could never play — constraint semantics (\"can't play here\"), not preference. Removes the\n * candidates whose codec-family set doesn't _equal_ the selected track's (set-equality so a muxed `hvc1,mp4a` rendition\n * can't pass as a match for `avc1,mp4a` on its audio half). Purely relational: the lock _is_ the current selection's\n * families, no state of its own. Pruned pre-pass, a cross-family user selection mid-stream never reaches the user\n * filter, which falls through unhonored instead of killing playback. Before any selection exists (the initial pick) it\n * removes nothing, which is what leaves the initial family choice to the rule chain (user intent, then\n * `preferCodecFamilies`).\n *\n * The selected track's families come from the _presentation's_ track list, not the already-pruned candidates: a CDN\n * entering cooldown may prune the current track itself while same-family renditions survive on another host, and the\n * lock must carry over to them. Removes nothing when: no selection yet, a selection the presentation no longer carries,\n * or a selected track without codecs (then no candidate's compatibility is decidable — same inertness as\n * `preferCodecFamilies` on a codec-less ladder).\n *\n * When the selected family genuinely vanishes from the playable set, the pre-pass empties: the behavior reports the\n * type's no-supported-track code and clears the selection — an explicable stop instead of a cross-family append\n * surfacing as an opaque decode error. Clearing also releases the lock (it keys on the live selection), so a following\n * pick may land in the surviving family on freshly-created buffer actors; whether the append layer survives that\n * rebuild is the changeType gap, out of this constraint's hands. If `changeType` support ever lands, this constraint is\n * what relaxes.\n *\n * Reading the selection here — a slot the picking effect itself writes, from inside the candidate-set computed — is\n * safe only because the effect scheduler revalidates an effect's sources after each run; see `core/signals/effect.ts`\n * (`revalidateSources`) for the lost-wakeup it prevents.\n *\n * Composed only into the re-evaluating `switch*` variants: the pinned `selectVideoTrack` (background compositions)\n * evaluates once and never re-picks, so it's immune by construction.\n */\nexport function stickToSelectedCodecs<S extends SelectionKey, T extends SwitchableTrack>(\n  tracks: readonly T[],\n  { state, config }: SelectionRuleDeps<TrackSwitchingStateMap<S>, AnySlotMap, TrackSwitchingConfig<S, T>>\n): readonly T[] {\n  const currentId = state[config.selectionKey].get();\n  if (!currentId) return tracks;\n\n  const presentation = state.presentation.get();\n  if (!isResolvedPresentation(presentation)) return tracks;\n\n  const current = config.getTracks(presentation).find((track) => track.id === currentId);\n  const families = current && getCodecFamilies(current);\n  if (!families) return tracks;\n\n  return tracks.filter((track) => {\n    const candidateFamilies = getCodecFamilies(track);\n\n    return (\n      !!candidateFamilies &&\n      candidateFamilies.length === families.length &&\n      candidateFamilies.every((family) => families.includes(family))\n    );\n  });\n}\n\n/**\n * Bandwidth ranking — the terminal sort, shared by video and audio. Orders by the throughput estimate: tracks within\n * the bandwidth threshold first (fitting), highest bitrate first; then over-threshold tracks, least-over first. The\n * head is the best-quality track that fits, falling back to the smallest over-throughput track when nothing fits.\n *\n * Hysteresis without temporal state: the current track's effective bitrate is boosted by `upgradeMargin` in the fitting\n * sort, so a higher track only outranks it once it clears `current.bitrate * upgradeMargin` (no flapping on marginal\n * bandwidth gains). Downgrades fall out for free — a current track over the threshold isn't in the fitting set to be\n * boosted, so the best fit (a downgrade) wins immediately. Equal-bitrate tracks break by resolution (higher `width ×\n * height` first), so an equal-bitrate ladder never picks a lower- quality rendition by manifest order; audio tracks\n * carry no dimensions, so they area-compare equal and a stable sort keeps their candidate order (e.g. same-bitrate\n * language variants). Early-bail skips this rule when a prior one narrowed to a single track, so the estimate is\n * neither read nor subscribed while that holds.\n */\nfunction rankByBandwidth<S extends SelectionKey, T extends SwitchableTrack>(\n  tracks: readonly T[],\n  { state, config }: SelectionRuleDeps<BandwidthRankerStateMap<S>, AnySlotMap, BandwidthRankerConfig<S, T>>\n): readonly T[] {\n  const safetyMargin = config.quality?.safetyMargin ?? DEFAULT_QUALITY_CONFIG.safetyMargin;\n  const upgradeMargin = config.quality?.upgradeMargin ?? DEFAULT_QUALITY_CONFIG.upgradeMargin;\n  const initialBandwidth = config.initialBandwidth ?? DEFAULT_INITIAL_BANDWIDTH;\n  const bandwidthConfig: BandwidthConfig = { ...DEFAULT_BANDWIDTH_CONFIG, ...config.bandwidth };\n\n  if (!state.bandwidthState) {\n    console.debug(\n      '[track-switching] rankByBandwidth: no bandwidthState signal in composition; ranking on initialBandwidth'\n    );\n  }\n\n  const threshold = getBandwidthEstimate(state.bandwidthState?.get(), initialBandwidth, bandwidthConfig) * safetyMargin;\n  const currentId = state[config.selectionKey].get();\n  const bitrate = (track: T) => track.bandwidth ?? 0;\n  // Boost the current track's sort weight by upgradeMargin (fitting set only) so\n  // an upgrade must clear current.bitrate * upgradeMargin to outrank it.\n  const rank = (track: T) => (track.id === currentId ? bitrate(track) * upgradeMargin : bitrate(track));\n  // Equal bitrate → prefer higher resolution (width × height), so an\n  // equal-bitrate ladder doesn't pick a lower-quality rendition by manifest\n  // order. Audio tracks carry no dimensions, so they area-compare equal and\n  // keep candidate order (stable sort).\n  const fitting = tracks\n    .filter((track) => bitrate(track) <= threshold)\n    .sort((a, b) => rank(b) - rank(a) || resolutionArea(b) - resolutionArea(a));\n  const over = tracks\n    .filter((track) => bitrate(track) > threshold)\n    .sort((a, b) => bitrate(a) - bitrate(b) || resolutionArea(b) - resolutionArea(a));\n\n  return [...fitting, ...over];\n}\n\n/**\n * Default final pick: the chain head. `applyRules` never narrows to nothing and early-bails to a single survivor, so\n * video and audio always converge to a track and the head is the pick.\n */\nfunction selectChainHead<T extends SwitchableTrack>(candidates: readonly T[]): string {\n  return candidates[0]!.id;\n}\n\n/**\n * State the text terminal reads: the lifecycle map plus an _optional_ `userTextTrackSelection` — the standing user\n * intent. `Partial<TextTrack>` is an explicit pick (language-based), `'off'` is explicit no-captions, `undefined` is\n * auto (no preference). The slot exists only when the composition materializes it (`shareSignals`); the terminal reads\n * it defensively and treats absence as auto.\n *\n * Unlike `user*TrackSelection` for video/audio, this carries the `'off'` sentinel and feeds the terminal pick (not the\n * shared `filterByUserSelection`) — text is the only type whose selection is legitimately optional, so the off/auto\n * logic lives in one text-specific place rather than widening the shared filter.\n */\ntype TextSelectionStateMap = TrackSwitchingStateMap<'selectedTextTrackId'> & {\n  userTextTrackSelection?: ReadonlySignal<Partial<TextTrack> | 'off' | undefined>;\n};\n\n/** Config the text terminal reads: the base config plus the opt-in default policy. */\ntype TextTerminalConfig = TrackSwitchingConfig<'selectedTextTrackId', TextTrackCandidate> & TextSelectionConfig;\n\n/**\n * Terminal pick for text — the `resolveSelection` the text variant supplies. Resolves the standing\n * `userTextTrackSelection` intent against the chain's survivors (already CDN-failover-pruned and active-CDN-scoped):\n *\n * - `'off'` → no selection (clear the slot). Sticky through re-evaluation, so a live refresh or failover re-run can't\n *   re-assert a default.\n * - Explicit `Partial<TextTrack>` → narrow to the match (language-based). A stale pick whose match is gone (e.g. the\n *   language dropped on a source change) falls through to the default policy.\n * - Auto (`undefined`) → the opt-in default policy (`preferredSubtitleLanguage` → `DEFAULT=YES + AUTOSELECT=YES` → none),\n *   via `pickTextTrackFromTracks`.\n *\n * Returning `undefined` is a real outcome (captions are opt-in), which is why the text variant relies on\n * `setupTrackSwitching`'s no-selection seam.\n */\nfunction pickResolvedTextTrack<T extends TextTrackCandidate>(\n  candidates: readonly T[],\n  { state, config }: SelectionRuleDeps<TextSelectionStateMap, AnySlotMap, TextTerminalConfig>\n): string | undefined {\n  const intent = state.userTextTrackSelection?.get();\n  if (intent === 'off') return undefined;\n\n  if (intent) {\n    // The stored intent is a `Partial<TextTrack>`; cast to the candidate's own\n    // partial shape so the generic `matchesPartialTrack` accepts it (every field\n    // it carries — language, forced — exists on the candidate too).\n    const matched = candidates.filter((track) => matchesPartialTrack(track, intent as Partial<T>));\n    if (matched.length) return matched[0]!.id;\n  }\n\n  return pickTextTrackFromTracks(candidates, config);\n}\n\n// `context` is the composition's context map, threaded in by each variant's\n// rest-spread and typed as the generic slot-map shape (`AnySlotMap`). It can't\n// be a typed param on the `defineBehavior` setup without widening `ContextMap`\n// to its constraint and forcing the slot required, so the variants forward it\n// untyped via the rest and it lands here — absent on direct setup calls, and\n// passed straight through to the rules (which don't read it yet).\nexport function setupTrackSwitching<\n  S extends SelectionKey,\n  T extends SwitchableTrack,\n  C extends TrackSwitchingConfig<S, T>,\n>(deps: { state: TrackSwitchingReporterStateMap<S>; context?: AnySlotMap; config: C }) {\n  const { state, config } = deps;\n  const { selectionKey, getTracks, rules, resolveSelection = selectChainHead, noSupportedTrackCode } = config;\n\n  const derivedStateSignal = computed(() =>\n    isResolvedPresentation(state.presentation.get())\n      ? ('presentation-resolved' as const)\n      : ('presentation-unresolved' as const)\n  );\n\n  // The playable candidate set — the tracks the rule chain gets to pick from,\n  // derived *outside* the reaction. The hard-constraints pre-pass (capability\n  // probing, CDN-failover cooldown) narrows the type's tracks before the chain\n  // runs. Because this is a `computed`, a constraint's own signal reads (e.g.\n  // `cdnHealth`) are tracked here, so when the playable set changes — a new\n  // source, or a *dynamic* constraint like a CDN entering cooldown — the effect\n  // re-picks. With no constraints configured this is just the type's tracks\n  // while a presentation is resolved.\n  //\n  // The `equals` gates notification on the *set of track ids*, not array\n  // identity: a live playlist refresh swaps in a new presentation object with\n  // the same variant tracks, and a constraint's inputs can churn without\n  // changing which tracks survive. In both cases the playable set is unchanged,\n  // so the reaction must not re-fire (the rule chain still re-runs on its own\n  // inputs — bandwidth, user selection). Same intent as `equalsById`, for the\n  // track list.\n  const candidateSet = computed<readonly T[]>(\n    () => {\n      const presentation = state.presentation.get();\n      if (!isResolvedPresentation(presentation)) return [];\n\n      return applyConstraints(config.constraints ?? [], getTracks(presentation), deps);\n    },\n    { equals: sameCandidateSet }\n  );\n\n  return createMachineReactor({\n    initial: 'presentation-unresolved',\n    monitor: () => derivedStateSignal.get(),\n    states: {\n      'presentation-unresolved': {},\n      'presentation-resolved': {\n        // Canonical cleanup-binds-to-setup: the selection signal's valid\n        // lifespan is exactly 'presentation-resolved'. Clear fires on exit,\n        // covering both src unload and behavior destroy.\n        entry: () => () => state[selectionKey].set(undefined),\n        effects: [\n          () => {\n            // Reactive read: subscribes the reaction to the candidate set, so a\n            // new presentation — or a constraint pruning it — re-fires this and\n            // re-picks.\n            const tracks = candidateSet.get();\n\n            // Empty candidate set — two shapes, told apart by whether the type\n            // has any tracks at all:\n            //   - The type has no tracks (e.g. a video-only source's absent\n            //     audio): legitimate, nothing to pick or clear.\n            //   - The type HAS tracks but the hard-constraints pre-pass pruned\n            //     every one (every rendition undecodable, or every CDN in\n            //     failover cooldown): no playable rendition. Clear the selection\n            //     so a pick made earlier — e.g. under the initial mp4 label,\n            //     before resolve-track relabeled the type to a non-fMP4\n            //     container — can't linger as a now-unplayable selection and\n            //     silently stall the pipeline.\n            if (!tracks.length) {\n              const presentation = peek(state.presentation);\n              const hasTracksOfType = isResolvedPresentation(presentation) && getTracks(presentation).length > 0;\n\n              if (hasTracksOfType) {\n                // Reported generically: *why* the set emptied is the constraints'\n                // business, not this behavior's, so no constraint's state is read\n                // here and no cause is distinguished. Whatever the reason, a type\n                // that has renditions but none selectable can't play — a codec\n                // this environment can't decode, or every CDN failed, which is\n                // itself fatal-or-nearly so. Finer causes (container vs codec)\n                // would need `CanPlayTrack` to report a reason; see\n                // `internal/design/spf/features/errors.md`.\n                if (noSupportedTrackCode !== undefined) {\n                  emitError(state, { code: noSupportedTrackCode, data: { selectionKey } });\n                }\n\n                state[selectionKey].set(undefined);\n              }\n\n              return;\n            }\n\n            // The whole deps object passes straight through to every rule in the\n            // variant-supplied chain (state + config from the behavior; context\n            // threaded in by the variant's rest-spread). Typed against the base\n            // config — each rule re-declares the extra fields it reads as\n            // optional, and the concrete `C` is assignable to the base.\n            const candidates = applyRules<T, TrackSwitchingStateMap<S>, AnySlotMap, TrackSwitchingConfig<S, T>>(\n              rules,\n              tracks,\n              deps\n            );\n\n            // applyRules early-bails to a single survivor and never narrows to\n            // nothing (a soft filter that would empty the set falls through), so\n            // the pick is just the head. An empty result means a rule misbehaved\n            // — applyRules is supposed to account for those cases, so surface it.\n            if (!candidates.length) {\n              console.error('[track-switching] applyRules returned no candidates');\n              return;\n            }\n\n            // Map survivors to the final id. Defaults to the chain head; a\n            // variant with optional selection (text) may resolve to `undefined`,\n            // which clears the slot (e.g. explicit off, opt-in decline).\n            // No change-guard needed: the slot uses default (Object.is) equality,\n            // so re-setting the same value is a no-op (no notify, no re-fire).\n            state[selectionKey].set(resolveSelection(candidates, deps));\n          },\n        ],\n      },\n    },\n  });\n}\n\n// ============================================================================\n// Variant: switchVideoTrack — bandwidth-driven ABR\n// ============================================================================\n\n/**\n * Manage `selectedVideoTrackId`: pick a default on src load, dynamically adjust based on bandwidth, clear on src\n * unload. Honors `userVideoTrackSelection` as a partial-track constraint on candidates; short-circuits ABR when the\n * constraint narrows to a single track.\n *\n * @example\n *   const reactor = switchVideoTrack.setup({ state });\n */\nexport const switchVideoTrack = defineBehavior({\n  stateKeys: ['presentation', 'selectedVideoTrackId'],\n  contextKeys: [],\n  setup: ({\n    state,\n    config,\n    ...otherProps\n  }: {\n    state: TrackSwitchingStateMap<'selectedVideoTrackId'>;\n    config?: SwitchVideoTrackConfig;\n  }) =>\n    setupTrackSwitching({\n      ...otherProps,\n      state,\n      config: {\n        ...config,\n        selectionKey: 'selectedVideoTrackId',\n        userSelectionKey: 'userVideoTrackSelection',\n        getTracks: (presentation) => getTracksByType(presentation, 'video') as readonly VideoTrackCandidate[],\n        constraints: [excludeFailedCdns, excludeUnplayableTracks, stickToSelectedCodecs],\n        rules: [filterByUserSelection, preferCodecFamilies, preferActiveCdn, playerResolutionCap, rankByBandwidth],\n        noSupportedTrackCode: SVTA_NO_SUPPORTED_VIDEO_TRACK,\n      },\n    }),\n});\n\n// ============================================================================\n// Variant: switchAudioTrack — bandwidth-ranked (shared ranker)\n// ============================================================================\n\n/**\n * Manage `selectedAudioTrackId`: pick a default on src load, narrow by `userAudioTrackSelection` filter, re-pick on\n * filter change, clear on src unload.\n *\n * Mid-stream flush on language switch is handled by the segment-loader's `planTasks` (see\n * `playback/actors/dom/segment-loader.ts`) — not this behavior. Same split as the video pipeline: slot owner writes;\n * loader orchestrates segment + flush plans.\n *\n * @example\n *   const reactor = switchAudioTrack.setup({ state });\n */\nexport const switchAudioTrack = defineBehavior({\n  stateKeys: ['presentation', 'selectedAudioTrackId'],\n  contextKeys: [],\n  setup: ({\n    state,\n    config,\n    ...otherProps\n  }: {\n    state: TrackSwitchingStateMap<'selectedAudioTrackId'>;\n    // Shares the video config shape so the engine config spreads through (CDN\n    // derivation + any future cross-cutting fields).\n    config?: SwitchVideoTrackConfig;\n  }) =>\n    setupTrackSwitching({\n      ...otherProps,\n      state,\n      config: {\n        // Spread engine config so cross-cutting fields (`getCdnId`, future shared\n        // tuning) flow through like they do for video, then override the per-type\n        // wiring. Video-only ABR tuning (`quality`/`bandwidth`/`initialBandwidth`)\n        // rides along into the shared `rankByBandwidth` too; harmless since audio\n        // has no `bandwidthState` to act on it and the ranker always yields a pick.\n        // FOLLOW-UP: a shared config type for the genuinely cross-cutting fields\n        // would keep video-only tuning out of audio entirely (CJP).\n        ...config,\n        selectionKey: 'selectedAudioTrackId',\n        userSelectionKey: 'userAudioTrackSelection',\n        getTracks: (presentation) => getTracksByType(presentation, 'audio') as readonly AudioTrackCandidate[],\n        constraints: [excludeFailedCdns, excludeUnplayableTracks, stickToSelectedCodecs],\n        rules: [filterByUserSelection, preferCodecFamilies, preferActiveCdn, rankByBandwidth],\n        noSupportedTrackCode: SVTA_NO_SUPPORTED_AUDIO_TRACK,\n      },\n    }),\n});\n\n// ============================================================================\n// Variant: switchTextTrack — intent-resolved, optional selection\n// ============================================================================\n\n/**\n * Config for `switchTextTrack` — the opt-in default policy (`preferredSubtitleLanguage` / `includeForcedTracks` /\n * `enableDefaultTrack`, via `TextSelectionConfig`) read by the terminal when the user has no standing intent, plus the\n * `getCdnId` override shared with the CDN constraint + scope.\n */\nexport interface SwitchTextTrackConfig extends TextSelectionConfig {\n  /** Override CDN-id derivation (shared by the failed-CDN constraint + active-CDN scope). */\n  getCdnId?: GetCdnId;\n}\n\n/**\n * Manage `selectedTextTrackId` as the single-writer **output** of standing user intent (`userTextTrackSelection`)\n * resolved against the playable, CDN-scoped text renditions: clear on src unload; re-resolve when a CDN fails or\n * recovers.\n *\n * Unlike video/audio, the selection is _optional_ — captions are opt-in and the user can turn them off — so the chain\n * skips the bandwidth ranker and the shared user-selection filter, and supplies a text-specific terminal\n * (`pickResolvedTextTrack`) that may resolve to no-selection via `setupTrackSwitching`'s `resolveSelection` seam.\n * Constraints are failed-CDN only (`excludeUnplayableTracks`/`canPlayTrack` is MSE-based — the wrong probe for text,\n * whose playability is SPF-parser support); the active-CDN scope co-locates captions with the surviving CDN on\n * failover.\n *\n * @example\n *   const reactor = switchTextTrack.setup({ state, config: { preferredSubtitleLanguage: 'en' } });\n */\nexport const switchTextTrack = defineBehavior({\n  stateKeys: ['presentation', 'selectedTextTrackId'],\n  contextKeys: [],\n  setup: ({\n    state,\n    config,\n    ...otherProps\n  }: {\n    state: TrackSwitchingStateMap<'selectedTextTrackId'>;\n    config?: SwitchTextTrackConfig;\n  }) =>\n    // Explicit type args pin the candidate type to `TextTrackCandidate`. Video and\n    // audio let it infer to the `SwitchableTrack` constraint (harmless — every\n    // rule is assignable up to it), but the text terminal needs the narrower type\n    // (it reads text-only fields), so it's named here rather than inferred.\n    setupTrackSwitching<'selectedTextTrackId', TextTrackCandidate, TextTerminalConfig & SwitchTextTrackConfig>({\n      ...otherProps,\n      state,\n      config: {\n        ...config,\n        selectionKey: 'selectedTextTrackId',\n        getTracks: (presentation) => getTracksByType(presentation, 'text') as readonly TextTrackCandidate[],\n        constraints: [excludeFailedCdns],\n        rules: [preferActiveCdn],\n        resolveSelection: pickResolvedTextTrack,\n      },\n    }),\n});\n"],"mappings":"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"}

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

@@ -0,0 +1,94 @@
+import { createComposition } from "../../../core/composition/create-composition.js";
+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 { collectErrors } from "../../behaviors/collect-errors.js";
+import { switchAudioTrack } from "../../behaviors/track-switching.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 { 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";
+import { resolvePresentation } from "../../behaviors/resolve-presentation.js";
+import { resolveAudioTrack } from "../../behaviors/resolve-track.js";
+import { setupFailoverMonitor } from "../../behaviors/setup-failover-monitor.js";
+import { syncPreload } from "../../behaviors/sync-preload.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", "disableRemotePlayback"]);
+/**
+* Create an audio-only HLS playback engine.
+*
+* Subtractive composition variant of `createHlsVideoEngine`: omits video-side behaviors (`resolveVideoTrack`,
+* `switchVideoTrack`, `setupVideoBufferActors`, `loadVideoSegments`) and text-track behaviors (`switchTextTrack`,
+* `resolveTextTrack`, `syncTextTracks`, `setupTextTrackActors`, `loadTextTrackSegments`). The remaining audio pipeline
+* composes unchanged.
+*
+* Handles both truly audio-only HLS sources (no video stream-inf) and mixed-AV HLS sources where the audio rendition is
+* selected and video / subtitle renditions are ignored at composition time. The variant decision is encoded by adapter
+* choice; this engine does not branch on source shape.
+*
+* @example
+*   ```ts
+*   let signals: HlsAudioEngineSignals;
+*   const engine = createHlsAudioEngine({
+*     preferredAudioLanguage: 'en',
+*     onSignalsReady: (refs) => {
+*       signals = refs;
+*     },
+*   });
+*
+*   signals.context.mediaElement.set(audioEl);
+*   signals.state.presentation.set({ url: 'https://example.com/stream.m3u8' });
+*   ```;
+*/
+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,
+		audioMessagePipelines: relocationPipelinesFor("audio", deriveStartMediaTime)
+	};
+	return createComposition([
+		syncPreload,
+		trackLoadTriggers,
+		resolvePresentation,
+		deriveCdnPriority,
+		setupFailoverMonitor,
+		collectErrors,
+		switchAudioTrack,
+		resolveAudioTrack,
+		calculatePresentationDuration,
+		setupMediaSource,
+		updateMediaSourceDuration,
+		establishStartMediaTime,
+		setupAudioBufferActors,
+		setupAirPlay,
+		trackCurrentTime,
+		applyStartPosition,
+		loadAudioSegments,
+		endOfStream,
+		recoverEndStall,
+		shareSignals
+	], { config: finalConfig });
+}
+//#endregion
+export { createHlsAudioEngine };
+
+//# sourceMappingURL=engine-audio-only.js.map