@rpgm-tools/neo-angband-core 0.10.0

package/dist/mod/vocabulary.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Mod vocabulary extension (W2.3): the seam by which a pack introduces
+ * genuinely NEW vocabulary terms at runtime - new flags, new stats/attributes,
+ * new tags of any mod-defined kind - and stores per-entity VALUES for them.
+ *
+ * WHY THIS SHAPE, NOT CORE-ARITY EXTENSION (the W2.3 architecture decision):
+ * the faithful engine stores flags in fixed-capacity bitsets (bitflag.ts, sized
+ * from RF_MAX/OF_MAX at bind time) and stats in fixed-arity arrays (STAT_MAX = 5,
+ * with the OBJ_MOD enum offset and str/int/wis/dex/con field names baked across
+ * calcs, char-sheet, randart and birth). Growing that arity to admit a mod flag
+ * or a sixth stat would (a) fight the byte-identical faithfulness guarantee the
+ * port is built on and (b) be bounded by whatever headroom was reserved. So mod
+ * vocabulary lives in a PARALLEL, mod-owned store instead: unbounded, and
+ * byte-identical to core whenever no mod declares anything. The trade is honest:
+ * unmodified core code paths do not read a mod term - but core cannot know what
+ * a brand-new stat MEANS without mod logic anyway, so the mod supplies both the
+ * term AND its behaviour, consuming its own values through the W2.2 registry
+ * hooks (monster AI, effects, commands) it already controls.
+ *
+ * Persistence: a VocabularyRegistry serialises to plain JSON (toJSON/fromJSON)
+ * so a host folds it into that mod's opaque save bag (mod/save-blocks.ts,
+ * ModBag) - the engine never interprets it, exactly as the bag contract requires.
+ *
+ * Layering: core owns the registry type so the capability-gated facade
+ * (mod/registry-host.ts) can expose it; the host creates one, hands it to the
+ * trusted plugin, and persists it. Nothing here touches GameState or the
+ * faithful data model.
+ */
+import type { JsonValue } from "./save-blocks.js";
+/**
+ * The category of a vocabulary term. "flag" and "stat" are the two families the
+ * W2.3 brief names; the kind is a free string so a mod may coin its own
+ * families (e.g. "attribute", "resource", "faction") without a core change.
+ */
+export type VocabKind = string;
+/** One declared vocabulary term: a namespaced name within a kind, plus metadata. */
+export interface VocabTerm {
+    /** The family this term belongs to ("flag", "stat", or any mod-coined kind). */
+    kind: VocabKind;
+    /** The term itself, namespaced like every mod id (e.g. "demo:luck"). */
+    term: string;
+    /** A human label for UIs (char sheet, mod manager); defaults to the term. */
+    label?: string;
+    /** Opaque per-term metadata (e.g. default value, min/max, display group). */
+    meta?: {
+        [key: string]: JsonValue;
+    };
+}
+/** The serialised form of a VocabularyRegistry (folds into a mod's save bag). */
+export interface VocabularySnapshot {
+    /** Every declared term, in declaration order. */
+    terms: VocabTerm[];
+    /** entity ref -> (term -> value); only entities with values appear. */
+    values: {
+        [entity: string]: {
+            [term: string]: JsonValue;
+        };
+    };
+}
+/**
+ * A mod's declared vocabulary plus the per-entity values for those terms. One
+ * instance per mod (so terms are namespaced by the owning pack and persistence
+ * is one bag). Entity refs are opaque strings the mod chooses - conventionally
+ * "player", `mon:${midx}`, `obj:${handle}` - and are never interpreted here.
+ */
+export declare class VocabularyRegistry {
+    /** kind\0term -> VocabTerm, insertion-ordered. */
+    private readonly terms;
+    /** entity -> (term -> value). */
+    private readonly values;
+    /**
+     * Declare a new term. Throws on a duplicate (same kind + term) so a mod
+     * cannot silently redeclare, and callers see conflicts. Returns nothing; the
+     * term is now usable with setValue.
+     */
+    define(term: VocabTerm): void;
+    /** Whether a term is declared in a given kind. */
+    has(kind: VocabKind, term: string): boolean;
+    /** Look up a declared term's record, or undefined. */
+    get(kind: VocabKind, term: string): VocabTerm | undefined;
+    /** All declared terms, optionally filtered to one kind, in declaration order. */
+    list(kind?: VocabKind): VocabTerm[];
+    /** True when `term` is declared in ANY kind (the setValue precondition). */
+    private isDeclared;
+    /**
+     * Set an entity's value for a term. Throws if the term was never declared -
+     * vocabulary must be declared before it is used, which is what makes the
+     * store a vocabulary and not an arbitrary property bag.
+     */
+    setValue(entity: string, term: string, value: JsonValue): void;
+    /** Get an entity's value for a term, or undefined when unset. */
+    getValue(entity: string, term: string): JsonValue | undefined;
+    /** A plain snapshot of one entity's term values (empty object when none). */
+    valuesOf(entity: string): {
+        [term: string]: JsonValue;
+    };
+    /** Drop all values for an entity (e.g. a monster that died / an item consumed). */
+    clearEntity(entity: string): void;
+    /** Serialise to plain JSON for a mod save bag. Declaration order is preserved. */
+    toJSON(): VocabularySnapshot;
+    /** Rebuild from a snapshot (a mod restoring its bag on load). */
+    static fromJSON(snapshot: VocabularySnapshot): VocabularyRegistry;
+}
+//# sourceMappingURL=vocabulary.d.ts.map

package/dist/mod/vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary.d.ts","sourceRoot":"","sources":["../../src/mod/vocabulary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B,oFAAoF;AACpF,MAAM,WAAW,SAAS;IACxB,gFAAgF;IAChF,IAAI,EAAE,SAAS,CAAC;IAChB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,IAAI,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;CACrC;AAED,iFAAiF;AACjF,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,uEAAuE;IACvE,MAAM,EAAE;QAAE,CAAC,MAAM,EAAE,MAAM,GAAG;YAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;SAAE,CAAA;KAAE,CAAC;CAC7D;AAOD;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,kDAAkD;IAClD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,iCAAiC;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6C;IAEpE;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAU7B,kDAAkD;IAClD,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAI3C,sDAAsD;IACtD,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIzD,iFAAiF;IACjF,IAAI,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,EAAE;IAQnC,4EAA4E;IAC5E,OAAO,CAAC,UAAU;IAKlB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAc9D,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI7D,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG;QAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE;IAOvD,mFAAmF;IACnF,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIjC,kFAAkF;IAClF,MAAM,IAAI,kBAAkB;IAU5B,iEAAiE;IACjE,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,GAAG,kBAAkB;CAUlE"}

package/dist/mod/vocabulary.js.map

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

package/dist/mon/bind.d.ts

@@ -0,0 +1,266 @@
+/**
+ * Monster registries, ported from the gamedata binding semantics in
+ * reference/src/mon-init.c (Angband 4.2.6).
+ *
+ * bindMonsters() takes parsed pack JSON records (no fs here) and produces
+ * a MonsterRegistry. Binding follows the upstream parser actions exactly;
+ * the important subtleties are noted inline:
+ *
+ * - Base inheritance (parse_monster_base): the race first copies the
+ *   base's display glyph and ORs in the base's flags; the race's own
+ *   flags: lines then OR on top and flags-off: lines remove flags (which
+ *   may remove inherited base flags, e.g. green glutton ghost drops the
+ *   ghost base's IM_COLD).
+ * - depth: sets spell_power = level as a default; a later spell-power:
+ *   line overrides it (parse_monster_depth / parse_monster_spell_power).
+ * - innate-freq / spell-freq percentages are stored as 100 / pct with C
+ *   integer division (parse_monster_innate_freq / parse_monster_spell_freq).
+ * - spells: after ORing the RSF flags, parse_monster_spells defaults
+ *   freq_innate to 4 when the race has innate spells but no innate-freq,
+ *   and freq_spell to 4 when it has non-(breath|innate) spells but no
+ *   spell-freq. Breaths count as innate for frequency purposes.
+ * - Monster spells (parse_mon_spell_*): each spell starts with one level
+ *   record at power 0; every power-cutoff: line appends a level, and lore
+ *   and message lines always apply to the last level.
+ * - finish_parse_monster resolves friends names to races afterwards
+ *   ("same", case-insensitive, binds the race to itself) and shape names
+ *   to a base if one matches, else a race.
+ * - max_num is not gamedata: player-birth.c resets it to 100, or 1 for
+ *   uniques. Binding applies that rule so allocation can use it.
+ *
+ * Moddability: registries accept any record arrays of the same shapes;
+ * mods extend the game by concatenating their records onto the pack's
+ * before binding.
+ */
+import { MFLAG_SIZE, RF_SIZE, RSF_SIZE } from "./types.js";
+import type { BlowEffect, BlowMethod, MonsterBase, MonsterRace, MonsterSpell, Pain, PitProfile, SummonType } from "./types.js";
+export { MFLAG_SIZE, RF_SIZE, RSF_SIZE };
+/** pain.json record. */
+export interface PainRecordJson {
+    type: number;
+    message: string[];
+}
+/** blow_methods.json record. */
+export interface BlowMethodRecordJson {
+    name: string;
+    cut?: number;
+    stun?: number;
+    miss?: number;
+    phys?: number;
+    msg?: string;
+    act?: string[];
+    desc?: string[];
+}
+/** blow_effects.json record. */
+export interface BlowEffectRecordJson {
+    name: string;
+    power?: number;
+    eval?: number;
+    desc?: string[];
+    "lore-color-base"?: string;
+    "lore-color-resist"?: string;
+    "lore-color-immune"?: string;
+    "effect-type"?: string;
+    resist?: string;
+    "lash-type"?: string;
+}
+/** monster_spell.json effect line. */
+export interface SpellEffectJson {
+    eff: string;
+    type?: string;
+    radius?: number;
+    other?: number;
+    dice?: string;
+    expr?: Array<{
+        name: string;
+        base: string;
+        expr: string;
+    }>;
+}
+/** monster_spell.json power-cutoff entry (same lore/message fields). */
+export interface SpellCutoffJson {
+    power: number;
+    lore?: string[];
+    "lore-color-base"?: string;
+    "lore-color-resist"?: string;
+    "lore-color-immune"?: string;
+    "message-vis"?: string[];
+    "message-invis"?: string[];
+    "message-miss"?: string[];
+    "message-save"?: string[];
+}
+/** monster_spell.json record. */
+export interface MonsterSpellRecordJson {
+    name: string;
+    msgt?: string;
+    hit?: number;
+    effect?: SpellEffectJson[];
+    lore?: string[];
+    "lore-color-base"?: string;
+    "lore-color-resist"?: string;
+    "lore-color-immune"?: string;
+    "message-vis"?: string[];
+    "message-invis"?: string[];
+    "message-miss"?: string[];
+    "message-save"?: string[];
+    "power-cutoff"?: SpellCutoffJson[];
+}
+/** monster_base.json record. */
+export interface MonsterBaseRecordJson {
+    name: string;
+    glyph: string;
+    pain: number;
+    flags?: string[];
+    desc?: string[];
+}
+/** monster.json blow line. */
+export interface MonsterBlowJson {
+    method: string;
+    effect?: string;
+    damage?: string;
+}
+/** monster.json drop / drop-base lines. */
+export interface MonsterDropJson {
+    tval: string;
+    sval?: string;
+    chance: number;
+    min: number;
+    max: number;
+}
+/** monster.json friends / friends-base lines. */
+export interface MonsterFriendsJson {
+    chance: number;
+    number: string;
+    name: string;
+    role?: string;
+}
+/** monster.json message-vis / message-invis / message-miss lines. */
+export interface MonsterAltMsgJson {
+    spell: string;
+    message?: string;
+}
+/** monster.json record. */
+export interface MonsterRecordJson {
+    name: string;
+    plural?: string;
+    base: string;
+    glyph?: string;
+    color: string;
+    speed?: number;
+    "hit-points"?: number;
+    light?: number;
+    hearing?: number;
+    smell?: number;
+    "armor-class"?: number;
+    sleepiness?: number;
+    depth?: number;
+    rarity?: number;
+    experience?: number;
+    blow?: MonsterBlowJson[];
+    flags?: string[];
+    "flags-off"?: string[];
+    desc?: string[];
+    "innate-freq"?: number;
+    "spell-freq"?: number;
+    "spell-power"?: number;
+    spells?: string[];
+    "message-vis"?: MonsterAltMsgJson[];
+    "message-invis"?: MonsterAltMsgJson[];
+    "message-miss"?: MonsterAltMsgJson[];
+    drop?: MonsterDropJson[];
+    "drop-base"?: MonsterDropJson[];
+    /** Compiler-preserved encounter order for the single C drops list. */
+    "drop-order"?: string[];
+    friends?: MonsterFriendsJson[];
+    "friends-base"?: MonsterFriendsJson[];
+    mimic?: Array<{
+        tval: string;
+        sval: string;
+    }>;
+    shape?: string[];
+    "color-cycle"?: {
+        group: string;
+        cycle: string;
+    };
+}
+/** summon.json record. */
+export interface SummonRecordJson {
+    name: string;
+    msgt?: string;
+    uniques?: number;
+    base?: string[];
+    "race-flag"?: string;
+    fallback?: string;
+    desc?: string;
+}
+/** pit.json record. */
+export interface PitRecordJson {
+    name: string;
+    room?: number;
+    alloc?: {
+        rarity: number;
+        level: number;
+    };
+    "obj-rarity"?: number;
+    "mon-base"?: string[];
+    color?: string[];
+    "flags-req"?: string[];
+    "flags-ban"?: string[];
+    "spell-req"?: string[];
+    "spell-ban"?: string[];
+    "mon-ban"?: string[];
+    "innate-freq"?: number;
+}
+/** All pack inputs bindMonsters needs; each is the file's records array. */
+export interface MonsterPackRecords {
+    pain: PainRecordJson[];
+    blowMethods: BlowMethodRecordJson[];
+    blowEffects: BlowEffectRecordJson[];
+    monsterSpells: MonsterSpellRecordJson[];
+    monsterBases: MonsterBaseRecordJson[];
+    monsters: MonsterRecordJson[];
+    summons: SummonRecordJson[];
+    pits: PitRecordJson[];
+}
+export interface BindMonstersOptions {
+    /** z_info->max_sight; hearing/smell scale by maxSight / 20. */
+    maxSight?: number;
+}
+/** Registry of everything the monster domain binds from the pack. */
+export declare class MonsterRegistry {
+    readonly pains: Map<number, Pain>;
+    readonly blowMethods: Map<string, BlowMethod>;
+    readonly blowEffects: Map<string, BlowEffect>;
+    /** RSF index -> spell. */
+    readonly spells: Map<number, MonsterSpell>;
+    /**
+     * lookup_monster_base (mon-util.c:146): upstream walks the rb_info list
+     * comparing streq(name, base->name); this is that lookup as a map, so
+     * `bases.get(name)` IS lookup_monster_base and `bases.get(n) === race.base`
+     * is match_monster_bases's single-name test (mon-util.c:166 - variadic
+     * upstream, and unused outside its unit test; the slay/brand base check is
+     * react_to_specific_slay's streq on base->name, obj-slays.c:274).
+     */
+    readonly bases: Map<string, MonsterBase>;
+    /** Record order mirrors monster.txt; ridx is the array index. */
+    readonly races: MonsterRace[];
+    readonly summons: SummonType[];
+    readonly pits: PitProfile[];
+    private readonly racesByName;
+    constructor(pack: MonsterPackRecords, options?: BindMonstersOptions);
+    /**
+     * lookup_monster (mon-util.c): exact case-insensitive match first,
+     * else the first race (lowest ridx) whose name contains the query as
+     * a case-insensitive substring. The shipped monster.txt relies on the
+     * substring fallback ("friends:100:4d4:spider" on ancient spider).
+     *
+     * The substring test is my_stristr (z-util.c:441), now a real counterpart in
+     * guard.ts rather than a second inline copy -- the third place that needed it
+     * (lookupTrap) had got it wrong.
+     */
+    raceByName(name: string): MonsterRace | null;
+    private bindRace;
+}
+/** Bind all monster-domain pack records into a registry. */
+export declare function bindMonsters(pack: MonsterPackRecords, options?: BindMonstersOptions): MonsterRegistry;
+//# sourceMappingURL=bind.d.ts.map

package/dist/mon/bind.d.ts.map

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