@rpgm-tools/neo-angband-core 0.10.0

package/dist/visuals/engine.js

@@ -0,0 +1,357 @@
+/**
+ * Color-cycle + legacy flicker animation engine, ported from
+ * reference/src/ui-visuals.c (Angband 4.2.6).
+ *
+ * This is the front-end-agnostic half of the visuals subsystem: given a
+ * color cycle group/name (or a monster race, or a base selection attr) and a
+ * frame counter, it returns the COLOUR_* attr to draw for that frame. It has
+ * no DOM/canvas dependency; a front end owns the frame timer and the actual
+ * glyph/tile draw. The stateful interpretation that ui-visuals.c performs at
+ * parse time is reproduced here in the builders (buildVisualsFlicker /
+ * buildVisualsCycler) that consume the compiled visuals.txt pack record.
+ *
+ * Faithful details preserved from the C:
+ *  - visuals_color_cycle_attr_for_frame (L169): step = frame % max_steps.
+ *  - visuals_color_cycle_copy (L126): a cycle is compressed to only its valid
+ *    colors (preserving order) when moved into a group, so attrForFrame wraps
+ *    over the real color count, not the padded VISUALS_STEPS_MAX capacity.
+ *  - visuals_flicker_get_attr_for_frame (L633): the flicker table is indexed
+ *    by the selection attr (the color code on the `flicker:` line), then by
+ *    frame % colors_per_cycle. Out-of-range selection attr -> BASIC_COLORS.
+ *  - visuals_flicker_set_color (L574): flicker cycles are filled by the
+ *    selection attr, so "the last one listed wins" for a duplicate selection.
+ *  - visuals_cycler_set_cycle_for_race (L420) / _get_attr_for_race (L468):
+ *    a race->cycle lookup table, growable by ridx, returns BASIC_COLORS when
+ *    a race has no cycle.
+ *  - do_animation (ui-display.c L1435): animateMonsterAttr replicates the
+ *    per-monster branch (RF_ATTR_MULTI random, RF_ATTR_FLICKER cycle ->
+ *    flicker -> base fallback, otherwise static).
+ */
+import { BASIC_COLORS, colorCharToAttr, MAX_COLORS } from "../color.js";
+/**
+ * z-color.h BASIC_COLORS: the count of the basic color attrs (0..28). It
+ * doubles as the "no color / invalid" sentinel the cycler/flicker return on a
+ * miss, since it is one past the last valid attr.
+ */
+export { BASIC_COLORS } from "../color.js";
+/**
+ * z-color.h MAX_COLORS (32). The flicker table is sized with this by
+ * ui_visuals_module_init: visuals_flicker_new(MAX_COLORS, 3).
+ */
+export const VISUALS_MAX_COLORS = MAX_COLORS;
+/** ui-visuals.c VISUALS_STEPS_MAX (L35): max colors per color cycle. */
+export const VISUALS_STEPS_MAX = 32;
+/** ui-visuals.c VISUALS_INVALID_COLOR (L38): unused-step marker. */
+export const VISUALS_INVALID_COLOR = 0xff;
+/** ui_visuals_module_init: colors_per_cycle for the legacy flicker table. */
+const FLICKER_COLORS_PER_CYCLE = 3;
+/* ----- Fancy Color Cycling ----- */
+/**
+ * struct visuals_color_cycle (ui-visuals.c L45): an ordered set of color
+ * attrs to rotate through, plus the padding capacity and invalid marker.
+ */
+export class VisualsColorCycle {
+    cycleName;
+    invalidColor;
+    /** The steps array (length maxSteps), invalidColor for unused slots. */
+    stepValues;
+    constructor(name, stepCount, invalidColor) {
+        this.cycleName = name;
+        this.invalidColor = invalidColor;
+        this.stepValues = new Array(stepCount).fill(invalidColor);
+    }
+    /** visuals_color_cycle_new (L62): NULL (here null) when stepCount is 0. */
+    static create(name, stepCount, invalidColor) {
+        if (stepCount === 0)
+            return null;
+        return new VisualsColorCycle(name, stepCount, invalidColor);
+    }
+    get maxSteps() {
+        return this.stepValues.length;
+    }
+    /** The step attrs, including any invalid padding. */
+    get steps() {
+        return this.stepValues;
+    }
+    /** Set the attr at a step (no-op if out of range, like the raw array). */
+    setStep(index, attr) {
+        if (index >= 0 && index < this.stepValues.length) {
+            this.stepValues[index] = attr;
+        }
+    }
+    /**
+     * visuals_color_cycle_copy (L126): a new cycle holding only the valid
+     * colors of this one, in order. Returns null if there are no valid colors
+     * (matching visuals_color_cycle_new(0) -> NULL).
+     */
+    copy() {
+        const valid = this.stepValues.filter((s) => s !== this.invalidColor);
+        const copy = VisualsColorCycle.create(this.cycleName, valid.length, this.invalidColor);
+        if (copy === null)
+            return null;
+        for (let i = 0; i < valid.length; i++)
+            copy.setStep(i, valid[i]);
+        return copy;
+    }
+    /**
+     * visuals_color_cycle_attr_for_frame (L169): the color for a frame, i.e.
+     * steps[frame % max_steps]. On a compressed (copied) cycle this wraps over
+     * the true color count.
+     */
+    attrForFrame(frame) {
+        const step = frame % this.stepValues.length;
+        return this.stepValues[step];
+    }
+}
+/**
+ * struct visuals_cycle_group (L186): named group of color cycles. Modeled as
+ * an insertion-ordered map of cycle-name -> cycle (the C uses parallel arrays
+ * but only ever looks cycles up by name).
+ */
+class VisualsCycleGroup {
+    groupName;
+    cycles;
+    constructor(name) {
+        this.groupName = name;
+        this.cycles = new Map();
+    }
+    /** visuals_cycler_cycle_by_name inner loop (L363): find a cycle by name. */
+    cycleByName(name) {
+        return this.cycles.get(name) ?? null;
+    }
+}
+/**
+ * struct visuals_cycler (L261): the whole color-cycling table, groups of
+ * color cycles. Built from the compiled visuals.txt `cycle` records.
+ */
+export class VisualsCycler {
+    groups;
+    constructor() {
+        this.groups = new Map();
+    }
+    /** Internal: fetch-or-create a group, preserving first-seen order. */
+    group(name) {
+        let g = this.groups.get(name);
+        if (g === undefined) {
+            g = new VisualsCycleGroup(name);
+            this.groups.set(name, g);
+        }
+        return g;
+    }
+    /**
+     * Add (or replace) a cycle in a group. Replicates visuals_parse_cycle's
+     * "if a cycle with a matching name is found, the parsed cycle replaces it"
+     * (L968-987) via Map.set. The stored cycle is the compressed copy, matching
+     * visuals_parse_context_convert (L807-813).
+     */
+    addCycle(groupName, cycle) {
+        const compressed = cycle.copy();
+        if (compressed === null)
+            return;
+        this.group(groupName).cycles.set(cycle.cycleName, compressed);
+    }
+    /** visuals_cycler_cycle_by_name (L336): find a cycle by group + name. */
+    cycleByName(groupName, cycleName) {
+        if (!groupName || !cycleName)
+            return null;
+        return this.groups.get(groupName)?.cycleByName(cycleName) ?? null;
+    }
+    /**
+     * visuals_cycler_get_attr_for_frame (L384): attr for a group/cycle at a
+     * frame, or BASIC_COLORS when the cycle is not found.
+     */
+    getAttrForFrame(groupName, cycleName, frame) {
+        const cycle = this.cycleByName(groupName, cycleName);
+        if (cycle === null)
+            return BASIC_COLORS;
+        return cycle.attrForFrame(frame);
+    }
+    /** Number of groups (introspection for wiring/tests). */
+    get groupCount() {
+        return this.groups.size;
+    }
+}
+/**
+ * struct visuals_flicker (L496): the legacy flicker table, a fixed grid of
+ * maxCycles * colorsPerCycle attrs indexed by [selection attr][step].
+ */
+export class VisualsFlicker {
+    maxCycles;
+    colorsPerCycle;
+    cells;
+    constructor(maxCycles, colorsPerCycle) {
+        this.maxCycles = maxCycles;
+        this.colorsPerCycle = colorsPerCycle;
+        this.cells = new Array(maxCycles * colorsPerCycle).fill(0);
+    }
+    /**
+     * visuals_flicker_new (L515): null unless maxCycles >= BASIC_COLORS and
+     * colorsPerCycle > 0, so the table can at least hold the basic colors.
+     */
+    static create(maxCycles, colorsPerCycle) {
+        if (maxCycles < BASIC_COLORS || colorsPerCycle === 0)
+            return null;
+        return new VisualsFlicker(maxCycles, colorsPerCycle);
+    }
+    /** visuals_flicker_set_color (L574): set [cycle][color], ignore if OOB. */
+    setColor(cycleIndex, colorIndex, attr) {
+        if (cycleIndex >= this.maxCycles)
+            return;
+        if (colorIndex >= this.colorsPerCycle)
+            return;
+        this.cells[cycleIndex * this.colorsPerCycle + colorIndex] = attr;
+    }
+    /** visuals_flicker_get_color (L603): [cycle][color], 0 if out of range. */
+    getColor(cycleIndex, colorIndex) {
+        if (cycleIndex >= this.maxCycles)
+            return 0;
+        if (colorIndex >= this.colorsPerCycle)
+            return 0;
+        return this.cells[cycleIndex * this.colorsPerCycle + colorIndex];
+    }
+    /**
+     * visuals_flicker_get_attr_for_frame (L633): the flicker color for a base
+     * selection attr at a frame, or BASIC_COLORS if the attr is out of range.
+     */
+    getAttrForFrame(selectionAttr, frame) {
+        if (selectionAttr >= this.maxCycles)
+            return BASIC_COLORS;
+        const colorIndex = frame % this.colorsPerCycle;
+        return this.getColor(selectionAttr, colorIndex);
+    }
+}
+/**
+ * Build the legacy flicker table from the compiled `flicker` records.
+ * Faithful to visuals_parse_flicker (L828) + visuals_parse_flicker_color
+ * (L863): each flicker entry selects a table row by its color's attr and
+ * resets the step index; each following flicker-color fills the next step.
+ * Duplicate selection attrs overwrite the same row (last wins). Invalid
+ * color codes are skipped defensively (the C aborts parsing; the shipped
+ * data is valid, so this is unreachable for pack zero).
+ */
+export function buildVisualsFlicker(records) {
+    const table = VisualsFlicker.create(VISUALS_MAX_COLORS, FLICKER_COLORS_PER_CYCLE);
+    /* create() only returns null for an impossible (too-small) config. */
+    if (table === null)
+        throw new Error("visuals: could not allocate flicker table");
+    for (const rec of records) {
+        const selection = colorCharToAttr(rec.color?.[0] ?? "");
+        const steps = rec["flicker-color"] ?? [];
+        let colorIndex = 0;
+        for (const code of steps) {
+            const attr = colorCharToAttr(code[0] ?? "");
+            table.setColor(selection, colorIndex, attr);
+            colorIndex++;
+        }
+    }
+    return table;
+}
+/**
+ * Build the color-cycle table from the compiled `cycle` records. Faithful to
+ * visuals_parse_cycle (L900) + visuals_parse_cycle_color (L1001) followed by
+ * visuals_parse_context_convert (L768): each cycle is created with
+ * VISUALS_STEPS_MAX capacity, filled with its color attrs (capped at
+ * capacity, matching PARSE_ERROR_TOO_MANY_ENTRIES), then compressed into its
+ * group. Later group+name duplicates replace earlier ones.
+ */
+export function buildVisualsCycler(records) {
+    const cycler = new VisualsCycler();
+    for (const rec of records) {
+        if (!rec.group || !rec.name)
+            continue;
+        const cycle = VisualsColorCycle.create(rec.name, VISUALS_STEPS_MAX, VISUALS_INVALID_COLOR);
+        /* VISUALS_STEPS_MAX is nonzero, so create never returns null here. */
+        if (cycle === null)
+            continue;
+        const steps = rec["cycle-color"] ?? [];
+        let stepIndex = 0;
+        for (const code of steps) {
+            if (stepIndex >= cycle.maxSteps)
+                break; // PARSE_ERROR_TOO_MANY_ENTRIES
+            const attr = colorCharToAttr(code[0] ?? "");
+            cycle.setStep(stepIndex, attr);
+            stepIndex++;
+        }
+        cycler.addCycle(rec.group, cycle);
+    }
+    return cycler;
+}
+/* ----- Race binding + the animator ----- */
+/**
+ * The instantiable visuals animator: owns the flicker table, the color
+ * cycler, and the race->cycle lookup (the three ui-visuals.c module globals),
+ * and exposes the per-frame attr selection do_animation uses. Build one with
+ * createVisualsAnimator from the compiled visuals.txt record.
+ */
+export class VisualsAnimator {
+    flicker;
+    cycler;
+    /** visuals_color_cycles_by_race: ridx -> cycle (sparse). */
+    raceCycles;
+    constructor(flicker, cycler) {
+        this.flicker = flicker;
+        this.cycler = cycler;
+        this.raceCycles = [];
+    }
+    /**
+     * visuals_cycler_set_cycle_for_race (L420): map a race (by ridx) to a
+     * cycle. A missing group/cycle leaves the race un-cycled (no entry).
+     */
+    setCycleForRace(ridx, groupName, cycleName) {
+        if (ridx < 0 || !groupName || !cycleName)
+            return;
+        const cycle = this.cycler.cycleByName(groupName, cycleName);
+        if (cycle === null)
+            return;
+        this.raceCycles[ridx] = cycle;
+    }
+    /**
+     * visuals_cycler_get_attr_for_race (L468): the cycled attr for a race at a
+     * frame, or BASIC_COLORS when the race has no cycle.
+     */
+    getAttrForRace(ridx, frame) {
+        if (ridx < 0 || ridx >= this.raceCycles.length)
+            return BASIC_COLORS;
+        const cycle = this.raceCycles[ridx];
+        if (!cycle)
+            return BASIC_COLORS;
+        return cycle.attrForFrame(frame);
+    }
+}
+/**
+ * Assemble a VisualsAnimator from the compiled visuals.txt record
+ * (records[0] of pack visuals.json). Mirrors ui_visuals_module_init: create
+ * the flicker table and parse the cycler.
+ */
+export function createVisualsAnimator(record) {
+    const flicker = buildVisualsFlicker(record.flicker ?? []);
+    const cycler = buildVisualsCycler(record.cycle ?? []);
+    return new VisualsAnimator(flicker, cycler);
+}
+/**
+ * do_animation's per-monster attr selection (ui-display.c L1445-1464). Returns
+ * the animated attr, or null when the monster is not animated (upstream
+ * `continue`, leaving mon->attr untouched at its static value).
+ *
+ *  - RF_ATTR_MULTI: randint1(BASIC_COLORS - 1), a shimmering random color.
+ *  - RF_ATTR_FLICKER: the race's color cycle, else the legacy flicker cycle
+ *    for the base attr, else the static base attr.
+ *  - neither flag: null (static).
+ */
+export function animateMonsterAttr(animator, opts) {
+    if (opts.attrMulti) {
+        return opts.randint1(BASIC_COLORS - 1);
+    }
+    if (opts.attrFlicker) {
+        let attr = animator.getAttrForRace(opts.ridx, opts.frame);
+        if (attr === BASIC_COLORS) {
+            attr = animator.flicker.getAttrForFrame(opts.baseAttr, opts.frame);
+        }
+        if (attr === BASIC_COLORS) {
+            attr = opts.baseAttr;
+        }
+        return attr;
+    }
+    return null;
+}
+//# sourceMappingURL=engine.js.map

package/dist/visuals/engine.js.map

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

package/dist/visuals/glyph-table.d.ts

@@ -0,0 +1,112 @@
+/**
+ * The runtime attr/char override tables, ported from reference/src/ui-prefs.c
+ * (Angband 4.2.6): the `monster_x_attr` / `monster_x_char` /
+ * `kind_x_attr` / `kind_x_char` / `feat_x_attr[LIGHTING_MAX]` /
+ * `feat_x_char[LIGHTING_MAX]` / `trap_x_attr[LIGHTING_MAX]` /
+ * `trap_x_char[LIGHTING_MAX]` / `flavor_x_attr` / `flavor_x_char` globals
+ * (ui-prefs.c L46-56), their allocation (textui_prefs_init, L1427-1452) and
+ * their (re)initialisation from gamedata (reset_visuals, L1352-1421).
+ *
+ * WHY THIS IS A SEPARATE LAYER FROM THE GAMEDATA. Upstream never draws a
+ * monster with `race->d_attr`: every draw goes through the x_attr/x_char
+ * table, which merely STARTS at the gamedata default. Three things write to it
+ * after that - a pref file (`process_pref_file`'s parse_prefs_monster and
+ * friends, L602-928), the knowledge browser's glyph picker (`glyph_command`,
+ * ui-knowledge.c L597-752), and the graphics pref of the active tile mode -
+ * and four things read it back out (the map, the knowledge screens, the
+ * monster-list sidebar, and the `dump_*` pref writers). A port that reads
+ * `race.dAttr` at the draw site cannot express any of that, which is why the
+ * glyph picker and the four "Save ... attr/chars" rows were both absent.
+ *
+ * RELATIONSHIP TO TileMap (tile-prefs.ts). Upstream keeps ONE set of arrays
+ * and lets a graf-*.prf write high-bit values into them, so in graphics mode
+ * the very same slot holds an atlas (row, col) instead of an (attr, glyph).
+ * This port splits the two: TileMap holds the graphics mapping, this table
+ * holds the ASCII one. That is behaviourally equivalent because upstream only
+ * ever has one of the two interpretations live at a time (`use_graphics`
+ * gates it, and display_knowledge picks the tile picker or the glyph picker on
+ * the same flag, ui-knowledge.c L1052-1070) - but it means the glyph picker
+ * edits this table and the tile picker edits the TileMap, rather than both
+ * editing one array.
+ *
+ * ATTR NORMALISATION. Upstream's `d_attr` is already a uint8_t COLOUR_* code
+ * for every entity type. The port's compiled gamedata keeps the source text's
+ * spelling instead: a colour CHAR for features / kinds / traps (`"w"`), a
+ * colour NAME for flavours (`"Light Green"`), and an already-numeric attr for
+ * monster races. resetVisuals normalises all four to the numeric attr, so from
+ * here on the table is uniform exactly as the C's arrays are.
+ *
+ * Determinism: no RNG anywhere in this module.
+ */
+import type { Flavor, ObjectKind } from "../obj/types.js";
+import type { MonsterRace } from "../mon/types.js";
+import type { Feature } from "../world/feature.js";
+import type { TrapKind } from "../world/trap.js";
+/** One (attr, char) pair - upstream's parallel uint8_t/wchar_t slot pair. */
+export interface GlyphPair {
+    attr: number;
+    char: string;
+}
+/** The gamedata reset_visuals reads its defaults out of. */
+export interface GlyphTableDeps {
+    /** f_info, indexed by fidx (FEAT_MAX slots upstream). */
+    features: readonly Feature[];
+    /** k_info in kidx order. */
+    kinds: readonly ObjectKind[];
+    /** r_info in ridx order. */
+    races: readonly MonsterRace[];
+    /** trap_info in tidx order; null when the pack binds no traps. */
+    traps: readonly TrapKind[] | null;
+    /** The flavor list (upstream walks the `flavors` linked list by fidx). */
+    flavors: readonly Flavor[];
+}
+/**
+ * The x_attr/x_char arrays as one object. Sparse-safe: a read for an index the
+ * gamedata never bound falls back to the caller's default rather than
+ * throwing, because upstream's arrays are FEAT_MAX / r_max / k_max long and
+ * simply hold the zeroed slot for an unbound entry.
+ */
+export declare class GlyphTable {
+    private readonly deps;
+    /** monster_x_attr / monster_x_char[ridx]. */
+    private readonly monster;
+    /** kind_x_attr / kind_x_char[kidx]. */
+    private readonly kind;
+    /** feat_x_attr / feat_x_char[lighting][fidx]. */
+    private readonly feat;
+    /** trap_x_attr / trap_x_char[lighting][tidx]. */
+    private readonly trap;
+    /** flavor_x_attr / flavor_x_char[fidx]. */
+    private readonly flavor;
+    constructor(deps: GlyphTableDeps);
+    /**
+     * reset_visuals(false) (ui-prefs.c L1352): re-extract every default
+     * attr/char from the gamedata, discarding any pref-file or picker override.
+     * The `load_prefs` half of the C's signature is the caller's job here (the
+     * front end re-runs its own pref load, exactly as reset_visuals(true) then
+     * calls process_pref_file("font.prf") or the tile mode's graphics pref).
+     *
+     * WART KEPT: upstream resets flavours from the CURRENT flavor list, which is
+     * the shuffled per-game one, not a canonical order - so a reset restores the
+     * glyphs this savefile was born with, not the file order.
+     */
+    reset(): void;
+    monsterGlyph(ridx: number): GlyphPair | undefined;
+    kindGlyph(kidx: number): GlyphPair | undefined;
+    featGlyph(lighting: number, fidx: number): GlyphPair | undefined;
+    trapGlyph(lighting: number, tidx: number): GlyphPair | undefined;
+    flavorGlyph(fidx: number): GlyphPair | undefined;
+    setMonsterGlyph(ridx: number, pair: GlyphPair): void;
+    setKindGlyph(kidx: number, pair: GlyphPair): void;
+    /**
+     * parse_prefs_feat (ui-prefs.c L798-849): a `*` lighting field writes every
+     * variant, which is why this takes LIGHTING.MAX as "all".
+     */
+    setFeatGlyph(lighting: number, fidx: number, pair: GlyphPair): void;
+    /** set_trap_graphic (ui-prefs.c L733-743), with the same `*` convention. */
+    setTrapGlyph(lighting: number, tidx: number, pair: GlyphPair): void;
+    setFlavorGlyph(fidx: number, pair: GlyphPair): void;
+    /** The gamedata this table was built from, for the dump writers' names. */
+    get gamedata(): GlyphTableDeps;
+}
+//# sourceMappingURL=glyph-table.d.ts.map

package/dist/visuals/glyph-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glyph-table.d.ts","sourceRoot":"","sources":["../../src/visuals/glyph-table.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAGjD,6EAA6E;AAC7E,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,4BAA4B;IAC5B,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IAC7B,4BAA4B;IAC5B,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IAC9B,kEAAkE;IAClE,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,IAAI,CAAC;IAClC,0EAA0E;IAC1E,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B;AAED;;;;;GAKG;AACH,qBAAa,UAAU;IAYT,OAAO,CAAC,QAAQ,CAAC,IAAI;IAXjC,6CAA6C;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,uCAAuC;IACvC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmB;IACxC,iDAAiD;IACjD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmC;IACxD,iDAAiD;IACjD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmC;IACxD,2CAA2C;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;gBAEb,IAAI,EAAE,cAAc;IAIjD;;;;;;;;;;OAUG;IACH,KAAK,IAAI,IAAI;IA0Bb,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIjD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI9C,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIhE,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIhE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAMhD,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAIpD,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAIjD;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IASnE,4EAA4E;IAC5E,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IASnE,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAMnD,2EAA2E;IAC3E,IAAI,QAAQ,IAAI,cAAc,CAE7B;CACF"}

package/dist/visuals/glyph-table.js

@@ -0,0 +1,156 @@
+/**
+ * The runtime attr/char override tables, ported from reference/src/ui-prefs.c
+ * (Angband 4.2.6): the `monster_x_attr` / `monster_x_char` /
+ * `kind_x_attr` / `kind_x_char` / `feat_x_attr[LIGHTING_MAX]` /
+ * `feat_x_char[LIGHTING_MAX]` / `trap_x_attr[LIGHTING_MAX]` /
+ * `trap_x_char[LIGHTING_MAX]` / `flavor_x_attr` / `flavor_x_char` globals
+ * (ui-prefs.c L46-56), their allocation (textui_prefs_init, L1427-1452) and
+ * their (re)initialisation from gamedata (reset_visuals, L1352-1421).
+ *
+ * WHY THIS IS A SEPARATE LAYER FROM THE GAMEDATA. Upstream never draws a
+ * monster with `race->d_attr`: every draw goes through the x_attr/x_char
+ * table, which merely STARTS at the gamedata default. Three things write to it
+ * after that - a pref file (`process_pref_file`'s parse_prefs_monster and
+ * friends, L602-928), the knowledge browser's glyph picker (`glyph_command`,
+ * ui-knowledge.c L597-752), and the graphics pref of the active tile mode -
+ * and four things read it back out (the map, the knowledge screens, the
+ * monster-list sidebar, and the `dump_*` pref writers). A port that reads
+ * `race.dAttr` at the draw site cannot express any of that, which is why the
+ * glyph picker and the four "Save ... attr/chars" rows were both absent.
+ *
+ * RELATIONSHIP TO TileMap (tile-prefs.ts). Upstream keeps ONE set of arrays
+ * and lets a graf-*.prf write high-bit values into them, so in graphics mode
+ * the very same slot holds an atlas (row, col) instead of an (attr, glyph).
+ * This port splits the two: TileMap holds the graphics mapping, this table
+ * holds the ASCII one. That is behaviourally equivalent because upstream only
+ * ever has one of the two interpretations live at a time (`use_graphics`
+ * gates it, and display_knowledge picks the tile picker or the glyph picker on
+ * the same flag, ui-knowledge.c L1052-1070) - but it means the glyph picker
+ * edits this table and the tile picker edits the TileMap, rather than both
+ * editing one array.
+ *
+ * ATTR NORMALISATION. Upstream's `d_attr` is already a uint8_t COLOUR_* code
+ * for every entity type. The port's compiled gamedata keeps the source text's
+ * spelling instead: a colour CHAR for features / kinds / traps (`"w"`), a
+ * colour NAME for flavours (`"Light Green"`), and an already-numeric attr for
+ * monster races. resetVisuals normalises all four to the numeric attr, so from
+ * here on the table is uniform exactly as the C's arrays are.
+ *
+ * Determinism: no RNG anywhere in this module.
+ */
+import { colorCharToAttr, colorTextToAttr } from "../color.js";
+import { LIGHTING } from "./tile-prefs.js";
+/**
+ * The x_attr/x_char arrays as one object. Sparse-safe: a read for an index the
+ * gamedata never bound falls back to the caller's default rather than
+ * throwing, because upstream's arrays are FEAT_MAX / r_max / k_max long and
+ * simply hold the zeroed slot for an unbound entry.
+ */
+export class GlyphTable {
+    deps;
+    /** monster_x_attr / monster_x_char[ridx]. */
+    monster = [];
+    /** kind_x_attr / kind_x_char[kidx]. */
+    kind = [];
+    /** feat_x_attr / feat_x_char[lighting][fidx]. */
+    feat = [[], [], [], []];
+    /** trap_x_attr / trap_x_char[lighting][tidx]. */
+    trap = [[], [], [], []];
+    /** flavor_x_attr / flavor_x_char[fidx]. */
+    flavor = [];
+    constructor(deps) {
+        this.deps = deps;
+        this.reset();
+    }
+    /**
+     * reset_visuals(false) (ui-prefs.c L1352): re-extract every default
+     * attr/char from the gamedata, discarding any pref-file or picker override.
+     * The `load_prefs` half of the C's signature is the caller's job here (the
+     * front end re-runs its own pref load, exactly as reset_visuals(true) then
+     * calls process_pref_file("font.prf") or the tile mode's graphics pref).
+     *
+     * WART KEPT: upstream resets flavours from the CURRENT flavor list, which is
+     * the shuffled per-game one, not a canonical order - so a reset restores the
+     * glyphs this savefile was born with, not the file order.
+     */
+    reset() {
+        for (const f of this.deps.features) {
+            const pair = { attr: colorCharToAttr(f.dAttr), char: f.dChar };
+            for (let j = 0; j < LIGHTING.MAX; j++) {
+                this.feat[j][f.fidx] = { ...pair };
+            }
+        }
+        for (const k of this.deps.kinds) {
+            this.kind[k.kidx] = { attr: colorCharToAttr(k.dAttr), char: k.dChar };
+        }
+        for (const r of this.deps.races) {
+            this.monster[r.ridx] = { attr: r.dAttr, char: r.dChar };
+        }
+        for (const t of this.deps.traps ?? []) {
+            const pair = { attr: colorCharToAttr(t.color), char: t.glyph };
+            for (let j = 0; j < LIGHTING.MAX; j++) {
+                this.trap[j][t.tidx] = { ...pair };
+            }
+        }
+        for (const f of this.deps.flavors) {
+            this.flavor[f.fidx] = { attr: colorTextToAttr(f.dAttr), char: f.dChar };
+        }
+    }
+    /* ----- reads (the draw sites and the dump writers) ----- */
+    monsterGlyph(ridx) {
+        return this.monster[ridx];
+    }
+    kindGlyph(kidx) {
+        return this.kind[kidx];
+    }
+    featGlyph(lighting, fidx) {
+        return this.feat[lighting]?.[fidx];
+    }
+    trapGlyph(lighting, tidx) {
+        return this.trap[lighting]?.[tidx];
+    }
+    flavorGlyph(fidx) {
+        return this.flavor[fidx];
+    }
+    /* ----- writes (the pref parser and the glyph picker) ----- */
+    setMonsterGlyph(ridx, pair) {
+        this.monster[ridx] = { ...pair };
+    }
+    setKindGlyph(kidx, pair) {
+        this.kind[kidx] = { ...pair };
+    }
+    /**
+     * parse_prefs_feat (ui-prefs.c L798-849): a `*` lighting field writes every
+     * variant, which is why this takes LIGHTING.MAX as "all".
+     */
+    setFeatGlyph(lighting, fidx, pair) {
+        if (lighting === LIGHTING.MAX) {
+            for (let j = 0; j < LIGHTING.MAX; j++)
+                this.feat[j][fidx] = { ...pair };
+            return;
+        }
+        const row = this.feat[lighting];
+        if (row)
+            row[fidx] = { ...pair };
+    }
+    /** set_trap_graphic (ui-prefs.c L733-743), with the same `*` convention. */
+    setTrapGlyph(lighting, tidx, pair) {
+        if (lighting === LIGHTING.MAX) {
+            for (let j = 0; j < LIGHTING.MAX; j++)
+                this.trap[j][tidx] = { ...pair };
+            return;
+        }
+        const row = this.trap[lighting];
+        if (row)
+            row[tidx] = { ...pair };
+    }
+    setFlavorGlyph(fidx, pair) {
+        this.flavor[fidx] = { ...pair };
+    }
+    /* ----- enumeration (the dump_* writers walk the whole table) ----- */
+    /** The gamedata this table was built from, for the dump writers' names. */
+    get gamedata() {
+        return this.deps;
+    }
+}
+//# sourceMappingURL=glyph-table.js.map

package/dist/visuals/glyph-table.js.map

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

package/dist/visuals/grafmode-data.d.ts

@@ -0,0 +1,4 @@
+import type { GraphicsMode } from "./grafmode.js";
+/** Every parsed graphics mode from list.txt, in file order (grafID 1..N). */
+export declare const GRAPHICS_MODE_CATALOG: readonly GraphicsMode[];
+//# sourceMappingURL=grafmode-data.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"grafmode-data.d.ts","sourceRoot":"","sources":["../../src/visuals/grafmode-data.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,6EAA6E;AAC7E,eAAO,MAAM,qBAAqB,EAAE,SAAS,YAAY,EAyExD,CAAC"}