@rpgm-tools/neo-angband-core 0.10.0

package/dist/game/mon-place.d.ts

@@ -0,0 +1,226 @@
+/**
+ * Live-cave monster placement, ported from the placement half of
+ * reference/src/mon-make.c (place_monster, place_new_monster_one,
+ * place_new_monster_group, place_friends, place_new_monster,
+ * pick_and_place_monster) and the world half of reference/src/mon-summon.c
+ * (summon_specific, call_monster, select_shape), Angband 4.2.6.
+ *
+ * The generation-time twin of this family lives in gen/util.ts and operates
+ * on the Gen context; this module operates on a running GameState, so
+ * summons, breeders and other mid-game arrivals join the live monster list,
+ * the group structures and the square occupancy exactly as the generated
+ * population did. Monster construction (RNG order: sleep, hp, speed
+ * variation, energy, random attr) is the shared mon/make.ts createMonster.
+ *
+ * Racial population counts (race->cur_num) are live here: placement
+ * increments them and deleteMonster (game/context.ts) decrements, so the
+ * "only one unique at a time" rule holds across summoning and death. The
+ * session layer keeps the counts consistent across level changes
+ * (wipe_mon_list decrements for every live monster).
+ *
+ * Placement-time monster drops (mon_create_drop) ARE wired here: placeMonsterLive
+ * calls the shared createDrop core (game/mon-death.ts) when origin != 0, exactly
+ * as place_monster does (mon-make.c L1044-1046), filling the monster's held pile
+ * so monster_death can spill it on death. Live callers thread the true origin
+ * (ORIGIN_DROP for ambient spawns and pickAndPlaceDistantMonster, DROP_SUMMON for
+ * summons, DROP_BREED for breeders, DROP_WIZARD for the debug spawn). Inert when
+ * the caller omits MonPlaceDeps.makeDeps (monster-only harnesses). The cheat_hear
+ * messages are UI-only; update_mon / monster-light view refresh rides the FOV
+ * consumers.
+ *
+ * Object-mimic placement (mon_create_mimicked_object) IS ported here and
+ * fires from placeMonsterLive for live-placed (summoned / bred) mimics when
+ * the caller supplies MonPlaceDeps.mimic. Generation-spawned mimics ARE built by
+ * gen/util.ts placeNewMonsterOne (createMimickedObject) and installed by
+ * session/game.ts populateFromLevel; the two paths draw at the same RNG-stream
+ * position because every vanilla mimic race carries no drops.
+ *
+ * add_to_monster_rating IS wired here (mon-make.c L1112-1126), matching
+ * upstream's single place_new_monster_one for both generation and live
+ * summons/breeders. Since chunk.feeling is computed once at gen-end
+ * (gen/generate.ts generateLevel) and never recomputed, these post-gen
+ * accumulations are harmless bookkeeping: they keep chunk.mon_rating byte-
+ * faithful to upstream but have no effect on an already-shown feeling.
+ */
+import type { Rng } from "../rng.js";
+import type { Loc } from "../loc.js";
+import type { MonsterBase, MonsterRace } from "../mon/types.js";
+import type { Monster, MonsterGroupInfo } from "../mon/monster.js";
+import type { MonAllocTable } from "../mon/make.js";
+import type { SummonTable } from "../mon/summon.js";
+import type { MakeDeps } from "../obj/make.js";
+import type { LoreStore } from "../mon/lore.js";
+import type { GameObject } from "../obj/object.js";
+import type { GameState } from "./context.js";
+import type { FloorEnv } from "./floor.js";
+/** Everything live placement needs beyond the state. */
+export interface MonPlaceDeps {
+    /** The live race allocation table (shared across the session). */
+    table: MonAllocTable;
+    /**
+     * square_isplayertrap / iswebbed / iswarded (game/trap.ts trapPredicates).
+     * Absent (no trap system), those tests pass vacuously.
+     */
+    preds?: {
+        isPlayerTrap: (grid: Loc) => boolean;
+        isWebbed: (grid: Loc) => boolean;
+        isWarded: (grid: Loc) => boolean;
+    };
+    /** z_info->monster_group_max (mon-gen:group-max, 25). */
+    groupMax?: number;
+    /** z_info->monster_group_dist (mon-gen:group-dist, 5). */
+    groupDist?: number;
+    /**
+     * Object-make deps for mon_create_mimicked_object (mon-make.c L899). Absent
+     * (worldless / monster-only harnesses, and every current caller until the
+     * generation-handoff seam is wired), object-mimics are placed as bare
+     * monsters with no fake item - exactly the pre-mimic behaviour - and
+     * mon.mimickedObj stays 0.
+     */
+    mimic?: MimicDeps;
+    /**
+     * Object-make deps for mon_create_drop (mon-make.c L1044). When present,
+     * placeMonsterLive generates the monster's held-object drops at placement, as
+     * upstream place_monster does when origin != 0. Absent (monster-only
+     * harnesses / tests that do not exercise loot), no drops are drawn and no held
+     * pile is populated - so those contexts stay RNG-identical to the pre-wiring
+     * behaviour.
+     */
+    makeDeps?: MakeDeps;
+    /**
+     * Lore store for mon_create_drop's unique theft reduction (mon-make.c L778).
+     * Absent => thefts treated as 0 (a never-stolen-from monster).
+     */
+    lore?: LoreStore;
+}
+/** Everything mon_create_mimicked_object needs beyond the state and monster. */
+export interface MimicDeps {
+    /** Object-make deps (makeGold / objectPrep / applyMagic share the RNG). */
+    makeDeps: MakeDeps;
+    /** floor_carry env (ignore / stacking hooks); defaults to inert. */
+    floorEnv?: FloorEnv;
+}
+/**
+ * The minimal, GameState-free surface mon_create_mimicked_object needs so BOTH
+ * the live cave (this module) and level generation (gen/util.ts) can build a
+ * mimic's fake object off the same code. The two paths differ only in how the
+ * object is carried: the live path calls floor_carry on the running state; the
+ * generation path parks it on the Gen side-table that populateFromLevel later
+ * re-carries. Neither carry draws RNG, so the object's draws (reservoir sample
+ * + make_gold / object_prep + apply_magic) land at the same stream position on
+ * either path.
+ */
+export interface MimicTarget {
+    /** c->depth: the depth make_gold / origin_depth read. */
+    depth: number;
+    /** The stream to draw from (live state.rng or generation g.rng). */
+    rng: Rng;
+    /** make_gold / object_prep / apply_magic dependencies. */
+    makeDeps: MakeDeps;
+    /** floor_carry(c, mon->grid, obj): put obj at grid, true iff it went. */
+    carry: (grid: Loc, obj: GameObject) => boolean;
+}
+/** square_isopen on the live cave: floor with no occupant (player counts). */
+export declare function squareIsOpenLive(state: GameState, grid: Loc): boolean;
+/** square_isempty on the live cave: open, no objects, no player trap / web. */
+export declare function squareIsEmptyLive(state: GameState, grid: Loc, preds?: MonPlaceDeps["preds"]): boolean;
+/** square_allows_summon: empty and neither warded nor decoyed. */
+export declare function squareAllowsSummon(state: GameState, grid: Loc, preds?: MonPlaceDeps["preds"]): boolean;
+/**
+ * mon_create_mimicked_object (mon-make.c L899): create the fake floor item an
+ * object-mimic imitates and link it to the monster. Reservoir-samples one of
+ * the race's mimic_kinds (one_in_(i) over i = 1..n; the first draw, one_in_(1),
+ * draws no RNG and always selects the first kind), makes a gold object for a
+ * money kind or a prepped-and-magicked item otherwise (RNG order identical to
+ * upstream), links both sides of the mimicry, and drops it on the monster's
+ * grid via floor_carry. If the floor cannot hold it the mimicry is cleared and
+ * the item is either given to the monster (RF_MIMIC_INV) or discarded.
+ *
+ * The port has no object oidx registry, so mon.mimickedObj is a nonzero
+ * presence marker (1); the live mon<->obj link is carried by
+ * obj.mimickingMIdx === mon.midx, which is what become_aware reads and the save
+ * format persists. C's list_object (oidx bookkeeping) is DEFERRED with the
+ * floor object list (game/floor.ts module docs). convert_depth_to_origin(
+ * c->depth) is the port's direct state.chunk.depth (matching mon-death.ts /
+ * effect-item.ts). Draws RNG exactly as upstream.
+ */
+export declare function createMimickedObject(target: MimicTarget, mon: Monster): void;
+/**
+ * Live-cave mon_create_mimicked_object: a thin wrapper that binds the running
+ * GameState to the shared, GameState-free createMimickedObject core. The carry
+ * is the live floor_carry (no RNG), so this stays byte- and RNG-identical to
+ * the pre-refactor function for every live-placed mimic.
+ */
+export declare function monCreateMimickedObject(state: GameState, mon: Monster, deps: MimicDeps): void;
+/**
+ * place_new_monster_one on the live cave: legality checks, monster
+ * construction (shared RNG order) and placement.
+ */
+export declare function placeNewMonsterOne(state: GameState, grid: Loc, race: MonsterRace, sleep: boolean, info: MonsterGroupInfo, deps: MonPlaceDeps, origin?: number): boolean;
+/**
+ * place_new_monster: place a monster of the given race at the given
+ * location, with its friends and escorts when `groupOk` is set. The first
+ * monster of a fresh group is its leader.
+ */
+export declare function placeNewMonster(state: GameState, grid: Loc, race: MonsterRace, sleep: boolean, groupOk: boolean, groupInfo: MonsterGroupInfo, deps: MonPlaceDeps, origin?: number): boolean;
+/**
+ * multiply_monster (mon-make.c L983): a breeder tries to spawn a copy of
+ * itself in a nearby empty grid. Returns true on a successful spawn.
+ *
+ * RNG order is preserved exactly: monster_is_shape_unique short-circuits
+ * before any draw (uniques never multiply and never touch the stream), then
+ * scatter_ext draws (distance 1, needs LOS, square_isempty), then
+ * place_new_monster (groupOk = false, so no friends/escort table draws - only
+ * createMonster's sleep/hp/speed/energy/attr draws). Fixing so multiplying a
+ * revealed camouflaged monster creates another revealed camouflaged monster
+ * (mon-move.c L1002-1011) draws no RNG - it just looks up the child that was
+ * placed a moment ago via square_monster, exactly as upstream does.
+ */
+export declare function multiplyMonster(state: GameState, mon: Monster, deps: MonPlaceDeps): boolean;
+/** pick_and_place_monster: place an appropriate monster (and group) at grid. */
+export declare function pickAndPlaceMonster(state: GameState, grid: Loc, depth: number, sleep: boolean, groupOkay: boolean, deps: MonPlaceDeps, origin?: number): boolean;
+/**
+ * pick_and_place_distant_monster (mon-make.c L1483): pick a monster race and
+ * place it on a naked floor grid at least `dis` away from `toAvoid`, allowing
+ * groups. Up to 10000 attempts, each drawing randint0(width) THEN
+ * randint0(height) (x before y - a chosen canonical order; C leaves the two
+ * argument evaluations unspecified and the port targets its own save
+ * determinism, not binary C-save compatibility). In a running game
+ * character_dungeon is true, so the "no random monsters in marked rooms" test
+ * is skipped. Returns whether a monster was placed.
+ */
+export declare function pickAndPlaceDistantMonster(state: GameState, toAvoid: Loc, dis: number, sleep: boolean, depth: number, deps: MonPlaceDeps): boolean;
+/** Everything summon_specific needs beyond the placement deps. */
+export interface SummonDeps extends MonPlaceDeps {
+    /** The bound summon table (mon/summon.ts). */
+    summons: SummonTable;
+    /** cave->mon_current: the summoner, whose group summons join (0 = none). */
+    monCurrent?: number;
+    /** The kin base for S_KIN (the summoner's race base). */
+    kinBase?: MonsterBase | null;
+}
+/**
+ * summon_specific: place a monster of the given summon type near the grid,
+ * trying progressively wider scatters (1..4). Returns the summoned
+ * monster's race level iff a monster was actually summoned.
+ */
+export declare function summonSpecific(state: GameState, grid: Loc, lev: number, type: number, delay: boolean, call: boolean, deps: SummonDeps): number;
+/**
+ * select_shape: a race for a monster shapechange, drawn from the summon
+ * type's eligible races at the current depth (+5).
+ */
+export declare function selectShape(state: GameState, type: number, deps: SummonDeps): MonsterRace | null;
+/**
+ * wipe_mon_list's racial-count half: forget every live monster's racial
+ * occurrence before the level's monster list is discarded. The session's
+ * level change calls this so cur_num stays balanced across levels.
+ */
+export declare function wipeMonsterCounts(state: GameState): void;
+/**
+ * Re-count racial occurrences from a freshly populated monster list, and
+ * rebuild cave->num_repro (mon-make.c wipe_mon_list sets it to 0 at wipe; the
+ * generated / loaded breeders are counted here so the reproduction cap sees
+ * every RF_MULTIPLY monster on the level, not only mid-game arrivals).
+ */
+export declare function countMonsterRaces(state: GameState): void;
+//# sourceMappingURL=mon-place.d.ts.map

package/dist/game/mon-place.d.ts.map

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