d2r-saver 0.1.0

package/dist/inventory/placement.js.map

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

package/dist/items/index.d.ts

@@ -0,0 +1,7 @@
+export { isSubType, itemGetTypes, itemGetType, presetItemIds, itemCheckMod, itemMaxSockets, } from './item-types.js';
+export { formatStr, addValues, addProp, modsToStats, uniqueStats, runewordStats, gemStats, type StatValue, } from './item.js';
+export { parseParamStats, parseUniqueStats, parseRunewordStats, parseModStats, } from './item-stats-parser.js';
+export { serializeItem, deserializeItem, type DeserializedItem, } from './item-serializer.js';
+export { getItemIconPath, getItemIconSD, } from './item-icon.js';
+export { toTradeDTO, type TradeItemDTO, type ItemQuality, } from './item-dto.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/items/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,YAAY,EACZ,WAAW,EACX,aAAa,EACb,YAAY,EACZ,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,SAAS,EACT,SAAS,EACT,OAAO,EACP,WAAW,EACX,WAAW,EACX,aAAa,EACb,QAAQ,EACR,KAAK,SAAS,GACf,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,GACd,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,aAAa,EACb,eAAe,EACf,KAAK,gBAAgB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,eAAe,EACf,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,UAAU,EACV,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,eAAe,CAAC"}

package/dist/items/index.js

@@ -0,0 +1,7 @@
+export { isSubType, itemGetTypes, itemGetType, presetItemIds, itemCheckMod, itemMaxSockets, } from './item-types.js';
+export { formatStr, addValues, addProp, modsToStats, uniqueStats, runewordStats, gemStats, } from './item.js';
+export { parseParamStats, parseUniqueStats, parseRunewordStats, parseModStats, } from './item-stats-parser.js';
+export { serializeItem, deserializeItem, } from './item-serializer.js';
+export { getItemIconPath, getItemIconSD, } from './item-icon.js';
+export { toTradeDTO, } from './item-dto.js';
+//# sourceMappingURL=index.js.map

package/dist/items/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/items/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,YAAY,EACZ,WAAW,EACX,aAAa,EACb,YAAY,EACZ,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,SAAS,EACT,SAAS,EACT,OAAO,EACP,WAAW,EACX,WAAW,EACX,aAAa,EACb,QAAQ,GAET,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,GACd,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,aAAa,EACb,eAAe,GAEhB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,eAAe,EACf,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,UAAU,GAGX,MAAM,eAAe,CAAC"}

package/dist/items/item-dto.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Item DTO — converts internal ParsedItem to a portable trade DTO.
+ *
+ * TradeItemDTO is the format sent to the backend for the trade system.
+ */
+import type { GameData } from '../game-data/game-data.js';
+import type { BinaryParsedItem } from '../formats/item-parser.js';
+/** Quality enum for trade DTO (matches internal quality values). */
+export type ItemQuality = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
+/** Trade item DTO — portable representation for the backend. */
+export interface TradeItemDTO {
+    /** Base64 token for full item reconstruction: `d2r1:<base64>` */
+    token: string;
+    /** 3-character item base code. */
+    baseCode: string;
+    /** Human-readable display name. */
+    displayName: string;
+    /** Item quality (1-9). */
+    quality: ItemQuality;
+    /** Item level. */
+    ilvl: number;
+    /** Is ethereal? */
+    ethereal: boolean;
+    /** Number of sockets (total, including filled). */
+    sockets: number;
+    /** Unique/set/runeword identifier. */
+    uniqueId?: string;
+    /** Width in grid cells. */
+    width: number;
+    /** Height in grid cells. */
+    height: number;
+    /** HD icon path key (for hditemlib.json lookup). */
+    iconPath: string | null;
+    /** Key stats for search/filtering. */
+    stats: Record<string, number>;
+    /** Socketed sub-items (runes/gems). */
+    socketedItems: TradeItemDTO[];
+}
+/**
+ * Convert a parsed item to a TradeItemDTO.
+ *
+ * @param item      The parsed item.
+ * @param allItems  All items dict (for socketed sub-item lookup and serialization).
+ * @param gd        GameData instance.
+ */
+export declare function toTradeDTO(item: BinaryParsedItem, allItems: Record<number | string, BinaryParsedItem>, gd: GameData): TradeItemDTO;
+//# sourceMappingURL=item-dto.d.ts.map

package/dist/items/item-dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-dto.d.ts","sourceRoot":"","sources":["../../src/items/item-dto.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAMlE,oEAAoE;AACpE,MAAM,MAAM,WAAW,GACnB,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,CAAC;AAEN,gEAAgE;AAChE,MAAM,WAAW,YAAY;IAC3B,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,OAAO,EAAE,WAAW,CAAC;IACrB,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,uCAAuC;IACvC,aAAa,EAAE,YAAY,EAAE,CAAC;CAC/B;AAID;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,gBAAgB,EACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,gBAAgB,CAAC,EACnD,EAAE,EAAE,QAAQ,GACX,YAAY,CAuCd"}

package/dist/items/item-dto.js

@@ -0,0 +1,124 @@
+/**
+ * Item DTO — converts internal ParsedItem to a portable trade DTO.
+ *
+ * TradeItemDTO is the format sent to the backend for the trade system.
+ */
+import { getItemIconPath } from './item-icon.js';
+import { serializeItem } from './item-serializer.js';
+// ─── Public API ─────────────────────────────────────────────────
+/**
+ * Convert a parsed item to a TradeItemDTO.
+ *
+ * @param item      The parsed item.
+ * @param allItems  All items dict (for socketed sub-item lookup and serialization).
+ * @param gd        GameData instance.
+ */
+export function toTradeDTO(item, allItems, gd) {
+    const baseEntry = gd.items[item.base];
+    const base = baseEntry ? baseEntry : undefined;
+    const { w, h } = getItemSize(base);
+    // Resolve display name
+    const displayName = resolveDisplayName(item, gd);
+    // Build socketed sub-DTOs
+    const socketedDTOs = [];
+    if (item.socketedItems) {
+        for (const sid of item.socketedItems) {
+            const sockItem = allItems[sid];
+            if (sockItem) {
+                socketedDTOs.push(toTradeDTO(sockItem, allItems, gd));
+            }
+        }
+    }
+    // Serialize token
+    const token = serializeItem(item, allItems, gd);
+    return {
+        token,
+        baseCode: item.base,
+        displayName,
+        quality: item.quality,
+        // Simple items (gems, runes, potions, scrolls) carry no ilvl in the binary
+        // format — surface 0 in the DTO so downstream consumers can rely on `number`.
+        ilvl: item.ilvl ?? 0,
+        ethereal: item.ethereal,
+        sockets: item.sockets,
+        uniqueId: item.unique,
+        width: w,
+        height: h,
+        iconPath: getItemIconPath(item, gd),
+        stats: { ...item.stats },
+        socketedItems: socketedDTOs,
+    };
+}
+// ─── Helpers ────────────────────────────────────────────────────
+/** Get item dimensions from base data. */
+function getItemSize(base) {
+    const w = base?.invwidth || 1;
+    const h = base?.invheight || 1;
+    return { w, h };
+}
+/** Resolve human-readable display name. */
+function resolveDisplayName(item, gd) {
+    // If item has an explicit name (rare/crafted)
+    if (item.name)
+        return item.name;
+    // Unique/set/runeword items: look up in GameData
+    if (item.unique) {
+        const name = lookupName(item.unique, gd);
+        if (name)
+            return name;
+    }
+    const base = localizedBaseName(item, gd);
+    // Magic items: in-game name is "<prefix> <base> <suffix>" (e.g. "Glowing Ring of the
+    // Whale"). The affix codes are read straight from the binary, so this works even when
+    // the stat solver fails to reconstruct the actual mods.
+    if (item.magicPrefixCode || item.magicSuffixCode) {
+        const prefix = affixWord(gd.magicPrefix?.[item.magicPrefixCode ?? ''], gd);
+        const suffix = affixWord(gd.magicSuffix?.[item.magicSuffixCode ?? ''], gd);
+        const full = [prefix, base, suffix].filter(Boolean).join(' ').trim();
+        if (full)
+            return full;
+    }
+    return base;
+}
+/** Resolve a magic affix entry's localized display word (e.g. "Glowing", "of the Whale"). */
+function affixWord(entry, gd) {
+    const key = entry?.name;
+    if (!key)
+        return '';
+    return gd.locale.strings[key] || key;
+}
+/** Localized base-item name from the locale, falling back to the raw base code. */
+function localizedBaseName(item, gd) {
+    const baseEntry = gd.items[item.base];
+    const base = baseEntry ? baseEntry : undefined;
+    const namestr = base?.namestr;
+    if (namestr) {
+        return gd.locale.strings[namestr] || namestr;
+    }
+    return item.base;
+}
+/** Look up an item name from the locale by its unique/set/runeword key. */
+function lookupName(key, gd) {
+    // Try direct locale lookup
+    const direct = gd.locale.strings[key];
+    if (direct)
+        return direct;
+    // Try uniqueItems / setItems tables if available. The name key lives in the `index`
+    // column (e.g. unique117.index = "Nokozan Relic"), NOT `namestr` — without this every
+    // unique/set fell through to its base name ("Amulet", "Ring", …).
+    const tables = ['uniqueItems', 'setItems'];
+    for (const table of tables) {
+        const dict = gd[table];
+        if (dict?.[key]) {
+            const nameStr = (dict[key].index ?? dict[key].namestr ?? dict[key].name);
+            if (nameStr) {
+                const localized = gd.locale.strings[nameStr];
+                if (localized)
+                    return localized;
+                return nameStr;
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=item-dto.js.map

package/dist/items/item-dto.js.map

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

package/dist/items/item-icon.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Item icon path resolution — determines the HD icon key for an item.
+ *
+ * Ported from d2planner/src/logic/item.js → itemGetIconHD().
+ */
+import type { GameData } from '../game-data/game-data.js';
+import type { BinaryParsedItem } from '../formats/item-parser.js';
+/**
+ * Get the HD icon path key for an item.
+ *
+ * Returns the icon identifier used in hditemlib.json for HD rendering.
+ * The result can be passed to the frontend for icon display.
+ *
+ * @param item  The parsed item.
+ * @param gd    GameData instance.
+ * @returns Icon path string, or `null` if no icon is available.
+ */
+export declare function getItemIconPath(item: BinaryParsedItem, gd: GameData): string | null;
+/**
+ * Get the inventory file icon name for an item (SD, non-HD).
+ *
+ * @param item  The parsed item.
+ * @param gd    GameData instance.
+ * @returns Icon name string, or `null` if not found.
+ */
+export declare function getItemIconSD(item: BinaryParsedItem, gd: GameData): string | null;
+//# sourceMappingURL=item-icon.d.ts.map

package/dist/items/item-icon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-icon.d.ts","sourceRoot":"","sources":["../../src/items/item-icon.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAIlE;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,gBAAgB,EACtB,EAAE,EAAE,QAAQ,GACX,MAAM,GAAG,IAAI,CAgDf;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,gBAAgB,EACtB,EAAE,EAAE,QAAQ,GACX,MAAM,GAAG,IAAI,CA8Bf"}

package/dist/items/item-icon.js

@@ -0,0 +1,103 @@
+/**
+ * Item icon path resolution — determines the HD icon key for an item.
+ *
+ * Ported from d2planner/src/logic/item.js → itemGetIconHD().
+ */
+// ─── Public API ─────────────────────────────────────────────────
+/**
+ * Get the HD icon path key for an item.
+ *
+ * Returns the icon identifier used in hditemlib.json for HD rendering.
+ * The result can be passed to the frontend for icon display.
+ *
+ * @param item  The parsed item.
+ * @param gd    GameData instance.
+ * @returns Icon path string, or `null` if no icon is available.
+ */
+export function getItemIconPath(item, gd) {
+    const baseEntry = gd.items[item.base];
+    if (!baseEntry)
+        return null;
+    const base = baseEntry;
+    let icon = base.hd;
+    if (!icon)
+        return null;
+    // Unique/set items may have specific HD icons
+    if (item.quality === 7 || item.quality === 5) {
+        // quality 7 = UNIQUE, 5 = SET
+        const specialItem = item.unique
+            ? gd.uniqueItems[item.unique]
+                ?? gd.setItems[item.unique]
+            : undefined;
+        const specialHd = specialItem?.hd;
+        if (specialHd?.length) {
+            const normcode = base.normcode;
+            const ubercode = base.ubercode;
+            const ultracode = base.ultracode;
+            if (!normcode || normcode === item.base) {
+                icon = specialHd[0];
+            }
+            else if (ubercode === item.base) {
+                icon = specialHd[1] ?? specialHd[0];
+            }
+            else if (ultracode === item.base) {
+                icon = specialHd[2] ?? specialHd[0];
+            }
+            else {
+                icon = specialHd[0];
+            }
+        }
+    }
+    if (!icon)
+        return null;
+    // Variable inventory graphics (armor/weapons with multiple visual variants)
+    const baseType = base.type;
+    if (baseType) {
+        const typeData = gd.itemTypes[baseType];
+        if (typeData?.varinvgfx && icon === base.hd) {
+            const varCount = typeData.varinvgfx;
+            const index = ((item.iconIndex || 0) % varCount) + 1;
+            icon = icon + index;
+        }
+    }
+    return icon;
+}
+/**
+ * Get the inventory file icon name for an item (SD, non-HD).
+ *
+ * @param item  The parsed item.
+ * @param gd    GameData instance.
+ * @returns Icon name string, or `null` if not found.
+ */
+export function getItemIconSD(item, gd) {
+    const baseEntry2 = gd.items[item.base];
+    if (!baseEntry2)
+        return null;
+    const base = baseEntry2;
+    let icon = base.invfile;
+    if (!icon)
+        return null;
+    // Variable inventory graphics
+    const baseType = base.type;
+    if (baseType) {
+        const typeData = gd.itemTypes[baseType];
+        if (typeData?.varinvgfx) {
+            const varCount = typeData.varinvgfx;
+            const index = ((item.iconIndex || 0) % varCount) + 1;
+            const varIcon = typeData[`invgfx${index}`];
+            if (varIcon)
+                icon = varIcon;
+        }
+    }
+    // Unique/set overrides
+    if (item.quality === 7) {
+        const uniq = item.unique ? gd.uniqueItems[item.unique] : undefined;
+        icon = uniq?.invfile || base.uniqueinvfile || icon;
+    }
+    else if (item.quality === 5) {
+        const setItem = item.unique ? gd.setItems[item.unique] : undefined;
+        icon = setItem?.invfile || base.setinvfile || icon;
+    }
+    return icon || null;
+}
+//# sourceMappingURL=item-icon.js.map

package/dist/items/item-icon.js.map

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

package/dist/items/item-serializer.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Item serializer — portable base64 token for item transfer.
+ *
+ * Format: `d2r1:<base64>` where the payload is writeItem() output
+ * with a zeroed-out location (loc=0, equip=0, x=0, y=0, storage=0).
+ *
+ * This allows items to be extracted from a save, serialized to a string token,
+ * transmitted (e.g. via trade API), and deserialized back into binary form
+ * for insertion into any save file.
+ */
+import { GameData } from '../game-data/game-data.js';
+import type { BinaryParsedItem } from '../formats/item-parser.js';
+/**
+ * Serialize an item (and its socketed sub-items) to a portable token string.
+ *
+ * @param item     The item to serialize.
+ * @param allItems All items dict (needed to look up socketed items).
+ * @param gd       GameData instance.
+ * @returns Token string: `d2r1:<base64>`
+ */
+export declare function serializeItem(item: BinaryParsedItem, allItems: Record<number | string, BinaryParsedItem>, gd: GameData): string;
+/**
+ * Deserialize a token string back to a parsed item.
+ *
+ * @param token  Token string (must start with `d2r1:`).
+ * @param gd     GameData instance.
+ * @returns The parsed item and any socketed sub-items.
+ * @throws If the token is invalid.
+ */
+export declare function deserializeItem(token: string, gd: GameData): DeserializedItem;
+/** Result of deserializing a token. */
+export interface DeserializedItem {
+    /** The main item. */
+    item: BinaryParsedItem;
+    /** All items including socketed sub-items, keyed by ID. */
+    allItems: Record<number, BinaryParsedItem>;
+}
+//# sourceMappingURL=item-serializer.d.ts.map

package/dist/items/item-serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-serializer.d.ts","sourceRoot":"","sources":["../../src/items/item-serializer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAMlE;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,gBAAgB,EACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,gBAAgB,CAAC,EACnD,EAAE,EAAE,QAAQ,GACX,MAAM,CAMR;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,QAAQ,GACX,gBAAgB,CAyClB;AAID,uCAAuC;AACvC,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB;IACrB,IAAI,EAAE,gBAAgB,CAAC;IACvB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC5C"}

package/dist/items/item-serializer.js

@@ -0,0 +1,92 @@
+/**
+ * Item serializer — portable base64 token for item transfer.
+ *
+ * Format: `d2r1:<base64>` where the payload is writeItem() output
+ * with a zeroed-out location (loc=0, equip=0, x=0, y=0, storage=0).
+ *
+ * This allows items to be extracted from a save, serialized to a string token,
+ * transmitted (e.g. via trade API), and deserialized back into binary form
+ * for insertion into any save file.
+ */
+import { BinaryReader } from '../core/binary-reader.js';
+import { TOKEN_PREFIX } from '../types/constants.js';
+import { writeItem } from '../formats/item-writer.js';
+import { createItemParser } from '../formats/item-parser.js';
+// ─── Public API ─────────────────────────────────────────────────
+/**
+ * Serialize an item (and its socketed sub-items) to a portable token string.
+ *
+ * @param item     The item to serialize.
+ * @param allItems All items dict (needed to look up socketed items).
+ * @param gd       GameData instance.
+ * @returns Token string: `d2r1:<base64>`
+ */
+export function serializeItem(item, allItems, gd) {
+    // Write item with zero location
+    const zeroLoc = { loc: 0, equip: 0, x: 0, y: 0, storage: 0 };
+    const bytes = writeItem(item, zeroLoc, allItems, gd);
+    const base64 = uint8ToBase64(bytes);
+    return TOKEN_PREFIX + base64;
+}
+/**
+ * Deserialize a token string back to a parsed item.
+ *
+ * @param token  Token string (must start with `d2r1:`).
+ * @param gd     GameData instance.
+ * @returns The parsed item and any socketed sub-items.
+ * @throws If the token is invalid.
+ */
+export function deserializeItem(token, gd) {
+    if (!token.startsWith(TOKEN_PREFIX)) {
+        throw new Error(`INVALID_TOKEN: token must start with '${TOKEN_PREFIX}'`);
+    }
+    const base64 = token.slice(TOKEN_PREFIX.length);
+    const bytes = base64ToUint8(base64);
+    if (bytes.length < 4) {
+        throw new Error('INVALID_TOKEN: payload too short');
+    }
+    // Parse item using a JM-wrapped buffer so createItemParser works
+    // We wrap: JM header (2 bytes) + count=1 (2 bytes) + item bytes
+    const wrapped = new Uint8Array(4 + bytes.length);
+    wrapped[0] = 0x4a; // 'J'
+    wrapped[1] = 0x4d; // 'M'
+    wrapped[2] = 1; // count = 1
+    wrapped[3] = 0;
+    wrapped.set(bytes, 4);
+    const reader = new BinaryReader(wrapped);
+    const ctx = createItemParser(reader, gd);
+    // Parse items — the handler may not fire because we use a zeroed location
+    // (location=0, storage=0), which doesn't match any known slot.
+    // Instead, we collect items directly from ctx.items after parsing.
+    ctx.parseItemList(() => { });
+    const allParsed = Object.values(ctx.items);
+    if (allParsed.length === 0) {
+        throw new Error('INVALID_TOKEN: no item parsed from token');
+    }
+    // The first item in the dict is the main item
+    const mainItem = allParsed[0];
+    return {
+        item: mainItem,
+        allItems: ctx.items,
+    };
+}
+// ─── Base64 helpers ─────────────────────────────────────────────
+// Browser-safe base64 (no node:buffer). btoa/atob operate on binary strings;
+// items are at most a few hundred bytes so the char-by-char loop is fine.
+// atob/btoa are globals in the Tauri webview and in Node 18+.
+function uint8ToBase64(bytes) {
+    let binary = '';
+    for (let i = 0; i < bytes.length; i++) {
+        binary += String.fromCharCode(bytes[i]);
+    }
+    return btoa(binary);
+}
+function base64ToUint8(base64) {
+    const binary = atob(base64);
+    const out = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        out[i] = binary.charCodeAt(i);
+    }
+    return out;
+}
+//# sourceMappingURL=item-serializer.js.map

package/dist/items/item-serializer.js.map

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

package/dist/items/item-stats-parser.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Item stat parser — determines mod sources for parsed items.
+ *
+ * Ported from d2planner/src/logic/parser.js.
+ * Provides: parseModStats, parseUniqueStats, parseRunewordStats.
+ *
+ * These functions analyze item stats read from the binary save file
+ * and determine which affixes (mods) produced those stats, along with
+ * the variable values (uniqueValues) for unique/set/runeword items.
+ *
+ * Uses GameData instead of global Data singleton.
+ */
+import { GameData } from '../game-data/game-data.js';
+import type { StatValue } from './item.js';
+interface ParsedItem {
+    base: string;
+    quality: number;
+    unique?: string;
+    [key: string]: unknown;
+}
+type StatsGetter = (src: Record<string, StatValue>) => Record<string, StatValue> | null;
+/**
+ * Post-process binary stats into a format suitable for mod matching.
+ * Handles descfunc 13/27 stats (class skill bonuses, single-skill bonuses).
+ * Ported from d2planner binary/index.js → parseParamStats().
+ */
+export declare function parseParamStats(gd: GameData, stats: Record<string, number>, src: Record<string, StatValue>): Record<string, StatValue> | null;
+/**
+ * Determine the variable values for a unique/set item by analyzing binary stats.
+ * Returns `{uniqueValues, propertyIndex}` (matching d2planner HEAD) or null
+ * when the stats don't match the definition.
+ *
+ * `propertyIndex` maps each propertyGroup property name to the picked option
+ * index (warlock items use this for "pick a skill tab" style rolls).
+ */
+export declare function parseUniqueStats(gd: GameData, item: ParsedItem, getStats: StatsGetter): {
+    uniqueValues: number[];
+    propertyIndex: Record<string, number>;
+} | null;
+/**
+ * Determine the mod sources and uniqueValues for a runeword item.
+ */
+export declare function parseRunewordStats(gd: GameData, item: ParsedItem, socketStats: Record<string, StatValue> | null, getStats: StatsGetter, presetMods?: string[]): Record<string, unknown> | null;
+/**
+ * Determine the mod sources for a magic/rare/crafted/superior item.
+ */
+export declare function parseModStats(gd: GameData, item: ParsedItem, magic: {
+    prefix?: string;
+    suffix?: string;
+} | null, socketStats: Record<string, StatValue> | null, levelreq: number | null, getStats: StatsGetter, presetMods?: string[]): Record<string, unknown> | null;
+export {};
+//# sourceMappingURL=item-stats-parser.d.ts.map

package/dist/items/item-stats-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-stats-parser.d.ts","sourceRoot":"","sources":["../../src/items/item-stats-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAM3C,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,KAAK,WAAW,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC;AAsaxF;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,CAoElC;AAID;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,WAAW,GACpB;IAAE,YAAY,EAAE,MAAM,EAAE,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,IAAI,CAmF1E;AAID;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,UAAU,EAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,EAC7C,QAAQ,EAAE,WAAW,EACrB,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CA2DhC;AAID;;GAEG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EAClD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,EAC7C,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,QAAQ,EAAE,WAAW,EACrB,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CA4ChC"}