@datamoc/mw_games 0.1.1

package/dist/roguelike/Doors.d.ts

@@ -0,0 +1,60 @@
+import type { Level } from './Level.ts';
+/**
+ * Open/closed/locked door state, the same shape `Secrets` already uses: the state itself is
+ * just terrain (a door swaps between its own open and closed terrain kinds, so `passable`/
+ * `transparent` need no door-specific code at all), and this class remembers the other half -
+ * which cells are doors, and what they swap to.
+ *
+ * Locking is a separate flag from open/closed: a locked door is always closed and refuses to
+ * open until `unlock` is called (typically once a game confirms the actor holds the right
+ * key item), rather than open/closed and locked/unlocked being folded into one state.
+ */
+export declare class Doors {
+    private level;
+    private openKind;
+    private closedKind;
+    private lockedBy;
+    private open_;
+    constructor(level: Level);
+    /** places a door at `(x, y)`, swapping between `open`/`closed` terrain kinds */
+    place(x: number, y: number, options: {
+        open: number;
+        closed: number;
+        locked?: string;
+        startOpen?: boolean;
+    }): void;
+    isDoor(x: number, y: number): boolean;
+    isOpen(x: number, y: number): boolean;
+    isLocked(x: number, y: number): boolean;
+    /** the id of the key item that unlocks this door, or undefined if it is not locked */
+    requiredKey(x: number, y: number): string | undefined;
+    /** @returns false, changing nothing, for a locked door, an already-open one, or not a door */
+    open(x: number, y: number): boolean;
+    /** @returns false, changing nothing, for an already-closed door or not a door */
+    close(x: number, y: number): boolean;
+    /** removes a door's lock, leaving it closed but now openable; false if it was not locked */
+    unlock(x: number, y: number): boolean;
+    toJSON(): {
+        doors: {
+            cell: number;
+            open: number;
+            closed: number;
+            locked?: string;
+            isOpen: boolean;
+        }[];
+    };
+    /**
+     * Rebuilds doors from save data onto a (separately restored) level, re-applying each
+     * door's terrain so an open door still reads as open to `passable`/`transparent`.
+     */
+    static fromJSON(level: Level, data: {
+        doors: {
+            cell: number;
+            open: number;
+            closed: number;
+            locked?: string;
+            isOpen: boolean;
+        }[];
+    }): Doors;
+}
+//# sourceMappingURL=Doors.d.ts.map

package/dist/roguelike/Doors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Doors.d.ts","sourceRoot":"","sources":["../../src/roguelike/Doors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;;;;;;;GASG;AACH,qBAAa,KAAK;IACjB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,KAAK,CAA8B;IAE3C,YAAY,KAAK,EAAE,KAAK,EAEvB;IAED,gFAAgF;IAChF,KAAK,CACJ,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAC7E,IAAI,CASN;IAED,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAEpC;IAED,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAEpC;IAED,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAEtC;IAED,sFAAsF;IACtF,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEpD;IAED,8FAA8F;IAC9F,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAOlC;IAED,iFAAiF;IACjF,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAOnC;IAED,4FAA4F;IAC5F,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAMpC;IAED,MAAM,IAAI;QAAE,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,OAAO,CAAA;SAAE,EAAE,CAAA;KAAE,CAYtG;IAED;;;OAGG;IACH,MAAM,CAAC,QAAQ,CACd,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE;QAAE,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,OAAO,CAAA;SAAE,EAAE,CAAA;KAAE,GACjG,KAAK,CAaP;CACD"}

package/dist/roguelike/Doors.js

@@ -0,0 +1,102 @@
+/**
+ * Open/closed/locked door state, the same shape `Secrets` already uses: the state itself is
+ * just terrain (a door swaps between its own open and closed terrain kinds, so `passable`/
+ * `transparent` need no door-specific code at all), and this class remembers the other half -
+ * which cells are doors, and what they swap to.
+ *
+ * Locking is a separate flag from open/closed: a locked door is always closed and refuses to
+ * open until `unlock` is called (typically once a game confirms the actor holds the right
+ * key item), rather than open/closed and locked/unlocked being folded into one state.
+ */
+export class Doors {
+    constructor(level) {
+        this.openKind = new Map();
+        this.closedKind = new Map();
+        this.lockedBy = new Map();
+        this.open_ = new Map();
+        this.level = level;
+    }
+    /** places a door at `(x, y)`, swapping between `open`/`closed` terrain kinds */
+    place(x, y, options) {
+        const cell = this.level.index(x, y);
+        this.openKind.set(cell, options.open);
+        this.closedKind.set(cell, options.closed);
+        this.open_.set(cell, options.startOpen ?? false);
+        if (options.locked !== undefined)
+            this.lockedBy.set(cell, options.locked);
+        else
+            this.lockedBy.delete(cell);
+        this.level.set(x, y, this.open_.get(cell) ? options.open : options.closed);
+    }
+    isDoor(x, y) {
+        return this.open_.has(this.level.index(x, y));
+    }
+    isOpen(x, y) {
+        return this.open_.get(this.level.index(x, y)) === true;
+    }
+    isLocked(x, y) {
+        return this.lockedBy.has(this.level.index(x, y));
+    }
+    /** the id of the key item that unlocks this door, or undefined if it is not locked */
+    requiredKey(x, y) {
+        return this.lockedBy.get(this.level.index(x, y));
+    }
+    /** @returns false, changing nothing, for a locked door, an already-open one, or not a door */
+    open(x, y) {
+        const cell = this.level.index(x, y);
+        if (!this.open_.has(cell) || this.open_.get(cell) || this.lockedBy.has(cell))
+            return false;
+        this.open_.set(cell, true);
+        this.level.set(x, y, this.openKind.get(cell));
+        return true;
+    }
+    /** @returns false, changing nothing, for an already-closed door or not a door */
+    close(x, y) {
+        const cell = this.level.index(x, y);
+        if (!this.open_.has(cell) || !this.open_.get(cell))
+            return false;
+        this.open_.set(cell, false);
+        this.level.set(x, y, this.closedKind.get(cell));
+        return true;
+    }
+    /** removes a door's lock, leaving it closed but now openable; false if it was not locked */
+    unlock(x, y) {
+        const cell = this.level.index(x, y);
+        if (!this.lockedBy.has(cell))
+            return false;
+        this.lockedBy.delete(cell);
+        return true;
+    }
+    toJSON() {
+        const doors = [];
+        for (const [cell, open] of this.openKind) {
+            doors.push({
+                cell,
+                open,
+                closed: this.closedKind.get(cell),
+                locked: this.lockedBy.get(cell),
+                isOpen: this.open_.get(cell) === true,
+            });
+        }
+        return { doors };
+    }
+    /**
+     * Rebuilds doors from save data onto a (separately restored) level, re-applying each
+     * door's terrain so an open door still reads as open to `passable`/`transparent`.
+     */
+    static fromJSON(level, data) {
+        const doors = new Doors(level);
+        for (const saved of data.doors) {
+            const x = level.xOf(saved.cell);
+            const y = level.yOf(saved.cell);
+            doors.place(x, y, {
+                open: saved.open,
+                closed: saved.closed,
+                locked: saved.locked,
+                startOpen: saved.isOpen,
+            });
+        }
+        return doors;
+    }
+}
+//# sourceMappingURL=Doors.js.map

package/dist/roguelike/Doors.js.map

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

package/dist/roguelike/Elevation.d.ts

@@ -0,0 +1,26 @@
+import type { Level } from './Level.ts';
+/**
+ * A discrete height per cell: raised platforms, cliffs, pits.
+ *
+ * A sidecar like `Secrets` and `Doors`, holding the `Level` it belongs to rather
+ * than living inside it - the still-fundamentally-2D map gains a height value,
+ * not a third axis. Every cell starts at 0, the ground everything else is
+ * measured against; negative heights are pits, for whatever a game makes of them.
+ *
+ * What reads it: `FieldOfView.update` takes heights to block sight asymmetrically
+ * (a cliff hides what is behind it from below, but not from above), and
+ * `Pathfinder` takes heights with a climb limit. What does not: `TileMap` draws
+ * tiles where the grid says, and sprites stand where the game puts them - a
+ * raised cell *looks* raised because the game offsets its occupants' sprites
+ * upward by their height, which is presentation, not pathing, and lives game-side.
+ */
+export declare class Elevation {
+    private readonly level;
+    private readonly heights;
+    constructor(level: Level);
+    /** the height of a cell; off the map reads as ground (walking there is refused by `Level` itself) */
+    heightAt(x: number, y: number): number;
+    /** raises or lowers one cell - heights are whole levels, not fractions */
+    set(x: number, y: number, height: number): void;
+}
+//# sourceMappingURL=Elevation.d.ts.map

package/dist/roguelike/Elevation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Elevation.d.ts","sourceRoot":"","sources":["../../src/roguelike/Elevation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;;;;;;;;;;;;GAcG;AACH,qBAAa,SAAS;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IAErC,YAAY,KAAK,EAAE,KAAK,EAGvB;IAED,qGAAqG;IACrG,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAGrC;IAED,0EAA0E;IAC1E,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAM9C;CACD"}

package/dist/roguelike/Elevation.js

@@ -0,0 +1,37 @@
+/**
+ * A discrete height per cell: raised platforms, cliffs, pits.
+ *
+ * A sidecar like `Secrets` and `Doors`, holding the `Level` it belongs to rather
+ * than living inside it - the still-fundamentally-2D map gains a height value,
+ * not a third axis. Every cell starts at 0, the ground everything else is
+ * measured against; negative heights are pits, for whatever a game makes of them.
+ *
+ * What reads it: `FieldOfView.update` takes heights to block sight asymmetrically
+ * (a cliff hides what is behind it from below, but not from above), and
+ * `Pathfinder` takes heights with a climb limit. What does not: `TileMap` draws
+ * tiles where the grid says, and sprites stand where the game puts them - a
+ * raised cell *looks* raised because the game offsets its occupants' sprites
+ * upward by their height, which is presentation, not pathing, and lives game-side.
+ */
+export class Elevation {
+    constructor(level) {
+        this.level = level;
+        this.heights = new Int32Array(level.cellCount);
+    }
+    /** the height of a cell; off the map reads as ground (walking there is refused by `Level` itself) */
+    heightAt(x, y) {
+        if (!this.level.inside(x, y))
+            return 0;
+        return this.heights[this.level.index(x, y)];
+    }
+    /** raises or lowers one cell - heights are whole levels, not fractions */
+    set(x, y, height) {
+        if (!Number.isInteger(height)) {
+            throw new Error(`a cell's height must be a whole number, got ${height}`);
+        }
+        if (!this.level.inside(x, y))
+            return;
+        this.heights[this.level.index(x, y)] = height;
+    }
+}
+//# sourceMappingURL=Elevation.js.map

package/dist/roguelike/Elevation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Elevation.js","sourceRoot":"","sources":["../../src/roguelike/Elevation.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,SAAS;IAIrB,YAAY,KAAY;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAChD,CAAC;IAED,qGAAqG;IACrG,QAAQ,CAAC,CAAS,EAAE,CAAS;QAC5B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,0EAA0E;IAC1E,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,MAAc;QACvC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,+CAA+C,MAAM,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;YAAE,OAAO;QACrC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;IAC/C,CAAC;CACD"}

package/dist/roguelike/FieldOfView.d.ts

@@ -0,0 +1,72 @@
+import type { Level } from './Level.ts';
+import type { Elevation } from './Elevation.ts';
+/**
+ * What the player can see, and what they remember seeing.
+ *
+ * Two sets, because a roguelike map has three states and not two: lit and in view,
+ * remembered but not currently seen, and never visited. The middle one is the whole reason
+ * exploring a dungeon feels like exploring — the map you have built stays on screen while
+ * what is happening on it does not.
+ *
+ * The shadowcasting itself comes from rot.js on a square `Level`, which has had these edge
+ * cases beaten out of it over years - what is here around it is the memory. rot.js has
+ * nothing hex-shaped, so a hex `Level` instead traces a straight line (`hexLine`) to every
+ * cell in range and lights it if nothing along the way is opaque: simple line-of-sight,
+ * deliberately not true shadowcasting, which is the v1 this roadmap item commits to.
+ */
+/**
+ * Sight from a height: the viewer's elevation, for maps with an `Elevation`.
+ *
+ * A cliff hides what is behind it from below but not from above - an intervening
+ * cell blocks exactly when it rises above both ends of the gaze. `height`
+ * defaults to the height of the cell stood on; a flying or perched viewer passes
+ * its own.
+ */
+export interface HeightSight {
+    heights: Elevation;
+    height?: number;
+}
+export declare class FieldOfView {
+    private level;
+    private fov;
+    /** cells currently in view */
+    readonly visible: Set<number>;
+    /** cells ever seen, which is what gets drawn dim */
+    readonly explored: Set<number>;
+    /** how bright each visible cell is, 0 to 1, by cell index */
+    readonly light: Map<number, number>;
+    constructor(level: Level);
+    /**
+     * Recomputes what is visible from a point.
+     *
+     * @param radius how far light reaches, in cells
+     * @param sight when given, sight is height-aware: every cell in range is
+     * tested along the straight line to it, blocked by opaque terrain or by a
+     * cell rising above viewer and target alike. That is line-of-sight per cell
+     * rather than shadowcasting, so its edges deliberately disagree with the
+     * flat computation in the same way targeting already does - rot.js's
+     * callback only ever sees the blocking cell, never the target, so the
+     * viewer-relative rule cannot live inside it.
+     */
+    update(x: number, y: number, radius: number, sight?: HeightSight): void;
+    /** lights one visible cell with the usual distance falloff */
+    private lightCell;
+    /** height-aware sight for both shapes: one straight line per cell, one rule for cliffs */
+    private updateFromHeight;
+    /**
+     * Whether anything between the line's ends blocks a gaze from `viewer` height
+     * to `target` height: opaque terrain always does, and so does a cell rising
+     * above them both. Heights only ever add blocking - a wall still reads as a
+     * wall from above.
+     */
+    private heightBlocked;
+    isVisible(x: number, y: number): boolean;
+    isExplored(x: number, y: number): boolean;
+    /** how lit a cell is right now, 0 when out of view */
+    lightAt(x: number, y: number): number;
+    /** forgets everything, as a new floor should */
+    reset(): void;
+    /** reveals the whole map, for a magic mapping effect or a debug view */
+    revealAll(): void;
+}
+//# sourceMappingURL=FieldOfView.d.ts.map

package/dist/roguelike/FieldOfView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldOfView.d.ts","sourceRoot":"","sources":["../../src/roguelike/FieldOfView.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAIhD;;;;;;;;;;;;;GAaG;AACH;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC3B,OAAO,EAAE,SAAS,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,WAAW;IAAG,OAAO,CAAC,KAAK,CAAQ;IAG/C,OAAO,CAAC,GAAG,CAAuD;IAElE,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,cAAqB;IAErC,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,cAAqB;IAEtC,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,sBAA6B;IAE3C,YAAY,KAAK,EAAE,KAAK,EAGvB;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CAmCtE;IAED,8DAA8D;IAC9D,OAAO,CAAC,SAAS;IAOjB,0FAA0F;IAC1F,OAAO,CAAC,gBAAgB;IAyBxB;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAerB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAEvC;IAED,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAExC;IAED,sDAAsD;IACtD,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpC;IAED,gDAAgD;IAChD,KAAK,IAAI,IAAI,CAIZ;IAED,wEAAwE;IACxE,SAAS,IAAI,IAAI,CAEhB;CACD"}

package/dist/roguelike/FieldOfView.js

@@ -0,0 +1,134 @@
+import { FOV } from 'rot-js';
+import { hexRange, hexLine } from '../core/Hex.js';
+import { chebyshevDistance, traceLine } from './Targeting.js';
+export class FieldOfView {
+    constructor(level) {
+        /** cells currently in view */
+        this.visible = new Set();
+        /** cells ever seen, which is what gets drawn dim */
+        this.explored = new Set();
+        /** how bright each visible cell is, 0 to 1, by cell index */
+        this.light = new Map();
+        this.level = level;
+        this.fov = level.shape === 'hex' ? null : new FOV.PreciseShadowcasting((x, y) => level.transparent(x, y));
+    }
+    /**
+     * Recomputes what is visible from a point.
+     *
+     * @param radius how far light reaches, in cells
+     * @param sight when given, sight is height-aware: every cell in range is
+     * tested along the straight line to it, blocked by opaque terrain or by a
+     * cell rising above viewer and target alike. That is line-of-sight per cell
+     * rather than shadowcasting, so its edges deliberately disagree with the
+     * flat computation in the same way targeting already does - rot.js's
+     * callback only ever sees the blocking cell, never the target, so the
+     * viewer-relative rule cannot live inside it.
+     */
+    update(x, y, radius, sight) {
+        this.visible.clear();
+        this.light.clear();
+        if (sight) {
+            this.updateFromHeight(x, y, radius, sight);
+            return;
+        }
+        if (this.fov) {
+            this.fov.compute(x, y, radius, (cx, cy, _r, visibility) => {
+                if (!this.level.inside(cx, cy))
+                    return;
+                const cell = this.level.index(cx, cy);
+                this.visible.add(cell);
+                this.explored.add(cell);
+                this.light.set(cell, visibility);
+            });
+            return;
+        }
+        const center = { x, y };
+        for (const target of hexRange(center, radius)) {
+            if (!this.level.inside(target.x, target.y))
+                continue;
+            const line = hexLine(center, target);
+            //every cell between the two ends must be transparent; the two ends themselves
+            //need not be, the same rule `hasLineOfSight` uses for a square grid
+            const blocked = line
+                .slice(1, -1)
+                .some((cell) => !this.level.inside(cell.x, cell.y) || !this.level.transparent(cell.x, cell.y));
+            if (blocked)
+                continue;
+            this.lightCell(target.x, target.y, line.length - 1, radius);
+        }
+    }
+    /** lights one visible cell with the usual distance falloff */
+    lightCell(x, y, distance, radius) {
+        const cell = this.level.index(x, y);
+        this.visible.add(cell);
+        this.explored.add(cell);
+        this.light.set(cell, radius === 0 ? 1 : Math.max(0, 1 - distance / (radius + 1)));
+    }
+    /** height-aware sight for both shapes: one straight line per cell, one rule for cliffs */
+    updateFromHeight(x, y, radius, sight) {
+        const viewer = sight.height ?? sight.heights.heightAt(x, y);
+        const center = { x, y };
+        if (this.level.shape === 'hex') {
+            for (const target of hexRange(center, radius)) {
+                if (!this.level.inside(target.x, target.y))
+                    continue;
+                const line = hexLine(center, target);
+                if (this.heightBlocked(line, sight.heights, viewer, sight.heights.heightAt(target.x, target.y)))
+                    continue;
+                this.lightCell(target.x, target.y, line.length - 1, radius);
+            }
+            return;
+        }
+        for (let ty = y - radius; ty <= y + radius; ty++) {
+            for (let tx = x - radius; tx <= x + radius; tx++) {
+                if (!this.level.inside(tx, ty))
+                    continue;
+                if (chebyshevDistance(center, { x: tx, y: ty }) > radius)
+                    continue;
+                const line = traceLine(center, { x: tx, y: ty });
+                if (this.heightBlocked(line, sight.heights, viewer, sight.heights.heightAt(tx, ty)))
+                    continue;
+                this.lightCell(tx, ty, line.length - 1, radius);
+            }
+        }
+    }
+    /**
+     * Whether anything between the line's ends blocks a gaze from `viewer` height
+     * to `target` height: opaque terrain always does, and so does a cell rising
+     * above them both. Heights only ever add blocking - a wall still reads as a
+     * wall from above.
+     */
+    heightBlocked(line, heights, viewer, target) {
+        const top = Math.max(viewer, target);
+        for (let i = 1; i < line.length - 1; i++) {
+            const cell = line[i];
+            if (!this.level.inside(cell.x, cell.y) || !this.level.transparent(cell.x, cell.y))
+                return true;
+            if (heights.heightAt(cell.x, cell.y) > top)
+                return true;
+        }
+        return false;
+    }
+    isVisible(x, y) {
+        return this.visible.has(this.level.index(x, y));
+    }
+    isExplored(x, y) {
+        return this.explored.has(this.level.index(x, y));
+    }
+    /** how lit a cell is right now, 0 when out of view */
+    lightAt(x, y) {
+        return this.light.get(this.level.index(x, y)) ?? 0;
+    }
+    /** forgets everything, as a new floor should */
+    reset() {
+        this.visible.clear();
+        this.explored.clear();
+        this.light.clear();
+    }
+    /** reveals the whole map, for a magic mapping effect or a debug view */
+    revealAll() {
+        for (let i = 0; i < this.level.cellCount; i++)
+            this.explored.add(i);
+    }
+}
+//# sourceMappingURL=FieldOfView.js.map

package/dist/roguelike/FieldOfView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldOfView.js","sourceRoot":"","sources":["../../src/roguelike/FieldOfView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAG7B,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AA6B9D,MAAM,OAAO,WAAW;IAcvB,YAAY,KAAY;QATxB,8BAA8B;QACrB,YAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAErC,oDAAoD;QAC3C,aAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;QAEtC,6DAA6D;QACpD,UAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;QAG1C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3G,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,CAAS,EAAE,CAAS,EAAE,MAAc,EAAE,KAAmB;QAC/D,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAEnB,IAAI,KAAK,EAAE,CAAC;YACX,IAAI,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YAC3C,OAAO;QACR,CAAC;QAED,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACd,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,UAAkB,EAAE,EAAE;gBACzF,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC;oBAAE,OAAO;gBAEvC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBACtC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACvB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACxB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAClC,CAAC,CAAC,CAAC;YACH,OAAO;QACR,CAAC;QAED,MAAM,MAAM,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACxB,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;YAC/C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;gBAAE,SAAS;YAErD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACrC,8EAA8E;YAC9E,oEAAoE;YACpE,MAAM,OAAO,GAAG,IAAI;iBAClB,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;iBACZ,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAChG,IAAI,OAAO;gBAAE,SAAS;YAEtB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;QAC7D,CAAC;IACF,CAAC;IAED,8DAA8D;IACtD,SAAS,CAAC,CAAS,EAAE,CAAS,EAAE,QAAgB,EAAE,MAAc;QACvE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACpC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,CAAC;IAED,0FAA0F;IAClF,gBAAgB,CAAC,CAAS,EAAE,CAAS,EAAE,MAAc,EAAE,KAAkB;QAChF,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QAExB,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;YAChC,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;gBAC/C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;oBAAE,SAAS;gBACrD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACrC,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;oBAAE,SAAS;gBAC1G,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;YAC7D,CAAC;YACD,OAAO;QACR,CAAC;QAED,KAAK,IAAI,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE,EAAE,IAAI,CAAC,GAAG,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;YAClD,KAAK,IAAI,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE,EAAE,IAAI,CAAC,GAAG,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;gBAClD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC;oBAAE,SAAS;gBACzC,IAAI,iBAAiB,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,MAAM;oBAAE,SAAS;gBACnE,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBACjD,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;oBAAE,SAAS;gBAC9F,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;YACjD,CAAC;QACF,CAAC;IACF,CAAC;IAED;;;;;OAKG;IACK,aAAa,CACpB,IAAqC,EACrC,OAAkB,EAClB,MAAc,EACd,MAAc;QAEd,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACrB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC/F,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG;gBAAE,OAAO,IAAI,CAAC;QACzD,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC;IAED,SAAS,CAAC,CAAS,EAAE,CAAS;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,UAAU,CAAC,CAAS,EAAE,CAAS;QAC9B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,sDAAsD;IACtD,OAAO,CAAC,CAAS,EAAE,CAAS;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC;IAED,gDAAgD;IAChD,KAAK;QACJ,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;IAED,wEAAwE;IACxE,SAAS;QACR,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,EAAE;YAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC;CACD"}

package/dist/roguelike/Level.d.ts

@@ -0,0 +1,96 @@
+/**
+ * The map a roguelike reasons about.
+ *
+ * Deliberately separate from `TileMap`, which is how a map is *drawn*. This one holds what
+ * the algorithms need — can something walk here, can light pass — and nothing about
+ * appearance. A game maps its own terrain kinds onto these two flags, so it can invent
+ * whatever terrain it likes without the framework knowing about lava or bookshelves.
+ */
+/** the grid a `Level` reasons over - a parameter, not a forked class, per the roadmap */
+export type LevelShape = 'square' | 'hex';
+/** the four or eight cell offsets around a point, shared by every square-grid algorithm here */
+export declare function neighbourOffsets(topology: 4 | 8): ReadonlyArray<readonly [number, number]>;
+export interface TerrainKind {
+    /** can a creature walk onto it */
+    passable: boolean;
+    /** can something be seen through it */
+    transparent: boolean;
+}
+/** the two that every map needs; a game adds its own alongside */
+export declare const WALL: TerrainKind;
+export declare const FLOOR: TerrainKind;
+export interface Rect {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+}
+export declare class Level {
+    readonly width: number;
+    readonly height: number;
+    readonly shape: LevelShape;
+    /** terrain id per cell, indexing into `kinds` */
+    readonly terrain: Uint8Array;
+    private kinds;
+    /** rooms the generator carved, for placing stairs, monsters and treasure */
+    rooms: Rect[];
+    constructor(width: number, height: number, kinds: TerrainKind[], fill?: number, shape?: LevelShape);
+    get cellCount(): number;
+    index(x: number, y: number): number;
+    xOf(cell: number): number;
+    yOf(cell: number): number;
+    inside(x: number, y: number): boolean;
+    /**
+     * The cells adjacent to `(x, y)` - six of them on a hex `Level`, four or eight on a
+     * square one, regardless of which. This is the seam that lets `Pathfinder` and
+     * `FieldOfView` work over either shape unchanged: they walk neighbours, and only this
+     * method knows what a neighbour is.
+     *
+     * @param topology ignored on a hex `Level` - it only has the one neighbourhood shape
+     */
+    neighbors(x: number, y: number, topology?: 4 | 8): Array<{
+        x: number;
+        y: number;
+    }>;
+    /**
+     * True only for cells with a full ring of neighbours.
+     *
+     * Anything that inspects a cell's surroundings should use this rather than `inside`,
+     * because a cell on the very edge has no neighbour on one side and every such check
+     * then needs its own bounds test. Generators keep the border solid for the same reason.
+     */
+    insideWithBorder(x: number, y: number): boolean;
+    get(x: number, y: number): number;
+    set(x: number, y: number, kind: number): void;
+    kindAt(x: number, y: number): TerrainKind;
+    passable(x: number, y: number): boolean;
+    transparent(x: number, y: number): boolean;
+    fillRect(rect: Rect, kind: number): void;
+    /** every passable cell, as indices — the pool to place things in */
+    passableCells(): number[];
+    toJSON(): {
+        width: number;
+        height: number;
+        shape: LevelShape;
+        terrain: number[];
+        rooms: Rect[];
+    };
+    /**
+     * Rebuilds a level from save data - the `kinds` table is supplied fresh (it holds a
+     * game's own terrain meanings, the same way `QuestLog` takes its definitions fresh),
+     * so only the terrain ids and rooms are ever save data.
+     */
+    static fromJSON(kinds: TerrainKind[], data: {
+        width: number;
+        height: number;
+        shape: LevelShape;
+        terrain: number[];
+        rooms: Rect[];
+    }): Level;
+}
+export declare function rectCenter(rect: Rect): {
+    x: number;
+    y: number;
+};
+export declare function rectsOverlap(a: Rect, b: Rect, margin?: number): boolean;
+//# sourceMappingURL=Level.d.ts.map

package/dist/roguelike/Level.d.ts.map

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