d2r-saver 0.1.0

package/dist/core/binary-reader.d.ts

@@ -0,0 +1,43 @@
+/**
+ * BinaryReader — bit-level reader for D2R save files (Blizzless v105).
+ *
+ * Ported from d2planner/src/logic/binary/reader.js.
+ * Supports byte-aligned reads, arbitrary-width bit reads,
+ * and Huffman-decoded character reads for item codes.
+ */
+export declare class BinaryReader {
+    /** Current position in bits */
+    bitpos: number;
+    /** Underlying raw buffer */
+    readonly buffer: Uint8Array;
+    constructor(buffer: Uint8Array);
+    /** Read unsigned 8-bit integer (byte-aligned). */
+    read8(): number;
+    /** Read unsigned 16-bit integer, little-endian (byte-aligned). */
+    read16(): number;
+    /** Read unsigned 32-bit integer, little-endian (byte-aligned). */
+    read32(): number;
+    /** Peek at a byte at relative offset from current byte position (does NOT advance). */
+    byte(offset: number): number;
+    /** Read a fixed-length ASCII string, stopping at the first NUL. */
+    string(length: number): string;
+    /** Read a fixed-length UTF-8 string, stopping at the first NUL. */
+    utf8(length: number): string;
+    /** Seek to an absolute byte position. */
+    seek(pos: number): void;
+    /** Skip forward by `bytes` bytes. */
+    skip(bytes: number): void;
+    /** Align to the next byte boundary. */
+    align(): void;
+    /** Read `count` bits as little-endian unsigned integer. */
+    bits(count: number): number;
+    /** Read a single bit (0 or 1). */
+    bit(): number;
+    /** Skip forward by `count` bits. */
+    skipbits(count: number): void;
+    /** Read one Huffman-encoded character (for item type codes). */
+    char(): string;
+    /** Returns true when the reader has consumed the entire buffer. */
+    eof(): boolean;
+}
+//# sourceMappingURL=binary-reader.d.ts.map

package/dist/core/binary-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary-reader.d.ts","sourceRoot":"","sources":["../../src/core/binary-reader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,qBAAa,YAAY;IACvB,+BAA+B;IAC/B,MAAM,SAAK;IAEX,4BAA4B;IAC5B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;gBAEhB,MAAM,EAAE,UAAU;IAM9B,kDAAkD;IAClD,KAAK,IAAI,MAAM;IAMf,kEAAkE;IAClE,MAAM,IAAI,MAAM;IAQhB,kEAAkE;IAClE,MAAM,IAAI,MAAM;IAUhB,uFAAuF;IACvF,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAM5B,mEAAmE;IACnE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAW9B,mEAAmE;IACnE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAa5B,yCAAyC;IACzC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIvB,qCAAqC;IACrC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIzB,uCAAuC;IACvC,KAAK,IAAI,IAAI;IAMb,2DAA2D;IAC3D,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAiB3B,kCAAkC;IAClC,GAAG,IAAI,MAAM;IAMb,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM7B,gEAAgE;IAChE,IAAI,IAAI,MAAM;IAUd,mEAAmE;IACnE,GAAG,IAAI,OAAO;CAGf"}

package/dist/core/binary-reader.js

@@ -0,0 +1,130 @@
+/**
+ * BinaryReader — bit-level reader for D2R save files (Blizzless v105).
+ *
+ * Ported from d2planner/src/logic/binary/reader.js.
+ * Supports byte-aligned reads, arbitrary-width bit reads,
+ * and Huffman-decoded character reads for item codes.
+ */
+import { HUFFMAN_TREE } from './huffman.js';
+const utf8Decoder = new TextDecoder('utf-8');
+export class BinaryReader {
+    /** Current position in bits */
+    bitpos = 0;
+    /** Underlying raw buffer */
+    buffer;
+    constructor(buffer) {
+        this.buffer = buffer;
+    }
+    // ─── Byte-aligned reads (little-endian) ───────────────────────
+    /** Read unsigned 8-bit integer (byte-aligned). */
+    read8() {
+        const value = this.buffer[this.bitpos >> 3];
+        this.bitpos += 8;
+        return value;
+    }
+    /** Read unsigned 16-bit integer, little-endian (byte-aligned). */
+    read16() {
+        const idx = this.bitpos >> 3;
+        const value1 = this.buffer[idx];
+        const value2 = this.buffer[idx + 1];
+        this.bitpos += 16;
+        return value1 | (value2 << 8);
+    }
+    /** Read unsigned 32-bit integer, little-endian (byte-aligned). */
+    read32() {
+        const idx = this.bitpos >> 3;
+        const value1 = this.buffer[idx];
+        const value2 = this.buffer[idx + 1];
+        const value3 = this.buffer[idx + 2];
+        const value4 = this.buffer[idx + 3];
+        this.bitpos += 32;
+        return (value1 | (value2 << 8) | (value3 << 16) | (value4 << 24)) >>> 0;
+    }
+    /** Peek at a byte at relative offset from current byte position (does NOT advance). */
+    byte(offset) {
+        return this.buffer[(this.bitpos >> 3) + offset];
+    }
+    // ─── String reads (byte-aligned) ──────────────────────────────
+    /** Read a fixed-length ASCII string, stopping at the first NUL. */
+    string(length) {
+        const start = this.bitpos >> 3;
+        const end = start + length;
+        let index = this.buffer.indexOf(0, start);
+        if (index < 0)
+            index = end;
+        else
+            index = Math.min(index, end);
+        const result = String.fromCharCode(...this.buffer.subarray(start, index));
+        this.bitpos = end << 3;
+        return result;
+    }
+    /** Read a fixed-length UTF-8 string, stopping at the first NUL. */
+    utf8(length) {
+        const start = this.bitpos >> 3;
+        const end = start + length;
+        let index = this.buffer.indexOf(0, start);
+        if (index < 0)
+            index = end;
+        else
+            index = Math.min(index, end);
+        const result = utf8Decoder.decode(this.buffer.subarray(start, index));
+        this.bitpos = end << 3;
+        return result;
+    }
+    // ─── Positioning ──────────────────────────────────────────────
+    /** Seek to an absolute byte position. */
+    seek(pos) {
+        this.bitpos = pos << 3;
+    }
+    /** Skip forward by `bytes` bytes. */
+    skip(bytes) {
+        this.bitpos += bytes << 3;
+    }
+    /** Align to the next byte boundary. */
+    align() {
+        this.bitpos = (this.bitpos + 7) & ~7;
+    }
+    // ─── Bit-level reads ─────────────────────────────────────────
+    /** Read `count` bits as little-endian unsigned integer. */
+    bits(count) {
+        let result = 0;
+        let shift = 0;
+        let remaining = count;
+        while (remaining) {
+            const byteIdx = this.bitpos >> 3;
+            const bit = this.bitpos & 7;
+            const read = Math.min(remaining, 8 - bit);
+            const value = (this.buffer[byteIdx] >> bit) & ((1 << read) - 1);
+            result |= value << shift;
+            shift += read;
+            remaining -= read;
+            this.bitpos += read;
+        }
+        return result;
+    }
+    /** Read a single bit (0 or 1). */
+    bit() {
+        const result = (this.buffer[this.bitpos >> 3] >> (this.bitpos & 7)) & 1;
+        this.bitpos += 1;
+        return result;
+    }
+    /** Skip forward by `count` bits. */
+    skipbits(count) {
+        this.bitpos += count;
+    }
+    // ─── Huffman ──────────────────────────────────────────────────
+    /** Read one Huffman-encoded character (for item type codes). */
+    char() {
+        let node = HUFFMAN_TREE;
+        while (Array.isArray(node)) {
+            node = node[this.bit()];
+        }
+        return node;
+    }
+    // ─── Utility ──────────────────────────────────────────────────
+    /** Returns true when the reader has consumed the entire buffer. */
+    eof() {
+        return this.bitpos >= this.buffer.byteLength * 8;
+    }
+}
+//# sourceMappingURL=binary-reader.js.map

package/dist/core/binary-reader.js.map

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

package/dist/core/binary-writer.d.ts

@@ -0,0 +1,49 @@
+/**
+ * BitWriter — bit-level writer for D2R save files (Blizzless v105).
+ *
+ * Ported from d2planner/src/logic/binary/writer.js.
+ * Stores individual bits in an expanded Uint8Array (1 bit per byte),
+ * then packs them on `toArray()`.
+ *
+ * Also provides Huffman character writing via `writeChar()`.
+ */
+export declare class BitWriter {
+    /** Expanded bit storage: each byte holds 0 or 1. */
+    private bits;
+    /** Current write/seek offset in bits. */
+    offset: number;
+    /** High-water mark — total bit length. */
+    length: number;
+    constructor(capacity?: number);
+    /** Write a single bit (0 or 1). */
+    writeBit(value: number | boolean): this;
+    /** Write an array of bits (expanded form: each element is 0 or 1). */
+    writeBits(bitsArray: ArrayLike<number>, numberOfBits: number): this;
+    /** Write raw bytes, optionally limiting to `numberOfBits` bits. */
+    writeBytes(bytes: ArrayLike<number>, numberOfBits?: number): this;
+    /** Alias for `writeBytes`. */
+    writeArray(bytes: ArrayLike<number>, numberOfBits: number): this;
+    /** Write an unsigned 8-bit value. */
+    writeUInt8(value: number, numberOfBits?: number): this;
+    /** Write an unsigned 16-bit value (little-endian). */
+    writeUInt16(value: number, numberOfBits?: number): this;
+    /** Write an unsigned 32-bit value (little-endian). */
+    writeUInt32(value: number, numberOfBits?: number): this;
+    /** Write a UTF-8 string, padded/truncated to `numberOfBytes` bytes. */
+    writeString(value: string, numberOfBytes: number): this;
+    /** Write `bits` bits of `value` in MSB-first order. */
+    writeBitsNumber(value: number, bits: number): this;
+    /** Write one Huffman-encoded character (for item type codes). */
+    writeChar(ch: string): this;
+    /** Seek to an absolute bit offset. */
+    seekBit(offset: number): this;
+    /** Seek to an absolute byte offset. */
+    seekByte(offset: number): this;
+    /** Peek at `count` packed bytes starting from current offset (does NOT advance). */
+    peekBytes(count: number): Uint8Array;
+    /** Align offset to next byte boundary (skip forward). */
+    align(): this;
+    /** Pack expanded bit storage into a compact Uint8Array. */
+    toArray(): Uint8Array;
+}
+//# sourceMappingURL=binary-writer.d.ts.map

package/dist/core/binary-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary-writer.d.ts","sourceRoot":"","sources":["../../src/core/binary-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,qBAAa,SAAS;IACpB,oDAAoD;IACpD,OAAO,CAAC,IAAI,CAAa;IACzB,yCAAyC;IACzC,MAAM,SAAK;IACX,0CAA0C;IAC1C,MAAM,SAAK;gBAEC,QAAQ,SAAmB;IAMvC,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAWvC,sEAAsE;IACtE,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAOnE,mEAAmE;IACnE,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,YAAY,GAAE,MAAyC,GAAG,IAAI;IAWnG,8BAA8B;IAC9B,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAMhE,qCAAqC;IACrC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,SAAI,GAAG,IAAI;IAMjD,sDAAsD;IACtD,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,SAAK,GAAG,IAAI;IAMnD,sDAAsD;IACtD,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,SAAK,GAAG,IAAI;IAMnD,uEAAuE;IACvE,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI;IASvD,uDAAuD;IACvD,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IASlD,iEAAiE;IACjE,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQ3B,sCAAsC;IACtC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAM7B,uCAAuC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI9B,oFAAoF;IACpF,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;IAmBpC,yDAAyD;IACzD,KAAK,IAAI,IAAI;IAQb,2DAA2D;IAC3D,OAAO,IAAI,UAAU;CAiBtB"}

package/dist/core/binary-writer.js

@@ -0,0 +1,156 @@
+/**
+ * BitWriter — bit-level writer for D2R save files (Blizzless v105).
+ *
+ * Ported from d2planner/src/logic/binary/writer.js.
+ * Stores individual bits in an expanded Uint8Array (1 bit per byte),
+ * then packs them on `toArray()`.
+ *
+ * Also provides Huffman character writing via `writeChar()`.
+ */
+import { HUFFMAN_LOOKUP } from './huffman.js';
+const DEFAULT_CAPACITY = 8192;
+export class BitWriter {
+    /** Expanded bit storage: each byte holds 0 or 1. */
+    bits;
+    /** Current write/seek offset in bits. */
+    offset = 0;
+    /** High-water mark — total bit length. */
+    length = 0;
+    constructor(capacity = DEFAULT_CAPACITY) {
+        this.bits = new Uint8Array(capacity);
+    }
+    // ─── Primitive bit writes ─────────────────────────────────────
+    /** Write a single bit (0 or 1). */
+    writeBit(value) {
+        if (this.offset >= this.bits.length) {
+            const resized = new Uint8Array(this.bits.length + 8192);
+            resized.set(this.bits, 0);
+            this.bits = resized;
+        }
+        this.bits[this.offset++] = value ? 1 : 0;
+        if (this.offset > this.length)
+            this.length = this.offset;
+        return this;
+    }
+    /** Write an array of bits (expanded form: each element is 0 or 1). */
+    writeBits(bitsArray, numberOfBits) {
+        for (let i = 0; i < numberOfBits; i++) {
+            this.writeBit(bitsArray[i]);
+        }
+        return this;
+    }
+    /** Write raw bytes, optionally limiting to `numberOfBits` bits. */
+    writeBytes(bytes, numberOfBits = bytes.length * 8) {
+        const toWrite = new Uint8Array(numberOfBits);
+        let acc = 0;
+        for (let j = 0; j < bytes.length && acc < numberOfBits; j++) {
+            for (let k = 0; k < 8 && acc < numberOfBits; k++) {
+                toWrite[acc++] = (bytes[j] >> k) & 1;
+            }
+        }
+        return this.writeBits(toWrite, numberOfBits);
+    }
+    /** Alias for `writeBytes`. */
+    writeArray(bytes, numberOfBits) {
+        return this.writeBytes(bytes, numberOfBits);
+    }
+    // ─── Typed writes (little-endian) ─────────────────────────────
+    /** Write an unsigned 8-bit value. */
+    writeUInt8(value, numberOfBits = 8) {
+        const buffer = new Uint8Array(1);
+        new DataView(buffer.buffer).setUint8(0, value);
+        return this.writeBytes(buffer, numberOfBits);
+    }
+    /** Write an unsigned 16-bit value (little-endian). */
+    writeUInt16(value, numberOfBits = 16) {
+        const buffer = new Uint8Array(2);
+        new DataView(buffer.buffer).setUint16(0, value, true);
+        return this.writeBytes(buffer, numberOfBits);
+    }
+    /** Write an unsigned 32-bit value (little-endian). */
+    writeUInt32(value, numberOfBits = 32) {
+        const buffer = new Uint8Array(4);
+        new DataView(buffer.buffer).setUint32(0, value, true);
+        return this.writeBytes(buffer, numberOfBits);
+    }
+    /** Write a UTF-8 string, padded/truncated to `numberOfBytes` bytes. */
+    writeString(value, numberOfBytes) {
+        const encoded = new TextEncoder().encode(value);
+        const padded = new Uint8Array(numberOfBytes);
+        padded.set(encoded.subarray(0, numberOfBytes));
+        return this.writeBytes(padded, numberOfBytes * 8);
+    }
+    // ─── MSB bit write (used for specific flag fields) ────────────
+    /** Write `bits` bits of `value` in MSB-first order. */
+    writeBitsNumber(value, bits) {
+        for (let i = bits - 1; i >= 0; i--) {
+            this.writeBit((value >> i) & 1);
+        }
+        return this;
+    }
+    // ─── Huffman writes ───────────────────────────────────────────
+    /** Write one Huffman-encoded character (for item type codes). */
+    writeChar(ch) {
+        const entry = HUFFMAN_LOOKUP[ch];
+        if (!entry)
+            throw new Error(`writeChar: unsupported character '${ch}'`);
+        return this.writeUInt16(entry.v, entry.l);
+    }
+    // ─── Positioning / Peek ───────────────────────────────────────
+    /** Seek to an absolute bit offset. */
+    seekBit(offset) {
+        this.offset = offset;
+        if (this.offset > this.length)
+            this.length = this.offset;
+        return this;
+    }
+    /** Seek to an absolute byte offset. */
+    seekByte(offset) {
+        return this.seekBit(offset * 8);
+    }
+    /** Peek at `count` packed bytes starting from current offset (does NOT advance). */
+    peekBytes(count) {
+        const buffer = new Uint8Array(count);
+        let byteIndex = 0;
+        let bitIndex = 0;
+        for (let i = 0; i < count * 8; ++i) {
+            if (this.bits[this.offset + i]) {
+                buffer[byteIndex] |= (1 << bitIndex) & 0xff;
+            }
+            bitIndex++;
+            if (bitIndex >= 8) {
+                byteIndex++;
+                bitIndex = 0;
+            }
+        }
+        return buffer;
+    }
+    // ─── Alignment ────────────────────────────────────────────────
+    /** Align offset to next byte boundary (skip forward). */
+    align() {
+        this.offset = (this.offset + 7) & ~7;
+        if (this.offset > this.length)
+            this.length = this.offset;
+        return this;
+    }
+    // ─── Output ───────────────────────────────────────────────────
+    /** Pack expanded bit storage into a compact Uint8Array. */
+    toArray() {
+        const byteLen = this.length > 0 ? Math.ceil(this.length / 8) : 0;
+        const buffer = new Uint8Array(byteLen);
+        let byteIndex = 0;
+        let bitIndex = 0;
+        for (let i = 0; i < this.length; ++i) {
+            if (this.bits[i]) {
+                buffer[byteIndex] |= (1 << bitIndex) & 0xff;
+            }
+            ++bitIndex;
+            if (bitIndex >= 8) {
+                ++byteIndex;
+                bitIndex = 0;
+            }
+        }
+        return buffer;
+    }
+}
+//# sourceMappingURL=binary-writer.js.map

package/dist/core/binary-writer.js.map

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

package/dist/core/checksum.d.ts

@@ -0,0 +1,28 @@
+/**
+ * D2S checksum — compute and patch the rolling checksum used by D2R save files.
+ *
+ * Ported from d2planner `fixHeader()` in writed2s.js.
+ *
+ * Format layout (byte offsets):
+ *   0x00  magic   (4 bytes, "aa 55 aa 55")
+ *   0x04  version (4 bytes)
+ *   0x08  filesize (4 bytes)  ← written by fixHeader
+ *   0x0C  checksum (4 bytes)  ← written by fixHeader
+ */
+import { BitWriter } from './binary-writer.js';
+/**
+ * Write the file size at offset 0x08 and compute + write the rolling checksum
+ * at offset 0x0C. Must be called **after** all other data has been written.
+ *
+ * @param writer The `BitWriter` that contains the fully-written save data.
+ */
+export declare function fixHeader(writer: BitWriter): void;
+/**
+ * Compute the checksum for a packed byte array (e.g. from `writer.toArray()`).
+ * The checksum field at 0x0C is treated as zero during computation.
+ *
+ * @param data Complete file bytes.
+ * @returns The 32-bit rolling checksum.
+ */
+export declare function computeChecksum(data: Uint8Array): number;
+//# sourceMappingURL=checksum.d.ts.map

package/dist/core/checksum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checksum.d.ts","sourceRoot":"","sources":["../../src/core/checksum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAO/C;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqBjD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAcxD"}

package/dist/core/checksum.js

@@ -0,0 +1,62 @@
+/**
+ * D2S checksum — compute and patch the rolling checksum used by D2R save files.
+ *
+ * Ported from d2planner `fixHeader()` in writed2s.js.
+ *
+ * Format layout (byte offsets):
+ *   0x00  magic   (4 bytes, "aa 55 aa 55")
+ *   0x04  version (4 bytes)
+ *   0x08  filesize (4 bytes)  ← written by fixHeader
+ *   0x0C  checksum (4 bytes)  ← written by fixHeader
+ */
+/** Byte offset of the file-size field. */
+const OFFSET_FILESIZE = 0x08;
+/** Byte offset of the checksum field. */
+const OFFSET_CHECKSUM = 0x0c;
+/**
+ * Write the file size at offset 0x08 and compute + write the rolling checksum
+ * at offset 0x0C. Must be called **after** all other data has been written.
+ *
+ * @param writer The `BitWriter` that contains the fully-written save data.
+ */
+export function fixHeader(writer) {
+    const eof = Math.ceil(writer.offset / 8);
+    // Write file size at 0x08
+    writer.seekByte(OFFSET_FILESIZE).writeUInt32(eof);
+    // Zero out the checksum field before computing
+    writer.seekByte(OFFSET_CHECKSUM).writeUInt32(0);
+    // Compute rolling checksum over the entire file
+    let checksum = 0;
+    for (let i = 0; i < eof; i++) {
+        let byte = writer.seekByte(i).peekBytes(1)[0];
+        if (checksum & 0x80000000) {
+            byte += 1;
+        }
+        checksum = (byte + checksum * 2) >>> 0;
+    }
+    // Write checksum at 0x0C
+    writer.seekByte(OFFSET_CHECKSUM).writeUInt32(checksum);
+}
+/**
+ * Compute the checksum for a packed byte array (e.g. from `writer.toArray()`).
+ * The checksum field at 0x0C is treated as zero during computation.
+ *
+ * @param data Complete file bytes.
+ * @returns The 32-bit rolling checksum.
+ */
+export function computeChecksum(data) {
+    let checksum = 0;
+    for (let i = 0; i < data.length; i++) {
+        let byte = data[i];
+        // Skip the checksum field (4 bytes at 0x0C)
+        if (i >= OFFSET_CHECKSUM && i < OFFSET_CHECKSUM + 4) {
+            byte = 0;
+        }
+        if (checksum & 0x80000000) {
+            byte += 1;
+        }
+        checksum = (byte + checksum * 2) >>> 0;
+    }
+    return checksum;
+}
+//# sourceMappingURL=checksum.js.map

package/dist/core/checksum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checksum.js","sourceRoot":"","sources":["../../src/core/checksum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,0CAA0C;AAC1C,MAAM,eAAe,GAAG,IAAI,CAAC;AAC7B,yCAAyC;AACzC,MAAM,eAAe,GAAG,IAAI,CAAC;AAE7B;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,MAAiB;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAEzC,0BAA0B;IAC1B,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAElD,+CAA+C;IAC/C,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAEhD,gDAAgD;IAChD,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,IAAI,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,IAAI,QAAQ,GAAG,UAAU,EAAE,CAAC;YAC1B,IAAI,IAAI,CAAC,CAAC;QACZ,CAAC;QACD,QAAQ,GAAG,CAAC,IAAI,GAAG,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,yBAAyB;IACzB,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,IAAgB;IAC9C,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACnB,4CAA4C;QAC5C,IAAI,CAAC,IAAI,eAAe,IAAI,CAAC,GAAG,eAAe,GAAG,CAAC,EAAE,CAAC;YACpD,IAAI,GAAG,CAAC,CAAC;QACX,CAAC;QACD,IAAI,QAAQ,GAAG,UAAU,EAAE,CAAC;YAC1B,IAAI,IAAI,CAAC,CAAC;QACZ,CAAC;QACD,QAAQ,GAAG,CAAC,IAAI,GAAG,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/core/huffman.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Huffman tree and lookup table for D2R item code encoding/decoding.
+ *
+ * Used in v105 (Blizzless) for 3-character item codes.
+ * Alphabet: [a-z0-9 ] — 37 symbols.
+ * Space (' ') is the most frequent (2 bits), 'j' is the rarest (9 bits).
+ */
+/**
+ * Huffman decoding tree. Navigate by bit value (0=left, 1=right) until a string leaf is reached.
+ * Note: some nodes have only one child (e.g. `["j"]`) — only bit 0 is valid there.
+ */
+export type HuffmanNode = [HuffmanNode, HuffmanNode] | [HuffmanNode] | string;
+export declare const HUFFMAN_TREE: HuffmanNode;
+/** Huffman encoding lookup: char → { v: bit pattern, l: bit length } */
+export interface HuffmanEntry {
+    /** Bit pattern value (little-endian) */
+    readonly v: number;
+    /** Number of bits */
+    readonly l: number;
+}
+export declare const HUFFMAN_LOOKUP: Readonly<Record<string, HuffmanEntry>>;
+//# sourceMappingURL=huffman.d.ts.map

package/dist/core/huffman.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"huffman.d.ts","sourceRoot":"","sources":["../../src/core/huffman.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC;AAE9E,eAAO,MAAM,YAAY,EAAE,WAkB1B,CAAC;AAEF,wEAAwE;AACxE,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAsCjE,CAAC"}

package/dist/core/huffman.js

@@ -0,0 +1,66 @@
+/**
+ * Huffman tree and lookup table for D2R item code encoding/decoding.
+ *
+ * Used in v105 (Blizzless) for 3-character item codes.
+ * Alphabet: [a-z0-9 ] — 37 symbols.
+ * Space (' ') is the most frequent (2 bits), 'j' is the rarest (9 bits).
+ */
+export const HUFFMAN_TREE = [
+    [
+        [
+            [['w', 'u'], [['8', ['y', ['5', ['j']]]], 'h']],
+            ['s', [['2', 'n'], 'x']],
+        ],
+        [
+            [['c', ['k', 'f']], 'b'],
+            [['t', 'm'], ['9', '7']],
+        ],
+    ],
+    [
+        ' ',
+        [
+            [[['e', 'd'], 'p'], ['g', [[['z', 'q'], '3'], ['v', '6']]]],
+            [['r', 'l'], ['a', [['1', ['4', '0']], ['i', 'o']]]],
+        ],
+    ],
+];
+export const HUFFMAN_LOOKUP = {
+    '0': { v: 223, l: 8 },
+    '1': { v: 31, l: 7 },
+    '2': { v: 12, l: 6 },
+    '3': { v: 91, l: 7 },
+    '4': { v: 95, l: 8 },
+    '5': { v: 104, l: 8 },
+    '6': { v: 123, l: 7 },
+    '7': { v: 30, l: 5 },
+    '8': { v: 8, l: 6 },
+    '9': { v: 14, l: 5 },
+    ' ': { v: 1, l: 2 },
+    a: { v: 15, l: 5 },
+    b: { v: 10, l: 4 },
+    c: { v: 2, l: 5 },
+    d: { v: 35, l: 6 },
+    e: { v: 3, l: 6 },
+    f: { v: 50, l: 6 },
+    g: { v: 11, l: 5 },
+    h: { v: 24, l: 5 },
+    i: { v: 63, l: 7 },
+    j: { v: 232, l: 9 },
+    k: { v: 18, l: 6 },
+    l: { v: 23, l: 5 },
+    m: { v: 22, l: 5 },
+    n: { v: 44, l: 6 },
+    o: { v: 127, l: 7 },
+    p: { v: 19, l: 5 },
+    q: { v: 155, l: 8 },
+    r: { v: 7, l: 5 },
+    s: { v: 4, l: 4 },
+    t: { v: 6, l: 5 },
+    u: { v: 16, l: 5 },
+    v: { v: 59, l: 7 },
+    w: { v: 0, l: 5 },
+    x: { v: 28, l: 5 },
+    y: { v: 40, l: 7 },
+    z: { v: 27, l: 8 },
+};
+//# sourceMappingURL=huffman.js.map

package/dist/core/huffman.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"huffman.js","sourceRoot":"","sources":["../../src/core/huffman.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,MAAM,CAAC,MAAM,YAAY,GAAgB;IACvC;QACE;YACE,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAC/C,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;SACzB;QACD;YACE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC;YACxB,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;SACzB;KACF;IACD;QACE,GAAG;QACH;YACE,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;YAC3D,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;SACrD;KACF;CACF,CAAC;AAUF,MAAM,CAAC,MAAM,cAAc,GAA2C;IACpE,GAAG,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE;IACrB,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;IACpB,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;IACpB,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;IACpB,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;IACpB,GAAG,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE;IACrB,GAAG,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE;IACrB,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;IACpB,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;IACnB,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;IACpB,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;IACnB,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;IAClB,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;IAClB,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;IACjB,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;IAClB,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;IACjB,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;IAClB,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;IAClB,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;IAClB,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;IAClB,CAAC,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE;IACnB,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;IAClB,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;IAClB,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;IAClB,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;IAClB,CAAC,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE;IACnB,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;IAClB,CAAC,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE;IACnB,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;IACjB,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;IACjB,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;IACjB,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;IAClB,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;IAClB,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;IACjB,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;IAClB,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;IAClB,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;CACnB,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,5 @@
+export { BinaryReader } from './binary-reader.js';
+export { BitWriter } from './binary-writer.js';
+export { fixHeader, computeChecksum } from './checksum.js';
+export { HUFFMAN_TREE, HUFFMAN_LOOKUP, type HuffmanNode, type HuffmanEntry, } from './huffman.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EACL,YAAY,EACZ,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,YAAY,GAClB,MAAM,cAAc,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,5 @@
+export { BinaryReader } from './binary-reader.js';
+export { BitWriter } from './binary-writer.js';
+export { fixHeader, computeChecksum } from './checksum.js';
+export { HUFFMAN_TREE, HUFFMAN_LOOKUP, } from './huffman.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EACL,YAAY,EACZ,cAAc,GAGf,MAAM,cAAc,CAAC"}