@datamoc/mw_games 0.1.1

package/dist/stage/DialogueStage.js

@@ -0,0 +1,207 @@
+import { Container, Sprite, Texture } from 'pixi.js';
+import { TintedSprite } from '../render/TintedSprite.js';
+/** where a slot sits, as a fraction of the stage width */
+const SLOTS = {
+    farLeft: 0.12,
+    left: 0.28,
+    center: 0.5,
+    right: 0.72,
+    farRight: 0.88,
+};
+/**
+ * A dialogue scene: a backdrop, characters standing in front of it, and whoever is
+ * speaking picked out from the rest.
+ *
+ * This is the presentation the tile map is not — a still image with figures on it, the
+ * mode nearly every RPG drops into for a conversation that matters, and the whole of how a
+ * visual novel looks.
+ *
+ * It draws only the scene. The words go in a `MessageBox` from `mwg/ui`, so a game gets
+ * the same dialogue box whether it is talking to a shopkeeper on a tile map or running a
+ * scripted scene here.
+ */
+export class DialogueStage extends Container {
+    constructor(width, height) {
+        super();
+        this.backdropLayer = new Container();
+        this.actorLayer = new Container();
+        this.backdrop = null;
+        this.outgoingBackdrop = null;
+        this.actors = new Map();
+        this.definitions = new Map();
+        this.focused = null;
+        this.tweens = [];
+        /** how far a character is darkened while someone else is speaking, 0 to 1 */
+        this.dimAmount = 0.45;
+        this.stageWidth = width;
+        this.stageHeight = height;
+        this.addChild(this.backdropLayer);
+        this.addChild(this.actorLayer);
+    }
+    /** registers a character so a script can refer to it by name alone */
+    defineCharacter(id, definition) {
+        this.definitions.set(id, definition);
+    }
+    resize(width, height) {
+        this.stageWidth = width;
+        this.stageHeight = height;
+        for (const sprite of [this.backdrop, this.outgoingBackdrop]) {
+            if (sprite)
+                this.fitBackdrop(sprite);
+        }
+        for (const actor of this.actors.values())
+            this.placeActor(actor);
+    }
+    /**
+     * Changes the backdrop.
+     *
+     * The old one stays underneath while the new one fades in over it, so the scene never
+     * flashes through to an empty stage mid-transition.
+     */
+    setBackdrop(texture, fade = 0.4) {
+        this.outgoingBackdrop?.destroy();
+        this.outgoingBackdrop = this.backdrop;
+        const sprite = new Sprite(texture);
+        this.fitBackdrop(sprite);
+        this.backdrop = sprite;
+        this.backdropLayer.addChild(sprite);
+        if (fade <= 0) {
+            this.outgoingBackdrop?.destroy();
+            this.outgoingBackdrop = null;
+            return Promise.resolve();
+        }
+        sprite.alpha = 0;
+        return this.tween(fade, (t) => {
+            sprite.alpha = t;
+        }).then(() => {
+            this.outgoingBackdrop?.destroy();
+            this.outgoingBackdrop = null;
+        });
+    }
+    fitBackdrop(sprite) {
+        //cover the stage without distorting: scale by the larger ratio and centre the rest
+        const source = sprite.texture;
+        const scale = Math.max(this.stageWidth / source.width, this.stageHeight / source.height);
+        sprite.scale.set(scale);
+        sprite.x = Math.round((this.stageWidth - source.width * scale) / 2);
+        sprite.y = Math.round((this.stageHeight - source.height * scale) / 2);
+    }
+    show(id, options = {}) {
+        const definition = this.definitions.get(id);
+        if (!definition)
+            throw new Error(`no character defined as "${id}"`);
+        const expression = options.expression ?? Object.keys(definition.expressions)[0];
+        const existing = this.actors.get(id);
+        if (existing) {
+            //already on stage: this is a move or an expression change, not an entrance
+            if (options.at !== undefined)
+                existing.slot = this.slotOf(options.at);
+            this.setExpression(id, expression);
+            this.placeActor(existing);
+            return Promise.resolve();
+        }
+        const sprite = new TintedSprite(definition.sheet.get(definition.expressions[expression]));
+        const actor = {
+            id,
+            sprite,
+            definition,
+            slot: this.slotOf(options.at ?? 'center'),
+            expression,
+        };
+        this.actors.set(id, actor);
+        this.actorLayer.addChild(sprite);
+        this.placeActor(actor);
+        this.applyFocus();
+        const fade = options.fade ?? 0.25;
+        if (fade <= 0)
+            return Promise.resolve();
+        sprite.alpha = 0;
+        return this.tween(fade, (t) => {
+            sprite.alpha = t;
+        });
+    }
+    hide(id, fade = 0.25) {
+        const actor = this.actors.get(id);
+        if (!actor)
+            return Promise.resolve();
+        this.actors.delete(id);
+        if (this.focused === id)
+            this.focused = null;
+        this.applyFocus();
+        if (fade <= 0) {
+            actor.sprite.destroy();
+            return Promise.resolve();
+        }
+        return this.tween(fade, (t) => {
+            actor.sprite.alpha = 1 - t;
+        }).then(() => actor.sprite.destroy());
+    }
+    hideAll(fade = 0.25) {
+        return Promise.all([...this.actors.keys()].map((id) => this.hide(id, fade))).then(() => undefined);
+    }
+    setExpression(id, expression) {
+        const actor = this.actors.get(id);
+        if (!actor)
+            return;
+        const frame = actor.definition.expressions[expression];
+        if (frame === undefined) {
+            throw new Error(`character "${id}" has no expression "${expression}"`);
+        }
+        actor.expression = expression;
+        actor.sprite.texture = actor.definition.sheet.get(frame);
+    }
+    /**
+     * Picks out whoever is speaking by dimming everyone else.
+     *
+     * A multiply tint is exactly right here: it darkens without changing hue, so a dimmed
+     * character reads as standing back rather than as being a different colour.
+     */
+    focus(id) {
+        this.focused = id;
+        this.applyFocus();
+    }
+    applyFocus() {
+        const lit = Math.round(0xff * (1 - this.dimAmount));
+        const dim = (lit << 16) | (lit << 8) | lit;
+        for (const actor of this.actors.values()) {
+            const isDimmed = this.focused !== null && actor.id !== this.focused;
+            actor.sprite.tint = isDimmed ? dim : 0xffffff;
+        }
+    }
+    slotOf(at) {
+        return typeof at === 'number' ? at : SLOTS[at];
+    }
+    placeActor(actor) {
+        const definition = actor.definition;
+        const wanted = (definition.height ?? 0.7) * this.stageHeight;
+        const scale = wanted / definition.sheet.frameHeight;
+        actor.sprite.scale.set(scale);
+        actor.sprite.x = Math.round(actor.slot * this.stageWidth - (definition.sheet.frameWidth * scale) / 2);
+        //positioned by the feet, so characters of different heights stand on the same floor
+        actor.sprite.y = Math.round((definition.baseline ?? 0.92) * this.stageHeight - wanted);
+    }
+    tween(duration, apply) {
+        return new Promise((resolve) => {
+            this.tweens.push({ elapsed: 0, duration, apply, resolve });
+        });
+    }
+    update(dt) {
+        if (this.tweens.length === 0)
+            return;
+        //iterate a copy: a tween's resolve may start another
+        for (const tween of [...this.tweens]) {
+            tween.elapsed += dt;
+            const t = Math.min(1, tween.elapsed / tween.duration);
+            tween.apply(t);
+            if (t >= 1) {
+                this.tweens.splice(this.tweens.indexOf(tween), 1);
+                tween.resolve();
+            }
+        }
+    }
+    /** true while a fade is running, so a script can wait for it */
+    get isBusy() {
+        return this.tweens.length > 0;
+    }
+}
+//# sourceMappingURL=DialogueStage.js.map

package/dist/stage/DialogueStage.js.map

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

package/dist/stage/index.d.ts

@@ -0,0 +1,7 @@
+export { DialogueStage } from './DialogueStage.ts';
+export type { CharacterDefinition, ShowOptions, SlotName } from './DialogueStage.ts';
+export { StageScript } from './script.ts';
+export type { StageCommand, StageChoice, StoryScript, ScriptOptions, ScriptState } from './script.ts';
+export { importTwee } from './twee.ts';
+export type { TwineStory } from './twee.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/stage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAErF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtG,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/dist/stage/index.js

@@ -0,0 +1,4 @@
+export { DialogueStage } from './DialogueStage.js';
+export { StageScript } from './script.js';
+export { importTwee } from './twee.js';
+//# sourceMappingURL=index.js.map

package/dist/stage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/stage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/dist/stage/script.d.ts

@@ -0,0 +1,111 @@
+import type { Texture } from 'pixi.js';
+import { type Choice } from '../ui/MessageBox.ts';
+import type { WindowStack } from '../ui/WindowStack.ts';
+import type { DialogueStage, SlotName } from './DialogueStage.ts';
+/**
+ * A scene, written as data.
+ *
+ * A scripted conversation is a list of instructions, not a function. That is deliberate:
+ * the same list can be written by hand, generated, translated, or one day produced by an
+ * editor, and none of those need the runtime to change. It is also what lets the RPG event
+ * interpreter and this share a format later — a cutscene on a tile map is the same list
+ * with a different backdrop.
+ */
+export type StageCommand = {
+    backdrop: string;
+    fade?: number;
+} | {
+    show: string;
+    at?: SlotName | number;
+    expression?: string;
+    fade?: number;
+} | {
+    hide: string;
+    fade?: number;
+} | {
+    hideAll: true;
+    fade?: number;
+} | {
+    expression: string;
+    of: string;
+} | {
+    say: string;
+    as?: string;
+    speaker?: string;
+} | {
+    ask: string;
+    as?: string;
+    speaker?: string;
+    choices: StageChoice[];
+    store?: string;
+} | {
+    goto: string;
+} | {
+    wait: number;
+} | {
+    call: (state: ScriptState) => void | Promise<void>;
+};
+/**
+ * A choice that can also move the story: when the player picks it inside
+ * `runStory`, the story jumps to the named passage afterwards. Plain `Choice`
+ * objects stay valid - every one of them is already a `StageChoice` that goes
+ * nowhere - and a `MessageBox` never sees the extra field.
+ */
+export type StageChoice = Choice & {
+    /** the passage to jump to when this choice is picked, in a `runStory` story */
+    goto?: string;
+};
+/**
+ * A story as a graph of named passages, each a list of commands - Twine's shape
+ * rather than a straight line. Passages can loop back or braid together; reaching
+ * the end of a passage ends the story.
+ */
+export type StoryScript = Record<string, readonly StageCommand[]>;
+export interface ScriptState {
+    /** whatever `ask` commands have stored, keyed by their `store` name */
+    answers: Record<string, unknown>;
+}
+export interface ScriptOptions {
+    stage: DialogueStage;
+    windows: WindowStack;
+    /** resolves a backdrop name from a command to a texture */
+    backdrop: (name: string) => Texture;
+    /** the name shown for a character id, when a `say` gives no explicit speaker */
+    displayName?: (id: string) => string;
+    /** width of the dialogue box; defaults to most of the stage */
+    boxWidth?: number;
+    boxHeight?: number;
+    /** characters revealed per second */
+    speed?: number;
+}
+/**
+ * Runs a scene.
+ *
+ * `run` resolves when the list is exhausted, so a caller can simply await a conversation
+ * and carry on afterwards — which is what makes a cutscene readable at the call site
+ * instead of a chain of callbacks.
+ */
+export declare class StageScript {
+    private options;
+    readonly state: ScriptState;
+    private cancelled;
+    constructor(options: ScriptOptions);
+    cancel(): void;
+    run(commands: readonly StageCommand[]): Promise<ScriptState>;
+    /**
+     * Runs a graph of passages starting at `start`, following `goto` commands and
+     * choice jumps until a passage runs out or the script is cancelled.
+     */
+    runStory(story: StoryScript, start: string): Promise<ScriptState>;
+    /** runs one command; returns the passage to jump to, if the command jumps anywhere */
+    private step;
+    /**
+     * Puts one line in front of the player and resolves with their answer.
+     *
+     * Protected rather than private on purpose: this is the seam for a game that presents
+     * dialogue its own way — a different box, a voice line, a test harness — without
+     * reimplementing the sequencing above.
+     */
+    protected speak(text: string, as: string | undefined, speaker?: string, choices?: Choice[]): Promise<unknown>;
+}
+//# sourceMappingURL=script.d.ts.map

package/dist/stage/script.d.ts.map

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

package/dist/stage/script.js

@@ -0,0 +1,133 @@
+import { MessageBox } from '../ui/MessageBox.js';
+/**
+ * Runs a scene.
+ *
+ * `run` resolves when the list is exhausted, so a caller can simply await a conversation
+ * and carry on afterwards — which is what makes a cutscene readable at the call site
+ * instead of a chain of callbacks.
+ */
+export class StageScript {
+    constructor(options) {
+        this.state = { answers: {} };
+        this.cancelled = false;
+        this.options = options;
+    }
+    cancel() {
+        this.cancelled = true;
+    }
+    async run(commands) {
+        for (const command of commands) {
+            if (this.cancelled)
+                break;
+            const jump = await this.step(command);
+            if (jump !== undefined) {
+                throw new Error(`a "goto ${jump}" only runs inside runStory, not a straight run`);
+            }
+        }
+        return this.state;
+    }
+    /**
+     * Runs a graph of passages starting at `start`, following `goto` commands and
+     * choice jumps until a passage runs out or the script is cancelled.
+     */
+    async runStory(story, start) {
+        if (!Object.prototype.hasOwnProperty.call(story, start)) {
+            throw new Error(`this story has no passage named "${start}"`);
+        }
+        let commands = story[start];
+        let index = 0;
+        while (index < commands.length) {
+            if (this.cancelled)
+                break;
+            const jump = await this.step(commands[index]);
+            index++;
+            if (jump !== undefined) {
+                if (!Object.prototype.hasOwnProperty.call(story, jump)) {
+                    throw new Error(`this story has no passage named "${jump}"`);
+                }
+                commands = story[jump];
+                index = 0;
+            }
+        }
+        return this.state;
+    }
+    /** runs one command; returns the passage to jump to, if the command jumps anywhere */
+    async step(command) {
+        const { stage } = this.options;
+        if ('backdrop' in command) {
+            await stage.setBackdrop(this.options.backdrop(command.backdrop), command.fade);
+            return undefined;
+        }
+        if ('show' in command) {
+            await stage.show(command.show, {
+                at: command.at,
+                expression: command.expression,
+                fade: command.fade,
+            });
+            return undefined;
+        }
+        if ('hide' in command) {
+            await stage.hide(command.hide, command.fade);
+            return undefined;
+        }
+        if ('hideAll' in command) {
+            await stage.hideAll(command.fade);
+            return undefined;
+        }
+        if ('expression' in command) {
+            stage.setExpression(command.of, command.expression);
+            return undefined;
+        }
+        if ('say' in command) {
+            await this.speak(command.say, command.as, command.speaker);
+            return undefined;
+        }
+        if ('ask' in command) {
+            const chosen = await this.speak(command.ask, command.as, command.speaker, command.choices);
+            if (command.store)
+                this.state.answers[command.store] = chosen;
+            //a MessageBox resolves with the chosen value, which defaults to the text
+            return command.choices.find((c) => (c.value ?? c.text) === chosen)?.goto;
+        }
+        if ('goto' in command) {
+            return command.goto;
+        }
+        if ('wait' in command) {
+            await new Promise((resolve) => setTimeout(resolve, command.wait * 1000));
+            return undefined;
+        }
+        if ('call' in command) {
+            await command.call(this.state);
+        }
+        return undefined;
+    }
+    /**
+     * Puts one line in front of the player and resolves with their answer.
+     *
+     * Protected rather than private on purpose: this is the seam for a game that presents
+     * dialogue its own way — a different box, a voice line, a test harness — without
+     * reimplementing the sequencing above.
+     */
+    speak(text, as, speaker, choices) {
+        const { stage, windows } = this.options;
+        //dim everyone but the speaker; a line with no speaker lights the whole stage again
+        stage.focus(as ?? null);
+        const name = speaker ?? (as ? (this.options.displayName?.(as) ?? as) : undefined);
+        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: name }],
+                //choices, when the line has them, are answered in the same box
+                choices,
+                //the scene behind is what the player is meant to be looking at, so it
+                //keeps its light; only the input is taken
+                dims: false,
+                anchor: 'bottom',
+                onDone: (chosen) => resolve(chosen),
+            }));
+        });
+    }
+}
+//# sourceMappingURL=script.js.map

package/dist/stage/script.js.map

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

package/dist/stage/twee.d.ts

@@ -0,0 +1,42 @@
+import type { StoryScript } from './script.ts';
+/**
+ * A story imported from Twine's Twee notation, ready for `StageScript.runStory`.
+ */
+export interface TwineStory {
+    story: StoryScript;
+    /** `StoryData`'s start passage when the file names one, else the first passage */
+    start: string;
+    /** the `StoryTitle` passage, when the file has one */
+    title?: string;
+}
+/**
+ * Reads a `.twee` file into a `StoryScript`.
+ *
+ * Twee was chosen over Twine's `<tw-passagedata>` HTML export on purpose: it is
+ * plain text, so this stays a pure string parser with no DOM - testable under
+ * `node --test` and loadable through `mwg/assets` like any other text asset.
+ *
+ * Only structure is imported, and that answers the format question the roadmap
+ * left open: each passage's text lines become `say` commands and its
+ * `[[links]]` become one closing `ask` whose choices jump (`[[text]]`,
+ * `[[text->target]]` and `[[target<-text]]`) - the last text line doubles as
+ * the question, since a choice box needs a prompt and repeating it works.
+ * No story-format macro language
+ * (Harlowe, SugarCube, Chapbook) is interpreted - body text reaches the stage
+ * untouched, and a link carrying a setter throws instead of silently dropping
+ * the behaviour the setter described.
+ *
+ * ```twee
+ * :: Start
+ * You stand at a crossroads.
+ *
+ * [[Take the left path->Left]]
+ * [[Take the right path->Right]]
+ *
+ * :: Left
+ * The path ends at a wall.
+ * [[Go back->Start]]
+ * ```
+ */
+export declare function importTwee(source: string): TwineStory;
+//# sourceMappingURL=twee.d.ts.map

package/dist/stage/twee.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"twee.d.ts","sourceRoot":"","sources":["../../src/stage/twee.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,WAAW,EAAE,MAAM,aAAa,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,KAAK,EAAE,WAAW,CAAC;IACnB,kFAAkF;IAClF,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAwCrD"}