@rpgm-tools/neo-angband-core 0.10.0

package/dist/game/steal.js.map

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

package/dist/game/take-hit-hooks.d.ts

@@ -0,0 +1,52 @@
+/**
+ * makeTakeHitHooks: the single, complete TakeHitHooks the live game binds to
+ * EVERY player take_hit site - projections (project_p), monster melee, the
+ * effect interpreter (traps, EF_DAMAGE, activations, monster casts) and the
+ * world clock's damage-over-time / terrain / over-exertion. Before this, the
+ * projection and effect paths passed no hooks (or only onMessage + onDisturb),
+ * so death by a breath, spell, trap or poison tick was SILENT - no damage line,
+ * no "*** LOW HITPOINT WARNING! ***" + bell, no "You die." - and p->died_from /
+ * p->total_winner were never recorded, so every death was scored as an unknown
+ * killer (audit 01 P1 CRITICAL).
+ *
+ * These are exactly the consequences take_hit itself performs inline in
+ * reference/src/player-util.c (Angband 4.2.6):
+ * - disturb(p)                                   (L207)  -> onDisturb
+ * - p->upkeep->redraw |= PR_HP                   (L225)  -> see onRedrawHp note
+ * - the bloodlust death-save randint0(10) roll   (L232)  -> rng
+ * - bell() on the first low-hitpoint notice      (L270)  -> bell
+ * - the msgt() status / death lines              (L233..L273) -> onMessage
+ * - my_strcpy(p->died_from, kb_str, ...)         (L244)  -> onDeath
+ * - p->total_winner = false                      (L255)  -> onDeath
+ *
+ * The score entry and death_knowledge (player-util.c L281 enter_score) are
+ * deliberately NOT done here: upstream defers them to close_game, and the port
+ * mirrors that in the shell's LOOP_STATUS.DEAD handler (web/src/main.ts), which
+ * reads the died_from this hook records and calls enterScore once. Recording
+ * died_from here without entering the score keeps that single close-game path.
+ *
+ * onRedrawHp has no faithful analogue in the port's batch-render model: the HP
+ * sidebar repaints once per turn after runGameLoop returns, so a mid-turn PR_HP
+ * is a visual no-op. It is deliberately omitted (matching the melee reference).
+ */
+import type { TakeHitHooks } from "../player/take-hit.js";
+import type { GameState } from "./context.js";
+import { type WizardDeps } from "./wizard.js";
+/**
+ * Optional deps for the EVENT_CHEAT_DEATH path (ui-display.c:2568-2573).
+ * The effect bundle is assigned after makeTakeHitHooks when wireGame finishes
+ * building the wizard effect stack; the hook closes over a mutable holder.
+ */
+export interface TakeHitHookOpts {
+    /**
+     * Mutable holder for WizardDeps.effect (assembled later in wireGame). The
+     * cheat-death hook reads `.current` at death time so it sees the live
+     * bundle even though makeTakeHitHooks runs before the effect stack exists.
+     */
+    wizardEffect?: {
+        current: WizardDeps["effect"] | undefined;
+    };
+}
+/** Build the shared, complete player take_hit consequences for `state`. */
+export declare function makeTakeHitHooks(state: GameState, opts?: TakeHitHookOpts): TakeHitHooks;
+//# sourceMappingURL=take-hit-hooks.d.ts.map

package/dist/game/take-hit-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"take-hit-hooks.d.ts","sourceRoot":"","sources":["../../src/game/take-hit-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,aAAa,CAAC;AAErB;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,YAAY,CAAC,EAAE;QAAE,OAAO,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAA;KAAE,CAAC;CAC9D;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,IAAI,GAAE,eAAoB,GACzB,YAAY,CA0Fd"}

package/dist/game/take-hit-hooks.js

@@ -0,0 +1,127 @@
+/**
+ * makeTakeHitHooks: the single, complete TakeHitHooks the live game binds to
+ * EVERY player take_hit site - projections (project_p), monster melee, the
+ * effect interpreter (traps, EF_DAMAGE, activations, monster casts) and the
+ * world clock's damage-over-time / terrain / over-exertion. Before this, the
+ * projection and effect paths passed no hooks (or only onMessage + onDisturb),
+ * so death by a breath, spell, trap or poison tick was SILENT - no damage line,
+ * no "*** LOW HITPOINT WARNING! ***" + bell, no "You die." - and p->died_from /
+ * p->total_winner were never recorded, so every death was scored as an unknown
+ * killer (audit 01 P1 CRITICAL).
+ *
+ * These are exactly the consequences take_hit itself performs inline in
+ * reference/src/player-util.c (Angband 4.2.6):
+ * - disturb(p)                                   (L207)  -> onDisturb
+ * - p->upkeep->redraw |= PR_HP                   (L225)  -> see onRedrawHp note
+ * - the bloodlust death-save randint0(10) roll   (L232)  -> rng
+ * - bell() on the first low-hitpoint notice      (L270)  -> bell
+ * - the msgt() status / death lines              (L233..L273) -> onMessage
+ * - my_strcpy(p->died_from, kb_str, ...)         (L244)  -> onDeath
+ * - p->total_winner = false                      (L255)  -> onDeath
+ *
+ * The score entry and death_knowledge (player-util.c L281 enter_score) are
+ * deliberately NOT done here: upstream defers them to close_game, and the port
+ * mirrors that in the shell's LOOP_STATUS.DEAD handler (web/src/main.ts), which
+ * reads the died_from this hook records and calls enterScore once. Recording
+ * died_from here without entering the score keeps that single close-game path.
+ *
+ * onRedrawHp has no faithful analogue in the port's batch-render model: the HP
+ * sidebar repaints once per turn after runGameLoop returns, so a mid-turn PR_HP
+ * is a visual no-op. It is deliberately omitted (matching the melee reference).
+ */
+import { MSG, PF } from "../generated/index.js";
+import { disturb } from "./player-path.js";
+import { playerAdjustManaPrecise } from "./loop.js";
+import { markNoscore, wizCheatDeath, } from "./wizard.js";
+/** Build the shared, complete player take_hit consequences for `state`. */
+export function makeTakeHitHooks(state, opts = {}) {
+    const recordDeath = (killer) => {
+        const p = state.actor.player;
+        /* my_strcpy(p->died_from, kb_str, ...) (L244) and total_winner = false
+         * (L255). The shell's death handler reads diedFrom for the score/tombstone
+         * and clears the active slot. */
+        p.diedFrom = killer;
+        p.totalWinner = false;
+    };
+    const cheatDeath = (killer) => {
+        const wizard = state.wizard === true;
+        const cheatLive = state.options?.get("cheat_live") === true;
+        if (!wizard && !cheatLive)
+            return false;
+        const p = state.actor.player;
+        /* C assigns died_from before get_check("Die? ") even when the answer is
+         * No and EVENT_CHEAT_DEATH follows. */
+        p.diedFrom = killer;
+        state.pendingDeath = {
+            killer,
+            resolve: (die) => {
+                state.pendingDeath = undefined;
+                if (die) {
+                    state.msg?.("You die.", "DEATH");
+                    state.sound?.(MSG.DEATH);
+                    state.isDead = true;
+                    recordDeath(killer);
+                    return;
+                }
+                state.msg?.("You invoke wizard mode and cheat death.");
+                const effect = opts.wizardEffect?.current;
+                wizCheatDeath(state, {
+                    wizard: true,
+                    /* Cheat death is gated on player->wizard || OPT(cheat_live)
+                     * (player-util.c L246), never on debug consent, and this bundle
+                     * exists only to run wizCheatDeath - so no debug command is
+                     * reachable through it. */
+                    debug: false,
+                    ...(effect ? { effect } : {}),
+                    markNoscore: (bits) => {
+                        p.noscore = markNoscore(p.noscore, bits);
+                    },
+                    msg: (t) => state.msg?.(t),
+                });
+            },
+        };
+        return "pending";
+    };
+    return {
+        /* The bloodlust death-save flavour roll (player-util.c L232). */
+        rng: state.rng,
+        onMessage: (text, msgt) => {
+            state.msg?.(text, msgt);
+            /* msgt() also plays the message-type sound (death, low-hp warning). Sound
+             * is a pure UI sink - it draws no RNG - so this restores the audible cue
+             * without perturbing the deterministic stream. */
+            if (msgt !== undefined) {
+                const code = MSG[msgt];
+                if (code !== undefined)
+                    state.sound?.(code);
+            }
+        },
+        onDisturb: () => disturb(state),
+        /* bell() on the first low-hitpoint notice (player-util.c L270). */
+        bell: () => state.sound?.(MSG.BELL),
+        onDeath: (_target, killer) => recordDeath(killer),
+        /*
+         * Wizard / cheat_live escape (player-util.c:246-248 + ui-display.c:2568):
+         * when player->wizard or OPT(cheat_live), the C asks get_check("Die? ")
+         * and on "no" signals EVENT_CHEAT_DEATH -> wiz_cheat_death(). No RNG.
+         * The shell owns the asynchronous prompt through state.pendingDeath.
+         */
+        cheatDeath,
+        /* PF_COMBAT_REGEN mana reward (player-util.c L216-222, audit 01 C1): a
+         * Blackguard turns lost hitpoints into rage-mana. take_hit already excludes
+         * poison / fatal wound / starvation before calling this, so only the flag
+         * gate and the formula remain. sp_gain = (MAX(msp,10)*65536)/mhp*dam,
+         * left-associative integer arithmetic, through player_adjust_mana_precise
+         * (no RNG). Absent p->mhp is never 0 in play. */
+        combatRegenReward: (dam) => {
+            const p = state.actor.player;
+            const hasFlag = state.playerState?.pflags.has(PF.COMBAT_REGEN) ??
+                (p.race.pflags.has(PF.COMBAT_REGEN) || p.cls.pflags.has(PF.COMBAT_REGEN));
+            if (!hasFlag || p.mhp <= 0)
+                return;
+            const spGain = Math.trunc((Math.max(p.msp, 10) * 65536) / p.mhp) * dam;
+            playerAdjustManaPrecise(p, spGain);
+        },
+    };
+}
+//# sourceMappingURL=take-hit-hooks.js.map

package/dist/game/take-hit-hooks.js.map

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

package/dist/game/target-loop.d.ts

@@ -0,0 +1,119 @@
+/**
+ * The interactive look/target browsing loop, ported from
+ * reference/src/ui-target.c: target_set_interactive's key-handling chain
+ * (L1309-1634), target_set_interactive_aux plus its aux_* handlers
+ * (L431-965), target_dir_allow (L95), and draw_path's colour rules
+ * (L1072-1167).
+ *
+ * This module is the non-rendering half: given the current keypress it
+ * decides the next cursor / interesting-grid-index / mode, and (on a
+ * selection) drives target.ts's targetSetMonster/targetSetLocation exactly
+ * as textui_target does; given a grid it builds the faithful one-line "look"
+ * description; given a projected path it returns the faithful per-grid
+ * colour. All actual screen I/O - the canvas, the camera, panels, mouse, the
+ * help banner, the keyboard listener itself - is presentation (#25) and
+ * lives in packages/web/src/main.ts's runTargetLoop, which drives this state
+ * machine and repaints from what it returns. Nothing here reads the game
+ * RNG: it only reads monster/grid/object/terrain state and calls the
+ * deterministic projectPath/targetPick geometry.
+ *
+ * Reductions (alongside target.ts's own ledger):
+ * - No panels on the web: change_panel / adjust_panel_help have no
+ *   equivalent, so a direction key that finds no new interesting grid is
+ *   simply silent (upstream's own behaviour once the retry-in-next-panel
+ *   also fails) rather than bell()ing; only an unrecognized key bells.
+ * - The per-grid content cascade (aux_monster's recall toggle, aux_object's
+ *   per-item OLIST browse, aux_trap/aux_terrain's "press space to continue")
+ *   collapses into ONE description string per grid (describeLookGrid),
+ *   showing the highest-precedence content (monster > trap > object >
+ *   terrain) instead of a press-by-press walk through all of them. A player
+ *   who wants full recall opens the existing lore/inventory screens.
+ * - Object piles: aux_object's floor_list is scanned from the player's
+ *   remembered twin chunk (square_object(player->cave, grid)); this port has
+ *   no per-object known twin (game/known.ts's own ledger), so a currently
+ *   SEEN grid describes the live pile (floorPile) and a remembered-but-
+ *   unseen grid falls back to the knownObject glyph marker ("something" /
+ *   "an object") instead of the exact remembered name/count.
+ * - draw_path's object/wall colours read square_object(player->cave, ...)
+ *   and square_isprojectable(player->cave, ...) - the player's remembered
+ *   map. Without a remembered-object list or a "believed wall" predicate
+ *   (project.ts's own note on PROJECT_INFO), this port uses the live floor
+ *   pile and the live projectability, which project.ts already documents as
+ *   the approximation for this exact, UI-only, deferred branch.
+ */
+import type { Loc } from "../loc.js";
+import type { Monster } from "../mon/monster.js";
+import type { GameState } from "./context.js";
+/**
+ * monster_desc's MDESC_IND_VIS: an indefinite-article name for a visible
+ * monster ("a kobold", "an ogre"), or the proper name for a unique. A
+ * reduction consistent with target.ts's own ledger (the race name stands in
+ * for the full monster_desc machinery).
+ */
+export declare function monsterLookName(mon: Monster): string;
+/** The monster this description named, if any (for healthWho / lore tracking). */
+export interface LookGridResult {
+    text: string;
+    mon: Monster | null;
+}
+/**
+ * target_set_interactive_aux (L981) plus its aux_reinit/aux_hallucinate/
+ * aux_monster/aux_trap/aux_object/aux_terrain handlers, folded into a single
+ * "one line, highest precedence content" description per the module's
+ * reduction note (monster > trap > object > terrain; hallucination overrides
+ * everything but the player's own grid phrasing). `mode` is accepted for call-
+ * site parity with target_set_interactive_aux (TARGET_LOOK vs TARGET_KILL)
+ * but does not change the precedence order in this single-line reduction -
+ * both modes describe the same highest-precedence content for a grid.
+ */
+export declare function describeLookGrid(state: GameState, grid: Loc, _mode: number): LookGridResult;
+/**
+ * draw_path (L1072-1167): the per-grid colour for the projected path
+ * overlay, in order (past an unknown grid, everything after reads grey;
+ * mimic/visible-monster/object/known-wall/unknown/plain).
+ */
+export declare function computePathColours(state: GameState, path: readonly Loc[]): number[];
+/** The loop's mutable UI state: cursor grid, interesting-list index, mode. */
+export interface TargetLoopUi {
+    x: number;
+    y: number;
+    /** show_interesting: browsing the interesting-grid list vs a free cursor. */
+    showInteresting: boolean;
+    targetIndex: number;
+    help: boolean;
+}
+/**
+ * target_set_interactive's init (L1282-1306), minus the panel/help-prompt
+ * screen writes (presentation): start on the player in interesting mode
+ * unless a valid starting grid is given, and cancel any existing target
+ * exactly as upstream's target_set_monster(0) does.
+ */
+export declare function initTargetLoopUi(state: GameState, startX?: number, startY?: number): TargetLoopUi;
+/** use_interesting_mode (L1311): browsing the list, and it is non-empty. */
+export declare function useInterestingLoopMode(ui: TargetLoopUi, targets: readonly Loc[]): boolean;
+/** The grid currently under the cursor (L1316-1317). */
+export declare function currentLoopGrid(ui: TargetLoopUi, targets: readonly Loc[]): Loc;
+/**
+ * target_dir_allow (L95), reduced to the web's keyset: a digit 1-9 or an
+ * arrow key resolves to a keypad direction, 0 otherwise. No keymaps exist on
+ * the web, so the allow_5/allow_esc parameters never matter here - the loop
+ * handles '5' and Escape directly, at the same precedence upstream gives
+ * them (both are intercepted before target_dir_allow is ever called).
+ */
+export declare function targetDirAllow(key: string): number;
+/** The result of one keypress through the loop. */
+export interface TargetLoopStep {
+    ui: TargetLoopUi;
+    done: boolean;
+    /** A bell() moment (an unrecognized key, or 't' on a non-target-able
+     * monster) - presentation plays the sound; nothing here touches audio. */
+    bell: boolean;
+}
+/**
+ * One keypress through target_set_interactive's key-handling chain
+ * (L1422-1632), minus mouse/panel/ignore branches that have no web equivalent.
+ * The nearest-stair '<'/'>' branches are retained as cursor-only operations;
+ * unlike navigate-up/down they do not spend energy or enqueue a player turn.
+ */
+export declare function stepTargetLoop(state: GameState, targets: readonly Loc[], ui: TargetLoopUi, key: string): TargetLoopStep;
+//# sourceMappingURL=target-loop.d.ts.map

package/dist/game/target-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-loop.d.ts","sourceRoot":"","sources":["../../src/game/target-loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAGH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AA0BjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAqB9C;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAIpD;AAkBD,kFAAkF;AAClF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;CACrB;AAmBD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,GAAG,EACT,KAAK,EAAE,MAAM,GACZ,cAAc,CAqEhB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,SAAS,GAAG,EAAE,GACnB,MAAM,EAAE,CAmCV;AAMD,8EAA8E;AAC9E,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,6EAA6E;IAC7E,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACd,YAAY,CAmBd;AAED,4EAA4E;AAC5E,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,YAAY,EAChB,OAAO,EAAE,SAAS,GAAG,EAAE,GACtB,OAAO,CAET;AAED,wDAAwD;AACxD,wBAAgB,eAAe,CAAC,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,GAAG,EAAE,GAAG,GAAG,CAI9E;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAclD;AAED,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,YAAY,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd;8EAC0E;IAC1E,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,SAAS,GAAG,EAAE,EACvB,EAAE,EAAE,YAAY,EAChB,GAAG,EAAE,MAAM,GACV,cAAc,CA0HhB"}