@datamoc/mw_games 0.12.0 → 0.14.0

package/dist/two-d/Game.js

@@ -1,8 +1,11 @@
 import { Application, TextureSource } from 'pixi.js';
 import { SceneStack } from '../core/SceneStack.js';
 import { Signal } from '../core/Signal.js';
+import { Logger } from '../core/Log.js';
+import { fitResolution } from './ResolutionFit.js';
 import * as Input from '../core/Input.js';
 const PIXEL_ART_CLASS = 'mwg-pixel-art';
+const log = new Logger('renderer');
 /**
  * A class beats an inline `canvas.style.imageRendering` because Pixi's own `autoDensity`/
  * `resizeTo` rewrite the canvas's `style` attribute wholesale (see `start()`); this rule
@@ -42,6 +45,13 @@ function watchDevicePixelRatio(onChange) {
  * The application: owns the renderer, the loop, and the current scene.
  *
  * Construct it, `await start(FirstScene)`, and the rest is scenes.
+ *
+ * The canvas is drawn at the display's `devicePixelRatio`, up to what the device can actually
+ * make: a backing store of `viewport * devicePixelRatio` pixels is refused past the GPU's
+ * `MAX_TEXTURE_SIZE` (WebGL clamps it rather than failing, with nothing reported), so the
+ * resolution is reduced to the largest whole number that fits and a warning says so. A game
+ * therefore keeps rendering on a device with a small limit, softer than the display asked for
+ * rather than wrong; nothing changes on a device that can afford what it asked for.
  */
 export class Game {
     static { this.instance = null; }
@@ -134,7 +144,11 @@ export class Game {
         //them the backing size would push everything they centre off the screen.
         this.app.renderer.on('resize', () => {
             this.stack.resize(this.width, this.height);
+            //a rotation or a window resize changes how much of a backing store this device
+            //can afford, so re-fit rather than keeping whatever was chosen at startup
+            this.fitResolutionToDevice();
         });
+        this.fitResolutionToDevice();
         //the resolution passed to app.init() above is a one-time snapshot of
         //devicePixelRatio; a later browser zoom (or dragging the window to a display with a
         //different scale factor) changes that ratio without Pixi noticing on its own. Left
@@ -143,7 +157,7 @@ export class Game {
         //non-integer ratio duplicates pixel columns inconsistently - the seams a pixel-art
         //tilemap shows between tiles that were perfectly adjacent in the buffer itself.
         this.stopWatchingDpr = watchDevicePixelRatio(() => {
-            this.app.renderer.resize(this.width, this.height, window.devicePixelRatio || 1);
+            this.fitResolutionToDevice();
         });
         this.expose();
         this.switchNow(first);
@@ -221,6 +235,33 @@ export class Game {
         target.__PIXI_APP__ = this.app;
         target.__MWG__ = this;
     }
+    /**
+     * Resizes the renderer to a resolution this device can actually afford.
+     *
+     * A full-window canvas at device resolution can ask for a backing store larger than the
+     * GPU's `MAX_TEXTURE_SIZE`, and WebGL clamps that silently instead of failing: the canvas
+     * keeps its size, the scene keeps being rendered into a surface that is not the one asked
+     * for, and nothing anywhere says so. A 1080-wide phone at `devicePixelRatio` 2.625 asks for
+     * 2121x4709 against the 4096 limit one emulator reported, and got a 2121x4096 drawing
+     * buffer; see `fitResolution` for the arithmetic and for what that investigation did and
+     * did not establish about the black screen that process showed.
+     *
+     * Called after `init`, whenever the renderer is resized (a rotation changes which one fits),
+     * and when `devicePixelRatio` itself changes. It returns immediately when the device can
+     * afford what was asked for, which is every ordinary case, so nothing about a normal
+     * startup changes.
+     */
+    fitResolutionToDevice() {
+        const gl = this.app.renderer.gl;
+        const limit = gl ? gl.getParameter(gl.MAX_TEXTURE_SIZE) : Number.POSITIVE_INFINITY;
+        const wanted = window.devicePixelRatio || 1;
+        const fitted = fitResolution(this.width, this.height, wanted, limit);
+        if (fitted === this.app.renderer.resolution)
+            return;
+        log.warn(`this device cannot render a ${this.width}x${this.height} canvas at ${wanted}x ` +
+            `(its limit is ${limit}); using ${fitted}x instead, which is softer than the display`);
+        this.app.renderer.resize(this.width, this.height, fitted);
+    }
     frame(deltaSeconds) {
         //queued scene changes run first, in order, so a frame never updates a
         //scene that was already asked to leave

package/dist/two-d/Game.js.map

@@ -1 +1 @@
-{"version":3,"file":"Game.js","sourceRoot":"","sources":["../../src/two-d/Game.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGrD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAE1C,MAAM,eAAe,GAAG,eAAe,CAAC;AAQxC;;;;;GAKG;AACH,SAAS,wBAAwB;IAChC,IAAI,QAAQ,CAAC,cAAc,CAAC,eAAe,CAAC;QAAE,OAAO;IAErD,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC9C,KAAK,CAAC,EAAE,GAAG,eAAe,CAAC;IAC3B,KAAK,CAAC,WAAW,GAAG,IAAI,eAAe,kCAAkC,CAAC;IAC1E,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,qBAAqB,CAAC,QAAoB;IAClD,IAAI,KAAK,GAA0B,IAAI,CAAC;IAExC,MAAM,KAAK,GAAG,GAAS,EAAE;QACxB,KAAK,GAAG,UAAU,CAAC,gBAAgB,MAAM,CAAC,gBAAgB,OAAO,CAAC,CAAC;QACnE,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC,CAAC;IACF,MAAM,IAAI,GAAG,GAAS,EAAE;QACvB,QAAQ,EAAE,CAAC;QACX,KAAK,EAAE,CAAC;IACT,CAAC,CAAC;IAEF,KAAK,EAAE,CAAC;IACR,OAAO,GAAG,EAAE,CAAC,KAAK,EAAE,mBAAmB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACzD,CAAC;AAuDD;;;;GAIG;AACH,MAAM,OAAO,IAAI;aACD,aAAQ,GAAgB,IAAI,AAApB,CAAqB;IAyB5C,YAAY,OAAO,GAAgB,EAAE;QAvB5B,QAAG,GAAG,IAAI,WAAW,EAAE,CAAC;QAEjC,mEAAmE;QACnE,YAAO,GAAG,CAAC,CAAC;QAEZ,wDAAwD;QACxD,cAAS,GAAG,CAAC,CAAC;QAEd,+EAA+E;QAC/E,cAAS,GAAG,CAAC,CAAC;QAEd,6EAA6E;QACpE,YAAO,GAAG,IAAI,MAAM,EAAU,CAAC;QAEhC,qBAAgB,GAAG,CAAC,CAAC;QACrB,iBAAY,GAAG,CAAC,CAAC;QAEjB,UAAK,GAAG,IAAI,UAAU,EAAW,CAAC;QAClC,YAAO,GAAmB,EAAE,CAAC;QAE7B,YAAO,GAAG,KAAK,CAAC;QAChB,oBAAe,GAAwB,IAAI,CAAC;QAGnD,IAAI,CAAC,OAAO,GAAG;YACd,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC;YAC1D,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,QAAQ;YAC1C,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;YAClC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;YAClC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,MAAM;YACpC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE;SACpC,CAAC;QAEF,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC3B,6EAA6E;YAC7E,6EAA6E;YAC7E,8EAA8E;YAC9E,2EAA2E;YAC3E,0EAA0E;YAC1E,+EAA+E;YAC/E,oEAAoE;YACpE,8EAA8E;YAC9E,yEAAyE;YACzE,aAAa,CAAC,cAAc,CAAC,SAAS,GAAG,SAAS,CAAC;QACpD,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,6EAA6E;IAC7E,IAAI,KAAK;QACR,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC;IACvC,CAAC;IAED,IAAI,MAAM;QACT,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACxC,CAAC;IAED,wEAAwE;IACxE,MAAM,KAAK,OAAO;QACjB,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC,QAAQ,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAA0B;QACrC,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QAEpB,6EAA6E;QAC7E,oFAAoF;QACpF,iCAAiC;QACjC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU;YAAE,QAAQ,EAAE,CAAC;QAC3D,KAAK,CAAC,MAAM,EAAE,CAAC;QAEf,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YACnB,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;YAC3B,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;YACnC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ;YAC/B,SAAS,EAAE,KAAK;YAChB,8EAA8E;YAC9E,qBAAqB,EAAE,KAAK;YAC5B,6EAA6E;YAC7E,UAAU,EAAE,MAAM,CAAC,gBAAgB,IAAI,CAAC;YACxC,WAAW,EAAE,IAAI;SACjB,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YACtC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAChD,CAAC;QAED,qFAAqF;QACrF,iFAAiF;QACjF,gFAAgF;QAChF,oFAAoF;QACpF,6EAA6E;QAC7E,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC3B,wBAAwB,EAAE,CAAC;YAC3B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACpD,CAAC;QAED,oFAAoF;QACpF,iFAAiF;QACjF,yEAAyE;QACzE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;YACnC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,qEAAqE;QACrE,oFAAoF;QACpF,mFAAmF;QACnF,mFAAmF;QACnF,8EAA8E;QAC9E,mFAAmF;QACnF,gFAAgF;QAChF,IAAI,CAAC,eAAe,GAAG,qBAAqB,CAAC,GAAG,EAAE;YACjD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,gBAAgB,IAAI,CAAC,CAAC,CAAC;QACjF,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAEtB,8EAA8E;QAC9E,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC;IACpE,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,IAAyB;QACpC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,IAAyB;QAClC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,MAAgB;QACxB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,yDAAyD;IACzD,IAAI,YAAY;QACf,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;IAC3B,CAAC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,QAAgB,EAAE,KAAK,GAAG,CAAC;QAClC,IAAI,CAAC,gBAAgB,GAAG,QAAQ,CAAC;QACjC,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAU;QACd,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACf,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;;;;;OAUG;IACK,MAAM;QACb,MAAM,MAAM,GAAG,UAAgD,CAAC;QAChE,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC;QAC/B,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACvB,CAAC;IAEO,KAAK,CAAC,YAAoB;QACjC,sEAAsE;QACtE,uCAAuC;QACvC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACpC,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ;gBAAE,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;iBACzD,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM;gBAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;;gBAC1D,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACpC,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QAExB,IAAI,IAAI,CAAC,gBAAgB,GAAG,CAAC,EAAE,CAAC;YAC/B,8EAA8E;YAC9E,IAAI,CAAC,gBAAgB,IAAI,YAAY,CAAC;YACtC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QACpE,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;QAC9E,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC;QAE/B,kFAAkF;QAClF,4EAA4E;QAC5E,KAAK,CAAC,YAAY,EAAE,CAAC;QAErB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEpC,yEAAyE;QACzE,KAAK,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;IAEO,SAAS,CAAC,IAAyB;QAC1C,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,0EAA0E;IAClE,WAAW,CAAC,IAAyB;QAC5C,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC;QACzB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;QAChC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAErC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QAEnB,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,+EAA+E;IACvE,SAAS,CAAC,IAAyB;QAC1C,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC;QACzB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAErC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QAEnB,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,kEAAkE;IAC1D,QAAQ,CAAC,MAAe;QAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACvB,IAAI,GAAG;YAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC;IAED,OAAO;QACN,KAAK,CAAC,MAAM,EAAE,CAAC;QACf,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC;QACzB,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACrB,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QACzB,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI;YAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IAClD,CAAC;CACD"}
+{"version":3,"file":"Game.js","sourceRoot":"","sources":["../../src/two-d/Game.ts"],"names":[],"mappings":"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"}

package/dist/two-d/ResolutionFit.d.ts

@@ -0,0 +1,28 @@
+/**
+ * A renderer's backing store is `width * resolution` by `height * resolution` pixels, and a
+ * device's GPU has a `MAX_TEXTURE_SIZE` it will not go past. `Game` used to ask for the
+ * display's full `devicePixelRatio` whatever the canvas size, which on a large enough canvas is
+ * a request the device cannot honour: WebGL answers that by clamping the drawing buffer rather
+ * than failing, so the game carries on rendering into a surface that is not the one it asked
+ * for, with nothing reported anywhere.
+ *
+ * Measured, not assumed: a full-window canvas of 816x1812 css pixels at `devicePixelRatio`
+ * 2.625 asks for 2121x4709, and a device reporting a 4096 limit produced a drawing buffer
+ * clamped to 2121x4096. That same process painted an entirely black screen, but that is *not*
+ * attributed here: the failure did not reproduce (the emulator reported 8192 on every later
+ * start) and a deliberately clamped 1050x10500 request rendered correctly on the next process,
+ * so the black screen's cause was never established. What stands on its own is the clamped
+ * request, which is a size the game never asked for and cannot see.
+ *
+ * So the request is kept inside what the device says it can make. Whole numbers, because whole
+ * device pixels are the point: a fractional ratio duplicates pixel columns unevenly, the same
+ * reason `Game` watches `devicePixelRatio` in the first place.
+ *
+ * @param width logical width in css pixels (`renderer.screen.width`)
+ * @param height logical height in css pixels
+ * @param devicePixelRatio what the display asks for; never exceeded
+ * @param maxTextureSize the GPU's own limit, or any non-finite/non-positive value for "no cap"
+ * @returns the resolution to resize with, never above `devicePixelRatio`, never below 1
+ */
+export declare function fitResolution(width: number, height: number, devicePixelRatio: number, maxTextureSize: number): number;
+//# sourceMappingURL=ResolutionFit.d.ts.map

package/dist/two-d/ResolutionFit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResolutionFit.d.ts","sourceRoot":"","sources":["../../src/two-d/ResolutionFit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CASrH"}

package/dist/two-d/ResolutionFit.js

@@ -0,0 +1,39 @@
+/**
+ * A renderer's backing store is `width * resolution` by `height * resolution` pixels, and a
+ * device's GPU has a `MAX_TEXTURE_SIZE` it will not go past. `Game` used to ask for the
+ * display's full `devicePixelRatio` whatever the canvas size, which on a large enough canvas is
+ * a request the device cannot honour: WebGL answers that by clamping the drawing buffer rather
+ * than failing, so the game carries on rendering into a surface that is not the one it asked
+ * for, with nothing reported anywhere.
+ *
+ * Measured, not assumed: a full-window canvas of 816x1812 css pixels at `devicePixelRatio`
+ * 2.625 asks for 2121x4709, and a device reporting a 4096 limit produced a drawing buffer
+ * clamped to 2121x4096. That same process painted an entirely black screen, but that is *not*
+ * attributed here: the failure did not reproduce (the emulator reported 8192 on every later
+ * start) and a deliberately clamped 1050x10500 request rendered correctly on the next process,
+ * so the black screen's cause was never established. What stands on its own is the clamped
+ * request, which is a size the game never asked for and cannot see.
+ *
+ * So the request is kept inside what the device says it can make. Whole numbers, because whole
+ * device pixels are the point: a fractional ratio duplicates pixel columns unevenly, the same
+ * reason `Game` watches `devicePixelRatio` in the first place.
+ *
+ * @param width logical width in css pixels (`renderer.screen.width`)
+ * @param height logical height in css pixels
+ * @param devicePixelRatio what the display asks for; never exceeded
+ * @param maxTextureSize the GPU's own limit, or any non-finite/non-positive value for "no cap"
+ * @returns the resolution to resize with, never above `devicePixelRatio`, never below 1
+ */
+export function fitResolution(width, height, devicePixelRatio, maxTextureSize) {
+    const longest = Math.max(width, height);
+    if (!Number.isFinite(maxTextureSize) || maxTextureSize <= 0)
+        return devicePixelRatio;
+    if (!Number.isFinite(longest) || longest <= 0)
+        return devicePixelRatio;
+    if (longest * devicePixelRatio <= maxTextureSize)
+        return devicePixelRatio;
+    //a canvas longer than the limit even at 1x is left at 1x: nothing smaller can be offered,
+    //and scaling the scene down instead would move every coordinate a game depends on
+    return Math.max(1, Math.floor(maxTextureSize / longest));
+}
+//# sourceMappingURL=ResolutionFit.js.map

package/dist/two-d/ResolutionFit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResolutionFit.js","sourceRoot":"","sources":["../../src/two-d/ResolutionFit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,MAAc,EAAE,gBAAwB,EAAE,cAAsB;IAC5G,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,cAAc,IAAI,CAAC;QAAE,OAAO,gBAAgB,CAAC;IACrF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,gBAAgB,CAAC;IACvE,IAAI,OAAO,GAAG,gBAAgB,IAAI,cAAc;QAAE,OAAO,gBAAgB,CAAC;IAE1E,0FAA0F;IAC1F,kFAAkF;IAClF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;AAC1D,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"}

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

@@ -1,31 +1,14 @@
+import { parseTwee } from '../../core/Twee.js';
 /**
  * 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
@@ -39,142 +22,7 @@
  * ```
  */
 export function importTwee(source) {
-    const passages = splitPassages(source);
-    if (passages.length === 0)
-        throw new Error('this twee source has no passages - passages start with ":: Name"');
-    const story = {};
-    let title;
-    let start;
-    for (const passage of passages) {
-        if (passage.name === 'StoryTitle') {
-            title = passage.body.trim() || undefined;
-            continue;
-        }
-        if (passage.name === 'StoryData') {
-            start = readStart(passage.body);
-            continue;
-        }
-        if (Object.prototype.hasOwnProperty.call(story, passage.name)) {
-            throw new Error(`this twee source defines "${passage.name}" twice`);
-        }
-        story[passage.name] = passageCommands(passage.name, passage.body);
-    }
-    const names = Object.keys(story);
-    if (names.length === 0)
-        throw new Error('this twee source has no story passages, only StoryTitle/StoryData');
-    if (start !== undefined && !Object.prototype.hasOwnProperty.call(story, start)) {
-        throw new Error(`StoryData starts at "${start}", which is not a passage in this file`);
-    }
-    for (const [name, commands] of Object.entries(story)) {
-        for (const command of commands) {
-            if ('ask' in command) {
-                for (const choice of command.choices) {
-                    if (choice.goto !== undefined && !Object.prototype.hasOwnProperty.call(story, choice.goto)) {
-                        throw new Error(`passage "${name}" links to "${choice.goto}", which is not a passage in this file`);
-                    }
-                }
-            }
-        }
-    }
-    return { story, start: start ?? names[0], title };
-}
-/** cuts the source at every line starting with `::`, parsing headers into names */
-function splitPassages(source) {
-    const out = [];
-    let name = null;
-    let body = [];
-    const flush = () => {
-        if (name !== null)
-            out.push({ name, body: body.join('\n') });
-    };
-    for (const line of source.split('\n')) {
-        if (line.startsWith('::')) {
-            flush();
-            name = parseHeader(line);
-            body = [];
-        }
-        else if (name !== null) {
-            body.push(line);
-        }
-    }
-    flush();
-    return out;
-}
-/** `:: Name [tags] {"meta": true}` - only the name survives; tags and position are editor concerns */
-function parseHeader(line) {
-    const rest = line.slice(2).trim();
-    const tagAt = rest.search(/[[{]/);
-    const name = (tagAt === -1 ? rest : rest.slice(0, tagAt)).trim();
-    if (!name)
-        throw new Error(`a twee passage header needs a name, got "${line}"`);
-    return name;
-}
-/** StoryData is JSON; only `start` matters to the runner, the rest is player furniture */
-function readStart(body) {
-    let data;
-    try {
-        data = JSON.parse(body.trim());
-    }
-    catch {
-        throw new Error('StoryData must be JSON - check the braces');
-    }
-    if (typeof data !== 'object' || data === null || Array.isArray(data)) {
-        throw new Error('StoryData must be a JSON object');
-    }
-    const start = data.start;
-    if (start !== undefined && typeof start !== 'string') {
-        throw new Error('StoryData "start" must be a passage name');
-    }
-    return start;
-}
-/** text lines speak in order; the last one doubles as the prompt when links follow it */
-function passageCommands(passage, body) {
-    const lines = [];
-    const choices = [];
-    for (const line of body.split('\n')) {
-        const text = extractLinks(line, choices, passage).replace(/\s+/g, ' ').trim();
-        if (text !== '')
-            lines.push(text);
-    }
-    if (choices.length === 0)
-        return lines.map((say) => ({ say }));
-    const prompt = lines.pop() ?? '';
-    return [...lines.map((say) => ({ say })), { ask: prompt, choices }];
-}
-/**
- * Pulls `[[links]]` out of a line, leaving the surrounding text behind.
- * Returns the line with the links removed.
- */
-function extractLinks(line, choices, passage) {
-    let out = '';
-    let rest = line;
-    for (;;) {
-        const open = rest.indexOf('[[');
-        if (open === -1)
-            return out + rest;
-        const close = rest.indexOf(']]', open);
-        if (close === -1) {
-            throw new Error(`passage "${passage}" has a "[[" with no closing "]]" in "${line.trim()}"`);
-        }
-        out += rest.slice(0, open);
-        choices.push(parseLink(rest.slice(open + 2, close), passage));
-        rest = rest.slice(close + 2);
-    }
-}
-function parseLink(inner, passage) {
-    if (inner.includes('[') || inner.includes(']')) {
-        throw new Error(`passage "${passage}" links with a setter ("${inner.trim()}") - ` +
-            'story-format macros are not imported, so the link is refused rather than half-read');
-    }
-    const forward = inner.indexOf('->');
-    if (forward !== -1) {
-        return { text: inner.slice(0, forward).trim(), goto: inner.slice(forward + 2).trim() };
-    }
-    const backward = inner.indexOf('<-');
-    if (backward !== -1) {
-        return { text: inner.slice(backward + 2).trim(), goto: inner.slice(0, backward).trim() };
-    }
-    const target = inner.trim();
-    return { text: target, goto: target };
+    const { story, start, title } = parseTwee(source);
+    return title === undefined ? { story, start } : { story, start, title };
 }
 //# sourceMappingURL=twee.js.map