mattebox 0.1.0

package/dist/kernel/timeline.js

@@ -0,0 +1,203 @@
+function isIndexed(addressing) {
+    return !Array.isArray(addressing) && addressing.kind === 'indexed';
+}
+/**
+ * An on-demand addressing whose index box has not been fetched yet: it
+ * carries no resolvable segments. Once the adapter parses the index it swaps
+ * this for an explicit array, so every consumer treats it as empty until then.
+ */
+function isUnresolved(addressing) {
+    return !Array.isArray(addressing) && addressing.kind === 'sidx';
+}
+/**
+ * Epochs for one rendition timeline across periods. A period boundary opens
+ * an epoch; inside a period, every segment flagged `discontinuity` opens
+ * another. One code path for both.
+ */
+export function buildEpochs(parts) {
+    const epochs = [];
+    for (const { period, rendition } of parts) {
+        const addressing = rendition.segments;
+        if (isIndexed(addressing)) {
+            const pto = (addressing.presentationTimeOffset ?? 0) / addressing.timescale;
+            epochs.push({
+                periodId: period.id,
+                firstSeq: addressing.startSeq,
+                presentationStart: period.start,
+                mediaStart: pto,
+            });
+            continue;
+        }
+        if (isUnresolved(addressing))
+            continue;
+        let open = false;
+        for (const segment of addressing) {
+            if (!open || segment.discontinuity === true) {
+                // A period-opening list that begins mid-timeline is a window into
+                // a longer stream (a live sliding window): media time is assumed
+                // continuous, so the offset is zero. A discontinuity restarts the
+                // media clock. tfdt reconciliation corrects both guesses with the
+                // bytes' truth once wired.
+                const mediaStart = open ? 0 : segment.start - period.start;
+                epochs.push({
+                    periodId: period.id,
+                    firstSeq: segment.seq,
+                    presentationStart: segment.start,
+                    mediaStart,
+                });
+                open = true;
+            }
+        }
+    }
+    return epochs;
+}
+/** The epoch a sequence number belongs to, or null before the first epoch. */
+export function epochForSeq(epochs, seq) {
+    let match = null;
+    for (const epoch of epochs) {
+        if (epoch.firstSeq <= seq)
+            match = epoch;
+    }
+    return match;
+}
+/** The timestampOffset an append from this epoch requires. */
+export function timestampOffsetFor(epoch) {
+    return epoch.presentationStart - epoch.mediaStart;
+}
+export function mediaToPresentation(mediaTime, epoch) {
+    return mediaTime - epoch.mediaStart + epoch.presentationStart;
+}
+export function presentationToMedia(presentationTime, epoch) {
+    return presentationTime - epoch.presentationStart + epoch.mediaStart;
+}
+/**
+ * Corrects an epoch with a real baseMediaDecodeTime once mp4-box can read
+ * tfdt (Stage 07). Interface only for now: manifests promise timing, the
+ * bytes tell the truth.
+ */
+export function reconcileTfdt(epoch, baseMediaDecodeTime, timescale) {
+    return { ...epoch, mediaStart: baseMediaDecodeTime / timescale };
+}
+/** Materializes one segment from an indexed form. Null outside the window. */
+export function segmentAt(addressing, seq, periodStart = 0) {
+    if (!isIndexed(addressing)) {
+        if (isUnresolved(addressing))
+            return null;
+        return addressing.find((segment) => segment.seq === seq) ?? null;
+    }
+    if (seq < addressing.startSeq)
+        return null;
+    if (addressing.endSeq !== null && seq > addressing.endSeq)
+        return null;
+    const { timescale } = addressing;
+    const pto = addressing.presentationTimeOffset ?? 0;
+    let startUnits;
+    let durationUnits;
+    if (addressing.timeline !== null) {
+        let cursor = addressing.startSeq;
+        let found = null;
+        for (const run of addressing.timeline) {
+            if (seq < cursor + run.count) {
+                found = { start: run.start + (seq - cursor) * run.duration, duration: run.duration };
+                break;
+            }
+            cursor += run.count;
+        }
+        if (found === null)
+            return null;
+        startUnits = found.start;
+        durationUnits = found.duration;
+    }
+    else if (addressing.segmentDuration !== null) {
+        // Media time starts at the offset: the period's first segment carries
+        // it, so $Time$ expands with it and the subtraction below lands at the
+        // period start, not before it.
+        durationUnits = addressing.segmentDuration;
+        startUnits = pto + (seq - addressing.startSeq) * durationUnits;
+    }
+    else {
+        return null;
+    }
+    // $Number$ and $Time$, with the ISO/IEC 23009-1 %0<width>d format tag,
+    // then $$ unescaped last.
+    const url = addressing.urlTemplate
+        .replace(/\$(Number|Time)(?:%0(\d+)d)?\$/g, (_, name, width) => {
+        const text = String(name === 'Number' ? seq : startUnits);
+        return width === undefined ? text : text.padStart(Number(width), '0');
+    })
+        .replaceAll('$$', '$');
+    return {
+        seq,
+        start: periodStart + (startUnits - pto) / timescale,
+        duration: durationUnits / timescale,
+        url,
+    };
+}
+/** The first segment whose interval contains or follows `time`, or null past the end. */
+export function segmentAtTime(addressing, time, periodStart = 0) {
+    if (!isIndexed(addressing)) {
+        if (isUnresolved(addressing))
+            return null;
+        for (const segment of addressing) {
+            if (segment.start + segment.duration > time)
+                return segment;
+        }
+        return null;
+    }
+    // Constant-duration templates index directly; timelines scan their runs.
+    if (addressing.timeline === null && addressing.segmentDuration !== null) {
+        const dur = addressing.segmentDuration / addressing.timescale;
+        const relative = Math.max(0, time - periodStart);
+        const seq = addressing.startSeq + Math.floor(relative / dur);
+        return segmentAt(addressing, Math.max(seq, addressing.startSeq), periodStart);
+    }
+    let seq = addressing.startSeq;
+    const last = addressing.endSeq;
+    while (last === null || seq <= last) {
+        const segment = segmentAt(addressing, seq, periodStart);
+        if (segment === null)
+            return null;
+        if (segment.start + segment.duration > time)
+            return segment;
+        seq += 1;
+    }
+    return null;
+}
+/**
+ * The seekable window. VOD: zero to the announced or derivable duration.
+ * Live: the sliding window ending at the supplied edge; the kernel never
+ * computes the edge itself.
+ */
+export function seekableWindow(presentation, liveEdge) {
+    if (!presentation.isLive) {
+        if (presentation.duration !== undefined)
+            return { start: 0, end: presentation.duration };
+        let end = 0;
+        for (const period of presentation.periods) {
+            if (period.duration !== undefined)
+                end = Math.max(end, period.start + period.duration);
+        }
+        return { start: 0, end };
+    }
+    const edge = liveEdge ?? 0;
+    let windowStart = edge;
+    for (const period of presentation.periods) {
+        for (const track of period.tracks) {
+            for (const rendition of track.renditions) {
+                const addressing = rendition.segments;
+                if (isIndexed(addressing)) {
+                    const first = segmentAt(addressing, addressing.startSeq, period.start);
+                    if (first !== null)
+                        windowStart = Math.min(windowStart, first.start);
+                }
+                else if (!isUnresolved(addressing)) {
+                    const first = addressing[0];
+                    if (first !== undefined)
+                        windowStart = Math.min(windowStart, first.start);
+                }
+            }
+        }
+    }
+    return { start: Math.min(windowStart, edge), end: edge };
+}
+//# sourceMappingURL=timeline.js.map

package/dist/kernel/timeline.js.map

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

package/dist/kernel/trace.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The diagnostic ring buffer and its tooling. Because the reducer is pure, a
+ * recorded trace replays into a fresh reducer and must reproduce the same
+ * effects. That turns a production stall into a deterministic regression
+ * test.
+ */
+import type { KernelState, Reducer, TraceEntry } from '../types/kernel.js';
+import type { Effect } from '../types/messages.js';
+export declare const DEFAULT_TRACE_CAPACITY = 500;
+export interface TraceBuffer {
+    push(entry: TraceEntry): void;
+    /** Entries oldest first. */
+    snapshot(): readonly TraceEntry[];
+    readonly capacity: number;
+}
+/** Fixed capacity, overwriting. Roughly 200 bytes of code for the whole payoff. */
+export declare function createTraceBuffer(capacity?: number): TraceBuffer;
+/**
+ * A cheap, stable hash of the state slices that matter for divergence
+ * detection. Stable across runs: it depends only on the state.
+ */
+export declare function digest(state: KernelState): string;
+/**
+ * JSON for a bug report. Byte payloads are reduced to their length and
+ * non-plain objects to their constructor name; the shape of the
+ * interleaving is what matters, not the media bytes.
+ */
+export declare function exportTrace(entries: readonly TraceEntry[]): string;
+export interface ReplayResult {
+    readonly ok: boolean;
+    /** Index of the first diverging entry, when not ok. */
+    readonly divergedAt?: number;
+    readonly expected?: readonly Effect[];
+    readonly actual?: readonly Effect[];
+}
+/**
+ * Feeds a recorded message sequence into a fresh reducer and checks that the
+ * same effects come out. The reducer must be built with the same slices as
+ * the one that produced the trace.
+ */
+export declare function replay(entries: readonly TraceEntry[], reducer: Reducer, initial: KernelState): ReplayResult;
+//# sourceMappingURL=trace.d.ts.map

package/dist/kernel/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/kernel/trace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,4BAA4B;IAC5B,QAAQ,IAAI,SAAS,UAAU,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,QAAQ,GAAE,MAA+B,GAAG,WAAW,CAiBxF;AAiDD;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAkBjD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CAgBlE;AA8BD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,uDAAuD;IACvD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CACpB,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,WAAW,GACnB,YAAY,CAYd"}

package/dist/kernel/trace.js

@@ -0,0 +1,165 @@
+export const DEFAULT_TRACE_CAPACITY = 500;
+/** Fixed capacity, overwriting. Roughly 200 bytes of code for the whole payoff. */
+export function createTraceBuffer(capacity = DEFAULT_TRACE_CAPACITY) {
+    const entries = [];
+    let head = 0;
+    return {
+        capacity,
+        push(entry) {
+            if (entries.length < capacity) {
+                entries.push(entry);
+            }
+            else {
+                entries[head] = entry;
+                head = (head + 1) % capacity;
+            }
+        },
+        snapshot() {
+            return [...entries.slice(head), ...entries.slice(0, head)];
+        },
+    };
+}
+function isPlainObject(value) {
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+/**
+ * Deterministic serialization for hashing: sorted object keys, sorted Map
+ * entries, opaque values tagged by constructor name. Not a wire format.
+ */
+function stableStringify(value) {
+    if (value === null || typeof value === 'number' || typeof value === 'boolean') {
+        return String(value);
+    }
+    if (typeof value === 'string')
+        return JSON.stringify(value);
+    if (value === undefined)
+        return 'undefined';
+    if (typeof value === 'function')
+        return '[function]';
+    if (Array.isArray(value)) {
+        return `[${value.map(stableStringify).join(',')}]`;
+    }
+    if (value instanceof Map) {
+        const parts = [...value.entries()]
+            .map(([k, v]) => `${stableStringify(k)}:${stableStringify(v)}`)
+            .sort();
+        return `Map{${parts.join(',')}}`;
+    }
+    if (value instanceof ArrayBuffer)
+        return `ArrayBuffer(${value.byteLength})`;
+    if (ArrayBuffer.isView(value))
+        return `${value.constructor.name}(${value.byteLength})`;
+    if (typeof value === 'object') {
+        if (!isPlainObject(value))
+            return `[${value.constructor?.name ?? 'opaque'}]`;
+        const parts = Object.keys(value)
+            .sort()
+            .map((k) => `${JSON.stringify(k)}:${stableStringify(value[k])}`);
+        return `{${parts.join(',')}}`;
+    }
+    return String(value);
+}
+/** 32-bit FNV-1a over a string, as fixed-width hex. */
+function fnv1a(input) {
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < input.length; i += 1) {
+        hash ^= input.charCodeAt(i);
+        hash = Math.imul(hash, 0x01000193) >>> 0;
+    }
+    return hash.toString(16).padStart(8, '0');
+}
+/**
+ * A cheap, stable hash of the state slices that matter for divergence
+ * detection. Stable across runs: it depends only on the state.
+ */
+export function digest(state) {
+    return fnv1a(stableStringify({
+        phase: state.lifecycle.phase,
+        presentation: state.presentation?.id ?? null,
+        inflight: [...state.scheduling.inflight.keys()].sort(),
+        bufferGoal: state.scheduling.bufferGoal,
+        tokenSeq: state.scheduling.tokenSeq,
+        buffers: state.buffers,
+        tracks: state.tracks.active,
+        quality: {
+            pinned: state.quality.pinned,
+            active: state.quality.active,
+            constraints: [...state.quality.constraints.keys()].sort(),
+        },
+        currentTime: state.playback.currentTime,
+    }));
+}
+/**
+ * JSON for a bug report. Byte payloads are reduced to their length and
+ * non-plain objects to their constructor name; the shape of the
+ * interleaving is what matters, not the media bytes.
+ */
+export function exportTrace(entries) {
+    return JSON.stringify(entries, (_key, value) => {
+        if (value instanceof ArrayBuffer)
+            return { $bytes: value.byteLength };
+        if (ArrayBuffer.isView(value))
+            return { $bytes: value.byteLength };
+        if (value instanceof Map)
+            return Object.fromEntries(value);
+        if (typeof value === 'function')
+            return { $opaque: 'function' };
+        if (typeof value === 'object' &&
+            value !== null &&
+            !Array.isArray(value) &&
+            !isPlainObject(value)) {
+            return { $opaque: value.constructor?.name ?? 'object' };
+        }
+        return value;
+    });
+}
+function buffersEqual(a, b) {
+    if (a.byteLength !== b.byteLength)
+        return false;
+    const va = new Uint8Array(a);
+    const vb = new Uint8Array(b);
+    for (let i = 0; i < va.length; i += 1) {
+        if (va[i] !== vb[i])
+            return false;
+    }
+    return true;
+}
+/** Structural equality over effect payloads: plain data plus ArrayBuffer. */
+function deepEqual(a, b) {
+    if (Object.is(a, b))
+        return true;
+    if (a instanceof ArrayBuffer && b instanceof ArrayBuffer)
+        return buffersEqual(a, b);
+    if (Array.isArray(a) && Array.isArray(b)) {
+        return a.length === b.length && a.every((item, i) => deepEqual(item, b[i]));
+    }
+    if (typeof a === 'object' && typeof b === 'object' && a !== null && b !== null) {
+        const ka = Object.keys(a);
+        const kb = Object.keys(b);
+        if (ka.length !== kb.length)
+            return false;
+        return ka.every((k) => deepEqual(a[k], b[k]));
+    }
+    return false;
+}
+/**
+ * Feeds a recorded message sequence into a fresh reducer and checks that the
+ * same effects come out. The reducer must be built with the same slices as
+ * the one that produced the trace.
+ */
+export function replay(entries, reducer, initial) {
+    let state = initial;
+    for (let i = 0; i < entries.length; i += 1) {
+        const entry = entries[i];
+        if (entry === undefined)
+            continue;
+        const [next, effects] = reducer(state, entry.msg);
+        if (!deepEqual(effects, entry.effects)) {
+            return { ok: false, divergedAt: i, expected: entry.effects, actual: effects };
+        }
+        state = next;
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=trace.js.map

package/dist/kernel/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../src/kernel/trace.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAS1C,mFAAmF;AACnF,MAAM,UAAU,iBAAiB,CAAC,WAAmB,sBAAsB;IACzE,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,OAAO;QACL,QAAQ;QACR,IAAI,CAAC,KAAK;YACR,IAAI,OAAO,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;gBAC9B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;gBACtB,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC;YAC/B,CAAC;QACH,CAAC;QACD,QAAQ;YACN,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QAC7D,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC3C,OAAO,KAAK,KAAK,MAAM,CAAC,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC9E,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC5D,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IAC5C,IAAI,OAAO,KAAK,KAAK,UAAU;QAAE,OAAO,YAAY,CAAC;IACrD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACrD,CAAC;IACD,IAAI,KAAK,YAAY,GAAG,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;aAC/B,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9D,IAAI,EAAE,CAAC;QACV,OAAO,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACnC,CAAC;IACD,IAAI,KAAK,YAAY,WAAW;QAAE,OAAO,eAAe,KAAK,CAAC,UAAU,GAAG,CAAC;IAC5E,IAAI,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,IAAI,KAAK,CAAC,UAAU,GAAG,CAAC;IACvF,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,IAAI,QAAQ,GAAG,CAAC;QAC7E,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;aAC7B,IAAI,EAAE;aACN,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,eAAe,CAAE,KAAiC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAChG,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAChC,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,uDAAuD;AACvD,SAAS,KAAK,CAAC,KAAa;IAC1B,IAAI,IAAI,GAAG,UAAU,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,IAAI,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,KAAkB;IACvC,OAAO,KAAK,CACV,eAAe,CAAC;QACd,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK;QAC5B,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,EAAE,IAAI,IAAI;QAC5C,QAAQ,EAAE,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;QACtD,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,UAAU;QACvC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,QAAQ;QACnC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;QAC3B,OAAO,EAAE;YACP,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM;YAC5B,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM;YAC5B,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;SAC1D;QACD,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,WAAW;KACxC,CAAC,CACH,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,OAA8B;IACxD,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,KAAc,EAAE,EAAE;QACtD,IAAI,KAAK,YAAY,WAAW;YAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC;QACtE,IAAI,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC;QACnE,IAAI,KAAK,YAAY,GAAG;YAAE,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC3D,IAAI,OAAO,KAAK,KAAK,UAAU;YAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;QAChE,IACE,OAAO,KAAK,KAAK,QAAQ;YACzB,KAAK,KAAK,IAAI;YACd,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YACrB,CAAC,aAAa,CAAC,KAAK,CAAC,EACrB,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,WAAW,EAAE,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC1D,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,YAAY,CAAC,CAAc,EAAE,CAAc;IAClD,IAAI,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAChD,MAAM,EAAE,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAC7B,MAAM,EAAE,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IACpC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6EAA6E;AAC7E,SAAS,SAAS,CAAC,CAAU,EAAE,CAAU;IACvC,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,CAAC,YAAY,WAAW,IAAI,CAAC,YAAY,WAAW;QAAE,OAAO,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACpF,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAC/E,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,EAAE,CAAC,MAAM,KAAK,EAAE,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAC1C,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CACpB,SAAS,CAAE,CAA6B,CAAC,CAAC,CAAC,EAAG,CAA6B,CAAC,CAAC,CAAC,CAAC,CAChF,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAUD;;;;GAIG;AACH,MAAM,UAAU,MAAM,CACpB,OAA8B,EAC9B,OAAgB,EAChB,OAAoB;IAEpB,IAAI,KAAK,GAAG,OAAO,CAAC;IACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QAClD,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACvC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAChF,CAAC;QACD,KAAK,GAAG,IAAI,CAAC;IACf,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC"}

package/dist/kernel/track-registry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Generic track enumeration and selection, the engine.tracks surface.
+ * Tracks whose content type has no registered sink are enumerated but not
+ * selectable: that is how a deployment without text-webvtt degrades
+ * gracefully instead of crashing.
+ */
+import type { TracksApi } from '../types/facade.js';
+import type { ContentType, TrackId } from '../types/ir.js';
+import type { KernelState } from '../types/kernel.js';
+import type { Command } from '../types/messages.js';
+export interface TrackRegistryDeps {
+    getState(): KernelState;
+    dispatch(cmd: Command): void;
+    emitEvent(event: string, payload: unknown): void;
+    /** Whether a sink is registered for the content type, from the bus registry. */
+    hasSink(contentType: ContentType): boolean;
+}
+export interface TrackRegistry extends TracksApi {
+    selectable(trackId: TrackId): boolean;
+}
+export declare function createTrackRegistry(deps: TrackRegistryDeps): TrackRegistry;
+//# sourceMappingURL=track-registry.d.ts.map

package/dist/kernel/track-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track-registry.d.ts","sourceRoot":"","sources":["../../src/kernel/track-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAS,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,IAAI,WAAW,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACjD,gFAAgF;IAChF,OAAO,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC;CAC5C;AAED,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC9C,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;CACvC;AAOD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAmC1E"}

package/dist/kernel/track-registry.js

@@ -0,0 +1,42 @@
+function allTracks(state) {
+    if (state.presentation === null)
+        return [];
+    return state.presentation.periods.flatMap((period) => period.tracks);
+}
+export function createTrackRegistry(deps) {
+    function find(trackId) {
+        return allTracks(deps.getState()).find((track) => track.id === trackId) ?? null;
+    }
+    return {
+        get available() {
+            return allTracks(deps.getState());
+        },
+        active(contentType) {
+            const activeId = deps.getState().tracks.active.get(contentType);
+            if (activeId === undefined)
+                return null;
+            return find(activeId);
+        },
+        selectable(trackId) {
+            const track = find(trackId);
+            return track !== null && deps.hasSink(track.contentType);
+        },
+        select(trackId) {
+            const track = find(trackId);
+            if (track !== null && !deps.hasSink(track.contentType)) {
+                // Selecting a track nothing can render is refused up front; the
+                // reducer cannot see the sink registry, so the check lives here.
+                deps.emitEvent('command:rejected', {
+                    command: 'SELECT_TRACK',
+                    reason: `no sink registered for '${track.contentType}'`,
+                });
+                return;
+            }
+            deps.dispatch({ type: 'SELECT_TRACK', trackId });
+        },
+        deselect(contentType) {
+            deps.dispatch({ type: 'DESELECT_TRACK', contentType });
+        },
+    };
+}
+//# sourceMappingURL=track-registry.js.map

package/dist/kernel/track-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track-registry.js","sourceRoot":"","sources":["../../src/kernel/track-registry.ts"],"names":[],"mappings":"AAuBA,SAAS,SAAS,CAAC,KAAkB;IACnC,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAC3C,OAAO,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAuB;IACzD,SAAS,IAAI,CAAC,OAAgB;QAC5B,OAAO,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,IAAI,CAAC;IAClF,CAAC;IAED,OAAO;QACL,IAAI,SAAS;YACX,OAAO,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACpC,CAAC;QACD,MAAM,CAAC,WAAW;YAChB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAChE,IAAI,QAAQ,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC;YACxC,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxB,CAAC;QACD,UAAU,CAAC,OAAO;YAChB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;YAC5B,OAAO,KAAK,KAAK,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC3D,CAAC;QACD,MAAM,CAAC,OAAO;YACZ,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;YAC5B,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;gBACvD,gEAAgE;gBAChE,iEAAiE;gBACjE,IAAI,CAAC,SAAS,CAAC,kBAAkB,EAAE;oBACjC,OAAO,EAAE,cAAc;oBACvB,MAAM,EAAE,2BAA2B,KAAK,CAAC,WAAW,GAAG;iBACxD,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,QAAQ,CAAC,WAAW;YAClB,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC,CAAC;QACzD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/kernel/transport.d.ts

@@ -0,0 +1,90 @@
+/**
+ * The fetch wrapper. Executes fetch effects, feeds results back as facts,
+ * and owns per-token AbortControllers so the abort effect can target any
+ * request, including one stalled in a timeout or waiting out a backoff.
+ *
+ * Extension points, used by cmcd, content-steering, and the playground's
+ * fault injector:
+ * - request hooks mutate a draft (url, headers, timeout) before dispatch
+ * - response hooks observe the outcome (status, rtt, size) after it
+ * - fetchImpl replaces the network entirely, which is how tests and the
+ *   fault injector produce deterministic bad networks
+ *
+ * Example:
+ *   transport.addRequestHook((req) => {
+ *     req.headers['CMCD-Request'] = `sid=${sessionId}`;
+ *   });
+ */
+import type { InflightRequest } from '../types/kernel.js';
+import type { Fact } from '../types/messages.js';
+import type { EffectRunner } from './effects.js';
+/** Retry policy as data, not code. */
+export interface RetryPolicy {
+    /** Total attempts including the first. */
+    readonly maxAttempts: number;
+    readonly baseDelayMs: number;
+    readonly factor: number;
+    readonly maxDelayMs: number;
+    /** HTTP statuses worth retrying. Network errors and timeouts always retry. */
+    readonly retryStatuses: readonly number[];
+}
+export declare const DEFAULT_RETRY_POLICY: RetryPolicy;
+/** Backoff delay before retry `attempt` (1 = first retry). Exported so tests pin the schedule. */
+export declare function backoffDelayMs(policy: RetryPolicy, attempt: number): number;
+/** The mutable draft request hooks receive before dispatch. */
+export interface TransportRequestDraft {
+    url: string;
+    headers: Record<string, string>;
+    timeoutMs: number | null;
+    readonly token: string;
+    readonly attempt: number;
+}
+export interface TransportResponseInfo {
+    readonly token: string;
+    readonly url: string;
+    readonly status: number | null;
+    readonly rtt: number;
+    readonly size: number;
+    readonly outcome: 'success' | 'failure' | 'timeout';
+    readonly attempt: number;
+}
+export type RequestHook = (req: TransportRequestDraft) => void;
+export type ResponseHook = (res: TransportResponseInfo) => void;
+export type FetchImpl = (url: string, init: RequestInit) => Promise<Response>;
+export interface TransportOptions {
+    readonly absorb: (fact: Fact) => void;
+    /** Correlates a token with its request record from kernel state. */
+    readonly inflight: (token: string) => InflightRequest | undefined;
+    readonly retry?: Partial<RetryPolicy>;
+    /** Default timeout when the fetch effect carries none. Null disables. */
+    readonly defaultTimeoutMs?: number | null;
+    readonly fetchImpl?: FetchImpl;
+    readonly now?: () => number;
+    /**
+     * Decides from the response Content-Type whether the manifest request's
+     * body is worth reading. Returning false fails the request as an
+     * unsupported manifest before the body downloads, so an audio file
+     * handed to `load` costs one round of headers, not the whole file. Only
+     * the request on the `manifest` track is checked; segments never are.
+     */
+    readonly acceptManifestType?: (contentType: string) => boolean;
+}
+export interface Transport {
+    registerHandlers(runner: EffectRunner): void;
+    addRequestHook(hook: RequestHook): () => void;
+    addResponseHook(hook: ResponseHook): () => void;
+    /**
+     * A one-off request through the same request hooks and fetchImpl as
+     * segments, for license and steering fetches. Not correlated to a token
+     * or the reducer; the caller awaits the Response directly.
+     */
+    request(url: string, init: {
+        method?: string;
+        headers?: Record<string, string>;
+        body?: ArrayBuffer | Uint8Array | string;
+    }): Promise<Response>;
+    /** Tokens with live network activity or a pending retry. For tests and diagnostics. */
+    pending(): readonly string[];
+}
+export declare function createTransport(options: TransportOptions): Transport;
+//# sourceMappingURL=transport.d.ts.map

package/dist/kernel/transport.d.ts.map

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