@rpgm-tools/neo-angband-core 0.10.0

package/dist/mon/steal.js

@@ -0,0 +1,163 @@
+/**
+ * Stealing objects from a monster, ported from reference/src/mon-util.c
+ * (Angband 4.2.6): get_random_monster_object (L1405) and steal_monster_item
+ * (L1430). This is the RNG core of the rogue / PF_STEAL "steal" command
+ * (do_cmd_steal, cmd-cave.c L1016) and, upstream, of the EAT_ITEM melee blow
+ * when the attacker's target is another monster (mon-blows.c L876).
+ *
+ * The heavy RNG order is the correctness crux, so it lives here worldless (like
+ * combat/mon-melee.ts): stealMonsterItem draws every roll in strict upstream
+ * order and mutates the monster's held pile directly, delegating the
+ * player-facing world work (gold gain, pack carry, drop_near, ignore checks,
+ * the hit-and-run teleport, EF_WAKE aggro) to the injected StealEnv. The game
+ * binding (game/steal.ts) supplies that env over the live GameState.
+ *
+ * RNG draw order (mon-util.c L1430-1539), verified against the C:
+ *   1. get_random_monster_object(mon): a reservoir pick over mon->held_obj -
+ *      one_in_(i) for each non-quest-artifact held object, i counting from 1.
+ *   2. (no object) one_in_(3), then monster_wake(mon, false, 100) on success
+ *      (which draws randint0(100) for awareness).
+ *   3. monster_reaction = guard/2 + randint1(MAX(guard, 1)); the item-weight
+ *      term adds no RNG.
+ *   4. success (reaction < skill): pile_excise, then either gold gain, or a
+ *      drop_near (its own breakage / grid RNG) when the item is ignored or the
+ *      pack is full, or a plain inven_carry; then mon_dec_timed(SLEEP) (which
+ *      may draw for its save), then the hit-and-run teleport when TMD_ATT_RUN.
+ *   5. decent fail (reaction/2 < skill): monster_wake(mon, true, 50).
+ *   6. bungle (else): monster_wake(mon, true, 100), then EF_WAKE aggro.
+ *
+ * DEFERRED (noted, no RNG impact): the object knowledge bookkeeping upstream
+ * threads here - object_grab / object_see / delist_object / object_delete - is
+ * the knowledge subsystem (#24), carried by the env's carry/gainGold seams; and
+ * react_to_slay blocking the monster-thief path (midx >= 0) is deferred exactly
+ * as the EAT_ITEM blow already defers it (game/mon-side.ts / mon-cmd.ts). The
+ * mon-vs-mon EAT_ITEM path wires stealMonsterItem from game/mon-cmd.ts.
+ */
+import { KF } from "../generated/index.js";
+import { getLore } from "./lore.js";
+import { monsterIsUnique } from "./predicate.js";
+import { monsterWake } from "./take-hit.js";
+import { MON_TMD } from "../generated/index.js";
+import { monDecTimed, MON_TMD_FLG_NOTIFY } from "./timed.js";
+/**
+ * get_random_monster_object (mon-util.c L1405): pick one object from the
+ * monster's held pile with uniform probability, skipping quest artifacts. The
+ * reservoir draw (one_in_(i), i from 1) matches upstream exactly, so the choice
+ * is the same for a given RNG stream.
+ */
+export function getRandomMonsterObject(rng, mon) {
+    let pick = null;
+    let i = 1;
+    for (const obj of mon.heldObj) {
+        /* Check it isn't a quest artifact. */
+        if (obj.artifact && obj.kind.kindFlags.has(KF.QUEST_ART))
+            continue;
+        if (rng.oneIn(i))
+            pick = obj;
+        i++;
+    }
+    return pick;
+}
+/** pile_excise(&mon->held_obj, obj): drop the object from the held pile. */
+function pileExcise(mon, obj) {
+    const at = mon.heldObj.indexOf(obj);
+    if (at >= 0)
+        mon.heldObj.splice(at, 1);
+}
+/**
+ * steal_monster_item (mon-util.c L1430): the thief with index `midx` steals a
+ * random item from `mon`. `midx < 0` is the player (do_cmd_steal); `midx >= 0`
+ * is a monster thief (the EAT_ITEM blow against another monster). Every RNG
+ * draw is issued in strict upstream order; see the module header.
+ */
+export function stealMonsterItem(rng, lore, mon, midx, env) {
+    /* Choose the victim item (drawn first, before anything else). */
+    const obj = getRandomMonsterObject(rng, mon);
+    const mName = env.monName(mon);
+    if (midx < 0) {
+        /* Base monster protection and player stealing skill. */
+        const unique = monsterIsUnique(mon);
+        let guard = Math.trunc((mon.race.level * (unique ? 4 : 3)) / 4) +
+            mon.mspeed -
+            env.playerSpeed;
+        let stealSkill = env.stealthSkill + env.dexToHit;
+        /* No object. */
+        if (!obj) {
+            env.msg(`You can find nothing to steal from ${mName}.`);
+            if (rng.oneIn(3)) {
+                /* Monster notices. */
+                monsterWake(rng, mon, false, 100);
+            }
+            return;
+        }
+        /* Penalize some status conditions. */
+        if (env.statusPenalty) {
+            stealSkill = Math.trunc(stealSkill / 4);
+        }
+        if (mon.mTimed[MON_TMD.SLEEP]) {
+            guard = Math.trunc(guard / 2);
+        }
+        /* Monster base reaction, plus allowance for item weight. */
+        let monsterReaction = Math.trunc(guard / 2) + rng.randint1(Math.max(guard, 1));
+        monsterReaction += Math.trunc((obj.number * env.objectWeight(obj)) / 20);
+        /* Try and steal. */
+        if (monsterReaction < stealSkill) {
+            const wake = 35 - env.stealthSkill;
+            /* Success! */
+            obj.heldMIdx = 0;
+            pileExcise(mon, obj);
+            if (env.isMoney(obj)) {
+                env.msg(`You steal ${obj.pval} gold pieces worth of treasure.`);
+                env.gainGold(obj);
+            }
+            else {
+                /* Drop immediately if ignored, or if inventory already full to
+                 * prevent pack overflow. */
+                if (env.isIgnored(obj) || !env.canCarry(obj)) {
+                    env.dropStolen(obj);
+                }
+                else {
+                    env.carry(obj);
+                }
+            }
+            /* Track thefts. */
+            getLore(lore, mon.race).thefts++;
+            /* Monster wakes a little. */
+            monDecTimed(rng, mon, MON_TMD.SLEEP, wake, MON_TMD_FLG_NOTIFY);
+        }
+        else if (Math.trunc(monsterReaction / 2) < stealSkill) {
+            /* Decent attempt, at least. */
+            const oName = env.isMoney(obj) ? "treasure" : env.objectName(obj);
+            env.msg(`You fail to steal ${oName} from ${mName}.`);
+            /* Monster wakes, may notice. */
+            monsterWake(rng, mon, true, 50);
+        }
+        else {
+            /* Bungled it. */
+            monsterWake(rng, mon, true, 100);
+            env.msg(`${(env.monNameStandard ?? env.monName)(mon)} cries out in anger!`);
+            env.wakeAll?.(mon);
+        }
+        /* Player hit and run. */
+        if (env.attRun) {
+            env.hitAndRun?.();
+        }
+    }
+    else {
+        /* Monster thief (midx >= 0): mon-vs-mon EAT_ITEM (mon-cmd.ts). react_to_slay
+         * blocking the theft is DEFERRED (no RNG), as the player EAT_ITEM path. */
+        const tName = env.thiefName?.(midx) ?? "It";
+        if (!obj /* || react_to_slay(obj, thief) -- DEFERRED */) {
+            /* Fail to steal. */
+            env.msg(`${tName} tries to steal something from ${mName}, but fails.`);
+        }
+        else {
+            env.msg(`${tName} steals something from ${mName}!`);
+            /* Steal and carry. */
+            obj.heldMIdx = 0;
+            pileExcise(mon, obj);
+            env.thiefCarry?.(midx, obj);
+        }
+    }
+}
+//# sourceMappingURL=steal.js.map

package/dist/mon/steal.js.map

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

package/dist/mon/summon.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Monster summon types, ported from reference/src/mon-summon.c (Angband
+ * 4.2.6): the summon table built from summon.txt (here the already-parsed
+ * summon.json records bound by bindMonsters) and the race-eligibility
+ * predicate summon_specific_okay.
+ *
+ * This module is the world-free half of mon-summon.c: the table lookups
+ * (summon_name_to_idx, summon_message_type, summon_fallback_type,
+ * summon_desc) and the "okay" test. The placement half (summon_specific,
+ * call_monster, select_shape) needs the live cave and lives in
+ * game/mon-place.ts.
+ *
+ * Divergences by design:
+ * - The upstream file-static summon_specific_type / kin_base globals become
+ *   explicit parameters (type is passed to okay(); the kin base is captured
+ *   by the caller from the summoner's race), so concurrent interpreters
+ *   cannot trample each other.
+ * - message_type stays the msgt NAME (sound/message channels ride #26/#25);
+ *   upstream resolves it to a message index at parse time.
+ */
+import type { MonsterBase, MonsterRace, SummonType } from "./types.js";
+/** One bound summon type (struct summon, resolved). */
+export interface BoundSummon {
+    /** Position in the table (the EF_SUMMON subtype value). */
+    index: number;
+    name: string;
+    /** The message type NAME (msgt:); sound dispatch rides #26. */
+    messageType: string;
+    /** uniques: whether uniques may answer this summon. */
+    uniqueAllowed: boolean;
+    /** base: allowed monster bases (empty = no base restriction). */
+    bases: readonly MonsterBase[];
+    /** race-flag: required RF_ flag (0 = none). */
+    raceFlag: number;
+    /** fallback: the summon type used when this one fails (-1 = none). */
+    fallback: number;
+    desc: string;
+}
+/**
+ * The bound summon table (finish_parse_summon). Records bind in file order,
+ * matching the upstream reversed-linked-list copy, so a record's array
+ * position is its upstream summon index.
+ */
+export declare class SummonTable {
+    readonly kinds: BoundSummon[];
+    constructor(records: readonly SummonType[], bases: ReadonlyMap<string, MonsterBase>);
+    /** summon_name_to_idx: the index for a summon name, or -1. */
+    nameToIdx(name: string): number;
+    /** summon_message_type: the msgt name for a summon type. */
+    messageType(type: number): string;
+    /** summon_fallback_type: the fallback index for a summon type (-1 none). */
+    fallbackType(type: number): number;
+    /** summon_desc: the description for a summon type. */
+    desc(type: number): string;
+}
+/**
+ * summon_specific_okay: whether a race may answer a summon of the given
+ * type. `kinBase` is the summoner's race base, read only by the KIN type
+ * (upstream's kin_base global, made a parameter).
+ */
+export declare function summonSpecificOkay(table: SummonTable, type: number, race: MonsterRace, kinBase: MonsterBase | null): boolean;
+//# sourceMappingURL=summon.d.ts.map

package/dist/mon/summon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summon.d.ts","sourceRoot":"","sources":["../../src/mon/summon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvE,uDAAuD;AACvD,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,aAAa,EAAE,OAAO,CAAC;IACvB,iEAAiE;IACjE,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IAC9B,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC;gBAG5B,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC;IAmCzC,8DAA8D;IAC9D,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAO/B,4DAA4D;IAC5D,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIjC,4EAA4E;IAC5E,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIlC,sDAAsD;IACtD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAG3B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,WAAW,GAAG,IAAI,GAC1B,OAAO,CAuBT"}

package/dist/mon/summon.js

@@ -0,0 +1,111 @@
+/**
+ * Monster summon types, ported from reference/src/mon-summon.c (Angband
+ * 4.2.6): the summon table built from summon.txt (here the already-parsed
+ * summon.json records bound by bindMonsters) and the race-eligibility
+ * predicate summon_specific_okay.
+ *
+ * This module is the world-free half of mon-summon.c: the table lookups
+ * (summon_name_to_idx, summon_message_type, summon_fallback_type,
+ * summon_desc) and the "okay" test. The placement half (summon_specific,
+ * call_monster, select_shape) needs the live cave and lives in
+ * game/mon-place.ts.
+ *
+ * Divergences by design:
+ * - The upstream file-static summon_specific_type / kin_base globals become
+ *   explicit parameters (type is passed to okay(); the kin base is captured
+ *   by the caller from the summoner's race), so concurrent interpreters
+ *   cannot trample each other.
+ * - message_type stays the msgt NAME (sound/message channels ride #26/#25);
+ *   upstream resolves it to a message index at parse time.
+ */
+import { RF } from "../generated/index.js";
+/**
+ * The bound summon table (finish_parse_summon). Records bind in file order,
+ * matching the upstream reversed-linked-list copy, so a record's array
+ * position is its upstream summon index.
+ */
+export class SummonTable {
+    kinds;
+    constructor(records, bases) {
+        this.kinds = records.map((rec, index) => {
+            const bound = [];
+            for (const name of rec.baseNames) {
+                const base = bases.get(name);
+                if (!base)
+                    throw new Error(`summon: unknown monster base ${name}`);
+                bound.push(base);
+            }
+            let raceFlag = 0;
+            if (rec.raceFlag) {
+                const value = RF[rec.raceFlag];
+                if (value === undefined || value === 0) {
+                    throw new Error(`summon: bad race flag ${rec.raceFlag}`);
+                }
+                raceFlag = value;
+            }
+            return {
+                index,
+                name: rec.name,
+                messageType: rec.msgt,
+                uniqueAllowed: rec.uniquesAllowed,
+                bases: bound,
+                raceFlag,
+                fallback: -1,
+                desc: rec.desc,
+            };
+        });
+        /* Add indices of fallback summons (finish_parse_summon). */
+        for (let i = 0; i < this.kinds.length; i++) {
+            const name = records[i].fallbackName;
+            this.kinds[i].fallback = name ? this.nameToIdx(name) : -1;
+        }
+    }
+    /** summon_name_to_idx: the index for a summon name, or -1. */
+    nameToIdx(name) {
+        for (const kind of this.kinds) {
+            if (kind.name === name)
+                return kind.index;
+        }
+        return -1;
+    }
+    /** summon_message_type: the msgt name for a summon type. */
+    messageType(type) {
+        return this.kinds[type]?.messageType ?? "";
+    }
+    /** summon_fallback_type: the fallback index for a summon type (-1 none). */
+    fallbackType(type) {
+        return this.kinds[type]?.fallback ?? -1;
+    }
+    /** summon_desc: the description for a summon type. */
+    desc(type) {
+        return this.kinds[type]?.desc ?? "";
+    }
+}
+/**
+ * summon_specific_okay: whether a race may answer a summon of the given
+ * type. `kinBase` is the summoner's race base, read only by the KIN type
+ * (upstream's kin_base global, made a parameter).
+ */
+export function summonSpecificOkay(table, type, race, kinBase) {
+    const summon = table.kinds[type];
+    if (!summon)
+        return false;
+    const unique = race.flags.has(RF.UNIQUE);
+    /* Forbid uniques? */
+    if (!summon.uniqueAllowed && unique)
+        return false;
+    /* A valid base and no match means disallowed. */
+    if (summon.bases.length > 0 && !summon.bases.some((b) => b === race.base)) {
+        return false;
+    }
+    /* A valid race flag and no match means disallowed. */
+    if (summon.raceFlag && !race.flags.has(summon.raceFlag))
+        return false;
+    /* Special case - summon kin. */
+    if (type === table.nameToIdx("KIN")) {
+        return !unique && race.base === kinBase;
+    }
+    /* If we made it here, we're fine. */
+    return true;
+}
+//# sourceMappingURL=summon.js.map

package/dist/mon/summon.js.map

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

package/dist/mon/take-hit.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Applying damage to a monster, ported from reference/src/mon-util.c (Angband
+ * 4.2.6): mon_take_hit (L1264) and its helpers monster_wake (L686) and
+ * monster_scared_by_damage (L1137). This is the shared "a monster is hurt"
+ * primitive that projections (project_m), melee, ranged attacks, and the effect
+ * handlers all funnel damage through, so death, fear, and waking behave
+ * identically no matter what dealt the blow.
+ *
+ * The heavy player-facing consequences are injected as hooks so the damage /
+ * fear / wake logic ships and is tested independently of them:
+ * - onKill (player_kill_monster): experience, drops, death messages,
+ *   uniqueness, quest completion - a large routine ported with the effect /
+ *   command layer.
+ * - becomeAware (become_aware): revealing a camouflaged mimic - knowledge/UI.
+ * - coverTracksBroken: clearing the player's TMD_COVERTRACKS - player state.
+ *
+ * Deferred: the arena-level branch (arena mode is not modelled) and the
+ * PR_HEALTH redraw (a UI concern) are omitted; both are unreached by the ported
+ * callers.
+ */
+import type { Rng } from "../rng.js";
+import type { Monster } from "./monster.js";
+/**
+ * monster_wake (mon-util.c L686): clear a monster's sleep timer and, with the
+ * given percentage chance, mark it aware of the player. `notify` selects
+ * whether the sleep clear emits a waking-up message.
+ */
+export declare function monsterWake(rng: Rng, mon: Monster, notify: boolean, awareChance: number): void;
+/**
+ * monster_scared_by_damage (mon-util.c L1137): pain can reduce, cancel, or
+ * newly cause fear. Returns true only when the hit newly frightens the monster.
+ * Called after the monster's hp has already been reduced by `dam`.
+ * `primaryGroupSize` is monster_primary_group_size(cave, mon), threaded into
+ * monster_can_be_scared's per-member group fear save; game callers pass the
+ * live group size (game/mon-group.ts), worldless callers default to 1 (lone).
+ */
+export declare function monsterScaredByDamage(rng: Rng, mon: Monster, dam: number, primaryGroupSize?: number): boolean;
+/** The player-facing consequences of a hit, supplied by the caller. */
+export interface MonTakeHitHooks {
+    /** player_kill_monster: experience, drops, death messages, uniqueness. */
+    onKill?: (mon: Monster, note: string | null) => void;
+    /** become_aware: reveal a camouflaged mimic. */
+    becomeAware?: (mon: Monster) => void;
+    /** Clear the player's TMD_COVERTRACKS (a hit ends stealthy movement). */
+    coverTracksBroken?: () => void;
+    /**
+     * The arena branch (mon-util.c L1290): a lethal blow in single combat
+     * signals the level change instead of killing - the monster stays (at
+     * negative hp) until the arena exit finishes it. Passed by game
+     * callers while state.arenaLevel is set.
+     */
+    onArenaDeath?: (mon: Monster) => void;
+    /**
+     * monster_primary_group_size(cave, mon) for the fear roll's per-member
+     * group save (mon-predicate.c L296). Game callers pass the live size
+     * (game/mon-group.ts monsterPrimaryGroupSize); absent, 1 (a lone monster).
+     */
+    primaryGroupSize?: () => number;
+}
+/** The outcome of a hit: whether the monster died and whether it took fright. */
+export interface MonTakeHitResult {
+    /** The monster's hp reached below zero and it was killed. */
+    died: boolean;
+    /** The monster was newly frightened by the blow (meaningless if it died). */
+    fear: boolean;
+}
+/**
+ * mon_take_hit (mon-util.c L1264): inflict `dam` damage on a monster from the
+ * player. Wakes the monster and clears any Hold when the blow is non-fatal,
+ * reveals camouflaged mimics, then applies the damage - killing the monster (via
+ * the onKill hook) if its hp drops below zero, or rolling fear otherwise.
+ * Returns whether the monster died and whether it was newly frightened.
+ */
+export declare function monTakeHit(rng: Rng, mon: Monster, dam: number, note: string | null, hooks?: MonTakeHitHooks): MonTakeHitResult;
+//# sourceMappingURL=take-hit.d.ts.map

package/dist/mon/take-hit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"take-hit.d.ts","sourceRoot":"","sources":["../../src/mon/take-hit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAW5C;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,OAAO,EACf,WAAW,EAAE,MAAM,GAClB,IAAI,CAMN;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,MAAM,EACX,gBAAgB,SAAI,GACnB,OAAO,CA8CT;AAED,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC9B,0EAA0E;IAC1E,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACrD,gDAAgD;IAChD,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,MAAM,CAAC;CACjC;AAED,iFAAiF;AACjF,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,IAAI,EAAE,OAAO,CAAC;IACd,6EAA6E;IAC7E,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,KAAK,GAAE,eAAoB,GAC1B,gBAAgB,CAoClB"}

package/dist/mon/take-hit.js

@@ -0,0 +1,122 @@
+/**
+ * Applying damage to a monster, ported from reference/src/mon-util.c (Angband
+ * 4.2.6): mon_take_hit (L1264) and its helpers monster_wake (L686) and
+ * monster_scared_by_damage (L1137). This is the shared "a monster is hurt"
+ * primitive that projections (project_m), melee, ranged attacks, and the effect
+ * handlers all funnel damage through, so death, fear, and waking behave
+ * identically no matter what dealt the blow.
+ *
+ * The heavy player-facing consequences are injected as hooks so the damage /
+ * fear / wake logic ships and is tested independently of them:
+ * - onKill (player_kill_monster): experience, drops, death messages,
+ *   uniqueness, quest completion - a large routine ported with the effect /
+ *   command layer.
+ * - becomeAware (become_aware): revealing a camouflaged mimic - knowledge/UI.
+ * - coverTracksBroken: clearing the player's TMD_COVERTRACKS - player state.
+ *
+ * Deferred: the arena-level branch (arena mode is not modelled) and the
+ * PR_HEALTH redraw (a UI concern) are omitted; both are unreached by the ported
+ * callers.
+ */
+import { MON_TMD } from "../generated/index.js";
+import { MFLAG } from "../generated/index.js";
+import { monsterCanBeScared, monsterIsCamouflaged } from "./predicate.js";
+import { MON_TMD_FLG_NOFAIL, MON_TMD_FLG_NOMESSAGE, MON_TMD_FLG_NOTIFY, monClearTimed, monDecTimed, monIncTimed, } from "./timed.js";
+/**
+ * monster_wake (mon-util.c L686): clear a monster's sleep timer and, with the
+ * given percentage chance, mark it aware of the player. `notify` selects
+ * whether the sleep clear emits a waking-up message.
+ */
+export function monsterWake(rng, mon, notify, awareChance) {
+    const flag = notify ? MON_TMD_FLG_NOTIFY : MON_TMD_FLG_NOMESSAGE;
+    monClearTimed(rng, mon, MON_TMD.SLEEP, flag);
+    if (rng.randint0(100) < awareChance) {
+        mon.mflag.on(MFLAG.AWARE);
+    }
+}
+/**
+ * monster_scared_by_damage (mon-util.c L1137): pain can reduce, cancel, or
+ * newly cause fear. Returns true only when the hit newly frightens the monster.
+ * Called after the monster's hp has already been reduced by `dam`.
+ * `primaryGroupSize` is monster_primary_group_size(cave, mon), threaded into
+ * monster_can_be_scared's per-member group fear save; game callers pass the
+ * live group size (game/mon-group.ts), worldless callers default to 1 (lone).
+ */
+export function monsterScaredByDamage(rng, mon, dam, primaryGroupSize = 1) {
+    const currentFear = mon.mTimed[MON_TMD.FEAR];
+    /* Pain can reduce or cancel existing fear, or cause fear. */
+    if (currentFear) {
+        const tmp = rng.randint1(dam);
+        if (tmp < currentFear) {
+            /* Reduce fear. */
+            monDecTimed(rng, mon, MON_TMD.FEAR, tmp, MON_TMD_FLG_NOMESSAGE);
+        }
+        else {
+            /* Cure fear. */
+            monClearTimed(rng, mon, MON_TMD.FEAR, MON_TMD_FLG_NOMESSAGE);
+            return false;
+        }
+    }
+    else if (monsterCanBeScared(rng, mon, primaryGroupSize)) {
+        /* Percentage of fully healthy. */
+        const percentage = Math.floor((100 * mon.hp) / mon.maxhp);
+        /* Run (sometimes) at 10% or less of max hp... */
+        const lowHp = rng.randint1(10) >= percentage;
+        /* ...or (usually) when hit for half its current hit points. */
+        const bigHit = dam >= mon.hp && rng.randint0(100) < 80;
+        if (lowHp || bigHit) {
+            let time = rng.randint1(10);
+            if (dam >= mon.hp && percentage > 7) {
+                time += 20;
+            }
+            else {
+                time += (11 - percentage) * 5;
+            }
+            /* Note fear. */
+            monIncTimed(rng, mon, MON_TMD.FEAR, time, MON_TMD_FLG_NOMESSAGE | MON_TMD_FLG_NOFAIL);
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * mon_take_hit (mon-util.c L1264): inflict `dam` damage on a monster from the
+ * player. Wakes the monster and clears any Hold when the blow is non-fatal,
+ * reveals camouflaged mimics, then applies the damage - killing the monster (via
+ * the onKill hook) if its hp drops below zero, or rolling fear otherwise.
+ * Returns whether the monster died and whether it was newly frightened.
+ */
+export function monTakeHit(rng, mon, dam, note, hooks = {}) {
+    /* If the hit doesn't kill, wake it up and make it aware of the player. */
+    if (dam <= mon.hp) {
+        monsterWake(rng, mon, false, 100);
+        monClearTimed(rng, mon, MON_TMD.HOLD, MON_TMD_FLG_NOTIFY);
+    }
+    /* Become aware of its presence. */
+    if (monsterIsCamouflaged(mon)) {
+        hooks.becomeAware?.(mon);
+    }
+    /* No damage, we're done. */
+    if (dam === 0)
+        return { died: false, fear: false };
+    /* Covering tracks is no longer possible. */
+    hooks.coverTracksBroken?.();
+    /* Hurt it. */
+    mon.hp -= dam;
+    if (mon.hp < 0) {
+        /* Deal with arena monsters: the kill waits for the arena exit. */
+        if (hooks.onArenaDeath) {
+            hooks.onArenaDeath(mon);
+            return { died: true, fear: false };
+        }
+        /* It is dead now. */
+        hooks.onKill?.(mon, note);
+        return { died: true, fear: false };
+    }
+    /* Not dead yet; did it get frightened? */
+    return {
+        died: false,
+        fear: monsterScaredByDamage(rng, mon, dam, hooks.primaryGroupSize?.() ?? 1),
+    };
+}
+//# sourceMappingURL=take-hit.js.map

package/dist/mon/take-hit.js.map

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

package/dist/mon/timed.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Monster timed effects, ported from reference/src/mon-timed.c (Angband
+ * 4.2.6): the resist roll, mon_set_timed, and the inc/dec/clear wrappers that
+ * drive a monster's m_timed[] array (sleep, stun, confusion, fear, slow,
+ * haste, hold, disenchant, command, shapechange).
+ *
+ * The effect table (gets_save / stacking / resist flag / max timer / begin-
+ * end-increase messages) is the generated MON_TIMED_ENTRIES (from
+ * list-mon-timed.h). Two upstream couplings are handled as follows, both
+ * faithful in reachable states:
+ * - Messages: the monster-message queue (mon-msg.c add_monster_message) is not
+ *   ported, so mon_set_timed emits through an optional MonTimedMessageSink
+ *   instead. The decision of WHICH message fires (and its NOTIFY/NOMESSAGE/
+ *   visibility gate) is preserved exactly; callers that have a sink pass one.
+ * - MON_TMD_CHANGED shapechange (monster_change_shape / _revert_shape,
+ *   mon-util.c) is DEFERRED: the timer is still set, but the form is not
+ *   swapped. CHANGED is only set by an effect that is not ported yet, so this
+ *   path is currently unreachable.
+ *
+ * The lore learn on a flag-resist (lore_learn_flag_if_visible) and the
+ * health-bar / monster-list redraw (upkeep masks) are UI/lore concerns and are
+ * DEFERRED.
+ */
+import type { Rng } from "../rng.js";
+import type { Monster } from "./monster.js";
+import type { LoreStore } from "./lore.js";
+/** mon-timed.h flags. */
+export declare const MON_TMD_FLG_NOTIFY = 1;
+export declare const MON_TMD_FLG_NOMESSAGE = 4;
+export declare const MON_TMD_FLG_NOFAIL = 8;
+/**
+ * A sink for the monster message that mon_set_timed would queue. `note` is the
+ * MON_MSG_* name (or the synthetic "MON_MSG_UNAFFECTED" / "MON_MSG_SHAPE_FAIL")
+ * upstream would pass to add_monster_message; `add` mirrors its 3rd argument.
+ */
+/**
+ * monster_change_shape / monster_revert_shape (game/mon-shape.ts), passed
+ * by the game-layer timed calls for MON_TMD_CHANGED.
+ */
+export interface MonShapeHooks {
+    change: (mon: Monster) => boolean;
+    revert: (mon: Monster) => boolean;
+}
+export type MonTimedMessageSink = (mon: Monster, note: string, add: boolean) => void;
+/**
+ * mon_timed_name_to_idx: the MON_TMD_ index for an effect name, or -1.
+ */
+export declare function monTimedNameToIdx(name: string): number;
+/** Register the lore store learning timed-resist flags for this rng/session. */
+export declare function installMonTimedLore(rng: Rng, lore: LoreStore): void;
+/**
+ * mon_set_timed: set effect `effectType`'s timer to `timer`, honouring
+ * resistance, the begin/end/increase message selection, and the COMMAND-expiry
+ * and CHANGED special cases. Returns true if the monster was affected.
+ */
+export declare function monSetTimed(rng: Rng, mon: Monster, effectType: number, timer: number, flag?: number, onMessage?: MonTimedMessageSink, shape?: MonShapeHooks): boolean;
+/**
+ * mon_inc_timed: raise effect `effectType` by `timer` (min 2 turns for a new
+ * effect), stacking per the effect's rule, then mon_set_timed.
+ */
+export declare function monIncTimed(rng: Rng, mon: Monster, effectType: number, timer: number, flag?: number, onMessage?: MonTimedMessageSink, shape?: MonShapeHooks): boolean;
+/**
+ * mon_dec_timed: lower effect `effectType` by `timer` (never below 0). A
+ * decrease never fails.
+ */
+export declare function monDecTimed(rng: Rng, mon: Monster, effectType: number, timer: number, flag?: number, onMessage?: MonTimedMessageSink, shape?: MonShapeHooks): boolean;
+/** mon_clear_timed: clear effect `effectType` (no-op if already 0). */
+export declare function monClearTimed(rng: Rng, mon: Monster, effectType: number, flag?: number, onMessage?: MonTimedMessageSink, shape?: MonShapeHooks): boolean;
+/**
+ * monster_effect_level: the 0 (unaffected) .. 5 (max) intensity band an effect
+ * is currently at for the monster.
+ */
+export declare function monsterEffectLevel(mon: Monster, effectType: number): number;
+//# sourceMappingURL=timed.d.ts.map

package/dist/mon/timed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timed.d.ts","sourceRoot":"","sources":["../../src/mon/timed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAGrC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAG3C,yBAAyB;AACzB,eAAO,MAAM,kBAAkB,IAAO,CAAC;AACvC,eAAO,MAAM,qBAAqB,IAAO,CAAC;AAC1C,eAAO,MAAM,kBAAkB,IAAO,CAAC;AAKvC;;;;GAIG;AACH;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;IAClC,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;CACnC;AAED,MAAM,MAAM,mBAAmB,GAAG,CAChC,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,OAAO,KACT,IAAI,CAAC;AAUV;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKtD;AAuBD,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAEnE;AA+BD;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,OAAO,EACZ,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,IAAI,SAAI,EACR,SAAS,CAAC,EAAE,mBAAmB,EAC/B,KAAK,CAAC,EAAE,aAAa,GACpB,OAAO,CA0ET;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,OAAO,EACZ,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,IAAI,SAAI,EACR,SAAS,CAAC,EAAE,mBAAmB,EAC/B,KAAK,CAAC,EAAE,aAAa,GACpB,OAAO,CAsBT;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,OAAO,EACZ,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,IAAI,SAAI,EACR,SAAS,CAAC,EAAE,mBAAmB,EAC/B,KAAK,CAAC,EAAE,aAAa,GACpB,OAAO,CAGT;AAED,uEAAuE;AACvE,wBAAgB,aAAa,CAC3B,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,OAAO,EACZ,UAAU,EAAE,MAAM,EAClB,IAAI,SAAI,EACR,SAAS,CAAC,EAAE,mBAAmB,EAC/B,KAAK,CAAC,EAAE,aAAa,GACpB,OAAO,CAGT;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAO3E"}