@rpgm-tools/neo-angband-core 0.10.0

package/dist/game/effect-mon-origin.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Shared monster-origin sub-branches for the effect / projection layer, ported
+ * from reference/src (Angband 4.2.6). These are the "a monster cast this"
+ * refinements that several handlers share: resolving the monster a caster is
+ * really aiming at (monster_target_monster), the confused-direction /
+ * target-monster / decoy target selection (get_target's SRC_MONSTER branch,
+ * effect-handler-attack.c L38), the decoy predicate and destruction
+ * (mon-predicate.c L308, cave-square.c square_destroy_decoy), and the
+ * monster-vs-monster damage primitive (mon-util.c L1193 mon_take_nonplayer_hit).
+ *
+ * They live in game/ (not mon/) because they mutate GameState and reuse the
+ * cast-context consequence hooks (drops / messages), the same seam discipline
+ * as the project_m / project_p drivers. mon/ exports (monsterWake,
+ * monsterScaredByDamage, monsterEffectLevel, the predicates) are called, never
+ * edited.
+ */
+import type { Loc } from "../loc.js";
+import type { Rng } from "../rng.js";
+import type { Monster } from "../mon/monster.js";
+import type { GameState } from "./context.js";
+import type { GameEffectEnv } from "./effect-game-env.js";
+import type { TrapDeps } from "./trap.js";
+/**
+ * CONF_RANDOM_CHANCE (mon-timed.h L31): the percentage chance, per confusion
+ * level, that an aimed monster spell goes in a random direction instead.
+ */
+export declare const CONF_RANDOM_CHANCE = 40;
+/**
+ * monster_target_monster (effect-handler-general.c L96): the monster the
+ * casting monster is targeting, or null. Only a SRC_MONSTER origin whose
+ * caster has a positive target.midx targets another monster.
+ */
+export declare function monsterTargetMonster(state: GameState, casterMidx: number): Monster | null;
+/** cave_find_decoy (cave.c L719): the player's active decoy grid, or null. */
+export declare function caveFindDecoy(state: GameState): Loc | null;
+/**
+ * monster_is_decoyed (mon-predicate.c L308): whether a live decoy exists that
+ * the monster can see.
+ */
+export declare function monsterIsDecoyed(state: GameState, mon: Monster): boolean;
+/**
+ * square_destroy_decoy (cave-square.c): remove the decoy trap at the decoy
+ * grid, clear cave->decoy, and announce it if the player can see it. trapDeps
+ * supplies the "decoy" trap kind (only its tidx removal differs from a bare
+ * clear); absent, the grid state is still cleared.
+ */
+export declare function destroyDecoy(state: GameState, trapDeps: TrapDeps | undefined, msg?: (text: string) => void): void;
+/**
+ * get_target's SRC_MONSTER branch (effect-handler-attack.c L38): resolve the
+ * grid a monster's aimed spell/projection strikes. Confusion may send it in a
+ * random direction (one randint1(100) draw is always made, matching the
+ * upstream RNG stream for every monster-aimed projection); otherwise it aims
+ * at a targeted monster, the decoy, or the player, in that order.
+ */
+export declare function monsterGetTarget(state: GameState, rng: Rng, casterMidx: number): Loc;
+/**
+ * mon_take_nonplayer_hit (mon-util.c L1193): apply `dam` to a monster from a
+ * non-player source (another monster's spell, an EF_DAMAGE monster origin).
+ * Uniques and arena monsters are reduced to but never killed by it. Death runs
+ * the shape revert, death message and drops through the cast-context monster
+ * hooks (the same ones project_m uses), then deletes the monster; a survivor
+ * shows a pain/hurt message and may take fright (the fear roll is made, but the
+ * EF_DAMAGE caller preserves the upstream quirk of not announcing it). Returns
+ * whether the monster died.
+ */
+export declare function monTakeNonplayerHit(env: GameEffectEnv, tMon: Monster, dam: number, hurtMsg?: number, dieMsg?: number): boolean;
+//# sourceMappingURL=effect-mon-origin.d.ts.map

package/dist/game/effect-mon-origin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-mon-origin.d.ts","sourceRoot":"","sources":["../../src/game/effect-mon-origin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAWjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C;;;GAGG;AACH,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,GAAG,IAAI,CAOhB;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,GAAG,GAAG,IAAI,CAI1D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAIxE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAC9B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC3B,IAAI,CAUN;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,GAAG,EACR,UAAU,EAAE,MAAM,GACjB,GAAG,CA0BL;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,MAAqB,EAC9B,MAAM,GAAE,MAAoB,GAC3B,OAAO,CAyCT"}

package/dist/game/effect-mon-origin.js

@@ -0,0 +1,164 @@
+/**
+ * Shared monster-origin sub-branches for the effect / projection layer, ported
+ * from reference/src (Angband 4.2.6). These are the "a monster cast this"
+ * refinements that several handlers share: resolving the monster a caster is
+ * really aiming at (monster_target_monster), the confused-direction /
+ * target-monster / decoy target selection (get_target's SRC_MONSTER branch,
+ * effect-handler-attack.c L38), the decoy predicate and destruction
+ * (mon-predicate.c L308, cave-square.c square_destroy_decoy), and the
+ * monster-vs-monster damage primitive (mon-util.c L1193 mon_take_nonplayer_hit).
+ *
+ * They live in game/ (not mon/) because they mutate GameState and reuse the
+ * cast-context consequence hooks (drops / messages), the same seam discipline
+ * as the project_m / project_p drivers. mon/ exports (monsterWake,
+ * monsterScaredByDamage, monsterEffectLevel, the predicates) are called, never
+ * edited.
+ */
+import { MON_MSG, MON_TMD, TMD } from "../generated/index.js";
+import { DDGRID, loc, locIsZero, locSum } from "../loc.js";
+import { monsterIsCamouflaged, monsterIsUnique, monsterIsVisible, } from "../mon/predicate.js";
+import { monsterEffectLevel } from "../mon/timed.js";
+import { monsterScaredByDamage, monsterWake } from "../mon/take-hit.js";
+import { los } from "../world/view.js";
+import { lookupTrap } from "../world/trap.js";
+import { deleteMonster } from "./context.js";
+import { squareRemoveAllTraps } from "./trap.js";
+/**
+ * CONF_RANDOM_CHANCE (mon-timed.h L31): the percentage chance, per confusion
+ * level, that an aimed monster spell goes in a random direction instead.
+ */
+export const CONF_RANDOM_CHANCE = 40;
+/**
+ * monster_target_monster (effect-handler-general.c L96): the monster the
+ * casting monster is targeting, or null. Only a SRC_MONSTER origin whose
+ * caster has a positive target.midx targets another monster.
+ */
+export function monsterTargetMonster(state, casterMidx) {
+    const mon = state.monsters[casterMidx];
+    if (!mon)
+        return null;
+    if (mon.target.midx > 0) {
+        return state.monsters[mon.target.midx] ?? null;
+    }
+    return null;
+}
+/** cave_find_decoy (cave.c L719): the player's active decoy grid, or null. */
+export function caveFindDecoy(state) {
+    const decoy = state.decoy ?? null;
+    if (!decoy || locIsZero(decoy))
+        return null;
+    return decoy;
+}
+/**
+ * monster_is_decoyed (mon-predicate.c L308): whether a live decoy exists that
+ * the monster can see.
+ */
+export function monsterIsDecoyed(state, mon) {
+    const decoy = caveFindDecoy(state);
+    if (!decoy)
+        return false;
+    return los(state.chunk, mon.grid, decoy);
+}
+/**
+ * square_destroy_decoy (cave-square.c): remove the decoy trap at the decoy
+ * grid, clear cave->decoy, and announce it if the player can see it. trapDeps
+ * supplies the "decoy" trap kind (only its tidx removal differs from a bare
+ * clear); absent, the grid state is still cleared.
+ */
+export function destroyDecoy(state, trapDeps, msg) {
+    const decoy = caveFindDecoy(state);
+    if (!decoy)
+        return;
+    const decoyKind = trapDeps ? lookupTrap(trapDeps.kinds, "decoy") : null;
+    squareRemoveAllTraps(state, decoy, decoyKind ? decoyKind.tidx : -1);
+    state.decoy = null;
+    const blind = (state.actor.player.timed[TMD.BLIND] ?? 0) > 0;
+    if (msg && los(state.chunk, state.actor.grid, decoy) && !blind) {
+        msg("The decoy is destroyed!");
+    }
+}
+/**
+ * get_target's SRC_MONSTER branch (effect-handler-attack.c L38): resolve the
+ * grid a monster's aimed spell/projection strikes. Confusion may send it in a
+ * random direction (one randint1(100) draw is always made, matching the
+ * upstream RNG stream for every monster-aimed projection); otherwise it aims
+ * at a targeted monster, the decoy, or the player, in that order.
+ */
+export function monsterGetTarget(state, rng, casterMidx) {
+    const mon = state.monsters[casterMidx];
+    /* Upstream breaks out to the caller's default (player grid) with no draw
+     * when the monster is gone; keep that. */
+    if (!mon)
+        return state.actor.grid;
+    let accuracy = 100;
+    let confLevel = monsterEffectLevel(mon, MON_TMD.CONF);
+    while (confLevel) {
+        accuracy = Math.trunc((accuracy * (100 - CONF_RANDOM_CHANCE)) / 100);
+        confLevel--;
+    }
+    if (rng.randint1(100) > accuracy) {
+        const dir = rng.randint1(9);
+        return locSum(mon.grid, DDGRID[dir] ?? loc(0, 0));
+    }
+    if (mon.target.midx > 0) {
+        const tMon = state.monsters[mon.target.midx];
+        if (tMon)
+            return tMon.grid;
+    }
+    if (monsterIsDecoyed(state, mon)) {
+        const decoy = caveFindDecoy(state);
+        if (decoy)
+            return decoy;
+    }
+    return state.actor.grid;
+}
+/**
+ * mon_take_nonplayer_hit (mon-util.c L1193): apply `dam` to a monster from a
+ * non-player source (another monster's spell, an EF_DAMAGE monster origin).
+ * Uniques and arena monsters are reduced to but never killed by it. Death runs
+ * the shape revert, death message and drops through the cast-context monster
+ * hooks (the same ones project_m uses), then deletes the monster; a survivor
+ * shows a pain/hurt message and may take fright (the fear roll is made, but the
+ * EF_DAMAGE caller preserves the upstream quirk of not announcing it). Returns
+ * whether the monster died.
+ */
+export function monTakeNonplayerHit(env, tMon, dam, hurtMsg = MON_MSG.NONE, dieMsg = MON_MSG.DIE) {
+    const { state } = env;
+    const rng = state.rng;
+    const hooks = env.cast.hooks?.monster;
+    /* "Unique" or arena monsters can only be "killed" by the player. */
+    if (monsterIsUnique(tMon) || state.arenaLevel) {
+        if (dam > tMon.hp)
+            dam = tMon.hp;
+    }
+    /* Wake the monster up, doesn't become aware of the player. */
+    monsterWake(rng, tMon, false, 0);
+    /* Hurt the monster. */
+    tMon.hp -= dam;
+    if (tMon.hp < 0) {
+        /* Shapechanged monsters revert on death. */
+        if (tMon.originalRace)
+            hooks?.revertShape?.(tMon);
+        if (monsterIsVisible(tMon))
+            hooks?.message?.(tMon, dieMsg, false);
+        /* Generate treasure, etc. (monster_death; removal done here). */
+        hooks?.onMonsterDeath?.(tMon);
+        deleteMonster(state, tMon.midx);
+        return true;
+    }
+    if (!monsterIsCamouflaged(tMon)) {
+        if (hurtMsg !== MON_MSG.NONE) {
+            hooks?.message?.(tMon, hurtMsg, false);
+        }
+        else if (dam > 0) {
+            hooks?.messagePain?.(tMon, dam);
+        }
+    }
+    /* Sometimes a monster gets scared by damage (roll preserved even though the
+     * EF_DAMAGE caller does not announce the resulting fear). */
+    if (!tMon.mTimed[MON_TMD.FEAR] && dam > 0) {
+        monsterScaredByDamage(rng, tMon, dam);
+    }
+    return false;
+}
+//# sourceMappingURL=effect-mon-origin.js.map

package/dist/game/effect-mon-origin.js.map

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

package/dist/game/effect-monster.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Monster-targeting general effect handlers, ported from
+ * reference/src/effect-handler-general.c (Angband 4.2.6): EF_WAKE (L2205),
+ * EF_BANISH (L2337) and EF_MASS_BANISH (L2401), plus the monster self-heal
+ * family from effect-handler-attack.c: EF_MON_HEAL_HP (L254) and
+ * EF_MON_HEAL_KIN (L311, healing a nearby injured same-base monster found
+ * by choose_nearby_injured_kin's reservoir sample). Each touches the live
+ * monsters, so like the attack handlers they live in game/ and are registered
+ * into the EffectRegistry from here (registerMonsterHandlers), overriding the
+ * NOT_IMPLEMENTED stubs. They read their game environment from
+ * context.env.game (effect-game-env.ts) and no-op when it is absent.
+ *
+ * All the primitives they need are already ported: monster iteration and
+ * removal (game/context.ts monsterMax / deleteMonster), waking (mon/take-hit.ts
+ * monsterWake), the uniqueness test (mon/predicate.ts monsterIsUnique) and the
+ * shared player-damage primitive (player/take-hit.ts). The banish symbol prompt
+ * (get_com) is an injected chooser on the game env; absent, EF_BANISH aborts,
+ * mirroring a cancelled prompt. The arena-level guard is omitted (arenas are
+ * not modelled).
+ */
+import type { EffectRegistry } from "../effects/interpreter.js";
+/**
+ * Register the monster-targeting general effect handlers, overriding the stubs
+ * registerCoreHandlers installed. Call after registerCoreHandlers.
+ */
+export declare function registerMonsterHandlers(registry: EffectRegistry): void;
+/** The monster-effect EF codes this module registers. */
+export declare const MONSTER_HANDLER_CODES: readonly number[];
+//# sourceMappingURL=effect-monster.d.ts.map

package/dist/game/effect-monster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-monster.d.ts","sourceRoot":"","sources":["../../src/game/effect-monster.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAQH,OAAO,KAAK,EAGV,cAAc,EACf,MAAM,2BAA2B,CAAC;AAyQnC;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAItE;AAED,yDAAyD;AACzD,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAElD,CAAC"}

package/dist/game/effect-monster.js

@@ -0,0 +1,281 @@
+/**
+ * Monster-targeting general effect handlers, ported from
+ * reference/src/effect-handler-general.c (Angband 4.2.6): EF_WAKE (L2205),
+ * EF_BANISH (L2337) and EF_MASS_BANISH (L2401), plus the monster self-heal
+ * family from effect-handler-attack.c: EF_MON_HEAL_HP (L254) and
+ * EF_MON_HEAL_KIN (L311, healing a nearby injured same-base monster found
+ * by choose_nearby_injured_kin's reservoir sample). Each touches the live
+ * monsters, so like the attack handlers they live in game/ and are registered
+ * into the EffectRegistry from here (registerMonsterHandlers), overriding the
+ * NOT_IMPLEMENTED stubs. They read their game environment from
+ * context.env.game (effect-game-env.ts) and no-op when it is absent.
+ *
+ * All the primitives they need are already ported: monster iteration and
+ * removal (game/context.ts monsterMax / deleteMonster), waking (mon/take-hit.ts
+ * monsterWake), the uniqueness test (mon/predicate.ts monsterIsUnique) and the
+ * shared player-damage primitive (player/take-hit.ts). The banish symbol prompt
+ * (get_com) is an injected chooser on the game env; absent, EF_BANISH aborts,
+ * mirroring a cancelled prompt. The arena-level guard is omitted (arenas are
+ * not modelled).
+ */
+import { EF, MON_TMD, TMD } from "../generated/index.js";
+import { distance, loc, locEq } from "../loc.js";
+import { monsterIsUnique, monsterIsVisible } from "../mon/predicate.js";
+import { monsterWake } from "../mon/take-hit.js";
+import { MON_TMD_FLG_NOMESSAGE, monClearTimed } from "../mon/timed.js";
+import { effectCalculateValue } from "../effects/interpreter.js";
+import { playerApplyDamageReduction, takeHit, } from "../player/take-hit.js";
+import { los } from "../world/view.js";
+import { deleteMonster, monsterMax } from "./context.js";
+import { gameEnv } from "./effect-game-env.js";
+/** take_hit through the player-projection actor, with the show-damage message. */
+function hurtPlayer(ctx, env, dam, killer) {
+    const actor = env.cast.playerActor;
+    const reduced = playerApplyDamageReduction(actor, actor.reduction, dam);
+    if (reduced > 0 && ctx.env.showDamage) {
+        ctx.env.messages?.msg(`You take ${reduced} damage.`);
+    }
+    takeHit(actor, reduced, killer, env.takeHitHooks);
+}
+/** EF_WAKE: wake every sleeping monster near the effect origin. */
+const handleWAKE = (ctx) => {
+    const env = gameEnv(ctx);
+    if (!env)
+        return true;
+    const { state } = env;
+    /* origin_get_loc: a monster source wakes from its own grid. */
+    const origin = ctx.origin.what === "monster"
+        ? (state.monsters[ctx.origin.monster]?.grid ?? state.actor.grid)
+        : state.actor.grid;
+    const radius = state.z.maxSight * 2;
+    let woken = false;
+    const max = monsterMax(state);
+    for (let i = 1; i < max; i++) {
+        const mon = state.monsters[i];
+        if (!mon)
+            continue;
+        const dist = distance(origin, mon.grid);
+        if (dist < radius && mon.mTimed[0] > 0) {
+            /* MON_TMD.SLEEP: closer means likelier to become aware. */
+            monsterWake(state.rng, mon, false, 100 - 2 * dist);
+            woken = true;
+        }
+    }
+    if (woken)
+        ctx.env.messages?.msg("You hear a sudden stirring in the distance!");
+    ctx.ident = true;
+    return true;
+};
+/**
+ * EF_BANISH: delete all non-unique monsters whose display glyph matches a
+ * player-chosen symbol, costing the player 1d4 hitpoints per monster. Returns
+ * false (aborting the effect) when no symbol is chosen.
+ */
+const handleBANISH = (ctx) => {
+    const env = gameEnv(ctx);
+    if (!env)
+        return true;
+    ctx.ident = true;
+    /* Don't allow in an arena. */
+    if (env.state.arenaLevel) {
+        ctx.env.messages?.msg("Nothing happens.");
+        return true;
+    }
+    const typ = env.banishSymbol ? env.banishSymbol() : null;
+    if (typ === null)
+        return false;
+    const { state } = env;
+    let dam = 0;
+    const max = monsterMax(state);
+    for (let i = 1; i < max; i++) {
+        const mon = state.monsters[i];
+        if (!mon)
+            continue;
+        if (monsterIsUnique(mon))
+            continue;
+        /* Shape-shifters banish by their original race's glyph. */
+        const glyph = (mon.originalRace ?? mon.race).dChar;
+        if (glyph !== typ)
+            continue;
+        deleteMonster(state, i);
+        dam += state.rng.randint1(4);
+    }
+    hurtPlayer(ctx, env, dam, "the strain of casting Banishment");
+    return true;
+};
+/**
+ * EF_MASS_BANISH: delete all nearby non-unique monsters (within context->radius,
+ * else the player's sight radius), costing the player 1d3 hitpoints per monster.
+ */
+const handleMASS_BANISH = (ctx) => {
+    const env = gameEnv(ctx);
+    if (!env)
+        return true;
+    ctx.ident = true;
+    const { state } = env;
+    /* Don't allow in an arena. */
+    if (state.arenaLevel) {
+        ctx.env.messages?.msg("Nothing happens.");
+        return true;
+    }
+    const radius = ctx.radius ? ctx.radius : state.z.maxSight;
+    let dam = 0;
+    const max = monsterMax(state);
+    for (let i = 1; i < max; i++) {
+        const mon = state.monsters[i];
+        if (!mon)
+            continue;
+        if (monsterIsUnique(mon))
+            continue;
+        if (mon.cdis > radius)
+            continue;
+        deleteMonster(state, i);
+        dam += state.rng.randint1(3);
+    }
+    hurtPlayer(ctx, env, dam, "the strain of casting Mass Banishment");
+    return true;
+};
+/**
+ * The heal-and-cancel-fear tail shared by MON_HEAL_HP and MON_HEAL_KIN
+ * (effect-handler-attack.c L275-299 / L336-354). The MDESC name rides the
+ * display layer, so the race name stands in.
+ *
+ * NOT shared: the messages. Upstream's two handlers look near-identical and
+ * differ in exactly two places, both of which a shared body loses --
+ * MON_HEAL_HP has "sounds ..." variants for an unseen monster (L282-290) while
+ * MON_HEAL_KIN wraps BOTH of its messages in `if (seen)` (L338-344) and says
+ * nothing at all when the kin is not seen. Hence `unseenMsg`.
+ */
+function healMonster(ctx, env, mon, amount, unseenMsg) {
+    const { state } = env;
+    const blind = (env.cast.playerActor.timed[TMD.BLIND] ?? 0) > 0;
+    const seen = !blind && monsterIsVisible(mon);
+    const name = mon.race.name;
+    /* Heal some */
+    mon.hp += amount;
+    if (mon.hp >= mon.maxhp) {
+        mon.hp = mon.maxhp;
+        if (seen) {
+            ctx.env.messages?.msg(`${name} looks REALLY healthy!`);
+        }
+        else if (unseenMsg) {
+            ctx.env.messages?.msg(`${name} sounds REALLY healthy!`);
+        }
+    }
+    else if (seen) {
+        ctx.env.messages?.msg(`${name} looks healthier.`);
+    }
+    else if (unseenMsg) {
+        ctx.env.messages?.msg(`${name} sounds healthier.`);
+    }
+    /* Cancel fear */
+    if ((mon.mTimed[MON_TMD.FEAR] ?? 0) > 0) {
+        monClearTimed(state.rng, mon, MON_TMD.FEAR, MON_TMD_FLG_NOMESSAGE);
+        ctx.env.messages?.msg(`${name} recovers its courage.`);
+    }
+    ctx.ident = true;
+}
+/** EF_MON_HEAL_HP: the casting monster heals itself. */
+const handleMON_HEAL_HP = (ctx) => {
+    const env = gameEnv(ctx);
+    if (!env)
+        return true;
+    if (ctx.origin.what !== "monster")
+        return true;
+    const mon = env.state.monsters[ctx.origin.monster];
+    /* The value is computed BEFORE the null-monster guard (L261 precedes L265),
+     * so a midx that resolves to no monster still consumes the dice draws. Keep
+     * the order: it is the stream the C produces. */
+    const amount = effectCalculateValue(ctx, false);
+    if (!mon)
+        return true;
+    healMonster(ctx, env, mon, amount, true);
+    return true;
+};
+/**
+ * choose_nearby_injured_kin (mon-util.c L907): one injured same-base monster
+ * in LOS within MAX_KIN_RADIUS/DISTANCE (both 5) of the caster, chosen by
+ * reservoir sampling with k = 1 (RNG draws as upstream).
+ */
+function chooseNearbyInjuredKin(state, mon) {
+    const KIN_RANGE = 5; /* MAX_KIN_RADIUS == MAX_KIN_DISTANCE == 5 */
+    let nseen = 0;
+    let found = null;
+    for (let y = mon.grid.y - KIN_RANGE; y <= mon.grid.y + KIN_RANGE; y++) {
+        for (let x = mon.grid.x - KIN_RANGE; x <= mon.grid.x + KIN_RANGE; x++) {
+            const grid = loc(x, y);
+            /* get_injured_kin: not itself, same base, LOS, injured, in range. */
+            if (!state.chunk.inBounds(grid))
+                continue;
+            if (locEq(grid, mon.grid))
+                continue;
+            const midx = state.chunk.mon(grid);
+            if (midx <= 0)
+                continue;
+            const kin = state.monsters[midx];
+            if (!kin)
+                continue;
+            if (kin.race.base !== mon.race.base)
+                continue;
+            if (!los(state.chunk, mon.grid, grid))
+                continue;
+            if (kin.hp === kin.maxhp)
+                continue;
+            if (distance(mon.grid, grid) > KIN_RANGE)
+                continue;
+            nseen++;
+            if (state.rng.randint0(nseen) === 0)
+                found = kin;
+        }
+    }
+    return found;
+}
+/** EF_MON_HEAL_KIN: the casting monster heals a nearby injured kin. */
+const handleMON_HEAL_KIN = (ctx) => {
+    const env = gameEnv(ctx);
+    if (!env)
+        return true;
+    if (ctx.origin.what !== "monster")
+        return true;
+    const caster = env.state.monsters[ctx.origin.monster];
+    if (!caster)
+        return true;
+    /* The value is rolled BEFORE the kin search (L319 precedes L324), and
+     * choose_nearby_injured_kin draws one randint0 per candidate, so computing it
+     * afterwards swaps two draw groups and desynchronises the stream. */
+    const amount = effectCalculateValue(ctx, false);
+    /* Find a nearby injured monster of the same base. */
+    const kin = chooseNearbyInjuredKin(env.state, caster);
+    if (!kin)
+        return true;
+    /* No unseen message: L338-344 wraps both messages in `if (seen)`, unlike
+     * MON_HEAL_HP. */
+    healMonster(ctx, env, kin, amount, false);
+    return true;
+};
+/** The monster-effect handlers, keyed by upstream EF code. */
+const MONSTER_HANDLERS = new Map([
+    [EF.WAKE, handleWAKE],
+    /* effect_handler_BANISH (effect-handler-general.c:2337) */
+    [EF.BANISH, handleBANISH],
+    /* effect_handler_MASS_BANISH (effect-handler-general.c:2401) */
+    [EF.MASS_BANISH, handleMASS_BANISH],
+    /* effect_handler_MON_HEAL_HP (effect-handler-attack.c:254) */
+    [EF.MON_HEAL_HP, handleMON_HEAL_HP],
+    /* effect_handler_MON_HEAL_KIN (effect-handler-attack.c:311) */
+    [EF.MON_HEAL_KIN, handleMON_HEAL_KIN],
+]);
+/**
+ * Register the monster-targeting general effect handlers, overriding the stubs
+ * registerCoreHandlers installed. Call after registerCoreHandlers.
+ */
+export function registerMonsterHandlers(registry) {
+    for (const [code, handler] of MONSTER_HANDLERS) {
+        registry.register(code, { handler, status: "implemented" });
+    }
+}
+/** The monster-effect EF codes this module registers. */
+export const MONSTER_HANDLER_CODES = [
+    ...MONSTER_HANDLERS.keys(),
+];
+//# sourceMappingURL=effect-monster.js.map

package/dist/game/effect-monster.js.map

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

package/dist/game/effect-summon.d.ts

@@ -0,0 +1,37 @@
+/**
+ * EF_SUMMON, ported from reference/src/effect-handler-general.c
+ * effect_handler_SUMMON (L2241, Angband 4.2.6), over the live summoning
+ * engine (game/mon-place.ts summonSpecific and the mon/summon.ts table).
+ *
+ * A monster-origin summon keeps calling until the summoned levels' squares
+ * pass depth * rlev or the attempts run out, falling back to the type's
+ * fallback on total failure ("But nothing comes." when even that fails); a
+ * player-origin summon (scroll / staff / trap) simply rolls `value` times,
+ * delayed so the player acts first, each with a 1-in-4 chance of calling an
+ * off-screen monster instead of creating one. The blind player hears
+ * something (or many things) appear nearby.
+ *
+ * Like the other game-layer handlers it reads context.env.game and no-ops
+ * without it; it additionally needs the summon seam (GameEffectEnv.summon)
+ * for the bound table and allocation deps, without which it also no-ops.
+ * The arena-level guard is omitted (arenas are not modelled); sound(msgt)
+ * rides the sound system (#26).
+ */
+import type { EffectRegistry } from "../effects/interpreter.js";
+import type { SummonTable } from "../mon/summon.js";
+import type { MonPlaceDeps } from "./mon-place.js";
+/** The summoning seam on the game effect environment. */
+export interface SummonEffectEnv {
+    /** The bound summon table (mon/summon.ts). */
+    summons: SummonTable;
+    /** Live placement deps (allocation table, trap predicates, group caps). */
+    place: MonPlaceDeps;
+}
+/**
+ * Register the summoning handler, overriding the stub registerCoreHandlers
+ * installed. Call after registerCoreHandlers.
+ */
+export declare function registerSummonHandlers(registry: EffectRegistry): void;
+/** The EF codes this module registers. */
+export declare const SUMMON_HANDLER_CODES: readonly number[];
+//# sourceMappingURL=effect-summon.d.ts.map

package/dist/game/effect-summon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-summon.d.ts","sourceRoot":"","sources":["../../src/game/effect-summon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAEV,cAAc,EACf,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,gBAAgB,CAAC;AAG/D,yDAAyD;AACzD,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,OAAO,EAAE,WAAW,CAAC;IACrB,2EAA2E;IAC3E,KAAK,EAAE,YAAY,CAAC;CACrB;AAkHD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAErE;AAED,0CAA0C;AAC1C,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAAgB,CAAC"}