@rpgm-tools/neo-angband-core 0.10.0

package/dist/player/types.d.ts

@@ -0,0 +1,390 @@
+/**
+ * Player domain types, ported from reference/src/player.h (Angband 4.2.6):
+ * struct player_race, player_class, class_magic / class_book / class_spell,
+ * magic_realm, player_shape, player_body / equip_slot, start_item, the
+ * history_chart graph, plus the player_property and timed_effect_data /
+ * timed_grade shapes bound from the compiled pack JSON.
+ *
+ * These are the typed, bound shapes produced by bind.ts. World coupling stays
+ * out of this module: starting inventory and spell effects keep object/effect
+ * references as tval/sval names and raw records, to be resolved by the obj and
+ * effects domains later (see the "deferred" notes and parity/ledger).
+ */
+import type { FlagSet } from "../bitflag.js";
+/** Number of timed effects (player-timed.h TMD_MAX); no MAX in the enum. */
+export declare const TMD_MAX: 53;
+/** Number of stats (player.h STAT_MAX). */
+export declare const STAT_MAX = 5;
+/**
+ * Number of stat-table slots (player.h STAT_RANGE): 3..17 give indices 0..14,
+ * then 18/00 .. 18/210+ give 15..37. Every adj_* table has exactly this many
+ * entries, indexed by state->stat_ind.
+ */
+export declare const STAT_RANGE = 38;
+/** Maximum character level (player.h PY_MAX_LEVEL). */
+export declare const PY_MAX_LEVEL = 50;
+/**
+ * Player skills (player.h SKILL_ enum). The order is the C enum order, which
+ * is NOT the order of the skill-* directives in p_race.txt / class.txt: note
+ * SEARCH precedes STEALTH here but the reverse in the data files, so binding
+ * maps by directive name rather than position.
+ */
+export declare const SKILL: {
+    readonly DISARM_PHYS: 0;
+    readonly DISARM_MAGIC: 1;
+    readonly DEVICE: 2;
+    readonly SAVE: 3;
+    readonly SEARCH: 4;
+    readonly STEALTH: 5;
+    readonly TO_HIT_MELEE: 6;
+    readonly TO_HIT_BOW: 7;
+    readonly TO_HIT_THROW: 8;
+    readonly DIGGING: 9;
+};
+export type SkillIndex = (typeof SKILL)[keyof typeof SKILL];
+/** Number of skills (player.h SKILL_MAX). */
+export declare const SKILL_MAX = 10;
+/** Byte size of an object flag set (OF_SIZE = FLAG_SIZE(OF_MAX)). */
+export declare const OF_SIZE: number;
+/** Byte size of a player flag set (PF_SIZE = FLAG_SIZE(PF_MAX)). */
+export declare const PF_SIZE: number;
+/**
+ * Per-element resist state for a race (struct element_info). Player races only
+ * set res_level via `values` lines; the ignore/hate flags used on objects are
+ * not relevant here.
+ */
+export interface PlayerElementInfo {
+    resLevel: number;
+}
+/**
+ * struct player_race (player.h), bound from p_race.json.
+ * `historyChart` is the starting chart index; `body` is a body registry index.
+ */
+export interface PlayerRace {
+    /** Index in the race array; record order mirrors p_race.txt. */
+    ridx: number;
+    name: string;
+    /** r_mhp: hit-dice modifier (the race's contribution to hitdie). */
+    hitdie: number;
+    /** r_exp: experience factor percentage. */
+    expFactor: number;
+    /** Base and modifier for the age roll (b_age + 1dm_age). */
+    baseAge: number;
+    modAge: number;
+    /** Base and modifier for the height/weight normal rolls. */
+    baseHeight: number;
+    modHeight: number;
+    baseWeight: number;
+    modWeight: number;
+    /** Infravision range in grids (infra). */
+    infravision: number;
+    /** Body registry index (always 0 in stock data: the single Humanoid body). */
+    body: number;
+    /** r_adj[STAT_MAX]: stat bonuses, indexed by STAT. */
+    statAdj: number[];
+    /** r_skills[SKILL_MAX]: skill bonuses, indexed by SKILL. */
+    skills: number[];
+    /** Racial object flags (OF_*). */
+    flags: FlagSet;
+    /** Racial player flags (PF_*). */
+    pflags: FlagSet;
+    /** Starting history chart index (r->history idx). */
+    historyChart: number;
+    /** Per-element resist info (el_info), length ELEM_MAX. */
+    elInfo: PlayerElementInfo[];
+}
+/**
+ * struct magic_realm (player.h), bound from realm.json. The pack stores only
+ * the realm's name, which serves as the lookup code (lookup_realm matches by
+ * name); no separate display code exists in 4.2.6 data.
+ */
+export interface MagicRealm {
+    /** realm.txt name, used as the lookup key from class books. */
+    name: string;
+    /** Spell stat as a STAT index (stat_name_to_idx). */
+    stat: number;
+    verb: string;
+    spellNoun: string;
+    bookNoun: string;
+}
+/**
+ * struct class_spell (player.h), bound minimally. The spell's effect chain is
+ * preserved verbatim as raw pack records (effectsRaw) rather than compiled
+ * into the effects domain; that binding is deferred.
+ */
+export interface ClassSpell {
+    name: string;
+    /** sidx: class-wide spell index (assigned in declaration order). */
+    sidx: number;
+    /** bidx: index of the owning book in the class books array. */
+    bidx: number;
+    /** slevel: required level to learn. */
+    level: number;
+    /** smana: mana to cast. */
+    mana: number;
+    /** sfail: base failure chance. */
+    fail: number;
+    /** sexp: encoded experience bonus. */
+    exp: number;
+    /** The realm of the owning book. */
+    realm: MagicRealm;
+    /** Raw effect records, preserved for later compilation (deferred). */
+    effectsRaw: unknown[];
+    /**
+     * spell->text (player-spell.c): the spell's flavour description, joined
+     * verbatim from the class data's desc: lines (string_append semantics -
+     * concatenated with no separator, so each line must carry its own leading
+     * space where the upstream data wants one). Shown by the cast/study/browse
+     * menu's '?' toggle (ui-spell.c spell_menu_browser).
+     */
+    text: string;
+}
+/**
+ * struct class_book (player.h), bound minimally. The object kind (sval,
+ * graphics, cost/rarity) is resolved by the object domain; those fields are
+ * preserved as raw data here.
+ */
+export interface ClassBook {
+    /** tval name from the pack (object domain resolves the numeric tval). */
+    tval: string;
+    /** Numeric tval, stamped by registerBookKinds (0 until registered). */
+    tvalIdx: number;
+    /** The book kind's sval, stamped by registerBookKinds (write_book_kind). */
+    sval: number;
+    /** dungeon: true when quality is "dungeon" rather than "town". */
+    dungeon: boolean;
+    /** The book's display name (used by write_book_kind to find its sval). */
+    name: string;
+    /** The magic realm of this book. */
+    realm: MagicRealm;
+    /** Declared spell count. */
+    numSpells: number;
+    spells: ClassSpell[];
+    /** Preserved book-graphics record (glyph/color), deferred to obj. */
+    graphics: unknown;
+    /** Preserved book-properties record (cost/common/minmax), deferred to obj. */
+    properties: unknown;
+}
+/** struct class_magic (player.h). */
+export interface ClassMagic {
+    /** Level of the class's first spell (0 for non-casters). */
+    spellFirst: number;
+    /** Max armor weight before mana penalties. */
+    spellWeight: number;
+    /** Number of spellbooks. */
+    numBooks: number;
+    /** Total spells across all books. */
+    totalSpells: number;
+    books: ClassBook[];
+}
+/**
+ * struct start_item (player.h), bound minimally: the object kind is kept as
+ * tval/sval names for the object domain to resolve (deferred).
+ */
+export interface StartItem {
+    tval: string;
+    sval: string;
+    min: number;
+    max: number;
+    /** Birth-option exclusion codes from the eopts field ("none" -> []). */
+    eopts: string[];
+}
+/** struct player_class (player.h), bound from class.json. */
+export interface PlayerClass {
+    /** Index in the class array; record order mirrors class.txt. */
+    cidx: number;
+    name: string;
+    /** Up to ten level titles. */
+    titles: string[];
+    /** c_adj[STAT_MAX]: stat modifiers, indexed by STAT. */
+    statAdj: number[];
+    /** c_skills[SKILL_MAX]: base skills, indexed by SKILL. */
+    skills: number[];
+    /** x_skills[SKILL_MAX]: per-level skill increments (per 10 levels). */
+    extraSkills: number[];
+    /** c_mhp: hit-dice adjustment. */
+    hitdie: number;
+    /** c_exp: experience factor percentage. */
+    expFactor: number;
+    flags: FlagSet;
+    pflags: FlagSet;
+    maxAttacks: number;
+    minWeight: number;
+    /** att_multiply: strength multiplier for blow calculation. */
+    attMultiply: number;
+    startItems: StartItem[];
+    magic: ClassMagic;
+}
+/** struct player_property (player-properties, from player_property.json). */
+export interface PlayerProperty {
+    /** "player", "object", or "element". */
+    type: string;
+    /** PF_/OF_ code, or undefined for element rows. */
+    code: string | null;
+    name: string;
+    desc: string;
+    /** Whether the property is shown in the UI birth/character screens. */
+    bindui: boolean;
+    /** Element value (resist rows), when present. */
+    value: number | null;
+}
+/**
+ * struct timed_grade (player-timed.c). The registry always prepends the
+ * implicit "off" grade (grade 0, max 0, no name/message), so a timed effect
+ * with N pack grades has N + 1 entries here.
+ */
+export interface TimedGrade {
+    /** 0 for the implicit off grade, then 1..N in ascending order. */
+    grade: number;
+    /** Resolved colour attribute (color_char/text_to_attr); 0 for off. */
+    color: number;
+    /** Upper bound of this grade (inclusive); 0 for the off grade. */
+    max: number;
+    /** Display name, or null (single-char pack names are dummies -> null). */
+    name: string | null;
+    /** Message shown when entering the grade from below, or null. */
+    upMsg: string | null;
+    /** Message shown when dropping into the grade from above, or null. */
+    downMsg: string | null;
+}
+/** One entry of a timed effect's fail directive ("fail uint code str flag"). */
+export interface TimedFail {
+    code: number;
+    flag: string;
+}
+/**
+ * One step of an on-begin-effect / on-end-effect chain (player-timed.c
+ * parse_player_timed_effect). The effect code and subtype are resolved at bind
+ * time; the dice string, when present, overrides the effect's own dice.
+ */
+export interface TimedEffectStep {
+    /** EF_ effect code (generated EF enum value). */
+    effect: number;
+    /** effect_subtype(effect, type) result (param2 / subtype), or 0 for none. */
+    subtype: number;
+    /** effect-dice string, or undefined to use the effect's default dice. */
+    dice?: string;
+}
+/** struct timed_effect_data (player-timed.c), bound from player_timed.json. */
+export interface TimedEffect {
+    /** TMD_ index; matches the generated TMD enum. */
+    index: number;
+    name: string;
+    desc: string;
+    /** on-end message (shown when the effect wears off). */
+    onEnd: string;
+    /** MSG_ type name (kept as a name; obj/effects resolve the int). */
+    msgt: string;
+    /** on-increase message (shown when the duration grows), or empty. */
+    onIncrease: string;
+    /** on-decrease message (shown when the duration shrinks), or empty. */
+    onDecrease: string;
+    /** TMD_FLAG_NONSTACKING: a fresh increase is blocked while already active. */
+    nonStacking: boolean;
+    /** lower-bound directive: values below this floor are raised to it. */
+    lowerBound: number;
+    /**
+     * temp_resist (player-timed.c parse_player_timed_resist): the ELEM_ index
+     * this effect grants a temporary resist against, or -1 when none. Bound
+     * from the pack `resist` field via ELEM[name]. On the five OPP_* effects.
+     */
+    tempResist: number;
+    /**
+     * oflag_dup (parse_player_timed_flag_synonym): the OF_ index this effect
+     * duplicates into the player's object flags while active, or 0 (OF_NONE)
+     * when none. Bound from the pack `flag-synonym[0].code` via OF[name].
+     */
+    oflagDup: number;
+    /**
+     * oflag_syn: whether the flag synonym is an exact duplicate (used only by
+     * the deferred notify-suppression). Bound from `flag-synonym[0].exact`.
+     */
+    oflagSyn: boolean;
+    grades: TimedGrade[];
+    fail: TimedFail[];
+    /**
+     * on_begin_effect (player-timed.c:875): the effect chain dispatched when the
+     * effect starts (a 0 -> positive transition), e.g. SCRAMBLE's SCRAMBLE_STATS.
+     * Undefined when the effect defines none.
+     */
+    onBeginEffect?: TimedEffectStep[];
+    /**
+     * on_end_effect (player-timed.c:884): the chain dispatched when the effect
+     * lapses (positive -> 0), e.g. SCRAMBLE's UNSCRAMBLE_STATS and SPRINT's
+     * ending TIMED_INC_NO_RES:SLOW. Undefined when the effect defines none.
+     */
+    onEndEffect?: TimedEffectStep[];
+}
+/**
+ * struct player_shape (player.h L216), fully bound from shape.json:
+ * combat bonuses, skills, object/player flags, the OBJ_MOD modifier
+ * array, elemental resists, the assume-shape effect chain and the shape
+ * blow verbs (the shape unarmed attack rides combat).
+ */
+export interface Shape {
+    /** Index in the shape array; record order mirrors shape.txt. */
+    sidx: number;
+    name: string;
+    /** Plusses to AC / hit / damage. */
+    toA: number;
+    toH: number;
+    toD: number;
+    /** skills[SKILL_MAX]. */
+    skills: number[];
+    /** Shape (object) flags. */
+    flags: FlagSet;
+    /** Shape (player) flags. */
+    pflags: FlagSet;
+    /** Stat and other modifiers (the OBJ_MOD index space). */
+    modifiers: number[];
+    /** Elemental resists (res_level per element). */
+    elInfo: PlayerElementInfo[];
+    /** The effect on taking this shape (raw records; chain built on cast). */
+    effects: readonly ShapeEffectJson[];
+    /** The effect's message, if any. */
+    effectMsg: string | null;
+    /** Shape blow verbs ("bite", "claw", ...). */
+    blows: readonly string[];
+}
+/** One raw shape-effect record (the object-effect record shape). */
+export interface ShapeEffectJson {
+    eff: string;
+    type?: string;
+    radius?: number;
+    other?: number;
+    dice?: string;
+    expr?: Array<{
+        name: string;
+        base: string;
+        expr: string;
+    }>;
+}
+/** One equipment slot of a body (struct equip_slot). */
+export interface BodySlot {
+    /** EQUIP_ slot type name from the pack (e.g. "WEAPON", "RING"). */
+    type: string;
+    /** Slot label (e.g. "right hand"). */
+    name: string;
+}
+/** struct player_body (player.h), bound from body.json. */
+export interface PlayerBody {
+    name: string;
+    count: number;
+    slots: BodySlot[];
+}
+/** struct history_entry (player.h): one weighted branch of a chart. */
+export interface HistoryEntry {
+    /** Cumulative roll threshold (1..100); chosen when roll <= this. */
+    roll: number;
+    /** Successor chart index (isucc); 0 terminates the walk. */
+    isucc: number;
+    /** Resolved successor chart, or null for terminal entries. */
+    succ: HistoryChart | null;
+    text: string;
+}
+/** struct history_chart (player.h): a node in the history graph. */
+export interface HistoryChart {
+    idx: number;
+    entries: HistoryEntry[];
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/player/types.js

@@ -0,0 +1,51 @@
+/**
+ * Player domain types, ported from reference/src/player.h (Angband 4.2.6):
+ * struct player_race, player_class, class_magic / class_book / class_spell,
+ * magic_realm, player_shape, player_body / equip_slot, start_item, the
+ * history_chart graph, plus the player_property and timed_effect_data /
+ * timed_grade shapes bound from the compiled pack JSON.
+ *
+ * These are the typed, bound shapes produced by bind.ts. World coupling stays
+ * out of this module: starting inventory and spell effects keep object/effect
+ * references as tval/sval names and raw records, to be resolved by the obj and
+ * effects domains later (see the "deferred" notes and parity/ledger).
+ */
+import { flagSize } from "../bitflag.js";
+import { OF, PLAYER_FLAG_ENTRIES, PLAYER_TIMED_ENTRIES } from "../generated/index.js";
+/** Number of timed effects (player-timed.h TMD_MAX); no MAX in the enum. */
+export const TMD_MAX = PLAYER_TIMED_ENTRIES.length;
+/** Number of stats (player.h STAT_MAX). */
+export const STAT_MAX = 5;
+/**
+ * Number of stat-table slots (player.h STAT_RANGE): 3..17 give indices 0..14,
+ * then 18/00 .. 18/210+ give 15..37. Every adj_* table has exactly this many
+ * entries, indexed by state->stat_ind.
+ */
+export const STAT_RANGE = 38;
+/** Maximum character level (player.h PY_MAX_LEVEL). */
+export const PY_MAX_LEVEL = 50;
+/**
+ * Player skills (player.h SKILL_ enum). The order is the C enum order, which
+ * is NOT the order of the skill-* directives in p_race.txt / class.txt: note
+ * SEARCH precedes STEALTH here but the reverse in the data files, so binding
+ * maps by directive name rather than position.
+ */
+export const SKILL = {
+    DISARM_PHYS: 0,
+    DISARM_MAGIC: 1,
+    DEVICE: 2,
+    SAVE: 3,
+    SEARCH: 4,
+    STEALTH: 5,
+    TO_HIT_MELEE: 6,
+    TO_HIT_BOW: 7,
+    TO_HIT_THROW: 8,
+    DIGGING: 9,
+};
+/** Number of skills (player.h SKILL_MAX). */
+export const SKILL_MAX = 10;
+/** Byte size of an object flag set (OF_SIZE = FLAG_SIZE(OF_MAX)). */
+export const OF_SIZE = flagSize(OF.MAX);
+/** Byte size of a player flag set (PF_SIZE = FLAG_SIZE(PF_MAX)). */
+export const PF_SIZE = flagSize(PLAYER_FLAG_ENTRIES.length);
+//# sourceMappingURL=types.js.map

package/dist/player/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/player/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,EAAE,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAEtF,4EAA4E;AAC5E,MAAM,CAAC,MAAM,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC;AAEnD,2CAA2C;AAC3C,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC;AAE1B;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC;AAE7B,uDAAuD;AACvD,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,WAAW,EAAE,CAAC;IACd,YAAY,EAAE,CAAC;IACf,MAAM,EAAE,CAAC;IACT,IAAI,EAAE,CAAC;IACP,MAAM,EAAE,CAAC;IACT,OAAO,EAAE,CAAC;IACV,YAAY,EAAE,CAAC;IACf,UAAU,EAAE,CAAC;IACb,YAAY,EAAE,CAAC;IACf,OAAO,EAAE,CAAC;CACF,CAAC;AAGX,6CAA6C;AAC7C,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC;AAE5B,qEAAqE;AACrE,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;AAExC,oEAAoE;AACpE,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC"}

package/dist/rational.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Exact rational arithmetic and the mean/variance estimators, ported from
+ * reference/src/z-util.c (Angband 4.2.6): gcd (L1679),
+ * my_rational_construct (L1694), my_rational_to_uint (L1722),
+ * my_rational_product (L1823), my_rational_sum (L1923), mean (L1389) and
+ * variance (L1516).
+ *
+ * WHY THESE ARE CORE AND NOT PLUMBING. Three upstream call sites depend on the
+ * exact values these return:
+ *  - obj-info.c (L435 sum_o_criticals, L563/L725 the O-combat crit averages,
+ *    L1271-L1488 the damage-per-blow readout) prints numbers derived from
+ *    my_rational_to_uint, so a rounding difference is a visibly wrong number on
+ *    the item-inspect screen.
+ *  - obj-randart.c L278-L282 store_base_power calls mean()/variance() over the
+ *    standard artifact set; those become the generator's power baselines.
+ *  - player-path.c L135/L195/L269 converts turn penalties through
+ *    my_rational_to_uint, which feeds the pathfinder's terrain penalties.
+ *
+ * FIDELITY. The C works in `unsigned int` (32-bit) and falls back to a
+ * hand-rolled 16-bit-limb multiprecision library (ini_u16n/mul_u16n/div_u16n,
+ * z-util.c L1000-L1380) whenever a product would overflow. This port keeps the
+ * SAME saturation and approximation behaviour, using BigInt for exactly the
+ * intermediates the C computes in multiprecision. That matters because the
+ * fallback is not just "a bigger integer": my_rational_product and
+ * my_rational_sum deliberately APPROXIMATE (they rescale to the largest
+ * denominator that still fits and then round to nearest), and
+ * my_rational_to_uint / variance SATURATE at UINT_MAX / INT_MAX. A port that
+ * merely used JS doubles would silently return the unsaturated value.
+ *
+ * The 32-bit rails are the point, so they are named rather than implied:
+ * a `number` here stands for a C `unsigned int` unless stated otherwise.
+ */
+/** struct my_rational (z-util.h): a fraction in lowest terms, d > 0. */
+export interface MyRational {
+    /** numerator (unsigned int) */
+    n: number;
+    /** denominator (unsigned int), always > 0 */
+    d: number;
+}
+/**
+ * gcd (z-util.c L1679): the division-based Euclid. Note gcd(0, d) === d, which
+ * my_rational_product relies on when a numerator is zero.
+ */
+export declare function gcd(a: number, b: number): number;
+/**
+ * my_rational_construct (z-util.c L1694). Zero is always 0/1; otherwise the
+ * fraction is divided through by the gcd. The C asserts denominator > 0.
+ */
+export declare function myRationalConstruct(numerator: number, denominator: number): MyRational;
+/** The out-parameter shape for my_rational_to_uint's `remainder`. */
+export interface UintRemainder {
+    remainder: number;
+}
+/**
+ * my_rational_to_uint (z-util.c L1722): a->n / a->d scaled by `scale`, floored,
+ * saturating at UINT_MAX. When `out` is given it receives the numerator of the
+ * part that was dropped (over the same denominator a.d) so the caller can round.
+ *
+ * Every early return that saturates ALSO zeroes the remainder — upstream does
+ * that at four separate points and a caller that rounds on the remainder would
+ * round differently if any were missed, so they are each reproduced.
+ */
+export declare function myRationalToUint(a: MyRational, scale: number, out?: UintRemainder): number;
+/** my_rational_product (z-util.c L1823): a * b, approximating on overflow. */
+export declare function myRationalProduct(a: MyRational, b: MyRational): MyRational;
+/** my_rational_sum (z-util.c L1923): a + b, approximating on overflow. */
+export declare function myRationalSum(a: MyRational, b: MyRational): MyRational;
+/**
+ * mean (z-util.c L1389): the arithmetic mean of nums[0 .. size-1].
+ *
+ * The `frac` out-parameter selects between TWO DIFFERENT ROUNDING RULES, which
+ * is the whole reason it exists:
+ *  - frac === null: the result is rounded to NEAREST, ties away from zero
+ *    (the C tests `f.n >= (f.d + 1) / 2` on the magnitude).
+ *  - frac given: the result is FLOORED (rounded toward negative infinity, not
+ *    toward zero) and *frac is the non-negative remainder over `size`, so that
+ *    `return + frac` is the exact mean. For a negative mean the C therefore
+ *    increments the magnitude and stores `(d - n) / d`.
+ *
+ * store_base_power (obj-randart.c L278) passes a non-null frac, so the artifact
+ * power baselines use the FLOOR, not round-to-nearest.
+ */
+export declare function mean(nums: readonly number[], size: number, frac: MyRational | null): number;
+/**
+ * variance (z-util.c L1516) of nums[0 .. size-1].
+ *
+ * `unbiased` divides by size - 1 instead of size; `ofMean` scales by a further
+ * 1 / size to give the variance of the estimate of the mean. `frac` selects
+ * floor + exact remainder over round-to-nearest, as in mean(). A result above
+ * INT_MAX saturates to INT_MAX with a zero fraction.
+ *
+ * The C computes this as (sum(x^2) - sum(x)^2 / size) / norm rather than from
+ * the deviations, and it rounds sum(x)^2 / size UP before subtracting (L1591),
+ * converting the remainder to `size - r0` so every later fractional term stays
+ * non-negative. Both are reproduced: the ceiling changes the floored result by
+ * one for some inputs.
+ */
+export declare function variance(nums: readonly number[], size: number, unbiased: boolean, ofMean: boolean, frac: MyRational | null): number;
+//# sourceMappingURL=rational.d.ts.map

package/dist/rational.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rational.d.ts","sourceRoot":"","sources":["../src/rational.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAIH,wEAAwE;AACxE,MAAM,WAAW,UAAU;IACzB,+BAA+B;IAC/B,CAAC,EAAE,MAAM,CAAC;IACV,6CAA6C;IAC7C,CAAC,EAAE,MAAM,CAAC;CACX;AAOD;;;GAGG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAOhD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,UAAU,CAOtF;AAED,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,CAAC,EAAE,UAAU,EACb,KAAK,EAAE,MAAM,EACb,GAAG,CAAC,EAAE,aAAa,GAClB,MAAM,CA+CR;AA+BD,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,UAAU,CAgB1E;AAED,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,UAAU,CAkBtE;AA0BD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,IAAI,CAClB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,GAAG,IAAI,GACtB,MAAM,CA8CR;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,OAAO,EACjB,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,UAAU,GAAG,IAAI,GACtB,MAAM,CAkER"}