@rpgm-tools/neo-angband-core 0.10.0

package/dist/msg.js

@@ -0,0 +1,126 @@
+/**
+ * Message handling, ported from reference/src/message.c and message.h
+ * (Angband 4.2.6).
+ *
+ * MessageLog stores the rolling log (most recent first, duplicate
+ * squashing with counts, capacity 2048). Messages is the engine-facing
+ * facade: msg()/msgt() add to the log and signal the event bus; sound()
+ * and bell() are event-only. Message types are numeric MSG_* indices
+ * (the generated list-message module supplies names); colors are numeric
+ * COLOUR_* indices as upstream.
+ *
+ * Not ported here: message_lookup_by_name / by_sound_name (they need the
+ * generated list-message table; they land with the pref-file loader).
+ * C's printf-style formatting is dropped; callers use template strings.
+ */
+import { colorCharToAttr, COLOUR_DARK, COLOUR_WHITE } from "./color.js";
+import { MSG } from "./generated/message.js";
+/** MSG_GENERIC: the default message type (index 0 of list-message.h). */
+export const MSG_GENERIC = 0;
+/**
+ * message.prf:103,115,196: these are the three non-white default message
+ * colours. All other listed defaults are `w`, so message.c:269-285's white
+ * fallback gives the same result without duplicating a 100-line table.
+ */
+const DEFAULT_MESSAGE_COLORS = new Map([
+    [MSG.BELL, colorCharToAttr("o")],
+    [MSG.HITPOINT_WARN, colorCharToAttr("o")],
+    [MSG.AFRAID, colorCharToAttr("o")],
+]);
+/** The rolling message memory (msgqueue_t). */
+export class MessageLog {
+    max;
+    /** Newest first, index 0 = age 0 (upstream walks head -> older). */
+    entries = [];
+    // message.c:269-285: message types start with their loaded defaults and
+    // an explicit COLOUR_DARK remains the unset/white sentinel.
+    colors = new Map(DEFAULT_MESSAGE_COLORS);
+    constructor(max = 2048) {
+        this.max = max;
+    }
+    /** messages_num. */
+    num() {
+        return this.entries.length;
+    }
+    /**
+     * message_add: append, or bump the count when identical to the newest
+     * entry (count saturates at 0xFFFF exactly like the uint16_t check).
+     */
+    add(str, type) {
+        const head = this.entries[0];
+        if (head && head.type === type && head.str === str && head.count !== 0xffff) {
+            head.count++;
+            return;
+        }
+        this.entries.unshift({ str, type, count: 1 });
+        if (this.entries.length > this.max)
+            this.entries.pop();
+    }
+    /** message_str: text of the message of the given age ("" if absent). */
+    str(age) {
+        return this.entries[age]?.str ?? "";
+    }
+    /** message_count: repeat count of the message of the given age. */
+    count(age) {
+        return this.entries[age]?.count ?? 0;
+    }
+    /** message_type. */
+    type(age) {
+        return this.entries[age]?.type ?? 0;
+    }
+    /** message_color. */
+    color(age) {
+        const e = this.entries[age];
+        return e ? this.typeColor(e.type) : COLOUR_WHITE;
+    }
+    /** message_color_define. */
+    colorDefine(type, color) {
+        this.colors.set(type, color);
+    }
+    /** message_type_color: COLOUR_DARK means "unset" and yields white. */
+    typeColor(type) {
+        const c = this.colors.get(type);
+        return c !== undefined && c !== COLOUR_DARK ? c : COLOUR_WHITE;
+    }
+}
+/** MSG_BELL index in list-message.h; bell() signals with this type. */
+export const MSG_BELL = MSG.BELL;
+/**
+ * The msg()/msgt()/sound()/bell() facade: adds to the log and signals the
+ * event bus, honoring the use_sound option via an injected getter.
+ */
+export class Messages {
+    log;
+    events;
+    soundEnabled;
+    constructor(log, events, soundEnabled = () => false) {
+        this.log = log;
+        this.events = events;
+        this.soundEnabled = soundEnabled;
+    }
+    /** msg: log with MSG_GENERIC and signal EVENT_MESSAGE. */
+    msg(text) {
+        this.log.add(text, MSG_GENERIC);
+        this.events.emit("message", { msg: text, type: MSG_GENERIC });
+    }
+    /** msgt: log with a type, make the type's sound, signal EVENT_MESSAGE. */
+    msgt(type, text) {
+        this.log.add(text, type);
+        this.sound(type);
+        this.events.emit("message", { msg: text, type });
+    }
+    /**
+     * sound: EVENT_SOUND only, gated by the use_sound option. The payload's
+     * message is null, not "" -- message.c:374 passes NULL.
+     */
+    sound(type) {
+        if (!this.soundEnabled())
+            return;
+        this.events.emit("sound", { msg: null, type });
+    }
+    /** bell: EVENT_BELL, likewise with a NULL message (message.c:381). */
+    bell() {
+        this.events.emit("bell", { msg: null, type: MSG_BELL });
+    }
+}
+//# sourceMappingURL=msg.js.map

package/dist/msg.js.map

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

package/dist/obj/artifact-fake.d.ts

@@ -0,0 +1,39 @@
+/**
+ * make_fake_artifact (obj-make.c L728-745): build a throwaway artifact object
+ * directly from a blank object, used purely to DESCRIBE an artifact - the
+ * artifact-knowledge recall (desc_art_fake, ui-knowledge.c L1610-1654) and the
+ * spoiler dumps. As upstream warns, the result is in no way marked "fake", so
+ * it must NEVER become a live game object.
+ *
+ * DETERMINISM (the reason this lives in one place): object_prep with the
+ * "maximise" aspect draws no entropy, but copy_artifact_data's copy_curses step
+ * ALWAYS rolls the curse timeout on the "randomise" aspect regardless of the
+ * caller's aspect (obj-curse.c L67, ported faithfully in copyCurses). A
+ * browsing preview must not perturb the shared game RNG stream, so this builder
+ * draws from a DEDICATED throwaway Rng (a fresh Rng at a fixed seed), never the
+ * game stream. The fixed seed also makes the same artifact preview identically
+ * every time it is browsed.
+ *
+ * Attribution: neostryder / RPGM Tools.
+ */
+import type { Constants } from "../constants.js";
+import type { ObjRegistry } from "./bind.js";
+import type { GameObject } from "./object.js";
+import type { Artifact } from "./types.js";
+/**
+ * The fixed seed for the throwaway prep Rng. object_prep(maximise) consumes no
+ * entropy and copy_artifact_data draws only the curse timeout, so a constant
+ * seed yields a stable, game-RNG-independent preview.
+ */
+export declare const FAKE_ARTIFACT_SEED = 1;
+/**
+ * make_fake_artifact(obj, artifact) (obj-make.c L728): look up the base kind,
+ * object_prep it with the MAXIMISE aspect, stamp on the artifact, then
+ * copy_artifact_data. Returns null when the artifact has no tval or its base
+ * kind is missing (upstream returns false - L733, L737).
+ *
+ * The build uses its own throwaway Rng (see the module note); the caller's game
+ * RNG stream is never touched.
+ */
+export declare function makeFakeArtifact(reg: ObjRegistry, constants: Constants, art: Artifact, seed?: number): GameObject | null;
+//# sourceMappingURL=artifact-fake.d.ts.map

package/dist/obj/artifact-fake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-fake.d.ts","sourceRoot":"","sources":["../../src/obj/artifact-fake.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,QAAQ,EACb,IAAI,GAAE,MAA2B,GAChC,UAAU,GAAG,IAAI,CAenB"}

package/dist/obj/artifact-fake.js

@@ -0,0 +1,52 @@
+/**
+ * make_fake_artifact (obj-make.c L728-745): build a throwaway artifact object
+ * directly from a blank object, used purely to DESCRIBE an artifact - the
+ * artifact-knowledge recall (desc_art_fake, ui-knowledge.c L1610-1654) and the
+ * spoiler dumps. As upstream warns, the result is in no way marked "fake", so
+ * it must NEVER become a live game object.
+ *
+ * DETERMINISM (the reason this lives in one place): object_prep with the
+ * "maximise" aspect draws no entropy, but copy_artifact_data's copy_curses step
+ * ALWAYS rolls the curse timeout on the "randomise" aspect regardless of the
+ * caller's aspect (obj-curse.c L67, ported faithfully in copyCurses). A
+ * browsing preview must not perturb the shared game RNG stream, so this builder
+ * draws from a DEDICATED throwaway Rng (a fresh Rng at a fixed seed), never the
+ * game stream. The fixed seed also makes the same artifact preview identically
+ * every time it is browsed.
+ *
+ * Attribution: neostryder / RPGM Tools.
+ */
+import { Rng } from "../rng.js";
+import { copyArtifactData, objectPrep } from "./make.js";
+/**
+ * The fixed seed for the throwaway prep Rng. object_prep(maximise) consumes no
+ * entropy and copy_artifact_data draws only the curse timeout, so a constant
+ * seed yields a stable, game-RNG-independent preview.
+ */
+export const FAKE_ARTIFACT_SEED = 1;
+/**
+ * make_fake_artifact(obj, artifact) (obj-make.c L728): look up the base kind,
+ * object_prep it with the MAXIMISE aspect, stamp on the artifact, then
+ * copy_artifact_data. Returns null when the artifact has no tval or its base
+ * kind is missing (upstream returns false - L733, L737).
+ *
+ * The build uses its own throwaway Rng (see the module note); the caller's game
+ * RNG stream is never touched.
+ */
+export function makeFakeArtifact(reg, constants, art, seed = FAKE_ARTIFACT_SEED) {
+    /* Don't bother with empty artifacts (L733). */
+    if (!art.tval)
+        return null;
+    /* Get the "kind" index (L736). */
+    const kind = reg.lookupKind(art.tval, art.sval);
+    if (!kind)
+        return null;
+    /* Create the artifact on a dedicated throwaway stream (L740-742). */
+    const rng = new Rng(seed);
+    const obj = objectPrep(rng, reg, constants, kind, 0, "maximise");
+    obj.artifact = art;
+    copyArtifactData(rng, reg, obj, art);
+    obj.number = 1;
+    return obj;
+}
+//# sourceMappingURL=artifact-fake.js.map

package/dist/obj/artifact-fake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-fake.js","sourceRoot":"","sources":["../../src/obj/artifact-fake.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEhC,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAIzD;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAEpC;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAAgB,EAChB,SAAoB,EACpB,GAAa,EACb,OAAe,kBAAkB;IAEjC,+CAA+C;IAC/C,IAAI,CAAC,GAAG,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAE3B,kCAAkC;IAClC,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,qEAAqE;IACrE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;IACjE,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC;IACnB,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IACrC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;IACf,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/obj/artifact-known.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Artifact-knowledge gating for the "known artifacts" browser, ported from
+ * find_artifact (reference/src/ui-knowledge.c L1537-1610), object_is_known_
+ * artifact (obj-knowledge.c L552-556) and artifact_is_known (ui-knowledge.c
+ * L1687-1707) of Angband 4.2.6.
+ *
+ * The point of the gate is to never leak an artifact the player has not yet
+ * identified: an artifact is only "known" once it has been created AND there is
+ * no live, still-unidentified copy of it anywhere in the world. Wizard mode
+ * reveals everything.
+ *
+ * Attribution: neostryder / RPGM Tools.
+ */
+import type { GameObject } from "./object.js";
+import type { Artifact } from "./types.js";
+/**
+ * object_is_known_artifact for a LIVE object (obj-knowledge.c L552): upstream
+ * reads obj->known->artifact, which objectKnownShadow (known-object.ts L512)
+ * sets to obj->artifact only when the object is ASSESSED (touched / picked up).
+ * So for a live object this is exactly "it is an artifact and it has been
+ * assessed" - computed here without building a full known shadow.
+ */
+export declare function liveObjectIsKnownArtifact(obj: GameObject): boolean;
+/** The world-scan + created-flags view artifact_is_known needs. */
+export interface ArtifactKnownEnv {
+    /**
+     * Every live object find_artifact scans (ui-knowledge.c L1537): floor piles,
+     * player gear, monster-held objects, store stock and stored (cached) level
+     * chunks. Order does not matter - a fixed artifact has at most one live copy.
+     */
+    worldObjects(): Iterable<GameObject>;
+    /** is_artifact_created(art) (obj-util.c): the per-game created flag. */
+    isCreated(aidx: number): boolean;
+    /** player->wizard: wizard mode reveals every artifact. */
+    wizard: boolean;
+}
+/**
+ * find_artifact (ui-knowledge.c L1537-1610): the live object that is this
+ * artifact, or null if no copy exists in the world right now.
+ */
+export declare function findArtifact(env: ArtifactKnownEnv, aidx: number): GameObject | null;
+/**
+ * artifact_is_known (ui-knowledge.c L1687-1707): should the browser list this
+ * artifact? Requires a name; wizard mode always yes; otherwise it must be
+ * created, and if a live copy exists it must already be identified as an
+ * artifact (else the copy is a not-yet-found artifact and listing it would
+ * leak it).
+ */
+export declare function artifactIsKnown(art: Artifact, env: ArtifactKnownEnv): boolean;
+//# sourceMappingURL=artifact-known.d.ts.map

package/dist/obj/artifact-known.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-known.d.ts","sourceRoot":"","sources":["../../src/obj/artifact-known.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAElE;AAED,mEAAmE;AACnE,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,YAAY,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC;IACrC,wEAAwE;IACxE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACjC,0DAA0D;IAC1D,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAKnF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAO7E"}

package/dist/obj/artifact-known.js

@@ -0,0 +1,55 @@
+/**
+ * Artifact-knowledge gating for the "known artifacts" browser, ported from
+ * find_artifact (reference/src/ui-knowledge.c L1537-1610), object_is_known_
+ * artifact (obj-knowledge.c L552-556) and artifact_is_known (ui-knowledge.c
+ * L1687-1707) of Angband 4.2.6.
+ *
+ * The point of the gate is to never leak an artifact the player has not yet
+ * identified: an artifact is only "known" once it has been created AND there is
+ * no live, still-unidentified copy of it anywhere in the world. Wizard mode
+ * reveals everything.
+ *
+ * Attribution: neostryder / RPGM Tools.
+ */
+import { OBJ_NOTICE } from "./knowledge.js";
+/**
+ * object_is_known_artifact for a LIVE object (obj-knowledge.c L552): upstream
+ * reads obj->known->artifact, which objectKnownShadow (known-object.ts L512)
+ * sets to obj->artifact only when the object is ASSESSED (touched / picked up).
+ * So for a live object this is exactly "it is an artifact and it has been
+ * assessed" - computed here without building a full known shadow.
+ */
+export function liveObjectIsKnownArtifact(obj) {
+    return obj.artifact !== null && (obj.notice & OBJ_NOTICE.ASSESSED) !== 0;
+}
+/**
+ * find_artifact (ui-knowledge.c L1537-1610): the live object that is this
+ * artifact, or null if no copy exists in the world right now.
+ */
+export function findArtifact(env, aidx) {
+    for (const obj of env.worldObjects()) {
+        if (obj.artifact && obj.artifact.aidx === aidx)
+            return obj;
+    }
+    return null;
+}
+/**
+ * artifact_is_known (ui-knowledge.c L1687-1707): should the browser list this
+ * artifact? Requires a name; wizard mode always yes; otherwise it must be
+ * created, and if a live copy exists it must already be identified as an
+ * artifact (else the copy is a not-yet-found artifact and listing it would
+ * leak it).
+ */
+export function artifactIsKnown(art, env) {
+    if (!art.name)
+        return false;
+    if (env.wizard)
+        return true;
+    if (!env.isCreated(art.aidx))
+        return false;
+    const obj = findArtifact(env, art.aidx);
+    if (obj && !liveObjectIsKnownArtifact(obj))
+        return false;
+    return true;
+}
+//# sourceMappingURL=artifact-known.js.map

package/dist/obj/artifact-known.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-known.js","sourceRoot":"","sources":["../../src/obj/artifact-known.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAI5C;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,GAAe;IACvD,OAAO,GAAG,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC3E,CAAC;AAgBD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAqB,EAAE,IAAY;IAC9D,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,YAAY,EAAE,EAAE,CAAC;QACrC,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI;YAAE,OAAO,GAAG,CAAC;IAC7D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,GAAa,EAAE,GAAqB;IAClE,IAAI,CAAC,GAAG,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IAC5B,IAAI,GAAG,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC5B,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,GAAG,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACzD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/obj/bind.d.ts

@@ -0,0 +1,219 @@
+/**
+ * Object registries: binding the compiled pack JSON into typed data,
+ * ported from reference/src/obj-init.c (all the object-domain parsers and
+ * their finish steps), datafile.c (grab_flag, grab_rand_value,
+ * grab_int_value, grab_index_and_int, grab_int_range, grab_element_flag),
+ * obj-tval.c (tval_find_idx), obj-util.c (lookup_kind, lookup_sval), and
+ * obj-desc.c (obj_desc_name_format, used for sval name matching).
+ *
+ * Ordering follows upstream init_arrays: bases, slays, brands, curses,
+ * objects, activations, egos, artifacts, properties, flavors. Faithful
+ * index quirks are kept: kinds/egos are 0-based in file order
+ * (kidx/eidx), artifacts and object properties are 1-based in file
+ * order, while slays, brands, curses, and activations are 1-based in
+ * REVERSE file order (upstream walks the prepended parse list from its
+ * head while counting up).
+ *
+ * Sval assignment mirrors parse_object_type: each kind bumps its base's
+ * num_svals as its type: line is bound, in file order, and takes that
+ * count as its sval. Special artifacts whose base-object sval does not
+ * exist get a dummy kind appended (write_dummy_object_record) with
+ * KF_INSTA_ART, inheriting the base's flags; its level is 0 at creation
+ * time because upstream reads art->level before the level: line has been
+ * parsed.
+ *
+ * MODDABILITY (ratified pillar): every bind step is driven purely by the
+ * record arrays passed in; appending extra records in the same compiled
+ * shape (new kinds, egos, artifacts, curses, ...) binds them exactly like
+ * pack data.
+ */
+import type { RandomValue } from "../rng.js";
+import type { Activation, Artifact, Brand, Curse, EgoItem, ElementInfo, Flavor, ObjectBase, ObjectKind, ObjectProperty, ObjPackJson, Slay } from "./types.js";
+/** obj_mods[]: the five stats then the object modifiers, index = value. */
+export declare const OBJ_MOD_NAMES: readonly string[];
+/** element_names[]: index = ELEM value. */
+export declare const ELEMENT_NAMES: readonly string[];
+/**
+ * dice string or plain number -> RandomValue (parser_getrand / parse_random,
+ * parser.c:126-213).
+ *
+ * The negation is NOT dice negation, and getting it wrong is a live gameplay
+ * divergence. `parse_random` strips a leading '-', parses the remainder as a
+ * POSITIVE value, and only then adjusts (parser.c:207-211):
+ *
+ *     base *= -1;  base -= m_bonus;  base -= dice * (sides + 1);
+ *
+ * with the reason stated there: "the random components are always positive, so
+ * the base must be adjusted as necessary". The base is shifted down far enough
+ * that `base + XdY` spans the NEGATION of the positive interval.
+ * Dice.parseString instead binds the '-' to the base token alone, which leaves
+ * the random part pointing the wrong way.
+ *
+ * Reachable in shipped 4.2.6 data: ego_item.txt:692, "of Backbiting", carries
+ * `combat:-26+d25:-26+d25:0`. Upstream yields base -52, dice 1, sides 25, i.e.
+ * to_h/to_d in -51..-27; binding the sign to the base alone yields -26 + 1d25,
+ * i.e. -25..-1, an ego roughly half as punishing as upstream's.
+ */
+export declare function parseRand(value: string | number | undefined): RandomValue;
+export declare function grabIntRange(range: string): [number, number];
+/**
+ * grab_rand_value: "STR[1d2]" -> parse the bracket as dice and store its
+ * random value at the name's index. Returns true when the name matched.
+ */
+export declare function grabRandValue(values: RandomValue[], names: readonly string[], token: string): boolean;
+/**
+ * grab_int_value: "SPEED[10]" -> store the int at the name's index.
+ * Returns true when the name matched.
+ */
+export declare function grabIntValue(values: number[], names: readonly string[], token: string): boolean;
+/**
+ * grab_index_and_int with a prefix: "RES_ACID[1]" against element names
+ * and prefix "RES_" -> { index, value }, or null when no name matches.
+ */
+export declare function grabIndexAndInt(names: readonly string[], prefix: string, token: string): {
+    index: number;
+    value: number;
+} | null;
+/**
+ * grab_element_flag: "IGNORE_ACID" / "HATES_FIRE" -> set the EL_INFO
+ * bit on the named element. Returns true when handled.
+ */
+export declare function grabElementFlag(elInfo: ElementInfo[], flagName: string): boolean;
+/**
+ * tval_find_idx: the numeric tval of a textual tval name (or a numeric
+ * string), -1 when unknown.
+ */
+export declare function tvalFindIdx(name: string): number;
+/** tval_find_name: textual name for a numeric tval. */
+export declare function tvalFindName(tval: number): string;
+/**
+ * obj_desc_name_format with a null modstr: strips '&' (and spaces after
+ * it), drops '~' (singular), picks the singular side of "|sing|plur|".
+ */
+export declare function objDescNameFormat(fmt: string): string;
+/**
+ * All object-domain registries, bound from the compiled pack JSON.
+ *
+ * Arrays with 1-based upstream indexing (slays, brands, curses,
+ * activations, artifacts, properties) keep a null at index 0.
+ */
+export declare class ObjRegistry {
+    /** kb_info: bases indexed by tval (missing tvals get a default base). */
+    readonly bases: ObjectBase[];
+    /** k_info in kidx order; ordinary kinds then INSTA_ART dummies. */
+    readonly kinds: ObjectKind[];
+    /** Count of ordinary kinds (before artifact dummy kinds). */
+    ordinaryKindCount: number;
+    /** e_info in eidx order. */
+    readonly egos: EgoItem[];
+    /** a_info, 1-based (index 0 is null). */
+    readonly artifacts: (Artifact | null)[];
+    /** curses, 1-based, reverse file order (upstream quirk). */
+    readonly curses: (Curse | null)[];
+    /** brands, 1-based, reverse file order (upstream quirk). */
+    readonly brands: (Brand | null)[];
+    /** slays, 1-based, reverse file order (upstream quirk). */
+    readonly slays: (Slay | null)[];
+    /** activations, 1-based, reverse file order (upstream quirk). */
+    readonly activations: (Activation | null)[];
+    /** obj_properties, 1-based, file order. */
+    readonly properties: (ObjectProperty | null)[];
+    /** Flat flavor list in file order. */
+    readonly flavors: Flavor[];
+    unknownItemKind: ObjectKind | null;
+    unknownGoldKind: ObjectKind | null;
+    pileKind: ObjectKind | null;
+    curseObjectKind: ObjectKind | null;
+    /** z_info->brand_max (array length including the null slot). */
+    get brandMax(): number;
+    /** z_info->slay_max. */
+    get slayMax(): number;
+    /** z_info->curse_max. */
+    get curseMax(): number;
+    constructor(pack: ObjPackJson);
+    /** lookup_kind: kind by tval and sval, or null. */
+    lookupKind(tval: number, sval: number): ObjectKind | null;
+    /** objkind_byid. */
+    kindByIdx(kidx: number): ObjectKind | null;
+    /**
+     * lookup_sval: sval of the kind whose formatted name matches (case
+     * insensitively), or a numeric string passed through; -1 when unknown.
+     */
+    lookupSval(tval: number, name: string): number;
+    /** lookup_curse: 1-based curse index by name, or 0. */
+    lookupCurse(name: string): number;
+    /** Brand index by code, or 0. */
+    lookupBrand(code: string): number;
+    /** Slay index by code, or 0. */
+    lookupSlay(code: string): number;
+    /** findact: activation by name, or null. */
+    findActivation(name: string): Activation | null;
+    /** Ego by exact name, or null (test/mod convenience). */
+    findEgo(name: string): EgoItem | null;
+    /** Artifact by exact name, or null (test/mod convenience). */
+    findArtifact(name: string): Artifact | null;
+    /**
+     * lookup_artifact_name (obj-util.c L520): the artifact whose name EQUALS
+     * `name`, else the first artifact whose name CONTAINS `name`
+     * case-insensitively (only when `name` is at least 3 characters). Backs the
+     * wizard-mode "Enter new artifact:" prompt's name branch (cmd-wizard.c L2798),
+     * so `narthanc` and `hanc` both resolve.
+     *
+     * Two upstream warts are reproduced deliberately:
+     * - the exact-match test runs inside the same loop, so an exact match on a
+     *   LATER artifact still wins over an earlier substring match;
+     * - the close-match result is returned only when `a_idx > 0` (L540), so a
+     *   substring hit at index 0 yields NULL. Here index 0 is the reserved null
+     *   artifact, which makes the wart inert - but the `> 0` bound is kept.
+     */
+    lookupArtifactName(name: string): Artifact | null;
+    /**
+     * lookup_ego_item (obj-util.c L549): the ego of exactly this `name` that can
+     * be applied to the kind with `tval`/`sval`. Backs the wizard-mode "Enter ego
+     * item:" prompt's name branch (cmd-wizard.c L2752). Unlike the artifact
+     * lookup this is EXACT-name only, and an ego whose poss_items list does not
+     * hold the kind is skipped even when the name matches.
+     */
+    lookupEgoItem(name: string, tval: number, sval: number): EgoItem | null;
+    private bindBases;
+    private bindSlays;
+    private bindBrands;
+    /**
+     * parse_curse_weight (obj-init.c) refuses an adjustment that will not fit in
+     * the int16_t it is stored in: `< -32768 || > 32767` is
+     * PARSE_ERROR_INVALID_VALUE (curse.c test_weight_bad0 plants 32769 and
+     * -32780). Negative-with-MULTIPLY_WEIGHT is a separate finalize-time check
+     * upstream and is not this one.
+     */
+    private static curseWeight;
+    private bindCurses;
+    private bindKinds;
+    private bindBrandList;
+    private bindSlayList;
+    private bindCurseList;
+    private bindActivations;
+    private bindEgos;
+    /**
+     * write_dummy_object_record: append an INSTA_ART kind for a special
+     * artifact base object that has no ordinary kind.
+     */
+    private writeDummyObjectRecord;
+    private bindArtifacts;
+    private bindProperties;
+    private bindFlavors;
+    private finish;
+}
+/** Assemble the ObjPackJson bundle from individually parsed pack files. */
+export declare function objPackFromJson(parts: {
+    objectBase: unknown;
+    object: unknown;
+    egoItem: unknown;
+    artifact: unknown;
+    curse: unknown;
+    brand: unknown;
+    slay: unknown;
+    activation: unknown;
+    objectProperty: unknown;
+    flavor: unknown;
+}): ObjPackJson;
+//# sourceMappingURL=bind.d.ts.map

package/dist/obj/bind.d.ts.map

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