@datamoc/mw_games 0.12.0 → 0.13.0

package/dist/rpg/EventRunner.d.ts

@@ -6,6 +6,8 @@ export interface EventChoice {
     text: string;
     value?: unknown;
     disabled?: boolean;
+    /** the passage to jump to when this choice is picked, in an `EventRunner.runStory` story */
+    goto?: string;
 }
 /** what the runner wants shown; how it looks is the presenter's business entirely */
 export interface DialogueRequest {
@@ -70,9 +72,18 @@ export type EventCommand = {
         target: string;
         steps: MoveStep[];
     };
+} | {
+    goto: string;
 } | {
     call: (state: EventRunnerState) => void | Promise<void>;
 };
+/**
+ * A branching event script: named passages, the same graph shape `two-d/stage`'s
+ * `StoryScript` is - a passage runs until it falls off the end, a `{ goto }` command or a
+ * choice's own `goto` jumps to a different one. `EventRunner.runStory` follows it the same
+ * way `StageScript.runStory` follows a `StoryScript`.
+ */
+export type EventStoryScript = Record<string, readonly EventCommand[]>;
 export interface EventRunnerState {
     game: GameState;
     /** whatever `ask` commands have stored, keyed by their `store` name */
@@ -106,6 +117,15 @@ export declare class EventRunner {
     constructor(options: EventRunnerOptions);
     cancel(): void;
     run(commands: readonly EventCommand[]): Promise<EventRunnerState>;
+    /**
+     * Runs a graph of passages starting at `start`, following `goto` commands and choice
+     * jumps until a passage runs out or the script is cancelled - the `EventCommand`
+     * counterpart to `StageScript.runStory`.
+     */
+    runStory(story: EventStoryScript, start: string): Promise<EventRunnerState>;
+    /** runs a plain list of commands, returning the passage to jump to, if any */
+    private runList;
+    /** runs one command; returns the passage to jump to, if the command jumps anywhere */
     private step;
     private speak;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"EventRunner.d.ts","sourceRoot":"","sources":["../../src/rpg/EventRunner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qFAAqF;AACrF,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,wGAAwG;IACxG,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,6FAA6F;IAC7F,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAC/E,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,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GACrD;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,WAAW,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7F;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,qFAAqF;IACrF,OAAO,EAAE,iBAAiB,CAAC;IAE3B,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;CACrE;AAED;;;;;;;;;;;;;GAaG;AACH,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;CAQb"}
+{"version":3,"file":"EventRunner.d.ts","sourceRoot":"","sources":["../../src/rpg/EventRunner.ts"],"names":[],"mappings":"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"}

package/dist/rpg/EventRunner.js

@@ -23,53 +23,94 @@ export class EventRunner {
         this.cancelled = true;
     }
     async run(commands) {
-        for (const command of commands) {
+        const jump = await this.runList(commands);
+        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 - the `EventCommand`
+     * counterpart to `StageScript.runStory`.
+     */
+    async runStory(story, start) {
+        if (!Object.prototype.hasOwnProperty.call(story, start)) {
+            throw new Error(`this event story has no passage named "${start}"`);
+        }
+        let commands = story[start];
+        let index = 0;
+        while (index < commands.length) {
             if (this.cancelled)
                 break;
-            await this.step(command);
+            const jump = await this.step(commands[index]);
+            index++;
+            if (jump !== undefined) {
+                if (!Object.prototype.hasOwnProperty.call(story, jump)) {
+                    throw new Error(`this event story has no passage named "${jump}"`);
+                }
+                commands = story[jump];
+                index = 0;
+            }
         }
         return this.state;
     }
+    /** runs a plain list of commands, returning the passage to jump to, if any */
+    async runList(commands) {
+        for (const command of commands) {
+            if (this.cancelled)
+                break;
+            const jump = await this.step(command);
+            if (jump !== undefined)
+                return jump;
+        }
+        return undefined;
+    }
+    /** runs one command; returns the passage to jump to, if the command jumps anywhere */
     async step(command) {
         if ('say' in command) {
             await this.speak(command.say, command.speaker, command.portrait);
-            return;
+            return undefined;
         }
         if ('ask' in command) {
             const chosen = await this.speak(command.ask, command.speaker, command.portrait, command.choices);
             if (command.store)
                 this.state.answers[command.store] = chosen;
-            return;
+            //a MessageBox resolves with the chosen value, which defaults to the text
+            return command.choices.find((c) => (c.value ?? c.text) === chosen)?.goto;
         }
         if ('wait' in command) {
             await new Promise((resolve) => setTimeout(resolve, command.wait * 1000));
-            return;
+            return undefined;
         }
         if ('setSwitch' in command) {
             this.state.game.setSwitch(command.setSwitch, command.value);
-            return;
+            return undefined;
         }
         if ('setVariable' in command) {
             this.state.game.setVariable(command.setVariable, command.value);
-            return;
+            return undefined;
         }
         if ('addVariable' in command) {
             const current = this.state.game.variable(command.addVariable);
             this.state.game.setVariable(command.addVariable, current + command.amount);
-            return;
+            return undefined;
         }
         if ('if' in command) {
             const holds = conditionHolds(command.if, this.state.game);
-            await this.run(holds ? command.then : (command.else ?? []));
-            return;
+            return this.runList(holds ? command.then : (command.else ?? []));
         }
         if ('move' in command) {
             await this.options.move?.(command.move.target, command.move.steps);
-            return;
+            return undefined;
+        }
+        if ('goto' in command) {
+            return command.goto;
         }
         if ('call' in command) {
             await command.call(this.state);
         }
+        return undefined;
     }
     speak(text, speaker, portrait, choices) {
         return this.options.present({ text, speaker, portrait, choices });

package/dist/rpg/EventRunner.js.map

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

package/dist/rpg/dialogue-text.d.ts

@@ -0,0 +1,81 @@
+import type { Catalog, Direction } from '../i18n/index.ts';
+import type { EventCommand } from './EventRunner.ts';
+/**
+ * A terse, line-based text format for straight (non-branching) dialogue - the format a
+ * text-only RPG (`core` plus `rpg`, no renderer at all) can use for its own `EventCommand`
+ * scripts without depending on `two-d` for anything. `two-d/stage` has its own wrapper
+ * around the same parsing engine (`core.parseDialogueLines`) targeting `StageCommand`
+ * instead - declared separately for the same reason `EventChoice` is declared separately
+ * from `two-d/ui`'s `Choice`: a Pixi-based visual novel that never touches `rpg`'s map
+ * events should not have to pull the whole module in just to parse dialogue text, and a
+ * text-only RPG should not have to pull in Pixi either. The actual `@id`/`-` parsing logic
+ * lives once in `core.parseDialogueLines`, not copied between the two - only the final
+ * command shape (`speaker` here, `as` in `two-d/stage`) differs.
+ *
+ * Three kinds of line:
+ *
+ * - `@id text` names who is speaking and says `text`; `@id` alone (no text) just registers
+ *   the speaker, without saying anything yet.
+ * - `- text` continues the two-speaker exchange the first two `@id` lines opened,
+ *   alternating speaker on every line: the first `-` after the two openers goes to
+ *   whichever of them did not speak last, and so on.
+ * - any other non-blank line narrates, with no speaker.
+ *
+ * ```
+ * @alice Hello.
+ * @bob Hi!
+ * - How are you?
+ * - Fine, and you?
+ * ```
+ *
+ * The `-` shorthand is deliberately capped at two speakers: it exists for the two-character
+ * back-and-forth, not as a guess at which of three or more people talks next. A third
+ * distinct `@id` anywhere in the source is a parse error rather than a silent guess; a scene
+ * with more than two speakers writes `@id` on every line instead, same as it does today.
+ *
+ * Lines reach `EventCommand.say` as plain, untranslated text - a game's own translation step
+ * decides how that text reaches a player, the same seam MWL's own `_("...")`-marked strings
+ * use (the source text doubles as the catalog key). `extractDialogueCatalog` builds that
+ * catalog the same way MWL's `extractCatalog` does, for a game that wants a translator-ready
+ * file to start from.
+ *
+ * @example
+ * ```ts
+ * import { parseDialogueText, EventRunner, GameState } from '@datamoc/mw_games/rpg';
+ *
+ * declare const game: GameState;
+ *
+ * const runner = new EventRunner({
+ *   game,
+ *   present: async (request) => {
+ *     console.log(request.speaker ? `${request.speaker}: ${request.text}` : request.text);
+ *   },
+ * });
+ * const commands = parseDialogueText(`
+ * @alice Hello.
+ * @bob Hi!
+ * - How are you?
+ * - Fine, and you?
+ * `);
+ * await runner.run(commands);
+ * ```
+ */
+export declare function parseDialogueText(source: string): EventCommand[];
+/**
+ * Collects every `say`/`ask` line's text into an identity catalog - each key mapping to
+ * itself, the same shape MWL's own `extractCatalog` builds from `_("...")`-marked strings -
+ * so a translator has real entries to work from instead of a wall of untranslated dialogue.
+ *
+ * @example
+ * ```ts
+ * import { parseDialogueText, extractDialogueCatalog } from '@datamoc/mw_games/rpg';
+ *
+ * const commands = parseDialogueText('@alice Hello.\n');
+ * console.log(extractDialogueCatalog(commands).messages); // { 'Hello.': 'Hello.' }
+ * ```
+ */
+export declare function extractDialogueCatalog(commands: readonly EventCommand[], options?: {
+    locale?: string;
+    direction?: Direction;
+}): Catalog;
+//# sourceMappingURL=dialogue-text.d.ts.map

package/dist/rpg/dialogue-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialogue-text.d.ts","sourceRoot":"","sources":["../../src/rpg/dialogue-text.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,CAIhE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,SAAS,YAAY,EAAE,EACjC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAAO,GACtD,OAAO,CAOT"}

package/dist/rpg/dialogue-text.js

@@ -0,0 +1,88 @@
+import { parseDialogueLines } from '../core/DialogueText.js';
+/**
+ * A terse, line-based text format for straight (non-branching) dialogue - the format a
+ * text-only RPG (`core` plus `rpg`, no renderer at all) can use for its own `EventCommand`
+ * scripts without depending on `two-d` for anything. `two-d/stage` has its own wrapper
+ * around the same parsing engine (`core.parseDialogueLines`) targeting `StageCommand`
+ * instead - declared separately for the same reason `EventChoice` is declared separately
+ * from `two-d/ui`'s `Choice`: a Pixi-based visual novel that never touches `rpg`'s map
+ * events should not have to pull the whole module in just to parse dialogue text, and a
+ * text-only RPG should not have to pull in Pixi either. The actual `@id`/`-` parsing logic
+ * lives once in `core.parseDialogueLines`, not copied between the two - only the final
+ * command shape (`speaker` here, `as` in `two-d/stage`) differs.
+ *
+ * Three kinds of line:
+ *
+ * - `@id text` names who is speaking and says `text`; `@id` alone (no text) just registers
+ *   the speaker, without saying anything yet.
+ * - `- text` continues the two-speaker exchange the first two `@id` lines opened,
+ *   alternating speaker on every line: the first `-` after the two openers goes to
+ *   whichever of them did not speak last, and so on.
+ * - any other non-blank line narrates, with no speaker.
+ *
+ * ```
+ * @alice Hello.
+ * @bob Hi!
+ * - How are you?
+ * - Fine, and you?
+ * ```
+ *
+ * The `-` shorthand is deliberately capped at two speakers: it exists for the two-character
+ * back-and-forth, not as a guess at which of three or more people talks next. A third
+ * distinct `@id` anywhere in the source is a parse error rather than a silent guess; a scene
+ * with more than two speakers writes `@id` on every line instead, same as it does today.
+ *
+ * Lines reach `EventCommand.say` as plain, untranslated text - a game's own translation step
+ * decides how that text reaches a player, the same seam MWL's own `_("...")`-marked strings
+ * use (the source text doubles as the catalog key). `extractDialogueCatalog` builds that
+ * catalog the same way MWL's `extractCatalog` does, for a game that wants a translator-ready
+ * file to start from.
+ *
+ * @example
+ * ```ts
+ * import { parseDialogueText, EventRunner, GameState } from '@datamoc/mw_games/rpg';
+ *
+ * declare const game: GameState;
+ *
+ * const runner = new EventRunner({
+ *   game,
+ *   present: async (request) => {
+ *     console.log(request.speaker ? `${request.speaker}: ${request.text}` : request.text);
+ *   },
+ * });
+ * const commands = parseDialogueText(`
+ * @alice Hello.
+ * @bob Hi!
+ * - How are you?
+ * - Fine, and you?
+ * `);
+ * await runner.run(commands);
+ * ```
+ */
+export function parseDialogueText(source) {
+    return parseDialogueLines(source).map((line) => line.speaker === undefined ? { say: line.text } : { say: line.text, speaker: line.speaker });
+}
+/**
+ * Collects every `say`/`ask` line's text into an identity catalog - each key mapping to
+ * itself, the same shape MWL's own `extractCatalog` builds from `_("...")`-marked strings -
+ * so a translator has real entries to work from instead of a wall of untranslated dialogue.
+ *
+ * @example
+ * ```ts
+ * import { parseDialogueText, extractDialogueCatalog } from '@datamoc/mw_games/rpg';
+ *
+ * const commands = parseDialogueText('@alice Hello.\n');
+ * console.log(extractDialogueCatalog(commands).messages); // { 'Hello.': 'Hello.' }
+ * ```
+ */
+export function extractDialogueCatalog(commands, options = {}) {
+    const messages = {};
+    for (const command of commands) {
+        if ('say' in command)
+            messages[command.say] = command.say;
+        else if ('ask' in command)
+            messages[command.ask] = command.ask;
+    }
+    return { locale: options.locale ?? 'en', direction: options.direction ?? 'ltr', messages };
+}
+//# sourceMappingURL=dialogue-text.js.map

package/dist/rpg/dialogue-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialogue-text.js","sourceRoot":"","sources":["../../src/rpg/dialogue-text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAI7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC/C,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC9C,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAC3F,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,sBAAsB,CACrC,QAAiC,EACjC,OAAO,GAA+C,EAAE;IAExD,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAChC,IAAI,KAAK,IAAI,OAAO;YAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;aACrD,IAAI,KAAK,IAAI,OAAO;YAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAChE,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,KAAK,EAAE,QAAQ,EAAE,CAAC;AAC5F,CAAC"}

package/dist/rpg/index.d.ts

@@ -6,7 +6,7 @@ export { GameState } from './GameState.ts';
 export { activePage, conditionHolds } from './Event.ts';
 export type { EventTrigger, EventCondition, EventPage, MapEvent } from './Event.ts';
 export { EventRunner } from './EventRunner.ts';
-export type { EventCommand, EventRunnerState, EventRunnerOptions, MoveStep, DialoguePresenter, DialogueRequest, EventChoice, } from './EventRunner.ts';
+export type { EventCommand, EventStoryScript, EventRunnerState, EventRunnerOptions, MoveStep, DialoguePresenter, DialogueRequest, EventChoice, } from './EventRunner.ts';
 export { GridMover } from './GridMover.ts';
 export type { GridMoverOptions, Direction4 } from './GridMover.ts';
 export { MoveRouteRunner } from './MoveRoute.ts';
@@ -19,4 +19,7 @@ export { QuestLog, questsFromRows } from './Quest.ts';
 export type { QuestStage, QuestDefinition, QuestStatus, QuestMarker, QuestStageRow } from './Quest.ts';
 export { decodeMarshal, encodeMarshal, RubySymbol, hashDefaultOf, withHashDefault } from './Marshal.ts';
 export type { RubyObject, RubyUserDefined } from './Marshal.ts';
+export { parseDialogueText, extractDialogueCatalog } from './dialogue-text.ts';
+export { importTwee } from './twee-events.ts';
+export type { EventTwineStory } from './twee-events.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rpg/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,EAAE,KAAK,IAAI,aAAa,EAAE,MAAM,cAAc,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EACX,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,QAAQ,EACR,iBAAiB,EACjB,eAAe,EACf,WAAW,GACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACxG,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACvG,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACxG,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rpg/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,EAAE,KAAK,IAAI,aAAa,EAAE,MAAM,cAAc,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EACX,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,QAAQ,EACR,iBAAiB,EACjB,eAAe,EACf,WAAW,GACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACxG,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACvG,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACxG,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/rpg/index.js

@@ -9,4 +9,6 @@ export { FreeMover } from './FreeMover.js';
 export { aabbOverlap, circleOverlap, circleAabbOverlap, resolveAabbAgainstTiles } from './Collision.js';
 export { QuestLog, questsFromRows } from './Quest.js';
 export { decodeMarshal, encodeMarshal, RubySymbol, hashDefaultOf, withHashDefault } from './Marshal.js';
+export { parseDialogueText, extractDialogueCatalog } from './dialogue-text.js';
+export { importTwee } from './twee-events.js';
 //# sourceMappingURL=index.js.map

package/dist/rpg/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rpg/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,KAAK,IAAI,aAAa,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAU/C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAExG,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rpg/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,KAAK,IAAI,aAAa,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAW/C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAExG,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAExG,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/rpg/twee-events.d.ts

@@ -0,0 +1,48 @@
+import type { EventStoryScript } from './EventRunner.ts';
+/**
+ * A story imported from Twine's Twee notation, ready for `EventRunner.runStory`.
+ *
+ * The `two-d/stage` counterpart, `importTwee`, targets `StageCommand`/`StoryScript` instead -
+ * declared independently here for the same reason `EventChoice` already duplicates
+ * `two-d/ui`'s `Choice`: a text-only RPG (`core` plus `rpg`, no renderer at all) should not
+ * have to depend on `two-d` just to import a branching Twee story, and a Pixi-based visual
+ * novel that never touches map events should not have to depend on `rpg` either.
+ */
+export interface EventTwineStory {
+    story: EventStoryScript;
+    /** `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 an `EventStoryScript`.
+ *
+ * The actual parsing (passages, `[[links]]`, `StoryData`/`StoryTitle`) lives once in
+ * `core.parseTwee` - this is a thin wrapper naming the `rpg`-specific return type, the same
+ * way `two-d/stage.importTwee` wraps the same engine for `StageCommand`.
+ *
+ * @example
+ * ```ts
+ * import { importTwee, EventRunner, GameState, type DialoguePresenter } from '@datamoc/mw_games/rpg';
+ *
+ * declare const present: DialoguePresenter;
+ *
+ * const story = importTwee(`:: Start
+ * You stand at a crossroads.
+ *
+ * [[Take the left path->Left]]
+ * [[Take the right path->Right]]
+ *
+ * :: Left
+ * The path ends at a wall.
+ *
+ * :: Right
+ * An open road.
+ * `);
+ * const runner = new EventRunner({ present, game: new GameState() });
+ * await runner.runStory(story.story, story.start);
+ * ```
+ */
+export declare function importTwee(source: string): EventTwineStory;
+//# sourceMappingURL=twee-events.d.ts.map

package/dist/rpg/twee-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"twee-events.d.ts","sourceRoot":"","sources":["../../src/rpg/twee-events.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,gBAAgB,CAAC;IACxB,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,eAAe,CAG1D"}

package/dist/rpg/twee-events.js

@@ -0,0 +1,35 @@
+import { parseTwee } from '../core/Twee.js';
+/**
+ * Reads a `.twee` file into an `EventStoryScript`.
+ *
+ * The actual parsing (passages, `[[links]]`, `StoryData`/`StoryTitle`) lives once in
+ * `core.parseTwee` - this is a thin wrapper naming the `rpg`-specific return type, the same
+ * way `two-d/stage.importTwee` wraps the same engine for `StageCommand`.
+ *
+ * @example
+ * ```ts
+ * import { importTwee, EventRunner, GameState, type DialoguePresenter } from '@datamoc/mw_games/rpg';
+ *
+ * declare const present: DialoguePresenter;
+ *
+ * const story = importTwee(`:: Start
+ * You stand at a crossroads.
+ *
+ * [[Take the left path->Left]]
+ * [[Take the right path->Right]]
+ *
+ * :: Left
+ * The path ends at a wall.
+ *
+ * :: Right
+ * An open road.
+ * `);
+ * const runner = new EventRunner({ present, game: new GameState() });
+ * await runner.runStory(story.story, story.start);
+ * ```
+ */
+export function importTwee(source) {
+    const { story, start, title } = parseTwee(source);
+    return title === undefined ? { story, start } : { story, start, title };
+}
+//# sourceMappingURL=twee-events.js.map

package/dist/rpg/twee-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"twee-events.js","sourceRoot":"","sources":["../../src/rpg/twee-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAoB5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc;IACxC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAClD,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACzE,CAAC"}

package/dist/two-d/stage/dialogue-text.d.ts

@@ -0,0 +1,81 @@
+import type { Catalog, Direction } from '../../i18n/index.ts';
+import type { StageCommand, StoryScript } from './script.ts';
+/**
+ * A terse, line-based text format for straight (non-branching) dialogue - the
+ * counterpart to `twee.ts`'s passage graphs, for the common case of a scene
+ * that is just a sequence of lines. `rpg` has its own wrapper around the same
+ * parsing engine (`core.parseDialogueLines`) for a text-only RPG's map events
+ * (`rpg.parseDialogueText`, targeting `EventCommand`) - declared separately
+ * here for the same reason `EventChoice` is declared separately from this
+ * module's own `Choice`: a text-only RPG built on `core` and `rpg` alone
+ * should not have to depend on `two-d` (and its Pixi peer dependency) just to
+ * parse dialogue text, and a Pixi-based visual novel that never touches map
+ * events should not have to pull in `rpg` either. The actual `@id`/`-`
+ * parsing logic lives once in `core.parseDialogueLines`, not copied between
+ * the two - only the final command shape (`as` here, `speaker` in `rpg`)
+ * differs. Three kinds of line:
+ *
+ * - `@id text` names who is speaking and says `text`; `@id` alone (no text)
+ *   just registers the speaker, without saying anything yet.
+ * - `- text` continues the two-speaker exchange the first two `@id` lines
+ *   opened, alternating speaker on every line: the first `-` after the two
+ *   openers goes to whichever of them did not speak last, and so on.
+ * - any other non-blank line narrates, with no speaker.
+ *
+ * ```
+ * @alice Hello.
+ * @bob Hi!
+ * - How are you?
+ * - Fine, and you?
+ * ```
+ *
+ * The `-` shorthand is deliberately capped at two speakers: it exists for the
+ * two-character back-and-forth, not as a guess at which of three or more
+ * people talks next. A third distinct `@id` anywhere in the source is a
+ * parse error rather than a silent guess; a scene with more than two
+ * speakers writes `@id` on every line instead, same as it does today.
+ *
+ * Like `twee.ts`, lines reach `StageCommand.say` as plain, untranslated
+ * text - a game's own translation step decides how that text reaches a
+ * player, the same seam MWL's own `_("...")`-marked strings use (the source
+ * text doubles as the catalog key). `extractDialogueCatalog` builds that
+ * catalog the same way MWL's `extractCatalog` does, for a game that wants a
+ * translator-ready file to start from.
+ *
+ * @example
+ * ```ts
+ * import { parseDialogueText, StageScript } from '@datamoc/mw_games/two-d';
+ *
+ * declare const script: StageScript;
+ *
+ * const commands = parseDialogueText(`
+ * @alice Hello.
+ * @bob Hi!
+ * - How are you?
+ * - Fine, and you?
+ * `);
+ * await script.run(commands);
+ * ```
+ */
+export declare function parseDialogueText(source: string): StageCommand[];
+/**
+ * Collects every `say`/`ask` line's text into an identity catalog - each key
+ * mapping to itself, the same shape MWL's own `extractCatalog` builds from
+ * `_("...")`-marked strings - so a translator has real entries to work from
+ * instead of a wall of untranslated dialogue. Accepts either a flat command
+ * list (`parseDialogueText`'s own output) or a `StoryScript` graph
+ * (`importTwee`'s), so the same extraction step covers both dialogue paths.
+ *
+ * @example
+ * ```ts
+ * import { parseDialogueText, extractDialogueCatalog } from '@datamoc/mw_games/two-d';
+ *
+ * const commands = parseDialogueText('@alice Hello.\n');
+ * console.log(extractDialogueCatalog(commands).messages); // { 'Hello.': 'Hello.' }
+ * ```
+ */
+export declare function extractDialogueCatalog(commands: readonly StageCommand[] | StoryScript, options?: {
+    locale?: string;
+    direction?: Direction;
+}): Catalog;
+//# sourceMappingURL=dialogue-text.d.ts.map

package/dist/two-d/stage/dialogue-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialogue-text.d.ts","sourceRoot":"","sources":["../../../src/two-d/stage/dialogue-text.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,CAIhE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,WAAW,EAC/C,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAAO,GACtD,OAAO,CAYT"}