@archivist-gg/dnd5e 0.3.11 → 0.3.13

package/dist/item/item.actions-map.d.ts

@@ -1,4 +1,5 @@
 import type { EquipmentEntry } from "../pc/pc.types.js";
+import type { EntryView } from "../pc/pc.infusions.js";
 export type ActionCost = "action" | "bonus-action" | "reaction" | "free" | "special";
 export interface ItemAction {
     cost: ActionCost;
@@ -8,7 +9,15 @@ export interface ItemAction {
         amount: string;
         reset: "dawn" | "short" | "long" | "special";
     };
+    /** Consumed on use (T17 rider C fold, user ruling 2026-09-24): using one spends the entry's QUANTITY, never a
+     *  charge, so the item carries no `max_charges` or `recovery` and the sheet shows its quantity only. Read through
+     *  `isConsumedOnUse` (`pc/pc.entry-overrides.ts`), which also answers by the entity's own type. */
+    consumed?: true;
 }
+/** What `resolveItemAction` hands the Actions items row: its cost and range, nothing else. The curated charges and
+ *  recovery are NOT on it: the charge pair is `effectiveItemCharges` and the rule `effectiveItemRecovery`
+ *  (`pc/pc.entry-overrides.ts`), so no reader can take the curated max over a stored pair. */
+export type ResolvedItemAction = Pick<ItemAction, "cost" | "range">;
 /**
  * Curated map of canonical SRD chargeable / activated items.
  * Slugs match the SRD compendium slug format. Augmenter reads this map
@@ -34,16 +43,42 @@ export declare const ITEM_ACTIONS: Record<string, ItemAction>;
 export declare function findItemAction(slug: string): ItemAction | undefined;
 /**
  * Resolve the ItemAction for an equipped entry.
- * Priority: per-instance override > curated map > `itemType==="potion"`
- * bonus-action default > null.
+ * Priority: per-instance override > the entry view's `action` > curated map >
+ * the type default (`itemType==="potion"`: bonus-action; `itemType==="scroll"`:
+ * its spell's cost, else action) > null.
  *
  * `itemType` is the entity's `data.type` (from the registry, statically
  * `unknown`); per the 2024 SRD, drinking/administering a potion is a Bonus
  * Action, so an uncurated `type==="potion"` item still surfaces (curated oils
  * mis-typed `"potion"` are pinned to "action" so this default cannot mislabel
- * them). Returns null when no source supplies a cost (non-potion uncurated with
- * no override).
+ * them). A spell scroll's use is its cast, so an uncurated `type==="scroll"` item
+ * costs what its spell's casting time costs: `opts.spellCost`, which the caller
+ * that holds the registry resolves (`scrollSpellCost`, pc/pc.entry-overrides.ts),
+ * else Action (no spell set or resolved, or a minute or hour cast). It keys on the
+ * type, never on a `scroll_level` marker alone, which every Enspelled weapon and
+ * armour also carries. Returns null when no source supplies a cost (an uncurated
+ * item that is neither a potion nor a scroll, with no override).
  *
  * Accepts both bare and compendium-prefixed slugs (see `findItemAction`).
+ *
+ * `opts.weaponLike`: the entry is a weapon or an item whose `base_item` is a
+ * weapon, so its `overrides.action` belongs to its ATTACK row (pc.equipment.ts)
+ * and is ignored here, as is its `overrides.range`, which no row reads (the
+ * attack row's range is the weapon's own, and `customizableOverrideKeys` offers
+ * no Range for it); only a curated activation (e.g. Sun Blade's) still
+ * resolves, and an uncurated weapon-like item with only an override resolves
+ * null. Omitted, the override wins as before.
+ *
+ * `opts.view` (ART-a, spec §5.4, Gate 1 I4): the entry's view. Its RULE
+ * entity's `action` (an infusion overlay's, e.g. Mind Sharpener's reaction)
+ * comes before the curated map, which is keyed by the base's slug and knows
+ * nothing of the infusion.
+ *
+ * `opts.spellCost`: a spell scroll's spell's cost (see above); read only for an
+ * item typed `scroll`.
  */
-export declare function resolveItemAction(slug: string, entry: EquipmentEntry, itemType?: unknown): ItemAction | null;
+export declare function resolveItemAction(slug: string, entry: EquipmentEntry, itemType?: unknown, opts?: {
+    weaponLike?: boolean;
+    view?: EntryView | null;
+    spellCost?: ActionCost;
+}): ResolvedItemAction | null;

package/dist/item/item.actions-map.js

@@ -1,87 +1,8 @@
-// src/item/item.actions-map.ts
-var ITEM_ACTIONS = {
-  // Wands and rods
-  "wand-of-fireballs": { cost: "action", range: "150 ft.", max_charges: 7, recovery: { amount: "1d6+1", reset: "dawn" } },
-  "wand-of-magic-missiles": { cost: "action", range: "120 ft.", max_charges: 7, recovery: { amount: "1d6+1", reset: "dawn" } },
-  "wand-of-lightning-bolts": { cost: "action", range: "100 ft.", max_charges: 7, recovery: { amount: "1d6+1", reset: "dawn" } },
-  "wand-of-paralysis": { cost: "action", range: "60 ft.", max_charges: 7, recovery: { amount: "1d6+1", reset: "dawn" } },
-  "wand-of-fear": { cost: "action", range: "self", max_charges: 7, recovery: { amount: "1d6+1", reset: "dawn" } },
-  "wand-of-binding": { cost: "action", range: "self", max_charges: 7, recovery: { amount: "1d6+1", reset: "dawn" } },
-  "wand-of-secrets": { cost: "action", range: "30 ft.", max_charges: 3, recovery: { amount: "1d3", reset: "dawn" } },
-  "wand-of-web": { cost: "action", range: "60 ft.", max_charges: 7, recovery: { amount: "1d6+1", reset: "dawn" } },
-  "wand-of-wonder": { cost: "action", range: "120 ft.", max_charges: 7, recovery: { amount: "1d6+1", reset: "dawn" } },
-  // Activatable wondrous items
-  "boots-of-speed": { cost: "bonus-action", range: "self", max_charges: 1, recovery: { amount: "1", reset: "long" } },
-  "boots-of-levitation": { cost: "action", range: "self" },
-  "boots-of-striding-and-springing": { cost: "free", range: "self" },
-  "broom-of-flying": { cost: "action", range: "touch" },
-  "cloak-of-displacement": { cost: "free", range: "self" },
-  "cloak-of-the-bat": { cost: "action", range: "self", max_charges: 1, recovery: { amount: "1", reset: "long" } },
-  "decanter-of-endless-water": { cost: "action", range: "touch" },
-  "drum-of-panic": { cost: "action", range: "120 ft.", max_charges: 1, recovery: { amount: "1", reset: "long" } },
-  "eyes-of-charming": { cost: "action", range: "30 ft.", max_charges: 3, recovery: { amount: "3", reset: "dawn" } },
-  // Rings
-  "ring-of-three-wishes": { cost: "action", range: "self", max_charges: 3, recovery: { amount: "0", reset: "special" } },
-  "ring-of-shooting-stars": { cost: "action", range: "60 ft.", max_charges: 6, recovery: { amount: "1d6", reset: "dawn" } },
-  "ring-of-the-ram": { cost: "action", range: "60 ft.", max_charges: 3, recovery: { amount: "1d3", reset: "dawn" } },
-  "ring-of-spell-storing": { cost: "action", range: "self", max_charges: 5 },
-  "ring-of-animal-influence": { cost: "action", range: "self", max_charges: 3, recovery: { amount: "1d3", reset: "dawn" } },
-  "ring-of-elemental-command": { cost: "action", range: "self", max_charges: 5, recovery: { amount: "1d4+1", reset: "dawn" } },
-  "ring-of-evasion": { cost: "reaction", range: "self", max_charges: 3, recovery: { amount: "1d3", reset: "dawn" } },
-  // Necklaces
-  "necklace-of-fireballs": { cost: "action", range: "60 ft.", max_charges: 9 },
-  // Gems
-  "gem-of-brightness": { cost: "action", range: "60 ft.", max_charges: 50 },
-  "gem-of-seeing": { cost: "action", range: "self", max_charges: 3, recovery: { amount: "1d3", reset: "dawn" } },
-  // Helms
-  "helm-of-teleportation": { cost: "action", range: "self", max_charges: 3, recovery: { amount: "1d3", reset: "dawn" } },
-  // Medallions
-  "medallion-of-thoughts": { cost: "action", range: "30 ft.", max_charges: 3, recovery: { amount: "1d3", reset: "dawn" } },
-  // Pipes
-  "pipes-of-haunting": { cost: "action", range: "30 ft.", max_charges: 3, recovery: { amount: "1d3", reset: "dawn" } },
-  "pipes-of-the-sewers": { cost: "action", range: "self", max_charges: 3, recovery: { amount: "1d3", reset: "dawn" } },
-  // Cubes / chimes
-  "cube-of-force": { cost: "action", range: "self", max_charges: 36, recovery: { amount: "1d20", reset: "dawn" } },
-  "chime-of-opening": { cost: "action", range: "120 ft.", max_charges: 10 },
-  // Magic weapons with activation actions (surface in items table only via override; weapons table is primary)
-  "sun-blade": { cost: "free", range: "self" },
-  // Potions / consumables
-  // 2024 healing potions are a Bonus Action to drink/administer (curation still
-  // carries range/max_charges/recovery; the type=potion default covers uncurated ones).
-  "potion-of-healing": { cost: "bonus-action", range: "self", max_charges: 1, recovery: { amount: "0", reset: "special" } },
-  "potion-of-greater-healing": { cost: "bonus-action", range: "self", max_charges: 1, recovery: { amount: "0", reset: "special" } },
-  "potion-of-superior-healing": { cost: "bonus-action", range: "self", max_charges: 1, recovery: { amount: "0", reset: "special" } },
-  "potion-of-supreme-healing": { cost: "bonus-action", range: "self", max_charges: 1, recovery: { amount: "0", reset: "special" } },
-  "alchemists-fire": { cost: "action", range: "20 ft.", max_charges: 1, recovery: { amount: "0", reset: "special" } },
-  "holy-water": { cost: "action", range: "20 ft.", max_charges: 1, recovery: { amount: "0", reset: "special" } },
-  // Oils are APPLIED (minutes), not drunk: curated to "action" so the blanket
-  // type=potion → bonus-action default never mislabels these mis-typed items.
-  "oil-of-sharpness": { cost: "action", range: "self", max_charges: 1, recovery: { amount: "0", reset: "special" } },
-  "oil-of-etherealness": { cost: "action", range: "self", max_charges: 1, recovery: { amount: "0", reset: "special" } },
-  "oil-of-slipperiness": { cost: "action", range: "self", max_charges: 1, recovery: { amount: "0", reset: "special" } },
-  "dust-of-disappearance": { cost: "action", range: "self", max_charges: 1, recovery: { amount: "0", reset: "special" } }
-};
-function findItemAction(slug) {
-  if (slug in ITEM_ACTIONS) return ITEM_ACTIONS[slug];
-  const p = slug.split("_");
-  const bare = p.length >= 3 ? p.slice(2).join("_") : p[p.length - 1];
-  return bare === slug ? void 0 : ITEM_ACTIONS[bare];
-}
-function resolveItemAction(slug, entry, itemType) {
-  var _a, _b;
-  const curated = (_a = findItemAction(slug)) != null ? _a : null;
-  const override = entry.overrides;
-  const overrideCost = override == null ? void 0 : override.action;
-  const overrideRange = override == null ? void 0 : override.range;
-  const cost = (_b = overrideCost != null ? overrideCost : curated == null ? void 0 : curated.cost) != null ? _b : itemType === "potion" ? "bonus-action" : void 0;
-  if (!cost) return null;
-  return {
-    cost,
-    range: overrideRange != null ? overrideRange : curated == null ? void 0 : curated.range,
-    max_charges: curated == null ? void 0 : curated.max_charges,
-    recovery: curated == null ? void 0 : curated.recovery
-  };
-}
+import {
+  ITEM_ACTIONS,
+  findItemAction,
+  resolveItemAction
+} from "../chunk-ZUQW5VBZ.js";
 export {
   ITEM_ACTIONS,
   findItemAction,

package/dist/item/item.attunement.js

@@ -1,12 +1,6 @@
-// src/item/item.attunement.ts
-function requiresAttunement(entity) {
-  if (!entity || !("attunement" in entity)) return false;
-  const a = entity.attunement;
-  if (a === true) return true;
-  if (typeof a === "string") return a.length > 0;
-  if (typeof a === "object" && a !== null) return a.required === true;
-  return false;
-}
+import {
+  requiresAttunement
+} from "../chunk-IHE6KVC3.js";
 export {
   requiresAttunement
 };

package/dist/item/item.bonuses.js

@@ -1,7 +1,10 @@
 import {
   readNumericBonus
-} from "../chunk-LWFTHJIE.js";
-import "../chunk-DNAJRMNN.js";
+} from "../chunk-HHBD4SQ6.js";
+import "../chunk-A54HHCWW.js";
+import "../chunk-LHZXYFBU.js";
+import "../chunk-CM5CWO4K.js";
+import "../chunk-ZCTUYGNV.js";
 export {
   readNumericBonus
 };

package/dist/item/item.codec.js

@@ -1,8 +1,8 @@
 import {
   itemCodec
-} from "../chunk-4XTNPNQB.js";
-import "../chunk-SMLXZUBH.js";
-import "../chunk-GFZ7PITJ.js";
+} from "../chunk-VPYBK2MG.js";
+import "../chunk-EYX4JMAU.js";
+import "../chunk-S3YUXDSC.js";
 import "../chunk-UA5KS2PL.js";
 export {
   itemCodec

package/dist/item/item.conditions.js

@@ -1,7 +1,10 @@
 import {
   evaluateCondition,
   evaluateConditions
-} from "../chunk-DNAJRMNN.js";
+} from "../chunk-A54HHCWW.js";
+import "../chunk-LHZXYFBU.js";
+import "../chunk-CM5CWO4K.js";
+import "../chunk-ZCTUYGNV.js";
 export {
   evaluateCondition,
   evaluateConditions

package/dist/item/item.conditions.types.d.ts

@@ -1,5 +1,6 @@
 import type { EquippedSlots, ClassEntry } from "../pc/pc.types.js";
 import type { BonusFieldPath, Condition } from "../types/item-conditions.types.js";
+import type { EntityRegistry } from "@archivist-gg/core";
 export type { Tier1Condition, Tier2Condition, Tier3Condition, Tier4Condition, FreeTextCondition, AnyOfCondition, Condition, ConditionalBonus, BonusFieldPath, } from "../types/item-conditions.types.js";
 export interface InformationalBonus {
     field: BonusFieldPath;
@@ -15,6 +16,9 @@ export interface ConditionContext {
     classList: ClassEntry[];
     race: string | null;
     subclasses: string[];
+    /** H234 H2: lets `wielding_two_handed` read a MAGIC main-hand weapon through its `base_item`. Optional: every test literal
+     *  stays valid, and without it only the entity's own properties are read. */
+    registry?: EntityRegistry;
 }
 export type BonusReadResult = {
     kind: "applied";

package/dist/item/item.cost.d.ts

@@ -0,0 +1,3 @@
+export declare function costToCopper(cost: string | number | undefined): number;
+export declare function formatCopper(cp: number): string;
+export declare function formatItemCost(cost: string): string;

package/dist/item/item.cost.js

@@ -0,0 +1,29 @@
+// src/item/item.cost.ts
+var GP_DECIMAL = /^\d+(\.\d+)?$/;
+function costToCopper(cost) {
+  let gp;
+  if (typeof cost === "number") gp = cost;
+  else if (typeof cost === "string" && GP_DECIMAL.test(cost)) gp = Number.parseFloat(cost);
+  else return 0;
+  if (!Number.isFinite(gp) || gp < 0) return 0;
+  return Math.round(gp * 100);
+}
+var group = (n) => String(n).replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+function formatCopper(cp) {
+  const c = Math.max(0, Math.round(cp));
+  if (c === 0) return "0 gp";
+  const gp = Math.floor(c / 100);
+  const rest = c % 100;
+  const restText = rest === 0 ? "" : rest % 10 === 0 ? `${rest / 10} sp` : `${rest} cp`;
+  if (gp === 0) return restText;
+  return rest === 0 ? `${group(gp)} gp` : `${group(gp)} gp ${restText}`;
+}
+function formatItemCost(cost) {
+  const cp = costToCopper(cost);
+  return cp > 0 ? formatCopper(cp) : cost;
+}
+export {
+  costToCopper,
+  formatCopper,
+  formatItemCost
+};

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

@@ -0,0 +1,15 @@
+/**
+ * The icon key of an item, weapon or armor entity (inventory arc I3). The key is DATA: an entity's own `icon`
+ * wins; otherwise these rules read the entity's own fields (the tattoo flag, the weapon's base, the armor's
+ * category, the item's type and focus kind, the approved coverage words of its name). A renderer maps a key to
+ * its drawing and each GENERIC_ICON key to a neutral glyph of its own. Every game word lives here, never in the
+ * renderer (memo rendering-policy-from-schema-not-renderer).
+ */
+export declare const GENERIC_ICON: {
+    readonly weapon: "generic:weapon";
+    readonly armor: "generic:armor";
+    readonly item: "generic:item";
+};
+/** Every non-generic key the rules can return; the renderer's icon set must hold each one. */
+export declare const ITEM_ICON_KEYS: readonly string[];
+export declare function itemIconKey(entity: unknown, entityType: string | null): string;

package/dist/item/item.icon.js

@@ -0,0 +1,211 @@
+// src/item/item.icon.ts
+var GENERIC_ICON = { weapon: "generic:weapon", armor: "generic:armor", item: "generic:item" };
+var WEAPON_KEYS = /* @__PURE__ */ new Set([
+  "club",
+  "dagger",
+  "greatclub",
+  "handaxe",
+  "javelin",
+  "light-hammer",
+  "mace",
+  "quarterstaff",
+  "sickle",
+  "spear",
+  "light-crossbow",
+  "dart",
+  "shortbow",
+  "sling",
+  "battleaxe",
+  "flail",
+  "glaive",
+  "greataxe",
+  "greatsword",
+  "halberd",
+  "lance",
+  "longsword",
+  "maul",
+  "morningstar",
+  "pike",
+  "rapier",
+  "scimitar",
+  "shortsword",
+  "trident",
+  "war-pick",
+  "warhammer",
+  "whip",
+  "blowgun",
+  "hand-crossbow",
+  "heavy-crossbow",
+  "longbow",
+  "net"
+]);
+var WEAPON_ALIAS = {
+  "crossbow-hand": "hand-crossbow",
+  "crossbow-light": "light-crossbow",
+  "crossbow-heavy": "heavy-crossbow"
+};
+var ARMOR_CATEGORY_KEY = {
+  light: "light-armor",
+  medium: "medium-armor",
+  heavy: "heavy-armor",
+  shield: "shield"
+};
+var ARMOR_BASE_CATEGORY = {
+  padded: "light",
+  leather: "light",
+  "studded-leather": "light",
+  hide: "medium",
+  "chain-shirt": "medium",
+  "scale-mail": "medium",
+  breastplate: "medium",
+  "half-plate": "medium",
+  "ring-mail": "heavy",
+  "chain-mail": "heavy",
+  splint: "heavy",
+  plate: "heavy",
+  shield: "shield"
+};
+var TYPE_DIRECT = {
+  ring: "ring",
+  potion: "potion",
+  scroll: "scroll",
+  wand: "wand",
+  staff: "staff",
+  rod: "rod",
+  shield: "shield"
+};
+var NAME_WORDS = [
+  ["backpack", ["backpack", "haversack"]],
+  ["pouch", ["pouch", "coin purse"]],
+  ["quiver", ["quiver", "bolt case"]],
+  ["chest", ["chest"]],
+  ["barrel", ["barrel", "basket", "bucket"]],
+  ["pot", ["pot", "jug"]],
+  ["sack", ["sack", "bag"]],
+  ["amulet", ["amulet", "necklace", "periapt"]],
+  ["cloak", ["cloak", "robe", "robes"]],
+  ["boots", ["boots", "slippers"]],
+  ["gloves", ["gloves", "gauntlets", "bracers"]],
+  ["belt", ["belt", "girdle"]],
+  ["circlet", ["circlet", "headband", "diadem"]],
+  ["crown", ["crown"]],
+  ["helmet", ["helm", "helmet"]],
+  ["rations", ["rations"]],
+  ["waterskin", ["waterskin"]],
+  ["instrument", ["instrument", "instruments"]],
+  ["dice", ["dice", "dice set", "gaming set"]],
+  ["gem", ["gem", "gems"]],
+  ["hourglass", ["hourglass"]],
+  ["flask", ["flask", "vial", "bottle", "oil", "holy water", "acid"]],
+  ["torch", ["torch"]],
+  ["lantern", ["lantern", "lamp"]],
+  ["candle", ["candle", "tinderbox"]],
+  ["rope", ["rope", "chain"]],
+  ["crowbar", ["crowbar"]],
+  ["manacles", ["manacles"]],
+  ["mirror", ["mirror"]],
+  ["spyglass", ["spyglass"]],
+  ["compass", ["compass"]],
+  ["map", ["map"]],
+  ["spellbook", ["spellbook"]],
+  ["book", ["book", "journal"]],
+  ["quill", ["ink", "ink pen", "paper"]],
+  ["bedroll", ["bedroll", "blanket"]],
+  ["tent", ["tent"]],
+  ["holy-symbol", ["holy symbol", "reliquary"]],
+  ["healer-kit", ["healer's kit"]],
+  ["herbs", ["herbalism kit", "herbs"]],
+  ["key", ["thieves' tools", "key", "lock"]],
+  ["tools", ["artisan's tools", "hammer", "smith's tools"]],
+  ["cards", ["playing cards", "playing card set"]],
+  ["coins", ["coin", "coins", "trade bar", "trade bars"]],
+  ["stone", ["stone", "stones"]],
+  ["wand", ["wand"]],
+  ["rod", ["rod"]],
+  ["staff", ["staff"]],
+  ["ring", ["ring"]],
+  ["net", ["net"]]
+];
+var FOCUS_KEY = { holy: "holy-symbol", arcane: "wondrous", druid: "herbs" };
+var TYPE_FALLBACK = {
+  instrument: "instrument",
+  "artisan's tools": "tools",
+  tool: "tools",
+  tools: "tools",
+  "gaming set": "dice",
+  ammunition: "quiver",
+  food: "rations",
+  wondrous: "wondrous"
+};
+var AMMUNITION_NAME = /\b(?:ammunition|arrows?|bolts?|bullets?|needles?)\b/i;
+var TATTOO_NAME = /\btattoo\b/i;
+var escapeRe = (w) => w.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+var NAME_RULES = NAME_WORDS.map(
+  ([key, words]) => [key, new RegExp(`\\b(?:${words.map(escapeRe).join("|")})\\b`, "i")]
+);
+var ITEM_ICON_KEYS = [.../* @__PURE__ */ new Set([
+  "tattoo",
+  "quiver",
+  ...WEAPON_KEYS,
+  ...Object.values(ARMOR_CATEGORY_KEY),
+  ...Object.values(TYPE_DIRECT),
+  ...NAME_WORDS.map(([k]) => k),
+  ...Object.values(FOCUS_KEY),
+  ...Object.values(TYPE_FALLBACK)
+])].sort();
+var text = (v) => typeof v === "string" ? v : "";
+function canon(raw) {
+  var _a;
+  let s = raw.toLowerCase().replace(/\s*\([^)]*\)/g, " ").trim();
+  const comma = /^([^,]+),\s*(.+)$/.exec(s);
+  if (comma) s = `${comma[2]} ${comma[1]}`;
+  s = s.replace(/[\s-]+armou?r$/, "").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  return (_a = WEAPON_ALIAS[s]) != null ? _a : s;
+}
+var weaponKey = (raw) => {
+  const k = canon(raw);
+  return WEAPON_KEYS.has(k) ? k : void 0;
+};
+var armorKey = (raw) => {
+  const cat = ARMOR_BASE_CATEGORY[canon(raw)];
+  return cat ? ARMOR_CATEGORY_KEY[cat] : void 0;
+};
+function baseName(link) {
+  const raw = text(link).trim();
+  if (!raw) return "";
+  const m = /^\[\[([^\]|]+)(?:\|[^\]]*)?\]\]$/.exec(raw);
+  const inner = m ? m[1] : raw;
+  return inner.includes("/") ? inner.slice(inner.lastIndexOf("/") + 1) : inner.slice(inner.lastIndexOf("_") + 1);
+}
+function itemIconKey(entity, entityType) {
+  var _a, _b, _c, _d, _e, _f, _g, _h;
+  const e = entity !== null && typeof entity === "object" ? entity : {};
+  const own = text(e.icon).trim();
+  if (own) return own;
+  const name = text(e.name);
+  if (e.tattoo === true || TATTOO_NAME.test(name)) return "tattoo";
+  if (entityType === "weapon") return (_b = (_a = weaponKey(baseName(e.slug))) != null ? _a : weaponKey(name)) != null ? _b : GENERIC_ICON.weapon;
+  if (entityType === "armor") {
+    const cat = text(e.category).toLowerCase().replace(/\s*armou?r\s*$/, "").trim();
+    return (_d = (_c = ARMOR_CATEGORY_KEY[cat]) != null ? _c : armorKey(name)) != null ? _d : GENERIC_ICON.armor;
+  }
+  const rawType = text(e.type).toLowerCase().trim();
+  const paren = /^([^()]+?)\s*\(([^)]+)\)\s*$/.exec(rawType);
+  const type = (paren ? paren[1] : rawType).trim().replace(/\s+item$/, "");
+  const inner = paren ? paren[2].trim() : "";
+  if (type === "weapon") {
+    return (_e = weaponKey(baseName(e.base_item) || inner)) != null ? _e : AMMUNITION_NAME.test(name) ? "quiver" : GENERIC_ICON.weapon;
+  }
+  if (type === "armor") return (_f = armorKey(baseName(e.base_item) || inner)) != null ? _f : GENERIC_ICON.armor;
+  const direct = TYPE_DIRECT[type];
+  if (direct) return direct;
+  const bare = name.replace(/\s*\([^)]*\)/g, " ").trim();
+  for (const [key, re] of NAME_RULES) if (re.test(bare)) return key;
+  if (type === "spellcasting focus") return (_g = FOCUS_KEY[text(e.focus).toLowerCase()]) != null ? _g : "wondrous";
+  return (_h = TYPE_FALLBACK[type]) != null ? _h : GENERIC_ICON.item;
+}
+export {
+  GENERIC_ICON,
+  ITEM_ICON_KEYS,
+  itemIconKey
+};

package/dist/item/item.parser.js

@@ -1,7 +1,7 @@
 import {
   parseItem
-} from "../chunk-SMLXZUBH.js";
-import "../chunk-GFZ7PITJ.js";
+} from "../chunk-EYX4JMAU.js";
+import "../chunk-S3YUXDSC.js";
 import "../chunk-UA5KS2PL.js";
 export {
   parseItem

package/dist/item/item.schema.d.ts

@@ -1,6 +1,18 @@
 import { z } from "zod";
 import type { Condition } from "@archivist-gg/dnd5e/types/item-conditions.types";
 export declare const conditionSchema: z.ZodType<Condition>;
+export declare const containerSchema: z.ZodObject<{
+    capacity_weight: z.ZodOptional<z.ZodNumber>;
+    holds_items: z.ZodOptional<z.ZodBoolean>;
+    pack_contents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    pack_atomic: z.ZodOptional<z.ZodBoolean>;
+    capacity: z.ZodOptional<z.ZodObject<{
+        weight: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+        item: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodNumber>>>;
+        weightless: z.ZodOptional<z.ZodBoolean>;
+        volume: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    }, z.core.$strict>>;
+}, z.core.$strip>;
 export declare const itemEntitySchema: z.ZodObject<{
     name: z.ZodString;
     slug: z.ZodOptional<z.ZodString>;
@@ -182,8 +194,9 @@ export declare const itemEntitySchema: z.ZodObject<{
     }, z.core.$strip>>;
     container: z.ZodOptional<z.ZodObject<{
         capacity_weight: z.ZodOptional<z.ZodNumber>;
-        weightless: z.ZodOptional<z.ZodBoolean>;
+        holds_items: z.ZodOptional<z.ZodBoolean>;
         pack_contents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        pack_atomic: z.ZodOptional<z.ZodBoolean>;
         capacity: z.ZodOptional<z.ZodObject<{
             weight: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
             item: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodNumber>>>;
@@ -201,6 +214,7 @@ export declare const itemEntitySchema: z.ZodObject<{
     }, z.core.$strict>>]>>;
     cursed: z.ZodOptional<z.ZodBoolean>;
     sentient: z.ZodOptional<z.ZodBoolean>;
+    tattoo: z.ZodOptional<z.ZodBoolean>;
     focus: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString, z.ZodArray<z.ZodString>]>>;
     tier: z.ZodOptional<z.ZodEnum<{
         major: "major";
@@ -241,6 +255,7 @@ export declare const itemEntitySchema: z.ZodObject<{
         bonus: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
     }, z.core.$strict>>;
     rendering_hint: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
     has_fluff: z.ZodOptional<z.ZodBoolean>;
     has_fluff_images: z.ZodOptional<z.ZodBoolean>;
     image: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;

package/dist/item/item.schema.js

@@ -1,9 +1,11 @@
 import {
   conditionSchema,
+  containerSchema,
   itemEntitySchema
-} from "../chunk-GFZ7PITJ.js";
+} from "../chunk-S3YUXDSC.js";
 import "../chunk-UA5KS2PL.js";
 export {
   conditionSchema,
+  containerSchema,
   itemEntitySchema
 };

package/dist/item/item.types.d.ts

@@ -109,12 +109,16 @@ export interface ItemEntity {
             blindsight?: number;
         };
     };
+    /** No top-level `weightless` (I2a): `capacity.weightless` is the one kept spelling. */
     container?: {
         capacity_weight?: number;
-        weightless?: boolean;
+        holds_items?: boolean;
         pack_contents?: string[];
+        pack_atomic?: boolean;
         /** Structured 5etools capacity. `item` entries are records of
-         *  "<item tag>": <count>, e.g. {"sling bullet|xphb": 20}. */
+         *  "<item tag>": <count>, e.g. {"sling bullet|xphb": 20}. `item` record keys
+         *  are 5etools uids ("sling bullet|xphb") in converted data and item display
+         *  names ("Sling Bullet") in the SRD bundle (I2a). */
         capacity?: {
             weight?: number[];
             item?: Array<Record<string, number>>;
@@ -135,6 +139,7 @@ export interface ItemEntity {
     }>;
     cursed?: boolean;
     sentient?: boolean;
+    tattoo?: boolean;
     focus?: boolean | "arcane" | "druid" | "holy" | string[];
     tier?: "major" | "minor";
     damage?: WeaponEntity["damage"] | string;
@@ -176,6 +181,8 @@ export interface ItemEntity {
     };
     /** Carried by every converter item doc, always as "" today. */
     rendering_hint?: string;
+    /** The icon key (I3): a key of the renderer's icon set or a Lucide name. */
+    icon?: string;
     has_fluff?: boolean;
     has_fluff_images?: boolean;
     /** One wikilink, or an array for >= 2 fluff images (images-ON emit). */

package/dist/monster/monster.parser.js

@@ -1,13 +1,13 @@
 import {
   migrateLegacy,
   parseMonster
-} from "../chunk-QHMWA3SZ.js";
-import "../chunk-G247QXWW.js";
-import "../chunk-PI4LLJG4.js";
+} from "../chunk-VDPRBUU5.js";
+import "../chunk-EL6QPF6I.js";
+import "../chunk-FPGXFD2M.js";
 import "../chunk-WYGD2UGN.js";
 import "../chunk-ZJXSXVFP.js";
-import "../chunk-2M34FLAY.js";
-import "../chunk-XTRDCSJB.js";
+import "../chunk-BRGLDWUP.js";
+import "../chunk-ZMJQUZQH.js";
 import "../chunk-UA5KS2PL.js";
 export {
   migrateLegacy,

package/dist/monster/monster.schema.js

@@ -11,12 +11,12 @@ import {
   monsterSpeedSchema,
   monsterSpellcastingSchema,
   monsterTypeSchema
-} from "../chunk-G247QXWW.js";
-import "../chunk-PI4LLJG4.js";
+} from "../chunk-EL6QPF6I.js";
+import "../chunk-FPGXFD2M.js";
 import "../chunk-WYGD2UGN.js";
 import "../chunk-ZJXSXVFP.js";
-import "../chunk-2M34FLAY.js";
-import "../chunk-XTRDCSJB.js";
+import "../chunk-BRGLDWUP.js";
+import "../chunk-ZMJQUZQH.js";
 import "../chunk-UA5KS2PL.js";
 export {
   MONSTER_KNOWN_KEYS,