mattebox 0.1.0

package/dist/stages/text-cea608/index.js

@@ -0,0 +1,84 @@
+/**
+ * CEA-608 in-band captions as a stage. It owns the decoder and the seam to
+ * its SEI source: it registers one caption consumer, and whichever source is
+ * composed (ts-transmux for TS, nal-scan for fMP4) delivers the byte pairs.
+ * The stage imports neither source, only the shared registry, which is what
+ * lets one decoder serve both routes (entanglement #1).
+ *
+ * Decoded captions become native VTTCues on a caption TextTrack, rendered by
+ * the browser like any text track. The track is created on the first cue and
+ * left off by default; the viewer or the app turns it on.
+ */
+import { registerCaptionConsumer } from '../../containers/captions.js';
+import { Cea608Decoder } from './decode.js';
+export default function textCea608() {
+    return {
+        name: 'text-cea608',
+        provides: ['text-cea608', { contentType: 'text', mimeType: 'application/cea-608' }],
+        // Either SEI source satisfies it; the loader resolves the alternative.
+        requires: [['ts-transmux', 'nal-scan']],
+        install(ctx) {
+            const decoder = new Cea608Decoder();
+            const element = ctx.element;
+            let track = null;
+            /** Empties the track. `cues` reads null while disabled; hidden makes them removable. */
+            function empty(target) {
+                target.mode = 'hidden';
+                const { cues } = target;
+                if (cues === null)
+                    return;
+                for (let i = cues.length - 1; i >= 0; i -= 1) {
+                    const cue = cues[i];
+                    if (cue !== undefined)
+                        target.removeCue(cue);
+                }
+            }
+            function ensureTrack() {
+                if (track === null) {
+                    // The element cannot drop a TextTrack, so a previous attach on the
+                    // same element (a rebuild) left one behind: adopt it, emptied,
+                    // rather than add a duplicate to the browser's caption menu.
+                    for (const existing of element.textTracks) {
+                        if (existing.kind === 'captions' && existing.label === 'CC1') {
+                            track = existing;
+                            empty(track);
+                            break;
+                        }
+                    }
+                    track ??= element.addTextTrack('captions', 'CC1', 'en');
+                    // Present but not rendered until the viewer selects it.
+                    track.mode = 'hidden';
+                }
+                return track;
+            }
+            const unregister = registerCaptionConsumer((packets) => {
+                for (const packet of packets) {
+                    for (const triple of packet.triples) {
+                        // CEA-608 field 1 carries CC1, the primary channel this decodes.
+                        if (triple.type === 0)
+                            decoder.push(triple.a, triple.b, packet.time);
+                    }
+                }
+                const cues = decoder.drain();
+                if (cues.length === 0)
+                    return;
+                const VttCue = globalThis.VTTCue;
+                if (VttCue === undefined)
+                    return;
+                const target = ensureTrack();
+                for (const cue of cues) {
+                    target.addCue(new VttCue(cue.start, cue.end, cue.text));
+                }
+            });
+            return () => {
+                unregister();
+                if (track !== null) {
+                    empty(track);
+                    track.mode = 'disabled';
+                    track = null;
+                }
+            };
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/stages/text-cea608/index.js.map

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

package/dist/stages/text-webvtt/index.d.ts

@@ -0,0 +1,3 @@
+import type { Stage } from '../../types/stage.js';
+export default function textWebvtt(): Stage;
+//# sourceMappingURL=index.d.ts.map

package/dist/stages/text-webvtt/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/stages/text-webvtt/index.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAOlD,MAAM,CAAC,OAAO,UAAU,UAAU,IAAI,KAAK,CAgE1C"}

package/dist/stages/text-webvtt/index.js

@@ -0,0 +1,82 @@
+/**
+ * WebVTT as a stage: a parser for text/vtt and the text sink registration
+ * that makes text tracks selectable. Cues become native VTTCues through the
+ * kernel's TextTrackSink; the browser renders, styles, and exposes the
+ * caption UI, which is why this stage stays small.
+ *
+ * The stage also keeps the element's TextTrackList and the engine's text
+ * selection in step, both ways. Every text track exists natively from the
+ * manifest on, so the browser's caption menu lists all of them; the active
+ * one is `showing`, the rest `disabled`. A pick in that menu selects in the
+ * engine, and switching captions off there deselects.
+ */
+import { createTextTrackSink } from '../../kernel/sinks/text-track-sink.js';
+import { parseVtt } from './parse.js';
+function parseSegment(data, _meta) {
+    return parseVtt(new TextDecoder().decode(data)).cues;
+}
+export default function textWebvtt() {
+    return {
+        name: 'text-webvtt',
+        provides: ['text-webvtt', { contentType: 'text', mimeType: 'text/vtt' }],
+        requires: ['scheduler'],
+        install(ctx) {
+            const { element } = ctx;
+            // One sink per attach, built here rather than in the factory so the
+            // mirror below can declare tracks before any segment is fetched.
+            const sink = createTextTrackSink({ element, parse: parseSegment });
+            ctx.registerParser('text/vtt', parseSegment);
+            ctx.registerSink('text', () => sink);
+            function textTracks() {
+                const presentation = ctx.getState().presentation;
+                if (presentation === null)
+                    return [];
+                return presentation.periods.flatMap((period) => period.tracks.filter((track) => track.contentType === 'text'));
+            }
+            function activeId() {
+                return ctx.getState().tracks.active.get('text');
+            }
+            // Engine to element. A track no longer in the presentation (a new
+            // source on the same engine) is retired first, so its last cue does
+            // not outlive it on screen.
+            function mirror() {
+                const active = activeId();
+                const current = new Set(textTracks().map((track) => track.id));
+                for (const id of sink.trackIds()) {
+                    if (!current.has(id))
+                        sink.retire(id);
+                }
+                for (const track of textTracks()) {
+                    const native = sink.declare(track.id);
+                    const mode = track.id === active ? 'showing' : 'disabled';
+                    if (native.mode !== mode)
+                        native.mode = mode;
+                }
+            }
+            // Element to engine. Fires for the mirror's own writes too; those
+            // find the element already in step and dispatch nothing.
+            function onNativeChange() {
+                const active = activeId();
+                const showing = textTracks().find((track) => sink.nativeTrack(track.id)?.mode === 'showing');
+                if (showing !== undefined) {
+                    if (showing.id !== active)
+                        ctx.dispatch({ type: 'SELECT_TRACK', trackId: showing.id });
+                }
+                else if (active !== undefined) {
+                    ctx.dispatch({ type: 'DESELECT_TRACK', contentType: 'text' });
+                }
+            }
+            ctx.on('tracks:changed', mirror);
+            ctx.on('tracks:selected', (payload) => {
+                if (payload.contentType === 'text')
+                    mirror();
+            });
+            element.textTracks.addEventListener('change', onNativeChange);
+            return () => {
+                element.textTracks.removeEventListener('change', onNativeChange);
+                sink.dispose();
+            };
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/stages/text-webvtt/index.js.map

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

package/dist/stages/text-webvtt/parse.d.ts

@@ -0,0 +1,19 @@
+/**
+ * WebVTT into cue descriptors. Pure, plain-VTT only: the HLS X-TIMESTAMP-MAP
+ * header is a segmented-delivery concern that text-webvtt-segmented rewrites
+ * away as a byte transform before this parser ever sees the text.
+ *
+ * Malformed cues are skipped, never thrown: one bad cue must not cost the
+ * segment. Every cue carries a deterministic id so re-delivered segments
+ * dedup at the sink.
+ */
+import type { CueDescriptor } from '../../types/messages.js';
+/** `HH:MM:SS.mmm` or `MM:SS.mmm` to seconds, or null. */
+export declare function parseTimestamp(text: string): number | null;
+export interface VttParseResult {
+    readonly cues: readonly CueDescriptor[];
+    /** Cue blocks skipped as malformed; surfaced as a warning, never an error. */
+    readonly skipped: number;
+}
+export declare function parseVtt(text: string): VttParseResult;
+//# sourceMappingURL=parse.d.ts.map

package/dist/stages/text-webvtt/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/stages/text-webvtt/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK1D;AAWD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,CAAC;IACxC,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CA2CrD"}

package/dist/stages/text-webvtt/parse.js

@@ -0,0 +1,62 @@
+/** `HH:MM:SS.mmm` or `MM:SS.mmm` to seconds, or null. */
+export function parseTimestamp(text) {
+    const match = /^(?:(\d+):)?([0-5]\d):([0-5]\d)\.(\d{3})$/.exec(text.trim());
+    if (match === null)
+        return null;
+    const [, hours, minutes, seconds, millis] = match;
+    return Number(hours ?? 0) * 3600 + Number(minutes) * 60 + Number(seconds) + Number(millis) / 1000;
+}
+/** djb2 over the cue text; enough identity for dedup, not cryptography. */
+function hash(text) {
+    let value = 5381;
+    for (let i = 0; i < text.length; i += 1) {
+        value = ((value << 5) + value + text.charCodeAt(i)) >>> 0;
+    }
+    return value.toString(36);
+}
+export function parseVtt(text) {
+    // Strip a BOM; the signature check is on the first line proper.
+    const body = text.charCodeAt(0) === 0xfeff ? text.slice(1) : text;
+    if (!body.startsWith('WEBVTT'))
+        return { cues: [], skipped: 0 };
+    const cues = [];
+    let skipped = 0;
+    // Blocks separated by blank lines; the first block is the header.
+    const blocks = body.split(/\r?\n\r?\n/).slice(1);
+    for (const block of blocks) {
+        const lines = block.split(/\r?\n/).filter((line) => line !== '');
+        if (lines.length === 0)
+            continue;
+        const first = lines[0];
+        if (first.startsWith('NOTE') || first.startsWith('STYLE') || first.startsWith('REGION')) {
+            continue;
+        }
+        // An optional id line precedes the timing line.
+        const timingIndex = lines.findIndex((line) => line.includes('-->'));
+        if (timingIndex === -1 || timingIndex > 1) {
+            skipped += 1;
+            continue;
+        }
+        const id = timingIndex === 1 ? first : undefined;
+        const timing = lines[timingIndex];
+        const [startText, rest] = timing.split('-->');
+        const settingsMatch = (rest ?? '').trim().split(/\s+/);
+        const start = parseTimestamp(startText ?? '');
+        const end = parseTimestamp(settingsMatch[0] ?? '');
+        if (start === null || end === null || end <= start) {
+            skipped += 1;
+            continue;
+        }
+        const settings = settingsMatch.slice(1).join(' ');
+        const cueText = lines.slice(timingIndex + 1).join('\n');
+        cues.push({
+            id: id ?? `${Math.round(start * 1000)}-${Math.round(end * 1000)}-${hash(cueText)}`,
+            start,
+            end,
+            text: cueText,
+            ...(settings !== '' ? { settings } : {}),
+        });
+    }
+    return { cues, skipped };
+}
+//# sourceMappingURL=parse.js.map

package/dist/stages/text-webvtt/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../src/stages/text-webvtt/parse.ts"],"names":[],"mappings":"AAWA,yDAAyD;AACzD,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,KAAK,GAAG,2CAA2C,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5E,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;IAClD,OAAO,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;AACpG,CAAC;AAED,2EAA2E;AAC3E,SAAS,IAAI,CAAC,IAAY;IACxB,IAAI,KAAK,GAAG,IAAI,CAAC;IACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAC5B,CAAC;AAQD,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,gEAAgE;IAChE,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAEhE,MAAM,IAAI,GAAoB,EAAE,CAAC;IACjC,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,kEAAkE;IAClE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACjD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;QACjE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACjC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAW,CAAC;QACjC,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxF,SAAS;QACX,CAAC;QACD,gDAAgD;QAChD,MAAM,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QACpE,IAAI,WAAW,KAAK,CAAC,CAAC,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YAC1C,OAAO,IAAI,CAAC,CAAC;YACb,SAAS;QACX,CAAC;QACD,MAAM,EAAE,GAAG,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QACjD,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAAW,CAAC;QAC5C,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,aAAa,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,cAAc,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QAC9C,MAAM,GAAG,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACnD,IAAI,KAAK,KAAK,IAAI,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC;YACnD,OAAO,IAAI,CAAC,CAAC;YACb,SAAS;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,CAAC;YACR,EAAE,EAAE,EAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE;YAClF,KAAK;YACL,GAAG;YACH,IAAI,EAAE,OAAO;YACb,GAAG,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC3B,CAAC"}

package/dist/stages/text-webvtt-segmented/index.d.ts

@@ -0,0 +1,5 @@
+import type { Stage } from '../../types/stage.js';
+/** Applies the segment's X-TIMESTAMP-MAP to every cue timing, in text. */
+export declare function shiftTimestampMap(text: string): string;
+export default function textWebvttSegmented(): Stage;
+//# sourceMappingURL=index.d.ts.map

package/dist/stages/text-webvtt-segmented/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/stages/text-webvtt-segmented/index.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAqBlD,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBtD;AAQD,MAAM,CAAC,OAAO,UAAU,mBAAmB,IAAI,KAAK,CAmBnD"}

package/dist/stages/text-webvtt-segmented/index.js

@@ -0,0 +1,63 @@
+const MPEGTS_TIMESCALE = 90_000;
+function timestampToSeconds(text) {
+    const [rest, millis] = text.split('.');
+    const parts = (rest ?? '').split(':').map(Number);
+    const [h, m, s] = parts.length === 3 ? parts : [0, ...parts];
+    return (h ?? 0) * 3600 + (m ?? 0) * 60 + (s ?? 0) + Number(millis ?? 0) / 1000;
+}
+function secondsToTimestamp(seconds) {
+    const clamped = Math.max(0, seconds);
+    const h = Math.floor(clamped / 3600);
+    const m = Math.floor((clamped % 3600) / 60);
+    const s = Math.floor(clamped % 60);
+    const ms = Math.round((clamped - Math.floor(clamped)) * 1000);
+    const pad = (value, width) => String(value).padStart(width, '0');
+    return `${pad(h, 2)}:${pad(m, 2)}:${pad(s, 2)}.${pad(ms, 3)}`;
+}
+/** Applies the segment's X-TIMESTAMP-MAP to every cue timing, in text. */
+export function shiftTimestampMap(text) {
+    const header = /X-TIMESTAMP-MAP=([^\r\n]+)/.exec(text);
+    if (header === null)
+        return text;
+    let local = 0;
+    let mpegts = 0;
+    for (const part of header[1].split(',')) {
+        const [key, value] = splitOnce(part.trim());
+        if (key === 'LOCAL')
+            local = timestampToSeconds(value);
+        if (key === 'MPEGTS')
+            mpegts = Number(value);
+    }
+    const offset = mpegts / MPEGTS_TIMESCALE - local;
+    const stripped = text.replace(/X-TIMESTAMP-MAP=[^\r\n]*\r?\n?/, '');
+    return stripped.replace(/((?:\d+:)?[0-5]\d:[0-5]\d\.\d{3})(\s+-->\s+)((?:\d+:)?[0-5]\d:[0-5]\d\.\d{3})/g, (_, start, arrow, end) => `${secondsToTimestamp(timestampToSeconds(start) + offset)}${arrow}${secondsToTimestamp(timestampToSeconds(end) + offset)}`);
+}
+function splitOnce(part) {
+    const index = part.indexOf(':');
+    if (index === -1)
+        return [part, ''];
+    return [part.slice(0, index), part.slice(index + 1)];
+}
+export default function textWebvttSegmented() {
+    return {
+        name: 'text-webvtt-segmented',
+        provides: ['text-webvtt-segmented'],
+        requires: ['text-webvtt'],
+        install(ctx) {
+            ctx.registerTransform({
+                name: 'vtt-timestamp-map',
+                // Early: decrypt-class steps use lower orders, parsing happens last.
+                order: 50,
+                transform(data, meta) {
+                    if (meta.contentType !== 'text')
+                        return data;
+                    const text = new TextDecoder().decode(data);
+                    if (!text.includes('X-TIMESTAMP-MAP'))
+                        return data;
+                    return new TextEncoder().encode(shiftTimestampMap(text));
+                },
+            });
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/stages/text-webvtt-segmented/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/stages/text-webvtt-segmented/index.ts"],"names":[],"mappings":"AAWA,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEhC,SAAS,kBAAkB,CAAC,IAAY;IACtC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC;IAC7D,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;AACjF,CAAC;AAED,SAAS,kBAAkB,CAAC,OAAe;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACrC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACrC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC5C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACnC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9D,MAAM,GAAG,GAAG,CAAC,KAAa,EAAE,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACjF,OAAO,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;AAChE,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,MAAM,GAAG,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,IAAI,IAAK,MAAM,CAAC,CAAC,CAAY,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACpD,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5C,IAAI,GAAG,KAAK,OAAO;YAAE,KAAK,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACvD,IAAI,GAAG,KAAK,QAAQ;YAAE,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,GAAG,gBAAgB,GAAG,KAAK,CAAC;IACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,gCAAgC,EAAE,EAAE,CAAC,CAAC;IACpE,OAAO,QAAQ,CAAC,OAAO,CACrB,gFAAgF,EAChF,CAAC,CAAC,EAAE,KAAa,EAAE,KAAa,EAAE,GAAW,EAAE,EAAE,CAC/C,GAAG,kBAAkB,CAAC,kBAAkB,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,GAAG,KAAK,GAAG,kBAAkB,CACpF,kBAAkB,CAAC,GAAG,CAAC,GAAG,MAAM,CACjC,EAAE,CACN,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACpC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,CAAC,OAAO,UAAU,mBAAmB;IACzC,OAAO;QACL,IAAI,EAAE,uBAAuB;QAC7B,QAAQ,EAAE,CAAC,uBAAuB,CAAC;QACnC,QAAQ,EAAE,CAAC,aAAa,CAAC;QACzB,OAAO,CAAC,GAAG;YACT,GAAG,CAAC,iBAAiB,CAAC;gBACpB,IAAI,EAAE,mBAAmB;gBACzB,qEAAqE;gBACrE,KAAK,EAAE,EAAE;gBACT,SAAS,CAAC,IAAgB,EAAE,IAAiB;oBAC3C,IAAI,IAAI,CAAC,WAAW,KAAK,MAAM;wBAAE,OAAO,IAAI,CAAC;oBAC7C,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBAC5C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC;wBAAE,OAAO,IAAI,CAAC;oBACnD,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC3D,CAAC;aACF,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/stages/thumbnails/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Thumbnails: the trick-play images a scrubbing UI shows. The common shape is
+ * a WebVTT track whose cues point at sprite-sheet tiles with an #xywh media
+ * fragment. This stage parses such a track and answers "which tile covers this
+ * time" through `engine.thumbnails`. It fetches through the transport seam, so
+ * request hooks (auth, cmcd, steering) apply to the thumbnail track too.
+ *
+ * It does not auto-discover the track from the manifest; HLS image playlists
+ * are a separate parse. The app points it at a track URL, which is what the
+ * playground does.
+ */
+import type { Stage } from '../../types/stage.js';
+/** One thumbnail: the tile's image URL and its rectangle within the sprite. */
+export interface Thumbnail {
+    readonly url: string;
+    readonly start: number;
+    readonly end: number;
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+/** Parses a WebVTT thumbnail track into tiles, resolving URLs against a base. */
+export declare function parseThumbnailTrack(text: string, baseUrl: string): Thumbnail[];
+export interface ThumbnailsApi {
+    /** Fetches and parses a WebVTT thumbnail track at a URL. */
+    load(url: string): Promise<number>;
+    /** The tile covering a presentation time, or null. */
+    at(time: number): Thumbnail | null;
+    /** Every parsed tile, in order. */
+    readonly all: readonly Thumbnail[];
+}
+export default function thumbnails(): Stage;
+//# sourceMappingURL=index.d.ts.map

package/dist/stages/thumbnails/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/stages/thumbnails/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAElD,+EAA+E;AAC/E,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAQD,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAwB9E;AAED,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,sDAAsD;IACtD,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IACnC,mCAAmC;IACnC,QAAQ,CAAC,GAAG,EAAE,SAAS,SAAS,EAAE,CAAC;CACpC;AAED,MAAM,CAAC,OAAO,UAAU,UAAU,IAAI,KAAK,CAwB1C"}

package/dist/stages/thumbnails/index.js

@@ -0,0 +1,58 @@
+function timestamp(text) {
+    const parts = text.trim().split(':').map(Number);
+    const [h, m, s] = parts.length === 3 ? parts : [0, ...parts];
+    return (h ?? 0) * 3600 + (m ?? 0) * 60 + (s ?? 0);
+}
+/** Parses a WebVTT thumbnail track into tiles, resolving URLs against a base. */
+export function parseThumbnailTrack(text, baseUrl) {
+    const thumbnails = [];
+    const blocks = text.replace(/\r/g, '').split('\n\n');
+    for (const block of blocks) {
+        const lines = block.split('\n').filter((line) => line !== '');
+        const timing = lines.find((line) => line.includes('-->'));
+        const target = lines.find((line) => !line.includes('-->') && line !== 'WEBVTT' && line !== '');
+        if (timing === undefined || target === undefined)
+            continue;
+        const [from, to] = timing.split('-->');
+        const start = timestamp(from ?? '');
+        const end = timestamp(to ?? '');
+        const [rawUrl, fragment] = target.split('#');
+        const url = new URL(rawUrl ?? '', baseUrl).href;
+        let [x, y, width, height] = [0, 0, 0, 0];
+        const xywh = /xywh=(?:pixel:)?(\d+),(\d+),(\d+),(\d+)/.exec(fragment ?? '');
+        if (xywh !== null) {
+            x = Number(xywh[1]);
+            y = Number(xywh[2]);
+            width = Number(xywh[3]);
+            height = Number(xywh[4]);
+        }
+        thumbnails.push({ url, start, end, x, y, width, height });
+    }
+    return thumbnails;
+}
+export default function thumbnails() {
+    return {
+        name: 'thumbnails',
+        provides: ['thumbnails'],
+        requires: ['transport'],
+        install(ctx) {
+            let tiles = [];
+            const api = {
+                async load(url) {
+                    const response = await ctx.request(url, { method: 'GET' });
+                    const text = await response.text();
+                    tiles = parseThumbnailTrack(text, url);
+                    return tiles.length;
+                },
+                at(time) {
+                    return tiles.find((tile) => time >= tile.start && time < tile.end) ?? null;
+                },
+                get all() {
+                    return tiles;
+                },
+            };
+            ctx.registerNamespace('thumbnails', api);
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/stages/thumbnails/index.js.map

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

package/dist/types/error.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The error taxonomy. The native MediaError has four codes; this is the real
+ * one. This module imports nothing so that messages can carry errors without
+ * a dependency cycle.
+ */
+export type ErrorCategory = 'network' | 'manifest' | 'media' | 'drm' | 'config' | 'internal';
+export type NetworkErrorCode = 'NETWORK_FAILED' | 'NETWORK_TIMEOUT' | 'NETWORK_HTTP_STATUS' | 'NETWORK_ABORTED';
+export type ManifestErrorCode = 'MANIFEST_PARSE_FAILED' | 'MANIFEST_UNSUPPORTED' | 'MANIFEST_EMPTY' | 'MANIFEST_REFRESH_FAILED';
+export type MediaErrorCode = 'MEDIA_APPEND_FAILED' | 'MEDIA_CONTAINER_INVALID' | 'MEDIA_QUOTA_EXCEEDED' | 'MEDIA_CODEC_UNSUPPORTED' | 'MEDIA_DECODE_ERROR' | 'MEDIA_SOURCE_CLOSED';
+export type DrmErrorCode = 'DRM_KEY_SYSTEM_UNAVAILABLE' | 'DRM_LICENSE_FAILED' | 'DRM_KEY_EXPIRED' | 'DRM_KEY_STATUS_ERROR' | 'DRM_OUTPUT_RESTRICTED' | 'DRM_SESSION_FAILED' | 'DRM_INIT_DATA_INVALID';
+export type ConfigErrorCode = 'CONFIG_INVALID' | 'CONFIG_STAGE_REQUIREMENT_MISSING' | 'CONFIG_ELEMENT_OCCUPIED';
+export type InternalErrorCode = 'INTERNAL_ASSERTION';
+export type ErrorCode = NetworkErrorCode | ManifestErrorCode | MediaErrorCode | DrmErrorCode | ConfigErrorCode | InternalErrorCode;
+/**
+ * A Mattebox error. Plain data, not an Error subclass, so it can travel in
+ * facts and in the trace.
+ */
+export interface MatteboxError {
+    readonly category: ErrorCategory;
+    readonly code: ErrorCode;
+    readonly fatal: boolean;
+    /** Whether the `recovery` stage could act on it. */
+    readonly recoverable: boolean;
+    readonly cause?: unknown;
+    readonly context?: Readonly<Record<string, unknown>>;
+    /**
+     * The diagnostic ring buffer, attached when a fatal error surfaces.
+     * Typed loosely here because TraceEntry lives above this module in the
+     * type graph; `TracedError` in kernel.ts is the precise shape.
+     */
+    readonly trace?: readonly unknown[];
+}
+//# sourceMappingURL=error.d.ts.map

package/dist/types/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/types/error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE7F,MAAM,MAAM,gBAAgB,GACxB,gBAAgB,GAChB,iBAAiB,GACjB,qBAAqB,GACrB,iBAAiB,CAAC;AAEtB,MAAM,MAAM,iBAAiB,GACzB,uBAAuB,GACvB,sBAAsB,GACtB,gBAAgB,GAChB,yBAAyB,CAAC;AAE9B,MAAM,MAAM,cAAc,GACtB,qBAAqB,GACrB,yBAAyB,GACzB,sBAAsB,GACtB,yBAAyB,GACzB,oBAAoB,GACpB,qBAAqB,CAAC;AAE1B,MAAM,MAAM,YAAY,GACpB,4BAA4B,GAC5B,oBAAoB,GACpB,iBAAiB,GACjB,sBAAsB,GACtB,uBAAuB,GACvB,oBAAoB,GACpB,uBAAuB,CAAC;AAE5B,MAAM,MAAM,eAAe,GACvB,gBAAgB,GAChB,kCAAkC,GAClC,yBAAyB,CAAC;AAE9B,MAAM,MAAM,iBAAiB,GAAG,oBAAoB,CAAC;AAErD,MAAM,MAAM,SAAS,GACjB,gBAAgB,GAChB,iBAAiB,GACjB,cAAc,GACd,YAAY,GACZ,eAAe,GACf,iBAAiB,CAAC;AAEtB;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,oDAAoD;IACpD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CACrC"}

package/dist/types/error.js

@@ -0,0 +1,7 @@
+/**
+ * The error taxonomy. The native MediaError has four codes; this is the real
+ * one. This module imports nothing so that messages can carry errors without
+ * a dependency cycle.
+ */
+export {};
+//# sourceMappingURL=error.js.map

package/dist/types/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/types/error.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/types/facade.d.ts

@@ -0,0 +1,104 @@
+/**
+ * The facade: flat and namespaced. Stages extend it by registering
+ * namespaces, never by assigning onto it. The engine never shadows a
+ * standard HTMLMediaElement member; `media` hands back the element itself.
+ */
+import type { ContentType, Track, TrackId } from './ir.js';
+import type { KernelConfig, KernelState, TracedError, TraceEntry } from './kernel.js';
+import type { Command } from './messages.js';
+import type { QualityApi } from './quality.js';
+import type { Listener, Stage, TransportRequestDraftView, Unsubscribe } from './stage.js';
+/**
+ * Generic track enumeration and selection. Chromium never shipped
+ * AudioTrackList, so the engine owns the list and mirrors into native
+ * where present.
+ */
+export interface TracksApi {
+    readonly available: readonly Track[];
+    active(contentType: ContentType): Track | null;
+    select(trackId: TrackId): void;
+    /** Stops a cue pipeline and clears its cues. Valid for text and metadata; video and audio always keep a selection. */
+    deselect(contentType: ContentType): void;
+}
+export interface StatsApi {
+    /** Exponentially weighted moving average of measured throughput, in bits per second. */
+    readonly throughput: number;
+    /** The diagnostic ring buffer, oldest first. Include it in every error report. */
+    trace(): readonly TraceEntry[];
+    /** The current kernel state, read-only. Diagnosability surface: the playground's panels draw from it. */
+    snapshot(): Readonly<KernelState>;
+}
+/** The mutable request draft transport hooks receive. Structural twin of the transport module's type. */
+export type { TransportRequestDraftView } from './stage.js';
+export interface TransportResponseView {
+    readonly token: string;
+    readonly url: string;
+    readonly status: number | null;
+    readonly rtt: number;
+    readonly size: number;
+    readonly outcome: 'success' | 'failure' | 'timeout';
+    readonly attempt: number;
+}
+/** Network-layer configuration: hooks and overrides the transport applies. */
+export interface TransportConfig {
+    readonly retry?: {
+        readonly maxAttempts?: number;
+        readonly baseDelayMs?: number;
+        readonly factor?: number;
+        readonly maxDelayMs?: number;
+        readonly retryStatuses?: readonly number[];
+    };
+    /** Replaces the network entirely: the fault-injection point. */
+    readonly fetchImpl?: (url: string, init: RequestInit) => Promise<Response>;
+    readonly requestHooks?: ReadonlyArray<(req: TransportRequestDraftView) => void>;
+    readonly responseHooks?: ReadonlyArray<(res: TransportResponseView) => void>;
+}
+export interface LoadOptions {
+    /**
+     * The manifest's MIME type, when the caller knows it. Authoritative: a
+     * type no composed adapter accepts fails the load before any fetch with
+     * MANIFEST_UNSUPPORTED, and an accepted type routes the bytes to that
+     * adapter without sniffing. Omitted, the adapters sniff the bytes.
+     */
+    readonly mimeType?: string;
+}
+export interface MatteboxOptions {
+    /** Stage factories to install, in order. Omitted means kernel only, which is a complete working player. */
+    readonly stages?: readonly Stage[];
+    /** Kernel tuning overrides. Every knob has a default. */
+    readonly config?: Partial<KernelConfig>;
+    /** Network hooks and overrides: cmcd, content steering, fault injection. */
+    readonly transport?: TransportConfig;
+}
+/**
+ * The kernel-owned facade surface. Namespaces contributed by stages
+ * ('live', 'drm', 'thumbnails', ...) are absent unless the stage is loaded;
+ * `'live' in engine` is the feature test. See `Mattebox` in the package
+ * entry, which layers the merged namespaces on top of this.
+ */
+export interface MatteboxBase {
+    /** The attached element, unwrapped, or null before attach. */
+    readonly media: HTMLMediaElement | null;
+    readonly quality: QualityApi;
+    readonly tracks: TracksApi;
+    readonly stats: StatsApi;
+    /** The last fatal error, with the trace attached, or null. */
+    readonly error: TracedError | null;
+    attach(el: HTMLMediaElement): Promise<void>;
+    /** Idempotent and safe to call from an error state. */
+    detach(): Promise<void>;
+    load(url: string, options?: LoadOptions): void;
+    unload(): void;
+    dispatch(cmd: Command): void;
+    /** Every capability the loaded stages provide. */
+    capabilities(): Iterable<string>;
+    /**
+     * Whether a composed adapter parses manifests of this MIME type. Case and
+     * parameters are ignored. Pair it with the element's own `canPlayType`
+     * to route a source between the engine and native playback; the engine
+     * never sets `src` itself.
+     */
+    accepts(mimeType: string): boolean;
+    on(event: string, fn: Listener): Unsubscribe;
+}
+//# sourceMappingURL=facade.d.ts.map

package/dist/types/facade.d.ts.map

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