wolfy-reader 0.1.0

package/dist/zip/crc32.js

@@ -0,0 +1,28 @@
+// From-scratch CRC-32 as defined by PKWARE APPNOTE 4.4.7: the "magic number"
+// 0xDEBB20E3 form — equivalently the reflected polynomial 0xEDB88320 —
+// pre-conditioned and post-conditioned with all ones. Table-driven: each table
+// slot holds the CRC of that single byte value, so the loop is one XOR, one
+// table lookup, and one shift per input byte. No code from any existing
+// implementation; the algorithm comes from the spec (and ISO 3309 / ITU-T
+// V.42, which APPNOTE cites).
+const POLY = 0xedb88320;
+const TABLE = (() => {
+    const table = new Uint32Array(256);
+    for (let n = 0; n < 256; n++) {
+        let c = n;
+        for (let k = 0; k < 8; k++) {
+            c = (c & 1) !== 0 ? POLY ^ (c >>> 1) : c >>> 1;
+        }
+        table[n] = c >>> 0;
+    }
+    return table;
+})();
+/** CRC-32 of `bytes` (zip polynomial), as an unsigned 32-bit integer. */
+export function crc32(bytes) {
+    let c = 0xffffffff;
+    for (let i = 0; i < bytes.length; i++) {
+        c = TABLE[(c ^ bytes[i]) & 0xff] ^ (c >>> 8);
+    }
+    return (c ^ 0xffffffff) >>> 0;
+}
+//# sourceMappingURL=crc32.js.map

package/dist/zip/crc32.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crc32.js","sourceRoot":"","sources":["../../src/zip/crc32.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,uEAAuE;AACvE,+EAA+E;AAC/E,4EAA4E;AAC5E,wEAAwE;AACxE,0EAA0E;AAC1E,8BAA8B;AAE9B,MAAM,IAAI,GAAG,UAAU,CAAC;AAExB,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE;IAClB,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC;IACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACjD,CAAC;QACD,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC,EAAE,CAAC;AAEL,yEAAyE;AACzE,MAAM,UAAU,KAAK,CAAC,KAAiB;IACrC,IAAI,CAAC,GAAG,UAAU,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,CAAC,GAAI,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,GAAG,IAAI,CAAY,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,CAAC,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC"}

package/dist/zip/eocd.d.ts

@@ -0,0 +1,9 @@
+import { type ByteSource } from './source.ts';
+export interface CentralDirectoryLocation {
+    offset: number;
+    size: number;
+    entryCount: number;
+}
+export declare function locateCentralDirectory(src: ByteSource): Promise<CentralDirectoryLocation>;
+export declare function toSafeNumber(value: bigint, what: string): number;
+//# sourceMappingURL=eocd.d.ts.map

package/dist/zip/eocd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eocd.d.ts","sourceRoot":"","sources":["../../src/zip/eocd.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAW/D,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA+B/F;AA0CD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKhE"}

package/dist/zip/eocd.js

@@ -0,0 +1,84 @@
+import { ZipFormatError } from './errors.js';
+import { readExact, view } from './source.js';
+const EOCD_SIG = 0x06054b50;
+const EOCD_MIN = 22;
+const MAX_COMMENT = 0xffff;
+const LOCATOR_SIG = 0x07064b50;
+const LOCATOR_SIZE = 20;
+const ZIP64_EOCD_SIG = 0x06064b50;
+const ZIP64_EOCD_MIN = 56;
+const INITIAL_PROBE = 1024;
+export async function locateCentralDirectory(src) {
+    if (src.size < EOCD_MIN)
+        throw new ZipFormatError('too small to be a zip archive');
+    let probe = Math.min(src.size, INITIAL_PROBE);
+    let tail = await readExact(src, src.size - probe, probe);
+    let idx = findEocd(tail);
+    const maxProbe = Math.min(src.size, EOCD_MIN + MAX_COMMENT);
+    if (idx < 0 && probe < maxProbe) {
+        probe = maxProbe;
+        tail = await readExact(src, src.size - probe, probe);
+        idx = findEocd(tail);
+    }
+    if (idx < 0)
+        throw new ZipFormatError('end of central directory record not found');
+    const eocdFileOffset = src.size - probe + idx;
+    const zip64 = await readZip64(src, tail, idx, eocdFileOffset);
+    if (zip64)
+        return zip64;
+    const dv = view(tail);
+    const diskNumber = dv.getUint16(idx + 4, true);
+    const cdDisk = dv.getUint16(idx + 6, true);
+    if (diskNumber !== 0 || cdDisk !== 0) {
+        throw new ZipFormatError('multi-disk archives are not supported');
+    }
+    const entryCount = dv.getUint16(idx + 10, true);
+    const size = dv.getUint32(idx + 12, true);
+    const offset = dv.getUint32(idx + 16, true);
+    if (entryCount === 0xffff || size === 0xffffffff || offset === 0xffffffff) {
+        throw new ZipFormatError('zip64 markers present but the zip64 locator is missing');
+    }
+    return { offset, size, entryCount };
+}
+function findEocd(tail) {
+    const dv = view(tail);
+    for (let i = tail.byteLength - EOCD_MIN; i >= 0; i--) {
+        if (dv.getUint32(i, true) !== EOCD_SIG)
+            continue;
+        const commentLen = dv.getUint16(i + 20, true);
+        if (i + EOCD_MIN + commentLen === tail.byteLength)
+            return i;
+    }
+    return -1;
+}
+async function readZip64(src, tail, eocdIdx, eocdFileOffset) {
+    if (eocdFileOffset < LOCATOR_SIZE)
+        return null;
+    const locator = eocdIdx >= LOCATOR_SIZE
+        ? tail.subarray(eocdIdx - LOCATOR_SIZE, eocdIdx)
+        : await readExact(src, eocdFileOffset - LOCATOR_SIZE, LOCATOR_SIZE);
+    const ldv = view(locator);
+    if (ldv.getUint32(0, true) !== LOCATOR_SIG)
+        return null;
+    if (ldv.getUint32(16, true) > 1) {
+        throw new ZipFormatError('multi-disk archives are not supported');
+    }
+    const recordOffset = toSafeNumber(ldv.getBigUint64(8, true), 'zip64 EOCD offset');
+    const record = await readExact(src, recordOffset, ZIP64_EOCD_MIN);
+    const rdv = view(record);
+    if (rdv.getUint32(0, true) !== ZIP64_EOCD_SIG) {
+        throw new ZipFormatError('zip64 locator points at a missing zip64 EOCD record');
+    }
+    return {
+        entryCount: toSafeNumber(rdv.getBigUint64(32, true), 'zip64 entry count'),
+        size: toSafeNumber(rdv.getBigUint64(40, true), 'zip64 central directory size'),
+        offset: toSafeNumber(rdv.getBigUint64(48, true), 'zip64 central directory offset'),
+    };
+}
+export function toSafeNumber(value, what) {
+    if (value > BigInt(Number.MAX_SAFE_INTEGER)) {
+        throw new ZipFormatError(`${what} exceeds the safe integer range`);
+    }
+    return Number(value);
+}
+//# sourceMappingURL=eocd.js.map

package/dist/zip/eocd.js.map

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

package/dist/zip/errors.d.ts

@@ -0,0 +1,19 @@
+export declare class ZipError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class ZipFormatError extends ZipError {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class ZipCrcMismatchError extends ZipFormatError {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class ZipEncryptedEntryError extends ZipError {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class ZipUnsupportedMethodError extends ZipError {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class ZipEntryNotFoundError extends ZipError {
+    constructor(message: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/zip/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/zip/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAS,SAAQ,KAAK;IACjC,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAGlD;CACF;AAED,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAGlD;CACF;AAED,qBAAa,mBAAoB,SAAQ,cAAc;IACrD,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAGlD;CACF;AAED,qBAAa,sBAAuB,SAAQ,QAAQ;IAClD,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAGlD;CACF;AAED,qBAAa,yBAA0B,SAAQ,QAAQ;IACrD,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAGlD;CACF;AAED,qBAAa,qBAAsB,SAAQ,QAAQ;IACjD,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAGlD;CACF"}

package/dist/zip/errors.js

@@ -0,0 +1,37 @@
+export class ZipError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'ZipError';
+    }
+}
+export class ZipFormatError extends ZipError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'ZipFormatError';
+    }
+}
+export class ZipCrcMismatchError extends ZipFormatError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'ZipCrcMismatchError';
+    }
+}
+export class ZipEncryptedEntryError extends ZipError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'ZipEncryptedEntryError';
+    }
+}
+export class ZipUnsupportedMethodError extends ZipError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'ZipUnsupportedMethodError';
+    }
+}
+export class ZipEntryNotFoundError extends ZipError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'ZipEntryNotFoundError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/zip/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/zip/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,QAAQ;IAC1C,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,cAAc;IACrD,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,QAAQ;IAClD,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,QAAQ;IACrD,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,QAAQ;IACjD,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF"}

package/dist/zip/index.d.ts

@@ -0,0 +1,18 @@
+import { ZipCrcMismatchError, ZipEncryptedEntryError, ZipEntryNotFoundError, ZipError, ZipFormatError, ZipUnsupportedMethodError } from './errors.ts';
+import { type ZipSource } from './source.ts';
+export { ZipCrcMismatchError, ZipEncryptedEntryError, ZipEntryNotFoundError, ZipError, ZipFormatError, ZipUnsupportedMethodError, };
+export type { RangeReader, RangeReaderSource, ZipSource } from './source.ts';
+export interface ZipEntry {
+    readonly name: string;
+    readonly method: number;
+    readonly compressedSize: number;
+    readonly uncompressedSize: number;
+    readonly encrypted: boolean;
+}
+export interface ZipArchive {
+    readonly entries: readonly ZipEntry[];
+    entry(name: string): ZipEntry | undefined;
+    read(name: string): Promise<Uint8Array>;
+}
+export declare function openZip(source: ZipSource): Promise<ZipArchive>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/zip/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,QAAQ,EACR,cAAc,EACd,yBAAyB,EAC1B,MAAM,aAAa,CAAC;AAErB,OAAO,EAAkD,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7F,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,QAAQ,EACR,cAAc,EACd,yBAAyB,GAC1B,CAAC;AACF,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAS7E,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,QAAQ,EAAE,CAAC;IACtC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC1C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACzC;AAED,wBAAsB,OAAO,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CA+BpE"}

package/dist/zip/index.js

@@ -0,0 +1,78 @@
+import { parseCentralDirectory } from './central.js';
+import { crc32 } from './crc32.js';
+import { locateCentralDirectory } from './eocd.js';
+import { ZipCrcMismatchError, ZipEncryptedEntryError, ZipEntryNotFoundError, ZipError, ZipFormatError, ZipUnsupportedMethodError, } from './errors.js';
+import { decompress } from './inflate.js';
+import { readExact, toByteSource, view } from './source.js';
+export { ZipCrcMismatchError, ZipEncryptedEntryError, ZipEntryNotFoundError, ZipError, ZipFormatError, ZipUnsupportedMethodError, };
+const LOCAL_SIG = 0x04034b50;
+const LOCAL_HEADER_SIZE = 30;
+function hex32(value) {
+    return `0x${value.toString(16).padStart(8, '0')}`;
+}
+export async function openZip(source) {
+    const src = toByteSource(source);
+    const location = await locateCentralDirectory(src);
+    const directory = await readExact(src, location.offset, location.size);
+    const records = parseCentralDirectory(directory, location.entryCount);
+    const byName = new Map();
+    for (const record of records)
+        byName.set(record.name, record);
+    const entries = records.map((record) => ({
+        name: record.name,
+        method: record.method,
+        compressedSize: record.compressedSize,
+        uncompressedSize: record.uncompressedSize,
+        encrypted: record.encrypted,
+    }));
+    // First entry wins on a duplicate name, preserving the Array.find semantics
+    // this Map lookup replaced.
+    const entryByName = new Map();
+    for (const entry of entries) {
+        if (!entryByName.has(entry.name))
+            entryByName.set(entry.name, entry);
+    }
+    return {
+        entries,
+        entry: (name) => entryByName.get(name),
+        read: async (name) => {
+            const record = byName.get(name);
+            if (!record)
+                throw new ZipEntryNotFoundError(`no entry named ${name}`);
+            return readEntry(src, record);
+        },
+    };
+}
+async function readEntry(src, record) {
+    if (record.encrypted) {
+        throw new ZipEncryptedEntryError(`entry ${record.name} is encrypted; encrypted archives are not supported`);
+    }
+    const header = await readExact(src, record.localHeaderOffset, LOCAL_HEADER_SIZE);
+    const dv = view(header);
+    if (dv.getUint32(0, true) !== LOCAL_SIG) {
+        throw new ZipFormatError(`entry ${record.name}: no local file header at offset ${record.localHeaderOffset}`);
+    }
+    // The local header's own name/extra lengths can differ from the central
+    // directory's (bsdtar pads local extras); sizes with data descriptors (flag
+    // bit 3) are zero here — the central directory values are authoritative.
+    const nameLen = dv.getUint16(26, true);
+    const extraLen = dv.getUint16(28, true);
+    const dataOffset = record.localHeaderOffset + LOCAL_HEADER_SIZE + nameLen + extraLen;
+    const data = await readExact(src, dataOffset, record.compressedSize);
+    const out = await decompress(data, record.method, record.name);
+    if (out.byteLength !== record.uncompressedSize) {
+        throw new ZipFormatError(`entry ${record.name}: expected ${record.uncompressedSize} bytes, decompressed to ${out.byteLength}`);
+    }
+    // Verify against the central directory's CRC-32, unconditionally. The
+    // data-descriptor exemption (APPNOTE 4.4.7) zeroes the CRC only in the
+    // *local* header of a flag-bit-3 entry — "the correct value is put in the
+    // data descriptor and in the central directory" — so the central copy is
+    // always the real checksum and there is no CRC==0 skip: 0 is simply the
+    // legitimate CRC of an empty payload, which trivially matches.
+    const actual = crc32(out);
+    if (actual !== record.crc32) {
+        throw new ZipCrcMismatchError(`entry ${record.name}: CRC-32 mismatch (expected ${hex32(record.crc32)}, computed ${hex32(actual)})`);
+    }
+    return out;
+}
+//# sourceMappingURL=index.js.map

package/dist/zip/index.js.map

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

package/dist/zip/inflate.d.ts

@@ -0,0 +1,2 @@
+export declare function decompress(data: Uint8Array, method: number, name: string): Promise<Uint8Array>;
+//# sourceMappingURL=inflate.d.ts.map

package/dist/zip/inflate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inflate.d.ts","sourceRoot":"","sources":["../../src/zip/inflate.ts"],"names":[],"mappings":"AAKA,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAIpG"}

package/dist/zip/inflate.js

@@ -0,0 +1,43 @@
+import { ZipFormatError, ZipUnsupportedMethodError } from './errors.js';
+const STORED = 0;
+const DEFLATED = 8;
+export async function decompress(data, method, name) {
+    if (method === STORED)
+        return data.slice();
+    if (method === DEFLATED)
+        return inflateRaw(data, name);
+    throw new ZipUnsupportedMethodError(`entry ${name} uses unsupported compression method ${method}`);
+}
+async function inflateRaw(data, name) {
+    const input = new ReadableStream({
+        start(controller) {
+            // slice() re-backs the view with a plain ArrayBuffer — a range reader may
+            // hand back a SharedArrayBuffer-backed view, which BufferSource excludes.
+            controller.enqueue(data.slice());
+            controller.close();
+        },
+    });
+    const chunks = [];
+    let total = 0;
+    try {
+        const reader = input.pipeThrough(new DecompressionStream('deflate-raw')).getReader();
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            chunks.push(value);
+            total += value.byteLength;
+        }
+    }
+    catch (cause) {
+        throw new ZipFormatError(`entry ${name}: corrupt deflate stream`, { cause });
+    }
+    const out = new Uint8Array(total);
+    let offset = 0;
+    for (const chunk of chunks) {
+        out.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return out;
+}
+//# sourceMappingURL=inflate.js.map

package/dist/zip/inflate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inflate.js","sourceRoot":"","sources":["../../src/zip/inflate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAExE,MAAM,MAAM,GAAG,CAAC,CAAC;AACjB,MAAM,QAAQ,GAAG,CAAC,CAAC;AAEnB,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAgB,EAAE,MAAc,EAAE,IAAY;IAC7E,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;IAC3C,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACvD,MAAM,IAAI,yBAAyB,CAAC,SAAS,IAAI,wCAAwC,MAAM,EAAE,CAAC,CAAC;AACrG,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAgB,EAAE,IAAY;IACtD,MAAM,KAAK,GAAG,IAAI,cAAc,CAAe;QAC7C,KAAK,CAAC,UAAU;YACd,0EAA0E;YAC1E,0EAA0E;YAC1E,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YACjC,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;KACF,CAAC,CAAC;IACH,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,mBAAmB,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;QACrF,SAAS,CAAC;YACR,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI;gBAAE,MAAM;YAChB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnB,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC;QAC5B,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,cAAc,CAAC,SAAS,IAAI,0BAA0B,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/E,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC;IAC7B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/zip/source.d.ts

@@ -0,0 +1,15 @@
+export type RangeReader = (offset: number, length: number) => Promise<Uint8Array>;
+/** Streaming input: `size` is required because locating a zip's central directory starts from the file tail. */
+export interface RangeReaderSource {
+    read: RangeReader;
+    size: number;
+}
+export type ZipSource = ArrayBuffer | Uint8Array | Blob | RangeReaderSource;
+export interface ByteSource {
+    size: number;
+    read: RangeReader;
+}
+export declare function toByteSource(source: ZipSource): ByteSource;
+export declare function readExact(src: ByteSource, offset: number, length: number): Promise<Uint8Array>;
+export declare function view(bytes: Uint8Array): DataView;
+//# sourceMappingURL=source.d.ts.map

package/dist/zip/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/zip/source.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAElF,gHAAgH;AAChH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,IAAI,GAAG,iBAAiB,CAAC;AAE5E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,CAW1D;AASD,wBAAsB,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CASpG;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ,CAEhD"}

package/dist/zip/source.js

@@ -0,0 +1,34 @@
+import { ZipFormatError } from './errors.js';
+export function toByteSource(source) {
+    if (source instanceof Uint8Array)
+        return bufferSource(source);
+    if (source instanceof ArrayBuffer)
+        return bufferSource(new Uint8Array(source));
+    if (source instanceof Blob) {
+        return {
+            size: source.size,
+            read: async (offset, length) => new Uint8Array(await source.slice(offset, offset + length).arrayBuffer()),
+        };
+    }
+    return { size: source.size, read: (offset, length) => source.read(offset, length) };
+}
+function bufferSource(bytes) {
+    return {
+        size: bytes.byteLength,
+        read: (offset, length) => Promise.resolve(bytes.subarray(offset, offset + length)),
+    };
+}
+export async function readExact(src, offset, length) {
+    if (offset < 0 || length < 0 || offset + length > src.size) {
+        throw new ZipFormatError(`range ${offset}..${offset + length} is outside the ${src.size}-byte source`);
+    }
+    const bytes = await src.read(offset, length);
+    if (bytes.byteLength !== length) {
+        throw new ZipFormatError(`short read at ${offset}: wanted ${length} bytes, got ${bytes.byteLength}`);
+    }
+    return bytes;
+}
+export function view(bytes) {
+    return new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+}
+//# sourceMappingURL=source.js.map

package/dist/zip/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../src/zip/source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAiB7C,MAAM,UAAU,YAAY,CAAC,MAAiB;IAC5C,IAAI,MAAM,YAAY,UAAU;QAAE,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;IAC9D,IAAI,MAAM,YAAY,WAAW;QAAE,OAAO,YAAY,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/E,IAAI,MAAM,YAAY,IAAI,EAAE,CAAC;QAC3B,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAC7B,IAAI,UAAU,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;SAC5E,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;AACtF,CAAC;AAED,SAAS,YAAY,CAAC,KAAiB;IACrC,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,UAAU;QACtB,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;KACnF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAe,EAAE,MAAc,EAAE,MAAc;IAC7E,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAC3D,MAAM,IAAI,cAAc,CAAC,SAAS,MAAM,KAAK,MAAM,GAAG,MAAM,mBAAmB,GAAG,CAAC,IAAI,cAAc,CAAC,CAAC;IACzG,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,IAAI,KAAK,CAAC,UAAU,KAAK,MAAM,EAAE,CAAC;QAChC,MAAM,IAAI,cAAc,CAAC,iBAAiB,MAAM,YAAY,MAAM,eAAe,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IACvG,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,KAAiB;IACpC,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;AACxE,CAAC"}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "wolfy-reader",
+  "version": "0.1.0",
+  "description": "Read ebooks in the browser — pages that turn, text you can search, and typography you can change without losing your place.",
+  "keywords": [
+    "ebook",
+    "reader",
+    "epub",
+    "fb2",
+    "pagination",
+    "browser"
+  ],
+  "license": "MIT",
+  "author": "Vitaliy Tkachuk",
+  "homepage": "https://github.com/vitaliy-tkachuk/wolfy-reader#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vitaliy-tkachuk/wolfy-reader.git"
+  },
+  "bugs": {
+    "url": "https://github.com/vitaliy-tkachuk/wolfy-reader/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "default": "./dist/core/index.js"
+    },
+    "./epub": {
+      "types": "./dist/formats/epub/index.d.ts",
+      "default": "./dist/formats/epub/index.js"
+    },
+    "./fb2": {
+      "types": "./dist/formats/fb2/index.d.ts",
+      "default": "./dist/formats/fb2/index.js"
+    },
+    "./text": {
+      "types": "./dist/formats/text/index.d.ts",
+      "default": "./dist/formats/text/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "clean": "node --input-type=module -e \"import{rmSync}from'node:fs';rmSync('dist',{recursive:true,force:true})\"",
+    "build": "npm run clean && tsc -p tsconfig.build.json && node scripts/banner.mjs",
+    "test": "node --test \"test/**/*.test.ts\"",
+    "test:browser": "node --test \"test/browser/*.browser.mjs\"",
+    "typecheck": "tsc --noEmit",
+    "check:core": "node scripts/check-core-purity.mjs",
+    "check:guards": "node scripts/check-guards.mjs",
+    "check:pack": "node scripts/check-pack.mjs",
+    "check:size": "node scripts/check-size.mjs",
+    "fetch-corpus": "node scripts/fetch-corpus.mjs",
+    "demo": "node scripts/serve-demo.mjs",
+    "bench": "node bench/run.mjs",
+    "prepack": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^26.2.0",
+    "esbuild": "^0.28.2",
+    "playwright": "^1.62.1",
+    "typescript": "^7.0.2"
+  }
+}

package/src/core/book.ts

@@ -0,0 +1,80 @@
+/** A lazily loaded binary payload with its media type. */
+export interface Resource {
+  readonly mediaType: string;
+  load(): Promise<Uint8Array>;
+}
+
+/** Fields the format could not determine are omitted, never set to undefined. */
+export interface BookMetadata {
+  readonly title?: string;
+  readonly author?: string;
+  /** BCP 47 language tag. */
+  readonly language?: string;
+  readonly cover?: Resource;
+}
+
+/** A table-of-contents entry; targets a section by id, never by file path. */
+export interface TocItem {
+  readonly label: string;
+  readonly sectionId: string;
+  /** Anchor within the section, when the format provides one. */
+  readonly fragment?: string;
+  readonly children: readonly TocItem[];
+}
+
+/** One unit of the book's reading order. */
+export interface Section {
+  /** Unique within the book. */
+  readonly id: string;
+  readonly mediaType: string;
+  /** True when the content declares executable script; omitted when unknown. */
+  readonly scripted?: boolean;
+  load(): Promise<Uint8Array>;
+  /**
+   * Resolves a reference appearing inside this section's content — in whatever
+   * form the format uses — to the resource it names. Returns undefined when the
+   * reference names nothing this book can supply. Omitted by formats that
+   * cannot resolve references.
+   */
+  resolve?(reference: string): Resource | undefined;
+  /**
+   * Resolves a reference appearing inside this section's content to the *section*
+   * it targets (plus any fragment), or undefined when it names no section in this
+   * book. The counterpart to {@link resolve}: `resolve` hands back a `Resource`'s
+   * bytes for a reference (an image, a stylesheet), this hands back a navigation
+   * target for a reference to another reading unit — a "next chapter" link, a
+   * table-of-contents entry rendered in-content. Section-relative (a bare
+   * `chapter-2.xhtml` resolves against this section's own location) and path-free
+   * on return, so container paths never enter the model. Omitted by formats whose
+   * references cannot name a section (plain text has none).
+   */
+  resolveHref?(reference: string): SectionRef | undefined;
+}
+
+/**
+ * A resolved in-content reference: the section it targets, plus any fragment the
+ * reference carried. Path-free by design — the return names a section by id, never
+ * by container path, so paths never enter the model.
+ */
+export interface SectionRef {
+  readonly sectionId: string;
+  /** Anchor within the target section, when the reference carried one. */
+  readonly fragment?: string;
+}
+
+/** Reading order of the pages: left-to-right or right-to-left. */
+export type ReadingDirection = 'ltr' | 'rtl';
+
+export interface Book {
+  readonly metadata: BookMetadata;
+  readonly toc: readonly TocItem[];
+  /** Reading order. */
+  readonly sections: readonly Section[];
+  section(id: string): Section | undefined;
+  /** Non-section payloads (images, stylesheets) keyed by format-defined id. */
+  readonly resources: ReadonlyMap<string, Resource>;
+  /** Declared reading direction; omitted when the book does not declare one. */
+  readonly direction?: ReadingDirection;
+  /** True when the book declares fixed-size pages. Detection only — rendering stays reflowable. */
+  readonly fixedLayout?: boolean;
+}

package/src/core/errors.ts

@@ -0,0 +1,31 @@
+/** Base class for every error this library throws. */
+export class BookError extends Error {
+  constructor(message: string, options?: ErrorOptions) {
+    super(message, options);
+    this.name = 'BookError';
+  }
+}
+
+/** No registered format claimed the input bytes. */
+export class UnrecognizedFormatError extends BookError {
+  constructor(message: string, options?: ErrorOptions) {
+    super(message, options);
+    this.name = 'UnrecognizedFormatError';
+  }
+}
+
+/** The container structure is damaged or malformed. */
+export class CorruptContainerError extends BookError {
+  constructor(message: string, options?: ErrorOptions) {
+    super(message, options);
+    this.name = 'CorruptContainerError';
+  }
+}
+
+/** The content is encrypted; DRM-free books only. */
+export class EncryptedContentError extends BookError {
+  constructor(message: string, options?: ErrorOptions) {
+    super(message, options);
+    this.name = 'EncryptedContentError';
+  }
+}

package/src/core/format.ts

@@ -0,0 +1,14 @@
+import type { Book } from './book.ts';
+import type { ByteSource } from './source.ts';
+import type { StorageAdapter } from './storage.ts';
+
+export interface FormatContext {
+  readonly storage?: StorageAdapter;
+}
+
+/** A registrable format: claims input via sniff, then decodes it to a Book. */
+export interface BookFormat {
+  readonly name: string;
+  sniff(source: ByteSource): boolean | Promise<boolean>;
+  decode(source: ByteSource, context: FormatContext): Promise<Book>;
+}