mattebox 0.1.0

package/dist/containers/adts.js

@@ -0,0 +1,66 @@
+/**
+ * ADTS AAC framing. Both ts-transmux (AAC inside a TS PES) and packed-audio
+ * (a bare .aac HLS segment) meet AAC as ADTS frames and need the same three
+ * things: the raw AAC payloads for the mdat, the codec parameters for the
+ * esds, and the sample count for timing. This is the shared module both
+ * import; neither imports the other.
+ */
+/** The MPEG-4 sampling frequency table, indexed by samplingFrequencyIndex. */
+export const SAMPLE_RATES = [
+    96000, 88200, 64000, 48000, 44100, 32000, 24000, 22050, 16000, 12000, 11025, 8000, 7350,
+];
+/** Samples per AAC frame; fixed for AAC-LC. */
+export const SAMPLES_PER_FRAME = 1024;
+/**
+ * Parses every ADTS frame in a buffer. Each frame header carries its own
+ * length, so parsing walks frame to frame; a bad or truncated header stops
+ * the walk rather than throwing. The returned codec parameters come from the
+ * first valid frame, which is what the init segment describes.
+ */
+export function parseAdts(data) {
+    const frames = [];
+    let audioObjectType = 2;
+    let samplingFrequencyIndex = 4;
+    let channelConfig = 2;
+    let offset = 0;
+    const length = data.byteLength;
+    while (offset + 7 <= length) {
+        // Syncword: eleven set bits across the first byte and the top of the second.
+        if (data[offset] !== 0xff || (data[offset + 1] & 0xf6) !== 0xf0) {
+            offset += 1;
+            continue;
+        }
+        const protectionAbsent = data[offset + 1] & 0x01;
+        const profile = (data[offset + 2] >> 6) & 0x03;
+        const freqIndex = (data[offset + 2] >> 2) & 0x0f;
+        const channels = ((data[offset + 2] & 0x01) << 2) | ((data[offset + 3] >> 6) & 0x03);
+        const frameLength = ((data[offset + 3] & 0x03) << 11) |
+            (data[offset + 4] << 3) |
+            ((data[offset + 5] >> 5) & 0x07);
+        if (frameLength < 7 || offset + frameLength > length)
+            break;
+        const headerSize = protectionAbsent ? 7 : 9;
+        if (headerSize < frameLength) {
+            frames.push({
+                data: data.subarray(offset + headerSize, offset + frameLength),
+                audioObjectType: profile + 1,
+                samplingFrequencyIndex: freqIndex,
+                channelConfig: channels,
+            });
+            if (frames.length === 1) {
+                audioObjectType = profile + 1;
+                samplingFrequencyIndex = freqIndex;
+                channelConfig = channels;
+            }
+        }
+        offset += frameLength;
+    }
+    return {
+        frames,
+        sampleRate: SAMPLE_RATES[samplingFrequencyIndex] ?? 44100,
+        audioObjectType,
+        samplingFrequencyIndex,
+        channelConfig,
+    };
+}
+//# sourceMappingURL=adts.js.map

package/dist/containers/adts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adts.js","sourceRoot":"","sources":["../../src/containers/adts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,8EAA8E;AAC9E,MAAM,CAAC,MAAM,YAAY,GAAsB;IAC7C,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI;CACxF,CAAC;AAEF,+CAA+C;AAC/C,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAkBtC;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,IAAgB;IACxC,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,IAAI,sBAAsB,GAAG,CAAC,CAAC;IAC/B,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC;IAC/B,OAAO,MAAM,GAAG,CAAC,IAAI,MAAM,EAAE,CAAC;QAC5B,6EAA6E;QAC7E,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI,CAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAY,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YAC5E,MAAM,IAAI,CAAC,CAAC;YACZ,SAAS;QACX,CAAC;QACD,MAAM,gBAAgB,GAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAY,GAAG,IAAI,CAAC;QAC7D,MAAM,OAAO,GAAG,CAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAY,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;QAC3D,MAAM,SAAS,GAAG,CAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAY,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;QAC7D,MAAM,QAAQ,GACZ,CAAC,CAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAY,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAY,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC9F,MAAM,WAAW,GACf,CAAC,CAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAY,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC7C,CAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAY,IAAI,CAAC,CAAC;YACnC,CAAC,CAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAY,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC/C,IAAI,WAAW,GAAG,CAAC,IAAI,MAAM,GAAG,WAAW,GAAG,MAAM;YAAE,MAAM;QAC5D,MAAM,UAAU,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5C,IAAI,UAAU,GAAG,WAAW,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,UAAU,EAAE,MAAM,GAAG,WAAW,CAAC;gBAC9D,eAAe,EAAE,OAAO,GAAG,CAAC;gBAC5B,sBAAsB,EAAE,SAAS;gBACjC,aAAa,EAAE,QAAQ;aACxB,CAAC,CAAC;YACH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,eAAe,GAAG,OAAO,GAAG,CAAC,CAAC;gBAC9B,sBAAsB,GAAG,SAAS,CAAC;gBACnC,aAAa,GAAG,QAAQ,CAAC;YAC3B,CAAC;QACH,CAAC;QACD,MAAM,IAAI,WAAW,CAAC;IACxB,CAAC;IACD,OAAO;QACL,MAAM;QACN,UAAU,EAAE,YAAY,CAAC,sBAAsB,CAAC,IAAI,KAAK;QACzD,eAAe;QACf,sBAAsB;QACtB,aAAa;KACd,CAAC;AACJ,CAAC"}

package/dist/containers/captions.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The caption seam of entanglement #1. Two sources reach in-band captions:
+ * ts-transmux, which already splits NALs in its Worker and returns the SEI
+ * caption bytes it finds, and nal-scan, which walks an fMP4 mdat for the same
+ * bytes. Both deliver here; text-cea608 registers the one consumer that
+ * decodes them. Nobody imports text-cea608 to do it, and when no caption
+ * stage has registered, `wanted()` is false and neither source does the work.
+ */
+import type { CcTriple } from './sei.js';
+/** One access unit's caption triples at its presentation time, in seconds. */
+export interface CcPacket {
+    readonly time: number;
+    readonly triples: readonly CcTriple[];
+}
+export type CaptionConsumer = (packets: readonly CcPacket[]) => void;
+/** Registers the caption decoder. Returns an unregister for stage teardown. */
+export declare function registerCaptionConsumer(fn: CaptionConsumer): () => void;
+/** True when a caption stage is loaded, so a SEI source should extract. */
+export declare function captionsWanted(): boolean;
+/**
+ * Hands extracted caption packets to the registered decoder. When both a
+ * ts-transmux and a nal-scan source are composed they extract the same SEI
+ * from the same segment back to back; an identical batch arriving twice in a
+ * row is dropped so the decoder never sees a caption doubled.
+ */
+export declare function deliverCaptions(packets: readonly CcPacket[]): void;
+//# sourceMappingURL=captions.d.ts.map

package/dist/containers/captions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"captions.d.ts","sourceRoot":"","sources":["../../src/containers/captions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,8EAA8E;AAC9E,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,QAAQ,EAAE,CAAC;CACvC;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,SAAS,QAAQ,EAAE,KAAK,IAAI,CAAC;AAKrE,+EAA+E;AAC/E,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,eAAe,GAAG,MAAM,IAAI,CAMvE;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAQD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,QAAQ,EAAE,GAAG,IAAI,CAMlE"}

package/dist/containers/captions.js

@@ -0,0 +1,36 @@
+let consumer = null;
+let lastFingerprint = '';
+/** Registers the caption decoder. Returns an unregister for stage teardown. */
+export function registerCaptionConsumer(fn) {
+    consumer = fn;
+    lastFingerprint = '';
+    return () => {
+        if (consumer === fn)
+            consumer = null;
+    };
+}
+/** True when a caption stage is loaded, so a SEI source should extract. */
+export function captionsWanted() {
+    return consumer !== null;
+}
+function fingerprint(packets) {
+    const first = packets[0];
+    const last = packets[packets.length - 1];
+    return `${packets.length}:${first?.time}:${first?.triples[0]?.a}:${last?.time}:${last?.triples[0]?.b}`;
+}
+/**
+ * Hands extracted caption packets to the registered decoder. When both a
+ * ts-transmux and a nal-scan source are composed they extract the same SEI
+ * from the same segment back to back; an identical batch arriving twice in a
+ * row is dropped so the decoder never sees a caption doubled.
+ */
+export function deliverCaptions(packets) {
+    if (packets.length === 0 || consumer === null)
+        return;
+    const print = fingerprint(packets);
+    if (print === lastFingerprint)
+        return;
+    lastFingerprint = print;
+    consumer(packets);
+}
+//# sourceMappingURL=captions.js.map

package/dist/containers/captions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"captions.js","sourceRoot":"","sources":["../../src/containers/captions.ts"],"names":[],"mappings":"AAkBA,IAAI,QAAQ,GAA2B,IAAI,CAAC;AAC5C,IAAI,eAAe,GAAG,EAAE,CAAC;AAEzB,+EAA+E;AAC/E,MAAM,UAAU,uBAAuB,CAAC,EAAmB;IACzD,QAAQ,GAAG,EAAE,CAAC;IACd,eAAe,GAAG,EAAE,CAAC;IACrB,OAAO,GAAG,EAAE;QACV,IAAI,QAAQ,KAAK,EAAE;YAAE,QAAQ,GAAG,IAAI,CAAC;IACvC,CAAC,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,cAAc;IAC5B,OAAO,QAAQ,KAAK,IAAI,CAAC;AAC3B,CAAC;AAED,SAAS,WAAW,CAAC,OAA4B;IAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzC,OAAO,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AACzG,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,OAA4B;IAC1D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO;IACtD,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,KAAK,KAAK,eAAe;QAAE,OAAO;IACtC,eAAe,GAAG,KAAK,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,CAAC;AACpB,CAAC"}

package/dist/containers/codec-probe/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Derives the exact codecs= string from an init segment's moov. Manifests
+ * routinely omit or misstate CODECS, and isTypeSupported wants exact
+ * strings; when the manifest and the probe disagree, the probe wins,
+ * because the probe read the actual bytes the decoder will see.
+ */
+import type { MatteboxError } from '../../types/error.js';
+export interface ProbedTrack {
+    /** The stsd sample entry fourcc, such as 'avc1' or 'mp4a'. */
+    readonly format: string;
+    /** The derived RFC 6381 codec string, or null when underivable. */
+    readonly codec: string | null;
+    readonly kind: 'video' | 'audio' | 'unknown';
+}
+export interface ProbeResult {
+    readonly tracks: readonly ProbedTrack[];
+    readonly codecs: readonly string[];
+    /** Ready for isTypeSupported, or null when nothing was derivable. */
+    readonly mimeType: string | null;
+    readonly error: MatteboxError | null;
+}
+/** Probes every stsd sample entry in the init segment's moov. */
+export declare function probeInitSegment(init: Uint8Array): ProbeResult;
+export interface CodecReconciliation {
+    /** The string to hand to addSourceBuffer. */
+    readonly contentType: string;
+    /** True when the manifest and the probe disagreed; emit a warning. */
+    readonly mismatch: boolean;
+}
+/**
+ * The probe wins over the manifest: it read the bytes the decoder will
+ * decode. The mismatch flag exists so the discrepancy stays visible.
+ */
+export declare function reconcileCodecs(manifestContentType: string | null, probe: ProbeResult): CodecReconciliation;
+//# sourceMappingURL=index.d.ts.map

package/dist/containers/codec-probe/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/containers/codec-probe/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAI1D,MAAM,WAAW,WAAW;IAC1B,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;CAC9C;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;CACtC;AAoLD,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,CAmC9D;AAED,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,mBAAmB,EAAE,MAAM,GAAG,IAAI,EAClC,KAAK,EAAE,WAAW,GACjB,mBAAmB,CAYrB"}

package/dist/containers/codec-probe/index.js

@@ -0,0 +1,222 @@
+import { findBoxes, fullBox, walkBoxes } from '../mp4-box/index.js';
+const VIDEO_FORMATS = new Set(['avc1', 'avc3', 'hvc1', 'hev1', 'vp09', 'av01']);
+const AUDIO_FORMATS = new Set(['mp4a', 'Opus', 'opus', 'ac-3', 'ec-3']);
+/** Sample entry fixed-part sizes before the codec config child boxes. */
+const VISUAL_ENTRY_HEADER = 8 + 70;
+const AUDIO_ENTRY_HEADER = 8 + 20;
+function hex(byte) {
+    return byte.toString(16).padStart(2, '0');
+}
+function childBox(entry, fixedOffset, type) {
+    // Child boxes start after the sample entry's fixed part. A malformed or
+    // versioned entry shifts them; scan forward conservatively.
+    for (const offset of [fixedOffset, fixedOffset + 16]) {
+        let at = offset;
+        const view = new DataView(entry.buffer, entry.byteOffset, entry.byteLength);
+        while (at + 8 <= entry.byteLength) {
+            const size = view.getUint32(at);
+            if (size < 8 || at + size > entry.byteLength)
+                break;
+            const name = String.fromCharCode(entry[at + 4] ?? 0, entry[at + 5] ?? 0, entry[at + 6] ?? 0, entry[at + 7] ?? 0);
+            if (name === type)
+                return entry.subarray(at + 8, at + size);
+            at += size;
+        }
+    }
+    return null;
+}
+/** avcC: profile, constraint flags, level -> avc1.PPCCLL. ISO 14496-15 §5.3. */
+function avcCodec(format, entry) {
+    const config = childBox(entry, VISUAL_ENTRY_HEADER, 'avcC');
+    if (config === null || config.byteLength < 4)
+        return null;
+    return `${format}.${hex(config[1])}${hex(config[2])}${hex(config[3])}`;
+}
+/** hvcC -> the full hvc1/hev1 form. ISO 14496-15 annex E. */
+function hevcCodec(format, entry) {
+    const c = childBox(entry, VISUAL_ENTRY_HEADER, 'hvcC');
+    if (c === null || c.byteLength < 13)
+        return null;
+    const profileSpace = (c[1] >> 6) & 0x3;
+    const tier = (c[1] >> 5) & 0x1;
+    const profileIdc = c[1] & 0x1f;
+    const compat = (c[2] << 24) |
+        (c[3] << 16) |
+        (c[4] << 8) |
+        c[5];
+    // The compatibility flags are written bit-reversed in the codec string.
+    let reversed = 0;
+    for (let i = 0; i < 32; i += 1) {
+        reversed = (reversed << 1) | ((compat >>> i) & 1);
+    }
+    const levelIdc = c[12];
+    const constraints = [];
+    for (let i = 6; i < 12; i += 1) {
+        constraints.push(c[i].toString(16).toUpperCase());
+    }
+    while (constraints.length > 1 && constraints[constraints.length - 1] === '0') {
+        constraints.pop();
+    }
+    const space = ['', 'A', 'B', 'C'][profileSpace] ?? '';
+    return `${format}.${space}${profileIdc}.${(reversed >>> 0).toString(16).toUpperCase()}.${tier === 1 ? 'H' : 'L'}${levelIdc}.${constraints.join('.')}`;
+}
+/** esds -> mp4a.40.N via the DecoderSpecificInfo audio object type. ISO 14496-1 §7.2.6. */
+function aacCodec(entry) {
+    const esds = childBox(entry, AUDIO_ENTRY_HEADER, 'esds');
+    if (esds === null)
+        return null;
+    const body = fullBox(esds)?.body;
+    if (body === undefined)
+        return null;
+    // Descriptors: tag byte, then an expandable length (0x80-continued).
+    function descriptor(data, tag) {
+        let at = 0;
+        while (at + 2 <= data.byteLength) {
+            const thisTag = data[at];
+            at += 1;
+            let size = 0;
+            let more = true;
+            while (more && at < data.byteLength) {
+                const byte = data[at];
+                size = (size << 7) | (byte & 0x7f);
+                more = (byte & 0x80) !== 0;
+                at += 1;
+            }
+            if (at + size > data.byteLength)
+                return null;
+            if (thisTag === tag)
+                return data.subarray(at, at + size);
+            at += size;
+        }
+        return null;
+    }
+    const es = descriptor(body, 0x03);
+    if (es === null)
+        return null;
+    // ES_Descriptor: ES_ID (2) + flags byte, then optional fields none of
+    // which appear in practice for CMAF.
+    const decoderConfig = descriptor(es.subarray(3), 0x04);
+    if (decoderConfig === null || decoderConfig.byteLength < 1)
+        return null;
+    const objectType = decoderConfig[0];
+    const specific = descriptor(decoderConfig.subarray(13), 0x05);
+    if (objectType === 0x40 && specific !== null && specific.byteLength >= 1) {
+        const audioObjectType = (specific[0] >> 3) & 0x1f;
+        return `mp4a.40.${audioObjectType}`;
+    }
+    return `mp4a.${hex(objectType)}`;
+}
+/** vpcC -> vp09.PP.LL.DD. VP9-in-ISOBMFF binding. */
+function vp9Codec(entry) {
+    const c = childBox(entry, VISUAL_ENTRY_HEADER, 'vpcC');
+    const body = c === null ? null : (fullBox(c)?.body ?? null);
+    if (body === null || body.byteLength < 2)
+        return null;
+    const profile = body[0];
+    const level = body[1];
+    const bitDepth = ((body[2] ?? 8) >> 4) & 0xf;
+    const pad = (n) => String(n).padStart(2, '0');
+    return `vp09.${pad(profile)}.${pad(level)}.${pad(bitDepth)}`;
+}
+/** av1C -> av01.P.LLT.DD. AV1-in-ISOBMFF binding. */
+function av1Codec(entry) {
+    const c = childBox(entry, VISUAL_ENTRY_HEADER, 'av1C');
+    if (c === null || c.byteLength < 2)
+        return null;
+    const profile = (c[1] >> 5) & 0x7;
+    const levelIdx = c[1] & 0x1f;
+    const tier = ((c[2] ?? 0) >> 7) & 0x1;
+    const highBitdepth = ((c[2] ?? 0) >> 6) & 0x1;
+    const twelveBit = ((c[2] ?? 0) >> 5) & 0x1;
+    const bitDepth = highBitdepth === 1 ? (twelveBit === 1 ? 12 : 10) : 8;
+    return `av01.${profile}.${String(levelIdx).padStart(2, '0')}${tier === 1 ? 'H' : 'M'}.${String(bitDepth).padStart(2, '0')}`;
+}
+function deriveTrack(format, entry) {
+    const kind = VIDEO_FORMATS.has(format)
+        ? 'video'
+        : AUDIO_FORMATS.has(format)
+            ? 'audio'
+            : 'unknown';
+    let codec = null;
+    switch (format) {
+        case 'avc1':
+        case 'avc3':
+            codec = avcCodec(format, entry);
+            break;
+        case 'hvc1':
+        case 'hev1':
+            codec = hevcCodec(format, entry);
+            break;
+        case 'mp4a':
+            codec = aacCodec(entry);
+            break;
+        case 'vp09':
+            codec = vp9Codec(entry);
+            break;
+        case 'av01':
+            codec = av1Codec(entry);
+            break;
+        case 'Opus':
+        case 'opus':
+            codec = 'opus';
+            break;
+        case 'ac-3':
+            codec = 'ac-3';
+            break;
+        case 'ec-3':
+            codec = 'ec-3';
+            break;
+        default:
+            codec = null;
+    }
+    return { format, codec, kind };
+}
+/** Probes every stsd sample entry in the init segment's moov. */
+export function probeInitSegment(init) {
+    const walk = walkBoxes(init, () => undefined);
+    if (walk.error !== null) {
+        return { tracks: [], codecs: [], mimeType: null, error: walk.error };
+    }
+    const tracks = [];
+    const stsds = findBoxes(init, 'moov/trak/mdia/minf/stbl/stsd');
+    for (const stsd of stsds) {
+        const header = fullBox(stsd.payload);
+        if (header === null || header.body.byteLength < 4)
+            continue;
+        const view = new DataView(header.body.buffer, header.body.byteOffset, header.body.byteLength);
+        const count = view.getUint32(0);
+        let at = 4;
+        for (let i = 0; i < count && at + 8 <= header.body.byteLength; i += 1) {
+            const size = view.getUint32(at);
+            if (size < 8 || at + size > header.body.byteLength)
+                break;
+            const format = String.fromCharCode(header.body[at + 4] ?? 0, header.body[at + 5] ?? 0, header.body[at + 6] ?? 0, header.body[at + 7] ?? 0);
+            tracks.push(deriveTrack(format, header.body.subarray(at + 8, at + size)));
+            at += size;
+        }
+    }
+    const codecs = tracks.map((t) => t.codec).filter((c) => c !== null);
+    const hasVideo = tracks.some((t) => t.kind === 'video');
+    const mimeType = codecs.length === 0
+        ? null
+        : `${hasVideo ? 'video' : 'audio'}/mp4; codecs="${codecs.join(',')}"`;
+    return { tracks, codecs, mimeType, error: null };
+}
+/**
+ * The probe wins over the manifest: it read the bytes the decoder will
+ * decode. The mismatch flag exists so the discrepancy stays visible.
+ */
+export function reconcileCodecs(manifestContentType, probe) {
+    if (probe.mimeType === null) {
+        return { contentType: manifestContentType ?? '', mismatch: false };
+    }
+    if (manifestContentType === null) {
+        return { contentType: probe.mimeType, mismatch: false };
+    }
+    const normalize = (s) => s.toLowerCase().replaceAll(/\s+/g, '');
+    return {
+        contentType: probe.mimeType,
+        mismatch: normalize(manifestContentType) !== normalize(probe.mimeType),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/containers/codec-probe/index.js.map

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

package/dist/containers/fmp4/writer.d.ts

@@ -0,0 +1,62 @@
+/**
+ * A minimal fragmented-ISOBMFF writer, the counterpart to mp4-box's reader.
+ * It emits exactly the boxes MSE needs to accept a fragment: an init segment
+ * (ftyp + a moov with one trak per elementary stream and an mvex) and a
+ * media segment (moof + mdat). A muxed TS segment becomes one init with a
+ * video trak and an audio trak, so a single SourceBuffer decodes both.
+ * Nothing here reads the clock or a random source: identical samples in
+ * produce identical bytes out, which is what the golden fixtures pin.
+ *
+ * ts-transmux and packed-audio both import this module. It is a shared
+ * container utility, not a stage, so neither imports the other.
+ */
+/** An AVC video track, configured from the SPS/PPS the demux extracted. */
+export interface VideoTrackConfig {
+    readonly id: number;
+    readonly kind: 'video';
+    /** 90 kHz for MPEG-TS sources. */
+    readonly timescale: number;
+    /** The sequence parameter set, one raw NAL with no start code or length prefix. */
+    readonly sps: Uint8Array;
+    readonly pps: Uint8Array;
+    readonly width: number;
+    readonly height: number;
+}
+/** An AAC audio track, configured from an ADTS header or an AudioSpecificConfig. */
+export interface AudioTrackConfig {
+    readonly id: number;
+    readonly kind: 'audio';
+    /** The sampling frequency in Hz; also the track timescale. */
+    readonly timescale: number;
+    /** MPEG-4 Audio Object Type. AAC-LC is 2. */
+    readonly audioObjectType: number;
+    /** Index into the MPEG-4 sampling frequency table. */
+    readonly samplingFrequencyIndex: number;
+    readonly channelConfig: number;
+}
+export type TrackConfig = VideoTrackConfig | AudioTrackConfig;
+/** One access unit: length-prefixed AVCC NALs for video, one raw AAC frame for audio. */
+export interface Sample {
+    readonly data: Uint8Array;
+    /** Duration in track timescale units. */
+    readonly duration: number;
+    /** Composition-time offset for B-frame reordering; zero for audio. */
+    readonly cts: number;
+    readonly isKeyframe: boolean;
+}
+/** One track's samples for a media segment, timed from its own decode time. */
+export interface TrackFragment {
+    readonly trackId: number;
+    readonly baseMediaDecodeTime: number;
+    readonly samples: readonly Sample[];
+}
+/** The init segment: ftyp then a moov describing every track. */
+export declare function writeInitSegment(configs: readonly TrackConfig[]): Uint8Array;
+/**
+ * The moof/mdat pair for one or more track fragments. Each trun's data offset
+ * is back-patched once the moof size is known, so the offsets are exact
+ * regardless of how many tracks the fragment carries or how large the trafs
+ * grew. The mdat interleaves tracks in the order given.
+ */
+export declare function writeMediaSegment(sequenceNumber: number, fragments: readonly TrackFragment[]): Uint8Array;
+//# sourceMappingURL=writer.d.ts.map

package/dist/containers/fmp4/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../../src/containers/fmp4/writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,2EAA2E;AAC3E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,kCAAkC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,mFAAmF;IACnF,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,oFAAoF;AACpF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,6CAA6C;IAC7C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,sDAAsD;IACtD,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAE9D,yFAAyF;AACzF,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED,+EAA+E;AAC/E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAuQD,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,UAAU,CAK5E;AA4BD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,SAAS,aAAa,EAAE,GAClC,UAAU,CA2CZ"}