@amazon/vinyl 2.0.4 → 3.0.0

package/dist/types/current/index.d.ts

@@ -58,6 +58,7 @@ export * from './playback/PlaybackSourceImpl';
 export * from './playback/ReadonlyPlaybackController';
 export * from './streaming/abr/QualitySelector';
 export * from './streaming/abr/QualitySelectorImpl';
+export * from './streaming/AudioOptions';
 export * from './streaming/buffering/BufferingController';
 export * from './streaming/buffering/codecDenylist';
 export * from './streaming/buffering/error/SourceBufferError';
@@ -87,11 +88,14 @@ export * from './streaming/StreamingEventMap';
 export * from './streaming/util/segment';
 export * from './text/discoverDashTextTracks';
 export * from './text/discoverHlsTextTracks';
+export * from './text/HtmlTextTrackRenderer';
+export * from './text/mediaTextTrackProvider';
 export * from './text/parseWebVtt';
 export * from './text/pickPreferredTextTrack';
 export * from './text/SidecarTextTrackController';
 export * from './text/SidecarTextTrackLoader';
 export * from './text/TextTrack';
+export * from './text/TextTrackRenderer';
 export * from './text/VttCueStyle';
 export * from './track/AutoResetController';
 export * from './track/createSegmentDataProvider';

package/dist/types/current/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/types/current/index.js

@@ -58,6 +58,7 @@ export * from './playback/PlaybackSourceImpl';
 export * from './playback/ReadonlyPlaybackController';
 export * from './streaming/abr/QualitySelector';
 export * from './streaming/abr/QualitySelectorImpl';
+export * from './streaming/AudioOptions';
 export * from './streaming/buffering/BufferingController';
 export * from './streaming/buffering/codecDenylist';
 export * from './streaming/buffering/error/SourceBufferError';
@@ -87,11 +88,14 @@ export * from './streaming/StreamingEventMap';
 export * from './streaming/util/segment';
 export * from './text/discoverDashTextTracks';
 export * from './text/discoverHlsTextTracks';
+export * from './text/HtmlTextTrackRenderer';
+export * from './text/mediaTextTrackProvider';
 export * from './text/parseWebVtt';
 export * from './text/pickPreferredTextTrack';
 export * from './text/SidecarTextTrackController';
 export * from './text/SidecarTextTrackLoader';
 export * from './text/TextTrack';
+export * from './text/TextTrackRenderer';
 export * from './text/VttCueStyle';
 export * from './track/AutoResetController';
 export * from './track/createSegmentDataProvider';

package/dist/types/current/streaming/AudioOptions.d.ts

@@ -0,0 +1,39 @@
+import type { ObjectSchema } from '@amazon/vinyl-validation';
+/**
+ * Criteria used to pick which audio rendition to play.
+ */
+export interface AudioSelection {
+    /**
+     * Preferred language(s) for audio content, as RFC 5646 codes (e.g. `'en'`,
+     * `'ja'`, `'fr-CA'`). May be a single tag or an ordered list of tags —
+     * earlier entries are preferred, with the best relatedness match kept for
+     * each period (audio without a language tag is always kept). `null` (the
+     * default) is NOT "no preference": it orders by the platform's
+     * `navigator.languages`. To keep every language, this option is not the
+     * mechanism — omit language content or pass a tag matching all.
+     */
+    readonly language?: string | readonly string[] | null;
+    /**
+     * Opt in to audio-description (a.k.a. described-video / DVS) audio: audio
+     * renditions carrying an accessibility "describes video" characteristic that
+     * narrate on-screen action. `false` (the default) keeps them out of the
+     * automatic default-audio selection — they are chosen only when this is set.
+     * When `true`, a description rendition is preferred where one exists for the
+     * selected language. Changing this reselects audio immediately.
+     */
+    readonly descriptive?: boolean;
+}
+/**
+ * Declarative audio configuration. Mirrors `VinylOptions.text`: the audio
+ * rendition is chosen from {@link selection}; changing it reselects audio
+ * immediately.
+ */
+export interface AudioOptions {
+    /**
+     * The audio selection criteria (language / descriptive).
+     */
+    readonly selection?: AudioSelection;
+}
+export declare const defaultAudioOptions: AudioOptions;
+export declare const audioOptionsValidator: ObjectSchema<AudioOptions>;
+//# sourceMappingURL=AudioOptions.d.ts.map

package/dist/types/current/streaming/AudioOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioOptions.d.ts","sourceRoot":"","sources":["../../../../src/streaming/AudioOptions.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAG5D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;IAErD;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CACjC;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IACzB;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAA;CACtC;AAED,eAAO,MAAM,mBAAmB,EAAE,YAEjC,CAAA;AAOD,eAAO,MAAM,qBAAqB,EAAE,YAAY,CAAC,YAAY,CAE3D,CAAA"}

package/dist/types/current/streaming/AudioOptions.js

@@ -0,0 +1,15 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { array, boolean, object, string } from '@amazon/vinyl-validation';
+export const defaultAudioOptions = {
+    selection: { language: null, descriptive: false },
+};
+const audioSelectionValidator = object({
+    language: string().or(array(string()).readonly()).orNull().optional(),
+    descriptive: boolean().optional(),
+});
+export const audioOptionsValidator = object({
+    selection: audioSelectionValidator.optional(),
+});

package/dist/types/current/streaming/createDefaultMediaTimelineTransformer.d.ts

@@ -3,13 +3,13 @@ import type { Capabilities } from '../client/Capabilities';
 import type { DrmController } from '../drm/DrmController';
 import type { MediaTimeline } from './MediaTimeline';
 import type { CodecOverrides } from '../util/media/codecOverrides';
+import type { AudioOptions } from './AudioOptions';
 export interface DefaultMediaTimelineTransformerDeps {
     readonly capabilities: Capabilities;
     readonly drmController: DrmController;
     readonly mediaTimeline: ObservableValue<Promise<MediaTimeline>>;
     readonly options: ObservableValue<{
-        readonly preferredAudioLanguage: string | readonly string[] | null;
-        readonly preferDescriptiveAudio?: boolean;
+        readonly audio: AudioOptions;
         readonly codecOverrides?: CodecOverrides;
     }>;
 }

package/dist/types/current/streaming/createDefaultMediaTimelineTransformer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createDefaultMediaTimelineTransformer.d.ts","sourceRoot":"","sources":["../../../../src/streaming/createDefaultMediaTimelineTransformer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAE/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAuBpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAGlE,MAAM,WAAW,mCAAmC;IAChD,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAA;IACnC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;IACrC,QAAQ,CAAC,aAAa,EAAE,eAAe,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAA;IAC/D,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;QAC9B,QAAQ,CAAC,sBAAsB,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;QAClE,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAA;QACzC,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAA;KAC3C,CAAC,CAAA;CACL;AAED;;;GAGG;AACH,wBAAgB,qCAAqC,CACjD,IAAI,EAAE,mCAAmC,GAC1C,eAAe,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CA6EzC"}
+{"version":3,"file":"createDefaultMediaTimelineTransformer.d.ts","sourceRoot":"","sources":["../../../../src/streaming/createDefaultMediaTimelineTransformer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAE/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAuBpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAElE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAElD,MAAM,WAAW,mCAAmC;IAChD,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAA;IACnC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;IACrC,QAAQ,CAAC,aAAa,EAAE,eAAe,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAA;IAC/D,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;QAC9B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAA;QAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAA;KAC3C,CAAC,CAAA;CACL;AAED;;;GAGG;AACH,wBAAgB,qCAAqC,CACjD,IAAI,EAAE,mCAAmC,GAC1C,eAAe,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAwEzC"}

package/dist/types/current/streaming/createDefaultMediaTimelineTransformer.js

@@ -38,7 +38,7 @@ export function createDefaultMediaTimelineTransformer(deps) {
         t = filterTimelineQualities((quality, index, array) => supportsAudioSamplingRate(deps, quality, index, array), throwSamplingRatesUnsupported, t);
         // Resolve audio-description eligibility BEFORE the language filter.
         // Description renditions are an accessibility opt-in, not general audio,
-        // so they must be gated out (unless opted in via preferDescriptiveAudio)
+        // so they must be gated out (unless opted in via audio.selection.descriptive)
         // before language selection runs. Otherwise a description rendition
         // whose language tag happens to score higher than the main audio's
         // (e.g. a described 'en' beating a main 'en-US') could win language
@@ -46,14 +46,14 @@ export function createDefaultMediaTimelineTransformer(deps) {
         // described audio they never opted into. With this gate first, the
         // language filter only ever picks among eligible (main, or opted-in
         // description) renditions.
-        t = filterTimelineQualities(createAudioDescriptionFilter(deps.options.value.preferDescriptiveAudio ?? false), throwNoPlayableAudio, t);
-        t = filterTimelineQualities(createLanguageFilter(deps.options.value.preferredAudioLanguage, 'audio'), throwLanguagesUnsupported, t);
+        const selection = deps.options.value.audio.selection;
+        t = filterTimelineQualities(createAudioDescriptionFilter(selection?.descriptive ?? false), throwNoPlayableAudio, t);
+        t = filterTimelineQualities(createLanguageFilter(selection?.language ?? null, 'audio'), throwLanguagesUnsupported, t);
         return t;
     }
     return combineData({
         timeline: deps.mediaTimeline,
-        preferredAudioLanguage: deps.options.pick('preferredAudioLanguage'),
-        preferDescriptiveAudio: deps.options.pick('preferDescriptiveAudio'),
+        audio: deps.options.pick('audio'),
         codecOverrides: deps.options.pick('codecOverrides'),
     }).map(async ({ timeline }) => {
         return transformTimeline(await timeline);

package/dist/types/current/text/HtmlTextTrackRenderer.d.ts

@@ -0,0 +1,60 @@
+import type { Disposable } from '@amazon/vinyl-util';
+import type { TextTrackRenderer } from './TextTrackRenderer';
+/**
+ * The subset of a `VTTCue`'s positioning properties {@link computeCueLayout}
+ * reads. A native `VTTCue` satisfies this; a plain `TextTrackCue` (platforms
+ * without `VTTCue`) leaves them undefined and falls back to defaults.
+ */
+export interface CueGeometry {
+    readonly align?: string | null;
+    readonly line?: number | AutoKeyword;
+    readonly lineAlign?: LineAlignSetting;
+    readonly position?: number | AutoKeyword;
+    readonly positionAlign?: PositionAlignSetting;
+    readonly size?: number;
+    readonly snapToLines?: boolean;
+    readonly vertical?: DirectionSetting;
+}
+/** Inline styles (camelCase CSS properties) to apply to a rendered cue box. */
+export type CueLayout = Record<string, string>;
+/**
+ * Maps a cue's WebVTT positioning settings to inline CSS. Pure and DOM-free so
+ * the (branchy) placement logic is unit-testable in isolation.
+ *
+ * A cue with neither `line` nor `position` set flows in the renderer's
+ * bottom-anchored, centered container (the common subtitle case). Otherwise it
+ * is absolutely positioned: `size` → width, `position`/`positionAlign` →
+ * horizontal, `line`/`lineAlign`/`snapToLines` → vertical (percentage lines, or
+ * whole rows counted from the bottom for negative integers), `align` → text
+ * alignment, `vertical` → writing mode.
+ */
+export declare function computeCueLayout(cue: CueGeometry): CueLayout;
+/**
+ * Renders a cue's text payload as safe HTML. Text is escaped (so it can't
+ * inject nodes); newlines become `<br>`; and WebVTT cue tags are converted:
+ * `<c.foo>`→`<span class="foo">`, `<i>/<b>/<u>/<ruby>/<rt>` pass through,
+ * `<v Name>`→`<span title>`, `<lang xx>`→`<span lang>`, timestamp tags are
+ * dropped. Class-based styling requires matching app CSS (STYLE blocks in the
+ * VTT are not applied).
+ */
+export declare function renderCueText(text: string): string;
+/**
+ * A {@link TextTrackRenderer} that paints cues as HTML into {@link element}.
+ * Mount `element` over the video; it stacks cues at the bottom, centered, and
+ * positions any cue that carries explicit WebVTT settings. The DOM track is
+ * expected to be `'hidden'` so only this renderer paints.
+ */
+export declare class HtmlTextTrackRenderer implements TextTrackRenderer, Disposable {
+    /** The overlay container to mount over the video. */
+    readonly element: HTMLElement;
+    private track;
+    private readonly styleElement;
+    private readonly onCueChange;
+    constructor();
+    setTextTrack(track: TextTrack | null): void;
+    setStyles(styles: readonly string[]): void;
+    dispose(): void;
+    private renderActiveCues;
+    private createCueBox;
+}
+//# sourceMappingURL=HtmlTextTrackRenderer.d.ts.map

package/dist/types/current/text/HtmlTextTrackRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HtmlTextTrackRenderer.d.ts","sourceRoot":"","sources":["../../../../src/text/HtmlTextTrackRenderer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAE5D;;;;GAIG;AACH,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,CAAA;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAA;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,CAAA;IACxC,QAAQ,CAAC,aAAa,CAAC,EAAE,oBAAoB,CAAA;IAC7C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAA;CACvC;AAED,+EAA+E;AAC/E,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAK9C;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,GAAG,SAAS,CAmD5D;AAmDD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoBlD;AAeD;;;;;GAKG;AACH,qBAAa,qBAAsB,YAAW,iBAAiB,EAAE,UAAU;IACvE,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;IAE7B,OAAO,CAAC,KAAK,CAAyB;IAGtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkB;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgC;;IAgB5D,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI;IAe3C,SAAS,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAI1C,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,YAAY;CAOvB"}

package/dist/types/current/text/HtmlTextTrackRenderer.js

@@ -0,0 +1,231 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/** Approximate row height for integer (snap-to-lines) `line` offsets. */
+const ROW_EM = 1.5;
+/**
+ * Maps a cue's WebVTT positioning settings to inline CSS. Pure and DOM-free so
+ * the (branchy) placement logic is unit-testable in isolation.
+ *
+ * A cue with neither `line` nor `position` set flows in the renderer's
+ * bottom-anchored, centered container (the common subtitle case). Otherwise it
+ * is absolutely positioned: `size` → width, `position`/`positionAlign` →
+ * horizontal, `line`/`lineAlign`/`snapToLines` → vertical (percentage lines, or
+ * whole rows counted from the bottom for negative integers), `align` → text
+ * alignment, `vertical` → writing mode.
+ */
+export function computeCueLayout(cue) {
+    const style = {};
+    // WebVTT's default text alignment is 'center'.
+    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;
+}
+const HTML_ESCAPE = {
+    '&': '&amp;',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+};
+/** Escapes text (and attribute values) for safe insertion via innerHTML. */
+function escapeHtml(text) {
+    // Character class, no backtracking.
+    return text.replace(/["&<>]/g, (ch) => HTML_ESCAPE[ch]);
+}
+// WebVTT inline tags rendered as the matching HTML element.
+const PASSTHROUGH_TAGS = new Set(['i', 'b', 'u', 'ruby', 'rt']);
+// Tags rendered as a <span> (styling/metadata carried via class/attributes).
+const SPAN_TAGS = new Set(['c', 'v', 'lang']);
+/** Opening HTML for a WebVTT start tag `inner` (the text between `<` and `>`). */
+function openTag(inner) {
+    // Timestamp tags (`<00:00:00.000>`) carry no styling — drop them.
+    if (/^\d/.test(inner))
+        return '';
+    // The head (before any annotation) is `name` plus `.class` segments.
+    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 ''; // unknown tag: drop
+}
+/** Closing HTML for a WebVTT end tag named `name`. */
+function closeTag(name) {
+    if (PASSTHROUGH_TAGS.has(name))
+        return `</${name}>`;
+    if (SPAN_TAGS.has(name))
+        return '</span>';
+    return '';
+}
+/**
+ * Renders a cue's text payload as safe HTML. Text is escaped (so it can't
+ * inject nodes); newlines become `<br>`; and WebVTT cue tags are converted:
+ * `<c.foo>`→`<span class="foo">`, `<i>/<b>/<u>/<ruby>/<rt>` pass through,
+ * `<v Name>`→`<span title>`, `<lang xx>`→`<span lang>`, timestamp tags are
+ * dropped. Class-based styling requires matching app CSS (STYLE blocks in the
+ * VTT are not applied).
+ */
+export function renderCueText(text) {
+    let html = '';
+    // Each match is one tag (`<…>`), a run of non-`<` text, or a stray `<`.
+    // The tag body excludes `<` (as well as `>`) so a failed tag match on a
+    // `<`-heavy string bails after one char rather than scanning to the end —
+    // keeping this linear (no polynomial backtracking) on adversarial input.
+    for (const token of text.match(/<[^<>]*>|[^<]+|</g) ?? []) {
+        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;
+}
+/**
+ * Rewrites a WebVTT `STYLE` block's `::cue` selectors to target this renderer's
+ * HTML cue elements: `::cue(<sel>)` → `.vinyl-text-cue <sel>` (cue components
+ * become descendants of the cue box) and bare `::cue` → `.vinyl-text-cue`.
+ * Rules are global to `.vinyl-text-cue`, so concurrent players share them.
+ */
+function scopeCueRules(css) {
+    // Bounded character classes; no nested quantifiers, so no backtracking blowup.
+    return css
+        .replace(/::cue\(([^)]*)\)/g, '.vinyl-text-cue $1')
+        .replace(/::cue\b/g, '.vinyl-text-cue');
+}
+/**
+ * A {@link TextTrackRenderer} that paints cues as HTML into {@link element}.
+ * Mount `element` over the video; it stacks cues at the bottom, centered, and
+ * positions any cue that carries explicit WebVTT settings. The DOM track is
+ * expected to be `'hidden'` so only this renderer paints.
+ */
+export class HtmlTextTrackRenderer {
+    /** The overlay container to mount over the video. */
+    element;
+    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.
+    styleElement;
+    onCueChange = () => this.renderActiveCues();
+    constructor() {
+        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) {
+        if (track === this.track)
+            return;
+        this.track?.removeEventListener('cuechange', this.onCueChange);
+        this.track = track;
+        // Drop the previous track's authored styles; the new one supplies its
+        // own via setStyles once loaded.
+        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() {
+        // Only invoked while a track is attached (from setTextTrack / cuechange).
+        const active = this.track.activeCues ?? [];
+        // Keep the <style> element; replace only the cue boxes.
+        const children = [this.styleElement];
+        for (let i = 0; i < active.length; i++) {
+            children.push(this.createCueBox(active[i]));
+        }
+        this.element.replaceChildren(...children);
+    }
+    createCueBox(cue) {
+        const box = document.createElement('div');
+        box.className = 'vinyl-text-cue';
+        Object.assign(box.style, computeCueLayout(cue));
+        box.innerHTML = renderCueText(cue.text ?? '');
+        return box;
+    }
+}

package/dist/types/current/text/SidecarTextTrackController.d.ts

@@ -1,91 +1,103 @@
 import { EventHostImpl, type Maybe, type RequestInitOptions } from '@amazon/vinyl-util';
-import type { TextTrackController, TextTrackEventMap, TextTrackInfo } from './TextTrack';
+import type { TextTrackController, TextTrackControllerOptions, TextTrackEventMap, TextTrackInfo } from './TextTrack';
 import type { ObservableValue } from '@amazon/vinyl-observable';
-import { type VttCueStyle } from './VttCueStyle';
+import type { MediaTextTrackProvider } from './mediaTextTrackProvider';
+import type { ReadonlyPlaybackController } from '../playback/ReadonlyPlaybackController';
+import type { TextTrackRenderer } from './TextTrackRenderer';
 export interface SidecarTextTrackControllerDeps {
     /**
-     * The HTML media element on which to attach the in-band TextTrack
-     * representation. Cues for the active text track are added to a TextTrack
-     * created via `media.addTextTrack`. Setting this to null disables DOM
-     * integration; cues are still loaded and surfaced via events.
+     * Hands out (memoized) DOM text tracks. Text tracks can only be created on a
+     * media element and never removed, so the provider reuses one track per
+     * rendition rather than accumulating them.
      */
-    readonly media: HTMLMediaElement | null;
+    readonly textTrackProvider: MediaTextTrackProvider;
     /**
      * Optional request init options forwarded with each VTT fetch (e.g. CORS).
      */
     readonly requestInit?: Maybe<RequestInitOptions>;
     /**
-     * Preferred caption language(s), most-preferred first. A non-null
-     * preference auto-selects the best-matching track, re-applied as the track
-     * list changes. Changing the preference to null clears the selection
-     * (captions off). An initial null (or an absent observable) is "no
-     * preference": forced tracks still auto-select until the app makes an
-     * explicit choice — it does not force captions off.
+     * The discovered text tracks, re-emitted whenever the manifest changes.
      */
-    readonly preferredTextLanguage?: ObservableValue<string | readonly string[] | null>;
+    readonly textTracks: ObservableValue<Promise<readonly TextTrackInfo[]>>;
     /**
-     * Layout style applied to each rendered VTTCue (see
-     * {@link VttCueStyle}). Read per cue as it is appended, so a change affects
-     * subsequently-rendered cues. Absent means no styling (browser defaults).
+     * Declarative selection / rendering configuration. Re-applied on change.
      */
-    readonly cueStyle?: ObservableValue<VttCueStyle | null>;
+    readonly options: ObservableValue<TextTrackControllerOptions>;
+    /**
+     * Supplies the current playhead used to fetch caption segments in a window
+     * around it.
+     */
+    readonly playbackController: ReadonlyPlaybackController;
+    /**
+     * Optional renderer that paints cues itself (HTML overlay). When provided,
+     * the DOM text track is kept `'hidden'` (timing only) and the renderer is
+     * handed the active track; without one, the track renders natively
+     * (`'showing'`).
+     */
+    readonly textTrackRenderer?: Maybe<TextTrackRenderer>;
 }
+/**
+ * Selects the text track that matches the given options, or null for none.
+ *
+ * The `enabled` mode gates everything: `'off'` renders nothing (default is
+ * `'forced'`). Otherwise an explicit {@link TextTrackSelection.id} wins; else
+ * the best language match is chosen among tracks filtered by kind and
+ * forced-ness. Forced-ness comes from {@link TextTrackSelection.forced} when
+ * set, otherwise from the mode (`'forced'` keeps only forced tracks, `'on'`
+ * only full tracks).
+ *
+ * @private
+ */
+export declare function resolveSelectedTrack(tracks: readonly TextTrackInfo[], options: TextTrackControllerOptions): TextTrackInfo | null;
 /**
  * Manages a sidecar WebVTT-based text track lifecycle:
  *
- *  - holds a discovered list of {@link TextTrackInfo}
- *  - on activation, fetches the chosen track's WebVTT and pushes cues to a
- *    `TextTrack` created on the `HTMLMediaElement`
- *  - clears any previously activated cues when switching tracks
+ *  - tracks the discovered {@link TextTrackInfo} list (from the `textTracks`
+ *    observable) and the current selection (from the `options` observable)
+ *  - on selection, fetches the chosen track's WebVTT and pushes cues to a DOM
+ *    `TextTrack` obtained from the {@link MediaTextTrackProvider}
+ *  - clears cues and hides the DOM track when the selection changes or clears
  *
- * The controller is intentionally agnostic of HLS/DASH discovery details. Its
- * input is whatever list of {@link TextTrackInfo} entries the manifest layer
- * decides to surface.
+ * The controller is agnostic of HLS/DASH discovery details; its inputs are the
+ * observables supplied by the manifest layer.
  */
 export declare class SidecarTextTrackController extends EventHostImpl<TextTrackEventMap> implements TextTrackController {
     private readonly deps;
     get [Symbol.toStringTag](): string;
-    private _tracks;
     private _active;
-    private _domTrack;
-    private loadAbort;
-    private _userSelected;
-    private readonly preferredLanguageSub;
+    private _tracks;
+    private _activeTextTrack;
+    private _ref;
+    private readonly loadAbort;
+    private readonly disposer;
     constructor(deps: SidecarTextTrackControllerDeps);
     get textTracks(): readonly TextTrackInfo[];
     get activeTextTrack(): TextTrackInfo | null;
+    get active(): boolean;
+    get disposed(): boolean;
     /**
-     * Replaces the discovered text track list. Emits `textTracksChange`. If
-     * the previously active track is no longer present, clears the active
-     * selection and emits `activeTextTrackChange`.
-     */
-    setTextTracks(tracks: readonly TextTrackInfo[]): void;
-    setActiveTextTrack(id: string | null): void;
-    /**
-     * Selects the track best matching the preferred language(s), or clears the
-     * selection when the preference is null or nothing matches.
+     * Replaces the discovered track list, emits `textTracksChange`, then
+     * re-applies the current selection against the new list.
      */
-    private applyPreferredLanguage;
+    private setTracks;
     /**
-     * Applies a selection by id (null clears it) without marking it as an
-     * explicit user choice. Shared by setActiveTextTrack and forced auto-select.
+     * Recomputes the selection from the current options and track list,
+     * emitting `activeTextTrackChange` on change and (re)rendering when active.
      */
-    private selectById;
+    private refreshSelection;
+    deactivate(): void;
+    activate(): void;
+    private startLoad;
+    private appendCues;
     /**
-     * The forced track to auto-select, or null. Prefers the default track's
-     * language, else the first forced track.
+     * Clears cues from the current DOM track and hides it, keeping the track for
+     * later reuse via the provider.
      */
-    private pickForcedTrack;
-    suspend(): void;
-    resume(): void;
+    private hideCurrent;
     /**
-     * Cancels any in-flight load, clears the DOM TextTrack, and resets state.
+     * Cancels any in-flight load, hides the DOM text track, and resets state.
      * Called by the host when the underlying media is unloaded.
      */
     dispose(): void;
-    private startLoad;
-    private ensureDomTrack;
-    private appendCues;
-    private clearDomTrack;
 }
 //# sourceMappingURL=SidecarTextTrackController.d.ts.map