@datamoc/mw_games 0.43.0 → 0.45.0

package/dist/rpg/MovableSprite.d.ts

@@ -1,31 +0,0 @@
-/**
- * What a mover actually needs of the thing it moves.
- *
- * `GridMover` and `FreeMover` used to name `render.AnimatedSprite` outright, which said two
- * untrue things: that the thing being moved has to be a sprite at all (it can be any object
- * with a position - a 3D mesh wrapper, a plain record a test asserts against), and that it
- * has to be animated (it does not; `examples/movement` carries a comment apologising for
- * exactly that). Naming the members instead is enough for TypeScript's structural typing:
- * a real `AnimatedSprite` satisfies this without knowing it exists, and so does anything else
- * shaped the same way.
- *
- * The animation members are optional because a mover degrades cleanly without them - a static
- * sprite simply never changes frame, which is what a game with no walk-cycle art wants.
- */
-export interface MovableSprite {
-    x: number;
-    y: number;
-    /** advances a frame-based animation, if the thing being moved has one */
-    update?(dt: number): void;
-    /** whether an animation of this name is registered */
-    has?(animation: string): boolean;
-    /** switches to a registered animation */
-    play?(animation: string): void;
-}
-/**
- * Plays `name` on `sprite` when it names an animation the sprite actually has - the guard
- * both movers share around their walk/idle callbacks, so a missing animation (or a sprite
- * with no animation support at all) is a silent no-op rather than a throw.
- */
-export declare function playMoverAnimation(sprite: MovableSprite, name: string | undefined): void;
-//# sourceMappingURL=MovableSprite.d.ts.map

package/dist/rpg/MovableSprite.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"MovableSprite.d.ts","sourceRoot":"","sources":["../../src/rpg/MovableSprite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,aAAa;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IAEV,yEAAyE;IACzE,MAAM,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,sDAAsD;IACtD,GAAG,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAEjC,yCAAyC;IACzC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAExF"}

package/dist/rpg/MovableSprite.js

@@ -1,10 +0,0 @@
-/**
- * Plays `name` on `sprite` when it names an animation the sprite actually has - the guard
- * both movers share around their walk/idle callbacks, so a missing animation (or a sprite
- * with no animation support at all) is a silent no-op rather than a throw.
- */
-export function playMoverAnimation(sprite, name) {
-    if (name && sprite.has?.(name))
-        sprite.play?.(name);
-}
-//# sourceMappingURL=MovableSprite.js.map

package/dist/rpg/MovableSprite.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"MovableSprite.js","sourceRoot":"","sources":["../../src/rpg/MovableSprite.ts"],"names":[],"mappings":"AA4BA;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAqB,EAAE,IAAwB;IACjF,IAAI,IAAI,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;QAAE,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC;AACrD,CAAC"}

package/dist/rpg/MoveRoute.d.ts

@@ -1,118 +0,0 @@
-import { GridMover, type Direction4 } from './GridMover.ts';
-/**
- * One step of a `MoveRoute`, run in order against a `GridMover`. Unlike `GridMover.moveBy`
- * itself, a route step does not always know its own `dx`/`dy` up front - `random`, `toward`
- * and `away` resolve a direction only when the runner actually reaches that step, against
- * wherever the mover and (for `toward`/`away`) the target happen to be at that moment.
- */
-export type MoveRouteStep = {
-    dir: Direction4;
-} | {
-    dir: 'random';
-}
-/** one tile along (or against) the way the mover currently faces */
- | {
-    dir: 'forward' | 'backward';
-} | ({
-    dir: 'toward' | 'away';
-} & RouteTarget)
-/** a step of any size and direction, diagonals included; `canMove` is asked with the same `dx`/`dy` */
- | {
-    step: {
-        dx: number;
-        dy: number;
-    };
-} | {
-    turn: Direction4 | 'random';
-}
-/** a quarter or half turn from the way the mover currently faces */
- | {
-    turn: 'around' | 'left90' | 'right90';
-} | ({
-    turn: 'toward' | 'away';
-} & RouteTarget) | {
-    jump: {
-        dx: number;
-        dy: number;
-    };
-} | {
-    wait: number;
-};
-/**
- * Where a `toward`/`away` step aims: fixed tile coordinates, or a function asked when the step
- * is reached, for a target that keeps moving (a player, another event).
- */
-export type RouteTarget = {
-    x: number;
-    y: number;
-} | {
-    target: () => {
-        x: number;
-        y: number;
-    };
-};
-export interface MoveRoute {
-    steps: readonly MoveRouteStep[];
-    /** loops back to the first step once the last one finishes, rather than stopping there */
-    repeat?: boolean;
-    /**
-     * when a directional step's target tile is refused by `canMove`, move on to the next step
-     * immediately rather than retrying the same step every tick until it opens up
-     */
-    skippable?: boolean;
-}
-export interface MoveRouteOptions {
-    /** asked before every directional/jump step, the same contract `GridMover` itself expects of its caller */
-    canMove?: (dx: number, dy: number) => boolean;
-    /** source of randomness for `random` steps; defaults to `Math.random` */
-    random?: () => number;
-}
-/**
- * Drives a `GridMover` through a `MoveRoute` over successive `update(dt)` calls - the piece
- * `GridMover`'s own one-step-at-a-time `moveBy`/`turnTo` deliberately leaves out (see its own
- * doc comment: whether a step is passable is the caller's question, not the mover's). Works
- * against any `GridMover`, not only the player's - an NPC's wandering or patrol route is the
- * same shape as a scripted cutscene walk.
- *
- * @example
- * ```ts
- * import { GridMover, MoveRouteRunner, type MoveRoute } from '@datamoc/mw_games/rpg';
- * import type { MovableSprite } from '@datamoc/mw_games/rpg';
- *
- * declare const npcSprite: MovableSprite;
- * declare function tilePassable(x: number, y: number): boolean;
- *
- * const mover = new GridMover(npcSprite, 3, 3, { tileWidth: 32, tileHeight: 32 });
- * const patrol: MoveRoute = {
- *   steps: [{ dir: 'right' }, { dir: 'right' }, { wait: 1 }, { dir: 'left' }, { dir: 'left' }],
- *   repeat: true,
- * };
- * const route = new MoveRouteRunner(mover, patrol, {
- *   canMove: (dx, dy) => tilePassable(mover.x + dx, mover.y + dy),
- * });
- *
- * // in the game loop:
- * mover.update(1 / 60);
- * route.update(1 / 60);
- * ```
- */
-export declare class MoveRouteRunner {
-    private mover;
-    private route;
-    private options;
-    private index;
-    private waiting;
-    constructor(mover: GridMover, route: MoveRoute, options?: MoveRouteOptions);
-    /** true once a non-repeating route has run every step */
-    get done(): boolean;
-    update(dt: number): void;
-    /** @returns whether the step actually moved/turned/waited, so the runner can decide to skip it */
-    private runStep;
-    private resolveDirection;
-    private resolveTurn;
-    /** one tile along the larger axis towards (or away from) a target, from where the mover stands now */
-    private resolveAim;
-    private attempt;
-    private pickDirection;
-}
-//# sourceMappingURL=MoveRoute.d.ts.map

package/dist/rpg/MoveRoute.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"MoveRoute.d.ts","sourceRoot":"","sources":["../../src/rpg/MoveRoute.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAmB5D;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GACtB;IAAE,GAAG,EAAE,UAAU,CAAA;CAAE,GACnB;IAAE,GAAG,EAAE,QAAQ,CAAA;CAAE;AACnB,oEAAoE;GAClE;IAAE,GAAG,EAAE,SAAS,GAAG,UAAU,CAAA;CAAE,GAC/B,CAAC;IAAE,GAAG,EAAE,QAAQ,GAAG,MAAM,CAAA;CAAE,GAAG,WAAW,CAAC;AAC5C,uGAAuG;GACrG;IAAE,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,UAAU,GAAG,QAAQ,CAAA;CAAE;AACjC,oEAAoE;GAClE;IAAE,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAA;CAAE,GACzC,CAAC;IAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAA;CAAE,GAAG,WAAW,CAAC,GAC3C;IAAE,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpB;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,MAAM;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAEhG,MAAM,WAAW,SAAS;IACzB,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAEhC,0FAA0F;IAC1F,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAChC,2GAA2G;IAC3G,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IAE9C,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,eAAe;IAC3B,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,OAAO,CAAK;IAEpB,YAAY,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,gBAAqB,EAI7E;IAED,yDAAyD;IACzD,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAevB;IAED,kGAAkG;IAClG,OAAO,CAAC,OAAO;IAwBf,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,WAAW;IAgBnB,sGAAsG;IACtG,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,aAAa;CAIrB"}

package/dist/rpg/MoveRoute.js

@@ -1,139 +0,0 @@
-import { GridMover } from './GridMover.js';
-const DIRECTIONS = ['up', 'down', 'left', 'right'];
-const DELTA = {
-    up: { dx: 0, dy: -1 },
-    down: { dx: 0, dy: 1 },
-    left: { dx: -1, dy: 0 },
-    right: { dx: 1, dy: 0 },
-};
-/** what a quarter or half turn from each facing lands on */
-const TURNED = {
-    up: { around: 'down', left90: 'left', right90: 'right' },
-    down: { around: 'up', left90: 'right', right90: 'left' },
-    left: { around: 'right', left90: 'down', right90: 'up' },
-    right: { around: 'left', left90: 'up', right90: 'down' },
-};
-/**
- * Drives a `GridMover` through a `MoveRoute` over successive `update(dt)` calls - the piece
- * `GridMover`'s own one-step-at-a-time `moveBy`/`turnTo` deliberately leaves out (see its own
- * doc comment: whether a step is passable is the caller's question, not the mover's). Works
- * against any `GridMover`, not only the player's - an NPC's wandering or patrol route is the
- * same shape as a scripted cutscene walk.
- *
- * @example
- * ```ts
- * import { GridMover, MoveRouteRunner, type MoveRoute } from '@datamoc/mw_games/rpg';
- * import type { MovableSprite } from '@datamoc/mw_games/rpg';
- *
- * declare const npcSprite: MovableSprite;
- * declare function tilePassable(x: number, y: number): boolean;
- *
- * const mover = new GridMover(npcSprite, 3, 3, { tileWidth: 32, tileHeight: 32 });
- * const patrol: MoveRoute = {
- *   steps: [{ dir: 'right' }, { dir: 'right' }, { wait: 1 }, { dir: 'left' }, { dir: 'left' }],
- *   repeat: true,
- * };
- * const route = new MoveRouteRunner(mover, patrol, {
- *   canMove: (dx, dy) => tilePassable(mover.x + dx, mover.y + dy),
- * });
- *
- * // in the game loop:
- * mover.update(1 / 60);
- * route.update(1 / 60);
- * ```
- */
-export class MoveRouteRunner {
-    constructor(mover, route, options = {}) {
-        this.index = 0;
-        this.waiting = 0;
-        this.mover = mover;
-        this.route = route;
-        this.options = options;
-    }
-    /** true once a non-repeating route has run every step */
-    get done() {
-        return !this.route.repeat && this.index >= this.route.steps.length;
-    }
-    update(dt) {
-        if (this.mover.isMoving || this.done)
-            return;
-        if (this.waiting > 0) {
-            this.waiting = Math.max(0, this.waiting - dt);
-            if (this.waiting > 0)
-                return;
-        }
-        if (this.index >= this.route.steps.length) {
-            this.index = 0;
-        }
-        const step = this.route.steps[this.index];
-        const advanced = this.runStep(step);
-        if (advanced || this.route.skippable)
-            this.index++;
-    }
-    /** @returns whether the step actually moved/turned/waited, so the runner can decide to skip it */
-    runStep(step) {
-        if ('turn' in step) {
-            const { dx, dy } = this.resolveTurn(step);
-            this.mover.turnTo(dx, dy);
-            return true;
-        }
-        if ('wait' in step) {
-            this.waiting = step.wait;
-            return true;
-        }
-        if ('jump' in step) {
-            return this.attempt(step.jump.dx, step.jump.dy, (dx, dy) => this.mover.jumpBy(dx, dy));
-        }
-        if ('step' in step) {
-            return this.attempt(step.step.dx, step.step.dy, (dx, dy) => this.mover.moveBy(dx, dy));
-        }
-        const { dx, dy } = this.resolveDirection(step);
-        return this.attempt(dx, dy, (dx, dy) => this.mover.moveBy(dx, dy));
-    }
-    resolveDirection(step) {
-        if (step.dir === 'random')
-            return DELTA[this.pickDirection()];
-        if (step.dir === 'forward')
-            return DELTA[this.mover.facing];
-        if (step.dir === 'backward')
-            return DELTA[TURNED[this.mover.facing].around];
-        if (step.dir === 'toward' || step.dir === 'away')
-            return this.resolveAim(step.dir, step);
-        return DELTA[step.dir];
-    }
-    resolveTurn(step) {
-        if (step.turn === 'random')
-            return DELTA[this.pickDirection()];
-        if (step.turn === 'around' || step.turn === 'left90' || step.turn === 'right90') {
-            return DELTA[TURNED[this.mover.facing][step.turn]];
-        }
-        if (step.turn === 'toward' || step.turn === 'away') {
-            const aim = this.resolveAim(step.turn, step);
-            return aim.dx === 0 && aim.dy === 0 ? DELTA[this.mover.facing] : aim;
-        }
-        return DELTA[step.turn];
-    }
-    /** one tile along the larger axis towards (or away from) a target, from where the mover stands now */
-    resolveAim(way, aim) {
-        const at = 'target' in aim ? aim.target() : aim;
-        const sign = way === 'toward' ? 1 : -1;
-        const ddx = at.x - this.mover.x;
-        const ddy = at.y - this.mover.y;
-        //the larger axis first, matching the direction a step would actually close (or open)
-        return Math.abs(ddx) >= Math.abs(ddy)
-            ? { dx: sign * Math.sign(ddx) || 0, dy: 0 }
-            : { dx: 0, dy: sign * Math.sign(ddy) || 0 };
-    }
-    attempt(dx, dy, move) {
-        if (dx === 0 && dy === 0)
-            return true;
-        if (this.options.canMove && !this.options.canMove(dx, dy))
-            return false;
-        return move(dx, dy);
-    }
-    pickDirection() {
-        const random = this.options.random ?? Math.random;
-        return DIRECTIONS[Math.floor(random() * DIRECTIONS.length)];
-    }
-}
-//# sourceMappingURL=MoveRoute.js.map

package/dist/rpg/MoveRoute.js.map

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

package/dist/rpg/Quest.d.ts

@@ -1,173 +0,0 @@
-import type { GameState } from './GameState.ts';
-import { type EventCondition } from './Event.ts';
-/**
- * One step of a quest: complete once its condition holds, or once its counter reaches a
- * target - "kill 5 rats: 3/5" is a counter stage, "talked to the shopkeeper" a condition
- * one, read off the same `GameState` switches/variables `EventRunner`'s `activePage`
- * conditions already do. A stage with neither is a pure milestone, complete the instant it
- * becomes current - the shape a quest's very first or very last stage often wants.
- */
-export interface QuestStage {
-    condition?: EventCondition;
-    counter?: {
-        variable: string;
-        target: number;
-    };
-    /** shown in a quest log's progress readout; `mwg` never reads this itself */
-    description?: string;
-    /**
-     * Where this stage is satisfied, if anywhere in particular - "kill 5 rats" can
-     * optionally also say where the rats are. `mwg` only carries this data; turning it into
-     * a route or a compass arrow is `roguelike.Pathfinder`'s job (already has everything
-     * needed: `find`/`step`/`distanceMap`) plus the game's own presentation.
-     */
-    location?: {
-        map?: string;
-        x: number;
-        y: number;
-    };
-}
-export interface QuestDefinition {
-    id: string;
-    stages: QuestStage[];
-    /** quest ids that must already be complete before this one can start */
-    requires?: string[];
-}
-export type QuestStatus = 'unavailable' | 'available' | 'active' | 'complete';
-/**
- * What an NPC (or anything else tied to a quest) currently has to offer the player, derived
- * the same way `Achievements`' unlocking already is rather than stored separately:
- * `'offer'` if any tied quest could be started, `'turnIn'` if any is active and its current
- * stage is already satisfied (ready to close out, whether or not the player has actually
- * walked up and done so), `'none'` otherwise. The actual `!`, its colour, and where it
- * floats above a sprite stay the game's own art and UI - this is only the derived bit.
- */
-export type QuestMarker = 'offer' | 'turnIn' | 'none';
-/**
- * Tracks which stage every known quest is on, against `GameState`'s existing switches and
- * variables - not a storage mechanism of its own. A quest's *definition* (its stages, its
- * prerequisites) is static game content, supplied once, the same way the dungeon example's
- * `ITEMS` table is; only which stage each quest has reached is what gets saved.
- *
- * @example
- * ```ts
- * import { QuestLog, GameState } from '@datamoc/mw_games/rpg';
- *
- * const state = new GameState();
- * const quests = new QuestLog();
- * quests.define({ id: 'rats', stages: [{ counter: { variable: 'ratsKilled', target: 5 } }] });
- *
- * quests.track('rats');
- * state.setVariable('ratsKilled', 5);
- * quests.advanceStage('rats', state); // true - the counter stage is satisfied
- *
- * console.log(quests.status('rats')); // 'complete'
- * ```
- */
-export declare class QuestLog {
-    private definitions;
-    /** the stage index a started quest is on; absent means not yet started */
-    private stageIndex;
-    /** the one active quest a game currently points the player towards, if any */
-    private tracked;
-    define(quest: QuestDefinition): void;
-    /** marks `id` as the quest a game currently guides the player towards; `null` to clear it */
-    track(id: string | null): void;
-    /** the currently tracked quest id, or `null` if none is tracked or it is no longer active */
-    trackedQuest(): string | null;
-    /** where the tracked quest's current stage is satisfied, if it says anywhere at all */
-    trackedLocation(): {
-        map?: string;
-        x: number;
-        y: number;
-    } | null;
-    /**
-     * Derives what an NPC tied to `ids` currently has to offer - see `QuestMarker`. Checking
-     * several ids at once covers an NPC that gives one quest and takes in another.
-     */
-    markerFor(ids: readonly string[], state: GameState): QuestMarker;
-    /** whether every prerequisite is already complete, so the quest could be started */
-    canStart(id: string): boolean;
-    /** begins a quest; throws if a prerequisite is not yet complete */
-    start(id: string): void;
-    status(id: string): QuestStatus;
-    /** the stage a quest is currently on; `null` once complete or before it has started */
-    currentStage(id: string): QuestStage | null;
-    /** progress, 0 to 1, towards the current stage's counter; `null` for a condition stage */
-    progress(id: string, state: GameState): number | null;
-    /**
-     * Moves a quest on if its current stage's condition or counter is now satisfied.
-     *
-     * A game calls this after anything that might have finished a stage - an event, a kill,
-     * picking up an item - the same way `EventRunner` re-checks `activePage` rather than
-     * being told directly when to move on. A single call advances at most one stage, even if
-     * the next one would also already be satisfied; call it again (a fresh turn, a fresh
-     * check) to walk through several at once.
-     *
-     * Named `advanceStage` rather than `advance`, because everything else called `advance` in
-     * this framework ticks a clock forward by whole turns (`TurnClock`, `Charges`, `Field`,
-     * `Barrier`, `AbilityCycle`). This advances a quest through its stage list, which is not
-     * time passing at all, and sharing the word made both harder to read.
-     *
-     * @returns true if a stage (or the whole quest) completed this call
-     */
-    advanceStage(id: string, state: GameState): boolean;
-    /** whether the current stage's condition or counter already holds, without advancing it */
-    private stageSatisfied;
-    private require;
-    toJSON(): {
-        stageIndex: [string, number][];
-        tracked: string | null;
-    };
-    /** rebuilds a log from save data - `definitions` are supplied fresh, the same as `ITEMS` */
-    static fromJSON(definitions: QuestDefinition[], data: {
-        stageIndex: [string, number][];
-        tracked?: string | null;
-    }): QuestLog;
-}
-/** one row of a flat quest-stage table - typically a `core.parseCSV` result, one row per stage */
-export interface QuestStageRow {
-    questId: string;
-    /** prerequisite quest ids; only read off a quest's first row (see `questsFromRows`) */
-    requires?: string[];
-    conditionSwitch?: string;
-    conditionEquals?: boolean;
-    conditionVariable?: string;
-    conditionAtLeast?: number;
-    counterVariable?: string;
-    counterTarget?: number;
-    description?: string;
-    locationMap?: string;
-    locationX?: number;
-    locationY?: number;
-}
-/**
- * Groups a flat table of stage rows into `QuestDefinition`s a `QuestLog` can `define` - the
- * same relational shape `core.parseCSV` already models for a flat table (`actors.AffixTable`,
- * `actors.buildEntities`): a content designer edits two spreadsheet columns (which quest,
- * which stage) instead of a hand-written `.ts` object literal nesting every quest's stage
- * array. Row order is preserved as stage order within a quest, and first-seen order across
- * the table as quest order.
- *
- * `requires` is only read off a quest's first row - a quest cannot require something
- * different depending on which of its own stage rows a spreadsheet author happened to fill
- * it in on, so only the first counts and a later row's `requires` is ignored.
- *
- * @example
- * ```ts
- * import { parseCSV } from '@datamoc/mw_games/core';
- * import { questsFromRows, QuestLog, type QuestStageRow } from '@datamoc/mw_games/rpg';
- *
- * const csv = `questId,counterVariable,counterTarget,description
- * rats,ratsKilled,5,Kill 5 rats
- * rats,,,Report back to the innkeeper`;
- *
- * const rows = parseCSV<QuestStageRow>(csv, { columns: { counterTarget: 'number' } });
- * const quests = questsFromRows(rows);
- *
- * const log = new QuestLog();
- * for (const quest of quests) log.define(quest);
- * ```
- */
-export declare function questsFromRows(rows: readonly QuestStageRow[]): QuestDefinition[];
-//# sourceMappingURL=Quest.d.ts.map

package/dist/rpg/Quest.d.ts.map

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