d2r-saver 0.1.0

package/dist/index.js

@@ -0,0 +1,197 @@
+/**
+ * d2r-saver — Blizzless D2R v105 save file reader/writer library.
+ *
+ * @packageDocumentation
+ */
+import { GameData } from './game-data/game-data.js';
+import { detectFormat } from './formats/detect.js';
+import { readD2S } from './formats/d2s-reader.js';
+import { readD2I } from './formats/d2i-reader.js';
+import { writeD2S } from './formats/d2s-writer.js';
+import { writeStash, buildStashWritePages, patchStashPage, } from './formats/d2i-writer.js';
+import { extractItemD2S, extractItemD2I, } from './operations/extract-item.js';
+import { insertItemD2S, insertItemD2I, } from './operations/insert-item.js';
+import { readSave } from './operations/read-save.js';
+import { serializeItem, deserializeItem, } from './items/item-serializer.js';
+import { getItemIconPath, getItemIconSD } from './items/item-icon.js';
+import { toTradeDTO } from './items/item-dto.js';
+import { canPlaceItem, findFreeSlot, findFreeSlotInStash } from './inventory/placement.js';
+import { D2RSaverError, ErrorCode } from './types/errors.js';
+// ─── Re-exports ─────────────────────────────────────────────────
+export { GameData } from './game-data/game-data.js';
+export { D2RSaverError, ErrorCode } from './types/errors.js';
+export { StashGrid } from './inventory/grid.js';
+/**
+ * Main facade for all d2r-saver operations.
+ *
+ * Holds a `GameData` instance and delegates to internal modules.
+ *
+ * @example
+ * ```ts
+ * const saver = await D2RSaver.create({ dataPath: './data/data.json', stringsPath: './data/strings.json' });
+ * const result = saver.readD2S(buffer);
+ * ```
+ */
+export class D2RSaver {
+    /** Internal game data reference. */
+    gd;
+    constructor(gd) {
+        this.gd = gd;
+    }
+    // ── Factory methods ─────────────────────────────────────────
+    /**
+     * Create a D2RSaver by loading game data from file paths.
+     *
+     * @param options  Paths to data.json and strings.json.
+     */
+    static async create(options) {
+        const gd = await GameData.fromFile(options.dataPath, options.stringsPath);
+        return new D2RSaver(gd);
+    }
+    /**
+     * Create a D2RSaver from pre-parsed JSON objects.
+     *
+     * @param rawData   Parsed data.json content.
+     * @param locale    Parsed strings.json content.
+     */
+    static fromData(rawData, locale) {
+        const gd = GameData.fromRaw(rawData, locale);
+        return new D2RSaver(gd);
+    }
+    // ── Format detection ────────────────────────────────────────
+    /**
+     * Detect file format.
+     *
+     * @throws {D2RSaverError} INVALID_FORMAT if file is unrecognized.
+     */
+    detectFormat(buffer) {
+        const result = detectFormat(buffer);
+        if (!result) {
+            throw new D2RSaverError(ErrorCode.INVALID_FORMAT, 'File is not a valid Blizzless v105 d2s or d2i.');
+        }
+        return result;
+    }
+    // ── Reading ─────────────────────────────────────────────────
+    /** Read a .d2s character save file. */
+    readD2S(buffer) {
+        return readD2S(buffer, this.gd);
+    }
+    /** Read a .d2i shared stash file. */
+    readD2I(buffer) {
+        return readD2I(buffer, this.gd);
+    }
+    /** Auto-detect format and read a save file. */
+    readSave(buffer) {
+        return readSave(buffer, this.gd);
+    }
+    // ── Item serialization ──────────────────────────────────────
+    /** Serialize an item to a portable token (`d2r1:<base64>`). */
+    serializeItem(item, allItems) {
+        return serializeItem(item, allItems, this.gd);
+    }
+    /** Deserialize an item from a portable token. */
+    deserializeItem(token) {
+        return deserializeItem(token, this.gd);
+    }
+    // ── Placement helpers ───────────────────────────────────────
+    /** Get the grid size of an item in cells. */
+    getItemSize(item) {
+        const base = this.gd.items[item.base];
+        return {
+            width: base?.invwidth ?? 1,
+            height: base?.invheight ?? 1,
+        };
+    }
+    /** Check if an item can be placed at a position on a grid. */
+    canPlaceItem(grid, x, y, item) {
+        return canPlaceItem(grid, x, y, item, this.gd);
+    }
+    /** Find the first free slot for an item on a grid. */
+    findFreeSlot(grid, item) {
+        return findFreeSlot(grid, item, this.gd);
+    }
+    /** Find the first free slot for an item across multiple stash grids. */
+    findFreeSlotInStash(grids, item) {
+        return findFreeSlotInStash(grids, item, this.gd);
+    }
+    // ── Item operations ─────────────────────────────────────────
+    /**
+     * Extract an item from a .d2s save file.
+     *
+     * @param buffer  Original file buffer.
+     * @param itemId  Item ID to extract.
+     */
+    extractItemD2S(buffer, itemId) {
+        return extractItemD2S(buffer, itemId, this.gd);
+    }
+    /**
+     * Extract an item from a .d2i shared stash.
+     *
+     * @param buffer     Original file buffer.
+     * @param pageIndex  Page index.
+     * @param x          X position in grid.
+     * @param y          Y position in grid.
+     */
+    extractItemD2I(buffer, pageIndex, x, y) {
+        return extractItemD2I(buffer, pageIndex, x, y, this.gd);
+    }
+    /**
+     * Insert an item into a .d2s save file.
+     *
+     * @param buffer          Original file buffer.
+     * @param item            Item to insert.
+     * @param allItemsForItem All related items (including socketed sub-items).
+     * @param target          Target container: 'stash' | 'inventory' | 'cube'.
+     * @param position        Optional specific position. Auto-finds if omitted.
+     */
+    insertItemD2S(buffer, item, allItemsForItem, target, position) {
+        return insertItemD2S(buffer, item, allItemsForItem, target, this.gd, position);
+    }
+    /**
+     * Insert an item into a .d2i shared stash.
+     *
+     * @param buffer          Original file buffer.
+     * @param item            Item to insert.
+     * @param allItemsForItem All related items (including socketed sub-items).
+     * @param target          Optional specific target page and position.
+     */
+    insertItemD2I(buffer, item, allItemsForItem, target) {
+        return insertItemD2I(buffer, item, allItemsForItem, this.gd, target);
+    }
+    // ── Writing ─────────────────────────────────────────────────
+    /**
+     * Re-serialise a complete .d2s from a (possibly edited) profile + items.
+     * Lossless: the parsed profile must carry rawHeader/attributes (from readD2S);
+     * apply edits by mutating `profile.attributes` (raw values) before calling.
+     */
+    writeD2S(profile, items, name) {
+        return writeD2S({ profile, items, gd: this.gd, name });
+    }
+    /** Convert parsed stash pages back to writable pages (for writeStash). */
+    buildStashWritePages(pages, allItems) {
+        return buildStashWritePages(pages, allItems, this.gd);
+    }
+    /** Re-serialise a complete .d2i shared stash from writable pages. */
+    writeStash(pages, allItems) {
+        return writeStash(pages, allItems, this.gd);
+    }
+    /** Patch a single .d2i sector (e.g. to change its gold) by raw sector index. */
+    patchStashPage(buffer, pageIndex, newPage, allItems) {
+        return patchStashPage(buffer, pageIndex, newPage, allItems, this.gd);
+    }
+    // ── Icons ───────────────────────────────────────────────────
+    /** Get the HD icon path key for an item. */
+    getItemIconPath(item) {
+        return getItemIconPath(item, this.gd);
+    }
+    /** Get the SD (invfile) icon name for an item. */
+    getItemIconSD(item) {
+        return getItemIconSD(item, this.gd);
+    }
+    // ── Trade DTO ───────────────────────────────────────────────
+    /** Convert an item to a TradeItemDTO for the backend. */
+    toTradeDTO(item, allItems) {
+        return toTradeDTO(item, allItems, this.gd);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/inventory/dimensions.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Inventory grid dimensions — Blizzless v105.
+ *
+ * Constants and helpers for stash/inventory/cube grid sizes.
+ */
+/** Shared stash grid dimensions. */
+export declare const STASH: {
+    readonly rows: 13;
+    readonly columns: 16;
+};
+/** Character inventory grid dimensions. */
+export declare const INVENTORY: {
+    readonly rows: 4;
+    readonly columns: 10;
+};
+/** Horadric cube grid dimensions. */
+export declare const CUBE: {
+    readonly rows: 4;
+    readonly columns: 3;
+};
+/** Belt grid (4 columns, variable rows depending on belt type). */
+export declare const BELT: {
+    readonly rows: 4;
+    readonly columns: 4;
+};
+/** Extended page misc tab (d2i type=1, virtual sub-page). */
+export declare const EXTENDED_MISC: {
+    readonly rows: 10;
+    readonly columns: 10;
+};
+/** Grid dimensions descriptor. */
+export interface GridSize {
+    readonly rows: number;
+    readonly columns: number;
+}
+/**
+ * Get grid dimensions for a storage type.
+ *
+ * @param storage  Storage type: 'inventory' | 'cube' | 'stash' | 'belt'
+ */
+export declare function getGridSize(storage: 'inventory' | 'cube' | 'stash' | 'belt'): GridSize;
+//# sourceMappingURL=dimensions.d.ts.map

package/dist/inventory/dimensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimensions.d.ts","sourceRoot":"","sources":["../../src/inventory/dimensions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,oCAAoC;AACpC,eAAO,MAAM,KAAK;;;CAAqC,CAAC;AAExD,2CAA2C;AAC3C,eAAO,MAAM,SAAS;;;CAAoC,CAAC;AAE3D,qCAAqC;AACrC,eAAO,MAAM,IAAI;;;CAAmC,CAAC;AAErD,mEAAmE;AACnE,eAAO,MAAM,IAAI;;;CAAmC,CAAC;AAErD,6DAA6D;AAC7D,eAAO,MAAM,aAAa;;;CAAqC,CAAC;AAIhE,kCAAkC;AAClC,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAOtF"}

package/dist/inventory/dimensions.js

@@ -0,0 +1,30 @@
+/**
+ * Inventory grid dimensions — Blizzless v105.
+ *
+ * Constants and helpers for stash/inventory/cube grid sizes.
+ */
+// ─── Grid dimensions (Blizzless) ────────────────────────────────
+/** Shared stash grid dimensions. */
+export const STASH = { rows: 13, columns: 16 };
+/** Character inventory grid dimensions. */
+export const INVENTORY = { rows: 4, columns: 10 };
+/** Horadric cube grid dimensions. */
+export const CUBE = { rows: 4, columns: 3 };
+/** Belt grid (4 columns, variable rows depending on belt type). */
+export const BELT = { rows: 4, columns: 4 };
+/** Extended page misc tab (d2i type=1, virtual sub-page). */
+export const EXTENDED_MISC = { rows: 10, columns: 10 };
+/**
+ * Get grid dimensions for a storage type.
+ *
+ * @param storage  Storage type: 'inventory' | 'cube' | 'stash' | 'belt'
+ */
+export function getGridSize(storage) {
+    switch (storage) {
+        case 'inventory': return INVENTORY;
+        case 'cube': return CUBE;
+        case 'stash': return STASH;
+        case 'belt': return BELT;
+    }
+}
+//# sourceMappingURL=dimensions.js.map

package/dist/inventory/dimensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimensions.js","sourceRoot":"","sources":["../../src/inventory/dimensions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mEAAmE;AAEnE,oCAAoC;AACpC,MAAM,CAAC,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAW,CAAC;AAExD,2CAA2C;AAC3C,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAW,CAAC;AAE3D,qCAAqC;AACrC,MAAM,CAAC,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAW,CAAC;AAErD,mEAAmE;AACnE,MAAM,CAAC,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAW,CAAC;AAErD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAW,CAAC;AAUhE;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,OAAgD;IAC1E,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,WAAW,CAAC,CAAC,OAAO,SAAS,CAAC;QACnC,KAAK,MAAM,CAAC,CAAC,OAAO,IAAI,CAAC;QACzB,KAAK,OAAO,CAAC,CAAC,OAAO,KAAK,CAAC;QAC3B,KAAK,MAAM,CAAC,CAAC,OAAO,IAAI,CAAC;IAC3B,CAAC;AACH,CAAC"}

package/dist/inventory/grid.d.ts

@@ -0,0 +1,53 @@
+/**
+ * StashGrid — occupancy grid for inventory/stash/cube placement.
+ *
+ * Ported from d2planner/src/logic/inventory.js, cleaned up as a class.
+ * Uses GameData for item base dimensions (invwidth, invheight).
+ */
+import type { GameData } from '../game-data/game-data.js';
+import type { GridSize } from './dimensions.js';
+/**
+ * A 2D occupancy grid for a storage area.
+ *
+ * Each cell is either free (0) or occupied (non-zero).
+ * Items occupy rectangular regions based on their `invwidth × invheight`.
+ */
+export declare class StashGrid {
+    readonly rows: number;
+    readonly columns: number;
+    /** Flat occupancy array: `cells[y * columns + x]`. 0 = free, else item ID. */
+    private cells;
+    constructor(size: GridSize);
+    constructor(rows: number, columns: number);
+    /** Check if a rectangular area is completely free. */
+    isFree(x: number, y: number, width: number, height: number): boolean;
+    /** Get the item ID at a cell, or 0 if free. */
+    at(x: number, y: number): number;
+    /** Mark a rectangular area as occupied by `itemId`. */
+    occupy(x: number, y: number, width: number, height: number, itemId?: number): void;
+    /** Free a rectangular area. */
+    free(x: number, y: number, width: number, height: number): void;
+    /** Clear the entire grid. */
+    clear(): void;
+    /**
+     * Find the first free slot (top-left corner) for an item of the given size.
+     * Scans left-to-right, top-to-bottom.
+     *
+     * @returns `{ x, y }` or `null` if no space.
+     */
+    findFreeSlot(width: number, height: number): {
+        x: number;
+        y: number;
+    } | null;
+    /**
+     * Populate the grid from a slot array (as returned by d2i/d2s readers).
+     *
+     * @param slots Sparse array: `slots[slot] = itemId`. Slot = `y * columns + x`.
+     * @param items All items keyed by ID.
+     * @param gd GameData for item base dimensions.
+     */
+    populate(slots: (number | string | undefined)[], items: Record<number | string, {
+        base: string;
+    }>, gd: GameData): void;
+}
+//# sourceMappingURL=grid.d.ts.map

package/dist/inventory/grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid.d.ts","sourceRoot":"","sources":["../../src/inventory/grid.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAIhD;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,8EAA8E;IAC9E,OAAO,CAAC,KAAK,CAAe;gBAEhB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAczC,sDAAsD;IACtD,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAUpE,+CAA+C;IAC/C,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IAOhC,uDAAuD;IACvD,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,IAAI;IAQ7E,+BAA+B;IAC/B,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ/D,6BAA6B;IAC7B,KAAK,IAAI,IAAI;IAMb;;;;;OAKG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAW5E;;;;;;OAMG;IACH,QAAQ,CACN,KAAK,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,EAAE,EACtC,KAAK,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,EAChD,EAAE,EAAE,QAAQ,GACX,IAAI;CAwBR"}

package/dist/inventory/grid.js

@@ -0,0 +1,117 @@
+/**
+ * StashGrid — occupancy grid for inventory/stash/cube placement.
+ *
+ * Ported from d2planner/src/logic/inventory.js, cleaned up as a class.
+ * Uses GameData for item base dimensions (invwidth, invheight).
+ */
+// ─── StashGrid ──────────────────────────────────────────────────
+/**
+ * A 2D occupancy grid for a storage area.
+ *
+ * Each cell is either free (0) or occupied (non-zero).
+ * Items occupy rectangular regions based on their `invwidth × invheight`.
+ */
+export class StashGrid {
+    rows;
+    columns;
+    /** Flat occupancy array: `cells[y * columns + x]`. 0 = free, else item ID. */
+    cells;
+    constructor(rowsOrSize, columns) {
+        if (typeof rowsOrSize === 'object') {
+            this.rows = rowsOrSize.rows;
+            this.columns = rowsOrSize.columns;
+        }
+        else {
+            this.rows = rowsOrSize;
+            this.columns = columns;
+        }
+        this.cells = new Float64Array(this.rows * this.columns);
+    }
+    // ─── Query ──────────────────────────────────────────────────
+    /** Check if a rectangular area is completely free. */
+    isFree(x, y, width, height) {
+        if (x < 0 || y < 0 || x + width > this.columns || y + height > this.rows)
+            return false;
+        for (let dy = 0; dy < height; dy++) {
+            for (let dx = 0; dx < width; dx++) {
+                if (this.cells[(y + dy) * this.columns + (x + dx)] !== 0)
+                    return false;
+            }
+        }
+        return true;
+    }
+    /** Get the item ID at a cell, or 0 if free. */
+    at(x, y) {
+        if (x < 0 || y < 0 || x >= this.columns || y >= this.rows)
+            return 0;
+        return this.cells[y * this.columns + x];
+    }
+    // ─── Mutation ─────────────────────────────────────────────────
+    /** Mark a rectangular area as occupied by `itemId`. */
+    occupy(x, y, width, height, itemId = 1) {
+        for (let dy = 0; dy < height; dy++) {
+            for (let dx = 0; dx < width; dx++) {
+                this.cells[(y + dy) * this.columns + (x + dx)] = itemId;
+            }
+        }
+    }
+    /** Free a rectangular area. */
+    free(x, y, width, height) {
+        for (let dy = 0; dy < height; dy++) {
+            for (let dx = 0; dx < width; dx++) {
+                this.cells[(y + dy) * this.columns + (x + dx)] = 0;
+            }
+        }
+    }
+    /** Clear the entire grid. */
+    clear() {
+        this.cells.fill(0);
+    }
+    // ─── Placement search ────────────────────────────────────────
+    /**
+     * Find the first free slot (top-left corner) for an item of the given size.
+     * Scans left-to-right, top-to-bottom.
+     *
+     * @returns `{ x, y }` or `null` if no space.
+     */
+    findFreeSlot(width, height) {
+        for (let y = 0; y <= this.rows - height; y++) {
+            for (let x = 0; x <= this.columns - width; x++) {
+                if (this.isFree(x, y, width, height))
+                    return { x, y };
+            }
+        }
+        return null;
+    }
+    // ─── Populate from items ──────────────────────────────────────
+    /**
+     * Populate the grid from a slot array (as returned by d2i/d2s readers).
+     *
+     * @param slots Sparse array: `slots[slot] = itemId`. Slot = `y * columns + x`.
+     * @param items All items keyed by ID.
+     * @param gd GameData for item base dimensions.
+     */
+    populate(slots, items, gd) {
+        this.clear();
+        for (let slot = 0; slot < slots.length; slot++) {
+            const id = slots[slot];
+            if (id == null)
+                continue;
+            const item = items[id];
+            if (!item)
+                continue;
+            const baseItem = gd.items[item.base];
+            const w = baseItem?.invwidth || 1;
+            const h = baseItem?.invheight || 1;
+            const x = slot % this.columns;
+            const y = Math.floor(slot / this.columns);
+            // Grid stores numeric IDs; map preset string codes to a hashed numeric
+            // sentinel so the grid can still mark cells occupied.
+            const numericId = typeof id === 'number'
+                ? id
+                : id.split('').reduce((s, c) => s * 31 + c.charCodeAt(0), 1) & 0x7fffffff;
+            this.occupy(x, y, w, h, numericId);
+        }
+    }
+}
+//# sourceMappingURL=grid.js.map

package/dist/inventory/grid.js.map

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

package/dist/inventory/index.d.ts

@@ -0,0 +1,4 @@
+export { STASH, INVENTORY, CUBE, BELT, EXTENDED_MISC, getGridSize, type GridSize, } from './dimensions.js';
+export { StashGrid } from './grid.js';
+export { canPlaceItem, findFreeSlot, findFreeSlotInStash, placeItem, removeItem, buildGrid, type PlacementItem, } from './placement.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/inventory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,aAAa,EACb,WAAW,EACX,KAAK,QAAQ,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,SAAS,EACT,UAAU,EACV,SAAS,EACT,KAAK,aAAa,GACnB,MAAM,gBAAgB,CAAC"}

package/dist/inventory/index.js

@@ -0,0 +1,4 @@
+export { STASH, INVENTORY, CUBE, BELT, EXTENDED_MISC, getGridSize, } from './dimensions.js';
+export { StashGrid } from './grid.js';
+export { canPlaceItem, findFreeSlot, findFreeSlotInStash, placeItem, removeItem, buildGrid, } from './placement.js';
+//# sourceMappingURL=index.js.map

package/dist/inventory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/inventory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,aAAa,EACb,WAAW,GAEZ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,SAAS,EACT,UAAU,EACV,SAAS,GAEV,MAAM,gBAAgB,CAAC"}

package/dist/inventory/placement.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Placement logic — inventory/stash item placement helpers.
+ *
+ * Ported from d2planner/src/logic/inventory.js.
+ * Uses GameData for item base dimensions.
+ */
+import type { GameData } from '../game-data/game-data.js';
+import { StashGrid } from './grid.js';
+import type { GridSize } from './dimensions.js';
+/** Minimal item descriptor needed for placement. */
+export interface PlacementItem {
+    base: string;
+}
+/**
+ * Check if an item can be placed at a specific position in a grid.
+ *
+ * @param grid  The occupancy grid.
+ * @param x     Column position.
+ * @param y     Row position.
+ * @param item  The item to check.
+ * @param gd    GameData for item dimensions.
+ */
+export declare function canPlaceItem(grid: StashGrid, x: number, y: number, item: PlacementItem, gd: GameData): boolean;
+/**
+ * Find a free slot for an item in a grid.
+ *
+ * @param grid  The occupancy grid.
+ * @param item  The item to place.
+ * @param gd    GameData for item dimensions.
+ * @returns  `{ x, y }` or `null` if no space.
+ */
+export declare function findFreeSlot(grid: StashGrid, item: PlacementItem, gd: GameData): {
+    x: number;
+    y: number;
+} | null;
+/**
+ * Find a free slot for an item across multiple stash pages.
+ *
+ * @param grids  Array of grids, one per stash page.
+ * @param item   The item to place.
+ * @param gd     GameData for item dimensions.
+ * @returns  `{ pageIndex, x, y }` or `null` if no space in any page.
+ */
+export declare function findFreeSlotInStash(grids: StashGrid[], item: PlacementItem, gd: GameData): {
+    pageIndex: number;
+    x: number;
+    y: number;
+} | null;
+/**
+ * Place an item in a grid, marking cells as occupied.
+ *
+ * @returns `true` if placed, `false` if the space is not free.
+ */
+export declare function placeItem(grid: StashGrid, x: number, y: number, item: PlacementItem, gd: GameData, itemId?: number): boolean;
+/**
+ * Remove an item from a grid, freeing its cells.
+ */
+export declare function removeItem(grid: StashGrid, x: number, y: number, item: PlacementItem, gd: GameData): void;
+/**
+ * Build a StashGrid populated from a slot array.
+ *
+ * @param size  Grid dimensions.
+ * @param slots  Sparse array: `slots[index] = itemId`.
+ * @param items  All items keyed by ID.
+ * @param gd  GameData for item dimensions.
+ */
+export declare function buildGrid(size: GridSize, slots: (number | string | undefined)[], items: Record<number | string, PlacementItem>, gd: GameData): StashGrid;
+//# sourceMappingURL=placement.d.ts.map

package/dist/inventory/placement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placement.d.ts","sourceRoot":"","sources":["../../src/inventory/placement.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAIhD,oDAAoD;AACpD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;CACd;AAID;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,SAAS,EACf,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,IAAI,EAAE,aAAa,EACnB,EAAE,EAAE,QAAQ,GACX,OAAO,CAGT;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,aAAa,EACnB,EAAE,EAAE,QAAQ,GACX;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAGjC;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,EAAE,EAClB,IAAI,EAAE,aAAa,EACnB,EAAE,EAAE,QAAQ,GACX;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAMpD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,SAAS,EACf,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,IAAI,EAAE,aAAa,EACnB,EAAE,EAAE,QAAQ,EACZ,MAAM,SAAI,GACT,OAAO,CAKT;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,SAAS,EACf,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,IAAI,EAAE,aAAa,EACnB,EAAE,EAAE,QAAQ,GACX,IAAI,CAGN;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,EAAE,EACtC,KAAK,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,aAAa,CAAC,EAC7C,EAAE,EAAE,QAAQ,GACX,SAAS,CAIX"}

package/dist/inventory/placement.js

@@ -0,0 +1,90 @@
+/**
+ * Placement logic — inventory/stash item placement helpers.
+ *
+ * Ported from d2planner/src/logic/inventory.js.
+ * Uses GameData for item base dimensions.
+ */
+import { StashGrid } from './grid.js';
+// ─── Public API ─────────────────────────────────────────────────
+/**
+ * Check if an item can be placed at a specific position in a grid.
+ *
+ * @param grid  The occupancy grid.
+ * @param x     Column position.
+ * @param y     Row position.
+ * @param item  The item to check.
+ * @param gd    GameData for item dimensions.
+ */
+export function canPlaceItem(grid, x, y, item, gd) {
+    const { w, h } = getItemSize(item, gd);
+    return grid.isFree(x, y, w, h);
+}
+/**
+ * Find a free slot for an item in a grid.
+ *
+ * @param grid  The occupancy grid.
+ * @param item  The item to place.
+ * @param gd    GameData for item dimensions.
+ * @returns  `{ x, y }` or `null` if no space.
+ */
+export function findFreeSlot(grid, item, gd) {
+    const { w, h } = getItemSize(item, gd);
+    return grid.findFreeSlot(w, h);
+}
+/**
+ * Find a free slot for an item across multiple stash pages.
+ *
+ * @param grids  Array of grids, one per stash page.
+ * @param item   The item to place.
+ * @param gd     GameData for item dimensions.
+ * @returns  `{ pageIndex, x, y }` or `null` if no space in any page.
+ */
+export function findFreeSlotInStash(grids, item, gd) {
+    for (let i = 0; i < grids.length; i++) {
+        const slot = findFreeSlot(grids[i], item, gd);
+        if (slot)
+            return { pageIndex: i, ...slot };
+    }
+    return null;
+}
+/**
+ * Place an item in a grid, marking cells as occupied.
+ *
+ * @returns `true` if placed, `false` if the space is not free.
+ */
+export function placeItem(grid, x, y, item, gd, itemId = 1) {
+    const { w, h } = getItemSize(item, gd);
+    if (!grid.isFree(x, y, w, h))
+        return false;
+    grid.occupy(x, y, w, h, itemId);
+    return true;
+}
+/**
+ * Remove an item from a grid, freeing its cells.
+ */
+export function removeItem(grid, x, y, item, gd) {
+    const { w, h } = getItemSize(item, gd);
+    grid.free(x, y, w, h);
+}
+/**
+ * Build a StashGrid populated from a slot array.
+ *
+ * @param size  Grid dimensions.
+ * @param slots  Sparse array: `slots[index] = itemId`.
+ * @param items  All items keyed by ID.
+ * @param gd  GameData for item dimensions.
+ */
+export function buildGrid(size, slots, items, gd) {
+    const grid = new StashGrid(size);
+    grid.populate(slots, items, gd);
+    return grid;
+}
+// ─── Internal ───────────────────────────────────────────────────
+/** Get item width and height from GameData. */
+function getItemSize(item, gd) {
+    const baseItem = gd.items[item.base];
+    const w = baseItem?.invwidth || 1;
+    const h = baseItem?.invheight || 1;
+    return { w, h };
+}
+//# sourceMappingURL=placement.js.map