export const ItemOriginKind = Object.freeze({ crafted: "crafted", shop: "shop", gathered: "gathered", gods: "gods", loot: "loot", minted: "minted", unknown: "unknown" }); /** Must match `ItemId.coins` — kept here to avoid a circular import with definitions/items.js. */ const COINS_ITEM_ID = 8; export const ROYAL_TREASURY_ORIGIN_LABEL = "Minted by the Royal Treasury"; /** Official coinage origin for every coin stack. */ export function royalTreasuryOrigin () { return { kind: ItemOriginKind.minted }; } /** Gather verbs for origin labels (`Mined by …`, `Felled by …`). */ export const GatherOriginVerb = Object.freeze({ mined: "Mined", felled: "Felled", caught: "Caught", picked: "Picked" }); /** * Craft verbs by station (`Forged by …` furnace, `Smithed by …` anvil, * `Carved by …` woodworking, `Assembled by …` crafting bench). */ export const CraftOriginVerb = Object.freeze({ forged: "Forged", smithed: "Smithed", carved: "Carved", assembled: "Assembled", made: "Made", brewed: "Brewed", mixed: "Mixed", written: "Written", issued: "Issued" }); /** @type {Readonly>} */ export const CRAFT_ORIGIN_VERB_BY_STATION = Object.freeze({ furnace: CraftOriginVerb.forged, anvil: CraftOriginVerb.smithed, "woodworking-bench": CraftOriginVerb.carved, "crafting-bench": CraftOriginVerb.assembled, "spinning-wheel": CraftOriginVerb.made, loom: CraftOriginVerb.made, "tailor-bench": CraftOriginVerb.made }); export function craftOriginVerbForStation (stationId) { return CRAFT_ORIGIN_VERB_BY_STATION[stationId] ?? CraftOriginVerb.made; } export function originKey (origin) { if (!origin) { return "none"; } return JSON.stringify(origin); } export function originLabel (origin, { lowercaseVerb = false } = {}) { if (!origin) { return "unknown origin"; } if (origin.kind === ItemOriginKind.crafted) { let verb = origin.verb?.trim() || CraftOriginVerb.made; if (lowercaseVerb && verb.length) { verb = verb.charAt(0).toLowerCase() + verb.slice(1); } const name = origin.displayName?.trim() || "someone"; return `${verb} by ${name}`; } if (origin.kind === ItemOriginKind.shop) { const name = origin.displayName?.trim() || "a shop"; return lowercaseVerb ? `bought from ${name}` : `Bought from ${name}`; } if (origin.kind === ItemOriginKind.gathered) { let verb = origin.verb?.trim() || "Gathered"; if (lowercaseVerb && verb.length) { verb = verb.charAt(0).toLowerCase() + verb.slice(1); } const name = origin.displayName?.trim() || "someone"; return `${verb} by ${name}`; } if (origin.kind === ItemOriginKind.loot) { const mob = origin.mobName?.trim() || "a creature"; const killer = origin.killerName?.trim() || "someone"; const label = `Dropped by ${mob}, slain by ${killer}.`; if (!lowercaseVerb) { return label; } return label.charAt(0).toLowerCase() + label.slice(1); } if (origin.kind === ItemOriginKind.gods) { return "Received from the gods"; } if (origin.kind === ItemOriginKind.minted) { return lowercaseVerb ? ROYAL_TREASURY_ORIGIN_LABEL.charAt(0).toLowerCase() + ROYAL_TREASURY_ORIGIN_LABEL.slice(1) : ROYAL_TREASURY_ORIGIN_LABEL; } return "unknown origin"; } function originLabelWithQuantity (entry) { const label = originLabel(entry.origin, { lowercaseVerb: true }); return `${entry.quantity} ${label}`; } /** Build a crafted-item origin (`Forged by Ada`, …). */ export function craftOrigin (verb, displayName) { return { kind: ItemOriginKind.crafted, verb: String(verb ?? CraftOriginVerb.made).trim() || CraftOriginVerb.made, displayName: String(displayName ?? "").trim() || "someone" }; } /** Letters / recipe paper: `Written by `. */ export function writtenOrigin (displayName) { return craftOrigin(CraftOriginVerb.written, displayName); } /** Blank cheques from the bank: `Issued by The Bank`. */ export function bankIssuedOrigin (displayName = "The Bank") { return craftOrigin(CraftOriginVerb.issued, displayName); } /** NPC catalog purchase origin (`Bought from …`). */ export function shopOrigin (displayName) { return { kind: ItemOriginKind.shop, displayName: String(displayName ?? "").trim() || "a shop" }; } /** Build a gathered-item origin (`Mined by Ada`, …). */ export function gatherOrigin (verb, displayName) { return { kind: ItemOriginKind.gathered, verb: String(verb ?? "Gathered").trim() || "Gathered", displayName: String(displayName ?? "").trim() || "someone" }; } /** Build a mob-drop origin (`Dropped by Rat, slain by Ada.`). */ export function lootOrigin (mobName, killerName) { return { kind: ItemOriginKind.loot, mobName: String(mobName ?? "").trim() || "a creature", killerName: String(killerName ?? "").trim() || "someone" }; } /** Starter gear granted at character creation. */ export function godsOrigin () { return { kind: ItemOriginKind.gods }; } /** @returns {{ origin: object|null, quantity: number }[]} */ export function normalizeOrigins (stack) { if (!stack) { return []; } const qty = Math.max(0, Math.floor(Number(stack.quantity) || 0)); if (qty <= 0) { return []; } // All coinage is royal mint — ignore any other origin metadata on the stack. if ((stack.itemId | 0) === COINS_ITEM_ID) { return [{ origin: royalTreasuryOrigin(), quantity: qty }]; } if (Array.isArray(stack.origins) && stack.origins.length) { return stack.origins.map((entry) => ({ origin: entry.origin ?? null, quantity: Math.max(0, Math.floor(Number(entry.quantity) || 0)) })).filter((entry) => entry.quantity > 0); } return [{ origin: stack.origin ?? null, quantity: qty }]; } export function mergeOriginLists (left, right) { const map = new Map(); for (const entry of [...normalizeOriginsList(left), ...normalizeOriginsList(right)]) { const key = originKey(entry.origin); const prev = map.get(key) ?? { origin: entry.origin ?? null, quantity: 0 }; prev.quantity += entry.quantity; map.set(key, prev); } return [...map.values()].filter((entry) => entry.quantity > 0); } function normalizeOriginsList (list) { if (!Array.isArray(list)) { return []; } return list.map((entry) => ({ origin: entry?.origin ?? null, quantity: Math.max(0, Math.floor(Number(entry?.quantity) || 0)) })).filter((entry) => entry.quantity > 0); } /** FIFO split of origin quantities when taking from a stack. */ export function splitOrigins (origins, takeQuantity) { const take = Math.max(0, Math.floor(Number(takeQuantity) || 0)); const source = normalizeOriginsList(origins); const taken = []; const remain = []; let left = take; for (const entry of source) { if (left <= 0) { remain.push({ ...entry }); continue; } const amount = Math.min(entry.quantity, left); if (amount > 0) { taken.push({ origin: entry.origin ?? null, quantity: amount }); left -= amount; } const rest = entry.quantity - amount; if (rest > 0) { remain.push({ origin: entry.origin ?? null, quantity: rest }); } } return { taken, remain }; } export function attachOrigins (stack) { const origins = normalizeOrigins(stack); const next = { ...stack, origins }; delete next.origin; return next; } export function formatOriginBreakdown (stack) { const origins = normalizeOrigins(stack); if (!origins.length) { return ""; } if (origins.length === 1) { return originLabel(origins[0].origin); } return origins .map((entry) => originLabelWithQuantity(entry)) .join("\n"); }