@videojs/spf 10.0.0-beta.1 → 10.0.0-beta.11

package/dist/default/core/hls/parse-media-playlist.js

@@ -0,0 +1,83 @@
+import { matchTag, parseByteRange, parseExtInfDuration } from "./parse-attributes.js";
+import { resolveUrl } from "./resolve-url.js";
+
+//#region src/core/hls/parse-media-playlist.ts
+/**
+* Parse HLS media playlist and resolve track with segments.
+*
+* Takes an unresolved track (from multivariant playlist) and media playlist text,
+* returns a HAM-compliant resolved track with segments.
+*
+* @param text - Media playlist text content
+* @param unresolved - Unresolved track from parseMultivariantPlaylist
+* @returns Resolved track with segments (type inferred from input)
+*/
+function parseMediaPlaylist(text, unresolved) {
+	const lines = text.split(/\r?\n/);
+	const baseUrl = unresolved.url;
+	const segments = [];
+	let initSegmentUrl;
+	let initSegmentByteRange;
+	let currentDuration = 0;
+	let currentByteRange;
+	let currentTime = 0;
+	let segmentIndex = 0;
+	let previousByteRangeEnd;
+	for (const line of lines) {
+		const trimmed = line.trim();
+		if (!trimmed || trimmed.startsWith("#") && !trimmed.startsWith("#EXT")) continue;
+		if (trimmed === "#EXTM3U" || trimmed.startsWith("#EXT-X-VERSION:") || trimmed.startsWith("#EXT-X-TARGETDURATION:") || trimmed.startsWith("#EXT-X-PLAYLIST-TYPE:") || trimmed.startsWith("#EXT-X-INDEPENDENT-SEGMENTS")) continue;
+		const mapAttrs = matchTag(trimmed, "EXT-X-MAP");
+		if (mapAttrs) {
+			const uri = mapAttrs.get("URI");
+			if (uri) {
+				initSegmentUrl = resolveUrl(uri, baseUrl);
+				const byteRangeStr = mapAttrs.get("BYTERANGE");
+				if (byteRangeStr) initSegmentByteRange = parseByteRange(byteRangeStr, 0) ?? void 0;
+			}
+			continue;
+		}
+		if (trimmed.startsWith("#EXTINF:")) {
+			currentDuration = parseExtInfDuration(trimmed.slice(8));
+			continue;
+		}
+		if (trimmed.startsWith("#EXT-X-BYTERANGE:")) {
+			currentByteRange = parseByteRange(trimmed.slice(17), previousByteRangeEnd) ?? void 0;
+			continue;
+		}
+		if (trimmed === "#EXT-X-ENDLIST") continue;
+		if (!trimmed.startsWith("#") && currentDuration > 0) {
+			const segment = {
+				id: `segment-${segmentIndex}`,
+				url: resolveUrl(trimmed, baseUrl),
+				duration: currentDuration,
+				startTime: currentTime
+			};
+			if (currentByteRange) {
+				segment.byteRange = currentByteRange;
+				previousByteRangeEnd = currentByteRange.end + 1;
+			} else previousByteRangeEnd = void 0;
+			segments.push(segment);
+			currentTime += currentDuration;
+			segmentIndex++;
+			currentDuration = 0;
+			currentByteRange = void 0;
+		}
+	}
+	const totalDuration = currentTime;
+	const initialization = unresolved.type === "text" && !initSegmentUrl ? void 0 : initSegmentUrl ? {
+		url: initSegmentUrl,
+		...initSegmentByteRange ? { byteRange: initSegmentByteRange } : {}
+	} : { url: "" };
+	return {
+		...unresolved,
+		startTime: 0,
+		duration: totalDuration,
+		segments,
+		initialization
+	};
+}
+
+//#endregion
+export { parseMediaPlaylist };
+//# sourceMappingURL=parse-media-playlist.js.map

package/dist/default/core/hls/parse-media-playlist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-media-playlist.js","names":[],"sources":["../../../../src/core/hls/parse-media-playlist.ts"],"sourcesContent":["import type {\n  AudioTrack,\n  PartiallyResolvedAudioTrack,\n  PartiallyResolvedTextTrack,\n  PartiallyResolvedTrack,\n  PartiallyResolvedVideoTrack,\n  Segment,\n  TextTrack,\n  VideoTrack,\n} from '../types';\nimport { matchTag, parseByteRange, parseExtInfDuration } from './parse-attributes';\nimport { resolveUrl } from './resolve-url';\n\n/**\n * Resolve unresolved track type to its resolved equivalent.\n */\ntype ResolveTrack<T> = T extends PartiallyResolvedVideoTrack\n  ? VideoTrack\n  : T extends PartiallyResolvedAudioTrack\n    ? AudioTrack\n    : T extends PartiallyResolvedTextTrack\n      ? TextTrack\n      : never;\n\n/**\n * Parse HLS media playlist and resolve track with segments.\n *\n * Takes an unresolved track (from multivariant playlist) and media playlist text,\n * returns a HAM-compliant resolved track with segments.\n *\n * @param text - Media playlist text content\n * @param unresolved - Unresolved track from parseMultivariantPlaylist\n * @returns Resolved track with segments (type inferred from input)\n */\nexport function parseMediaPlaylist<T extends PartiallyResolvedTrack>(\n  text: string,\n  unresolved: T | ResolveTrack<T>\n): ResolveTrack<T> {\n  const lines = text.split(/\\r?\\n/);\n\n  // Segments and resources resolve relative to media playlist URL (per HLS spec)\n  const baseUrl = unresolved.url;\n\n  // Parse playlist\n  const segments: Segment[] = [];\n  let initSegmentUrl: string | undefined;\n  let initSegmentByteRange: { start: number; end: number } | undefined;\n\n  let currentDuration = 0;\n  let currentByteRange: { start: number; end: number } | undefined;\n  let currentTime = 0;\n  let segmentIndex = 0;\n  let previousByteRangeEnd: number | undefined;\n\n  for (const line of lines) {\n    const trimmed = line.trim();\n\n    if (!trimmed || (trimmed.startsWith('#') && !trimmed.startsWith('#EXT'))) {\n      continue;\n    }\n\n    if (\n      trimmed === '#EXTM3U' ||\n      trimmed.startsWith('#EXT-X-VERSION:') ||\n      trimmed.startsWith('#EXT-X-TARGETDURATION:') ||\n      trimmed.startsWith('#EXT-X-PLAYLIST-TYPE:') ||\n      trimmed.startsWith('#EXT-X-INDEPENDENT-SEGMENTS')\n    ) {\n      continue;\n    }\n\n    // #EXT-X-MAP - Init segment\n    const mapAttrs = matchTag(trimmed, 'EXT-X-MAP');\n    if (mapAttrs) {\n      const uri = mapAttrs.get('URI');\n      if (uri) {\n        initSegmentUrl = resolveUrl(uri, baseUrl);\n        const byteRangeStr = mapAttrs.get('BYTERANGE');\n        if (byteRangeStr) {\n          initSegmentByteRange = parseByteRange(byteRangeStr, 0) ?? undefined;\n        }\n      }\n      continue;\n    }\n\n    // #EXTINF - Segment duration\n    if (trimmed.startsWith('#EXTINF:')) {\n      currentDuration = parseExtInfDuration(trimmed.slice(8));\n      continue;\n    }\n\n    // #EXT-X-BYTERANGE - Segment byte range\n    if (trimmed.startsWith('#EXT-X-BYTERANGE:')) {\n      currentByteRange = parseByteRange(trimmed.slice(17), previousByteRangeEnd) ?? undefined;\n      continue;\n    }\n\n    if (trimmed === '#EXT-X-ENDLIST') {\n      continue;\n    }\n\n    // Segment URI\n    if (!trimmed.startsWith('#') && currentDuration > 0) {\n      const segment: Segment = {\n        id: `segment-${segmentIndex}`,\n        url: resolveUrl(trimmed, baseUrl),\n        duration: currentDuration,\n        startTime: currentTime,\n      };\n\n      if (currentByteRange) {\n        segment.byteRange = currentByteRange;\n        previousByteRangeEnd = currentByteRange.end + 1;\n      } else {\n        previousByteRangeEnd = undefined;\n      }\n\n      segments.push(segment);\n      currentTime += currentDuration;\n      segmentIndex++;\n\n      currentDuration = 0;\n      currentByteRange = undefined;\n    }\n  }\n\n  const totalDuration = currentTime;\n\n  // Build initialization (VTT may not have init segment)\n  const initialization =\n    unresolved.type === 'text' && !initSegmentUrl\n      ? undefined\n      : initSegmentUrl\n        ? { url: initSegmentUrl, ...(initSegmentByteRange ? { byteRange: initSegmentByteRange } : {}) }\n        : { url: '' };\n\n  // Generic resolution: All type-specific fields already on unresolved track from P1\n  // Just add parsed properties (startTime, duration, segments, initialization)\n  return {\n    ...unresolved,\n    startTime: 0,\n    duration: totalDuration,\n    segments,\n    initialization,\n  } as unknown as ResolveTrack<T>;\n}\n"],"mappings":";;;;;;;;;;;;;;AAkCA,SAAgB,mBACd,MACA,YACiB;CACjB,MAAM,QAAQ,KAAK,MAAM,QAAQ;CAGjC,MAAM,UAAU,WAAW;CAG3B,MAAM,WAAsB,EAAE;CAC9B,IAAI;CACJ,IAAI;CAEJ,IAAI,kBAAkB;CACtB,IAAI;CACJ,IAAI,cAAc;CAClB,IAAI,eAAe;CACnB,IAAI;AAEJ,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,UAAU,KAAK,MAAM;AAE3B,MAAI,CAAC,WAAY,QAAQ,WAAW,IAAI,IAAI,CAAC,QAAQ,WAAW,OAAO,CACrE;AAGF,MACE,YAAY,aACZ,QAAQ,WAAW,kBAAkB,IACrC,QAAQ,WAAW,yBAAyB,IAC5C,QAAQ,WAAW,wBAAwB,IAC3C,QAAQ,WAAW,8BAA8B,CAEjD;EAIF,MAAM,WAAW,SAAS,SAAS,YAAY;AAC/C,MAAI,UAAU;GACZ,MAAM,MAAM,SAAS,IAAI,MAAM;AAC/B,OAAI,KAAK;AACP,qBAAiB,WAAW,KAAK,QAAQ;IACzC,MAAM,eAAe,SAAS,IAAI,YAAY;AAC9C,QAAI,aACF,wBAAuB,eAAe,cAAc,EAAE,IAAI;;AAG9D;;AAIF,MAAI,QAAQ,WAAW,WAAW,EAAE;AAClC,qBAAkB,oBAAoB,QAAQ,MAAM,EAAE,CAAC;AACvD;;AAIF,MAAI,QAAQ,WAAW,oBAAoB,EAAE;AAC3C,sBAAmB,eAAe,QAAQ,MAAM,GAAG,EAAE,qBAAqB,IAAI;AAC9E;;AAGF,MAAI,YAAY,iBACd;AAIF,MAAI,CAAC,QAAQ,WAAW,IAAI,IAAI,kBAAkB,GAAG;GACnD,MAAM,UAAmB;IACvB,IAAI,WAAW;IACf,KAAK,WAAW,SAAS,QAAQ;IACjC,UAAU;IACV,WAAW;IACZ;AAED,OAAI,kBAAkB;AACpB,YAAQ,YAAY;AACpB,2BAAuB,iBAAiB,MAAM;SAE9C,wBAAuB;AAGzB,YAAS,KAAK,QAAQ;AACtB,kBAAe;AACf;AAEA,qBAAkB;AAClB,sBAAmB;;;CAIvB,MAAM,gBAAgB;CAGtB,MAAM,iBACJ,WAAW,SAAS,UAAU,CAAC,iBAC3B,SACA,iBACE;EAAE,KAAK;EAAgB,GAAI,uBAAuB,EAAE,WAAW,sBAAsB,GAAG,EAAE;EAAG,GAC7F,EAAE,KAAK,IAAI;AAInB,QAAO;EACL,GAAG;EACH,WAAW;EACX,UAAU;EACV;EACA;EACD"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse-multivariant.js","names":[],"sources":["../../../../src/core/hls/parse-multivariant.ts"],"sourcesContent":["import 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 { generateId } from '../utils/generate-id';\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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"}

package/dist/default/core/hls/resolve-url.js

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

package/dist/default/core/hls/resolve-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-url.js","names":[],"sources":["../../../../src/core/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"}

package/dist/default/core/reactive/combine-latest.js

@@ -0,0 +1,72 @@
+//#region src/core/reactive/combine-latest.ts
+/**
+* Combines multiple Observable sources into a single Observable.
+*
+* Emits an array of latest values whenever any source emits.
+* Only emits after all sources have emitted at least once.
+*
+* Supports selector-based subscriptions (fires only when the selected value
+* changes, per the optional equalityFn) mirroring the createState API.
+*
+* @param sources - Array of Observable sources
+* @returns Combined Observable
+*
+* @example
+* ```ts
+* const state = createState({ count: 0 });
+* const events = createEventStream<Action>();
+*
+* combineLatest([state, events]).subscribe(([state, event]) => {
+*   if (event.type === 'PLAY' && state.count > 0) {
+*     // React to event + state condition
+*   }
+* });
+* ```
+*
+* @example Selector subscription
+* ```ts
+* combineLatest([state, owners]).subscribe(
+*   ([s, o]) => deriveKey(s, o),
+*   (key) => { ... },
+*   { equalityFn: keyEq }
+* );
+* ```
+*/
+function combineLatest(sources) {
+	const subscribeToSources = (listener) => {
+		const latest = new Array(sources.length);
+		const hasValue = new Array(sources.length).fill(false);
+		const unsubscribers = [];
+		for (let i = 0; i < sources.length; i++) {
+			const unsubscribe = sources[i].subscribe((value) => {
+				latest[i] = value;
+				hasValue[i] = true;
+				if (hasValue.every((has) => has)) listener([...latest]);
+			});
+			unsubscribers.push(unsubscribe);
+		}
+		return () => {
+			for (const unsubscribe of unsubscribers) unsubscribe();
+		};
+	};
+	return { subscribe(listenerOrSelector, maybeListener, options) {
+		if (maybeListener === void 0) return subscribeToSources(listenerOrSelector);
+		const selector = listenerOrSelector;
+		const listener = maybeListener;
+		const equalityFn = options?.equalityFn ?? Object.is;
+		let prevSelected;
+		let initialized = false;
+		return subscribeToSources((values) => {
+			const nextSelected = selector(values);
+			if (!initialized || !equalityFn(prevSelected, nextSelected)) {
+				prevSelected = nextSelected;
+				initialized = true;
+				listener(nextSelected);
+			}
+		});
+	} };
+}
+
+//#endregion
+export { combineLatest };
+//# sourceMappingURL=combine-latest.js.map

package/dist/default/core/reactive/combine-latest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"combine-latest.js","names":[],"sources":["../../../../src/core/reactive/combine-latest.ts"],"sourcesContent":["/**\n * Minimal combineLatest operator for reactive composition.\n *\n * Combines multiple Observable-like sources and emits an array of their latest values\n * whenever any source emits.\n */\n\n/**\n * Observable-like interface.\n * Both State and EventStream conform to this shape.\n */\nexport interface Observable<T> {\n  subscribe(listener: (value: T) => void): () => void;\n}\n\n/**\n * Infer value types from array of Observables.\n */\nexport type InferObservableValues<T extends readonly Observable<unknown>[]> = {\n  [K in keyof T]: T[K] extends Observable<infer V> ? V : never;\n};\n\n/**\n * Options for selector-based subscriptions on a combined observable.\n */\nexport interface SelectorOptions<R> {\n  equalityFn?: (a: R, b: R) => boolean;\n}\n\n/**\n * Observable returned by combineLatest — supports both plain and\n * selector-based subscriptions.\n */\nexport interface CombinedObservable<T> extends Observable<T> {\n  subscribe(listener: (value: T) => void): () => void;\n  subscribe<R>(selector: (value: T) => R, listener: (value: R) => void, options?: SelectorOptions<R>): () => void;\n}\n\n/**\n * Combines multiple Observable sources into a single Observable.\n *\n * Emits an array of latest values whenever any source emits.\n * Only emits after all sources have emitted at least once.\n *\n * Supports selector-based subscriptions (fires only when the selected value\n * changes, per the optional equalityFn) mirroring the createState API.\n *\n * @param sources - Array of Observable sources\n * @returns Combined Observable\n *\n * @example\n * ```ts\n * const state = createState({ count: 0 });\n * const events = createEventStream<Action>();\n *\n * combineLatest([state, events]).subscribe(([state, event]) => {\n *   if (event.type === 'PLAY' && state.count > 0) {\n *     // React to event + state condition\n *   }\n * });\n * ```\n *\n * @example Selector subscription\n * ```ts\n * combineLatest([state, owners]).subscribe(\n *   ([s, o]) => deriveKey(s, o),\n *   (key) => { ... },\n *   { equalityFn: keyEq }\n * );\n * ```\n */\nexport function combineLatest<T extends readonly Observable<unknown>[]>(\n  sources: [...T]\n): CombinedObservable<InferObservableValues<T>> {\n  type Values = InferObservableValues<T>;\n\n  const subscribeToSources = (listener: (values: Values) => void): (() => void) => {\n    const latest: unknown[] = new Array(sources.length);\n    const hasValue: boolean[] = new Array(sources.length).fill(false);\n    const unsubscribers: Array<() => void> = [];\n\n    for (let i = 0; i < sources.length; i++) {\n      const unsubscribe = sources[i]!.subscribe((value) => {\n        latest[i] = value;\n        hasValue[i] = true;\n        if (hasValue.every((has) => has)) {\n          listener([...latest] as Values);\n        }\n      });\n      unsubscribers.push(unsubscribe);\n    }\n\n    return () => {\n      for (const unsubscribe of unsubscribers) {\n        unsubscribe();\n      }\n    };\n  };\n\n  return {\n    subscribe<R>(\n      listenerOrSelector: ((values: Values) => void) | ((values: Values) => R),\n      maybeListener?: (value: R) => void,\n      options?: SelectorOptions<R>\n    ): () => void {\n      if (maybeListener === undefined) {\n        return subscribeToSources(listenerOrSelector as (values: Values) => void);\n      }\n\n      const selector = listenerOrSelector as (values: Values) => R;\n      const listener = maybeListener;\n      const equalityFn = options?.equalityFn ?? Object.is;\n\n      let prevSelected: R | undefined;\n      let initialized = false;\n\n      return subscribeToSources((values) => {\n        const nextSelected = selector(values);\n        if (!initialized || !equalityFn(prevSelected as R, nextSelected)) {\n          prevSelected = nextSelected;\n          initialized = true;\n          listener(nextSelected);\n        }\n      });\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuEA,SAAgB,cACd,SAC8C;CAG9C,MAAM,sBAAsB,aAAqD;EAC/E,MAAM,SAAoB,IAAI,MAAM,QAAQ,OAAO;EACnD,MAAM,WAAsB,IAAI,MAAM,QAAQ,OAAO,CAAC,KAAK,MAAM;EACjE,MAAM,gBAAmC,EAAE;AAE3C,OAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;GACvC,MAAM,cAAc,QAAQ,GAAI,WAAW,UAAU;AACnD,WAAO,KAAK;AACZ,aAAS,KAAK;AACd,QAAI,SAAS,OAAO,QAAQ,IAAI,CAC9B,UAAS,CAAC,GAAG,OAAO,CAAW;KAEjC;AACF,iBAAc,KAAK,YAAY;;AAGjC,eAAa;AACX,QAAK,MAAM,eAAe,cACxB,cAAa;;;AAKnB,QAAO,EACL,UACE,oBACA,eACA,SACY;AACZ,MAAI,kBAAkB,OACpB,QAAO,mBAAmB,mBAA+C;EAG3E,MAAM,WAAW;EACjB,MAAM,WAAW;EACjB,MAAM,aAAa,SAAS,cAAc,OAAO;EAEjD,IAAI;EACJ,IAAI,cAAc;AAElB,SAAO,oBAAoB,WAAW;GACpC,MAAM,eAAe,SAAS,OAAO;AACrC,OAAI,CAAC,eAAe,CAAC,WAAW,cAAmB,aAAa,EAAE;AAChE,mBAAe;AACf,kBAAc;AACd,aAAS,aAAa;;IAExB;IAEL"}

package/dist/default/core/state/create-state.js

@@ -0,0 +1,143 @@
+//#region src/core/state/create-state.ts
+/**
+* Reactive state container with selectors, custom equality, and batched updates.
+*
+* Manages both immutable state values and mutable object references (e.g., HTMLMediaElement).
+*/
+const STATE_SYMBOL = Symbol("@videojs/spf/state");
+/**
+* Default equality function using Object.is.
+*/
+function defaultEquality(a, b) {
+	return Object.is(a, b);
+}
+/**
+* State container implementation.
+*/
+var StateContainer = class {
+	[STATE_SYMBOL] = true;
+	#current;
+	#pending = null;
+	#pendingFlush = false;
+	#equalityFn;
+	#listeners = /* @__PURE__ */ new Set();
+	#selectorListeners = /* @__PURE__ */ new Set();
+	constructor(initial, config) {
+		this.#current = typeof initial === "object" && initial !== null ? { ...initial } : initial;
+		this.#equalityFn = config?.equalityFn ?? defaultEquality;
+	}
+	get current() {
+		return this.#pending ?? this.#current;
+	}
+	patch(partial) {
+		const base = this.#pending ?? this.#current;
+		if (typeof base !== "object" || base === null) {
+			const value = partial;
+			if (!Object.is(base, value)) {
+				this.#pending = value;
+				this.#scheduleFlush();
+			}
+			return;
+		}
+		const next = { ...base };
+		let changed = false;
+		for (const key in partial) {
+			if (!Object.hasOwn(partial, key)) continue;
+			const value = partial[key];
+			if (!Object.is(base[key], value)) {
+				next[key] = value;
+				changed = true;
+			}
+		}
+		if (changed) {
+			this.#pending = next;
+			this.#scheduleFlush();
+		}
+	}
+	subscribe(selectorOrListener, maybeListener, options) {
+		if (maybeListener === void 0) {
+			const listener = selectorOrListener;
+			this.#listeners.add(listener);
+			listener(this.current);
+			return () => {
+				this.#listeners.delete(listener);
+			};
+		}
+		const selector = selectorOrListener;
+		const listener = maybeListener;
+		const entry = {
+			selector,
+			listener,
+			options: options ?? {}
+		};
+		this.#selectorListeners.add(entry);
+		listener(selector(this.current));
+		return () => {
+			this.#selectorListeners.delete(entry);
+		};
+	}
+	flush() {
+		if (this.#pending === null) return;
+		const prev = this.#current;
+		const next = this.#pending;
+		this.#pending = null;
+		this.#pendingFlush = false;
+		if (this.#equalityFn(prev, next)) return;
+		this.#current = next;
+		for (const listener of this.#listeners) listener(this.#current);
+		for (const entry of this.#selectorListeners) {
+			const prevSelected = entry.selector(prev);
+			const nextSelected = entry.selector(this.#current);
+			if (!(entry.options.equalityFn ?? Object.is)(prevSelected, nextSelected)) entry.listener(nextSelected);
+		}
+	}
+	#scheduleFlush() {
+		if (this.#pendingFlush) return;
+		this.#pendingFlush = true;
+		queueMicrotask(() => this.flush());
+	}
+};
+/**
+* Create a reactive state container.
+*
+* @example
+* ```typescript
+* const state = createState({ count: 0 });
+*
+* // Subscribe to changes
+* state.subscribe((current, prev) => {
+*   console.log('Changed:', prev, '->', current);
+* });
+*
+* // Updates are batched
+* state.patch({ count: 1 });
+* state.patch({ count: 2 });
+* // Only one notification fires (with count: 2)
+* ```
+*
+* @example Selector subscriptions
+* ```typescript
+* const state = createState({ count: 0, name: 'test' });
+*
+* // Only notified when count changes
+* state.subscribe(
+*   s => s.count,
+*   (current, prev) => console.log(current, prev)
+* );
+* ```
+*
+* @example Custom equality
+* ```typescript
+* const state = createState(
+*   { count: 0, name: 'test' },
+*   { equalityFn: (a, b) => a.count === b.count }
+* );
+* ```
+*/
+function createState(initial, config) {
+	return new StateContainer(initial, config);
+}
+
+//#endregion
+export { createState };
+//# sourceMappingURL=create-state.js.map

package/dist/default/core/state/create-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-state.js","names":["#current","#equalityFn","#pending","#scheduleFlush","#listeners","#selectorListeners","#pendingFlush"],"sources":["../../../../src/core/state/create-state.ts"],"sourcesContent":["/**\n * Reactive state container with selectors, custom equality, and batched updates.\n *\n * Manages both immutable state values and mutable object references (e.g., HTMLMediaElement).\n */\n\n// =============================================================================\n// Symbol for type identification\n// =============================================================================\n\nconst STATE_SYMBOL = Symbol('@videojs/spf/state');\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/**\n * State change listener for full-state subscriptions.\n */\nexport type StateListener<T> = (current: T) => void;\n\n/**\n * Selector function to derive a value from state.\n */\nexport type StateSelector<T, R> = (state: T) => R;\n\n/**\n * Listener for selector-based subscriptions.\n */\nexport type SelectorListener<R> = (current: R) => void;\n\n/**\n * Options for selector subscriptions.\n */\nexport interface SelectorOptions<R> {\n  /**\n   * Custom equality function for selected value.\n   * Defaults to Object.is\n   */\n  equalityFn?: (a: R, b: R) => boolean;\n}\n\n/**\n * Configuration for creating a state container.\n */\nexport interface StateConfig<T> {\n  /**\n   * Custom equality function for change detection.\n   * Defaults to Object.is for top-level comparison.\n   */\n  equalityFn?: (a: T, b: T) => boolean;\n}\n\n/**\n * Read-only state interface.\n */\nexport interface State<T> {\n  /** Symbol for type identification */\n  readonly [STATE_SYMBOL]: true;\n\n  /** Current state snapshot */\n  readonly current: T;\n\n  /** Subscribe to state changes */\n  subscribe(listener: StateListener<T>): () => void;\n}\n\n/**\n * Writable state interface with patch capability.\n */\nexport interface WritableState<T> extends State<T> {\n  /** Update state with partial object (for object state) or full value (for primitive state) */\n  patch(partial: T extends object ? Partial<T> : T): void;\n\n  /** Subscribe to full-state changes */\n  subscribe(listener: StateListener<T>): () => void;\n\n  /** Subscribe to selected value changes */\n  subscribe<R>(selector: StateSelector<T, R>, listener: SelectorListener<R>, options?: SelectorOptions<R>): () => void;\n\n  /** Manually flush pending updates */\n  flush(): void;\n}\n\n/**\n * Entry for selector subscriptions.\n */\ninterface SelectorEntry<T, R> {\n  selector: StateSelector<T, R>;\n  listener: SelectorListener<R>;\n  options: SelectorOptions<R>;\n}\n\n// =============================================================================\n// Default equality function\n// =============================================================================\n\n/**\n * Default equality function using Object.is.\n */\nfunction defaultEquality<T>(a: T, b: T): boolean {\n  return Object.is(a, b);\n}\n\n// =============================================================================\n// Implementation\n// =============================================================================\n\n/**\n * State container implementation.\n */\nclass StateContainer<T> implements WritableState<T> {\n  [STATE_SYMBOL] = true as const;\n\n  #current: T;\n  #pending: T | null = null;\n  #pendingFlush = false;\n  #equalityFn: (a: T, b: T) => boolean;\n\n  // Full-state listeners\n  #listeners = new Set<StateListener<T>>();\n\n  // Selector-based listeners\n  #selectorListeners = new Set<SelectorEntry<T, unknown>>();\n\n  constructor(initial: T, config?: StateConfig<T>) {\n    this.#current = typeof initial === 'object' && initial !== null ? ({ ...initial } as T) : initial;\n    this.#equalityFn = config?.equalityFn ?? defaultEquality;\n  }\n\n  get current(): T {\n    // Return pending state if available (for chained patches)\n    return this.#pending ?? this.#current;\n  }\n\n  patch(partial: T extends object ? Partial<T> : T): void {\n    const base = this.#pending ?? this.#current;\n\n    if (typeof base !== 'object' || base === null) {\n      // Primitive state: replace the whole value\n      const value = partial as T;\n      if (!Object.is(base, value)) {\n        this.#pending = value;\n        this.#scheduleFlush();\n      }\n      return;\n    }\n\n    const next = { ...base } as T;\n    let changed = false;\n\n    // Apply partial updates with change detection\n    for (const key in partial) {\n      if (!Object.hasOwn(partial as any, key)) continue;\n\n      const value = (partial as Partial<T>)[key as keyof T];\n\n      if (!Object.is((base as Partial<T>)[key as keyof T], value)) {\n        (next as Partial<T>)[key as keyof T] = value;\n        changed = true;\n      }\n    }\n\n    if (changed) {\n      this.#pending = next;\n      this.#scheduleFlush();\n    }\n  }\n\n  subscribe(listener: StateListener<T>): () => void;\n  subscribe<R>(selector: StateSelector<T, R>, listener: SelectorListener<R>, options?: SelectorOptions<R>): () => void;\n  subscribe<R>(\n    selectorOrListener: StateListener<T> | StateSelector<T, R>,\n    maybeListener?: SelectorListener<R>,\n    options?: SelectorOptions<R>\n  ): () => void {\n    // Overload 1: Full-state subscription\n    if (maybeListener === undefined) {\n      const listener = selectorOrListener as StateListener<T>;\n      this.#listeners.add(listener);\n\n      // Fire immediately with current state\n      listener(this.current);\n\n      return () => {\n        this.#listeners.delete(listener);\n      };\n    }\n\n    // Overload 2: Selector subscription\n    const selector = selectorOrListener as StateSelector<T, R>;\n    const listener = maybeListener;\n    const opts = options ?? {};\n\n    const entry: SelectorEntry<T, unknown> = {\n      selector: selector as StateSelector<T, unknown>,\n      listener: listener as SelectorListener<unknown>,\n      options: opts as SelectorOptions<unknown>,\n    };\n\n    this.#selectorListeners.add(entry);\n\n    // Fire immediately with current selected value\n    const selected = selector(this.current);\n    listener(selected);\n\n    return () => {\n      this.#selectorListeners.delete(entry);\n    };\n  }\n\n  flush(): void {\n    if (this.#pending === null) return;\n\n    const prev = this.#current;\n    const next = this.#pending;\n    this.#pending = null;\n    this.#pendingFlush = false;\n\n    // Check if state actually changed using custom equality\n    if (this.#equalityFn(prev, next)) return;\n\n    this.#current = next;\n\n    // Notify full-state listeners\n    for (const listener of this.#listeners) {\n      listener(this.#current);\n    }\n\n    // Notify selector listeners\n    for (const entry of this.#selectorListeners) {\n      const prevSelected = entry.selector(prev);\n      const nextSelected = entry.selector(this.#current);\n\n      const equalityFn = entry.options.equalityFn ?? Object.is;\n\n      if (!equalityFn(prevSelected, nextSelected)) {\n        entry.listener(nextSelected);\n      }\n    }\n  }\n\n  #scheduleFlush(): void {\n    if (this.#pendingFlush) return;\n    this.#pendingFlush = true;\n    queueMicrotask(() => this.flush());\n  }\n}\n\n// =============================================================================\n// Factory function\n// =============================================================================\n\n/**\n * Create a reactive state container.\n *\n * @example\n * ```typescript\n * const state = createState({ count: 0 });\n *\n * // Subscribe to changes\n * state.subscribe((current, prev) => {\n *   console.log('Changed:', prev, '->', current);\n * });\n *\n * // Updates are batched\n * state.patch({ count: 1 });\n * state.patch({ count: 2 });\n * // Only one notification fires (with count: 2)\n * ```\n *\n * @example Selector subscriptions\n * ```typescript\n * const state = createState({ count: 0, name: 'test' });\n *\n * // Only notified when count changes\n * state.subscribe(\n *   s => s.count,\n *   (current, prev) => console.log(current, prev)\n * );\n * ```\n *\n * @example Custom equality\n * ```typescript\n * const state = createState(\n *   { count: 0, name: 'test' },\n *   { equalityFn: (a, b) => a.count === b.count }\n * );\n * ```\n */\nexport function createState<T>(initial: T, config?: StateConfig<T>): WritableState<T> {\n  return new StateContainer(initial, config);\n}\n\n// =============================================================================\n// Type guard\n// =============================================================================\n\n/**\n * Check if a value is a State container.\n */\nexport function isState(value: unknown): value is State<object> {\n  return typeof value === 'object' && value !== null && STATE_SYMBOL in value;\n}\n"],"mappings":";;;;;;AAUA,MAAM,eAAe,OAAO,qBAAqB;;;;AA0FjD,SAAS,gBAAmB,GAAM,GAAe;AAC/C,QAAO,OAAO,GAAG,GAAG,EAAE;;;;;AAUxB,IAAM,iBAAN,MAAoD;CAClD,CAAC,gBAAgB;CAEjB;CACA,WAAqB;CACrB,gBAAgB;CAChB;CAGA,6BAAa,IAAI,KAAuB;CAGxC,qCAAqB,IAAI,KAAgC;CAEzD,YAAY,SAAY,QAAyB;AAC/C,QAAKA,UAAW,OAAO,YAAY,YAAY,YAAY,OAAQ,EAAE,GAAG,SAAS,GAAS;AAC1F,QAAKC,aAAc,QAAQ,cAAc;;CAG3C,IAAI,UAAa;AAEf,SAAO,MAAKC,WAAY,MAAKF;;CAG/B,MAAM,SAAkD;EACtD,MAAM,OAAO,MAAKE,WAAY,MAAKF;AAEnC,MAAI,OAAO,SAAS,YAAY,SAAS,MAAM;GAE7C,MAAM,QAAQ;AACd,OAAI,CAAC,OAAO,GAAG,MAAM,MAAM,EAAE;AAC3B,UAAKE,UAAW;AAChB,UAAKC,eAAgB;;AAEvB;;EAGF,MAAM,OAAO,EAAE,GAAG,MAAM;EACxB,IAAI,UAAU;AAGd,OAAK,MAAM,OAAO,SAAS;AACzB,OAAI,CAAC,OAAO,OAAO,SAAgB,IAAI,CAAE;GAEzC,MAAM,QAAS,QAAuB;AAEtC,OAAI,CAAC,OAAO,GAAI,KAAoB,MAAiB,MAAM,EAAE;AAC3D,IAAC,KAAoB,OAAkB;AACvC,cAAU;;;AAId,MAAI,SAAS;AACX,SAAKD,UAAW;AAChB,SAAKC,eAAgB;;;CAMzB,UACE,oBACA,eACA,SACY;AAEZ,MAAI,kBAAkB,QAAW;GAC/B,MAAM,WAAW;AACjB,SAAKC,UAAW,IAAI,SAAS;AAG7B,YAAS,KAAK,QAAQ;AAEtB,gBAAa;AACX,UAAKA,UAAW,OAAO,SAAS;;;EAKpC,MAAM,WAAW;EACjB,MAAM,WAAW;EAGjB,MAAM,QAAmC;GAC7B;GACA;GACV,SALW,WAAW,EAAE;GAMzB;AAED,QAAKC,kBAAmB,IAAI,MAAM;AAIlC,WADiB,SAAS,KAAK,QAAQ,CACrB;AAElB,eAAa;AACX,SAAKA,kBAAmB,OAAO,MAAM;;;CAIzC,QAAc;AACZ,MAAI,MAAKH,YAAa,KAAM;EAE5B,MAAM,OAAO,MAAKF;EAClB,MAAM,OAAO,MAAKE;AAClB,QAAKA,UAAW;AAChB,QAAKI,eAAgB;AAGrB,MAAI,MAAKL,WAAY,MAAM,KAAK,CAAE;AAElC,QAAKD,UAAW;AAGhB,OAAK,MAAM,YAAY,MAAKI,UAC1B,UAAS,MAAKJ,QAAS;AAIzB,OAAK,MAAM,SAAS,MAAKK,mBAAoB;GAC3C,MAAM,eAAe,MAAM,SAAS,KAAK;GACzC,MAAM,eAAe,MAAM,SAAS,MAAKL,QAAS;AAIlD,OAAI,EAFe,MAAM,QAAQ,cAAc,OAAO,IAEtC,cAAc,aAAa,CACzC,OAAM,SAAS,aAAa;;;CAKlC,iBAAuB;AACrB,MAAI,MAAKM,aAAe;AACxB,QAAKA,eAAgB;AACrB,uBAAqB,KAAK,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CtC,SAAgB,YAAe,SAAY,QAA2C;AACpF,QAAO,IAAI,eAAe,SAAS,OAAO"}