@rpgm-tools/neo-angband-core 0.10.0

package/dist/obj/knowledge.d.ts

@@ -0,0 +1,520 @@
+/**
+ * The player's object-knowledge (the "rune" learning system), ported from
+ * reference/src/obj-knowledge.c (Angband 4.2.6).
+ *
+ * The learn-by-use half is fully ported: runes are learned on wield
+ * (object_learn_on_wield), on attack and defend (equip_learn_on_melee_attack /
+ * _ranged_attack / _on_defend, missile_learn_on_ranged_attack), when a flag or
+ * element fires in play (equip_learn_flag / equip_learn_element), over time
+ * (equip_learn_after_time), from brands/slays biting a monster
+ * (player_learn_brand/slay via combat/brand-slay.ts), plus the racial innates
+ * at birth (player_learn_innate) and the learn-everything wizard ramp
+ * (player_learn_all_runes).
+ *
+ * The modifier runes gate REAL play: calc_bonuses (player-calcs.c L1942-1981)
+ * multiplies every equipped item's modifier by p->obj_k->modifiers, so an
+ * unlearned modifier is INERT. Flags, resists, and the to_a/to_h/to_d combat
+ * bonuses always apply for the real state and their runes feed the DISPLAYED
+ * known_state (character sheet / inspect), which lands with the display task;
+ * the knowledge itself is tracked here exactly as upstream so the display
+ * work is pure presentation.
+ *
+ * DEFERRED (ledgered in parity/ledger/obj-knowledge.yaml): the per-object
+ * obj->known twin (display-only shadow copies: "had a chance to notice"
+ * markers, object_fully_known short-circuits, update_player_object_knowledge's
+ * gear/store sweep), rune inscriptions (rune_note), monster-lore learning from
+ * brands/slays (lore is #24), and shapechange learning (shapes are bound raw).
+ */
+import { FlagSet } from "../bitflag.js";
+import type { RandomValue } from "../rng.js";
+import type { GameObject } from "./object.js";
+import type { Brand, Curse, EgoItem, ObjectKind, ObjectProperty, Slay } from "./types.js";
+import type { Player } from "../player/player.js";
+/** obj->notice bits (object.h). */
+export declare const OBJ_NOTICE: {
+    readonly WORN: 1;
+    readonly ASSESSED: 2;
+    readonly IGNORE: 4;
+    readonly IMAGINED: 8;
+};
+/**
+ * The registry tables and equipment access rune learning reads. Built once
+ * per game (session/game.ts wireGame) from the bound registries; the harness
+ * provides an inert default for worldless tests.
+ */
+export interface RuneEnv {
+    brands: readonly (Brand | null)[];
+    slays: readonly (Slay | null)[];
+    curses: readonly (Curse | null)[];
+    properties: readonly (ObjectProperty | null)[];
+    /** Element rune names (upstream projections[i].name: "acid", ...). */
+    elementNames: readonly string[];
+    /** slot_object(p, i): the equipped object in body slot i, or null. */
+    slotObject(slot: number): GameObject | null;
+    /** randcalc_varies, for object_has_standard_to_h on body armor. */
+    randcalcVaries(v: RandomValue): boolean;
+    /** Flavor knowledge, for object_flavor_tried on wield. */
+    flavor?: FlavorKnowledge;
+    /** msg() sink for rune / flag / modifier messages. */
+    msg?(text: string): void;
+}
+/** Optional registry tables for makeRuneEnv (inert defaults when absent). */
+export interface RuneEnvTables {
+    brands?: readonly (Brand | null)[];
+    slays?: readonly (Slay | null)[];
+    curses?: readonly (Curse | null)[];
+    properties?: readonly (ObjectProperty | null)[];
+    elementNames?: readonly string[];
+    flavor?: FlavorKnowledge;
+    msg?(text: string): void;
+}
+/**
+ * Assemble a RuneEnv from equipment access plus whatever registry tables the
+ * caller has; missing tables default to empty (learning against them is a
+ * no-op), which keeps worldless harness tests total.
+ */
+export declare function makeRuneEnv(slotObject: (slot: number) => GameObject | null, randcalcVaries: (v: RandomValue) => boolean, tables?: RuneEnvTables): RuneEnv;
+/** ODESC_BASE approximation until object_desc lands: the kind's plain name. */
+export declare function objBaseName(obj: GameObject): string;
+/** player_knows_brand. */
+export declare function playerKnowsBrand(p: Player, i: number): boolean;
+/** player_knows_slay. */
+export declare function playerKnowsSlay(p: Player, i: number): boolean;
+/** player_knows_curse. */
+export declare function playerKnowsCurse(p: Player, i: number): boolean;
+/** RUNE_VAR_COMBAT: learn one of the three combat runes. */
+export declare function playerLearnCombat(p: Player, env: RuneEnv, which: "toA" | "toH" | "toD", message?: boolean): boolean;
+/** RUNE_VAR_MOD: learn a modifier rune. */
+export declare function playerLearnMod(p: Player, env: RuneEnv, i: number, message?: boolean): boolean;
+/** RUNE_VAR_RESIST: learn an element rune (high elements only, as the list). */
+export declare function playerLearnResist(p: Player, env: RuneEnv, elem: number, message?: boolean): boolean;
+/** RUNE_VAR_FLAG: learn an object-flag rune. */
+export declare function playerLearnFlagRune(p: Player, env: RuneEnv, flag: number, message?: boolean): boolean;
+/**
+ * RUNE_VAR_BRAND: learn a brand rune; all brands sharing the name are learned
+ * together (a rune covers "fire" whatever the multiplier).
+ */
+export declare function playerLearnBrand(p: Player, env: RuneEnv, index: number, message?: boolean): boolean;
+/**
+ * RUNE_VAR_SLAY: learn a slay rune; all slays hitting the same monsters
+ * (same_monsters_slain) are learned together.
+ */
+export declare function playerLearnSlay(p: Player, env: RuneEnv, index: number, message?: boolean): boolean;
+/** RUNE_VAR_CURSE: learn a curse rune. */
+export declare function playerLearnCurse(p: Player, env: RuneEnv, index: number, message?: boolean): boolean;
+/**
+ * create_obj_flag_mask(f, true, id, OFT_MAX): every OF_* flag whose property
+ * has the given OFID_* identify type.
+ */
+export declare function objFlagMaskById(env: RuneEnv, id: number): FlagSet;
+/**
+ * player_outfit's obvious-flag knowledge (player-birth.c L597-602): at birth the
+ * player knows every LIGHT / DIG / THROW / CURSE_ONLY subtype object flag. These
+ * are the non-rune "on wield" flags (init_rune skips their subtypes), so without
+ * this a mundane torch / digger / thrown item would read as not-fully-known and
+ * show a spurious "{??}" in stores and lists. Marking them known here makes such
+ * items fully known the moment they are seen, exactly as upstream. Mutates the
+ * passed flag set in place.
+ */
+export declare function learnBirthObviousFlags(known: FlagSet, properties: readonly (ObjectProperty | null)[]): void;
+/** sustain_flag(stat): the OF_SUST_* flag for a stat (contiguous block). */
+export declare function sustainFlag(stat: number): number;
+/**
+ * object_has_standard_to_h: body armor with a fixed kind to_h matches the
+ * kind's base; anything else is standard only at to_h == 0.
+ */
+export declare function objectHasStandardToH(env: RuneEnv, obj: GameObject): boolean;
+export declare function objectCursesFindToA(p: Player, env: RuneEnv, obj: GameObject): void;
+export declare function objectCursesFindToH(p: Player, env: RuneEnv, obj: GameObject): void;
+export declare function objectCursesFindToD(p: Player, env: RuneEnv, obj: GameObject): void;
+/** object_curses_find_flags: learn test-mask flags carried by curses. */
+export declare function objectCursesFindFlags(p: Player, env: RuneEnv, obj: GameObject, testFlags: FlagSet): boolean;
+/** object_curses_find_modifiers: learn modifier runes carried by curses. */
+export declare function objectCursesFindModifiers(p: Player, env: RuneEnv, obj: GameObject): void;
+/** object_curses_find_element: learn an element rune carried by curses. */
+export declare function objectCursesFindElement(p: Player, env: RuneEnv, obj: GameObject, elem: number): boolean;
+/**
+ * object_learn_on_wield (obj-knowledge.c L1820): learn the properties that
+ * become obvious the moment an item is worn or wielded - the obvious
+ * (OFID_WIELD) flags with sustains promoted to obvious on stat items, every
+ * modifier, and anything the item's curses supply. Guarded by the
+ * OBJ_NOTICE_WORN bit and marks flavored wearables tried.
+ *
+ * Without an env (worldless callers, e.g. unit tests that only exercise the
+ * calc_bonuses gate) only the modifier runes are learned, which is the whole
+ * real-play effect.
+ */
+export declare function objectLearnOnWield(player: Player, obj: GameObject, env?: RuneEnv): void;
+/**
+ * missile_learn_on_ranged_attack: firing teaches the to-hit rune (when the
+ * missile or launcher is off-standard) and the to-dam rune.
+ */
+export declare function missileLearnOnRangedAttack(p: Player, env: RuneEnv, obj: GameObject): void;
+/** equip_learn_on_defend: being hit teaches the to-armor rune. */
+export declare function equipLearnOnDefend(p: Player, env: RuneEnv): void;
+/**
+ * equip_learn_on_ranged_attack: firing teaches the to-hit rune from any
+ * off-standard equipment except the weapon and launcher.
+ */
+export declare function equipLearnOnRangedAttack(p: Player, env: RuneEnv): void;
+/**
+ * equip_learn_on_melee_attack: attacking teaches the to-hit and to-dam runes
+ * from any off-standard equipment except the launcher.
+ */
+export declare function equipLearnOnMeleeAttack(p: Player, env: RuneEnv): void;
+/**
+ * equip_learn_flag: a flag fired in play; learn its rune from any equipped
+ * item carrying it (with the flag_message), including via curses.
+ */
+export declare function equipLearnFlag(p: Player, env: RuneEnv, flag: number): void;
+/**
+ * equip_learn_element: an element hit the player; learn its rune from any
+ * equipped item affecting it (with the glow message), including via curses.
+ */
+export declare function equipLearnElement(p: Player, env: RuneEnv, element: number): void;
+/**
+ * shape_learn_on_assume (L1892): on taking a shape, learn its obvious
+ * (OFID_WIELD) flags and its resists, through the same equipment learn
+ * calls upstream uses.
+ */
+export declare function shapeLearnOnAssume(p: Player, env: RuneEnv, shape: import("../player/types.js").Shape): void;
+/**
+ * equip_learn_after_time: learn the timed (OFID_TIMED) flags the equipment
+ * carries; called every 100 game turns from process_world.
+ */
+export declare function equipLearnAfterTime(p: Player, env: RuneEnv): void;
+/** player_learn_innate: know the racial element and flag runes at birth. */
+export declare function playerLearnInnate(p: Player, env: RuneEnv): void;
+/** player_learn_all_runes: learn absolutely everything (wizard mode). */
+export declare function playerLearnAllRunes(p: Player, env: RuneEnv): void;
+/** enum rune_variety. */
+export type RuneVariety = "combat" | "mod" | "resist" | "brand" | "slay" | "curse" | "flag";
+/** struct rune, resolved: a variety, its per-variety index, and a name. */
+export interface Rune {
+    variety: RuneVariety;
+    index: number;
+    name: string;
+}
+/**
+ * init_rune: build the rune list in the exact upstream order - combat,
+ * modifiers, high elements, brands (first of each name), slays (first of
+ * each same-monsters group), named curses, then the identifiable flags
+ * (subtypes NONE / LIGHT / DIG / THROW / CURSE_ONLY excluded).
+ */
+export declare function buildRuneList(env: RuneEnv): Rune[];
+/**
+ * rune_desc (obj-knowledge.c L344-403): the recall description of a rune. The
+ * text is computed per variety (no per-rune desc field in the data pack), so
+ * this ports the C switch verbatim. Combat runes have fixed strings keyed by
+ * COMBAT_RUNE_TO_A/H/D (obj-knowledge.h L35-37); curse runes read the curse's
+ * own desc (curses[index].desc) formatted as "Object %s."; every other variety
+ * substitutes the rune's name into its template. Returns "" for an out-of-range
+ * curse (the C default falls through to NULL).
+ */
+export declare function runeDesc(env: RuneEnv, rune: Rune): string;
+/** player_knows_rune over the typed knowledge stores. */
+export declare function playerKnowsRune(p: Player, rune: Rune): boolean;
+/** object_has_rune. */
+export declare function objectHasRune(env: RuneEnv, obj: GameObject, rune: Rune): boolean;
+/**
+ * object_runes_known, reduced to the port's player-rune knowledge model:
+ * every rune the object carries is known to the player. (Upstream compares
+ * the obj->known twin, which is filled from the same rune knowledge.)
+ */
+export declare function objectRunesKnown(p: Player, env: RuneEnv, obj: GameObject, runes: readonly Rune[]): boolean;
+/** player_learn_rune dispatched by variety. */
+export declare function playerLearnRune(p: Player, env: RuneEnv, rune: Rune, message: boolean): boolean;
+/**
+ * object_find_unknown_rune: a random unknown rune carried by the object
+ * (upstream RNG: candidates gathered in list order, then randint0), or -1.
+ */
+export declare function objectFindUnknownRune(rng: {
+    randint0(m: number): number;
+}, p: Player, env: RuneEnv, obj: GameObject, runes: readonly Rune[]): number;
+/**
+ * object_learn_unknown_rune (obj-knowledge.c L1798): learn a random unknown
+ * rune from the object; with none left the object is marked assessed. Returns
+ * whether a rune was learned.
+ *
+ * Upstream both branches end in player_know_object (directly at L1806, or via
+ * player_learn_rune -> update_player_object_knowledge at L1811), which fires the
+ * object_flavor_aware side effect for the object. The port synthesises the
+ * known shadow on demand for display, so that awareness half is fired here (a
+ * knowledge-UPDATE site) via playerKnowObjectAwareness. `flavor` is optional so
+ * callers with no flavor environment (older tests) keep the bare rune-learn.
+ */
+export declare function objectLearnUnknownRune(rng: {
+    randint0(m: number): number;
+}, p: Player, env: RuneEnv, obj: GameObject, runes: readonly Rune[], flavor?: FlavorKnowledge, flavorDeps?: FlavorAwareDeps): boolean;
+/**
+ * Flavor awareness, ported from the kind->aware / kind->tried bits of
+ * reference/src/object.h and the accessors/setters in obj-knowledge.c
+ * (object_flavor_is_aware L2243, object_flavor_was_tried L2254,
+ * object_flavor_aware L2266, object_flavor_tried L2320).
+ *
+ * Upstream these two bits live on the shared object_kind template and are
+ * global to the running game. This port keeps them out of the immutable bound
+ * registry and in a per-game FlavorKnowledge, keyed by kind index (kidx), so a
+ * bound ObjRegistry stays reusable across games.
+ *
+ * "aware" means the player knows what a flavored kind does (has quaffed the
+ * potion, etc.); "tried" means a kind of that flavor has been used without the
+ * effect being learned. object_value and object_value_base read is_aware to
+ * decide between the real cost and a flat per-tval guess.
+ */
+/**
+ * The player-side side effects object_flavor_aware fires beyond flipping the
+ * aware bit (obj-knowledge.c L2276-2279). Injected so FlavorKnowledge stays
+ * decoupled from the ignore subsystem (obj/ignore.ts IgnoreSettings) and the
+ * player's upkeep, mirroring how the rest of the port threads deps. The
+ * gear/store base_known sweep and floor re-light are NOT here: the former is
+ * covered by the on-demand known shadow, the latter is a display concern (see
+ * FlavorKnowledge.objectFlavorAware).
+ */
+export interface FlavorAwareDeps {
+    /** kind_is_ignored_unaware(kind) (obj-ignore.c): ignored while unidentified? */
+    isIgnoredUnaware(kidx: number): boolean;
+    /** kind_ignore_when_aware(kind) (obj-ignore.c): carry the ignore bit over. */
+    ignoreWhenAware(kidx: number): void;
+    /** p->upkeep->notice |= PN_IGNORE: request an ignore re-check of the pack. */
+    requestIgnoreNotice(): void;
+}
+/**
+ * An inert FlavorAwareDeps for callers that have a FlavorKnowledge but no
+ * live ignore/notice environment (birth-time scripting, tests, or a caller
+ * that intentionally wants the bare aware-bit flip with none of the L2276-79
+ * side effects). Equivalent to the old bare setAware() call.
+ */
+export declare const NOOP_FLAVOR_AWARE_DEPS: FlavorAwareDeps;
+export declare class FlavorKnowledge {
+    private readonly ordinaryKindCount;
+    private readonly awareKidx;
+    private readonly triedKidx;
+    /**
+     * @param ordinaryKindCount z_info->ordinary_kind_max: kinds at or above this
+     * index are INSTA_ART dummies and are never marked tried.
+     */
+    constructor(ordinaryKindCount: number);
+    /**
+     * z_info->ordinary_kind_max: kinds at or above this index are special-artifact
+     * dummies (see obj-knowledge.c L1168's kidx >= ordinary_kind_max test).
+     */
+    get ordinaryKindMax(): number;
+    /** object_flavor_is_aware(obj): is the player aware of this kind's flavor? */
+    isAware(kind: ObjectKind): boolean;
+    /** object_flavor_was_tried(obj): has a kind of this flavor been tried? */
+    wasTried(kind: ObjectKind): boolean;
+    /**
+     * The aware-bit half of object_flavor_aware (L2272-2273): mark a kind's
+     * flavor known; returns true when this made a change. This is the pure
+     * primitive - it flips the bit and nothing else, so it is safe for birth
+     * aware-marking (flavor.ts) and savefile restore, which must NOT trigger the
+     * ignore re-check. Callers that are the player becoming aware in play should
+     * use objectFlavorAware() below, which layers on the awareness side effects.
+     */
+    setAware(kind: ObjectKind): boolean;
+    /**
+     * object_flavor_aware (obj-knowledge.c L2266): the player becomes aware of a
+     * flavoured kind AND the awareness side effects fire. Returns true when
+     * awareness newly changed (upstream is void; the port surfaces the change so
+     * callers can gate a message / redraw).
+     *
+     * What each upstream step maps to in the port's on-demand-shadow model:
+     * - kind->aware = true (L2272-2273): setAware below.
+     * - obj->known->effect = obj->effect (L2274): the port keeps NO persistent
+     *   obj->known twin; the known shadow is synthesised on demand and
+     *   objectSetBaseKnown (known-object.ts L157-170) already fills shadow.effect
+     *   from deps.isAware(kind). Once the bit above flips, every later synthesis
+     *   reveals the effect automatically - there is nothing to write here.
+     * - ignore/autoinscribe fix (L2276-2279): ported below via `deps`.
+     * - object_set_base_known over p->gear and every store's stock (L2281-2290):
+     *   a NO-OP in the port. Those are exactly the twins that are synthesised on
+     *   demand and re-read the freshly-flipped aware bit, so there is no stored
+     *   copy to re-sweep. (Building a persistent twin to sweep is the separate
+     *   DEFERRED obj->known item, out of scope here.)
+     * - floor-tile re-light for kinds that change glyph on awareness
+     *   (L2293-2312): a cave/display concern, outside packages/core/src/obj.
+     *
+     * @returns true iff the kind was not already aware.
+     */
+    objectFlavorAware(kind: ObjectKind, deps: FlavorAwareDeps): boolean;
+    /** object_flavor_tried (L2320): mark a kind tried; artifacts are skipped. */
+    setTried(kind: ObjectKind): void;
+    /** A JSON-safe snapshot of the aware/tried kidx sets, for savefiles. */
+    snapshot(): {
+        aware: number[];
+        tried: number[];
+    };
+    /** Restore a snapshot() payload (replacing the current knowledge). */
+    restore(data: {
+        aware: number[];
+        tried: number[];
+    }): void;
+}
+/**
+ * The per-game "everseen" knowledge (object.h struct object_kind.everseen and
+ * struct ego_item.everseen). Upstream these bits live on the shared kind/ego
+ * templates and are global to the running game; this port keeps them out of the
+ * immutable bound registry - exactly like FlavorKnowledge - in a per-game store
+ * keyed by kind index (kidx) and ego index (eidx), so a bound ObjRegistry stays
+ * reusable across games and the flags ride the save (save.c L397, L533).
+ *
+ * A kind or ego is marked everseen the first time the player sees an item whose
+ * name they know: object_desc sets obj->kind->everseen once the flavour is
+ * aware, and obj->ego->everseen once the ego is identified (obj-desc.c
+ * L633-637), plus player-birth.c L658 marks each bought start-item's kind. The
+ * object-knowledge browser lists a kind when it is everseen OR flavoured
+ * (ui-knowledge.c L2157); the ego browser lists an ego when it is everseen
+ * (L1847).
+ *
+ * Marking is a pure Set insert: it draws no RNG and does not depend on draw
+ * order, so wiring it into object_desc/generation cannot perturb determinism.
+ */
+export declare class EverseenKnowledge {
+    private readonly seenKidx;
+    private readonly seenEidx;
+    /** obj->kind->everseen: has the player ever seen this kind (name known)? */
+    kindSeen(kind: ObjectKind): boolean;
+    /** obj->ego->everseen: has the player ever seen this ego (identified)? */
+    egoSeen(ego: EgoItem): boolean;
+    /** obj->kind->everseen = true (obj-desc.c L637 / player-birth.c L658). */
+    markKind(kind: ObjectKind): void;
+    /** obj->ego->everseen = true (obj-desc.c L634). */
+    markEgo(ego: EgoItem): void;
+    /** A JSON-safe snapshot of the seen kidx/eidx sets, for savefiles. */
+    snapshot(): {
+        kinds: number[];
+        egos: number[];
+    };
+    /** Restore a snapshot() payload (replacing the current knowledge). */
+    restore(data: {
+        kinds: number[];
+        egos: number[];
+    }): void;
+}
+/**
+ * The per-kind autoinscription registry (object.h L241-242's
+ * kind->note_aware / kind->note_unaware). Upstream these two quark strings
+ * live on the shared object_kind template and are global to the running game;
+ * this port keeps them out of the immutable bound registry - like
+ * FlavorKnowledge and IgnoreSettings - in a per-game store keyed by kind index
+ * (kidx), so a bound ObjRegistry stays reusable across games and the notes ride
+ * the save.
+ *
+ * get(kidx, aware) is get_autoinscription (obj-ignore.c L229): the aware note
+ * when the kind is aware, else the unaware note. set() is
+ * add_autoinscription / remove_autoinscription (obj-ignore.c L322 / L294): a
+ * non-empty note registers that slot, an empty note clears it (upstream's
+ * NULL-inscription -> remove_autoinscription path).
+ *
+ * This is the KIND-note half only. The separate rune-based autoinscription
+ * (runes_autoinscribe, obj-ignore.c L217) rides the rune-knowledge system and
+ * stays ledger-deferred (#24).
+ */
+export declare class AutoinscriptionRegistry {
+    /** kind->note_aware / note_unaware, keyed by kidx. Absent slot == no note. */
+    private readonly notes;
+    /** get_autoinscription(kind, aware) (obj-ignore.c L229). */
+    get(kidx: number, aware: boolean): string | undefined;
+    /**
+     * add_autoinscription (obj-ignore.c L322) / remove_autoinscription (L294):
+     * register the aware or unaware note for a kind. An empty note clears that
+     * slot (upstream's null-inscription branch); a kind with neither slot set is
+     * dropped from the map entirely.
+     */
+    set(kidx: number, note: string, aware: boolean): void;
+    /** remove_autoinscription (obj-ignore.c L294): clear both slots for a kind. */
+    clear(kidx: number): void;
+    /** Every kind with a registered note (either slot), for the management UI. */
+    entries(): Array<[number, {
+        aware?: string;
+        unaware?: string;
+    }]>;
+}
+/**
+ * rune_list[i].note (object.h struct rune): the player's per-rune
+ * autoinscription. Upstream this is a quark on the file-static rune_list, set
+ * from the rune knowledge screen (ui-knowledge.c rune_xtra_act, L2246-2280) and
+ * saved/loaded by wr_ignore (save.c:586-605) / rd_ignore (load.c:937-945).
+ * Like AutoinscriptionRegistry it lives per-game here so the bound registries
+ * stay immutable, keyed by the rune's index in buildRuneList - the same key
+ * upstream uses to address rune_list at runtime. (The SAVEFILE keys by runeKey
+ * instead; see runeKey below for why.)
+ *
+ * WART preserved: upstream `rune_set_note(i, "")` goes through quark_add(""),
+ * which returns a NONZERO quark (z-quark.c:31-49 never returns 0 for a new
+ * string), so an empty inscription is a LIVE note that appends nothing - it is
+ * written to the savefile and shows the '}' uninscribe prompt. Only
+ * rune_set_note(i, NULL) clears the slot. Hence set(i, "") stores, set(i, null)
+ * deletes.
+ */
+export declare class RuneNoteRegistry {
+    private readonly notes;
+    /** rune_note(i) (obj-knowledge.c:406). undefined == quark 0 == no note. */
+    get(i: number): string | undefined;
+    /** rune_set_note(i, inscription) (obj-knowledge.c:414). */
+    set(i: number, note: string | null): void;
+    /** Every rune index carrying a note, for the save block and the UI. */
+    entries(): Array<[number, string]>;
+}
+/** rune_note (obj-knowledge.c:406) as a free function over the registry. */
+export declare function runeNote(registry: RuneNoteRegistry, i: number): string | undefined;
+/** rune_set_note (obj-knowledge.c:414) as a free function over the registry. */
+export declare function runeSetNote(registry: RuneNoteRegistry, i: number, note: string | null): void;
+/**
+ * A pack-stable identity for a rune, for the savefile only.
+ *
+ * Upstream writes the raw rune-list index (`wr_s16b(k)`, save.c:600) and reads
+ * it straight back (`rune_set_note(runeid, tmp)`, load.c:944), which mis-targets
+ * if the loaded data changes the rune list's shape - the same positional-index
+ * fragility wr_object_memory has. That fragility is a property of the C
+ * SAVEFILE FORMAT, and the port's format is the ratified JSON document whose
+ * load-bearing rule is that every content reference is a stable id
+ * (MOD_LIFECYCLE decision 1, session/save.ts SAVE_VERSION). Runtime behaviour
+ * is untouched: in play a rune is still addressed by its buildRuneList index,
+ * exactly as upstream addresses rune_list.
+ *
+ * `variety:name` is unique across the whole list: buildRuneList already
+ * de-duplicates brands and slays by name, and the remaining varieties draw one
+ * rune per distinct property name.
+ */
+export declare function runeKey(rune: Rune): string;
+/**
+ * rune_name (obj-knowledge.c:325): the display name of a rune, with the
+ * variety-specific decoration - "<x> brand", "slay <x>", "<x> curse",
+ * "resist <x>", and the bare name for combat / modifier / flag runes.
+ */
+export declare function runeName(rune: Rune): string;
+/**
+ * get_autoinscription (obj-ignore.c L229) as a free function over the registry,
+ * mirroring the upstream signature: the aware note when the kind is aware, else
+ * the unaware note; undefined when the kind has no note for that awareness.
+ */
+export declare function getAutoinscription(registry: AutoinscriptionRegistry, kidx: number, aware: boolean): string | undefined;
+/**
+ * add_autoinscription / remove_autoinscription (obj-ignore.c L322 / L294) as a
+ * free function over the registry: register `note` for the aware or unaware
+ * slot; an empty note clears it.
+ */
+export declare function setAutoinscription(registry: AutoinscriptionRegistry, kidx: number, note: string, aware: boolean): void;
+/**
+ * The object_flavor_aware side effect of player_know_object (obj-knowledge.c
+ * L1163-1175). This is the awareness-UPDATE half of player_know_object, split
+ * out so it can be fired at the port's knowledge-update sites - upstream the
+ * whole of player_know_object writes the obj->known twin AND fires this; the
+ * port synthesises the twin on demand for display, so ONLY this awareness half
+ * needs a home, and it must never live on the display path (describing an item
+ * must not mutate the player's knowledge).
+ *
+ * player_know_object early-returns for a not-yet-assessed object (L1033) before
+ * ever reaching these branches, so this mirrors that gate: awareness fires only
+ * once the object is ASSESSED. Then:
+ * - jewellery whose non-curse runes are all known becomes aware (L1163-1167);
+ * - a special artifact that isn't jewellery (kidx >= ordinary_kind_max) becomes
+ *   aware outright (L1168-1175).
+ *
+ * object_flavor_aware itself early-returns when the kind is already aware, so
+ * re-firing across repeated rune-learns is a no-op.
+ */
+export declare function playerKnowObjectAwareness(p: Player, env: RuneEnv, obj: GameObject, runes: readonly Rune[], flavor: FlavorKnowledge, flavorDeps: FlavorAwareDeps): void;
+//# sourceMappingURL=knowledge.d.ts.map

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

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