@datamoc/mw_games 0.11.0 → 0.13.0

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,9 +6,11 @@ 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';
+export type { MoveRoute, MoveRouteStep, MoveRouteOptions } from './MoveRoute.ts';
 export { FreeMover } from './FreeMover.ts';
 export type { FreeMoverOptions } from './FreeMover.ts';
 export { aabbOverlap, circleOverlap, circleAabbOverlap, resolveAabbAgainstTiles } from './Collision.ts';
@@ -17,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,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

@@ -4,8 +4,11 @@ export { GameState } from './GameState.js';
 export { activePage, conditionHolds } from './Event.js';
 export { EventRunner } from './EventRunner.js';
 export { GridMover } from './GridMover.js';
+export { MoveRouteRunner } from './MoveRoute.js';
 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,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"}

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

@@ -0,0 +1,95 @@
+import { parseDialogueLines } from '../../core/DialogueText.js';
+/**
+ * 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 function parseDialogueText(source) {
+    return parseDialogueLines(source).map((line) => line.speaker === undefined ? { say: line.text } : { say: line.text, as: 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. 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 function extractDialogueCatalog(commands, options = {}) {
+    const messages = {};
+    const collect = (list) => {
+        for (const command of list) {
+            if ('say' in command)
+                messages[command.say] = command.say;
+            else if ('ask' in command)
+                messages[command.ask] = command.ask;
+        }
+    };
+    if (Array.isArray(commands))
+        collect(commands);
+    else
+        for (const list of Object.values(commands))
+            collect(list);
+    return { locale: options.locale ?? 'en', direction: options.direction ?? 'ltr', messages };
+}
+//# sourceMappingURL=dialogue-text.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dialogue-text.js","sourceRoot":"","sources":["../../../src/two-d/stage/dialogue-text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAIhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;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,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,CACtF,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,sBAAsB,CACrC,QAA+C,EAC/C,OAAO,GAA+C,EAAE;IAExD,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,MAAM,OAAO,GAAG,CAAC,IAA6B,EAAQ,EAAE;QACvD,KAAK,MAAM,OAAO,IAAI,IAAI,EAAE,CAAC;YAC5B,IAAI,KAAK,IAAI,OAAO;gBAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;iBACrD,IAAI,KAAK,IAAI,OAAO;gBAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;QAChE,CAAC;IACF,CAAC,CAAC;IACF,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;;QAC1C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/D,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/two-d/stage/index.d.ts

@@ -4,6 +4,7 @@ export { StageScript } from './script.ts';
 export type { StageCommand, StageChoice, StoryScript, ScriptOptions, ScriptState, HistoryEntry } from './script.ts';
 export { importTwee } from './twee.ts';
 export type { TwineStory } from './twee.ts';
+export { parseDialogueText, extractDialogueCatalog } from './dialogue-text.ts';
 export { StoryScreen, StorySequence } from './StoryScreen.ts';
 export type { StoryBeat, StoryScreenOptions } from './StoryScreen.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/two-d/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,YAAY,EAAE,MAAM,aAAa,CAAC;AACpH,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC9D,YAAY,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/two-d/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,YAAY,EAAE,MAAM,aAAa,CAAC;AACpH,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE/E,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC9D,YAAY,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/two-d/stage/index.js

@@ -1,5 +1,6 @@
 export { DialogueStage } from './DialogueStage.js';
 export { StageScript } from './script.js';
 export { importTwee } from './twee.js';
+export { parseDialogueText, extractDialogueCatalog } from './dialogue-text.js';
 export { StoryScreen, StorySequence } from './StoryScreen.js';
 //# sourceMappingURL=index.js.map

package/dist/two-d/stage/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/two-d/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;AAGvC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/two-d/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;AAEvC,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE/E,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/two-d/stage/twee.d.ts

@@ -12,31 +12,13 @@ export interface TwineStory {
 /**
  * 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]]
- * ```
+ * The actual parsing (passages, `[[links]]`, `StoryData`/`StoryTitle`) lives once in
+ * `core.parseTwee` - `rpg.importTwee` is the same wrapper around the same engine, targeting
+ * `EventStoryScript` instead, declared separately for the same reason `EventChoice` already
+ * duplicates `two-d/ui`'s `Choice`: a text-only RPG 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. `core.parseTwee`'s own doc comment covers
+ * the notation itself (passages, links, what a macro-carrying link does).
  *
  * @example
  * ```ts

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

@@ -1 +1 @@
-{"version":3,"file":"twee.d.ts","sourceRoot":"","sources":["../../../src/two-d/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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CA0CrD"}
+{"version":3,"file":"twee.d.ts","sourceRoot":"","sources":["../../../src/two-d/stage/twee.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;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;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAGrD"}