@rpgm-tools/neo-angband-core 0.10.0

package/dist/dice.js

@@ -0,0 +1,424 @@
+/**
+ * Dice expressions, ported from reference/src/z-dice.c/h (Angband 4.2.6).
+ *
+ * A dice object represents "B+XdYmZ" (base, dice, sides, m_bonus) parsed
+ * from strings like "3+4d5M6", "d4", or "$B+$Dd$S". Uppercase names
+ * starting with $ are variables; expressions are bound to them with
+ * bindExpression and evaluated when the dice are rolled.
+ *
+ * Parser behavior replicated exactly from the upstream state machine:
+ * - Spaces (C isspace) are skipped, concatenating what surrounds them
+ *   ("1 1 +2d3" parses as base 11).
+ * - Tokens (numbers, variable names) are truncated to 16 characters.
+ * - A 'd' with no leading count means one die ("d6" is 1d6).
+ * - 'M' doubles as the bonus marker and as a variable-name character; it is
+ *   only treated as a name character while a variable name is being read.
+ *   'm' is always the bonus marker.
+ * - '-' is only accepted as the very first character (negative base).
+ * - Characters that are none of [0-9A-Z$dmM+-&], C whitespace, or the
+ *   terminator are silently IGNORED, as upstream ("1z+2d3" == "1+2d3").
+ * - Numbers are parsed with C strtol base 0, so a leading 0 makes a number
+ *   octal ("010+d4" has base 8).
+ * - At most 4 distinct variables fit; on overflow the component keeps the
+ *   error index -1 (upstream stores it and later reads out of bounds,
+ *   undefined behavior; this port evaluates such a component as 0).
+ *
+ * The RNG is passed to roll/evaluate as a parameter; this module holds no
+ * random state.
+ */
+import { strtolBase0 } from "./expression.js";
+/** Hard limit on the number of variables/expressions. */
+const DICE_MAX_EXPRESSIONS = 4;
+/** Max size for a token/number; longer tokens are truncated. */
+const DICE_TOKEN_SIZE = 16;
+/* String parser states (dice_state_t), 'A' through 'M' in the table. */
+const STATE_START = 0; /* A */
+const STATE_BASE_DIGIT = 1; /* B */
+const STATE_FLUSH_BASE = 2; /* C */
+const STATE_DICE_DIGIT = 3; /* D */
+const STATE_FLUSH_DICE = 4; /* E */
+const STATE_SIDE_DIGIT = 5; /* F */
+const STATE_FLUSH_SIDE = 6; /* G */
+const STATE_BONUS = 7; /* H */
+const STATE_BONUS_DIGIT = 8; /* I */
+const STATE_FLUSH_BONUS = 9; /* J */
+const STATE_VAR = 10; /* K */
+const STATE_VAR_CHAR = 11; /* L */
+const STATE_FLUSH_ALL = 12; /* M */
+const STATE_MAX = 13;
+/* Parser input types (dice_input_t). */
+const INPUT_AMP = 0;
+const INPUT_MINUS = 1;
+const INPUT_BASE = 2;
+const INPUT_DICE = 3;
+const INPUT_BONUS = 4;
+const INPUT_VAR = 5;
+const INPUT_DIGIT = 6;
+const INPUT_UPPER = 7;
+const INPUT_NULL = 8;
+const INPUT_MAX = 9;
+/**
+ * The state table from dice_parse_state_transition, transcribed verbatim.
+ * Row = state A..M, column = input (&, -, +, d, m, $, digit, upper, NUL).
+ * '.' is an invalid transition.
+ */
+const STATE_TABLE = [
+    ".B.EHKB..", /* A: START */
+    "..CE..B.C", /* B: BASE_DIGIT */
+    "...EHKD..", /* C: FLUSH_BASE */
+    "...E..D..", /* D: DICE_DIGIT */
+    ".....KF..", /* E: FLUSH_DICE */
+    "G...H.F.G", /* F: SIDE_DIGIT */
+    "....H....", /* G: FLUSH_SIDE */
+    ".....KI..", /* H: BONUS */
+    "......I.J", /* I: BONUS_DIGIT */
+    ".........", /* J: FLUSH_BONUS */
+    ".......L.", /* K: VAR */
+    "G.CEH..LM", /* L: VAR_CHAR */
+    ".........", /* M: FLUSH_ALL */
+];
+/* Last-seen tracker (enum last_seen_e). */
+const SEEN_NONE = 0;
+const SEEN_BASE = 1;
+const SEEN_DICE = 2;
+const SEEN_SIDE = 3;
+const SEEN_BONUS = 4;
+const C_SPACE = " \t\n\v\f\r";
+function isDigit(c) {
+    return c >= "0" && c <= "9";
+}
+function isUpper(c) {
+    return c >= "A" && c <= "Z";
+}
+/** dice_input_for_char. */
+function inputForChar(c) {
+    switch (c) {
+        case "&":
+            return INPUT_AMP;
+        case "-":
+            return INPUT_MINUS;
+        case "+":
+            return INPUT_BASE;
+        case "d":
+            return INPUT_DICE;
+        case "M":
+        case "m":
+            return INPUT_BONUS;
+        case "$":
+            return INPUT_VAR;
+        case "\0":
+            return INPUT_NULL;
+        default:
+            break;
+    }
+    if (isDigit(c))
+        return INPUT_DIGIT;
+    if (isUpper(c))
+        return INPUT_UPPER;
+    return INPUT_MAX;
+}
+/** dice_parse_state_transition. */
+function stateTransition(state, input) {
+    if (state === STATE_MAX || input === INPUT_MAX)
+        return STATE_MAX;
+    const cell = STATE_TABLE[state][input];
+    if (cell === ".")
+        return STATE_MAX;
+    return cell.charCodeAt(0) - 0x41; /* 'A' */
+}
+/**
+ * dice_t. Construction is dice_new (dice_free is garbage collected).
+ */
+export class Dice {
+    b = 0;
+    x = 0;
+    y = 0;
+    m = 0;
+    exB = false;
+    exX = false;
+    exY = false;
+    exM = false;
+    expressions = null;
+    /**
+     * dice_reset: zero the values and clear (but keep) the expression table.
+     */
+    reset() {
+        this.b = 0;
+        this.x = 0;
+        this.y = 0;
+        this.m = 0;
+        this.exB = false;
+        this.exX = false;
+        this.exY = false;
+        this.exM = false;
+        if (this.expressions === null)
+            return;
+        for (const entry of this.expressions) {
+            entry.name = null;
+            entry.expression = null;
+        }
+    }
+    /**
+     * dice_add_variable: returns the index of the (possibly new) variable
+     * name, or -1 when all DICE_MAX_EXPRESSIONS slots are taken.
+     */
+    addVariable(name) {
+        if (this.expressions === null) {
+            this.expressions = [];
+            for (let i = 0; i < DICE_MAX_EXPRESSIONS; i++) {
+                this.expressions.push({ name: null, expression: null });
+            }
+        }
+        for (let i = 0; i < DICE_MAX_EXPRESSIONS; i++) {
+            const entry = this.expressions[i];
+            if (entry.name === null) {
+                entry.name = name;
+                return i;
+            }
+            else if (entry.name.toLowerCase() === name.toLowerCase()) {
+                return i;
+            }
+        }
+        return -1;
+    }
+    /**
+     * dice_bind_expression: bind a deep copy of `expression` to a variable
+     * name found during parsing. Returns the index bound, or -1 when the
+     * name is unknown (case-insensitive lookup, as upstream my_stricmp).
+     */
+    bindExpression(name, expression) {
+        if (this.expressions === null)
+            return -1;
+        for (let i = 0; i < DICE_MAX_EXPRESSIONS; i++) {
+            const entry = this.expressions[i];
+            if (entry.name === null)
+                continue;
+            if (entry.name.toLowerCase() === name.toLowerCase()) {
+                entry.expression = expression.copy();
+                return i;
+            }
+        }
+        return -1;
+    }
+    /**
+     * dice_parse_string: parse a dice string into this object, resetting any
+     * previous state. Returns true on success, false on a parse error.
+     */
+    parseString(string) {
+        if (string === null || string === undefined)
+            return false;
+        let token = "";
+        let state = STATE_START;
+        let lastSeen = SEEN_NONE;
+        /* Reset all internal state, since this object might be reused. */
+        this.reset();
+        /* The string terminator is included as part of the parse. */
+        for (let current = 0; current <= string.length; current++) {
+            const ch = current < string.length ? string[current] : "\0";
+            /* Skip spaces; this concatenates digits and variable names. */
+            if (C_SPACE.includes(ch))
+                continue;
+            const inputType = inputForChar(ch);
+            switch (inputType) {
+                case INPUT_AMP:
+                case INPUT_BASE:
+                case INPUT_DICE:
+                case INPUT_VAR:
+                case INPUT_NULL:
+                    state = stateTransition(state, inputType);
+                    break;
+                case INPUT_MINUS:
+                case INPUT_DIGIT:
+                case INPUT_UPPER:
+                    /* Truncate tokens if they are too long to fit. */
+                    if (token.length < DICE_TOKEN_SIZE)
+                        token += ch;
+                    state = stateTransition(state, inputType);
+                    break;
+                default:
+                    /* INPUT_BONUS and unrecognized characters: handled below or
+                     * silently ignored, as upstream. */
+                    break;
+            }
+            /*
+             * 'M' doubles as the bonus marker and a variable-name character; it
+             * is a name character only while a variable name is being read.
+             */
+            if (ch === "M") {
+                if (state === STATE_VAR || state === STATE_VAR_CHAR) {
+                    if (token.length < DICE_TOKEN_SIZE)
+                        token += ch;
+                    state = stateTransition(state, INPUT_UPPER);
+                }
+                else {
+                    state = stateTransition(state, INPUT_BONUS);
+                }
+            }
+            else if (ch === "m") {
+                state = stateTransition(state, INPUT_BONUS);
+            }
+            /* Illegal transition. */
+            if (state >= STATE_MAX)
+                return false;
+            let flush = true;
+            switch (state) {
+                case STATE_FLUSH_BASE:
+                    lastSeen = SEEN_BASE;
+                    break;
+                case STATE_FLUSH_DICE:
+                    lastSeen = SEEN_DICE;
+                    /* A 'd' with no number before it is one die. */
+                    if (token.length === 0)
+                        token = "1";
+                    break;
+                case STATE_FLUSH_SIDE:
+                    lastSeen = SEEN_SIDE;
+                    break;
+                case STATE_FLUSH_BONUS:
+                    lastSeen = SEEN_BONUS;
+                    break;
+                case STATE_FLUSH_ALL:
+                    /* Flush whatever comes after what we last saw. */
+                    if (lastSeen < SEEN_BONUS)
+                        lastSeen++;
+                    break;
+                case STATE_BONUS:
+                    /* If we last saw dice, we are now seeing sides. */
+                    if (lastSeen === SEEN_DICE)
+                        lastSeen = SEEN_SIDE;
+                    else
+                        lastSeen = SEEN_BONUS;
+                    break;
+                default:
+                    /* A state that should not flush anything. */
+                    flush = false;
+                    break;
+            }
+            if (flush && token.length > 0) {
+                let value = 0;
+                let isVariable = false;
+                if (isUpper(token[0])) {
+                    value = this.addVariable(token);
+                    isVariable = true;
+                }
+                else {
+                    /* C strtol(token, NULL, 0) then (int) cast. */
+                    value = strtolBase0(token).value | 0;
+                    isVariable = false;
+                }
+                switch (lastSeen) {
+                    case SEEN_BASE:
+                        this.b = value;
+                        this.exB = isVariable;
+                        break;
+                    case SEEN_DICE:
+                        this.x = value;
+                        this.exX = isVariable;
+                        break;
+                    case SEEN_SIDE:
+                        this.y = value;
+                        this.exY = isVariable;
+                        break;
+                    case SEEN_BONUS:
+                        this.m = value;
+                        this.exM = isVariable;
+                        break;
+                    default:
+                        break;
+                }
+                token = "";
+            }
+        }
+        return true;
+    }
+    /** Evaluate one component, resolving a bound expression if needed. */
+    component(value, isExpression) {
+        if (!isExpression)
+            return value;
+        if (this.expressions !== null &&
+            value >= 0 &&
+            value < DICE_MAX_EXPRESSIONS &&
+            this.expressions[value].expression !== null) {
+            const expr = this.expressions[value]
+                .expression;
+            return expr.evaluate();
+        }
+        return 0;
+    }
+    /**
+     * dice_random_value: extract a random_value, evaluating any bound
+     * expressions. Deterministic (no RNG involved).
+     */
+    randomValue() {
+        return {
+            base: this.component(this.b, this.exB),
+            dice: this.component(this.x, this.exX),
+            sides: this.component(this.y, this.exY),
+            mBonus: this.component(this.m, this.exM),
+        };
+    }
+    /**
+     * dice_evaluate: fully evaluate via randcalc under an aspect. When `out`
+     * is passed, the random_value used is written into it (the upstream out
+     * parameter).
+     */
+    evaluate(rng, level, aspect, out) {
+        const rv = this.randomValue();
+        if (out !== undefined) {
+            out.base = rv.base;
+            out.dice = rv.dice;
+            out.sides = rv.sides;
+            out.mBonus = rv.mBonus;
+        }
+        return rng.randcalc(rv, level, aspect);
+    }
+    /**
+     * dice_roll: evaluate as base + XdY (m_bonus is reported in `out` but
+     * not rolled, as upstream).
+     */
+    roll(rng, out) {
+        const rv = this.randomValue();
+        if (out !== undefined) {
+            out.base = rv.base;
+            out.dice = rv.dice;
+            out.sides = rv.sides;
+            out.mBonus = rv.mBonus;
+        }
+        return rv.base + rng.damroll(rv.dice, rv.sides);
+    }
+    /** dice_test_values: compare the raw parsed values (not expressions). */
+    testValues(base, diceCount, sides, bonus) {
+        let success = true;
+        success &&= this.b === base;
+        success &&= this.x === diceCount;
+        success &&= this.y === sides;
+        success &&= this.m === bonus;
+        return success;
+    }
+    /**
+     * dice_test_variables: check that each component uses the named variable
+     * (or, when null, does not use a variable). Requires that at least one
+     * variable was parsed, as upstream (expressions table must exist).
+     */
+    testVariables(base, diceName, sides, bonus) {
+        if (this.expressions === null)
+            return false;
+        const check = (wanted, isExpr, index) => {
+            if (wanted === null)
+                return !isExpr;
+            if (!isExpr || index < 0)
+                return false;
+            const entry = this.expressions?.[index];
+            if (entry === undefined || entry.name === null)
+                return false;
+            return entry.name.toLowerCase() === wanted.toLowerCase();
+        };
+        let success = true;
+        success &&= check(base, this.exB, this.b);
+        success &&= check(diceName, this.exX, this.x);
+        success &&= check(sides, this.exY, this.y);
+        success &&= check(bonus, this.exM, this.m);
+        return success;
+    }
+}
+//# sourceMappingURL=dice.js.map

package/dist/dice.js.map

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

package/dist/effects/effect-choice.d.ts

@@ -0,0 +1,15 @@
+import type { Effect } from "./effect.js";
+import type { EffectMenuNameDeps } from "./effect-info.js";
+/** Renderer-neutral EF_SELECT menu rows (ui-effect.c L34-180). */
+export interface EffectChoiceRow {
+    /** 0-based sub-effect choice, or -2 for the explicit random row. */
+    choice: number;
+    label: string;
+    random: boolean;
+}
+/**
+ * Build the rows a host UI presents for a SELECT chain. This is data-only;
+ * GlyphTerm and other renderers stay outside game/effects logic.
+ */
+export declare function effectChoiceRows(first: Effect | null, count: number, deps?: EffectMenuNameDeps): EffectChoiceRow[];
+//# sourceMappingURL=effect-choice.d.ts.map

package/dist/effects/effect-choice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-choice.d.ts","sourceRoot":"","sources":["../../src/effects/effect-choice.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,kBAAuB,GAC5B,eAAe,EAAE,CAWnB"}

package/dist/effects/effect-choice.js

@@ -0,0 +1,18 @@
+import { effectMenuName, effectNext } from "./effect-info.js";
+/**
+ * Build the rows a host UI presents for a SELECT chain. This is data-only;
+ * GlyphTerm and other renderers stay outside game/effects logic.
+ */
+export function effectChoiceRows(first, count, deps = {}) {
+    const labels = [];
+    let effect = first;
+    for (let i = 0; effect && i < count; i++) {
+        labels.push(effectMenuName(effect, deps));
+        effect = effectNext(effect);
+    }
+    return [
+        { choice: -2, label: "one of the following at random", random: true },
+        ...labels.map((label, choice) => ({ choice, label, random: false })),
+    ];
+}
+//# sourceMappingURL=effect-choice.js.map

package/dist/effects/effect-choice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-choice.js","sourceRoot":"","sources":["../../src/effects/effect-choice.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAW9D;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAoB,EACpB,KAAa,EACb,OAA2B,EAAE;IAE7B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;QAC1C,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO;QACL,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,gCAAgC,EAAE,MAAM,EAAE,IAAI,EAAE;QACrE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;KACrE,CAAC;AACJ,CAAC"}

package/dist/effects/effect-info.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Effect display/description helpers, ported from reference/src/effects-info.c
+ * (Angband 4.2.6): effect_info (effects.c L103, re-exposed here as a pure
+ * function over the generated EFFECT_ENTRIES table), effect_damages (L742),
+ * effect_avg_damage (L773), effect_projection (L804), effect_next (L721),
+ * effect_describe / create_nested_effect_description (L122-572), plus the
+ * per-row spell comment builder of reference/src/player-spell.c
+ * (append_random_value_string L570, spell_effect_append_value_info L593,
+ * get_spell_info L708) and the "Inflicts an average of ... damage." summary
+ * of reference/src/ui-spell.c spell_menu_browser (L147-208).
+ *
+ * PURE DISPLAY PATH, RNG-SAFE BY CONSTRUCTION: nothing in this module reads
+ * or advances the game RNG. Upstream's effect_describe / get_spell_info call
+ * dice_roll(effect->dice, &value) to populate the random_value it formats;
+ * dice_roll itself calls damroll() and so draws real entropy (harmless for
+ * the "roll" it discards but a determinism hazard if replicated here, since
+ * rendering a menu row or a spell description must never perturb future RNG
+ * draws - the project's #1 anxiety per its save-scum policy). This port
+ * substitutes Dice.randomValue() (dice_random_value: base/dice/sides/mBonus
+ * extraction with no rolling) at every such call site, and reimplements the
+ * AVERAGE/MINIMISE/MAXIMISE aspect math locally (rvAverage/rvMin/rvMax) so
+ * that not even an Rng instance needs to be threaded through this file.
+ * effect_next's random/select "how many sub-effects" count and
+ * effect_damages/effect_avg_damage/effect_projection's dice_evaluate(...,
+ * AVERAGE, ...) calls are all replaced the same way.
+ *
+ * Divergences by design:
+ * - No textblock/colour markup: describeEffect returns a plain string.
+ *   Upstream's digit-highlighting (copy_to_textblock_with_coloring) is a
+ *   rendering concern left to whatever UI layer consumes the string.
+ * - Globals the upstream reads (timed_effects[], the object property
+ *   registry, the summon table, player->lev, z_info->food_value,
+ *   z_info->max_range) are passed in as dependency bags instead
+ *   (EffectDescribeDeps, SpellInfoDeps) with sensible defaults so callers
+ *   that don't need a given case can omit it.
+ */
+import type { Dice } from "../dice.js";
+import { type RandomValue } from "../rng.js";
+import type { ProjectionInfo } from "../world/projection.js";
+import type { Effect } from "./effect.js";
+/** Live lookup data needed by effect_get_menu_name (effects-info.c L583-714). */
+export interface EffectMenuNameDeps {
+    projections?: readonly Pick<ProjectionInfo, "desc" | "playerDesc" | "lashDesc">[];
+    timedDesc?: (tmdIndex: number) => string;
+    statName?: (statIndex: number) => string;
+    summonDesc?: (summonIndex: number) => string;
+    foodFull?: number;
+    foodHungry?: number;
+}
+/** effect_get_menu_name (effects-info.c L583-714), including subtype formatting. */
+export declare function effectMenuName(effect: Effect | null, deps?: EffectMenuNameDeps): string;
+/** effect_info (effects.c L103): the short info-type string ("dam", "heal", ...). */
+export declare function effectInfo(effect: Effect | null): string | null;
+/**
+ * effect_next (effects-info.c L721): the next effect in the chain, skipping
+ * over all the sub-effects of a random/select effect.
+ */
+export declare function effectNext(effect: Effect): Effect | null;
+/**
+ * effect_damages (effects-info.c L742): whether the effect (or, for a
+ * random/select effect, any sub-effect) deals damage.
+ */
+export declare function effectDamages(effect: Effect): boolean;
+/**
+ * effect_avg_damage (effects-info.c L773): the average damage dealt, using
+ * `sharedDice` in place of the effect's own dice when a prior SET_VALUE
+ * effect supplied one (pass null when there wasn't one).
+ */
+export declare function effectAvgDamage(effect: Effect, sharedDice: Dice | null): number;
+/**
+ * effect_projection (effects-info.c L804): the element/projection name for
+ * the damage segment, or "" if the effect has none (or, for a random/select
+ * effect, its sub-effects don't all share the same one).
+ */
+export declare function effectProjection(effect: Effect, projections: readonly Pick<ProjectionInfo, "playerDesc">[]): string;
+/**
+ * Dependencies effect_describe reads from globals upstream. All optional
+ * except `projections`, defaulting to "" (no case in the EFINFO_* switch
+ * treats an empty string specially, matching an absent lookup gracefully).
+ */
+export interface EffectDescribeDeps {
+    /** projections[] indexed by PROJ value (or subtype for mod codes). */
+    projections: readonly Pick<ProjectionInfo, "desc" | "playerDesc" | "lashDesc">[];
+    /** timed_effects[idx].desc (player-timed.c), for EFINFO_CURE / EFINFO_TIMED. */
+    timedDesc?: (tmdIndex: number) => string;
+    /** lookup_obj_property(OBJ_PROPERTY_STAT, idx)->name, for EFINFO_STAT. */
+    statName?: (statIndex: number) => string;
+    /** summon_desc(idx) (mon-summon.c), for EFINFO_SUMM. */
+    summonDesc?: (summonIndex: number) => string;
+    /** player->lev; scales EFINFO_SHORT's displayed length. */
+    playerLevel?: number;
+    /** z_info->food_value; the EFINFO_FOOD turn-count multiplier (100 upstream). */
+    foodValue?: number;
+}
+/**
+ * effect_describe (effects-info.c L319): a description of `effectHead` (and
+ * any effects chained after it via EF_RANDOM/EF_SELECT) if `onlyFirst`, or of
+ * the whole remaining chain otherwise. Returns null when nothing in range has
+ * a description (mirrors upstream's NULL textblock). `prefix` is prepended
+ * once, before the first description added.
+ */
+export declare function describeEffect(effectHead: Effect | null, prefix: string | null, devSkillBoost: number, onlyFirst: boolean, deps: EffectDescribeDeps): string | null;
+/** append_random_value_string (player-spell.c L570). */
+export declare function appendRandomValueString(rv: RandomValue): string;
+/** Dependencies get_spell_info reads from the live player upstream. */
+export interface SpellInfoDeps {
+    /** player->lev; scales the displayed EF_BALL radius / EF_SHORT_BEAM length. */
+    playerLevel?: number;
+    /** z_info->max_range; caps the displayed EF_SHORT_BEAM length. */
+    maxRange?: number;
+}
+/**
+ * get_spell_info (player-spell.c L708): the per-spell comment shown after the
+ * fail% column in the spell menu, e.g. " dam 3d4" or " dam 2d8; heal 15".
+ */
+export declare function getSpellInfo(effect: Effect | null, deps?: SpellInfoDeps): string;
+/**
+ * The damaging-effects half of spell_menu_browser (ui-spell.c L164-201): the
+ * "Inflicts an average of N element[, M element and ...] damage." sentence,
+ * or null when the spell has no damaging effects at all (upstream skips the
+ * whole block in that case).
+ */
+export declare function spellDamageSummary(effect: Effect | null, projections: readonly Pick<ProjectionInfo, "playerDesc">[]): string | null;
+//# sourceMappingURL=effect-info.d.ts.map

package/dist/effects/effect-info.d.ts.map

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