@mango-iiif/av 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mango IIIF contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,205 @@
+# @mango-iiif/av
+
+Framework-free IIIF audio and video components powered by [Media Chrome](https://www.media-chrome.org/). The package reads Presentation 2 and Presentation 3 manifests and exposes an all-in-one element, independently placeable components, and a typed controller API. It has no React or Svelte runtime dependency.
+
+## Install
+
+```sh
+npm install @mango-iiif/av
+```
+
+## Complete media experience
+
+`<mango-av-media>` contains the player, chapters, transcript, annotations, metadata, and supplemental files:
+
+```ts
+import '@mango-iiif/av';
+import type { MangoAVMediaElement } from '@mango-iiif/av';
+
+const media = document.querySelector<MangoAVMediaElement>('mango-av-media')!;
+
+media.config = {
+  panels: {
+    chapters: true,
+    transcript: true,
+    annotations: true,
+    metadata: true,
+    supplementalFiles: true,
+  },
+  controls: {
+    captions: true,
+    playbackRate: true,
+    pictureInPicture: true,
+    fullscreen: true,
+  },
+  resume: { enabled: true },
+};
+
+media.manifest = 'https://example.org/iiif/manifest.json';
+```
+
+It can also be configured from HTML when only JSON-compatible options are needed:
+
+```html
+<mango-av-media
+  manifest-url="https://example.org/iiif/manifest.json"
+  config='{"panels":{"transcript":true},"autoAdvance":false}'
+></mango-av-media>
+```
+
+## Independently placeable components
+
+The player, chapters, transcript, and annotations can be placed anywhere in an application. Assign the same `AVPlayerController` to each element so actions and state changes synchronize across all of them:
+
+```html
+<main><mango-av-player></mango-av-player></main>
+<aside><mango-av-chapters></mango-av-chapters></aside>
+<section><mango-av-transcript></mango-av-transcript></section>
+<aside><mango-av-annotations></mango-av-annotations></aside>
+```
+
+```ts
+import { AVPlayerController } from '@mango-iiif/av/core';
+import '@mango-iiif/av/player';
+import '@mango-iiif/av/chapters';
+import '@mango-iiif/av/transcript';
+import '@mango-iiif/av/annotations';
+import { type MangoAVPlayerElement } from '@mango-iiif/av/player';
+import { type MangoAVChaptersElement } from '@mango-iiif/av/chapters';
+import { type MangoAVTranscriptElement } from '@mango-iiif/av/transcript';
+import { type MangoAVAnnotationsElement } from '@mango-iiif/av/annotations';
+
+const controller = new AVPlayerController();
+
+document.querySelector<MangoAVPlayerElement>('mango-av-player')!.controller = controller;
+document.querySelector<MangoAVChaptersElement>('mango-av-chapters')!.controller = controller;
+document.querySelector<MangoAVTranscriptElement>('mango-av-transcript')!.controller = controller;
+document.querySelector<MangoAVAnnotationsElement>('mango-av-annotations')!.controller = controller;
+
+await controller.load(manifest);
+```
+
+The controller is an `EventTarget`. A chapter selection calls `selectCanvas`, a transcript or annotation selection calls `seekTo`, and every connected component reacts to the resulting typed controller events. Components do not need a common DOM parent.
+
+Use one `<mango-av-player>` per controller. Any number of display or interaction components can share that controller, including components rendered in different framework components, panels, or portals.
+
+```ts
+const unsubscribe = controller.on('av-timeupdate', ({ detail }) => {
+  console.log(detail.canvasId, detail.time);
+});
+```
+
+## Translations
+
+Override any package-owned interface string with the typed, partial `strings` configuration. Unspecified values keep their English defaults, and the same controller dictionary is used by every connected standalone component:
+
+```ts
+const controller = new AVPlayerController({
+  preferredLanguages: ['cy', 'en', 'none'],
+  strings: {
+    chapters: 'Penodau',
+    transcript: 'Trawsgrifiad',
+    previous: 'Blaenorol',
+    next: 'Nesaf',
+    searchTranscript: 'Chwilio’r trawsgrifiad',
+    sourceNumber: 'Ffynhonnell {number}',
+    resumePrompt: 'Parhau o {time}?',
+  },
+});
+```
+
+`preferredLanguages` chooses localized IIIF labels and sets the Media Chrome language. The package automatically loads Media Chrome's bundled German, Spanish, French, Portuguese, and Chinese dictionaries. `strings` covers the Mango AV wrapper UI and generated fallback labels for any language. The complete English dictionary is exported as `defaultStrings` for building and validating translation files.
+
+## Svelte
+
+The element works as a normal custom element. The future Mango integration does not need a wrapper library:
+
+```svelte
+<script lang="ts">
+  import '@mango-iiif/av';
+  import type { AVPlayerConfig } from '@mango-iiif/av';
+
+  const config: AVPlayerConfig = {
+    panels: { chapters: true, transcript: true },
+  };
+</script>
+
+<mango-av-media manifest-url={manifestUrl} .config={config}></mango-av-media>
+```
+
+For Svelte versions that do not accept property syntax in markup, bind the element and assign `element.config` in an effect.
+
+## Controller-only API
+
+Use the controller when an application owns its own UI:
+
+```ts
+import { AVPlayerController } from '@mango-iiif/av/core';
+
+const controller = new AVPlayerController({ autoAdvance: true });
+const manifest = await controller.load(manifestJson);
+
+controller.attachMedia(document.querySelector('video')!);
+controller.selectCanvas(manifest.canvases[1].id, { time: 12.5 });
+await controller.play();
+```
+
+## Styling and themes
+
+The component maps its theme to public CSS custom properties. This gives the host full control of the look without depending on private shadow-DOM selectors:
+
+```css
+mango-av-media.tailwind-audio,
+mango-av-player.tailwind-audio,
+mango-av-chapters.tailwind-audio,
+mango-av-transcript.tailwind-audio,
+mango-av-annotations.tailwind-audio {
+  --mango-av-accent: #0f172a;
+  --mango-av-accent-contrast: #f8fafc;
+  --mango-av-background: #f8fafc;
+  --mango-av-surface: #e2e8f0;
+  --mango-av-text: #0f172a;
+  --mango-av-border: #cbd5e1;
+  --mango-av-radius: 0.875rem;
+  --mango-av-font: Inter, ui-sans-serif, system-ui;
+  --mango-av-panel-width: 26rem;
+}
+```
+
+Media Chrome variables such as `--media-primary-color` and `--media-secondary-color` can also be set directly. The complete element provides `header`, `before-player`, `player-overlay`, `controls`, and `after-player` slots. The standalone player provides `overlay` and `controls`; the information components provide a `heading` slot.
+
+Run `npm run dev` to use the interactive configuration builder and the linked composable-components demonstration. They include Video, HLS, and Audio presets, feature switches, generated API configuration, independently positioned components, and multiple style recipes.
+
+## Supported IIIF AV behavior
+
+- Presentation 2 sequences and Presentation 3 Canvas items
+- Audio, video, native HLS, and hls.js-backed HLS through `<hls-video>`
+- `Choice` and multiple painting bodies, media source selection, temporal fragments, and clipped playback
+- Multi-Canvas previous/next, `start`/`startCanvas`, `auto-advance`, and `repeat`
+- Nested Range navigation and temporal chapters
+- Inline and external supplementing annotations
+- Captions, subtitles, audio descriptions, transcript selection, search, download, and synchronized scrolling
+- WebVTT, SRT, plain text, structured JSON, and inline TextualBody transcripts
+- Commenting, supplementing, transcribing, tagging, and highlighting annotations
+- Manifest/Canvas metadata, rights, required statements, homepages, and `rendering` downloads
+- Placeholder posters, request resolution for protected media, and service metadata normalization
+- Optional persisted playback positions
+- Configurable annotation create/update/delete adapters
+
+See [API.md](docs/API.md) for the complete API and [FEATURE_PARITY.md](docs/FEATURE_PARITY.md) for feature coverage.
+
+## Development
+
+```sh
+npm install
+npm run dev
+npm run typecheck
+npm test
+npm run test:e2e
+npm run build
+npm run pack:check
+```
+
+## License
+
+MIT

package/dist/annotations.d.ts

@@ -0,0 +1,12 @@
+import { A as AVControllerElement } from './controller-element-BOKM9v2S.js';
+import { i as AVPlayerEventMap } from './controller-DLy38ais.js';
+
+declare class MangoAVAnnotationsElement extends AVControllerElement {
+    #private;
+    constructor();
+    protected controllerChanged(): void;
+    protected handleControllerEvent<K extends keyof AVPlayerEventMap>(type: K, _event: CustomEvent<AVPlayerEventMap[K]>): void;
+}
+declare const defineMangoAVAnnotations: (tagName?: string) => typeof MangoAVAnnotationsElement;
+
+export { MangoAVAnnotationsElement, defineMangoAVAnnotations };

package/dist/annotations.js

@@ -0,0 +1,15 @@
+import {
+  MangoAVAnnotationsElement,
+  defineMangoAVAnnotations
+} from "./chunk-IFTSCRCU.js";
+import "./chunk-CDLYT3KB.js";
+import "./chunk-JXUHKKIX.js";
+import "./chunk-R4OUWZ3R.js";
+
+// src/annotations.ts
+if (typeof window !== "undefined" && "customElements" in window) defineMangoAVAnnotations();
+export {
+  MangoAVAnnotationsElement,
+  defineMangoAVAnnotations
+};
+//# sourceMappingURL=annotations.js.map

package/dist/annotations.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/annotations.ts"],"sourcesContent":["export { defineMangoAVAnnotations, MangoAVAnnotationsElement } from './components/mango-av-annotations';\n\nimport { defineMangoAVAnnotations } from './components/mango-av-annotations';\nif (typeof window !== 'undefined' && 'customElements' in window) defineMangoAVAnnotations();\n"],"mappings":";;;;;;;;;AAGA,IAAI,OAAO,WAAW,eAAe,oBAAoB,OAAQ,0BAAyB;","names":[]}

package/dist/chapters.d.ts

@@ -0,0 +1,12 @@
+import { A as AVControllerElement } from './controller-element-BOKM9v2S.js';
+import { i as AVPlayerEventMap } from './controller-DLy38ais.js';
+
+declare class MangoAVChaptersElement extends AVControllerElement {
+    #private;
+    constructor();
+    protected controllerChanged(): void;
+    protected handleControllerEvent<K extends keyof AVPlayerEventMap>(type: K, _event: CustomEvent<AVPlayerEventMap[K]>): void;
+}
+declare const defineMangoAVChapters: (tagName?: string) => typeof MangoAVChaptersElement;
+
+export { MangoAVChaptersElement, defineMangoAVChapters };

package/dist/chapters.js

@@ -0,0 +1,14 @@
+import {
+  MangoAVChaptersElement,
+  defineMangoAVChapters
+} from "./chunk-YH6DS7J6.js";
+import "./chunk-JXUHKKIX.js";
+import "./chunk-R4OUWZ3R.js";
+
+// src/chapters.ts
+if (typeof window !== "undefined" && "customElements" in window) defineMangoAVChapters();
+export {
+  MangoAVChaptersElement,
+  defineMangoAVChapters
+};
+//# sourceMappingURL=chapters.js.map

package/dist/chapters.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/chapters.ts"],"sourcesContent":["export { defineMangoAVChapters, MangoAVChaptersElement } from './components/mango-av-chapters';\n\nimport { defineMangoAVChapters } from './components/mango-av-chapters';\nif (typeof window !== 'undefined' && 'customElements' in window) defineMangoAVChapters();\n"],"mappings":";;;;;;;;AAGA,IAAI,OAAO,WAAW,eAAe,oBAAoB,OAAQ,uBAAsB;","names":[]}

package/dist/chunk-3LLEY7MA.js

@@ -0,0 +1,126 @@
+import {
+  parseTime
+} from "./chunk-R4OUWZ3R.js";
+
+// src/transcript.ts
+var stripMarkup = (value) => value.replace(/<br\s*\/?>/gi, "\n").replace(/<[^>]+>/g, "").replace(/&nbsp;/g, " ").replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').trim();
+var cueFromBlock = (block, index, isSrt) => {
+  const timestampIndex = block.findIndex((line) => line.includes("-->"));
+  if (timestampIndex < 0) return void 0;
+  const timestamp = block[timestampIndex];
+  if (!timestamp) return void 0;
+  const [rawStart = "", rawEnd = ""] = timestamp.split("-->").map((part) => part.trim().split(/\s+/)[0] ?? "");
+  const start = parseTime(isSrt ? rawStart.replace(",", ".") : rawStart);
+  const end = parseTime(isSrt ? rawEnd.replace(",", ".") : rawEnd);
+  if (start === void 0 || end === void 0) return void 0;
+  const text = stripMarkup(block.slice(timestampIndex + 1).join("\n"));
+  if (!text) return void 0;
+  return {
+    id: `cue-${index}`,
+    start,
+    end,
+    text,
+    type: "cue"
+  };
+};
+var parseTimedText = (input, format, options = {}) => {
+  const normalized = input.replace(/^\uFEFF/, "").replace(/\r\n?/g, "\n");
+  if (format === "vtt" && !normalized.trimStart().startsWith("WEBVTT")) {
+    throw new Error("Invalid WebVTT transcript: missing WEBVTT header.");
+  }
+  const lines = normalized.split("\n");
+  const cues = [];
+  let block = [];
+  const flush = () => {
+    if (block.length === 0) return;
+    const first = block[0]?.trim() ?? "";
+    if (/^NOTE(?:\s|$)/i.test(first)) {
+      if (options.showNotes) {
+        const text = stripMarkup(block.join("\n").replace(/^NOTE\s*/i, ""));
+        if (text) cues.push({ id: `note-${cues.length}`, text, type: "note" });
+      }
+    } else if (!block.some((line) => line.includes("-->"))) {
+      const upper = first.toUpperCase();
+      if (options.showMetadata && first && first !== "WEBVTT" && upper !== "STYLE" && upper !== "REGION") {
+        cues.push({ id: `metadata-${cues.length}`, text: stripMarkup(block.join("\n")), type: "metadata" });
+      }
+    } else {
+      const cue = cueFromBlock(block, cues.length, format === "srt");
+      if (cue) cues.push(cue);
+    }
+    block = [];
+  };
+  for (const line of lines) {
+    if (line.trim() === "") flush();
+    else block.push(line);
+  }
+  flush();
+  return cues;
+};
+var parseJsonTranscript = (value) => {
+  if (!Array.isArray(value)) return [];
+  const cues = [];
+  for (const entry of value) {
+    if (!entry || typeof entry !== "object") continue;
+    const object = entry;
+    const spans = Array.isArray(object.spans) ? object.spans : [object];
+    for (const spanValue of spans) {
+      if (!spanValue || typeof spanValue !== "object") continue;
+      const span = spanValue;
+      const textValue = span.text ?? span.value ?? span.chars;
+      if (typeof textValue !== "string") continue;
+      const cue = {
+        id: typeof span.id === "string" ? span.id : `cue-${cues.length}`,
+        text: stripMarkup(textValue),
+        type: "cue"
+      };
+      const start = parseTime(span.begin ?? span.start);
+      const end = parseTime(span.end ?? span.stop);
+      if (start !== void 0) cue.start = start;
+      if (end !== void 0) cue.end = end;
+      if (typeof object.speaker === "string") cue.speaker = object.speaker;
+      else if (typeof span.speaker === "string") cue.speaker = span.speaker;
+      cues.push(cue);
+    }
+  }
+  return cues;
+};
+var parseTranscript = (input, format, options = {}) => {
+  const normalizedFormat = format.toLowerCase().split(";")[0] ?? "";
+  if (normalizedFormat.includes("json") || typeof input !== "string" && typeof input === "object") {
+    const value = typeof input === "string" ? JSON.parse(input) : input;
+    return parseJsonTranscript(value);
+  }
+  if (typeof input !== "string") return [];
+  if (normalizedFormat.includes("vtt") || normalizedFormat === "vtt") return parseTimedText(input, "vtt", options);
+  if (normalizedFormat.includes("srt") || normalizedFormat.includes("subrip") || normalizedFormat === "srt") return parseTimedText(input, "srt", options);
+  return input.replace(/\r\n?/g, "\n").split(/\n{2,}|\n/).map((text) => stripMarkup(text)).filter(Boolean).map((text, index) => ({ id: `text-${index}`, text, type: "text" }));
+};
+var inferFormat = (resource, contentType) => {
+  if (resource.format) return resource.format;
+  if (contentType) return contentType;
+  const extension = resource.src?.split(/[?#]/)[0]?.split(".").pop()?.toLowerCase();
+  return extension ?? "text/plain";
+};
+var loadTranscript = async (resource, options = {}) => {
+  if (resource.cues) return resource.cues;
+  if (!resource.src) return [];
+  if (resource.format?.includes("wordprocessingml") || /\.docx(?:$|[?#])/i.test(resource.src)) {
+    throw new Error("DOCX transcripts are not supported.");
+  }
+  const fetcher = options.fetch ?? globalThis.fetch;
+  if (!fetcher) throw new Error("No fetch implementation is available to load the transcript.");
+  const response = await fetcher(resource.src, options.requestInit);
+  if (!response.ok) throw new Error(`Unable to load transcript (${response.status} ${response.statusText}).`);
+  const contentType = response.headers.get("content-type");
+  const format = inferFormat(resource, contentType);
+  if (format.includes("json")) return parseTranscript(await response.json(), format, options);
+  return parseTranscript(await response.text(), format, options);
+};
+
+export {
+  parseTimedText,
+  parseTranscript,
+  loadTranscript
+};
+//# sourceMappingURL=chunk-3LLEY7MA.js.map

package/dist/chunk-3LLEY7MA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transcript.ts"],"sourcesContent":["import type { TranscriptCue, TranscriptResource } from './types';\nimport { parseTime } from './utils';\n\nexport interface TranscriptParseOptions {\n  showNotes?: boolean;\n  showMetadata?: boolean;\n}\n\nconst stripMarkup = (value: string): string =>\n  value\n    .replace(/<br\\s*\\/?>/gi, '\\n')\n    .replace(/<[^>]+>/g, '')\n    .replace(/&nbsp;/g, ' ')\n    .replace(/&amp;/g, '&')\n    .replace(/&lt;/g, '<')\n    .replace(/&gt;/g, '>')\n    .replace(/&quot;/g, '\"')\n    .trim();\n\nconst cueFromBlock = (\n  block: string[],\n  index: number,\n  isSrt: boolean,\n): TranscriptCue | undefined => {\n  const timestampIndex = block.findIndex((line) => line.includes('-->'));\n  if (timestampIndex < 0) return undefined;\n  const timestamp = block[timestampIndex];\n  if (!timestamp) return undefined;\n  const [rawStart = '', rawEnd = ''] = timestamp.split('-->').map((part) => part.trim().split(/\\s+/)[0] ?? '');\n  const start = parseTime(isSrt ? rawStart.replace(',', '.') : rawStart);\n  const end = parseTime(isSrt ? rawEnd.replace(',', '.') : rawEnd);\n  if (start === undefined || end === undefined) return undefined;\n  const text = stripMarkup(block.slice(timestampIndex + 1).join('\\n'));\n  if (!text) return undefined;\n  return {\n    id: `cue-${index}`,\n    start,\n    end,\n    text,\n    type: 'cue',\n  };\n};\n\nexport const parseTimedText = (\n  input: string,\n  format: 'vtt' | 'srt',\n  options: TranscriptParseOptions = {},\n): TranscriptCue[] => {\n  const normalized = input.replace(/^\\uFEFF/, '').replace(/\\r\\n?/g, '\\n');\n  if (format === 'vtt' && !normalized.trimStart().startsWith('WEBVTT')) {\n    throw new Error('Invalid WebVTT transcript: missing WEBVTT header.');\n  }\n  const lines = normalized.split('\\n');\n  const cues: TranscriptCue[] = [];\n  let block: string[] = [];\n  const flush = () => {\n    if (block.length === 0) return;\n    const first = block[0]?.trim() ?? '';\n    if (/^NOTE(?:\\s|$)/i.test(first)) {\n      if (options.showNotes) {\n        const text = stripMarkup(block.join('\\n').replace(/^NOTE\\s*/i, ''));\n        if (text) cues.push({ id: `note-${cues.length}`, text, type: 'note' });\n      }\n    } else if (!block.some((line) => line.includes('-->'))) {\n      const upper = first.toUpperCase();\n      if (options.showMetadata && first && first !== 'WEBVTT' && upper !== 'STYLE' && upper !== 'REGION') {\n        cues.push({ id: `metadata-${cues.length}`, text: stripMarkup(block.join('\\n')), type: 'metadata' });\n      }\n    } else {\n      const cue = cueFromBlock(block, cues.length, format === 'srt');\n      if (cue) cues.push(cue);\n    }\n    block = [];\n  };\n  for (const line of lines) {\n    if (line.trim() === '') flush();\n    else block.push(line);\n  }\n  flush();\n  return cues;\n};\n\nconst parseJsonTranscript = (value: unknown): TranscriptCue[] => {\n  if (!Array.isArray(value)) return [];\n  const cues: TranscriptCue[] = [];\n  for (const entry of value) {\n    if (!entry || typeof entry !== 'object') continue;\n    const object = entry as Record<string, unknown>;\n    const spans = Array.isArray(object.spans) ? object.spans : [object];\n    for (const spanValue of spans) {\n      if (!spanValue || typeof spanValue !== 'object') continue;\n      const span = spanValue as Record<string, unknown>;\n      const textValue = span.text ?? span.value ?? span.chars;\n      if (typeof textValue !== 'string') continue;\n      const cue: TranscriptCue = {\n        id: typeof span.id === 'string' ? span.id : `cue-${cues.length}`,\n        text: stripMarkup(textValue),\n        type: 'cue',\n      };\n      const start = parseTime((span.begin ?? span.start) as string | number | undefined);\n      const end = parseTime((span.end ?? span.stop) as string | number | undefined);\n      if (start !== undefined) cue.start = start;\n      if (end !== undefined) cue.end = end;\n      if (typeof object.speaker === 'string') cue.speaker = object.speaker;\n      else if (typeof span.speaker === 'string') cue.speaker = span.speaker;\n      cues.push(cue);\n    }\n  }\n  return cues;\n};\n\nexport const parseTranscript = (\n  input: string | unknown,\n  format: string,\n  options: TranscriptParseOptions = {},\n): TranscriptCue[] => {\n  const normalizedFormat = format.toLowerCase().split(';')[0] ?? '';\n  if (normalizedFormat.includes('json') || (typeof input !== 'string' && typeof input === 'object')) {\n    const value = typeof input === 'string' ? JSON.parse(input) as unknown : input;\n    return parseJsonTranscript(value);\n  }\n  if (typeof input !== 'string') return [];\n  if (normalizedFormat.includes('vtt') || normalizedFormat === 'vtt') return parseTimedText(input, 'vtt', options);\n  if (normalizedFormat.includes('srt') || normalizedFormat.includes('subrip') || normalizedFormat === 'srt') return parseTimedText(input, 'srt', options);\n  return input\n    .replace(/\\r\\n?/g, '\\n')\n    .split(/\\n{2,}|\\n/)\n    .map((text) => stripMarkup(text))\n    .filter(Boolean)\n    .map((text, index) => ({ id: `text-${index}`, text, type: 'text' as const }));\n};\n\nconst inferFormat = (resource: TranscriptResource, contentType: string | null): string => {\n  if (resource.format) return resource.format;\n  if (contentType) return contentType;\n  const extension = resource.src?.split(/[?#]/)[0]?.split('.').pop()?.toLowerCase();\n  return extension ?? 'text/plain';\n};\n\nexport const loadTranscript = async (\n  resource: TranscriptResource,\n  options: TranscriptParseOptions & { fetch?: typeof globalThis.fetch; requestInit?: RequestInit } = {},\n): Promise<TranscriptCue[]> => {\n  if (resource.cues) return resource.cues;\n  if (!resource.src) return [];\n  if (resource.format?.includes('wordprocessingml') || /\\.docx(?:$|[?#])/i.test(resource.src)) {\n    throw new Error('DOCX transcripts are not supported.');\n  }\n  const fetcher = options.fetch ?? globalThis.fetch;\n  if (!fetcher) throw new Error('No fetch implementation is available to load the transcript.');\n  const response = await fetcher(resource.src, options.requestInit);\n  if (!response.ok) throw new Error(`Unable to load transcript (${response.status} ${response.statusText}).`);\n  const contentType = response.headers.get('content-type');\n  const format = inferFormat(resource, contentType);\n  if (format.includes('json')) return parseTranscript(await response.json(), format, options);\n  return parseTranscript(await response.text(), format, options);\n};\n"],"mappings":"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","names":[]}

package/dist/chunk-CDLYT3KB.js

@@ -0,0 +1,17 @@
+// src/components/playback.ts
+var playFromInteraction = (controller, target) => {
+  void controller.play().catch((cause) => {
+    if (cause instanceof Error && cause.name === "AbortError") return;
+    const error = cause instanceof Error ? cause : new Error(String(cause));
+    target.dispatchEvent(new CustomEvent("av-error", {
+      detail: { error },
+      bubbles: true,
+      composed: true
+    }));
+  });
+};
+
+export {
+  playFromInteraction
+};
+//# sourceMappingURL=chunk-CDLYT3KB.js.map

package/dist/chunk-CDLYT3KB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/playback.ts"],"sourcesContent":["import type { AVPlayerController } from '../controller';\n\nexport const playFromInteraction = (controller: AVPlayerController, target: EventTarget): void => {\n  void controller.play().catch((cause: unknown) => {\n    if (cause instanceof Error && cause.name === 'AbortError') return;\n    const error = cause instanceof Error ? cause : new Error(String(cause));\n    target.dispatchEvent(new CustomEvent('av-error', {\n      detail: { error },\n      bubbles: true,\n      composed: true,\n    }));\n  });\n};\n"],"mappings":";AAEO,IAAM,sBAAsB,CAAC,YAAgC,WAA8B;AAChG,OAAK,WAAW,KAAK,EAAE,MAAM,CAAC,UAAmB;AAC/C,QAAI,iBAAiB,SAAS,MAAM,SAAS,aAAc;AAC3D,UAAM,QAAQ,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AACtE,WAAO,cAAc,IAAI,YAAY,YAAY;AAAA,MAC/C,QAAQ,EAAE,MAAM;AAAA,MAChB,SAAS;AAAA,MACT,UAAU;AAAA,IACZ,CAAC,CAAC;AAAA,EACJ,CAAC;AACH;","names":[]}

package/dist/chunk-GAVG7CPU.js

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-GAVG7CPU.js.map

package/dist/chunk-GAVG7CPU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}