@rpgm-tools/neo-angband-core 0.10.0

package/dist/game/effect-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-env.d.ts","sourceRoot":"","sources":["../../src/game/effect-env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EACV,aAAa,EAEb,YAAY,EAGZ,SAAS,EACV,MAAM,2BAA2B,CAAC;AAQnC,OAAO,KAAK,EACV,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAK5B,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EAEb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,UAAU,EAAE,SAAS,WAAW,EAAE,CAAC;IACnC,uCAAuC;IACvC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,yDAAyD;IACzD,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,yEAAyE;IACzE,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/D,yEAAyE;IACzE,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC;;gEAE4D;IAC5D,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,0DAA0D;IAC1D,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,yDAAyD;IACzD,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,iEAAiE;IACjE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAyBD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,aAAa,GAClB,SAAS,CAmCX;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,aAAa,GAClB,YAAY,CAuDd;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,aAAa,GAClB,aAAa,CAsBf"}

package/dist/game/effect-env.js

@@ -0,0 +1,166 @@
+/**
+ * The effect-interpreter environment adapters: build a live EffectContext
+ * (effects/interpreter.ts) from the GameState so the already-ported general
+ * effect handlers (effects/handlers.ts: EF_HEAL_HP, EF_CURE, the EF_TIMED_*
+ * family, EF_NOURISH, EF_DAMAGE, ...) run end to end against a real player
+ * instead of no-opping on an absent slot.
+ *
+ * These are the concrete backing for the narrow capability interfaces the
+ * interpreter defines:
+ * - TimedHost is backed by the player-timed runtime (player/timed.ts) over the
+ *   bound timed-effect table, so grade transitions, messages, disturbance and
+ *   the NONSTACKING guard behave identically to every other status change.
+ * - EffectPlayer.hp is a live view of the player's hitpoints; takeHit and
+ *   applyDamageReduction route through the shared player-damage primitive
+ *   (player/take-hit.ts), the same one the projection player driver uses.
+ *
+ * The bound timed table (player/bind.ts) is passed in because GameState does
+ * not carry it; the same is true of the food value, depth, damage reduction
+ * and player_inc_check queries (all calc_bonuses / pack state that lives
+ * outside the turn-loop state). A caller that supplies no incQueries lets every
+ * timed increase through, matching a bare resistance-less player.
+ */
+import { playerClearTimed, playerDecTimed, playerIncCheck, playerIncTimed, playerSetTimed, } from "../player/timed.js";
+import { playerApplyDamageReduction, takeHit, } from "../player/take-hit.js";
+import { DEFAULT_HITPOINT_WARN } from "./project-cast.js";
+/** A TakeHitTarget view whose chp / is_dead mutations write back to the state. */
+function takeHitTarget(state) {
+    const p = state.actor.player;
+    return {
+        get chp() {
+            return p.chp;
+        },
+        set chp(v) {
+            p.chp = v;
+        },
+        mhp: p.mhp,
+        lev: p.lev,
+        get isDead() {
+            return state.isDead;
+        },
+        set isDead(v) {
+            state.isDead = v;
+        },
+        timed: p.timed,
+        hitpointWarn: DEFAULT_HITPOINT_WARN,
+    };
+}
+/**
+ * buildTimedHost: the interpreter's TimedHost over the live player, dispatching
+ * through the player-timed runtime with the bound effect table (looked up by
+ * the effect's index, so the table may be in any order).
+ */
+export function buildTimedHost(state, deps) {
+    const p = state.actor.player;
+    const byIndex = new Map();
+    for (const e of deps.timedTable)
+        byIndex.set(e.index, e);
+    const effect = (idx) => {
+        const e = byIndex.get(idx);
+        if (!e)
+            throw new Error(`no bound timed effect for index ${idx}`);
+        return e;
+    };
+    const hooks = {
+        ...(deps.onMessage
+            ? { onMessage: (t, msgt) => deps.onMessage(t, msgt) }
+            : {}),
+        ...(deps.timedHooks ?? {}),
+        ...(deps.incQueries
+            ? {
+                incCheck: (idx) => playerIncCheck(effect(idx), deps.incQueries, deps.incHooks),
+            }
+            : {}),
+    };
+    return {
+        timed: (idx) => p.timed[idx] ?? 0,
+        setTimed: (idx, v, notify, canDisturb) => playerSetTimed(p, effect(idx), v, notify, canDisturb, hooks),
+        incTimed: (idx, v, notify, canDisturb, check) => playerIncTimed(p, effect(idx), v, notify, canDisturb, check, hooks),
+        decTimed: (idx, v, notify, canDisturb) => playerDecTimed(p, effect(idx), v, notify, canDisturb, hooks),
+        clearTimed: (idx, notify, canDisturb) => playerClearTimed(p, effect(idx), notify, canDisturb, hooks),
+    };
+}
+/**
+ * buildEffectPlayer: the interpreter's EffectPlayer slot over the live player -
+ * a live hitpoint view, the timed host, and take_hit / damage-reduction routed
+ * through the shared player-damage primitive.
+ */
+export function buildEffectPlayer(state, deps) {
+    const p = state.actor.player;
+    const target = takeHitTarget(state);
+    const reduction = deps.reduction ?? { damRed: 0, percDamRed: 0 };
+    const hp = {
+        get chp() {
+            return p.chp;
+        },
+        set chp(v) {
+            p.chp = v;
+        },
+        get mhp() {
+            return p.mhp;
+        },
+        set mhp(v) {
+            p.mhp = v;
+        },
+        get chpFrac() {
+            return p.chpFrac;
+        },
+        set chpFrac(v) {
+            p.chpFrac = v;
+        },
+    };
+    const mana = {
+        get csp() {
+            return p.csp;
+        },
+        set csp(v) {
+            p.csp = v;
+        },
+        get msp() {
+            return p.msp;
+        },
+        set msp(v) {
+            p.msp = v;
+        },
+        get cspFrac() {
+            return p.cspFrac;
+        },
+        set cspFrac(v) {
+            p.cspFrac = v;
+        },
+    };
+    return {
+        hp,
+        mana,
+        timed: buildTimedHost(state, deps),
+        applyDamageReduction: (dam) => playerApplyDamageReduction(target, reduction, dam),
+        takeHit: (dam, killer) => takeHit(target, dam, killer, deps.takeHitHooks),
+    };
+}
+/**
+ * buildEffectContext: a full EffectContext for effect_do / effect_simple, built
+ * from the live GameState. rng comes from the state; the player slot and food
+ * value are populated so the general handlers act for real.
+ */
+export function buildEffectContext(state, deps) {
+    const messages = deps.onMessage
+        ? { msg: deps.onMessage }
+        : undefined;
+    /* OPT(player, show_damage): the injected dep wins, else the wired option
+     * store. Absent (worldless tests), it stays undefined (falsey), preserving
+     * the prior seam-absent behaviour and the shipped default (off). */
+    const showDamage = deps.showDamage ?? state.options?.get("show_damage");
+    return {
+        rng: state.rng,
+        ...(messages ? { messages } : {}),
+        ...(deps.events ? { events: deps.events } : {}),
+        player: buildEffectPlayer(state, deps),
+        foodValue: deps.foodValue ?? state.z.foodValue,
+        ...(deps.level !== undefined ? { level: deps.level } : {}),
+        ...(showDamage !== undefined ? { showDamage } : {}),
+        ...((deps.chooseEffect ?? state.effectChooser)
+            ? { chooseEffect: deps.chooseEffect ?? state.effectChooser }
+            : {}),
+    };
+}
+//# sourceMappingURL=effect-env.js.map

package/dist/game/effect-env.js.map

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

package/dist/game/effect-game-env.d.ts

@@ -0,0 +1,76 @@
+/**
+ * The shared game-layer effect environment. Game effect handlers (the attack
+ * projections in effect-attack.ts, the monster effects in effect-monster.ts,
+ * and later batches) need access to the live GameState, which the effects/
+ * layer's EffectContext deliberately keeps opaque (the layering rule keeps
+ * effects/ below game/). This module owns the concrete environment those
+ * handlers read and the plumbing that attaches it to an EffectContext.
+ *
+ * A handler reads the environment from context.env.game (an opaque slot on
+ * EffectContext) via gameEnv(); when it is absent the handler no-ops (the
+ * worldless rule the effects/ handlers already follow). The caller attaches it
+ * with attachGameEnv after building the base context (game/effect-env.ts
+ * buildEffectContext).
+ */
+import type { Loc } from "../loc.js";
+import type { EffectContext, EffectHandlerContext } from "../effects/interpreter.js";
+import type { TakeHitHooks } from "../player/take-hit.js";
+import type { GameState } from "./context.js";
+import type { CastContext } from "./project-cast.js";
+import type { TeleportEnv } from "./effect-teleport.js";
+import type { GeneralEffectEnv } from "./effect-general.js";
+import type { ItemEffectEnv } from "./effect-item.js";
+import type { SummonEffectEnv } from "./effect-summon.js";
+/** Everything the game-layer effect handlers need beyond the EffectContext. */
+export interface GameEffectEnv {
+    /** The live game state (monsters, chunk, player actor, rng). */
+    state: GameState;
+    /** The projection casting context (bound projections, range, player actor). */
+    cast: CastContext;
+    /**
+     * target_get for a DIR_TARGET player cast. The command layers back it
+     * with a live getter over game/target.ts (targetOkay + targetGet), so a
+     * target that moves or dies mid-chain is re-read per handler exactly as
+     * upstream's per-handler target_get; tests may pass a plain grid.
+     */
+    aimed?: Loc | undefined;
+    /** cave->mon_current: the acting monster, excluded by PROJECT_LOS. */
+    monCurrent?: number;
+    /** player_has(PF_CHARM). */
+    charm?: boolean;
+    /** take_hit consequences for effects that damage the player (BANISH, ...). */
+    takeHitHooks?: TakeHitHooks;
+    /**
+     * get_com symbol chooser for EF_BANISH: return the chosen monster glyph, or
+     * null to abort. Absent means the effect aborts (no UI wired).
+     */
+    banishSymbol?: () => string | null;
+    /** Teleport-family hooks and unmodelled-subsystem seams (effect-teleport.ts). */
+    teleport?: TeleportEnv;
+    /** General-handler seams: trap access for glyphs/webs (effect-general.ts). */
+    general?: GeneralEffectEnv;
+    /** Item-targeting seams: get_item and the ego/curse tables (effect-item.ts). */
+    item?: ItemEffectEnv;
+    /**
+     * Per-game flavor knowledge, so an item-identifying effect (EF_IDENTIFY ->
+     * object_learn_unknown_rune -> player_know_object) can fire the
+     * object_flavor_aware side effect. Absent, awareness is left unchanged (the
+     * worldless rule); the ignore/notice consequences ride flavorDeps.
+     */
+    flavor?: import("../obj/knowledge.js").FlavorKnowledge;
+    /** object_flavor_aware's ignore/notice side effects, used with `flavor`. */
+    flavorDeps?: import("../obj/knowledge.js").FlavorAwareDeps;
+    /** Summoning seams: the summon table and live placement (effect-summon.ts). */
+    summon?: SummonEffectEnv;
+    /**
+     * monster_change_shape / monster_revert_shape (game/mon-shape.ts), for
+     * the MON_TMD_CHANGED timer (the SHAPECHANGE monster spell). Built by
+     * wireGame; absent, the timer stands and the form is unchanged.
+     */
+    monShape?: import("../mon/timed.js").MonShapeHooks;
+}
+/** Attach a game environment to an effect context for the game handlers. */
+export declare function attachGameEnv(env: EffectContext, game: GameEffectEnv): EffectContext;
+/** Read the game env off the context, or null for a worldless interpreter. */
+export declare function gameEnv(ctx: EffectHandlerContext): GameEffectEnv | null;
+//# sourceMappingURL=effect-game-env.d.ts.map

package/dist/game/effect-game-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-game-env.d.ts","sourceRoot":"","sources":["../../src/game/effect-game-env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,+EAA+E;AAC/E,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,KAAK,EAAE,SAAS,CAAC;IACjB,+EAA+E;IAC/E,IAAI,EAAE,WAAW,CAAC;IAClB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,GAAG,GAAG,SAAS,CAAC;IACxB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACnC,iFAAiF;IACjF,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,gFAAgF;IAChF,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,qBAAqB,EAAE,eAAe,CAAC;IACvD,4EAA4E;IAC5E,UAAU,CAAC,EAAE,OAAO,qBAAqB,EAAE,eAAe,CAAC;IAC3D,+EAA+E;IAC/E,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,iBAAiB,EAAE,aAAa,CAAC;CACpD;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAC3B,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,aAAa,GAClB,aAAa,CAEf;AAED,8EAA8E;AAC9E,wBAAgB,OAAO,CAAC,GAAG,EAAE,oBAAoB,GAAG,aAAa,GAAG,IAAI,CAEvE"}

package/dist/game/effect-game-env.js

@@ -0,0 +1,23 @@
+/**
+ * The shared game-layer effect environment. Game effect handlers (the attack
+ * projections in effect-attack.ts, the monster effects in effect-monster.ts,
+ * and later batches) need access to the live GameState, which the effects/
+ * layer's EffectContext deliberately keeps opaque (the layering rule keeps
+ * effects/ below game/). This module owns the concrete environment those
+ * handlers read and the plumbing that attaches it to an EffectContext.
+ *
+ * A handler reads the environment from context.env.game (an opaque slot on
+ * EffectContext) via gameEnv(); when it is absent the handler no-ops (the
+ * worldless rule the effects/ handlers already follow). The caller attaches it
+ * with attachGameEnv after building the base context (game/effect-env.ts
+ * buildEffectContext).
+ */
+/** Attach a game environment to an effect context for the game handlers. */
+export function attachGameEnv(env, game) {
+    return { ...env, game };
+}
+/** Read the game env off the context, or null for a worldless interpreter. */
+export function gameEnv(ctx) {
+    return ctx.env.game ?? null;
+}
+//# sourceMappingURL=effect-game-env.js.map

package/dist/game/effect-game-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-game-env.js","sourceRoot":"","sources":["../../src/game/effect-game-env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA6DH,4EAA4E;AAC5E,MAAM,UAAU,aAAa,CAC3B,GAAkB,EAClB,IAAmB;IAEnB,OAAO,EAAE,GAAG,GAAG,EAAE,IAAI,EAAE,CAAC;AAC1B,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,OAAO,CAAC,GAAyB;IAC/C,OAAQ,GAAG,CAAC,GAAG,CAAC,IAAkC,IAAI,IAAI,CAAC;AAC7D,CAAC"}

package/dist/game/effect-general.d.ts

@@ -0,0 +1,98 @@
+/**
+ * The world-touching general effect handlers, ported from
+ * reference/src/effect-handler-general.c (Angband 4.2.6): EF_GLYPH (L700, a
+ * glyph of warding or a decoy on the player's grid), EF_WEB (L732, a web
+ * spinner filling its surroundings), EF_DISENCHANT (L2003, disenchanting
+ * a random piece of worn equipment), the stat family (RESTORE_STAT L773,
+ * DRAIN_STAT L803 with its sustain save and rune learning,
+ * LOSE_RANDOM_STAT L852, GAIN_STAT L875, SCRAMBLE_STATS / UNSCRAMBLE_STATS
+ * L3634 for the TMD_SCRAMBLE timed chains), the experience pair
+ * (RESTORE_EXP L893, GAIN_EXP L913), the drains (DRAIN_LIGHT L928,
+ * DRAIN_MANA L956 healing a monster caster and soaked by a decoy) and
+ * MON_TIMED_INC (L667). Like the other game-layer handlers they read their
+ * environment from context.env.game and no-op when it is absent (the
+ * worldless rule); GLYPH and WEB additionally need the trap system
+ * (env.general.trapDeps) since glyphs and webs ARE trap kinds upstream.
+ *
+ * disenchantEquipment is exported separately: project-player.c's DISEN
+ * handler applies the same disenchantment through effect_simple, so the
+ * player side-effect table (game/player-side.ts) calls it directly.
+ *
+ * Simplifications, ledgered: the equipment letter in the disenchant message
+ * (gear_to_label) and the ODESC_BASE description ride the display layer
+ * (#25) - the kind's base name is used; obj->known->to_h/to_d/to_a display
+ * sync likewise (knowledge is rune-based here). The decoy grid lives on
+ * GameState.decoy; the monster-AI decoy targeting is deferred with lore
+ * (#24).
+ */
+import type { EffectRegistry } from "../effects/interpreter.js";
+import type { Shape } from "../player/types.js";
+import type { ObjectProperty } from "../obj/types.js";
+import type { ExpDeps } from "../player/exp.js";
+import type { GameState } from "./context.js";
+import type { TrapDeps } from "./trap.js";
+/**
+ * The general-handler seams, grouped on the game effect environment
+ * (effect-game-env.ts GameEffectEnv.general). trapDeps backs glyph and web
+ * creation; absent, those handlers no-op (the trap system is not wired).
+ * properties backs desc_stat (the stat adjectives from object_property.txt);
+ * expDeps lets experience gains ripple level changes.
+ */
+export interface GeneralEffectEnv {
+    trapDeps?: TrapDeps;
+    /** The bound object properties (ObjRegistry.properties), for desc_stat. */
+    properties?: readonly (ObjectProperty | null)[];
+    /** player_exp_gain's level-change ripple (player/exp.ts). */
+    expDeps?: ExpDeps;
+    /** get_check yes/no prompts (RECALL's depth/cancel checks). Default yes. */
+    confirm?: (prompt: string) => boolean;
+    /**
+     * get_quantity (ui-input.c L1206) for player_get_recall_depth's
+     * "Which level do you wish to return to (0 to cancel)? " prompt. Only
+     * reached under birth_levels_persist. 0 = cancel.
+     */
+    chooseDepth?: (prompt: string, max: number) => number;
+    /** The bound player shapes (PlayerRegistry.shapes), for EF_SHAPECHANGE. */
+    shapes?: readonly Shape[];
+}
+/**
+ * The EF_DISENCHANT body, shared with the PROJ_DISEN player side effect
+ * (project-player.c dispatches it through effect_simple): pick a random
+ * disenchantable equipment slot (not rings, amulets or lights), let
+ * artifacts resist 60% of the time, and knock a point (sometimes two) off
+ * the item's enchantment.
+ */
+export declare function disenchantEquipment(state: GameState, opts?: {
+    msg?: (text: string) => void;
+}): void;
+/**
+ * player_get_recall_depth (player-util.c L100): under birth_levels_persist the
+ * player CHOOSES which visited persistent level Word of Recall returns to.
+ * Reached from exactly one place, effect_handler_RECALL's depth-0 branch
+ * (effect-handler-general.c L1141), and only with that option on.
+ *
+ * The rules, exactly:
+ *   - max_depth <= 0 (never left town) or birth_force_descend: no prompt at
+ *     all, return true, recall_depth untouched (L109-111).
+ *   - otherwise loop on get_quantity(prompt, p->max_depth): 0 cancels the whole
+ *     scroll (return false); a depth with no entry in chunk_list re-prompts
+ *     after "You must choose a level you have previously visited."
+ *   - only on success is recall_depth assigned (L134).
+ * get_quantity itself skips the prompt and yields 1 when max == 1
+ * (ui-input.c L1211), so a max_depth of 1 never asks.
+ *
+ * `chooseDepth` is the get_quantity seam. With no seam an unprompted terminal
+ * takes get_quantity's clamp-to-max, i.e. the deepest level reached, which is
+ * always present in the cache.
+ */
+export declare function playerGetRecallDepth(state: GameState, chooseDepth?: (prompt: string, max: number) => number, say?: (text: string) => void): boolean;
+/**
+ * Register the general world-touching handlers, overriding the stubs
+ * registerCoreHandlers installed. Call after registerCoreHandlers. Each
+ * handler reads its game environment from context.env.game (attach it with
+ * attachGameEnv) and no-ops when it is absent.
+ */
+export declare function registerGeneralHandlers(registry: EffectRegistry): void;
+/** The general EF codes this module registers. */
+export declare const GENERAL_HANDLER_CODES: readonly number[];
+//# sourceMappingURL=effect-general.d.ts.map

package/dist/game/effect-general.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-general.d.ts","sourceRoot":"","sources":["../../src/game/effect-general.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAMH,OAAO,KAAK,EAGV,cAAc,EACf,MAAM,2BAA2B,CAAC;AAkBnC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAGhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAWtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAQhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAW9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAG1C;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,EAAE,CAAC;IAChD,6DAA6D;IAC7D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IACtC;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACtD,2EAA2E;IAC3E,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;CAC3B;AAuID;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,EAChB,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAAO,GAC1C,IAAI,CA+DN;AA2PD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,EAChB,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,EACrD,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC3B,OAAO,CA0BT;AAoeD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAItE;AAED,kDAAkD;AAClD,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAElD,CAAC"}