d2r-saver 0.1.0

package/dist/operations/insert-item.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Insert item into a save file — places an item and returns a patched buffer.
+ *
+ * Works with both .d2s and .d2i files.
+ */
+import { GameData } from '../game-data/game-data.js';
+import type { BinaryParsedItem } from '../formats/item-parser.js';
+/** Location types for D2S insertion. */
+export type InsertD2STarget = 'stash' | 'inventory' | 'cube';
+/** Result of inserting an item into a save. */
+export interface InsertResult {
+    /** Patched file buffer with the item inserted. */
+    newBuffer: Uint8Array;
+    /** Position where the item was placed. */
+    position: {
+        x: number;
+        y: number;
+    };
+}
+/** Result of inserting an item into a D2I stash. */
+export interface InsertD2IResult extends InsertResult {
+    /** Page index where the item was placed. */
+    pageIndex: number;
+}
+/**
+ * Insert an item into a .d2s character save.
+ *
+ * If `position` is provided, attempts to place at that exact location.
+ * Otherwise, finds the first available slot.
+ *
+ * @param buffer  Original .d2s file bytes.
+ * @param item    The item to insert.
+ * @param allItemsForItem  All items for the item (e.g. socketed sub-items).
+ * @param target  Where to place: 'stash', 'inventory', or 'cube'.
+ * @param gd      GameData instance.
+ * @param position  Optional specific position `{ x, y }`.
+ */
+export declare function insertItemD2S(buffer: Uint8Array, item: BinaryParsedItem, allItemsForItem: Record<number | string, BinaryParsedItem>, target: InsertD2STarget, gd: GameData, position?: {
+    x: number;
+    y: number;
+}): InsertResult;
+/**
+ * Insert an item into a .d2i stash page.
+ *
+ * If `position` is provided, attempts to place at that exact location on the
+ * specified page. Otherwise, finds the first available slot across normal pages.
+ *
+ * @param buffer  Original .d2i file bytes.
+ * @param item    The item to insert.
+ * @param allItemsForItem  All items for the item (e.g. socketed sub-items).
+ * @param gd      GameData instance.
+ * @param target  Optional { pageIndex, x, y } for exact placement.
+ */
+export declare function insertItemD2I(buffer: Uint8Array, item: BinaryParsedItem, allItemsForItem: Record<number | string, BinaryParsedItem>, gd: GameData, target?: {
+    pageIndex: number;
+    x: number;
+    y: number;
+}): InsertD2IResult;
+//# sourceMappingURL=insert-item.d.ts.map

package/dist/operations/insert-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-item.d.ts","sourceRoot":"","sources":["../../src/operations/insert-item.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAKrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAOlE,wCAAwC;AACxC,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,WAAW,GAAG,MAAM,CAAC;AAE7D,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,SAAS,EAAE,UAAU,CAAC;IACtB,0CAA0C;IAC1C,QAAQ,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpC;AAED,oDAAoD;AACpD,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;CACnB;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,gBAAgB,EACtB,eAAe,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,gBAAgB,CAAC,EAC1D,MAAM,EAAE,eAAe,EACvB,EAAE,EAAE,QAAQ,EACZ,QAAQ,CAAC,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAClC,YAAY,CAwDd;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,gBAAgB,EACtB,eAAe,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,gBAAgB,CAAC,EAC1D,EAAE,EAAE,QAAQ,EACZ,MAAM,CAAC,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD,eAAe,CA6EjB"}

package/dist/operations/insert-item.js

@@ -0,0 +1,210 @@
+/**
+ * Insert item into a save file — places an item and returns a patched buffer.
+ *
+ * Works with both .d2s and .d2i files.
+ */
+import { readD2S } from '../formats/d2s-reader.js';
+import { writeD2S } from '../formats/d2s-writer.js';
+import { readD2I } from '../formats/d2i-reader.js';
+import { patchStashPage } from '../formats/d2i-writer.js';
+import { buildGrid, findFreeSlot, canPlaceItem } from '../inventory/placement.js';
+import { STASH, INVENTORY, CUBE } from '../inventory/dimensions.js';
+// ─── insertItemD2S ──────────────────────────────────────────────
+/**
+ * Insert an item into a .d2s character save.
+ *
+ * If `position` is provided, attempts to place at that exact location.
+ * Otherwise, finds the first available slot.
+ *
+ * @param buffer  Original .d2s file bytes.
+ * @param item    The item to insert.
+ * @param allItemsForItem  All items for the item (e.g. socketed sub-items).
+ * @param target  Where to place: 'stash', 'inventory', or 'cube'.
+ * @param gd      GameData instance.
+ * @param position  Optional specific position `{ x, y }`.
+ */
+export function insertItemD2S(buffer, item, allItemsForItem, target, gd, position) {
+    const { profile, items } = readD2S(buffer, gd);
+    const { size, slots } = getTargetInfo(profile, target);
+    // Build occupancy grid
+    const grid = buildGrid(size, slots, items, gd);
+    // Determine placement position
+    let x;
+    let y;
+    if (position) {
+        if (!canPlaceItem(grid, position.x, position.y, item, gd)) {
+            throw new Error(`NO_SPACE: cannot place item at (${position.x}, ${position.y}) in ${target}`);
+        }
+        x = position.x;
+        y = position.y;
+    }
+    else {
+        const slot = findFreeSlot(grid, item, gd);
+        if (!slot) {
+            throw new Error(`NO_SPACE: no free slot for item in ${target}`);
+        }
+        x = slot.x;
+        y = slot.y;
+    }
+    // Assign new unique item ID
+    const maxId = Math.max(0, ...Object.keys(items).filter(k => !isNaN(Number(k))).map(Number));
+    const newId = maxId + 1;
+    const newItem = { ...item, itemId: newId };
+    // Register item and its sockets in the save's items dict
+    items[newId] = newItem;
+    let nextSocketId = newId + 1;
+    if (item.socketedItems) {
+        const newSocketedIds = [];
+        for (const oldSid of item.socketedItems) {
+            const sockItem = allItemsForItem[oldSid];
+            if (sockItem) {
+                items[nextSocketId] = { ...sockItem, itemId: nextSocketId };
+                newSocketedIds.push(nextSocketId);
+                nextSocketId++;
+            }
+        }
+        newItem.socketedItems = newSocketedIds;
+    }
+    // Place in the slot array
+    const slotIndex = y * size.columns + x;
+    slots[slotIndex] = newId;
+    // Rewrite D2S
+    const newBuffer = writeD2S({ profile: profile, items, gd });
+    return { newBuffer, position: { x, y } };
+}
+// ─── insertItemD2I ──────────────────────────────────────────────
+/**
+ * Insert an item into a .d2i stash page.
+ *
+ * If `position` is provided, attempts to place at that exact location on the
+ * specified page. Otherwise, finds the first available slot across normal pages.
+ *
+ * @param buffer  Original .d2i file bytes.
+ * @param item    The item to insert.
+ * @param allItemsForItem  All items for the item (e.g. socketed sub-items).
+ * @param gd      GameData instance.
+ * @param target  Optional { pageIndex, x, y } for exact placement.
+ */
+export function insertItemD2I(buffer, item, allItemsForItem, gd, target) {
+    const { pages, items } = readD2I(buffer, gd);
+    // Filter to normal pages only (pageType=0)
+    const normalPages = pages.filter(p => p.pageType === 0);
+    let targetPage;
+    let x;
+    let y;
+    if (target) {
+        // Exact placement
+        targetPage = pages[target.pageIndex];
+        if (!targetPage)
+            throw new Error(`PAGE_NOT_FOUND: page ${target.pageIndex} not found`);
+        if (targetPage.pageType !== 0)
+            throw new Error('INVALID_PAGE: can only insert into normal pages');
+        const grid = buildGrid(STASH, targetPage.stash, items, gd);
+        if (!canPlaceItem(grid, target.x, target.y, item, gd)) {
+            throw new Error(`NO_SPACE: cannot place item at (${target.x}, ${target.y}) on page ${target.pageIndex}`);
+        }
+        x = target.x;
+        y = target.y;
+    }
+    else {
+        // Auto-find slot across normal pages
+        let found = false;
+        targetPage = normalPages[0]; // default
+        x = 0;
+        y = 0;
+        for (const page of normalPages) {
+            const grid = buildGrid(STASH, page.stash, items, gd);
+            const slot = findFreeSlot(grid, item, gd);
+            if (slot) {
+                targetPage = page;
+                x = slot.x;
+                y = slot.y;
+                found = true;
+                break;
+            }
+        }
+        if (!found) {
+            throw new Error('NO_SPACE: no free slot for item in any stash page');
+        }
+    }
+    // Assign new unique item ID
+    const maxId = Math.max(0, ...Object.keys(items).filter(k => !isNaN(Number(k))).map(Number));
+    const newId = maxId + 1;
+    const newItem = { ...item, itemId: newId };
+    // Register item and its sockets
+    items[newId] = newItem;
+    let nextSocketId = newId + 1;
+    if (item.socketedItems) {
+        const newSocketedIds = [];
+        for (const oldSid of item.socketedItems) {
+            const sockItem = allItemsForItem[oldSid];
+            if (sockItem) {
+                items[nextSocketId] = { ...sockItem, itemId: nextSocketId };
+                newSocketedIds.push(nextSocketId);
+                nextSocketId++;
+            }
+        }
+        newItem.socketedItems = newSocketedIds;
+    }
+    // Place in stash array
+    const slotIndex = y * 16 + x; // STASH columns = 16
+    targetPage.stash[slotIndex] = newId;
+    // Build write page and patch
+    const writePage = buildWritePageFromStash(targetPage, items, gd);
+    const rawPageIndex = findRawPageIndex(pages, targetPage.index);
+    const newBuffer = patchStashPage(buffer, rawPageIndex, writePage, items, gd);
+    return { newBuffer, position: { x, y }, pageIndex: targetPage.index };
+}
+// ─── Helpers ────────────────────────────────────────────────────
+/** Get target grid info from a D2S profile. */
+function getTargetInfo(profile, target) {
+    switch (target) {
+        case 'stash':
+            return { size: STASH, slots: profile.stash };
+        case 'inventory':
+            return { size: INVENTORY, slots: profile.inventory };
+        case 'cube':
+            return { size: CUBE, slots: profile.cube };
+        default:
+            throw new Error(`INVALID_TARGET: unknown target '${target}'`);
+    }
+}
+/** Build a WriteStashPage from a D2IStashPage's current stash array. */
+function buildWritePageFromStash(page, items, gd) {
+    const entries = [];
+    const columns = 16; // STASH.columns
+    for (let slot = 0; slot < page.stash.length; slot++) {
+        const id = page.stash[slot];
+        if (id == null)
+            continue;
+        const item = items[id];
+        if (!item)
+            continue;
+        // Skip socketed sub-items
+        const isSocketed = Object.values(items).some(i => i.socketedItems?.includes(id));
+        if (isSocketed)
+            continue;
+        const x = slot % columns;
+        const y = Math.floor(slot / columns);
+        const location = { loc: 0, equip: 0, x, y, storage: 5 };
+        entries.push({ item, location });
+    }
+    return {
+        pageType: typeof page.pageType === 'number' ? page.pageType : 0,
+        gold: page.gold,
+        entries,
+    };
+}
+/** Find the raw sector index for a page in the d2i file. */
+function findRawPageIndex(pages, targetPageIndex) {
+    const targetOffset = pages[targetPageIndex].offset;
+    const seenOffsets = new Set();
+    for (let i = 0; i < pages.length; i++) {
+        const off = pages[i].offset;
+        if (off === targetOffset)
+            return seenOffsets.size;
+        seenOffsets.add(off);
+    }
+    return targetPageIndex;
+}
+//# sourceMappingURL=insert-item.js.map

package/dist/operations/insert-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-item.js","sourceRoot":"","sources":["../../src/operations/insert-item.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,OAAO,EAA4B,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,OAAO,EAAqB,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,cAAc,EAAuB,MAAM,0BAA0B,CAAC;AAG/E,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAiB,MAAM,4BAA4B,CAAC;AAqBnF,mEAAmE;AAEnE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAkB,EAClB,IAAsB,EACtB,eAA0D,EAC1D,MAAuB,EACvB,EAAY,EACZ,QAAmC;IAEnC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAE/C,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAEvD,uBAAuB;IACvB,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;IAE/C,+BAA+B;IAC/B,IAAI,CAAS,CAAC;IACd,IAAI,CAAS,CAAC;IAEd,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,mCAAmC,QAAQ,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,QAAQ,MAAM,EAAE,CAAC,CAAC;QAChG,CAAC;QACD,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;QACf,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;IACjB,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,sCAAsC,MAAM,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QACX,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACb,CAAC;IAED,4BAA4B;IAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5F,MAAM,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC;IACxB,MAAM,OAAO,GAAG,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAE3C,yDAAyD;IACzD,KAAK,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC;IACvB,IAAI,YAAY,GAAG,KAAK,GAAG,CAAC,CAAC;IAC7B,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,MAAM,cAAc,GAAa,EAAE,CAAC;QACpC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACxC,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;YACzC,IAAI,QAAQ,EAAE,CAAC;gBACb,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;gBAC5D,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAClC,YAAY,EAAE,CAAC;YACjB,CAAC;QACH,CAAC;QACD,OAAO,CAAC,aAAa,GAAG,cAAc,CAAC;IACzC,CAAC;IAED,0BAA0B;IAC1B,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;IACvC,KAAK,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC;IAEzB,cAAc;IACd,MAAM,SAAS,GAAG,QAAQ,CAAC,EAAE,OAAO,EAAE,OAA8B,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IAEnF,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;AAC3C,CAAC;AAED,mEAAmE;AAEnE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAkB,EAClB,IAAsB,EACtB,eAA0D,EAC1D,EAAY,EACZ,MAAoD;IAEpD,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAE7C,2CAA2C;IAC3C,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC;IAExD,IAAI,UAAwB,CAAC;IAC7B,IAAI,CAAS,CAAC;IACd,IAAI,CAAS,CAAC;IAEd,IAAI,MAAM,EAAE,CAAC;QACX,kBAAkB;QAClB,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,CAAC,SAAS,YAAY,CAAC,CAAC;QACvF,IAAI,UAAU,CAAC,QAAQ,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QAElG,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,mCAAmC,MAAM,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,aAAa,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAC3G,CAAC;QACD,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;QACb,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IACf,CAAC;SAAM,CAAC;QACN,qCAAqC;QACrC,IAAI,KAAK,GAAG,KAAK,CAAC;QAClB,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU;QACvC,CAAC,GAAG,CAAC,CAAC;QACN,CAAC,GAAG,CAAC,CAAC;QAEN,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YACrD,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;YAC1C,IAAI,IAAI,EAAE,CAAC;gBACT,UAAU,GAAG,IAAI,CAAC;gBAClB,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;gBACX,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;gBACX,KAAK,GAAG,IAAI,CAAC;gBACb,MAAM;YACR,CAAC;QACH,CAAC;QAED,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5F,MAAM,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC;IACxB,MAAM,OAAO,GAAG,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAE3C,gCAAgC;IAChC,KAAK,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC;IACvB,IAAI,YAAY,GAAG,KAAK,GAAG,CAAC,CAAC;IAC7B,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,MAAM,cAAc,GAAa,EAAE,CAAC;QACpC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACxC,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;YACzC,IAAI,QAAQ,EAAE,CAAC;gBACb,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;gBAC5D,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAClC,YAAY,EAAE,CAAC;YACjB,CAAC;QACH,CAAC;QACD,OAAO,CAAC,aAAa,GAAG,cAAc,CAAC;IACzC,CAAC;IAED,uBAAuB;IACvB,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,qBAAqB;IACnD,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC;IAEpC,6BAA6B;IAC7B,MAAM,SAAS,GAAG,uBAAuB,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;IACjE,MAAM,YAAY,GAAG,gBAAgB,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;IAE7E,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC;AACxE,CAAC;AAED,mEAAmE;AAEnE,+CAA+C;AAC/C,SAAS,aAAa,CACpB,OAA4B,EAC5B,MAAuB;IAEvB,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,OAAO;YACV,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QAC/C,KAAK,WAAW;YACd,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;QACvD,KAAK,MAAM;YACT,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;QAC7C;YACE,MAAM,IAAI,KAAK,CAAC,mCAAmC,MAAM,GAAG,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,SAAS,uBAAuB,CAC9B,IAAkB,EAClB,KAAgD,EAChD,EAAY;IAEZ,MAAM,OAAO,GAAqB,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,EAAE,CAAC,CAAC,gBAAgB;IAEpC,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;QACpD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,EAAE,IAAI,IAAI;YAAE,SAAS;QACzB,MAAM,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,0BAA0B;QAC1B,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAC1C,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,EAAE,QAAQ,CAAC,EAAY,CAAC,CAC7C,CAAC;QACF,IAAI,UAAU;YAAE,SAAS;QAEzB,MAAM,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC;QACzB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC;QACrC,MAAM,QAAQ,GAAsB,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QAC3E,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC/D,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO;KACR,CAAC;AACJ,CAAC;AAED,4DAA4D;AAC5D,SAAS,gBAAgB,CAAC,KAAqB,EAAE,eAAuB;IACtE,MAAM,YAAY,GAAG,KAAK,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC;IACnD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAC5B,IAAI,GAAG,KAAK,YAAY;YAAE,OAAO,WAAW,CAAC,IAAI,CAAC;QAClD,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/dist/operations/read-save.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Universal save file reader — auto-detects format and parses.
+ */
+import { type D2SReadResult } from '../formats/d2s-reader.js';
+import { type D2IReadResult } from '../formats/d2i-reader.js';
+import type { GameData } from '../game-data/game-data.js';
+export interface ReadSaveD2SResult {
+    type: 'd2s';
+    data: D2SReadResult;
+}
+export interface ReadSaveD2IResult {
+    type: 'd2i';
+    data: D2IReadResult;
+}
+export type ReadSaveResult = ReadSaveD2SResult | ReadSaveD2IResult;
+/**
+ * Detect format and parse a save file buffer.
+ *
+ * @param buffer  Raw file bytes.
+ * @param gd      GameData instance.
+ * @returns Discriminated union with `type` and parsed `data`.
+ * @throws {D2RSaverError} INVALID_FORMAT if file cannot be detected.
+ */
+export declare function readSave(buffer: Uint8Array, gd: GameData): ReadSaveResult;
+//# sourceMappingURL=read-save.d.ts.map

package/dist/operations/read-save.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-save.d.ts","sourceRoot":"","sources":["../../src/operations/read-save.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAW,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAW,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAK1D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,MAAM,MAAM,cAAc,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAInE;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,GAAG,cAAc,CAWzE"}

package/dist/operations/read-save.js

@@ -0,0 +1,27 @@
+/**
+ * Universal save file reader — auto-detects format and parses.
+ */
+import { detectFormat } from '../formats/detect.js';
+import { readD2S } from '../formats/d2s-reader.js';
+import { readD2I } from '../formats/d2i-reader.js';
+import { D2RSaverError, ErrorCode } from '../types/errors.js';
+// ─── Public API ─────────────────────────────────────────────────
+/**
+ * Detect format and parse a save file buffer.
+ *
+ * @param buffer  Raw file bytes.
+ * @param gd      GameData instance.
+ * @returns Discriminated union with `type` and parsed `data`.
+ * @throws {D2RSaverError} INVALID_FORMAT if file cannot be detected.
+ */
+export function readSave(buffer, gd) {
+    const format = detectFormat(buffer);
+    if (!format) {
+        throw new D2RSaverError(ErrorCode.INVALID_FORMAT, 'File is not a valid Blizzless v105 d2s or d2i.');
+    }
+    if (format.type === 'd2s') {
+        return { type: 'd2s', data: readD2S(buffer, gd) };
+    }
+    return { type: 'd2i', data: readD2I(buffer, gd) };
+}
+//# sourceMappingURL=read-save.js.map

package/dist/operations/read-save.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-save.js","sourceRoot":"","sources":["../../src/operations/read-save.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAsB,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,OAAO,EAAsB,MAAM,0BAA0B,CAAC;AAEvE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAgB9D,mEAAmE;AAEnE;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAkB,EAAE,EAAY;IACvD,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,aAAa,CAAC,SAAS,CAAC,cAAc,EAAE,gDAAgD,CAAC,CAAC;IACtG,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QAC1B,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;IACpD,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;AACpD,CAAC"}

package/dist/types/constants.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Enums & constants for Blizzless D2R v105 save format.
+ */
+export declare enum ItemQuality {
+    LOW = 1,
+    NORMAL = 2,
+    SUPERIOR = 3,
+    MAGIC = 4,
+    SET = 5,
+    RARE = 6,
+    UNIQUE = 7,
+    CRAFTED = 8
+}
+/** Where the item is in the save file (3-bit location field). */
+export declare enum LocationType {
+    /** Stored in a location grid (inventory, cube, stash). */
+    STORED = 0,
+    /** Equipped on body. */
+    EQUIPPED = 1,
+    /** In belt. */
+    BELT = 2,
+    /** Socketed inside another item. */
+    SOCKETED = 6
+}
+/** Storage grid identifier (3-bit field for STORED items). */
+export declare enum StorageType {
+    NONE = 0,
+    INVENTORY = 1,
+    CUBE = 4,
+    STASH = 5
+}
+/** Body slot index for equipped items (4-bit bodyloc field). */
+export declare enum BodyLocation {
+    NONE = 0,
+    HEAD = 1,
+    NECK = 2,
+    TORSO = 3,
+    RIGHT_HAND = 4,
+    LEFT_HAND = 5,
+    RIGHT_RING = 6,
+    LEFT_RING = 7,
+    WAIST = 8,
+    FEET = 9,
+    GLOVES = 10
+}
+/** D2S magic signature. */
+export declare const D2S_MAGIC = 2857740885;
+/** D2I (stash) magic signature. */
+export declare const D2I_MAGIC = 5460804;
+/** Only supported version. */
+export declare const BLIZZLESS_VERSION = 105;
+export declare const STASH_WIDTH = 16;
+export declare const STASH_HEIGHT = 13;
+export declare const INVENTORY_WIDTH = 10;
+export declare const INVENTORY_HEIGHT = 4;
+export declare const CUBE_WIDTH = 3;
+export declare const CUBE_HEIGHT = 4;
+/** Section marker in d2s: item list section. */
+export declare const SECTION_ITEMS = 19021;
+/** Section marker in d2s: character stats. */
+export declare const SECTION_STATS = 26470;
+/** Section marker in d2s: extended section (v105). */
+export declare const SECTION_EXTENDED = 26220;
+/** Prefix for serialized item tokens. */
+export declare const TOKEN_PREFIX = "d2r1:";
+export declare enum CharacterClass {
+    AMAZON = 0,
+    SORCERESS = 1,
+    NECROMANCER = 2,
+    PALADIN = 3,
+    BARBARIAN = 4,
+    DRUID = 5,
+    ASSASSIN = 6
+}
+export declare const CLASS_NAMES: Readonly<Record<CharacterClass, string>>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/types/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/types/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,oBAAY,WAAW;IACrB,GAAG,IAAI;IACP,MAAM,IAAI;IACV,QAAQ,IAAI;IACZ,KAAK,IAAI;IACT,GAAG,IAAI;IACP,IAAI,IAAI;IACR,MAAM,IAAI;IACV,OAAO,IAAI;CACZ;AAID,iEAAiE;AACjE,oBAAY,YAAY;IACtB,0DAA0D;IAC1D,MAAM,IAAI;IACV,wBAAwB;IACxB,QAAQ,IAAI;IACZ,eAAe;IACf,IAAI,IAAI;IACR,oCAAoC;IACpC,QAAQ,IAAI;CACb;AAED,8DAA8D;AAC9D,oBAAY,WAAW;IACrB,IAAI,IAAI;IACR,SAAS,IAAI;IACb,IAAI,IAAI;IACR,KAAK,IAAI;CACV;AAED,gEAAgE;AAChE,oBAAY,YAAY;IACtB,IAAI,IAAI;IACR,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;IACT,UAAU,IAAI;IACd,SAAS,IAAI;IACb,UAAU,IAAI;IACd,SAAS,IAAI;IACb,KAAK,IAAI;IACT,IAAI,IAAI;IACR,MAAM,KAAK;CACZ;AAID,2BAA2B;AAC3B,eAAO,MAAM,SAAS,aAAa,CAAC;AACpC,mCAAmC;AACnC,eAAO,MAAM,SAAS,UAAa,CAAC;AAEpC,8BAA8B;AAC9B,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAIrC,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,eAAO,MAAM,YAAY,KAAK,CAAC;AAC/B,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,eAAO,MAAM,UAAU,IAAI,CAAC;AAC5B,eAAO,MAAM,WAAW,IAAI,CAAC;AAI7B,gDAAgD;AAChD,eAAO,MAAM,aAAa,QAAS,CAAC;AACpC,8CAA8C;AAC9C,eAAO,MAAM,aAAa,QAAS,CAAC;AACpC,sDAAsD;AACtD,eAAO,MAAM,gBAAgB,QAAS,CAAC;AAIvC,yCAAyC;AACzC,eAAO,MAAM,YAAY,UAAU,CAAC;AAIpC,oBAAY,cAAc;IACxB,MAAM,IAAI;IACV,SAAS,IAAI;IACb,WAAW,IAAI;IACf,OAAO,IAAI;IACX,SAAS,IAAI;IACb,KAAK,IAAI;IACT,QAAQ,IAAI;CACb;AAED,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAQhE,CAAC"}

package/dist/types/constants.js

@@ -0,0 +1,96 @@
+/**
+ * Enums & constants for Blizzless D2R v105 save format.
+ */
+// ─── Item Quality ───────────────────────────────────────────────
+export var ItemQuality;
+(function (ItemQuality) {
+    ItemQuality[ItemQuality["LOW"] = 1] = "LOW";
+    ItemQuality[ItemQuality["NORMAL"] = 2] = "NORMAL";
+    ItemQuality[ItemQuality["SUPERIOR"] = 3] = "SUPERIOR";
+    ItemQuality[ItemQuality["MAGIC"] = 4] = "MAGIC";
+    ItemQuality[ItemQuality["SET"] = 5] = "SET";
+    ItemQuality[ItemQuality["RARE"] = 6] = "RARE";
+    ItemQuality[ItemQuality["UNIQUE"] = 7] = "UNIQUE";
+    ItemQuality[ItemQuality["CRAFTED"] = 8] = "CRAFTED";
+})(ItemQuality || (ItemQuality = {}));
+// ─── Location / Storage ─────────────────────────────────────────
+/** Where the item is in the save file (3-bit location field). */
+export var LocationType;
+(function (LocationType) {
+    /** Stored in a location grid (inventory, cube, stash). */
+    LocationType[LocationType["STORED"] = 0] = "STORED";
+    /** Equipped on body. */
+    LocationType[LocationType["EQUIPPED"] = 1] = "EQUIPPED";
+    /** In belt. */
+    LocationType[LocationType["BELT"] = 2] = "BELT";
+    /** Socketed inside another item. */
+    LocationType[LocationType["SOCKETED"] = 6] = "SOCKETED";
+})(LocationType || (LocationType = {}));
+/** Storage grid identifier (3-bit field for STORED items). */
+export var StorageType;
+(function (StorageType) {
+    StorageType[StorageType["NONE"] = 0] = "NONE";
+    StorageType[StorageType["INVENTORY"] = 1] = "INVENTORY";
+    StorageType[StorageType["CUBE"] = 4] = "CUBE";
+    StorageType[StorageType["STASH"] = 5] = "STASH";
+})(StorageType || (StorageType = {}));
+/** Body slot index for equipped items (4-bit bodyloc field). */
+export var BodyLocation;
+(function (BodyLocation) {
+    BodyLocation[BodyLocation["NONE"] = 0] = "NONE";
+    BodyLocation[BodyLocation["HEAD"] = 1] = "HEAD";
+    BodyLocation[BodyLocation["NECK"] = 2] = "NECK";
+    BodyLocation[BodyLocation["TORSO"] = 3] = "TORSO";
+    BodyLocation[BodyLocation["RIGHT_HAND"] = 4] = "RIGHT_HAND";
+    BodyLocation[BodyLocation["LEFT_HAND"] = 5] = "LEFT_HAND";
+    BodyLocation[BodyLocation["RIGHT_RING"] = 6] = "RIGHT_RING";
+    BodyLocation[BodyLocation["LEFT_RING"] = 7] = "LEFT_RING";
+    BodyLocation[BodyLocation["WAIST"] = 8] = "WAIST";
+    BodyLocation[BodyLocation["FEET"] = 9] = "FEET";
+    BodyLocation[BodyLocation["GLOVES"] = 10] = "GLOVES";
+})(BodyLocation || (BodyLocation = {}));
+// ─── File format ────────────────────────────────────────────────
+/** D2S magic signature. */
+export const D2S_MAGIC = 0xaa55aa55;
+/** D2I (stash) magic signature. */
+export const D2I_MAGIC = 0x00535344; // "DST\0" in LE
+/** Only supported version. */
+export const BLIZZLESS_VERSION = 105;
+// ─── Grid dimensions (Blizzless) ────────────────────────────────
+export const STASH_WIDTH = 16;
+export const STASH_HEIGHT = 13;
+export const INVENTORY_WIDTH = 10;
+export const INVENTORY_HEIGHT = 4;
+export const CUBE_WIDTH = 3;
+export const CUBE_HEIGHT = 4;
+// ─── D2S section markers (v105 — no "JM" per-item headers) ─────
+/** Section marker in d2s: item list section. */
+export const SECTION_ITEMS = 0x4a4d; // "JM"
+/** Section marker in d2s: character stats. */
+export const SECTION_STATS = 0x6766; // "gf"
+/** Section marker in d2s: extended section (v105). */
+export const SECTION_EXTENDED = 0x666c; // "fl"
+// ─── Portability token prefix ───────────────────────────────────
+/** Prefix for serialized item tokens. */
+export const TOKEN_PREFIX = 'd2r1:';
+// ─── Character classes ──────────────────────────────────────────
+export var CharacterClass;
+(function (CharacterClass) {
+    CharacterClass[CharacterClass["AMAZON"] = 0] = "AMAZON";
+    CharacterClass[CharacterClass["SORCERESS"] = 1] = "SORCERESS";
+    CharacterClass[CharacterClass["NECROMANCER"] = 2] = "NECROMANCER";
+    CharacterClass[CharacterClass["PALADIN"] = 3] = "PALADIN";
+    CharacterClass[CharacterClass["BARBARIAN"] = 4] = "BARBARIAN";
+    CharacterClass[CharacterClass["DRUID"] = 5] = "DRUID";
+    CharacterClass[CharacterClass["ASSASSIN"] = 6] = "ASSASSIN";
+})(CharacterClass || (CharacterClass = {}));
+export const CLASS_NAMES = {
+    [CharacterClass.AMAZON]: 'Amazon',
+    [CharacterClass.SORCERESS]: 'Sorceress',
+    [CharacterClass.NECROMANCER]: 'Necromancer',
+    [CharacterClass.PALADIN]: 'Paladin',
+    [CharacterClass.BARBARIAN]: 'Barbarian',
+    [CharacterClass.DRUID]: 'Druid',
+    [CharacterClass.ASSASSIN]: 'Assassin',
+};
+//# sourceMappingURL=constants.js.map

package/dist/types/constants.js.map

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

package/dist/types/errors.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Typed error class for d2r-saver.
+ *
+ * All user-facing errors are instances of D2RSaverError with a machine-readable
+ * `code` property for programmatic handling.
+ */
+/** Error code enum — all machine-readable error codes. */
+export declare enum ErrorCode {
+    /** File is not a valid d2s or d2i. */
+    INVALID_FORMAT = "INVALID_FORMAT",
+    /** Unrecognized or non-v105 file version. */
+    UNSUPPORTED_VERSION = "UNSUPPORTED_VERSION",
+    /** Generic parse failure. */
+    PARSE_ERROR = "PARSE_ERROR",
+    /** Checksum doesn't match (warning, usually non-blocking). */
+    CHECKSUM_MISMATCH = "CHECKSUM_MISMATCH",
+    /** No free grid slot for placement. */
+    NO_FREE_SLOT = "NO_FREE_SLOT",
+    /** Item with given ID not found. */
+    ITEM_NOT_FOUND = "ITEM_NOT_FOUND",
+    /** Error during binary write. */
+    WRITE_ERROR = "WRITE_ERROR",
+    /** Malformed portability token. */
+    INVALID_TOKEN = "INVALID_TOKEN",
+    /** GameData has not been loaded yet. */
+    DATA_NOT_LOADED = "DATA_NOT_LOADED"
+}
+/**
+ * Structured error thrown by d2r-saver operations.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   saver.extractItemD2S(buf, 999);
+ * } catch (e) {
+ *   if (e instanceof D2RSaverError && e.code === ErrorCode.ITEM_NOT_FOUND) {
+ *     console.log('Item not found');
+ *   }
+ * }
+ * ```
+ */
+export declare class D2RSaverError extends Error {
+    readonly name = "D2RSaverError";
+    readonly code: ErrorCode;
+    constructor(code: ErrorCode, message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,0DAA0D;AAC1D,oBAAY,SAAS;IACnB,sCAAsC;IACtC,cAAc,mBAAmB;IACjC,6CAA6C;IAC7C,mBAAmB,wBAAwB;IAC3C,6BAA6B;IAC7B,WAAW,gBAAgB;IAC3B,8DAA8D;IAC9D,iBAAiB,sBAAsB;IACvC,uCAAuC;IACvC,YAAY,iBAAiB;IAC7B,oCAAoC;IACpC,cAAc,mBAAmB;IACjC,iCAAiC;IACjC,WAAW,gBAAgB;IAC3B,mCAAmC;IACnC,aAAa,kBAAkB;IAC/B,wCAAwC;IACxC,eAAe,oBAAoB;CACpC;AAID;;;;;;;;;;;;;GAaG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAkB,IAAI,mBAAmB;IACzC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;gBAEb,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM;CAI7C"}

package/dist/types/errors.js

@@ -0,0 +1,53 @@
+/**
+ * Typed error class for d2r-saver.
+ *
+ * All user-facing errors are instances of D2RSaverError with a machine-readable
+ * `code` property for programmatic handling.
+ */
+// ─── Error codes ────────────────────────────────────────────────
+/** Error code enum — all machine-readable error codes. */
+export var ErrorCode;
+(function (ErrorCode) {
+    /** File is not a valid d2s or d2i. */
+    ErrorCode["INVALID_FORMAT"] = "INVALID_FORMAT";
+    /** Unrecognized or non-v105 file version. */
+    ErrorCode["UNSUPPORTED_VERSION"] = "UNSUPPORTED_VERSION";
+    /** Generic parse failure. */
+    ErrorCode["PARSE_ERROR"] = "PARSE_ERROR";
+    /** Checksum doesn't match (warning, usually non-blocking). */
+    ErrorCode["CHECKSUM_MISMATCH"] = "CHECKSUM_MISMATCH";
+    /** No free grid slot for placement. */
+    ErrorCode["NO_FREE_SLOT"] = "NO_FREE_SLOT";
+    /** Item with given ID not found. */
+    ErrorCode["ITEM_NOT_FOUND"] = "ITEM_NOT_FOUND";
+    /** Error during binary write. */
+    ErrorCode["WRITE_ERROR"] = "WRITE_ERROR";
+    /** Malformed portability token. */
+    ErrorCode["INVALID_TOKEN"] = "INVALID_TOKEN";
+    /** GameData has not been loaded yet. */
+    ErrorCode["DATA_NOT_LOADED"] = "DATA_NOT_LOADED";
+})(ErrorCode || (ErrorCode = {}));
+// ─── Error class ────────────────────────────────────────────────
+/**
+ * Structured error thrown by d2r-saver operations.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   saver.extractItemD2S(buf, 999);
+ * } catch (e) {
+ *   if (e instanceof D2RSaverError && e.code === ErrorCode.ITEM_NOT_FOUND) {
+ *     console.log('Item not found');
+ *   }
+ * }
+ * ```
+ */
+export class D2RSaverError extends Error {
+    name = 'D2RSaverError';
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/types/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,mEAAmE;AAEnE,0DAA0D;AAC1D,MAAM,CAAN,IAAY,SAmBX;AAnBD,WAAY,SAAS;IACnB,sCAAsC;IACtC,8CAAiC,CAAA;IACjC,6CAA6C;IAC7C,wDAA2C,CAAA;IAC3C,6BAA6B;IAC7B,wCAA2B,CAAA;IAC3B,8DAA8D;IAC9D,oDAAuC,CAAA;IACvC,uCAAuC;IACvC,0CAA6B,CAAA;IAC7B,oCAAoC;IACpC,8CAAiC,CAAA;IACjC,iCAAiC;IACjC,wCAA2B,CAAA;IAC3B,mCAAmC;IACnC,4CAA+B,CAAA;IAC/B,wCAAwC;IACxC,gDAAmC,CAAA;AACrC,CAAC,EAnBW,SAAS,KAAT,SAAS,QAmBpB;AAED,mEAAmE;AAEnE;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IACpB,IAAI,GAAG,eAAe,CAAC;IAChC,IAAI,CAAY;IAEzB,YAAY,IAAe,EAAE,OAAe;QAC1C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/types/index.d.ts

@@ -0,0 +1,5 @@
+export { ItemQuality, LocationType, StorageType, BodyLocation, CharacterClass, CLASS_NAMES, D2S_MAGIC, D2I_MAGIC, BLIZZLESS_VERSION, STASH_WIDTH, STASH_HEIGHT, INVENTORY_WIDTH, INVENTORY_HEIGHT, CUBE_WIDTH, CUBE_HEIGHT, SECTION_ITEMS, SECTION_STATS, SECTION_EXTENDED, TOKEN_PREFIX, } from './constants.js';
+export type { ModContainer, RawItemLocation, ItemLocation, EarData, BinaryOffset, ParsedItem, LocatedItem, } from './item.js';
+export type { CharacterStats, QuestCompletions, CharacterInfo, CharacterStatus, D2SParseResult, D2IParseResult, StashPage, SaveFileType, DetectedFormat, } from './save-file.js';
+export type { TradeItemDTO } from './trade-item.js';
+//# sourceMappingURL=index.d.ts.map