@rpgm-tools/neo-angband-core 0.10.0

package/dist/world/projection.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Projection runtime data and player damage-vs-resistance scaling, ported from
+ * reference/src/project.h (struct projection, loaded from projection.txt) and
+ * reference/src/project-player.c adjust_dam (L48), Angband 4.2.6.
+ *
+ * The generated projections.ts carries only the PROJ names / enum. The
+ * behavioural data - the resistance numerator / denominator, the damage
+ * divisor and cap, and the obvious / wake flags project_m and project_p read -
+ * lives in projection.json and is bound here into ProjectionInfo[], indexed by
+ * PROJ value.
+ *
+ * adjust_dam is the player-side analog of project-mon.c's resist helpers: it
+ * scales incoming damage by the player's resistance level for the projection
+ * type. It stays pure - the caller looks up the resistance (with the ICE->COLD
+ * remap and equip_learn side effect) and passes it in, exactly the split the
+ * effect handlers and project_p need.
+ *
+ * desc / playerDesc / lashDesc are the display-only strings (struct
+ * projection's desc / player_desc / lash_desc) consumed by
+ * effects/effect-info.ts (effect_projection, effect_describe): desc is always
+ * present; playerDesc and lashDesc are absent (null) for projection types the
+ * pack never gives a "player-desc" / "lash-desc" line, exactly as upstream
+ * leaves those fields NULL.
+ */
+import { Dice } from "../dice.js";
+import type { Aspect, Rng } from "../rng.js";
+/** struct projection: the behavioural data for one PROJ_ type. */
+export interface ProjectionInfo {
+    /** PROJ_ value (index into the table). */
+    index: number;
+    /** Upstream code, e.g. "ACID". */
+    code: string;
+    /** In-game name, e.g. "acid". */
+    name: string;
+    /** "element" | "environs" | "monster". */
+    type: string;
+    /** Resistance numerator (0 when the type has no variable resistance). */
+    numerator: number;
+    /** Resistance denominator dice ("3", "8+1d4"), or null when absent. */
+    denominator: Dice | null;
+    /** diameter-of-source divisor (default 1). */
+    divisor: number;
+    /** Maximum damage the projection can deal (0 when uncapped/absent). */
+    damageCap: number;
+    /** Whether the effect's nature is obvious to the player. */
+    obvious: boolean;
+    /** Whether the projection forces affected monsters awake. */
+    wake: boolean;
+    /** MSG_ type name for messaging, or null. */
+    msgt: string | null;
+    /** Colour name (resolved to an attr by the render layer). */
+    color: string | null;
+    /** "hit by X" description used when the player cannot see the source. */
+    blindDesc: string | null;
+    /** Generic description ("acid", "fear", ...); always present. */
+    desc: string;
+    /** Description as experienced by the player ("acid", "frost", ...), or null. */
+    playerDesc: string | null;
+    /** Description for the LASH effect handler ("acid", "venom", ...), or null. */
+    lashDesc: string | null;
+}
+/** One projection.json record (only the fields bound here are typed). */
+export interface ProjectionRecordJson {
+    code: string;
+    name?: string;
+    type: string;
+    numerator?: number;
+    denominator?: string;
+    divisor?: number;
+    "damage-cap"?: number;
+    obvious?: number;
+    wake?: number;
+    msgt?: string;
+    color?: string;
+    desc?: string;
+    "player-desc"?: string;
+    "lash-desc"?: string;
+    "blind-desc"?: string;
+}
+/**
+ * Bind projection.json into a ProjectionInfo table indexed by PROJ value. The
+ * projection.txt / .json record order does NOT match the PROJ enum (upstream
+ * matches records to slots by code at load), so each record is placed at its
+ * resolved PROJ[code] slot. An unknown code, or an unfilled or duplicated slot,
+ * throws so pack / codegen drift is caught at load.
+ */
+export declare function bindProjections(records: ProjectionRecordJson[]): ProjectionInfo[];
+/**
+ * adjust_dam: scale `dam` for the player's `resistLevel` against projection
+ * `type`. resistLevel is the caller-supplied el_info[res_type].res_level (the
+ * caller applies the ICE->COLD remap and any equip-learn side effect): 3 is
+ * immune, -1 vulnerable, positive values each divide by numerator/denominator.
+ *
+ * `minusAc` is minus_ac(p): acid damage is halved when the player has armour
+ * that acid can damage. Immunity and vulnerability short-circuit exactly as
+ * upstream; the variable-resist denominator is evaluated with the aspect
+ * inverted (least damage uses the largest divisor).
+ */
+export declare function adjustDam(rng: Rng, projections: readonly ProjectionInfo[], type: number, dam: number, aspect: Aspect, resistLevel: number, minusAc?: boolean): number;
+//# sourceMappingURL=projection.d.ts.map

package/dist/world/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../src/world/projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAI7C,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,OAAO,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,IAAI,EAAE,OAAO,CAAC;IACd,6CAA6C;IAC7C,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,yEAAyE;IACzE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,yEAAyE;AACzE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,oBAAoB,EAAE,GAC9B,cAAc,EAAE,CA8ElB;AAOD;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,GAAG,EACR,WAAW,EAAE,SAAS,cAAc,EAAE,EACtC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,OAAO,UAAQ,GACd,MAAM,CA6BR"}

package/dist/world/projection.js

@@ -0,0 +1,152 @@
+/**
+ * Projection runtime data and player damage-vs-resistance scaling, ported from
+ * reference/src/project.h (struct projection, loaded from projection.txt) and
+ * reference/src/project-player.c adjust_dam (L48), Angband 4.2.6.
+ *
+ * The generated projections.ts carries only the PROJ names / enum. The
+ * behavioural data - the resistance numerator / denominator, the damage
+ * divisor and cap, and the obvious / wake flags project_m and project_p read -
+ * lives in projection.json and is bound here into ProjectionInfo[], indexed by
+ * PROJ value.
+ *
+ * adjust_dam is the player-side analog of project-mon.c's resist helpers: it
+ * scales incoming damage by the player's resistance level for the projection
+ * type. It stays pure - the caller looks up the resistance (with the ICE->COLD
+ * remap and equip_learn side effect) and passes it in, exactly the split the
+ * effect handlers and project_p need.
+ *
+ * desc / playerDesc / lashDesc are the display-only strings (struct
+ * projection's desc / player_desc / lash_desc) consumed by
+ * effects/effect-info.ts (effect_projection, effect_describe): desc is always
+ * present; playerDesc and lashDesc are absent (null) for projection types the
+ * pack never gives a "player-desc" / "lash-desc" line, exactly as upstream
+ * leaves those fields NULL.
+ */
+import { Dice } from "../dice.js";
+import { ELEMENT_ENTRIES, PROJ, PROJECTION_ENTRIES } from "../generated/index.js";
+import { messageLookupByName } from "../sound/engine.js";
+/**
+ * Bind projection.json into a ProjectionInfo table indexed by PROJ value. The
+ * projection.txt / .json record order does NOT match the PROJ enum (upstream
+ * matches records to slots by code at load), so each record is placed at its
+ * resolved PROJ[code] slot. An unknown code, or an unfilled or duplicated slot,
+ * throws so pack / codegen drift is caught at load.
+ */
+export function bindProjections(records) {
+    /* 25 elements (list-elements.h) precede the list-projections.h entries. */
+    const total = PROJECTION_ENTRIES.length + ELEMENT_ENTRIES.length;
+    const out = new Array(total).fill(null);
+    /*
+     * parse_projection_code (obj-init.c) numbers records sequentially and
+     * returns PARSE_ERROR_ELEMENT_NAME_MISMATCH when a record whose position is
+     * below ELEM_MAX does not carry element_names[position] as its code
+     * (proj.c test_code_mismatch0). Binding below is by code, so position would
+     * otherwise be free - but el_info[] is indexed by ELEM value and the
+     * ordering invariant is what upstream relies on to keep the two in step, so
+     * the port enforces it too, on the same input, before binding anything.
+     *
+     * A record that is absent entirely is NOT this error: upstream never runs
+     * the check for a position no record reached, and reports the short file as
+     * PARSE_ERROR_TOO_FEW_ENTRIES from finish_parse_projection instead. That is
+     * the "no record for PROJ value" throw at the bottom of this function, so
+     * missing positions are deliberately skipped here.
+     */
+    for (let i = 0; i < ELEMENT_ENTRIES.length && i < records.length; i++) {
+        const rec = records[i];
+        const expected = ELEMENT_ENTRIES[i].name;
+        if (rec.code !== expected) {
+            throw new Error(`projection: record ${String(i)} is ${rec.code}, expected the ` +
+                `element ${expected} (PARSE_ERROR_ELEMENT_NAME_MISMATCH)`);
+        }
+    }
+    for (const rec of records) {
+        const index = PROJ[rec.code];
+        if (index === undefined) {
+            throw new Error(`projection: unknown code ${rec.code}`);
+        }
+        if (out[index]) {
+            throw new Error(`projection: duplicate code ${rec.code}`);
+        }
+        /* parse_projection_message_type: an unknown MSG_ name is
+         * PARSE_ERROR_INVALID_MESSAGE (proj.c test_msgt_bad0). */
+        if (rec.msgt !== undefined && messageLookupByName(rec.msgt) < 0) {
+            throw new Error(`projection: ${rec.code}: invalid msgt ${rec.msgt} ` +
+                `(PARSE_ERROR_INVALID_MESSAGE)`);
+        }
+        let denominator = null;
+        if (rec.denominator !== undefined) {
+            denominator = new Dice();
+            denominator.parseString(rec.denominator);
+        }
+        out[index] = {
+            index,
+            code: rec.code,
+            name: rec.name ?? rec.code,
+            type: rec.type,
+            numerator: rec.numerator ?? 0,
+            denominator,
+            divisor: rec.divisor ?? 1,
+            damageCap: rec["damage-cap"] ?? 0,
+            obvious: rec.obvious === 1,
+            wake: rec.wake === 1,
+            msgt: rec.msgt ?? null,
+            color: rec.color ?? null,
+            blindDesc: rec["blind-desc"] ?? null,
+            desc: rec.desc ?? "",
+            playerDesc: rec["player-desc"] ?? null,
+            lashDesc: rec["lash-desc"] ?? null,
+        };
+    }
+    for (let i = 0; i < total; i++) {
+        if (!out[i])
+            throw new Error(`projection: no record for PROJ value ${i}`);
+    }
+    return out;
+}
+/** RES_LEVEL that means full immunity (el_info res_level 3). */
+const RESIST_IMMUNE = 3;
+/** RES_LEVEL that means vulnerability. */
+const RESIST_VULNERABLE = -1;
+/**
+ * adjust_dam: scale `dam` for the player's `resistLevel` against projection
+ * `type`. resistLevel is the caller-supplied el_info[res_type].res_level (the
+ * caller applies the ICE->COLD remap and any equip-learn side effect): 3 is
+ * immune, -1 vulnerable, positive values each divide by numerator/denominator.
+ *
+ * `minusAc` is minus_ac(p): acid damage is halved when the player has armour
+ * that acid can damage. Immunity and vulnerability short-circuit exactly as
+ * upstream; the variable-resist denominator is evaluated with the aspect
+ * inverted (least damage uses the largest divisor).
+ */
+export function adjustDam(rng, projections, type, dam, aspect, resistLevel, minusAc = false) {
+    /* Immune */
+    if (resistLevel === RESIST_IMMUNE)
+        return 0;
+    /* Hack - acid damage is halved by armour. */
+    if (type === PROJ.ACID && minusAc)
+        dam = Math.trunc((dam + 1) / 2);
+    /* Vulnerable */
+    if (resistLevel === RESIST_VULNERABLE)
+        return Math.trunc((dam * 4) / 3);
+    const info = projections[type];
+    let denom = 0;
+    if (info && info.denominator) {
+        /*
+         * Variable resists vary the denominator, so invert the aspect: the
+         * minimum damage uses the maximum divisor and vice versa.
+         */
+        let denomAspect = aspect;
+        if (aspect === "minimise")
+            denomAspect = "maximise";
+        else if (aspect === "maximise")
+            denomAspect = "minimise";
+        denom = info.denominator.evaluate(rng, 0, denomAspect);
+    }
+    const numerator = info ? info.numerator : 0;
+    for (let i = resistLevel; i > 0; i--) {
+        if (denom)
+            dam = Math.trunc((dam * numerator) / denom);
+    }
+    return dam;
+}
+//# sourceMappingURL=projection.js.map

package/dist/world/projection.js.map

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

package/dist/world/scatter.d.ts

@@ -0,0 +1,25 @@
+/**
+ * scatter / scatter_ext from cave.c: randomly selected locations near a
+ * grid, fully in bounds, optionally in line of sight and satisfying a
+ * predicate.
+ *
+ * Upstream provenance: reference/src/cave.c (scatter, scatter_ext).
+ */
+import type { Loc } from "../loc.js";
+import type { Rng } from "../rng.js";
+import type { Chunk } from "./chunk.js";
+export type ScatterPred = (c: Chunk, grid: Loc) => boolean;
+/**
+ * Find up to n distinct random locations within distance d of grid.
+ * Mirrors scatter_ext: collect every feasible grid in the (2d+1)^2 box
+ * (skipping the exact-distance check when d <= 1, as upstream does),
+ * then draw without replacement using rng.randint0.
+ */
+export declare function scatterExt(c: Chunk, rng: Rng, n: number, grid: Loc, d: number, needLos: boolean, pred?: ScatterPred): Loc[];
+/**
+ * scatter: the single-location convenience wrapper. Returns the found
+ * location, or null when no feasible grid exists (upstream leaves the
+ * output loc untouched in that case; callers there always pre-fill it).
+ */
+export declare function scatter(c: Chunk, rng: Rng, grid: Loc, d: number, needLos: boolean): Loc | null;
+//# sourceMappingURL=scatter.d.ts.map

package/dist/world/scatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scatter.d.ts","sourceRoot":"","sources":["../../src/world/scatter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxC,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC;AAE3D;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,CAAC,EAAE,KAAK,EACR,GAAG,EAAE,GAAG,EACR,CAAC,EAAE,MAAM,EACT,IAAI,EAAE,GAAG,EACT,CAAC,EAAE,MAAM,EACT,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,WAAW,GACjB,GAAG,EAAE,CAwBP;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CACrB,CAAC,EAAE,KAAK,EACR,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,GAAG,EACT,CAAC,EAAE,MAAM,EACT,OAAO,EAAE,OAAO,GACf,GAAG,GAAG,IAAI,CAGZ"}

package/dist/world/scatter.js

@@ -0,0 +1,54 @@
+/**
+ * scatter / scatter_ext from cave.c: randomly selected locations near a
+ * grid, fully in bounds, optionally in line of sight and satisfying a
+ * predicate.
+ *
+ * Upstream provenance: reference/src/cave.c (scatter, scatter_ext).
+ */
+import { distance } from "../loc.js";
+import { loc } from "../loc.js";
+import { los } from "./view.js";
+/**
+ * Find up to n distinct random locations within distance d of grid.
+ * Mirrors scatter_ext: collect every feasible grid in the (2d+1)^2 box
+ * (skipping the exact-distance check when d <= 1, as upstream does),
+ * then draw without replacement using rng.randint0.
+ */
+export function scatterExt(c, rng, n, grid, d, needLos, pred) {
+    const feas = [];
+    for (let y = grid.y - d; y <= grid.y + d; y++) {
+        for (let x = grid.x - d; x <= grid.x + d; x++) {
+            const g = loc(x, y);
+            if (!c.inBoundsFully(g))
+                continue;
+            if (d > 1 && distance(grid, g) > d)
+                continue;
+            if (needLos && !los(c, grid, g))
+                continue;
+            if (pred && !pred(c, g))
+                continue;
+            feas.push(g);
+        }
+    }
+    const places = [];
+    let nfeas = feas.length;
+    while (places.length < n && nfeas > 0) {
+        const choice = rng.randint0(nfeas);
+        // feas entries below nfeas are always defined; the picked one is
+        // replaced by the last feasible entry, exactly as upstream shifts.
+        places.push(feas[choice]);
+        nfeas--;
+        feas[choice] = feas[nfeas];
+    }
+    return places;
+}
+/**
+ * scatter: the single-location convenience wrapper. Returns the found
+ * location, or null when no feasible grid exists (upstream leaves the
+ * output loc untouched in that case; callers there always pre-fill it).
+ */
+export function scatter(c, rng, grid, d, needLos) {
+    const found = scatterExt(c, rng, 1, grid, d, needLos);
+    return found.length > 0 ? found[0] : null;
+}
+//# sourceMappingURL=scatter.js.map

package/dist/world/scatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scatter.js","sourceRoot":"","sources":["../../src/world/scatter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAGhC,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAIhC;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CACxB,CAAQ,EACR,GAAQ,EACR,CAAS,EACT,IAAS,EACT,CAAS,EACT,OAAgB,EAChB,IAAkB;IAElB,MAAM,IAAI,GAAU,EAAE,CAAC;IACvB,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9C,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;gBAAE,SAAS;YAClC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC7C,IAAI,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;gBAAE,SAAS;YAC1C,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;gBAAE,SAAS;YAClC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACf,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAU,EAAE,CAAC;IACzB,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;IACxB,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACnC,iEAAiE;QACjE,mEAAmE;QACnE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAQ,CAAC,CAAC;QACjC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAQ,CAAC;IACpC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CACrB,CAAQ,EACR,GAAQ,EACR,IAAS,EACT,CAAS,EACT,OAAgB;IAEhB,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IACtD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAE,KAAK,CAAC,CAAC,CAAS,CAAC,CAAC,CAAC,IAAI,CAAC;AACrD,CAAC"}

package/dist/world/trap.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Trap kinds bound from trap.json (upstream lib/gamedata/trap.txt via
+ * init.c parse_trap_*), ported from the data half of reference/src/trap.c
+ * (Angband 4.2.6). Pure data: the live trap instances and their behaviour
+ * live in game/trap.ts (they mutate GameState).
+ *
+ * The "visibility" line is the kind's power random-value (rolled at
+ * placement against trap_level and matched against the SEARCH skill when
+ * revealing). Effects stay raw EffectRecordJson chains, built per
+ * activation exactly like object effects (game/obj-cmd.ts).
+ */
+import { FlagSet } from "../bitflag.js";
+import type { RandomValue } from "../rng.js";
+import type { EffectRecordJson } from "../obj/types.js";
+/** TRF_SIZE = FLAG_SIZE(TRF_MAX): byte size of a trap FlagSet. */
+export declare const TRF_SIZE: number;
+/** struct trap_kind. */
+export interface TrapKind {
+    /** Index in the bound table (t_idx). */
+    tidx: number;
+    /** Short name ("pit"); lookup_trap matches on desc. */
+    name: string;
+    /** Longer description used by lookup_trap ("spiked pit"). */
+    desc: string;
+    /**
+     * trap->text (trap.c parse_trap_desc / init.c L1887): the long recall
+     * paragraph shown by trap_lore (ui-knowledge.c L2588). Compiled from the
+     * JSON `desc` lines; empty when the record has none.
+     */
+    text: string;
+    glyph: string;
+    color: string;
+    /** appear: rarity (0 = never placed randomly), min depth, max number. */
+    rarity: number;
+    minDepth: number;
+    maxNum: number;
+    /** visibility: the power random-value. */
+    power: RandomValue;
+    flags: FlagSet;
+    effect: EffectRecordJson[];
+    effectXtra: EffectRecordJson[];
+    /** save: OF_ flag indexes that let the player evade entirely. */
+    saveFlags: number[];
+    msg: string;
+    msgGood: string;
+    msgBad: string;
+    msgXtra: string;
+}
+/** trap.json record shape (compiled from trap.txt). */
+export interface TrapRecordJson {
+    name: {
+        name: string;
+        desc: string;
+    };
+    graphics: {
+        glyph: string;
+        color: string;
+    };
+    appear?: {
+        rarity: number;
+        mindepth: number;
+        maxnum: number;
+    };
+    visibility?: string;
+    flags?: string[];
+    effect?: EffectRecordJson[];
+    "effect-xtra"?: EffectRecordJson[];
+    save?: string;
+    desc?: string[];
+    msg?: string[];
+    "msg-good"?: string[];
+    "msg-bad"?: string[];
+    "msg-xtra"?: string[];
+}
+/** Bind trap.json records into the trap_kind table (index = t_idx). */
+export declare function bindTraps(records: readonly TrapRecordJson[]): TrapKind[];
+/**
+ * lookup_trap (trap.c:44-63): exact desc match wins, otherwise the FIRST close
+ * match. The two tests differ in case sensitivity and the port had them the same:
+ * equality is `streq` (:54) but the close match is `my_stristr` (:57), i.e.
+ * case-INsensitive. Found by W1-CITED.
+ */
+export declare function lookupTrap(kinds: readonly TrapKind[], desc: string): TrapKind | null;
+//# sourceMappingURL=trap.d.ts.map

package/dist/world/trap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trap.d.ts","sourceRoot":"","sources":["../../src/world/trap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAY,MAAM,eAAe,CAAC;AAIlD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,kEAAkE;AAClE,eAAO,MAAM,QAAQ,QAAqC,CAAC;AAE3D,wBAAwB;AACxB,MAAM,WAAW,QAAQ;IACvB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,iEAAiE;IACjE,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,MAAM,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC5B,aAAa,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AA8CD,uEAAuE;AACvE,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,QAAQ,EAAE,CAqBxE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAQpF"}

package/dist/world/trap.js

@@ -0,0 +1,106 @@
+/**
+ * Trap kinds bound from trap.json (upstream lib/gamedata/trap.txt via
+ * init.c parse_trap_*), ported from the data half of reference/src/trap.c
+ * (Angband 4.2.6). Pure data: the live trap instances and their behaviour
+ * live in game/trap.ts (they mutate GameState).
+ *
+ * The "visibility" line is the kind's power random-value (rolled at
+ * placement against trap_level and matched against the SEARCH skill when
+ * revealing). Effects stay raw EffectRecordJson chains, built per
+ * activation exactly like object effects (game/obj-cmd.ts).
+ */
+import { FlagSet, flagSize } from "../bitflag.js";
+import { Dice } from "../dice.js";
+import { OF, TRAP_FLAG_ENTRIES, TRF } from "../generated/index.js";
+import { myStristr } from "../guard.js";
+/** TRF_SIZE = FLAG_SIZE(TRF_MAX): byte size of a trap FlagSet. */
+export const TRF_SIZE = flagSize(TRAP_FLAG_ENTRIES.length);
+function parseTrapFlags(lines) {
+    const flags = new FlagSet(TRF_SIZE);
+    if (!lines)
+        return flags;
+    for (const line of lines) {
+        /* A non-string entry is the compiler's presence marker for "flags:"
+         * with no value: parse_trap_flags (init.c L1612-1614) returns
+         * PARSE_ERROR_NONE with t->flags untouched (partrap.c test_flags0). */
+        if (typeof line !== "string")
+            continue;
+        for (const raw of line.split("|")) {
+            const name = raw.trim();
+            if (!name)
+                continue;
+            const value = TRF[name];
+            if (value === undefined || value === 0) {
+                throw new Error(`trap: unknown flag ${name}`);
+            }
+            flags.on(value);
+        }
+    }
+    return flags;
+}
+function parsePower(expr) {
+    if (!expr)
+        return { base: 0, dice: 0, sides: 0, mBonus: 0 };
+    const d = new Dice();
+    if (!d.parseString(expr))
+        throw new Error(`trap: bad power "${expr}"`);
+    return d.randomValue();
+}
+function parseSaveFlags(save) {
+    if (!save)
+        return [];
+    const out = [];
+    for (const raw of save.split("|")) {
+        const name = raw.trim();
+        if (!name)
+            continue;
+        const value = OF[name];
+        if (value === undefined)
+            throw new Error(`trap: unknown save flag ${name}`);
+        out.push(value);
+    }
+    return out;
+}
+const joined = (lines) => lines ? lines.join("") : "";
+/** Bind trap.json records into the trap_kind table (index = t_idx). */
+export function bindTraps(records) {
+    return records.map((rec, tidx) => ({
+        tidx,
+        name: rec.name.name,
+        desc: rec.name.desc,
+        text: joined(rec.desc),
+        glyph: rec.graphics.glyph,
+        color: rec.graphics.color,
+        rarity: rec.appear?.rarity ?? 0,
+        minDepth: rec.appear?.mindepth ?? 0,
+        maxNum: rec.appear?.maxnum ?? 0,
+        power: parsePower(rec.visibility),
+        flags: parseTrapFlags(rec.flags),
+        effect: rec.effect ?? [],
+        effectXtra: rec["effect-xtra"] ?? [],
+        saveFlags: parseSaveFlags(rec.save),
+        msg: joined(rec.msg),
+        msgGood: joined(rec["msg-good"]),
+        msgBad: joined(rec["msg-bad"]),
+        msgXtra: joined(rec["msg-xtra"]),
+    }));
+}
+/**
+ * lookup_trap (trap.c:44-63): exact desc match wins, otherwise the FIRST close
+ * match. The two tests differ in case sensitivity and the port had them the same:
+ * equality is `streq` (:54) but the close match is `my_stristr` (:57), i.e.
+ * case-INsensitive. Found by W1-CITED.
+ */
+export function lookupTrap(kinds, desc) {
+    let closest = null;
+    for (const kind of kinds) {
+        if (!kind.name)
+            continue;
+        if (kind.desc === desc)
+            return kind;
+        if (!closest && myStristr(kind.desc, desc))
+            closest = kind;
+    }
+    return closest;
+}
+//# sourceMappingURL=trap.js.map

package/dist/world/trap.js.map

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

package/dist/world/view.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Line of sight, ported from reference/src/cave-view.c (Angband 4.2.6).
+ *
+ * los() is the integer fixed-point algorithm by Joseph Hall: true when a
+ * line can be traced between grid centers with every intermediate grid
+ * projectable. Reflexive except for the "chess knight move" special
+ * cases, exactly as upstream.
+ *
+ * updateView() is the player FOV: wall-face lighting, light propagation
+ * (player + other sources), and the VIEW/SEEN/CLOSE_PLAYER square flags.
+ * The player and monster couplings are injected: a ViewerState carries
+ * exactly the fields the C reads from struct player, and light sources
+ * arrive as a list instead of scanning the monster array. The knowledge
+ * side effects of update_one (trap reveal, square_note_spot/light_spot,
+ * feeling display) and the blind forget of the current non-passable
+ * remembered square (cave-view.c:894-897) run from game/known.ts noteSpots
+ * after every updateView; the flag bookkeeping they sit beside is ported.
+ */
+import type { GameEvents } from "../events.js";
+import type { Loc } from "../loc.js";
+import type { Chunk } from "./chunk.js";
+/** los(c, grid1, grid2). */
+export declare function los(c: Chunk, grid1: Loc, grid2: Loc): boolean;
+/** The player fields update_view reads (injected instead of coupled). */
+export interface ViewerState {
+    grid: Loc;
+    /** p->state.cur_light: light radius (negative = darkness source). */
+    curLight: number;
+    /** p->timed[TMD_BLIND] truthiness. */
+    blind: boolean;
+    /** player_has(p, PF_UNLIGHT). */
+    hasUnlight: boolean;
+    /** p->lev, for the UNLIGHT view radius. */
+    level: number;
+}
+/** A non-player light source (upstream scans monsters for these). */
+export interface LightSource {
+    grid: Loc;
+    /** mon->race->light: positive light, negative darkness. */
+    light: number;
+}
+/** z_info fields the view code needs. */
+export interface ViewConstants {
+    maxSight: number;
+    feelingNeed: number;
+}
+/** motion_dir: keypad direction from start toward finish (5 = none). */
+export declare function motionDir(start: Loc, finish: Loc): number;
+/** next_grid: the grid one step in a keypad direction. */
+export declare function nextGrid(grid: Loc, dir: number): Loc;
+/** square_islit: positive light level. */
+export declare function squareIsLit(c: Chunk, grid: Loc): boolean;
+/** square_isview / square_isseen. */
+export declare function squareIsView(c: Chunk, grid: Loc): boolean;
+export declare function squareIsSeen(c: Chunk, grid: Loc): boolean;
+/** square_isno_esp: telepathy does not work on this square. */
+export declare function squareIsNoEsp(c: Chunk, grid: Loc): boolean;
+/** update_view. */
+export declare function updateView(c: Chunk, p: ViewerState, z: ViewConstants, sources?: readonly LightSource[], events?: GameEvents): void;
+//# sourceMappingURL=view.d.ts.map

package/dist/world/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../src/world/view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,4BAA4B;AAC5B,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAsH7D;AAMD,yEAAyE;AACzE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,GAAG,CAAC;IACV,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,iCAAiC;IACjC,UAAU,EAAE,OAAO,CAAC;IACpB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qEAAqE;AACrE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,GAAG,CAAC;IACV,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;CACf;AAED,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,MAAM,CAQzD;AAED,0DAA0D;AAC1D,wBAAgB,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,GAAG,CAEpD;AAUD,0CAA0C;AAC1C,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAExD;AAED,qCAAqC;AACrC,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAEzD;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAEzD;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAE1D;AA2QD,mBAAmB;AACnB,wBAAgB,UAAU,CACxB,CAAC,EAAE,KAAK,EACR,CAAC,EAAE,WAAW,EACd,CAAC,EAAE,aAAa,EAChB,OAAO,GAAE,SAAS,WAAW,EAAO,EACpC,MAAM,CAAC,EAAE,UAAU,GAClB,IAAI,CAoBN"}