@rpgm-tools/neo-angband-core 0.10.0

package/dist/obj/randart-build.d.ts

@@ -0,0 +1,223 @@
+/**
+ * Random artifact generation: the artifact-building primitives, ported from
+ * reference/src/obj-randart.c (Angband 4.2.6) lines 1332-2670. These are the
+ * routines do_randart uses to construct a single random artifact: pick a base
+ * item (get_base_item), seed it with its base stats (artifact_prep), build its
+ * per-item ability frequency table (build_freq_table), optionally supercharge
+ * it (try_supercharge), and then add individual abilities/curses via the many
+ * add_* helpers, choose_ability, add_ability(_aux), remove_contradictory and
+ * make_bad.
+ *
+ * Every routine that needs randomness takes an Rng explicitly (no globals) and
+ * draws in the exact upstream order so a randart_seed remains reproducible. The
+ * two inhibiting macros are, per upstream obj-randart.h:
+ *   INHIBIT_STRONG => rng.oneIn(6)   (one_in_(6))
+ *   INHIBIT_WEAK   => rng.oneIn(2)   (one_in_(2))
+ * Each textual occurrence of these macros consumes one draw, and C's
+ * short-circuit evaluation of && / || is reproduced exactly so no draw is
+ * added or dropped.
+ *
+ * Faithful notes / approximations:
+ * - The upstream file_putf(log_file, ...) logging is dropped throughout; it
+ *   never affects any returned value or RNG draw (same convention as power.ts
+ *   and randart-data.ts). Where a routine's only use of a value was logging
+ *   (e.g. lookup_obj_property in add_flag / add_mod), that lookup is dropped.
+ * - add_brand adds the resist matching the picked brand by comparing the
+ *   brand's name to projections[element].name for the four base elements.
+ *   Projections are not bound in ObjRegistry, so the base-element projection
+ *   names are held in a small local table (BASE_ELEMENT_PROJ_NAMES) mirroring
+ *   projection.txt / projection.json; noted as an approximation.
+ * - remove_contradictory_activation depends on effect_summarize_properties
+ *   (effects-info.c). That summarizer lives in the effects domain, so it is
+ *   ported in ./effects-info.ts (makeActivationSummarizer) and injected here as
+ *   the ActivationSummarizer seam. It consumes no RNG and only ever nulls an
+ *   activation when it is fully redundant with the artifact's other properties.
+ *   When no summarizer is supplied this stays a conservative no-op (activations
+ *   are never treated as redundant).
+ * - artifact_curse_conflicts's TIMED_INC "effect foiled by an existing
+ *   property" branch depends on the timed-effects failure tables (not ported);
+ *   only the explicit conflict-flags branch is ported. This affects only the
+ *   cursed-artifact path (make_bad) and consumes no RNG. Noted as an
+ *   approximation.
+ * - add_curse computes power as randint1(9) + 10 * m_bonus(9, level); C leaves
+ *   the evaluation order of the two calls unspecified, so this port draws
+ *   randint1 then m_bonus (left-to-right textual order).
+ */
+import type { Rng } from "../rng.js";
+import type { ObjRegistry } from "./bind.js";
+import type { CurseTimedFoil } from "./object.js";
+import type { ArtifactSetData } from "./randart-data.js";
+import type { Artifact, EffectRecordJson, ObjectKind } from "./types.js";
+/**
+ * get_base_item (obj-randart.c L1348): pick a random base item kind for a given
+ * tval, drawn uniformly across the tval's svals; rejects elven Rings-of and
+ * quest-artifact kinds. For rings/amulets the search starts past the ordinary
+ * kinds (so only special jewellery bases are used).
+ */
+export declare function getBaseItem(reg: ObjRegistry, tval: number, rng: Rng): ObjectKind;
+/**
+ * artifact_prep (obj-randart.c L1383): add basic data to an artifact of a given
+ * object kind, then assign basic combat stats based on the item type. Draws
+ * randint0 for the weapon to-hit/to-dam or armour to-AC starting bonus.
+ */
+export declare function artifactPrep(reg: ObjRegistry, art: Artifact, kind: ObjectKind, data: ArtifactSetData, rng: Rng): void;
+/**
+ * build_freq_table (obj-randart.c L1505): build a cumulative ability-frequency
+ * table for the given artifact's item type, zeroing frequencies for abilities
+ * that do not apply. Returns the cumulative table (length ART_IDX_TOTAL).
+ */
+export declare function buildFreqTable(art: Artifact, data: ArtifactSetData): number[];
+/**
+ * try_supercharge (obj-randart.c L1627): give the artifact one up-front chance
+ * at each supercharge ability (huge dice/blows, max shots/might, big speed, big
+ * AC, aggravation), weighted by the learned supercharge frequencies. The
+ * randint0(a_max) rolls use reg.artifacts.length (z_info->a_max).
+ */
+export declare function trySupercharge(reg: ObjRegistry, art: Artifact, targetPower: number, data: ArtifactSetData, rng: Rng): void;
+/** add_flag (obj-randart.c L1721): add a flag; returns true when it changed. */
+export declare function addFlag(art: Artifact, flag: number): boolean;
+/** add_resist (obj-randart.c L1736): add a resist; true when it changed. */
+export declare function addResist(art: Artifact, element: number): boolean;
+/** add_immunity (obj-randart.c L1750): grant immunity to a random base element. */
+export declare function addImmunity(art: Artifact, rng: Rng): void;
+/**
+ * add_mod (obj-randart.c L1761): add, increase (or worsen a negative) a
+ * modifier, favouring a few large bonuses over many small ones. Blows, might
+ * and moves are "powerful" and applied sparingly. Returns true when changed.
+ */
+export declare function addMod(art: Artifact, mod: number, rng: Rng): boolean;
+/** add_stat (obj-randart.c L1823): add or increase a random stat modifier. */
+export declare function addStat(art: Artifact, rng: Rng): void;
+/** add_sustain (obj-randart.c L1831): add a random sustain, if any are free. */
+export declare function addSustain(art: Artifact, rng: Rng): void;
+/** add_low_resist (obj-randart.c L1854): add a random unheld low resist. */
+export declare function addLowResist(art: Artifact, rng: Rng): void;
+/**
+ * add_high_resist (obj-randart.c L1879): add a high resist chosen from the
+ * learned high-resist frequency distribution. Faithfully preserves the
+ * upstream weighting quirk in which the running `temp` accumulator is left in
+ * a partial-sum state between retry iterations (it is not reset to the total).
+ */
+export declare function addHighResist(art: Artifact, data: ArtifactSetData, rng: Rng): void;
+/**
+ * add_brand (obj-randart.c L1928): add a brand (mostly only one), then
+ * frequently add the resist matching the brand's element.
+ */
+export declare function addBrand(reg: ObjRegistry, art: Artifact, rng: Rng): void;
+/**
+ * add_slay (obj-randart.c L1962): add a slay, then frequently add more slays
+ * if the first choice was weak (power < 105).
+ */
+export declare function addSlay(reg: ObjRegistry, art: Artifact, rng: Rng): void;
+/** add_damage_dice (obj-randart.c L1986): add one or two damage dice. */
+export declare function addDamageDice(art: Artifact, rng: Rng): void;
+/**
+ * add_to_hit (obj-randart.c L1997): add to-hit unless already too high (the
+ * high thresholds are only bypassed by the inhibiting rolls).
+ */
+export declare function addToHit(art: Artifact, fixed: number, random: number, rng: Rng): void;
+/**
+ * add_to_dam (obj-randart.c L2020): add to-dam unless already too high. Note
+ * the upstream quirk kept faithfully: the HIGH threshold branch tests to_h,
+ * not to_d.
+ */
+export declare function addToDam(art: Artifact, fixed: number, random: number, rng: Rng): void;
+/**
+ * add_to_AC (obj-randart.c L2044): add to-AC unless already too high. Note the
+ * upstream quirk kept faithfully: the HIGH threshold branch tests to_h, not
+ * to_a.
+ */
+export declare function addToAC(art: Artifact, fixed: number, random: number, rng: Rng): void;
+/** add_weight_mod (obj-randart.c L2068): lower the artifact's weight by 10%. */
+export declare function addWeightMod(art: Artifact): void;
+/**
+ * add_activation (obj-randart.c L2078): give the artifact a random activation
+ * that is useful but not exploitable and roughly proportionate to its power.
+ * z_info->act_max is reg.activations.length (index 0 is the null/zeroed slot,
+ * mirroring the zeroed activations[0] upstream).
+ */
+export declare function addActivation(reg: ObjRegistry, art: Artifact, targetPower: number, maxPower: number, rng: Rng): void;
+/**
+ * choose_ability (obj-randart.c L2121): choose an ability index weighted by the
+ * given cumulative frequency table (length ART_IDX_TOTAL).
+ */
+export declare function chooseAbility(freqTable: readonly number[], rng: Rng): number;
+/**
+ * add_ability_aux (obj-randart.c L2150): add the ability given by index r. A
+ * general dispatch that imposes no item-type restriction (that is handled by
+ * the frequency table).
+ */
+export declare function addAbilityAux(reg: ObjRegistry, art: Artifact, r: number, targetPower: number, data: ArtifactSetData, rng: Rng): void;
+/**
+ * enum effect_object_property_kind (effects-info.h L40): the kind of object
+ * property an activation effect grants, as summarized for redundancy checks.
+ */
+export declare const EFPROP: {
+    readonly OBJECT_FLAG_EXACT: 0;
+    readonly OBJECT_FLAG: 1;
+    readonly RESIST: 2;
+    readonly CURE_FLAG: 3;
+    readonly CURE_RESIST: 4;
+    readonly CONFLICT_FLAG: 5;
+    readonly CONFLICT_RESIST: 6;
+    readonly CONFLICT_VULN: 7;
+    readonly BRAND: 8;
+    readonly SLAY: 9;
+};
+/** struct effect_object_property (effects-info.h L53): one summarized property. */
+export interface EffectObjectProperty {
+    /** EFPROP_* kind. */
+    kind: number;
+    /** OF_ / ELEM_ / brand / slay index, per `kind`. */
+    idx: number;
+    /** For the resist/vuln kinds: the res_level window that makes it redundant. */
+    reslevelMin: number;
+    reslevelMax: number;
+}
+/**
+ * effect_summarize_properties (effects-info.c L898): summarize the object
+ * properties an activation's effect chain grants, plus a count of sub-effects
+ * that map to no object property. This lives in the effects domain (out of this
+ * work package's lock) and is injected so remove_contradictory_activation can
+ * measure redundancy. When no summarizer is supplied the activation is never
+ * treated as redundant (a conservative no-op).
+ */
+export type ActivationSummarizer = (effect: readonly EffectRecordJson[]) => {
+    props: EffectObjectProperty[];
+    unsummarizedCount: number;
+};
+/**
+ * remove_contradictory_activation (obj-randart.c L2420): drop the activation
+ * when everything it does is already provided by (or in conflict with) the
+ * artifact's other properties. Upstream summarizes the activation via
+ * effect_summarize_properties; the port injects that summarizer (see
+ * ActivationSummarizer / gap 3.8 WIRING-NEEDED). The redundancy switch below is
+ * a faithful transcription; it draws no RNG.
+ */
+export declare function removeContradictoryActivation(reg: ObjRegistry, art: Artifact, summarize?: ActivationSummarizer): void;
+/**
+ * remove_contradictory (obj-randart.c L2530): clean up illogical combinations
+ * of powers (aggravation vs stealth, negative stats vs their sustains,
+ * drain-exp vs hold-life), remove conflicting curses, and drop a redundant
+ * activation.
+ */
+export declare function removeContradictory(reg: ObjRegistry, art: Artifact, timedFoil?: CurseTimedFoil, activationSummarize?: ActivationSummarizer): void;
+/**
+ * add_ability (obj-randart.c L2567): choose a random ability from the frequency
+ * table, add it, remove contradictions, and bless WIS-bearing sharp weapons.
+ */
+export declare function addAbility(reg: ObjRegistry, art: Artifact, targetPower: number, freq: readonly number[], data: ArtifactSetData, rng: Rng): void;
+/**
+ * add_curse (obj-randart.c L2591): randomly select a curse and apply it, unless
+ * the artifact is blessed. Each attempt draws pick then power regardless of
+ * whether the curse is possible on this tval. See the module note on the
+ * randint1(9) + 10 * m_bonus(9, level) evaluation order.
+ */
+export declare function addCurse(reg: ObjRegistry, art: Artifact, level: number, rng: Rng, timedFoil?: CurseTimedFoil): boolean;
+/**
+ * make_bad (obj-randart.c L2613): make an artifact bad, or worse: possibly add
+ * aggravation / drain-exp / no-teleport, flip some positive modifiers and
+ * combat bonuses to negative, and apply one or two curses.
+ */
+export declare function makeBad(reg: ObjRegistry, art: Artifact, level: number, rng: Rng, timedFoil?: CurseTimedFoil): void;
+//# sourceMappingURL=randart-build.d.ts.map

package/dist/obj/randart-build.d.ts.map

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