@videojs/spf 10.0.0-beta.14 → 10.0.0-beta.16

package/dist/default/dom/features/sync-selected-text-track-from-dom.js

@@ -1,54 +0,0 @@
-import { effect } from "../../core/signals/effect.js";
-import { computed, update } from "../../core/signals/primitives.js";
-import { listen } from "@videojs/utils/dom";
-//#region src/dom/features/sync-selected-text-track-from-dom.ts
-/**
-* Sync selectedTextTrackId from DOM text track mode changes.
-*
-* Listens to the `change` event on `media.textTracks` and updates
-* `selectedTextTrackId` when external code (e.g. the captions button via
-* `toggleSubtitles()`) changes a subtitle/caption track mode to 'showing'.
-*
-* This bridges the core store's `toggleSubtitles()` with SPF's reactive text
-* track pipeline (`syncTextTrackModes`, `loadTextTrackCues`). Without this
-* bridge, direct DOM mode changes would be immediately overridden by
-* `syncTextTrackModes` on the next SPF state update.
-*
-* When a subtitle/caption track's mode is 'showing', its DOM `id` — which
-* matches the SPF track ID set by `setupTextTracks` — is written to
-* `selectedTextTrackId`. When no subtitle/caption track is 'showing',
-* `selectedTextTrackId` is cleared along with the deselected track's
-* `textBufferState` entry — setting mode to 'disabled' clears native cues from
-* the track element, so the buffer must be reset to re-fetch cues on re-enable.
-*
-* @example
-* const cleanup = syncSelectedTextTrackFromDom({ state, owners });
-*/
-function syncSelectedTextTrackFromDom({ state, owners }) {
-	const mediaElement = computed(() => owners.get().mediaElement);
-	return effect(() => {
-		const el = mediaElement.get();
-		if (!el) return;
-		return listen(el.textTracks, "change", () => {
-			const newId = Array.from(el.textTracks).find((t) => t.mode === "showing" && (t.kind === "subtitles" || t.kind === "captions"))?.id || void 0;
-			const current = state.get();
-			if (current.selectedTextTrackId === newId) return;
-			if (newId) update(state, { selectedTextTrackId: newId });
-			else {
-				const prevId = current.selectedTextTrackId;
-				if (prevId && current.textBufferState?.[prevId]) {
-					const next = { ...current.textBufferState };
-					delete next[prevId];
-					update(state, {
-						selectedTextTrackId: void 0,
-						textBufferState: next
-					});
-				} else update(state, { selectedTextTrackId: void 0 });
-			}
-		});
-	});
-}
-//#endregion
-export { syncSelectedTextTrackFromDom };
-
-//# sourceMappingURL=sync-selected-text-track-from-dom.js.map

package/dist/default/dom/features/sync-selected-text-track-from-dom.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sync-selected-text-track-from-dom.js","names":[],"sources":["../../../../src/dom/features/sync-selected-text-track-from-dom.ts"],"sourcesContent":["import { listen } from '@videojs/utils/dom';\nimport { effect } from '../../core/signals/effect';\nimport { computed, type Signal, update } from '../../core/signals/primitives';\nimport type { TextTrackBufferState } from './load-text-track-cues';\n\n/**\n * State shape for DOM-driven text track selection.\n */\nexport interface SelectedTextTrackFromDomState {\n  selectedTextTrackId?: string | undefined;\n  textBufferState?: TextTrackBufferState | undefined;\n}\n\n/**\n * Owners shape for DOM-driven text track selection.\n */\nexport interface SelectedTextTrackFromDomOwners {\n  mediaElement?: HTMLMediaElement | undefined;\n}\n\n/**\n * Sync selectedTextTrackId from DOM text track mode changes.\n *\n * Listens to the `change` event on `media.textTracks` and updates\n * `selectedTextTrackId` when external code (e.g. the captions button via\n * `toggleSubtitles()`) changes a subtitle/caption track mode to 'showing'.\n *\n * This bridges the core store's `toggleSubtitles()` with SPF's reactive text\n * track pipeline (`syncTextTrackModes`, `loadTextTrackCues`). Without this\n * bridge, direct DOM mode changes would be immediately overridden by\n * `syncTextTrackModes` on the next SPF state update.\n *\n * When a subtitle/caption track's mode is 'showing', its DOM `id` — which\n * matches the SPF track ID set by `setupTextTracks` — is written to\n * `selectedTextTrackId`. When no subtitle/caption track is 'showing',\n * `selectedTextTrackId` is cleared along with the deselected track's\n * `textBufferState` entry — setting mode to 'disabled' clears native cues from\n * the track element, so the buffer must be reset to re-fetch cues on re-enable.\n *\n * @example\n * const cleanup = syncSelectedTextTrackFromDom({ state, owners });\n */\nexport function syncSelectedTextTrackFromDom<\n  S extends SelectedTextTrackFromDomState,\n  O extends SelectedTextTrackFromDomOwners,\n>({ state, owners }: { state: Signal<S>; owners: Signal<O> }): () => void {\n  const mediaElement = computed(() => owners.get().mediaElement);\n\n  return effect(() => {\n    const el = mediaElement.get();\n    if (!el) return;\n\n    return listen(el.textTracks, 'change', () => {\n      const showingTrack = Array.from(el.textTracks).find(\n        (t) => t.mode === 'showing' && (t.kind === 'subtitles' || t.kind === 'captions')\n      );\n\n      // showingTrack.id is set from the SPF presentation track ID by setupTextTracks.\n      // Fall back to undefined for empty-string IDs (non-SPF-managed tracks).\n      const newId = showingTrack?.id || undefined;\n      const current = state.get();\n\n      // Guard against redundant writes — e.g. syncTextTrackModes confirming the\n      // current selection, which would otherwise create a feedback loop.\n      if (current.selectedTextTrackId === newId) return;\n\n      if (newId) {\n        const patch: Partial<SelectedTextTrackFromDomState> = { selectedTextTrackId: newId };\n        update(state, patch);\n      } else {\n        // When deselecting, clear the textBufferState entry for the previous track.\n        // Setting mode to 'disabled' (as toggleSubtitles() does) clears native cues\n        // from the track element, so the buffer must be reset to allow re-fetching\n        // on re-enable.\n        const prevId = current.selectedTextTrackId;\n        if (prevId && current.textBufferState?.[prevId]) {\n          const next = { ...current.textBufferState };\n          delete next[prevId];\n          const patch: Partial<SelectedTextTrackFromDomState> = {\n            selectedTextTrackId: undefined,\n            textBufferState: next,\n          };\n          update(state, patch);\n        } else {\n          const patch: Partial<SelectedTextTrackFromDomState> = { selectedTextTrackId: undefined };\n          update(state, patch);\n        }\n      }\n    });\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,SAAgB,6BAGd,EAAE,OAAO,UAA+D;CACxE,MAAM,eAAe,eAAe,OAAO,KAAK,CAAC,aAAa;AAE9D,QAAO,aAAa;EAClB,MAAM,KAAK,aAAa,KAAK;AAC7B,MAAI,CAAC,GAAI;AAET,SAAO,OAAO,GAAG,YAAY,gBAAgB;GAO3C,MAAM,QANe,MAAM,KAAK,GAAG,WAAW,CAAC,MAC5C,MAAM,EAAE,SAAS,cAAc,EAAE,SAAS,eAAe,EAAE,SAAS,YACtE,EAI2B,MAAM,KAAA;GAClC,MAAM,UAAU,MAAM,KAAK;AAI3B,OAAI,QAAQ,wBAAwB,MAAO;AAE3C,OAAI,MAEF,QAAO,OAD+C,EAAE,qBAAqB,OAAO,CAChE;QACf;IAKL,MAAM,SAAS,QAAQ;AACvB,QAAI,UAAU,QAAQ,kBAAkB,SAAS;KAC/C,MAAM,OAAO,EAAE,GAAG,QAAQ,iBAAiB;AAC3C,YAAO,KAAK;AAKZ,YAAO,OAJ+C;MACpD,qBAAqB,KAAA;MACrB,iBAAiB;MAClB,CACmB;UAGpB,QAAO,OAD+C,EAAE,qBAAqB,KAAA,GAAW,CACpE;;IAGxB;GACF"}

package/dist/default/dom/features/sync-text-track-modes.js

@@ -1,33 +0,0 @@
-import { effect } from "../../core/signals/effect.js";
-import { computed } from "../../core/signals/primitives.js";
-//#region src/dom/features/sync-text-track-modes.ts
-/**
-* Sync text track modes orchestration.
-*
-* Manages track element modes based on selectedTextTrackId:
-* - Selected track: mode = "showing"
-* - Other tracks: mode = "hidden"
-* - No selection: all tracks mode = "hidden"
-*
-* Note: Uses "hidden" instead of "disabled" for non-selected tracks
-* so they remain available in the browser's track menu.
-*
-* @example
-* const cleanup = syncTextTrackModes({ state, owners });
-*/
-function syncTextTrackModes({ state, owners }) {
-	const textTracksSignal = computed(() => owners.get().textTracks);
-	const selectedTextTrackIdSignal = computed(() => state.get().selectedTextTrackId);
-	const canSyncTextTrackModes = computed(() => !!textTracksSignal.get()?.size);
-	return effect(() => {
-		if (!canSyncTextTrackModes.get()) return;
-		/** @TODO refactor TextTracks owners model. Should simply use id. Also should use corresponding TextTrack (JS) element if possible (CJP) */
-		const textTracks = textTracksSignal.get();
-		const selectedTextTrackId = selectedTextTrackIdSignal.get();
-		for (const [trackId, trackElement] of textTracks) trackElement.track.mode = trackId === selectedTextTrackId ? "showing" : "hidden";
-	});
-}
-//#endregion
-export { syncTextTrackModes };
-
-//# sourceMappingURL=sync-text-track-modes.js.map

package/dist/default/dom/features/sync-text-track-modes.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sync-text-track-modes.js","names":[],"sources":["../../../../src/dom/features/sync-text-track-modes.ts"],"sourcesContent":["import { effect } from '../../core/signals/effect';\nimport { computed, type Signal } from '../../core/signals/primitives';\n\n/**\n * State shape for text track mode synchronization.\n */\nexport interface TextTrackModeState {\n  selectedTextTrackId?: string | undefined;\n}\n\n/**\n * Owners shape for text track mode synchronization.\n */\nexport interface TextTrackModeOwners {\n  textTracks?: Map<string, HTMLTrackElement>;\n}\n\n/**\n * Sync text track modes orchestration.\n *\n * Manages track element modes based on selectedTextTrackId:\n * - Selected track: mode = \"showing\"\n * - Other tracks: mode = \"hidden\"\n * - No selection: all tracks mode = \"hidden\"\n *\n * Note: Uses \"hidden\" instead of \"disabled\" for non-selected tracks\n * so they remain available in the browser's track menu.\n *\n * @example\n * const cleanup = syncTextTrackModes({ state, owners });\n */\nexport function syncTextTrackModes<S extends TextTrackModeState, O extends TextTrackModeOwners>({\n  state,\n  owners,\n}: {\n  state: Signal<S>;\n  owners: Signal<O>;\n}): () => void {\n  const textTracksSignal = computed(() => owners.get().textTracks);\n  const selectedTextTrackIdSignal = computed(() => state.get().selectedTextTrackId);\n\n  const canSyncTextTrackModes = computed(() => !!textTracksSignal.get()?.size);\n\n  return effect(() => {\n    if (!canSyncTextTrackModes.get()) return;\n    /** @TODO refactor TextTracks owners model. Should simply use id. Also should use corresponding TextTrack (JS) element if possible (CJP) */\n    const textTracks = textTracksSignal.get() as Map<string, HTMLTrackElement>;\n    const selectedTextTrackId = selectedTextTrackIdSignal.get() as string;\n\n    for (const [trackId, trackElement] of textTracks) {\n      trackElement.track.mode = trackId === selectedTextTrackId ? 'showing' : 'hidden';\n    }\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AA+BA,SAAgB,mBAAgF,EAC9F,OACA,UAIa;CACb,MAAM,mBAAmB,eAAe,OAAO,KAAK,CAAC,WAAW;CAChE,MAAM,4BAA4B,eAAe,MAAM,KAAK,CAAC,oBAAoB;CAEjF,MAAM,wBAAwB,eAAe,CAAC,CAAC,iBAAiB,KAAK,EAAE,KAAK;AAE5E,QAAO,aAAa;AAClB,MAAI,CAAC,sBAAsB,KAAK,CAAE;;EAElC,MAAM,aAAa,iBAAiB,KAAK;EACzC,MAAM,sBAAsB,0BAA0B,KAAK;AAE3D,OAAK,MAAM,CAAC,SAAS,iBAAiB,WACpC,cAAa,MAAM,OAAO,YAAY,sBAAsB,YAAY;GAE1E"}

package/dist/dev/dom/features/setup-text-tracks.js

@@ -1,67 +0,0 @@
-import { effect } from "../../core/signals/effect.js";
-import { computed, update } from "../../core/signals/primitives.js";
-//#region src/dom/features/setup-text-tracks.ts
-/**
-* Create a track element for a text track.
-*
-* Note: We use DOM <track> elements instead of the TextTrack JS API
-* because there's no way to remove TextTracks added via addTextTrack().
-*/
-function createTrackElement(track) {
-	const trackElement = document.createElement("track");
-	trackElement.id = track.id;
-	trackElement.kind = track.kind;
-	trackElement.label = track.label;
-	if (track.language) trackElement.srclang = track.language;
-	if (track.default) trackElement.default = true;
-	trackElement.src = track.url;
-	return trackElement;
-}
-/**
-* Setup text tracks orchestration.
-*
-* Triggers when:
-* - mediaElement exists
-* - presentation is resolved (has text tracks)
-*
-* Creates <track> elements for all text tracks and adds them as children
-* to the media element. This allows the browser's native text track rendering.
-*
-* Note: Uses DOM track elements instead of TextTrack API because tracks
-* added via addTextTrack() cannot be removed.
-*
-* @example
-* const cleanup = setupTextTracks({ state, owners });
-*/
-function setupTextTracks({ state, owners }) {
-	const modelTextTracksSignal = computed(() => state.get().presentation?.selectionSets?.find((selectionSet) => selectionSet.type === "text")?.switchingSets[0]?.tracks, { equals(prevTextTracks, nextTextTracks) {
-		if (prevTextTracks === nextTextTracks) return true;
-		if (typeof prevTextTracks !== typeof nextTextTracks) return false;
-		if (prevTextTracks?.length !== nextTextTracks?.length) return false;
-		return !!nextTextTracks && nextTextTracks.every((nextTextTrack) => prevTextTracks?.some((prevTextTrack) => prevTextTrack.id === nextTextTrack.id));
-	} });
-	const ownerTextTracksSignal = computed(() => owners.get().textTracks);
-	const mediaElementSignal = computed(() => owners.get().mediaElement);
-	const canSetupTextTracksSignal = computed(() => !!mediaElementSignal.get() && modelTextTracksSignal.get()?.length);
-	const shouldSetupTextTracksSignal = computed(() => !ownerTextTracksSignal.get());
-	const cleanupEffect = effect(() => {
-		if (!canSetupTextTracksSignal.get() || !shouldSetupTextTracksSignal.get()) return;
-		const mediaElement = mediaElementSignal.get();
-		const modelTextTracks = modelTextTracksSignal.get();
-		const trackMap = /* @__PURE__ */ new Map();
-		modelTextTracks.forEach((modelTextTrack) => {
-			const trackElement = createTrackElement(modelTextTrack);
-			mediaElement.appendChild(trackElement);
-			trackMap.set(modelTextTrack.id, trackElement);
-		});
-		if (trackMap.size) update(owners, { textTracks: trackMap });
-	});
-	return () => {
-		owners.get().textTracks?.forEach((trackElement) => trackElement.remove());
-		cleanupEffect();
-	};
-}
-//#endregion
-export { setupTextTracks };
-
-//# sourceMappingURL=setup-text-tracks.js.map

package/dist/dev/dom/features/setup-text-tracks.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"setup-text-tracks.js","names":[],"sources":["../../../../src/dom/features/setup-text-tracks.ts"],"sourcesContent":["import { effect } from '../../core/signals/effect';\nimport { computed, type Signal, update } from '../../core/signals/primitives';\nimport type { PartiallyResolvedTextTrack, Presentation, TextTrack } from '../../core/types';\n\n/**\n * State shape for text track setup.\n */\nexport interface TextTrackState {\n  presentation?: Presentation | undefined;\n  selectedTextTrackId?: string | undefined;\n}\n\n/**\n * Owners shape for text track setup.\n */\nexport interface TextTrackOwners {\n  mediaElement?: HTMLMediaElement | undefined;\n  textTracks?: Map<string, HTMLTrackElement>;\n}\n\n/**\n * Create a track element for a text track.\n *\n * Note: We use DOM <track> elements instead of the TextTrack JS API\n * because there's no way to remove TextTracks added via addTextTrack().\n */\nfunction createTrackElement(track: PartiallyResolvedTextTrack | TextTrack): HTMLTrackElement {\n  const trackElement = document.createElement('track');\n\n  trackElement.id = track.id;\n  trackElement.kind = track.kind;\n  trackElement.label = track.label;\n\n  if (track.language) {\n    trackElement.srclang = track.language;\n  }\n\n  if (track.default) {\n    trackElement.default = true;\n  }\n\n  // Set src to track URL\n  trackElement.src = track.url;\n\n  return trackElement;\n}\n\n/**\n * Setup text tracks orchestration.\n *\n * Triggers when:\n * - mediaElement exists\n * - presentation is resolved (has text tracks)\n *\n * Creates <track> elements for all text tracks and adds them as children\n * to the media element. This allows the browser's native text track rendering.\n *\n * Note: Uses DOM track elements instead of TextTrack API because tracks\n * added via addTextTrack() cannot be removed.\n *\n * @example\n * const cleanup = setupTextTracks({ state, owners });\n */\nexport function setupTextTracks<S extends TextTrackState, O extends TextTrackOwners>({\n  state,\n  owners,\n}: {\n  state: Signal<S>;\n  owners: Signal<O>;\n}): () => void {\n  const modelTextTracksSignal = computed(\n    // NOTE: This assumes exactly one selection set and switching set for TextTracks (CJP)\n    () =>\n      state.get().presentation?.selectionSets?.find((selectionSet) => selectionSet.type === 'text')?.switchingSets[0]\n        ?.tracks,\n    {\n      /** @TODO Make generic and abstract away for Array<T> | undefined (CJP) */\n      equals(prevTextTracks, nextTextTracks) {\n        if (prevTextTracks === nextTextTracks) return true;\n        if (typeof prevTextTracks !== typeof nextTextTracks) return false;\n        if (prevTextTracks?.length !== nextTextTracks?.length) return false;\n        // NOTE: This could probably be optimized, but the set should generally be small (CJP)\n        return (\n          !!nextTextTracks &&\n          nextTextTracks.every((nextTextTrack) =>\n            prevTextTracks?.some((prevTextTrack) => prevTextTrack.id === nextTextTrack.id)\n          )\n        );\n      },\n    }\n  );\n  const ownerTextTracksSignal = computed(() => owners.get().textTracks);\n  const mediaElementSignal = computed(() => owners.get().mediaElement);\n\n  const canSetupTextTracksSignal = computed(() => !!mediaElementSignal.get() && modelTextTracksSignal.get()?.length);\n  const shouldSetupTextTracksSignal = computed(() => !ownerTextTracksSignal.get());\n\n  const cleanupEffect = effect(() => {\n    if (!canSetupTextTracksSignal.get() || !shouldSetupTextTracksSignal.get()) return;\n    const mediaElement = mediaElementSignal.get();\n    const modelTextTracks = modelTextTracksSignal.get() as TextTrack[];\n\n    const trackMap = new Map<string, HTMLTrackElement>();\n    modelTextTracks.forEach((modelTextTrack) => {\n      const trackElement = createTrackElement(modelTextTrack);\n      mediaElement!.appendChild(trackElement);\n      trackMap.set(modelTextTrack.id, trackElement);\n    });\n\n    if (trackMap.size) {\n      const patch: Partial<TextTrackOwners> = { textTracks: trackMap };\n      update(owners, patch);\n    }\n  });\n\n  return () => {\n    owners.get().textTracks?.forEach((trackElement) => trackElement.remove());\n    cleanupEffect();\n  };\n}\n"],"mappings":";;;;;;;;;AA0BA,SAAS,mBAAmB,OAAiE;CAC3F,MAAM,eAAe,SAAS,cAAc,QAAQ;AAEpD,cAAa,KAAK,MAAM;AACxB,cAAa,OAAO,MAAM;AAC1B,cAAa,QAAQ,MAAM;AAE3B,KAAI,MAAM,SACR,cAAa,UAAU,MAAM;AAG/B,KAAI,MAAM,QACR,cAAa,UAAU;AAIzB,cAAa,MAAM,MAAM;AAEzB,QAAO;;;;;;;;;;;;;;;;;;AAmBT,SAAgB,gBAAqE,EACnF,OACA,UAIa;CACb,MAAM,wBAAwB,eAG1B,MAAM,KAAK,CAAC,cAAc,eAAe,MAAM,iBAAiB,aAAa,SAAS,OAAO,EAAE,cAAc,IACzG,QACN,EAEE,OAAO,gBAAgB,gBAAgB;AACrC,MAAI,mBAAmB,eAAgB,QAAO;AAC9C,MAAI,OAAO,mBAAmB,OAAO,eAAgB,QAAO;AAC5D,MAAI,gBAAgB,WAAW,gBAAgB,OAAQ,QAAO;AAE9D,SACE,CAAC,CAAC,kBACF,eAAe,OAAO,kBACpB,gBAAgB,MAAM,kBAAkB,cAAc,OAAO,cAAc,GAAG,CAC/E;IAGN,CACF;CACD,MAAM,wBAAwB,eAAe,OAAO,KAAK,CAAC,WAAW;CACrE,MAAM,qBAAqB,eAAe,OAAO,KAAK,CAAC,aAAa;CAEpE,MAAM,2BAA2B,eAAe,CAAC,CAAC,mBAAmB,KAAK,IAAI,sBAAsB,KAAK,EAAE,OAAO;CAClH,MAAM,8BAA8B,eAAe,CAAC,sBAAsB,KAAK,CAAC;CAEhF,MAAM,gBAAgB,aAAa;AACjC,MAAI,CAAC,yBAAyB,KAAK,IAAI,CAAC,4BAA4B,KAAK,CAAE;EAC3E,MAAM,eAAe,mBAAmB,KAAK;EAC7C,MAAM,kBAAkB,sBAAsB,KAAK;EAEnD,MAAM,2BAAW,IAAI,KAA+B;AACpD,kBAAgB,SAAS,mBAAmB;GAC1C,MAAM,eAAe,mBAAmB,eAAe;AACvD,gBAAc,YAAY,aAAa;AACvC,YAAS,IAAI,eAAe,IAAI,aAAa;IAC7C;AAEF,MAAI,SAAS,KAEX,QAAO,QADiC,EAAE,YAAY,UAAU,CAC3C;GAEvB;AAEF,cAAa;AACX,SAAO,KAAK,CAAC,YAAY,SAAS,iBAAiB,aAAa,QAAQ,CAAC;AACzE,iBAAe"}

package/dist/dev/dom/features/sync-selected-text-track-from-dom.js

@@ -1,54 +0,0 @@
-import { effect } from "../../core/signals/effect.js";
-import { computed, update } from "../../core/signals/primitives.js";
-import { listen } from "@videojs/utils/dom";
-//#region src/dom/features/sync-selected-text-track-from-dom.ts
-/**
-* Sync selectedTextTrackId from DOM text track mode changes.
-*
-* Listens to the `change` event on `media.textTracks` and updates
-* `selectedTextTrackId` when external code (e.g. the captions button via
-* `toggleSubtitles()`) changes a subtitle/caption track mode to 'showing'.
-*
-* This bridges the core store's `toggleSubtitles()` with SPF's reactive text
-* track pipeline (`syncTextTrackModes`, `loadTextTrackCues`). Without this
-* bridge, direct DOM mode changes would be immediately overridden by
-* `syncTextTrackModes` on the next SPF state update.
-*
-* When a subtitle/caption track's mode is 'showing', its DOM `id` — which
-* matches the SPF track ID set by `setupTextTracks` — is written to
-* `selectedTextTrackId`. When no subtitle/caption track is 'showing',
-* `selectedTextTrackId` is cleared along with the deselected track's
-* `textBufferState` entry — setting mode to 'disabled' clears native cues from
-* the track element, so the buffer must be reset to re-fetch cues on re-enable.
-*
-* @example
-* const cleanup = syncSelectedTextTrackFromDom({ state, owners });
-*/
-function syncSelectedTextTrackFromDom({ state, owners }) {
-	const mediaElement = computed(() => owners.get().mediaElement);
-	return effect(() => {
-		const el = mediaElement.get();
-		if (!el) return;
-		return listen(el.textTracks, "change", () => {
-			const newId = Array.from(el.textTracks).find((t) => t.mode === "showing" && (t.kind === "subtitles" || t.kind === "captions"))?.id || void 0;
-			const current = state.get();
-			if (current.selectedTextTrackId === newId) return;
-			if (newId) update(state, { selectedTextTrackId: newId });
-			else {
-				const prevId = current.selectedTextTrackId;
-				if (prevId && current.textBufferState?.[prevId]) {
-					const next = { ...current.textBufferState };
-					delete next[prevId];
-					update(state, {
-						selectedTextTrackId: void 0,
-						textBufferState: next
-					});
-				} else update(state, { selectedTextTrackId: void 0 });
-			}
-		});
-	});
-}
-//#endregion
-export { syncSelectedTextTrackFromDom };
-
-//# sourceMappingURL=sync-selected-text-track-from-dom.js.map

package/dist/dev/dom/features/sync-selected-text-track-from-dom.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sync-selected-text-track-from-dom.js","names":[],"sources":["../../../../src/dom/features/sync-selected-text-track-from-dom.ts"],"sourcesContent":["import { listen } from '@videojs/utils/dom';\nimport { effect } from '../../core/signals/effect';\nimport { computed, type Signal, update } from '../../core/signals/primitives';\nimport type { TextTrackBufferState } from './load-text-track-cues';\n\n/**\n * State shape for DOM-driven text track selection.\n */\nexport interface SelectedTextTrackFromDomState {\n  selectedTextTrackId?: string | undefined;\n  textBufferState?: TextTrackBufferState | undefined;\n}\n\n/**\n * Owners shape for DOM-driven text track selection.\n */\nexport interface SelectedTextTrackFromDomOwners {\n  mediaElement?: HTMLMediaElement | undefined;\n}\n\n/**\n * Sync selectedTextTrackId from DOM text track mode changes.\n *\n * Listens to the `change` event on `media.textTracks` and updates\n * `selectedTextTrackId` when external code (e.g. the captions button via\n * `toggleSubtitles()`) changes a subtitle/caption track mode to 'showing'.\n *\n * This bridges the core store's `toggleSubtitles()` with SPF's reactive text\n * track pipeline (`syncTextTrackModes`, `loadTextTrackCues`). Without this\n * bridge, direct DOM mode changes would be immediately overridden by\n * `syncTextTrackModes` on the next SPF state update.\n *\n * When a subtitle/caption track's mode is 'showing', its DOM `id` — which\n * matches the SPF track ID set by `setupTextTracks` — is written to\n * `selectedTextTrackId`. When no subtitle/caption track is 'showing',\n * `selectedTextTrackId` is cleared along with the deselected track's\n * `textBufferState` entry — setting mode to 'disabled' clears native cues from\n * the track element, so the buffer must be reset to re-fetch cues on re-enable.\n *\n * @example\n * const cleanup = syncSelectedTextTrackFromDom({ state, owners });\n */\nexport function syncSelectedTextTrackFromDom<\n  S extends SelectedTextTrackFromDomState,\n  O extends SelectedTextTrackFromDomOwners,\n>({ state, owners }: { state: Signal<S>; owners: Signal<O> }): () => void {\n  const mediaElement = computed(() => owners.get().mediaElement);\n\n  return effect(() => {\n    const el = mediaElement.get();\n    if (!el) return;\n\n    return listen(el.textTracks, 'change', () => {\n      const showingTrack = Array.from(el.textTracks).find(\n        (t) => t.mode === 'showing' && (t.kind === 'subtitles' || t.kind === 'captions')\n      );\n\n      // showingTrack.id is set from the SPF presentation track ID by setupTextTracks.\n      // Fall back to undefined for empty-string IDs (non-SPF-managed tracks).\n      const newId = showingTrack?.id || undefined;\n      const current = state.get();\n\n      // Guard against redundant writes — e.g. syncTextTrackModes confirming the\n      // current selection, which would otherwise create a feedback loop.\n      if (current.selectedTextTrackId === newId) return;\n\n      if (newId) {\n        const patch: Partial<SelectedTextTrackFromDomState> = { selectedTextTrackId: newId };\n        update(state, patch);\n      } else {\n        // When deselecting, clear the textBufferState entry for the previous track.\n        // Setting mode to 'disabled' (as toggleSubtitles() does) clears native cues\n        // from the track element, so the buffer must be reset to allow re-fetching\n        // on re-enable.\n        const prevId = current.selectedTextTrackId;\n        if (prevId && current.textBufferState?.[prevId]) {\n          const next = { ...current.textBufferState };\n          delete next[prevId];\n          const patch: Partial<SelectedTextTrackFromDomState> = {\n            selectedTextTrackId: undefined,\n            textBufferState: next,\n          };\n          update(state, patch);\n        } else {\n          const patch: Partial<SelectedTextTrackFromDomState> = { selectedTextTrackId: undefined };\n          update(state, patch);\n        }\n      }\n    });\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,SAAgB,6BAGd,EAAE,OAAO,UAA+D;CACxE,MAAM,eAAe,eAAe,OAAO,KAAK,CAAC,aAAa;AAE9D,QAAO,aAAa;EAClB,MAAM,KAAK,aAAa,KAAK;AAC7B,MAAI,CAAC,GAAI;AAET,SAAO,OAAO,GAAG,YAAY,gBAAgB;GAO3C,MAAM,QANe,MAAM,KAAK,GAAG,WAAW,CAAC,MAC5C,MAAM,EAAE,SAAS,cAAc,EAAE,SAAS,eAAe,EAAE,SAAS,YACtE,EAI2B,MAAM,KAAA;GAClC,MAAM,UAAU,MAAM,KAAK;AAI3B,OAAI,QAAQ,wBAAwB,MAAO;AAE3C,OAAI,MAEF,QAAO,OAD+C,EAAE,qBAAqB,OAAO,CAChE;QACf;IAKL,MAAM,SAAS,QAAQ;AACvB,QAAI,UAAU,QAAQ,kBAAkB,SAAS;KAC/C,MAAM,OAAO,EAAE,GAAG,QAAQ,iBAAiB;AAC3C,YAAO,KAAK;AAKZ,YAAO,OAJ+C;MACpD,qBAAqB,KAAA;MACrB,iBAAiB;MAClB,CACmB;UAGpB,QAAO,OAD+C,EAAE,qBAAqB,KAAA,GAAW,CACpE;;IAGxB;GACF"}

package/dist/dev/dom/features/sync-text-track-modes.js

@@ -1,33 +0,0 @@
-import { effect } from "../../core/signals/effect.js";
-import { computed } from "../../core/signals/primitives.js";
-//#region src/dom/features/sync-text-track-modes.ts
-/**
-* Sync text track modes orchestration.
-*
-* Manages track element modes based on selectedTextTrackId:
-* - Selected track: mode = "showing"
-* - Other tracks: mode = "hidden"
-* - No selection: all tracks mode = "hidden"
-*
-* Note: Uses "hidden" instead of "disabled" for non-selected tracks
-* so they remain available in the browser's track menu.
-*
-* @example
-* const cleanup = syncTextTrackModes({ state, owners });
-*/
-function syncTextTrackModes({ state, owners }) {
-	const textTracksSignal = computed(() => owners.get().textTracks);
-	const selectedTextTrackIdSignal = computed(() => state.get().selectedTextTrackId);
-	const canSyncTextTrackModes = computed(() => !!textTracksSignal.get()?.size);
-	return effect(() => {
-		if (!canSyncTextTrackModes.get()) return;
-		/** @TODO refactor TextTracks owners model. Should simply use id. Also should use corresponding TextTrack (JS) element if possible (CJP) */
-		const textTracks = textTracksSignal.get();
-		const selectedTextTrackId = selectedTextTrackIdSignal.get();
-		for (const [trackId, trackElement] of textTracks) trackElement.track.mode = trackId === selectedTextTrackId ? "showing" : "hidden";
-	});
-}
-//#endregion
-export { syncTextTrackModes };
-
-//# sourceMappingURL=sync-text-track-modes.js.map

package/dist/dev/dom/features/sync-text-track-modes.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sync-text-track-modes.js","names":[],"sources":["../../../../src/dom/features/sync-text-track-modes.ts"],"sourcesContent":["import { effect } from '../../core/signals/effect';\nimport { computed, type Signal } from '../../core/signals/primitives';\n\n/**\n * State shape for text track mode synchronization.\n */\nexport interface TextTrackModeState {\n  selectedTextTrackId?: string | undefined;\n}\n\n/**\n * Owners shape for text track mode synchronization.\n */\nexport interface TextTrackModeOwners {\n  textTracks?: Map<string, HTMLTrackElement>;\n}\n\n/**\n * Sync text track modes orchestration.\n *\n * Manages track element modes based on selectedTextTrackId:\n * - Selected track: mode = \"showing\"\n * - Other tracks: mode = \"hidden\"\n * - No selection: all tracks mode = \"hidden\"\n *\n * Note: Uses \"hidden\" instead of \"disabled\" for non-selected tracks\n * so they remain available in the browser's track menu.\n *\n * @example\n * const cleanup = syncTextTrackModes({ state, owners });\n */\nexport function syncTextTrackModes<S extends TextTrackModeState, O extends TextTrackModeOwners>({\n  state,\n  owners,\n}: {\n  state: Signal<S>;\n  owners: Signal<O>;\n}): () => void {\n  const textTracksSignal = computed(() => owners.get().textTracks);\n  const selectedTextTrackIdSignal = computed(() => state.get().selectedTextTrackId);\n\n  const canSyncTextTrackModes = computed(() => !!textTracksSignal.get()?.size);\n\n  return effect(() => {\n    if (!canSyncTextTrackModes.get()) return;\n    /** @TODO refactor TextTracks owners model. Should simply use id. Also should use corresponding TextTrack (JS) element if possible (CJP) */\n    const textTracks = textTracksSignal.get() as Map<string, HTMLTrackElement>;\n    const selectedTextTrackId = selectedTextTrackIdSignal.get() as string;\n\n    for (const [trackId, trackElement] of textTracks) {\n      trackElement.track.mode = trackId === selectedTextTrackId ? 'showing' : 'hidden';\n    }\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AA+BA,SAAgB,mBAAgF,EAC9F,OACA,UAIa;CACb,MAAM,mBAAmB,eAAe,OAAO,KAAK,CAAC,WAAW;CAChE,MAAM,4BAA4B,eAAe,MAAM,KAAK,CAAC,oBAAoB;CAEjF,MAAM,wBAAwB,eAAe,CAAC,CAAC,iBAAiB,KAAK,EAAE,KAAK;AAE5E,QAAO,aAAa;AAClB,MAAI,CAAC,sBAAsB,KAAK,CAAE;;EAElC,MAAM,aAAa,iBAAiB,KAAK;EACzC,MAAM,sBAAsB,0BAA0B,KAAK;AAE3D,OAAK,MAAM,CAAC,SAAS,iBAAiB,WACpC,cAAa,MAAM,OAAO,YAAY,sBAAsB,YAAY;GAE1E"}