@datamoc/mw_games 0.43.0 → 0.45.0

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

@@ -1,28 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,39 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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/Scene2D.d.ts

@@ -1,43 +0,0 @@
-import { Scene } from '../core/Scene.ts';
-import type { Container2D } from './render/Types2D.ts';
-import type { TransitionOptions } from './render/SceneTransition.ts';
-/**
- * A scene that draws through Pixi: `core.Scene`'s lifecycle plus the container everything
- * this screen shows hangs off.
- *
- * This is what a 2D game extends. The container is destroyed with the scene, so a scene may
- * add whatever it likes to `stage` without tracking it for cleanup. The base class holds the
- * lifecycle alone precisely so that `core.SceneStack` can drive a Babylon scene just as well
- * as this one - the stack calls `create`, `resize`, `onSuspend`, `onResume` and `destroy`,
- * and never touches `stage`.
- */
-export declare abstract class Scene2D extends Scene {
-    /** everything this scene draws hangs off here */
-    readonly stage: Container2D;
-    /**
-     * Replaces what this scene shows under a transition: the current picture is photographed, `swap`
-     * changes the content (a new level, decor, layout), and the transition plays over the result.
-     * Without a running `Game` (a test) `swap` just runs.
-     *
-     * @example
-     * ```ts
-     * import { Scene2D } from '@datamoc/mw_games/two-d';
-     * import { tileShrink } from '@datamoc/mw_games/two-d/render';
-     *
-     * class Levels extends Scene2D {
-     * 	override create(): void {}
-     * 	private level = 1;
-     * 	next(): void {
-     * 		this.transitionTo(() => this.load(++this.level), { transition: tileShrink({ columns: 8, rows: 5 }), duration: 0.6 });
-     * 	}
-     * 	private load(level: number): void {
-     * 		console.log('loading level', level);
-     * 	}
-     * }
-     * ```
-     */
-    transitionTo(swap: () => void, options: TransitionOptions): void;
-    protected teardown(): void;
-}
-export type Scene2DClass = new () => Scene2D;
-//# sourceMappingURL=Scene2D.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Scene2D.d.ts","sourceRoot":"","sources":["../../src/two-d/Scene2D.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE;;;;;;;;;GASG;AACH,8BAAsB,OAAQ,SAAQ,KAAK;IAC1C,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAmB;IAE9C;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAI/D;IAED,UAAmB,QAAQ,IAAI,IAAI,CAElC;CACD;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,OAAO,CAAC"}

package/dist/two-d/Scene2D.js

@@ -1,53 +0,0 @@
-import { Container } from 'pixi.js';
-import { Scene } from '../core/Scene.js';
-import { Game } from './Game.js';
-/**
- * A scene that draws through Pixi: `core.Scene`'s lifecycle plus the container everything
- * this screen shows hangs off.
- *
- * This is what a 2D game extends. The container is destroyed with the scene, so a scene may
- * add whatever it likes to `stage` without tracking it for cleanup. The base class holds the
- * lifecycle alone precisely so that `core.SceneStack` can drive a Babylon scene just as well
- * as this one - the stack calls `create`, `resize`, `onSuspend`, `onResume` and `destroy`,
- * and never touches `stage`.
- */
-export class Scene2D extends Scene {
-    constructor() {
-        super(...arguments);
-        /** everything this scene draws hangs off here */
-        this.stage = new Container();
-    }
-    /**
-     * Replaces what this scene shows under a transition: the current picture is photographed, `swap`
-     * changes the content (a new level, decor, layout), and the transition plays over the result.
-     * Without a running `Game` (a test) `swap` just runs.
-     *
-     * @example
-     * ```ts
-     * import { Scene2D } from '@datamoc/mw_games/two-d';
-     * import { tileShrink } from '@datamoc/mw_games/two-d/render';
-     *
-     * class Levels extends Scene2D {
-     * 	override create(): void {}
-     * 	private level = 1;
-     * 	next(): void {
-     * 		this.transitionTo(() => this.load(++this.level), { transition: tileShrink({ columns: 8, rows: 5 }), duration: 0.6 });
-     * 	}
-     * 	private load(level: number): void {
-     * 		console.log('loading level', level);
-     * 	}
-     * }
-     * ```
-     */
-    transitionTo(swap, options) {
-        const game = Game.active;
-        if (game)
-            game.transition(swap, options);
-        else
-            swap();
-    }
-    teardown() {
-        this.stage.destroy({ children: true });
-    }
-}
-//# sourceMappingURL=Scene2D.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Scene2D.js","sourceRoot":"","sources":["../../src/two-d/Scene2D.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC;;;;;;;;;GASG;AACH,MAAM,OAAgB,OAAQ,SAAQ,KAAK;IAA3C;;QACC,iDAAiD;QACxC,UAAK,GAAgB,IAAI,SAAS,EAAE,CAAC;IAiC/C,CAAC;IA/BA;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,YAAY,CAAC,IAAgB,EAAE,OAA0B;QACxD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,IAAI,IAAI;YAAE,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;;YACpC,IAAI,EAAE,CAAC;IACb,CAAC;IAEkB,QAAQ;QAC1B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;CACD"}

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

@@ -1,22 +0,0 @@
-/**
- * Everything that draws in 2D, through PixiJS.
- *
- * The counterpart to `mwg/3d`, and the reason `mwg/core` needs no renderer: `Game` owns the
- * Pixi `Application` and the frame loop, `Scene2D` adds a display container to `core.Scene`'s
- * renderer-free lifecycle, and `render`, `ui` and `stage` live underneath here because every
- * one of them is Pixi from top to bottom.
- *
- * This barrel is the one-stop 2D import. The granular subpaths still exist and are what a
- * game concerned with bundle size should reach for: `mwg/two-d/render`, `mwg/two-d/ui`,
- * `mwg/two-d/stage`.
- */
-export { Game } from './Game.ts';
-export type { GameOptions, AudioSuspendRig } from './Game.ts';
-export { QualityScaler } from './QualityScaler.ts';
-export type { QualityScalerOptions } from './QualityScaler.ts';
-export { Scene2D } from './Scene2D.ts';
-export type { Scene2DClass } from './Scene2D.ts';
-export * from './render/index.ts';
-export * from './ui/index.ts';
-export * from './stage/index.ts';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/two-d/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC"}

package/dist/two-d/index.js

@@ -1,19 +0,0 @@
-/**
- * Everything that draws in 2D, through PixiJS.
- *
- * The counterpart to `mwg/3d`, and the reason `mwg/core` needs no renderer: `Game` owns the
- * Pixi `Application` and the frame loop, `Scene2D` adds a display container to `core.Scene`'s
- * renderer-free lifecycle, and `render`, `ui` and `stage` live underneath here because every
- * one of them is Pixi from top to bottom.
- *
- * This barrel is the one-stop 2D import. The granular subpaths still exist and are what a
- * game concerned with bundle size should reach for: `mwg/two-d/render`, `mwg/two-d/ui`,
- * `mwg/two-d/stage`.
- */
-export { Game } from './Game.js';
-export { QualityScaler } from './QualityScaler.js';
-export { Scene2D } from './Scene2D.js';
-export * from './render/index.js';
-export * from './ui/index.js';
-export * from './stage/index.js';
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/two-d/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC"}

package/dist/two-d/pixi-interop.d.ts

@@ -1,66 +0,0 @@
-/**
- * Explicit, exceptional backend access.
- *
- * A normal 2D game should never need this: `two-d`'s own facade (`Container2D`, `Texture2D`,
- * `Sprite2D`/`Shape2D`/`Text2D`/`TiledSprite`/`Gradient`, `AnimatedSprite`/`TintedSprite`,
- * `NinePatch`, `SpriteSheet`) covers ordinary needs without naming a `pixi.js` type. This
- * module exists for the rare case where a game needs a Pixi-specific effect the facade does
- * not cover yet - importing from here rather than from `pixi.js` directly keeps that
- * dependency visible and confined to one file, instead of spreading `pixi.js` imports through
- * the game's own source. `FillGradient`/`TilingSprite` join the original four here for the
- * same reason `render.Gradient`/`TiledSprite` name them at the facade level (item 293).
- *
- * On the pipe-registration question item 293 also raised (and item 297 named the two symbols
- * that still had no facade name): `TilingSprite` and `NineSliceSprite` (`ui.NinePatch`'s own
- * backing class) both need their renderer pipe registered before use, the same way
- * `TintedSprite`'s colour-transform pipe does. This project's own build never has to call
- * `registerBuiltinPipes` itself, because it imports the full `pixi.js` package everywhere
- * (never a slimmed custom bundle) and that package registers every built-in pipe,
- * `TilingSpritePipe`/`NineSliceSpritePipe` included, as a side effect of the import itself -
- * but that guarantee is `pixi.js`'s own `package.json` `sideEffects` list surviving whatever
- * bundler and tree-shaking configuration the *consumer* uses, not a universal one, and the
- * port whose build tree-shook a pipe away is exactly the case this function is for.
- *
- * Facade-gap accounting (P31): every primitive below already has a facade family, so no new
- * facade coverage was needed - what stays interop-only is the Pixi-typed seam each note
- * names, and a consumer budget justifies a use by pointing at the note instead of merely
- * counting the import.
- *
- * @example
- * ```ts
- * import { registerBuiltinPipes, TilingSprite } from '@datamoc/mw_games/two-d/pixi-interop';
- *
- * // only needed if a game's own bundler configuration tree-shook TilingSpritePipe/
- * // NineSliceSpritePipe away; call before the renderer is created
- * registerBuiltinPipes();
- * const backdrop = new TilingSprite({ texture: undefined as never, width: 100, height: 100 });
- * ```
- */
-/** Interop-only: the unadorned scene-graph node behind facade `Container2D`/`Node2D`. The facade subclasses it rather than wrapping it, so a value that never needed the subclass - or a Pixi API typed against the base - still names this. */
-export { Container } from 'pixi.js';
-/** Interop-only: the textured quad behind facade `Sprite2D`/`TintedSprite`/`AnimatedSprite`. Same subclass relationship: reach for this for Pixi sprite behaviour the facade subclasses do not model, not for an ordinary positioned image. */
-export { Sprite } from 'pixi.js';
-/** Interop-only: the GPU image behind facade `Texture2D`/`TextureRegion`. `TextureRegion` still carries one in its `texture` slot, and Pixi constructors (sprites, tilings, nine-slices, render textures) take one - that slot is the seam. */
-export { Texture } from 'pixi.js';
-/** Interop-only: the vector canvas behind facade `Shape2D`. `Shape2D` extends this with the game's fill/stroke vocabulary; a `Graphics` program outside that vocabulary stays here. */
-export { Graphics } from 'pixi.js';
-/** Interop-only: the Pixi rect behind facade `Rect`. Atlas frames, bounds and hit areas arrive as one; `render.rectOf` converts it to a plain `Rect` at the boundary, and code that hands a rect straight back to Pixi keeps this. */
-export { Rectangle } from 'pixi.js';
-/** Interop-only: the text node behind facade `Text2D`. Same subclass relationship as `Sprite`: ordinary labels are `Text2D`; Pixi text behaviour the facade does not model stays here. */
-export { Text } from 'pixi.js';
-/** Interop-only: the gradient behind facade `Gradient` (which is this, aliased). `Shape2D.fill`/`.stroke` accept it directly, so most gradient work never imports it; direct construction of a gradient object does. */
-export { FillGradient } from 'pixi.js';
-/** Interop-only: the repeating texture behind facade `TiledSprite`. `TiledSprite` extends this; tiling behaviour outside the facade's repeat/offset surface stays here (and needs `registerBuiltinPipes` in a tree-shaken build, below). */
-export { TilingSprite } from 'pixi.js';
-/** Interop-only: renderer pipes, not scene content. Only needed when a consumer bundler tree-shook them away; see `registerBuiltinPipes`. */
-export { TilingSpritePipe, NineSliceSpritePipe } from 'pixi.js';
-/** The Pixi sprite construction options, for the rare hand-built interop sprite above. */
-export type { SpriteOptions } from 'pixi.js';
-/**
- * Registers `TilingSpritePipe`/`NineSliceSpritePipe` with Pixi, for a build whose bundler
- * tree-shook them away despite importing the full `pixi.js` package - see this module's own
- * doc comment for why that can happen even without a deliberately slimmed bundle. Idempotent;
- * a normal build never needs to call it.
- */
-export declare function registerBuiltinPipes(): void;
-//# sourceMappingURL=pixi-interop.d.ts.map

package/dist/two-d/pixi-interop.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pixi-interop.d.ts","sourceRoot":"","sources":["../../src/two-d/pixi-interop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,gPAAgP;AAChP,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,+OAA+O;AAC/O,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,+OAA+O;AAC/O,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,uLAAuL;AACvL,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,sOAAsO;AACtO,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,0LAA0L;AAC1L,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC/B,wNAAwN;AACxN,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,4OAA4O;AAC5O,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,6IAA6I;AAC7I,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAChE,0FAA0F;AAC1F,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAM7C;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAM3C"}

package/dist/two-d/pixi-interop.js

@@ -1,72 +0,0 @@
-/**
- * Explicit, exceptional backend access.
- *
- * A normal 2D game should never need this: `two-d`'s own facade (`Container2D`, `Texture2D`,
- * `Sprite2D`/`Shape2D`/`Text2D`/`TiledSprite`/`Gradient`, `AnimatedSprite`/`TintedSprite`,
- * `NinePatch`, `SpriteSheet`) covers ordinary needs without naming a `pixi.js` type. This
- * module exists for the rare case where a game needs a Pixi-specific effect the facade does
- * not cover yet - importing from here rather than from `pixi.js` directly keeps that
- * dependency visible and confined to one file, instead of spreading `pixi.js` imports through
- * the game's own source. `FillGradient`/`TilingSprite` join the original four here for the
- * same reason `render.Gradient`/`TiledSprite` name them at the facade level (item 293).
- *
- * On the pipe-registration question item 293 also raised (and item 297 named the two symbols
- * that still had no facade name): `TilingSprite` and `NineSliceSprite` (`ui.NinePatch`'s own
- * backing class) both need their renderer pipe registered before use, the same way
- * `TintedSprite`'s colour-transform pipe does. This project's own build never has to call
- * `registerBuiltinPipes` itself, because it imports the full `pixi.js` package everywhere
- * (never a slimmed custom bundle) and that package registers every built-in pipe,
- * `TilingSpritePipe`/`NineSliceSpritePipe` included, as a side effect of the import itself -
- * but that guarantee is `pixi.js`'s own `package.json` `sideEffects` list surviving whatever
- * bundler and tree-shaking configuration the *consumer* uses, not a universal one, and the
- * port whose build tree-shook a pipe away is exactly the case this function is for.
- *
- * Facade-gap accounting (P31): every primitive below already has a facade family, so no new
- * facade coverage was needed - what stays interop-only is the Pixi-typed seam each note
- * names, and a consumer budget justifies a use by pointing at the note instead of merely
- * counting the import.
- *
- * @example
- * ```ts
- * import { registerBuiltinPipes, TilingSprite } from '@datamoc/mw_games/two-d/pixi-interop';
- *
- * // only needed if a game's own bundler configuration tree-shook TilingSpritePipe/
- * // NineSliceSpritePipe away; call before the renderer is created
- * registerBuiltinPipes();
- * const backdrop = new TilingSprite({ texture: undefined as never, width: 100, height: 100 });
- * ```
- */
-/** Interop-only: the unadorned scene-graph node behind facade `Container2D`/`Node2D`. The facade subclasses it rather than wrapping it, so a value that never needed the subclass - or a Pixi API typed against the base - still names this. */
-export { Container } from 'pixi.js';
-/** Interop-only: the textured quad behind facade `Sprite2D`/`TintedSprite`/`AnimatedSprite`. Same subclass relationship: reach for this for Pixi sprite behaviour the facade subclasses do not model, not for an ordinary positioned image. */
-export { Sprite } from 'pixi.js';
-/** Interop-only: the GPU image behind facade `Texture2D`/`TextureRegion`. `TextureRegion` still carries one in its `texture` slot, and Pixi constructors (sprites, tilings, nine-slices, render textures) take one - that slot is the seam. */
-export { Texture } from 'pixi.js';
-/** Interop-only: the vector canvas behind facade `Shape2D`. `Shape2D` extends this with the game's fill/stroke vocabulary; a `Graphics` program outside that vocabulary stays here. */
-export { Graphics } from 'pixi.js';
-/** Interop-only: the Pixi rect behind facade `Rect`. Atlas frames, bounds and hit areas arrive as one; `render.rectOf` converts it to a plain `Rect` at the boundary, and code that hands a rect straight back to Pixi keeps this. */
-export { Rectangle } from 'pixi.js';
-/** Interop-only: the text node behind facade `Text2D`. Same subclass relationship as `Sprite`: ordinary labels are `Text2D`; Pixi text behaviour the facade does not model stays here. */
-export { Text } from 'pixi.js';
-/** Interop-only: the gradient behind facade `Gradient` (which is this, aliased). `Shape2D.fill`/`.stroke` accept it directly, so most gradient work never imports it; direct construction of a gradient object does. */
-export { FillGradient } from 'pixi.js';
-/** Interop-only: the repeating texture behind facade `TiledSprite`. `TiledSprite` extends this; tiling behaviour outside the facade's repeat/offset surface stays here (and needs `registerBuiltinPipes` in a tree-shaken build, below). */
-export { TilingSprite } from 'pixi.js';
-/** Interop-only: renderer pipes, not scene content. Only needed when a consumer bundler tree-shook them away; see `registerBuiltinPipes`. */
-export { TilingSpritePipe, NineSliceSpritePipe } from 'pixi.js';
-import { extensions, TilingSpritePipe, NineSliceSpritePipe } from 'pixi.js';
-let registered = false;
-/**
- * Registers `TilingSpritePipe`/`NineSliceSpritePipe` with Pixi, for a build whose bundler
- * tree-shook them away despite importing the full `pixi.js` package - see this module's own
- * doc comment for why that can happen even without a deliberately slimmed bundle. Idempotent;
- * a normal build never needs to call it.
- */
-export function registerBuiltinPipes() {
-    if (registered)
-        return;
-    registered = true;
-    extensions.add(TilingSpritePipe);
-    extensions.add(NineSliceSpritePipe);
-}
-//# sourceMappingURL=pixi-interop.js.map

package/dist/two-d/pixi-interop.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"pixi-interop.js","sourceRoot":"","sources":["../../src/two-d/pixi-interop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,gPAAgP;AAChP,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,+OAA+O;AAC/O,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,+OAA+O;AAC/O,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,uLAAuL;AACvL,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,sOAAsO;AACtO,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,0LAA0L;AAC1L,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC/B,wNAAwN;AACxN,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,4OAA4O;AAC5O,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,6IAA6I;AAC7I,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAIhE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE5E,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB;IACnC,IAAI,UAAU;QAAE,OAAO;IACvB,UAAU,GAAG,IAAI,CAAC;IAElB,UAAU,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACjC,UAAU,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AACrC,CAAC"}

package/dist/two-d/presentation/MwlPresentation.d.ts

@@ -1,117 +0,0 @@
-import { Container } from 'pixi.js';
-import { Camera } from '../render/Camera.ts';
-import { WindowStack } from '../ui/WindowStack.ts';
-import type { CompiledPresentation, PresentationItem, PresentationProperties, PresentationValue } from '../../mwl/presentation.ts';
-/** The game state a controller exposes each frame: a scalar per manifest value, or the rows of a collection. */
-export type PresentationState = Readonly<Record<string, PresentationValue | readonly PresentationItem[]>>;
-/**
- * What an adapter factory receives, and `restyle` again after a context switch: the effective theme `tokens` and the adapter node's own `properties`.
- */
-export interface PresentationAdapterContext {
-    readonly tokens: Readonly<Record<string, number>>;
-    readonly properties: PresentationProperties;
-}
-/** Runtime owns and destroys `view`; destroy detaches adapter-owned subscriptions/resources. */
-export interface PresentationAdapter {
-    readonly view: Container;
-    update?(dt: number, state: PresentationState): void;
-    resize?(width: number, height: number): void;
-    restyle?(context: PresentationAdapterContext): void;
-    destroy?(): void;
-}
-/**
- * Wiring for `MwlPresentation`. `state` is polled on every update; `actions` and `adapters` must cover every name the manifest declares or construction throws. `translate` maps message ids to display text (identity when omitted).
- */
-export interface PresentationRuntimeOptions {
-    readonly parent: Container;
-    readonly state: () => PresentationState;
-    readonly actions: Readonly<Record<string, (item?: PresentationItem) => void>>;
-    readonly adapters?: Readonly<Record<string, (context: PresentationAdapterContext) => PresentationAdapter>>;
-    readonly translate?: (message: string) => string;
-    /** Optional external notification; returned disposer is called at destruction. */
-    readonly subscribe?: (refresh: () => void) => () => void;
-}
-/**
- * Instantiates compiled MWL presentation using existing Pixi widgets. The controller owns state
- * and actions; context switches restyle the same views without rebuilding procedural adapters.
- * Kept off the root barrel so a game pays for this runtime only when it imports the subpath.
- *
- * @example
- * ```ts
- * import { MwlPresentation } from '@datamoc/mw_games/two-d/presentation';
- * import type { CompiledPresentation } from '@datamoc/mw_games/mwl/presentation';
- * import { Node2D } from '@datamoc/mw_games/two-d/render';
- * declare const data: CompiledPresentation;
- * const ui = new MwlPresentation(data, 'game', { parent: new Node2D(), state: () => ({}), actions: {} });
- * ui.resize(800, 600);
- * ui.update(1 / 60);
- * ui.destroy();
- * ```
- */
-export declare class MwlPresentation<Id extends string = string> {
-    private readonly data;
-    private readonly options;
-    readonly root: Container<import("pixi.js").ContainerChild>;
-    readonly windows: WindowStack;
-    readonly camera: Camera;
-    private readonly nodes;
-    private readonly roots;
-    private readonly baseTheme;
-    private readonly cameraProperties;
-    private readonly cameraPath;
-    private readonly previousTheme;
-    private appliedTheme;
-    private context;
-    private tokens;
-    private viewport;
-    private focused;
-    private destroyed;
-    private unsubscribe?;
-    private state;
-    private readonly inputListener;
-    constructor(data: CompiledPresentation, sceneId: string, options: PresentationRuntimeOptions);
-    /** Looks up an instance by its compiled path; repeats add their stable key to the path. */
-    get(id: Id): Container | null;
-    get focusId(): string | null;
-    get activeContext(): string;
-    get palette(): Readonly<Record<string, number>>;
-    setContext(context?: string): void;
-    private applyTheme;
-    update(dt?: number): void;
-    resize(width: number, height: number): void;
-    private createRecord;
-    private read;
-    private coerce;
-    private resolveProperties;
-    private refresh;
-    private refreshButton;
-    private readValues;
-    private viewOf;
-    private mount;
-    private wireButton;
-    private wireWindow;
-    private reconcile;
-    private token;
-    private applyProperties;
-    private isVisible;
-    private layout;
-    private layoutNode;
-    private measureNode;
-    private defaultHeight;
-    /** Positions visible children; returns the content height when the node sizes to fit. */
-    private placeChildren;
-    private paintNode;
-    private anchorNode;
-    private invoke;
-    private isFocusable;
-    private focusable;
-    private setFocus;
-    private navigate;
-    /** Offers modal windows input first, then the screen-space buttons. */
-    handleAction(action: string): boolean;
-    private unmount;
-    private dispose;
-    private assertAlive;
-    destroy(): void;
-}
-//# sourceMappingURL=MwlPresentation.d.ts.map

package/dist/two-d/presentation/MwlPresentation.d.ts.map

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