@rpgm-tools/neo-angband-core 0.10.0

package/dist/visuals/grafmode-data.js

@@ -0,0 +1,88 @@
+// Generated from reference/lib/tiles/list.txt by
+// scripts/gen-grafmode.mjs. Do not edit.
+//
+// The graphics-mode catalog METADATA (functional data) from Angband's tile
+// list. Faithful to grafmode.c's parse of name/directory/size/pref/extra.
+//
+// This file is METADATA ONLY - no tile images. The art for all five packs ships
+// with the web build at packages/web/public/tiles/, and each pack's terms differ
+// (see that directory's CREDITS.md). A front end builds file paths from
+// `directory`/`file`, and can be pointed at a pack of the player's own with
+// `?tiles=<base-url>`. ASCII is the default and the game runs fully with no tile
+// pack present.
+/** Every parsed graphics mode from list.txt, in file order (grafID 1..N). */
+export const GRAPHICS_MODE_CATALOG = [
+    {
+        grafID: 1,
+        menuname: "Original Tiles",
+        directory: "old",
+        cellWidth: 8,
+        cellHeight: 8,
+        file: "8x8.png",
+        pref: "graf-xxx.prf",
+        alphablend: 0,
+        overdrawRow: 0,
+        overdrawMax: 0,
+    },
+    {
+        grafID: 2,
+        menuname: "Adam Bolt's tiles",
+        directory: "adam-bolt",
+        cellWidth: 16,
+        cellHeight: 16,
+        file: "16x16.png",
+        pref: "graf-new.prf",
+        alphablend: 0,
+        overdrawRow: 0,
+        overdrawMax: 0,
+    },
+    {
+        grafID: 3,
+        menuname: "David Gervais' tiles",
+        directory: "gervais",
+        cellWidth: 32,
+        cellHeight: 32,
+        file: "32x32.png",
+        pref: "graf-dvg.prf",
+        alphablend: 0,
+        overdrawRow: 0,
+        overdrawMax: 0,
+    },
+    {
+        grafID: 4,
+        menuname: "Nomad's tiles",
+        directory: "nomad",
+        cellWidth: 16,
+        cellHeight: 16,
+        file: "8x16.png",
+        pref: "graf-nmd.prf",
+        alphablend: 0,
+        overdrawRow: 0,
+        overdrawMax: 0,
+    },
+    {
+        grafID: 5,
+        menuname: "Shockbolt Dark",
+        directory: "shockbolt",
+        cellWidth: 64,
+        cellHeight: 64,
+        file: "64x64.png",
+        pref: "graf-shb-dark.prf",
+        alphablend: 1,
+        overdrawRow: 27,
+        overdrawMax: 31,
+    },
+    {
+        grafID: 6,
+        menuname: "Shockbolt Light",
+        directory: "shockbolt",
+        cellWidth: 64,
+        cellHeight: 64,
+        file: "64x64.png",
+        pref: "graf-shb-light.prf",
+        alphablend: 1,
+        overdrawRow: 27,
+        overdrawMax: 31,
+    },
+];
+//# sourceMappingURL=grafmode-data.js.map

package/dist/visuals/grafmode-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grafmode-data.js","sourceRoot":"","sources":["../../src/visuals/grafmode-data.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,0EAA0E;AAC1E,EAAE;AACF,gFAAgF;AAChF,iFAAiF;AACjF,wEAAwE;AACxE,4EAA4E;AAC5E,iFAAiF;AACjF,gBAAgB;AAIhB,6EAA6E;AAC7E,MAAM,CAAC,MAAM,qBAAqB,GAA4B;IAC5D;QACE,MAAM,EAAE,CAAC;QACT,QAAQ,EAAE,gBAAgB;QAC1B,SAAS,EAAE,KAAK;QAChB,SAAS,EAAE,CAAC;QACZ,UAAU,EAAE,CAAC;QACb,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,cAAc;QACpB,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,CAAC;QACd,WAAW,EAAE,CAAC;KACf;IACD;QACE,MAAM,EAAE,CAAC;QACT,QAAQ,EAAE,mBAAmB;QAC7B,SAAS,EAAE,WAAW;QACtB,SAAS,EAAE,EAAE;QACb,UAAU,EAAE,EAAE;QACd,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,cAAc;QACpB,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,CAAC;QACd,WAAW,EAAE,CAAC;KACf;IACD;QACE,MAAM,EAAE,CAAC;QACT,QAAQ,EAAE,sBAAsB;QAChC,SAAS,EAAE,SAAS;QACpB,SAAS,EAAE,EAAE;QACb,UAAU,EAAE,EAAE;QACd,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,cAAc;QACpB,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,CAAC;QACd,WAAW,EAAE,CAAC;KACf;IACD;QACE,MAAM,EAAE,CAAC;QACT,QAAQ,EAAE,eAAe;QACzB,SAAS,EAAE,OAAO;QAClB,SAAS,EAAE,EAAE;QACb,UAAU,EAAE,EAAE;QACd,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,cAAc;QACpB,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,CAAC;QACd,WAAW,EAAE,CAAC;KACf;IACD;QACE,MAAM,EAAE,CAAC;QACT,QAAQ,EAAE,gBAAgB;QAC1B,SAAS,EAAE,WAAW;QACtB,SAAS,EAAE,EAAE;QACb,UAAU,EAAE,EAAE;QACd,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,mBAAmB;QACzB,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,EAAE;QACf,WAAW,EAAE,EAAE;KAChB;IACD;QACE,MAAM,EAAE,CAAC;QACT,QAAQ,EAAE,iBAAiB;QAC3B,SAAS,EAAE,WAAW;QACtB,SAAS,EAAE,EAAE;QACb,UAAU,EAAE,EAAE;QACd,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,oBAAoB;QAC1B,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,EAAE;QACf,WAAW,EAAE,EAAE;KAChB;CACF,CAAC"}

package/dist/visuals/grafmode.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Graphics-mode catalog + lookup, ported from reference/src/grafmode.c
+ * (Angband 4.2.6).
+ *
+ * The catalog is metadata only (mode id, menu name, tile dimensions,
+ * directory + image/pref filenames, double-height rows) parsed from
+ * lib/tiles/list.txt. NO tile IMAGE assets are bundled - the art packs carry
+ * their own (partly non-commercial) licenses, so a user supplies a tile pack
+ * at runtime and the web renderer builds URLs from this metadata. ASCII stays
+ * the default and the game runs fully with no tile pack present.
+ *
+ * Ported here:
+ *  - struct graphics_mode -> GraphicsMode.
+ *  - GRAPHICS_NONE (grafmode.h) + the hardcoded "None" fallback entry the C
+ *    appends in finish_parse_grafmode (L137-146).
+ *  - get_graphics_mode (L223): find a mode by grafID.
+ *  - graphics_mode_high_id (L148): the highest catalog grafID.
+ *  - is_dh_tile (L241): double-height tile test.
+ *
+ * The list.txt parse itself is done ahead of time by
+ * scripts/gen-grafmode.mjs, which emits grafmode-data.ts.
+ */
+export { GRAPHICS_MODE_CATALOG } from "./grafmode-data.js";
+/** grafmode.h GRAPHICS_NONE: the ASCII (no-tiles) mode id. */
+export declare const GRAPHICS_NONE = 0;
+/**
+ * struct graphics_mode (grafmode.h). The C stores a fully-built absolute
+ * `path` under ANGBAND_DIR_TILES; here we keep the raw `directory` name and
+ * leave path/URL construction to the platform (no bundled assets).
+ */
+export interface GraphicsMode {
+    /** grafID: the serial number / mode id (uint on the `name` line). */
+    grafID: number;
+    /** menuname: the display name (the `name` line's str field). */
+    menuname: string;
+    /** The tile directory name (the `directory` line), e.g. "old". */
+    directory: string;
+    /** cell_width: tile width in pixels (the `size` line). */
+    cellWidth: number;
+    /** cell_height: tile height in pixels (the `size` line). */
+    cellHeight: number;
+    /** file: the tileset image filename (the `size` line's str field). */
+    file: string;
+    /** pref: the pref file name (the `pref` line), or "none". */
+    pref: string;
+    /** alphablend: whether the tileset needs alpha blending (the `extra` line). */
+    alphablend: number;
+    /** overdrawRow: first double-height tile row (the `extra` line). */
+    overdrawRow: number;
+    /** overdrawMax: last double-height tile row (the `extra` line). */
+    overdrawMax: number;
+}
+/**
+ * The hardcoded no-graphics fallback (grafmode.c L137-146). Appended after the
+ * parsed catalog and used as the initial current_graphics_mode.
+ */
+export declare const GRAPHICS_MODE_NONE: GraphicsMode;
+/**
+ * The full graphics-mode list: the parsed catalog plus the "None" entry at the
+ * end, exactly as finish_parse_grafmode builds graphics_modes[] (parsed modes
+ * followed by the hardcoded None fallback).
+ */
+export declare const GRAPHICS_MODES: readonly GraphicsMode[];
+/**
+ * graphics_mode_high_id (grafmode.c L148): the highest grafID among the
+ * parsed modes (the None entry is excluded, matching the C's `max` scan which
+ * runs before None is appended).
+ */
+export declare const GRAPHICS_MODE_HIGH_ID: number;
+/**
+ * get_graphics_mode (grafmode.c L223): the mode with the given id, or
+ * undefined (the C returns NULL) if none matches. GRAPHICS_NONE resolves to
+ * the None fallback entry.
+ */
+export declare function getGraphicsMode(id: number): GraphicsMode | undefined;
+/**
+ * is_dh_tile (grafmode.c L241): whether an attr/char pair is a double-height
+ * tile under the given mode. True only for a tile attr (high bit set) whose
+ * tileset row falls in the mode's double-height band. `current` may be
+ * undefined (no mode selected), matching the C's !current_graphics_mode guard.
+ */
+export declare function isDoubleHeightTile(current: GraphicsMode | undefined, attr: number): boolean;
+//# sourceMappingURL=grafmode.d.ts.map

package/dist/visuals/grafmode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grafmode.d.ts","sourceRoot":"","sources":["../../src/visuals/grafmode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,8DAA8D;AAC9D,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,YAWhC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAGjD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAGnC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAKpE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,YAAY,GAAG,SAAS,EACjC,IAAI,EAAE,MAAM,GACX,OAAO,CAMT"}

package/dist/visuals/grafmode.js

@@ -0,0 +1,82 @@
+/**
+ * Graphics-mode catalog + lookup, ported from reference/src/grafmode.c
+ * (Angband 4.2.6).
+ *
+ * The catalog is metadata only (mode id, menu name, tile dimensions,
+ * directory + image/pref filenames, double-height rows) parsed from
+ * lib/tiles/list.txt. NO tile IMAGE assets are bundled - the art packs carry
+ * their own (partly non-commercial) licenses, so a user supplies a tile pack
+ * at runtime and the web renderer builds URLs from this metadata. ASCII stays
+ * the default and the game runs fully with no tile pack present.
+ *
+ * Ported here:
+ *  - struct graphics_mode -> GraphicsMode.
+ *  - GRAPHICS_NONE (grafmode.h) + the hardcoded "None" fallback entry the C
+ *    appends in finish_parse_grafmode (L137-146).
+ *  - get_graphics_mode (L223): find a mode by grafID.
+ *  - graphics_mode_high_id (L148): the highest catalog grafID.
+ *  - is_dh_tile (L241): double-height tile test.
+ *
+ * The list.txt parse itself is done ahead of time by
+ * scripts/gen-grafmode.mjs, which emits grafmode-data.ts.
+ */
+import { GRAPHICS_MODE_CATALOG } from "./grafmode-data.js";
+export { GRAPHICS_MODE_CATALOG } from "./grafmode-data.js";
+/** grafmode.h GRAPHICS_NONE: the ASCII (no-tiles) mode id. */
+export const GRAPHICS_NONE = 0;
+/**
+ * The hardcoded no-graphics fallback (grafmode.c L137-146). Appended after the
+ * parsed catalog and used as the initial current_graphics_mode.
+ */
+export const GRAPHICS_MODE_NONE = {
+    grafID: GRAPHICS_NONE,
+    menuname: "None",
+    directory: "",
+    cellWidth: 0,
+    cellHeight: 0,
+    file: "",
+    pref: "none",
+    alphablend: 0,
+    overdrawRow: 0,
+    overdrawMax: 0,
+};
+/**
+ * The full graphics-mode list: the parsed catalog plus the "None" entry at the
+ * end, exactly as finish_parse_grafmode builds graphics_modes[] (parsed modes
+ * followed by the hardcoded None fallback).
+ */
+export const GRAPHICS_MODES = [
+    ...GRAPHICS_MODE_CATALOG,
+    GRAPHICS_MODE_NONE,
+];
+/**
+ * graphics_mode_high_id (grafmode.c L148): the highest grafID among the
+ * parsed modes (the None entry is excluded, matching the C's `max` scan which
+ * runs before None is appended).
+ */
+export const GRAPHICS_MODE_HIGH_ID = GRAPHICS_MODE_CATALOG.reduce((max, m) => (m.grafID > max ? m.grafID : max), 0);
+/**
+ * get_graphics_mode (grafmode.c L223): the mode with the given id, or
+ * undefined (the C returns NULL) if none matches. GRAPHICS_NONE resolves to
+ * the None fallback entry.
+ */
+export function getGraphicsMode(id) {
+    for (const mode of GRAPHICS_MODES) {
+        if (mode.grafID === id)
+            return mode;
+    }
+    return undefined;
+}
+/**
+ * is_dh_tile (grafmode.c L241): whether an attr/char pair is a double-height
+ * tile under the given mode. True only for a tile attr (high bit set) whose
+ * tileset row falls in the mode's double-height band. `current` may be
+ * undefined (no mode selected), matching the C's !current_graphics_mode guard.
+ */
+export function isDoubleHeightTile(current, attr) {
+    if ((attr & 0x80) === 0 || !current || !current.overdrawRow)
+        return false;
+    const tilesetRow = attr & 0x7f;
+    return (tilesetRow >= current.overdrawRow && tilesetRow <= current.overdrawMax);
+}
+//# sourceMappingURL=grafmode.js.map

package/dist/visuals/grafmode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grafmode.js","sourceRoot":"","sources":["../../src/visuals/grafmode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,8DAA8D;AAC9D,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AA8B/B;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAiB;IAC9C,MAAM,EAAE,aAAa;IACrB,QAAQ,EAAE,MAAM;IAChB,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,CAAC;IACZ,UAAU,EAAE,CAAC;IACb,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,CAAC;IACb,WAAW,EAAE,CAAC;IACd,WAAW,EAAE,CAAC;CACf,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAA4B;IACrD,GAAG,qBAAqB;IACxB,kBAAkB;CACnB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAW,qBAAqB,CAAC,MAAM,CACvE,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAC7C,CAAC,CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,MAAM,KAAK,EAAE;YAAE,OAAO,IAAI,CAAC;IACtC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAiC,EACjC,IAAY;IAEZ,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW;QAAE,OAAO,KAAK,CAAC;IAC1E,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,CAAC;IAC/B,OAAO,CACL,UAAU,IAAI,OAAO,CAAC,WAAW,IAAI,UAAU,IAAI,OAAO,CAAC,WAAW,CACvE,CAAC;AACJ,CAAC"}

package/dist/visuals/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The visuals subsystem: a platform-agnostic color-cycle + legacy flicker
+ * animation engine (engine.ts) and the graphics-mode catalog (grafmode.ts),
+ * ported from reference/src/ui-visuals.c and reference/src/grafmode.c
+ * (Angband 4.2.6).
+ *
+ * A front end owns the frame timer and the glyph/tile draw; the core returns
+ * the COLOUR_* attr to draw for a given animation frame. The tile IMAGE assets
+ * for all six graphics modes ship with the web build (packages/web/public/tiles);
+ * ASCII stays the default.
+ */
+export * from "./engine.js";
+export * from "./glyph-table.js";
+export * from "./grafmode.js";
+export * from "./map-text.js";
+export * from "./pref-expr.js";
+export * from "./prefs.js";
+export * from "./tile-prefs.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/visuals/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/visuals/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/visuals/index.js

@@ -0,0 +1,19 @@
+/**
+ * The visuals subsystem: a platform-agnostic color-cycle + legacy flicker
+ * animation engine (engine.ts) and the graphics-mode catalog (grafmode.ts),
+ * ported from reference/src/ui-visuals.c and reference/src/grafmode.c
+ * (Angband 4.2.6).
+ *
+ * A front end owns the frame timer and the glyph/tile draw; the core returns
+ * the COLOUR_* attr to draw for a given animation frame. The tile IMAGE assets
+ * for all six graphics modes ship with the web build (packages/web/public/tiles);
+ * ASCII stays the default.
+ */
+export * from "./engine.js";
+export * from "./glyph-table.js";
+export * from "./grafmode.js";
+export * from "./map-text.js";
+export * from "./pref-expr.js";
+export * from "./prefs.js";
+export * from "./tile-prefs.js";
+//# sourceMappingURL=index.js.map

package/dist/visuals/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/visuals/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/visuals/map-text.d.ts

@@ -0,0 +1,79 @@
+/**
+ * The monster and player arms of grid_data_as_text, ported from
+ * reference/src/ui-map.c L232-331 (Angband 4.2.6).
+ *
+ * SCOPE. Upstream resolves a whole map cell in one function: terrain from
+ * feat_x_attr, then trap, then object, then monster-or-player, all layered onto
+ * one (attr, char) pair. The port's web shell layers those four in its own
+ * render loop (main.ts render(), one index map per layer), so what needs to
+ * live in core is the part that is not simple "last writer wins": the monster
+ * branch, whose seven arms READ the glyph already under the monster, and the
+ * player branch, which takes its colour from the x_attr table's race-0 slot.
+ * Everything here is pure, so both are directly testable.
+ *
+ * What upstream does that the port's layered loop still cannot express is
+ * recorded in parity/CENSUS_PUNCHLIST.md (block O: map_info has no port, so
+ * hallucination glyphs, the multi-object pile kind and the unknown-item/gold
+ * kinds are absent) - it is measured there rather than excused here.
+ *
+ * Determinism: no RNG. ATTR_RAND's per-monster colour is rolled once at birth
+ * (mon-make.c place_new_monster_one), and the flicker/multi frame colour is the
+ * caller's animator; this module only selects between values it is handed.
+ */
+import type { GlyphPair } from "./glyph-table.js";
+/** The inputs grid_data_as_text's monster branch reads. */
+export interface MonsterGlyphInput {
+    /** The (attr, char) already resolved for this grid: terrain, then trap/object. */
+    under: GlyphPair;
+    /** monster_x_attr[race->ridx] / monster_x_char[race->ridx]. */
+    desired: GlyphPair;
+    /**
+     * mon->attr: the animated colour do_animation last wrote for an
+     * ATTR_MULTI/ATTR_FLICKER monster, or the colour ATTR_RAND rolled at birth.
+     * 0 means "none set", which upstream falls back from to `da` (L259).
+     */
+    monAttr: number;
+    attrMulti: boolean;
+    attrFlicker: boolean;
+    attrRand: boolean;
+    attrClear: boolean;
+    charClear: boolean;
+    /** OPT(player, purple_uniques). */
+    purpleUniques: boolean;
+    /** monster_is_shape_unique(mon) (mon-predicate.c L100). */
+    shapeUnique: boolean;
+}
+/**
+ * grid_data_as_text's `g->m_idx > 0` branch (ui-map.c L232-289), in upstream's
+ * exact arm order. The returned attr is also what upstream stores back into
+ * `mon->attr` (L288), which the monster-list sidebar then reads.
+ *
+ * The arms, in order:
+ *  1. `da & 0x80` - a special (tile) code in the slot wins outright.
+ *  2. purple_uniques on a currently-unique monster: violet, monster's char.
+ *  3. ATTR_MULTI / ATTR_FLICKER / ATTR_RAND: `mon->attr` if set, else `da`.
+ *  4. Neither ATTR_CLEAR nor CHAR_CLEAR: an ordinary monster, both overridden.
+ *  5. `a & 0x80` - a bizarre (tile) grid under the monster: both overridden.
+ *  6. not CHAR_CLEAR: keep the grid's attr, take the monster's char.
+ *  7. not ATTR_CLEAR: take the monster's attr, keep the grid's char.
+ *
+ * Arms 6 and 7 are why an ATTR_CLEAR monster shows in the colour of whatever
+ * it is standing on, and a CHAR_CLEAR monster is invisible except for its
+ * colour tinting the terrain glyph.
+ */
+export declare function monsterGlyph(input: MonsterGlyphInput): GlyphPair;
+/**
+ * grid_data_as_text's `g->is_player` branch (ui-map.c L289-331). The player's
+ * glyph is r_info[0] ("<player>" in monster.txt) read through the SAME x_attr
+ * table as every monster, so a pref file or the glyph picker can re-map the
+ * '@'. hp_changes_color recolours by HP decile, but only when the slot does
+ * not hold a tile code (L292 `!(a & 0x80)`).
+ */
+export declare function playerGlyph(
+/** monster_x_attr[0] / monster_x_char[0]. */
+desired: GlyphPair, opts: {
+    hpChangesColor: boolean;
+    chp: number;
+    mhp: number;
+}): GlyphPair;
+//# sourceMappingURL=map-text.d.ts.map

package/dist/visuals/map-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-text.d.ts","sourceRoot":"","sources":["../../src/visuals/map-text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAWlD,2DAA2D;AAC3D,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,KAAK,EAAE,SAAS,CAAC;IACjB,+DAA+D;IAC/D,OAAO,EAAE,SAAS,CAAC;IACnB;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,mCAAmC;IACnC,aAAa,EAAE,OAAO,CAAC;IACvB,2DAA2D;IAC3D,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,SAAS,CA2BhE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW;AACzB,6CAA6C;AAC7C,OAAO,EAAE,SAAS,EAClB,IAAI,EAAE;IAAE,cAAc,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC1D,SAAS,CAmCX"}

package/dist/visuals/map-text.js

@@ -0,0 +1,122 @@
+/**
+ * The monster and player arms of grid_data_as_text, ported from
+ * reference/src/ui-map.c L232-331 (Angband 4.2.6).
+ *
+ * SCOPE. Upstream resolves a whole map cell in one function: terrain from
+ * feat_x_attr, then trap, then object, then monster-or-player, all layered onto
+ * one (attr, char) pair. The port's web shell layers those four in its own
+ * render loop (main.ts render(), one index map per layer), so what needs to
+ * live in core is the part that is not simple "last writer wins": the monster
+ * branch, whose seven arms READ the glyph already under the monster, and the
+ * player branch, which takes its colour from the x_attr table's race-0 slot.
+ * Everything here is pure, so both are directly testable.
+ *
+ * What upstream does that the port's layered loop still cannot express is
+ * recorded in parity/CENSUS_PUNCHLIST.md (block O: map_info has no port, so
+ * hallucination glyphs, the multi-object pile kind and the unknown-item/gold
+ * kinds are absent) - it is measured there rather than excused here.
+ *
+ * Determinism: no RNG. ATTR_RAND's per-monster colour is rolled once at birth
+ * (mon-make.c place_new_monster_one), and the flicker/multi frame colour is the
+ * caller's animator; this module only selects between values it is handed.
+ */
+import { COLOUR_L_RED, COLOUR_ORANGE, COLOUR_RED, COLOUR_VIOLET, COLOUR_WHITE, COLOUR_YELLOW } from "../color.js";
+/**
+ * The high bit upstream reserves for "this slot holds a graphics tile code,
+ * not a colour attr" (ui-map.c L246 `da & 0x80`, L275 `a & 0x80`). The port
+ * keeps tile codes in a separate TileMap (see glyph-table.ts), so in practice
+ * this is only set when a pref file wrote a high-bit attr into the ASCII
+ * table; the branches are ported anyway so that case behaves as upstream.
+ */
+const ATTR_TILE_BIT = 0x80;
+/**
+ * grid_data_as_text's `g->m_idx > 0` branch (ui-map.c L232-289), in upstream's
+ * exact arm order. The returned attr is also what upstream stores back into
+ * `mon->attr` (L288), which the monster-list sidebar then reads.
+ *
+ * The arms, in order:
+ *  1. `da & 0x80` - a special (tile) code in the slot wins outright.
+ *  2. purple_uniques on a currently-unique monster: violet, monster's char.
+ *  3. ATTR_MULTI / ATTR_FLICKER / ATTR_RAND: `mon->attr` if set, else `da`.
+ *  4. Neither ATTR_CLEAR nor CHAR_CLEAR: an ordinary monster, both overridden.
+ *  5. `a & 0x80` - a bizarre (tile) grid under the monster: both overridden.
+ *  6. not CHAR_CLEAR: keep the grid's attr, take the monster's char.
+ *  7. not ATTR_CLEAR: take the monster's attr, keep the grid's char.
+ *
+ * Arms 6 and 7 are why an ATTR_CLEAR monster shows in the colour of whatever
+ * it is standing on, and a CHAR_CLEAR monster is invisible except for its
+ * colour tinting the terrain glyph.
+ */
+export function monsterGlyph(input) {
+    const { under, desired } = input;
+    if (desired.attr & ATTR_TILE_BIT) {
+        return { attr: desired.attr, char: desired.char };
+    }
+    if (input.purpleUniques && input.shapeUnique) {
+        return { attr: COLOUR_VIOLET, char: desired.char };
+    }
+    if (input.attrMulti || input.attrFlicker || input.attrRand) {
+        return { attr: input.monAttr ? input.monAttr : desired.attr, char: desired.char };
+    }
+    if (!input.attrClear && !input.charClear) {
+        return { attr: desired.attr, char: desired.char };
+    }
+    if (under.attr & ATTR_TILE_BIT) {
+        return { attr: desired.attr, char: desired.char };
+    }
+    if (!input.charClear) {
+        return { attr: under.attr, char: desired.char };
+    }
+    if (!input.attrClear) {
+        return { attr: desired.attr, char: under.char };
+    }
+    /* Both flags set: upstream falls out of the if-chain leaving the grid's own
+     * attr and char untouched - a monster you cannot see at all. */
+    return { attr: under.attr, char: under.char };
+}
+/**
+ * grid_data_as_text's `g->is_player` branch (ui-map.c L289-331). The player's
+ * glyph is r_info[0] ("<player>" in monster.txt) read through the SAME x_attr
+ * table as every monster, so a pref file or the glyph picker can re-map the
+ * '@'. hp_changes_color recolours by HP decile, but only when the slot does
+ * not hold a tile code (L292 `!(a & 0x80)`).
+ */
+export function playerGlyph(
+/** monster_x_attr[0] / monster_x_char[0]. */
+desired, opts) {
+    let attr = desired.attr;
+    if (opts.hpChangesColor && !(attr & ATTR_TILE_BIT)) {
+        /* Upstream's `player->chp * 10 / player->mhp` is integer division on
+         * possibly-negative chp; Math.trunc reproduces C's truncation. mhp is
+         * never 0 in a live game, but a 0 guard keeps this total for tests. */
+        const decile = opts.mhp > 0 ? Math.trunc((opts.chp * 10) / opts.mhp) : 10;
+        switch (decile) {
+            case 10:
+            case 9:
+                attr = COLOUR_WHITE;
+                break;
+            case 8:
+            case 7:
+                attr = COLOUR_YELLOW;
+                break;
+            case 6:
+            case 5:
+                attr = COLOUR_ORANGE;
+                break;
+            case 4:
+            case 3:
+                attr = COLOUR_L_RED;
+                break;
+            case 2:
+            case 1:
+            case 0:
+                attr = COLOUR_RED;
+                break;
+            default:
+                attr = COLOUR_WHITE;
+                break;
+        }
+    }
+    return { attr, char: desired.char };
+}
+//# sourceMappingURL=map-text.js.map

package/dist/visuals/map-text.js.map

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

package/dist/visuals/pref-expr.d.ts

@@ -0,0 +1,56 @@
+/**
+ * process_pref_file_expr, ported from reference/src/ui-prefs.c L453-575
+ * (Angband 4.2.6): the prefix-expression language behind a pref file's `?:`
+ * lines, which is how one .prf file carries per-race, per-class and per-frontend
+ * variants of the same directive.
+ *
+ * This is the SHARED evaluator. It has to be shared because the port has two
+ * pref parsers - prefs.ts (the general x_attr/x_char + keymap/colour surface)
+ * and tile-prefs.ts (the graphics TileMap) - and upstream has exactly one
+ * expression evaluator serving both. A second copy is how the graphics parser
+ * came to have no `?:` support at all while the other parser had a version that
+ * could not read a nested bracket; see the note on evaluate() below.
+ *
+ * Faithfulness notes, because two of these look like bugs and are not:
+ *
+ * - The variables are SYS, RACE and CLASS. That is the whole set (L553-560).
+ *   In particular there is no GENDER: the string "GENDER" does not occur
+ *   anywhere in reference/src, so every `[EQU $GENDER Female]` line in the
+ *   shipped xtra-*.prf files - 66 of them - evaluates unknown, compares unequal,
+ *   and is bypassed. Upstream has never drawn a female player tile from those
+ *   files. Core keeps the wart; a mod may fix it.
+ * - LEQ and GEQ are STRICT despite their names. Upstream sets the result to "0"
+ *   when `strcmp(p, t) >= 0` (LEQ) or `<= 0` (GEQ), so `[LEQ 5 5]` is FALSE.
+ *
+ * An unknown variable, an unknown connective, and an empty expression all yield
+ * "?o?o?"; an unterminated bracket yields "?x?x?". Both are non-"0", so the
+ * caller does NOT bypass - upstream's fail-open behaviour, which is why a pref
+ * file written for a newer game still applies most of its lines here.
+ */
+/** The `$VAR` values a `?:` line can test. Upstream's set, and only it. */
+export interface PrefExprVars {
+    /** ANGBAND_SYS: the front-end module's name (init.c L84, main.c L508). */
+    SYS?: string;
+    /** player->race->name, e.g. "Half-Troll". */
+    RACE?: string;
+    /** player->class->name, e.g. "Ranger". */
+    CLASS?: string;
+}
+/** The value an unknown variable, unknown connective or empty expression takes. */
+export declare const PREF_EXPR_UNKNOWN = "?o?o?";
+/** The value an unterminated `[` takes. */
+export declare const PREF_EXPR_MALFORMED = "?x?x?";
+/**
+ * Evaluate a `?:` expression to upstream's string result. "0" is the only false
+ * value; everything else - including "?o?o?" from an unknown variable - is true.
+ *
+ * The parser this replaced matched a single bracket level with a regular
+ * expression, so `[AND [EQU $CLASS Mage] [EQU $RACE Elf]]` split into six bare
+ * tokens, none of which was "0", and every AND came out TRUE. That is why the
+ * shipped xtra-shb.prf's 132 `monster:<player>` lines all applied and the last
+ * one won.
+ */
+export declare function evalPrefExpr(expr: string, vars?: PrefExprVars): string;
+/** The `?` line's own question: does this expression bypass what follows? */
+export declare function prefExprBypasses(expr: string, vars?: PrefExprVars): boolean;
+//# sourceMappingURL=pref-expr.d.ts.map

package/dist/visuals/pref-expr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pref-expr.d.ts","sourceRoot":"","sources":["../../src/visuals/pref-expr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,2EAA2E;AAC3E,MAAM,WAAW,YAAY;IAC3B,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,UAAU,CAAC;AACzC,2CAA2C;AAC3C,eAAO,MAAM,mBAAmB,UAAU,CAAC;AAyH3C;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,MAAM,CAE1E;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAE/E"}