@datamoc/mw_games 0.44.2 → 0.45.0

package/dist/roguelike/Level.js.map

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

package/dist/roguelike/MonsterAI.d.ts

@@ -1,54 +0,0 @@
-import type { Level } from './Level.ts';
-import { type PathOptions, type Pathfinder, type Step } from './Pathfinder.ts';
-export type AIState = 'wander' | 'hunt' | 'flee';
-/** hostile hunts on sight, same as ever; neutral/peaceful only wander until `provoked` */
-export type Disposition = 'hostile' | 'neutral' | 'peaceful';
-export interface AIDecision {
-    state: AIState;
-    /** where to move this turn; null when there is nowhere sensible to go */
-    step: Step | null;
-}
-export interface MonsterAIOptions extends PathOptions {
-    /** how far the monster can see, in cells - its own sight range, not the player's */
-    sightRadius?: number;
-    /** HP fraction (0 to 1) at or below which a visible target is fled rather than hunted */
-    fleeBelow?: number;
-    /** defaults to 'hostile' - always hunts on sight, exactly like every monster used to */
-    disposition?: Disposition;
-    /**
-     * true once this monster has been attacked (or otherwise provoked) - overrides a
-     * neutral/peaceful disposition back to hunting, permanently, the same as `hostile`. A
-     * game tracks this per monster and sets it the moment it lands the provoking hit; this
-     * function stores no state of its own between calls, same as `hpFraction`.
-     */
-    provoked?: boolean;
-}
-/**
- * One monster's turn: wander when the target is outside its own sight, hunt when it can see
- * the target and is healthy, flee when it can see the target and its own HP has dropped to
- * `fleeBelow` or lower. Built entirely from `FieldOfView` and `Pathfinder` - both already
- * shipped - so this is what turns them into an actual decision, rather than a game
- * hand-rolling the same wander/hunt/flee branch on its own.
- *
- * A fresh `FieldOfView` per call is deliberate: a monster's sight is its own, not the
- * player's, and computing a small-radius shadowcast once per monster per turn is cheap at
- * the monster counts a level actually has. `mwg` does not decide what a monster does with
- * the result - a game's own turn loop calls this once per monster and acts on the `step`
- * (or doesn't, for wander's "nowhere in particular").
- *
- * @example
- * ```ts
- * import { decideMonsterAI, Pathfinder, Level, WALL, FLOOR } from '@datamoc/mw_games/roguelike';
- *
- * const level = new Level(20, 20, [WALL, FLOOR], 1);
- * const pathfinder = new Pathfinder(level);
- *
- * const decision = decideMonsterAI(level, pathfinder, { x: 5, y: 5 }, 0.8, { x: 8, y: 5 }, {
- *   sightRadius: 6,
- *   fleeBelow: 0.2,
- * });
- * if (decision.step) console.log(decision.state, decision.step); // 'hunt', a step towards the player
- * ```
- */
-export declare function decideMonsterAI(level: Level, pathfinder: Pathfinder, self: Step, hpFraction: number, target: Step, options?: MonsterAIOptions): AIDecision;
-//# sourceMappingURL=MonsterAI.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"MonsterAI.d.ts","sourceRoot":"","sources":["../../src/roguelike/MonsterAI.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAoB,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEjG,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEjD,0FAA0F;AAC1F,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAE7D,MAAM,WAAW,UAAU;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,yEAAyE;IACzE,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACpD,oFAAoF;IACpF,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,yFAAyF;IACzF,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,wFAAwF;IACxF,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,eAAe,CAC9B,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,IAAI,EACZ,OAAO,GAAE,gBAAqB,GAC5B,UAAU,CAqBZ"}

package/dist/roguelike/MonsterAI.js

@@ -1,83 +0,0 @@
-import * as Random from '../core/Random.js';
-import { FieldOfView } from './FieldOfView.js';
-import { neighbourOffsets } from './Pathfinder.js';
-/**
- * One monster's turn: wander when the target is outside its own sight, hunt when it can see
- * the target and is healthy, flee when it can see the target and its own HP has dropped to
- * `fleeBelow` or lower. Built entirely from `FieldOfView` and `Pathfinder` - both already
- * shipped - so this is what turns them into an actual decision, rather than a game
- * hand-rolling the same wander/hunt/flee branch on its own.
- *
- * A fresh `FieldOfView` per call is deliberate: a monster's sight is its own, not the
- * player's, and computing a small-radius shadowcast once per monster per turn is cheap at
- * the monster counts a level actually has. `mwg` does not decide what a monster does with
- * the result - a game's own turn loop calls this once per monster and acts on the `step`
- * (or doesn't, for wander's "nowhere in particular").
- *
- * @example
- * ```ts
- * import { decideMonsterAI, Pathfinder, Level, WALL, FLOOR } from '@datamoc/mw_games/roguelike';
- *
- * const level = new Level(20, 20, [WALL, FLOOR], 1);
- * const pathfinder = new Pathfinder(level);
- *
- * const decision = decideMonsterAI(level, pathfinder, { x: 5, y: 5 }, 0.8, { x: 8, y: 5 }, {
- *   sightRadius: 6,
- *   fleeBelow: 0.2,
- * });
- * if (decision.step) console.log(decision.state, decision.step); // 'hunt', a step towards the player
- * ```
- */
-export function decideMonsterAI(level, pathfinder, self, hpFraction, target, options = {}) {
-    const sightRadius = options.sightRadius ?? 6;
-    const fleeBelow = options.fleeBelow ?? 0;
-    const hunts = (options.disposition ?? 'hostile') === 'hostile' || options.provoked === true;
-    if (!hunts) {
-        return { state: 'wander', step: wanderStep(level, self, options) };
-    }
-    const fov = new FieldOfView(level);
-    fov.update(self.x, self.y, sightRadius);
-    if (!fov.isVisible(target.x, target.y)) {
-        return { state: 'wander', step: wanderStep(level, self, options) };
-    }
-    if (hpFraction <= fleeBelow) {
-        return { state: 'flee', step: fleeStep(level, self, target, options) };
-    }
-    return { state: 'hunt', step: pathfinder.step(self, target, options) };
-}
-/** a random open neighbour, or null when boxed in - wandering needs no path, just a step */
-function wanderStep(level, self, options) {
-    const open = openNeighbours(level, self, options);
-    return Random.element(open);
-}
-/** the open neighbour furthest from the target - moving away needs no path either */
-function fleeStep(level, self, target, options) {
-    const open = openNeighbours(level, self, options);
-    let best = null;
-    let bestDistance = distanceSquared(self, target);
-    for (const step of open) {
-        const distance = distanceSquared(step, target);
-        if (distance > bestDistance) {
-            bestDistance = distance;
-            best = step;
-        }
-    }
-    return best;
-}
-function openNeighbours(level, self, options) {
-    const blocked = options.blocked;
-    const out = [];
-    for (const [dx, dy] of neighbourOffsets(options.topology ?? 8)) {
-        const step = { x: self.x + dx, y: self.y + dy };
-        if (!level.passable(step.x, step.y))
-            continue;
-        if (blocked?.has(level.index(step.x, step.y)))
-            continue;
-        out.push(step);
-    }
-    return out;
-}
-function distanceSquared(a, b) {
-    return (a.x - b.x) ** 2 + (a.y - b.y) ** 2;
-}
-//# sourceMappingURL=MonsterAI.js.map

package/dist/roguelike/MonsterAI.js.map

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

package/dist/roguelike/MultiStageAbility.d.ts

@@ -1,59 +0,0 @@
-/**
- * An ability whose own use unfolds through named stages in sequence (windup, active, recovery)
- * rather than resolving instantly - the multi-stage subclass/ability shape a talent branch's
- * capstone move often needs, distinct from `AbilityCycle`'s cooldown-only view of "may I use
- * this yet". `mwg` tracks only which stage is current and when it should advance; what each
- * stage does (grant invulnerability, deal damage, open a window for a follow-up) stays the
- * game's own hook, fired from `advance`'s returned stage name.
- */
-export interface AbilityStage {
-    name: string;
-    /** turns this stage lasts once entered */
-    duration: number;
-}
-/**
- * @example
- * ```ts
- * import { MultiStageAbility } from '@datamoc/mw_games/roguelike';
- *
- * const dive = new MultiStageAbility([
- *   { name: 'windup', duration: 1 },
- *   { name: 'active', duration: 1 },
- *   { name: 'recovery', duration: 2 },
- * ]);
- *
- * dive.start();
- * console.log(dive.stage?.name); // 'windup'
- * dive.advance(); // one turn passes; moves to 'active' once windup's duration elapses
- * ```
- */
-export declare class MultiStageAbility {
-    private stages;
-    private index;
-    private remaining;
-    constructor(stages: readonly AbilityStage[]);
-    /** whether the ability is currently mid-sequence */
-    get active(): boolean;
-    /** the currently active stage, or null when not in use */
-    get stage(): AbilityStage | null;
-    /** begins the ability at its first stage; a no-op, reporting false, while already active */
-    start(): boolean;
-    /**
-     * Advances one turn.
-     *
-     * @returns the newly entered stage's name the turn a stage changes, `'done'` the turn the
-     * last stage finishes, or null when nothing changed (still mid-stage, or never started)
-     */
-    advance(): string | null;
-    /** ends the ability early - interrupted mid-windup, say */
-    cancel(): void;
-    toJSON(): {
-        index: number;
-        remaining: number;
-    };
-    static fromJSON(stages: readonly AbilityStage[], data: {
-        index: number;
-        remaining: number;
-    }): MultiStageAbility;
-}
-//# sourceMappingURL=MultiStageAbility.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"MultiStageAbility.d.ts","sourceRoot":"","sources":["../../src/roguelike/MultiStageAbility.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IAEb,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,SAAS,CAAK;IAEtB,YAAY,MAAM,EAAE,SAAS,YAAY,EAAE,EAG1C;IAED,oDAAoD;IACpD,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,0DAA0D;IAC1D,IAAI,KAAK,IAAI,YAAY,GAAG,IAAI,CAE/B;IAED,4FAA4F;IAC5F,KAAK,IAAI,OAAO,CAKf;IAED;;;;;OAKG;IACH,OAAO,IAAI,MAAM,GAAG,IAAI,CAYvB;IAED,2DAA2D;IAC3D,MAAM,IAAI,IAAI,CAGb;IAED,MAAM,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAE7C;IAED,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,iBAAiB,CAK9G;CACD"}

package/dist/roguelike/MultiStageAbility.js

@@ -1,76 +0,0 @@
-/**
- * @example
- * ```ts
- * import { MultiStageAbility } from '@datamoc/mw_games/roguelike';
- *
- * const dive = new MultiStageAbility([
- *   { name: 'windup', duration: 1 },
- *   { name: 'active', duration: 1 },
- *   { name: 'recovery', duration: 2 },
- * ]);
- *
- * dive.start();
- * console.log(dive.stage?.name); // 'windup'
- * dive.advance(); // one turn passes; moves to 'active' once windup's duration elapses
- * ```
- */
-export class MultiStageAbility {
-    constructor(stages) {
-        this.index = -1;
-        this.remaining = 0;
-        if (stages.length === 0)
-            throw new Error('a multi-stage ability needs at least one stage');
-        this.stages = stages;
-    }
-    /** whether the ability is currently mid-sequence */
-    get active() {
-        return this.index >= 0;
-    }
-    /** the currently active stage, or null when not in use */
-    get stage() {
-        return this.index >= 0 ? this.stages[this.index] : null;
-    }
-    /** begins the ability at its first stage; a no-op, reporting false, while already active */
-    start() {
-        if (this.active)
-            return false;
-        this.index = 0;
-        this.remaining = this.stages[0].duration;
-        return true;
-    }
-    /**
-     * Advances one turn.
-     *
-     * @returns the newly entered stage's name the turn a stage changes, `'done'` the turn the
-     * last stage finishes, or null when nothing changed (still mid-stage, or never started)
-     */
-    advance() {
-        if (!this.active)
-            return null;
-        this.remaining--;
-        if (this.remaining > 0)
-            return null;
-        this.index++;
-        if (this.index >= this.stages.length) {
-            this.index = -1;
-            return 'done';
-        }
-        this.remaining = this.stages[this.index].duration;
-        return this.stages[this.index].name;
-    }
-    /** ends the ability early - interrupted mid-windup, say */
-    cancel() {
-        this.index = -1;
-        this.remaining = 0;
-    }
-    toJSON() {
-        return { index: this.index, remaining: this.remaining };
-    }
-    static fromJSON(stages, data) {
-        const ability = new MultiStageAbility(stages);
-        ability.index = data.index;
-        ability.remaining = data.remaining;
-        return ability;
-    }
-}
-//# sourceMappingURL=MultiStageAbility.js.map

package/dist/roguelike/MultiStageAbility.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"MultiStageAbility.js","sourceRoot":"","sources":["../../src/roguelike/MultiStageAbility.ts"],"names":[],"mappings":"AAeA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,iBAAiB;IAK7B,YAAY,MAA+B;QAHnC,UAAK,GAAG,CAAC,CAAC,CAAC;QACX,cAAS,GAAG,CAAC,CAAC;QAGrB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QAC3F,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,CAAC;IAED,oDAAoD;IACpD,IAAI,MAAM;QACT,OAAO,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,0DAA0D;IAC1D,IAAI,KAAK;QACR,OAAO,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACzD,CAAC;IAED,4FAA4F;IAC5F,KAAK;QACJ,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;QACf,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QACzC,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;OAKG;IACH,OAAO;QACN,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAC9B,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAEpC,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACtC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YAChB,OAAO,MAAM,CAAC;QACf,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC;QAClD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;IACrC,CAAC;IAED,2DAA2D;IAC3D,MAAM;QACL,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAChB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;IACpB,CAAC;IAED,MAAM;QACL,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;IACzD,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,MAA+B,EAAE,IAA0C;QAC1F,MAAM,OAAO,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC9C,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QAC3B,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QACnC,OAAO,OAAO,CAAC;IAChB,CAAC;CACD"}

package/dist/roguelike/MultiTurnBeam.d.ts

@@ -1,108 +0,0 @@
-import type { Level } from './Level.ts';
-import type { Step } from './Pathfinder.ts';
-export interface BeamDamageContext {
-    cell: Step;
-    step: number;
-    /** 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;
-    target: Step;
-    damage: number | ((target: T, context: BeamDamageContext) => number);
-    /** Finds live targets at the cell when that cell is reached. */
-    targetsAt?: (cell: Step) => readonly T[];
-    /** Applies the resolved damage. The game owns health, resistances and effects. */
-    applyDamage?: (target: T, amount: number, context: BeamDamageContext) => void;
-    /** An extra game rule on top of `blocker`, e.g. "a wall of fire melts the beam". */
-    isBlocked?: (cell: Step, context: BeamDamageContext) => boolean;
-    /** 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 {
-    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 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
- * 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
- * import { Level, FLOOR, WALL, MultiTurnBeam } from '@datamoc/mw_games/roguelike';
- *
- * const level = new Level(8, 1, [WALL, FLOOR], 1);
- * const beam = new MultiTurnBeam({ level, from: { x: 0, y: 0 }, target: { x: 3, y: 0 }, damage: 4 });
- * beam.start();
- * beam.advance(); // reaches x=1; call again on the next turn
- * ```
- */
-export declare class MultiTurnBeam<T = unknown> {
-    private options;
-    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 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 +0,0 @@
-{"version":3,"file":"MultiTurnBeam.d.ts","sourceRoot":"","sources":["../../src/roguelike/MultiTurnBeam.ts"],"names":[],"mappings":"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"}

package/dist/roguelike/MultiTurnBeam.js

@@ -1,164 +0,0 @@
-import { resolveAreaOnLevel } from './Targeting.js';
-/**
- * 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
- * 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
- * import { Level, FLOOR, WALL, MultiTurnBeam } from '@datamoc/mw_games/roguelike';
- *
- * const level = new Level(8, 1, [WALL, FLOOR], 1);
- * const beam = new MultiTurnBeam({ level, from: { x: 0, y: 0 }, target: { x: 3, y: 0 }, damage: 4 });
- * beam.start();
- * beam.advance(); // reaches x=1; call again on the next turn
- * ```
- */
-export class MultiTurnBeam {
-    constructor(options) {
-        this.index = 0;
-        this.state = 'idle';
-        if (typeof options.damage !== 'function' && !Number.isFinite(options.damage)) {
-            throw new Error('beam damage must be a finite number or a function');
-        }
-        if (typeof options.damage === 'number' && options.damage < 0) {
-            throw new Error('beam damage must be non-negative');
-        }
-        this.options = options;
-        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';
-    }
-    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.fronts.flat().map((cell) => ({ ...cell }));
-    }
-    start() {
-        if (this.state !== 'idle')
-            return false;
-        this.state = this.fronts.length === 0 ? 'done' : 'active';
-        return true;
-    }
-    /** Resolves and applies one beam front. Call once per game turn. */
-    advance() {
-        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 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++;
-        //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: cells.length === 0 ? 'blocked' : this.state,
-            cell: cells[0] ? { ...cells[0] } : null,
-            cells: cells.map((cell) => ({ ...cell })),
-            step,
-            remaining,
-            targets: [...targets],
-            damage,
-        };
-    }
-    cancel() {
-        if (this.state === 'active' || this.state === 'idle')
-            this.state = 'cancelled';
-    }
-    toJSON() {
-        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.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 +0,0 @@
-{"version":3,"file":"MultiTurnBeam.js","sourceRoot":"","sources":["../../src/roguelike/MultiTurnBeam.ts"],"names":[],"mappings":"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"}