@flighthq/compression 0.3.0-next.1494.7333e82

package/dist/contract.d.ts

@@ -0,0 +1,3 @@
+export * from './decompressor';
+export * from './deflate';
+//# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC"}

package/dist/contract.js

@@ -0,0 +1,3 @@
+export * from './decompressor';
+export * from './deflate';
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC"}

package/dist/decompressor.d.ts

@@ -0,0 +1,6 @@
+import type { Compression, Decompressor } from '@flighthq/types/contract';
+export declare function getDecompressor(compression: Compression): Decompressor | null;
+export declare function hasDecompressor(compression: Compression): boolean;
+export declare function registerDecompressor(compression: Compression, decompress: Decompressor): void;
+export declare function unregisterDecompressor(compression: Compression): void;
+//# sourceMappingURL=decompressor.d.ts.map

package/dist/decompressor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decompressor.d.ts","sourceRoot":"","sources":["../src/decompressor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAU1E,wBAAgB,eAAe,CAAC,WAAW,EAAE,WAAW,GAAG,YAAY,GAAG,IAAI,CAE7E;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAEjE;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,GAAG,IAAI,CAE7F;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAErE"}

package/dist/decompressor.js

@@ -0,0 +1,22 @@
+// The one registry every container format resolves through. A caller registers an algorithm once and
+// every consumer that carries a compressed body — SWF's `CWS`/`ZWS`, AWD2's compressed blocks, anything
+// added later — can read it, rather than each format owning a private registry keyed by its own
+// vocabulary and asking the caller to register the same function twice.
+//
+// It starts empty and is only ever filled by an explicit `register*` call, so importing a codec module
+// registers nothing and a build that never decompresses pays for no codec. Registration is
+// last-write-wins, which is what lets a host replace a portable decoder with a native or wasm one.
+export function getDecompressor(compression) {
+    return _decompressors.get(compression) ?? null;
+}
+export function hasDecompressor(compression) {
+    return _decompressors.has(compression);
+}
+export function registerDecompressor(compression, decompress) {
+    _decompressors.set(compression, decompress);
+}
+export function unregisterDecompressor(compression) {
+    _decompressors.delete(compression);
+}
+const _decompressors = new Map();
+//# sourceMappingURL=decompressor.js.map

package/dist/decompressor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decompressor.js","sourceRoot":"","sources":["../src/decompressor.ts"],"names":[],"mappings":"AAEA,qGAAqG;AACrG,wGAAwG;AACxG,gGAAgG;AAChG,wEAAwE;AACxE,EAAE;AACF,uGAAuG;AACvG,2FAA2F;AAC3F,mGAAmG;AACnG,MAAM,UAAU,eAAe,CAAC,WAAwB;IACtD,OAAO,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,WAAwB;IACtD,OAAO,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,WAAwB,EAAE,UAAwB;IACrF,cAAc,CAAC,GAAG,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,WAAwB;IAC7D,cAAc,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,cAAc,GAAG,IAAI,GAAG,EAA6B,CAAC"}

package/dist/deflate.d.ts

@@ -0,0 +1,4 @@
+import type { Decompressor } from '@flighthq/types/contract';
+export declare const inflateDeflate: Decompressor;
+export declare function registerDeflateDecompressor(): void;
+//# sourceMappingURL=deflate.d.ts.map

package/dist/deflate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deflate.d.ts","sourceRoot":"","sources":["../src/deflate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAe7D,eAAO,MAAM,cAAc,EAAE,YAc5B,CAAC;AAKF,wBAAgB,2BAA2B,IAAI,IAAI,CAElD"}

package/dist/deflate.js

@@ -0,0 +1,258 @@
+import { Compression } from '@flighthq/types/contract';
+import { registerDecompressor } from './decompressor';
+// Dependency-free, synchronous RFC 1951 (DEFLATE) and RFC 1950 (zlib) decoding. Kept in its own module so
+// the registry stays tree-shakable: a bundle that never calls `registerDeflateDecompressor` pays nothing
+// for this Huffman decoder. Sync because inflate is a straight-line state machine, which keeps every
+// synchronous parser that resolves through the registry synchronous too; a host with a faster native or
+// wasm codec registers that instead.
+//
+// Real containers mix the two framings — SWF's `CWS` body and Away3D's `ByteArray.compress()` are zlib
+// (a 2-byte header, the DEFLATE stream, an Adler-32), while other producers emit the bare stream — so a
+// zlib header is detected and skipped when present and the input is otherwise read as raw DEFLATE.
+// `uncompressedLength` is unused: DEFLATE encodes its own end and the output buffer grows to fit.
+export const inflateDeflate = (compressed) => {
+    const input = compressed;
+    // A zlib header: the low nibble of CMF is the compression method (8 = deflate) and the big-endian
+    // (CMF,FLG) pair is a multiple of 31. A preset dictionary (FDICT) is not supported.
+    let start = 0;
+    if (input.length >= 2 && (input[0] & 0x0f) === 8 && (((input[0] << 8) | input[1]) & 0xffff) % 31 === 0) {
+        if ((input[1] & 0x20) !== 0)
+            return null;
+        start = 2;
+    }
+    try {
+        return rawInflate(input, start);
+    }
+    catch {
+        return null;
+    }
+};
+// Registers `inflateDeflate` for `Compression.Deflate`, which is what lets every consumer read a
+// zlib-or-raw compressed body. Opt-in, so the codec is only bundled when a caller asks for it.
+// Idempotent; last registration wins.
+export function registerDeflateDecompressor() {
+    registerDecompressor(Compression.Deflate, inflateDeflate);
+}
+// RFC 1951 length codes 257-285: the base copy length and the number of extra bits that follow.
+const LENGTH_BASE = [
+    3, 4, 5, 6, 7, 8, 9, 10, 11, 13, 15, 17, 19, 23, 27, 31, 35, 43, 51, 59, 67, 83, 99, 115, 131, 163, 195, 227, 258,
+];
+const LENGTH_EXTRA = [0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 2, 2, 2, 2, 3, 3, 3, 3, 4, 4, 4, 4, 5, 5, 5, 5, 0];
+// RFC 1951 distance codes 0-29: the base back-distance and the number of extra bits that follow.
+const DISTANCE_BASE = [
+    1, 2, 3, 4, 5, 7, 9, 13, 17, 25, 33, 49, 65, 97, 129, 193, 257, 385, 513, 769, 1025, 1537, 2049, 3073, 4097, 6145,
+    8193, 12289, 16385, 24577,
+];
+const DISTANCE_EXTRA = [
+    0, 0, 0, 0, 1, 1, 2, 2, 3, 3, 4, 4, 5, 5, 6, 6, 7, 7, 8, 8, 9, 9, 10, 10, 11, 11, 12, 12, 13, 13,
+];
+// The order in which the 19 code-length-code lengths are written in a dynamic-Huffman block header.
+const CODE_LENGTH_ORDER = [16, 17, 18, 0, 8, 7, 9, 6, 10, 5, 11, 4, 12, 3, 13, 2, 14, 1, 15];
+// An LSB-first bit reader over the DEFLATE stream, plus the growable output buffer. Throwing on overrun
+// keeps the decode a straight line; inflateAwdDeflate turns the throw into a null return.
+class InflateState {
+    input;
+    position;
+    bitBuffer = 0;
+    bitCount = 0;
+    output = new Uint8Array(1024);
+    outputLength = 0;
+    constructor(input, position) {
+        this.input = input;
+        this.position = position;
+    }
+    readBit() {
+        if (this.bitCount === 0) {
+            if (this.position >= this.input.length)
+                throw new Error('deflate: read past end of stream');
+            this.bitBuffer = this.input[this.position++];
+            this.bitCount = 8;
+        }
+        const bit = this.bitBuffer & 1;
+        this.bitBuffer >>= 1;
+        this.bitCount--;
+        return bit;
+    }
+    readBits(count, base) {
+        let value = 0;
+        for (let i = 0; i < count; i++)
+            value |= this.readBit() << i;
+        return value + base;
+    }
+    writeByte(byte) {
+        if (this.outputLength >= this.output.length) {
+            // Every other bound in this package is a field checked against the buffer. This one cannot be:
+            // the quantity that sizes the allocation is the COMPRESSION RATIO, which is not in the file, is
+            // not bounded by its length, and no per-field check can reach it. A kilobyte of nested maximum-
+            // length back-references expands to gigabytes and takes the process with it — unrecoverable, and
+            // reachable from any untrusted .awd. Where the file cannot bound the allocation, an explicit cap
+            // has to.
+            if (this.output.length * 2 > MAX_INFLATE_BYTES)
+                throw new Error('deflate: output exceeds the inflate limit');
+            const grown = new Uint8Array(this.output.length * 2);
+            grown.set(this.output);
+            this.output = grown;
+        }
+        this.output[this.outputLength++] = byte;
+    }
+}
+// Inflates the raw DEFLATE block stream at `start`, returning exactly the decompressed bytes.
+function rawInflate(input, start) {
+    const state = new InflateState(input, start);
+    let final = 0;
+    do {
+        final = state.readBit();
+        const type = state.readBits(2, 0);
+        if (type === 0)
+            inflateStoredBlock(state);
+        else if (type === 1)
+            inflateHuffmanBlock(state, FIXED_LITERAL_TREE, FIXED_DISTANCE_TREE);
+        else if (type === 2)
+            inflateDynamicBlock(state);
+        else
+            throw new Error('deflate: invalid block type');
+    } while (final === 0);
+    return state.output.slice(0, state.outputLength);
+}
+// A stored (uncompressed) block: align to the next byte, read the 16-bit LEN and its one's-complement
+// NLEN, then copy LEN literal bytes.
+function inflateStoredBlock(state) {
+    state.bitBuffer = 0;
+    state.bitCount = 0;
+    if (state.position + 4 > state.input.length)
+        throw new Error('deflate: truncated stored block header');
+    const len = state.input[state.position] | (state.input[state.position + 1] << 8);
+    const nlen = state.input[state.position + 2] | (state.input[state.position + 3] << 8);
+    state.position += 4;
+    if ((len ^ 0xffff) !== nlen)
+        throw new Error('deflate: stored block length mismatch');
+    if (state.position + len > state.input.length)
+        throw new Error('deflate: truncated stored block data');
+    for (let i = 0; i < len; i++)
+        state.writeByte(state.input[state.position++]);
+}
+// Decodes one Huffman-coded block against the given literal/length and distance trees, emitting literals
+// and resolving <length, distance> back-references against the bytes already written.
+function inflateHuffmanBlock(state, literalTree, distanceTree) {
+    for (;;) {
+        const symbol = decodeSymbol(state, literalTree);
+        if (symbol === 256)
+            return; // end of block
+        if (symbol < 256) {
+            state.writeByte(symbol);
+            continue;
+        }
+        const lengthIndex = symbol - 257;
+        if (lengthIndex >= LENGTH_BASE.length)
+            throw new Error('deflate: invalid length symbol');
+        const length = state.readBits(LENGTH_EXTRA[lengthIndex], LENGTH_BASE[lengthIndex]);
+        const distanceSymbol = decodeSymbol(state, distanceTree);
+        if (distanceSymbol >= DISTANCE_BASE.length)
+            throw new Error('deflate: invalid distance symbol');
+        const distance = state.readBits(DISTANCE_EXTRA[distanceSymbol], DISTANCE_BASE[distanceSymbol]);
+        let source = state.outputLength - distance;
+        if (source < 0)
+            throw new Error('deflate: back-reference before start of output');
+        for (let i = 0; i < length; i++)
+            state.writeByte(state.output[source++]);
+    }
+}
+// Builds the dynamic literal/length and distance Huffman trees from the block header (their code lengths
+// are themselves Huffman-coded by a code-length code), then decodes the block.
+function inflateDynamicBlock(state) {
+    const literalCount = state.readBits(5, 257);
+    const distanceCount = state.readBits(5, 1);
+    const codeLengthCount = state.readBits(4, 4);
+    const codeLengthLengths = new Array(19).fill(0);
+    for (let i = 0; i < codeLengthCount; i++)
+        codeLengthLengths[CODE_LENGTH_ORDER[i]] = state.readBits(3, 0);
+    const codeLengthTree = buildHuffmanTree(codeLengthLengths, 19);
+    // Decode the literal+distance code lengths as one run, honoring the repeat codes 16 (copy previous
+    // 3-6×), 17 (zero 3-10×), and 18 (zero 11-138×).
+    const lengths = new Array(literalCount + distanceCount).fill(0);
+    let i = 0;
+    while (i < lengths.length) {
+        const symbol = decodeSymbol(state, codeLengthTree);
+        if (symbol < 16) {
+            lengths[i++] = symbol;
+        }
+        else if (symbol === 16) {
+            if (i === 0)
+                throw new Error('deflate: repeat with no previous length');
+            const repeat = state.readBits(2, 3);
+            const previous = lengths[i - 1];
+            for (let r = 0; r < repeat && i < lengths.length; r++)
+                lengths[i++] = previous;
+        }
+        else if (symbol === 17) {
+            const repeat = state.readBits(3, 3);
+            for (let r = 0; r < repeat && i < lengths.length; r++)
+                lengths[i++] = 0;
+        }
+        else if (symbol === 18) {
+            const repeat = state.readBits(7, 11);
+            for (let r = 0; r < repeat && i < lengths.length; r++)
+                lengths[i++] = 0;
+        }
+        else {
+            throw new Error('deflate: invalid code-length symbol');
+        }
+    }
+    const literalTree = buildHuffmanTree(lengths.slice(0, literalCount), literalCount);
+    const distanceTree = buildHuffmanTree(lengths.slice(literalCount), distanceCount);
+    inflateHuffmanBlock(state, literalTree, distanceTree);
+}
+// Builds a canonical Huffman decode tree from per-symbol code lengths (0 = unused). Symbols are bucketed
+// by length so decodeSymbol can walk the code space one bit at a time.
+function buildHuffmanTree(lengths, count) {
+    const counts = new Array(16).fill(0);
+    for (let i = 0; i < count; i++)
+        counts[lengths[i]]++;
+    counts[0] = 0;
+    const offsets = new Array(16).fill(0);
+    for (let len = 1; len < 16; len++)
+        offsets[len] = offsets[len - 1] + counts[len - 1];
+    const symbols = new Array(count).fill(0);
+    for (let i = 0; i < count; i++) {
+        if (lengths[i] !== 0)
+            symbols[offsets[lengths[i]]++] = i;
+    }
+    return { counts, symbols };
+}
+// Reads bits until they identify one canonical Huffman symbol (the tinf decode: extend the code one bit
+// at a time, subtracting each length's code count until the code falls within a bucket).
+function decodeSymbol(state, tree) {
+    let code = 0;
+    let first = 0;
+    let index = 0;
+    for (let len = 1; len < 16; len++) {
+        code |= state.readBit();
+        const count = tree.counts[len];
+        if (code - first < count)
+            return tree.symbols[index + (code - first)];
+        index += count;
+        first += count;
+        first <<= 1;
+        code <<= 1;
+    }
+    throw new Error('deflate: invalid Huffman code');
+}
+// The RFC 1951 fixed Huffman trees: literals/lengths 0-287 (lengths 8/9/7/8 by range) and 5-bit distances.
+const FIXED_LITERAL_TREE = buildFixedLiteralTree();
+const FIXED_DISTANCE_TREE = buildHuffmanTree(new Array(30).fill(5), 30);
+function buildFixedLiteralTree() {
+    const lengths = new Array(288);
+    for (let i = 0; i < 144; i++)
+        lengths[i] = 8;
+    for (let i = 144; i < 256; i++)
+        lengths[i] = 9;
+    for (let i = 256; i < 280; i++)
+        lengths[i] = 7;
+    for (let i = 280; i < 288; i++)
+        lengths[i] = 8;
+    return buildHuffmanTree(lengths, 288);
+}
+// The ceiling on a single inflate. Generous for any real AWD body — a 256 MB scene is far past what
+// this importer is used for — and small enough that hitting it fails a parse instead of the process.
+const MAX_INFLATE_BYTES = 256 * 1024 * 1024;
+//# sourceMappingURL=deflate.js.map

package/dist/deflate.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { inflateDeflate, registerDeflateDecompressor } from './deflate';
+export { getDecompressor, hasDecompressor, registerDecompressor, unregisterDecompressor } from './decompressor';
+//# 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":"AAAA,OAAO,EAAE,cAAc,EAAE,2BAA2B,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { inflateDeflate, registerDeflateDecompressor } from './deflate';
+export { getDecompressor, hasDecompressor, registerDecompressor, unregisterDecompressor } from './decompressor';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,2BAA2B,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@flighthq/compression",
+  "version": "0.3.0-next.1494.7333e82",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flighthq/flight.git",
+    "directory": "packages/compression"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./contract": {
+      "types": "./dist/contract.d.ts",
+      "default": "./dist/contract.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/types": "0.3.0-next.1494.7333e82"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Compressed-byte decoders and the shared decompressor registry consumers resolve through",
+  "sideEffects": false
+}

package/src/decompressor.test.ts

@@ -0,0 +1,58 @@
+import { Compression } from '@flighthq/types/contract';
+
+import { getDecompressor, hasDecompressor, registerDecompressor, unregisterDecompressor } from './decompressor';
+
+describe('getDecompressor', () => {
+  it('reports nothing registered rather than throwing', () => {
+    expect(getDecompressor(Compression.Deflate)).toBeNull();
+    expect(getDecompressor(Compression.Lzma)).toBeNull();
+  });
+});
+
+describe('hasDecompressor', () => {
+  afterEach(() => unregisterDecompressor(Compression.Lzma));
+
+  it('answers without handing back the implementation', () => {
+    expect(hasDecompressor(Compression.Lzma)).toBe(false);
+    registerDecompressor(Compression.Lzma, () => null);
+    expect(hasDecompressor(Compression.Lzma)).toBe(true);
+  });
+});
+
+describe('registerDecompressor', () => {
+  afterEach(() => {
+    unregisterDecompressor(Compression.Deflate);
+    unregisterDecompressor(Compression.Lzma);
+  });
+
+  it('registers per algorithm, last write winning', () => {
+    const first = (): Uint8Array => new Uint8Array([1]);
+    const second = (): Uint8Array => new Uint8Array([2]);
+
+    registerDecompressor(Compression.Deflate, first);
+    expect(getDecompressor(Compression.Deflate)).toBe(first);
+    // A host replacing a portable decoder with a native or wasm one relies on last-write-wins.
+    registerDecompressor(Compression.Deflate, second);
+    expect(getDecompressor(Compression.Deflate)).toBe(second);
+    // Registering one algorithm leaves the others alone.
+    expect(getDecompressor(Compression.Lzma)).toBeNull();
+  });
+
+  it('serves every consumer from the one registration', () => {
+    const decompress = (): Uint8Array => new Uint8Array([7]);
+    registerDecompressor(Compression.Deflate, decompress);
+
+    // Whatever container asks — a SWF body, an AWD2 block — resolves the same implementation.
+    expect(getDecompressor(Compression.Deflate)).toBe(decompress);
+    expect(getDecompressor(Compression.Deflate)).toBe(getDecompressor(Compression.Deflate));
+  });
+});
+
+describe('unregisterDecompressor', () => {
+  it('removes a registration and is safe when none exists', () => {
+    registerDecompressor(Compression.Deflate, () => new Uint8Array());
+    unregisterDecompressor(Compression.Deflate);
+    expect(getDecompressor(Compression.Deflate)).toBeNull();
+    expect(() => unregisterDecompressor(Compression.Deflate)).not.toThrow();
+  });
+});

package/src/deflate.test.ts

@@ -0,0 +1,120 @@
+import { Compression } from '@flighthq/types/contract';
+
+import { getDecompressor, unregisterDecompressor } from './decompressor';
+import { inflateDeflate, registerDeflateDecompressor } from './deflate';
+
+// The compressed fixtures below are precomputed with Node's zlib and embedded as base64 rather than
+// generated at test time: `scene-formats` is a browser-clean package whose build carries no `@types/node`,
+// so a `node:zlib` import fails the `tsc -b` build. Provenance — generated once with node v22.22.1:
+//   const b64 = (u8) => Buffer.from(u8).toString('base64');
+//   const enc = (s) => new TextEncoder().encode(s);
+//   b64(deflateSync(new Uint8Array(0)))                                         // EMPTY
+//   b64(deflateSync(enc('flighthq scene-formats')))                            // LITERAL (zlib)
+//   b64(deflateRawSync(enc('flighthq scene-formats')))                         // RAW_LITERAL (headerless)
+//   b64(deflateSync(enc('abcABC123'.repeat(600))))                            // REPETITIVE
+//   b64(deflateSync(enc('Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore. '.repeat(12)))) // LOREM (genuine dynamic-Huffman block)
+//   b64(deflateSync(enc('the quick brown fox jumps over the lazy dog'), { level: 0 }))  // STORED_L0
+// The round-trip assertions still verify the vendored inflater reproduces the original bytes EXACTLY.
+const LOREM = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore. ';
+const FIXTURES = {
+  EMPTY: 'eJwDAAAAAAE=',
+  // 64 KB of a repeating byte run, zlib-deflated: 124 bytes expanding 528x — a high but honest ratio.
+  HIGH_RATIO:
+    'eJztxbEBADAEADC0/H+yQyRLIuv9npAkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIkSZIk3W4BATsAKQ==',
+  LITERAL: 'eJxLy8lMzyjJKFQoTk7NS9VNyy/KTSwpBgBjVQiv',
+  RAW_LITERAL: 'S8vJTM8oyShUKE5OzUvVTcsvyk0sKQYA',
+  REPETITIVE: 'eJztxjEBACAIALBMYgIxCdC/g0HcrlXPybtil4iIiIiIiIiIiMgfeU6Y4Pw=',
+  LOREM:
+    'eJztzdENQyEMQ9FVPEDVSd4SlESVJUIQSfYvQ/STb+v6PL7VwBVlEB++EUw003yh+wztqVkbTbgYnfMLHTxjqJwAygpzQaqtE3N2CqVmohKjfc79G89FLnKRi/wX+QG1gr9k',
+  STORED_L0: 'eAEBKwDU/3RoZSBxdWljayBicm93biBmb3gganVtcHMgb3ZlciB0aGUgbGF6eSBkb2dhPA/6',
+} as const;
+
+// Decodes a base64 string to bytes with no external dependency (no `atob`/`Buffer`) so the test stays
+// browser-clean. The embedded fixtures are canonical base64 (no whitespace, standard alphabet).
+function decodeBase64(input: string): Uint8Array {
+  const alphabet = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
+  const lookup = new Uint8Array(128);
+  for (let i = 0; i < alphabet.length; i++) lookup[alphabet.charCodeAt(i)] = i;
+  const clean = input.replace(/=+$/, '');
+  const out = new Uint8Array((clean.length * 3) >> 2);
+  let accumulator = 0;
+  let bits = 0;
+  let o = 0;
+  for (let i = 0; i < clean.length; i++) {
+    accumulator = (accumulator << 6) | lookup[clean.charCodeAt(i)];
+    bits += 6;
+    if (bits >= 8) {
+      bits -= 8;
+      out[o++] = (accumulator >> bits) & 0xff;
+    }
+  }
+  return out;
+}
+
+const encode = (s: string): Uint8Array => new TextEncoder().encode(s);
+
+describe('inflateDeflate', () => {
+  it('round-trips empty input', () => {
+    expect(inflateDeflate(decodeBase64(FIXTURES.EMPTY), 0)).toEqual(new Uint8Array(0));
+  });
+
+  it('keeps inflating a stream whose expansion ratio is large but bounded', () => {
+    // The inflate cap must not fire on real content. AWD bodies are float arrays with long repeating
+    // runs, so a high ratio is ORDINARY here — the cap is for a ratio that is unbounded, not merely
+    // large, and one that rejected honest compression would be worse than the bomb it prevents. This
+    // fixture is 124 bytes expanding 528x to 64 KB, and must still round-trip byte for byte.
+    const source = new Uint8Array(64 * 1024);
+    for (let i = 0; i < source.length; i++) source[i] = i % 7;
+    expect(inflateDeflate(decodeBase64(FIXTURES.HIGH_RATIO), 0)).toEqual(source);
+  });
+
+  it('round-trips a short literal run (zlib-wrapped)', () => {
+    expect(inflateDeflate(decodeBase64(FIXTURES.LITERAL), 0)).toEqual(encode('flighthq scene-formats'));
+  });
+
+  it('round-trips a headerless raw DEFLATE stream via the fallback path', () => {
+    expect(inflateDeflate(decodeBase64(FIXTURES.RAW_LITERAL), 0)).toEqual(encode('flighthq scene-formats'));
+  });
+
+  it('round-trips highly repetitive data through back-references and grows the output buffer', () => {
+    // 5400 bytes out — past the 1024-byte initial buffer, exercising the grow path.
+    expect(inflateDeflate(decodeBase64(FIXTURES.REPETITIVE), 0)).toEqual(encode('abcABC123'.repeat(600)));
+  });
+
+  it('round-trips prose through a genuine dynamic-Huffman block', () => {
+    // Verified offline that zlib emits BTYPE=2 (dynamic Huffman) for this input, exercising the
+    // dynamic literal/length + distance code-length decode path.
+    expect(inflateDeflate(decodeBase64(FIXTURES.LOREM), 0)).toEqual(encode(LOREM.repeat(12)));
+  });
+
+  it('round-trips a stored (level 0) block', () => {
+    expect(inflateDeflate(decodeBase64(FIXTURES.STORED_L0), 0)).toEqual(
+      encode('the quick brown fox jumps over the lazy dog'),
+    );
+  });
+
+  it('returns null on a truncated stream rather than throwing', () => {
+    expect(inflateDeflate(decodeBase64(FIXTURES.REPETITIVE).subarray(0, 6), 0)).toBeNull();
+  });
+
+  it('returns null on a corrupt (invalid block type) stream', () => {
+    // 0x78 0x9c is a valid zlib header; 0xff 0xff after it decodes an invalid block type.
+    expect(inflateDeflate(new Uint8Array([0x78, 0x9c, 0xff, 0xff]), 0)).toBeNull();
+  });
+});
+
+describe('registerDeflateDecompressor', () => {
+  afterEach(() => unregisterDecompressor(Compression.Deflate));
+
+  it('puts the inflater in the shared registry every consumer resolves through', () => {
+    expect(getDecompressor(Compression.Deflate)).toBeNull();
+
+    registerDeflateDecompressor();
+
+    // One registration is what every container format reads through — none of them owns its own registry.
+    expect(getDecompressor(Compression.Deflate)).toBe(inflateDeflate);
+    expect(getDecompressor(Compression.Deflate)?.(decodeBase64(FIXTURES.LITERAL), 0)).toEqual(
+      encode('flighthq scene-formats'),
+    );
+  });
+});