@rpgm-tools/neo-angband-core 0.10.0

package/dist/obj/types.js

@@ -0,0 +1,104 @@
+/**
+ * Object domain data model, ported from reference/src/object.h (struct
+ * object_base, object_kind, ego_item, artifact, curse, brand, slay,
+ * activation, flavor), obj-properties.h (struct obj_property and the
+ * OFT_/OBJ_PROPERTY_/OFID_ enums), and the related constants
+ * (Angband 4.2.6).
+ *
+ * Registries bind from the compiled pack JSON (packages/content/pack);
+ * see bind.ts. Live object instances are in object.ts; generation is in
+ * make.ts.
+ *
+ * Effect chains (kind/curse/activation `effect:` directives) are kept as
+ * raw compiled records (EffectRecordJson) rather than being converted to
+ * the effects domain's runtime Effect type here; the effects interpreter
+ * owns that conversion at integration time. Dice strings inside effect
+ * records therefore stay raw as well.
+ */
+import { flagSize, FlagSet } from "../bitflag.js";
+import { ELEM, ELEMENT_ENTRIES, KF, OBJ_MOD, OF, TVAL_ENTRIES } from "../generated/index.js";
+/** TV_MAX: number of tvals (list-tvals.h). */
+export const TV_MAX = TVAL_ENTRIES.length;
+/** Byte size of an object flag set (OF_SIZE = FLAG_SIZE(OF_MAX)). */
+export const OF_SIZE = flagSize(OF.MAX);
+/** Byte size of a kind flag set (KF_SIZE = FLAG_SIZE(KF_MAX)). */
+export const KF_SIZE = flagSize(KF.MAX);
+/** OBJ_MOD_MAX: five stats plus the list-object-modifiers.h entries. */
+export const OBJ_MOD_MAX = Object.keys(OBJ_MOD).length;
+/** ELEM_MAX from list-elements.h. */
+export const ELEM_MAX = ELEMENT_ENTRIES.length;
+/* Element ranges (object.h). */
+export const ELEM_BASE_MIN = ELEM.ACID;
+export const ELEM_BASE_MAX = ELEM.COLD + 1;
+export const ELEM_HIGH_MIN = ELEM.POIS;
+export const ELEM_HIGH_MAX = ELEM.DISEN + 1;
+/* struct element_info flags (object.h). */
+export const EL_INFO_HATES = 0x01;
+export const EL_INFO_IGNORE = 0x02;
+export const EL_INFO_RANDOM = 0x04;
+/** obj-util.h MAX_PVAL. */
+export const MAX_PVAL = 32767;
+/** obj-make.h NO_MINIMUM (ego minima sentinel). */
+export const NO_MINIMUM = 255;
+/** obj-tval.h SV_UNKNOWN. */
+export const SV_UNKNOWN = 0;
+/** obj-properties.h enum object_flag_type. */
+export const OFT = {
+    NONE: 0,
+    SUST: 1,
+    PROT: 2,
+    MISC: 3,
+    LIGHT: 4,
+    MELEE: 5,
+    BAD: 6,
+    DIG: 7,
+    THROW: 8,
+    CURSE_ONLY: 9,
+    MAX: 10,
+};
+/** obj-properties.h enum object_flag_id. */
+export const OFID = {
+    NONE: 0,
+    NORMAL: 1,
+    TIMED: 2,
+    WIELD: 3,
+};
+/** obj-properties.h enum obj_property_type. */
+export const OBJ_PROPERTY = {
+    NONE: 0,
+    STAT: 1,
+    MOD: 2,
+    FLAG: 3,
+    IGNORE: 4,
+    RESIST: 5,
+    VULN: 6,
+    IMM: 7,
+    MAX: 8,
+};
+/** A zeroed element info array of ELEM_MAX entries. */
+export function newElemInfo() {
+    const out = [];
+    for (let i = 0; i < ELEM_MAX; i++)
+        out.push({ resLevel: 0, flags: 0 });
+    return out;
+}
+/** A zeroed RandomValue. */
+export function zeroRv() {
+    return { base: 0, dice: 0, sides: 0, mBonus: 0 };
+}
+/** A zeroed RandomValue array of OBJ_MOD_MAX entries. */
+export function newModifiersRv() {
+    const out = [];
+    for (let i = 0; i < OBJ_MOD_MAX; i++)
+        out.push(zeroRv());
+    return out;
+}
+/** A new object flag set. */
+export function newOfFlags() {
+    return new FlagSet(OF_SIZE);
+}
+/** A new kind flag set. */
+export function newKfFlags() {
+    return new FlagSet(KF_SIZE);
+}
+//# sourceMappingURL=types.js.map

package/dist/obj/types.js.map

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

package/dist/obj/value.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Object valuation, ported from the pricing half of reference/src/obj-power.c
+ * (Angband 4.2.6): object_value_base, object_value_real, object_value.
+ *
+ * The variable-power path (weapons, launchers, ammo, armour, jewelry, lights)
+ * is priced from object_power (see power.ts); constant-price kinds (potions,
+ * scrolls, food, wands, staves, rods, ...) are priced from the kind's base
+ * cost, plus a per-charge premium for wands and staves.
+ *
+ * object_value dispatches by flavor-awareness (supplied by the caller's
+ * FlavorKnowledge) and item class. For variable-power items upstream prices the
+ * obj->known partial-knowledge twin (obj-power.c L1257-1259); a caller that
+ * supplies an ObjectValueKnowledge context makes object_value synthesise that
+ * twin (the port's on-demand known shadow) and price it, so an item with
+ * still-unknown runes is valued from what the player actually knows. A caller
+ * with no context prices the real object, which is exact for a fully-known item
+ * (store stock, identified gear) and over-values only an item with unknown runes.
+ */
+import type { Player } from "../player/player.js";
+import type { ObjRegistry } from "./bind.js";
+import type { KnownDesc } from "./known-object.js";
+import type { RuneEnv } from "./knowledge.js";
+import type { GameObject } from "./object.js";
+/**
+ * object_value_base (obj-power.c L1060): a guess at the value of a non-aware
+ * item. `aware` is object_flavor_is_aware(obj); when the item's flavor is known
+ * the kind's real cost is used, otherwise a flat per-tval estimate.
+ */
+export declare function objectValueBase(obj: GameObject, aware: boolean): number;
+/**
+ * object_value_real (obj-power.c L1099): the real price of a known (or partly
+ * known) item, for a stack of `qty`.
+ *
+ * Wearables and ammo are priced by object_power via a quadratic
+ * value = power * (power * a + b) (a = 1, b = 5), scaled down by AMMO_RESCALER
+ * for ammo and non-ego burning torches. Constant-price kinds use kind.cost,
+ * with a per-charge premium for wands and staves.
+ */
+export declare function objectValueReal(reg: ObjRegistry, obj: GameObject, qty: number): number;
+/**
+ * The knowledge context object_value needs to synthesise the obj->known twin
+ * (the port's on-demand known shadow) for a variable-power item, mirroring
+ * upstream's object_value_real(obj->known) at obj-power.c L1258-1259.
+ */
+export interface ObjectValueKnowledge {
+    /** The pricing player (upstream `player`; obj->known is built from p->obj_k). */
+    p: Player;
+    /** The rune/curse registries the shadow synthesis reads. */
+    env: RuneEnv;
+    /** Flavour-awareness deps the shadow synthesis reads. */
+    deps: KnownDesc;
+}
+/**
+ * object_value (obj-power.c L1253): the price of an item (qty one or a stack),
+ * including plusses and charges, never noticing unknown bonuses.
+ *
+ * `aware` is object_flavor_is_aware(obj), supplied by the caller's
+ * FlavorKnowledge. For a variable-power item upstream prices obj->known
+ * (L1258-1259): when `known` is supplied this synthesises that twin from the
+ * player's rune knowledge and prices it (so unknown runes are not paid for);
+ * without it the real object is priced (exact for a fully-known item).
+ */
+export declare function objectValue(reg: ObjRegistry, obj: GameObject, qty: number, aware: boolean, known?: ObjectValueKnowledge): number;
+//# sourceMappingURL=value.d.ts.map

package/dist/obj/value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value.d.ts","sourceRoot":"","sources":["../../src/obj/value.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAQ9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAS9C;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAwBvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,MAAM,GACV,MAAM,CAkFR;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,iFAAiF;IACjF,CAAC,EAAE,MAAM,CAAC;IACV,4DAA4D;IAC5D,GAAG,EAAE,OAAO,CAAC;IACb,yDAAyD;IACzD,IAAI,EAAE,SAAS,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,KAAK,CAAC,EAAE,oBAAoB,GAC3B,MAAM,CAcR"}

package/dist/obj/value.js

@@ -0,0 +1,176 @@
+/**
+ * Object valuation, ported from the pricing half of reference/src/obj-power.c
+ * (Angband 4.2.6): object_value_base, object_value_real, object_value.
+ *
+ * The variable-power path (weapons, launchers, ammo, armour, jewelry, lights)
+ * is priced from object_power (see power.ts); constant-price kinds (potions,
+ * scrolls, food, wands, staves, rods, ...) are priced from the kind's base
+ * cost, plus a per-charge premium for wands and staves.
+ *
+ * object_value dispatches by flavor-awareness (supplied by the caller's
+ * FlavorKnowledge) and item class. For variable-power items upstream prices the
+ * obj->known partial-knowledge twin (obj-power.c L1257-1259); a caller that
+ * supplies an ObjectValueKnowledge context makes object_value synthesise that
+ * twin (the port's on-demand known shadow) and price it, so an item with
+ * still-unknown runes is valued from what the player actually knows. A caller
+ * with no context prices the real object, which is exact for a fully-known item
+ * (store stock, identified gear) and over-values only an item with unknown runes.
+ */
+import { OF, TV } from "../generated/index.js";
+import { INT_MAX, INT_MIN } from "../guard.js";
+import { objectKnownShadow } from "./known-object.js";
+import { tvalCanHaveCharges, tvalCanHaveFlavor, tvalHasVariablePower, tvalIsAmmo, tvalIsLight, } from "./object.js";
+import { objectPower } from "./power.js";
+/**
+ * AMMO_RESCALER (obj-power.h): a stack of this many pieces of ammo (or plain
+ * torches) is worth one weapon of the same damage output.
+ */
+const AMMO_RESCALER = 20;
+/**
+ * object_value_base (obj-power.c L1060): a guess at the value of a non-aware
+ * item. `aware` is object_flavor_is_aware(obj); when the item's flavor is known
+ * the kind's real cost is used, otherwise a flat per-tval estimate.
+ */
+export function objectValueBase(obj, aware) {
+    /* Use template cost for aware objects. */
+    if (aware)
+        return obj.kind.cost;
+    /* Analyze the type. */
+    switch (obj.tval) {
+        case TV.FOOD:
+        case TV.MUSHROOM:
+            return 5;
+        case TV.POTION:
+        case TV.SCROLL:
+            return 20;
+        case TV.RING:
+        case TV.AMULET:
+            return 45;
+        case TV.WAND:
+            return 50;
+        case TV.STAFF:
+            return 70;
+        case TV.ROD:
+            return 90;
+        default:
+            return 0;
+    }
+}
+/**
+ * object_value_real (obj-power.c L1099): the real price of a known (or partly
+ * known) item, for a stack of `qty`.
+ *
+ * Wearables and ammo are priced by object_power via a quadratic
+ * value = power * (power * a + b) (a = 1, b = 5), scaled down by AMMO_RESCALER
+ * for ammo and non-ego burning torches. Constant-price kinds use kind.cost,
+ * with a per-charge premium for wands and staves.
+ */
+export function objectValueReal(reg, obj, qty) {
+    /* Quadratic (a) and linear (b) coefficients; both must be non-negative. */
+    const a = 1;
+    const b = 5;
+    let value = 0;
+    let totalValue;
+    /* Wearables and ammo vary by individual item properties. */
+    if (tvalHasVariablePower(obj.tval)) {
+        const power = objectPower(reg, obj);
+        /* Protect against overflow. */
+        if (power > 0) {
+            if (a > 0) {
+                if (power <= Math.trunc((Math.trunc(INT_MAX / power) - b) / a)) {
+                    value = power * (power * a + b);
+                }
+                else {
+                    value = INT_MAX;
+                }
+            }
+            else if (b > 0) {
+                value = power <= Math.trunc(INT_MAX / b) ? power * b : INT_MAX;
+            }
+            else {
+                value = 0;
+            }
+        }
+        else if (power < 0) {
+            if (a > 0) {
+                if (power > INT_MIN &&
+                    power >= Math.trunc((Math.trunc(INT_MIN / -power) + b) / a)) {
+                    value = -power * (power * a - b);
+                }
+                else {
+                    value = INT_MIN;
+                }
+            }
+            else if (b > 0) {
+                value = power >= Math.trunc(INT_MIN / b) ? power * b : INT_MIN;
+            }
+            else {
+                value = 0;
+            }
+        }
+        else {
+            value = 0;
+        }
+        /* Rescale for expendables. */
+        if ((tvalIsLight(obj.tval) && obj.flags.has(OF.BURNS_OUT) && !obj.ego) ||
+            tvalIsAmmo(obj.tval)) {
+            value = Math.trunc(value / AMMO_RESCALER);
+        }
+        /* Round up so things like cloaks are not worthless. */
+        if (value === 0)
+            value = 1;
+        totalValue = value * qty;
+        if (totalValue < 0)
+            totalValue = 0;
+    }
+    else {
+        /* Worthless items. */
+        if (!obj.kind.cost)
+            return 0;
+        /* Base cost. */
+        value = obj.kind.cost;
+        /* Analyze the item type and quantity. */
+        if (tvalCanHaveCharges(obj.tval)) {
+            totalValue = value * qty;
+            /* Calculate number of charges, rounded up. */
+            let charges = Math.floor((obj.pval * qty) / obj.number);
+            if ((obj.pval * qty) % obj.number !== 0)
+                charges++;
+            /* Pay extra for charges, depending on standard number of charges. */
+            totalValue += Math.floor((value * charges) / 20);
+        }
+        else {
+            totalValue = value * qty;
+        }
+        /* No negative value. */
+        if (totalValue < 0)
+            totalValue = 0;
+    }
+    return totalValue;
+}
+/**
+ * object_value (obj-power.c L1253): the price of an item (qty one or a stack),
+ * including plusses and charges, never noticing unknown bonuses.
+ *
+ * `aware` is object_flavor_is_aware(obj), supplied by the caller's
+ * FlavorKnowledge. For a variable-power item upstream prices obj->known
+ * (L1258-1259): when `known` is supplied this synthesises that twin from the
+ * player's rune knowledge and prices it (so unknown runes are not paid for);
+ * without it the real object is priced (exact for a fully-known item).
+ */
+export function objectValue(reg, obj, qty, aware, known) {
+    /* Variable-power items are assessed by what is known about them. */
+    if (tvalHasVariablePower(obj.tval)) {
+        const priced = known
+            ? objectKnownShadow(obj, known.p, known.env, known.deps)
+            : obj;
+        return objectValueReal(reg, priced, qty);
+    }
+    /* Flavoured kinds the player is aware of price at their real cost. */
+    if (tvalCanHaveFlavor(obj.kind.tval) && aware) {
+        return objectValueReal(reg, obj, qty);
+    }
+    /* Otherwise, a flat base guess. */
+    return objectValueBase(obj, aware) * qty;
+}
+//# sourceMappingURL=value.js.map

package/dist/obj/value.js.map

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

package/dist/player/abilities.d.ts

@@ -0,0 +1,57 @@
+/**
+ * The race/class abilities browser's data model, ported from
+ * reference/src/player-properties.c (class_has_ability, race_has_ability,
+ * view_abilities).
+ *
+ * Upstream keeps one flat player_ability list (player_abilities), each row
+ * typed "player" (a PF_* player flag), "object" (an OF_* object flag) or
+ * "element" (a resistance/immunity/vulnerability level on a specific
+ * element). do_cmd_abilities scans that list twice - once testing
+ * class_has_ability against player->class, once testing race_has_ability
+ * against player->race - and shows the two runs back to back (class first,
+ * then race).
+ *
+ * The port's bound player_property records (players.properties,
+ * PlayerPropertyRecordJson via bind.ts) are a direct, UNEXPANDED parse of
+ * player_property.txt: the three "element" template rows (Resistance /
+ * Immunity / Vulnerability) still read as single records, whereas upstream's
+ * finish_parse_player_prop (init.c L1362) expands each of them into one row
+ * per element (new->index = element index, name = "<Elem> <Template>", desc
+ * = "<template desc> <elem>.") before the game ever runs. This module
+ * performs that same expansion at read time instead of at load time - same
+ * result, since playerAbilities is the only reader of the element rows.
+ *
+ * PlayerProperty carries no numeric index (the bound record keeps only the
+ * PF_/OF_ *name*, in `code`); resolveIndex maps it through the generated PF /
+ * OF tables, mirroring the game's numeric player_ability->index. An
+ * unresolvable code is skipped rather than throwing, so a future data/flag
+ * drift degrades gracefully instead of crashing the browser.
+ */
+import type { GameState } from "../game/context.js";
+import type { PlayerProperty } from "./types.js";
+/** One row of the abilities browser: an ability's display name/desc/group. */
+export interface AbilityRow {
+    name: string;
+    desc: string;
+    group: "class" | "race" | "special";
+}
+/** Deps playerAbilities needs beyond GameState (registry data, not core state). */
+export interface PlayerAbilitiesDeps {
+    /** players.properties: the raw (unexpanded) player_property records. */
+    properties: readonly PlayerProperty[];
+    /**
+     * projections[i].name for element index i (element-type projections are
+     * bound first, in list-elements.h order - see obj/object-info.ts's
+     * raceOrigin/projections use for the same convention). Only entries up to
+     * the number of elements on PlayerRace.elInfo are consulted.
+     */
+    elementNames: readonly string[];
+}
+/**
+ * view_abilities (player-properties.c L62): the ability_list the abilities
+ * browser shows - every class ability the player has, then every racial one
+ * (including the per-element resist/immune/vulnerable rows), in
+ * player_property.txt declaration order within each pass.
+ */
+export declare function playerAbilities(state: GameState, deps: PlayerAbilitiesDeps): AbilityRow[];
+//# sourceMappingURL=abilities.d.ts.map

package/dist/player/abilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abilities.d.ts","sourceRoot":"","sources":["../../src/player/abilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAe,cAAc,EAAc,MAAM,YAAY,CAAC;AAI1E,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,mFAAmF;AACnF,MAAM,WAAW,mBAAmB;IAClC,wEAAwE;IACxE,UAAU,EAAE,SAAS,cAAc,EAAE,CAAC;IACtC;;;;;OAKG;IACH,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AA4DD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,mBAAmB,GAAG,UAAU,EAAE,CAsBzF"}

package/dist/player/abilities.js

@@ -0,0 +1,118 @@
+/**
+ * The race/class abilities browser's data model, ported from
+ * reference/src/player-properties.c (class_has_ability, race_has_ability,
+ * view_abilities).
+ *
+ * Upstream keeps one flat player_ability list (player_abilities), each row
+ * typed "player" (a PF_* player flag), "object" (an OF_* object flag) or
+ * "element" (a resistance/immunity/vulnerability level on a specific
+ * element). do_cmd_abilities scans that list twice - once testing
+ * class_has_ability against player->class, once testing race_has_ability
+ * against player->race - and shows the two runs back to back (class first,
+ * then race).
+ *
+ * The port's bound player_property records (players.properties,
+ * PlayerPropertyRecordJson via bind.ts) are a direct, UNEXPANDED parse of
+ * player_property.txt: the three "element" template rows (Resistance /
+ * Immunity / Vulnerability) still read as single records, whereas upstream's
+ * finish_parse_player_prop (init.c L1362) expands each of them into one row
+ * per element (new->index = element index, name = "<Elem> <Template>", desc
+ * = "<template desc> <elem>.") before the game ever runs. This module
+ * performs that same expansion at read time instead of at load time - same
+ * result, since playerAbilities is the only reader of the element rows.
+ *
+ * PlayerProperty carries no numeric index (the bound record keeps only the
+ * PF_/OF_ *name*, in `code`); resolveIndex maps it through the generated PF /
+ * OF tables, mirroring the game's numeric player_ability->index. An
+ * unresolvable code is skipped rather than throwing, so a future data/flag
+ * drift degrades gracefully instead of crashing the browser.
+ */
+import { OF } from "../generated/object-flags.js";
+import { PF } from "../generated/player-flags.js";
+/** PF_/OF_ name -> numeric index, or null when the code is absent/unmapped. */
+function resolveIndex(prop) {
+    if (prop.code === null)
+        return null;
+    if (prop.type === "player")
+        return PF[prop.code] ?? null;
+    if (prop.type === "object")
+        return OF[prop.code] ?? null;
+    return null;
+}
+/** class_has_ability (player-properties.c L28). */
+function classHasAbility(cls, prop) {
+    const idx = resolveIndex(prop);
+    if (idx === null)
+        return false;
+    if (prop.type === "player")
+        return cls.pflags.has(idx);
+    if (prop.type === "object")
+        return cls.flags.has(idx);
+    return false;
+}
+/** race_has_ability (player-properties.c L41), excluding the element branch
+ * (handled separately by expandElementRows since it fans one record out
+ * into one row per matching element). */
+function raceHasAbility(race, prop) {
+    const idx = resolveIndex(prop);
+    if (idx === null)
+        return false;
+    if (prop.type === "player")
+        return race.pflags.has(idx);
+    if (prop.type === "object")
+        return race.flags.has(idx);
+    return false;
+}
+/** ODESC_CAPITAL-style single-word/phrase capitalisation (my_strcap on the element name). */
+function capitalize(s) {
+    return s.length ? s.charAt(0).toUpperCase() + s.slice(1) : s;
+}
+/**
+ * Expand one "element" template property into its per-element ability rows
+ * (finish_parse_player_prop, init.c L1362-1387): one row for every element
+ * whose el_info[i].resLevel matches the template's value (1 = resist, 3 =
+ * immune, -1 = vulnerable).
+ */
+function expandElementRows(prop, race, elementNames) {
+    const rows = [];
+    const n = Math.min(elementNames.length, race.elInfo.length);
+    for (let i = 0; i < n; i++) {
+        if ((race.elInfo[i]?.resLevel ?? 0) !== prop.value)
+            continue;
+        const elemName = elementNames[i] ?? "";
+        rows.push({
+            name: `${capitalize(elemName)} ${prop.name}`,
+            desc: `${prop.desc} ${elemName}.`,
+            group: "race",
+        });
+    }
+    return rows;
+}
+/**
+ * view_abilities (player-properties.c L62): the ability_list the abilities
+ * browser shows - every class ability the player has, then every racial one
+ * (including the per-element resist/immune/vulnerable rows), in
+ * player_property.txt declaration order within each pass.
+ */
+export function playerAbilities(state, deps) {
+    const player = state.actor.player;
+    const rows = [];
+    for (const prop of deps.properties) {
+        if (prop.type === "element")
+            continue; // no class-side element abilities
+        if (classHasAbility(player.cls, prop)) {
+            rows.push({ name: prop.name, desc: prop.desc, group: "class" });
+        }
+    }
+    for (const prop of deps.properties) {
+        if (prop.type === "element") {
+            rows.push(...expandElementRows(prop, player.race, deps.elementNames));
+            continue;
+        }
+        if (raceHasAbility(player.race, prop)) {
+            rows.push({ name: prop.name, desc: prop.desc, group: "race" });
+        }
+    }
+    return rows;
+}
+//# sourceMappingURL=abilities.js.map

package/dist/player/abilities.js.map

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

package/dist/player/best-digger.d.ts

@@ -0,0 +1,42 @@
+/**
+ * player_best_digger (player-util.c L744) plus the swap-and-recompute tail that
+ * do_cmd_tunnel_aux (cmd-cave.c L546-588) and compute_rubble_penalty
+ * (player-path.c L219-256) share, ported from Angband 4.2.6.
+ *
+ * Digging normally uses the wielded weapon's DIGGING skill, but a better digger
+ * carried in the pack is temporarily wielded first: upstream finds the pack's
+ * best melee weapon (by the DIGGING skill it would grant), and if it differs
+ * from the current weapon and the current weapon can be removed, recomputes the
+ * bonuses with it swapped in and reads that DIGGING. This module reproduces that
+ * choice and returns the DIGGING skill to feed into the existing dig roll.
+ *
+ * RNG: player_best_digger and the swap are RNG-FREE - they only change the INPUT
+ * (the DIGGING skill) to the caller's existing randint0(1600) draw. calc_bonuses
+ * takes no Rng, so `computeDigging` draws nothing; the caller's draw count and
+ * order are unchanged. This is deliberately input-only (do not add or reorder
+ * any draw here).
+ */
+import type { GameObject } from "../obj/object.js";
+/**
+ * player_best_digger + the do_cmd_tunnel_aux / compute_rubble_penalty swap:
+ * return the DIGGING skill the dig should use, given the live per-body-slot
+ * equipment, every carried object (upstream p->gear, pack + equipped), the
+ * weapon body-slot index, and a `computeDigging` that runs calc_bonuses over a
+ * candidate equipment array and returns its SKILL_DIGGING (update=false, so no
+ * side effects and no RNG).
+ *
+ * The best pack digger is the qualifying melee weapon whose wielded DIGGING is
+ * highest (upstream's strict `score > best_score`, so ties keep the first-seen
+ * object - immaterial here since ties share the same DIGGING value). The swap
+ * only applies when that object differs from the current weapon AND the current
+ * weapon can be taken off (obj_can_takeoff: not sticky-cursed); otherwise the
+ * current wielded DIGGING stands.
+ */
+export declare function playerBestDiggerDigging(liveEquipment: readonly (GameObject | null)[], gearObjects: readonly GameObject[], weaponSlot: number, computeDigging: (equipment: (GameObject | null)[]) => number): number;
+/**
+ * tunnel_aux's `with_clause` (cmd-cave.c:541, :552): what every tunnel message
+ * says the player is digging with. Derived from the SAME swap decision as
+ * playerBestDiggerDigging, so the message and the roll can never disagree.
+ */
+export declare function playerBestDiggerWithClause(liveEquipment: readonly (GameObject | null)[], gearObjects: readonly GameObject[], weaponSlot: number, computeDigging: (equipment: (GameObject | null)[]) => number): string;
+//# sourceMappingURL=best-digger.d.ts.map

package/dist/player/best-digger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"best-digger.d.ts","sourceRoot":"","sources":["../../src/player/best-digger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,SAAS,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,EAC7C,WAAW,EAAE,SAAS,UAAU,EAAE,EAClC,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,CAAC,SAAS,EAAE,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,KAAK,MAAM,GAC3D,MAAM,CAaR;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,SAAS,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,EAC7C,WAAW,EAAE,SAAS,UAAU,EAAE,EAClC,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,CAAC,SAAS,EAAE,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,KAAK,MAAM,GAC3D,MAAM,CASR"}