@myrialabs/zipkit 0.0.6

package/dist/codecs/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * All codec façades, re-exported. Import individual codecs from the package
+ * root (`import { gzip } from '@myrialabs/zipkit'`) for tree-shaking, or grab the whole
+ * set here.
+ */
+export { gzip, gunzip } from './gzip.js';
+export { deflate, inflate } from './deflate.js';
+export { zlib, unzlib } from './zlib.js';
+export { zstd, unzstd } from './zstd.js';
+export { lz4, unlz4 } from './lz4.js';
+export { snappy, unsnappy } from './snappy.js';
+export { brotli, unbrotli } from './brotli.js';
+export { lzma, unlzma } from './lzma.js';
+export { xz, unxz } from './xz.js';
+export { bzip2, unbzip2 } from './bzip2.js';
+export { encodeImage, decodeImage } from './image.js';
+export { encodeFrames, decodeFrames, type FrameCodec } from './video.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/codecs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/codecs/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/codecs/index.js

@@ -0,0 +1,18 @@
+/**
+ * All codec façades, re-exported. Import individual codecs from the package
+ * root (`import { gzip } from '@myrialabs/zipkit'`) for tree-shaking, or grab the whole
+ * set here.
+ */
+export { gzip, gunzip } from './gzip.js';
+export { deflate, inflate } from './deflate.js';
+export { zlib, unzlib } from './zlib.js';
+export { zstd, unzstd } from './zstd.js';
+export { lz4, unlz4 } from './lz4.js';
+export { snappy, unsnappy } from './snappy.js';
+export { brotli, unbrotli } from './brotli.js';
+export { lzma, unlzma } from './lzma.js';
+export { xz, unxz } from './xz.js';
+export { bzip2, unbzip2 } from './bzip2.js';
+export { encodeImage, decodeImage } from './image.js';
+export { encodeFrames, decodeFrames } from './video.js';
+//# sourceMappingURL=index.js.map

package/dist/codecs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/codecs/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAmB,MAAM,YAAY,CAAC"}

package/dist/codecs/lz4.d.ts

@@ -0,0 +1,6 @@
+import type { CompressOptions, DecompressOptions } from '../types.js';
+/** Compress with LZ4 (raw block). */
+export declare function lz4(data: Uint8Array, opts?: CompressOptions): Promise<Uint8Array>;
+/** Decompress an LZ4 raw block produced by {@link lz4}. */
+export declare function unlz4(data: Uint8Array, opts?: DecompressOptions): Promise<Uint8Array>;
+//# sourceMappingURL=lz4.d.ts.map

package/dist/codecs/lz4.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lz4.d.ts","sourceRoot":"","sources":["../../src/codecs/lz4.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEtE,qCAAqC;AACrC,wBAAsB,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAGvF;AAED,2DAA2D;AAC3D,wBAAsB,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAG3F"}

package/dist/codecs/lz4.js

@@ -0,0 +1,17 @@
+/**
+ * LZ4 codec — lz4 1.10.0, raw block format (no frame header). The fastest
+ * codec in ZipKit; pair with a slower codec only when ratio matters.
+ */
+import { getEngine } from '../engine.js';
+import { runAsync } from '../internal.js';
+/** Compress with LZ4 (raw block). */
+export async function lz4(data, opts) {
+    const e = await getEngine();
+    return runAsync(() => e.lz4Compress(data), opts, data.length);
+}
+/** Decompress an LZ4 raw block produced by {@link lz4}. */
+export async function unlz4(data, opts) {
+    const e = await getEngine();
+    return runAsync(() => e.lz4Decompress(data), opts, data.length);
+}
+//# sourceMappingURL=lz4.js.map

package/dist/codecs/lz4.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lz4.js","sourceRoot":"","sources":["../../src/codecs/lz4.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,qCAAqC;AACrC,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAgB,EAAE,IAAsB;IACjE,MAAM,CAAC,GAAG,MAAM,SAAS,EAAE,CAAC;IAC5B,OAAO,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/D,CAAC;AAED,2DAA2D;AAC3D,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAgB,EAAE,IAAwB;IACrE,MAAM,CAAC,GAAG,MAAM,SAAS,EAAE,CAAC;IAC5B,OAAO,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;AACjE,CAAC"}

package/dist/codecs/lzma.d.ts

@@ -0,0 +1,6 @@
+import type { CompressOptions, DecompressOptions } from '../types.js';
+/** Compress with LZMA. Level `0`–`9`; mode chooses the default. */
+export declare function lzma(data: Uint8Array, opts?: CompressOptions): Promise<Uint8Array>;
+/** Decompress an LZMA buffer produced by {@link lzma}. */
+export declare function unlzma(data: Uint8Array, opts?: DecompressOptions): Promise<Uint8Array>;
+//# sourceMappingURL=lzma.d.ts.map

package/dist/codecs/lzma.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lzma.d.ts","sourceRoot":"","sources":["../../src/codecs/lzma.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEtE,mEAAmE;AACnE,wBAAsB,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAIxF;AAED,0DAA0D;AAC1D,wBAAsB,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAG5F"}

package/dist/codecs/lzma.js

@@ -0,0 +1,15 @@
+/** LZMA codec — 7-Zip SDK. Highest general-purpose ratio, slowest. */
+import { getEngine } from '../engine.js';
+import { levelForMode, runAsync } from '../internal.js';
+/** Compress with LZMA. Level `0`–`9`; mode chooses the default. */
+export async function lzma(data, opts) {
+    const e = await getEngine();
+    const level = levelForMode(opts, 0, 9, { speed: 3, balanced: 6, ratio: 9 });
+    return runAsync(() => e.lzmaCompress(data, level), opts, data.length);
+}
+/** Decompress an LZMA buffer produced by {@link lzma}. */
+export async function unlzma(data, opts) {
+    const e = await getEngine();
+    return runAsync(() => e.lzmaDecompress(data), opts, data.length);
+}
+//# sourceMappingURL=lzma.js.map

package/dist/codecs/lzma.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lzma.js","sourceRoot":"","sources":["../../src/codecs/lzma.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAGxD,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAgB,EAAE,IAAsB;IAClE,MAAM,CAAC,GAAG,MAAM,SAAS,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IAC5E,OAAO,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;AACvE,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAgB,EAAE,IAAwB;IACtE,MAAM,CAAC,GAAG,MAAM,SAAS,EAAE,CAAC;IAC5B,OAAO,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;AAClE,CAAC"}

package/dist/codecs/snappy.d.ts

@@ -0,0 +1,6 @@
+import type { CompressOptions, DecompressOptions } from '../types.js';
+/** Compress with Snappy. */
+export declare function snappy(data: Uint8Array, opts?: CompressOptions): Promise<Uint8Array>;
+/** Decompress a Snappy buffer. */
+export declare function unsnappy(data: Uint8Array, opts?: DecompressOptions): Promise<Uint8Array>;
+//# sourceMappingURL=snappy.d.ts.map

package/dist/codecs/snappy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snappy.d.ts","sourceRoot":"","sources":["../../src/codecs/snappy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEtE,4BAA4B;AAC5B,wBAAsB,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAG1F;AAED,kCAAkC;AAClC,wBAAsB,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAG9F"}

package/dist/codecs/snappy.js

@@ -0,0 +1,14 @@
+/** Snappy codec — snappy 1.2.1. Extremely fast, modest ratio. */
+import { getEngine } from '../engine.js';
+import { runAsync } from '../internal.js';
+/** Compress with Snappy. */
+export async function snappy(data, opts) {
+    const e = await getEngine();
+    return runAsync(() => e.snappyCompress(data), opts, data.length);
+}
+/** Decompress a Snappy buffer. */
+export async function unsnappy(data, opts) {
+    const e = await getEngine();
+    return runAsync(() => e.snappyDecompress(data), opts, data.length);
+}
+//# sourceMappingURL=snappy.js.map

package/dist/codecs/snappy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snappy.js","sourceRoot":"","sources":["../../src/codecs/snappy.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,4BAA4B;AAC5B,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAgB,EAAE,IAAsB;IACpE,MAAM,CAAC,GAAG,MAAM,SAAS,EAAE,CAAC;IAC5B,OAAO,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;AAClE,CAAC;AAED,kCAAkC;AAClC,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAgB,EAAE,IAAwB;IACxE,MAAM,CAAC,GAAG,MAAM,SAAS,EAAE,CAAC;IAC5B,OAAO,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;AACpE,CAAC"}

package/dist/codecs/video.d.ts

@@ -0,0 +1,13 @@
+/** The fast codec applied to the frame-delta residual. */
+export type FrameCodec = 'zstd' | 'lz4';
+/**
+ * Encode a sequence of equally-sized raw frames losslessly.
+ *
+ * @param frames - All frames concatenated, each exactly `frameSize` bytes.
+ * @param frameSize - Bytes per frame (e.g. `width * height * channels`).
+ * @param codec - Residual codec: `'zstd'` (denser) or `'lz4'` (faster).
+ */
+export declare function encodeFrames(frames: Uint8Array, frameSize: number, codec?: FrameCodec): Promise<Uint8Array>;
+/** Decode frames produced by {@link encodeFrames} (same `frameSize`/`codec`). */
+export declare function decodeFrames(data: Uint8Array, frameSize: number, codec?: FrameCodec): Promise<Uint8Array>;
+//# sourceMappingURL=video.d.ts.map

package/dist/codecs/video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.d.ts","sourceRoot":"","sources":["../../src/codecs/video.ts"],"names":[],"mappings":"AAQA,0DAA0D;AAC1D,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,KAAK,CAAC;AAExC;;;;;;GAMG;AACH,wBAAsB,YAAY,CACjC,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,UAAmB,GACxB,OAAO,CAAC,UAAU,CAAC,CAIrB;AAED,iFAAiF;AACjF,wBAAsB,YAAY,CACjC,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,UAAmB,GACxB,OAAO,CAAC,UAAU,CAAC,CAIrB"}

package/dist/codecs/video.js

@@ -0,0 +1,26 @@
+/**
+ * Lossless temporal video compression: frame-delta prediction followed by a
+ * fast general codec. Subtract each frame from the previous one (the residual
+ * is mostly zeros) then compress the residual with zstd or lz4. Ideal for
+ * screen recordings, raw frame buffers, and video IPC — not a lossy codec.
+ */
+import { getEngine } from '../engine.js';
+/**
+ * Encode a sequence of equally-sized raw frames losslessly.
+ *
+ * @param frames - All frames concatenated, each exactly `frameSize` bytes.
+ * @param frameSize - Bytes per frame (e.g. `width * height * channels`).
+ * @param codec - Residual codec: `'zstd'` (denser) or `'lz4'` (faster).
+ */
+export async function encodeFrames(frames, frameSize, codec = 'zstd') {
+    const e = await getEngine();
+    const residual = e.frameDeltaEncode(frames, frameSize);
+    return codec === 'lz4' ? e.lz4Compress(residual) : e.zstdCompress(residual, 19);
+}
+/** Decode frames produced by {@link encodeFrames} (same `frameSize`/`codec`). */
+export async function decodeFrames(data, frameSize, codec = 'zstd') {
+    const e = await getEngine();
+    const residual = codec === 'lz4' ? e.lz4Decompress(data) : e.zstdDecompress(data);
+    return e.frameDeltaDecode(residual, frameSize);
+}
+//# sourceMappingURL=video.js.map

package/dist/codecs/video.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.js","sourceRoot":"","sources":["../../src/codecs/video.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAKzC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CACjC,MAAkB,EAClB,SAAiB,EACjB,QAAoB,MAAM;IAE1B,MAAM,CAAC,GAAG,MAAM,SAAS,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAG,CAAC,CAAC,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACvD,OAAO,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AACjF,CAAC;AAED,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,YAAY,CACjC,IAAgB,EAChB,SAAiB,EACjB,QAAoB,MAAM;IAE1B,MAAM,CAAC,GAAG,MAAM,SAAS,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAG,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAClF,OAAO,CAAC,CAAC,gBAAgB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAChD,CAAC"}

package/dist/codecs/xz.d.ts

@@ -0,0 +1,6 @@
+import type { CompressOptions, DecompressOptions } from '../types.js';
+/** Compress to a standard `.xz` stream. Level `0`–`9`; mode chooses the default. */
+export declare function xz(data: Uint8Array, opts?: CompressOptions): Promise<Uint8Array>;
+/** Decompress a standard `.xz` stream produced by ZipKit, the `xz` CLI, or 7-Zip. */
+export declare function unxz(data: Uint8Array, opts?: DecompressOptions): Promise<Uint8Array>;
+//# sourceMappingURL=xz.d.ts.map

package/dist/codecs/xz.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xz.d.ts","sourceRoot":"","sources":["../../src/codecs/xz.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEtE,oFAAoF;AACpF,wBAAsB,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAItF;AAED,qFAAqF;AACrF,wBAAsB,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAG1F"}

package/dist/codecs/xz.js

@@ -0,0 +1,30 @@
+/**
+ * xz codec — the standard `.xz` container (LZMA2 + CRC integrity) from the
+ * 7-Zip SDK. Unlike a hand-rolled LZMA2 chunker, this is the SDK's full
+ * streaming encoder/decoder, so it interoperates with the `xz` CLI and the
+ * `.tar.xz` tarballs found in the wild.
+ */
+import { getEngine } from '../engine.js';
+import { levelForMode, runAsync } from '../internal.js';
+import { ZipKitError } from '../types.js';
+/** Compress to a standard `.xz` stream. Level `0`–`9`; mode chooses the default. */
+export async function xz(data, opts) {
+    const e = await getEngine();
+    const level = levelForMode(opts, 0, 9, { speed: 1, balanced: 6, ratio: 9 });
+    return runAsync(() => wrap(() => e.xzCompress(data, level)), opts, data.length);
+}
+/** Decompress a standard `.xz` stream produced by ZipKit, the `xz` CLI, or 7-Zip. */
+export async function unxz(data, opts) {
+    const e = await getEngine();
+    return runAsync(() => wrap(() => e.xzDecompress(data)), opts, data.length);
+}
+/** Surface engine failures as the library's {@link ZipKitError}. */
+function wrap(fn) {
+    try {
+        return fn();
+    }
+    catch (err) {
+        throw new ZipKitError(err instanceof Error ? err.message : 'xz operation failed');
+    }
+}
+//# sourceMappingURL=xz.js.map

package/dist/codecs/xz.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xz.js","sourceRoot":"","sources":["../../src/codecs/xz.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,EAAE,CAAC,IAAgB,EAAE,IAAsB;IAChE,MAAM,CAAC,GAAG,MAAM,SAAS,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IAC5E,OAAO,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;AACjF,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAgB,EAAE,IAAwB;IACpE,MAAM,CAAC,GAAG,MAAM,SAAS,EAAE,CAAC;IAC5B,OAAO,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5E,CAAC;AAED,oEAAoE;AACpE,SAAS,IAAI,CAAC,EAAoB;IACjC,IAAI,CAAC;QACJ,OAAO,EAAE,EAAE,CAAC;IACb,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,MAAM,IAAI,WAAW,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC;IACnF,CAAC;AACF,CAAC"}

package/dist/codecs/zlib.d.ts

@@ -0,0 +1,6 @@
+import type { CompressOptions, DecompressOptions } from '../types.js';
+/** Compress to the zlib format. Level `0`–`9`; mode chooses the default. */
+export declare function zlib(data: Uint8Array, opts?: CompressOptions): Promise<Uint8Array>;
+/** Decompress a zlib buffer. */
+export declare function unzlib(data: Uint8Array, opts?: DecompressOptions): Promise<Uint8Array>;
+//# sourceMappingURL=zlib.d.ts.map

package/dist/codecs/zlib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zlib.d.ts","sourceRoot":"","sources":["../../src/codecs/zlib.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEtE,4EAA4E;AAC5E,wBAAsB,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAIxF;AAED,gCAAgC;AAChC,wBAAsB,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAG5F"}

package/dist/codecs/zlib.js

@@ -0,0 +1,15 @@
+/** zlib codec (RFC 1950) — libdeflate, standard-format compatible. */
+import { getEngine } from '../engine.js';
+import { levelForMode, runAsync } from '../internal.js';
+/** Compress to the zlib format. Level `0`–`9`; mode chooses the default. */
+export async function zlib(data, opts) {
+    const e = await getEngine();
+    const level = levelForMode(opts, 0, 9, { speed: 1, balanced: 6, ratio: 9 });
+    return runAsync(() => e.zlibCompress(data, level), opts, data.length);
+}
+/** Decompress a zlib buffer. */
+export async function unzlib(data, opts) {
+    const e = await getEngine();
+    return runAsync(() => e.zlibDecompress(data), opts, data.length);
+}
+//# sourceMappingURL=zlib.js.map

package/dist/codecs/zlib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zlib.js","sourceRoot":"","sources":["../../src/codecs/zlib.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAGxD,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAgB,EAAE,IAAsB;IAClE,MAAM,CAAC,GAAG,MAAM,SAAS,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IAC5E,OAAO,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;AACvE,CAAC;AAED,gCAAgC;AAChC,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAgB,EAAE,IAAwB;IACtE,MAAM,CAAC,GAAG,MAAM,SAAS,EAAE,CAAC;IAC5B,OAAO,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;AAClE,CAAC"}

package/dist/codecs/zstd.d.ts

@@ -0,0 +1,6 @@
+import type { CompressOptions, DecompressOptions } from '../types.js';
+/** Compress with Zstandard. Level `1`–`22`; mode chooses the default. */
+export declare function zstd(data: Uint8Array, opts?: CompressOptions): Promise<Uint8Array>;
+/** Decompress a Zstandard frame. */
+export declare function unzstd(data: Uint8Array, opts?: DecompressOptions): Promise<Uint8Array>;
+//# sourceMappingURL=zstd.d.ts.map

package/dist/codecs/zstd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zstd.d.ts","sourceRoot":"","sources":["../../src/codecs/zstd.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEtE,yEAAyE;AACzE,wBAAsB,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAUxF;AAED,oCAAoC;AACpC,wBAAsB,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAK5F"}

package/dist/codecs/zstd.js

@@ -0,0 +1,24 @@
+/** Zstandard codec — libzstd 1.5.6, standard-format compatible. */
+import { getEngine } from '../engine.js';
+import { bunRuntime, levelForMode, runAsync } from '../internal.js';
+/** Compress with Zstandard. Level `1`–`22`; mode chooses the default. */
+export async function zstd(data, opts) {
+    const level = levelForMode(opts, 1, 22, { speed: 1, balanced: 3, ratio: 19 });
+    const bun = bunRuntime();
+    if (bun?.zstdCompressSync) {
+        return runAsync(() => bun.zstdCompressSync(data, { level }), opts, data.length);
+    }
+    const e = await getEngine();
+    // Levels above 19 enable zstd's "ultra" mode plus long-distance matching.
+    const work = level > 19 ? () => e.zstdMaxCompress(data, level) : () => e.zstdCompress(data, level);
+    return runAsync(work, opts, data.length);
+}
+/** Decompress a Zstandard frame. */
+export async function unzstd(data, opts) {
+    const bun = bunRuntime();
+    if (bun?.zstdDecompressSync)
+        return runAsync(() => bun.zstdDecompressSync(data), opts, data.length);
+    const e = await getEngine();
+    return runAsync(() => e.zstdDecompress(data), opts, data.length);
+}
+//# sourceMappingURL=zstd.js.map

package/dist/codecs/zstd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zstd.js","sourceRoot":"","sources":["../../src/codecs/zstd.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAGpE,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAgB,EAAE,IAAsB;IAClE,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IAC9E,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,IAAI,GAAG,EAAE,gBAAgB,EAAE,CAAC;QAC3B,OAAO,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACjF,CAAC;IACD,MAAM,CAAC,GAAG,MAAM,SAAS,EAAE,CAAC;IAC5B,0EAA0E;IAC1E,MAAM,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACnG,OAAO,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,oCAAoC;AACpC,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAgB,EAAE,IAAwB;IACtE,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,IAAI,GAAG,EAAE,kBAAkB;QAAE,OAAO,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACpG,MAAM,CAAC,GAAG,MAAM,SAAS,EAAE,CAAC;IAC5B,OAAO,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;AAClE,CAAC"}

package/dist/compress.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Generic codec dispatch by name, plus auto-detecting decompression.
+ *
+ * `compress(data, 'zstd')` picks the codec explicitly; `decompress(data)`
+ * sniffs the header (see {@link detectFormat}) and routes accordingly. For
+ * headerless formats (brotli, raw lzma, raw lz4 block, snappy) pass the codec
+ * explicitly via `decompressWith`.
+ */
+import type { Codec, CompressOptions, DecompressOptions } from './types.js';
+/** Compress with the named codec. */
+export declare function compress(data: Uint8Array, codec: Codec, opts?: CompressOptions): Promise<Uint8Array>;
+/** Decompress with the named codec. */
+export declare function decompressWith(data: Uint8Array, codec: Codec, opts?: DecompressOptions): Promise<Uint8Array>;
+/**
+ * Decompress by auto-detecting the format from magic bytes. Throws
+ * {@link ZipKitError} if the format has no recognizable signature — use
+ * {@link decompressWith} and name the codec in that case.
+ */
+export declare function decompress(data: Uint8Array, opts?: DecompressOptions): Promise<Uint8Array>;
+//# sourceMappingURL=compress.d.ts.map

package/dist/compress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compress.d.ts","sourceRoot":"","sources":["../src/compress.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAsC5E,qCAAqC;AACrC,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAIpG;AAED,uCAAuC;AACvC,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAI5G;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAahG"}

package/dist/compress.js

@@ -0,0 +1,83 @@
+/**
+ * Generic codec dispatch by name, plus auto-detecting decompression.
+ *
+ * `compress(data, 'zstd')` picks the codec explicitly; `decompress(data)`
+ * sniffs the header (see {@link detectFormat}) and routes accordingly. For
+ * headerless formats (brotli, raw lzma, raw lz4 block, snappy) pass the codec
+ * explicitly via `decompressWith`.
+ */
+import { ZipKitError } from './types.js';
+import { detectFormat, isDirectlyDecompressible } from './detect.js';
+import { gzip, gunzip } from './codecs/gzip.js';
+import { deflate, inflate } from './codecs/deflate.js';
+import { zlib, unzlib } from './codecs/zlib.js';
+import { zstd, unzstd } from './codecs/zstd.js';
+import { lz4, unlz4 } from './codecs/lz4.js';
+import { snappy, unsnappy } from './codecs/snappy.js';
+import { brotli, unbrotli } from './codecs/brotli.js';
+import { lzma, unlzma } from './codecs/lzma.js';
+import { bzip2, unbzip2 } from './codecs/bzip2.js';
+import { unxz } from './codecs/xz.js';
+const COMPRESSORS = {
+    gzip,
+    deflate,
+    zlib,
+    zstd,
+    lz4,
+    snappy,
+    brotli,
+    lzma,
+    bzip2
+};
+const DECOMPRESSORS = {
+    gzip: gunzip,
+    deflate: inflate,
+    zlib: unzlib,
+    zstd: unzstd,
+    lz4: unlz4,
+    snappy: unsnappy,
+    brotli: unbrotli,
+    lzma: unlzma,
+    bzip2: unbzip2
+};
+/** Compress with the named codec. */
+export function compress(data, codec, opts) {
+    const fn = COMPRESSORS[codec];
+    if (!fn)
+        throw new ZipKitError(`Unknown codec: ${codec}`);
+    return fn(data, opts);
+}
+/** Decompress with the named codec. */
+export function decompressWith(data, codec, opts) {
+    const fn = DECOMPRESSORS[codec];
+    if (!fn)
+        throw new ZipKitError(`Unknown codec: ${codec}`);
+    return fn(data, opts);
+}
+/**
+ * Decompress by auto-detecting the format from magic bytes. Throws
+ * {@link ZipKitError} if the format has no recognizable signature — use
+ * {@link decompressWith} and name the codec in that case.
+ */
+export async function decompress(data, opts) {
+    const fmt = detectFormat(data);
+    if (!fmt) {
+        throw new ZipKitError('Could not auto-detect the compression format. Pass the codec explicitly via decompressWith().');
+    }
+    // xz is a container, but ZipKit decodes it directly via the engine.
+    if (fmt === 'xz')
+        return unxz(data, opts);
+    if (!isDirectlyDecompressible(fmt)) {
+        throw new ZipKitError(CONTAINER_HINT[fmt]);
+    }
+    return decompressWith(data, fmt, opts);
+}
+/** Guidance for formats {@link decompress} recognizes but can't decode itself. */
+const CONTAINER_HINT = {
+    zip: 'Input is a ZIP archive — use unzip() from @myrialabs/zipkit/zip (or the \`zipkit unzip\` CLI command).',
+    tar: 'Input is a tar archive — use untar() from @myrialabs/zipkit/tar (or untarGz/untarZstd for compressed tarballs).',
+    '7z': 'Input is a 7z archive — use unSevenZip() from @myrialabs/zipkit/sevenzip.',
+    bzip2: 'Input is a standard bzip2 (.bz2) stream. ZipKit\'s bzip2 codec uses its own length-prefixed frame, so this external stream needs a standard .bz2 reader.',
+    'lz4-frame': 'Input is an LZ4 frame — ZipKit emits and reads the raw LZ4 block; decode frames with a frame-aware LZ4 reader.'
+};
+//# sourceMappingURL=compress.js.map

package/dist/compress.js.map

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

package/dist/delta.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Delta (incremental) compression for text/JSON that changes in small steps —
+ * log streams, chat histories, config snapshots, agent conversation state. The
+ * analogue of `encodeFrames` (frame-delta + zstd) for video, but for text: given
+ * a `base` revision, {@link compressDelta} encodes a new revision against it so
+ * only what changed costs bytes.
+ *
+ * Implemented as zstd with the base loaded as a raw content prefix (the same
+ * mechanism as zstd `--patch-from`): the encoder can copy long runs straight
+ * from the base, so an append or a small edit compresses to a tiny patch. The
+ * exact same `base` must be supplied to {@link applyDelta}.
+ *
+ * @example
+ * ```ts
+ * import { compressDelta, applyDelta } from '@myrialabs/zipkit';
+ * const v1 = strToU8(JSON.stringify(stateV1));
+ * const patch = await compressDelta(v1, strToU8(JSON.stringify(stateV2)));
+ * const v2 = await applyDelta(v1, patch); // === bytes of stateV2
+ * ```
+ */
+import type { CompressOptions, DecompressOptions } from './types.js';
+/**
+ * Compress `target` as a delta against `base`. The closer `target` is to
+ * `base`, the smaller the result. Decode with {@link applyDelta} and the same
+ * `base`.
+ */
+export declare function compressDelta(base: Uint8Array, target: Uint8Array, opts?: CompressOptions): Promise<Uint8Array>;
+/** Reconstruct the target bytes from `base` and a patch from {@link compressDelta}. */
+export declare function applyDelta(base: Uint8Array, patch: Uint8Array, opts?: DecompressOptions): Promise<Uint8Array>;
+//# sourceMappingURL=delta.d.ts.map

package/dist/delta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delta.d.ts","sourceRoot":"","sources":["../src/delta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAErE;;;;GAIG;AACH,wBAAsB,aAAa,CAClC,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,UAAU,EAClB,IAAI,CAAC,EAAE,eAAe,GACpB,OAAO,CAAC,UAAU,CAAC,CAOrB;AAED,uFAAuF;AACvF,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAMnH"}

package/dist/delta.js

@@ -0,0 +1,44 @@
+/**
+ * Delta (incremental) compression for text/JSON that changes in small steps —
+ * log streams, chat histories, config snapshots, agent conversation state. The
+ * analogue of `encodeFrames` (frame-delta + zstd) for video, but for text: given
+ * a `base` revision, {@link compressDelta} encodes a new revision against it so
+ * only what changed costs bytes.
+ *
+ * Implemented as zstd with the base loaded as a raw content prefix (the same
+ * mechanism as zstd `--patch-from`): the encoder can copy long runs straight
+ * from the base, so an append or a small edit compresses to a tiny patch. The
+ * exact same `base` must be supplied to {@link applyDelta}.
+ *
+ * @example
+ * ```ts
+ * import { compressDelta, applyDelta } from '@myrialabs/zipkit';
+ * const v1 = strToU8(JSON.stringify(stateV1));
+ * const patch = await compressDelta(v1, strToU8(JSON.stringify(stateV2)));
+ * const v2 = await applyDelta(v1, patch); // === bytes of stateV2
+ * ```
+ */
+import { getEngine } from './engine.js';
+import { levelForMode, runAsync } from './internal.js';
+/**
+ * Compress `target` as a delta against `base`. The closer `target` is to
+ * `base`, the smaller the result. Decode with {@link applyDelta} and the same
+ * `base`.
+ */
+export async function compressDelta(base, target, opts) {
+    const e = await getEngine();
+    const level = levelForMode(opts, 1, 22, { speed: 3, balanced: 19, ratio: 22 });
+    return runAsync(() => {
+        e.setAux(base);
+        return e.zstdCompressDict(target, level);
+    }, opts, target.length);
+}
+/** Reconstruct the target bytes from `base` and a patch from {@link compressDelta}. */
+export async function applyDelta(base, patch, opts) {
+    const e = await getEngine();
+    return runAsync(() => {
+        e.setAux(base);
+        return e.zstdDecompressDict(patch);
+    }, opts, patch.length);
+}
+//# sourceMappingURL=delta.js.map

package/dist/delta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delta.js","sourceRoot":"","sources":["../src/delta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGvD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,IAAgB,EAChB,MAAkB,EAClB,IAAsB;IAEtB,MAAM,CAAC,GAAG,MAAM,SAAS,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IAC/E,OAAO,QAAQ,CAAC,GAAG,EAAE;QACpB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACf,OAAO,CAAC,CAAC,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;AACzB,CAAC;AAED,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAgB,EAAE,KAAiB,EAAE,IAAwB;IAC7F,MAAM,CAAC,GAAG,MAAM,SAAS,EAAE,CAAC;IAC5B,OAAO,QAAQ,CAAC,GAAG,EAAE;QACpB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACf,OAAO,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC"}

package/dist/detect.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 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`.
+ */
+/**
+ * A format ZipKit can recognize from its header bytes. Only formats with a
+ * reliable leading signature are detectable; everything else needs an explicit
+ * codec via `decompressWith`.
+ */
+export type DetectedFormat = 'gzip' | 'zlib' | 'zstd' | 'zip' | 'tar' | 'xz' | '7z' | 'bzip2' | 'lz4-frame';
+/** Whether {@link decompress} can reverse a detected format without extra API. */
+export declare function isDirectlyDecompressible(fmt: DetectedFormat): boolean;
+/**
+ * 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 declare function detectFormat(data: Uint8Array): DetectedFormat | undefined;
+//# sourceMappingURL=detect.d.ts.map

package/dist/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../src/detect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,OAAO,GAAG,WAAW,CAAC;AAK5G,kFAAkF;AAClF,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAErE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,GAAG,SAAS,CAgDzE"}