@vizor-vr/player 0.2.0

package/dist/captions/caption-renderer.d.ts

@@ -0,0 +1,57 @@
+import type { PlayerState } from '../core/player-state.js';
+import { type VttCue } from './webvtt-parser.js';
+/** A loaded track with its parsed cues */
+export interface CaptionTrack {
+    srclang: string;
+    label: string;
+    cues: VttCue[];
+    isDefault: boolean;
+}
+/**
+ * Caption / subtitle renderer.
+ *
+ * Fetches `<track>` children via their `src` attribute, parses the
+ * WebVTT content, and renders the active cue as a HUD overlay
+ * positioned at the bottom of the player viewport.
+ *
+ * The overlay stays fixed relative to the viewport so that
+ * captions remain visible regardless of camera orientation in
+ * 360° video.
+ */
+export declare class CaptionRenderer {
+    private tracks;
+    private activeTrackIndex;
+    private overlay;
+    private shadow;
+    private unsubscribes;
+    private lastCueId;
+    constructor(shadow: ShadowRoot, state: PlayerState);
+    /**
+     * Load all `<track>` children from the host element.
+     * Each track with a valid `src` is fetched and parsed.
+     */
+    loadTracks(hostElement: HTMLElement): Promise<void>;
+    /** Get all loaded tracks */
+    getTracks(): Readonly<CaptionTrack[]>;
+    /** Get the currently active track index (-1 = off) */
+    getActiveTrackIndex(): number;
+    /** Set the active caption track by index. -1 = off. */
+    setActiveTrack(index: number): void;
+    /** Toggle captions on/off. If off, activates the first available track. */
+    toggle(): void;
+    /** Whether captions are currently active */
+    isActive(): boolean;
+    /** Whether any tracks are loaded */
+    hasTracks(): boolean;
+    dispose(): void;
+    private fetchAndParse;
+    /** Find and render the active cue for the given time */
+    private renderCue;
+    /**
+     * Linear search for the active cue at the given time.
+     * WebVTT cue arrays are typically small (<200 entries),
+     * so linear scan is fine.
+     */
+    private findActiveCue;
+}
+//# sourceMappingURL=caption-renderer.d.ts.map

package/dist/captions/caption-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caption-renderer.d.ts","sourceRoot":"","sources":["../../src/captions/caption-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAe,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAG9D,0CAA0C;AAC1C,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,gBAAgB,CAAM;IAC9B,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,SAAS,CAAuB;gBAE5B,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW;IAiBlD;;;OAGG;IACG,UAAU,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BzD,4BAA4B;IAC5B,SAAS,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;IAIrC,sDAAsD;IACtD,mBAAmB,IAAI,MAAM;IAI7B,uDAAuD;IACvD,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAWnC,2EAA2E;IAC3E,MAAM,IAAI,IAAI;IAad,4CAA4C;IAC5C,QAAQ,IAAI,OAAO;IAInB,oCAAoC;IACpC,SAAS,IAAI,OAAO;IAIpB,OAAO,IAAI,IAAI;YASD,aAAa;IA0B3B,wDAAwD;IACxD,OAAO,CAAC,SAAS;IA4BjB;;;;OAIG;IACH,OAAO,CAAC,aAAa;CAQtB"}

package/dist/captions/index.d.ts

@@ -0,0 +1,3 @@
+export { parseWebVTT, parseTimestamp, type VttCue } from './webvtt-parser.js';
+export { CaptionRenderer, type CaptionTrack } from './caption-renderer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/captions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/captions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/captions/webvtt-parser.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Minimal WebVTT parser.
+ *
+ * Handles:
+ * - UTF-8 BOM
+ * - Timestamp lines `HH:MM:SS.mmm --> HH:MM:SS.mmm`
+ * - Cue IDs (optional identifier line before timestamp)
+ * - NOTE blocks (skipped)
+ * - STYLE blocks (skipped)
+ * - REGION blocks (skipped)
+ * - Preserves <b>, <i>, <u> formatting tags; strips all others
+ */
+export interface VttCue {
+    id: string;
+    startTime: number;
+    endTime: number;
+    text: string;
+}
+/**
+ * Parse a WebVTT timestamp string into seconds.
+ *
+ * Formats:
+ *   HH:MM:SS.mmm
+ *   MM:SS.mmm
+ */
+export declare function parseTimestamp(ts: string): number;
+/**
+ * Parse a WebVTT string into an array of cues.
+ */
+export declare function parseWebVTT(input: string): VttCue[];
+//# sourceMappingURL=webvtt-parser.d.ts.map

package/dist/captions/webvtt-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webvtt-parser.d.ts","sourceRoot":"","sources":["../../src/captions/webvtt-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAUD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAoBjD;AAwBD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAoHnD"}

package/dist/captions-BP0H2E03.js

@@ -0,0 +1,274 @@
+import { p as purify } from "./annotations-C0ugfCn4.js";
+const ALLOWED_TAGS = /* @__PURE__ */ new Set(["b", "i", "u", "br"]);
+function stripBOM(str) {
+  return str.charCodeAt(0) === 65279 ? str.slice(1) : str;
+}
+function parseTimestamp(ts) {
+  const parts = ts.trim().split(":");
+  if (parts.length < 2 || parts.length > 3) return NaN;
+  let hours = 0;
+  let minutes;
+  let seconds;
+  if (parts.length === 3) {
+    hours = parseInt(parts[0], 10);
+    minutes = parseInt(parts[1], 10);
+    seconds = parseFloat(parts[2]);
+  } else {
+    minutes = parseInt(parts[0], 10);
+    seconds = parseFloat(parts[1]);
+  }
+  if (isNaN(hours) || isNaN(minutes) || isNaN(seconds)) return NaN;
+  return hours * 3600 + minutes * 60 + seconds;
+}
+function sanitizeText(raw) {
+  let text = raw.replace(/\n/g, "<br>");
+  text = text.replace(/<\/?([a-zA-Z][a-zA-Z0-9]*)\b[^>]*>/g, (match, tag) => {
+    const lower = tag.toLowerCase();
+    if (ALLOWED_TAGS.has(lower)) {
+      if (match.startsWith("</")) return `</${lower}>`;
+      if (lower === "br") return "<br>";
+      return `<${lower}>`;
+    }
+    return "";
+  });
+  return text.trim();
+}
+function parseWebVTT(input) {
+  const raw = stripBOM(input);
+  const lines = raw.replace(/\r\n/g, "\n").replace(/\r/g, "\n").split("\n");
+  const headerLine = lines[0]?.trim() ?? "";
+  if (!headerLine.startsWith("WEBVTT")) {
+    console.warn("[Vizor] Invalid WebVTT: missing WEBVTT header");
+    return [];
+  }
+  const cues = [];
+  const TIMESTAMP_RE = /^([\d:.]+)\s*-->\s*([\d:.]+)/;
+  let i = 1;
+  let cueIndex = 0;
+  while (i < lines.length) {
+    const line = lines[i];
+    if (line.trim() === "") {
+      i++;
+      continue;
+    }
+    if (line.trim().startsWith("NOTE")) {
+      i++;
+      while (i < lines.length && lines[i].trim() !== "") {
+        i++;
+      }
+      continue;
+    }
+    if (line.trim().startsWith("STYLE")) {
+      i++;
+      while (i < lines.length && lines[i].trim() !== "") {
+        i++;
+      }
+      continue;
+    }
+    if (line.trim().startsWith("REGION")) {
+      i++;
+      while (i < lines.length && lines[i].trim() !== "") {
+        i++;
+      }
+      continue;
+    }
+    let cueId;
+    const timestampMatch = line.match(TIMESTAMP_RE);
+    if (!timestampMatch) {
+      const nextLine = lines[i + 1] ?? "";
+      const nextMatch = nextLine.match(TIMESTAMP_RE);
+      if (nextMatch) {
+        cueId = line.trim();
+        i++;
+        const tsMatch = lines[i].match(TIMESTAMP_RE);
+        const startTime2 = parseTimestamp(tsMatch[1]);
+        const endTime2 = parseTimestamp(tsMatch[2]);
+        i++;
+        const textLines2 = [];
+        while (i < lines.length && lines[i].trim() !== "") {
+          textLines2.push(lines[i]);
+          i++;
+        }
+        if (!isNaN(startTime2) && !isNaN(endTime2) && textLines2.length > 0) {
+          cues.push({
+            id: cueId ?? String(cueIndex),
+            startTime: startTime2,
+            endTime: endTime2,
+            text: sanitizeText(textLines2.join("\n"))
+          });
+          cueIndex++;
+        }
+      } else {
+        i++;
+      }
+      continue;
+    }
+    const startTime = parseTimestamp(timestampMatch[1]);
+    const endTime = parseTimestamp(timestampMatch[2]);
+    i++;
+    const textLines = [];
+    while (i < lines.length && lines[i].trim() !== "") {
+      textLines.push(lines[i]);
+      i++;
+    }
+    if (!isNaN(startTime) && !isNaN(endTime) && textLines.length > 0) {
+      cues.push({
+        id: cueId ?? String(cueIndex),
+        startTime,
+        endTime,
+        text: sanitizeText(textLines.join("\n"))
+      });
+      cueIndex++;
+    }
+  }
+  return cues;
+}
+class CaptionRenderer {
+  tracks = [];
+  activeTrackIndex = -1;
+  overlay;
+  shadow;
+  unsubscribes = [];
+  lastCueId = null;
+  constructor(shadow, state) {
+    this.shadow = shadow;
+    this.overlay = document.createElement("div");
+    this.overlay.className = "vz-caption-overlay";
+    this.overlay.setAttribute("aria-live", "polite");
+    this.overlay.setAttribute("role", "status");
+    shadow.appendChild(this.overlay);
+    const unsub = state.subscribe("currentTime", (time) => {
+      this.renderCue(time);
+    });
+    this.unsubscribes.push(unsub);
+  }
+  /**
+   * Load all `<track>` children from the host element.
+   * Each track with a valid `src` is fetched and parsed.
+   */
+  async loadTracks(hostElement) {
+    const trackElements = hostElement.querySelectorAll("track");
+    if (trackElements.length === 0) return;
+    const promises = [];
+    trackElements.forEach((el) => {
+      const src = el.getAttribute("src");
+      if (!src) return;
+      const srclang = el.getAttribute("srclang") ?? "en";
+      const label = el.getAttribute("label") ?? srclang.toUpperCase();
+      const isDefault = el.hasAttribute("default");
+      promises.push(
+        this.fetchAndParse(src, srclang, label, isDefault)
+      );
+    });
+    await Promise.allSettled(promises);
+    if (this.tracks.length > 0) {
+      const defaultIndex = this.tracks.findIndex((t) => t.isDefault);
+      if (defaultIndex >= 0) {
+        this.activeTrackIndex = defaultIndex;
+      }
+    }
+  }
+  /** Get all loaded tracks */
+  getTracks() {
+    return this.tracks;
+  }
+  /** Get the currently active track index (-1 = off) */
+  getActiveTrackIndex() {
+    return this.activeTrackIndex;
+  }
+  /** Set the active caption track by index. -1 = off. */
+  setActiveTrack(index) {
+    if (index < -1 || index >= this.tracks.length) return;
+    this.activeTrackIndex = index;
+    this.lastCueId = null;
+    if (index === -1) {
+      this.overlay.innerHTML = "";
+      this.overlay.classList.remove("visible");
+    }
+  }
+  /** Toggle captions on/off. If off, activates the first available track. */
+  toggle() {
+    if (this.tracks.length === 0) return;
+    if (this.activeTrackIndex >= 0) {
+      this.setActiveTrack(-1);
+    } else {
+      const defaultIndex = this.tracks.findIndex((t) => t.isDefault);
+      this.setActiveTrack(defaultIndex >= 0 ? defaultIndex : 0);
+    }
+  }
+  /** Whether captions are currently active */
+  isActive() {
+    return this.activeTrackIndex >= 0;
+  }
+  /** Whether any tracks are loaded */
+  hasTracks() {
+    return this.tracks.length > 0;
+  }
+  dispose() {
+    for (const unsub of this.unsubscribes) unsub();
+    this.unsubscribes = [];
+    this.overlay.remove();
+    this.tracks = [];
+  }
+  // --- Private ---
+  async fetchAndParse(src, srclang, label, isDefault) {
+    try {
+      const response = await fetch(src);
+      if (!response.ok) {
+        console.warn(`[Vizor] Failed to fetch track: ${src} (${response.status})`);
+        return;
+      }
+      const text = await response.text();
+      const cues = parseWebVTT(text);
+      if (cues.length === 0) {
+        console.warn(`[Vizor] No cues found in track: ${src}`);
+        return;
+      }
+      this.tracks.push({ srclang, label, cues, isDefault });
+    } catch (err) {
+      console.warn(`[Vizor] Error loading track ${src}:`, err);
+    }
+  }
+  /** Find and render the active cue for the given time */
+  renderCue(currentTime) {
+    if (this.activeTrackIndex < 0 || this.activeTrackIndex >= this.tracks.length) {
+      return;
+    }
+    const track = this.tracks[this.activeTrackIndex];
+    const activeCue = this.findActiveCue(track.cues, currentTime);
+    if (!activeCue) {
+      if (this.lastCueId !== null) {
+        this.overlay.innerHTML = "";
+        this.overlay.classList.remove("visible");
+        this.lastCueId = null;
+      }
+      return;
+    }
+    if (activeCue.id !== this.lastCueId) {
+      this.overlay.innerHTML = purify.sanitize(activeCue.text, {
+        ALLOWED_TAGS: ["b", "i", "u", "span", "c", "ruby", "rt"],
+        ALLOWED_ATTR: ["class", "lang"]
+      });
+      this.overlay.classList.add("visible");
+      this.lastCueId = activeCue.id;
+    }
+  }
+  /**
+   * Linear search for the active cue at the given time.
+   * WebVTT cue arrays are typically small (<200 entries),
+   * so linear scan is fine.
+   */
+  findActiveCue(cues, time) {
+    for (const cue of cues) {
+      if (time >= cue.startTime && time < cue.endTime) {
+        return cue;
+      }
+    }
+    return null;
+  }
+}
+export {
+  CaptionRenderer as C,
+  parseWebVTT as p
+};
+//# sourceMappingURL=captions-BP0H2E03.js.map

package/dist/captions-BP0H2E03.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"captions-BP0H2E03.js","sources":["../src/captions/webvtt-parser.ts","../src/captions/caption-renderer.ts"],"sourcesContent":["/**\n * Minimal WebVTT parser.\n *\n * Handles:\n * - UTF-8 BOM\n * - Timestamp lines `HH:MM:SS.mmm --> HH:MM:SS.mmm`\n * - Cue IDs (optional identifier line before timestamp)\n * - NOTE blocks (skipped)\n * - STYLE blocks (skipped)\n * - REGION blocks (skipped)\n * - Preserves <b>, <i>, <u> formatting tags; strips all others\n */\n\nexport interface VttCue {\n  id: string;\n  startTime: number;\n  endTime: number;\n  text: string;\n}\n\n/** Set of tags allowed in cue text */\nconst ALLOWED_TAGS = new Set(['b', 'i', 'u', 'br']);\n\n/** Strip BOM if present */\nfunction stripBOM(str: string): string {\n  return str.charCodeAt(0) === 0xfeff ? str.slice(1) : str;\n}\n\n/**\n * Parse a WebVTT timestamp string into seconds.\n *\n * Formats:\n *   HH:MM:SS.mmm\n *   MM:SS.mmm\n */\nexport function parseTimestamp(ts: string): number {\n  const parts = ts.trim().split(':');\n  if (parts.length < 2 || parts.length > 3) return NaN;\n\n  let hours = 0;\n  let minutes: number;\n  let seconds: number;\n\n  if (parts.length === 3) {\n    hours = parseInt(parts[0]!, 10);\n    minutes = parseInt(parts[1]!, 10);\n    seconds = parseFloat(parts[2]!);\n  } else {\n    minutes = parseInt(parts[0]!, 10);\n    seconds = parseFloat(parts[1]!);\n  }\n\n  if (isNaN(hours) || isNaN(minutes) || isNaN(seconds)) return NaN;\n\n  return hours * 3600 + minutes * 60 + seconds;\n}\n\n/**\n * Sanitize cue text: keep only allowed HTML tags, convert `\\n` to `<br>`.\n */\nfunction sanitizeText(raw: string): string {\n  // Replace newlines within a cue with <br>\n  let text = raw.replace(/\\n/g, '<br>');\n\n  // Strip disallowed tags but keep allowed ones\n  text = text.replace(/<\\/?([a-zA-Z][a-zA-Z0-9]*)\\b[^>]*>/g, (match, tag: string) => {\n    const lower = tag.toLowerCase();\n    if (ALLOWED_TAGS.has(lower)) {\n      // Return just the simple open/close tag (strip attributes)\n      if (match.startsWith('</')) return `</${lower}>`;\n      if (lower === 'br') return '<br>';\n      return `<${lower}>`;\n    }\n    return '';\n  });\n\n  return text.trim();\n}\n\n/**\n * Parse a WebVTT string into an array of cues.\n */\nexport function parseWebVTT(input: string): VttCue[] {\n  const raw = stripBOM(input);\n  const lines = raw.replace(/\\r\\n/g, '\\n').replace(/\\r/g, '\\n').split('\\n');\n\n  // Validate WEBVTT header\n  const headerLine = lines[0]?.trim() ?? '';\n  if (!headerLine.startsWith('WEBVTT')) {\n    console.warn('[Vizor] Invalid WebVTT: missing WEBVTT header');\n    return [];\n  }\n\n  const cues: VttCue[] = [];\n  const TIMESTAMP_RE = /^([\\d:.]+)\\s*-->\\s*([\\d:.]+)/;\n\n  let i = 1; // skip header line\n  let cueIndex = 0;\n\n  while (i < lines.length) {\n    const line = lines[i]!;\n    // Skip blank lines\n    if (line.trim() === '') {\n      i++;\n      continue;\n    }\n\n    // Skip NOTE blocks\n    if (line.trim().startsWith('NOTE')) {\n      i++;\n      while (i < lines.length && lines[i]!.trim() !== '') {\n        i++;\n      }\n      continue;\n    }\n\n    // Skip STYLE blocks\n    if (line.trim().startsWith('STYLE')) {\n      i++;\n      while (i < lines.length && lines[i]!.trim() !== '') {\n        i++;\n      }\n      continue;\n    }\n\n    // Skip REGION blocks\n    if (line.trim().startsWith('REGION')) {\n      i++;\n      while (i < lines.length && lines[i]!.trim() !== '') {\n        i++;\n      }\n      continue;\n    }\n\n    // Try to parse a cue: might start with an ID line or directly with timestamp\n    let cueId: string | undefined;\n    const timestampMatch = line.match(TIMESTAMP_RE);\n\n    if (!timestampMatch) {\n      // This line might be a cue ID — check if next line is a timestamp\n      const nextLine = lines[i + 1] ?? '';\n      const nextMatch = nextLine.match(TIMESTAMP_RE);\n      if (nextMatch) {\n        cueId = line.trim();\n        i++;\n        // Now lines[i] is the timestamp line; parse it below\n        const tsMatch = lines[i]!.match(TIMESTAMP_RE)!;\n        const startTime = parseTimestamp(tsMatch[1]!);\n        const endTime = parseTimestamp(tsMatch[2]!);\n        i++;\n\n        // Collect cue text lines\n        const textLines: string[] = [];\n        while (i < lines.length && lines[i]!.trim() !== '') {\n          textLines.push(lines[i]!);\n          i++;\n        }\n\n        if (!isNaN(startTime) && !isNaN(endTime) && textLines.length > 0) {\n          cues.push({\n            id: cueId ?? String(cueIndex),\n            startTime,\n            endTime,\n            text: sanitizeText(textLines.join('\\n')),\n          });\n          cueIndex++;\n        }\n      } else {\n        // Unknown line — skip\n        i++;\n      }\n      continue;\n    }\n\n    // Direct timestamp line (no cue ID)\n    const startTime = parseTimestamp(timestampMatch[1]!);\n    const endTime = parseTimestamp(timestampMatch[2]!);\n    i++;\n\n    // Collect cue text lines\n    const textLines: string[] = [];\n    while (i < lines.length && lines[i]!.trim() !== '') {\n      textLines.push(lines[i]!);\n      i++;\n    }\n\n    if (!isNaN(startTime) && !isNaN(endTime) && textLines.length > 0) {\n      cues.push({\n        id: cueId ?? String(cueIndex),\n        startTime,\n        endTime,\n        text: sanitizeText(textLines.join('\\n')),\n      });\n      cueIndex++;\n    }\n  }\n\n  return cues;\n}\n","import type { PlayerState } from '../core/player-state.js';\nimport { parseWebVTT, type VttCue } from './webvtt-parser.js';\nimport DOMPurify from 'dompurify';\n\n/** A loaded track with its parsed cues */\nexport interface CaptionTrack {\n  srclang: string;\n  label: string;\n  cues: VttCue[];\n  isDefault: boolean;\n}\n\n/**\n * Caption / subtitle renderer.\n *\n * Fetches `<track>` children via their `src` attribute, parses the\n * WebVTT content, and renders the active cue as a HUD overlay\n * positioned at the bottom of the player viewport.\n *\n * The overlay stays fixed relative to the viewport so that\n * captions remain visible regardless of camera orientation in\n * 360° video.\n */\nexport class CaptionRenderer {\n  private tracks: CaptionTrack[] = [];\n  private activeTrackIndex = -1;\n  private overlay: HTMLDivElement;\n  private shadow: ShadowRoot;\n  private unsubscribes: Array<() => void> = [];\n  private lastCueId: string | null = null;\n\n  constructor(shadow: ShadowRoot, state: PlayerState) {\n    this.shadow = shadow;\n\n    // Create the caption overlay element\n    this.overlay = document.createElement('div');\n    this.overlay.className = 'vz-caption-overlay';\n    this.overlay.setAttribute('aria-live', 'polite');\n    this.overlay.setAttribute('role', 'status');\n    shadow.appendChild(this.overlay);\n\n    // Subscribe to currentTime for cue updates\n    const unsub = state.subscribe('currentTime', (time) => {\n      this.renderCue(time);\n    });\n    this.unsubscribes.push(unsub);\n  }\n\n  /**\n   * Load all `<track>` children from the host element.\n   * Each track with a valid `src` is fetched and parsed.\n   */\n  async loadTracks(hostElement: HTMLElement): Promise<void> {\n    const trackElements = hostElement.querySelectorAll('track');\n    if (trackElements.length === 0) return;\n\n    const promises: Promise<void>[] = [];\n\n    trackElements.forEach((el) => {\n      const src = el.getAttribute('src');\n      if (!src) return;\n\n      const srclang = el.getAttribute('srclang') ?? 'en';\n      const label = el.getAttribute('label') ?? srclang.toUpperCase();\n      const isDefault = el.hasAttribute('default');\n\n      promises.push(\n        this.fetchAndParse(src, srclang, label, isDefault),\n      );\n    });\n\n    await Promise.allSettled(promises);\n\n    // Activate the default track if one exists\n    if (this.tracks.length > 0) {\n      const defaultIndex = this.tracks.findIndex((t) => t.isDefault);\n      if (defaultIndex >= 0) {\n        this.activeTrackIndex = defaultIndex;\n      }\n      // If no default, leave captions off (activeTrackIndex = -1)\n    }\n  }\n\n  /** Get all loaded tracks */\n  getTracks(): Readonly<CaptionTrack[]> {\n    return this.tracks;\n  }\n\n  /** Get the currently active track index (-1 = off) */\n  getActiveTrackIndex(): number {\n    return this.activeTrackIndex;\n  }\n\n  /** Set the active caption track by index. -1 = off. */\n  setActiveTrack(index: number): void {\n    if (index < -1 || index >= this.tracks.length) return;\n    this.activeTrackIndex = index;\n    this.lastCueId = null;\n\n    if (index === -1) {\n      this.overlay.innerHTML = '';\n      this.overlay.classList.remove('visible');\n    }\n  }\n\n  /** Toggle captions on/off. If off, activates the first available track. */\n  toggle(): void {\n    if (this.tracks.length === 0) return;\n\n    if (this.activeTrackIndex >= 0) {\n      // Turn off\n      this.setActiveTrack(-1);\n    } else {\n      // Turn on — prefer default track, fallback to first\n      const defaultIndex = this.tracks.findIndex((t) => t.isDefault);\n      this.setActiveTrack(defaultIndex >= 0 ? defaultIndex : 0);\n    }\n  }\n\n  /** Whether captions are currently active */\n  isActive(): boolean {\n    return this.activeTrackIndex >= 0;\n  }\n\n  /** Whether any tracks are loaded */\n  hasTracks(): boolean {\n    return this.tracks.length > 0;\n  }\n\n  dispose(): void {\n    for (const unsub of this.unsubscribes) unsub();\n    this.unsubscribes = [];\n    this.overlay.remove();\n    this.tracks = [];\n  }\n\n  // --- Private ---\n\n  private async fetchAndParse(\n    src: string,\n    srclang: string,\n    label: string,\n    isDefault: boolean,\n  ): Promise<void> {\n    try {\n      const response = await fetch(src);\n      if (!response.ok) {\n        console.warn(`[Vizor] Failed to fetch track: ${src} (${response.status})`);\n        return;\n      }\n      const text = await response.text();\n      const cues = parseWebVTT(text);\n\n      if (cues.length === 0) {\n        console.warn(`[Vizor] No cues found in track: ${src}`);\n        return;\n      }\n\n      this.tracks.push({ srclang, label, cues, isDefault });\n    } catch (err) {\n      console.warn(`[Vizor] Error loading track ${src}:`, err);\n    }\n  }\n\n  /** Find and render the active cue for the given time */\n  private renderCue(currentTime: number): void {\n    if (this.activeTrackIndex < 0 || this.activeTrackIndex >= this.tracks.length) {\n      return;\n    }\n\n    const track = this.tracks[this.activeTrackIndex]!;\n    const activeCue = this.findActiveCue(track.cues, currentTime);\n\n    if (!activeCue) {\n      if (this.lastCueId !== null) {\n        this.overlay.innerHTML = '';\n        this.overlay.classList.remove('visible');\n        this.lastCueId = null;\n      }\n      return;\n    }\n\n    // Only update DOM if cue changed\n    if (activeCue.id !== this.lastCueId) {\n      this.overlay.innerHTML = DOMPurify.sanitize(activeCue.text, {\n        ALLOWED_TAGS: ['b', 'i', 'u', 'span', 'c', 'ruby', 'rt'],\n        ALLOWED_ATTR: ['class', 'lang'],\n      });\n      this.overlay.classList.add('visible');\n      this.lastCueId = activeCue.id;\n    }\n  }\n\n  /**\n   * Linear search for the active cue at the given time.\n   * WebVTT cue arrays are typically small (<200 entries),\n   * so linear scan is fine.\n   */\n  private findActiveCue(cues: VttCue[], time: number): VttCue | null {\n    for (const cue of cues) {\n      if (time >= cue.startTime && time < cue.endTime) {\n        return cue;\n      }\n    }\n    return null;\n  }\n}\n"],"names":["startTime","endTime","textLines","DOMPurify"],"mappings":"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"}