@rpgm-tools/neo-angband-core 0.10.0

package/dist/host/bridge.js

@@ -0,0 +1,176 @@
+/**
+ * RawFs across a process boundary, with both ends defined in one file.
+ *
+ * WHY THIS EXISTS
+ *
+ * On the desktop build the filesystem and the game are in different processes:
+ * Electron's renderer is sandboxed (no node:fs), and the main process is where
+ * the real files are. So the game's host has to make a call across that gap.
+ *
+ * The client and the server are written here together, deliberately. A hand-
+ * written pair on either side of an IPC channel is two things that must agree
+ * about op names and argument order forever, and nothing checks that they do -
+ * exactly the drift the RawFs/RawFsHost split exists to prevent. Here, one file
+ * owns the wire format.
+ *
+ * WHY SYNCHRONOUS
+ *
+ * z-file.c is synchronous, and so is every caller of it. `prefs_save` writes
+ * inside a menu handler; the panic-save writes from a signal handler; the game
+ * loop reads a pref file inline. Making the host async would push `await` up
+ * through the whole command layer and change the game's control flow to suit the
+ * transport - the same mistake, in a new place, as letting the browser decide
+ * what a file is. The writes here are a few kilobytes to a local disk.
+ *
+ * WHY THE CLIENT COERCES EVERYTHING
+ *
+ * The transport can fail in ways a function call cannot: the channel may not be
+ * registered, the other end may be a different version, the reply may be
+ * undefined. Every result is therefore narrowed to the type RawFs promises, and
+ * anything unexpected becomes that operation's FAILURE value rather than an
+ * exception. That is z-file.c's discipline - file_open returns NULL, it does not
+ * die - and it is what keeps a broken bridge from throwing halfway through a save.
+ */
+import { FileType, HostDir } from "./io.js";
+/** The operation names on the wire. Exported so a host can log or gate them. */
+export const RAW_FS_OPS = [
+    "displayPath",
+    "isFile",
+    "readText",
+    "writeText",
+    "unlink",
+    "rename",
+    "mtime",
+    "listFiles",
+];
+/** Whether a value is one of init.c's five writable directories. */
+export function isHostDir(v) {
+    return (v === HostDir.USER ||
+        v === HostDir.SAVE ||
+        v === HostDir.PANIC ||
+        v === HostDir.SCORES ||
+        v === HostDir.ARCHIVE);
+}
+/** Whether a value is a valid write outcome as it comes back off the wire. */
+function toWriteOutcome(v) {
+    /* Anything unrecognised is the open failure: reporting "could not create it"
+     * about a write that may not have happened is the safe direction. Claiming
+     * success is the failure mode already recorded against persistSave. */
+    return v === "ok" || v === "close-failed" ? v : "create-failed";
+}
+/**
+ * The CLIENT half: a RawFs that forwards every call over a transport. Used in
+ * the sandboxed renderer, where `send` is a synchronous IPC call.
+ */
+export function rawFsOverTransport(send) {
+    /** A transport hop that turns a thrown transport error into a null result. */
+    const call = (op, args) => {
+        try {
+            return send(op, args);
+        }
+        catch {
+            /* A dead channel must look like a failed syscall, not a crash. */
+            return undefined;
+        }
+    };
+    return {
+        displayPath(dir, name) {
+            const r = call("displayPath", [dir, name]);
+            /* Display text only, so a broken bridge still produces something
+             * printable rather than "undefined" inside a message. */
+            return typeof r === "string" ? r : `${dir}/${name}`;
+        },
+        isFile(dir, name) {
+            return call("isFile", [dir, name]) === true;
+        },
+        readText(dir, name) {
+            const r = call("readText", [dir, name]);
+            return typeof r === "string" ? r : null;
+        },
+        writeText(dir, name, text, append, ftype) {
+            return toWriteOutcome(call("writeText", [dir, name, text, append, ftype]));
+        },
+        unlink(dir, name) {
+            return call("unlink", [dir, name]) === true;
+        },
+        rename(dir, from, to) {
+            return call("rename", [dir, from, to]) === true;
+        },
+        mtime(dir, name) {
+            const r = call("mtime", [dir, name]);
+            /* Not Number.isFinite on a non-number: NaN or Infinity would make
+             * file_newer's comparison meaningless, so both are "cannot tell". */
+            return typeof r === "number" && Number.isFinite(r) ? r : null;
+        },
+        listFiles(dir) {
+            const r = call("listFiles", [dir]);
+            if (!Array.isArray(r))
+                return [];
+            return r.filter((e) => typeof e === "string");
+        },
+    };
+}
+/**
+ * The SERVER half: turns a real RawFs into a transport handler. Used in the
+ * trusted process.
+ *
+ * Every argument is validated here, because they arrive from the renderer and
+ * the renderer is the untrusted side. An unknown op or a malformed argument list
+ * returns that operation's failure value rather than throwing, so a hostile or
+ * buggy caller cannot take down the main process.
+ */
+export function serveRawFs(raw) {
+    const str = (v) => (typeof v === "string" ? v : null);
+    return (op, args) => {
+        const dir = args[0];
+        if (!isHostDir(dir)) {
+            /* Not a directory we own. Report each op's failure value. */
+            return op === "listFiles" ? [] : op === "readText" || op === "mtime" ? null
+                : op === "writeText" ? "create-failed"
+                    : op === "displayPath" ? "" : false;
+        }
+        switch (op) {
+            case "listFiles":
+                return raw.listFiles(dir);
+            case "displayPath": {
+                const name = str(args[1]);
+                return name === null ? "" : raw.displayPath(dir, name);
+            }
+            case "isFile": {
+                const name = str(args[1]);
+                return name === null ? false : raw.isFile(dir, name);
+            }
+            case "readText": {
+                const name = str(args[1]);
+                return name === null ? null : raw.readText(dir, name);
+            }
+            case "mtime": {
+                const name = str(args[1]);
+                return name === null ? null : raw.mtime(dir, name);
+            }
+            case "unlink": {
+                const name = str(args[1]);
+                return name === null ? false : raw.unlink(dir, name);
+            }
+            case "rename": {
+                const from = str(args[1]);
+                const to = str(args[2]);
+                return from === null || to === null ? false : raw.rename(dir, from, to);
+            }
+            case "writeText": {
+                const name = str(args[1]);
+                const text = str(args[2]);
+                if (name === null || text === null)
+                    return "create-failed";
+                const append = args[3] === true;
+                const ftype = typeof args[4] === "number" ? args[4] : FileType.TEXT;
+                return raw.writeText(dir, name, text, append, ftype);
+            }
+            default:
+                /* An op this server does not know. False is the least destructive
+                 * answer: it reads as "that did not work" to every boolean caller. */
+                return false;
+        }
+    };
+}
+//# sourceMappingURL=bridge.js.map

package/dist/host/bridge.js.map

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

package/dist/host/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The host layer on its own, importable without the game engine.
+ *
+ * core's main barrel re-exports everything, which is right for a front end that
+ * runs the game. The Electron MAIN process does not run the game: it only serves
+ * z-file.c to the renderer. Importing the barrel there pulled the entire engine -
+ * rules, generation, monsters - into the main-process bundle, 479 kB of code a
+ * file write has no use for.
+ *
+ * So the host is reachable as `@rpgm-tools/neo-angband-core/host`. Same modules, same
+ * single copy of the semantics; just a door that does not open onto the rest.
+ */
+export * from "./io.js";
+export * from "./raw.js";
+export * from "./bridge.js";
+export * from "./memory.js";
+export * from "./args.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/host/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/dist/host/index.js

@@ -0,0 +1,18 @@
+/**
+ * The host layer on its own, importable without the game engine.
+ *
+ * core's main barrel re-exports everything, which is right for a front end that
+ * runs the game. The Electron MAIN process does not run the game: it only serves
+ * z-file.c to the renderer. Importing the barrel there pulled the entire engine -
+ * rules, generation, monsters - into the main-process bundle, 479 kB of code a
+ * file write has no use for.
+ *
+ * So the host is reachable as `@rpgm-tools/neo-angband-core/host`. Same modules, same
+ * single copy of the semantics; just a door that does not open onto the rest.
+ */
+export * from "./io.js";
+export * from "./raw.js";
+export * from "./bridge.js";
+export * from "./memory.js";
+export * from "./args.js";
+//# sourceMappingURL=index.js.map

package/dist/host/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/host/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/dist/host/io.d.ts

@@ -0,0 +1,169 @@
+/**
+ * The host layer: z-file.c's file access and init.c's directory set, as an
+ * interface core can be handed instead of a platform it has to guess at.
+ *
+ * WHY THIS EXISTS
+ *
+ * Upstream is not a browser program that happens to run on desktops; it is a
+ * desktop program with several front ends (main-sdl2.c, main-gcu.c, main-win.c)
+ * over ONE host layer (z-file.c) and ONE directory set (init.c's ANGBAND_DIR_*).
+ * The port had the first half of that - a platform-agnostic core with the front
+ * end in packages/web - but no second half: every feature that needed a file
+ * asked the browser, got "no", and was then quietly reshaped to fit the answer.
+ *
+ * That reshaping is the bug. Measured on 2026-07-28, 18 of the 35 remaining
+ * text-census absences exist only because there is no host filesystem, no argv
+ * and no process to receive a signal - not because the C was hard to read. And
+ * the damage is not limited to absences: a platform limit that goes unmodelled
+ * turns into an invented stand-in (the "use the CLI" spoiler line, the PNG
+ * screen dump), which is worse, because a stand-in FILLS the slot and neither
+ * census can see it.
+ *
+ * So the host is a first-class, injectable seam with three adapters:
+ *
+ *   - desktop (Electron main process, real node:fs)  - full capability
+ *   - cli     (node:fs directly)                     - full capability
+ *   - web     (localStorage, one key per file)       - reduced, and SAYS so
+ *
+ * THE RULE THIS ENCODES: the reference C defines the semantics. A front end
+ * either expresses them or is recorded as reduced, via `capabilities`. What a
+ * front end cannot do must never edit what the game IS.
+ */
+/** file_mode (z-file.h L113-118). */
+export declare enum FileMode {
+    WRITE = 0,
+    READ = 1,
+    APPEND = 2
+}
+/**
+ * file_type (z-file.h L123-129). Upstream passes this so systems without file
+ * extensions can tag the file; it reaches the platform through file_open_hook.
+ * Kept because the HTML tag distinguishes the screen dump and disconnect.html
+ * from the text dumps, and a host may want to act on that.
+ */
+export declare enum FileType {
+    TEXT = 1,
+    SAVE = 2,
+    RAW = 3,
+    HTML = 4
+}
+/**
+ * init.c's ANGBAND_DIR_* (init.h L229-241), minus the read-only gamedata roots
+ * the port ships as bundled JSON rather than a tree on disk. These five are the
+ * ones the game WRITES to, which is exactly the set a browser cannot provide.
+ */
+export declare enum HostDir {
+    /** ANGBAND_DIR_USER: dumps, pref files, lore.txt, spoilers, the dev logs. */
+    USER = "user",
+    /** ANGBAND_DIR_SAVE: one savefile per character. */
+    SAVE = "save",
+    /** ANGBAND_DIR_PANIC: the signal handler's separate savefile. */
+    PANIC = "panic",
+    /** ANGBAND_DIR_SCORES: the shared score list. */
+    SCORES = "scores",
+    /** ANGBAND_DIR_ARCHIVE: retired characters' savefiles. */
+    ARCHIVE = "archive"
+}
+/**
+ * What a host can actually do. A screen reads this to decide which of
+ * upstream's paths it can take; it must NEVER be used to decide what the game
+ * means. Every field is a statement about the platform, not about the port.
+ */
+export interface HostCapabilities {
+    /**
+     * Files persist somewhere the user can see and other programs can reach. On
+     * the web adapter this is false: localStorage is private to the origin and
+     * evictable, so a mod manager cannot deploy into it and a "clear browsing
+     * data" destroys it.
+     */
+    readonly realFiles: boolean;
+    /** A process command line exists (main.c's switches: -f, -u, -w, -p, ...). */
+    readonly argv: boolean;
+    /** The host can be told the process is dying, so a panic save can be written. */
+    readonly signals: boolean;
+    /**
+     * More than one terminal window can exist. Upstream's ANGBAND_TERM_MAX is 8
+     * (ui-term.h:244); a single canvas is 1, which is why the port's subwindow
+     * setup, its window: pref directive and its option_dump are all hollow.
+     */
+    readonly termCount: number;
+    /** Directories can be listed and watched, so an on-disk mod tree can be found. */
+    readonly directories: boolean;
+}
+/**
+ * The write outcomes upstream's callers distinguish. file_open failing and
+ * file_close failing are reported with DIFFERENT messages at the same call site
+ * (wiz-spoil.c: "Cannot create spoiler file." vs "Cannot close spoiler file."),
+ * so a host must be able to tell them apart rather than returning one boolean.
+ */
+export type WriteOutcome = "ok" | "create-failed" | "close-failed";
+/**
+ * z-file.c's file access, per directory. Paths are LEAF names within a HostDir,
+ * not host paths: core never composes a path (that is path_build's job, and it
+ * is host-specific), and a leaf-only API cannot traverse out of its directory.
+ */
+export interface HostIo {
+    /** What this host can do. Checked, never assumed. */
+    readonly capabilities: HostCapabilities;
+    /**
+     * path_build(dir, name) purely for DISPLAY - the text upstream prints in
+     * prompts and messages ("Cannot open '%s'."). Never used to open anything.
+     */
+    displayPath(dir: HostDir, name: string): string;
+    /** file_exists (z-file.h L135). */
+    exists(dir: HostDir, name: string): boolean;
+    /** file_open(MODE_READ) + a file_getl loop: the whole text, or null if absent. */
+    read(dir: HostDir, name: string): string | null;
+    /**
+     * file_open(mode, ftype) + file_put + file_close, as one call. The two
+     * failure modes stay distinct; see WriteOutcome.
+     */
+    write(dir: HostDir, name: string, text: string, mode?: FileMode, ftype?: FileType): WriteOutcome;
+    /** file_delete (z-file.h L145). */
+    remove(dir: HostDir, name: string): boolean;
+    /** file_move (z-file.h L169). */
+    move(dir: HostDir, from: string, to: string): boolean;
+    /**
+     * file_newer (z-file.h L174). This is the gate on upstream's panic-save
+     * prompt (ui-game.c:709-720), so a host without timestamps must say so rather
+     * than guess: null means "cannot tell", which is not the same as false.
+     */
+    newer(dir: HostDir, first: string, second: string): boolean | null;
+    /** The directory listing. Upstream reaches this through its platform layer. */
+    list(dir: HostDir): string[];
+    /**
+     * main.c's argv, minus the program name. Empty when capabilities.argv is
+     * false - which is why ui-player.c:1250's "You are not allowed to change your
+     * name!" (reachable only via -f / arg_force_name) has no way to fire on the
+     * web adapter.
+     */
+    argv(): readonly string[];
+}
+/**
+ * A host that has no directories at all: every read misses and every write
+ * fails. This is what core falls back to when nothing was injected, so a
+ * missing host is a reported failure rather than a thrown exception - the same
+ * discipline z-file.c uses, where file_open just returns NULL.
+ *
+ * Deliberately NOT a silent success. A write that claims to have worked while
+ * storing nothing is the failure mode already recorded against persistSave.
+ */
+export declare const NULL_HOST: HostIo;
+/** Install the host for this process. The front end calls this at startup. */
+export declare function setHost(host: HostIo): void;
+/** The installed host, or NULL_HOST if the front end never set one. */
+export declare function host(): HostIo;
+/**
+ * text_lines_to_file (z-textblock.c L703-737): write <name>.new, rotate it into
+ * place over any existing file, and keep <name>.old only for the length of the
+ * rename. Returns an `errr` exactly as the C does - 0 on success, -1 when the
+ * staged file could not be opened - because callers read it that way:
+ *
+ *     if (text_lines_to_file(path, writer)) msg("Failed to create file %s.new", path);
+ *
+ * Lives here rather than in a front end because the staging sequence is host
+ * behaviour that every adapter owes, and it was previously duplicated in the
+ * web layer alone.
+ */
+export declare function textLinesToFile(io: HostIo, dir: HostDir, name: string, text: string): number;
+//# sourceMappingURL=io.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../src/host/io.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,qCAAqC;AACrC,oBAAY,QAAQ;IAClB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,MAAM,IAAI;CACX;AAED;;;;;GAKG;AACH,oBAAY,QAAQ;IAClB,IAAI,IAAI;IACR,IAAI,IAAI;IACR,GAAG,IAAI;IACP,IAAI,IAAI;CACT;AAED;;;;GAIG;AACH,oBAAY,OAAO;IACjB,6EAA6E;IAC7E,IAAI,SAAS;IACb,oDAAoD;IACpD,IAAI,SAAS;IACb,iEAAiE;IACjE,KAAK,UAAU;IACf,iDAAiD;IACjD,MAAM,WAAW;IACjB,0DAA0D;IAC1D,OAAO,YAAY;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,kFAAkF;IAClF,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,eAAe,GAAG,cAAc,CAAC;AAEnE;;;;GAIG;AACH,MAAM,WAAW,MAAM;IACrB,qDAAqD;IACrD,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;IAExC;;;OAGG;IACH,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAEhD,mCAAmC;IACnC,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAE5C,kFAAkF;IAClF,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAEhD;;;OAGG;IACH,KAAK,CACH,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,QAAQ,EACf,KAAK,CAAC,EAAE,QAAQ,GACf,YAAY,CAAC;IAEhB,mCAAmC;IACnC,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAE5C,iCAAiC;IACjC,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAEtD;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAEnE,+EAA+E;IAC/E,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC;IAE7B;;;;;OAKG;IACH,IAAI,IAAI,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,EAAE,MAiBvB,CAAC;AAIF,8EAA8E;AAC9E,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,uEAAuE;AACvE,wBAAgB,IAAI,IAAI,MAAM,CAE7B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,MAAM,CAkBR"}

package/dist/host/io.js

@@ -0,0 +1,137 @@
+/**
+ * The host layer: z-file.c's file access and init.c's directory set, as an
+ * interface core can be handed instead of a platform it has to guess at.
+ *
+ * WHY THIS EXISTS
+ *
+ * Upstream is not a browser program that happens to run on desktops; it is a
+ * desktop program with several front ends (main-sdl2.c, main-gcu.c, main-win.c)
+ * over ONE host layer (z-file.c) and ONE directory set (init.c's ANGBAND_DIR_*).
+ * The port had the first half of that - a platform-agnostic core with the front
+ * end in packages/web - but no second half: every feature that needed a file
+ * asked the browser, got "no", and was then quietly reshaped to fit the answer.
+ *
+ * That reshaping is the bug. Measured on 2026-07-28, 18 of the 35 remaining
+ * text-census absences exist only because there is no host filesystem, no argv
+ * and no process to receive a signal - not because the C was hard to read. And
+ * the damage is not limited to absences: a platform limit that goes unmodelled
+ * turns into an invented stand-in (the "use the CLI" spoiler line, the PNG
+ * screen dump), which is worse, because a stand-in FILLS the slot and neither
+ * census can see it.
+ *
+ * So the host is a first-class, injectable seam with three adapters:
+ *
+ *   - desktop (Electron main process, real node:fs)  - full capability
+ *   - cli     (node:fs directly)                     - full capability
+ *   - web     (localStorage, one key per file)       - reduced, and SAYS so
+ *
+ * THE RULE THIS ENCODES: the reference C defines the semantics. A front end
+ * either expresses them or is recorded as reduced, via `capabilities`. What a
+ * front end cannot do must never edit what the game IS.
+ */
+/** file_mode (z-file.h L113-118). */
+export var FileMode;
+(function (FileMode) {
+    FileMode[FileMode["WRITE"] = 0] = "WRITE";
+    FileMode[FileMode["READ"] = 1] = "READ";
+    FileMode[FileMode["APPEND"] = 2] = "APPEND";
+})(FileMode || (FileMode = {}));
+/**
+ * file_type (z-file.h L123-129). Upstream passes this so systems without file
+ * extensions can tag the file; it reaches the platform through file_open_hook.
+ * Kept because the HTML tag distinguishes the screen dump and disconnect.html
+ * from the text dumps, and a host may want to act on that.
+ */
+export var FileType;
+(function (FileType) {
+    FileType[FileType["TEXT"] = 1] = "TEXT";
+    FileType[FileType["SAVE"] = 2] = "SAVE";
+    FileType[FileType["RAW"] = 3] = "RAW";
+    FileType[FileType["HTML"] = 4] = "HTML";
+})(FileType || (FileType = {}));
+/**
+ * init.c's ANGBAND_DIR_* (init.h L229-241), minus the read-only gamedata roots
+ * the port ships as bundled JSON rather than a tree on disk. These five are the
+ * ones the game WRITES to, which is exactly the set a browser cannot provide.
+ */
+export var HostDir;
+(function (HostDir) {
+    /** ANGBAND_DIR_USER: dumps, pref files, lore.txt, spoilers, the dev logs. */
+    HostDir["USER"] = "user";
+    /** ANGBAND_DIR_SAVE: one savefile per character. */
+    HostDir["SAVE"] = "save";
+    /** ANGBAND_DIR_PANIC: the signal handler's separate savefile. */
+    HostDir["PANIC"] = "panic";
+    /** ANGBAND_DIR_SCORES: the shared score list. */
+    HostDir["SCORES"] = "scores";
+    /** ANGBAND_DIR_ARCHIVE: retired characters' savefiles. */
+    HostDir["ARCHIVE"] = "archive";
+})(HostDir || (HostDir = {}));
+/**
+ * A host that has no directories at all: every read misses and every write
+ * fails. This is what core falls back to when nothing was injected, so a
+ * missing host is a reported failure rather than a thrown exception - the same
+ * discipline z-file.c uses, where file_open just returns NULL.
+ *
+ * Deliberately NOT a silent success. A write that claims to have worked while
+ * storing nothing is the failure mode already recorded against persistSave.
+ */
+export const NULL_HOST = {
+    capabilities: {
+        realFiles: false,
+        argv: false,
+        signals: false,
+        termCount: 1,
+        directories: false,
+    },
+    displayPath: (dir, name) => `${dir}/${name}`,
+    exists: () => false,
+    read: () => null,
+    write: () => "create-failed",
+    remove: () => false,
+    move: () => false,
+    newer: () => null,
+    list: () => [],
+    argv: () => [],
+};
+let current = NULL_HOST;
+/** Install the host for this process. The front end calls this at startup. */
+export function setHost(host) {
+    current = host;
+}
+/** The installed host, or NULL_HOST if the front end never set one. */
+export function host() {
+    return current;
+}
+/**
+ * text_lines_to_file (z-textblock.c L703-737): write <name>.new, rotate it into
+ * place over any existing file, and keep <name>.old only for the length of the
+ * rename. Returns an `errr` exactly as the C does - 0 on success, -1 when the
+ * staged file could not be opened - because callers read it that way:
+ *
+ *     if (text_lines_to_file(path, writer)) msg("Failed to create file %s.new", path);
+ *
+ * Lives here rather than in a front end because the staging sequence is host
+ * behaviour that every adapter owes, and it was previously duplicated in the
+ * web layer alone.
+ */
+export function textLinesToFile(io, dir, name, text) {
+    const newName = `${name}.new`;
+    const oldName = `${name}.old`;
+    /* Write new file (L714-724). */
+    if (io.write(dir, newName, text) !== "ok")
+        return -1;
+    /* Move files around (L726-734). */
+    if (!io.exists(dir, name)) {
+        io.move(dir, newName, name);
+    }
+    else if (io.move(dir, name, oldName)) {
+        io.move(dir, newName, name);
+        io.remove(dir, oldName);
+    }
+    else {
+        io.remove(dir, newName);
+    }
+    return 0;
+}
+//# sourceMappingURL=io.js.map

package/dist/host/io.js.map

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

package/dist/host/memory.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 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 type { HostCapabilities, HostIo, WriteOutcome } from "./io.js";
+import { FileMode, HostDir } from "./io.js";
+/** Knobs a test uses to provoke the failure paths. */
+export interface MemoryHostOpts {
+    /** Override any capability; the rest stay at full. */
+    capabilities?: Partial<HostCapabilities>;
+    /** argv, minus the program name. */
+    argv?: readonly string[];
+    /** Names whose write fails at open - upstream's "can't open" message. */
+    failWrites?: readonly string[];
+    /**
+     * Names whose write appears to succeed but stores nothing - upstream's
+     * "can't close" message, and the real localStorage failure mode where a
+     * quota-evicted setItem does not throw.
+     */
+    truncateWrites?: readonly string[];
+}
+/** A HostIo backed by a Map per directory, with an inspectable file table. */
+export declare class MemoryHost implements HostIo {
+    readonly capabilities: HostCapabilities;
+    private readonly files;
+    /** Monotonic write counter, standing in for an mtime so `newer` is decidable. */
+    private readonly stamps;
+    private clock;
+    private readonly cmdline;
+    private readonly failSet;
+    private readonly truncSet;
+    constructor(opts?: MemoryHostOpts);
+    private key;
+    displayPath(dir: HostDir, name: string): string;
+    exists(dir: HostDir, name: string): boolean;
+    read(dir: HostDir, name: string): string | null;
+    write(dir: HostDir, name: string, text: string, mode?: FileMode): WriteOutcome;
+    remove(dir: HostDir, name: string): boolean;
+    move(dir: HostDir, from: string, to: string): boolean;
+    newer(dir: HostDir, first: string, second: string): boolean | null;
+    list(dir: HostDir): string[];
+    argv(): readonly string[];
+    /** Test helper: every file, as dir/name -> text. */
+    snapshot(): Record<string, string>;
+}
+//# sourceMappingURL=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/host/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAE5C,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,YAAY,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACzC,oCAAoC;IACpC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,yEAAyE;IACzE,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B;;;;OAIG;IACH,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAWD,8EAA8E;AAC9E,qBAAa,UAAW,YAAW,MAAM;IACvC,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;IACnD,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;gBAEnC,IAAI,GAAE,cAAmB;IAOrC,OAAO,CAAC,GAAG;IAIX,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAI/C,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,GAC9B,YAAY;IAWf,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAM3C,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO;IAOrD,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAUlE,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE;IAS5B,IAAI,IAAI,SAAS,MAAM,EAAE;IAIzB,oDAAoD;IACpD,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAGnC"}