@rpgm-tools/neo-angband-core 0.10.0

package/dist/combat/hit.js

@@ -0,0 +1,310 @@
+/**
+ * Shared to-hit and critical-hit machinery, ported VERBATIM from
+ * reference/src/player-attack.c and reference/src/mon-attack.c (Angband
+ * 4.2.6), with the critical constant tables from
+ * reference/lib/gamedata/constants.txt.
+ *
+ * This module ports the DEFAULT (non-O) combat path: test_hit / hit_chance,
+ * the melee/ranged critical chance-and-power formulas, and the critical-level
+ * cutoff tables. It also ports the alternative "O-combat" path
+ * (birth_percent_damage): o_critical_melee / o_critical_shot, the o-*-critical
+ * constants (constants.txt), and apply_deadliness. The O path is a birth
+ * option, off by default; oMeleeDamage / oRangedDamage (melee.ts / ranged.ts)
+ * consume these behind that gate.
+ *
+ * All integer arithmetic reproduces C semantics (Math.trunc for the C `/`).
+ */
+import { MON_TMD } from "../generated/index.js";
+/** Adjust BTH per plus-to-hit (player.h BTH_PLUS_ADJ). */
+export const BTH_PLUS_ADJ = 3;
+/** Percentage reduction in accuracy for a stunned combatant (mon-timed.h). */
+export const STUN_HIT_REDUCTION = 25;
+/** Percentage reduction in damage for a stunned combatant (mon-timed.h). */
+export const STUN_DAM_REDUCTION = 25;
+/* ------------------------------------------------------------------ *
+ * test_hit / hit_chance (player-attack.c)
+ * ------------------------------------------------------------------ */
+const HUNDRED_PCT = 10000;
+const ALWAYS_HIT = 1200;
+const ALWAYS_MISS = 500;
+/**
+ * hit_chance: the likelihood of a hit roll succeeding for the given to_hit and
+ * ac. Scaled to a denominator of 10,000 to avoid rounding error.
+ *
+ * Always hit 12% of the time, always miss 5% of the time, floor the to-hit at
+ * 9, roll 0..to_hit, and require the roll to reach ac*2/3.
+ */
+export function hitChance(toHit, ac) {
+    /* Put a floor on the to_hit */
+    const th = Math.max(9, toHit);
+    /* Calculate the hit percentage */
+    let numerator = Math.max(0, th - Math.trunc((ac * 2) / 3));
+    const denominator = th;
+    /* Convert the ratio to a scaled percentage */
+    numerator = Math.trunc((HUNDRED_PCT * numerator) / denominator);
+    /* The calculated rate only applies when the guaranteed hit/miss don't */
+    numerator = Math.trunc((numerator * (HUNDRED_PCT - ALWAYS_MISS - ALWAYS_HIT)) / HUNDRED_PCT);
+    /* Add in the guaranteed hit */
+    numerator += ALWAYS_HIT;
+    return { numerator, denominator: HUNDRED_PCT };
+}
+/**
+ * test_hit: determine if a hit roll succeeds against the target AC. Uses the
+ * port's random_chance_check (rng.randomChanceCheck), which is the faithful
+ * WELL-stream equivalent of upstream random_chance_check.
+ */
+export function testHit(rng, toHit, ac) {
+    return rng.randomChanceCheck(hitChance(toHit, ac));
+}
+/**
+ * Success percentage (0..100) for the given to_hit and ac, derived from
+ * hit_chance. Upstream ui-player.c reports the same ratio (numerator / 100).
+ */
+export function getHitChance(toHit, ac) {
+    return Math.trunc(hitChance(toHit, ac).numerator / 100);
+}
+/**
+ * is_debuffed: whether a monster is confused, held, afraid or stunned - any
+ * of which makes a critical hit more likely.
+ */
+export function isDebuffed(mon) {
+    return ((mon.mTimed[MON_TMD.CONF] ?? 0) > 0 ||
+        (mon.mTimed[MON_TMD.HOLD] ?? 0) > 0 ||
+        (mon.mTimed[MON_TMD.FEAR] ?? 0) > 0 ||
+        (mon.mTimed[MON_TMD.STUN] ?? 0) > 0);
+}
+/** melee-critical chance/power scale factors (constants.txt). */
+export const MELEE_CRIT = {
+    debuffToh: 10,
+    chanceWeightScl: 1,
+    chanceTohScl: 5,
+    chanceLevelScl: 0,
+    chanceTohSkillScl: 1,
+    chanceOffset: -60,
+    chanceRange: 5000,
+    powerWeightScl: 1,
+    powerRandom: 650,
+};
+/** melee-critical-level cutoffs (constants.txt), in file order (head first). */
+export const MELEE_CRIT_LEVELS = [
+    { cutoff: 400, mult: 2, add: 5, msg: "HIT_GOOD" },
+    { cutoff: 700, mult: 2, add: 10, msg: "HIT_GREAT" },
+    { cutoff: 900, mult: 3, add: 15, msg: "HIT_SUPERB" },
+    { cutoff: 1300, mult: 3, add: 20, msg: "HIT_HI_GREAT" },
+    { cutoff: -1, mult: 4, add: 20, msg: "HIT_HI_SUPERB" },
+];
+/** ranged-critical chance/power scale factors (constants.txt). */
+export const RANGED_CRIT = {
+    debuffToh: 10,
+    chanceWeightScl: 1,
+    chanceTohScl: 4,
+    chanceLevelScl: 2,
+    chanceLaunchedTohSkillScl: 0,
+    chanceThrownTohSkillScl: 0,
+    chanceOffset: 0,
+    chanceRange: 5000,
+    powerWeightScl: 1,
+    powerRandom: 500,
+};
+/** ranged-critical-level cutoffs (constants.txt), in file order. */
+export const RANGED_CRIT_LEVELS = [
+    { cutoff: 500, mult: 2, add: 5, msg: "HIT_GOOD" },
+    { cutoff: 1000, mult: 2, add: 10, msg: "HIT_GREAT" },
+    { cutoff: -1, mult: 3, add: 15, msg: "HIT_SUPERB" },
+];
+/**
+ * Walk the critical-level list for a given power, exactly as the upstream
+ * `while (power >= this_l->cutoff && this_l->next) this_l = this_l->next`.
+ * The head level is the "below the first cutoff" bucket; each cutoff is the
+ * threshold to advance to the next, sharper level; the final entry (cutoff
+ * -1) is the catch-all.
+ */
+export function selectCritLevel(power, levels) {
+    let i = 0;
+    const last = levels.length - 1;
+    while (i < last && power >= levels[i].cutoff) {
+        i++;
+    }
+    return levels[i];
+}
+/**
+ * critical_melee: factor weapon weight, total plusses and player level into a
+ * chance of a critical, then a power that selects a severity level.
+ *
+ * NB: in 4.2.6 the melee critical is critical_melee(); earlier releases named
+ * the equivalent routine critical_norm(). criticalMelee is the faithful port.
+ */
+export function criticalMelee(rng, actor, mon, weight, plus, dam) {
+    let toH = actor.toH + plus;
+    if (isDebuffed(mon))
+        toH += MELEE_CRIT.debuffToh;
+    const chance = MELEE_CRIT.chanceWeightScl * weight +
+        MELEE_CRIT.chanceTohScl * toH +
+        MELEE_CRIT.chanceLevelScl * actor.lev +
+        MELEE_CRIT.chanceTohSkillScl * actor.meleeSkill +
+        MELEE_CRIT.chanceOffset;
+    if (rng.randint1(MELEE_CRIT.chanceRange) > chance) {
+        return { damage: dam, msg: "HIT" };
+    }
+    const power = MELEE_CRIT.powerWeightScl * weight + rng.randint1(MELEE_CRIT.powerRandom);
+    const level = selectCritLevel(power, MELEE_CRIT_LEVELS);
+    return { damage: level.add + level.mult * dam, msg: level.msg };
+}
+/**
+ * critical_shot: as critical_melee but for shooting/throwing. `launched` is
+ * true for a launcher shot, false for a thrown object. The non-critical
+ * message is SHOOT_HIT (not HIT).
+ */
+export function criticalShot(rng, actor, mon, weight, plus, dam, launched) {
+    let toH = actor.toH + plus;
+    if (isDebuffed(mon))
+        toH += RANGED_CRIT.debuffToh;
+    let chance = RANGED_CRIT.chanceWeightScl * weight +
+        RANGED_CRIT.chanceTohScl * toH +
+        RANGED_CRIT.chanceLevelScl * actor.lev +
+        RANGED_CRIT.chanceOffset;
+    if (launched) {
+        chance += RANGED_CRIT.chanceLaunchedTohSkillScl * actor.bowSkill;
+    }
+    else {
+        chance += RANGED_CRIT.chanceThrownTohSkillScl * actor.throwSkill;
+    }
+    if (rng.randint1(RANGED_CRIT.chanceRange) > chance) {
+        return { damage: dam, msg: "SHOOT_HIT" };
+    }
+    const power = RANGED_CRIT.powerWeightScl * weight + rng.randint1(RANGED_CRIT.powerRandom);
+    const level = selectCritLevel(power, RANGED_CRIT_LEVELS);
+    return { damage: level.add + level.mult * dam, msg: level.msg };
+}
+/** o-melee-critical scale factors (constants.txt). */
+export const O_MELEE_CRIT = {
+    debuffToh: 10,
+    powerTohScaleNum: 1,
+    powerTohScaleDen: 3,
+    chancePowerScaleNum: 1,
+    chancePowerScaleDen: 1,
+    chanceAddDen: 240,
+};
+/** o-melee-critical-level rows (constants.txt), head first. */
+export const O_MELEE_CRIT_LEVELS = [
+    { chance: 40, dice: 5, msg: "HIT_HI_SUPERB" },
+    { chance: 12, dice: 4, msg: "HIT_HI_GREAT" },
+    { chance: 3, dice: 3, msg: "HIT_SUPERB" },
+    { chance: 2, dice: 2, msg: "HIT_GREAT" },
+    { chance: 1, dice: 1, msg: "HIT_GOOD" },
+];
+/** o-ranged-critical scale factors (constants.txt). */
+export const O_RANGED_CRIT = {
+    debuffToh: 10,
+    powerLaunchedTohScaleNum: 1,
+    powerLaunchedTohScaleDen: 1,
+    powerThrownTohScaleNum: 3,
+    powerThrownTohScaleDen: 2,
+    chancePowerScaleNum: 1,
+    chancePowerScaleDen: 1,
+    chanceAddDen: 360,
+};
+/** o-ranged-critical-level rows (constants.txt), head first. */
+export const O_RANGED_CRIT_LEVELS = [
+    { chance: 50, dice: 3, msg: "HIT_SUPERB" },
+    { chance: 10, dice: 2, msg: "HIT_GREAT" },
+    { chance: 1, dice: 1, msg: "HIT_GOOD" },
+];
+/**
+ * Walk the O-critical-level list, exactly as upstream
+ * `while (this_l->next && !one_in_(this_l->chance)) this_l = this_l->next;`.
+ * Draws one_in_ (a randint0) at each non-terminal level until it stops.
+ */
+function selectOCritLevel(rng, levels) {
+    let i = 0;
+    const last = levels.length - 1;
+    while (i < last && !rng.oneIn(levels[i].chance)) {
+        i++;
+    }
+    const lvl = levels[i];
+    return { addDice: lvl.dice, msg: lvl.msg };
+}
+/**
+ * o_critical_melee (player-attack.c L439): the crit-chance is a rational
+ * a*power / (b*power + c); on success, walk the level list for the added dice.
+ * `powerBase` is chance_of_melee_hit_base(p, obj) (computed by the caller).
+ *
+ * RNG: one randint1(chance_den) for the crit test, then (on a crit) the
+ * one_in_ level walk. Non-crit returns msg SHOOT_HIT, faithful to upstream.
+ */
+export function oCriticalMelee(rng, powerBase, mon) {
+    let power = powerBase;
+    if (isDebuffed(mon))
+        power += O_MELEE_CRIT.debuffToh;
+    power = Math.trunc((power * O_MELEE_CRIT.powerTohScaleNum) / O_MELEE_CRIT.powerTohScaleDen);
+    const chanceNum = power * O_MELEE_CRIT.chancePowerScaleNum;
+    const chanceDen = power * O_MELEE_CRIT.chancePowerScaleDen + O_MELEE_CRIT.chanceAddDen;
+    if (rng.randint1(chanceDen) <= chanceNum) {
+        return selectOCritLevel(rng, O_MELEE_CRIT_LEVELS);
+    }
+    return { addDice: 0, msg: "SHOOT_HIT" };
+}
+/**
+ * o_critical_shot (player-attack.c L351): as oCriticalMelee for shooting
+ * (launched) / throwing. `powerBase` is chance_of_missile_hit_base(p, missile,
+ * launcher). The power scale factor differs for launched vs thrown.
+ */
+export function oCriticalShot(rng, powerBase, mon, launched) {
+    let power = powerBase;
+    if (isDebuffed(mon))
+        power += O_RANGED_CRIT.debuffToh;
+    const num = launched
+        ? O_RANGED_CRIT.powerLaunchedTohScaleNum
+        : O_RANGED_CRIT.powerThrownTohScaleNum;
+    const den = launched
+        ? O_RANGED_CRIT.powerLaunchedTohScaleDen
+        : O_RANGED_CRIT.powerThrownTohScaleDen;
+    power = Math.trunc((power * num) / den);
+    const chanceNum = power * O_RANGED_CRIT.chancePowerScaleNum;
+    const chanceDen = power * O_RANGED_CRIT.chancePowerScaleDen + O_RANGED_CRIT.chanceAddDen;
+    if (rng.randint1(chanceDen) <= chanceNum) {
+        return selectOCritLevel(rng, O_RANGED_CRIT_LEVELS);
+    }
+    return { addDice: 0, msg: "SHOOT_HIT" };
+}
+/* ------------------------------------------------------------------ *
+ * apply_deadliness (player-attack.c L231/L261)
+ *
+ * Ported faithfully here (rather than reused) because obj/object-info.ts - the
+ * display estimate's home for the same table - imports from this combat module,
+ * so combat cannot import back from it without a cycle. Both copies are
+ * verified against the constants; keep them in step.
+ * ------------------------------------------------------------------ */
+/** deadliness_conversion[151] (player-attack.c L231). */
+export const DEADLINESS_CONVERSION = [
+    0, 5, 10, 14, 18, 22, 26, 30, 33, 36, 39, 42, 45, 48, 51, 54, 57, 60, 63, 66,
+    69, 72, 75, 78, 81, 84, 87, 90, 93, 96, 99, 102, 104, 107, 109, 112, 114, 117,
+    119, 122, 124, 127, 129, 132, 134, 137, 139, 142, 144, 147, 149, 152, 154,
+    157, 159, 162, 164, 167, 169, 172, 174, 176, 178, 180, 182, 184, 186, 188,
+    190, 192, 194, 196, 198, 200, 202, 204, 206, 208, 210, 212, 214, 216, 218,
+    220, 222, 224, 226, 228, 230, 232, 234, 236, 238, 240, 242, 244, 246, 248,
+    250, 251, 253, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255,
+    255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255,
+    255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255,
+    255, 255, 255, 255, 255, 255, 255, 255, 255,
+];
+/**
+ * apply_deadliness (player-attack.c L261): scale die_average (x100) by the
+ * deadliness bonus. Returns the scaled value (upstream mutates in place).
+ */
+export function applyDeadliness(dieAverage, deadliness) {
+    let dl = deadliness;
+    if (dl > 150)
+        dl = 150;
+    if (dl < -150)
+        dl = -150;
+    if (dl >= 0) {
+        const i = DEADLINESS_CONVERSION[dl];
+        return dieAverage * (100 + i);
+    }
+    const i = DEADLINESS_CONVERSION[Math.abs(dl)];
+    if (i >= 100)
+        return 0;
+    return dieAverage * (100 - i);
+}
+//# sourceMappingURL=hit.js.map

package/dist/combat/hit.js.map

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

package/dist/combat/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The combat domain: shared to-hit / critical math (hit.ts), brand and slay
+ * selection (brand-slay.ts), player melee (melee.ts), monster melee against
+ * the player (mon-melee.ts), and player ranged attacks (ranged.ts). Ported
+ * from Angband 4.2.6 (player-attack.c, mon-attack.c, mon-blows.c, obj-slays.c).
+ *
+ * Not wired into the package barrel (packages/core/src/index.ts) yet; import
+ * directly from "./combat".
+ */
+export * from "./hit.js";
+export * from "./brand-slay.js";
+export * from "./melee.js";
+export * from "./mon-melee.js";
+export * from "./ranged.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/combat/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/combat/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}

package/dist/combat/index.js

@@ -0,0 +1,15 @@
+/**
+ * The combat domain: shared to-hit / critical math (hit.ts), brand and slay
+ * selection (brand-slay.ts), player melee (melee.ts), monster melee against
+ * the player (mon-melee.ts), and player ranged attacks (ranged.ts). Ported
+ * from Angband 4.2.6 (player-attack.c, mon-attack.c, mon-blows.c, obj-slays.c).
+ *
+ * Not wired into the package barrel (packages/core/src/index.ts) yet; import
+ * directly from "./combat".
+ */
+export * from "./hit.js";
+export * from "./brand-slay.js";
+export * from "./melee.js";
+export * from "./mon-melee.js";
+export * from "./ranged.js";
+//# sourceMappingURL=index.js.map

package/dist/combat/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/combat/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}

package/dist/combat/melee.d.ts

@@ -0,0 +1,261 @@
+/**
+ * Player melee attacks, ported from reference/src/player-attack.c (Angband
+ * 4.2.6): chance_of_melee_hit(_base), melee_damage, py_attack_real and the
+ * py_attack blow loop. Standard (non-O) combat only.
+ *
+ * The upstream `struct player` carries a computed `struct player_state`
+ * (calc_bonuses) with to_h/to_d/ac/num_blows/skills/stat_ind; the port's
+ * Player does not yet compute that (player/calcs.ts defers it). Combat
+ * therefore takes an explicit PlayerCombatState alongside the Player, exactly
+ * as upstream separates `p` from `p->state`. num_blows is likewise injected.
+ *
+ * Knowledge / learning side effects (equip_learn_on_melee_attack,
+ * learn_brand_slay_from_melee) are wired at the GAME layer around pyAttack
+ * (game/player-turn.ts, game/cave-cmd.ts), keeping this module pure combat
+ * math; see obj/knowledge.ts and parity/ledger/obj-knowledge.yaml.
+ *
+ * Damage now routes through the shared mon_take_hit primitive (mon/take-hit.ts)
+ * so a blow generates monster fear (gap 2.4); the full py_attack side-effect
+ * suite (gap 2.5) - blow_side_effects (TMD_ATT_CONF), the vampiric drain
+ * (TMD_ATT_VAMP), OF_IMPACT earthquakes, bloodlust over-exertion, the
+ * shapechange verb, splash, shield bash and the PF_COMBAT_REGEN mana reward -
+ * is interleaved at the faithful RNG points via optional MeleeEffectHooks. A
+ * caller supplying no hooks (e.g. the effect handlers) still rolls fear but
+ * skips the state-mutating side effects, exactly as those simplified paths do.
+ *
+ * DEFERRED (ledgered in parity/ledger/combat-melee.yaml):
+ * - Message text/formatting (the combat code returns the HitType key only).
+ *
+ * O-combat (birth_percent_damage) IS ported: oMeleeDamage / o_critical_melee,
+ * gated in pyAttackReal at the same point upstream branches (player-attack.c
+ * L803/L811/L826). With the option off the path is byte-identical to standard.
+ */
+import type { Rng } from "../rng.js";
+import type { Brand, Slay } from "../obj/types.js";
+import type { GameObject } from "../obj/object.js";
+import type { Monster } from "../mon/monster.js";
+import type { MonTakeHitHooks } from "../mon/take-hit.js";
+import type { Player } from "../player/player.js";
+import type { HitType } from "./hit.js";
+import type { TempBrandSlay } from "./brand-slay.js";
+/**
+ * The subset of upstream `struct player_state` that combat reads. Supplied by
+ * the caller (calc_bonuses is deferred in player/calcs.ts).
+ */
+export interface PlayerCombatState {
+    /** state->to_h. */
+    toH: number;
+    /** state->to_d. */
+    toD: number;
+    /** state->ac. */
+    ac: number;
+    /** state->to_a. */
+    toA: number;
+    /** state->skills[SKILL_MAX], indexed by SKILL. */
+    skills: readonly number[];
+    /** state->num_blows, in hundredths of a blow (100 = one blow). */
+    numBlows: number;
+    /** state->ammo_mult (ranged). */
+    ammoMult: number;
+    /** state->num_shots, in tenths of a shot (10 = one shot). */
+    numShots: number;
+    /** state->ammo_tval: the ammo tval the equipped launcher fires (0 = none). */
+    ammoTval: number;
+    /** state->bless_wield (blessed weapon / holy-wield bonus). */
+    blessWield: boolean;
+}
+/**
+ * The state-mutating side effects of a melee blow (player-attack.c:669-978),
+ * all optional. combat/melee.ts draws every RNG at the faithful point whenever
+ * the triggering condition (the boolean flags below) is met, keeping the stream
+ * faithful; the callback then applies the game-state change. A caller that
+ * omits a callback leaves that effect's state change a no-op while still
+ * drawing its RNG, matching the simplified effect-handler melee paths.
+ */
+export interface MeleeEffectHooks {
+    /** mon_take_hit hooks (kill / become_aware / cover-tracks / arena death). */
+    takeHit?: MonTakeHitHooks;
+    /** p->timed[TMD_ATT_CONF] > 0: the confusion-brand side effect is armed. */
+    attConf?: boolean;
+    /** player_clear_timed(p, TMD_ATT_CONF): spend the confusion brand. */
+    clearAttConf?: () => void;
+    /** mon_inc_timed(mon, MON_TMD_CONF, dur, NOTIFY). */
+    confuseMonster?: (mon: Monster, dur: number) => void;
+    /** p->timed[TMD_ATT_VAMP] > 0: the vampiric drain is armed. */
+    attVamp?: boolean;
+    /** effect_simple(EF_HEAL_HP, drain): heal the player by the amount drained. */
+    healPlayer?: (amount: number) => void;
+    /** p->timed[TMD_BLOODLUST] > 0: bloodlust over-exertion is armed. */
+    bloodlust?: boolean;
+    /** player_over_exert(p, PY_EXERT_SCRAMBLE, 20, 20) on a missed bloodlust blow. */
+    overExertScramble?: () => void;
+    /** player_over_exert(p, PY_EXERT_CON, 20, 0) on a landed bloodlust blow. */
+    overExertCon?: () => void;
+    /** player_of_has(p, OF_IMPACT): earthquake brand present. */
+    impact?: boolean;
+    /** equip_learn_flag(p, OF_IMPACT), run when the quake condition trips. */
+    learnImpact?: () => void;
+    /** effect_simple(EF_EARTHQUAKE, rad 10) at the player; draws its own RNG. */
+    earthquake?: () => void;
+    /** square_monster(cave, grid) == null after the quake (monster gone/moved). */
+    monsterGone?: () => boolean;
+    /**
+     * PF_COMBAT_REGEN: reward the player with 5% of max SP before the blows
+     * (player-attack.c L1002); present only when the player has the flag.
+     */
+    combatRegen?: () => void;
+    /**
+     * PF_SHIELD_BASH (player-attack.c L1009): present only when the player has
+     * the flag; the bash also needs a visible monster.
+     */
+    shieldBash?: ShieldBashDeps;
+    /**
+     * player_is_shapechanged: the shape's blow verbs (p->shape->blows). When
+     * present a random one replaces the attack verb, drawing randint0(len).
+     */
+    shapeBlows?: readonly string[];
+    /**
+     * Temporary brands/slays (improve_attack_modifier(p, NULL, ...)); consulted
+     * only on the melee path, exactly as upstream.
+     */
+    temp?: TempBrandSlay;
+}
+/** Options for a melee attack. */
+export interface MeleeOptions {
+    /** monster_is_visible(mon); a non-visible target halves the to-hit. */
+    monVisible?: boolean;
+    /** player_of_has(p, OF_AFRAID); an afraid player cannot attack. */
+    afraid?: boolean;
+    /**
+     * Off-weapon equipped items (body slots >= 2) carrying brands/slays, in
+     * slot order. Upstream iterates these before the weapon.
+     */
+    offhand?: readonly GameObject[];
+    /** p->energy for the blow loop (defaults to moveEnergy: one full turn). */
+    energy?: number;
+    /** z_info->move_energy (constants.txt; 100 upstream). */
+    moveEnergy?: number;
+    /**
+     * OPT(p, birth_percent_damage): route damage through the O-combat path
+     * (oMeleeDamage) instead of the standard melee_damage + critical_melee.
+     * Off by default; when off, RNG draws are byte-identical to the standard
+     * path (the gate adds/reorders nothing).
+     */
+    percentDamage?: boolean;
+    /** The blow side effects (gap 2.5); omitted by pure-math / effect callers. */
+    hooks?: MeleeEffectHooks;
+}
+/** The outcome of a single blow (py_attack_real). */
+export interface MeleeBlow {
+    hit: boolean;
+    damage: number;
+    msg: HitType;
+    verb: string;
+    /** Brand index used (0 = none). */
+    brand: number;
+    /** Slay index used (0 = none). */
+    slay: number;
+    /** The monster was killed by the blow (mon_take_hit died). */
+    monsterDied: boolean;
+    /**
+     * The upstream `stop` value: the monster died, OR the impact quake removed
+     * or moved it (blow_after_effects). Ends the blow loop; equals monsterDied
+     * whenever no earthquake hook fires.
+     */
+    stopAttack: boolean;
+    /** The blow newly frightened the monster (mon_take_hit's *fear out-param). */
+    fear: boolean;
+}
+/** The outcome of a full attack (py_attack). */
+export interface MeleeAttack {
+    blows: MeleeBlow[];
+    totalDamage: number;
+    monsterDied: boolean;
+    /**
+     * The monster survived and was left frightened and visible: py_attack's
+     * end-of-loop add_monster_message(MON_MSG_FLEE_IN_TERROR). The caller emits
+     * the "flees in terror" line.
+     */
+    monsterFled: boolean;
+    /**
+     * p->upkeep->energy_use as py_attack leaves it: blow_energy per blow landed
+     * plus any shield-bash stumble. May be less than a full move_energy (e.g.
+     * two 40-energy blows leave 80), exactly as upstream.
+     */
+    energyUsed: number;
+}
+/**
+ * chance_of_melee_hit_base: the player's melee to-hit before the target.
+ */
+export declare function chanceOfMeleeHitBase(state: PlayerCombatState, weapon: GameObject | null): number;
+/**
+ * chance_of_melee_hit: to-hit against a specific monster (half if unseen).
+ */
+export declare function chanceOfMeleeHit(state: PlayerCombatState, weapon: GameObject | null, monVisible: boolean): number;
+/**
+ * melee_damage: base weapon dice, times the best slay or brand multiplier,
+ * plus the weapon's to-dam. Standard (non-O) combat.
+ */
+export declare function meleeDamage(rng: Rng, mon: Monster, weapon: GameObject | null, brand: number, slay: number, brands: readonly (Brand | null)[], slays: readonly (Slay | null)[]): number;
+/** The (possibly critical-boosted) damage of a single blow plus its message. */
+export interface DamageOutcome {
+    damage: number;
+    msg: HitType;
+}
+/**
+ * o_melee_damage (player-attack.c L501): the birth_percent_damage melee path.
+ * Deadliness and the slay/brand o_multiplier add extra SIDES to the damage
+ * dice; criticals add extra DICE. Unlike the standard path, the player's
+ * to-dam (player_damage_bonus) is folded in here via deadliness, so the caller
+ * must NOT add state.toD afterwards (upstream skips it under the option gate).
+ *
+ * RNG order, matching upstream exactly:
+ *  1. randint0(10000) - the fractional-sides roll (drawn even when unarmed).
+ *  2. (weapon only) o_critical_melee: randint1(chance_den) crit test, then on
+ *     a crit the one_in_ level walk.
+ *  3. damroll(dice, sides).
+ */
+export declare function oMeleeDamage(rng: Rng, state: PlayerCombatState, mon: Monster, weapon: GameObject | null, brand: number, slay: number, brands: readonly (Brand | null)[], slays: readonly (Slay | null)[]): DamageOutcome;
+/**
+ * py_attack_real: a single melee blow against the monster (player-attack.c
+ * L717). Mutates mon.hp on a damaging hit (through mon_take_hit, which also
+ * rolls fear), and interleaves the blow side effects via opts.hooks at the
+ * faithful RNG points. Returns the blow outcome; blow.monsterDied is the
+ * upstream `stop` value and blow.fear is mon_take_hit's *fear out-param.
+ */
+export declare function pyAttackReal(rng: Rng, p: Player, state: PlayerCombatState, weapon: GameObject | null, mon: Monster, brands: readonly (Brand | null)[], slays: readonly (Slay | null)[], opts?: MeleeOptions): MeleeBlow;
+/**
+ * The player-state / equipment inputs attempt_shield_bash reads beyond the
+ * combat state (player-attack.c:897-978). Present on MeleeEffectHooks only when
+ * the player has PF_SHIELD_BASH.
+ */
+export interface ShieldBashDeps {
+    /** slot_object(p, slot_by_name(p, "arm")): the equipped shield, if any. */
+    shield: GameObject | null;
+    /** state->stat_ind[STAT_DEX] (indexes adj_dex_th). */
+    dexInd: number;
+    /** state->stat_ind[STAT_STR] (indexes adj_str_td). */
+    strInd: number;
+    /** p->wt: the player's body weight. */
+    playerWt: number;
+    /** p->upkeep->total_weight: carried weight. */
+    totalWeight: number;
+    /** OPT(p, show_damage): append " (N)" to the bash message. */
+    showDamage?: boolean;
+    /** msg sink for "You get in a shield bash!" / "WHAMM!" / "You stumble!". */
+    msg?: (text: string) => void;
+    /** mon_inc_timed(mon, MON_TMD_STUN, dur, 0). */
+    stunMonster?: (mon: Monster, dur: number) => void;
+    /** mon_inc_timed(mon, MON_TMD_CONF, dur, 0). */
+    confuseMonster?: (mon: Monster, dur: number) => void;
+}
+/**
+ * py_attack (player-attack.c L988): land blows until the next blow would
+ * exceed the energy available for a single turn, or the monster dies.
+ * blow_energy = 100 * move_energy / num_blows; energy defaults to a full
+ * turn's worth. Runs the PF_COMBAT_REGEN mana reward and the shield bash
+ * before the blow loop, accumulates the fear flag across blows, and reports
+ * the delayed "flees in terror" condition and the energy actually used.
+ */
+export declare function pyAttack(rng: Rng, p: Player, state: PlayerCombatState, weapon: GameObject | null, mon: Monster, brands: readonly (Brand | null)[], slays: readonly (Slay | null)[], opts?: MeleeOptions): MeleeAttack;
+//# sourceMappingURL=melee.d.ts.map

package/dist/combat/melee.d.ts.map

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