@datamoc/mw_games 0.7.6 → 0.7.7

package/dist/roguelike/MultiTurnBeam.d.ts

@@ -3,9 +3,17 @@ import type { Step } from './Pathfinder.ts';
 export interface BeamDamageContext {
     cell: Step;
     step: number;
-    /** the number of cells remaining after this one */
+    /** the number of cells remaining after this one, counting only fronts already resolved */
     remaining: number;
 }
+/**
+ * What ends a beam cell, as one explicit choice rather than a combination of flags:
+ *
+ * - `'terrain'` (the default): outside the map or opaque terrain stops it, the ordinary beam.
+ * - `'none'`: it passes through terrain; only `isBlocked` (when given) can stop it.
+ * - a function: the game decides, terrain ignored.
+ */
+export type BeamBlocker = 'terrain' | 'none' | ((cell: Step, context: BeamDamageContext) => boolean);
 export interface MultiTurnBeamOptions<T> {
     level: Level;
     from: Step;
@@ -15,31 +23,55 @@ export interface MultiTurnBeamOptions<T> {
     targetsAt?: (cell: Step) => readonly T[];
     /** Applies the resolved damage. The game owns health, resistances and effects. */
     applyDamage?: (target: T, amount: number, context: BeamDamageContext) => void;
-    /** A dynamic blocker can stop a beam after it has started. */
+    /** An extra game rule on top of `blocker`, e.g. "a wall of fire melts the beam". */
     isBlocked?: (cell: Step, context: BeamDamageContext) => boolean;
-    /** Whether the beam stops at opaque terrain. Defaults to true. */
+    /** The explicit blocker policy; defaults to `'terrain'`, matching a plain beam. */
+    blocker?: BeamBlocker;
+    /** @deprecated use `blocker: 'none'`; kept so existing content keeps its meaning */
     stopAtOpaque?: boolean;
+    /**
+     * Opt-in per-turn fronts instead of a straight line. Given the cells the previous turn
+     * actually reached (the origin alone at turn 0) and the turn number, it returns the cells
+     * this turn affects; an empty list ends the beam. A cone widens, a burst stops moving, a
+     * forked front splits, and a moving front is whatever the game returns each turn - none of
+     * which the framework has to understand, only sequence and save.
+     */
+    fronts?: (previous: readonly Step[], turn: number) => readonly Step[];
+    /** Names the shape this beam is, saved so a reload resumes the same one; defaults to `'line'`/`'fronts'`. */
+    shape?: string;
+    /** Called for every cell the front actually reaches, before targets are resolved. */
+    onCell?: (cell: Step, context: BeamDamageContext) => void;
 }
 export interface BeamStep<T> {
     status: 'idle' | 'active' | 'done' | 'blocked' | 'cancelled';
+    /** the first cell this turn reached, or null when the front was empty or fully blocked */
     cell: Step | null;
+    /** every cell this turn reached, in front order */
+    cells: readonly Step[];
     step: number;
     remaining: number;
     targets: readonly T[];
     damage: number;
 }
 export interface MultiTurnBeamSave {
-    path: Step[];
-    index: number;
     state: 'idle' | 'active' | 'done' | 'blocked' | 'cancelled';
+    /** every front resolved so far, oldest first; `fronts[index]` is the next to resolve */
+    fronts: Step[][];
+    index: number;
+    /** the shape the beam was built with, so a reload resumes the same one */
+    shape: string;
+    /** @deprecated a save written before fronts landed: one cell per turn */
+    path?: Step[];
 }
 /**
- * Advances a straight beam one cell per turn.
+ * Advances a beam one front per turn.
  *
- * The framework owns traversal and timing. A game supplies target lookup and damage
- * application, so this stays useful for hit points, shields, status effects and any other
- * combat model. The path is captured at construction time, while blockers and targets are
- * checked when each cell is reached. `advance` is deterministic when those callbacks are.
+ * The framework owns traversal and timing. A game supplies target lookup and damage application,
+ * so this stays useful for hit points, shields, status effects and any other combat model. The
+ * default shape is a straight line captured at construction time; `fronts` opts into a per-turn
+ * front resolver, which is what expresses a cone, a burst, a fork or a moving front without any
+ * of those rules living here. Blockers and targets are checked when each cell is reached, so
+ * `advance` is deterministic when those callbacks are.
  *
  * @example
  * ```ts
@@ -53,18 +85,24 @@ export interface MultiTurnBeamSave {
  */
 export declare class MultiTurnBeam<T = unknown> {
     private options;
-    private path;
+    private fronts;
     private index;
     private state;
+    private shape;
     constructor(options: MultiTurnBeamOptions<T>);
     get active(): boolean;
     get done(): boolean;
+    /** The shape this beam was built with, for a save or a UI label. */
+    get beamShape(): string;
+    /** Every cell of every resolved front, in order - the straight path of a line beam. */
     get currentPath(): readonly Step[];
     start(): boolean;
-    /** Resolves and applies one beam cell. Call once per game turn. */
+    /** Resolves and applies one beam front. Call once per game turn. */
     advance(): BeamStep<T>;
     cancel(): void;
     toJSON(): MultiTurnBeamSave;
     static fromJSON<T>(options: Omit<MultiTurnBeamOptions<T>, 'from' | 'target'>, data: MultiTurnBeamSave): MultiTurnBeam<T>;
+    private blocked;
+    private inactiveStep;
 }
 //# sourceMappingURL=MultiTurnBeam.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"MultiTurnBeam.d.ts","sourceRoot":"","sources":["../../src/roguelike/MultiTurnBeam.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACtC,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,IAAI,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,iBAAiB,KAAK,MAAM,CAAC,CAAC;IACrE,gEAAgE;IAChE,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,EAAE,CAAC;IACzC,kFAAkF;IAClF,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC9E,8DAA8D;IAC9D,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC;IAChE,kEAAkE;IAClE,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ,CAAC,CAAC;IAC1B,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC;IAC7D,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,IAAI,EAAE,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC;CAC5D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,aAAa,CAAC,CAAC,GAAG,OAAO;IACrC,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,KAAK,CAAsC;IAEnD,YAAY,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAS3C;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,IAAI,WAAW,IAAI,SAAS,IAAI,EAAE,CAEjC;IAED,KAAK,IAAI,OAAO,CAIf;IAED,mEAAmE;IACnE,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC,CAuDrB;IAED,MAAM,IAAI,IAAI,CAEb;IAED,MAAM,IAAI,iBAAiB,CAE1B;IAED,MAAM,CAAC,QAAQ,CAAC,CAAC,EAChB,OAAO,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,EACzD,IAAI,EAAE,iBAAiB,GACrB,aAAa,CAAC,CAAC,CAAC,CAOlB;CACD"}
+{"version":3,"file":"MultiTurnBeam.d.ts","sourceRoot":"","sources":["../../src/roguelike/MultiTurnBeam.ts"],"names":[],"mappings":"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"}

package/dist/roguelike/MultiTurnBeam.js

@@ -1,11 +1,13 @@
 import { resolveAreaOnLevel } from './Targeting.js';
 /**
- * Advances a straight beam one cell per turn.
+ * Advances a beam one front per turn.
  *
- * The framework owns traversal and timing. A game supplies target lookup and damage
- * application, so this stays useful for hit points, shields, status effects and any other
- * combat model. The path is captured at construction time, while blockers and targets are
- * checked when each cell is reached. `advance` is deterministic when those callbacks are.
+ * The framework owns traversal and timing. A game supplies target lookup and damage application,
+ * so this stays useful for hit points, shields, status effects and any other combat model. The
+ * default shape is a straight line captured at construction time; `fronts` opts into a per-turn
+ * front resolver, which is what expresses a cone, a burst, a fork or a moving front without any
+ * of those rules living here. Blockers and targets are checked when each cell is reached, so
+ * `advance` is deterministic when those callbacks are.
  *
  * @example
  * ```ts
@@ -28,7 +30,16 @@ export class MultiTurnBeam {
             throw new Error('beam damage must be non-negative');
         }
         this.options = options;
-        this.path = resolveAreaOnLevel(options.level, options.from, options.target, { kind: 'line' }).slice(1);
+        this.shape = options.shape ?? (options.fronts ? 'fronts' : 'line');
+        if (options.fronts) {
+            const first = options.fronts([{ ...options.from }], 0);
+            this.fronts = first.length ? [first.map((cell) => ({ ...cell }))] : [];
+        }
+        else {
+            this.fronts = resolveAreaOnLevel(options.level, options.from, options.target, { kind: 'line' })
+                .slice(1)
+                .map((cell) => [{ ...cell }]);
+        }
     }
     get active() {
         return this.state === 'active';
@@ -36,64 +47,65 @@ export class MultiTurnBeam {
     get done() {
         return this.state === 'done' || this.state === 'blocked' || this.state === 'cancelled';
     }
+    /** The shape this beam was built with, for a save or a UI label. */
+    get beamShape() {
+        return this.shape;
+    }
+    /** Every cell of every resolved front, in order - the straight path of a line beam. */
     get currentPath() {
-        return this.path;
+        return this.fronts.flat().map((cell) => ({ ...cell }));
     }
     start() {
         if (this.state !== 'idle')
             return false;
-        this.state = this.path.length === 0 ? 'done' : 'active';
+        this.state = this.fronts.length === 0 ? 'done' : 'active';
         return true;
     }
-    /** Resolves and applies one beam cell. Call once per game turn. */
+    /** Resolves and applies one beam front. Call once per game turn. */
     advance() {
-        if (this.state !== 'active') {
-            return {
-                status: this.state,
-                cell: null,
-                step: this.index,
-                remaining: Math.max(0, this.path.length - this.index),
-                targets: [],
-                damage: 0,
-            };
-        }
-        const cell = this.path[this.index];
-        const context = {
-            cell: { ...cell },
-            step: this.index,
-            remaining: this.path.length - this.index - 1,
-        };
-        const blocked = !this.options.level.inside(cell.x, cell.y) ||
-            (this.options.stopAtOpaque !== false && !this.options.level.transparent(cell.x, cell.y)) ||
-            this.options.isBlocked?.(cell, context) === true;
-        if (blocked) {
-            this.state = 'blocked';
-            return {
-                status: 'blocked',
-                cell: { ...cell },
-                step: this.index,
-                remaining: context.remaining,
-                targets: [],
-                damage: 0,
-            };
-        }
-        const targets = this.options.targetsAt?.(cell) ?? [];
+        if (this.state !== 'active')
+            return this.inactiveStep();
+        const front = this.fronts[this.index] ?? [];
+        const remaining = Math.max(0, this.fronts.length - this.index - 1);
+        const cells = [];
+        const targets = [];
         let damage = 0;
-        for (const target of targets) {
-            const amount = typeof this.options.damage === 'function' ? this.options.damage(target, context) : this.options.damage;
-            if (!Number.isFinite(amount) || amount < 0)
-                throw new Error('beam damage callback must return a non-negative finite number');
-            damage += amount;
-            this.options.applyDamage?.(target, amount, context);
+        for (const raw of front) {
+            const context = { cell: { ...raw }, step: this.index, remaining };
+            if (this.blocked(raw, context))
+                continue;
+            cells.push({ ...raw });
+            this.options.onCell?.({ ...raw }, context);
+            for (const target of this.options.targetsAt?.(raw) ?? []) {
+                const amount = typeof this.options.damage === 'function'
+                    ? this.options.damage(target, context)
+                    : this.options.damage;
+                if (!Number.isFinite(amount) || amount < 0)
+                    throw new Error('beam damage callback must return a non-negative finite number');
+                damage += amount;
+                targets.push(target);
+                this.options.applyDamage?.(target, amount, context);
+            }
         }
+        const step = this.index;
         this.index++;
-        if (this.index >= this.path.length)
+        //a per-turn resolver extends the beam from what this front actually reached; a blocked
+        //cell does not propagate, and no cells at all ends the show
+        if (this.options.fronts && cells.length > 0) {
+            const next = this.options.fronts(cells.map((cell) => ({ ...cell })), this.index);
+            if (next.length)
+                this.fronts.push(next.map((cell) => ({ ...cell })));
+        }
+        if (cells.length === 0)
+            this.state = 'blocked';
+        else if (this.index >= this.fronts.length)
             this.state = 'done';
         return {
-            status: this.state === 'done' ? 'done' : 'active',
-            cell: { ...cell },
-            step: context.step,
-            remaining: context.remaining,
+            status: cells.length === 0 ? 'blocked' : this.state,
+            cell: cells[0] ? { ...cells[0] } : null,
+            cells: cells.map((cell) => ({ ...cell })),
+            step,
+            remaining,
             targets: [...targets],
             damage,
         };
@@ -103,15 +115,50 @@ export class MultiTurnBeam {
             this.state = 'cancelled';
     }
     toJSON() {
-        return { path: this.path.map((cell) => ({ ...cell })), index: this.index, state: this.state };
+        return {
+            state: this.state,
+            fronts: this.fronts.map((front) => front.map((cell) => ({ ...cell }))),
+            index: this.index,
+            shape: this.shape,
+        };
     }
     static fromJSON(options, data) {
+        const shape = data.shape ?? (options.fronts ? 'fronts' : 'line');
+        if (options.shape !== undefined && options.shape !== shape)
+            throw new Error(`beam save is shape "${shape}", not "${options.shape}"`);
         const beam = Object.create(MultiTurnBeam.prototype);
         beam.options = options;
-        beam.path = data.path.map((cell) => ({ ...cell }));
+        beam.shape = shape;
+        //a save written before fronts landed stored one cell per turn as `path`
+        beam.fronts = data.fronts
+            ? data.fronts.map((front) => front.map((cell) => ({ ...cell })))
+            : (data.path ?? []).map((cell) => [{ ...cell }]);
         beam.index = data.index;
         beam.state = data.state;
         return beam;
     }
+    blocked(cell, context) {
+        const blocker = this.options.blocker ?? (this.options.stopAtOpaque === false ? 'none' : 'terrain');
+        let blockedByPolicy = false;
+        if (blocker === 'terrain') {
+            blockedByPolicy =
+                !this.options.level.inside(cell.x, cell.y) || !this.options.level.transparent(cell.x, cell.y);
+        }
+        else if (blocker !== 'none') {
+            blockedByPolicy = blocker({ ...cell }, context) === true;
+        }
+        return blockedByPolicy || this.options.isBlocked?.({ ...cell }, context) === true;
+    }
+    inactiveStep() {
+        return {
+            status: this.state,
+            cell: null,
+            cells: [],
+            step: this.index,
+            remaining: Math.max(0, this.fronts.length - this.index),
+            targets: [],
+            damage: 0,
+        };
+    }
 }
 //# sourceMappingURL=MultiTurnBeam.js.map

package/dist/roguelike/MultiTurnBeam.js.map

@@ -1 +1 @@
-{"version":3,"file":"MultiTurnBeam.js","sourceRoot":"","sources":["../../src/roguelike/MultiTurnBeam.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"MultiTurnBeam.js","sourceRoot":"","sources":["../../src/roguelike/MultiTurnBeam.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAuEpD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,aAAa;IAOzB,YAAY,OAAgC;QAJpC,UAAK,GAAG,CAAC,CAAC;QACV,UAAK,GAA+B,MAAM,CAAC;QAIlD,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,UAAU,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9E,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACnE,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YACvD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,CAAC;aAAM,CAAC;YACP,IAAI,CAAC,MAAM,GAAG,kBAAkB,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;iBAC7F,KAAK,CAAC,CAAC,CAAC;iBACR,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;QAChC,CAAC;IACF,CAAC;IAED,IAAI,MAAM;QACT,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC;IAChC,CAAC;IAED,IAAI,IAAI;QACP,OAAO,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,CAAC;IACxF,CAAC;IAED,oEAAoE;IACpE,IAAI,SAAS;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;IAED,uFAAuF;IACvF,IAAI,WAAW;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,KAAK;QACJ,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM;YAAE,OAAO,KAAK,CAAC;QACxC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC1D,OAAO,IAAI,CAAC;IACb,CAAC;IAED,oEAAoE;IACpE,OAAO;QACN,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC;QAExD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACnE,MAAM,KAAK,GAAW,EAAE,CAAC;QACzB,MAAM,OAAO,GAAQ,EAAE,CAAC;QACxB,IAAI,MAAM,GAAG,CAAC,CAAC;QAEf,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,OAAO,GAAsB,EAAE,IAAI,EAAE,EAAE,GAAG,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC;YACrF,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC;gBAAE,SAAS;YAEzC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;YACvB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;YAC3C,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC1D,MAAM,MAAM,GACX,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,UAAU;oBACxC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;oBACtC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;gBACxB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC;oBACzC,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;gBAClF,MAAM,IAAI,MAAM,CAAC;gBACjB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACrB,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YACrD,CAAC;QACF,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,KAAK,EAAE,CAAC;QAEb,uFAAuF;QACvF,4DAA4D;QAC5D,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAC/B,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,EAClC,IAAI,CAAC,KAAK,CACV,CAAC;YACF,IAAI,IAAI,CAAC,MAAM;gBAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACtE,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;aAC1C,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;QAE/D,OAAO;YACN,MAAM,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK;YACnD,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI;YACvC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;YACzC,IAAI;YACJ,SAAS;YACT,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC;YACrB,MAAM;SACN,CAAC;IACH,CAAC;IAED,MAAM;QACL,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM;YAAE,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC;IAChF,CAAC;IAED,MAAM;QACL,OAAO;YACN,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;YACtE,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;SACjB,CAAC;IACH,CAAC;IAED,MAAM,CAAC,QAAQ,CACd,OAAyD,EACzD,IAAuB;QAEvB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACjE,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK;YACzD,MAAM,IAAI,KAAK,CAAC,uBAAuB,KAAK,WAAW,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC;QAE1E,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAqB,CAAC;QACxE,IAAI,CAAC,OAAO,GAAG,OAAkC,CAAC;QAClD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,wEAAwE;QACxE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM;YACxB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;YAChE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;QAClD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,OAAO,IAAI,CAAC;IACb,CAAC;IAEO,OAAO,CAAC,IAAU,EAAE,OAA0B;QACrD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACnG,IAAI,eAAe,GAAG,KAAK,CAAC;QAC5B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC3B,eAAe;gBACd,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAChG,CAAC;aAAM,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;YAC/B,eAAe,GAAG,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QAC1D,CAAC;QACD,OAAO,eAAe,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACnF,CAAC;IAEO,YAAY;QACnB,OAAO;YACN,MAAM,EAAE,IAAI,CAAC,KAAK;YAClB,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,EAAE;YACT,IAAI,EAAE,IAAI,CAAC,KAAK;YAChB,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC;YACvD,OAAO,EAAE,EAAE;YACX,MAAM,EAAE,CAAC;SACT,CAAC;IACH,CAAC;CACD"}

package/dist/roguelike/Targeting.d.ts

@@ -1,5 +1,6 @@
 import type { Level } from './Level.ts';
 import type { Step } from './Pathfinder.ts';
+import { Signal } from '../core/Signal.ts';
 /**
  * How a target resolves into the cells it actually affects.
  *
@@ -180,4 +181,97 @@ export declare function areaFalloffMultiplier(index: number, steps: readonly num
  * very first cell already blocks, in which case the shove lands against the wall instead.
  */
 export declare function knockbackPath(level: Level, from: Step, direction: Step, distance: number): Step[];
+export interface TargetingControllerOptions {
+    /** where the aim starts: the thrower's own cell */
+    origin: Step;
+    /** how far the aim reaches, in the owning shape's own ruler (`canTarget`'s) */
+    range: number;
+    /** whether a wall between origin and cursor blocks the aim; on by default */
+    requireLineOfSight?: boolean;
+    /** how a confirmed aim resolves into cells; a single cell by default */
+    shape?: AreaShape;
+    /** the cursor's first cell; defaults to `origin` */
+    cursor?: Step;
+    /**
+     * A game's own rule on top of range and sight (not through an ally, not an empty floor
+     * tile). The controller never guesses what is in a cell: only the game knows.
+     */
+    validate?: (target: Step) => boolean;
+}
+/** What `TargetingController.confirm` returns, and what its `onConfirm` carries. Cells only. */
+export interface TargetResult {
+    readonly origin: Step;
+    readonly target: Step;
+    readonly shape: AreaShape;
+    /** the cells the shape affects, resolved through the level's own topology */
+    readonly cells: readonly Step[];
+}
+/**
+ * The input-facing half of targeting: a cursor a player moves over cells, the range and
+ * line-of-sight rule that decides whether the current aim is legal, an optional preview of
+ * the shape, and a confirm/cancel result. It carries no renderer: `moveTo` takes a cell, so
+ * a game converts its own pointer position through its own camera, and the controller hands
+ * back cells for the game to draw and resolve. Legality beyond range and sight is the
+ * optional `validate` hook's job, and damage is never the controller's business.
+ *
+ * @example
+ * ```ts
+ * import { Level, FLOOR, WALL, TargetingController } from '@datamoc/mw_games/roguelike';
+ *
+ * const level = new Level(12, 12, [WALL, FLOOR], 1);
+ * const aiming = new TargetingController(level, {
+ *   origin: { x: 2, y: 2 },
+ *   range: 6,
+ *   shape: { kind: 'burst', radius: 1 },
+ * });
+ *
+ * aiming.move(1, 0); // keyboard: one cell east
+ * aiming.moveTo({ x: 5, y: 2 }); // pointer: the caller resolved the screen point first
+ * console.log(aiming.valid); // in range and in sight
+ * console.log(aiming.preview()); // the burst's cells, or [] while the aim is illegal
+ *
+ * const shot = aiming.confirm(); // null when illegal, the target cells when not
+ * ```
+ */
+export declare class TargetingController {
+    readonly onMove: Signal<Step>;
+    readonly onConfirm: Signal<TargetResult>;
+    readonly onCancel: Signal<void>;
+    private readonly level;
+    private readonly origin;
+    private readonly range;
+    private readonly requireLineOfSight;
+    private readonly validate?;
+    private shape;
+    private cursor;
+    constructor(level: Level, options: TargetingControllerOptions);
+    /** the cell the cursor is on now, as a copy - mutating it does not move the aim */
+    get target(): Step;
+    /** how many cells the cursor is from the origin, in the level's own ruler */
+    get distance(): number;
+    get inRange(): boolean;
+    get inSight(): boolean;
+    /** whether the current aim is legal: range, sight unless waived, and the game's own rule */
+    get valid(): boolean;
+    /**
+     * Moves the cursor one cell, for keyboard and gamepad navigation. On a square level the
+     * offset is added directly; on a hex level it is looked up among the cursor's six
+     * neighbours, since only the level knows which offset means which direction there. A move
+     * that would leave the map is ignored rather than clamped to its edge.
+     */
+    move(dx: number, dy: number): void;
+    /**
+     * Moves the cursor to a specific cell, for pointer navigation: the caller has already
+     * turned a screen point into a cell through its own camera. Off-map cells are ignored.
+     */
+    moveTo(cell: Step): void;
+    /** Replaces the shape a confirm resolves to, keeping the cursor where it is. */
+    setShape(shape: AreaShape): void;
+    /** The cells the current aim would affect, for a preview overlay; empty while illegal. */
+    preview(): Step[];
+    /** Returns the confirmed target, or null when the current aim is illegal. */
+    confirm(): TargetResult | null;
+    /** Abandons the aim without confirming; the game closes its own overlay on `onCancel`. */
+    cancel(): void;
+}
 //# sourceMappingURL=Targeting.d.ts.map

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

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

package/dist/roguelike/Targeting.js

@@ -1,4 +1,5 @@
 import { hexDistance, hexLine, hexRange } from '../core/Hex.js';
+import { Signal } from '../core/Signal.js';
 /**
  * The straight-line ruler distance a roguelike uses: diagonals cost the same as a step.
  *
@@ -284,4 +285,126 @@ export function knockbackPath(level, from, direction, distance) {
     }
     return cells;
 }
+/**
+ * The input-facing half of targeting: a cursor a player moves over cells, the range and
+ * line-of-sight rule that decides whether the current aim is legal, an optional preview of
+ * the shape, and a confirm/cancel result. It carries no renderer: `moveTo` takes a cell, so
+ * a game converts its own pointer position through its own camera, and the controller hands
+ * back cells for the game to draw and resolve. Legality beyond range and sight is the
+ * optional `validate` hook's job, and damage is never the controller's business.
+ *
+ * @example
+ * ```ts
+ * import { Level, FLOOR, WALL, TargetingController } from '@datamoc/mw_games/roguelike';
+ *
+ * const level = new Level(12, 12, [WALL, FLOOR], 1);
+ * const aiming = new TargetingController(level, {
+ *   origin: { x: 2, y: 2 },
+ *   range: 6,
+ *   shape: { kind: 'burst', radius: 1 },
+ * });
+ *
+ * aiming.move(1, 0); // keyboard: one cell east
+ * aiming.moveTo({ x: 5, y: 2 }); // pointer: the caller resolved the screen point first
+ * console.log(aiming.valid); // in range and in sight
+ * console.log(aiming.preview()); // the burst's cells, or [] while the aim is illegal
+ *
+ * const shot = aiming.confirm(); // null when illegal, the target cells when not
+ * ```
+ */
+export class TargetingController {
+    constructor(level, options) {
+        this.onMove = new Signal();
+        this.onConfirm = new Signal();
+        this.onCancel = new Signal();
+        if (!Number.isFinite(options.range) || options.range < 0) {
+            throw new Error('targeting range must be a finite non-negative number');
+        }
+        this.level = level;
+        this.origin = { ...options.origin };
+        this.range = options.range;
+        this.requireLineOfSight = options.requireLineOfSight ?? true;
+        this.validate = options.validate;
+        this.shape = options.shape ?? { kind: 'single' };
+        this.cursor = { ...(options.cursor ?? options.origin) };
+    }
+    /** the cell the cursor is on now, as a copy - mutating it does not move the aim */
+    get target() {
+        return { ...this.cursor };
+    }
+    /** how many cells the cursor is from the origin, in the level's own ruler */
+    get distance() {
+        return this.level.shape === 'hex'
+            ? hexDistance(this.origin, this.cursor)
+            : chebyshevDistance(this.origin, this.cursor);
+    }
+    get inRange() {
+        return this.distance <= this.range;
+    }
+    get inSight() {
+        return hasLineOfSight(this.level, this.origin, this.cursor);
+    }
+    /** whether the current aim is legal: range, sight unless waived, and the game's own rule */
+    get valid() {
+        if (!this.inRange)
+            return false;
+        if (this.requireLineOfSight && !this.inSight)
+            return false;
+        return this.validate ? this.validate(this.cursor) : true;
+    }
+    /**
+     * Moves the cursor one cell, for keyboard and gamepad navigation. On a square level the
+     * offset is added directly; on a hex level it is looked up among the cursor's six
+     * neighbours, since only the level knows which offset means which direction there. A move
+     * that would leave the map is ignored rather than clamped to its edge.
+     */
+    move(dx, dy) {
+        if (this.level.shape === 'hex') {
+            const next = this.level
+                .neighbors(this.cursor.x, this.cursor.y)
+                .find((neighbor) => neighbor.x - this.cursor.x === dx && neighbor.y - this.cursor.y === dy);
+            if (next)
+                this.moveTo(next);
+            return;
+        }
+        this.moveTo({ x: this.cursor.x + dx, y: this.cursor.y + dy });
+    }
+    /**
+     * Moves the cursor to a specific cell, for pointer navigation: the caller has already
+     * turned a screen point into a cell through its own camera. Off-map cells are ignored.
+     */
+    moveTo(cell) {
+        if (!this.level.inside(cell.x, cell.y))
+            return;
+        this.cursor = { x: cell.x, y: cell.y };
+        this.onMove.dispatch({ ...this.cursor });
+    }
+    /** Replaces the shape a confirm resolves to, keeping the cursor where it is. */
+    setShape(shape) {
+        this.shape = shape;
+    }
+    /** The cells the current aim would affect, for a preview overlay; empty while illegal. */
+    preview() {
+        if (!this.valid)
+            return [];
+        return resolveAreaOnLevel(this.level, this.origin, this.cursor, this.shape);
+    }
+    /** Returns the confirmed target, or null when the current aim is illegal. */
+    confirm() {
+        if (!this.valid)
+            return null;
+        const result = {
+            origin: { ...this.origin },
+            target: { ...this.cursor },
+            shape: this.shape,
+            cells: this.preview(),
+        };
+        this.onConfirm.dispatch(result);
+        return result;
+    }
+    /** Abandons the aim without confirming; the game closes its own overlay on `onCancel`. */
+    cancel() {
+        this.onCancel.dispatch();
+    }
+}
 //# sourceMappingURL=Targeting.js.map