@rpgm-tools/neo-angband-core 0.10.0

package/dist/mod/ids.js.map

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

package/dist/mod/registry-host.d.ts

@@ -0,0 +1,156 @@
+/**
+ * The in-process registry host (W2.2): the capability-gated seam through which a
+ * TRUSTED, in-process plugin overrides game SYSTEMS - not just data. It opens
+ * the four runtime registries the engine already exposes for extension:
+ *
+ * - effects  (EffectRegistry, effects/interpreter.ts): register a handler for a
+ *   new string effect code, or replace a core numeric EF handler - overriding
+ *   combat / healing / teleport / detection logic. Gated by "registry:effect".
+ * - rooms    (RoomRegistry, gen/room.ts): register a room/level builder under
+ *   any key, referenced from a (modded) dungeon profile - overriding level
+ *   generation. Gated by "registry:room".
+ * - commands (ActionRegistry, game/player-turn.ts): register or replace the
+ *   action a player command code runs - overriding what "walk", "cast", ... do.
+ *   Gated by "registry:command". (This is the live player-command seam; the
+ *   cmd.ts CommandQueue is a faithful port the web loop does not drive.)
+ * - monsters (GameState.monsterTurnHook, game/monster-turn.ts): install a hook
+ *   consulted at the top of every monster's turn; returning true takes the turn
+ *   over entirely - overriding monster AI. Gated by "registry:monster".
+ * - vocab    (VocabularyRegistry, mod/vocabulary.ts): declare genuinely NEW
+ *   vocabulary terms (flags, stats, any mod-coined kind) and store per-entity
+ *   values for them - extending the game's vocabulary, not just recombining it
+ *   (W2.3). Mod-owned and persisted in the mod's save bag; core never reads it.
+ *   Gated by "registry:vocab".
+ *
+ * WHY IN-PROCESS AND TRUSTED (the W2.2 architecture decision): every one of
+ * these handlers executes SYNCHRONOUSLY with live access to the rng, the chunk,
+ * the player and the monster - deep inside the turn. A Web Worker (the W2.1
+ * sandbox) is async and isolated by construction and cannot supply such a
+ * handler; the only browser primitive that could (SharedArrayBuffer +
+ * Atomics.wait) needs cross-origin-isolation headers a static host cannot send,
+ * and would freeze the main thread per effect regardless. So deep system
+ * override is a TRUSTED, in-process capability - as it is in every real modding
+ * system (SKSE, Forge, ...). Trust is still explicit: the plugin declares each
+ * registry:* capability in its manifest, the user consents at install, and the
+ * conflict report covers what it touches. The untrusted Worker tier keeps the
+ * reactive perceive/act/event surface (W2.1) and none of this.
+ *
+ * Layering: core owns this facade because it gates access to core registries;
+ * the HOST (web/cli) constructs it from the live registries and hands it to a
+ * loaded trusted plugin. Capabilities are the same structural AgentCapabilities
+ * the perceive/act facades use - satisfied by mod-sdk's CapabilitySet without
+ * core depending on mod-sdk. Absent capabilities means a fully trusted host
+ * (everything granted), matching the perceive/act/controller convention.
+ */
+import type { AgentCapabilities } from "../agent/types.js";
+import type { EffectCode } from "../effects/effect.js";
+import type { EffectDefinition, EffectRegistry } from "../effects/interpreter.js";
+import type { RoomBuilder, RoomRegistry } from "../gen/room.js";
+import type { ActionRegistry, PlayerAction } from "../game/player-turn.js";
+import type { GameState } from "../game/context.js";
+import type { Monster } from "../mon/monster.js";
+import type { JsonValue } from "./save-blocks.js";
+import type { VocabKind, VocabTerm, VocabularyRegistry } from "./vocabulary.js";
+/** The capability each registry facade requires (registry:<domain>). */
+export declare const REGISTRY_CAPABILITIES: {
+    readonly effect: "registry:effect";
+    readonly room: "registry:room";
+    readonly command: "registry:command";
+    readonly monster: "registry:monster";
+    readonly vocab: "registry:vocab";
+};
+export type RegistryDomain = keyof typeof REGISTRY_CAPABILITIES;
+/**
+ * A monster-AI override: run at the top of monsterTurn (game/monster-turn.ts).
+ * Return true to consume the monster's whole turn (the default behaviour is
+ * skipped); return false to fall through to the ported AI. Mutates state as the
+ * ported turn code would - it runs in the same synchronous, live-state context.
+ */
+export type MonsterTurnHook = (mon: Monster, state: GameState) => boolean;
+/** The live registries a host wires into the facade; any may be absent. */
+export interface RegistryTargets {
+    /** The effect interpreter; null when the pack has no projections. */
+    effects?: EffectRegistry | null;
+    /** The room/level builder registry (CoreRegistries.rooms). */
+    rooms?: RoomRegistry | null;
+    /** The live player action registry (the decision-13 command seam). */
+    commands?: ActionRegistry | null;
+    /** The game state, for installing the monster-AI turn hook. */
+    state?: GameState | null;
+    /** This mod's vocabulary registry (declared terms + per-entity values). */
+    vocab?: VocabularyRegistry | null;
+}
+/** The effect-override facade (gated by registry:effect). */
+export interface EffectFacade {
+    /**
+     * Register a handler for an effect code. A string code adds a brand-new
+     * effect; a numeric EF code replaces the core handler for that effect. The
+     * handler runs synchronously inside effect_do with the live EffectContext.
+     */
+    register(code: EffectCode, def: EffectDefinition): void;
+    /** Whether a code currently has a handler. */
+    isRegistered(code: EffectCode): boolean;
+}
+/** The room-builder facade (gated by registry:room). */
+export interface RoomFacade {
+    /** Register (or replace) a room/level builder under a key. */
+    register(name: string, builder: RoomBuilder): void;
+}
+/** The player-command facade (gated by registry:command). */
+export interface CommandFacade {
+    /** Register (or replace) the action a player command code runs. */
+    register(code: string, action: PlayerAction): void;
+    /** Whether a command code currently has an action. */
+    has(code: string): boolean;
+}
+/** The monster-AI facade (gated by registry:monster). */
+export interface MonsterFacade {
+    /**
+     * Install the monster-turn hook (replaces any previously installed one; pass
+     * null to clear). Consulted at the top of every monster's turn.
+     */
+    setTurnHook(hook: MonsterTurnHook | null): void;
+}
+/**
+ * The vocabulary-extension facade (gated by registry:vocab). Declares NEW terms
+ * (flags / stats / any mod-coined kind) and stores per-entity values for them -
+ * the W2.3 seam. Delegates to the mod's own VocabularyRegistry (mod/vocabulary.ts),
+ * which the host persists into the mod's save bag; core never reads these terms.
+ */
+export interface VocabFacade {
+    /** Declare a new term; throws on a duplicate (same kind + term). */
+    define(term: VocabTerm): void;
+    /** Whether a term is declared in a kind. */
+    has(kind: VocabKind, term: string): boolean;
+    /** All declared terms, optionally filtered to one kind. */
+    list(kind?: VocabKind): VocabTerm[];
+    /** Set an entity's value for a declared term (throws if undeclared). */
+    setValue(entity: string, term: string, value: JsonValue): void;
+    /** Get an entity's value for a term, or undefined when unset. */
+    getValue(entity: string, term: string): JsonValue | undefined;
+    /** A plain snapshot of one entity's term values. */
+    valuesOf(entity: string): {
+        [term: string]: JsonValue;
+    };
+}
+/**
+ * The capability-gated registry host handed to a trusted in-process plugin.
+ * Each facade throws AgentCapabilityError on first use if the corresponding
+ * registry:<domain> capability was not granted, and a plain Error if the host
+ * did not wire that registry (e.g. effects on a worldless boot).
+ */
+export interface ModRegistryHost {
+    readonly effects: EffectFacade;
+    readonly rooms: RoomFacade;
+    readonly commands: CommandFacade;
+    readonly monsters: MonsterFacade;
+    readonly vocab: VocabFacade;
+}
+/**
+ * Build the capability-gated registry host over the live registries. Pass the
+ * plugin's AgentCapabilities (from CapabilitySet.fromManifest); omit for a fully
+ * trusted host. The gate is checked at each call, so a plugin that never touches
+ * a domain never needs its capability.
+ */
+export declare function createModRegistryHost(targets: RegistryTargets, capabilities?: AgentCapabilities): ModRegistryHost;
+//# sourceMappingURL=registry-host.d.ts.map

package/dist/mod/registry-host.d.ts.map

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

package/dist/mod/registry-host.js

@@ -0,0 +1,142 @@
+/**
+ * The in-process registry host (W2.2): the capability-gated seam through which a
+ * TRUSTED, in-process plugin overrides game SYSTEMS - not just data. It opens
+ * the four runtime registries the engine already exposes for extension:
+ *
+ * - effects  (EffectRegistry, effects/interpreter.ts): register a handler for a
+ *   new string effect code, or replace a core numeric EF handler - overriding
+ *   combat / healing / teleport / detection logic. Gated by "registry:effect".
+ * - rooms    (RoomRegistry, gen/room.ts): register a room/level builder under
+ *   any key, referenced from a (modded) dungeon profile - overriding level
+ *   generation. Gated by "registry:room".
+ * - commands (ActionRegistry, game/player-turn.ts): register or replace the
+ *   action a player command code runs - overriding what "walk", "cast", ... do.
+ *   Gated by "registry:command". (This is the live player-command seam; the
+ *   cmd.ts CommandQueue is a faithful port the web loop does not drive.)
+ * - monsters (GameState.monsterTurnHook, game/monster-turn.ts): install a hook
+ *   consulted at the top of every monster's turn; returning true takes the turn
+ *   over entirely - overriding monster AI. Gated by "registry:monster".
+ * - vocab    (VocabularyRegistry, mod/vocabulary.ts): declare genuinely NEW
+ *   vocabulary terms (flags, stats, any mod-coined kind) and store per-entity
+ *   values for them - extending the game's vocabulary, not just recombining it
+ *   (W2.3). Mod-owned and persisted in the mod's save bag; core never reads it.
+ *   Gated by "registry:vocab".
+ *
+ * WHY IN-PROCESS AND TRUSTED (the W2.2 architecture decision): every one of
+ * these handlers executes SYNCHRONOUSLY with live access to the rng, the chunk,
+ * the player and the monster - deep inside the turn. A Web Worker (the W2.1
+ * sandbox) is async and isolated by construction and cannot supply such a
+ * handler; the only browser primitive that could (SharedArrayBuffer +
+ * Atomics.wait) needs cross-origin-isolation headers a static host cannot send,
+ * and would freeze the main thread per effect regardless. So deep system
+ * override is a TRUSTED, in-process capability - as it is in every real modding
+ * system (SKSE, Forge, ...). Trust is still explicit: the plugin declares each
+ * registry:* capability in its manifest, the user consents at install, and the
+ * conflict report covers what it touches. The untrusted Worker tier keeps the
+ * reactive perceive/act/event surface (W2.1) and none of this.
+ *
+ * Layering: core owns this facade because it gates access to core registries;
+ * the HOST (web/cli) constructs it from the live registries and hands it to a
+ * loaded trusted plugin. Capabilities are the same structural AgentCapabilities
+ * the perceive/act facades use - satisfied by mod-sdk's CapabilitySet without
+ * core depending on mod-sdk. Absent capabilities means a fully trusted host
+ * (everything granted), matching the perceive/act/controller convention.
+ */
+import { AgentCapabilityError } from "../agent/types.js";
+/** The capability each registry facade requires (registry:<domain>). */
+export const REGISTRY_CAPABILITIES = {
+    effect: "registry:effect",
+    room: "registry:room",
+    command: "registry:command",
+    monster: "registry:monster",
+    vocab: "registry:vocab",
+};
+/** Absent capabilities => trusted host, all granted (perceive/act convention). */
+function granted(caps, capability) {
+    return !caps || caps.has(capability);
+}
+function requireCap(caps, domain) {
+    const capability = REGISTRY_CAPABILITIES[domain];
+    if (!granted(caps, capability)) {
+        throw new AgentCapabilityError(`mod registry: "${domain}" override requires capability "${capability}" - grant it in the mod manifest`);
+    }
+}
+function requireTarget(target, domain) {
+    if (target === null || target === undefined) {
+        throw new Error(`mod registry: the "${domain}" registry is not available in this game (host did not wire it)`);
+    }
+    return target;
+}
+/**
+ * Build the capability-gated registry host over the live registries. Pass the
+ * plugin's AgentCapabilities (from CapabilitySet.fromManifest); omit for a fully
+ * trusted host. The gate is checked at each call, so a plugin that never touches
+ * a domain never needs its capability.
+ */
+export function createModRegistryHost(targets, capabilities) {
+    return {
+        effects: {
+            register(code, def) {
+                requireCap(capabilities, "effect");
+                requireTarget(targets.effects, "effect").register(code, def);
+            },
+            isRegistered(code) {
+                requireCap(capabilities, "effect");
+                return requireTarget(targets.effects, "effect").isRegistered(code);
+            },
+        },
+        rooms: {
+            register(name, builder) {
+                requireCap(capabilities, "room");
+                requireTarget(targets.rooms, "room").register(name, builder);
+            },
+        },
+        commands: {
+            register(code, action) {
+                requireCap(capabilities, "command");
+                requireTarget(targets.commands, "command").register(code, action);
+            },
+            has(code) {
+                requireCap(capabilities, "command");
+                return requireTarget(targets.commands, "command").has(code);
+            },
+        },
+        monsters: {
+            setTurnHook(hook) {
+                requireCap(capabilities, "monster");
+                const state = requireTarget(targets.state, "monster");
+                if (hook)
+                    state.monsterTurnHook = hook;
+                else
+                    delete state.monsterTurnHook;
+            },
+        },
+        vocab: {
+            define(term) {
+                requireCap(capabilities, "vocab");
+                requireTarget(targets.vocab, "vocab").define(term);
+            },
+            has(kind, term) {
+                requireCap(capabilities, "vocab");
+                return requireTarget(targets.vocab, "vocab").has(kind, term);
+            },
+            list(kind) {
+                requireCap(capabilities, "vocab");
+                return requireTarget(targets.vocab, "vocab").list(kind);
+            },
+            setValue(entity, term, value) {
+                requireCap(capabilities, "vocab");
+                requireTarget(targets.vocab, "vocab").setValue(entity, term, value);
+            },
+            getValue(entity, term) {
+                requireCap(capabilities, "vocab");
+                return requireTarget(targets.vocab, "vocab").getValue(entity, term);
+            },
+            valuesOf(entity) {
+                requireCap(capabilities, "vocab");
+                return requireTarget(targets.vocab, "vocab").valuesOf(entity);
+            },
+        },
+    };
+}
+//# sourceMappingURL=registry-host.js.map

package/dist/mod/registry-host.js.map

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

package/dist/mod/save-blocks.d.ts

@@ -0,0 +1,201 @@
+/**
+ * Namespaced save blocks: the mod-lifecycle tiers layered over the flat JSON
+ * save (MOD_LIFECYCLE.md section 1, P7 phase 2).
+ *
+ * Phase 1 (mod/ids.ts) made every content cross-reference a namespaced string
+ * id. Phase 2 adds the three tiers the lifecycle design calls for on top of
+ * that:
+ *
+ * - The MANIFEST block (SaveManifest): the exact pack set that produced the
+ *   save - each pack's id/version (+ optional hash/source) and the resolved
+ *   load order - plus the core-owned determinism mode. This is the save's
+ *   profile fingerprint, and it travels WITH the save so a load can tell which
+ *   content is missing and whether the run is still reproducible.
+ * - Per-mod BAGS (mod:<id>): one opaque JSON bag per mod, versioned by the
+ *   mod's saveSchema. The engine never interprets a bag; a scripted plugin
+ *   persists whatever it likes and is the only thing that reads it back. A mod
+ *   update migrates its OWN bag (migrateModBag); core never participates.
+ * - The ORPHANS store (orphans:<id>@<version>): entities whose defining pack is
+ *   missing or shadowed are QUARANTINED here - frozen, inert, removed from
+ *   active play, but preserved verbatim - instead of being deleted or crashing
+ *   the load. Reinstall the pack (same major) and rehydrateSave puts them back.
+ *
+ * The determinism mode is a core-owned one-way ratchet (MOD_LIFECYCLE section
+ * 4, PORT_PLAN decision 22): a save starts "deterministic"; the first time a
+ * nondeterministic mod is enabled on it, core flips it to "nondeterministic"
+ * IRREVERSIBLY. Removing the mod never restores deterministic mode. Mods can
+ * trip the flip but can never reverse or prevent it.
+ *
+ * Everything here is pure and deterministic over the plain-JSON save: quarantine
+ * and rehydrate are read-time transforms of the SavedGame, so the on-disk
+ * FORMAT (the optional blocks below) is the load-bearing part that lands now,
+ * while the quarantine ALGORITHM can be refined later without a format change.
+ *
+ * SCOPE (documented, not silent): quarantine operates at whole-entity
+ * granularity keyed on each entity's PRIMARY definition id - a monster's race,
+ * an object's kind, a trap's kind, a lore record's race, a created-artifact id -
+ * which is the "a whole frost:frost-wyrm on the level" / "an item whose
+ * definition came from the missing mod" case the design centres on. This sweep
+ * covers every id-bearing collection a real SavedGame can carry that entity in:
+ * the live level (monsters + held objects, gear store / pack / equipment, floor
+ * piles, traps, lore, created artifacts) AND the birth_levels_persist
+ * frozen-level cache (save.levelCache), whose stored levels carry the same
+ * monster / held-object / floor / trap collections - a mod entity frozen there
+ * would otherwise reach deserializeLevelCache on load and throw (D1). Terrain
+ * features (the chunk feat grid / legend) are deliberately NOT quarantined:
+ * removing a terrain cell would tear a hole in the map, so a mod feature is a
+ * separate hard-incompatibility concern, not a quarantine case. Finer
+ * sub-property granularity (a mod ego or brand on an otherwise-core object, a
+ * mod origin-race on a core object) degrades to the base entity and is a
+ * documented follow-up. The player-facing recoveries built ON TOP of this store
+ * (stranded characters returning to town, mod items surfaced in the home, the
+ * stash view) are P-UI work per MOD_LIFECYCLE section 6 step 2.
+ */
+import type { SavedGame } from "../session/save.js";
+/** A plain JSON value - the shape of an opaque mod bag and an orphan payload. */
+export type JsonValue = null | boolean | number | string | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+/**
+ * The core-owned determinism mode carried by every save. A one-way ratchet:
+ * "deterministic" -> "nondeterministic" only, never back (see advanceDeterminism).
+ */
+export type DeterminismMode = "deterministic" | "nondeterministic";
+/** One pack in the manifest: its identity and where it came from. */
+export interface SavePackRef {
+    /** Namespace / pack id, e.g. "core", "frost". */
+    id: string;
+    /** Semver version string, e.g. "1.2.0". */
+    version: string;
+    /** Content hash of the pack that produced the save (optional). */
+    hash?: string;
+    /** Source (git URL + ref, or marketplace id) the pack was installed from. */
+    source?: string;
+}
+/**
+ * The manifest block: the exact pack set + resolved load order + determinism
+ * mode that produced the save. The save's profile fingerprint.
+ */
+export interface SaveManifest {
+    /** Every pack that contributed, keyed by id (order not significant here). */
+    packs: SavePackRef[];
+    /** The resolved load order (last-in-wins), pack ids in application order. */
+    loadOrder: string[];
+    /** The core-owned determinism mode (one-way ratchet). */
+    determinism: DeterminismMode;
+    /** True once a gameplay-affecting mod has made this save permanently non-scoring. */
+    modNoscore: boolean;
+}
+/**
+ * One mod's private save bag: opaque data the engine never interprets, tagged
+ * with the saveSchema version that wrote it so the mod can migrate its own bag.
+ */
+export interface ModBag {
+    /** The mod's saveSchema number when this bag was written. */
+    schema: number;
+    /** Whatever the mod chose to persist. Never read by core. */
+    data: JsonValue;
+}
+/** The kind of entity an orphan payload holds (drives rehydration placement). */
+export type OrphanKind = "monster" | "heldObject" | "gearObject" | "floorObject" | "trap" | "lore" | "artifactCreated" | "cacheMonster" | "cacheHeldObject" | "cacheFloorObject" | "cacheTrap";
+/** One quarantined entity: frozen verbatim, tagged for the stash view + rehydrate. */
+export interface OrphanEntry {
+    /** Which collection it came from (drives where rehydrateSave puts it back). */
+    kind: OrphanKind;
+    /** The content id that could not resolve ("what it is" in the stash view). */
+    ref: string;
+    /** The original serialized payload, verbatim, for exact rehydration. */
+    data: JsonValue;
+    /** Where it lived, so rehydrate can restore its position. */
+    locus: JsonValue;
+}
+/**
+ * The orphans store, keyed "<namespace>@<version>" - the pack (at the version
+ * that produced the save) whose absence quarantined these entities. Reinstalling
+ * that pack (same major) is what rehydrates them.
+ */
+export type OrphanStore = Record<string, OrphanEntry[]>;
+/**
+ * The base game's pack version: pack zero's version in the save manifest.
+ *
+ * It used to be its own string literal, "kept in sync with
+ * packages/core/package.json" by hand, and was not - core moved to 0.9.0 while
+ * every new save went on recording core as 0.1.0. Core DOES have a runtime
+ * version constant (version.ts, deliberately outside the barrel so citing it
+ * makes no cycle), so it cites that instead.
+ *
+ * Changing it does not invalidate an older save: orphanedNamespaces skips the
+ * core pack outright, and versionMap's versions are only ever used to key
+ * quarantined MOD entities. An existing save keeps whatever it recorded.
+ */
+export declare const CORE_PACK_VERSION = "0.10.0";
+/** A core-only manifest: the base game with no mods, deterministic. */
+export declare function coreOnlyManifest(): SaveManifest;
+/**
+ * Advance the determinism mode (MOD_LIFECYCLE section 4). The flip to
+ * "nondeterministic" is irreversible: once a save is nondeterministic it stays
+ * so regardless of the argument, so removing a mod can never "cleanse" a save
+ * back to deterministic. Enabling a nondeterministic mod on a still-deterministic
+ * save flips it once, seamlessly.
+ */
+export declare function advanceDeterminism(current: DeterminismMode, enablingNondeterministicMod: boolean): DeterminismMode;
+/** Advance the permanent scoring ratchet for gameplay-affecting mods. */
+export declare function advanceModNoscore(current: boolean, enablingGameplayMod: boolean): boolean;
+/** A mod's own bag migrator: old data + the schema it was written at -> new data. */
+export type BagMigrator = (data: JsonValue, fromSchema: number) => JsonValue;
+/**
+ * Migrate one mod bag to a target saveSchema (called at mod-load time when the
+ * mod's schema has advanced past the bag's). A no-op when the bag is already at
+ * or beyond the target; otherwise the mod's migrator rewrites its own data and
+ * the schema is stamped forward. Core never inspects `data`.
+ */
+export declare function migrateModBag(bag: ModBag, targetSchema: number, migrate: BagMigrator): ModBag;
+/**
+ * Compare the pack set that produced a save against the packs present now, and
+ * return the namespaces whose content is orphaned (present in the save's
+ * manifest but not currently loaded). "core" is never orphaned - a save whose
+ * core is absent is an engine-incompatibility that the load rejects outright,
+ * not a quarantine case.
+ *
+ * The harder REFUSE-to-load gate (a still-enabled mod's REQUIRED dependency is
+ * missing) is the load-order resolver's job (mod-sdk resolveLoadOrder, phase 4);
+ * this function is only the save-side "what did this save use that is gone now".
+ */
+export declare function orphanedNamespaces(manifest: SaveManifest, present: ReadonlySet<string>): string[];
+/** The total number of quarantined entities across the store (decision-8 count). */
+export declare function orphanCount(store: OrphanStore | undefined): number;
+/** The namespace of a content id, or null when it has none (malformed / bare). */
+export declare function namespaceOf(id: string): string | null;
+/** The outcome of a quarantine pass. */
+export interface QuarantineResult {
+    /** The save with orphaned entities removed and folded into `orphans`. */
+    save: SavedGame;
+    /** The merged orphan store (any pre-existing orphans + the newly quarantined). */
+    orphans: OrphanStore;
+    /** How many entities were newly quarantined THIS pass. */
+    quarantined: number;
+}
+/**
+ * Move every entity whose defining pack is absent into the orphans store,
+ * returning a pruned save whose remaining content all resolves against the
+ * present packs (so the normal deserializers never see a missing-mod id). Pure:
+ * the input save is not mutated. Any orphans already carried by the save are
+ * preserved and merged with the newly quarantined set.
+ *
+ * `present(namespace)` decides membership; `orphanedNamespaces` computes the
+ * missing set from the manifest, and the manifest supplies each pack's version
+ * for the orphan-store key.
+ */
+export declare function quarantineSave(save: SavedGame, manifest: SaveManifest, present: (namespace: string) => boolean): QuarantineResult;
+/**
+ * Restore quarantined entities whose pack is present again, returning a save
+ * with those orphans reinserted and dropped from the store; orphans whose pack
+ * is still absent stay quarantined. Pure: the input save is not mutated.
+ *
+ * The inverse of quarantineSave for the common "reinstall the mod" path. Two
+ * documented, deliberate degradations: a rehydrated monster does not rebuild its
+ * old group cohesion (its group entry may have been dissolved on quarantine),
+ * and a rehydrated equipped item returns to the pack rather than auto-re-equipping.
+ */
+export declare function rehydrateSave(save: SavedGame, present: (namespace: string) => boolean): SavedGame;
+//# sourceMappingURL=save-blocks.d.ts.map

package/dist/mod/save-blocks.d.ts.map

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