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

package/dist/dev/media/hls/parse-multivariant.js

@@ -0,0 +1,234 @@
+import { matchTag, parseCodecs } from "./parse-attributes.js";
+import { resolveUrl } from "./resolve-url.js";
+import { generateId } from "@videojs/utils/string";
+//#region src/media/hls/parse-multivariant.ts
+/**
+* Parse HLS multivariant playlist into a Presentation.
+*
+* Returns Presentation with partially resolved tracks (no segment information).
+* Tracks contain metadata from multivariant playlist (bandwidth, resolution, codecs)
+* but segment information is added when media playlists are fetched.
+*
+* @param text - Raw playlist text content
+* @param unresolved - Unresolved presentation (contains URL for base URL resolution)
+* @returns Presentation with partially resolved tracks (duration is undefined)
+*/
+function parseMultivariantPlaylist(text, unresolved) {
+	const baseUrl = unresolved.url;
+	const lines = text.split(/\r?\n/);
+	const streams = [];
+	const audioRenditions = [];
+	const subtitleRenditions = [];
+	let pendingStreamInfo = null;
+	for (const line of lines) {
+		const trimmed = line.trim();
+		if (!trimmed || trimmed.startsWith("#") && !trimmed.startsWith("#EXT")) continue;
+		if (trimmed === "#EXTM3U" || trimmed.startsWith("#EXT-X-VERSION:") || trimmed.startsWith("#EXT-X-INDEPENDENT-SEGMENTS")) continue;
+		const mediaAttrs = matchTag(trimmed, "EXT-X-MEDIA");
+		if (mediaAttrs) {
+			const type = mediaAttrs.get("TYPE");
+			const groupId = mediaAttrs.get("GROUP-ID");
+			const name = mediaAttrs.get("NAME");
+			if (type === "AUDIO" && groupId && name) {
+				const uri = mediaAttrs.get("URI");
+				audioRenditions.push({
+					groupId,
+					name,
+					language: mediaAttrs.get("LANGUAGE"),
+					uri: uri ? resolveUrl(uri, baseUrl) : void 0,
+					default: mediaAttrs.getBool("DEFAULT"),
+					autoselect: mediaAttrs.getBool("AUTOSELECT"),
+					channels: mediaAttrs.getInt("CHANNELS")
+				});
+			}
+			if (type === "SUBTITLES" && groupId && name) {
+				const uri = mediaAttrs.get("URI");
+				if (uri) subtitleRenditions.push({
+					groupId,
+					name,
+					language: mediaAttrs.get("LANGUAGE"),
+					uri: resolveUrl(uri, baseUrl),
+					default: mediaAttrs.getBool("DEFAULT"),
+					autoselect: mediaAttrs.getBool("AUTOSELECT"),
+					forced: mediaAttrs.getBool("FORCED")
+				});
+			}
+			continue;
+		}
+		const streamInfAttrs = matchTag(trimmed, "EXT-X-STREAM-INF");
+		if (streamInfAttrs) {
+			pendingStreamInfo = {
+				bandwidth: streamInfAttrs.getInt("BANDWIDTH", 0),
+				resolution: streamInfAttrs.getResolution("RESOLUTION"),
+				codecs: streamInfAttrs.get("CODECS"),
+				frameRate: streamInfAttrs.getFrameRate("FRAME-RATE"),
+				audioGroupId: streamInfAttrs.get("AUDIO")
+			};
+			continue;
+		}
+		if (!trimmed.startsWith("#") && pendingStreamInfo) {
+			streams.push({
+				...pendingStreamInfo,
+				uri: resolveUrl(trimmed, baseUrl)
+			});
+			pendingStreamInfo = null;
+		}
+	}
+	const videoStreams = [];
+	const audioOnlyStreams = [];
+	for (const stream of streams) {
+		if (!stream.codecs) {
+			videoStreams.push(stream);
+			continue;
+		}
+		const parsedCodecs = parseCodecs(stream.codecs);
+		if (stream.codecs.split(",").length === 1) if (parsedCodecs.audio && !parsedCodecs.video) audioOnlyStreams.push(stream);
+		else videoStreams.push(stream);
+		else videoStreams.push(stream);
+	}
+	const videoTracksByUrl = /* @__PURE__ */ new Map();
+	for (const stream of videoStreams) {
+		const existing = videoTracksByUrl.get(stream.uri);
+		if (existing) {
+			if (stream.audioGroupId && !existing.audioGroupIds?.includes(stream.audioGroupId)) existing.audioGroupIds = [...existing.audioGroupIds ?? [], stream.audioGroupId];
+			if (stream.bandwidth < existing.bandwidth) existing.bandwidth = stream.bandwidth;
+			continue;
+		}
+		const codecs = stream.codecs ? parseCodecs(stream.codecs) : void 0;
+		const track = {
+			type: "video",
+			id: generateId(),
+			url: stream.uri,
+			bandwidth: stream.bandwidth,
+			mimeType: "video/mp4",
+			codecs: []
+		};
+		if (stream.resolution?.width !== void 0) track.width = stream.resolution.width;
+		if (stream.resolution?.height !== void 0) track.height = stream.resolution.height;
+		if (codecs?.video) track.codecs = codecs.audio && !stream.audioGroupId ? [codecs.video, codecs.audio] : [codecs.video];
+		if (stream.frameRate) track.frameRate = stream.frameRate;
+		if (stream.audioGroupId) track.audioGroupIds = [stream.audioGroupId];
+		videoTracksByUrl.set(stream.uri, track);
+	}
+	const videoTracks = [...videoTracksByUrl.values()];
+	const audioOnlyTracks = audioOnlyStreams.map((stream) => {
+		const codecs = stream.codecs ? parseCodecs(stream.codecs) : void 0;
+		return {
+			type: "audio",
+			id: generateId(),
+			url: stream.uri,
+			bandwidth: stream.bandwidth,
+			mimeType: "audio/mp4",
+			codecs: codecs?.audio ? [codecs.audio] : [],
+			groupId: stream.audioGroupId || "default",
+			name: "Default",
+			sampleRate: 48e3,
+			channels: 2
+		};
+	});
+	const audioTracks = [...audioRenditions.flatMap((rendition) => {
+		let audioCodecs;
+		for (const stream of streams) if (stream.audioGroupId === rendition.groupId && stream.codecs) {
+			const codecs = parseCodecs(stream.codecs);
+			if (codecs.audio) {
+				audioCodecs = [codecs.audio];
+				break;
+			}
+		}
+		if (!rendition.uri) {
+			const carrier = audioOnlyTracks.find((track) => track.groupId === rendition.groupId);
+			if (carrier) {
+				carrier.name = rendition.name;
+				if (rendition.language) carrier.language = rendition.language;
+				if (rendition.channels) carrier.channels = rendition.channels;
+				if (rendition.default) carrier.default = rendition.default;
+				if (rendition.autoselect) carrier.autoselect = rendition.autoselect;
+				return [];
+			}
+		}
+		const track = {
+			type: "audio",
+			id: generateId(),
+			url: rendition.uri ?? "",
+			groupId: rendition.groupId,
+			name: rendition.name,
+			mimeType: "audio/mp4",
+			bandwidth: 0,
+			sampleRate: 48e3,
+			channels: rendition.channels ?? 2,
+			codecs: []
+		};
+		if (rendition.language) track.language = rendition.language;
+		if (audioCodecs) track.codecs = audioCodecs;
+		if (rendition.default) track.default = rendition.default;
+		if (rendition.autoselect) track.autoselect = rendition.autoselect;
+		return [track];
+	}), ...audioOnlyTracks];
+	const textTracks = subtitleRenditions.map((rendition) => {
+		const track = {
+			type: "text",
+			id: generateId(),
+			url: rendition.uri,
+			groupId: rendition.groupId,
+			label: rendition.name,
+			kind: "subtitles",
+			mimeType: "text/vtt",
+			bandwidth: 0
+		};
+		if (rendition.language) track.language = rendition.language;
+		if (rendition.default && rendition.autoselect) track.default = true;
+		if (rendition.autoselect) track.autoselect = rendition.autoselect;
+		if (rendition.forced) track.forced = rendition.forced;
+		return track;
+	});
+	const selectionSets = [];
+	if (videoTracks.length > 0) {
+		const videoSwitchingSet = {
+			id: generateId(),
+			type: "video",
+			tracks: videoTracks
+		};
+		const videoSelectionSet = {
+			id: generateId(),
+			type: "video",
+			switchingSets: [videoSwitchingSet]
+		};
+		selectionSets.push(videoSelectionSet);
+	}
+	if (audioTracks.length > 0) {
+		const audioSwitchingSet = {
+			id: generateId(),
+			type: "audio",
+			tracks: audioTracks
+		};
+		const audioSelectionSet = {
+			id: generateId(),
+			type: "audio",
+			switchingSets: [audioSwitchingSet]
+		};
+		selectionSets.push(audioSelectionSet);
+	}
+	if (textTracks.length > 0) {
+		const textSwitchingSet = {
+			id: generateId(),
+			type: "text",
+			tracks: textTracks
+		};
+		const textSelectionSet = {
+			id: generateId(),
+			type: "text",
+			switchingSets: [textSwitchingSet]
+		};
+		selectionSets.push(textSelectionSet);
+	}
+	return {
+		id: generateId(),
+		url: unresolved.url,
+		startTime: 0,
+		selectionSets
+	};
+}
+//#endregion
+export { parseMultivariantPlaylist };
+
+//# sourceMappingURL=parse-multivariant.js.map

package/dist/dev/media/hls/parse-multivariant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-multivariant.js","names":[],"sources":["../../../../src/media/hls/parse-multivariant.ts"],"sourcesContent":["import { generateId } from '@videojs/utils/string';\nimport type {\n  AddressableObject,\n  AudioSelectionSet,\n  AudioSwitchingSet,\n  FrameRate,\n  PartiallyResolvedAudioTrack,\n  PartiallyResolvedTextTrack,\n  PartiallyResolvedVideoTrack,\n  Presentation,\n  SelectionSet,\n  TextSelectionSet,\n  TextSwitchingSet,\n  VideoSelectionSet,\n  VideoSwitchingSet,\n} from '../types';\nimport { matchTag, parseCodecs } from './parse-attributes';\nimport { resolveUrl } from './resolve-url';\n\n/**\n * Parse HLS multivariant playlist into a Presentation.\n *\n * Returns Presentation with partially resolved tracks (no segment information).\n * Tracks contain metadata from multivariant playlist (bandwidth, resolution, codecs)\n * but segment information is added when media playlists are fetched.\n *\n * @param text - Raw playlist text content\n * @param unresolved - Unresolved presentation (contains URL for base URL resolution)\n * @returns Presentation with partially resolved tracks (duration is undefined)\n */\nexport function parseMultivariantPlaylist(text: string, unresolved: AddressableObject): Presentation {\n  const baseUrl = unresolved.url;\n  const lines = text.split(/\\r?\\n/);\n\n  // Intermediate parsing structures\n  interface StreamInfo {\n    uri: string;\n    bandwidth: number;\n    resolution?: { width: number; height: number } | undefined;\n    codecs?: string | undefined;\n    frameRate?: FrameRate | undefined;\n    audioGroupId?: string | undefined;\n  }\n\n  interface AudioRenditionInfo {\n    groupId: string;\n    name: string;\n    language?: string | undefined;\n    uri?: string | undefined;\n    default?: boolean | undefined;\n    autoselect?: boolean | undefined;\n    channels?: number | undefined;\n  }\n\n  interface SubtitleRenditionInfo {\n    groupId: string;\n    name: string;\n    language?: string | undefined;\n    uri: string;\n    default?: boolean | undefined;\n    autoselect?: boolean | undefined;\n    forced?: boolean | undefined;\n  }\n\n  const streams: StreamInfo[] = [];\n  const audioRenditions: AudioRenditionInfo[] = [];\n  const subtitleRenditions: SubtitleRenditionInfo[] = [];\n\n  // State for STREAM-INF parsing (URI follows on next line)\n  let pendingStreamInfo: Omit<StreamInfo, 'uri'> | null = null;\n\n  for (const line of lines) {\n    const trimmed = line.trim();\n\n    // Skip empty lines and comments\n    if (!trimmed || (trimmed.startsWith('#') && !trimmed.startsWith('#EXT'))) {\n      continue;\n    }\n\n    // Skip tags not used in Presentation model\n    if (\n      trimmed === '#EXTM3U' ||\n      trimmed.startsWith('#EXT-X-VERSION:') ||\n      trimmed.startsWith('#EXT-X-INDEPENDENT-SEGMENTS')\n    ) {\n      continue;\n    }\n\n    // #EXT-X-MEDIA:TYPE=AUDIO/SUBTITLES\n    const mediaAttrs = matchTag(trimmed, 'EXT-X-MEDIA');\n    if (mediaAttrs) {\n      const type = mediaAttrs.get('TYPE');\n      const groupId = mediaAttrs.get('GROUP-ID');\n      const name = mediaAttrs.get('NAME');\n\n      if (type === 'AUDIO' && groupId && name) {\n        const uri = mediaAttrs.get('URI');\n        audioRenditions.push({\n          groupId,\n          name,\n          language: mediaAttrs.get('LANGUAGE'),\n          uri: uri ? resolveUrl(uri, baseUrl) : undefined,\n          default: mediaAttrs.getBool('DEFAULT'),\n          autoselect: mediaAttrs.getBool('AUTOSELECT'),\n          // CHANNELS is a quoted string whose first parameter is the channel\n          // count (\"6\", or \"16/JOC\" for spatial audio); getInt reads the\n          // leading integer.\n          channels: mediaAttrs.getInt('CHANNELS'),\n        });\n      }\n\n      if (type === 'SUBTITLES' && groupId && name) {\n        const uri = mediaAttrs.get('URI');\n        // URI is required for subtitle tracks\n        if (uri) {\n          subtitleRenditions.push({\n            groupId,\n            name,\n            language: mediaAttrs.get('LANGUAGE'),\n            uri: resolveUrl(uri, baseUrl),\n            default: mediaAttrs.getBool('DEFAULT'),\n            autoselect: mediaAttrs.getBool('AUTOSELECT'),\n            forced: mediaAttrs.getBool('FORCED'),\n          });\n        }\n      }\n      continue;\n    }\n\n    // #EXT-X-STREAM-INF:BANDWIDTH=...\n    const streamInfAttrs = matchTag(trimmed, 'EXT-X-STREAM-INF');\n    if (streamInfAttrs) {\n      pendingStreamInfo = {\n        bandwidth: streamInfAttrs.getInt('BANDWIDTH', 0)!,\n        resolution: streamInfAttrs.getResolution('RESOLUTION'),\n        codecs: streamInfAttrs.get('CODECS'),\n        frameRate: streamInfAttrs.getFrameRate('FRAME-RATE'),\n        audioGroupId: streamInfAttrs.get('AUDIO'),\n      };\n      continue;\n    }\n\n    // URI line following STREAM-INF\n    if (!trimmed.startsWith('#') && pendingStreamInfo) {\n      streams.push({\n        ...pendingStreamInfo,\n        uri: resolveUrl(trimmed, baseUrl),\n      });\n      pendingStreamInfo = null;\n    }\n  }\n\n  // Separate streams into video and audio based on codecs\n  // If CODECS has single codec, use parseCodecs to determine type\n  const videoStreams: typeof streams = [];\n  const audioOnlyStreams: typeof streams = [];\n\n  for (const stream of streams) {\n    if (!stream.codecs) {\n      // No codecs - assume video (default behavior)\n      videoStreams.push(stream);\n      continue;\n    }\n\n    const parsedCodecs = parseCodecs(stream.codecs);\n    const codecCount = stream.codecs.split(',').length;\n\n    // Single codec - determine type from parseCodecs result\n    if (codecCount === 1) {\n      if (parsedCodecs.audio && !parsedCodecs.video) {\n        // Audio-only stream\n        audioOnlyStreams.push(stream);\n      } else {\n        // Video stream (or unknown - default to video)\n        videoStreams.push(stream);\n      }\n    } else {\n      // Multiple codecs - video stream with muxed audio\n      videoStreams.push(stream);\n    }\n  }\n\n  // Build PartiallyResolvedVideoTracks from video streams, de-duplicating the\n  // HLS cross-product: one video rendition is listed across several\n  // `EXT-X-STREAM-INF` entries — one per audio group it can pair with, all\n  // sharing the same media-playlist URI. Collapse them to one track per URI,\n  // accumulating every advertised audio group. (Redundant-stream renditions\n  // live at *distinct* per-CDN URIs, so they stay separate — only the same-URI\n  // cross-product merges.)\n  const videoTracksByUrl = new Map<string, PartiallyResolvedVideoTrack>();\n  for (const stream of videoStreams) {\n    const existing = videoTracksByUrl.get(stream.uri);\n    if (existing) {\n      if (stream.audioGroupId && !existing.audioGroupIds?.includes(stream.audioGroupId)) {\n        existing.audioGroupIds = [...(existing.audioGroupIds ?? []), stream.audioGroupId];\n      }\n      // BANDWIDTH is video + audio combined; the duplicates differ only in the\n      // paired audio. Keep the lowest as the closest proxy to video-only, which\n      // is what ABR should rank on.\n      if (stream.bandwidth < existing.bandwidth) {\n        existing.bandwidth = stream.bandwidth;\n      }\n      continue;\n    }\n\n    const codecs = stream.codecs ? parseCodecs(stream.codecs) : undefined;\n\n    const track: PartiallyResolvedVideoTrack = {\n      type: 'video' as const,\n      id: generateId(),\n      url: stream.uri,\n      bandwidth: stream.bandwidth,\n      // Type-specific defaults (CMAF video)\n      mimeType: 'video/mp4',\n      codecs: [],\n    };\n\n    if (stream.resolution?.width !== undefined) {\n      track.width = stream.resolution.width;\n    }\n    if (stream.resolution?.height !== undefined) {\n      track.height = stream.resolution.height;\n    }\n    if (codecs?.video) {\n      // When the STREAM-INF lists an audio codec but declares no AUDIO group,\n      // the audio is muxed into this rendition's segments — keep both codecs so\n      // the SourceBuffer mimetype matches the muxed media (otherwise the muxed\n      // audio fails to append: \"audio object type does not match the mimetype\").\n      // With an AUDIO group the audio is a separate rendition, so only the video\n      // codec belongs here.\n      track.codecs = codecs.audio && !stream.audioGroupId ? [codecs.video, codecs.audio] : [codecs.video];\n    }\n    if (stream.frameRate) {\n      track.frameRate = stream.frameRate;\n    }\n    if (stream.audioGroupId) {\n      track.audioGroupIds = [stream.audioGroupId];\n    }\n\n    videoTracksByUrl.set(stream.uri, track);\n  }\n  const videoTracks: PartiallyResolvedVideoTrack[] = [...videoTracksByUrl.values()];\n\n  // Build PartiallyResolvedAudioTracks from audio-only streams\n  const audioOnlyTracks: PartiallyResolvedAudioTrack[] = audioOnlyStreams.map((stream) => {\n    const codecs = stream.codecs ? parseCodecs(stream.codecs) : undefined;\n\n    const track: PartiallyResolvedAudioTrack = {\n      type: 'audio' as const,\n      id: generateId(),\n      url: stream.uri,\n      bandwidth: stream.bandwidth,\n      mimeType: 'audio/mp4',\n      codecs: codecs?.audio ? [codecs.audio] : [],\n      groupId: stream.audioGroupId || 'default',\n      name: 'Default',\n      sampleRate: 48000, // Default - will be in media playlist if available\n      channels: 2, // Default - will be in media playlist if available\n    };\n\n    return track;\n  });\n\n  // Build PartiallyResolvedAudioTracks from audio renditions (EXT-X-MEDIA)\n  // Extract audio codecs from referencing streams\n  const audioRenditionTracks: PartiallyResolvedAudioTrack[] = audioRenditions.flatMap((rendition) => {\n    let audioCodecs: string[] | undefined;\n    for (const stream of streams) {\n      if (stream.audioGroupId === rendition.groupId && stream.codecs) {\n        const codecs = parseCodecs(stream.codecs);\n        if (codecs.audio) {\n          audioCodecs = [codecs.audio];\n          break;\n        }\n      }\n    }\n\n    // A rendition with no URI names media carried in the streams referencing its\n    // group. When such a stream is audio-only it is already a track of its own, so\n    // the two describe one rendition: merge rather than add a second entry that has\n    // nothing to fetch. The rendition holds the naming and selection metadata, the\n    // stream the URL and bandwidth.\n    if (!rendition.uri) {\n      const carrier = audioOnlyTracks.find((track) => track.groupId === rendition.groupId);\n      if (carrier) {\n        carrier.name = rendition.name;\n        if (rendition.language) carrier.language = rendition.language;\n        if (rendition.channels) carrier.channels = rendition.channels;\n        if (rendition.default) carrier.default = rendition.default;\n        if (rendition.autoselect) carrier.autoselect = rendition.autoselect;\n        return [];\n      }\n    }\n\n    const track: PartiallyResolvedAudioTrack = {\n      type: 'audio' as const,\n      id: generateId(),\n      url: rendition.uri ?? '',\n      groupId: rendition.groupId,\n      name: rendition.name,\n      // Type-specific defaults (CMAF audio)\n      mimeType: 'audio/mp4',\n      bandwidth: 0, // Not available in multivariant for demuxed audio\n      sampleRate: 48000, // CMAF default\n      channels: rendition.channels ?? 2, // From EXT-X-MEDIA CHANNELS; stereo default\n      codecs: [],\n    };\n\n    if (rendition.language) {\n      track.language = rendition.language;\n    }\n    if (audioCodecs) {\n      track.codecs = audioCodecs;\n    }\n    if (rendition.default) {\n      track.default = rendition.default;\n    }\n    if (rendition.autoselect) {\n      track.autoselect = rendition.autoselect;\n    }\n\n    return [track];\n  });\n\n  // Combine audio tracks from both EXT-X-MEDIA renditions and audio-only STREAM-INF\n  const audioTracks = [...audioRenditionTracks, ...audioOnlyTracks];\n\n  // Build PartiallyResolvedTextTracks from subtitle renditions\n  const textTracks: PartiallyResolvedTextTrack[] = subtitleRenditions.map((rendition) => {\n    const track: PartiallyResolvedTextTrack = {\n      type: 'text' as const,\n      id: generateId(),\n      url: rendition.uri,\n      groupId: rendition.groupId,\n      label: rendition.name,\n      kind: 'subtitles' as const,\n      // Type-specific defaults (VTT)\n      mimeType: 'text/vtt',\n      bandwidth: 0, // Text tracks don't consume bandwidth\n    };\n\n    if (rendition.language) {\n      track.language = rendition.language;\n    }\n    // Match hls.js/http-streaming: only set default=true when BOTH DEFAULT=YES AND AUTOSELECT=YES\n    if (rendition.default && rendition.autoselect) {\n      track.default = true;\n    }\n    if (rendition.autoselect) {\n      track.autoselect = rendition.autoselect;\n    }\n    if (rendition.forced) {\n      track.forced = rendition.forced;\n    }\n\n    return track;\n  });\n\n  // Build selection sets\n  const selectionSets: SelectionSet[] = [];\n\n  if (videoTracks.length > 0) {\n    const videoSwitchingSet: VideoSwitchingSet = {\n      id: generateId(),\n      type: 'video',\n      tracks: videoTracks,\n    };\n\n    const videoSelectionSet: VideoSelectionSet = {\n      id: generateId(),\n      type: 'video',\n      switchingSets: [videoSwitchingSet],\n    };\n\n    selectionSets.push(videoSelectionSet);\n  }\n\n  if (audioTracks.length > 0) {\n    const audioSwitchingSet: AudioSwitchingSet = {\n      id: generateId(),\n      type: 'audio',\n      tracks: audioTracks,\n    };\n\n    const audioSelectionSet: AudioSelectionSet = {\n      id: generateId(),\n      type: 'audio',\n      switchingSets: [audioSwitchingSet],\n    };\n\n    selectionSets.push(audioSelectionSet);\n  }\n\n  if (textTracks.length > 0) {\n    const textSwitchingSet: TextSwitchingSet = {\n      id: generateId(),\n      type: 'text',\n      tracks: textTracks,\n    };\n\n    const textSelectionSet: TextSelectionSet = {\n      id: generateId(),\n      type: 'text',\n      switchingSets: [textSwitchingSet],\n    };\n\n    selectionSets.push(textSelectionSet);\n  }\n\n  // Build presentation (duration is undefined until tracks are resolved)\n  return {\n    id: generateId(),\n    url: unresolved.url,\n    startTime: 0,\n    // duration: undefined, // Won't be known until after at least one media playlist is fetched + parsed\n    selectionSets,\n  };\n}\n"],"mappings":"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"}

package/dist/dev/media/hls/reload-policy.js

@@ -0,0 +1,71 @@
+import { getMediaPlaylistMetadata, isResolvedPresentation, isResolvedTrack } from "../types/index.js";
+import { findTrackById } from "../utils/tracks.js";
+//#region src/media/hls/reload-policy.ts
+/** Reload cadence when a playlist carries no usable target duration. */
+const FALLBACK_TARGET_DURATION = 6;
+/**
+* Default `HOLD-BACK` as a multiple of the target duration when the playlist
+* declares none — the HLS spec default (RFC 8216bis `EXT-X-SERVER-CONTROL`).
+*/
+const HOLD_BACK_TARGET_MULTIPLIER = 3;
+/** Identity of a reload snapshot — window position + length. Changes when the window slid or grew. */
+function snapshotSignature(track) {
+	return `${getMediaPlaylistMetadata(track)?.mediaSequence ?? 0}:${track.segments.length}`;
+}
+function targetDurationOf(track) {
+	return getMediaPlaylistMetadata(track)?.targetDuration || FALLBACK_TARGET_DURATION;
+}
+/**
+* Live media-playlist reload cadence, per RFC 8216bis §6.3.4 — a
+* {@link RecurrencePolicy} for a `RecurringRunner` re-resolving the selected
+* track. Structurally matches `RecurrencePolicy<ResolvedTrack>` without
+* importing it (media stays core-free): `current` is the freshly resolved track,
+* `previous` the prior resolved snapshot.
+*
+* - Complete playlist (VoD, or live that hit `#EXT-X-ENDLIST`) → `null`: stop.
+*   Keys off `Track.duration` (finite once complete), the single completeness
+*   source of truth.
+* - Unchanged window (same media sequence + segment count as `previous`) → poll
+*   at half the target duration; a moved/grown window (or the first reload) →
+*   full target duration.
+*
+* A failed reload doesn't reach here — the rejection propagates through the
+* `RecurringRunner`; transient-failure recovery belongs at the fetch layer.
+*
+* Returned delays are milliseconds.
+*/
+function mediaPlaylistReloadDelay(current, previous) {
+	if (Number.isFinite(current.duration)) return null;
+	const target = targetDurationOf(current);
+	return (!previous || snapshotSignature(current) !== snapshotSignature(previous) ? target : target / 2) * 1e3;
+}
+/**
+* Target live latency (seconds) for a resolved track — how far behind the live
+* edge the playhead should sit. Prefers the server's declared
+* `EXT-X-SERVER-CONTROL` `HOLD-BACK`, falling back to
+* {@link HOLD_BACK_TARGET_MULTIPLIER}× the target duration when absent (the
+* spec default). This is the HLS side of the format-neutral
+* `resolveLiveLatency` seam consumed by `seek-to-live-edge`; a DASH engine
+* supplies its own (`suggestedPresentationDelay`).
+*
+* Only `HOLD-BACK` — never `PART-HOLD-BACK`, which assumes partial-segment
+* playback. See {@link MediaPlaylistMetadata.holdBack}.
+*/
+function liveLatencyFor(track) {
+	return getMediaPlaylistMetadata(track)?.holdBack ?? HOLD_BACK_TARGET_MULTIPLIER * targetDurationOf(track);
+}
+/**
+* Resolve the target live latency for a presentation's timeline-bearing track —
+* the HLS engine injects this as `seekToLiveEdge`'s format-neutral
+* `resolveLiveLatency` seam. `0` when there is no resolved track to read (the
+* behavior then seeks straight to the edge).
+*/
+function resolveLiveLatency(presentation, trackId) {
+	if (!isResolvedPresentation(presentation) || !trackId) return 0;
+	const track = findTrackById(presentation, trackId);
+	return track && isResolvedTrack(track) ? liveLatencyFor(track) : 0;
+}
+//#endregion
+export { liveLatencyFor, mediaPlaylistReloadDelay, resolveLiveLatency };
+
+//# sourceMappingURL=reload-policy.js.map

package/dist/dev/media/hls/reload-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reload-policy.js","names":[],"sources":["../../../../src/media/hls/reload-policy.ts"],"sourcesContent":["import {\n  getMediaPlaylistMetadata,\n  isResolvedPresentation,\n  isResolvedTrack,\n  type MaybeResolvedPresentation,\n  type ResolvedTrack,\n} from '../types';\nimport { findTrackById } from '../utils/tracks';\n\n/** Reload cadence when a playlist carries no usable target duration. */\nconst FALLBACK_TARGET_DURATION = 6;\n\n/**\n * Default `HOLD-BACK` as a multiple of the target duration when the playlist\n * declares none — the HLS spec default (RFC 8216bis `EXT-X-SERVER-CONTROL`).\n */\nconst HOLD_BACK_TARGET_MULTIPLIER = 3;\n\n/** Identity of a reload snapshot — window position + length. Changes when the window slid or grew. */\nfunction snapshotSignature(track: ResolvedTrack): string {\n  return `${getMediaPlaylistMetadata(track)?.mediaSequence ?? 0}:${track.segments.length}`;\n}\n\nfunction targetDurationOf(track: ResolvedTrack): number {\n  return getMediaPlaylistMetadata(track)?.targetDuration || FALLBACK_TARGET_DURATION;\n}\n\n/**\n * Live media-playlist reload cadence, per RFC 8216bis §6.3.4 — a\n * {@link RecurrencePolicy} for a `RecurringRunner` re-resolving the selected\n * track. Structurally matches `RecurrencePolicy<ResolvedTrack>` without\n * importing it (media stays core-free): `current` is the freshly resolved track,\n * `previous` the prior resolved snapshot.\n *\n * - Complete playlist (VoD, or live that hit `#EXT-X-ENDLIST`) → `null`: stop.\n *   Keys off `Track.duration` (finite once complete), the single completeness\n *   source of truth.\n * - Unchanged window (same media sequence + segment count as `previous`) → poll\n *   at half the target duration; a moved/grown window (or the first reload) →\n *   full target duration.\n *\n * A failed reload doesn't reach here — the rejection propagates through the\n * `RecurringRunner`; transient-failure recovery belongs at the fetch layer.\n *\n * Returned delays are milliseconds.\n */\nexport function mediaPlaylistReloadDelay(current: ResolvedTrack, previous: ResolvedTrack | undefined): number | null {\n  if (Number.isFinite(current.duration)) return null;\n\n  const target = targetDurationOf(current);\n  const changed = !previous || snapshotSignature(current) !== snapshotSignature(previous);\n  return (changed ? target : target / 2) * 1000;\n}\n\n/**\n * Target live latency (seconds) for a resolved track — how far behind the live\n * edge the playhead should sit. Prefers the server's declared\n * `EXT-X-SERVER-CONTROL` `HOLD-BACK`, falling back to\n * {@link HOLD_BACK_TARGET_MULTIPLIER}× the target duration when absent (the\n * spec default). This is the HLS side of the format-neutral\n * `resolveLiveLatency` seam consumed by `seek-to-live-edge`; a DASH engine\n * supplies its own (`suggestedPresentationDelay`).\n *\n * Only `HOLD-BACK` — never `PART-HOLD-BACK`, which assumes partial-segment\n * playback. See {@link MediaPlaylistMetadata.holdBack}.\n */\nexport function liveLatencyFor(track: ResolvedTrack): number {\n  return getMediaPlaylistMetadata(track)?.holdBack ?? HOLD_BACK_TARGET_MULTIPLIER * targetDurationOf(track);\n}\n\n/**\n * Resolve the target live latency for a presentation's timeline-bearing track —\n * the HLS engine injects this as `seekToLiveEdge`'s format-neutral\n * `resolveLiveLatency` seam. `0` when there is no resolved track to read (the\n * behavior then seeks straight to the edge).\n */\nexport function resolveLiveLatency(\n  presentation: MaybeResolvedPresentation | undefined,\n  trackId: string | undefined\n): number {\n  if (!isResolvedPresentation(presentation) || !trackId) return 0;\n  const track = findTrackById(presentation, trackId);\n  return track && isResolvedTrack(track) ? liveLatencyFor(track) : 0;\n}\n"],"mappings":";;;;AAUA,MAAM,2BAA2B;;;;;AAMjC,MAAM,8BAA8B;;AAGpC,SAAS,kBAAkB,OAA8B;CACvD,OAAO,GAAG,yBAAyB,KAAK,CAAC,EAAE,iBAAiB,EAAE,GAAG,MAAM,SAAS;AAClF;AAEA,SAAS,iBAAiB,OAA8B;CACtD,OAAO,yBAAyB,KAAK,CAAC,EAAE,kBAAkB;AAC5D;;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,yBAAyB,SAAwB,UAAoD;CACnH,IAAI,OAAO,SAAS,QAAQ,QAAQ,GAAG,OAAO;CAE9C,MAAM,SAAS,iBAAiB,OAAO;CAEvC,QADgB,CAAC,YAAY,kBAAkB,OAAO,MAAM,kBAAkB,QAAQ,IACpE,SAAS,SAAS,KAAK;AAC3C;;;;;;;;;;;;;AAcA,SAAgB,eAAe,OAA8B;CAC3D,OAAO,yBAAyB,KAAK,CAAC,EAAE,YAAY,8BAA8B,iBAAiB,KAAK;AAC1G;;;;;;;AAQA,SAAgB,mBACd,cACA,SACQ;CACR,IAAI,CAAC,uBAAuB,YAAY,KAAK,CAAC,SAAS,OAAO;CAC9D,MAAM,QAAQ,cAAc,cAAc,OAAO;CACjD,OAAO,SAAS,gBAAgB,KAAK,IAAI,eAAe,KAAK,IAAI;AACnE"}

package/dist/dev/media/hls/resolve-url.js

@@ -0,0 +1,11 @@
+//#region src/media/hls/resolve-url.ts
+/**
+* Resolve a potentially relative URL against a base URL using native URL API.
+*/
+function resolveUrl(url, baseUrl) {
+	return new URL(url, baseUrl).href;
+}
+//#endregion
+export { resolveUrl };
+
+//# sourceMappingURL=resolve-url.js.map

package/dist/dev/media/hls/resolve-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-url.js","names":[],"sources":["../../../../src/media/hls/resolve-url.ts"],"sourcesContent":["/**\n * Resolve a potentially relative URL against a base URL using native URL API.\n */\nexport function resolveUrl(url: string, baseUrl: string): string {\n  return new URL(url, baseUrl).href;\n}\n"],"mappings":";;;;AAGA,SAAgB,WAAW,KAAa,SAAyB;CAC/D,OAAO,IAAI,IAAI,KAAK,OAAO,CAAC,CAAC;AAC/B"}

package/dist/dev/media/live-window.js

@@ -0,0 +1,36 @@
+import { isResolvedPresentation, isResolvedTrack } from "./types/index.js";
+import { findTrackById } from "./utils/tracks.js";
+//#region src/media/live-window.ts
+/**
+* Derive the live window of the track with the given id — the single source of
+* truth for "where is live," consumed (via `liveWindowFromState`) by the
+* seek-to-live-edge and live-seekable-range behaviors so neither re-derives (or
+* re-presumes) the window shape. Type-agnostic: the caller decides which track
+* bears the timeline (video when present, else audio).
+*
+* The window is a **live read** over the current `segments` array — never
+* stored on the track. The anchor triple is frozen per source; per-segment
+* `startTime` values are re-derived against it on every reload, so the edge
+* here slides while the origin stays fixed (see
+* `internal/design/spf/live-presentation-timeline-model.md`).
+*
+* Returns `null` when there is no live edge to track: an unresolved
+* presentation or track, a track with no segments, or a **complete** playlist
+* (VoD, or live that has ended — a finite `Track.duration`).
+*/
+function liveWindowFor(presentation, trackId) {
+	if (!isResolvedPresentation(presentation) || !trackId) return null;
+	const track = findTrackById(presentation, trackId);
+	if (!track || !isResolvedTrack(track) || track.segments.length === 0) return null;
+	if (Number.isFinite(track.duration)) return null;
+	const { segments } = track;
+	const last = segments[segments.length - 1];
+	return {
+		start: segments[0].startTime,
+		end: last.startTime + last.duration
+	};
+}
+//#endregion
+export { liveWindowFor };
+
+//# sourceMappingURL=live-window.js.map

package/dist/dev/media/live-window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-window.js","names":[],"sources":["../../../src/media/live-window.ts"],"sourcesContent":["/**\n * Derive the live window of the track with the given id — the single source of\n * truth for \"where is live,\" consumed (via `liveWindowFromState`) by the\n * seek-to-live-edge and live-seekable-range behaviors so neither re-derives (or\n * re-presumes) the window shape. Type-agnostic: the caller decides which track\n * bears the timeline (video when present, else audio).\n *\n * The window is a **live read** over the current `segments` array — never\n * stored on the track. The anchor triple is frozen per source; per-segment\n * `startTime` values are re-derived against it on every reload, so the edge\n * here slides while the origin stays fixed (see\n * `internal/design/spf/live-presentation-timeline-model.md`).\n *\n * Returns `null` when there is no live edge to track: an unresolved\n * presentation or track, a track with no segments, or a **complete** playlist\n * (VoD, or live that has ended — a finite `Track.duration`).\n */\nimport { isResolvedPresentation, isResolvedTrack, type MaybeResolvedPresentation } from './types';\nimport { findTrackById } from './utils/tracks';\n\nexport interface LiveWindow {\n  /** Earliest time still in the window (seconds, presentation timeline). */\n  start: number;\n  /** The live edge — latest time in the window (seconds). */\n  end: number;\n}\n\nexport function liveWindowFor(\n  presentation: MaybeResolvedPresentation | undefined,\n  trackId: string | undefined\n): LiveWindow | null {\n  if (!isResolvedPresentation(presentation) || !trackId) return null;\n\n  const track = findTrackById(presentation, trackId);\n  if (!track || !isResolvedTrack(track) || track.segments.length === 0) return null;\n\n  // Complete playlist (VoD, or live that has ended) → no live edge. `Track.duration`\n  // is the parser's completeness signal (finite = complete, Infinity = still growing).\n  if (Number.isFinite(track.duration)) return null;\n\n  const { segments } = track;\n  const last = segments[segments.length - 1]!;\n  return {\n    start: segments[0]!.startTime,\n    end: last.startTime + last.duration,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA2BA,SAAgB,cACd,cACA,SACmB;CACnB,IAAI,CAAC,uBAAuB,YAAY,KAAK,CAAC,SAAS,OAAO;CAE9D,MAAM,QAAQ,cAAc,cAAc,OAAO;CACjD,IAAI,CAAC,SAAS,CAAC,gBAAgB,KAAK,KAAK,MAAM,SAAS,WAAW,GAAG,OAAO;CAI7E,IAAI,OAAO,SAAS,MAAM,QAAQ,GAAG,OAAO;CAE5C,MAAM,EAAE,aAAa;CACrB,MAAM,OAAO,SAAS,SAAS,SAAS;CACxC,OAAO;EACL,OAAO,SAAS,EAAE,CAAE;EACpB,KAAK,KAAK,YAAY,KAAK;CAC7B;AACF"}

package/dist/dev/media/media-tracks/media-tracks.d.ts

@@ -0,0 +1,51 @@
+import { AudioTrack, FrameRate, MaybeResolvedPresentation, VideoTrack } from "../types/index.js";
+//#region src/media/media-tracks/media-tracks.d.ts
+/** Properties that identify a distinct video rendition (multi-CDN copies share them). */
+interface VideoDedupeKey {
+  width?: VideoTrack['width'];
+  height?: VideoTrack['height'];
+  bandwidth?: VideoTrack['bandwidth'];
+}
+/** Properties that identify a distinct audio track (multi-CDN copies share them). */
+interface AudioDedupeKey {
+  language?: AudioTrack['language'];
+  name?: AudioTrack['name'];
+}
+/**
+ * The distinct video tracks of a presentation, deduped by {@link VideoDedupeKey} (first occurrence wins).
+ *
+ * Returns `[]` when the presentation is unresolved or has no video tracks.
+ */
+declare function dedupedVideoTracks(presentation: MaybeResolvedPresentation | undefined): VideoTrack[];
+/**
+ * The distinct audio tracks of a presentation, deduped by `language` + `name`
+ * (first occurrence wins). Returns `[]` when the presentation is unresolved or has no audio tracks.
+ */
+declare function dedupedAudioTracks(presentation: MaybeResolvedPresentation | undefined): AudioTrack[];
+/**
+ * Find a video track by id, searching the same candidate set the engine resolves
+ * against ({@link dedupedVideoTracks}'s pre-dedupe source). Returns `undefined`
+ * when absent. Maps the engine's resolved `selectedVideoTrackId` back to its
+ * properties for `active` reflection — the resolved id may be a per-CDN copy that
+ * isn't the representative {@link dedupedVideoTracks} kept.
+ */
+declare function findVideoTrackById(presentation: MaybeResolvedPresentation | undefined, id: string | undefined): VideoTrack | undefined;
+/** Audio counterpart of {@link findVideoTrackById}, for `enabled` reflection. */
+declare function findAudioTrackById(presentation: MaybeResolvedPresentation | undefined, id: string | undefined): AudioTrack | undefined;
+/**
+ * Build a partial video track that can be used as `userVideoTrackSelection`.
+ */
+declare function toUserVideoTrackSelection<T extends VideoDedupeKey>(rendition?: T): Partial<VideoTrack> | undefined;
+/**
+ * Build a partial audio track that can be used as a `userAudioTrackSelection`.
+ */
+declare function toUserAudioTrackSelection<T extends AudioDedupeKey>(track?: T): Partial<AudioTrack> | undefined;
+/** Whether two video tracks are the same by dedupe key */
+declare function isSameVideoTrack(a: VideoDedupeKey, b: VideoDedupeKey | undefined): boolean;
+/** Whether two audio tracks are the same by dedupe key */
+declare function isSameAudioTrack(a: AudioDedupeKey, b: AudioDedupeKey | undefined): boolean;
+/** Collapse a rational frame rate (numerator/denominator) to frames per second. */
+declare const frameRateToNumber: (frameRate: FrameRate) => number;
+//#endregion
+export { AudioDedupeKey, type AudioTrack, VideoDedupeKey, type VideoTrack, dedupedAudioTracks, dedupedVideoTracks, findAudioTrackById, findVideoTrackById, frameRateToNumber, isSameAudioTrack, isSameVideoTrack, toUserAudioTrackSelection, toUserVideoTrackSelection };
+//# sourceMappingURL=media-tracks.d.ts.map

package/dist/dev/media/media-tracks/media-tracks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-tracks.d.ts","names":[],"sources":["../../../../src/media/media-tracks/media-tracks.ts"],"mappings":";;;UA0BiB;EACf,QAAQ;EACR,SAAS;EACT,YAAY;;;UAIG;EACf,WAAW;EACX,OAAO;;;;;;;iBAQO,mBAAmB,cAAc,wCAAwC;;;;;iBAazE,mBAAmB,cAAc,wCAAwC;;;;;;;;iBAgBzE,mBACd,cAAc,uCACd,yBACC;;iBAOa,mBACd,cAAc,uCACd,yBACC;;;;iBA2Ca,0BAA0B,UAAU,gBAAgB,YAAY,IAAI,QAAQ;;;;iBAO5E,0BAA0B,UAAU,gBAAgB,QAAQ,IAAI,QAAQ;;iBAKxE,iBAAiB,GAAG,gBAAgB,GAAG;;iBAKvC,iBAAiB,GAAG,gBAAgB,GAAG;;cAK1C,oBAAiB,WAAe"}

package/dist/dev/media/media-tracks/media-tracks.js

@@ -0,0 +1,101 @@
+import { findTrackById, getTracksByType } from "../utils/tracks.js";
+//#region src/media/media-tracks/media-tracks.ts
+/**
+* The distinct video tracks of a presentation, deduped by {@link VideoDedupeKey} (first occurrence wins).
+*
+* Returns `[]` when the presentation is unresolved or has no video tracks.
+*/
+function dedupedVideoTracks(presentation) {
+	if (!presentation) return [];
+	return dedupe({
+		tracks: getTracksByType(presentation, "video"),
+		keyFn: toUserVideoTrackSelection
+	});
+}
+/**
+* The distinct audio tracks of a presentation, deduped by `language` + `name`
+* (first occurrence wins). Returns `[]` when the presentation is unresolved or has no audio tracks.
+*/
+function dedupedAudioTracks(presentation) {
+	if (!presentation) return [];
+	return dedupe({
+		tracks: getTracksByType(presentation, "audio"),
+		keyFn: toUserAudioTrackSelection
+	});
+}
+/**
+* Find a video track by id, searching the same candidate set the engine resolves
+* against ({@link dedupedVideoTracks}'s pre-dedupe source). Returns `undefined`
+* when absent. Maps the engine's resolved `selectedVideoTrackId` back to its
+* properties for `active` reflection — the resolved id may be a per-CDN copy that
+* isn't the representative {@link dedupedVideoTracks} kept.
+*/
+function findVideoTrackById(presentation, id) {
+	if (!presentation || !id) return void 0;
+	const track = findTrackById(presentation, id);
+	return track?.type === "video" ? track : void 0;
+}
+/** Audio counterpart of {@link findVideoTrackById}, for `enabled` reflection. */
+function findAudioTrackById(presentation, id) {
+	if (!presentation || !id) return void 0;
+	const track = findTrackById(presentation, id);
+	return track?.type === "audio" ? track : void 0;
+}
+/**
+* Shallow-equal two key objects by their own properties. Both come from the same
+* key builder, so they carry the same keys — a one-directional scan suffices.
+*/
+function sameKey(a, b) {
+	for (const attr in a) if (a[attr] !== b[attr]) return false;
+	return true;
+}
+/**
+* Dedupe tracks by a key function, keeping the first occurrence of each key.
+* Keys are compared field-by-field ({@link sameKey}).
+*/
+function dedupe({ tracks, keyFn }) {
+	const seen = [];
+	const kept = [];
+	for (const track of tracks) {
+		const key = keyFn(track);
+		if (!key || seen.some((other) => sameKey(other, key))) continue;
+		seen.push(key);
+		kept.push(track);
+	}
+	return kept;
+}
+/**
+* Build a partial video track that can be used as `userVideoTrackSelection`.
+*/
+function toUserVideoTrackSelection(rendition) {
+	return rendition ? {
+		width: rendition.width,
+		height: rendition.height,
+		bandwidth: rendition.bandwidth
+	} : void 0;
+}
+/**
+* Build a partial audio track that can be used as a `userAudioTrackSelection`.
+*/
+function toUserAudioTrackSelection(track) {
+	return track ? {
+		language: track.language,
+		name: track.name
+	} : void 0;
+}
+/** Whether two video tracks are the same by dedupe key */
+function isSameVideoTrack(a, b) {
+	return !!b && a.width === b.width && a.height === b.height && a.bandwidth === b.bandwidth;
+}
+/** Whether two audio tracks are the same by dedupe key */
+function isSameAudioTrack(a, b) {
+	return !!b && (a.language ?? "") === (b.language ?? "") && a.name === b.name;
+}
+/** Collapse a rational frame rate (numerator/denominator) to frames per second. */
+const frameRateToNumber = (frameRate) => {
+	return frameRate.frameRateNumerator / (frameRate.frameRateDenominator ?? 1);
+};
+//#endregion
+export { dedupedAudioTracks, dedupedVideoTracks, findAudioTrackById, findVideoTrackById, frameRateToNumber, isSameAudioTrack, isSameVideoTrack, toUserAudioTrackSelection, toUserVideoTrackSelection };
+
+//# sourceMappingURL=media-tracks.js.map

package/dist/dev/media/media-tracks/media-tracks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-tracks.js","names":[],"sources":["../../../../src/media/media-tracks/media-tracks.ts"],"sourcesContent":["/**\n * Media-track translation utilities.\n *\n * Pure, DOM-free transforms from SPF's CMAF-HAM track model onto the deduped\n * lists a media-element adapter exposes (video renditions, audio tracks), plus\n * the selection-criteria builders that turn a chosen rendition/track back into a\n * `user*TrackSelection` partial the engine's track-switching reads.\n *\n * These return SPF *model vocabulary* (`bandwidth`, `codecs: string[]`,\n * `frameRate` as a rational `FrameRate`); the consuming adapter owns the\n * mapping (e.g. for DOM `bandwidth` -> `bitrate`, `codecs.join(',')` -> `codec`,\n * `name` -> `label`).\n *\n * Deduplication is by *properties*, never URL, so a multi-CDN source that lists\n * the same rendition on several hosts collapses to one entry: video renditions\n * by `width` + `height` + `bandwidth`, audio tracks by `language` + `name`.\n * The selection builders emit those same properties as the match criteria, so\n * selecting a collapsed entry re-selects, for example, every underlying per-CDN track.\n */\n\nimport type { AudioTrack, FrameRate, MaybeResolvedPresentation, VideoTrack } from '../types';\nimport { findTrackById, getTracksByType } from '../utils/tracks';\n\nexport type { AudioTrack, VideoTrack };\n\n/** Properties that identify a distinct video rendition (multi-CDN copies share them). */\nexport interface VideoDedupeKey {\n  width?: VideoTrack['width'];\n  height?: VideoTrack['height'];\n  bandwidth?: VideoTrack['bandwidth'];\n}\n\n/** Properties that identify a distinct audio track (multi-CDN copies share them). */\nexport interface AudioDedupeKey {\n  language?: AudioTrack['language'];\n  name?: AudioTrack['name'];\n}\n\n/**\n * The distinct video tracks of a presentation, deduped by {@link VideoDedupeKey} (first occurrence wins).\n *\n * Returns `[]` when the presentation is unresolved or has no video tracks.\n */\nexport function dedupedVideoTracks(presentation: MaybeResolvedPresentation | undefined): VideoTrack[] {\n  if (!presentation) return [];\n\n  return dedupe({\n    tracks: getTracksByType(presentation, 'video') as readonly VideoTrack[],\n    keyFn: toUserVideoTrackSelection,\n  });\n}\n\n/**\n * The distinct audio tracks of a presentation, deduped by `language` + `name`\n * (first occurrence wins). Returns `[]` when the presentation is unresolved or has no audio tracks.\n */\nexport function dedupedAudioTracks(presentation: MaybeResolvedPresentation | undefined): AudioTrack[] {\n  if (!presentation) return [];\n\n  return dedupe({\n    tracks: getTracksByType(presentation, 'audio') as readonly AudioTrack[],\n    keyFn: toUserAudioTrackSelection,\n  });\n}\n\n/**\n * Find a video track by id, searching the same candidate set the engine resolves\n * against ({@link dedupedVideoTracks}'s pre-dedupe source). Returns `undefined`\n * when absent. Maps the engine's resolved `selectedVideoTrackId` back to its\n * properties for `active` reflection — the resolved id may be a per-CDN copy that\n * isn't the representative {@link dedupedVideoTracks} kept.\n */\nexport function findVideoTrackById(\n  presentation: MaybeResolvedPresentation | undefined,\n  id: string | undefined\n): VideoTrack | undefined {\n  if (!presentation || !id) return undefined;\n  const track = findTrackById(presentation, id);\n  return track?.type === 'video' ? (track as VideoTrack) : undefined;\n}\n\n/** Audio counterpart of {@link findVideoTrackById}, for `enabled` reflection. */\nexport function findAudioTrackById(\n  presentation: MaybeResolvedPresentation | undefined,\n  id: string | undefined\n): AudioTrack | undefined {\n  if (!presentation || !id) return undefined;\n  const track = findTrackById(presentation, id);\n  return track?.type === 'audio' ? (track as AudioTrack) : undefined;\n}\n\n/**\n * Shallow-equal two key objects by their own properties. Both come from the same\n * key builder, so they carry the same keys — a one-directional scan suffices.\n */\nfunction sameKey<K extends object>(a: K, b: K): boolean {\n  for (const attr in a) {\n    if (a[attr] !== b[attr]) return false;\n  }\n  return true;\n}\n\n/**\n * Dedupe tracks by a key function, keeping the first occurrence of each key.\n * Keys are compared field-by-field ({@link sameKey}).\n */\nfunction dedupe<T, K extends object>({\n  tracks,\n  keyFn,\n}: {\n  tracks: readonly T[];\n  keyFn: (track: T) => K | undefined;\n}): T[] {\n  const seen: K[] = [];\n  const kept: T[] = [];\n  for (const track of tracks) {\n    const key = keyFn(track);\n    if (!key || seen.some((other) => sameKey(other, key))) continue;\n    seen.push(key);\n    kept.push(track);\n  }\n\n  return kept;\n}\n\n/**\n * Build a partial video track that can be used as `userVideoTrackSelection`.\n */\nexport function toUserVideoTrackSelection<T extends VideoDedupeKey>(rendition?: T): Partial<VideoTrack> | undefined {\n  return rendition ? { width: rendition.width, height: rendition.height, bandwidth: rendition.bandwidth } : undefined;\n}\n\n/**\n * Build a partial audio track that can be used as a `userAudioTrackSelection`.\n */\nexport function toUserAudioTrackSelection<T extends AudioDedupeKey>(track?: T): Partial<AudioTrack> | undefined {\n  return track ? { language: track.language, name: track.name } : undefined;\n}\n\n/** Whether two video tracks are the same by dedupe key */\nexport function isSameVideoTrack(a: VideoDedupeKey, b: VideoDedupeKey | undefined): boolean {\n  return !!b && a.width === b.width && a.height === b.height && a.bandwidth === b.bandwidth;\n}\n\n/** Whether two audio tracks are the same by dedupe key */\nexport function isSameAudioTrack(a: AudioDedupeKey, b: AudioDedupeKey | undefined): boolean {\n  return !!b && (a.language ?? '') === (b.language ?? '') && a.name === b.name;\n}\n\n/** Collapse a rational frame rate (numerator/denominator) to frames per second. */\nexport const frameRateToNumber = (frameRate: FrameRate) => {\n  return frameRate.frameRateNumerator / (frameRate.frameRateDenominator ?? 1);\n};\n"],"mappings":";;;;;;;AA2CA,SAAgB,mBAAmB,cAAmE;CACpG,IAAI,CAAC,cAAc,OAAO,CAAC;CAE3B,OAAO,OAAO;EACZ,QAAQ,gBAAgB,cAAc,OAAO;EAC7C,OAAO;CACT,CAAC;AACH;;;;;AAMA,SAAgB,mBAAmB,cAAmE;CACpG,IAAI,CAAC,cAAc,OAAO,CAAC;CAE3B,OAAO,OAAO;EACZ,QAAQ,gBAAgB,cAAc,OAAO;EAC7C,OAAO;CACT,CAAC;AACH;;;;;;;;AASA,SAAgB,mBACd,cACA,IACwB;CACxB,IAAI,CAAC,gBAAgB,CAAC,IAAI,OAAO,KAAA;CACjC,MAAM,QAAQ,cAAc,cAAc,EAAE;CAC5C,OAAO,OAAO,SAAS,UAAW,QAAuB,KAAA;AAC3D;;AAGA,SAAgB,mBACd,cACA,IACwB;CACxB,IAAI,CAAC,gBAAgB,CAAC,IAAI,OAAO,KAAA;CACjC,MAAM,QAAQ,cAAc,cAAc,EAAE;CAC5C,OAAO,OAAO,SAAS,UAAW,QAAuB,KAAA;AAC3D;;;;;AAMA,SAAS,QAA0B,GAAM,GAAe;CACtD,KAAK,MAAM,QAAQ,GACjB,IAAI,EAAE,UAAU,EAAE,OAAO,OAAO;CAElC,OAAO;AACT;;;;;AAMA,SAAS,OAA4B,EACnC,QACA,SAIM;CACN,MAAM,OAAY,CAAC;CACnB,MAAM,OAAY,CAAC;CACnB,KAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,MAAM,MAAM,KAAK;EACvB,IAAI,CAAC,OAAO,KAAK,MAAM,UAAU,QAAQ,OAAO,GAAG,CAAC,GAAG;EACvD,KAAK,KAAK,GAAG;EACb,KAAK,KAAK,KAAK;CACjB;CAEA,OAAO;AACT;;;;AAKA,SAAgB,0BAAoD,WAAgD;CAClH,OAAO,YAAY;EAAE,OAAO,UAAU;EAAO,QAAQ,UAAU;EAAQ,WAAW,UAAU;CAAU,IAAI,KAAA;AAC5G;;;;AAKA,SAAgB,0BAAoD,OAA4C;CAC9G,OAAO,QAAQ;EAAE,UAAU,MAAM;EAAU,MAAM,MAAM;CAAK,IAAI,KAAA;AAClE;;AAGA,SAAgB,iBAAiB,GAAmB,GAAwC;CAC1F,OAAO,CAAC,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE;AAClF;;AAGA,SAAgB,iBAAiB,GAAmB,GAAwC;CAC1F,OAAO,CAAC,CAAC,MAAM,EAAE,YAAY,SAAS,EAAE,YAAY,OAAO,EAAE,SAAS,EAAE;AAC1E;;AAGA,MAAa,qBAAqB,cAAyB;CACzD,OAAO,UAAU,sBAAsB,UAAU,wBAAwB;AAC3E"}

package/dist/dev/media/mp4/box.js

@@ -0,0 +1,58 @@
+//#region src/media/mp4/box.ts
+function toDataView(data) {
+	return data instanceof Uint8Array ? new DataView(data.buffer, data.byteOffset, data.byteLength) : new DataView(data);
+}
+/** Read a 4-character box type / FourCC at `offset`. */
+function readFourCC(view, offset) {
+	return String.fromCharCode(view.getUint8(offset), view.getUint8(offset + 1), view.getUint8(offset + 2), view.getUint8(offset + 3));
+}
+/** Iterate the boxes directly contained in `[start, end)`. */
+function* iterateBoxes(view, start = 0, end = view.byteLength) {
+	let offset = start;
+	while (offset + 8 <= end) {
+		let size = view.getUint32(offset);
+		const type = readFourCC(view, offset + 4);
+		let dataStart = offset + 8;
+		if (size === 1) {
+			size = Number(view.getBigUint64(offset + 8));
+			dataStart = offset + 16;
+		} else if (size === 0) size = end - offset;
+		if (size < dataStart - offset) return;
+		yield {
+			type,
+			start: offset,
+			dataStart,
+			end: offset + size
+		};
+		offset += size;
+	}
+}
+/** Iterate the direct child boxes of a given `type` within `[start, end)`. */
+function* iterateBoxesOfType(view, type, start = 0, end = view.byteLength) {
+	for (const box of iterateBoxes(view, start, end)) if (box.type === type) yield box;
+}
+/**
+* Depth-first descent to the first box matching a nested path, e.g.
+* `['moov', 'trak', 'mdia', 'mdhd']`. Returns `undefined` if any level is
+* absent.
+*/
+function findBox(view, path, start = 0, end = view.byteLength) {
+	const [head, ...rest] = path;
+	for (const box of iterateBoxes(view, start, end)) {
+		if (box.type !== head) continue;
+		if (rest.length === 0) return box;
+		const found = findBox(view, rest, box.dataStart, box.end);
+		if (found) return found;
+	}
+}
+/**
+* Read the version byte of a FullBox — the `version(1) + flags(3)` header at the
+* start of the payload of `mdhd` / `tkhd` / `tfdt` / `hdlr` / `elst` / etc.
+*/
+function readFullBoxVersion(view, dataStart) {
+	return view.getUint8(dataStart);
+}
+//#endregion
+export { findBox, iterateBoxes, iterateBoxesOfType, readFourCC, readFullBoxVersion, toDataView };
+
+//# sourceMappingURL=box.js.map