@rpgm-tools/neo-angband-core 0.10.0

package/dist/mon/make.js

@@ -0,0 +1,353 @@
+/**
+ * Monster allocation and creation, ported from reference/src/mon-make.c
+ * (Angband 4.2.6).
+ *
+ * Ported here: the race allocation table (init_race_allocs), restriction
+ * hooks (get_mon_num_prep), depth-ruled picking (get_mon_num), hp
+ * calculation (mon_hp), and the monster-instance construction half of
+ * place_new_monster_one. Actual placement into a chunk (square checks,
+ * level rating, drops, mimicked objects, groups/friends spawning) is
+ * deferred to the world integration; see parity/ledger/mon-make.yaml.
+ *
+ * Upstream notes preserved:
+ * - Town monsters (level 0) are only picked when generated_level is 0,
+ *   and never in the dungeon; dungeon monsters never appear in town
+ *   because entries above generated_level are cut off.
+ * - get_mon_num boosts generated_level 1 time in ood_monster_chance by
+ *   min(level / 4 + 2, ood_monster_amount), then rerolls for a deeper
+ *   race once at 60 percent or twice at 10 percent.
+ * - SEASONAL races only allocate around Christmas; this port takes that
+ *   as an option instead of reading the wall clock.
+ * - Uniques allocate only while cur_num < max_num; FORCE_DEPTH races
+ *   never allocate above their native depth (checked against the level
+ *   the monster is placed on, not the generation level).
+ */
+import { ORIGIN, RF } from "../generated/index.js";
+import { MON_TMD } from "../generated/index.js";
+import { MON_GROUP } from "./types.js";
+import { blankMonster, GROUP_TYPE, turnEnergy } from "./monster.js";
+import { MFLAG } from "../generated/index.js";
+import { objectAbsorb, objectMergeable, OSTACK_MONSTER } from "../obj/object.js";
+// z-color.h:78: ATTR_RAND rolls use the shared basic-colour count.
+import { BASIC_COLORS } from "../color.js";
+/**
+ * The monster allocation table (init_race_allocs + get_mon_num_prep +
+ * get_mon_num). Races are grouped by level ascending, stable by ridx,
+ * exactly like the upstream counting sort.
+ */
+export class MonAllocTable {
+    entries;
+    races;
+    oodChance;
+    /**
+     * Full race table (index 0 is the <player> placeholder). Exposed so callers
+     * that need the raw r_info array for mon_restrict("random") - e.g.
+     * get_chamber_monsters - can reuse the table's races without re-threading a
+     * separate array through MonPlaceDeps.
+     */
+    get allRaces() {
+        return this.races;
+    }
+    oodAmount;
+    seasonalAllowed;
+    constructor(races, options = {}) {
+        const maxDepth = options.maxDepth ?? 128;
+        this.oodChance = options.oodChance ?? 25;
+        this.oodAmount = options.oodAmount ?? 10;
+        this.seasonalAllowed = options.seasonalAllowed ?? false;
+        this.races = races;
+        /*
+         * init_race_allocs: scan races skipping index 0 (the <player>
+         * placeholder record, which has no rarity anyway) and keep only
+         * races with a rarity. Upstream also skips the trailing player
+         * ghost slot, which this port does not allocate at all.
+         */
+        const legal = [];
+        for (let i = 1; i < races.length; i++) {
+            const race = races[i];
+            if (!race.rarity)
+                continue;
+            if (race.level >= maxDepth) {
+                throw new Error(`mon: race ${race.name} level ${race.level} outside max depth`);
+            }
+            legal.push(race);
+        }
+        /* Counting sort by level is stable within a level. */
+        legal.sort((a, b) => (a.level !== b.level ? a.level - b.level : a.ridx - b.ridx));
+        this.entries = legal.map((race) => {
+            /* p = (100 / rarity) * (1 + lev / 10), C integer division. */
+            const p = Math.trunc(100 / race.rarity) * (1 + Math.trunc(race.level / 10));
+            return {
+                index: race.ridx,
+                level: race.level,
+                prob1: p,
+                prob2: p,
+                prob3: p,
+            };
+        });
+    }
+    /**
+     * get_mon_num_prep: apply a restriction hook; prob2 becomes prob1 for
+     * accepted races and 0 otherwise. Pass null to clear the restriction.
+     */
+    prep(hook) {
+        for (const entry of this.entries) {
+            const race = this.races[entry.index];
+            entry.prob2 = !hook || hook(race) ? entry.prob1 : 0;
+        }
+    }
+    /** get_mon_race_aux: weighted pick over prob3. */
+    pickAux(rng, total) {
+        let value = rng.randint0(total);
+        let i = 0;
+        for (; i < this.entries.length; i++) {
+            const entry = this.entries[i];
+            if (value < entry.prob3)
+                break;
+            value -= entry.prob3;
+        }
+        const entry = this.entries[Math.min(i, this.entries.length - 1)];
+        return this.races[entry.index];
+    }
+    /**
+     * get_mon_num: choose a race appropriate to generatedLevel, applying
+     * the universal restrictions against currentLevel (the level the
+     * monster will be placed on). Returns null when no race is legal.
+     */
+    getMonNum(rng, generatedLevel, currentLevel, 
+    /**
+     * Level generation only: "is this unique already placed on the level being
+     * built?". C has no equivalent parameter because it increments
+     * race->cur_num the moment a monster is placed (mon-make.c L1040-1041), so
+     * the unique gate below excludes it from the very next table build. The
+     * port generates into a detached Gen and must not touch the shared count
+     * (see the note in gen/util.ts placeNewMonsterOne), so generation supplies
+     * its level-local placed set here instead. Same effect on the table, and
+     * therefore the same RNG stream: a placed unique is never offered again,
+     * rather than being drawn and then rejected at placement.
+     */
+    uniquePlaced) {
+        /* Occasionally produce a nastier monster in the dungeon. */
+        if (generatedLevel > 0 && rng.oneIn(this.oodChance)) {
+            generatedLevel += Math.min(Math.trunc(generatedLevel / 4) + 2, this.oodAmount);
+        }
+        let total = 0;
+        for (const entry of this.entries) {
+            /* Monsters are sorted by depth. */
+            if (entry.level > generatedLevel)
+                break;
+            entry.prob3 = 0;
+            /* No town monsters in the dungeon. */
+            if (generatedLevel > 0 && entry.level <= 0)
+                continue;
+            const race = this.races[entry.index];
+            /* No seasonal monsters outside of Christmas. */
+            if (race.flags.has(RF.SEASONAL) && !this.seasonalAllowed)
+                continue;
+            /* Only one copy of a unique at a time (and none once dead). */
+            if (race.flags.has(RF.UNIQUE)) {
+                if (race.curNum >= race.maxNum)
+                    continue;
+                if (uniquePlaced?.(race))
+                    continue;
+            }
+            /* Some monsters never appear out of depth. */
+            if (race.flags.has(RF.FORCE_DEPTH) && race.level > currentLevel) {
+                continue;
+            }
+            entry.prob3 = entry.prob2;
+            total += entry.prob3;
+        }
+        if (total <= 0)
+            return null;
+        let race = this.pickAux(rng, total);
+        /* Try for a harder monster once (50%) or twice (10%). */
+        const p = rng.randint0(100);
+        if (p < 60) {
+            const old = race;
+            race = this.pickAux(rng, total);
+            if (race.level < old.level)
+                race = old;
+        }
+        if (p < 10) {
+            const old = race;
+            race = this.pickAux(rng, total);
+            if (race.level < old.level)
+                race = old;
+        }
+        return race;
+    }
+}
+/**
+ * mon_hp: hp for a race by aspect. Uniques are handled by the caller
+ * (they always get avg_hp); this is the raw calculation.
+ */
+export function monHp(race, hpAspect, rng) {
+    let stdDev = Math.trunc((Math.trunc((race.avgHp * 10) / 8) + 5) / 10);
+    if (race.avgHp > 1)
+        stdDev++;
+    switch (hpAspect) {
+        case "minimise":
+            return race.avgHp - 4 * stdDev;
+        case "maximise":
+        case "extremify":
+            return race.avgHp + 4 * stdDev;
+        case "average":
+            return race.avgHp;
+        case "randomise":
+            if (!rng)
+                throw new Error("monHp: randomise needs an rng");
+            return rng.randNormal(race.avgHp, stdDev);
+    }
+}
+/**
+ * The monster-construction half of place_new_monster_one: builds a fully
+ * initialized Monster instance for a race. RNG call order matches
+ * upstream (sleep, hp, speed variation, energy, random attr) so seeded
+ * streams stay comparable. Placement into a chunk is deferred.
+ */
+export function createMonster(rng, race, options = {}) {
+    const sleep = options.sleep ?? true;
+    const mon = blankMonster(race);
+    const unique = race.flags.has(RF.UNIQUE);
+    /* Enforce sleeping if needed. */
+    if (sleep && race.sleep) {
+        const val = race.sleep;
+        mon.mTimed[MON_TMD.SLEEP] = val * 2 + rng.randint1(val * 10);
+    }
+    /* Uniques get a fixed amount of HP. */
+    if (unique) {
+        mon.maxhp = race.avgHp;
+    }
+    else {
+        mon.maxhp = Math.max(monHp(race, "randomise", rng), 1);
+    }
+    mon.hp = mon.maxhp;
+    /* Extract the monster base speed, with small racial variety. */
+    mon.mspeed = race.speed;
+    if (!unique) {
+        const i = Math.trunc(turnEnergy(race.speed, options.moveEnergy) / 10);
+        if (i)
+            mon.mspeed += rng.randSpread(0, i);
+    }
+    /* Give a random starting energy. */
+    mon.energy = rng.randint0(50);
+    /* Force monster to wait for player. */
+    if (race.flags.has(RF.FORCE_SLEEP))
+        mon.mflag.on(MFLAG.NICE);
+    /* Is this obviously a monster? (Mimics etc. are not.) */
+    if (race.flags.has(RF.UNAWARE)) {
+        mon.mflag.on(MFLAG.CAMOUFLAGE);
+    }
+    else {
+        mon.mflag.off(MFLAG.CAMOUFLAGE);
+    }
+    /* Set the color if necessary. */
+    if (race.flags.has(RF.ATTR_RAND)) {
+        mon.attr = rng.randint1(BASIC_COLORS - 1);
+    }
+    /* Set the primary group info. */
+    const info = mon.groupInfo[GROUP_TYPE.PRIMARY];
+    if (info) {
+        info.index = options.groupIndex ?? 0;
+        info.role = options.groupRole ?? MON_GROUP.MEMBER;
+    }
+    return mon;
+}
+/* ------------------------------------------------------------------ */
+/* Drops (mon_create_drop_count) and held objects (monster_carry)       */
+/* ------------------------------------------------------------------ */
+/** drop_4_max / drop_3_max / drop_2_max (mon-make.c L704-706). */
+const DROP_4_MAX = 6;
+const DROP_3_MAX = 4;
+const DROP_2_MAX = 3;
+/**
+ * mon_create_drop_count (mon-make.c L699): how many generic drops a race
+ * yields from its RF_DROP_* flags, plus (optionally) its specified-drop
+ * count. `maximize` returns the maximum instead of a random roll (the lore
+ * display path); `specific` folds the specified-drop count into the returned
+ * `number`. `specificCount` is always the (random or maximum) specified-drop
+ * total, so callers that need the two separately (lore display) can read it.
+ *
+ * CRITICAL (mon-make.c L728-734): in the non-maximize branch the specified-drop
+ * loop draws RNG - randint0(100), then randint0(max-min) when it passes - for
+ * EVERY race.drops entry, even though the resulting specnum is discarded when
+ * specific=false. mon_create_drop calls this with specific=false but the draws
+ * still happen; omitting them desyncs every later draw. Kept faithfully below.
+ */
+export function monCreateDropCount(rng, race, maximize, specific) {
+    let number = 0;
+    let specnum = 0;
+    if (maximize) {
+        if (race.flags.has(RF.DROP_20))
+            number++;
+        if (race.flags.has(RF.DROP_40))
+            number++;
+        if (race.flags.has(RF.DROP_60))
+            number++;
+        if (race.flags.has(RF.DROP_4))
+            number += DROP_4_MAX;
+        if (race.flags.has(RF.DROP_3))
+            number += DROP_3_MAX;
+        if (race.flags.has(RF.DROP_2))
+            number += DROP_2_MAX;
+        if (race.flags.has(RF.DROP_1))
+            number++;
+        for (const drop of race.drops)
+            specnum += drop.max;
+    }
+    else {
+        if (race.flags.has(RF.DROP_20) && rng.randint0(100) < 20)
+            number++;
+        if (race.flags.has(RF.DROP_40) && rng.randint0(100) < 40)
+            number++;
+        if (race.flags.has(RF.DROP_60) && rng.randint0(100) < 60)
+            number++;
+        if (race.flags.has(RF.DROP_4))
+            number += rng.randRange(2, DROP_4_MAX);
+        if (race.flags.has(RF.DROP_3))
+            number += rng.randRange(2, DROP_3_MAX);
+        if (race.flags.has(RF.DROP_2))
+            number += rng.randRange(1, DROP_2_MAX);
+        if (race.flags.has(RF.DROP_1))
+            number++;
+        for (const drop of race.drops) {
+            if (rng.randint0(100) < drop.percentChance) {
+                specnum += rng.randint0(drop.max - drop.min) + drop.min;
+            }
+        }
+    }
+    if (specific)
+        number += specnum;
+    return { number, specificCount: specnum };
+}
+/**
+ * OSTACK_MONSTER stacking never reads the quiver limits (only OSTACK_QUIVER
+ * does), so any values work; these are the shipped constants.txt quiver
+ * numbers for consistency with floor.ts.
+ */
+const MON_STACK_LIMITS = { quiverSlotSize: 40, thrownQuiverMult: 5 };
+/**
+ * monster_carry (mon-util.c L1368): give an object to a monster's held pile.
+ * Merges into a compatible held stack when possible (object_absorb), otherwise
+ * forgets the object's location and prepends it (pile_insert) so `pile[0]` is
+ * the newest held object, matching the upstream head-first held_obj list.
+ *
+ * The port's held pile is the GameObject[] on Monster.heldObj (head-first);
+ * the chunk-side list_object / known-object bookkeeping of upstream rides the
+ * knowledge subsystem and is not modelled here.
+ */
+export function monsterCarry(pile, obj, midx) {
+    /* Scan objects already being held for combination. */
+    for (const held of pile) {
+        if (objectMergeable(held, obj, OSTACK_MONSTER, MON_STACK_LIMITS)) {
+            objectAbsorb(held, obj, ORIGIN.MIXED);
+            return;
+        }
+    }
+    /* Forget location; link the object to the monster; prepend to the pile. */
+    obj.grid = null;
+    obj.heldMIdx = midx;
+    pile.unshift(obj);
+}
+//# sourceMappingURL=make.js.map

package/dist/mon/make.js.map

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

package/dist/mon/monster.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Live monster instances, ported from struct monster in
+ * reference/src/monster.h, plus the energy table from
+ * reference/src/game-world.c (Angband 4.2.6).
+ *
+ * World coupling is kept to numeric handles: held and mimicked objects are
+ * object handles (0 = none) and the grid is a plain Loc. The chunk-side
+ * bookkeeping (midx assignment, square occupancy) happens at placement,
+ * which is deferred to the world integration.
+ */
+import { FlagSet } from "../bitflag.js";
+import type { Loc } from "../loc.js";
+import type { GameObject } from "../obj/object.js";
+import type { MonsterGroupRole, MonsterRace } from "./types.js";
+/** enum monster_group_type. */
+export declare const GROUP_TYPE: {
+    readonly PRIMARY: 0;
+    readonly SUMMON: 1;
+};
+export declare const GROUP_MAX = 2;
+/** struct monster_group_info. */
+export interface MonsterGroupInfo {
+    index: number;
+    role: MonsterGroupRole;
+}
+/** Minimal struct target: a grid and/or a monster index. */
+export interface MonsterTarget {
+    grid: Loc;
+    midx: number;
+}
+/**
+ * monster.known_pstate (monster.h): what the monster has learned about the
+ * player under birth_ai_learn - observed object flags, player (class/race)
+ * flags and elemental resist levels. Written by update_smart_learn
+ * (mon/spell.ts) and read by remove_bad_spells' unset_spells filter.
+ */
+export interface MonKnownPstate {
+    /** of-flags observed on the player (OF_ index space). */
+    flags: FlagSet;
+    /** player flags observed (PF_ index space). */
+    pflags: FlagSet;
+    /** el_info[elem].res_level observed, indexed by ELEM_. */
+    elInfo: Int16Array;
+}
+/** struct monster (monster.h), world references as numeric handles. */
+export interface Monster {
+    race: MonsterRace;
+    /** Changed monster's original race, or null. */
+    originalRace: MonsterRace | null;
+    /** Index in the chunk monster list; 0 until placed. */
+    midx: number;
+    grid: Loc;
+    hp: number;
+    maxhp: number;
+    /** Timed effects, indexed by MON_TMD_*. */
+    mTimed: Int16Array;
+    mspeed: number;
+    energy: number;
+    /** Current distance from the player. */
+    cdis: number;
+    /** Temporary MFLAG_* flags. */
+    mflag: FlagSet;
+    /** Object handle of the mimicked object (0 = none). */
+    mimickedObj: number;
+    /**
+     * The monster's held objects (struct monster.held_obj), head-first: pile[0]
+     * is the newest, exactly as upstream's pile_insert-prepended linked list.
+     * Populated by monster_carry (mon/make.ts) - generated drops at death and
+     * gold/items stolen by melee - and emptied by monster_death.
+     */
+    heldObj: GameObject[];
+    /** Attr last used for drawing (0 = use race default). */
+    attr: number;
+    target: MonsterTarget;
+    groupInfo: MonsterGroupInfo[];
+    minRange: number;
+    bestRange: number;
+    /** known_pstate: the birth_ai_learn player-knowledge memory. */
+    knownPstate: MonKnownPstate;
+}
+/** A zeroed monster of the given race (memset in place_new_monster_one). */
+export declare function blankMonster(race: MonsterRace): Monster;
+/**
+ * extract_energy from game-world.c: energy gained per game turn by speed.
+ * Indexed 0..199; standard speed 110 gains 10.
+ */
+export declare const EXTRACT_ENERGY: readonly number[];
+/**
+ * turn_energy (game-world.c). moveEnergy is z_info->move_energy (100 in
+ * the shipped constants.txt). Divergence: upstream indexes the table
+ * unchecked; this port clamps speed to 0..199 to keep the lookup safe.
+ */
+export declare function turnEnergy(speed: number, moveEnergy?: number): number;
+//# sourceMappingURL=monster.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"monster.d.ts","sourceRoot":"","sources":["../../src/mon/monster.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAGrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGhE,+BAA+B;AAC/B,eAAO,MAAM,UAAU;;;CAGb,CAAC;AACX,eAAO,MAAM,SAAS,IAAI,CAAC;AAE3B,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,GAAG,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,KAAK,EAAE,OAAO,CAAC;IACf,+CAA+C;IAC/C,MAAM,EAAE,OAAO,CAAC;IAChB,0DAA0D;IAC1D,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,uEAAuE;AACvE,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,WAAW,CAAC;IAClB,gDAAgD;IAChD,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,GAAG,CAAC;IACV,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,WAAW,EAAE,cAAc,CAAC;CAC7B;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CA8BvD;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAqB3C,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,SAAM,GAAG,MAAM,CAGlE"}

package/dist/mon/monster.js

@@ -0,0 +1,90 @@
+/**
+ * Live monster instances, ported from struct monster in
+ * reference/src/monster.h, plus the energy table from
+ * reference/src/game-world.c (Angband 4.2.6).
+ *
+ * World coupling is kept to numeric handles: held and mimicked objects are
+ * object handles (0 = none) and the grid is a plain Loc. The chunk-side
+ * bookkeeping (midx assignment, square occupancy) happens at placement,
+ * which is deferred to the world integration.
+ */
+import { FlagSet } from "../bitflag.js";
+import { loc } from "../loc.js";
+import { MON_TMD } from "../generated/index.js";
+import { ELEM_MAX, OF_SIZE } from "../obj/types.js";
+import { PF_SIZE } from "../player/types.js";
+import { MFLAG_SIZE, MON_GROUP } from "./types.js";
+/** enum monster_group_type. */
+export const GROUP_TYPE = {
+    PRIMARY: 0,
+    SUMMON: 1,
+};
+export const GROUP_MAX = 2;
+/** A zeroed monster of the given race (memset in place_new_monster_one). */
+export function blankMonster(race) {
+    const groupInfo = [];
+    for (let i = 0; i < GROUP_MAX; i++) {
+        groupInfo.push({ index: 0, role: MON_GROUP.MEMBER });
+    }
+    return {
+        race,
+        originalRace: null,
+        midx: 0,
+        grid: loc(0, 0),
+        hp: 0,
+        maxhp: 0,
+        mTimed: new Int16Array(MON_TMD.MAX),
+        mspeed: 0,
+        energy: 0,
+        cdis: 0,
+        mflag: new FlagSet(MFLAG_SIZE),
+        mimickedObj: 0,
+        heldObj: [],
+        attr: 0,
+        target: { grid: loc(0, 0), midx: 0 },
+        groupInfo,
+        minRange: 0,
+        bestRange: 0,
+        knownPstate: {
+            flags: new FlagSet(OF_SIZE),
+            pflags: new FlagSet(PF_SIZE),
+            elInfo: new Int16Array(ELEM_MAX),
+        },
+    };
+}
+/**
+ * extract_energy from game-world.c: energy gained per game turn by speed.
+ * Indexed 0..199; standard speed 110 gains 10.
+ */
+export const EXTRACT_ENERGY = [
+    /* Slow */ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+    /* Slow */ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+    /* Slow */ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+    /* Slow */ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+    /* Slow */ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+    /* Slow */ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+    /* S-50 */ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+    /* S-40 */ 2, 2, 2, 2, 2, 2, 2, 2, 2, 2,
+    /* S-30 */ 2, 2, 2, 2, 2, 2, 2, 3, 3, 3,
+    /* S-20 */ 3, 3, 3, 3, 3, 4, 4, 4, 4, 4,
+    /* S-10 */ 5, 5, 5, 5, 6, 6, 7, 7, 8, 9,
+    /* Norm */ 10, 11, 12, 13, 14, 15, 16, 17, 18, 19,
+    /* F+10 */ 20, 21, 22, 23, 24, 25, 26, 27, 28, 29,
+    /* F+20 */ 30, 31, 32, 33, 34, 35, 36, 36, 37, 37,
+    /* F+30 */ 38, 38, 39, 39, 40, 40, 40, 41, 41, 41,
+    /* F+40 */ 42, 42, 42, 43, 43, 43, 44, 44, 44, 44,
+    /* F+50 */ 45, 45, 45, 45, 45, 46, 46, 46, 46, 46,
+    /* F+60 */ 47, 47, 47, 47, 47, 48, 48, 48, 48, 48,
+    /* F+70 */ 49, 49, 49, 49, 49, 49, 49, 49, 49, 49,
+    /* Fast */ 49, 49, 49, 49, 49, 49, 49, 49, 49, 49,
+];
+/**
+ * turn_energy (game-world.c). moveEnergy is z_info->move_energy (100 in
+ * the shipped constants.txt). Divergence: upstream indexes the table
+ * unchecked; this port clamps speed to 0..199 to keep the lookup safe.
+ */
+export function turnEnergy(speed, moveEnergy = 100) {
+    const s = Math.min(Math.max(speed, 0), EXTRACT_ENERGY.length - 1);
+    return Math.trunc((EXTRACT_ENERGY[s] * moveEnergy) / 100);
+}
+//# sourceMappingURL=monster.js.map

package/dist/mon/monster.js.map

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

package/dist/mon/predicate.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Monster predicates, ported from reference/src/mon-predicate.c (Angband
+ * 4.2.6): the permanent (race-flag / spell-flag derived) properties and the
+ * temporary (mflag derived) properties of a live monster.
+ *
+ * These are pure queries over a Monster and its race, used throughout the AI,
+ * combat, effects, and spell systems. create_mon_spell_mask is expressed via
+ * monSpellsOfTypes (mon/types.ts); mflag / race-flag reads use the generated
+ * MFLAG / RF enums.
+ *
+ * One divergence, one deferral (both faithful in reachable states):
+ * - monster_can_be_scared's group-size branch takes primaryGroupSize as an
+ *   argument (default 1 = "no group"), because monster groups are not tracked
+ *   in the cave yet; primaryGroupSize=1 gives count=0, so the group fear-save
+ *   loop never runs, matching a lone monster exactly.
+ * - monster_is_decoyed is DEFERRED: it needs cave_find_decoy + los + a live
+ *   cave, and a decoy only exists once the create-decoy effect is ported.
+ */
+import type { Rng } from "../rng.js";
+import type { Monster } from "./monster.js";
+/** monster_is_undead. */
+export declare function monsterIsUndead(mon: Monster): boolean;
+/** monster_is_nonliving: undead or explicitly nonliving; immune to drain. */
+export declare function monsterIsNonliving(mon: Monster): boolean;
+/** monster_is_living. */
+export declare function monsterIsLiving(mon: Monster): boolean;
+/** monster_is_destroyed: nonliving or stupid monsters are destroyed, not slain. */
+export declare function monsterIsDestroyed(mon: Monster): boolean;
+/** monster_passes_walls: PASS_WALL / KILL_WALL / SMASH_WALL. */
+export declare function monsterPassesWalls(mon: Monster): boolean;
+/** monster_is_invisible. */
+export declare function monsterIsInvisible(mon: Monster): boolean;
+/** monster_is_not_invisible. */
+export declare function monsterIsNotInvisible(mon: Monster): boolean;
+/** monster_is_unique: the unshifted (original) form is unique. */
+export declare function monsterIsUnique(mon: Monster): boolean;
+/** monster_is_shape_unique: the current form is unique. */
+export declare function monsterIsShapeUnique(mon: Monster): boolean;
+/** monster_is_stupid. */
+export declare function monsterIsStupid(mon: Monster): boolean;
+/** monster_is_smart: the monster is (or was, before a shapechange) smart. */
+export declare function monsterIsSmart(mon: Monster): boolean;
+/**
+ * monster_is_esp_detectable: detectable by telepathy. EMPTY_MIND (in both the
+ * current and original form) blocks it; WEIRD_MIND makes only one in ten
+ * individuals (midx % 10 == 5) detectable.
+ */
+export declare function monsterIsEspDetectable(mon: Monster): boolean;
+/** monster_has_spirit. */
+export declare function monsterHasSpirit(mon: Monster): boolean;
+/** monster_is_evil. */
+export declare function monsterIsEvil(mon: Monster): boolean;
+/** monster_is_fearful: can be frightened at all (no NO_FEAR flag). */
+export declare function monsterIsFearful(mon: Monster): boolean;
+/** monster_is_powerful. */
+export declare function monsterIsPowerful(mon: Monster): boolean;
+/** monster_has_spells: any spell flag at all. */
+export declare function monsterHasSpells(mon: Monster): boolean;
+/** monster_breathes: has a damaging-breath spell. */
+export declare function monsterBreathes(mon: Monster): boolean;
+/** monster_has_innate_spells. */
+export declare function monsterHasInnateSpells(mon: Monster): boolean;
+/** monster_has_non_innate_spells: any spell set that is not innate. */
+export declare function monsterHasNonInnateSpells(mon: Monster): boolean;
+/** monster_loves_archery: has archery spells and casts them often. */
+export declare function monsterLovesArchery(mon: Monster): boolean;
+/** monster_is_in_view: in the player's field of view. */
+export declare function monsterIsInView(mon: Monster): boolean;
+/** monster_is_visible. */
+export declare function monsterIsVisible(mon: Monster): boolean;
+/** monster_is_camouflaged: not recognised as a monster. */
+export declare function monsterIsCamouflaged(mon: Monster): boolean;
+/** monster_is_obvious: visible and not camouflaged. */
+export declare function monsterIsObvious(mon: Monster): boolean;
+/** monster_is_mimicking: camouflaged as a specific item. */
+export declare function monsterIsMimicking(mon: Monster): boolean;
+/**
+ * monster_can_be_scared: NO_FEAR blocks fear outright; bodyguards are
+ * fearless; servants dodge fear one time in three; others get a per-member
+ * one-in-twenty save across the group.
+ *
+ * `primaryGroupSize` is monster_primary_group_size(cave, mon); it defaults to
+ * 1 (lone monster) until monster-group tracking is ported, which gives count=0
+ * and no group save - exactly a solitary monster.
+ */
+export declare function monsterCanBeScared(rng: Rng, mon: Monster, primaryGroupSize?: number): boolean;
+//# sourceMappingURL=predicate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"predicate.d.ts","sourceRoot":"","sources":["../../src/mon/predicate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAGrC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAa5C,yBAAyB;AACzB,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAErD;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAExD;AAED,yBAAyB;AACzB,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAErD;AAED,mFAAmF;AACnF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAExD;AAED,gEAAgE;AAChE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAMxD;AAED,4BAA4B;AAC5B,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAExD;AAED,gCAAgC;AAChC,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAE3D;AAED,kEAAkE;AAClE,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAGrD;AAED,2DAA2D;AAC3D,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAE1D;AAED,yBAAyB;AACzB,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAErD;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAGpD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAQ5D;AAED,0BAA0B;AAC1B,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEtD;AAED,uBAAuB;AACvB,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEnD;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEtD;AAED,2BAA2B;AAC3B,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEvD;AAED,iDAAiD;AACjD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEtD;AAED,qDAAqD;AACrD,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAErD;AAED,iCAAiC;AACjC,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAE5D;AAED,uEAAuE;AACvE,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAM/D;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAGzD;AAMD,yDAAyD;AACzD,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAErD;AAED,0BAA0B;AAC1B,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEtD;AAED,2DAA2D;AAC3D,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAE1D;AAED,uDAAuD;AACvD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEtD;AAED,4DAA4D;AAC5D,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAExD;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,OAAO,EACZ,gBAAgB,SAAI,GACnB,OAAO,CAeT"}