@rpgm-tools/neo-angband-core 0.10.0

package/dist/visuals/pref-expr.js

@@ -0,0 +1,173 @@
+/**
+ * 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 value an unknown variable, unknown connective or empty expression takes. */
+export const PREF_EXPR_UNKNOWN = "?o?o?";
+/** The value an unterminated `[` takes. */
+export const PREF_EXPR_MALFORMED = "?x?x?";
+/** isspace(), for the leading-space skip. */
+function isSpace(c) {
+    return c === " " || c === "\t" || c === "\n" || c === "\v" || c === "\f" || c === "\r";
+}
+/**
+ * isprint() in the C locale: the token scan stops at anything else, so a byte
+ * >= 0x7F ends a token exactly as it does upstream.
+ */
+function isPrint(c) {
+    const n = c.charCodeAt(0);
+    return n >= 0x20 && n < 0x7f;
+}
+/** strcmp's sign, for LEQ/GEQ (upstream compares bytes, not numbers). */
+function strcmp(a, b) {
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+/**
+ * One recursive step of process_pref_file_expr.
+ *
+ * Upstream walks a mutable buffer and terminates each token in place; this walks
+ * an index instead, which is exactly equivalent because `s` only ever moves
+ * forward and no position is read twice. The `f` out-parameter is carried in the
+ * return value.
+ */
+function step(src, from, vars) {
+    let i = from;
+    while (i < src.length && isSpace(src[i]))
+        i++;
+    const b = i;
+    let value = PREF_EXPR_UNKNOWN;
+    let final = "";
+    if (src[i] === "[") {
+        i++;
+        let r = step(src, i, vars);
+        i = r.next;
+        final = r.final;
+        let t = r.value;
+        /* `*s && (f != ']')`: there is input left and the bracket has not closed. */
+        const more = () => i < src.length && final !== "]";
+        const nextTok = () => {
+            r = step(src, i, vars);
+            i = r.next;
+            final = r.final;
+            return r.value;
+        };
+        if (t.length === 0) {
+            /* "Nothing" - the value stays unknown (L487-488). */
+        }
+        else if (t === "IOR") {
+            value = "0";
+            while (more()) {
+                t = nextTok();
+                if (t.length > 0 && t !== "0")
+                    value = "1";
+            }
+        }
+        else if (t === "AND") {
+            value = "1";
+            while (more()) {
+                t = nextTok();
+                if (t.length > 0 && t === "0")
+                    value = "0";
+            }
+        }
+        else if (t === "NOT") {
+            value = "1";
+            while (more()) {
+                t = nextTok();
+                if (t.length > 0 && t !== "0")
+                    value = "0";
+            }
+        }
+        else if (t === "EQU" || t === "LEQ" || t === "GEQ") {
+            const op = t;
+            value = "1";
+            /* The first operand is fetched outside the loop, then each subsequent one
+             * is compared against its PREDECESSOR, not against the first (L505-532). */
+            if (more())
+                t = nextTok();
+            while (more()) {
+                const p = t;
+                t = nextTok();
+                if (t.length === 0)
+                    continue;
+                const c = strcmp(p, t);
+                /* LEQ/GEQ are STRICT: upstream zeroes the result on `>= 0` and `<= 0`. */
+                const fails = op === "EQU" ? c !== 0 : op === "LEQ" ? c >= 0 : c <= 0;
+                if (fails)
+                    value = "0";
+            }
+        }
+        else {
+            /* An unknown connective: consume the bracket and stay unknown (L534-538). */
+            while (more())
+                nextTok();
+        }
+        if (final !== "]")
+            value = PREF_EXPR_MALFORMED;
+        final = i < src.length ? src[i] : "";
+        if (final !== "")
+            i++;
+    }
+    else {
+        while (i < src.length && isPrint(src[i]) && " []".indexOf(src[i]) < 0)
+            i++;
+        const tok = src.slice(b, i);
+        final = i < src.length ? src[i] : "";
+        if (final !== "")
+            i++;
+        if (tok.startsWith("$")) {
+            /* L553-560: three variables, and an unrecognised one keeps the default. */
+            const name = tok.slice(1);
+            const v = name === "SYS" ? vars.SYS : name === "RACE" ? vars.RACE : name === "CLASS" ? vars.CLASS : undefined;
+            if (v !== undefined)
+                value = v;
+        }
+        else {
+            value = tok;
+        }
+    }
+    return { value, final, next: i };
+}
+/**
+ * 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 function evalPrefExpr(expr, vars = {}) {
+    return step(expr, 0, vars).value;
+}
+/** The `?` line's own question: does this expression bypass what follows? */
+export function prefExprBypasses(expr, vars = {}) {
+    return evalPrefExpr(expr, vars) === "0";
+}
+//# sourceMappingURL=pref-expr.js.map

package/dist/visuals/pref-expr.js.map

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

package/dist/visuals/prefs.d.ts

@@ -0,0 +1,280 @@
+/**
+ * The pref-file subsystem, ported from reference/src/ui-prefs.c (Angband
+ * 4.2.6): the writer half (`prefs_save`, `remove_old_dump`, `pref_header` /
+ * `pref_footer` and the eight `dump_*` functions) and the reader half
+ * (`init_parse_prefs`'s line grammar, `process_pref_file_named`'s loop and
+ * `print_error`).
+ *
+ * ONE grammar, TWO consumers. Upstream has a single set of x_attr/x_char arrays
+ * and a single parser that writes into them; whether a value means "colour +
+ * glyph" or "atlas row + column" depends only on whether graphics are on. The
+ * port splits the STORAGE (GlyphTable for ASCII, TileMap for tiles - see
+ * glyph-table.ts for why) but must not split the GRAMMAR, so this module owns
+ * the decoders and drives an injected `PrefSink`; tile-prefs.ts is one sink over
+ * it and glyphTableSink() is the other. That keeps the `object:tval:*` wildcard,
+ * the `feat`/`trap` `*` lighting field, the `GF` `|` type list and the base-0
+ * integer rules in exactly one place.
+ *
+ * Values stay NUMERIC through the sink, as upstream's wchar_t does: the pref
+ * grammar writes the glyph as an integer (`0x%02X` for monsters, `%d` for
+ * feat/object/flavor) and a graphics pack's "char" is an atlas column, not text.
+ * The GlyphTable sink is what turns a code point into a string.
+ *
+ * Determinism: no RNG. Parsing and dumping are pure functions of their inputs.
+ */
+import type { ObjRegistry } from "../obj/bind.js";
+import type { TrapKind } from "../world/trap.js";
+import type { FeatureRegistry } from "../world/feature.js";
+import { GlyphTable } from "./glyph-table.js";
+import type { PrefExprVars } from "./pref-expr.js";
+import { TileMap } from "./tile-prefs.js";
+import type { TilePrefsDeps } from "./tile-prefs.js";
+/** The registries a pref line resolves names/tvals against. */
+export interface PrefDeps {
+    features: FeatureRegistry;
+    objects: ObjRegistry;
+    /** MonsterRegistry: lookup_monster plus lookup_monster_base. */
+    monsters: {
+        raceByName(name: string): {
+            ridx: number;
+        } | null;
+        races?: readonly {
+            ridx: number;
+            base: {
+                name: string;
+            };
+        }[];
+    };
+    /** Bound trap kinds (t_idx order), or null when the pack has none. */
+    traps: readonly TrapKind[] | null;
+}
+/**
+ * One `parser_error`, as print_error formats it (ui-prefs.c L1195-1202).
+ * `msg` is the offending token (parser_state.msg) and `error` the enum_parser
+ * error CODE, resolved to parser_error_str[]'s text by prefErrorMessage.
+ */
+export interface PrefError {
+    line: number;
+    col: number;
+    msg: string;
+    error: number;
+}
+/**
+ * parser_error_str[] (parser.c L36-100), generated straight from
+ * list-parser-errors.h - the codegen'd table, NOT a hand-typed copy. Upstream
+ * spells several of these differently from the handler names ("invalid colour",
+ * "unrecognized tval"), which is exactly the sort of thing a transcription gets
+ * wrong.
+ */
+export declare function parserErrorText(code: number): string;
+/**
+ * Everything a parsed pref line can change. The six glyph directives are
+ * required (they are the reason both consumers exist); the rest are optional so
+ * a graphics-only sink can ignore them exactly as a graf-*.prf never uses them.
+ */
+export interface PrefSink {
+    setFeat(lighting: number, fidx: number, attr: number, char: number): void;
+    setTrap(lighting: number, tidx: number, attr: number, char: number): void;
+    setMonster(ridx: number, attr: number, char: number): void;
+    setKind(kidx: number, attr: number, char: number): void;
+    setFlavor(fidx: number, attr: number, char: number): void;
+    setProjection(proj: number, motion: number, attr: number, char: number): void;
+    /** parse_prefs_inscribe -> add_autoinscription(kidx, text, true). */
+    addAutoinscription?(kidx: number, text: string): void;
+    /** parse_prefs_keymap_action: stash the action text for the next input line. */
+    keymapAct?(text: string): void;
+    /** parse_prefs_keymap_input -> keymap_add(mode, key, buffer, user). */
+    keymapInput?(mode: number, key: string, act: string): void;
+    /** parse_prefs_message -> message_color_define(msg_index, attr). */
+    messageColor?(msgIndex: number, attr: number): void;
+    /** parse_prefs_color -> angband_color_table[idx] = {k,r,g,b}. */
+    colorTable?(idx: number, k: number, r: number, g: number, b: number): void;
+    /** parse_prefs_window: the subwindow flag set finish_parse_prefs applies. */
+    windowFlag?(window: number, flag: number, value: number): void;
+    /** parse_prefs_entry_renderer -> ui_entry_renderer_customize. */
+    entryRenderer?(name: string, colors: string | null, labelColors: string | null, symbols: string | null): void;
+    /** `%` include (parse_prefs_load): the referenced file's text, or null. */
+    loadFile?(name: string): string | null;
+}
+/**
+ * parse_int / parse_uint (parser.c L313-320: `strtol(tok, &z, 0)`), including
+ * strtol's LENIENCY, which is load-bearing: it skips leading whitespace, takes
+ * an optional sign, reads the longest valid base-0 digit run (0x/0X hex, a
+ * leading 0 as octal, otherwise decimal) and simply STOPS at the first
+ * character it cannot use. The parser reports NOT_NUMBER only when nothing at
+ * all was consumed (`z == tok`) - trailing text is discarded in silence.
+ *
+ * Requiring a clean token instead - which this did until 2026-07-31 - throws
+ * away every pref line with a trailing comment. Measured across the five
+ * bundled packs' 16 pref files: 132 such lines, ALL of them in
+ * shockbolt/xtra-shb.prf, and all 132 of them are the `monster:<player>` lines
+ * that end `0x83:0x87 #  `. So Shockbolt's special player pictures never reached
+ * the tile map at all, whatever the character was.
+ *
+ * "0x" with no hex digits reads as the plain 0 that precedes it, and "08" as 0,
+ * both exactly as strtol does.
+ */
+export declare function parsePrefNum(tok: string): number | null;
+/**
+ * The lighting keyword -> LIGHTING index, LIGHTING.MAX for `*` ("all
+ * variants"), or -1 for an invalid keyword (ui-prefs.c L824-836).
+ */
+export declare function prefLightingIdx(kw: string): number;
+/** Options process_pref_file_named's caller controls. */
+export interface ProcessPrefOptions {
+    /**
+     * The $VAR values `?` expression lines test. Upstream has exactly three -
+     * SYS, RACE and CLASS (ui-prefs.c L553-560) - and the graphics packs' player
+     * pictures are selected entirely by RACE and CLASS, so a caller that omits
+     * them gets whatever the pack's unconditional lines set.
+     */
+    vars?: PrefExprVars;
+    /**
+     * get_parser_error_limit(): stop after this many bad lines (0 = no limit).
+     * Upstream's default is 0 (ui-init.c / z-util), so every error is reported.
+     */
+    errorLimit?: number;
+    /** Recursion guard for `%` includes; upstream relies on the filesystem. */
+    depth?: number;
+}
+/**
+ * process_pref_file_named's parse loop (ui-prefs.c L1212-1262) over already-read
+ * text. Returns every parse error in order, so the caller can print each one
+ * through `print_error` and decide the boolean result (upstream: false if ANY
+ * line failed).
+ *
+ * A `#` line is a comment, a blank line is skipped, `%` includes another file
+ * through sink.loadFile, and `?` sets the bypass flag that makes every
+ * following handler a no-op until the next `?`.
+ */
+export declare function processPrefText(text: string, deps: PrefDeps, sink: PrefSink, opts?: ProcessPrefOptions): PrefError[];
+/** print_error's exact text (ui-prefs.c L1195-1202). */
+export declare function prefErrorMessage(name: string, e: PrefError): string;
+/**
+ * A PrefSink that writes the six glyph directives into a GlyphTable, turning
+ * each numeric char field into the string the table stores. The non-glyph
+ * directives are the caller's to supply (spread `...extra` over the result).
+ */
+export declare function glyphTableSink(table: GlyphTable, extra?: Partial<PrefSink>): PrefSink;
+/** dump_separator (ui-prefs.c L66). */
+export declare const DUMP_SEPARATOR = "#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#=#";
+/** pref_header (ui-prefs.c L153-163). */
+export declare function prefHeader(mark: string): string;
+/** pref_footer (ui-prefs.c L165-176). */
+export declare function prefFooter(mark: string): string;
+/**
+ * remove_old_dump (ui-prefs.c L75-146) over text rather than two file handles:
+ * strip the lines between `<sep> begin <mark>` and `<sep> end <mark>`, the end
+ * marker included (`skip_one`). Returns null when nothing was between marks, so
+ * the caller can skip the file rotation exactly as the C destroys its temp file
+ * when `changed` stayed false.
+ */
+export declare function removeOldDump(text: string, mark: string): string | null;
+/**
+ * prefs_save (ui-prefs.c L391-421) against an injected file layer: strip any
+ * previous dump with the same title, then APPEND header + body + footer.
+ * Returns false when the file cannot be opened for append, exactly as the C
+ * does - which is what makes the caller print "Failed to save %s.".
+ */
+export interface PrefsFileIO {
+    /** file_exists + a full read, or null when there is no such file. */
+    read(path: string): string | null;
+    /** file_open(MODE_WRITE) + write + close; false on any failure. */
+    write(path: string, text: string): boolean;
+}
+export declare function prefsSave(io: PrefsFileIO, path: string, dump: () => string, title: string): boolean;
+/** The gamedata + live table a dump writer walks. */
+export interface DumpDeps {
+    table: GlyphTable;
+    objects: ObjRegistry;
+    features: FeatureRegistry;
+    monsters: {
+        races: readonly {
+            ridx: number;
+            name: string;
+        }[];
+    };
+    /** get_autoinscription(kind, true): the AWARE note, or null. */
+    autoinscription?: (kidx: number) => string | null;
+    /** ui_entry_renderer_* enumeration, in index order. */
+    entryRenderers?: readonly {
+        name: string;
+        colors: string;
+        labelColors: string;
+        symbols: string;
+    }[];
+}
+/** dump_monsters (ui-prefs.c L178-192): `monster:%s:0x%02X:0x%02X`. */
+export declare function dumpMonsters(deps: DumpDeps): string;
+/**
+ * dump_objects (ui-prefs.c L197-215): a `# Objects` header then one line per
+ * named kind with a real tval, naming the kind by object_short_name.
+ */
+export declare function dumpObjects(deps: DumpDeps): string;
+/**
+ * object_short_name (obj-util.c L233-249): strip a leading `& ` article and
+ * every `~` pluralisation marker - the form a pref file's `object:` and
+ * `inscribe:` lines name a kind by, and the form parse_prefs_object's
+ * lookup_sval matches against.
+ */
+export declare function objectShortName(name: string): string;
+/** dump_autoinscriptions (ui-prefs.c L218-236): only AWARE notes are dumped. */
+export declare function dumpAutoinscriptions(deps: DumpDeps): string;
+/**
+ * dump_features (ui-prefs.c L239-276): a `# Terrain:` comment then one `feat:`
+ * line per lighting variant, skipping nameless and MIMIC features. The name in
+ * the line is the terrain CODE (get_feat_code_name), not the printable name.
+ *
+ * The C's keyword chain reads oddly - `if (TORCH) light="torch"; if (LOS)
+ * light="los"; else if (LIT) ... else if (DARK) ...` - the second `if` is not
+ * an `else if`. Re-derived: it is nonetheless correct, because none of LOS /
+ * LIT / DARK can equal TORCH, so the else-chain never runs on the pass that
+ * set "torch". Transcribed in the same shape rather than tidied, so the next
+ * reader can check the same thing against the same lines.
+ */
+export declare function dumpFeatures(deps: DumpDeps): string;
+/** dump_flavors (ui-prefs.c L279-292): a comment plus a blank line per flavour. */
+export declare function dumpFlavors(deps: DumpDeps): string;
+/**
+ * dump_colors (ui-prefs.c L295-320): every colour row, skipping all-zero rows
+ * at or past BASIC_COLORS. Only basic colours get their table name.
+ */
+export declare function dumpColors(): string;
+/** dump_ui_entry_renderers (ui-prefs.c L323-349). */
+export declare function dumpUiEntryRenderers(deps: DumpDeps): string;
+/**
+ * option_dump (ui-prefs.c L352-386): the SUBWINDOW flag set, not the game
+ * options - the row that drives it is labelled "Save subwindow setup to pref
+ * file". The port is one terminal with no subwindows, so there is nothing to
+ * enumerate and the dump is its header alone, which is exactly what upstream
+ * writes when no angband_term[i>0] exists (a single-window build).
+ */
+export declare function optionDump(): string;
+/**
+ * A PrefSink (prefs.ts) that writes into a TileMap: the graphics-mode
+ * interpretation of the very same x_attr/x_char slots the ASCII GlyphTable
+ * sink fills. The grammar - the `object:tval:*` wildcards, the `*` lighting
+ * field, the `GF` `|` type list, base-0 integers, `%` includes - lives in
+ * prefs.ts and is shared, because upstream has exactly one parser for it.
+ * Values stay raw here (high bit and all): decoding attr/char to an atlas
+ * (row, col) is the front end's job, exactly as upstream keeps the raw bytes.
+ *
+ * setProjection is the one slot the ASCII sink has nothing to write to, since
+ * the port's bolt animation draws its own character rather than reading a
+ * proj_to_char table.
+ */
+export declare function tileMapSink(map: TileMap, deps: TilePrefsDeps): PrefSink;
+/**
+ * Parse a graf-*.prf or flvr-*.prf text INTO an existing TileMap (so a graf
+ * file and its flvr file layer into one map). Later lines overwrite earlier
+ * ones for the same entity, exactly as the C reassigns the x_attr/x_char slot.
+ *
+ * Parse errors are dropped rather than reported: a graphics pref is loaded by
+ * reset_visuals(true) with `quiet` semantics, and an entity this build does not
+ * know simply keeps its ASCII glyph. `processPrefText` returns them for the
+ * user-pref path, which does print them.
+ */
+export declare function parseTilePrefsInto(map: TileMap, text: string, deps: TilePrefsDeps): void;
+/** Parse pref text into a fresh TileMap. */
+export declare function parseTilePrefs(text: string, deps: TilePrefsDeps): TileMap;
+//# sourceMappingURL=prefs.d.ts.map

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

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