@rpgm-tools/neo-angband-core 0.10.0

package/dist/host/memory.js

@@ -0,0 +1,105 @@
+/**
+ * An in-memory HostIo: the reference implementation of the host contract, and
+ * the one the tests drive.
+ *
+ * It exists so the file-shaped code paths can be exercised WITHOUT a platform.
+ * Before the host seam, the only way to test a dump was to reach into the web
+ * layer's localStorage shim, so core code that wrote files could not be tested
+ * from core at all - and the failure paths (a write that fails, a file that is
+ * older than another) had no way to be provoked deliberately.
+ *
+ * Capabilities default to full, because this host really can do everything the
+ * contract asks; `failWrites` and `truncateWrites` let a test provoke
+ * upstream's two distinct write failures on demand.
+ */
+import { FileMode, HostDir } from "./io.js";
+const FULL = {
+    realFiles: true,
+    argv: true,
+    signals: true,
+    /** ANGBAND_TERM_MAX (ui-term.h:244). */
+    termCount: 8,
+    directories: true,
+};
+/** A HostIo backed by a Map per directory, with an inspectable file table. */
+export class MemoryHost {
+    capabilities;
+    files = new Map();
+    /** Monotonic write counter, standing in for an mtime so `newer` is decidable. */
+    stamps = new Map();
+    clock = 0;
+    cmdline;
+    failSet;
+    truncSet;
+    constructor(opts = {}) {
+        this.capabilities = { ...FULL, ...opts.capabilities };
+        this.cmdline = opts.argv ?? [];
+        this.failSet = new Set(opts.failWrites ?? []);
+        this.truncSet = new Set(opts.truncateWrites ?? []);
+    }
+    key(dir, name) {
+        return `${dir}/${name}`;
+    }
+    displayPath(dir, name) {
+        return `${dir}/${name}`;
+    }
+    exists(dir, name) {
+        return this.files.has(this.key(dir, name));
+    }
+    read(dir, name) {
+        return this.files.get(this.key(dir, name)) ?? null;
+    }
+    write(dir, name, text, mode = FileMode.WRITE) {
+        if (this.failSet.has(name))
+            return "create-failed";
+        const k = this.key(dir, name);
+        /* MODE_APPEND keeps the current contents; MODE_WRITE overwrites them. */
+        const body = mode === FileMode.APPEND ? (this.files.get(k) ?? "") + text : text;
+        if (this.truncSet.has(name))
+            return "close-failed";
+        this.files.set(k, body);
+        this.stamps.set(k, ++this.clock);
+        return "ok";
+    }
+    remove(dir, name) {
+        const k = this.key(dir, name);
+        this.stamps.delete(k);
+        return this.files.delete(k);
+    }
+    move(dir, from, to) {
+        const text = this.read(dir, from);
+        if (text === null)
+            return false;
+        if (this.write(dir, to, text) !== "ok")
+            return false;
+        return this.remove(dir, from);
+    }
+    newer(dir, first, second) {
+        const a = this.stamps.get(this.key(dir, first));
+        const b = this.stamps.get(this.key(dir, second));
+        /* file_newer's own answer when either side is missing: it stats both and
+         * returns false unless the first exists and is strictly newer. */
+        if (a === undefined)
+            return false;
+        if (b === undefined)
+            return true;
+        return a > b;
+    }
+    list(dir) {
+        const prefix = `${dir}/`;
+        const out = [];
+        for (const k of this.files.keys()) {
+            if (k.startsWith(prefix))
+                out.push(k.slice(prefix.length));
+        }
+        return out.sort((x, y) => x.localeCompare(y));
+    }
+    argv() {
+        return this.cmdline;
+    }
+    /** Test helper: every file, as dir/name -> text. */
+    snapshot() {
+        return Object.fromEntries(this.files);
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/host/memory.js.map

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

package/dist/host/raw.d.ts

@@ -0,0 +1,114 @@
+/**
+ * The real-filesystem HostIo, split so there is exactly ONE copy of the
+ * semantics.
+ *
+ * WHY THIS EXISTS
+ *
+ * Two front ends have a real filesystem under them - the CLI (node:fs directly)
+ * and the Electron desktop build (node:fs in the main process, reached from the
+ * renderer over IPC). They are the same z-file.c, so they must not be two
+ * hand-written adapters that agree today and drift tomorrow. `file_newer`'s
+ * three-way rule is the clearest example: it is the gate on ui-game.c's
+ * panic-save prompt, and "second is missing" returning TRUE rather than false
+ * (z-file.c:952-967) is the kind of detail one of two copies would get wrong.
+ *
+ * So the split is:
+ *
+ *   RawFs      - the syscall surface. One method per operation, no rules.
+ *                Each host implements this: node:fs directly, or an IPC hop.
+ *   RawFsHost  - z-file.c's rules over any RawFs. Written once, tested once.
+ *
+ * The traversal guard deliberately lives in the RawFs implementations rather
+ * than here, because on the Electron split it is a SECURITY boundary and has to
+ * be enforced in the trusted process. Enforcing it here as well would read as if
+ * the renderer's copy were the one that mattered.
+ */
+import type { HostCapabilities, HostIo, WriteOutcome } from "./io.js";
+import { FileMode, FileType, HostDir } from "./io.js";
+/**
+ * The raw operations a real filesystem provides, addressed the way HostIo is:
+ * by (directory, leaf name), never by a composed path. An implementation owns
+ * path composition, because that is path_build's job and it is host-specific.
+ *
+ * Every method reports failure by return value; none throws. That mirrors
+ * z-file.c, where file_open returns NULL rather than dying.
+ */
+export interface RawFs {
+    /**
+     * path_build(dir, name) for DISPLAY only - the text upstream prints in
+     * "Cannot open '%s'." A name that escapes its directory still has to render
+     * as something, so this never returns null.
+     */
+    displayPath(dir: HostDir, name: string): string;
+    /** stat(p).isFile(). False for a directory, which is what file_exists means. */
+    isFile(dir: HostDir, name: string): boolean;
+    /** The whole file as text, or null if it cannot be read. */
+    readText(dir: HostDir, name: string): string | null;
+    /**
+     * open + write + close, reporting WHICH phase failed. The two are separate
+     * because upstream prints different messages for them at one call site
+     * (wiz-spoil.c's "Cannot create spoiler file." / "Cannot close spoiler file.").
+     */
+    writeText(dir: HostDir, name: string, text: string, append: boolean, ftype: FileType): WriteOutcome;
+    /** unlink. */
+    unlink(dir: HostDir, name: string): boolean;
+    /** rename within one directory. */
+    rename(dir: HostDir, from: string, to: string): boolean;
+    /** Modification time in milliseconds, or null when the file is not there. */
+    mtime(dir: HostDir, name: string): number | null;
+    /** The files (not subdirectories) in a directory. */
+    listFiles(dir: HostDir): string[];
+}
+/** Every writable HostDir, for hosts that need to create the tree up front. */
+export declare const ALL_HOST_DIRS: readonly HostDir[];
+export interface RawFsHostOpts {
+    /** argv minus the program name. */
+    argv?: readonly string[];
+    /**
+     * Terminals this front end can show. Upstream's ANGBAND_TERM_MAX is 8
+     * (ui-term.h:244); a single-canvas front end is 1.
+     */
+    termCount?: number;
+    /**
+     * Whether this front end is actually told the process is dying, so a panic
+     * save can be written. True for a process that installs handlers itself (the
+     * CLI). A sandboxed renderer only has this if its host process forwards the
+     * event, so it must declare what it really has rather than inherit a yes -
+     * capabilities describe the platform, and a false yes here silently removes
+     * ui-game.c's panic save instead of removing any code.
+     */
+    signals?: boolean;
+}
+/**
+ * z-file.c's rules over any RawFs. This is the full-capability host: real
+ * files, a command line, and a process that can be signalled.
+ */
+export declare class RawFsHost implements HostIo {
+    readonly capabilities: HostCapabilities;
+    private readonly raw;
+    private readonly cmdline;
+    constructor(raw: RawFs, opts?: RawFsHostOpts);
+    displayPath(dir: HostDir, name: string): string;
+    /** file_exists (z-file.h:135) - exists AND is a file. */
+    exists(dir: HostDir, name: string): boolean;
+    read(dir: HostDir, name: string): string | null;
+    write(dir: HostDir, name: string, text: string, mode?: FileMode, ftype?: FileType): WriteOutcome;
+    remove(dir: HostDir, name: string): boolean;
+    move(dir: HostDir, from: string, to: string): boolean;
+    /**
+     * file_newer (z-file.c:952-967), all three branches:
+     *
+     *   if (stat(first,  ...) != 0) return false;   // first missing -> not newer
+     *   if (stat(second, ...) != 0) return true;    // second missing -> newer
+     *   return stat1.st_mtime > stat2.st_mtime;
+     *
+     * Never null here: a real filesystem always knows. The null in HostIo exists
+     * for BrowserHost, which stores no mtime and must say "cannot tell" rather
+     * than guess false - that guess would silently delete ui-game.c:709-720's
+     * panic-save prompt.
+     */
+    newer(dir: HostDir, first: string, second: string): boolean;
+    list(dir: HostDir): string[];
+    argv(): readonly string[];
+}
+//# sourceMappingURL=raw.d.ts.map

package/dist/host/raw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw.d.ts","sourceRoot":"","sources":["../../src/host/raw.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,WAAW,KAAK;IACpB;;;;OAIG;IACH,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAEhD,gFAAgF;IAChF,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAE5C,4DAA4D;IAC5D,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAEpD;;;;OAIG;IACH,SAAS,CACP,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,QAAQ,GACd,YAAY,CAAC;IAEhB,cAAc;IACd,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAE5C,mCAAmC;IACnC,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAExD,6EAA6E;IAC7E,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAEjD,qDAAqD;IACrD,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC;CACnC;AAED,+EAA+E;AAC/E,eAAO,MAAM,aAAa,EAAE,SAAS,OAAO,EAM3C,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,SAAU,YAAW,MAAM;IACtC,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;gBAEhC,GAAG,EAAE,KAAK,EAAE,IAAI,GAAE,aAAkB;IAYhD,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAI/C,yDAAyD;IACzD,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAI3C,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAI/C,KAAK,CACH,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,QAAyB,EAC/B,KAAK,GAAE,QAAwB,GAC9B,YAAY;IASf,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAI3C,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO;IAIrD;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAQ3D,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE;IAI5B,IAAI,IAAI,SAAS,MAAM,EAAE;CAG1B"}

package/dist/host/raw.js

@@ -0,0 +1,107 @@
+/**
+ * The real-filesystem HostIo, split so there is exactly ONE copy of the
+ * semantics.
+ *
+ * WHY THIS EXISTS
+ *
+ * Two front ends have a real filesystem under them - the CLI (node:fs directly)
+ * and the Electron desktop build (node:fs in the main process, reached from the
+ * renderer over IPC). They are the same z-file.c, so they must not be two
+ * hand-written adapters that agree today and drift tomorrow. `file_newer`'s
+ * three-way rule is the clearest example: it is the gate on ui-game.c's
+ * panic-save prompt, and "second is missing" returning TRUE rather than false
+ * (z-file.c:952-967) is the kind of detail one of two copies would get wrong.
+ *
+ * So the split is:
+ *
+ *   RawFs      - the syscall surface. One method per operation, no rules.
+ *                Each host implements this: node:fs directly, or an IPC hop.
+ *   RawFsHost  - z-file.c's rules over any RawFs. Written once, tested once.
+ *
+ * The traversal guard deliberately lives in the RawFs implementations rather
+ * than here, because on the Electron split it is a SECURITY boundary and has to
+ * be enforced in the trusted process. Enforcing it here as well would read as if
+ * the renderer's copy were the one that mattered.
+ */
+import { FileMode, FileType, HostDir } from "./io.js";
+/** Every writable HostDir, for hosts that need to create the tree up front. */
+export const ALL_HOST_DIRS = [
+    HostDir.USER,
+    HostDir.SAVE,
+    HostDir.PANIC,
+    HostDir.SCORES,
+    HostDir.ARCHIVE,
+];
+/**
+ * z-file.c's rules over any RawFs. This is the full-capability host: real
+ * files, a command line, and a process that can be signalled.
+ */
+export class RawFsHost {
+    capabilities;
+    raw;
+    cmdline;
+    constructor(raw, opts = {}) {
+        this.raw = raw;
+        this.cmdline = opts.argv ?? [];
+        this.capabilities = {
+            realFiles: true,
+            argv: true,
+            signals: opts.signals ?? true,
+            termCount: opts.termCount ?? 1,
+            directories: true,
+        };
+    }
+    displayPath(dir, name) {
+        return this.raw.displayPath(dir, name);
+    }
+    /** file_exists (z-file.h:135) - exists AND is a file. */
+    exists(dir, name) {
+        return this.raw.isFile(dir, name);
+    }
+    read(dir, name) {
+        return this.raw.readText(dir, name);
+    }
+    write(dir, name, text, mode = FileMode.WRITE, ftype = FileType.TEXT) {
+        /* MODE_APPEND must not truncate: prefs_save appends its dump after
+         * remove_old_dump has stripped the previous one. MODE_READ reaching a write
+         * is a caller bug, and truncating on it would destroy the file, so it is
+         * treated as the open failure it would be in C. */
+        if (mode === FileMode.READ)
+            return "create-failed";
+        return this.raw.writeText(dir, name, text, mode === FileMode.APPEND, ftype);
+    }
+    remove(dir, name) {
+        return this.raw.unlink(dir, name);
+    }
+    move(dir, from, to) {
+        return this.raw.rename(dir, from, to);
+    }
+    /**
+     * file_newer (z-file.c:952-967), all three branches:
+     *
+     *   if (stat(first,  ...) != 0) return false;   // first missing -> not newer
+     *   if (stat(second, ...) != 0) return true;    // second missing -> newer
+     *   return stat1.st_mtime > stat2.st_mtime;
+     *
+     * Never null here: a real filesystem always knows. The null in HostIo exists
+     * for BrowserHost, which stores no mtime and must say "cannot tell" rather
+     * than guess false - that guess would silently delete ui-game.c:709-720's
+     * panic-save prompt.
+     */
+    newer(dir, first, second) {
+        const a = this.raw.mtime(dir, first);
+        if (a === null)
+            return false;
+        const b = this.raw.mtime(dir, second);
+        if (b === null)
+            return true;
+        return a > b;
+    }
+    list(dir) {
+        return this.raw.listFiles(dir);
+    }
+    argv() {
+        return this.cmdline;
+    }
+}
+//# sourceMappingURL=raw.js.map

package/dist/host/raw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw.js","sourceRoot":"","sources":["../../src/host/raw.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAkDtD,+EAA+E;AAC/E,MAAM,CAAC,MAAM,aAAa,GAAuB;IAC/C,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO;CAChB,CAAC;AAqBF;;;GAGG;AACH,MAAM,OAAO,SAAS;IACX,YAAY,CAAmB;IACvB,GAAG,CAAQ;IACX,OAAO,CAAoB;IAE5C,YAAY,GAAU,EAAE,OAAsB,EAAE;QAC9C,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;QAC/B,IAAI,CAAC,YAAY,GAAG;YAClB,SAAS,EAAE,IAAI;YACf,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI;YAC7B,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,CAAC;YAC9B,WAAW,EAAE,IAAI;SAClB,CAAC;IACJ,CAAC;IAED,WAAW,CAAC,GAAY,EAAE,IAAY;QACpC,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,yDAAyD;IACzD,MAAM,CAAC,GAAY,EAAE,IAAY;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,CAAC,GAAY,EAAE,IAAY;QAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CACH,GAAY,EACZ,IAAY,EACZ,IAAY,EACZ,OAAiB,QAAQ,CAAC,KAAK,EAC/B,QAAkB,QAAQ,CAAC,IAAI;QAE/B;;;2DAGmD;QACnD,IAAI,IAAI,KAAK,QAAQ,CAAC,IAAI;YAAE,OAAO,eAAe,CAAC;QACnD,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,KAAK,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,CAAC,GAAY,EAAE,IAAY;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,CAAC,GAAY,EAAE,IAAY,EAAE,EAAU;QACzC,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,GAAY,EAAE,KAAa,EAAE,MAAc;QAC/C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC7B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IAED,IAAI,CAAC,GAAY;QACf,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,180 @@
+/**
+ * @rpgm-tools/neo-angband-core - the headless game engine.
+ *
+ * Phase 0 scaffold. The engine grows here by dependency order:
+ * rng -> dice/expressions -> flags -> world kernel -> entities ->
+ * effects -> game loop. See docs/PORT_PLAN.md at the repository root.
+ *
+ * Parity baseline: Angband 4.2.6 (see reference/ and parity/).
+ */
+export * from "./rng.js";
+export * from "./loc.js";
+export * from "./events.js";
+export * from "./cmd.js";
+export * from "./msg.js";
+export * from "./color.js";
+export * from "./bitflag.js";
+export * from "./guard.js";
+export * from "./expression.js";
+export * from "./dice.js";
+export * from "./generated/index.js";
+export * from "./constants.js";
+export * from "./version.js";
+export * from "./world/feature.js";
+export * from "./world/chunk.js";
+export * from "./world/view.js";
+export * from "./world/scatter.js";
+export * from "./world/flow.js";
+export * from "./world/project.js";
+export * from "./world/projection.js";
+export * from "./world/trap.js";
+export * from "./effects/effect.js";
+export * from "./effects/effect-info.js";
+export * from "./effects/effect-choice.js";
+export * from "./effects/interpreter.js";
+export * from "./effects/handlers.js";
+export * from "./mon/types.js";
+export * from "./mon/bind.js";
+export * from "./mon/monster.js";
+export * from "./mon/make.js";
+export * from "./mon/summon.js";
+export * from "./mon/predicate.js";
+export * from "./mon/timed.js";
+export * from "./mon/take-hit.js";
+export * from "./mon/spell.js";
+export * from "./mon/desc.js";
+export * from "./mon/knowledge-groups.js";
+export * from "./mon/project-mon.js";
+export * from "./obj/types.js";
+export * from "./obj/bind.js";
+export * from "./obj/object.js";
+export * from "./obj/chest.js";
+export * from "./obj/make.js";
+export * from "./obj/power.js";
+export * from "./obj/value.js";
+export * from "./obj/knowledge.js";
+export * from "./obj/ignore.js";
+export * from "./obj/known-object.js";
+export * from "./obj/artifact-known.js";
+export * from "./obj/artifact-fake.js";
+export * from "./obj/desc.js";
+export * from "./obj/object-info.js";
+export * from "./obj/randname.js";
+export * from "./obj/flavor.js";
+export * from "./obj/randart.js";
+export * from "./player/types.js";
+export * from "./player/options.js";
+export * from "./player/bind.js";
+export * from "./player/player.js";
+export * from "./player/calcs.js";
+export * from "./player/timed.js";
+export * from "./player/take-hit.js";
+export * from "./player/spell.js";
+export * from "./player/birth.js";
+export * from "./player/history.js";
+export * from "./player/abilities.js";
+export * from "./player/shape-lore.js";
+export * from "./save/buffer.js";
+export * from "./save/compress.js";
+export * from "./save/description.js";
+export * from "./save/integrity.js";
+export * from "./gen/util.js";
+export * from "./gen/room.js";
+export * from "./gen/cave.js";
+export * from "./gen/generate.js";
+export * from "./gen/gen-monster.js";
+export * from "./combat/index.js";
+export * from "./store/types.js";
+export * from "./store/bind.js";
+export * from "./store/price.js";
+export * from "./store/store.js";
+export * from "./store/transact.js";
+export * from "./store/store-cmd.js";
+export * from "./session/boot.js";
+export * from "./session/game.js";
+export * from "./session/save.js";
+export * from "./mod/hooks.js";
+export * from "./mod/save-blocks.js";
+export * from "./mod/ids.js";
+export * from "./mod/registry-host.js";
+export * from "./mod/vocabulary.js";
+export * from "./agent/index.js";
+export * from "./game/energy.js";
+export * from "./game/context.js";
+export * from "./game/monster-turn.js";
+export * from "./game/scheduler.js";
+export * from "./game/player-turn.js";
+export * from "./game/project-monster.js";
+export * from "./game/project-player.js";
+export * from "./game/project-cast.js";
+export * from "./game/effect-env.js";
+export * from "./game/effect-game-env.js";
+export * from "./game/effect-attack.js";
+export * from "./game/effect-general.js";
+export * from "./game/effect-monster.js";
+export * from "./game/effect-teleport.js";
+export * from "./game/effect-terrain.js";
+export * from "./game/effect-item.js";
+export * from "./game/effect-melee.js";
+export * from "./game/effect-summon.js";
+export * from "./game/effect-detect.js";
+export * from "./game/known.js";
+export * from "./game/inscription-confirm.js";
+export * from "./game/target.js";
+export * from "./game/target-loop.js";
+export * from "./game/mon-cmd.js";
+export * from "./game/describe.js";
+export * from "./game/history.js";
+export * from "./game/object-inspect.js";
+export * from "./game/mon-message.js";
+export * from "./game/mon-list.js";
+export * from "./game/obj-list.js";
+export * from "./game/display.js";
+export * from "./game/char-sheet.js";
+export * from "./game/lore-color.js";
+export * from "./game/ui-entry.js";
+export * from "./game/equip-cmp.js";
+export * from "./game/mon-shape.js";
+export * from "./mon/lore.js";
+export * from "./mon/lore-describe.js";
+export { squareIsOpenLive, squareIsEmptyLive, squareAllowsSummon, placeNewMonsterOne, placeNewMonster as placeNewMonsterLive, pickAndPlaceMonster as pickAndPlaceMonsterLive, summonSpecific, selectShape, wipeMonsterCounts, countMonsterRaces, } from "./game/mon-place.js";
+export type { MonPlaceDeps as LiveMonPlaceDeps, SummonDeps, } from "./game/mon-place.js";
+export * from "./game/thrust.js";
+export * from "./game/mon-cast.js";
+export * from "./game/mon-ranged.js";
+export * from "./game/mon-group.js";
+export * from "./game/floor.js";
+export * from "./game/dump-level.js";
+export * from "./game/spoil.js";
+export * from "./game/pickup.js";
+export * from "./game/obj-cmd.js";
+export * from "./game/cave-cmd.js";
+export * from "./game/chest.js";
+export * from "./game/trap.js";
+export * from "./game/spell-cmd.js";
+export * from "./game/ranged-cmd.js";
+export * from "./game/loop.js";
+export * from "./game/ignore-cmd.js";
+export * from "./game/wizard.js";
+export * from "./sound/index.js";
+export * from "./score/types.js";
+export * from "./score/score.js";
+export * from "./score/display.js";
+export * from "./visuals/index.js";
+export * from "./host/io.js";
+export * from "./host/memory.js";
+export * from "./host/raw.js";
+export * from "./host/bridge.js";
+export * from "./host/args.js";
+export { OF_SIZE, ELEM_MAX } from "./obj/types.js";
+export { nextGrid } from "./world/view.js";
+export { objDescNameFormat } from "./obj/desc.js";
+export type { CriticalLevel } from "./combat/hit.js";
+export type { MeleeAttack, MeleeBlow } from "./combat/melee.js";
+export type { HitType } from "./combat/hit.js";
+export { EXTRACT_ENERGY, turnEnergy } from "./mon/monster.js";
+export { squareIsEmpty } from "./gen/util.js";
+export { squareCanPutItem } from "./gen/util.js";
+export { placeTrap } from "./gen/util.js";
+export * from "./game/gear.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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