@myrialabs/zipkit 0.0.6

package/dist/detect.js

@@ -0,0 +1,86 @@
+/**
+ * Format auto-detection from magic bytes.
+ *
+ * Recognizes the container/codec of a buffer by inspecting its header. Two
+ * groups are reported:
+ *
+ * - **Directly decompressible** by {@link import('./compress.js').decompress}:
+ *   gzip, zlib, zstd.
+ * - **Recognized but not auto-decoded here** — ZIP and the standard external
+ *   framings (tar, xz, 7z, standard bzip2, the LZ4 *frame*). These need a
+ *   dedicated reader (\`@myrialabs/zipkit/zip\`, \`@myrialabs/zipkit/tar\`, …) or an explicit codec, so
+ *   {@link import('./compress.js').decompress} points you at the right API
+ *   rather than guessing.
+ *
+ * ZipKit's own brotli, snappy, raw LZ4 *block*, and length-prefixed lzma/bzip2
+ * streams have no leading magic and return `undefined`; decode them with an
+ * explicit codec via `decompressWith`.
+ */
+/** Formats {@link import('./compress.js').decompress} can decode directly. */
+const DIRECT = new Set(['gzip', 'zlib', 'zstd']);
+/** Whether {@link decompress} can reverse a detected format without extra API. */
+export function isDirectlyDecompressible(fmt) {
+    return DIRECT.has(fmt);
+}
+/**
+ * Identify the format of a buffer, or `undefined` if it has no recognizable
+ * signature.
+ *
+ * Detectable: **gzip, zlib, zstd, ZIP, tar, xz, 7z, standard bzip2, and the LZ4
+ * frame**. Headerless or ZipKit-framed codecs — brotli, snappy, the raw LZ4
+ * *block* written by {@link import('./codecs/lz4.js').lz4}, and the
+ * length-prefixed lzma/bzip2 streams ZipKit emits — have no leading magic and
+ * return `undefined`; decode them with an explicit codec via `decompressWith`.
+ *
+ * @example
+ * ```ts
+ * detectFormat(gzipBytes);   // 'gzip'
+ * detectFormat(zipBytes);    // 'zip'
+ * detectFormat(tarBytes);    // 'tar'
+ * detectFormat(brotliBytes); // undefined
+ * ```
+ */
+export function detectFormat(data) {
+    if (data.length < 2)
+        return undefined;
+    const b0 = data[0];
+    const b1 = data[1];
+    // gzip — 1f 8b
+    if (b0 === 0x1f && b1 === 0x8b)
+        return 'gzip';
+    // ZIP — "PK\x03\x04" (local file header) or "PK\x05\x06" (empty archive EOCD)
+    if (b0 === 0x50 && b1 === 0x4b && (data[2] === 0x03 || data[2] === 0x05)) {
+        return 'zip';
+    }
+    // zstd — little-endian magic 0xFD2FB528
+    if (b0 === 0x28 && b1 === 0xb5 && data[2] === 0x2f && data[3] === 0xfd)
+        return 'zstd';
+    // xz — FD "7zXZ" 00
+    if (b0 === 0xfd && b1 === 0x37 && data[2] === 0x7a && data[3] === 0x58 && data[4] === 0x5a && data[5] === 0x00) {
+        return 'xz';
+    }
+    // 7z — "7z" BC AF 27 1C
+    if (b0 === 0x37 && b1 === 0x7a && data[2] === 0xbc && data[3] === 0xaf && data[4] === 0x27 && data[5] === 0x1c) {
+        return '7z';
+    }
+    // LZ4 frame — 04 22 4D 18 (the standard frame, not ZipKit's raw block)
+    if (b0 === 0x04 && b1 === 0x22 && data[2] === 0x4d && data[3] === 0x18)
+        return 'lz4-frame';
+    // Standard bzip2 — "BZh" then a 1–9 block-size digit. ZipKit's own bzip2()
+    // emits a length-prefixed frame, not this, so its output won't match here.
+    if (b0 === 0x42 && b1 === 0x5a && data[2] === 0x68 && data[3] >= 0x31 && data[3] <= 0x39) {
+        return 'bzip2';
+    }
+    // tar (ustar) — "ustar" magic at offset 257 of the first 512-byte header.
+    if (data.length >= 263 && data[257] === 0x75 && data[258] === 0x73 && data[259] === 0x74 && data[260] === 0x61 && data[261] === 0x72) {
+        return 'tar';
+    }
+    // zlib — CMF/FLG: low nibble of CMF is 8 (deflate) and the 16-bit header is
+    // a multiple of 31. Checked last because the test is structural, not a fixed
+    // magic, so it must not shadow the signatures above.
+    if ((b0 & 0x0f) === 0x08 && (b0 >> 4) <= 7 && ((b0 << 8) | b1) % 31 === 0) {
+        return 'zlib';
+    }
+    return undefined;
+}
+//# sourceMappingURL=detect.js.map

package/dist/detect.js.map

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

package/dist/dictionary.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Zstd dictionary compression — the big win for many small, *similar* payloads
+ * (log lines, JSON records, RPC messages, chat-history entries). Train a
+ * dictionary once from representative samples, then compress each small payload
+ * against it: the shared structure lives in the dictionary instead of being
+ * repeated in every frame, so tiny inputs shrink dramatically.
+ *
+ * Backed by the engine's `ZDICT_trainFromBuffer` + `ZSTD_*_usingDict`. The
+ * resulting frames are standard zstd-with-dictionary — interoperable with any
+ * zstd that is given the same dictionary.
+ *
+ * @example
+ * ```ts
+ * import { trainDictionary, compressWithDictionary, decompressWithDictionary } from '@myrialabs/zipkit';
+ * const dict = await trainDictionary(logLines);          // Uint8Array[]
+ * const packed = await compressWithDictionary(oneLine, dict);
+ * const back = await decompressWithDictionary(packed, dict);
+ * ```
+ */
+import type { CompressOptions, DecompressOptions } from './types.js';
+/** Options for {@link trainDictionary}. */
+export interface TrainOptions {
+    /** Target dictionary size in bytes (default 112 640 — zstd's own default). */
+    maxSize?: number;
+}
+/**
+ * Train a zstd dictionary from representative `samples`. More, smaller samples
+ * that share structure train a better dictionary; zstd recommends at least ~100
+ * samples. Throws {@link ZipKitError} if training fails (typically too few or
+ * too-uniform samples).
+ */
+export declare function trainDictionary(samples: Uint8Array[], opts?: TrainOptions): Promise<Uint8Array>;
+/** Compress `data` against `dict`. Level follows the usual zstd 1–22 scale. */
+export declare function compressWithDictionary(data: Uint8Array, dict: Uint8Array, opts?: CompressOptions): Promise<Uint8Array>;
+/** Decompress `data` produced by {@link compressWithDictionary} with the same `dict`. */
+export declare function decompressWithDictionary(data: Uint8Array, dict: Uint8Array, opts?: DecompressOptions): Promise<Uint8Array>;
+//# sourceMappingURL=dictionary.d.ts.map

package/dist/dictionary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictionary.d.ts","sourceRoot":"","sources":["../src/dictionary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAErE,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC5B,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAwBrG;AAED,+EAA+E;AAC/E,wBAAsB,sBAAsB,CAC3C,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,UAAU,EAChB,IAAI,CAAC,EAAE,eAAe,GACpB,OAAO,CAAC,UAAU,CAAC,CAOrB;AAED,yFAAyF;AACzF,wBAAsB,wBAAwB,CAC7C,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,UAAU,EAChB,IAAI,CAAC,EAAE,iBAAiB,GACtB,OAAO,CAAC,UAAU,CAAC,CAMrB"}

package/dist/dictionary.js

@@ -0,0 +1,71 @@
+/**
+ * Zstd dictionary compression — the big win for many small, *similar* payloads
+ * (log lines, JSON records, RPC messages, chat-history entries). Train a
+ * dictionary once from representative samples, then compress each small payload
+ * against it: the shared structure lives in the dictionary instead of being
+ * repeated in every frame, so tiny inputs shrink dramatically.
+ *
+ * Backed by the engine's `ZDICT_trainFromBuffer` + `ZSTD_*_usingDict`. The
+ * resulting frames are standard zstd-with-dictionary — interoperable with any
+ * zstd that is given the same dictionary.
+ *
+ * @example
+ * ```ts
+ * import { trainDictionary, compressWithDictionary, decompressWithDictionary } from '@myrialabs/zipkit';
+ * const dict = await trainDictionary(logLines);          // Uint8Array[]
+ * const packed = await compressWithDictionary(oneLine, dict);
+ * const back = await decompressWithDictionary(packed, dict);
+ * ```
+ */
+import { getEngine } from './engine.js';
+import { levelForMode, runAsync } from './internal.js';
+import { ZipKitError } from './types.js';
+/**
+ * Train a zstd dictionary from representative `samples`. More, smaller samples
+ * that share structure train a better dictionary; zstd recommends at least ~100
+ * samples. Throws {@link ZipKitError} if training fails (typically too few or
+ * too-uniform samples).
+ */
+export async function trainDictionary(samples, opts) {
+    if (samples.length === 0)
+        throw new ZipKitError('trainDictionary needs at least one sample');
+    const e = await getEngine();
+    const maxSize = opts?.maxSize ?? 112_640;
+    // Concatenate the samples and build the parallel u32-LE size table.
+    let total = 0;
+    for (const s of samples)
+        total += s.length;
+    const concat = new Uint8Array(total);
+    const sizes = new Uint8Array(samples.length * 4);
+    const sizeView = new DataView(sizes.buffer);
+    let off = 0;
+    for (let i = 0; i < samples.length; i++) {
+        concat.set(samples[i], off);
+        sizeView.setUint32(i * 4, samples[i].length, true);
+        off += samples[i].length;
+    }
+    e.setAux(sizes); // staged size table for the trainer
+    const dict = e.zstdTrainDict(concat, samples.length, maxSize);
+    if (dict.length === 0) {
+        throw new ZipKitError('Dictionary training failed — provide more, more varied samples');
+    }
+    return dict;
+}
+/** Compress `data` against `dict`. Level follows the usual zstd 1–22 scale. */
+export async function compressWithDictionary(data, dict, opts) {
+    const e = await getEngine();
+    const level = levelForMode(opts, 1, 22, { speed: 3, balanced: 19, ratio: 22 });
+    return runAsync(() => {
+        e.setAux(dict);
+        return e.zstdCompressDict(data, level);
+    }, opts, data.length);
+}
+/** Decompress `data` produced by {@link compressWithDictionary} with the same `dict`. */
+export async function decompressWithDictionary(data, dict, opts) {
+    const e = await getEngine();
+    return runAsync(() => {
+        e.setAux(dict);
+        return e.zstdDecompressDict(data);
+    }, opts, data.length);
+}
+//# sourceMappingURL=dictionary.js.map

package/dist/dictionary.js.map

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

package/dist/engine.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Loader for the unified ZipKit Wasm engine (Emscripten ES module).
+ *
+ * One module, all codecs: gzip/deflate/zlib (libdeflate), lz4, zstd (+ ultra),
+ * brotli, snappy, lzma, bzip2, qoi (image), frame-delta (video). The ABI is
+ * deliberately tiny — persistent buffers, one copy in and one copy out per
+ * call, no allocation crossing the JS/Wasm boundary.
+ *
+ * The engine is the low-level escape hatch. Most users want the high-level
+ * {@link import('./zipkit.js').ZipKit} class or the named codec helpers from
+ * the package root; reach for `ZipKitEngine` only when you need raw codec
+ * access without runtime dispatch.
+ *
+ * @example
+ * ```ts
+ * import { ZipKitEngine } from '@myrialabs/zipkit/engine';
+ * const engine = await ZipKitEngine.load();
+ * const packed = engine.zstdCompress(bytes, 19);
+ * ```
+ */
+/**
+ * The raw Wasm engine: every codec exposed as a synchronous
+ * `Uint8Array -> Uint8Array` method. Construct it with the async
+ * {@link ZipKitEngine.load} factory (Wasm instantiation is async), or call
+ * {@link getEngine} for a process-wide lazily-instantiated singleton.
+ */
+export declare class ZipKitEngine {
+    private m;
+    private constructor();
+    /** Instantiate a fresh engine. Prefer {@link getEngine} to avoid reloading. */
+    static load(): Promise<ZipKitEngine>;
+    private call;
+    gzipCompress(d: Uint8Array, level?: number): Uint8Array;
+    gzipDecompress(d: Uint8Array): Uint8Array;
+    deflateCompress(d: Uint8Array, level?: number): Uint8Array;
+    deflateDecompress(d: Uint8Array): Uint8Array;
+    zlibCompress(d: Uint8Array, level?: number): Uint8Array;
+    zlibDecompress(d: Uint8Array): Uint8Array;
+    /**
+     * CRC-32 (IEEE 802.3) of `d`, optionally continuing from a prior `seed`.
+     * Returns the checksum directly — libdeflate's SIMD path, far faster than a
+     * byte-at-a-time table. Used by the ZIP container.
+     */
+    crc32(d: Uint8Array, seed?: number): number;
+    lz4Compress(d: Uint8Array): Uint8Array;
+    lz4Decompress(d: Uint8Array): Uint8Array;
+    zstdCompress(d: Uint8Array, level?: number): Uint8Array;
+    zstdDecompress(d: Uint8Array): Uint8Array;
+    brotliCompress(d: Uint8Array, quality?: number): Uint8Array;
+    brotliDecompress(d: Uint8Array): Uint8Array;
+    snappyCompress(d: Uint8Array): Uint8Array;
+    snappyDecompress(d: Uint8Array): Uint8Array;
+    /** Max-ratio zstd (ultra + long-distance matching), up to level 22. */
+    zstdMaxCompress(d: Uint8Array, level?: number): Uint8Array;
+    /** LZMA — highest general-purpose ratio. */
+    lzmaCompress(d: Uint8Array, level?: number): Uint8Array;
+    lzmaDecompress(d: Uint8Array): Uint8Array;
+    /**
+     * Decode a raw LZMA2 stream (used by the 7z reader). `prop` is the single
+     * LZMA2 dictionary-size property byte; `outSize` is the known unpacked size.
+     */
+    lzma2Decompress(d: Uint8Array, prop: number, outSize: number): Uint8Array;
+    /** xz — the standard `.xz` container around LZMA2 (full streaming codec). */
+    xzCompress(d: Uint8Array, level?: number): Uint8Array;
+    xzDecompress(d: Uint8Array): Uint8Array;
+    /**
+     * Stage `dict` into the engine's auxiliary buffer for the next dictionary
+     * call. Held until the next {@link setAux}, so set it immediately before
+     * {@link zstdCompressDict}/{@link zstdDecompressDict} or {@link zstdTrainDict}.
+     */
+    setAux(dict: Uint8Array): void;
+    /**
+     * Train a zstd dictionary of up to `dictCapacity` bytes from `samples`. Stage
+     * the per-sample sizes (u32 LE) via {@link setAux} first; `samples` is the
+     * concatenation of every sample. Returns the dictionary bytes (empty on
+     * failure, e.g. too few samples).
+     */
+    zstdTrainDict(samples: Uint8Array, nSamples: number, dictCapacity: number): Uint8Array;
+    /** Compress `d` with the dictionary previously staged via {@link setAux}. */
+    zstdCompressDict(d: Uint8Array, level?: number): Uint8Array;
+    /** Decompress `d` with the dictionary previously staged via {@link setAux}. */
+    zstdDecompressDict(d: Uint8Array): Uint8Array;
+    /** bzip2 — Burrows–Wheeler transform. */
+    bzip2Compress(d: Uint8Array, level?: number): Uint8Array;
+    bzip2Decompress(d: Uint8Array): Uint8Array;
+    /** QOI — lossless image (raw RGB/RGBA pixels in, QOI bytes out). */
+    qoiEncode(pixels: Uint8Array, width: number, height: number, channels: number): Uint8Array;
+    qoiDecode(d: Uint8Array): Uint8Array;
+    /**
+     * Frame-delta — lossless temporal predictor for video-like streams. Pair
+     * `encode -> zstd/lz4` on the way in and `lz4/zstd -> decode` on the way out.
+     */
+    frameDeltaEncode(d: Uint8Array, frameSize: number): Uint8Array;
+    frameDeltaDecode(d: Uint8Array, frameSize: number): Uint8Array;
+}
+/**
+ * Return the process-wide engine, instantiating the Wasm module on first call
+ * and reusing it thereafter. This is what every high-level helper uses, so the
+ * 1.4 MB module loads at most once per process.
+ */
+export declare function getEngine(): Promise<ZipKitEngine>;
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

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

package/dist/engine.js

@@ -0,0 +1,204 @@
+/**
+ * Loader for the unified ZipKit Wasm engine (Emscripten ES module).
+ *
+ * One module, all codecs: gzip/deflate/zlib (libdeflate), lz4, zstd (+ ultra),
+ * brotli, snappy, lzma, bzip2, qoi (image), frame-delta (video). The ABI is
+ * deliberately tiny — persistent buffers, one copy in and one copy out per
+ * call, no allocation crossing the JS/Wasm boundary.
+ *
+ * The engine is the low-level escape hatch. Most users want the high-level
+ * {@link import('./zipkit.js').ZipKit} class or the named codec helpers from
+ * the package root; reach for `ZipKitEngine` only when you need raw codec
+ * access without runtime dispatch.
+ *
+ * @example
+ * ```ts
+ * import { ZipKitEngine } from '@myrialabs/zipkit/engine';
+ * const engine = await ZipKitEngine.load();
+ * const packed = engine.zstdCompress(bytes, 19);
+ * ```
+ */
+import ZipKitModule from '../engine/dist/zipkit-engine.mjs';
+/**
+ * The raw Wasm engine: every codec exposed as a synchronous
+ * `Uint8Array -> Uint8Array` method. Construct it with the async
+ * {@link ZipKitEngine.load} factory (Wasm instantiation is async), or call
+ * {@link getEngine} for a process-wide lazily-instantiated singleton.
+ */
+export class ZipKitEngine {
+    m;
+    constructor(m) {
+        this.m = m;
+    }
+    /** Instantiate a fresh engine. Prefer {@link getEngine} to avoid reloading. */
+    static async load() {
+        const m = (await ZipKitModule());
+        return new ZipKitEngine(m);
+    }
+    call(fn, data) {
+        const m = this.m;
+        const p = m._zk_input_ptr(data.length);
+        m.HEAPU8.set(data, p);
+        fn(data.length);
+        const op = m._zk_result_ptr();
+        const ol = m._zk_result_len() >>> 0;
+        // slice() copies out of the (possibly growable) Wasm heap into a
+        // standalone buffer the caller owns.
+        return m.HEAPU8.slice(op, op + ol);
+    }
+    gzipCompress(d, level = 9) {
+        return this.call((l) => this.m._zk_gzip_compress(l, level), d);
+    }
+    gzipDecompress(d) {
+        return this.call((l) => this.m._zk_gzip_decompress(l), d);
+    }
+    deflateCompress(d, level = 9) {
+        return this.call((l) => this.m._zk_deflate_compress(l, level), d);
+    }
+    deflateDecompress(d) {
+        return this.call((l) => this.m._zk_deflate_decompress(l, 0), d);
+    }
+    zlibCompress(d, level = 9) {
+        return this.call((l) => this.m._zk_zlib_compress(l, level), d);
+    }
+    zlibDecompress(d) {
+        return this.call((l) => this.m._zk_zlib_decompress(l, 0), d);
+    }
+    /**
+     * CRC-32 (IEEE 802.3) of `d`, optionally continuing from a prior `seed`.
+     * Returns the checksum directly — libdeflate's SIMD path, far faster than a
+     * byte-at-a-time table. Used by the ZIP container.
+     */
+    crc32(d, seed = 0) {
+        const m = this.m;
+        const p = m._zk_input_ptr(d.length);
+        m.HEAPU8.set(d, p);
+        return m._zk_crc32(d.length, seed >>> 0) >>> 0;
+    }
+    lz4Compress(d) {
+        return this.call((l) => this.m._zk_lz4_compress(l), d);
+    }
+    lz4Decompress(d) {
+        return this.call((l) => this.m._zk_lz4_decompress(l), d);
+    }
+    zstdCompress(d, level = 19) {
+        return this.call((l) => this.m._zk_zstd_compress(l, level), d);
+    }
+    zstdDecompress(d) {
+        return this.call((l) => this.m._zk_zstd_decompress(l), d);
+    }
+    brotliCompress(d, quality = 11) {
+        return this.call((l) => this.m._zk_brotli_compress(l, quality), d);
+    }
+    brotliDecompress(d) {
+        return this.call((l) => this.m._zk_brotli_decompress(l), d);
+    }
+    snappyCompress(d) {
+        return this.call((l) => this.m._zk_snappy_compress(l), d);
+    }
+    snappyDecompress(d) {
+        return this.call((l) => this.m._zk_snappy_decompress(l), d);
+    }
+    /** Max-ratio zstd (ultra + long-distance matching), up to level 22. */
+    zstdMaxCompress(d, level = 22) {
+        return this.call((l) => this.m._zk_zstd_max_compress(l, level), d);
+    }
+    // (decompress with zstdDecompress — same frame format)
+    /** LZMA — highest general-purpose ratio. */
+    lzmaCompress(d, level = 9) {
+        return this.call((l) => this.m._zk_lzma_compress(l, level), d);
+    }
+    lzmaDecompress(d) {
+        return this.call((l) => this.m._zk_lzma_decompress(l), d);
+    }
+    /**
+     * Decode a raw LZMA2 stream (used by the 7z reader). `prop` is the single
+     * LZMA2 dictionary-size property byte; `outSize` is the known unpacked size.
+     */
+    lzma2Decompress(d, prop, outSize) {
+        return this.call((l) => this.m._zk_lzma2_decompress(l, prop, outSize), d);
+    }
+    /** xz — the standard `.xz` container around LZMA2 (full streaming codec). */
+    xzCompress(d, level = 6) {
+        const out = this.call((l) => this.m._zk_xz_compress(l, level), d);
+        if (!this.m._zk_xz_ok())
+            throw new Error('xz compression failed');
+        return out;
+    }
+    xzDecompress(d) {
+        // An empty result is valid (a stream can decode to zero bytes), so success
+        // is read from the engine's explicit flag, not the output length.
+        const out = this.call((l) => this.m._zk_xz_decompress(l), d);
+        if (!this.m._zk_xz_ok())
+            throw new Error('xz decompression failed (corrupt stream or unsupported filter)');
+        return out;
+    }
+    /**
+     * Stage `dict` into the engine's auxiliary buffer for the next dictionary
+     * call. Held until the next {@link setAux}, so set it immediately before
+     * {@link zstdCompressDict}/{@link zstdDecompressDict} or {@link zstdTrainDict}.
+     */
+    setAux(dict) {
+        const m = this.m;
+        const p = m._zk_input_ptr(dict.length);
+        m.HEAPU8.set(dict, p);
+        m._zk_set_aux(dict.length);
+    }
+    /**
+     * Train a zstd dictionary of up to `dictCapacity` bytes from `samples`. Stage
+     * the per-sample sizes (u32 LE) via {@link setAux} first; `samples` is the
+     * concatenation of every sample. Returns the dictionary bytes (empty on
+     * failure, e.g. too few samples).
+     */
+    zstdTrainDict(samples, nSamples, dictCapacity) {
+        const m = this.m;
+        const p = m._zk_input_ptr(samples.length);
+        m.HEAPU8.set(samples, p);
+        m._zk_zstd_train_dict(samples.length, nSamples, dictCapacity);
+        const op = m._zk_result_ptr();
+        const ol = m._zk_result_len() >>> 0;
+        return m.HEAPU8.slice(op, op + ol);
+    }
+    /** Compress `d` with the dictionary previously staged via {@link setAux}. */
+    zstdCompressDict(d, level = 19) {
+        return this.call((l) => this.m._zk_zstd_compress_dict(l, level), d);
+    }
+    /** Decompress `d` with the dictionary previously staged via {@link setAux}. */
+    zstdDecompressDict(d) {
+        return this.call((l) => this.m._zk_zstd_decompress_dict(l), d);
+    }
+    /** bzip2 — Burrows–Wheeler transform. */
+    bzip2Compress(d, level = 9) {
+        return this.call((l) => this.m._zk_bzip2_compress(l, level), d);
+    }
+    bzip2Decompress(d) {
+        return this.call((l) => this.m._zk_bzip2_decompress(l), d);
+    }
+    /** QOI — lossless image (raw RGB/RGBA pixels in, QOI bytes out). */
+    qoiEncode(pixels, width, height, channels) {
+        return this.call((l) => this.m._zk_qoi_encode(l, width, height, channels), pixels);
+    }
+    qoiDecode(d) {
+        return this.call((l) => this.m._zk_qoi_decode(l), d);
+    }
+    /**
+     * Frame-delta — lossless temporal predictor for video-like streams. Pair
+     * `encode -> zstd/lz4` on the way in and `lz4/zstd -> decode` on the way out.
+     */
+    frameDeltaEncode(d, frameSize) {
+        return this.call((l) => this.m._zk_frame_delta_encode(l, frameSize), d);
+    }
+    frameDeltaDecode(d, frameSize) {
+        return this.call((l) => this.m._zk_frame_delta_decode(l, frameSize), d);
+    }
+}
+let singleton;
+/**
+ * Return the process-wide engine, instantiating the Wasm module on first call
+ * and reusing it thereafter. This is what every high-level helper uses, so the
+ * 1.4 MB module loads at most once per process.
+ */
+export function getEngine() {
+    return (singleton ??= ZipKitEngine.load());
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

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

package/dist/fsa.d.ts

@@ -0,0 +1,54 @@
+/**
+ * File System Access API helpers (browser).
+ *
+ * Bridges the browser's `FileSystemFileHandle` to ZipKit's streaming writer so
+ * you can zip large local files straight to disk without first reading them all
+ * into memory: {@link zipToFileHandle} pipes {@link zipStream} into the handle's
+ * writable, and {@link entriesFromFileHandles} turns picked files into the entry
+ * stream it consumes.
+ *
+ * The handle shapes are typed structurally (not via the DOM lib), so this module
+ * imports cleanly in Node/Bun too — it just needs real handles at call time.
+ *
+ * @example
+ * ```ts
+ * import { zipToFileHandle, entriesFromFileHandles } from '@myrialabs/zipkit/fsa';
+ * const out = await window.showSaveFilePicker({ suggestedName: 'archive.zip' });
+ * const picked = await window.showOpenFilePicker({ multiple: true });
+ * await zipToFileHandle(out, entriesFromFileHandles(picked, h => h));
+ * ```
+ */
+import { type ZipStreamOptions } from './zip/index.js';
+import type { ZipEntryInput, ZipMethod } from './zip/index.js';
+/** The slice of `File` ZipKit reads. */
+export interface FileLike {
+    name: string;
+    lastModified: number;
+    arrayBuffer(): Promise<ArrayBuffer>;
+}
+/** The slice of `FileSystemFileHandle` ZipKit reads from. */
+export interface ReadableFileHandle {
+    getFile(): Promise<FileLike>;
+}
+/** The slice of `FileSystemFileHandle` ZipKit writes to. */
+export interface WritableFileHandle {
+    createWritable(): Promise<WritableStream<Uint8Array>>;
+}
+/** How to name and compress an entry derived from a file handle. */
+export interface FileHandleEntryOptions {
+    /** Archive path for the file (default: the file's own `name`). */
+    name?: (file: FileLike) => string;
+    /** Compression method (default `'deflate'`). */
+    method?: ZipMethod;
+}
+/**
+ * Turn picked file handles into the entry stream {@link zipStream} consumes,
+ * reading each file only when its turn comes (peak memory = one file at a time).
+ */
+export declare function entriesFromFileHandles(handles: Iterable<ReadableFileHandle>, opts?: FileHandleEntryOptions): AsyncGenerator<ZipEntryInput>;
+/**
+ * Stream a ZIP archive built from `entries` straight into a `FileSystemFileHandle`
+ * obtained via `showSaveFilePicker`. The archive is never fully buffered.
+ */
+export declare function zipToFileHandle(handle: WritableFileHandle, entries: Iterable<ZipEntryInput> | AsyncIterable<ZipEntryInput>, opts?: ZipStreamOptions): Promise<void>;
+//# sourceMappingURL=fsa.d.ts.map

package/dist/fsa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsa.d.ts","sourceRoot":"","sources":["../src/fsa.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAa,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE/D,wCAAwC;AACxC,MAAM,WAAW,QAAQ;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;CACpC;AAED,6DAA6D;AAC7D,MAAM,WAAW,kBAAkB;IAClC,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC7B;AAED,4DAA4D;AAC5D,MAAM,WAAW,kBAAkB;IAClC,cAAc,IAAI,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC;CACtD;AAED,oEAAoE;AACpE,MAAM,WAAW,sBAAsB;IACtC,kEAAkE;IAClE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,MAAM,CAAC;IAClC,gDAAgD;IAChD,MAAM,CAAC,EAAE,SAAS,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAuB,sBAAsB,CAC5C,OAAO,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EACrC,IAAI,GAAE,sBAA2B,GAC/B,cAAc,CAAC,aAAa,CAAC,CAU/B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACpC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,aAAa,CAAC,aAAa,CAAC,EAC/D,IAAI,CAAC,EAAE,gBAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/fsa.js

@@ -0,0 +1,45 @@
+/**
+ * File System Access API helpers (browser).
+ *
+ * Bridges the browser's `FileSystemFileHandle` to ZipKit's streaming writer so
+ * you can zip large local files straight to disk without first reading them all
+ * into memory: {@link zipToFileHandle} pipes {@link zipStream} into the handle's
+ * writable, and {@link entriesFromFileHandles} turns picked files into the entry
+ * stream it consumes.
+ *
+ * The handle shapes are typed structurally (not via the DOM lib), so this module
+ * imports cleanly in Node/Bun too — it just needs real handles at call time.
+ *
+ * @example
+ * ```ts
+ * import { zipToFileHandle, entriesFromFileHandles } from '@myrialabs/zipkit/fsa';
+ * const out = await window.showSaveFilePicker({ suggestedName: 'archive.zip' });
+ * const picked = await window.showOpenFilePicker({ multiple: true });
+ * await zipToFileHandle(out, entriesFromFileHandles(picked, h => h));
+ * ```
+ */
+import { zipStream } from './zip/index.js';
+/**
+ * Turn picked file handles into the entry stream {@link zipStream} consumes,
+ * reading each file only when its turn comes (peak memory = one file at a time).
+ */
+export async function* entriesFromFileHandles(handles, opts = {}) {
+    for (const handle of handles) {
+        const file = await handle.getFile();
+        yield {
+            name: opts.name ? opts.name(file) : file.name,
+            data: new Uint8Array(await file.arrayBuffer()),
+            method: opts.method,
+            mtime: file.lastModified
+        };
+    }
+}
+/**
+ * Stream a ZIP archive built from `entries` straight into a `FileSystemFileHandle`
+ * obtained via `showSaveFilePicker`. The archive is never fully buffered.
+ */
+export async function zipToFileHandle(handle, entries, opts) {
+    const writable = await handle.createWritable();
+    await zipStream(entries, opts).pipeTo(writable);
+}
+//# sourceMappingURL=fsa.js.map

package/dist/fsa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsa.js","sourceRoot":"","sources":["../src/fsa.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,SAAS,EAAyB,MAAM,gBAAgB,CAAC;AA4BlE;;;GAGG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,sBAAsB,CAC5C,OAAqC,EACrC,OAA+B,EAAE;IAEjC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACpC,MAAM;YACL,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI;YAC7C,IAAI,EAAE,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;YAC9C,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,YAAY;SACxB,CAAC;IACH,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACpC,MAA0B,EAC1B,OAA+D,EAC/D,IAAuB;IAEvB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC;IAC/C,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACjD,CAAC"}