@datamoc/mw_games 0.1.1

package/dist/rpg/Event.d.ts

@@ -0,0 +1,33 @@
+import type { GameState } from './GameState.ts';
+import type { EventCommand } from './EventRunner.ts';
+/** when a page's commands run */
+export type EventTrigger = 'action' | 'touch' | 'autorun' | 'parallel';
+export type EventCondition = {
+    switch: string;
+    equals: boolean;
+} | {
+    variable: string;
+    atLeast: number;
+};
+export interface EventPage {
+    /** every condition must hold for this page to be selected */
+    conditions?: EventCondition[];
+    trigger: EventTrigger;
+    commands: EventCommand[];
+    /** the frame shown on the map for this page; omit for no graphic */
+    frame?: number | string;
+}
+export interface MapEvent {
+    id: string;
+    x: number;
+    y: number;
+    pages: EventPage[];
+}
+export declare function conditionHolds(condition: EventCondition, state: GameState): boolean;
+/**
+ * The last page whose conditions all hold - the same convention RPG Maker uses, so an event
+ * is authored as an ordered list running from "default behaviour" to "most specific", and
+ * whichever specific case currently applies overrides the general one before it.
+ */
+export declare function activePage(event: MapEvent, state: GameState): EventPage | undefined;
+//# sourceMappingURL=Event.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Event.d.ts","sourceRoot":"","sources":["../../src/rpg/Event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,iCAAiC;AACjC,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;AAEvE,MAAM,MAAM,cAAc,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzG,MAAM,WAAW,SAAS;IACzB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,YAAY,EAAE,CAAC;IAEzB,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,SAAS,EAAE,CAAC;CACnB;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAGnF;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAMnF"}

package/dist/rpg/Event.js

@@ -0,0 +1,19 @@
+export function conditionHolds(condition, state) {
+    if ('switch' in condition)
+        return state.switch(condition.switch) === condition.equals;
+    return state.variable(condition.variable) >= condition.atLeast;
+}
+/**
+ * The last page whose conditions all hold - the same convention RPG Maker uses, so an event
+ * is authored as an ordered list running from "default behaviour" to "most specific", and
+ * whichever specific case currently applies overrides the general one before it.
+ */
+export function activePage(event, state) {
+    let match;
+    for (const page of event.pages) {
+        if ((page.conditions ?? []).every((c) => conditionHolds(c, state)))
+            match = page;
+    }
+    return match;
+}
+//# sourceMappingURL=Event.js.map

package/dist/rpg/Event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Event.js","sourceRoot":"","sources":["../../src/rpg/Event.ts"],"names":[],"mappings":"AAyBA,MAAM,UAAU,cAAc,CAAC,SAAyB,EAAE,KAAgB;IACzE,IAAI,QAAQ,IAAI,SAAS;QAAE,OAAO,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,SAAS,CAAC,MAAM,CAAC;IACtF,OAAO,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC;AAChE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,KAAe,EAAE,KAAgB;IAC3D,IAAI,KAA4B,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YAAE,KAAK,GAAG,IAAI,CAAC;IAClF,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/rpg/EventRunner.d.ts

@@ -0,0 +1,72 @@
+import { type Choice } from '../ui/MessageBox.ts';
+import type { WindowStack } from '../ui/WindowStack.ts';
+import { type EventCondition } from './Event.ts';
+import type { GameState } from './GameState.ts';
+export interface MoveStep {
+    dx: number;
+    dy: number;
+}
+/**
+ * A map event's script, written as data - the same shape `mwg/stage`'s `StageCommand` is,
+ * but for map events rather than dialogue scenes: switches, variables and branches instead
+ * of a backdrop and characters. Kept as its own interpreter because the two run on
+ * genuinely different state, not because the "list of commands, awaited as one call" shape
+ * needed reinventing.
+ */
+export type EventCommand = {
+    say: string;
+    speaker?: string;
+} | {
+    ask: string;
+    speaker?: string;
+    choices: Choice[];
+    store?: string;
+} | {
+    wait: number;
+} | {
+    setSwitch: string;
+    value: boolean;
+} | {
+    setVariable: string;
+    value: number;
+} | {
+    addVariable: string;
+    amount: number;
+} | {
+    if: EventCondition;
+    then: EventCommand[];
+    else?: EventCommand[];
+} | {
+    move: {
+        target: string;
+        steps: MoveStep[];
+    };
+} | {
+    call: (state: EventRunnerState) => void | Promise<void>;
+};
+export interface EventRunnerState {
+    game: GameState;
+    /** whatever `ask` commands have stored, keyed by their `store` name */
+    answers: Record<string, unknown>;
+}
+export interface EventRunnerOptions {
+    windows: WindowStack;
+    game: GameState;
+    /** carries out a move command; the runner itself does not know what "moving" means */
+    move?: (target: string, steps: readonly MoveStep[]) => Promise<void>;
+    /** width/height of the dialogue box; characters revealed per second */
+    boxWidth?: number;
+    boxHeight?: number;
+    speed?: number;
+}
+export declare class EventRunner {
+    private options;
+    readonly state: EventRunnerState;
+    private cancelled;
+    constructor(options: EventRunnerOptions);
+    cancel(): void;
+    run(commands: readonly EventCommand[]): Promise<EventRunnerState>;
+    private step;
+    private speak;
+}
+//# sourceMappingURL=EventRunner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EventRunner.d.ts","sourceRoot":"","sources":["../../src/rpg/EventRunner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACX;AAED;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GACrB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACpE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACrC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,EAAE,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,YAAY,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,YAAY,EAAE,CAAA;CAAE,GACnE;IAAE,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,QAAQ,EAAE,CAAA;KAAE,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,SAAS,CAAC;IAEhB,sFAAsF;IACtF,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,QAAQ,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAErE,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,WAAW;IACvB,OAAO,CAAC,OAAO,CAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,OAAO,CAAC,SAAS,CAAS;IAE1B,YAAY,OAAO,EAAE,kBAAkB,EAGtC;IAED,MAAM,IAAI,IAAI,CAEb;IAEK,GAAG,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAMtE;YAEa,IAAI;IAiDlB,OAAO,CAAC,KAAK;CAgBb"}

package/dist/rpg/EventRunner.js

@@ -0,0 +1,76 @@
+import { MessageBox } from '../ui/MessageBox.js';
+import { conditionHolds } from './Event.js';
+export class EventRunner {
+    constructor(options) {
+        this.cancelled = false;
+        this.options = options;
+        this.state = { game: options.game, answers: {} };
+    }
+    cancel() {
+        this.cancelled = true;
+    }
+    async run(commands) {
+        for (const command of commands) {
+            if (this.cancelled)
+                break;
+            await this.step(command);
+        }
+        return this.state;
+    }
+    async step(command) {
+        if ('say' in command) {
+            await this.speak(command.say, command.speaker);
+            return;
+        }
+        if ('ask' in command) {
+            const chosen = await this.speak(command.ask, command.speaker, command.choices);
+            if (command.store)
+                this.state.answers[command.store] = chosen;
+            return;
+        }
+        if ('wait' in command) {
+            await new Promise((resolve) => setTimeout(resolve, command.wait * 1000));
+            return;
+        }
+        if ('setSwitch' in command) {
+            this.state.game.setSwitch(command.setSwitch, command.value);
+            return;
+        }
+        if ('setVariable' in command) {
+            this.state.game.setVariable(command.setVariable, command.value);
+            return;
+        }
+        if ('addVariable' in command) {
+            const current = this.state.game.variable(command.addVariable);
+            this.state.game.setVariable(command.addVariable, current + command.amount);
+            return;
+        }
+        if ('if' in command) {
+            const holds = conditionHolds(command.if, this.state.game);
+            await this.run(holds ? command.then : (command.else ?? []));
+            return;
+        }
+        if ('move' in command) {
+            await this.options.move?.(command.move.target, command.move.steps);
+            return;
+        }
+        if ('call' in command) {
+            await command.call(this.state);
+        }
+    }
+    speak(text, speaker, choices) {
+        const { windows } = this.options;
+        return new Promise((resolve) => {
+            windows.push(new MessageBox({
+                width: this.options.boxWidth ?? 480,
+                height: this.options.boxHeight ?? 120,
+                speed: this.options.speed ?? 45,
+                pages: [{ text, speaker }],
+                choices,
+                anchor: 'bottom',
+                onDone: (chosen) => resolve(chosen),
+            }));
+        });
+    }
+}
+//# sourceMappingURL=EventRunner.js.map

package/dist/rpg/EventRunner.js.map

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

package/dist/rpg/GameState.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Global switches and variables - the two pieces of state an RPG's events read and write
+ * most, kept as plain maps rather than anything fancier so `mwg/core`'s eventual save
+ * system (see the roadmap) can serialise them like any other plain data.
+ */
+export declare class GameState {
+    private switches;
+    private variables;
+    switch(name: string): boolean;
+    setSwitch(name: string, value: boolean): void;
+    variable(name: string): number;
+    setVariable(name: string, value: number): void;
+    toJSON(): {
+        switches: [string, boolean][];
+        variables: [string, number][];
+    };
+    static fromJSON(data: {
+        switches: [string, boolean][];
+        variables: [string, number][];
+    }): GameState;
+}
+//# sourceMappingURL=GameState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GameState.d.ts","sourceRoot":"","sources":["../../src/rpg/GameState.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,SAAS;IACrB,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,SAAS,CAA6B;IAE9C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5B;IAED,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAE5C;IAED,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7B;IAED,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAE7C;IAED,MAAM,IAAI;QAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;QAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;KAAE,CAEzE;IAED,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;QAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;KAAE,GAAG,SAAS,CAKjG;CACD"}

package/dist/rpg/GameState.js

@@ -0,0 +1,35 @@
+/**
+ * Global switches and variables - the two pieces of state an RPG's events read and write
+ * most, kept as plain maps rather than anything fancier so `mwg/core`'s eventual save
+ * system (see the roadmap) can serialise them like any other plain data.
+ */
+export class GameState {
+    constructor() {
+        this.switches = new Map();
+        this.variables = new Map();
+    }
+    switch(name) {
+        return this.switches.get(name) ?? false;
+    }
+    setSwitch(name, value) {
+        this.switches.set(name, value);
+    }
+    variable(name) {
+        return this.variables.get(name) ?? 0;
+    }
+    setVariable(name, value) {
+        this.variables.set(name, value);
+    }
+    toJSON() {
+        return { switches: [...this.switches], variables: [...this.variables] };
+    }
+    static fromJSON(data) {
+        const state = new GameState();
+        for (const [name, value] of data.switches)
+            state.setSwitch(name, value);
+        for (const [name, value] of data.variables)
+            state.setVariable(name, value);
+        return state;
+    }
+}
+//# sourceMappingURL=GameState.js.map

package/dist/rpg/GameState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GameState.js","sourceRoot":"","sources":["../../src/rpg/GameState.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,SAAS;IAAtB;QACS,aAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;QACtC,cAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IA4B/C,CAAC;IA1BA,MAAM,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC;IACzC,CAAC;IAED,SAAS,CAAC,IAAY,EAAE,KAAc;QACrC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,QAAQ,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,WAAW,CAAC,IAAY,EAAE,KAAa;QACtC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,MAAM;QACL,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;IACzE,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,IAAsE;QACrF,MAAM,KAAK,GAAG,IAAI,SAAS,EAAE,CAAC;QAC9B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ;YAAE,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACxE,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS;YAAE,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC3E,OAAO,KAAK,CAAC;IACd,CAAC;CACD"}

package/dist/rpg/GridMover.d.ts

@@ -0,0 +1,51 @@
+import type { AnimatedSprite } from '../render/AnimatedSprite.ts';
+export type Direction4 = 'up' | 'down' | 'left' | 'right';
+export interface GridMoverOptions {
+    tileWidth: number;
+    tileHeight: number;
+    /** tiles crossed per second */
+    speed?: number;
+    /** an animation name to play while moving in this direction, if the sprite has one */
+    walkAnimation?: (direction: Direction4) => string;
+    /** an animation name to play while standing still facing this direction */
+    idleAnimation?: (direction: Direction4) => string;
+}
+/**
+ * Grid movement tweened between tiles, with a walk cycle - what turns "the player pressed
+ * right" into a sprite that glides from one tile to the next and faces the way it is going,
+ * rather than teleporting square to square.
+ *
+ * This owns position and animation only. Whether the target tile is passable, whether
+ * something is standing on it, whether stepping onto it should trigger an event - all of
+ * that is a question for the map, asked before `moveBy` is called.
+ */
+export declare class GridMover {
+    x: number;
+    y: number;
+    facing: Direction4;
+    private sprite;
+    private tileWidth;
+    private tileHeight;
+    private speed;
+    private options;
+    private fromX;
+    private fromY;
+    private target;
+    private progress;
+    constructor(sprite: AnimatedSprite, x: number, y: number, options: GridMoverOptions);
+    get isMoving(): boolean;
+    /**
+     * Faces a direction without moving - what a bump into a wall or an NPC turns into,
+     * rather than nothing at all. Without this, a player who arrives beside an NPC from the
+     * "wrong" side can never turn to face it, since an actual step that way is blocked and
+     * `moveBy` only ever faces the direction it successfully moves in.
+     */
+    turnTo(dx: number, dy: number): void;
+    /** starts moving one tile in the given direction; false when already moving */
+    moveBy(dx: number, dy: number): boolean;
+    update(dt: number): void;
+    private place;
+    private playWalk;
+    private playIdle;
+}
+//# sourceMappingURL=GridMover.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GridMover.d.ts","sourceRoot":"","sources":["../../src/rpg/GridMover.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IAEnB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,sFAAsF;IACtF,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,UAAU,KAAK,MAAM,CAAC;IAElD,2EAA2E;IAC3E,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,UAAU,KAAK,MAAM,CAAC;CAClD;AAED;;;;;;;;GAQG;AACH,qBAAa,SAAS;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,EAAE,UAAU,CAAU;IAE5B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAmB;IAElC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAyC;IACvD,OAAO,CAAC,QAAQ,CAAK;IAErB,YAAY,MAAM,EAAE,cAAc,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAWlF;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;;;OAKG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAInC;IAED,+EAA+E;IAC/E,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAUtC;IAED,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAcvB;IAED,OAAO,CAAC,KAAK;IAKb,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,QAAQ;CAIhB"}

package/dist/rpg/GridMover.js

@@ -0,0 +1,91 @@
+/**
+ * Grid movement tweened between tiles, with a walk cycle - what turns "the player pressed
+ * right" into a sprite that glides from one tile to the next and faces the way it is going,
+ * rather than teleporting square to square.
+ *
+ * This owns position and animation only. Whether the target tile is passable, whether
+ * something is standing on it, whether stepping onto it should trigger an event - all of
+ * that is a question for the map, asked before `moveBy` is called.
+ */
+export class GridMover {
+    constructor(sprite, x, y, options) {
+        this.facing = 'down';
+        this.target = null;
+        this.progress = 0;
+        this.sprite = sprite;
+        this.x = this.fromX = x;
+        this.y = this.fromY = y;
+        this.tileWidth = options.tileWidth;
+        this.tileHeight = options.tileHeight;
+        this.speed = options.speed ?? 4;
+        this.options = options;
+        this.place();
+        this.playIdle();
+    }
+    get isMoving() {
+        return this.target !== null;
+    }
+    /**
+     * Faces a direction without moving - what a bump into a wall or an NPC turns into,
+     * rather than nothing at all. Without this, a player who arrives beside an NPC from the
+     * "wrong" side can never turn to face it, since an actual step that way is blocked and
+     * `moveBy` only ever faces the direction it successfully moves in.
+     */
+    turnTo(dx, dy) {
+        if (this.target)
+            return;
+        this.facing = directionOf(dx, dy);
+        this.playIdle();
+    }
+    /** starts moving one tile in the given direction; false when already moving */
+    moveBy(dx, dy) {
+        if (this.target)
+            return false;
+        this.facing = directionOf(dx, dy);
+        this.fromX = this.x;
+        this.fromY = this.y;
+        this.target = { x: this.x + dx, y: this.y + dy };
+        this.progress = 0;
+        this.playWalk();
+        return true;
+    }
+    update(dt) {
+        this.sprite.update(dt);
+        if (!this.target)
+            return;
+        this.progress = Math.min(1, this.progress + this.speed * dt);
+        this.sprite.x = lerp(this.fromX, this.target.x, this.progress) * this.tileWidth;
+        this.sprite.y = lerp(this.fromY, this.target.y, this.progress) * this.tileHeight;
+        if (this.progress >= 1) {
+            this.x = this.target.x;
+            this.y = this.target.y;
+            this.target = null;
+            this.playIdle();
+        }
+    }
+    place() {
+        this.sprite.x = this.x * this.tileWidth;
+        this.sprite.y = this.y * this.tileHeight;
+    }
+    playWalk() {
+        const name = this.options.walkAnimation?.(this.facing);
+        if (name && this.sprite.has(name))
+            this.sprite.play(name);
+    }
+    playIdle() {
+        const name = this.options.idleAnimation?.(this.facing);
+        if (name && this.sprite.has(name))
+            this.sprite.play(name);
+    }
+}
+function directionOf(dx, dy) {
+    if (dx > 0)
+        return 'right';
+    if (dx < 0)
+        return 'left';
+    return dy > 0 ? 'down' : 'up';
+}
+function lerp(from, to, t) {
+    return from + (to - from) * t;
+}
+//# sourceMappingURL=GridMover.js.map

package/dist/rpg/GridMover.js.map

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

package/dist/rpg/Quest.d.ts

@@ -0,0 +1,67 @@
+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;
+}
+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';
+/**
+ * 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.
+ */
+export declare class QuestLog {
+    private definitions;
+    /** the stage index a started quest is on; absent means not yet started */
+    private stageIndex;
+    define(quest: QuestDefinition): void;
+    /** 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.
+     *
+     * @returns true if a stage (or the whole quest) completed this call
+     */
+    advance(id: string, state: GameState): boolean;
+    private require;
+    toJSON(): {
+        stageIndex: [string, number][];
+    };
+    /** rebuilds a log from save data - `definitions` are supplied fresh, the same as `ITEMS` */
+    static fromJSON(definitions: QuestDefinition[], data: {
+        stageIndex: [string, number][];
+    }): QuestLog;
+}
+//# sourceMappingURL=Quest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Quest.d.ts","sourceRoot":"","sources":["../../src/rpg/Quest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IAC1B,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,OAAO,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAE/C,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,UAAU,EAAE,CAAC;IAErB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE9E;;;;;GAKG;AACH,qBAAa,QAAQ;IACpB,OAAO,CAAC,WAAW,CAAsC;IAEzD,0EAA0E;IAC1E,OAAO,CAAC,UAAU,CAA6B;IAE/C,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAEnC;IAED,oFAAoF;IACpF,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAG5B;IAED,mEAAmE;IACnE,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAGtB;IAED,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,CAK9B;IAED,uFAAuF;IACvF,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAG1C;IAED,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAIpD;IAED;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAa7C;IAED,OAAO,CAAC,OAAO;IAMf,MAAM,IAAI;QAAE,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;KAAE,CAE3C;IAED,4FAA4F;IAC5F,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE;QAAE,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;KAAE,GAAG,QAAQ,CAKlG;CACD"}

package/dist/rpg/Quest.js

@@ -0,0 +1,92 @@
+import { conditionHolds } from './Event.js';
+/**
+ * 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.
+ */
+export class QuestLog {
+    constructor() {
+        this.definitions = new Map();
+        /** the stage index a started quest is on; absent means not yet started */
+        this.stageIndex = new Map();
+    }
+    define(quest) {
+        this.definitions.set(quest.id, quest);
+    }
+    /** whether every prerequisite is already complete, so the quest could be started */
+    canStart(id) {
+        const quest = this.require(id);
+        return (quest.requires ?? []).every((r) => this.status(r) === 'complete');
+    }
+    /** begins a quest; throws if a prerequisite is not yet complete */
+    start(id) {
+        if (!this.canStart(id))
+            throw new Error(`quest "${id}" cannot start yet - a prerequisite is incomplete`);
+        this.stageIndex.set(id, 0);
+    }
+    status(id) {
+        const quest = this.require(id);
+        const index = this.stageIndex.get(id);
+        if (index === undefined)
+            return this.canStart(id) ? 'available' : 'unavailable';
+        return index >= quest.stages.length ? 'complete' : 'active';
+    }
+    /** the stage a quest is currently on; `null` once complete or before it has started */
+    currentStage(id) {
+        if (this.status(id) !== 'active')
+            return null;
+        return this.require(id).stages[this.stageIndex.get(id)];
+    }
+    /** progress, 0 to 1, towards the current stage's counter; `null` for a condition stage */
+    progress(id, state) {
+        const stage = this.currentStage(id);
+        if (!stage?.counter)
+            return null;
+        return Math.min(1, state.variable(stage.counter.variable) / stage.counter.target);
+    }
+    /**
+     * 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.
+     *
+     * @returns true if a stage (or the whole quest) completed this call
+     */
+    advance(id, state) {
+        const stage = this.currentStage(id);
+        if (!stage)
+            return false;
+        const done = stage.condition
+            ? conditionHolds(stage.condition, state)
+            : stage.counter
+                ? state.variable(stage.counter.variable) >= stage.counter.target
+                : true;
+        if (!done)
+            return false;
+        this.stageIndex.set(id, this.stageIndex.get(id) + 1);
+        return true;
+    }
+    require(id) {
+        const quest = this.definitions.get(id);
+        if (!quest)
+            throw new Error(`no such quest: "${id}"`);
+        return quest;
+    }
+    toJSON() {
+        return { stageIndex: [...this.stageIndex] };
+    }
+    /** rebuilds a log from save data - `definitions` are supplied fresh, the same as `ITEMS` */
+    static fromJSON(definitions, data) {
+        const log = new QuestLog();
+        for (const quest of definitions)
+            log.define(quest);
+        for (const [id, index] of data.stageIndex)
+            log.stageIndex.set(id, index);
+        return log;
+    }
+}
+//# sourceMappingURL=Quest.js.map

package/dist/rpg/Quest.js.map

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