@rpgm-tools/neo-angband-core 0.10.0

package/dist/mon/timed.js

@@ -0,0 +1,219 @@
+/**
+ * Monster timed effects, ported from reference/src/mon-timed.c (Angband
+ * 4.2.6): the resist roll, mon_set_timed, and the inc/dec/clear wrappers that
+ * drive a monster's m_timed[] array (sleep, stun, confusion, fear, slow,
+ * haste, hold, disenchant, command, shapechange).
+ *
+ * The effect table (gets_save / stacking / resist flag / max timer / begin-
+ * end-increase messages) is the generated MON_TIMED_ENTRIES (from
+ * list-mon-timed.h). Two upstream couplings are handled as follows, both
+ * faithful in reachable states:
+ * - Messages: the monster-message queue (mon-msg.c add_monster_message) is not
+ *   ported, so mon_set_timed emits through an optional MonTimedMessageSink
+ *   instead. The decision of WHICH message fires (and its NOTIFY/NOMESSAGE/
+ *   visibility gate) is preserved exactly; callers that have a sink pass one.
+ * - MON_TMD_CHANGED shapechange (monster_change_shape / _revert_shape,
+ *   mon-util.c) is DEFERRED: the timer is still set, but the form is not
+ *   swapped. CHANGED is only set by an effect that is not ported yet, so this
+ *   path is currently unreachable.
+ *
+ * The lore learn on a flag-resist (lore_learn_flag_if_visible) and the
+ * health-bar / monster-list redraw (upkeep masks) are UI/lore concerns and are
+ * DEFERRED.
+ */
+import { MON_TIMED_ENTRIES, RF } from "../generated/index.js";
+import { MON_TMD } from "../generated/index.js";
+import { monsterIsObvious, monsterIsUnique } from "./predicate.js";
+import { getLore, loreLearnFlagIfVisible } from "./lore.js";
+/** mon-timed.h flags. */
+export const MON_TMD_FLG_NOTIFY = 0x01;
+export const MON_TMD_FLG_NOMESSAGE = 0x04;
+export const MON_TMD_FLG_NOFAIL = 0x08;
+/** Minimum number of turns a new timed effect can last (MON_INC_MIN_TURNS). */
+const MON_INC_MIN_TURNS = 2;
+/** Resolve an effect entry's resistFlag ("RF_NO_SLEEP" | 0) to an RF index. */
+function resistFlagIndex(resistFlag) {
+    if (typeof resistFlag !== "string")
+        return -1;
+    const key = resistFlag.replace(/^RF_/, "");
+    const idx = RF[key];
+    return typeof idx === "number" ? idx : -1;
+}
+/**
+ * mon_timed_name_to_idx: the MON_TMD_ index for an effect name, or -1.
+ */
+export function monTimedNameToIdx(name) {
+    for (let i = 0; i < MON_TMD.MAX; i++) {
+        if (MON_TIMED_ENTRIES[i]?.name === name)
+            return i;
+    }
+    return -1;
+}
+/** saving_throw: level- and timer-scaled resist, doubled for uniques. */
+function savingThrow(rng, mon, timer) {
+    const resistChance = Math.min(90, mon.race.level + Math.max(0, 25 - Math.trunc(timer / 2)));
+    /* Give unique monsters a double check. */
+    if (monsterIsUnique(mon) && rng.randint0(100) < resistChance)
+        return true;
+    return rng.randint0(100) < resistChance;
+}
+/**
+ * The lore store the resist branch learns into (lore_learn_flag_if_visible,
+ * mon-timed.c L108). does_resist has no deps parameter upstream (get_lore is a
+ * global), so the port registers the session's store against its Rng - the one
+ * shared object every timed call threads - via installMonTimedLore. Worldless
+ * harnesses that never install one simply skip the lore learn (the pre-port
+ * behaviour); the resist outcome is identical either way.
+ */
+const TIMED_LORE_STORES = new WeakMap();
+/** Register the lore store learning timed-resist flags for this rng/session. */
+export function installMonTimedLore(rng, lore) {
+    TIMED_LORE_STORES.set(rng, lore);
+}
+/**
+ * does_resist (mon-timed.c L89): NOFAIL override, then flag immunity (learning
+ * the resist flag into visible lore, mon-timed.c L107-110), then the save.
+ */
+function doesResist(rng, mon, effectType, timer, flag) {
+    const effect = MON_TIMED_ENTRIES[effectType];
+    /* The game can override the monster's innate resistance. */
+    if (flag & MON_TMD_FLG_NOFAIL)
+        return false;
+    /* Check resistances from monster flags: a visible monster shrugging the
+     * effect off via its race flag teaches that flag. */
+    const rflag = resistFlagIndex(effect.resistFlag);
+    if (rflag >= 0 && mon.race.flags.has(rflag)) {
+        const store = TIMED_LORE_STORES.get(rng);
+        if (store)
+            loreLearnFlagIfVisible(getLore(store, mon.race), mon, rflag);
+        return true;
+    }
+    /* Some effects get a saving throw; others do not. */
+    return effect.save ? savingThrow(rng, mon, timer) : false;
+}
+/**
+ * mon_set_timed: set effect `effectType`'s timer to `timer`, honouring
+ * resistance, the begin/end/increase message selection, and the COMMAND-expiry
+ * and CHANGED special cases. Returns true if the monster was affected.
+ */
+export function monSetTimed(rng, mon, effectType, timer, flag = 0, onMessage, shape) {
+    const effect = MON_TIMED_ENTRIES[effectType];
+    const oldTimer = mon.mTimed[effectType];
+    let resisted = false;
+    let update = false;
+    let checkResist;
+    let note = 0;
+    /* Limit the time of the effect. */
+    if (timer > effect.time)
+        timer = effect.time;
+    /* No change. */
+    if (oldTimer === timer) {
+        return false;
+    }
+    else if (timer === 0) {
+        /* Turning off, usually mention. */
+        note = effect.messageEnd;
+        flag |= MON_TMD_FLG_NOTIFY;
+        checkResist = false;
+        /* Necromancer COMMAND expiring: drop the stale monster -> monster target. */
+        if (effectType === MON_TMD.COMMAND)
+            mon.target.midx = 0;
+    }
+    else if (oldTimer === 0) {
+        /* Turning on, usually mention. */
+        note = effect.messageBegin;
+        flag |= MON_TMD_FLG_NOTIFY;
+        checkResist = true;
+    }
+    else if (timer > oldTimer) {
+        /* Increase: a different message, but do not auto-mention. */
+        note = effect.messageIncrease;
+        checkResist = true;
+    }
+    else {
+        /* Decreases get no message and never resist. */
+        checkResist = false;
+    }
+    /* Resolve resistance, when appropriate. */
+    if (checkResist && doesResist(rng, mon, effectType, timer, flag)) {
+        resisted = true;
+        note = "MON_MSG_UNAFFECTED";
+    }
+    else {
+        mon.mTimed[effectType] = timer;
+        update = true;
+    }
+    /* Special case - deal with monster shapechanges (mon-timed.c L195).
+     * The swap functions live in game/mon-shape.ts; the game-layer timed
+     * calls pass them as hooks (the layering keeps this module below
+     * game/). Without hooks, the timer stands and the form is unchanged. */
+    if (effectType === MON_TMD.CHANGED && shape) {
+        if (timer > oldTimer) {
+            if (!shape.change(mon)) {
+                note = "MON_MSG_SHAPE_FAIL";
+                mon.mTimed[effectType] = oldTimer;
+            }
+        }
+        else if (timer === 0) {
+            shape.revert(mon);
+        }
+    }
+    /* Queue a message if there is one, it is allowed, and the monster is seen. */
+    if (note &&
+        !(flag & MON_TMD_FLG_NOMESSAGE) &&
+        flag & MON_TMD_FLG_NOTIFY &&
+        monsterIsObvious(mon)) {
+        onMessage?.(mon, String(note), true);
+    }
+    /* update -> health-bar / monster-list redraw is UI upkeep (DEFERRED). */
+    void update;
+    return !resisted;
+}
+/**
+ * mon_inc_timed: raise effect `effectType` by `timer` (min 2 turns for a new
+ * effect), stacking per the effect's rule, then mon_set_timed.
+ */
+export function monIncTimed(rng, mon, effectType, timer, flag = 0, onMessage, shape) {
+    const effect = MON_TIMED_ENTRIES[effectType];
+    /* Make a new effect last a minimum number of turns. */
+    if (mon.mTimed[effectType] === 0 && timer < MON_INC_MIN_TURNS) {
+        timer = MON_INC_MIN_TURNS;
+    }
+    let newValue = timer;
+    switch (effect.stack) {
+        case "NO":
+            newValue = mon.mTimed[effectType] === 0 ? timer : mon.mTimed[effectType];
+            break;
+        case "MAX":
+            newValue = Math.max(mon.mTimed[effectType], timer);
+            break;
+        case "INCR":
+            newValue = mon.mTimed[effectType] + timer;
+            break;
+    }
+    return monSetTimed(rng, mon, effectType, newValue, flag, onMessage, shape);
+}
+/**
+ * mon_dec_timed: lower effect `effectType` by `timer` (never below 0). A
+ * decrease never fails.
+ */
+export function monDecTimed(rng, mon, effectType, timer, flag = 0, onMessage, shape) {
+    const newLevel = Math.max(0, mon.mTimed[effectType] - timer);
+    return monSetTimed(rng, mon, effectType, newLevel, flag, onMessage, shape);
+}
+/** mon_clear_timed: clear effect `effectType` (no-op if already 0). */
+export function monClearTimed(rng, mon, effectType, flag = 0, onMessage, shape) {
+    if (mon.mTimed[effectType] === 0)
+        return false;
+    return monSetTimed(rng, mon, effectType, 0, flag, onMessage, shape);
+}
+/**
+ * monster_effect_level: the 0 (unaffected) .. 5 (max) intensity band an effect
+ * is currently at for the monster.
+ */
+export function monsterEffectLevel(mon, effectType) {
+    const effect = MON_TIMED_ENTRIES[effectType];
+    const divisor = Math.max(Math.trunc(effect.time / 5), 1);
+    return Math.min(Math.trunc((mon.mTimed[effectType] + divisor - 1) / divisor), 5);
+}
+//# sourceMappingURL=timed.js.map

package/dist/mon/timed.js.map

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

package/dist/mon/types.d.ts

@@ -0,0 +1,252 @@
+/**
+ * Monster domain types, ported from reference/src/monster.h and
+ * reference/src/mon-blows.h (Angband 4.2.6).
+ *
+ * These are the bound, typed shapes produced by bind.ts from the compiled
+ * pack JSON (monster.json, monster_base.json, monster_spell.json,
+ * blow_methods.json, blow_effects.json, pain.json, summon.json, pit.json).
+ * World coupling stays out of this module: races reference each other and
+ * their bases directly, but objects (mimic kinds, drops) are kept as tval
+ * and sval names, to be resolved by the object domain later.
+ */
+import type { FlagSet } from "../bitflag.js";
+import type { Dice } from "../dice.js";
+/** Byte size of a race FlagSet (upstream RF_SIZE = FLAG_SIZE(RF_MAX)). */
+export declare const RF_SIZE: number;
+/** Byte size of a spell FlagSet (upstream RSF_SIZE = FLAG_SIZE(RSF_MAX)). */
+export declare const RSF_SIZE: number;
+/** Byte size of a temp-flag FlagSet (upstream MFLAG_SIZE). */
+export declare const MFLAG_SIZE: number;
+/**
+ * struct monster_pain: one pain-message family; pain.txt `type` values are
+ * the pain_idx keys monster_base pain: refers to.
+ */
+export interface Pain {
+    painIdx: number;
+    /** Up to seven messages, ordered from least to most hurt. */
+    messages: string[];
+}
+/** struct blow_method (mon-blows.h), bound from blow_methods.json. */
+export interface BlowMethod {
+    name: string;
+    cut: boolean;
+    stun: boolean;
+    miss: boolean;
+    phys: boolean;
+    /** MSG_ type name (upstream stores the resolved msgt int). */
+    msgt: string;
+    /** Action messages ({target} substitution done by combat code later). */
+    messages: string[];
+    desc: string;
+}
+/** struct blow_effect (mon-blows.h), bound from blow_effects.json. */
+export interface BlowEffect {
+    name: string;
+    power: number;
+    eval: number;
+    desc: string;
+    /** Lore colors kept as color names (upstream resolves to attrs). */
+    loreColorBase: string;
+    loreColorResist: string;
+    loreColorImmune: string;
+    effectType: string;
+    /** Element name for resist checks (upstream resolves to an index). */
+    resist: string | null;
+    /** Projection type name used by LASH. */
+    lashType: string | null;
+}
+/** struct monster_blow: one melee blow of a race. */
+export interface MonsterBlow {
+    method: BlowMethod;
+    effect: BlowEffect;
+    /** Damage dice, or null when the blow has no damage (upstream zero rand). */
+    dice: Dice | null;
+    /** The raw damage string from monster.txt, e.g. "20d10", or null. */
+    diceRaw: string | null;
+}
+/** One effect line of a monster spell (kept close to the pack record). */
+export interface MonsterSpellEffect {
+    eff: string;
+    type: string | null;
+    radius: number;
+    other: number;
+    /** Parsed dice (expressions bound where present), or null. */
+    dice: Dice | null;
+    diceRaw: string | null;
+    /** expr bindings as written: name, base value name, operations string. */
+    exprs: Array<{
+        name: string;
+        base: string;
+        expr: string;
+    }>;
+}
+/**
+ * struct monster_spell_level: power-cutoff dependent lore and messages.
+ * The first level always has power 0; power-cutoff directives append more.
+ */
+export interface MonsterSpellLevel {
+    power: number;
+    loreDesc: string;
+    loreColorBase: string;
+    loreColorResist: string;
+    loreColorImmune: string;
+    message: string;
+    blindMessage: string;
+    missMessage: string;
+    saveMessage: string;
+}
+/** struct monster_spell: one RSF_ spell bound from monster_spell.json. */
+export interface MonsterSpell {
+    /** RSF_ index. */
+    index: number;
+    name: string;
+    /** MSG_ type name for message coloring. */
+    msgt: string;
+    /** To-hit level of the attack. */
+    hit: number;
+    effects: MonsterSpellEffect[];
+    levels: MonsterSpellLevel[];
+}
+/** struct monster_base: race template bound from monster_base.json. */
+export interface MonsterBase {
+    name: string;
+    /** In-game name (desc line). */
+    text: string;
+    flags: FlagSet;
+    /** Default display glyph. */
+    glyph: string;
+    pain: Pain;
+}
+/** enum monster_group_role. */
+export declare const MON_GROUP: {
+    readonly LEADER: 0;
+    readonly SERVANT: 1;
+    readonly BODYGUARD: 2;
+    readonly MEMBER: 3;
+    readonly SUMMON: 4;
+};
+export type MonsterGroupRole = (typeof MON_GROUP)[keyof typeof MON_GROUP];
+/** struct monster_friends: specific-race companion line. */
+export interface MonsterFriends {
+    /** Raw name; "same" binds to the owning race. */
+    name: string;
+    /** Resolved after all races bind. */
+    race: MonsterRace | null;
+    role: MonsterGroupRole;
+    percentChance: number;
+    numberDice: number;
+    numberSide: number;
+}
+/** struct monster_friends_base: base-template companion line. */
+export interface MonsterFriendsBase {
+    base: MonsterBase;
+    role: MonsterGroupRole;
+    percentChance: number;
+    numberDice: number;
+    numberSide: number;
+}
+/**
+ * struct monster_drop, minimal model: object kinds stay unresolved names
+ * until the object domain binds them (drop-base lines have sval null).
+ */
+export interface MonsterDrop {
+    tval: string;
+    sval: string | null;
+    percentChance: number;
+    min: number;
+    max: number;
+}
+/** struct monster_mimic, minimal: kind kept as tval/sval names. */
+export interface MonsterMimic {
+    tval: string;
+    sval: string;
+}
+/** struct monster_shape: race resolved second-pass; base wins if it names one. */
+export interface MonsterShape {
+    name: string;
+    race: MonsterRace | null;
+    base: MonsterBase | null;
+}
+/** struct monster_altmsg: per-race override of a spell message. */
+export type MonsterAltMsgType = "seen" | "unseen" | "miss";
+export interface MonsterAltMsg {
+    /** RSF_ index of the spell. */
+    index: number;
+    msgType: MonsterAltMsgType;
+    message: string;
+}
+/** struct monster_race (monster.h), bound from monster.json. */
+export interface MonsterRace {
+    /** Index in the race array; record order mirrors monster.txt. */
+    ridx: number;
+    name: string;
+    text: string;
+    plural: string | null;
+    base: MonsterBase;
+    /** Average hit points (4.2 stores avg_hp, not hdice). */
+    avgHp: number;
+    ac: number;
+    sleep: number;
+    /** Scaled by max_sight / 20 at bind time, as parse_monster_hearing. */
+    hearing: number;
+    smell: number;
+    speed: number;
+    light: number;
+    mexp: number;
+    /** Stored as 100 / pct like upstream freq_innate / freq_spell. */
+    freqInnate: number;
+    freqSpell: number;
+    /** Defaults to level; overridden by spell-power. */
+    spellPower: number;
+    flags: FlagSet;
+    spellFlags: FlagSet;
+    blows: MonsterBlow[];
+    level: number;
+    rarity: number;
+    /** Display attr (COLOUR_ index) and glyph. */
+    dAttr: number;
+    dChar: string;
+    /** Population cap: 100, or 1 for uniques (player-birth.c). */
+    maxNum: number;
+    /** Mutable per-level population count. */
+    curNum: number;
+    spellMsgs: MonsterAltMsg[];
+    drops: MonsterDrop[];
+    friends: MonsterFriends[];
+    friendsBase: MonsterFriendsBase[];
+    mimicKinds: MonsterMimic[];
+    shapes: MonsterShape[];
+}
+/** summon.txt record, loaded with minimal binding (details deferred). */
+export interface SummonType {
+    name: string;
+    msgt: string;
+    uniquesAllowed: boolean;
+    baseNames: string[];
+    raceFlag: string | null;
+    fallbackName: string | null;
+    desc: string;
+}
+/** pit.txt record, loaded with minimal binding (details deferred). */
+export interface PitProfile {
+    name: string;
+    room: number;
+    allocRarity: number;
+    allocLevel: number;
+    objRarity: number;
+    baseNames: string[];
+    colors: string[];
+    flagsReq: string[];
+    flagsBan: string[];
+    spellReq: string[];
+    spellBan: string[];
+    monBan: string[];
+    freqInnate: number;
+}
+/**
+ * The RSF_ index whose list-mon-spells.h type expression contains any of
+ * the given RST_ names (create_mon_spell_mask). Entry i of
+ * MON_SPELL_ENTRIES is RSF value i.
+ */
+export declare function monSpellsOfTypes(...types: string[]): number[];
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/mon/types.js

@@ -0,0 +1,46 @@
+/**
+ * Monster domain types, ported from reference/src/monster.h and
+ * reference/src/mon-blows.h (Angband 4.2.6).
+ *
+ * These are the bound, typed shapes produced by bind.ts from the compiled
+ * pack JSON (monster.json, monster_base.json, monster_spell.json,
+ * blow_methods.json, blow_effects.json, pain.json, summon.json, pit.json).
+ * World coupling stays out of this module: races reference each other and
+ * their bases directly, but objects (mimic kinds, drops) are kept as tval
+ * and sval names, to be resolved by the object domain later.
+ */
+import { MON_RACE_FLAG_ENTRIES, MON_SPELL_ENTRIES, MON_TEMP_FLAG_ENTRIES, } from "../generated/index.js";
+import { flagSize } from "../bitflag.js";
+import { RSF } from "../generated/index.js";
+/** Byte size of a race FlagSet (upstream RF_SIZE = FLAG_SIZE(RF_MAX)). */
+export const RF_SIZE = flagSize(MON_RACE_FLAG_ENTRIES.length);
+/** Byte size of a spell FlagSet (upstream RSF_SIZE = FLAG_SIZE(RSF_MAX)). */
+export const RSF_SIZE = flagSize(RSF.MAX);
+/** Byte size of a temp-flag FlagSet (upstream MFLAG_SIZE). */
+export const MFLAG_SIZE = flagSize(MON_TEMP_FLAG_ENTRIES.length);
+/** enum monster_group_role. */
+export const MON_GROUP = {
+    LEADER: 0,
+    SERVANT: 1,
+    BODYGUARD: 2,
+    MEMBER: 3,
+    SUMMON: 4,
+};
+/**
+ * The RSF_ index whose list-mon-spells.h type expression contains any of
+ * the given RST_ names (create_mon_spell_mask). Entry i of
+ * MON_SPELL_ENTRIES is RSF value i.
+ */
+export function monSpellsOfTypes(...types) {
+    const out = [];
+    for (let i = 0; i < MON_SPELL_ENTRIES.length; i++) {
+        const entry = MON_SPELL_ENTRIES[i];
+        if (!entry || typeof entry.type !== "string")
+            continue;
+        const parts = entry.type.split("|").map((s) => s.trim());
+        if (types.some((t) => parts.includes(t)))
+            out.push(i);
+    }
+    return out;
+}
+//# sourceMappingURL=types.js.map

package/dist/mon/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mon/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAE5C,0EAA0E;AAC1E,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAE9D,6EAA6E;AAC7E,MAAM,CAAC,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAE1C,8DAA8D;AAC9D,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;AA0GjE,+BAA+B;AAC/B,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,MAAM,EAAE,CAAC;IACT,OAAO,EAAE,CAAC;IACV,SAAS,EAAE,CAAC;IACZ,MAAM,EAAE,CAAC;IACT,MAAM,EAAE,CAAC;CACD,CAAC;AAiIX;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAG,KAAe;IACjD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,iBAAiB,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,SAAS;QACvD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACzD,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/msg.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Message handling, ported from reference/src/message.c and message.h
+ * (Angband 4.2.6).
+ *
+ * MessageLog stores the rolling log (most recent first, duplicate
+ * squashing with counts, capacity 2048). Messages is the engine-facing
+ * facade: msg()/msgt() add to the log and signal the event bus; sound()
+ * and bell() are event-only. Message types are numeric MSG_* indices
+ * (the generated list-message module supplies names); colors are numeric
+ * COLOUR_* indices as upstream.
+ *
+ * Not ported here: message_lookup_by_name / by_sound_name (they need the
+ * generated list-message table; they land with the pref-file loader).
+ * C's printf-style formatting is dropped; callers use template strings.
+ */
+import type { GameEvents } from "./events.js";
+/** A message type as it appears at engine call sites or after codegen. */
+export type MessageType = number | string;
+/** MSG_GENERIC: the default message type (index 0 of list-message.h). */
+export declare const MSG_GENERIC = 0;
+/** The rolling message memory (msgqueue_t). */
+export declare class MessageLog {
+    private max;
+    /** Newest first, index 0 = age 0 (upstream walks head -> older). */
+    private entries;
+    private colors;
+    constructor(max?: number);
+    /** messages_num. */
+    num(): number;
+    /**
+     * message_add: append, or bump the count when identical to the newest
+     * entry (count saturates at 0xFFFF exactly like the uint16_t check).
+     */
+    add(str: string, type: number): void;
+    /** message_str: text of the message of the given age ("" if absent). */
+    str(age: number): string;
+    /** message_count: repeat count of the message of the given age. */
+    count(age: number): number;
+    /** message_type. */
+    type(age: number): number;
+    /** message_color. */
+    color(age: number): number;
+    /** message_color_define. */
+    colorDefine(type: number, color: number): void;
+    /** message_type_color: COLOUR_DARK means "unset" and yields white. */
+    typeColor(type: number): number;
+}
+/** MSG_BELL index in list-message.h; bell() signals with this type. */
+export declare const MSG_BELL: 26;
+/**
+ * The msg()/msgt()/sound()/bell() facade: adds to the log and signals the
+ * event bus, honoring the use_sound option via an injected getter.
+ */
+export declare class Messages {
+    readonly log: MessageLog;
+    private events;
+    private soundEnabled;
+    constructor(log: MessageLog, events: GameEvents, soundEnabled?: () => boolean);
+    /** msg: log with MSG_GENERIC and signal EVENT_MESSAGE. */
+    msg(text: string): void;
+    /** msgt: log with a type, make the type's sound, signal EVENT_MESSAGE. */
+    msgt(type: number, text: string): void;
+    /**
+     * sound: EVENT_SOUND only, gated by the use_sound option. The payload's
+     * message is null, not "" -- message.c:374 passes NULL.
+     */
+    sound(type: number): void;
+    /** bell: EVENT_BELL, likewise with a NULL message (message.c:381). */
+    bell(): void;
+}
+//# sourceMappingURL=msg.d.ts.map

package/dist/msg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"msg.d.ts","sourceRoot":"","sources":["../src/msg.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,0EAA0E;AAC1E,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC;AAE1C,yEAAyE;AACzE,eAAO,MAAM,WAAW,IAAI,CAAC;AAmB7B,+CAA+C;AAC/C,qBAAa,UAAU;IAOT,OAAO,CAAC,GAAG;IANvB,oEAAoE;IACpE,OAAO,CAAC,OAAO,CAAkB;IAGjC,OAAO,CAAC,MAAM,CAAmC;gBAE7B,GAAG,SAAO;IAE9B,oBAAoB;IACpB,GAAG,IAAI,MAAM;IAIb;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAUpC,wEAAwE;IACxE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIxB,mEAAmE;IACnE,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI1B,oBAAoB;IACpB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIzB,qBAAqB;IACrB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAK1B,4BAA4B;IAC5B,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9C,sEAAsE;IACtE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAIhC;AAED,uEAAuE;AACvE,eAAO,MAAM,QAAQ,IAAW,CAAC;AAEjC;;;GAGG;AACH,qBAAa,QAAQ;IAEjB,QAAQ,CAAC,GAAG,EAAE,UAAU;IACxB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,YAAY;gBAFX,GAAG,EAAE,UAAU,EAChB,MAAM,EAAE,UAAU,EAClB,YAAY,GAAE,MAAM,OAAqB;IAGnD,0DAA0D;IAC1D,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKvB,0EAA0E;IAC1E,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAMtC;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKzB,sEAAsE;IACtE,IAAI,IAAI,IAAI;CAGb"}