@rpgm-tools/neo-angband-core 0.10.0

package/dist/player/history.js

@@ -0,0 +1,145 @@
+/**
+ * Character auto-history creation and management, ported from
+ * reference/src/player-history.c (Angband 4.2.6).
+ *
+ * struct history_info (player-history.h L47-54) becomes HistoryInfo below.
+ * Upstream's `type` field is a bitflag SET (bitflag type[HIST_SIZE]); the
+ * port models it as a single JS number bitmask, since HIST_MAX (11, see
+ * generated/history-types.ts) fits comfortably in bits 0..10 and at most two
+ * or three bits are ever combined (e.g. ARTIFACT_UNKNOWN|ARTIFACT_LOST on a
+ * "Missed X" entry). historyAdd sets exactly one bit (1 << typeBit),
+ * matching history_add's hist_wipe + hist_on(flags, type) (L127-134).
+ *
+ * Upstream's player_history struct additionally tracks `next`/`length` for
+ * its manually-grown C array (history_init/history_realloc); the port's
+ * Player.hist is a plain growable array, so array length stands in for
+ * `next` and there is nothing to persist beyond the entries themselves.
+ *
+ * This module is pure (player/ layer): every function takes explicit
+ * dlev/clev/turn stamps and a `nameFn` for artifact text, exactly like
+ * history_add_full's parameters, so it draws no RNG and depends on no
+ * GameState. The game-layer stamp (dlev/clev/turn off live state) and the
+ * artifact fake-name builder live in game/history.ts.
+ */
+import { HIST } from "../generated/index.js";
+/** hist_has(f, flag): whether bit `flagBit` is set in the type bitmask. */
+export function histHas(type, flagBit) {
+    return (type & (1 << flagBit)) !== 0;
+}
+/** hist_on(f, flag): set bit `flagBit` on the entry's type bitmask. */
+function histOn(entry, flagBit) {
+    entry.type |= 1 << flagBit;
+}
+/** hist_off(f, flag): clear bit `flagBit` on the entry's type bitmask. */
+function histOff(entry, flagBit) {
+    entry.type &= ~(1 << flagBit);
+}
+/** history_clear (player-history.c L56-67): empty the log. */
+export function historyClear(p) {
+    p.hist = [];
+}
+/**
+ * history_add_full (player-history.c L76-105): append a fully-specified
+ * entry. `text` is truncated to 79 characters (my_strcpy into event[80]
+ * leaves room for the NUL). Always succeeds (the port's array has no fixed
+ * capacity to fail against), matching the C's unconditional `return true`.
+ */
+export function historyAddFull(p, type, aIdx, dlev, clev, turn, text) {
+    p.hist.push({ type, dlev, clev, aIdx, turn, event: text.slice(0, 79) });
+    return true;
+}
+/**
+ * history_add (player-history.c L127-134): add an entry with a single HIST_*
+ * type bit, no artifact. Mirrors history_add_with_flags's stamp (aidx 0,
+ * p->depth, p->lev, p->total_energy/100) via the caller-supplied dlev/clev/
+ * turn (the game layer reads those off live state; see game/history.ts).
+ */
+export function historyAdd(p, text, typeBit, dlev, clev, turn) {
+    return historyAddFull(p, 1 << typeBit, 0, dlev, clev, turn, text);
+}
+/**
+ * history_is_artifact_known (player-history.c L139-153): true if a KNOWN
+ * entry for this artifact exists. Scans newest-first, exactly as upstream.
+ */
+export function historyIsArtifactKnown(p, art) {
+    for (let i = p.hist.length - 1; i >= 0; i--) {
+        const e = p.hist[i];
+        if (histHas(e.type, HIST.ARTIFACT_KNOWN) && e.aIdx === art.aidx)
+            return true;
+    }
+    return false;
+}
+/**
+ * history_mark_artifact_known (player-history.c L158-173): flip the first
+ * (newest) matching-aidx entry from UNKNOWN to KNOWN. Returns whether a
+ * matching entry was found.
+ */
+function historyMarkArtifactKnown(p, art) {
+    for (let i = p.hist.length - 1; i >= 0; i--) {
+        const e = p.hist[i];
+        if (e.aIdx === art.aidx) {
+            histOff(e, HIST.ARTIFACT_UNKNOWN);
+            histOn(e, HIST.ARTIFACT_KNOWN);
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * history_mark_artifact_lost (player-history.c L178-192): flip the LOST bit
+ * on the first (newest) matching-aidx entry. Returns whether found.
+ */
+function historyMarkArtifactLost(p, art) {
+    for (let i = p.hist.length - 1; i >= 0; i--) {
+        const e = p.hist[i];
+        if (e.aIdx === art.aidx) {
+            histOn(e, HIST.ARTIFACT_LOST);
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * history_find_artifact (player-history.c L223-241): reveal an existing
+ * artifact entry, or log a new "Found <name>" KNOWN entry. `nameFn` builds
+ * the spoiled artifact name (get_artifact_name, L197-215); the game layer's
+ * artifactHistoryName is RNG-free (objectPrep with the "maximise" aspect).
+ */
+export function historyFindArtifact(p, art, dlev, clev, turn, nameFn) {
+    if (!historyMarkArtifactKnown(p, art)) {
+        const text = `Found ${nameFn(art)}`;
+        historyAddFull(p, 1 << HIST.ARTIFACT_KNOWN, art.aidx, dlev, clev, turn, text);
+    }
+}
+/**
+ * history_lose_artifact (player-history.c L246-266): mark an artifact lost,
+ * or log a new "Missed <name>" UNKNOWN|LOST entry.
+ */
+export function historyLoseArtifact(p, art, dlev, clev, turn, nameFn) {
+    if (!historyMarkArtifactLost(p, art)) {
+        const text = `Missed ${nameFn(art)}`;
+        const type = (1 << HIST.ARTIFACT_UNKNOWN) | (1 << HIST.ARTIFACT_LOST);
+        historyAddFull(p, type, art.aidx, dlev, clev, turn, text);
+    }
+}
+/**
+ * history_unmask_unknown (player-history.c L272-283): convert every
+ * ARTIFACT_UNKNOWN entry to ARTIFACT_KNOWN. Called once at death (matching
+ * player-util.c death_knowledge L309) so the memorial/char-dump shows real
+ * artifact names; 4.2.6 never writes a HIST_PLAYER_DEATH entry (verified:
+ * zero uses of that type in reference/src), so death logs nothing new here.
+ */
+export function historyUnmaskUnknown(p) {
+    for (let i = p.hist.length - 1; i >= 0; i--) {
+        const e = p.hist[i];
+        if (histHas(e.type, HIST.ARTIFACT_UNKNOWN)) {
+            histOff(e, HIST.ARTIFACT_UNKNOWN);
+            histOn(e, HIST.ARTIFACT_KNOWN);
+        }
+    }
+}
+/** history_get_list (player-history.c L288-294): the entries, oldest-first. */
+export function historyGetList(p) {
+    return p.hist;
+}
+//# sourceMappingURL=history.js.map

package/dist/player/history.js.map

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

package/dist/player/options.d.ts

@@ -0,0 +1,123 @@
+/**
+ * The player option store, ported from reference/src/option.c (Angband 4.2.6).
+ *
+ * option.c owns the option table (list-options.h, codegen'd to
+ * generated/options.ts as OPTION_ENTRIES) plus a small amount of runtime
+ * behaviour: options_init_defaults (each option's `normal` value, the
+ * delay_factor = 40 and hitpoint_warn = 3 defaults) and the cheat/score
+ * coupling in option_set (turning a cheat_* option on forces its score_*
+ * twin, which suppresses scoring). This module is the pure data half of
+ * that; the option MENU (ui-options.c, the keypress screens) is DEFERRED as
+ * a platform-native menu concern (see parity/ledger/options.yaml).
+ *
+ * Faithful notes:
+ * - Defaults are read straight from OPTION_ENTRIES (do not hand-copy the
+ *   table): each option is seeded from its `normal` field.
+ * - hitpoint_warn is the 0..9 integer op_ptr->hitpoint_warn (DEFAULT 3), kept
+ *   alongside the booleans. delay_factor (default 40) and lazymove_delay
+ *   (player->opts.lazymove_delay, default 0, uint8) are carried too.
+ * - Birth options (type BIRTH) are chosen at character creation and then
+ *   locked: an immutable snapshot is captured at construction, and set()
+ *   refuses to change a birth option afterwards (upstream shows them
+ *   read-only in-game; only the birth process sets them).
+ * - The cheat/score linkage keys off the table order (each cheat_X is
+ *   immediately followed by score_X), reproduced by name (cheat_X -> score_X).
+ *
+ * Pure: no DOM, no filesystem. The session wires an OptionState onto the
+ * GameState and each deferred seam reads it through state.options.
+ */
+import { OPTION_ENTRIES } from "../generated/options.js";
+/** Every option name in the table (the `name` field of OPTION_ENTRIES). */
+export type OptionName = (typeof OPTION_ENTRIES)[number]["name"];
+/** option.c options_init_defaults: op_ptr->hitpoint_warn default (0..9). */
+export declare const DEFAULT_HITPOINT_WARN = 3;
+/** option.c options_init_defaults: op_ptr->delay_factor default (ms). */
+export declare const DEFAULT_DELAY_FACTOR = 40;
+/**
+ * player->opts.lazymove_delay default. options_init_defaults does NOT set it,
+ * so it keeps the struct-zero value (0 = no lazy-move disturbance pause).
+ * ui-options.c do_cmd_lazymove_delay clamps it to a uint8 (MIN(delay, 255)).
+ */
+export declare const DEFAULT_LAZYMOVE_DELAY = 0;
+/** A plain map of option name -> boolean value (the serialized form). */
+export type OptionValues = Record<string, boolean>;
+/** The serialized OptionState (save format). */
+export interface OptionStateData {
+    /** Every option's live boolean value. */
+    values: OptionValues;
+    /** op_ptr->hitpoint_warn (0..9). */
+    hitpointWarn: number;
+    /** op_ptr->delay_factor. */
+    delayFactor: number;
+    /** player->opts.lazymove_delay (0..255). */
+    lazymoveDelay: number;
+    /** The immutable birth-option snapshot (birth_* only). */
+    birth: OptionValues;
+}
+/** Options that can be preset at construction / character creation. */
+export interface OptionInit {
+    /** Preset values (birth or interface). Applied over the table defaults. */
+    overrides?: Partial<Record<OptionName, boolean>>;
+    /** op_ptr->hitpoint_warn (0..9). Default 3. */
+    hitpointWarn?: number;
+    /** op_ptr->delay_factor. Default 40. */
+    delayFactor?: number;
+    /** player->opts.lazymove_delay (0..255). Default 0. */
+    lazymoveDelay?: number;
+}
+/**
+ * The option store: a name -> boolean map seeded from OPTION_ENTRIES.normal,
+ * with the hitpoint_warn / delay_factor scalars and the immutable birth
+ * snapshot. Mutable in play through set(), except birth options.
+ */
+export declare class OptionState {
+    private readonly values;
+    /** op_ptr->hitpoint_warn (0..9). */
+    hitpointWarn: number;
+    /** op_ptr->delay_factor. */
+    delayFactor: number;
+    /** player->opts.lazymove_delay (0..255). */
+    lazymoveDelay: number;
+    /** The birth_* values chosen at creation, frozen (immutable after birth). */
+    private readonly birth;
+    constructor(init?: OptionInit);
+    /** Set a value with the cheat->score coupling, ignoring the birth lock. */
+    private applyRaw;
+    /** OPT(player, name): the current value of a boolean option. */
+    get(name: OptionName | string): boolean;
+    /**
+     * option_set (option.c L153): set a boolean option, applying the cheat->score
+     * coupling. Birth options are locked after creation (return false, no
+     * change), mirroring the in-game read-only birth options. Returns whether
+     * the option exists and was writable.
+     */
+    set(name: OptionName | string, value: boolean): boolean;
+    /** Whether `name` is a birth option (type BIRTH). */
+    isBirth(name: string): boolean;
+    /** Whether `name` is a cheat option (type CHEAT). */
+    isCheat(name: string): boolean;
+    /** Whether `name` is a score option (type SCORE). */
+    isScore(name: string): boolean;
+    /**
+     * The immutable birth-option value chosen at character creation. Unlike
+     * get(), this never changes after construction.
+     */
+    birthValue(name: OptionName | string): boolean;
+    /**
+     * Whether any OP_SCORE option is set (enter_score's "cheating" gate, score.c
+     * L277). A cheat_* option forces its score_* twin, so a cheated game trips
+     * this even after the cheat option itself is turned back off.
+     */
+    anyScoreSet(): boolean;
+    /** The list of option names in table order. */
+    names(): readonly string[];
+    /** Serialize to plain JSON (the save format). */
+    snapshot(): OptionStateData;
+    /**
+     * Rebuild an OptionState from serialized data. Missing options fall back to
+     * their table default (back-compat with saves written before a new option
+     * was added). The birth snapshot is restored verbatim.
+     */
+    static restore(data: OptionStateData): OptionState;
+}
+//# sourceMappingURL=options.d.ts.map

package/dist/player/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/player/options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,2EAA2E;AAC3E,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,4EAA4E;AAC5E,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,yEAAyE;AACzE,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,yEAAyE;AACzE,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnD,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,MAAM,EAAE,YAAY,CAAC;IACrB,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,uEAAuE;AACvE,MAAM,WAAW,UAAU;IACzB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IACjD,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAwBD;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;gBAEzB,IAAI,GAAE,UAAe;IAoBjC,2EAA2E;IAC3E,OAAO,CAAC,QAAQ;IAUhB,gEAAgE;IAChE,GAAG,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO;IAIvC;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO;IAOvD,qDAAqD;IACrD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B,qDAAqD;IACrD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B,qDAAqD;IACrD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO;IAI9C;;;;OAIG;IACH,WAAW,IAAI,OAAO;IAOtB,+CAA+C;IAC/C,KAAK,IAAI,SAAS,MAAM,EAAE;IAI1B,iDAAiD;IACjD,QAAQ,IAAI,eAAe;IAU3B;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW;CAwBnD"}

package/dist/player/options.js

@@ -0,0 +1,199 @@
+/**
+ * The player option store, ported from reference/src/option.c (Angband 4.2.6).
+ *
+ * option.c owns the option table (list-options.h, codegen'd to
+ * generated/options.ts as OPTION_ENTRIES) plus a small amount of runtime
+ * behaviour: options_init_defaults (each option's `normal` value, the
+ * delay_factor = 40 and hitpoint_warn = 3 defaults) and the cheat/score
+ * coupling in option_set (turning a cheat_* option on forces its score_*
+ * twin, which suppresses scoring). This module is the pure data half of
+ * that; the option MENU (ui-options.c, the keypress screens) is DEFERRED as
+ * a platform-native menu concern (see parity/ledger/options.yaml).
+ *
+ * Faithful notes:
+ * - Defaults are read straight from OPTION_ENTRIES (do not hand-copy the
+ *   table): each option is seeded from its `normal` field.
+ * - hitpoint_warn is the 0..9 integer op_ptr->hitpoint_warn (DEFAULT 3), kept
+ *   alongside the booleans. delay_factor (default 40) and lazymove_delay
+ *   (player->opts.lazymove_delay, default 0, uint8) are carried too.
+ * - Birth options (type BIRTH) are chosen at character creation and then
+ *   locked: an immutable snapshot is captured at construction, and set()
+ *   refuses to change a birth option afterwards (upstream shows them
+ *   read-only in-game; only the birth process sets them).
+ * - The cheat/score linkage keys off the table order (each cheat_X is
+ *   immediately followed by score_X), reproduced by name (cheat_X -> score_X).
+ *
+ * Pure: no DOM, no filesystem. The session wires an OptionState onto the
+ * GameState and each deferred seam reads it through state.options.
+ */
+import { OPTION_ENTRIES } from "../generated/options.js";
+/** option.c options_init_defaults: op_ptr->hitpoint_warn default (0..9). */
+export const DEFAULT_HITPOINT_WARN = 3;
+/** option.c options_init_defaults: op_ptr->delay_factor default (ms). */
+export const DEFAULT_DELAY_FACTOR = 40;
+/**
+ * player->opts.lazymove_delay default. options_init_defaults does NOT set it,
+ * so it keeps the struct-zero value (0 = no lazy-move disturbance pause).
+ * ui-options.c do_cmd_lazymove_delay clamps it to a uint8 (MIN(delay, 255)).
+ */
+export const DEFAULT_LAZYMOVE_DELAY = 0;
+/** The set of option names, and the birth subset, derived once from the table. */
+const ALL_NAMES = OPTION_ENTRIES.map((e) => e.name);
+const BIRTH_NAMES = new Set(OPTION_ENTRIES.filter((e) => e.type === "BIRTH").map((e) => e.name));
+const CHEAT_NAMES = new Set(OPTION_ENTRIES.filter((e) => e.type === "CHEAT").map((e) => e.name));
+const SCORE_NAMES = new Set(OPTION_ENTRIES.filter((e) => e.type === "SCORE").map((e) => e.name));
+/** clamp hitpoint_warn into the legal 0..9 band. */
+function clampWarn(v) {
+    if (!Number.isFinite(v))
+        return DEFAULT_HITPOINT_WARN;
+    return Math.max(0, Math.min(9, Math.trunc(v)));
+}
+/** clamp a uint8 option (lazymove_delay) into 0..255, MIN(delay, 255)-style. */
+function clampByte(v) {
+    if (!Number.isFinite(v))
+        return 0;
+    return Math.max(0, Math.min(255, Math.trunc(v)));
+}
+/**
+ * The option store: a name -> boolean map seeded from OPTION_ENTRIES.normal,
+ * with the hitpoint_warn / delay_factor scalars and the immutable birth
+ * snapshot. Mutable in play through set(), except birth options.
+ */
+export class OptionState {
+    values = {};
+    /** op_ptr->hitpoint_warn (0..9). */
+    hitpointWarn;
+    /** op_ptr->delay_factor. */
+    delayFactor;
+    /** player->opts.lazymove_delay (0..255). */
+    lazymoveDelay;
+    /** The birth_* values chosen at creation, frozen (immutable after birth). */
+    birth;
+    constructor(init = {}) {
+        /* options_init_defaults: seed every option from its table `normal`. */
+        for (const entry of OPTION_ENTRIES) {
+            this.values[entry.name] = entry.normal;
+        }
+        /* Apply the birth/interface presets chosen at creation. Cheat presets
+         * still couple to their score twins (as option_set would). */
+        for (const [name, value] of Object.entries(init.overrides ?? {})) {
+            if (value === undefined)
+                continue;
+            this.applyRaw(name, value);
+        }
+        this.hitpointWarn = clampWarn(init.hitpointWarn ?? DEFAULT_HITPOINT_WARN);
+        this.delayFactor = init.delayFactor ?? DEFAULT_DELAY_FACTOR;
+        this.lazymoveDelay = clampByte(init.lazymoveDelay ?? DEFAULT_LAZYMOVE_DELAY);
+        /* Freeze the birth-option snapshot: the birth_* values are locked now. */
+        const birth = {};
+        for (const name of BIRTH_NAMES)
+            birth[name] = this.values[name] ?? false;
+        this.birth = Object.freeze(birth);
+    }
+    /** Set a value with the cheat->score coupling, ignoring the birth lock. */
+    applyRaw(name, value) {
+        if (!(name in this.values))
+            return;
+        this.values[name] = value;
+        /* option_set: turning a cheat_* option on forces its score_* twin on. */
+        if (value && CHEAT_NAMES.has(name)) {
+            const twin = "score" + name.slice("cheat".length); // cheat_X -> score_X
+            if (twin in this.values)
+                this.values[twin] = true;
+        }
+    }
+    /** OPT(player, name): the current value of a boolean option. */
+    get(name) {
+        return this.values[name] ?? false;
+    }
+    /**
+     * option_set (option.c L153): set a boolean option, applying the cheat->score
+     * coupling. Birth options are locked after creation (return false, no
+     * change), mirroring the in-game read-only birth options. Returns whether
+     * the option exists and was writable.
+     */
+    set(name, value) {
+        if (!(name in this.values))
+            return false;
+        if (BIRTH_NAMES.has(name))
+            return false; // locked after birth
+        this.applyRaw(name, value);
+        return true;
+    }
+    /** Whether `name` is a birth option (type BIRTH). */
+    isBirth(name) {
+        return BIRTH_NAMES.has(name);
+    }
+    /** Whether `name` is a cheat option (type CHEAT). */
+    isCheat(name) {
+        return CHEAT_NAMES.has(name);
+    }
+    /** Whether `name` is a score option (type SCORE). */
+    isScore(name) {
+        return SCORE_NAMES.has(name);
+    }
+    /**
+     * The immutable birth-option value chosen at character creation. Unlike
+     * get(), this never changes after construction.
+     */
+    birthValue(name) {
+        return this.birth[name] ?? false;
+    }
+    /**
+     * Whether any OP_SCORE option is set (enter_score's "cheating" gate, score.c
+     * L277). A cheat_* option forces its score_* twin, so a cheated game trips
+     * this even after the cheat option itself is turned back off.
+     */
+    anyScoreSet() {
+        for (const name of SCORE_NAMES) {
+            if (this.values[name])
+                return true;
+        }
+        return false;
+    }
+    /** The list of option names in table order. */
+    names() {
+        return ALL_NAMES;
+    }
+    /** Serialize to plain JSON (the save format). */
+    snapshot() {
+        return {
+            values: { ...this.values },
+            hitpointWarn: this.hitpointWarn,
+            delayFactor: this.delayFactor,
+            lazymoveDelay: this.lazymoveDelay,
+            birth: { ...this.birth },
+        };
+    }
+    /**
+     * Rebuild an OptionState from serialized data. Missing options fall back to
+     * their table default (back-compat with saves written before a new option
+     * was added). The birth snapshot is restored verbatim.
+     */
+    static restore(data) {
+        const state = new OptionState();
+        for (const name of ALL_NAMES) {
+            if (name in data.values)
+                state.values[name] = data.values[name];
+        }
+        state.hitpointWarn = clampWarn(data.hitpointWarn ?? DEFAULT_HITPOINT_WARN);
+        state.delayFactor = data.delayFactor ?? DEFAULT_DELAY_FACTOR;
+        state.lazymoveDelay = clampByte(data.lazymoveDelay ?? DEFAULT_LAZYMOVE_DELAY);
+        /* Restore the frozen birth snapshot (default table values if absent). */
+        const birth = data.birth ?? {};
+        const restored = {};
+        for (const name of BIRTH_NAMES) {
+            restored[name] =
+                name in birth ? birth[name] : (state.values[name] ?? false);
+        }
+        // Replace the frozen snapshot via defineProperty (birth is readonly).
+        Object.defineProperty(state, "birth", {
+            value: Object.freeze(restored),
+            writable: false,
+            configurable: false,
+            enumerable: false,
+        });
+        return state;
+    }
+}
+//# sourceMappingURL=options.js.map

package/dist/player/options.js.map

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