@amazon/vinyl 2.0.0 → 3.0.0

package/dist/index.js

@@ -2565,7 +2565,7 @@ function configureVinylGlobal(options) {
 import { parseVersion } from "@amazon/vinyl-util";
 var vinylVersion = /* @__PURE__ */ parseVersion(
   /* istanbul ignore next */
-  "2.0.0"
+  "3.0.0"
 );
 
 // src/global/globalRef.ts
@@ -3936,6 +3936,19 @@ var QualitySelectorImpl = class {
   }
 };
 
+// src/streaming/AudioOptions.ts
+import { array, boolean as boolean3, object as object7, string as string4 } from "@amazon/vinyl-validation";
+var defaultAudioOptions = {
+  selection: { language: null, descriptive: false }
+};
+var audioSelectionValidator = /* @__PURE__ */ object7({
+  language: /* @__PURE__ */ string4().or(/* @__PURE__ */ array(/* @__PURE__ */ string4()).readonly()).orNull().optional(),
+  descriptive: /* @__PURE__ */ boolean3().optional()
+});
+var audioOptionsValidator = /* @__PURE__ */ object7({
+  selection: /* @__PURE__ */ audioSelectionValidator.optional()
+});
+
 // src/streaming/buffering/BufferingController.ts
 import {
   createAbortSlot,
@@ -5298,22 +5311,22 @@ function createLanguageFilter(preferredLanguage, contentType2) {
     return best;
   };
   const bestScoreForPeriod = memoize5(
-    (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;
   };
@@ -5377,22 +5390,22 @@ function isAudioDescription(quality) {
 }
 function createAudioDescriptionFilter(preferDescription) {
   const periodFlags = memoize7(
-    (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);
@@ -5438,7 +5451,7 @@ import {
 function throwSamplingRatesUnsupported() {
   throw new MediaUnsupportedError6("No supported sample rate", "sampling-rate");
 }
-function supportsAudioSamplingRate(deps, metadata, _index, array4) {
+function supportsAudioSamplingRate(deps, metadata, _index, array6) {
   const isFirefox = hasBrowser4(Browser4.FIREFOX);
   const maxSampleRate = deps.capabilities.sampleRate;
   const samplingRate = last(metadata.audioSamplingRate);
@@ -5447,13 +5460,13 @@ function supportsAudioSamplingRate(deps, metadata, _index, array4) {
     return samplingRate <= 48e3;
   }
   if (samplingRate <= maxSampleRate) return true;
-  const allAboveMax = every(array4, (item) => {
+  const allAboveMax = every(array6, (item) => {
     const itemSamplingRate = last(item.audioSamplingRate);
     return itemSamplingRate != null && itemSamplingRate > maxSampleRate;
   });
   if (allAboveMax) {
     const samplingRates = map2(
-      array4,
+      array6,
       (item) => last(item.audioSamplingRate)
     ).filter((rate) => rate != null);
     const lowestSamplingRate = min(samplingRates);
@@ -5495,7 +5508,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),
@@ -5508,22 +5521,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
     );
@@ -5531,8 +5540,7 @@ function createDefaultMediaTimelineTransformer(deps) {
   }
   return combineData2({
     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);
@@ -5541,10 +5549,10 @@ function createDefaultMediaTimelineTransformer(deps) {
 
 // src/streaming/DescriptorRecord.ts
 import {
-  array,
-  object as object7,
+  array as array2,
+  object as object8,
   record as record2,
-  string as string4
+  string as string5
 } from "@amazon/vinyl-validation";
 import { first } from "@amazon/vinyl-util";
 function getDescriptorValue(record4, uri, id) {
@@ -5554,11 +5562,11 @@ function getDescriptorValue(record4, uri, id) {
   if (id !== void 0) arr = arr.filter((descriptor) => descriptor.id === id);
   return (_b = (_a = first(arr)) == null ? void 0 : _a.value) != null ? _b : null;
 }
-var descriptorValidator = /* @__PURE__ */ object7({
-  id: /* @__PURE__ */ string4().maybe().optional(),
-  value: /* @__PURE__ */ string4().maybe().optional()
+var descriptorValidator = /* @__PURE__ */ object8({
+  id: /* @__PURE__ */ string5().maybe().optional(),
+  value: /* @__PURE__ */ string5().maybe().optional()
 });
-var descriptorRecordValidator = /* @__PURE__ */ record2(/* @__PURE__ */ string4(), /* @__PURE__ */ array(descriptorValidator).readonly().orUndefined());
+var descriptorRecordValidator = /* @__PURE__ */ record2(/* @__PURE__ */ string5(), /* @__PURE__ */ array2(descriptorValidator).readonly().orUndefined());
 
 // src/streaming/ManifestControllerImpl.ts
 import { data } from "@amazon/vinyl-observable";
@@ -5671,12 +5679,12 @@ import {
   createShortUid
 } from "@amazon/vinyl-util";
 import {
-  array as array2,
+  array as array3,
   enumOf as enumOf3,
   isOneOf as isOneOf3,
   number as number5,
-  object as object8,
-  string as string5,
+  object as object9,
+  string as string6,
   tuple
 } from "@amazon/vinyl-validation";
 var ALL_CONTENT_TYPES = [
@@ -5690,15 +5698,15 @@ var RESTRICTABLE_CONTENT_TYPES = [
 ];
 var drmProtectionValidator = /* @__PURE__ */ descriptorValidator.extend({
   keySystem: /* @__PURE__ */ enumOf3(DrmKeySystem),
-  pro: /* @__PURE__ */ string5().maybe().optional(),
-  pssh: /* @__PURE__ */ string5().maybe().optional()
+  pro: /* @__PURE__ */ string6().maybe().optional(),
+  pssh: /* @__PURE__ */ string6().maybe().optional()
 });
-var mediaFormatMetadataValidator = /* @__PURE__ */ object8({
-  contentProtections: /* @__PURE__ */ array2(drmProtectionValidator).readonly(),
+var mediaFormatMetadataValidator = /* @__PURE__ */ object9({
+  contentProtections: /* @__PURE__ */ array3(drmProtectionValidator).readonly(),
   contentType: /* @__PURE__ */ isOneOf3("audio", "video", "text").orNull(),
-  initDataType: /* @__PURE__ */ string5().orNull(),
-  encryptionScheme: /* @__PURE__ */ string5().orNull(),
-  mimeType: /* @__PURE__ */ string5().orNull()
+  initDataType: /* @__PURE__ */ string6().orNull(),
+  encryptionScheme: /* @__PURE__ */ string6().orNull(),
+  mimeType: /* @__PURE__ */ string6().orNull()
 });
 function createEmptyMediaFormatMetadata() {
   return {
@@ -5728,20 +5736,20 @@ function createEmptyMediaQualityMetadata() {
   });
 }
 var mediaQualityMetadataValidator = /* @__PURE__ */ mediaFormatMetadataValidator.extend({
-  audioSamplingRate: /* @__PURE__ */ array2(/* @__PURE__ */ number5()).readonly().orNull(),
+  audioSamplingRate: /* @__PURE__ */ array3(/* @__PURE__ */ number5()).readonly().orNull(),
   bandwidth: /* @__PURE__ */ number5().orNull(),
   bandwidthTotal: /* @__PURE__ */ number5().orNull(),
-  codecs: /* @__PURE__ */ string5().orNull(),
-  decoderId: /* @__PURE__ */ string5(),
+  codecs: /* @__PURE__ */ string6().orNull(),
+  decoderId: /* @__PURE__ */ string6(),
   frameRate: /* @__PURE__ */ tuple(/* @__PURE__ */ number5(), /* @__PURE__ */ number5()).readonly().orNull(),
   height: /* @__PURE__ */ number5().orNull(),
-  qualityId: /* @__PURE__ */ string5(),
+  qualityId: /* @__PURE__ */ string6(),
   supplementalProperties: descriptorRecordValidator,
   width: /* @__PURE__ */ number5().orNull(),
-  lang: /* @__PURE__ */ string5().orNull(),
-  characteristics: /* @__PURE__ */ array2(/* @__PURE__ */ string5()).readonly(),
-  groupId: /* @__PURE__ */ string5(),
-  switchingGroupIds: /* @__PURE__ */ array2(/* @__PURE__ */ string5()).readonly().orNull()
+  lang: /* @__PURE__ */ string6().orNull(),
+  characteristics: /* @__PURE__ */ array3(/* @__PURE__ */ string6()).readonly(),
+  groupId: /* @__PURE__ */ string6(),
+  switchingGroupIds: /* @__PURE__ */ array3(/* @__PURE__ */ string6()).readonly().orNull()
 });
 
 // src/streaming/MediaTimeline.ts
@@ -6545,10 +6553,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
 import { ErrorOrigin as ErrorOrigin16, ValidationError as ValidationError3 } from "@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 ValidationError3(
@@ -6566,6 +6766,7 @@ function parseWebVtt(input) {
     );
   }
   const cues = [];
+  const styles = [];
   let i = 1;
   while (i < lines.length && lines[i] !== "") i++;
   while (i < lines.length) {
@@ -6573,49 +6774,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;
@@ -6623,18 +6846,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) {
@@ -6668,9 +6953,11 @@ function scoreTextTrack(track, prefs) {
 
 // src/text/SidecarTextTrackController.ts
 import {
-  Abort as Abort3,
+  createAbortSlot as createAbortSlot4,
+  createDisposer as createDisposer14,
   equalDeep,
-  EventHostImpl as EventHostImpl13
+  EventHostImpl as EventHostImpl13,
+  logError as logError4
 } from "@amazon/vinyl-util";
 
 // src/text/SidecarTextTrackLoader.ts
@@ -6681,7 +6968,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;
@@ -6692,6 +6979,7 @@ async function loadWebVttCues(uri, options) {
       abort,
       variables: variables != null ? variables : void 0,
       onCues,
+      onStyles,
       getCurrentTime,
       lookAhead,
       lookBehind
@@ -6708,13 +6996,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];
@@ -6754,8 +7044,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) {
@@ -6778,7 +7069,7 @@ function pickInWindow(pending, ranges, ctx) {
 }
 
 // src/text/VttCueStyle.ts
-import { boolean as boolean3, isOneOf as isOneOf4, number as number6, object as object9 } from "@amazon/vinyl-validation";
+import { boolean as boolean4, isOneOf as isOneOf4, number as number6, object as object10 } from "@amazon/vinyl-validation";
 function isVttCue(cue) {
   return typeof VTTCue !== "undefined" && cue instanceof VTTCue;
 }
@@ -6793,7 +7084,7 @@ 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__ */ object9({
+var vttCueStyleValidator = /* @__PURE__ */ object10({
   align: /* @__PURE__ */ isOneOf4("start", "center", "end", "left", "right").optional(),
   line: /* @__PURE__ */ number6().or(/* @__PURE__ */ isOneOf4("auto")).optional(),
   lineAlign: /* @__PURE__ */ isOneOf4("start", "center", "end").optional(),
@@ -6805,27 +7096,50 @@ var vttCueStyleValidator = /* @__PURE__ */ object9({
     "auto"
   ).optional(),
   size: /* @__PURE__ */ number6().optional(),
-  snapToLines: /* @__PURE__ */ boolean3().optional(),
+  snapToLines: /* @__PURE__ */ boolean4().optional(),
   vertical: /* @__PURE__ */ isOneOf4("", "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 EventHostImpl13 {
   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__ */ createAbortSlot4());
+    __publicField(this, "disposer", /* @__PURE__ */ createDisposer14());
+    const { add } = this.disposer;
+    add(deps.options.onData(() => this.refreshSelection()));
+    add(
+      deps.textTracks.onData((tracksPromise) => {
+        tracksPromise.then((tracks) => this.setTracks(tracks)).catch((error) => {
+          logError4(this, "text tracks promise rejected", error);
+        });
+      })
+    );
   }
   get [Symbol.toStringTag]() {
     return "SidecarTextTrackController";
@@ -6834,120 +7148,89 @@ var SidecarTextTrackController = class extends EventHostImpl13 {
     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 (equalDeep(this._tracks, tracks)) return;
+  setTracks(tracks) {
+    if (this.disposed) return;
     const previous = this._tracks;
+    if (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);
-  }
-  /**
-   * Selects the track best matching the preferred language(s), or clears the
-   * selection when the preference is null or nothing matches.
-   */
-  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);
+    this.refreshSelection();
   }
   /**
-   * The forced track to auto-select, or null. Prefers the default track's
-   * language, else the first forced track.
+   * Recomputes the selection from the current options and track list,
+   * emitting `activeTextTrackChange` on change and (re)rendering when active.
    */
-  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 Abort3();
-    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", {
@@ -6956,43 +7239,45 @@ var SidecarTextTrackController = class extends EventHostImpl13 {
       });
     });
   }
-  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() {
@@ -7002,6 +7287,30 @@ function getVttCueConstructor() {
 }
 
 // src/text/TextTrack.ts
+import {
+  array as array4,
+  boolean as boolean5,
+  isOneOf as isOneOf5,
+  object as object11,
+  string as string7
+} from "@amazon/vinyl-validation";
+var TEXT_TRACK_KINDS = [
+  "subtitles",
+  "captions",
+  "descriptions",
+  "chapters",
+  "metadata"
+];
+var textTrackSelectionValidator = /* @__PURE__ */ object11({
+  id: /* @__PURE__ */ string7().orNull().optional(),
+  kind: /* @__PURE__ */ isOneOf5(...TEXT_TRACK_KINDS).orNull().optional(),
+  language: /* @__PURE__ */ string7().or(/* @__PURE__ */ array4(/* @__PURE__ */ string7()).readonly()).orNull().optional(),
+  forced: /* @__PURE__ */ boolean5().orNull().optional()
+});
+var textTrackControllerOptionsValidator = /* @__PURE__ */ object11({
+  enabled: /* @__PURE__ */ isOneOf5("on", "off", "forced").orNull().optional(),
+  selection: /* @__PURE__ */ textTrackSelectionValidator.orNull().optional()
+});
 var ALL_TEXT_TRACK_EVENTS = [
   "textTracksChange",
   "activeTextTrackChange",
@@ -7010,7 +7319,7 @@ var ALL_TEXT_TRACK_EVENTS = [
 
 // src/track/AutoResetController.ts
 import {
-  createDisposer as createDisposer14,
+  createDisposer as createDisposer15,
   EventHostImpl as EventHostImpl14,
   getNetworkState as getNetworkState2,
   logDebug as logDebug13,
@@ -7030,7 +7339,7 @@ var AutoResetControllerImpl = class extends EventHostImpl14 {
     __publicField(this, "_error", null);
     __publicField(this, "watchSub", null);
     __publicField(this, "currentRetry", 0);
-    __publicField(this, "disposer", /* @__PURE__ */ createDisposer14());
+    __publicField(this, "disposer", /* @__PURE__ */ createDisposer15());
     logDebug13(this, "constructor");
     this.options = __spreadValues(__spreadValues({}, defaultResetControllerOptions), options);
     this.disposer.add(
@@ -7068,7 +7377,7 @@ var AutoResetControllerImpl = class extends EventHostImpl14 {
     this.watchSub = null;
     if (value) {
       const networkState = getNetworkState2();
-      const { add, dispose: watchSub } = createDisposer14();
+      const { add, dispose: watchSub } = createDisposer15();
       this.watchSub = watchSub;
       add(
         networkState.on("online", () => {
@@ -7177,25 +7486,25 @@ import {
 } from "@amazon/vinyl-util";
 import {
   any as any2,
-  isOneOf as isOneOf5,
+  isOneOf as isOneOf6,
   number as number7,
-  object as object10,
-  string as string6
+  object as object12,
+  string as string8
 } from "@amazon/vinyl-validation";
-var trackConfigOptionsValidator = /* @__PURE__ */ object10({
+var trackConfigOptionsValidator = /* @__PURE__ */ object12({
   extra: /* @__PURE__ */ any2().optional(),
   startTime: /* @__PURE__ */ number7().maybe().optional(),
   drm: /* @__PURE__ */ drmOptionsValidator.partial().optional()
 });
-var trackLoadOptionsValidator = /* @__PURE__ */ object10(
+var trackLoadOptionsValidator = /* @__PURE__ */ object12(
   {
-    type: /* @__PURE__ */ string6(),
-    uri: /* @__PURE__ */ string6().notEmpty(),
+    type: /* @__PURE__ */ string8(),
+    uri: /* @__PURE__ */ string8().notEmpty(),
     config: /* @__PURE__ */ trackConfigOptionsValidator.maybe().optional()
   }
 );
 function createTrackFactory(factories) {
-  const typeValidator = isOneOf5(...ownKeys2(factories));
+  const typeValidator = isOneOf6(...ownKeys2(factories));
   return {
     validate(options) {
       typeValidator.assert(options.type, ErrorOrigin17.API);
@@ -7209,12 +7518,12 @@ function createTrackFactory(factories) {
 
 // src/track/source/SourceObjectTrack.ts
 import { ErrorOrigin as ErrorOrigin18 } from "@amazon/vinyl-util";
-import { func as func2, isOneOf as isOneOf6 } from "@amazon/vinyl-validation";
+import { func as func2, isOneOf as isOneOf7 } from "@amazon/vinyl-validation";
 
 // src/track/TrackBase.ts
 import {
-  createAbortSlot as createAbortSlot4,
-  createDisposer as createDisposer15,
+  createAbortSlot as createAbortSlot5,
+  createDisposer as createDisposer16,
   emptyRanges as emptyRanges2,
   equalDeep as equalDeep2,
   EventHostImpl as EventHostImpl15,
@@ -7242,8 +7551,8 @@ var TrackBase = class extends EventHostImpl15 {
         });
       }
     });
-    __publicField(this, "disposer", /* @__PURE__ */ createDisposer15());
-    __publicField(this, "drmSessionAbort", /* @__PURE__ */ createAbortSlot4());
+    __publicField(this, "disposer", /* @__PURE__ */ createDisposer16());
+    __publicField(this, "drmSessionAbort", /* @__PURE__ */ createAbortSlot5());
     /**
      * Sets on handleError, cleared on 'reset'.
      */
@@ -7472,7 +7781,7 @@ var FixedPlaybackQuality = class extends EventHostImpl16 {
 
 // src/track/source/SourceTrackBase.ts
 import {
-  createDisposer as createDisposer16,
+  createDisposer as createDisposer17,
   logDebug as logDebug15,
   redispatchEvents as redispatchEvents2
 } from "@amazon/vinyl-util";
@@ -7531,7 +7840,7 @@ var SourceTrackBase = class extends TrackBase {
     return this.fixedPlaybackQuality.getPlaybackQuality(contentType2);
   }
   onActivated() {
-    const { add, dispose } = createDisposer16();
+    const { add, dispose } = createDisposer17();
     this.activeSub = dispose;
     add(
       this.deps.playbackController.on("durationChange", (event) => {
@@ -7565,7 +7874,7 @@ var SourceTrackBase = class extends TrackBase {
 // src/track/source/SourceObjectTrack.ts
 var loadOptionsValidator = /* @__PURE__ */ trackLoadOptionsValidator.extend({
   srcObjectProvider: /* @__PURE__ */ func2(),
-  type: /* @__PURE__ */ isOneOf6("srcObject"),
+  type: /* @__PURE__ */ isOneOf7("srcObject"),
   config: /* @__PURE__ */ sourceTrackBaseOptionsValidator.maybe().optional()
 });
 function createSourceObjectTrackFactory(deps) {
@@ -7602,11 +7911,11 @@ var SourceObjectTrack = class extends SourceTrackBase {
 
 // src/track/source/SourceTrack.ts
 import { ErrorOrigin as ErrorOrigin19 } from "@amazon/vinyl-util";
-import { func as func3, isOneOf as isOneOf7 } from "@amazon/vinyl-validation";
+import { func as func3, isOneOf as isOneOf8 } from "@amazon/vinyl-validation";
 var loadOptionsValidator2 = /* @__PURE__ */ trackLoadOptionsValidator.extend({
   config: /* @__PURE__ */ sourceTrackBaseOptionsValidator.maybe().optional(),
   srcProvider: /* @__PURE__ */ func3().maybe().optional(),
-  type: /* @__PURE__ */ isOneOf7("src")
+  type: /* @__PURE__ */ isOneOf8("src")
 });
 function createSourceTrackFactory(deps) {
   return {
@@ -7646,13 +7955,13 @@ import {
 } from "@amazon/vinyl-util";
 import {
   func as func4,
-  isOneOf as isOneOf8,
-  object as object11
+  isOneOf as isOneOf9,
+  object as object13
 } from "@amazon/vinyl-validation";
 
 // src/track/mse/MseTrack.ts
 import {
-  Abort as Abort4,
+  Abort as Abort3,
   equalDeep as equalDeep3,
   first as first2,
   IntersectionRanges,
@@ -7670,7 +7979,7 @@ var MseTrack = class extends TrackBase {
     super(uri, type, deps);
     __publicField(this, "streams", []);
     __publicField(this, "stallNudgeTimer", null);
-    __publicField(this, "disposeAbort", /* @__PURE__ */ new Abort4());
+    __publicField(this, "disposeAbort", /* @__PURE__ */ new Abort3());
     __publicField(this, "lastPreloadOptions", null);
     __publicField(this, "allFetchedRanges", []);
     __publicField(this, "_fetchedRanges", /* @__PURE__ */ new IntersectionRanges(
@@ -7727,7 +8036,7 @@ var MseTrack = class extends TrackBase {
       )
     );
     add(
-      deps.preferredAudioLanguage.onData((_value, previous) => {
+      deps.audio.onData((_value, previous) => {
         if (previous !== void 0) this.reloadStreams();
       })
     );
@@ -7736,11 +8045,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;
@@ -7947,7 +8251,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(
@@ -7980,7 +8284,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();
@@ -8078,9 +8382,9 @@ var MseTrack = class extends TrackBase {
 // src/track/dash/DashTrack.ts
 var loadOptionsValidator3 = /* @__PURE__ */ trackLoadOptionsValidator.extend({
   manifestProvider: /* @__PURE__ */ func4().maybe().optional(),
-  requestInit: /* @__PURE__ */ object11({}).cast().maybe().optional(),
-  segmentRequestInit: /* @__PURE__ */ object11({}).cast().maybe().optional(),
-  type: /* @__PURE__ */ isOneOf8("dash")
+  requestInit: /* @__PURE__ */ object13({}).cast().maybe().optional(),
+  segmentRequestInit: /* @__PURE__ */ object13({}).cast().maybe().optional(),
+  type: /* @__PURE__ */ isOneOf9("dash")
 });
 function createDashTrackFactory(deps) {
   return {
@@ -8101,14 +8405,14 @@ function createDashTrackFactory(deps) {
 import { ErrorOrigin as ErrorOrigin21 } from "@amazon/vinyl-util";
 import {
   func as func5,
-  isOneOf as isOneOf9,
-  object as object12
+  isOneOf as isOneOf10,
+  object as object14
 } from "@amazon/vinyl-validation";
 var loadOptionsValidator4 = /* @__PURE__ */ trackLoadOptionsValidator.extend({
   manifestProvider: /* @__PURE__ */ func5().maybe().optional(),
-  requestInit: /* @__PURE__ */ object12({}).cast().maybe().optional(),
-  segmentRequestInit: /* @__PURE__ */ object12({}).cast().maybe().optional(),
-  type: /* @__PURE__ */ isOneOf9("hls")
+  requestInit: /* @__PURE__ */ object14({}).cast().maybe().optional(),
+  segmentRequestInit: /* @__PURE__ */ object14({}).cast().maybe().optional(),
+  type: /* @__PURE__ */ isOneOf10("hls")
 });
 function createHlsTrackFactory(deps) {
   return {
@@ -9089,9 +9393,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) => {
@@ -9101,26 +9404,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;
       }
     }));
   };
@@ -9508,9 +9806,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;
@@ -9519,26 +9816,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;
         }
       }));
     };
@@ -9548,13 +9840,13 @@ function createHlsFactories(options) {
 // src/track/TrackController.ts
 import {
   countElements,
-  createDisposer as createDisposer17,
+  createDisposer as createDisposer18,
   EventHostImpl as EventHostImpl17,
   first as first3,
   getOrSet as getOrSet3,
   IllegalStateError as IllegalStateError4,
   logDebug as logDebug17,
-  logError as logError4,
+  logError as logError5,
   logInfo as logInfo3,
   logVerbose as logVerbose4,
   logWarn as logWarn6,
@@ -9599,7 +9891,7 @@ var TrackControllerImpl = class extends EventHostImpl17 {
     // Ad tracks keyed by parent content URI, kept out of the content cache.
     // Pegged to the parent: disposed when the parent is evicted (see onEvict).
     __publicField(this, "adTracksByParent", /* @__PURE__ */ new Map());
-    __publicField(this, "disposer", /* @__PURE__ */ createDisposer17());
+    __publicField(this, "disposer", /* @__PURE__ */ createDisposer18());
     __publicField(this, "_options", defaultTrackControllerImplOptions);
     /**
      * The current track has ended naturally. On the next tick advance the queue or emit queue ended.
@@ -9630,7 +9922,7 @@ var TrackControllerImpl = class extends EventHostImpl17 {
           });
         }
       }).catch((error) => {
-        logError4(this, "enterPostroll failed", error);
+        logError5(this, "enterPostroll failed", error);
       });
     });
     __publicField(this, "validateLoadOptions", (loadOptions) => this.deps.trackFactory.validate(loadOptions));
@@ -10071,7 +10363,7 @@ var TrackControllerImpl = class extends EventHostImpl17 {
           if (preroll) return;
           activate();
         }).catch((error) => {
-          logError4(this, "enterPreroll failed", error);
+          logError5(this, "enterPreroll failed", error);
           activate();
         });
       }
@@ -10129,34 +10421,33 @@ import { validateFactories as validateFactories5 } from "@amazon/vinyl-di";
 
 // src/vinyl/VinylOptions.ts
 import {
-  array as array3,
-  boolean as boolean4,
-  isOneOf as isOneOf10,
-  object as object13,
+  array as array5,
+  isOneOf as isOneOf11,
+  object as object15,
   record as record3,
-  string as string7
+  string as string9
 } from "@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__ */ object13({
+var vinylOptionsValidator = /* @__PURE__ */ object15({
   abr: qualitySelectorImplOptionsValidator,
   loudnessNormalization: loudnessNormalizationControllerImplOptionsValidator,
-  preferredAudioLanguage: /* @__PURE__ */ string7().or(/* @__PURE__ */ array3(/* @__PURE__ */ string7()).readonly()).orNull(),
-  preferredTextLanguage: /* @__PURE__ */ string7().or(/* @__PURE__ */ array3(/* @__PURE__ */ string7()).readonly()).orNull(),
-  preferDescriptiveAudio: /* @__PURE__ */ boolean4(),
-  codecOverrides: /* @__PURE__ */ record3(/* @__PURE__ */ string7(), /* @__PURE__ */ isOneOf10("allow", "deny")),
-  allowedContentTypes: /* @__PURE__ */ array3(/* @__PURE__ */ isOneOf10(...RESTRICTABLE_CONTENT_TYPES)).cast().describe(
+  audio: audioOptionsValidator,
+  codecOverrides: /* @__PURE__ */ record3(/* @__PURE__ */ string9(), /* @__PURE__ */ isOneOf11("allow", "deny")),
+  allowedContentTypes: /* @__PURE__ */ array5(/* @__PURE__ */ isOneOf11(...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
@@ -10189,6 +10480,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({
@@ -10211,7 +10510,7 @@ function createVinylFactories(options) {
 
 // src/vinyl/VinylPlayer.ts
 import {
-  createDisposer as createDisposer18,
+  createDisposer as createDisposer19,
   emptyRanges as emptyRanges3,
   equalDeep as equalDeep4,
   EventHostImpl as EventHostImpl18,
@@ -10240,7 +10539,7 @@ var VinylPlayer = class extends EventHostImpl18 {
      */
     __publicField(this, "client");
     __publicField(this, "_error", null);
-    __publicField(this, "disposer", /* @__PURE__ */ createDisposer18());
+    __publicField(this, "disposer", /* @__PURE__ */ createDisposer19());
     const add = this.disposer.add;
     this.deps = add(createContainer3(factories)).dependencies;
     this.client = {
@@ -10324,10 +10623,6 @@ var VinylPlayer = class extends EventHostImpl18 {
       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();
@@ -10744,16 +11039,6 @@ var VinylPlayer = class extends EventHostImpl18 {
     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;
@@ -10885,6 +11170,7 @@ export {
   DrmRobustness,
   FAIR_PLAY_KEY_SYSTEMS,
   FixedPlaybackQuality,
+  HtmlTextTrackRenderer,
   InvalidSeekError,
   LICENSE_TIMEOUT,
   LIVE_DURATION,
@@ -10947,6 +11233,7 @@ export {
   applyVttCueStyle,
   assertMseSupported,
   audioContextRef,
+  audioOptionsValidator,
   buildDashMediaTimeline,
   buildHlsMediaTimeline,
   buildSegmentTimeline,
@@ -10961,6 +11248,7 @@ export {
   codecToContentType,
   codecsToContentTypes,
   commonEmeFactory,
+  computeCueLayout,
   configureVinylGlobal,
   contentProtectionToMetadata,
   contentTypeToMimeType,
@@ -10994,6 +11282,7 @@ export {
   createLanguageFilter,
   createMediaQualityMetadataFromDashRepresentation,
   createMediaSource,
+  createMediaTextTrackProvider,
   createPreventStallsPatch,
   createSegmentControllerFactory,
   createSegmentDataProvider,
@@ -11008,6 +11297,7 @@ export {
   createVinylTrackFactories,
   defaultAdControllerImplOptions,
   defaultAdLoadOptionsResolver,
+  defaultAudioOptions,
   defaultDrmKeySystemResolver,
   defaultLicenseProvider,
   defaultLoudnessNormalizationControllerImplOptions,
@@ -11101,11 +11391,13 @@ export {
   playerRegistryRef,
   prefetchPriorityQueuesRef,
   qualitySelectorImplOptionsValidator,
+  renderCueText,
   requiresPreventStallsPatch,
   requiresUnreliablePlaybackEventsPatch,
   resolveCodecOverride,
   resolveDashUri,
   resolvePreferredLanguages,
+  resolveSelectedTrack,
   sampleToMpdTime,
   segmentPriorityComparatorRef,
   segmentTemplateUrl,
@@ -11117,6 +11409,7 @@ export {
   supportsMse,
   supportsStandardEme,
   supportsWebKitEme,
+  textTrackControllerOptionsValidator,
   throwKeySystemsUnsupported,
   throwLanguagesUnsupported,
   throwMimeTypesUnsupported,