@rpgm-tools/neo-angband-core 0.10.0

package/dist/game/target-loop.js

@@ -0,0 +1,408 @@
+/**
+ * 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 { RF, TMD } from "../generated/index.js";
+import { DDX, DDY, distance, loc } from "../loc.js";
+import { monsterIsCamouflaged, monsterIsMimicking, monsterIsObvious, monsterIsVisible, } from "../mon/predicate.js";
+import { COLOUR_BLUE, COLOUR_L_DARK, COLOUR_L_RED, COLOUR_WHITE, COLOUR_YELLOW, } from "../color.js";
+import { describeObject } from "./describe.js";
+import { ODESC } from "../obj/desc.js";
+import { floorPile } from "./floor.js";
+import { knownObject, squareApparentLookInPreposition, squareApparentLookPrefix, squareApparentName, squareIsKnown, } from "./known.js";
+import { squareIsVisibleTrap, squareTrap } from "./trap.js";
+import { squareIsSeen } from "../world/view.js";
+import { squareMonster } from "./context.js";
+import { pathNearestKnown } from "./player-path.js";
+import { coordsDesc, lookMonDesc, targetAble, targetPick, targetSetLocation, targetSetMonster, } from "./target.js";
+/** is_a_vowel (z-util.c). */
+function isAVowel(c) {
+    return "aeiouAEIOU".includes(c);
+}
+function clamp(v, lo, hi) {
+    return Math.max(lo, Math.min(hi, v));
+}
+/**
+ * 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 function monsterLookName(mon) {
+    const n = mon.race.name;
+    if (mon.race.flags.has(RF.UNIQUE))
+        return n;
+    return `${isAVowel(n.charAt(0)) ? "an" : "a"} ${n}`;
+}
+/** The floor-object clause of a look description, or null if the grid has
+ * nothing on it (aux_object, reduced per the module doc). */
+function describeFloorAtGrid(state, grid) {
+    if (squareIsSeen(state.chunk, grid)) {
+        const pile = floorPile(state, grid);
+        if (pile.length > 1)
+            return `a pile of ${pile.length} objects`;
+        if (pile.length === 1) {
+            return describeObject(state, pile[0], ODESC.PREFIX | ODESC.FULL);
+        }
+        return null;
+    }
+    const mem = knownObject(state, grid);
+    if (!mem)
+        return null;
+    return mem.ch === null ? "something" : "an object";
+}
+/**
+ * The wizard-mode tail every aux_* description carries (ui-target.c L400-407,
+ * L483-487, L559-563, L717-721, L790-793, L915-918): where an ordinary look line
+ * ends "..., <coords>.", a wizard's ends "..., <coords> (y:x, noise=N, scent=N).".
+ * The same seven-site pattern in the C, so it lives in one place here.
+ *
+ * cave->noise.grids[y][x] / cave->scent.grids[y][x] are the flow maps the port
+ * keeps as flat y*width+x arrays (the same ones do_cmd_wiz_peek_noise_scent
+ * walks, see game/wizard.ts wizPeekFlow).
+ */
+function lookTail(state, grid) {
+    if (state.wizard !== true)
+        return ".";
+    const c = state.chunk;
+    const i = grid.y * c.width + grid.x;
+    return ` (${grid.y}:${grid.x}, noise=${c.noise[i] ?? 0}, scent=${c.scent[i] ?? 0}).`;
+}
+/**
+ * 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 function describeLookGrid(state, grid, _mode) {
+    const coords = coordsDesc(state, grid);
+    /* aux_reinit (L431-468): phrase1/phrase2. */
+    let phrase1;
+    let phrase2;
+    if (state.chunk.mon(grid) < 0) {
+        phrase1 = "You are ";
+        phrase2 = "on ";
+    }
+    else if (squareIsSeen(state.chunk, grid)) {
+        phrase1 = "You see ";
+        phrase2 = "";
+    }
+    else {
+        const seenMon = squareMonster(state, grid);
+        phrase1 = seenMon && monsterIsObvious(seenMon) ? "You sense " : "You recall ";
+        phrase2 = "";
+    }
+    /* aux_hallucinate (L473-508). */
+    if ((state.actor.player.timed[TMD.IMAGE] ?? 0) > 0) {
+        return {
+            text: `${phrase1}${phrase2}something strange, ${coords}${lookTail(state, grid)}`,
+            mon: null,
+        };
+    }
+    /* aux_monster (L516-691, reduced: no carried-object / recall sub-loop). The
+     * wizard-only "She is carrying <object>" walk over mon->held_obj (L622-687) is
+     * part of that same absent sub-loop - it is an interactive keypress loop, not a
+     * line, so it lands with the sub-loop port and not with the wizard tail. */
+    const mon = squareMonster(state, grid);
+    if (mon && monsterIsObvious(mon)) {
+        const name = monsterLookName(mon);
+        const health = lookMonDesc(mon);
+        return {
+            text: `${phrase1}${phrase2}${name} (${health}), ${coords}${lookTail(state, grid)}`,
+            mon,
+        };
+    }
+    /* aux_trap (L696-758). */
+    if (squareIsVisibleTrap(state, grid)) {
+        const trap = squareTrap(state, grid)[0];
+        if (trap) {
+            const art = isAVowel(trap.kind.desc.charAt(0)) ? "an " : "a ";
+            return {
+                text: `${phrase1}${phrase2}${art}${trap.kind.desc}, ${coords}${lookTail(state, grid)}`,
+                mon: null,
+            };
+        }
+    }
+    /* aux_object (L763-888, reduced per the module doc). */
+    const objDesc = describeFloorAtGrid(state, grid);
+    if (objDesc) {
+        return {
+            text: `${phrase1}${phrase2}${objDesc}, ${coords}${lookTail(state, grid)}`,
+            mon: null,
+        };
+    }
+    /* aux_terrain (L893-950): shown whenever nothing else claimed the grid. */
+    const name = squareApparentName(state, grid);
+    const lphrase2 = phrase2 ? squareApparentLookInPreposition(state, grid) : "";
+    const lphrase3 = squareApparentLookPrefix(state, grid);
+    return {
+        text: `${phrase1}${lphrase2}${lphrase3}${name}, ${coords}${lookTail(state, grid)}`,
+        mon: null,
+    };
+}
+/**
+ * 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 function computePathColours(state, path) {
+    let pastKnown = false;
+    const out = [];
+    for (const grid of path) {
+        let colour;
+        const mon = squareMonster(state, grid);
+        const hasObj = floorPile(state, grid).length > 0;
+        if (pastKnown) {
+            colour = COLOUR_L_DARK;
+        }
+        else if (mon && monsterIsVisible(mon)) {
+            if (monsterIsMimicking(mon)) {
+                colour = COLOUR_YELLOW;
+            }
+            else if (!monsterIsCamouflaged(mon)) {
+                colour = COLOUR_L_RED;
+            }
+            else if (hasObj) {
+                colour = COLOUR_YELLOW;
+            }
+            else if (squareIsKnown(state, grid) && !state.chunk.isProjectable(grid)) {
+                colour = COLOUR_BLUE;
+            }
+            else {
+                colour = COLOUR_WHITE;
+            }
+        }
+        else if (hasObj) {
+            colour = COLOUR_YELLOW;
+        }
+        else if (squareIsKnown(state, grid) && !state.chunk.isProjectable(grid)) {
+            colour = COLOUR_BLUE;
+        }
+        else if (!squareIsKnown(state, grid)) {
+            pastKnown = true;
+            colour = COLOUR_L_DARK;
+        }
+        else {
+            colour = COLOUR_WHITE;
+        }
+        out.push(colour);
+    }
+    return out;
+}
+/**
+ * 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 function initTargetLoopUi(state, startX, startY) {
+    let x;
+    let y;
+    let showInteresting;
+    if (startX === undefined ||
+        startY === undefined ||
+        !state.chunk.inBoundsFully(loc(startX, startY))) {
+        x = state.actor.grid.x;
+        y = state.actor.grid.y;
+        showInteresting = true;
+    }
+    else {
+        x = startX;
+        y = startY;
+        showInteresting = false;
+    }
+    targetSetMonster(state, null);
+    return { x, y, showInteresting, targetIndex: 0, help: false };
+}
+/** use_interesting_mode (L1311): browsing the list, and it is non-empty. */
+export function useInterestingLoopMode(ui, targets) {
+    return ui.showInteresting && targets.length > 0;
+}
+/** The grid currently under the cursor (L1316-1317). */
+export function currentLoopGrid(ui, targets) {
+    return useInterestingLoopMode(ui, targets)
+        ? targets[ui.targetIndex]
+        : loc(ui.x, ui.y);
+}
+/**
+ * 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 function targetDirAllow(key) {
+    if (/^[1-9]$/.test(key))
+        return Number(key);
+    switch (key) {
+        case "ArrowDown":
+            return 2;
+        case "ArrowLeft":
+            return 4;
+        case "ArrowRight":
+            return 6;
+        case "ArrowUp":
+            return 8;
+        default:
+            return 0;
+    }
+}
+/**
+ * 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 function stepTargetLoop(state, targets, ui, key) {
+    const interesting = useInterestingLoopMode(ui, targets);
+    if (key === "Escape" || key === "q") {
+        return { ui, done: true, bell: false };
+    }
+    if (key === " " || key === "*" || key === "+") {
+        if (interesting) {
+            const next = (ui.targetIndex + 1) % targets.length;
+            return { ui: { ...ui, targetIndex: next }, done: false, bell: false };
+        }
+        return { ui, done: false, bell: false };
+    }
+    if (key === "-") {
+        if (interesting) {
+            const next = (ui.targetIndex - 1 + targets.length) % targets.length;
+            return { ui: { ...ui, targetIndex: next }, done: false, bell: false };
+        }
+        return { ui, done: false, bell: false };
+    }
+    if (key === "p") {
+        return {
+            ui: {
+                ...ui,
+                x: state.actor.grid.x,
+                y: state.actor.grid.y,
+                showInteresting: false,
+            },
+            done: false,
+            bell: false,
+        };
+    }
+    if (key === "o") {
+        return { ui: { ...ui, showInteresting: false }, done: false, bell: false };
+    }
+    if (key === "m") {
+        if (!interesting && targets.length > 0) {
+            const cur = loc(ui.x, ui.y);
+            let bestIndex = 0;
+            let bestDist = Infinity;
+            for (let i = 0; i < targets.length; i++) {
+                const d = distance(cur, targets[i]);
+                if (d < bestDist) {
+                    bestDist = d;
+                    bestIndex = i;
+                }
+            }
+            return {
+                ui: { ...ui, showInteresting: true, targetIndex: bestIndex },
+                done: false,
+                bell: false,
+            };
+        }
+        return { ui, done: false, bell: false };
+    }
+    /* target_set_interactive's nearest-known-stair branches (ui-target.c
+     * L1506-1542): search from the cursor, not from the player, and move only
+     * the target cursor. This is UI navigation, so it draws no RNG and spends
+     * no energy; the web caller repaints the target panel after this step. */
+    if (key === ">" || key === "<") {
+        const start = currentLoopGrid(ui, targets);
+        const found = pathNearestKnown(state, start, key === ">"
+            ? (s, grid) => s.chunk.isDownstairs(grid)
+            : (s, grid) => s.chunk.isUpstairs(grid));
+        if (found.length > 0) {
+            return {
+                ui: { ...ui, x: found.dest.x, y: found.dest.y, showInteresting: false },
+                done: false,
+                bell: false,
+            };
+        }
+        return { ui, done: false, bell: true };
+    }
+    if (key === "t" || key === "5" || key === "0" || key === ".") {
+        if (interesting) {
+            const cur = currentLoopGrid(ui, targets);
+            const mon = squareMonster(state, cur);
+            if (targetAble(state, mon)) {
+                /* Monster race and health are tracked by the caller's
+                 * describeLookGrid, matching upstream's own aux_monster. */
+                targetSetMonster(state, mon);
+                return { ui, done: true, bell: false };
+            }
+            return { ui, done: false, bell: true };
+        }
+        targetSetLocation(state, loc(ui.x, ui.y));
+        return { ui, done: true, bell: false };
+    }
+    if (key === "?") {
+        return { ui: { ...ui, help: !ui.help }, done: false, bell: false };
+    }
+    const dir = targetDirAllow(key);
+    if (!dir) {
+        return { ui, done: false, bell: true };
+    }
+    if (interesting) {
+        const cur = currentLoopGrid(ui, targets);
+        const ni = targetPick(cur.y, cur.x, DDY[dir], DDX[dir], targets);
+        /* No panels on the web (change_panel is a no-op reduction): a miss
+         * here stays SILENT, exactly as upstream once the retry-in-the-next-
+         * panel also fails - only an unrecognized key (dir === 0) bells. */
+        if (ni >= 0) {
+            return { ui: { ...ui, targetIndex: ni }, done: false, bell: false };
+        }
+        return { ui, done: false, bell: false };
+    }
+    const nx = clamp(ui.x + DDX[dir], 1, state.chunk.width - 2);
+    const ny = clamp(ui.y + DDY[dir], 1, state.chunk.height - 2);
+    return { ui: { ...ui, x: nx, y: ny }, done: false, bell: false };
+}
+//# sourceMappingURL=target-loop.js.map

package/dist/game/target-loop.js.map

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

package/dist/game/target.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Targeting, ported from reference/src/target.c (Angband 4.2.6): the
+ * player's persistent target (a monster or a location), the target-able
+ * test, the fix/release protocol that keeps a mid-spell target's grid
+ * alive after the monster dies, the interesting-grid scan the look/target
+ * UI walks, and target_set_closest.
+ *
+ * The upstream file-statics (target_set, target_fixed, target, old_target)
+ * live on GameState.target (a TargetState) so saves/tests stay explicit.
+ * The interactive half of targeting (ui-target.c: the * key browsing loop,
+ * panels, prompts) rides presentation (#25); this module is the complete
+ * bookkeeping half those menus drive, and effect handlers reach it through
+ * the aimed seam (obj-cmd / spell-cmd resolve DIR_TARGET through
+ * targetOkay + targetGet exactly as the upstream handlers do).
+ *
+ * Reductions, ledgered in parity/ledger/game-target.yaml: monster names use
+ * the full monster_desc grammar (mon/desc.ts), panel restriction is an
+ * injected predicate defaulting to "everything" (panels are UI state),
+ * ignore_known_item_ok treats no known objects as ignored (ignore is a
+ * later #24 slice), and monster_race_track is lore's (healthWho covers
+ * health_track).
+ */
+import type { Loc } from "../loc.js";
+import type { Monster } from "../mon/monster.js";
+import type { GameState } from "./context.js";
+/** Bit flags for target_get_monsters / target_set_closest (target.h). */
+export declare const TARGET: {
+    readonly KILL: 1;
+    readonly LOOK: 2;
+    readonly XTRA: 4;
+    readonly GRID: 8;
+    readonly QUIET: 16;
+};
+/**
+ * The target.c file-statics: whether a target is set, whether it is fixed
+ * for the duration of a spell, the current target (monster index + grid)
+ * and the saved old target the release step inspects.
+ */
+export interface TargetState {
+    /** target_set. */
+    set: boolean;
+    /** target_fixed. */
+    fixed: boolean;
+    /** target.midx (0 = a location target or none). */
+    midx: number;
+    /** target.grid. */
+    grid: Loc;
+    /** old_target, saved by targetFix. */
+    oldMidx: number;
+    oldGrid: Loc;
+}
+/** A fresh, unset target. */
+export declare function newTargetState(): TargetState;
+/**
+ * look_mon_desc (L56): the monster health/status description ("wounded,
+ * asleep, afraid"). PROBE and the look UI read it.
+ */
+export declare function lookMonDesc(mon: Monster): string;
+/**
+ * target_able (L110): a reasonable target is an obvious monster the player
+ * could hit with a projection while not hallucinating.
+ */
+export declare function targetAble(state: GameState, mon: Monster | null): boolean;
+/**
+ * target_okay (L124): update (a monster target's grid follows the monster)
+ * and verify the target.
+ */
+export declare function targetOkay(state: GameState): boolean;
+/**
+ * target_set_monster (L152): set the target to a monster (or nobody); if
+ * the target is fixed, keep the grid so further effects of a spell that
+ * killed the monster still have somewhere to land.
+ */
+export declare function targetSetMonster(state: GameState, mon: Monster | null): boolean;
+/** target_set_location (L180): target a legal (fully in-bounds) grid. */
+export declare function targetSetLocation(state: GameState, grid: Loc): void;
+/** target_is_set (L203). */
+export declare function targetIsSet(state: GameState): boolean;
+/** target_fix (L211): freeze the target for the duration of a spell. */
+export declare function targetFix(state: GameState): void;
+/**
+ * target_release (L220): unfreeze; if the old target is a now-dead (or no
+ * longer viewed) monster, cancel the grid.
+ */
+export declare function targetRelease(state: GameState): void;
+/**
+ * target_pick (L276): from a set of interesting points, pick the closest
+ * in (roughly) the given direction from (x1, y1). Returns the index into
+ * `targets`, or -1. The look UI's direction-key cycling drives it.
+ */
+export declare function targetPick(y1: number, x1: number, dy: number, dx: number, targets: readonly Loc[]): number;
+/**
+ * target_accept (L325): is a grid "interesting" (the look/target scan
+ * stops on it)? Player grid, obvious monsters, visible traps, remembered
+ * objects and remembered interesting terrain qualify; hallucination blanks
+ * everything but the player.
+ */
+export declare function targetAccept(state: GameState, grid: Loc): boolean;
+/**
+ * coords_desc (L370): a location relative to the player, e.g.
+ * "12 S, 35 W".
+ */
+export declare function coordsDesc(state: GameState, grid: Loc): string;
+/** target_get (L395): the currently targeted location. */
+export declare function targetGet(state: GameState): Loc;
+/** target_get_monster (L405): the currently targeted monster, or null. */
+export declare function targetGetMonster(state: GameState): Monster | null;
+/**
+ * target_sighted (L414): the current target is in line of sight. The panel
+ * test is the UI's (#25); an injected predicate stands in, defaulting to
+ * everything on-panel.
+ */
+export declare function targetSighted(state: GameState, panelContains?: (grid: Loc) => boolean): boolean;
+/**
+ * target_get_monsters (L437): the interesting locations, sorted by
+ * distance to the player. With TARGET.KILL only target-able monsters
+ * matching `pred` are included. Panel restriction is injected (upstream's
+ * restrict_to_panel); absent, the scan covers max_range around the player
+ * as the upstream else-branch does.
+ */
+export declare function targetGetMonsters(state: GameState, mode: number, pred?: (mon: Monster) => boolean, panel?: {
+    minY: number;
+    minX: number;
+    maxY: number;
+    maxX: number;
+}): Loc[];
+/**
+ * target_set_closest (L493): target the closest (target-able, matching)
+ * monster, announcing it and tracking its health. Returns false (with
+ * "No Available Target.") when nothing qualifies.
+ */
+export declare function targetSetClosest(state: GameState, mode: number, pred?: (mon: Monster) => boolean): boolean;
+//# sourceMappingURL=target.d.ts.map

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

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