@videojs/spf 10.0.0-beta.24 → 10.0.0-beta.26

package/dist/dev/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  }\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        });\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\n  const videoTracks: PartiallyResolvedVideoTrack[] = videoStreams.map((stream) => {\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.audioGroupId = stream.audioGroupId;\n    }\n\n    return track;\n  });\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: 2, // 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      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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"}

package/dist/dev/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/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

package/dist/dev/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/dev/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/dev/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/dev/media/primitives/select-tracks.d.ts

@@ -0,0 +1,35 @@
+import { MaybeResolvedPresentation } from "../types/index.js";
+//#region src/media/primitives/select-tracks.d.ts
+/**
+ * Configuration for video track selection.
+ */
+interface VideoSelectionConfig {
+  /**
+   * Initial bandwidth estimate for cold start (bits per second).
+   * Used to select video quality before we have real measurements.
+   * Default: 1 Mbps (conservative).
+   */
+  initialBandwidth?: number;
+  /**
+   * Safety margin for quality selection (0-1).
+   * Default: 0.85 (15% headroom).
+   */
+  safetyMargin?: number;
+}
+/**
+ * Contract for a track picker — a pure function that consults a
+ * presentation (and optional config) and returns the id of the track to
+ * select, or `undefined` to leave the slot unset.
+ *
+ * Behaviors that own a track-selection slot (`selectAudioTrack`,
+ * `selectVideoTrack`, `switchVideoTrack`) accept a
+ * `TrackPicker` via config. The behavior passes its own config straight
+ * through as the picker's second argument — pickers that need richer
+ * options (language preferences, default-track filtering, bandwidth-aware
+ * selection) read from `config`; pickers that don't (e.g., first-track)
+ * ignore it.
+ */
+type TrackPicker<Config = unknown> = (presentation: MaybeResolvedPresentation, config?: Config) => string | undefined;
+//#endregion
+export { TrackPicker, VideoSelectionConfig };
+//# sourceMappingURL=select-tracks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"select-tracks.d.ts","names":[],"sources":["../../../../src/media/primitives/select-tracks.ts"],"mappings":";;;;;UA0CiB;;;;;;EAMf;;;;;EAMA;;;;;;;;;;;;;;;KA8DU,YAAY,qBACtB,cAAc,2BACd,SAAS"}

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

@@ -1,5 +1,22 @@
 //#region src/media/primitives/select-tracks.ts
 /**
+* Test whether a track matches a partial-track description: every present,
+* defined field of `filter` equals the track's. Absent or `undefined` filter
+* fields don't constrain. Used to narrow candidates by a user selection
+* (`{ id }`, `{ language }`, `{ height }`, …).
+*
+* @param track - The track to test
+* @param filter - Partial-track description; only present, defined fields constrain
+* @returns `true` when the track matches every constraining field
+*/
+function matchesPartialTrack(track, filter) {
+	for (const key in filter) {
+		const filterValue = filter[key];
+		if (filterValue !== void 0 && track[key] !== filterValue) return false;
+	}
+	return true;
+}
+/**
 * Pick the first track of the given type from a presentation.
 *
 * Returns the first track in the first switching set of the matching
@@ -12,21 +29,89 @@ function pickFirstTrackId(presentation, type) {
 	return presentation.selectionSets?.find((set) => set.type === type)?.switchingSets[0]?.tracks[0]?.id;
 }
 /**
-* Pick text track to activate. Conforms to the `TrackPicker` contract so it
-* can be used directly as a default picker for `selectTextTrack` without an
-* adapter wrapper.
+* 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).
+* Tiebreak on bandwidth. Missing dimensions are treated as area `0`.
+*/
+function pickTrackUnderPixelArea(tracks, maxPixelArea = Number.POSITIVE_INFINITY) {
+	if (tracks.length === 0) return void 0;
+	const sorted = [...tracks].sort((a, b) => (b.width ?? 0) * (b.height ?? 0) - (a.width ?? 0) * (a.height ?? 0) || (b.bandwidth ?? 0) - (a.bandwidth ?? 0));
+	return sorted.find((t) => (t.width ?? 0) * (t.height ?? 0) <= maxPixelArea) ?? sorted[sorted.length - 1];
+}
+/**
+* Pick the video track with the highest pixel area.
+*
+* Pair with `selectVideoTrack`; compose `switchVideoQuality` instead
+* for runtime-adapted quality.
+*/
+function pickHighestResolutionVideoTrack(presentation) {
+	const tracks = (presentation.selectionSets?.find((set) => set.type === "video"))?.switchingSets[0]?.tracks;
+	if (!tracks?.length) return void 0;
+	return pickTrackUnderPixelArea(tracks)?.id;
+}
+/**
+* Pick audio track.
 *
-* Selection priority (if enabled):
-* 1. User preference (preferredSubtitleLanguage)
-* 2. DEFAULT track (if enableDefaultTrack is true and track has DEFAULT=YES + AUTOSELECT=YES)
-* 3. No auto-selection (user opt-in)
+* Selection priority:
+* 1. First track matching preferred language (if specified)
+* 2. First default track
+* 3. First audio track
+*
+* @param presentation - Presentation with audio tracks
+* @param config - Selection configuration (preferred language)
+* @returns Selected audio track ID, or undefined if no audio tracks
+*/
+function pickAudioTrack(presentation, config) {
+	const audioSet = presentation.selectionSets?.find((set) => set.type === "audio");
+	if (!audioSet || audioSet.switchingSets.length === 0) return;
+	const switchingSet = audioSet.switchingSets[0];
+	if (!switchingSet || switchingSet.tracks.length === 0) return;
+	const tracks = switchingSet.tracks;
+	if (config?.preferredAudioLanguage) {
+		const languageMatch = tracks.find((track) => track.language === config.preferredAudioLanguage);
+		if (languageMatch) return languageMatch.id;
+	}
+	const defaultTrack = tracks.find((track) => track.default === true);
+	if (defaultTrack) return defaultTrack.id;
+	return tracks[0]?.id;
+}
+/**
+* Default text-track policy over an explicit candidate list (rather than a whole
+* presentation): the opt-in three-tier pick `pickTextTrack` delegates to, factored
+* out so a caller that has already narrowed the candidates — a constrained,
+* CDN-scoped track-switching chain — applies the same policy without re-deriving
+* from the presentation.
 *
-* By default, FORCED tracks are excluded per Apple's HLS spec.
+* Priority: `preferredSubtitleLanguage` match → `DEFAULT=YES + AUTOSELECT=YES`
+* (only when `enableDefaultTrack`) → `undefined` (opt-in). FORCED tracks are
+* excluded unless `includeForcedTracks` (Apple-spec: a regular track must carry
+* forced content when both exist, so a forced-only track is redundant).
 */
-function pickTextTrack(presentation, config) {
-	const textSet = presentation.selectionSets?.find((set) => set.type === "text");
-	if (!textSet?.switchingSets?.[0]?.tracks.length) return void 0;
-	const tracks = textSet.switchingSets[0].tracks;
+function pickTextTrackFromTracks(tracks, config) {
 	const availableTracks = config?.includeForcedTracks ? tracks : tracks.filter((track) => !track.forced);
 	if (availableTracks.length === 0) return void 0;
 	const { preferredSubtitleLanguage, enableDefaultTrack = false } = config ?? {};
@@ -40,6 +125,6 @@ function pickTextTrack(presentation, config) {
 	}
 }
 //#endregion
-export { pickFirstTrackId, pickTextTrack };
+export { matchesPartialTrack, maxResolutionToPixelArea, pickAudioTrack, pickFirstTrackId, pickHighestResolutionVideoTrack, pickTextTrackFromTracks, pickTrackUnderPixelArea };
 
 //# sourceMappingURL=select-tracks.js.map