@amazon/vinyl 2.0.4 → 3.0.1

package/dist/index.cjs

@@ -69,6 +69,7 @@ __export(index_exports, {
   DrmRobustness: () => DrmRobustness,
   FAIR_PLAY_KEY_SYSTEMS: () => FAIR_PLAY_KEY_SYSTEMS,
   FixedPlaybackQuality: () => FixedPlaybackQuality,
+  HtmlTextTrackRenderer: () => HtmlTextTrackRenderer,
   InvalidSeekError: () => InvalidSeekError,
   LICENSE_TIMEOUT: () => LICENSE_TIMEOUT,
   LIVE_DURATION: () => LIVE_DURATION,
@@ -131,6 +132,7 @@ __export(index_exports, {
   applyVttCueStyle: () => applyVttCueStyle,
   assertMseSupported: () => assertMseSupported,
   audioContextRef: () => audioContextRef,
+  audioOptionsValidator: () => audioOptionsValidator,
   buildDashMediaTimeline: () => buildDashMediaTimeline,
   buildHlsMediaTimeline: () => buildHlsMediaTimeline,
   buildSegmentTimeline: () => buildSegmentTimeline,
@@ -145,6 +147,7 @@ __export(index_exports, {
   codecToContentType: () => codecToContentType,
   codecsToContentTypes: () => codecsToContentTypes,
   commonEmeFactory: () => commonEmeFactory,
+  computeCueLayout: () => computeCueLayout,
   configureVinylGlobal: () => configureVinylGlobal,
   contentProtectionToMetadata: () => contentProtectionToMetadata,
   contentTypeToMimeType: () => contentTypeToMimeType,
@@ -178,6 +181,7 @@ __export(index_exports, {
   createLanguageFilter: () => createLanguageFilter,
   createMediaQualityMetadataFromDashRepresentation: () => createMediaQualityMetadataFromDashRepresentation,
   createMediaSource: () => createMediaSource,
+  createMediaTextTrackProvider: () => createMediaTextTrackProvider,
   createPreventStallsPatch: () => createPreventStallsPatch,
   createSegmentControllerFactory: () => createSegmentControllerFactory,
   createSegmentDataProvider: () => createSegmentDataProvider,
@@ -192,6 +196,7 @@ __export(index_exports, {
   createVinylTrackFactories: () => createVinylTrackFactories,
   defaultAdControllerImplOptions: () => defaultAdControllerImplOptions,
   defaultAdLoadOptionsResolver: () => defaultAdLoadOptionsResolver,
+  defaultAudioOptions: () => defaultAudioOptions,
   defaultDrmKeySystemResolver: () => defaultDrmKeySystemResolver,
   defaultLicenseProvider: () => defaultLicenseProvider,
   defaultLoudnessNormalizationControllerImplOptions: () => defaultLoudnessNormalizationControllerImplOptions,
@@ -285,11 +290,13 @@ __export(index_exports, {
   playerRegistryRef: () => playerRegistryRef,
   prefetchPriorityQueuesRef: () => prefetchPriorityQueuesRef,
   qualitySelectorImplOptionsValidator: () => qualitySelectorImplOptionsValidator,
+  renderCueText: () => renderCueText,
   requiresPreventStallsPatch: () => requiresPreventStallsPatch,
   requiresUnreliablePlaybackEventsPatch: () => requiresUnreliablePlaybackEventsPatch,
   resolveCodecOverride: () => resolveCodecOverride,
   resolveDashUri: () => resolveDashUri,
   resolvePreferredLanguages: () => resolvePreferredLanguages,
+  resolveSelectedTrack: () => resolveSelectedTrack,
   sampleToMpdTime: () => sampleToMpdTime,
   segmentPriorityComparatorRef: () => segmentPriorityComparatorRef,
   segmentTemplateUrl: () => segmentTemplateUrl,
@@ -301,6 +308,7 @@ __export(index_exports, {
   supportsMse: () => supportsMse,
   supportsStandardEme: () => supportsStandardEme,
   supportsWebKitEme: () => supportsWebKitEme,
+  textTrackControllerOptionsValidator: () => textTrackControllerOptionsValidator,
   throwKeySystemsUnsupported: () => throwKeySystemsUnsupported,
   throwLanguagesUnsupported: () => throwLanguagesUnsupported,
   throwMimeTypesUnsupported: () => throwMimeTypesUnsupported,
@@ -2767,7 +2775,7 @@ function configureVinylGlobal(options) {
 var import_vinyl_util27 = require("@amazon/vinyl-util");
 var vinylVersion = /* @__PURE__ */ (0, import_vinyl_util27.parseVersion)(
   /* istanbul ignore next */
-  "2.0.4"
+  "3.0.1"
 );
 
 // src/global/globalRef.ts
@@ -4070,6 +4078,19 @@ var QualitySelectorImpl = class {
   }
 };
 
+// src/streaming/AudioOptions.ts
+var import_vinyl_validation8 = require("@amazon/vinyl-validation");
+var defaultAudioOptions = {
+  selection: { language: null, descriptive: false }
+};
+var audioSelectionValidator = /* @__PURE__ */ (0, import_vinyl_validation8.object)({
+  language: /* @__PURE__ */ (0, import_vinyl_validation8.string)().or(/* @__PURE__ */ (0, import_vinyl_validation8.array)(/* @__PURE__ */ (0, import_vinyl_validation8.string)()).readonly()).orNull().optional(),
+  descriptive: /* @__PURE__ */ (0, import_vinyl_validation8.boolean)().optional()
+});
+var audioOptionsValidator = /* @__PURE__ */ (0, import_vinyl_validation8.object)({
+  selection: /* @__PURE__ */ audioSelectionValidator.optional()
+});
+
 // src/streaming/buffering/BufferingController.ts
 var import_vinyl_util50 = require("@amazon/vinyl-util");
 
@@ -5389,22 +5410,22 @@ function createLanguageFilter(preferredLanguage, contentType2) {
     return best;
   };
   const bestScoreForPeriod = (0, import_vinyl_util57.memoize)(
-    (array4) => {
+    (array6) => {
       let best = 0;
-      for (const quality of Array.from(array4)) {
+      for (const quality of Array.from(array6)) {
         if (quality.contentType === contentType2 && quality.lang) {
           best = Math.max(best, scoreLang(quality.lang));
         }
       }
       return best;
     },
-    (array4) => array4,
+    (array6) => array6,
     1
   );
-  return (quality, _index, array4) => {
+  return (quality, _index, array6) => {
     if (quality.contentType !== contentType2) return true;
     if (!quality.lang) return true;
-    const best = bestScoreForPeriod(array4);
+    const best = bestScoreForPeriod(array6);
     if (best === 0) return true;
     return scoreLang(quality.lang) === best;
   };
@@ -5468,22 +5489,22 @@ function isAudioDescription(quality) {
 }
 function createAudioDescriptionFilter(preferDescription) {
   const periodFlags = (0, import_vinyl_util59.memoize)(
-    (array4) => {
+    (array6) => {
       let hasDescription = false;
       let hasMain = false;
-      for (const quality of Array.from(array4)) {
+      for (const quality of Array.from(array6)) {
         if (quality.contentType !== "audio") continue;
         if (isAudioDescription(quality)) hasDescription = true;
         else hasMain = true;
       }
       return { hasDescription, hasMain };
     },
-    (array4) => array4,
+    (array6) => array6,
     1
   );
-  return (quality, _index, array4) => {
+  return (quality, _index, array6) => {
     if (quality.contentType !== "audio") return true;
-    const { hasDescription, hasMain } = periodFlags(array4);
+    const { hasDescription, hasMain } = periodFlags(array6);
     if (preferDescription) {
       if (!hasDescription) return true;
       return isAudioDescription(quality);
@@ -5521,7 +5542,7 @@ var import_vinyl_util62 = require("@amazon/vinyl-util");
 function throwSamplingRatesUnsupported() {
   throw new import_vinyl_util62.MediaUnsupportedError("No supported sample rate", "sampling-rate");
 }
-function supportsAudioSamplingRate(deps, metadata, _index, array4) {
+function supportsAudioSamplingRate(deps, metadata, _index, array6) {
   const isFirefox = (0, import_vinyl_util62.hasBrowser)(import_vinyl_util62.Browser.FIREFOX);
   const maxSampleRate = deps.capabilities.sampleRate;
   const samplingRate = (0, import_vinyl_util62.last)(metadata.audioSamplingRate);
@@ -5530,13 +5551,13 @@ function supportsAudioSamplingRate(deps, metadata, _index, array4) {
     return samplingRate <= 48e3;
   }
   if (samplingRate <= maxSampleRate) return true;
-  const allAboveMax = (0, import_vinyl_util62.every)(array4, (item) => {
+  const allAboveMax = (0, import_vinyl_util62.every)(array6, (item) => {
     const itemSamplingRate = (0, import_vinyl_util62.last)(item.audioSamplingRate);
     return itemSamplingRate != null && itemSamplingRate > maxSampleRate;
   });
   if (allAboveMax) {
     const samplingRates = (0, import_vinyl_util62.map)(
-      array4,
+      array6,
       (item) => (0, import_vinyl_util62.last)(item.audioSamplingRate)
     ).filter((rate) => rate != null);
     const lowestSamplingRate = (0, import_vinyl_util62.min)(samplingRates);
@@ -5578,7 +5599,7 @@ function createDefaultMediaTimelineTransformer(deps) {
     return canPlayMimeType(deps, quality);
   }
   async function transformTimeline(timeline) {
-    var _a;
+    var _a, _b;
     const codecOverrides = deps.options.value.codecOverrides;
     let t = filterTimelineQualities(
       (quality) => canPlayWithOverrides(quality, codecOverrides),
@@ -5591,22 +5612,18 @@ function createDefaultMediaTimelineTransformer(deps) {
       t
     );
     t = filterTimelineQualities(
-      (quality, index, array4) => supportsAudioSamplingRate(deps, quality, index, array4),
+      (quality, index, array6) => supportsAudioSamplingRate(deps, quality, index, array6),
       throwSamplingRatesUnsupported,
       t
     );
+    const selection = deps.options.value.audio.selection;
     t = filterTimelineQualities(
-      createAudioDescriptionFilter(
-        (_a = deps.options.value.preferDescriptiveAudio) != null ? _a : false
-      ),
+      createAudioDescriptionFilter((_a = selection == null ? void 0 : selection.descriptive) != null ? _a : false),
       throwNoPlayableAudio,
       t
     );
     t = filterTimelineQualities(
-      createLanguageFilter(
-        deps.options.value.preferredAudioLanguage,
-        "audio"
-      ),
+      createLanguageFilter((_b = selection == null ? void 0 : selection.language) != null ? _b : null, "audio"),
       throwLanguagesUnsupported,
       t
     );
@@ -5614,8 +5631,7 @@ function createDefaultMediaTimelineTransformer(deps) {
   }
   return (0, import_vinyl_observable2.combineData)({
     timeline: deps.mediaTimeline,
-    preferredAudioLanguage: deps.options.pick("preferredAudioLanguage"),
-    preferDescriptiveAudio: deps.options.pick("preferDescriptiveAudio"),
+    audio: deps.options.pick("audio"),
     codecOverrides: deps.options.pick("codecOverrides")
   }).map(async ({ timeline }) => {
     return transformTimeline(await timeline);
@@ -5623,7 +5639,7 @@ function createDefaultMediaTimelineTransformer(deps) {
 }
 
 // src/streaming/DescriptorRecord.ts
-var import_vinyl_validation8 = require("@amazon/vinyl-validation");
+var import_vinyl_validation9 = require("@amazon/vinyl-validation");
 var import_vinyl_util63 = require("@amazon/vinyl-util");
 function getDescriptorValue(record4, uri, id) {
   var _a, _b;
@@ -5632,11 +5648,11 @@ function getDescriptorValue(record4, uri, id) {
   if (id !== void 0) arr = arr.filter((descriptor) => descriptor.id === id);
   return (_b = (_a = (0, import_vinyl_util63.first)(arr)) == null ? void 0 : _a.value) != null ? _b : null;
 }
-var descriptorValidator = /* @__PURE__ */ (0, import_vinyl_validation8.object)({
-  id: /* @__PURE__ */ (0, import_vinyl_validation8.string)().maybe().optional(),
-  value: /* @__PURE__ */ (0, import_vinyl_validation8.string)().maybe().optional()
+var descriptorValidator = /* @__PURE__ */ (0, import_vinyl_validation9.object)({
+  id: /* @__PURE__ */ (0, import_vinyl_validation9.string)().maybe().optional(),
+  value: /* @__PURE__ */ (0, import_vinyl_validation9.string)().maybe().optional()
 });
-var descriptorRecordValidator = /* @__PURE__ */ (0, import_vinyl_validation8.record)(/* @__PURE__ */ (0, import_vinyl_validation8.string)(), /* @__PURE__ */ (0, import_vinyl_validation8.array)(descriptorValidator).readonly().orUndefined());
+var descriptorRecordValidator = /* @__PURE__ */ (0, import_vinyl_validation9.record)(/* @__PURE__ */ (0, import_vinyl_validation9.string)(), /* @__PURE__ */ (0, import_vinyl_validation9.array)(descriptorValidator).readonly().orUndefined());
 
 // src/streaming/ManifestControllerImpl.ts
 var import_vinyl_observable3 = require("@amazon/vinyl-observable");
@@ -5741,7 +5757,7 @@ var ManifestControllerImpl = class {
 
 // src/streaming/MediaQualityMetadata.ts
 var import_vinyl_util65 = require("@amazon/vinyl-util");
-var import_vinyl_validation9 = require("@amazon/vinyl-validation");
+var import_vinyl_validation10 = require("@amazon/vinyl-validation");
 var ALL_CONTENT_TYPES = [
   "video",
   "audio",
@@ -5752,16 +5768,16 @@ var RESTRICTABLE_CONTENT_TYPES = [
   "audio"
 ];
 var drmProtectionValidator = /* @__PURE__ */ descriptorValidator.extend({
-  keySystem: /* @__PURE__ */ (0, import_vinyl_validation9.enumOf)(DrmKeySystem),
-  pro: /* @__PURE__ */ (0, import_vinyl_validation9.string)().maybe().optional(),
-  pssh: /* @__PURE__ */ (0, import_vinyl_validation9.string)().maybe().optional()
+  keySystem: /* @__PURE__ */ (0, import_vinyl_validation10.enumOf)(DrmKeySystem),
+  pro: /* @__PURE__ */ (0, import_vinyl_validation10.string)().maybe().optional(),
+  pssh: /* @__PURE__ */ (0, import_vinyl_validation10.string)().maybe().optional()
 });
-var mediaFormatMetadataValidator = /* @__PURE__ */ (0, import_vinyl_validation9.object)({
-  contentProtections: /* @__PURE__ */ (0, import_vinyl_validation9.array)(drmProtectionValidator).readonly(),
-  contentType: /* @__PURE__ */ (0, import_vinyl_validation9.isOneOf)("audio", "video", "text").orNull(),
-  initDataType: /* @__PURE__ */ (0, import_vinyl_validation9.string)().orNull(),
-  encryptionScheme: /* @__PURE__ */ (0, import_vinyl_validation9.string)().orNull(),
-  mimeType: /* @__PURE__ */ (0, import_vinyl_validation9.string)().orNull()
+var mediaFormatMetadataValidator = /* @__PURE__ */ (0, import_vinyl_validation10.object)({
+  contentProtections: /* @__PURE__ */ (0, import_vinyl_validation10.array)(drmProtectionValidator).readonly(),
+  contentType: /* @__PURE__ */ (0, import_vinyl_validation10.isOneOf)("audio", "video", "text").orNull(),
+  initDataType: /* @__PURE__ */ (0, import_vinyl_validation10.string)().orNull(),
+  encryptionScheme: /* @__PURE__ */ (0, import_vinyl_validation10.string)().orNull(),
+  mimeType: /* @__PURE__ */ (0, import_vinyl_validation10.string)().orNull()
 });
 function createEmptyMediaFormatMetadata() {
   return {
@@ -5791,20 +5807,20 @@ function createEmptyMediaQualityMetadata() {
   });
 }
 var mediaQualityMetadataValidator = /* @__PURE__ */ mediaFormatMetadataValidator.extend({
-  audioSamplingRate: /* @__PURE__ */ (0, import_vinyl_validation9.array)(/* @__PURE__ */ (0, import_vinyl_validation9.number)()).readonly().orNull(),
-  bandwidth: /* @__PURE__ */ (0, import_vinyl_validation9.number)().orNull(),
-  bandwidthTotal: /* @__PURE__ */ (0, import_vinyl_validation9.number)().orNull(),
-  codecs: /* @__PURE__ */ (0, import_vinyl_validation9.string)().orNull(),
-  decoderId: /* @__PURE__ */ (0, import_vinyl_validation9.string)(),
-  frameRate: /* @__PURE__ */ (0, import_vinyl_validation9.tuple)(/* @__PURE__ */ (0, import_vinyl_validation9.number)(), /* @__PURE__ */ (0, import_vinyl_validation9.number)()).readonly().orNull(),
-  height: /* @__PURE__ */ (0, import_vinyl_validation9.number)().orNull(),
-  qualityId: /* @__PURE__ */ (0, import_vinyl_validation9.string)(),
+  audioSamplingRate: /* @__PURE__ */ (0, import_vinyl_validation10.array)(/* @__PURE__ */ (0, import_vinyl_validation10.number)()).readonly().orNull(),
+  bandwidth: /* @__PURE__ */ (0, import_vinyl_validation10.number)().orNull(),
+  bandwidthTotal: /* @__PURE__ */ (0, import_vinyl_validation10.number)().orNull(),
+  codecs: /* @__PURE__ */ (0, import_vinyl_validation10.string)().orNull(),
+  decoderId: /* @__PURE__ */ (0, import_vinyl_validation10.string)(),
+  frameRate: /* @__PURE__ */ (0, import_vinyl_validation10.tuple)(/* @__PURE__ */ (0, import_vinyl_validation10.number)(), /* @__PURE__ */ (0, import_vinyl_validation10.number)()).readonly().orNull(),
+  height: /* @__PURE__ */ (0, import_vinyl_validation10.number)().orNull(),
+  qualityId: /* @__PURE__ */ (0, import_vinyl_validation10.string)(),
   supplementalProperties: descriptorRecordValidator,
-  width: /* @__PURE__ */ (0, import_vinyl_validation9.number)().orNull(),
-  lang: /* @__PURE__ */ (0, import_vinyl_validation9.string)().orNull(),
-  characteristics: /* @__PURE__ */ (0, import_vinyl_validation9.array)(/* @__PURE__ */ (0, import_vinyl_validation9.string)()).readonly(),
-  groupId: /* @__PURE__ */ (0, import_vinyl_validation9.string)(),
-  switchingGroupIds: /* @__PURE__ */ (0, import_vinyl_validation9.array)(/* @__PURE__ */ (0, import_vinyl_validation9.string)()).readonly().orNull()
+  width: /* @__PURE__ */ (0, import_vinyl_validation10.number)().orNull(),
+  lang: /* @__PURE__ */ (0, import_vinyl_validation10.string)().orNull(),
+  characteristics: /* @__PURE__ */ (0, import_vinyl_validation10.array)(/* @__PURE__ */ (0, import_vinyl_validation10.string)()).readonly(),
+  groupId: /* @__PURE__ */ (0, import_vinyl_validation10.string)(),
+  switchingGroupIds: /* @__PURE__ */ (0, import_vinyl_validation10.array)(/* @__PURE__ */ (0, import_vinyl_validation10.string)()).readonly().orNull()
 });
 
 // src/streaming/MediaTimeline.ts
@@ -6584,10 +6600,202 @@ function discoverHlsTextTracks(mainPlaylist, baseUrl) {
   return out;
 }
 
+// src/text/HtmlTextTrackRenderer.ts
+var ROW_EM = 1.5;
+function computeCueLayout(cue) {
+  const style = {};
+  style.textAlign = cue.align || "center";
+  if (cue.vertical === "rl") style.writingMode = "vertical-rl";
+  else if (cue.vertical === "lr") style.writingMode = "vertical-lr";
+  const size = typeof cue.size === "number" ? cue.size : 100;
+  style.maxWidth = `${size}%`;
+  const line = typeof cue.line === "number" ? cue.line : null;
+  const position = typeof cue.position === "number" ? cue.position : null;
+  if (line == null && position == null) return style;
+  style.position = "absolute";
+  const transforms = [];
+  if (position == null) {
+    style.left = "50%";
+    transforms.push("translateX(-50%)");
+  } else {
+    if (cue.positionAlign === "line-right") {
+      style.right = `${100 - position}%`;
+    } else if (cue.positionAlign === "line-left") {
+      style.left = `${position}%`;
+    } else {
+      style.left = `${position}%`;
+      transforms.push("translateX(-50%)");
+    }
+  }
+  if (line == null) {
+    style.bottom = "0";
+  } else {
+    if (cue.snapToLines === false) {
+      if (cue.lineAlign === "end") {
+        style.bottom = `${100 - line}%`;
+      } else if (cue.lineAlign === "center") {
+        style.top = `${line}%`;
+        transforms.push("translateY(-50%)");
+      } else {
+        style.top = `${line}%`;
+      }
+    } else if (line < 0) {
+      style.bottom = `${(-line - 1) * ROW_EM}em`;
+    } else {
+      style.top = `${line * ROW_EM}em`;
+    }
+  }
+  if (transforms.length > 0) style.transform = transforms.join(" ");
+  return style;
+}
+var HTML_ESCAPE = {
+  "&": "&amp;",
+  "<": "&lt;",
+  ">": "&gt;",
+  '"': "&quot;"
+};
+function escapeHtml(text) {
+  return text.replace(/["&<>]/g, (ch) => HTML_ESCAPE[ch]);
+}
+var PASSTHROUGH_TAGS = /* @__PURE__ */ new Set(["i", "b", "u", "ruby", "rt"]);
+var SPAN_TAGS = /* @__PURE__ */ new Set(["c", "v", "lang"]);
+function openTag(inner) {
+  if (/^\d/.test(inner)) return "";
+  const head = inner.split(/\s/, 1)[0];
+  const [name, ...classes] = head.split(".");
+  const annotation = inner.slice(head.length).trim();
+  const classAttr = classes.filter(Boolean).length ? ` class="${escapeHtml(classes.filter(Boolean).join(" "))}"` : "";
+  if (PASSTHROUGH_TAGS.has(name)) return `<${name}${classAttr}>`;
+  if (name === "v") {
+    const title = annotation ? ` title="${escapeHtml(annotation)}"` : "";
+    return `<span${classAttr}${title}>`;
+  }
+  if (name === "lang") {
+    const lang = annotation ? ` lang="${escapeHtml(annotation)}"` : "";
+    return `<span${classAttr}${lang}>`;
+  }
+  if (name === "c") return `<span${classAttr}>`;
+  return "";
+}
+function closeTag(name) {
+  if (PASSTHROUGH_TAGS.has(name)) return `</${name}>`;
+  if (SPAN_TAGS.has(name)) return "</span>";
+  return "";
+}
+function renderCueText(text) {
+  var _a;
+  let html = "";
+  for (const token of (_a = text.match(/<[^<>]*>|[^<]+|</g)) != null ? _a : []) {
+    if (token[0] !== "<" || token === "<") {
+      html += escapeHtml(token).replace(/\n/g, "<br>");
+    } else {
+      const inner = token.slice(1, -1);
+      html += inner[0] === "/" ? closeTag(
+        inner.slice(1).split(/[.\s]/, 1)[0].toLowerCase()
+      ) : openTag(inner);
+    }
+  }
+  return html;
+}
+function scopeCueRules(css) {
+  return css.replace(/::cue\(([^)]*)\)/g, ".vinyl-text-cue $1").replace(/::cue\b/g, ".vinyl-text-cue");
+}
+var HtmlTextTrackRenderer = class {
+  constructor() {
+    /** The overlay container to mount over the video. */
+    __publicField(this, "element");
+    __publicField(this, "track", null);
+    // Holds the authored STYLE-block CSS (::cue rules rewritten to target our
+    // cue elements). A <style> renders nothing itself, so it lives in-container.
+    __publicField(this, "styleElement");
+    __publicField(this, "onCueChange", () => this.renderActiveCues());
+    this.element = document.createElement("div");
+    this.element.className = "vinyl-text-container";
+    Object.assign(this.element.style, {
+      display: "flex",
+      flexDirection: "column",
+      justifyContent: "flex-end",
+      alignItems: "center",
+      pointerEvents: "none"
+    });
+    this.styleElement = document.createElement("style");
+    this.element.appendChild(this.styleElement);
+  }
+  setTextTrack(track) {
+    var _a;
+    if (track === this.track) return;
+    (_a = this.track) == null ? void 0 : _a.removeEventListener("cuechange", this.onCueChange);
+    this.track = track;
+    this.styleElement.textContent = "";
+    if (!track) {
+      this.element.replaceChildren(this.styleElement);
+      return;
+    }
+    track.addEventListener("cuechange", this.onCueChange);
+    this.renderActiveCues();
+  }
+  setStyles(styles) {
+    this.styleElement.textContent = styles.map(scopeCueRules).join("\n");
+  }
+  dispose() {
+    this.setTextTrack(null);
+  }
+  renderActiveCues() {
+    var _a;
+    const active = (_a = this.track.activeCues) != null ? _a : [];
+    const children = [this.styleElement];
+    for (let i = 0; i < active.length; i++) {
+      children.push(this.createCueBox(active[i]));
+    }
+    this.element.replaceChildren(...children);
+  }
+  createCueBox(cue) {
+    var _a;
+    const box = document.createElement("div");
+    box.className = "vinyl-text-cue";
+    Object.assign(box.style, computeCueLayout(cue));
+    box.innerHTML = renderCueText((_a = cue.text) != null ? _a : "");
+    return box;
+  }
+};
+
+// src/text/mediaTextTrackProvider.ts
+function createMediaTextTrackProvider(deps) {
+  const { media } = deps;
+  const cache = /* @__PURE__ */ new Map();
+  const isAttached = (track) => {
+    for (let i = 0; i < media.textTracks.length; i++) {
+      if (media.textTracks[i] === track) return true;
+    }
+    return false;
+  };
+  const create = (kind, label, language) => {
+    const track = media.addTextTrack(kind, label, language);
+    return {
+      track,
+      clear() {
+        if (!track.cues) return;
+        const all = Array.from(track.cues);
+        for (const cue of all) track.removeCue(cue);
+      }
+    };
+  };
+  return {
+    getOrCreate(kind, label, language) {
+      const key = `${kind}-${label}-${language}`;
+      const cached = cache.get(key);
+      if (cached && isAttached(cached.track)) return cached;
+      const ref = create(kind, label, language);
+      cache.set(key, ref);
+      return ref;
+    }
+  };
+}
+
 // src/text/parseWebVtt.ts
 var import_vinyl_util73 = require("@amazon/vinyl-util");
 var WEBVTT_HEADER = "WEBVTT";
-var TIME_RE = /^\s*(?:(\d+):)?([0-5]?\d):([0-5]?\d)\.(\d{3})\s*-->\s*(?:(\d+):)?([0-5]?\d):([0-5]?\d)\.(\d{3})(?:\s.*)?$/;
+var TIMESTAMP_RE = /^(?:(\d+):)?([0-5]\d):([0-5]\d)\.(\d{3})/;
 function parseWebVtt(input) {
   if (typeof input !== "string") {
     throw new import_vinyl_util73.ValidationError(
@@ -6605,6 +6813,7 @@ function parseWebVtt(input) {
     );
   }
   const cues = [];
+  const styles = [];
   let i = 1;
   while (i < lines.length && lines[i] !== "") i++;
   while (i < lines.length) {
@@ -6612,49 +6821,71 @@ function parseWebVtt(input) {
       i++;
       continue;
     }
-    if (lines[i] === "NOTE" || lines[i].startsWith("NOTE ")) {
+    if (lines[i] === "NOTE" || lines[i].startsWith("NOTE ") || lines[i].startsWith("NOTE	") || lines[i] === "REGION") {
       i++;
       while (i < lines.length && lines[i] !== "") i++;
       continue;
     }
-    if (lines[i] === "STYLE" || lines[i] === "REGION") {
+    if (lines[i] === "STYLE") {
       i++;
+      const start = i;
       while (i < lines.length && lines[i] !== "") i++;
+      const css = lines.slice(start, i).join("\n").trim();
+      if (css) styles.push(css);
       continue;
     }
     let id = null;
-    let timingLine;
-    const firstLine = lines[i];
-    if (TIME_RE.test(firstLine)) {
-      timingLine = firstLine;
-      i++;
-    } else {
-      id = firstLine;
+    if (!lines[i].includes("-->")) {
+      id = lines[i];
       i++;
       if (i >= lines.length) break;
-      timingLine = lines[i];
-      i++;
     }
-    const match = TIME_RE.exec(timingLine);
-    if (!match) {
+    const timing = parseTiming(lines[i]);
+    i++;
+    if (!timing) {
       while (i < lines.length && lines[i] !== "") i++;
       continue;
     }
-    const startTime = toSeconds(match[1], match[2], match[3], match[4]);
-    const endTime = toSeconds(match[5], match[6], match[7], match[8]);
     const payloadLines = [];
     while (i < lines.length && lines[i] !== "") {
       payloadLines.push(lines[i]);
       i++;
     }
-    cues.push({
-      id,
-      startTime,
-      endTime,
-      text: payloadLines.join("\n")
-    });
+    const text2 = payloadLines.join("\n");
+    cues.push(
+      timing.settings === void 0 ? {
+        id,
+        startTime: timing.startTime,
+        endTime: timing.endTime,
+        text: text2
+      } : {
+        id,
+        startTime: timing.startTime,
+        endTime: timing.endTime,
+        text: text2,
+        settings: timing.settings
+      }
+    );
   }
-  return { cues };
+  return { cues, styles };
+}
+function parseTiming(line) {
+  const arrow = line.indexOf("-->");
+  if (arrow < 0) return null;
+  const before = line.slice(0, arrow).trim();
+  const start = TIMESTAMP_RE.exec(before);
+  if (!start || start[0].length !== before.length) return null;
+  const rest = line.slice(arrow + 3).trim();
+  const end = TIMESTAMP_RE.exec(rest);
+  if (!end) return null;
+  return {
+    startTime: toSeconds(start[1], start[2], start[3], start[4]),
+    endTime: toSeconds(end[1], end[2], end[3], end[4]),
+    settings: parseCueSettings(rest.slice(end[0].length))
+  };
+}
+function toSeconds(hours, minutes, seconds, millis) {
+  return (hours ? Number(hours) * 3600 : 0) + Number(minutes) * 60 + Number(seconds) + Number(millis) / 1e3;
 }
 function isWebVttHeader(line) {
   if (!line.startsWith(WEBVTT_HEADER)) return false;
@@ -6662,18 +6893,80 @@ function isWebVttHeader(line) {
   const next = line.charCodeAt(WEBVTT_HEADER.length);
   return next === 32 || next === 9;
 }
-function toSeconds(hours, minutes, seconds, millis) {
-  const h = hours ? Number(hours) : 0;
-  const m = Number(minutes);
-  const s = Number(seconds);
-  const ms = Number(millis);
-  return h * 3600 + m * 60 + s + ms / 1e3;
+var ALIGN = /* @__PURE__ */ new Set(["start", "center", "end", "left", "right"]);
+var LINE_ALIGN = /* @__PURE__ */ new Set(["start", "center", "end"]);
+var POSITION_ALIGN = /* @__PURE__ */ new Set(["line-left", "center", "line-right", "auto"]);
+var VERTICAL = /* @__PURE__ */ new Set(["rl", "lr"]);
+function parseCueSettings(text) {
+  if (!text) return void 0;
+  const settings = {};
+  for (const token of text.trim().split(/\s+/)) {
+    const colon = token.indexOf(":");
+    if (colon <= 0) continue;
+    const key = token.slice(0, colon);
+    const value = token.slice(colon + 1);
+    switch (key) {
+      case "align": {
+        const align = value === "middle" ? "center" : value;
+        if (ALIGN.has(align)) settings.align = align;
+        break;
+      }
+      case "vertical":
+        if (VERTICAL.has(value))
+          settings.vertical = value;
+        break;
+      case "size": {
+        const size = parsePercent(value);
+        if (size != null) settings.size = size;
+        break;
+      }
+      case "line":
+        parseLine(value, settings);
+        break;
+      case "position":
+        parsePosition(value, settings);
+        break;
+    }
+  }
+  return Object.keys(settings).length > 0 ? settings : void 0;
+}
+function parseLine(value, settings) {
+  const [pos, align] = value.split(",");
+  if (pos.endsWith("%")) {
+    const percent = parsePercent(pos);
+    if (percent == null) return;
+    settings.line = percent;
+    settings.snapToLines = false;
+  } else {
+    const n = Number(pos);
+    if (!Number.isInteger(n)) return;
+    settings.line = n;
+    settings.snapToLines = true;
+  }
+  const lineAlign = align === "middle" ? "center" : align;
+  if (lineAlign && LINE_ALIGN.has(lineAlign))
+    settings.lineAlign = lineAlign;
+}
+function parsePosition(value, settings) {
+  const [pos, align] = value.split(",");
+  const percent = parsePercent(pos);
+  if (percent == null) return;
+  settings.position = percent;
+  const positionAlign = align === "middle" ? "center" : align;
+  if (positionAlign && POSITION_ALIGN.has(positionAlign))
+    settings.positionAlign = positionAlign;
+}
+function parsePercent(value) {
+  if (!value.endsWith("%")) return null;
+  const n = Number(value.slice(0, -1));
+  return Number.isFinite(n) ? n : null;
 }
 
 // src/text/pickPreferredTextTrack.ts
 function resolvePreferredTextLanguages(preferred) {
   if (typeof preferred === "string") return [preferred];
   if (preferred) return preferred;
+  if (typeof navigator !== "undefined") return [...navigator.languages];
   return [];
 }
 function pickPreferredTextTrack(tracks, preferred) {
@@ -6716,7 +7009,7 @@ var DEFAULT_TEXT_LOOK_BEHIND = 2;
 var IDLE_POLL_SECONDS = 0.25;
 async function loadWebVttCues(uri, options) {
   var _a, _b, _c;
-  const { abort, requestInit, variables, onCues, getCurrentTime } = options;
+  const { abort, requestInit, variables, onCues, onStyles, getCurrentTime } = options;
   const lookAhead = (_a = options.lookAhead) != null ? _a : DEFAULT_TEXT_LOOK_AHEAD;
   const lookBehind = (_b = options.lookBehind) != null ? _b : DEFAULT_TEXT_LOOK_BEHIND;
   const init = requestInit != null ? requestInit : void 0;
@@ -6727,6 +7020,7 @@ async function loadWebVttCues(uri, options) {
       abort,
       variables: variables != null ? variables : void 0,
       onCues,
+      onStyles,
       getCurrentTime,
       lookAhead,
       lookBehind
@@ -6743,13 +7037,15 @@ async function loadWebVttCues(uri, options) {
       abort,
       variables: variables != null ? variables : void 0,
       onCues,
+      onStyles,
       getCurrentTime,
       lookAhead,
       lookBehind
     });
   }
-  const cues = parseWebVtt(body).cues;
-  if (cues.length > 0) onCues(cues);
+  const doc = parseWebVtt(body);
+  if (doc.cues.length > 0) onCues(doc.cues);
+  if (onStyles && doc.styles.length > 0) onStyles(doc.styles);
 }
 function looksLikeMediaPlaylist(uri) {
   const path = uri.split(/[?#]/)[0];
@@ -6789,8 +7085,9 @@ async function streamMediaPlaylistText(ctx) {
       abort: ctx.abort
     });
     const body = await res.text();
-    const cues = parseWebVtt(body).cues;
-    if (cues.length > 0) ctx.onCues(cues);
+    const doc = parseWebVtt(body);
+    if (doc.cues.length > 0) ctx.onCues(doc.cues);
+    if (ctx.onStyles && doc.styles.length > 0) ctx.onStyles(doc.styles);
   }
 }
 function pickInWindow(pending, ranges, ctx) {
@@ -6813,7 +7110,7 @@ function pickInWindow(pending, ranges, ctx) {
 }
 
 // src/text/VttCueStyle.ts
-var import_vinyl_validation10 = require("@amazon/vinyl-validation");
+var import_vinyl_validation11 = require("@amazon/vinyl-validation");
 function isVttCue(cue) {
   return typeof VTTCue !== "undefined" && cue instanceof VTTCue;
 }
@@ -6828,39 +7125,62 @@ function applyVttCueStyle(cue, style) {
   if (style.snapToLines !== void 0) cue.snapToLines = style.snapToLines;
   if (style.vertical !== void 0) cue.vertical = style.vertical;
 }
-var vttCueStyleValidator = /* @__PURE__ */ (0, import_vinyl_validation10.object)({
-  align: /* @__PURE__ */ (0, import_vinyl_validation10.isOneOf)("start", "center", "end", "left", "right").optional(),
-  line: /* @__PURE__ */ (0, import_vinyl_validation10.number)().or(/* @__PURE__ */ (0, import_vinyl_validation10.isOneOf)("auto")).optional(),
-  lineAlign: /* @__PURE__ */ (0, import_vinyl_validation10.isOneOf)("start", "center", "end").optional(),
-  position: /* @__PURE__ */ (0, import_vinyl_validation10.number)().or(/* @__PURE__ */ (0, import_vinyl_validation10.isOneOf)("auto")).optional(),
-  positionAlign: /* @__PURE__ */ (0, import_vinyl_validation10.isOneOf)(
+var vttCueStyleValidator = /* @__PURE__ */ (0, import_vinyl_validation11.object)({
+  align: /* @__PURE__ */ (0, import_vinyl_validation11.isOneOf)("start", "center", "end", "left", "right").optional(),
+  line: /* @__PURE__ */ (0, import_vinyl_validation11.number)().or(/* @__PURE__ */ (0, import_vinyl_validation11.isOneOf)("auto")).optional(),
+  lineAlign: /* @__PURE__ */ (0, import_vinyl_validation11.isOneOf)("start", "center", "end").optional(),
+  position: /* @__PURE__ */ (0, import_vinyl_validation11.number)().or(/* @__PURE__ */ (0, import_vinyl_validation11.isOneOf)("auto")).optional(),
+  positionAlign: /* @__PURE__ */ (0, import_vinyl_validation11.isOneOf)(
     "line-left",
     "center",
     "line-right",
     "auto"
   ).optional(),
-  size: /* @__PURE__ */ (0, import_vinyl_validation10.number)().optional(),
-  snapToLines: /* @__PURE__ */ (0, import_vinyl_validation10.boolean)().optional(),
-  vertical: /* @__PURE__ */ (0, import_vinyl_validation10.isOneOf)("", "rl", "lr").optional()
+  size: /* @__PURE__ */ (0, import_vinyl_validation11.number)().optional(),
+  snapToLines: /* @__PURE__ */ (0, import_vinyl_validation11.boolean)().optional(),
+  vertical: /* @__PURE__ */ (0, import_vinyl_validation11.isOneOf)("", "rl", "lr").optional()
 });
 
 // src/text/SidecarTextTrackController.ts
+function resolveSelectedTrack(tracks, options) {
+  var _a, _b, _c, _d;
+  const mode = (_a = options.enabled) != null ? _a : "forced";
+  if (mode === "off") return null;
+  const selection = (_b = options.selection) != null ? _b : {};
+  if (selection.id != null) {
+    return (_c = tracks.find((t) => t.id === selection.id)) != null ? _c : null;
+  }
+  let pool = tracks;
+  if (selection.kind != null) {
+    pool = pool.filter((t) => t.kind === selection.kind);
+  }
+  const forced = (_d = selection.forced) != null ? _d : mode === "forced";
+  pool = pool.filter((t) => t.forced === forced);
+  return pickPreferredTextTrack(pool, selection.language);
+}
 var SidecarTextTrackController = class extends import_vinyl_util75.EventHostImpl {
   constructor(deps) {
-    var _a, _b;
     super();
     __publicField(this, "deps", deps);
+    // Whether the owning media track is current (rendering allowed). Toggled by
+    // activate()/deactivate() across suspensions such as ad breaks.
+    __publicField(this, "_active", false);
     __publicField(this, "_tracks", []);
-    __publicField(this, "_active", null);
-    __publicField(this, "_domTrack", null);
-    __publicField(this, "loadAbort", null);
-    // True once the app has made an explicit selection (including null). Until
-    // then, forced tracks auto-select on discovery.
-    __publicField(this, "_userSelected", false);
-    __publicField(this, "preferredLanguageSub");
-    this.preferredLanguageSub = (_b = (_a = deps.preferredTextLanguage) == null ? void 0 : _a.onData((value, previous) => {
-      if (previous !== void 0) this.applyPreferredLanguage(value);
-    })) != null ? _b : null;
+    __publicField(this, "_activeTextTrack", null);
+    // The DOM text track currently rendering cues, or null when hidden. Owned by
+    // the provider (never created/removed here).
+    __publicField(this, "_ref", null);
+    __publicField(this, "loadAbort", /* @__PURE__ */ (0, import_vinyl_util75.createAbortSlot)());
+    __publicField(this, "disposer", /* @__PURE__ */ (0, import_vinyl_util75.createDisposer)());
+    const { add } = this.disposer;
+    add(deps.options.onData(() => this.refreshSelection()));
+    add(
+      deps.textTracks.onData((tracksPromise) => {
+        tracksPromise.then((tracks) => this.setTracks(tracks)).catch((error) => {
+          (0, import_vinyl_util75.logError)(this, "text tracks promise rejected", error);
+        });
+      })
+    );
   }
   get [Symbol.toStringTag]() {
     return "SidecarTextTrackController";
@@ -6869,120 +7189,89 @@ var SidecarTextTrackController = class extends import_vinyl_util75.EventHostImpl
     return this._tracks;
   }
   get activeTextTrack() {
+    return this._activeTextTrack;
+  }
+  get active() {
     return this._active;
   }
+  get disposed() {
+    return this.disposer.disposed;
+  }
   /**
-   * Replaces the discovered text track list. Emits `textTracksChange`. If
-   * the previously active track is no longer present, clears the active
-   * selection and emits `activeTextTrackChange`.
+   * Replaces the discovered track list, emits `textTracksChange`, then
+   * re-applies the current selection against the new list.
    */
-  setTextTracks(tracks) {
-    var _a;
-    if ((0, import_vinyl_util75.equalDeep)(this._tracks, tracks)) return;
+  setTracks(tracks) {
+    if (this.disposed) return;
     const previous = this._tracks;
+    if ((0, import_vinyl_util75.equalDeep)(previous, tracks)) return;
     this._tracks = tracks;
     this.dispatch("textTracksChange", { previous, current: tracks });
-    if (this._active && !tracks.some((t) => t.id === this._active.id)) {
-      this.selectById(null);
-    }
-    const preferred = (_a = this.deps.preferredTextLanguage) == null ? void 0 : _a.value;
-    if (preferred != null) {
-      this.applyPreferredLanguage(preferred);
-    } else if (!this._userSelected && !this._active) {
-      const forced = this.pickForcedTrack(tracks);
-      if (forced) this.selectById(forced.id);
-    }
-  }
-  setActiveTextTrack(id) {
-    this._userSelected = true;
-    this.selectById(id);
+    this.refreshSelection();
   }
   /**
-   * Selects the track best matching the preferred language(s), or clears the
-   * selection when the preference is null or nothing matches.
+   * Recomputes the selection from the current options and track list,
+   * emitting `activeTextTrackChange` on change and (re)rendering when active.
    */
-  applyPreferredLanguage(preferred) {
-    var _a;
-    const target = pickPreferredTextTrack(this._tracks, preferred);
-    this.setActiveTextTrack((_a = target == null ? void 0 : target.id) != null ? _a : null);
-  }
-  /**
-   * Applies a selection by id (null clears it) without marking it as an
-   * explicit user choice. Shared by setActiveTextTrack and forced auto-select.
-   */
-  selectById(id) {
-    var _a, _b;
-    const next = id == null ? null : this._tracks.find((t) => t.id === id);
-    if (id != null && !next) return;
-    const target = next != null ? next : null;
-    if ((target == null ? void 0 : target.id) === ((_a = this._active) == null ? void 0 : _a.id)) return;
-    const previous = this._active;
-    this.clearDomTrack();
-    (_b = this.loadAbort) == null ? void 0 : _b.abort();
-    this.loadAbort = null;
-    this._active = target;
-    this.dispatch("activeTextTrackChange", {
-      previous,
-      current: target
-    });
-    if (target) this.startLoad(target);
-  }
-  /**
-   * The forced track to auto-select, or null. Prefers the default track's
-   * language, else the first forced track.
-   */
-  pickForcedTrack(tracks) {
-    var _a;
-    const forced = tracks.filter((t) => t.forced);
-    if (forced.length === 0) return null;
-    const defaultLang = (_a = tracks.find((t) => t.default)) == null ? void 0 : _a.language;
-    if (defaultLang != null) {
-      const match = forced.find((t) => t.language === defaultLang);
-      if (match) return match;
+  refreshSelection() {
+    const previous = this._activeTextTrack;
+    const target = resolveSelectedTrack(
+      this._tracks,
+      this.deps.options.value
+    );
+    const trackChanged = (target == null ? void 0 : target.id) !== (previous == null ? void 0 : previous.id);
+    if (trackChanged) {
+      this._activeTextTrack = target;
+      this.dispatch("activeTextTrackChange", {
+        previous,
+        current: target
+      });
     }
-    return forced[0];
-  }
-  suspend() {
-    var _a;
-    (_a = this.loadAbort) == null ? void 0 : _a.abort();
-    this.loadAbort = null;
-    this.clearDomTrack();
+    if (!this._active) return;
+    if (!target) this.hideCurrent();
+    else if (trackChanged || !this._ref) this.startLoad(target);
   }
-  resume() {
-    if (!this._active || this._domTrack) return;
-    this.startLoad(this._active);
+  deactivate() {
+    this._active = false;
+    this.hideCurrent();
   }
-  /**
-   * Cancels any in-flight load, clears the DOM TextTrack, and resets state.
-   * Called by the host when the underlying media is unloaded.
-   */
-  dispose() {
-    var _a, _b;
-    super.dispose();
-    (_a = this.preferredLanguageSub) == null ? void 0 : _a.call(this);
-    (_b = this.loadAbort) == null ? void 0 : _b.abort();
-    this.loadAbort = null;
-    this.clearDomTrack();
-    this._tracks = [];
-    this._active = null;
+  activate() {
+    this._active = true;
+    if (!this._activeTextTrack || this._ref) return;
+    this.startLoad(this._activeTextTrack);
   }
   startLoad(track) {
-    const media = this.deps.media;
-    if (!media) return;
-    const abort = new import_vinyl_util75.Abort();
-    this.loadAbort = abort;
-    const dom = this.ensureDomTrack(media, track);
+    var _a, _b;
+    this.hideCurrent();
+    const abort = this.loadAbort.value;
+    const ref = this.deps.textTrackProvider.getOrCreate(
+      track.kind,
+      track.label,
+      (_a = track.language) != null ? _a : void 0
+    );
+    const renderer = this.deps.textTrackRenderer;
+    ref.track.mode = renderer ? "hidden" : "showing";
+    ref.clear();
+    this._ref = ref;
+    renderer == null ? void 0 : renderer.setTextTrack(ref.track);
     const CueCtor = getVttCueConstructor();
     const seen = /* @__PURE__ */ new Set();
+    const styles = /* @__PURE__ */ new Set();
+    const setStyles = (_b = renderer == null ? void 0 : renderer.setStyles) == null ? void 0 : _b.bind(renderer);
     loadWebVttCues(track.uri, {
       abort,
       requestInit: this.deps.requestInit,
       variables: track.variables,
-      getCurrentTime: () => media.currentTime,
+      getCurrentTime: () => this.deps.playbackController.currentTime,
       onCues: (cues) => {
         if (abort.aborted()) return;
-        if (CueCtor) this.appendCues(dom, CueCtor, cues, seen);
-      }
+        if (CueCtor) this.appendCues(ref.track, CueCtor, cues, seen);
+      },
+      onStyles: setStyles ? (blocks) => {
+        if (abort.aborted()) return;
+        for (const block of blocks) styles.add(block);
+        setStyles([...styles]);
+      } : void 0
     }).catch((error) => {
       if (abort.aborted()) return;
       this.dispatch("textTrackError", {
@@ -6991,43 +7280,45 @@ var SidecarTextTrackController = class extends import_vinyl_util75.EventHostImpl
       });
     });
   }
-  ensureDomTrack(media, track) {
-    var _a;
-    const dom = media.addTextTrack(
-      track.kind,
-      track.label,
-      (_a = track.language) != null ? _a : void 0
-    );
-    dom.mode = "showing";
-    this._domTrack = dom;
-    return dom;
-  }
   appendCues(dom, CueCtor, cues, seen) {
-    var _a;
     for (const cue of cues) {
       const key = `${cue.startTime}|${cue.endTime}|${cue.text}`;
       if (seen.has(key)) continue;
       seen.add(key);
       const domCue = new CueCtor(cue.startTime, cue.endTime, cue.text);
       if (cue.id != null) domCue.id = cue.id;
-      const cueStyle = (_a = this.deps.cueStyle) == null ? void 0 : _a.value;
-      if (cueStyle && isVttCue(domCue)) {
-        applyVttCueStyle(domCue, cueStyle);
+      if (cue.settings && isVttCue(domCue)) {
+        applyVttCueStyle(domCue, cue.settings);
       }
       dom.addCue(domCue);
     }
   }
-  clearDomTrack() {
-    const dom = this._domTrack;
-    if (!dom) return;
-    dom.mode = "disabled";
-    if (dom.cues) {
-      const all = Array.from(
-        dom.cues
-      );
-      for (const cue of all) dom.removeCue(cue);
-    }
-    this._domTrack = null;
+  /**
+   * Clears cues from the current DOM track and hides it, keeping the track for
+   * later reuse via the provider.
+   */
+  hideCurrent() {
+    var _a;
+    this.loadAbort.abort();
+    const ref = this._ref;
+    if (!ref) return;
+    (_a = this.deps.textTrackRenderer) == null ? void 0 : _a.setTextTrack(null);
+    ref.clear();
+    ref.track.mode = "disabled";
+    this._ref = null;
+  }
+  /**
+   * Cancels any in-flight load, hides the DOM text track, and resets state.
+   * Called by the host when the underlying media is unloaded.
+   */
+  dispose() {
+    if (this.disposed) return;
+    super.dispose();
+    this.loadAbort.abort();
+    this.hideCurrent();
+    this.disposer.dispose();
+    this._tracks = [];
+    this._activeTextTrack = null;
   }
 };
 function getVttCueConstructor() {
@@ -7037,6 +7328,24 @@ function getVttCueConstructor() {
 }
 
 // src/text/TextTrack.ts
+var import_vinyl_validation12 = require("@amazon/vinyl-validation");
+var TEXT_TRACK_KINDS = [
+  "subtitles",
+  "captions",
+  "descriptions",
+  "chapters",
+  "metadata"
+];
+var textTrackSelectionValidator = /* @__PURE__ */ (0, import_vinyl_validation12.object)({
+  id: /* @__PURE__ */ (0, import_vinyl_validation12.string)().orNull().optional(),
+  kind: /* @__PURE__ */ (0, import_vinyl_validation12.isOneOf)(...TEXT_TRACK_KINDS).orNull().optional(),
+  language: /* @__PURE__ */ (0, import_vinyl_validation12.string)().or(/* @__PURE__ */ (0, import_vinyl_validation12.array)(/* @__PURE__ */ (0, import_vinyl_validation12.string)()).readonly()).orNull().optional(),
+  forced: /* @__PURE__ */ (0, import_vinyl_validation12.boolean)().orNull().optional()
+});
+var textTrackControllerOptionsValidator = /* @__PURE__ */ (0, import_vinyl_validation12.object)({
+  enabled: /* @__PURE__ */ (0, import_vinyl_validation12.isOneOf)("on", "off", "forced").orNull().optional(),
+  selection: /* @__PURE__ */ textTrackSelectionValidator.orNull().optional()
+});
 var ALL_TEXT_TRACK_EVENTS = [
   "textTracksChange",
   "activeTextTrackChange",
@@ -7194,21 +7503,21 @@ function createSegmentDataProvider(deps, options) {
 
 // src/track/TrackFactory.ts
 var import_vinyl_util78 = require("@amazon/vinyl-util");
-var import_vinyl_validation11 = require("@amazon/vinyl-validation");
-var trackConfigOptionsValidator = /* @__PURE__ */ (0, import_vinyl_validation11.object)({
-  extra: /* @__PURE__ */ (0, import_vinyl_validation11.any)().optional(),
-  startTime: /* @__PURE__ */ (0, import_vinyl_validation11.number)().maybe().optional(),
+var import_vinyl_validation13 = require("@amazon/vinyl-validation");
+var trackConfigOptionsValidator = /* @__PURE__ */ (0, import_vinyl_validation13.object)({
+  extra: /* @__PURE__ */ (0, import_vinyl_validation13.any)().optional(),
+  startTime: /* @__PURE__ */ (0, import_vinyl_validation13.number)().maybe().optional(),
   drm: /* @__PURE__ */ drmOptionsValidator.partial().optional()
 });
-var trackLoadOptionsValidator = /* @__PURE__ */ (0, import_vinyl_validation11.object)(
+var trackLoadOptionsValidator = /* @__PURE__ */ (0, import_vinyl_validation13.object)(
   {
-    type: /* @__PURE__ */ (0, import_vinyl_validation11.string)(),
-    uri: /* @__PURE__ */ (0, import_vinyl_validation11.string)().notEmpty(),
+    type: /* @__PURE__ */ (0, import_vinyl_validation13.string)(),
+    uri: /* @__PURE__ */ (0, import_vinyl_validation13.string)().notEmpty(),
     config: /* @__PURE__ */ trackConfigOptionsValidator.maybe().optional()
   }
 );
 function createTrackFactory(factories) {
-  const typeValidator = (0, import_vinyl_validation11.isOneOf)(...(0, import_vinyl_util78.ownKeys)(factories));
+  const typeValidator = (0, import_vinyl_validation13.isOneOf)(...(0, import_vinyl_util78.ownKeys)(factories));
   return {
     validate(options) {
       typeValidator.assert(options.type, import_vinyl_util78.ErrorOrigin.API);
@@ -7222,7 +7531,7 @@ function createTrackFactory(factories) {
 
 // src/track/source/SourceObjectTrack.ts
 var import_vinyl_util82 = require("@amazon/vinyl-util");
-var import_vinyl_validation12 = require("@amazon/vinyl-validation");
+var import_vinyl_validation14 = require("@amazon/vinyl-validation");
 
 // src/track/TrackBase.ts
 var import_vinyl_util79 = require("@amazon/vinyl-util");
@@ -7564,8 +7873,8 @@ var SourceTrackBase = class extends TrackBase {
 
 // src/track/source/SourceObjectTrack.ts
 var loadOptionsValidator = /* @__PURE__ */ trackLoadOptionsValidator.extend({
-  srcObjectProvider: /* @__PURE__ */ (0, import_vinyl_validation12.func)(),
-  type: /* @__PURE__ */ (0, import_vinyl_validation12.isOneOf)("srcObject"),
+  srcObjectProvider: /* @__PURE__ */ (0, import_vinyl_validation14.func)(),
+  type: /* @__PURE__ */ (0, import_vinyl_validation14.isOneOf)("srcObject"),
   config: /* @__PURE__ */ sourceTrackBaseOptionsValidator.maybe().optional()
 });
 function createSourceObjectTrackFactory(deps) {
@@ -7602,11 +7911,11 @@ var SourceObjectTrack = class extends SourceTrackBase {
 
 // src/track/source/SourceTrack.ts
 var import_vinyl_util83 = require("@amazon/vinyl-util");
-var import_vinyl_validation13 = require("@amazon/vinyl-validation");
+var import_vinyl_validation15 = require("@amazon/vinyl-validation");
 var loadOptionsValidator2 = /* @__PURE__ */ trackLoadOptionsValidator.extend({
   config: /* @__PURE__ */ sourceTrackBaseOptionsValidator.maybe().optional(),
-  srcProvider: /* @__PURE__ */ (0, import_vinyl_validation13.func)().maybe().optional(),
-  type: /* @__PURE__ */ (0, import_vinyl_validation13.isOneOf)("src")
+  srcProvider: /* @__PURE__ */ (0, import_vinyl_validation15.func)().maybe().optional(),
+  type: /* @__PURE__ */ (0, import_vinyl_validation15.isOneOf)("src")
 });
 function createSourceTrackFactory(deps) {
   return {
@@ -7642,7 +7951,7 @@ var SourceTrack = class extends SourceTrackBase {
 
 // src/track/dash/DashTrack.ts
 var import_vinyl_util85 = require("@amazon/vinyl-util");
-var import_vinyl_validation14 = require("@amazon/vinyl-validation");
+var import_vinyl_validation16 = require("@amazon/vinyl-validation");
 
 // src/track/mse/MseTrack.ts
 var import_vinyl_util84 = require("@amazon/vinyl-util");
@@ -7713,7 +8022,7 @@ var MseTrack = class extends TrackBase {
       )
     );
     add(
-      deps.preferredAudioLanguage.onData((_value, previous) => {
+      deps.audio.onData((_value, previous) => {
         if (previous !== void 0) this.reloadStreams();
       })
     );
@@ -7722,11 +8031,6 @@ var MseTrack = class extends TrackBase {
         if (previous !== void 0) this.reloadStreams();
       })
     );
-    add(
-      deps.preferDescriptiveAudio.onData((_value, previous) => {
-        if (previous !== void 0) this.reloadStreams();
-      })
-    );
     add(
       deps.abr.onData((value, previous) => {
         if (previous === void 0) return;
@@ -7933,7 +8237,7 @@ var MseTrack = class extends TrackBase {
   onActivated(loadOptions) {
     var _a;
     if (this.disposed) return;
-    (_a = this.deps.textTrackController) == null ? void 0 : _a.resume();
+    (_a = this.deps.textTrackController) == null ? void 0 : _a.activate();
     this.deps.playbackSource.disableRemotePlayback = true;
     this.streams.forEach((stream) => {
       this.deps.drmController.initializeForPlayback(
@@ -7966,7 +8270,7 @@ var MseTrack = class extends TrackBase {
       trackUri: this.uri,
       abort: this.disposeAbort
     });
-    (_b = this.deps.textTrackController) == null ? void 0 : _b.suspend();
+    (_b = this.deps.textTrackController) == null ? void 0 : _b.deactivate();
     this.deps.playbackSource.src = null;
     this.deps.playbackSource.load();
     this.deps.mediaSourceController.deactivate();
@@ -8063,10 +8367,10 @@ var MseTrack = class extends TrackBase {
 
 // src/track/dash/DashTrack.ts
 var loadOptionsValidator3 = /* @__PURE__ */ trackLoadOptionsValidator.extend({
-  manifestProvider: /* @__PURE__ */ (0, import_vinyl_validation14.func)().maybe().optional(),
-  requestInit: /* @__PURE__ */ (0, import_vinyl_validation14.object)({}).cast().maybe().optional(),
-  segmentRequestInit: /* @__PURE__ */ (0, import_vinyl_validation14.object)({}).cast().maybe().optional(),
-  type: /* @__PURE__ */ (0, import_vinyl_validation14.isOneOf)("dash")
+  manifestProvider: /* @__PURE__ */ (0, import_vinyl_validation16.func)().maybe().optional(),
+  requestInit: /* @__PURE__ */ (0, import_vinyl_validation16.object)({}).cast().maybe().optional(),
+  segmentRequestInit: /* @__PURE__ */ (0, import_vinyl_validation16.object)({}).cast().maybe().optional(),
+  type: /* @__PURE__ */ (0, import_vinyl_validation16.isOneOf)("dash")
 });
 function createDashTrackFactory(deps) {
   return {
@@ -8085,12 +8389,12 @@ function createDashTrackFactory(deps) {
 
 // src/track/hls/HlsTrack.ts
 var import_vinyl_util86 = require("@amazon/vinyl-util");
-var import_vinyl_validation15 = require("@amazon/vinyl-validation");
+var import_vinyl_validation17 = require("@amazon/vinyl-validation");
 var loadOptionsValidator4 = /* @__PURE__ */ trackLoadOptionsValidator.extend({
-  manifestProvider: /* @__PURE__ */ (0, import_vinyl_validation15.func)().maybe().optional(),
-  requestInit: /* @__PURE__ */ (0, import_vinyl_validation15.object)({}).cast().maybe().optional(),
-  segmentRequestInit: /* @__PURE__ */ (0, import_vinyl_validation15.object)({}).cast().maybe().optional(),
-  type: /* @__PURE__ */ (0, import_vinyl_validation15.isOneOf)("hls")
+  manifestProvider: /* @__PURE__ */ (0, import_vinyl_validation17.func)().maybe().optional(),
+  requestInit: /* @__PURE__ */ (0, import_vinyl_validation17.object)({}).cast().maybe().optional(),
+  segmentRequestInit: /* @__PURE__ */ (0, import_vinyl_validation17.object)({}).cast().maybe().optional(),
+  type: /* @__PURE__ */ (0, import_vinyl_validation17.isOneOf)("hls")
 });
 function createHlsTrackFactory(deps) {
   return {
@@ -9043,9 +9347,8 @@ function createDashFactories(options) {
       qualitySelector: (deps2) => new QualitySelectorImpl({
         options: deps2.options.pick("abr")
       }),
-      preferredAudioLanguage: (deps2) => deps2.options.pick("preferredAudioLanguage"),
+      audio: (deps2) => deps2.options.pick("audio"),
       allowedContentTypes: (deps2) => deps2.options.pick("allowedContentTypes"),
-      preferDescriptiveAudio: (deps2) => deps2.options.pick("preferDescriptiveAudio"),
       abr: (deps2) => deps2.options.pick("abr"),
       manifestTransformed: createDefaultDashManifestTransformer,
       mediaTimeline: (deps2) => deps2.manifestTransformed.map(async (manifestPromise) => {
@@ -9055,26 +9358,21 @@ function createDashFactories(options) {
       mediaTimelineTransformed: createDefaultMediaTimelineTransformer,
       textTrackController: (deps2) => {
         var _a;
-        const controller = new SidecarTextTrackController({
-          media: deps2.media,
+        return new SidecarTextTrackController({
+          textTrackProvider: deps2.textTrackProvider,
+          textTrackRenderer: deps2.textTrackRenderer,
+          playbackController: deps2.playbackController,
           requestInit: (_a = loadOptions.requestInit) != null ? _a : void 0,
-          preferredTextLanguage: deps2.options.pick(
-            "preferredTextLanguage"
-          ),
-          cueStyle: deps2.options.pick("textCueStyle")
-        });
-        deps2.manifestTransformed.onData((manifestPromise) => {
-          manifestPromise.then((data3) => {
-            controller.setTextTracks(
-              discoverDashTextTracks(
+          options: deps2.options.pick("text"),
+          textTracks: deps2.manifestTransformed.map(
+            (manifestPromise) => manifestPromise.then(
+              (data3) => discoverDashTextTracks(
                 data3.manifest,
                 data3.baseUrl
               )
-            );
-          }).catch(() => {
-          });
+            )
+          )
         });
-        return controller;
       }
     }));
   };
@@ -9456,9 +9754,8 @@ function createHlsFactories(options) {
         qualitySelector: (deps2) => new QualitySelectorImpl({
           options: deps2.options.pick("abr")
         }),
-        preferredAudioLanguage: (deps2) => deps2.options.pick("preferredAudioLanguage"),
+        audio: (deps2) => deps2.options.pick("audio"),
         allowedContentTypes: (deps2) => deps2.options.pick("allowedContentTypes"),
-        preferDescriptiveAudio: (deps2) => deps2.options.pick("preferDescriptiveAudio"),
         abr: (deps2) => deps2.options.pick("abr"),
         mediaTimeline: (deps2) => deps2.manifestTransformed.map(async (manifestPromise) => {
           const data3 = await manifestPromise;
@@ -9467,26 +9764,21 @@ function createHlsFactories(options) {
         mediaTimelineTransformed: createDefaultMediaTimelineTransformer,
         textTrackController: (deps2) => {
           var _a;
-          const controller = new SidecarTextTrackController({
-            media: deps2.media,
+          return new SidecarTextTrackController({
+            textTrackProvider: deps2.textTrackProvider,
+            textTrackRenderer: deps2.textTrackRenderer,
+            playbackController: deps2.playbackController,
             requestInit: (_a = loadOptions.requestInit) != null ? _a : void 0,
-            preferredTextLanguage: deps2.options.pick(
-              "preferredTextLanguage"
-            ),
-            cueStyle: deps2.options.pick("textCueStyle")
-          });
-          deps2.manifestTransformed.onData((manifestPromise) => {
-            manifestPromise.then((data3) => {
-              controller.setTextTracks(
-                discoverHlsTextTracks(
+            options: deps2.options.pick("text"),
+            textTracks: deps2.manifestTransformed.map(
+              (manifestPromise) => manifestPromise.then(
+                (data3) => discoverHlsTextTracks(
                   data3.mainPlaylist,
                   data3.baseUrl
                 )
-              );
-            }).catch(() => {
-            });
+              )
+            )
           });
-          return controller;
         }
       }));
     };
@@ -9637,36 +9929,36 @@ var TrackControllerImpl = class extends import_vinyl_util101.EventHostImpl {
           (0, import_vinyl_util101.logDebug)(this, "more adbreaks");
           return;
         }
-        if (adParent.active) {
-          (0, import_vinyl_util101.logDebug)(this, "no ads began");
-          return;
-        }
         const adParentLoad = this._current;
         const placement = event.adBreak.placement;
         const isPreroll = placement === "preroll";
         const isPostroll = placement === "postroll";
+        const noAdBegan = adParent.active;
+        const resumeContent = (startTime) => this.setCurrentTrack(adParent, {
+          config: __spreadProps(__spreadValues({}, adParentLoad.config), { startTime }),
+          isAd: false,
+          checkPreroll: false
+        });
         if (isPostroll) {
           (0, import_vinyl_util101.logDebug)(this, "trackEnded after postroll");
           this.dispatch("trackEnded", { track: adParentLoad });
-        }
-        if (isPostroll && this.hasNext()) {
-          this.next();
-        } else {
-          const startTime = isPreroll ? (_a = adParentLoad.config) == null ? void 0 : _a.startTime : event.resumePosition;
-          this.setCurrentTrack(adParent, {
-            config: __spreadProps(__spreadValues({}, adParentLoad.config), {
-              startTime
-            }),
-            isAd: false,
-            checkPreroll: false
-          });
-          if (isPostroll) {
-            (0, import_vinyl_util101.logInfo)(this, "queueEnded after postroll ad(s)");
-            this.dispatch("queueEnded", {});
-          } else {
-            playbackController.play().catch(import_vinyl_util101.noop);
+          if (this.hasNext()) {
+            this.next();
+            return;
           }
+          if (!noAdBegan) resumeContent(event.resumePosition);
+          (0, import_vinyl_util101.logInfo)(this, "queueEnded after postroll");
+          this.dispatch("queueEnded", {});
+          return;
         }
+        if (noAdBegan) {
+          (0, import_vinyl_util101.logDebug)(this, "no ads began");
+          return;
+        }
+        resumeContent(
+          isPreroll ? (_a = adParentLoad.config) == null ? void 0 : _a.startTime : event.resumePosition
+        );
+        playbackController.play().catch(import_vinyl_util101.noop);
       })
     );
   }
@@ -10061,28 +10353,28 @@ var defaultPatchOptions = /* @__PURE__ */ (0, import_vinyl_util102.lazy)(() => {
 var import_vinyl_di7 = require("@amazon/vinyl-di");
 
 // src/vinyl/VinylOptions.ts
-var import_vinyl_validation16 = require("@amazon/vinyl-validation");
+var import_vinyl_validation18 = require("@amazon/vinyl-validation");
 var defaultVinylOptions = {
   abr: defaultQualitySelectorImplOptions,
   loudnessNormalization: defaultLoudnessNormalizationControllerImplOptions,
-  preferredAudioLanguage: null,
-  preferredTextLanguage: null,
-  preferDescriptiveAudio: false,
+  audio: defaultAudioOptions,
   codecOverrides: {},
   allowedContentTypes: null,
-  textCueStyle: { size: 90 }
+  text: {
+    // Forced-only captions in the platform's preferred languages (no
+    // explicit language → navigator.languages).
+    enabled: "forced"
+  }
 };
-var vinylOptionsValidator = /* @__PURE__ */ (0, import_vinyl_validation16.object)({
+var vinylOptionsValidator = /* @__PURE__ */ (0, import_vinyl_validation18.object)({
   abr: qualitySelectorImplOptionsValidator,
   loudnessNormalization: loudnessNormalizationControllerImplOptionsValidator,
-  preferredAudioLanguage: /* @__PURE__ */ (0, import_vinyl_validation16.string)().or(/* @__PURE__ */ (0, import_vinyl_validation16.array)(/* @__PURE__ */ (0, import_vinyl_validation16.string)()).readonly()).orNull(),
-  preferredTextLanguage: /* @__PURE__ */ (0, import_vinyl_validation16.string)().or(/* @__PURE__ */ (0, import_vinyl_validation16.array)(/* @__PURE__ */ (0, import_vinyl_validation16.string)()).readonly()).orNull(),
-  preferDescriptiveAudio: /* @__PURE__ */ (0, import_vinyl_validation16.boolean)(),
-  codecOverrides: /* @__PURE__ */ (0, import_vinyl_validation16.record)(/* @__PURE__ */ (0, import_vinyl_validation16.string)(), /* @__PURE__ */ (0, import_vinyl_validation16.isOneOf)("allow", "deny")),
-  allowedContentTypes: /* @__PURE__ */ (0, import_vinyl_validation16.array)(/* @__PURE__ */ (0, import_vinyl_validation16.isOneOf)(...RESTRICTABLE_CONTENT_TYPES)).cast().describe(
+  audio: audioOptionsValidator,
+  codecOverrides: /* @__PURE__ */ (0, import_vinyl_validation18.record)(/* @__PURE__ */ (0, import_vinyl_validation18.string)(), /* @__PURE__ */ (0, import_vinyl_validation18.isOneOf)("allow", "deny")),
+  allowedContentTypes: /* @__PURE__ */ (0, import_vinyl_validation18.array)(/* @__PURE__ */ (0, import_vinyl_validation18.isOneOf)(...RESTRICTABLE_CONTENT_TYPES)).readonly().describe(
     "Allow list of media content types (audio, video) to stream; other media streams are ignored. Text tracks are unaffected."
   ).orNull(),
-  textCueStyle: /* @__PURE__ */ vttCueStyleValidator.orNull()
+  text: textTrackControllerOptionsValidator
 });
 
 // src/vinyl/playerConfigFactory.ts
@@ -10115,6 +10407,14 @@ function createVinylFactories(options) {
       return patchMediaElement(options.media, patches.media);
     },
     media: (deps) => deps.patchedMedia.patched,
+    // One provider per media element (the player container creates each
+    // dependency once), so text tracks are reused rather than accumulated.
+    textTrackProvider: (deps) => createMediaTextTrackProvider({ media: deps.media }),
+    // App-provided cue renderer (or null for native rendering).
+    textTrackRenderer: () => {
+      var _a2;
+      return (_a2 = options.textTrackRenderer) != null ? _a2 : null;
+    },
     playbackController: (deps) => new PlaybackControllerImpl(deps, options.playbackController),
     playbackSource: (deps) => new PlaybackSourceImpl(deps),
     loudnessNormalizationController: (deps) => new LoudnessNormalizationControllerImpl({
@@ -10239,10 +10539,6 @@ var VinylPlayer = class extends import_vinyl_util104.EventHostImpl {
       const previous = activeTrack;
       if (previous === current) return;
       activeTrack = current;
-      const prevTextController = previous == null ? void 0 : previous.textTrackController;
-      if (!this.deps.adController.currentAdBreak) {
-        prevTextController == null ? void 0 : prevTextController.setActiveTextTrack(null);
-      }
       sub == null ? void 0 : sub();
       sub = null;
       textSub == null ? void 0 : textSub();
@@ -10659,16 +10955,6 @@ var VinylPlayer = class extends import_vinyl_util104.EventHostImpl {
     var _a, _b, _c;
     return (_c = (_b = (_a = this.activeTrack) == null ? void 0 : _a.textTrackController) == null ? void 0 : _b.activeTextTrack) != null ? _c : null;
   }
-  /**
-   * Selects the text track with the given id, or clears the active text
-   * track when called with null. No-op when the current track does not
-   * surface text tracks or the id is unknown.
-   */
-  setActiveTextTrack(id) {
-    var _a;
-    const controller = (_a = this.deps.trackController.activeTrack) == null ? void 0 : _a.textTrackController;
-    controller == null ? void 0 : controller.setActiveTextTrack(id);
-  }
   emitTextTrackChangeEventsFor(previous, current) {
     var _a, _b, _c, _d, _e, _f;
     const prevList = (_a = previous == null ? void 0 : previous.textTrackController) == null ? void 0 : _a.textTracks;