mattebox 0.1.0

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

@@ -0,0 +1,57 @@
+//#region src/stages/text-webvtt-segmented/index.ts
+const MPEGTS_TIMESCALE = 9e4;
+function timestampToSeconds(text) {
+	const [rest, millis] = text.split(".");
+	const parts = (rest !== null && rest !== void 0 ? rest : "").split(":").map(Number);
+	const [h, m, s] = parts.length === 3 ? parts : [0, ...parts];
+	return (h !== null && h !== void 0 ? h : 0) * 3600 + (m !== null && m !== void 0 ? m : 0) * 60 + (s !== null && s !== void 0 ? s : 0) + Number(millis !== null && millis !== void 0 ? millis : 0) / 1e3;
+}
+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)) * 1e3);
+	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. */
+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;
+	return text.replace(/X-TIMESTAMP-MAP=[^\r\n]*\r?\n?/, "").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)];
+}
+function textWebvttSegmented() {
+	return {
+		name: "text-webvtt-segmented",
+		provides: ["text-webvtt-segmented"],
+		requires: ["text-webvtt"],
+		install(ctx) {
+			ctx.registerTransform({
+				name: "vtt-timestamp-map",
+				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));
+				}
+			});
+		}
+	};
+}
+//#endregion
+export { textWebvttSegmented as default, shiftTimestampMap };

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

@@ -0,0 +1,73 @@
+import _asyncToGenerator from "../../_virtual/_@oxc-project_runtime@0.147.0/helpers/esm/asyncToGenerator.js";
+//#region src/stages/thumbnails/index.ts
+function timestamp(text) {
+	const parts = text.trim().split(":").map(Number);
+	const [h, m, s] = parts.length === 3 ? parts : [0, ...parts];
+	return (h !== null && h !== void 0 ? h : 0) * 3600 + (m !== null && m !== void 0 ? m : 0) * 60 + (s !== null && s !== void 0 ? s : 0);
+}
+/** Parses a WebVTT thumbnail track into tiles, resolving URLs against a base. */
+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 === void 0 || target === void 0) continue;
+		const [from, to] = timing.split("-->");
+		const start = timestamp(from !== null && from !== void 0 ? from : "");
+		const end = timestamp(to !== null && to !== void 0 ? to : "");
+		const [rawUrl, fragment] = target.split("#");
+		const url = new URL(rawUrl !== null && rawUrl !== void 0 ? rawUrl : "", baseUrl).href;
+		let [x, y, width, height] = [
+			0,
+			0,
+			0,
+			0
+		];
+		const xywh = /xywh=(?:pixel:)?(\d+),(\d+),(\d+),(\d+)/.exec(fragment !== null && fragment !== void 0 ? 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;
+}
+function thumbnails() {
+	return {
+		name: "thumbnails",
+		provides: ["thumbnails"],
+		requires: ["transport"],
+		install(ctx) {
+			let tiles = [];
+			ctx.registerNamespace("thumbnails", {
+				load(url) {
+					return _asyncToGenerator(function* () {
+						tiles = parseThumbnailTrack(yield (yield ctx.request(url, { method: "GET" })).text(), url);
+						return tiles.length;
+					})();
+				},
+				at(time) {
+					var _tiles$find;
+					return (_tiles$find = tiles.find((tile) => time >= tile.start && time < tile.end)) !== null && _tiles$find !== void 0 ? _tiles$find : null;
+				},
+				get all() {
+					return tiles;
+				}
+			});
+		}
+	};
+}
+//#endregion
+export { thumbnails as default, parseThumbnailTrack };

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+import type { MatteboxBase, MatteboxOptions } from './types/facade.js';
+export { createReducer, initialState, resolveConfig } from './kernel/reducer.js';
+export { canSwitchTo } from './kernel/rendition-select.js';
+export { exportTrace, replay } from './kernel/trace.js';
+export type * from './types/error.js';
+export type * from './types/facade.js';
+export type * from './types/ir.js';
+export type * from './types/kernel.js';
+export type * from './types/messages.js';
+export type * from './types/quality.js';
+export type * from './types/sink.js';
+export type * from './types/stage.js';
+/**
+ * Namespaces contributed by stages. Empty here on purpose: a stage's module
+ * augments this interface (declaration merging) so that, for example,
+ * `engine.live` is typed exactly when `hls-live` or `dash-live` is loaded.
+ * Without the merge the property does not exist, matching the runtime, where
+ * an absent stage leaves no stub behind.
+ */
+export interface MatteboxNamespaces {
+}
+/**
+ * The engine facade. Namespace members are optional because presence
+ * depends on the loaded stages; `'live' in engine` is the feature test.
+ */
+export type Mattebox = MatteboxBase & Partial<MatteboxNamespaces>;
+/** Creates an engine. The element is supplied later via `attach`. */
+export declare function mattebox(options: MatteboxOptions): Mattebox;
+export declare namespace mattebox {
+    var from: (el: HTMLMediaElement) => Mattebox | null;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMvE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEjF,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAExD,mBAAmB,kBAAkB,CAAC;AACtC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,eAAe,CAAC;AACnC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,iBAAiB,CAAC;AACrC,mBAAmB,kBAAkB,CAAC;AAEtC;;;;;;GAMG;AAEH,MAAM,WAAW,kBAAkB;CAAG;AAEtC;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAIlE,qEAAqE;AACrE,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CAsZ3D;yBAtZe,QAAQ;mBA4ZH,gBAAgB,KAAG,QAAQ,GAAG,IAAI"}

package/dist/index.js

@@ -0,0 +1,423 @@
+/**
+ * Mattebox: a modular adaptive-streaming engine for HLS and DASH.
+ * The public entry: the mattebox() factory composes the kernel with the
+ * caller's stages; mattebox.from() finds an engine from its element. One
+ * name for both, so the ESM import and the CDN global read the same.
+ */
+import { createBus } from './kernel/bus.js';
+import { createEffectRunner } from './kernel/effects.js';
+import { createLifecycle } from './kernel/lifecycle.js';
+import { compose } from './kernel/loader.js';
+import { normalizeMimeType } from './kernel/mime.js';
+import { createMseController } from './kernel/mse.js';
+import { createReducer, initialState, resolveConfig } from './kernel/reducer.js';
+import { createArbiter } from './kernel/rendition-select.js';
+import { createMseSink } from './kernel/sinks/mse-sink.js';
+import { createTrackRegistry } from './kernel/track-registry.js';
+import { createTransport } from './kernel/transport.js';
+// Diagnosability is a project goal: the trace tooling is public API. A
+// production trace replays into a fresh reducer as a regression test.
+export { createReducer, initialState, resolveConfig } from './kernel/reducer.js';
+// The kernel's default answer to entanglement #2; the abr stage consumes it.
+export { canSwitchTo } from './kernel/rendition-select.js';
+export { exportTrace, replay } from './kernel/trace.js';
+const registry = new WeakMap();
+/** Creates an engine. The element is supplied later via `attach`. */
+export function mattebox(options) {
+    const composition = compose(options.stages ?? []);
+    // A timing transform makes media time equal presentation time; the
+    // scheduler must know, or a discontinuity gets re-anchored twice.
+    const config = {
+        ...options.config,
+        mediaTimeNormalized: options.config?.mediaTimeNormalized ??
+            composition.capabilities.includes('media-time-normalized'),
+    };
+    const cfg = resolveConfig(config);
+    const bus = createBus({
+        reducer: createReducer([], config),
+        initial: initialState(config),
+        traceCapacity: cfg.traceCapacity,
+    });
+    const runner = createEffectRunner({ onEvent: (event, payload) => bus.emitEvent(event, payload) });
+    bus.setEffectSink((effects) => runner.run(effects));
+    // A transform pipeline routes media bytes through registerTransform steps
+    // before the SourceBuffer, exactly as the deliver effect routes cue bytes.
+    // Wired only when the composition actually registered a transform, so a
+    // CMAF composition keeps the direct-enqueue append path untouched.
+    const mediaTransforms = composition.capabilities.includes('media-transform');
+    const mse = createMseController({
+        absorb: (fact) => bus.absorb(fact),
+        backBufferSeconds: cfg.backBufferSeconds,
+        // A codec-less rendition's buffer is typed from its first segment,
+        // when a stage registered a probe; without one the bare type is tried.
+        inferType: (bytes) => hooks.typeProbe?.(bytes) ?? null,
+        ...(mediaTransforms
+            ? {
+                appendTransform: async (data, meta) => {
+                    let out = data;
+                    for (const step of bus.transforms()) {
+                        out = new Uint8Array(await step.transform(out, meta));
+                    }
+                    return out;
+                },
+            }
+            : {}),
+    });
+    mse.registerHandlers(runner);
+    const transport = createTransport({
+        absorb: (fact) => bus.absorb(fact),
+        inflight: (token) => bus.getState().scheduling.inflight.get(token),
+        // A media Content-Type on the manifest response that no adapter parses
+        // (an mp3, a progressive mp4) is refused before the body downloads.
+        // Anything else, including octet-stream, downloads and is sniffed.
+        acceptManifestType: (contentType) => {
+            const type = normalizeMimeType(contentType);
+            return !(type.startsWith('audio/') || type.startsWith('video/')) || accepts(type);
+        },
+        ...(options.transport?.retry !== undefined ? { retry: options.transport.retry } : {}),
+        ...(options.transport?.fetchImpl !== undefined
+            ? { fetchImpl: options.transport.fetchImpl }
+            : {}),
+    });
+    transport.registerHandlers(runner);
+    for (const hook of options.transport?.requestHooks ?? [])
+        transport.addRequestHook(hook);
+    for (const hook of options.transport?.responseHooks ?? [])
+        transport.addResponseHook(hook);
+    runner.register('emit', (effect) => {
+        bus.emitEvent(effect.event, effect.payload);
+        return undefined;
+    });
+    runner.register('schedule', (effect) => {
+        const id = setTimeout(() => {
+            runner.forget(effect.token);
+            // Ticks carry the wall time of their firing: the one clock input a
+            // pure slice can loop itself.
+            const msg = effect.then.type === 'TICK'
+                ? { ...effect.then, wallClock: Date.now() / 1000 }
+                : effect.then;
+            bus.route(msg);
+        }, effect.delayMs);
+        return () => clearTimeout(id);
+    });
+    runner.register('seekElement', (effect) => {
+        const el = lifecycle.element();
+        if (el !== null)
+            el.currentTime = effect.to;
+        return undefined;
+    });
+    // Cue sinks arrive from stages as factories; the kernel instantiates one
+    // per content type at first use, against the attached element, so the
+    // emitCues, deliver, and clearCues effects have a live target. Cleared on
+    // detach with the element.
+    const cueSinks = new Map();
+    function cueSinkFor(contentType) {
+        const existing = cueSinks.get(contentType);
+        if (existing !== undefined)
+            return existing;
+        const el = lifecycle.element();
+        if (el === null)
+            return null;
+        const factory = bus.sinkFor(contentType);
+        if (factory === undefined)
+            return null;
+        const sink = factory({ element: el });
+        cueSinks.set(contentType, sink);
+        return sink;
+    }
+    function contentTypeOfTrack(trackId) {
+        for (const period of bus.getState().presentation?.periods ?? []) {
+            for (const track of period.tracks) {
+                if (track.id === trackId)
+                    return track.contentType;
+            }
+        }
+        return null;
+    }
+    runner.register('emitCues', (effect) => {
+        const contentType = contentTypeOfTrack(effect.trackId);
+        if (contentType !== 'text' && contentType !== 'metadata')
+            return undefined;
+        cueSinkFor(contentType)?.handleEmitCues(effect.trackId, effect.cues);
+        return undefined;
+    });
+    // Byte delivery for cue pipelines: transforms in declared order, then the
+    // sink parses and answers with effects. A per-engine chain keeps segment
+    // order even when a transform is asynchronous.
+    let deliverChain = Promise.resolve();
+    runner.register('deliver', (effect) => {
+        const sink = cueSinkFor(effect.contentType);
+        if (sink === null)
+            return undefined;
+        deliverChain = deliverChain
+            .then(async () => {
+            let data = new Uint8Array(effect.data);
+            for (const step of bus.transforms()) {
+                data = new Uint8Array(await step.transform(data, effect.meta));
+            }
+            const bytes = data.byteOffset === 0 && data.byteLength === data.buffer.byteLength
+                ? data.buffer
+                : data.slice().buffer;
+            const produced = sink.accept(effect.trackId, bytes, effect.meta);
+            if (produced.length > 0)
+                runner.run(produced);
+        })
+            .catch(() => {
+            // A cue pipeline degrades; playback is untouched.
+            bus.emitEvent('error', {
+                category: 'media',
+                code: 'MEDIA_CONTAINER_INVALID',
+                fatal: false,
+                recoverable: false,
+                trackId: effect.trackId,
+            });
+        });
+        return undefined;
+    });
+    runner.register('clearCues', (effect) => {
+        for (const sink of cueSinks.values()) {
+            sink.clear(effect.trackId, effect.start, effect.end);
+        }
+        return undefined;
+    });
+    // The kernel owns the media sinks; stages own text and metadata.
+    const sinkInstances = new Map();
+    for (const contentType of ['video', 'audio']) {
+        const sink = createMseSink(contentType, { buffered: (sbId) => mse.buffered(sbId) });
+        sinkInstances.set(contentType, sink);
+        bus.registerSink(contentType, () => sink);
+    }
+    for (const capability of composition.capabilities) {
+        bus.registerCapability(capability);
+    }
+    const tracks = createTrackRegistry({
+        getState: () => bus.getState(),
+        dispatch: (cmd) => bus.dispatch(cmd),
+        emitEvent: (event, payload) => bus.emitEvent(event, payload),
+        hasSink: (contentType) => bus.sinkFor(contentType) !== undefined,
+    });
+    const arbiter = createArbiter();
+    // Shared with the stage contexts: the abr stage sets `abr` at install and
+    // the reducer reads it live through this object.
+    const hooks = { manifestTypes: composition.manifestTypes };
+    let lastError = null;
+    function accepts(mimeType) {
+        return composition.manifestTypes.has(normalizeMimeType(mimeType));
+    }
+    function activeVideoRenditions() {
+        const state = bus.getState();
+        if (state.presentation === null)
+            return [];
+        const activeId = state.tracks.active.get('video');
+        for (const period of state.presentation.periods) {
+            for (const track of period.tracks) {
+                if (track.contentType !== 'video')
+                    continue;
+                if (activeId === undefined || track.id === activeId)
+                    return track.renditions;
+            }
+        }
+        return [];
+    }
+    function arbitrated() {
+        const state = bus.getState();
+        return arbiter.run({
+            renditions: activeVideoRenditions(),
+            constraints: state.quality.constraints,
+            pinned: state.quality.pinned,
+            current: state.quality.active,
+            couplings: state.presentation?.couplings ?? [],
+            activeTracks: state.tracks.active,
+            availableGroups: (() => {
+                const groups = new Set();
+                for (const period of state.presentation?.periods ?? []) {
+                    for (const track of period.tracks) {
+                        if (track.contentType !== 'audio' && track.contentType !== 'text')
+                            continue;
+                        const colon = track.id.indexOf(':');
+                        groups.add(`${track.contentType}:${colon === -1 ? track.id : track.id.slice(0, colon)}`);
+                    }
+                }
+                return groups;
+            })(),
+            telemetry: {
+                throughputEwma: state.stats.throughputEwma,
+                throughputFastEwma: state.stats.throughputFastEwma,
+                current: state.quality.active,
+                currentTime: state.playback.currentTime,
+            },
+        }, state.quality.version);
+    }
+    const facadeTarget = {};
+    // The element's own error (a decoder that gave up, a source the browser
+    // rejects) is reported as a fatal engine error, never papered over by a
+    // reload: a rebuilt pipeline restarts playback visibly, which is worse
+    // than an honest error. In-place recovery (nudges, gap jumps, flushes,
+    // skips, rendition exclusion) is the recovery stage's job and happens
+    // before the decoder ever fails.
+    const MEDIA_ERR = [
+        '',
+        'MEDIA_ERR_ABORTED',
+        'MEDIA_ERR_NETWORK',
+        'MEDIA_ERR_DECODE',
+        'MEDIA_ERR_SRC_NOT_SUPPORTED',
+    ];
+    function onMediaError(el) {
+        const code = el.error?.code ?? 0;
+        // An abort is the app's doing; an engine that already halted keeps its error.
+        if (code === 1 || lastError !== null)
+            return;
+        bus.emitEvent('error', {
+            category: 'media',
+            code: code === 4 ? 'MEDIA_CODEC_UNSUPPORTED' : 'MEDIA_DECODE_ERROR',
+            fatal: true,
+            recoverable: false,
+            context: { mediaError: MEDIA_ERR[code] ?? code, message: el.error?.message ?? '' },
+        });
+    }
+    const base = {
+        get media() {
+            return lifecycle.element();
+        },
+        quality: {
+            get renditions() {
+                return activeVideoRenditions();
+            },
+            get allowed() {
+                const ids = arbitrated().result.allowed;
+                return activeVideoRenditions().filter((r) => ids.includes(r.id));
+            },
+            get active() {
+                const id = bus.getState().quality.active;
+                return activeVideoRenditions().find((r) => r.id === id) ?? null;
+            },
+            get playing() {
+                const state = bus.getState();
+                const id = arbiter.playingAt(state.quality.appendLog, state.playback.currentTime);
+                return activeVideoRenditions().find((r) => r.id === id) ?? null;
+            },
+            get pinned() {
+                return bus.getState().quality.pinned;
+            },
+            get constraints() {
+                return bus.getState().quality.constraints;
+            },
+            constrain(source, constraint) {
+                bus.dispatch({ type: 'CONSTRAIN', source, constraint });
+            },
+            release(source) {
+                bus.dispatch({ type: 'RELEASE_CONSTRAINT', source });
+            },
+            pin(renditionId, pinOptions) {
+                bus.dispatch({
+                    type: 'PIN_RENDITION',
+                    renditionId,
+                    apply: pinOptions?.apply ?? 'soon',
+                });
+            },
+            auto() {
+                bus.dispatch({ type: 'RELEASE_PIN' });
+            },
+        },
+        tracks,
+        stats: {
+            get throughput() {
+                return bus.getState().stats.throughputEwma;
+            },
+            trace() {
+                return bus.trace();
+            },
+            snapshot() {
+                return bus.getState();
+            },
+        },
+        get error() {
+            return lastError;
+        },
+        async attach(el) {
+            // async so a synchronous composition or occupancy error surfaces as
+            // a rejection, matching the declared Promise contract.
+            lifecycle.attach(el);
+        },
+        async detach() {
+            lifecycle.detach();
+        },
+        load(url, loadOptions) {
+            // Consumers hand over page-relative URLs; the IR stores absolute ones
+            // and parsers resolve against the manifest URL, so absolutize here.
+            let absolute = url;
+            try {
+                absolute = new URL(url, globalThis.location?.href).href;
+            }
+            catch {
+                // No document base (tests, workers): the caller's URL stands.
+            }
+            lastError = null;
+            bus.dispatch({
+                type: 'LOAD',
+                url: absolute,
+                ...(loadOptions?.mimeType !== undefined ? { mimeType: loadOptions.mimeType } : {}),
+            });
+        },
+        unload() {
+            bus.dispatch({ type: 'UNLOAD' });
+        },
+        dispatch(cmd) {
+            bus.dispatch(cmd);
+        },
+        capabilities() {
+            return composition.capabilities.map((capability) => typeof capability === 'string'
+                ? capability
+                : `${capability.contentType}:${capability.mimeType}`);
+        },
+        accepts,
+        on(event, fn) {
+            return bus.on(event, fn);
+        },
+    };
+    bus.on('error', (payload) => {
+        const summary = payload;
+        if (summary.fatal === true) {
+            lastError = {
+                category: summary.category ?? 'internal',
+                code: summary.code ?? 'INTERNAL_ASSERTION',
+                fatal: true,
+                recoverable: summary.recoverable ?? false,
+                trace: bus.trace(),
+            };
+        }
+    });
+    // Copy descriptors, not values: Object.assign would evaluate every live
+    // getter once and freeze the result.
+    Object.defineProperties(facadeTarget, Object.getOwnPropertyDescriptors(base));
+    const engine = facadeTarget;
+    const lifecycle = createLifecycle({
+        bus,
+        mse,
+        composition,
+        facade: facadeTarget,
+        config,
+        hooks,
+        addRequestHook: (hook) => transport.addRequestHook(hook),
+        request: (url, init) => transport.request(url, init),
+        register: (el) => registry.set(el, engine),
+        unregister: (el) => {
+            registry.delete(el);
+            // Nothing started before the detach may land after it: pending
+            // timers and fetches go, and the cue sinks release their native
+            // tracks (the element cannot drop a TextTrack, so they empty them).
+            runner.cancelAll();
+            for (const sink of cueSinks.values())
+                sink.dispose();
+            cueSinks.clear();
+        },
+        onMediaError,
+    });
+    return engine;
+}
+/**
+ * Static lookup from an element to its engine, backed by a WeakMap. The
+ * element itself carries no added surface and garbage-collects normally.
+ */
+mattebox.from = (el) => registry.get(el) ?? null;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/kernel/append-queue.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Per-SourceBuffer FIFO, strictly serialized on updateend. The single most
+ * common MSE bug is touching a SourceBuffer while `updating` is true; every
+ * operation here waits its turn.
+ *
+ * Quota handling: an append that throws QuotaExceededError goes back to the
+ * front of the queue and the owner is notified with an attempt count. The
+ * owner enqueues eviction removes with `enqueueFront`, so they run before
+ * the failed append retries; queued appends behind it keep their order. The
+ * attempt count resets as soon as an append succeeds, so only consecutive
+ * failures escalate.
+ */
+import type { SbId } from '../types/kernel.js';
+import type { Fact } from '../types/messages.js';
+export type QueueOp = {
+    readonly op: 'append';
+    readonly data: ArrayBuffer;
+} | {
+    readonly op: 'remove';
+    readonly start: number;
+    readonly end: number;
+} | {
+    readonly op: 'changeType';
+    readonly type: string;
+} | {
+    readonly op: 'setTimestampOffset';
+    readonly offset: number;
+};
+export interface AppendQueueCallbacks {
+    absorb(fact: Fact): void;
+    /** appendBuffer threw QuotaExceededError. `attempt` counts consecutive failures, starting at 1. */
+    onQuota(sbId: SbId, attempt: number): void;
+    /** The queue drained and the buffer is not updating. Used for deferred endOfStream. */
+    onIdle(sbId: SbId): void;
+}
+export interface AppendQueue {
+    enqueue(op: QueueOp): void;
+    /** Jumps the queue. For eviction removes that must precede a retried append. */
+    enqueueFront(op: QueueOp): void;
+    /** sourceBuffer.abort() semantics: pending operations are dropped, not retried. */
+    abort(): void;
+    /** Detach teardown: drops everything and removes listeners. Idempotent. */
+    destroy(): void;
+    readonly idle: () => boolean;
+}
+export declare function createAppendQueue(sbId: SbId, sb: SourceBuffer, cb: AppendQueueCallbacks): AppendQueue;
+//# sourceMappingURL=append-queue.d.ts.map

package/dist/kernel/append-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"append-queue.d.ts","sourceRoot":"","sources":["../../src/kernel/append-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAEjD,MAAM,MAAM,OAAO,GACf;IAAE,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,EAAE,EAAE,oBAAoB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,mGAAmG;IACnG,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,uFAAuF;IACvF,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,gFAAgF;IAChF,YAAY,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,mFAAmF;IACnF,KAAK,IAAI,IAAI,CAAC;IACd,2EAA2E;IAC3E,OAAO,IAAI,IAAI,CAAC;IAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC;CAC9B;AAUD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,IAAI,EACV,EAAE,EAAE,YAAY,EAChB,EAAE,EAAE,oBAAoB,GACvB,WAAW,CAwKb"}