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

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

@@ -105,7 +105,7 @@ function parseMultivariantPlaylist(text, unresolved) {
 		};
 		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.video];
+		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);
@@ -126,7 +126,7 @@ function parseMultivariantPlaylist(text, unresolved) {
 			channels: 2
 		};
 	});
-	const audioTracks = [...audioRenditions.map((rendition) => {
+	const audioTracks = [...audioRenditions.flatMap((rendition) => {
 		let audioCodecs;
 		for (const stream of streams) if (stream.audioGroupId === rendition.groupId && stream.codecs) {
 			const codecs = parseCodecs(stream.codecs);
@@ -135,6 +135,17 @@ function parseMultivariantPlaylist(text, unresolved) {
 				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(),
@@ -151,7 +162,7 @@ function parseMultivariantPlaylist(text, unresolved) {
 		if (audioCodecs) track.codecs = audioCodecs;
 		if (rendition.default) track.default = rendition.default;
 		if (rendition.autoselect) track.autoselect = rendition.autoselect;
-		return track;
+		return [track];
 	}), ...audioOnlyTracks];
 	const textTracks = subtitleRenditions.map((rendition) => {
 		const track = {

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

@@ -1 +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      track.codecs = [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.map((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    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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"}
+{"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/default/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/default/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/default/media/hls/resolve-url.js.map

@@ -1 +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;AAC/D,QAAO,IAAI,IAAI,KAAK,QAAQ,CAAC"}
+{"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/default/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/default/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/default/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/default/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/default/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

package/dist/default/media/mp4/box.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"box.js","names":[],"sources":["../../../../src/media/mp4/box.ts"],"sourcesContent":["/**\n * Minimal ISO-BMFF (MP4/CMAF) box walker.\n *\n * Just enough to locate boxes by nested path — the framework needs a couple of\n * leaf fields (`mdhd` timescale, `tfdt` baseMediaDecodeTime) to derive a\n * segment's decode-time origin, not a full demuxer. DOM-free: operates on an\n * `ArrayBuffer` / `Uint8Array` via `DataView`.\n *\n * Box layout: `[u32 size][u32 type][payload]`. `size === 1` means a `u64\n * largesize` follows the type (payload after it); `size === 0` means the box\n * runs to the end of its container.\n */\n\n/** A located box: its 4-char type and byte offsets within the buffer. */\nexport interface Box {\n  type: string;\n  /** Offset of the box's first byte (its size field). */\n  start: number;\n  /** Offset of the box's payload — after `size` + `type` (+ `largesize`). */\n  dataStart: number;\n  /** Offset one past the box's last byte. */\n  end: number;\n}\n\nexport function toDataView(data: ArrayBuffer | Uint8Array): DataView {\n  return data instanceof Uint8Array ? new DataView(data.buffer, data.byteOffset, data.byteLength) : new DataView(data);\n}\n\n/** Read a 4-character box type / FourCC at `offset`. */\nexport function readFourCC(view: DataView, offset: number): string {\n  return String.fromCharCode(\n    view.getUint8(offset),\n    view.getUint8(offset + 1),\n    view.getUint8(offset + 2),\n    view.getUint8(offset + 3)\n  );\n}\n\n/** Iterate the boxes directly contained in `[start, end)`. */\nexport function* iterateBoxes(view: DataView, start = 0, end = view.byteLength): Generator<Box> {\n  let offset = start;\n  while (offset + 8 <= end) {\n    let size = view.getUint32(offset);\n    const type = readFourCC(view, offset + 4);\n    let dataStart = offset + 8;\n    if (size === 1) {\n      size = Number(view.getBigUint64(offset + 8));\n      dataStart = offset + 16;\n    } else if (size === 0) {\n      size = end - offset;\n    }\n    // A size smaller than its own header is malformed — stop rather than loop.\n    if (size < dataStart - offset) return;\n    yield { type, start: offset, dataStart, end: offset + size };\n    offset += size;\n  }\n}\n\n/** Iterate the direct child boxes of a given `type` within `[start, end)`. */\nexport function* iterateBoxesOfType(view: DataView, type: string, start = 0, end = view.byteLength): Generator<Box> {\n  for (const box of iterateBoxes(view, start, end)) {\n    if (box.type === type) yield box;\n  }\n}\n\n/**\n * Depth-first descent to the first box matching a nested path, e.g.\n * `['moov', 'trak', 'mdia', 'mdhd']`. Returns `undefined` if any level is\n * absent.\n */\nexport function findBox(view: DataView, path: readonly string[], start = 0, end = view.byteLength): Box | undefined {\n  const [head, ...rest] = path;\n  for (const box of iterateBoxes(view, start, end)) {\n    if (box.type !== head) continue;\n    if (rest.length === 0) return box;\n    const found = findBox(view, rest, box.dataStart, box.end);\n    if (found) return found;\n  }\n  return undefined;\n}\n\n/**\n * Read the version byte of a FullBox — the `version(1) + flags(3)` header at the\n * start of the payload of `mdhd` / `tkhd` / `tfdt` / `hdlr` / `elst` / etc.\n */\nexport function readFullBoxVersion(view: DataView, dataStart: number): number {\n  return view.getUint8(dataStart);\n}\n"],"mappings":";AAwBA,SAAgB,WAAW,MAA0C;CACnE,OAAO,gBAAgB,aAAa,IAAI,SAAS,KAAK,QAAQ,KAAK,YAAY,KAAK,UAAU,IAAI,IAAI,SAAS,IAAI;AACrH;;AAGA,SAAgB,WAAW,MAAgB,QAAwB;CACjE,OAAO,OAAO,aACZ,KAAK,SAAS,MAAM,GACpB,KAAK,SAAS,SAAS,CAAC,GACxB,KAAK,SAAS,SAAS,CAAC,GACxB,KAAK,SAAS,SAAS,CAAC,CAC1B;AACF;;AAGA,UAAiB,aAAa,MAAgB,QAAQ,GAAG,MAAM,KAAK,YAA4B;CAC9F,IAAI,SAAS;CACb,OAAO,SAAS,KAAK,KAAK;EACxB,IAAI,OAAO,KAAK,UAAU,MAAM;EAChC,MAAM,OAAO,WAAW,MAAM,SAAS,CAAC;EACxC,IAAI,YAAY,SAAS;EACzB,IAAI,SAAS,GAAG;GACd,OAAO,OAAO,KAAK,aAAa,SAAS,CAAC,CAAC;GAC3C,YAAY,SAAS;EACvB,OAAO,IAAI,SAAS,GAClB,OAAO,MAAM;EAGf,IAAI,OAAO,YAAY,QAAQ;EAC/B,MAAM;GAAE;GAAM,OAAO;GAAQ;GAAW,KAAK,SAAS;EAAK;EAC3D,UAAU;CACZ;AACF;;AAGA,UAAiB,mBAAmB,MAAgB,MAAc,QAAQ,GAAG,MAAM,KAAK,YAA4B;CAClH,KAAK,MAAM,OAAO,aAAa,MAAM,OAAO,GAAG,GAC7C,IAAI,IAAI,SAAS,MAAM,MAAM;AAEjC;;;;;;AAOA,SAAgB,QAAQ,MAAgB,MAAyB,QAAQ,GAAG,MAAM,KAAK,YAA6B;CAClH,MAAM,CAAC,MAAM,GAAG,QAAQ;CACxB,KAAK,MAAM,OAAO,aAAa,MAAM,OAAO,GAAG,GAAG;EAChD,IAAI,IAAI,SAAS,MAAM;EACvB,IAAI,KAAK,WAAW,GAAG,OAAO;EAC9B,MAAM,QAAQ,QAAQ,MAAM,MAAM,IAAI,WAAW,IAAI,GAAG;EACxD,IAAI,OAAO,OAAO;CACpB;AAEF;;;;;AAMA,SAAgB,mBAAmB,MAAgB,WAA2B;CAC5E,OAAO,KAAK,SAAS,SAAS;AAChC"}

package/dist/default/media/mp4/timestamp-origin.js

@@ -0,0 +1,107 @@
+import { findBox, iterateBoxesOfType, readFourCC, readFullBoxVersion, toDataView } from "./box.js";
+//#region src/media/mp4/timestamp-origin.ts
+/**
+* Decode-time origin extraction from fMP4/CMAF segments.
+*
+* Non-zero-PTS sources encode media at a non-zero start time (an instant clip
+* starting at asset second 60, an Apple bipbop asset starting at 10s, …). To
+* relocate such a source onto a 0-based presentation timeline via
+* `SourceBuffer.timestampOffset`, the engine needs that start time — the
+* **decode-time origin** — read straight from the container:
+*
+* - `tfdt.baseMediaDecodeTime` (from a media segment's `moof`) — the decode
+*   time of the segment's first sample, in the track's media timescale. This is
+*   a DTS: relocating by `−(baseMediaDecodeTime / timescale)` lands the earliest
+*   DTS at exactly 0, so a negative-DTS append failure on Chromium is impossible
+*   by construction.
+* - `mdhd.timescale` (from the init segment's `moov`) — ticks per second for
+*   that track, needed to convert the raw tick count to seconds.
+*
+* ## Presumptive vs. track-selected reads
+*
+* The two variants share only the leaf field-readers (`mdhd` timescale, `tfdt`
+* baseMediaDecodeTime) and the box walker. Everything else differs, and the
+* split is deliberate so the presumptive pair is *proportionally* smaller under
+* tree-shaking:
+*
+* - **Presumptive** — {@link readFirstMediaTimescale} / {@link readFirstBaseMediaDecodeTime}
+*   read the first `mdhd` timescale and first `tfdt` baseMediaDecodeTime. There's
+*   no `track_id` (nothing to match against) and no `trak`/`traf` iteration — a
+*   direct `findBox` to the first leaf. Correct when the init/segment holds a
+*   single media track (the common CMAF case). A caption-free platform imports
+*   only this pair and tree-shakes away all the matching machinery below.
+* - **Track-selected** — {@link findMediaTrack} / {@link readBaseMediaDecodeTime}.
+*   `findMediaTrack` returns `{ trackId, timescale }` for the `trak` whose `hdlr`
+*   handler matches; `readBaseMediaDecodeTime` takes that `trackId` and reads the
+*   `traf` whose `tfhd.track_id` matches. The `track_id` is the join that ties one
+*   track's timescale to the *same* track's baseMediaDecodeTime — required when a
+*   source muxes CEA-608/708 captions (a `clcp` track shares the same `moov` and
+*   `moof`, each track with its own timescale + baseMediaDecodeTime, so a
+*   presumptive read there risks `300000 / 6000 = 50s` instead of
+*   `60000 / 6000 = 10s`). This pair adds `trak`/`traf` iteration plus the handler
+*   and `track_id` reads. We only ever ask for buffered media handlers
+*   (`vide` / `soun`); the caption track is never selected — we read the origin,
+*   not the captions (caption *rendering* is out of scope).
+*
+* Both raw values are returned un-divided to leave room for an edit-list (`elst`)
+* presentation-time correction term if a source ever carries one — the validated
+* streams do not.
+*/
+/**
+* The `track_ID` + timescale of the `trak` whose `mdhd` handler matches
+* `handlerType`, skipping a muxed `clcp` caption track. `undefined` if no
+* matching track exists.
+*/
+function findMediaTrack(initSegment, handlerType) {
+	const view = toDataView(initSegment);
+	const moov = findBox(view, ["moov"]);
+	if (!moov) return void 0;
+	for (const trak of iterateBoxesOfType(view, "trak", moov.dataStart, moov.end)) {
+		if (readTrakHandler(view, trak) !== handlerType) continue;
+		const tkhd = findBox(view, ["tkhd"], trak.dataStart, trak.end);
+		const mdhd = findBox(view, ["mdia", "mdhd"], trak.dataStart, trak.end);
+		if (!tkhd || !mdhd) return void 0;
+		return {
+			trackId: view.getUint32(tkhd.dataStart + 4 + (readFullBoxVersion(view, tkhd.dataStart) === 1 ? 16 : 8)),
+			timescale: readMdhdTimescale(view, mdhd)
+		};
+	}
+}
+/**
+* `baseMediaDecodeTime` (in the track's media timescale) from the `traf` matching
+* `trackId` (via `tfhd.track_id`) — required for muxed multi-`traf` segments.
+* `undefined` if no matching `tfdt` exists.
+*/
+function readBaseMediaDecodeTime(mediaSegment, trackId) {
+	const view = toDataView(mediaSegment);
+	const moof = findBox(view, ["moof"]);
+	if (!moof) return void 0;
+	for (const traf of iterateBoxesOfType(view, "traf", moof.dataStart, moof.end)) {
+		if (readTrafTrackId(view, traf) !== trackId) continue;
+		const tfdt = findBox(view, ["tfdt"], traf.dataStart, traf.end);
+		return tfdt ? readTfdtBaseMediaDecodeTime(view, tfdt) : void 0;
+	}
+}
+/** `mdhd.timescale`: FullBox version(1)+flags(3) + dates (v0: 4+4, v1: 8+8) + timescale. */
+function readMdhdTimescale(view, mdhd) {
+	return view.getUint32(mdhd.dataStart + 4 + (readFullBoxVersion(view, mdhd.dataStart) === 1 ? 16 : 8));
+}
+/** `tfdt.baseMediaDecodeTime`: FullBox, then the value — v0: (4), v1: (8). */
+function readTfdtBaseMediaDecodeTime(view, tfdt) {
+	const at = tfdt.dataStart + 4;
+	return readFullBoxVersion(view, tfdt.dataStart) === 1 ? Number(view.getBigUint64(at)) : view.getUint32(at);
+}
+/** `hdlr.handler_type` for a `trak`: FullBox version(1)+flags(3) + pre_defined(4) + handler_type(4). */
+function readTrakHandler(view, trak) {
+	const hdlr = findBox(view, ["mdia", "hdlr"], trak.dataStart, trak.end);
+	return hdlr ? readFourCC(view, hdlr.dataStart + 8) : void 0;
+}
+/** `tfhd.track_id` for a `traf`: FullBox version(1)+flags(3) + track_id(4). */
+function readTrafTrackId(view, traf) {
+	const tfhd = findBox(view, ["tfhd"], traf.dataStart, traf.end);
+	return tfhd ? view.getUint32(tfhd.dataStart + 4) : void 0;
+}
+//#endregion
+export { findMediaTrack, readBaseMediaDecodeTime };
+
+//# sourceMappingURL=timestamp-origin.js.map

package/dist/default/media/mp4/timestamp-origin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamp-origin.js","names":[],"sources":["../../../../src/media/mp4/timestamp-origin.ts"],"sourcesContent":["/**\n * Decode-time origin extraction from fMP4/CMAF segments.\n *\n * Non-zero-PTS sources encode media at a non-zero start time (an instant clip\n * starting at asset second 60, an Apple bipbop asset starting at 10s, …). To\n * relocate such a source onto a 0-based presentation timeline via\n * `SourceBuffer.timestampOffset`, the engine needs that start time — the\n * **decode-time origin** — read straight from the container:\n *\n * - `tfdt.baseMediaDecodeTime` (from a media segment's `moof`) — the decode\n *   time of the segment's first sample, in the track's media timescale. This is\n *   a DTS: relocating by `−(baseMediaDecodeTime / timescale)` lands the earliest\n *   DTS at exactly 0, so a negative-DTS append failure on Chromium is impossible\n *   by construction.\n * - `mdhd.timescale` (from the init segment's `moov`) — ticks per second for\n *   that track, needed to convert the raw tick count to seconds.\n *\n * ## Presumptive vs. track-selected reads\n *\n * The two variants share only the leaf field-readers (`mdhd` timescale, `tfdt`\n * baseMediaDecodeTime) and the box walker. Everything else differs, and the\n * split is deliberate so the presumptive pair is *proportionally* smaller under\n * tree-shaking:\n *\n * - **Presumptive** — {@link readFirstMediaTimescale} / {@link readFirstBaseMediaDecodeTime}\n *   read the first `mdhd` timescale and first `tfdt` baseMediaDecodeTime. There's\n *   no `track_id` (nothing to match against) and no `trak`/`traf` iteration — a\n *   direct `findBox` to the first leaf. Correct when the init/segment holds a\n *   single media track (the common CMAF case). A caption-free platform imports\n *   only this pair and tree-shakes away all the matching machinery below.\n * - **Track-selected** — {@link findMediaTrack} / {@link readBaseMediaDecodeTime}.\n *   `findMediaTrack` returns `{ trackId, timescale }` for the `trak` whose `hdlr`\n *   handler matches; `readBaseMediaDecodeTime` takes that `trackId` and reads the\n *   `traf` whose `tfhd.track_id` matches. The `track_id` is the join that ties one\n *   track's timescale to the *same* track's baseMediaDecodeTime — required when a\n *   source muxes CEA-608/708 captions (a `clcp` track shares the same `moov` and\n *   `moof`, each track with its own timescale + baseMediaDecodeTime, so a\n *   presumptive read there risks `300000 / 6000 = 50s` instead of\n *   `60000 / 6000 = 10s`). This pair adds `trak`/`traf` iteration plus the handler\n *   and `track_id` reads. We only ever ask for buffered media handlers\n *   (`vide` / `soun`); the caption track is never selected — we read the origin,\n *   not the captions (caption *rendering* is out of scope).\n *\n * Both raw values are returned un-divided to leave room for an edit-list (`elst`)\n * presentation-time correction term if a source ever carries one — the validated\n * streams do not.\n */\nimport { type Box, findBox, iterateBoxesOfType, readFourCC, readFullBoxVersion, toDataView } from './box';\n\n/** MSE-buffered media handler types (`mdhd`/`hdlr`). Captions/subtitles excluded. */\nexport type MediaHandlerType = 'vide' | 'soun';\n\nexport interface MediaTrackInfo {\n  /** `tkhd.track_id` — used to match the corresponding `traf` in media segments. */\n  trackId: number;\n  /** `mdhd.timescale` — ticks per second for this track. */\n  timescale: number;\n}\n\n// --- presumptive: first leaf, no track_id, no iteration -----------------------\n\n/**\n * Presumptive: the `timescale` of the **first** `mdhd` in an init segment.\n * Correct only for single-media-track inits — for muxed captions use\n * {@link findMediaTrack}. `undefined` if no `mdhd` exists.\n */\nexport function readFirstMediaTimescale(initSegment: ArrayBuffer | Uint8Array): number | undefined {\n  const view = toDataView(initSegment);\n  const mdhd = findBox(view, ['moov', 'trak', 'mdia', 'mdhd']);\n  return mdhd ? readMdhdTimescale(view, mdhd) : undefined;\n}\n\n/**\n * Presumptive: `baseMediaDecodeTime` from the **first** `tfdt` of a media\n * segment. Correct only for single-`traf` segments — for muxed captions use\n * {@link readBaseMediaDecodeTime}. `undefined` if no `tfdt` exists.\n */\nexport function readFirstBaseMediaDecodeTime(mediaSegment: ArrayBuffer | Uint8Array): number | undefined {\n  const view = toDataView(mediaSegment);\n  const tfdt = findBox(view, ['moof', 'traf', 'tfdt']);\n  return tfdt ? readTfdtBaseMediaDecodeTime(view, tfdt) : undefined;\n}\n\n// --- track-selected: iterate + match by handler / track_id --------------------\n\n/**\n * The `track_ID` + timescale of the `trak` whose `mdhd` handler matches\n * `handlerType`, skipping a muxed `clcp` caption track. `undefined` if no\n * matching track exists.\n */\nexport function findMediaTrack(\n  initSegment: ArrayBuffer | Uint8Array,\n  handlerType: MediaHandlerType\n): MediaTrackInfo | undefined {\n  const view = toDataView(initSegment);\n  const moov = findBox(view, ['moov']);\n  if (!moov) return undefined;\n\n  for (const trak of iterateBoxesOfType(view, 'trak', moov.dataStart, moov.end)) {\n    if (readTrakHandler(view, trak) !== handlerType) continue;\n    const tkhd = findBox(view, ['tkhd'], trak.dataStart, trak.end);\n    const mdhd = findBox(view, ['mdia', 'mdhd'], trak.dataStart, trak.end);\n    if (!tkhd || !mdhd) return undefined;\n    // tkhd FullBox: version(1)+flags(3), creation/modification dates (v0: 4+4, v1:\n    // 8+8), then track_id.\n    const trackId = view.getUint32(tkhd.dataStart + 4 + (readFullBoxVersion(view, tkhd.dataStart) === 1 ? 16 : 8));\n    return { trackId, timescale: readMdhdTimescale(view, mdhd) };\n  }\n  return undefined;\n}\n\n/**\n * `baseMediaDecodeTime` (in the track's media timescale) from the `traf` matching\n * `trackId` (via `tfhd.track_id`) — required for muxed multi-`traf` segments.\n * `undefined` if no matching `tfdt` exists.\n */\nexport function readBaseMediaDecodeTime(mediaSegment: ArrayBuffer | Uint8Array, trackId: number): number | undefined {\n  const view = toDataView(mediaSegment);\n  const moof = findBox(view, ['moof']);\n  if (!moof) return undefined;\n\n  for (const traf of iterateBoxesOfType(view, 'traf', moof.dataStart, moof.end)) {\n    if (readTrafTrackId(view, traf) !== trackId) continue;\n    const tfdt = findBox(view, ['tfdt'], traf.dataStart, traf.end);\n    return tfdt ? readTfdtBaseMediaDecodeTime(view, tfdt) : undefined;\n  }\n  return undefined;\n}\n\n// --- shared leaf field-readers ------------------------------------------------\n\n/** `mdhd.timescale`: FullBox version(1)+flags(3) + dates (v0: 4+4, v1: 8+8) + timescale. */\nfunction readMdhdTimescale(view: DataView, mdhd: Box): number {\n  return view.getUint32(mdhd.dataStart + 4 + (readFullBoxVersion(view, mdhd.dataStart) === 1 ? 16 : 8));\n}\n\n/** `tfdt.baseMediaDecodeTime`: FullBox, then the value — v0: (4), v1: (8). */\nfunction readTfdtBaseMediaDecodeTime(view: DataView, tfdt: Box): number {\n  const at = tfdt.dataStart + 4;\n  return readFullBoxVersion(view, tfdt.dataStart) === 1 ? Number(view.getBigUint64(at)) : view.getUint32(at);\n}\n\n// --- track-selection readers (referenced only by the track-selected variants) -\n\n/** `hdlr.handler_type` for a `trak`: FullBox version(1)+flags(3) + pre_defined(4) + handler_type(4). */\nfunction readTrakHandler(view: DataView, trak: Box): string | undefined {\n  const hdlr = findBox(view, ['mdia', 'hdlr'], trak.dataStart, trak.end);\n  return hdlr ? readFourCC(view, hdlr.dataStart + 8) : undefined;\n}\n\n/** `tfhd.track_id` for a `traf`: FullBox version(1)+flags(3) + track_id(4). */\nfunction readTrafTrackId(view: DataView, traf: Box): number | undefined {\n  const tfhd = findBox(view, ['tfhd'], traf.dataStart, traf.end);\n  return tfhd ? view.getUint32(tfhd.dataStart + 4) : undefined;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0FA,SAAgB,eACd,aACA,aAC4B;CAC5B,MAAM,OAAO,WAAW,WAAW;CACnC,MAAM,OAAO,QAAQ,MAAM,CAAC,MAAM,CAAC;CACnC,IAAI,CAAC,MAAM,OAAO,KAAA;CAElB,KAAK,MAAM,QAAQ,mBAAmB,MAAM,QAAQ,KAAK,WAAW,KAAK,GAAG,GAAG;EAC7E,IAAI,gBAAgB,MAAM,IAAI,MAAM,aAAa;EACjD,MAAM,OAAO,QAAQ,MAAM,CAAC,MAAM,GAAG,KAAK,WAAW,KAAK,GAAG;EAC7D,MAAM,OAAO,QAAQ,MAAM,CAAC,QAAQ,MAAM,GAAG,KAAK,WAAW,KAAK,GAAG;EACrE,IAAI,CAAC,QAAQ,CAAC,MAAM,OAAO,KAAA;EAI3B,OAAO;GAAE,SADO,KAAK,UAAU,KAAK,YAAY,KAAK,mBAAmB,MAAM,KAAK,SAAS,MAAM,IAAI,KAAK,EAC5F;GAAG,WAAW,kBAAkB,MAAM,IAAI;EAAE;CAC7D;AAEF;;;;;;AAOA,SAAgB,wBAAwB,cAAwC,SAAqC;CACnH,MAAM,OAAO,WAAW,YAAY;CACpC,MAAM,OAAO,QAAQ,MAAM,CAAC,MAAM,CAAC;CACnC,IAAI,CAAC,MAAM,OAAO,KAAA;CAElB,KAAK,MAAM,QAAQ,mBAAmB,MAAM,QAAQ,KAAK,WAAW,KAAK,GAAG,GAAG;EAC7E,IAAI,gBAAgB,MAAM,IAAI,MAAM,SAAS;EAC7C,MAAM,OAAO,QAAQ,MAAM,CAAC,MAAM,GAAG,KAAK,WAAW,KAAK,GAAG;EAC7D,OAAO,OAAO,4BAA4B,MAAM,IAAI,IAAI,KAAA;CAC1D;AAEF;;AAKA,SAAS,kBAAkB,MAAgB,MAAmB;CAC5D,OAAO,KAAK,UAAU,KAAK,YAAY,KAAK,mBAAmB,MAAM,KAAK,SAAS,MAAM,IAAI,KAAK,EAAE;AACtG;;AAGA,SAAS,4BAA4B,MAAgB,MAAmB;CACtE,MAAM,KAAK,KAAK,YAAY;CAC5B,OAAO,mBAAmB,MAAM,KAAK,SAAS,MAAM,IAAI,OAAO,KAAK,aAAa,EAAE,CAAC,IAAI,KAAK,UAAU,EAAE;AAC3G;;AAKA,SAAS,gBAAgB,MAAgB,MAA+B;CACtE,MAAM,OAAO,QAAQ,MAAM,CAAC,QAAQ,MAAM,GAAG,KAAK,WAAW,KAAK,GAAG;CACrE,OAAO,OAAO,WAAW,MAAM,KAAK,YAAY,CAAC,IAAI,KAAA;AACvD;;AAGA,SAAS,gBAAgB,MAAgB,MAA+B;CACtE,MAAM,OAAO,QAAQ,MAAM,CAAC,MAAM,GAAG,KAAK,WAAW,KAAK,GAAG;CAC7D,OAAO,OAAO,KAAK,UAAU,KAAK,YAAY,CAAC,IAAI,KAAA;AACrD"}

package/dist/default/media/primitives/select-tracks.js

@@ -29,29 +29,6 @@ function pickFirstTrackId(presentation, type) {
 	return presentation.selectionSets?.find((set) => set.type === type)?.switchingSets[0]?.tracks[0]?.id;
 }
 /**
-* Translates a "max resolution" into a total total pixel area
-* for comparisons with video track resolutions with an assumed
-* 16:9 ratio.
-*
-* Example: "720p" translates to a 921600 pixel area.
-*
-* Because 720 * 1280 = 720 * (720 * (16/9) ) = 921_600
-*
-* Accepts:
-* - string with the format '{height}p'. ('720p')
-* - bare number, interpreted as pixel area. (921_600)
-* - anything else will translate to `+Infinity`, meaning no cap specified
-*/
-function maxResolutionToPixelArea(value) {
-	if (value === void 0 || value === null) return Number.POSITIVE_INFINITY;
-	if (typeof value === "number") return Number.isFinite(value) && value > 0 ? value : Number.POSITIVE_INFINITY;
-	const match = value.trim().match(/^(\d+)p?$/i);
-	if (!match) return Number.POSITIVE_INFINITY;
-	const height = Number(match[1]);
-	if (!(Number.isFinite(height) && height > 0)) return Number.POSITIVE_INFINITY;
-	return height * height * 16 / 9;
-}
-/**
 * Pick the track with the highest pixel area at or below `maxPixelArea`.
 * Falls back to the lowest track when nothing satisfies the cap (the
 * lowest of the above-cap set is the closest to the cap from above).
@@ -125,6 +102,6 @@ function pickTextTrackFromTracks(tracks, config) {
 	}
 }
 //#endregion
-export { matchesPartialTrack, maxResolutionToPixelArea, pickAudioTrack, pickFirstTrackId, pickHighestResolutionVideoTrack, pickTextTrackFromTracks, pickTrackUnderPixelArea };
+export { matchesPartialTrack, pickAudioTrack, pickFirstTrackId, pickHighestResolutionVideoTrack, pickTextTrackFromTracks, pickTrackUnderPixelArea };
 
 //# sourceMappingURL=select-tracks.js.map