@datamoc/mw_games 0.36.1 → 0.38.0

package/dist/physics/PhysicsWorld.js

@@ -0,0 +1,137 @@
+import Matter from 'matter-js';
+import { FixedStepper } from '../core/FixedStepper.js';
+import { Signal } from '../core/Signal.js';
+/**
+ * Rigid bodies and constraints through matter-js, stepped on a fixed clock.
+ *
+ * The adapter is the framework side of using matter-js in a mwg game: it owns the `Engine`,
+ * steps it with a `FixedStepper` so the simulation is the same at any display refresh rate,
+ * and reports contacts through a `Signal`, while leaving the bodies themselves as plain
+ * matter-js objects a game reads `position` and `angle` from to place its sprites. It is
+ * renderer-free, so a game's headless tests can run the same world.
+ *
+ * `matter-js` is an optional peer dependency (`npm install matter-js`), imported only by this
+ * module (`@datamoc/mw_games/physics`), so a game that never simulates physics never bundles it.
+ * Constraints are springs and rods. Give one a `maxStretch` and it breaks when pulled that far
+ * past its rest length (`onBreak`); a game with a different stress rule reads `stretchOf` itself
+ * and calls `remove`.
+ *
+ * @example
+ * ```ts
+ * import { PhysicsWorld } from '@datamoc/mw_games/physics';
+ *
+ * const world = new PhysicsWorld();
+ * world.addBox(0, 300, 800, 20, { isStatic: true });
+ * const crate = world.addBox(100, 0, 40, 40, { restitution: 0.3 });
+ * world.update(1 / 30); // two fixed steps
+ * console.log(crate.position.y > 0); // true: it has started to fall
+ * ```
+ */
+export class PhysicsWorld {
+    constructor(options = {}) {
+        /** fires once per new contact between two bodies, with the matter-js bodies of the pair */
+        this.onContact = new Signal();
+        /** fires when a breakable constraint passes its `maxStretch`; it is already removed from the world */
+        this.onBreak = new Signal();
+        this.breakable = new Map();
+        this.engine = Matter.Engine.create();
+        const gravity = options.gravity ?? { x: 0, y: 9.8 };
+        //matter's gravity is a direction times `scale`; 9.8 maps to its own default scale of 0.001
+        this.engine.gravity.x = Math.sign(gravity.x);
+        this.engine.gravity.y = Math.sign(gravity.y);
+        this.engine.gravity.scale = Math.max(Math.abs(gravity.x), Math.abs(gravity.y)) * 0.0001;
+        this.stepper = new FixedStepper(options.step ?? 1 / 60, options.maxSubsteps ?? 5);
+        Matter.Events.on(this.engine, 'collisionStart', (event) => {
+            for (const pair of event.pairs)
+                this.onContact.dispatch({ a: pair.bodyA, b: pair.bodyB });
+        });
+    }
+    get bodies() {
+        return Matter.Composite.allBodies(this.engine.world);
+    }
+    get constraints() {
+        return Matter.Composite.allConstraints(this.engine.world);
+    }
+    /** how far into the next fixed step the clock is, 0 to 1, for interpolated drawing */
+    get alpha() {
+        return this.stepper.alpha;
+    }
+    /** a box centred on (x, y) */
+    addBox(x, y, width, height, options = {}) {
+        return this.add(Matter.Bodies.rectangle(x, y, width, height, options));
+    }
+    addCircle(x, y, radius, options = {}) {
+        return this.add(Matter.Bodies.circle(x, y, radius, options));
+    }
+    /** joins two bodies, or a body to a fixed point in the world when `b` is a point */
+    addConstraint(a, b, options = {}) {
+        const isBody = (value) => 'position' in value;
+        const constraint = Matter.Constraint.create({
+            bodyA: a,
+            ...(isBody(b) ? { bodyB: b } : { pointB: b }),
+            ...(options.pointA ? { pointA: options.pointA } : {}),
+            ...(isBody(b) && options.pointB ? { pointB: options.pointB } : {}),
+            stiffness: options.stiffness ?? 1,
+            damping: options.damping ?? 0,
+            ...(options.length !== undefined ? { length: options.length } : {}),
+        });
+        Matter.Composite.add(this.engine.world, constraint);
+        if (options.maxStretch !== undefined)
+            this.breakable.set(constraint, options.maxStretch);
+        return constraint;
+    }
+    /** removes a body, or a constraint, from the simulation */
+    remove(item) {
+        Matter.Composite.remove(this.engine.world, item);
+        this.breakable.delete(item);
+    }
+    /**
+     * How far a constraint is stretched past its rest length, as a fraction of it (0.1 is 10%
+     * longer); for a zero-length joint, the distance between its ends. Negative when compressed.
+     */
+    stretchOf(constraint) {
+        const a = endPoint(constraint.bodyA, constraint.pointA);
+        const b = endPoint(constraint.bodyB, constraint.pointB);
+        const distance = Math.hypot(a.x - b.x, a.y - b.y);
+        return constraint.length > 0 ? distance / constraint.length - 1 : distance;
+    }
+    /**
+     * Advances the simulation by `dt` seconds of real time, running as many fixed steps as that
+     * covers; call it from `Scene.update(dt)`.
+     *
+     * @returns how many fixed steps ran
+     */
+    update(dt) {
+        return this.stepper.advance(dt, (step) => {
+            Matter.Engine.update(this.engine, step * 1000);
+            this.breakOverstretched();
+        });
+    }
+    breakOverstretched() {
+        //collected first: removing while iterating the map would skip entries
+        const snapped = [];
+        for (const [constraint, limit] of this.breakable) {
+            const stretch = this.stretchOf(constraint);
+            if (stretch > limit)
+                snapped.push([constraint, stretch]);
+        }
+        for (const [constraint, stretch] of snapped) {
+            this.remove(constraint);
+            this.onBreak.dispatch({ constraint, stretch });
+        }
+    }
+    add(body) {
+        Matter.Composite.add(this.engine.world, body);
+        return body;
+    }
+}
+/** a constraint end in world space: the body's attachment point turned and moved with it, or the fixed point itself */
+function endPoint(body, point) {
+    const local = point ?? { x: 0, y: 0 };
+    if (!body)
+        return local;
+    const cos = Math.cos(body.angle);
+    const sin = Math.sin(body.angle);
+    return { x: body.position.x + local.x * cos - local.y * sin, y: body.position.y + local.x * sin + local.y * cos };
+}
+//# sourceMappingURL=PhysicsWorld.js.map

package/dist/physics/PhysicsWorld.js.map

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

package/dist/physics/XpbdWorld.d.ts

@@ -0,0 +1,139 @@
+import { Signal } from '../core/Signal.ts';
+export interface XpbdOptions {
+    /** downward acceleration in units per second squared; 520 when omitted (a 1-unit-per-pixel scale) */
+    gravity?: number;
+    /** substeps per `step`; 16 when omitted. More is stiffer and steadier, and costs linearly */
+    substeps?: number;
+    /** constraint iterations per substep; 2 when omitted */
+    iterations?: number;
+    /** the frame time one `step` advances, in seconds; 1/60 when omitted */
+    step?: number;
+    /** velocity damping per second (exponential); 2.5 when omitted. Raise it while a structure settles */
+    damping?: number;
+    /** time constant of the load smoothing used for breaking, in seconds; 0.06 when omitted */
+    smoothing?: number;
+    /** how much of a node's sideways motion the ground removes while it touches, 0 to 1; 0.5 when omitted */
+    groundFriction?: number;
+}
+/** the ground a node cannot sink below: a height (y grows downward), or a height at each x */
+export type XpbdGround = number | ((x: number) => number);
+export interface XpbdNodeSpec {
+    x: number;
+    y: number;
+    /** an anchor that never moves */
+    fixed?: boolean;
+    /** point mass; 1 when omitted. Link `mass` is added on top */
+    mass?: number;
+}
+export interface XpbdLinkSpec {
+    a: number;
+    b: number;
+    /** spring stiffness: force per unit of stretch ratio. Higher is more rigid */
+    stiffness: number;
+    /** rest length; the current distance between the nodes when omitted */
+    rest?: number;
+    /** mass of the link itself, shared evenly between its two nodes */
+    mass?: number;
+    /** a cable: pulls when stretched and goes slack, without pushing, when compressed */
+    tensionOnly?: boolean;
+    /** the load it carries in compression before breaking; also in tension unless `tensionStrength` is set. Unbreakable when omitted */
+    strength?: number;
+    /** the load it carries in tension before breaking, when that differs from `strength` */
+    tensionStrength?: number;
+}
+export interface XpbdNode {
+    x: number;
+    y: number;
+    fixed: boolean;
+    vx: number;
+    vy: number;
+    /** inverse mass, 0 for a fixed node */
+    w: number;
+}
+export interface XpbdLink {
+    a: number;
+    b: number;
+    stiffness: number;
+    rest: number;
+    tensionOnly: boolean;
+    strength: number | undefined;
+    tensionStrength: number | undefined;
+    broken: boolean;
+    /** the force it carried over the last step, positive in tension, negative in compression */
+    force: number;
+    /** smoothed load as a fraction of what it can carry; it breaks above 1 */
+    ratio: number;
+}
+/**
+ * A deterministic structure solver: point masses joined by springs, solved with extended
+ * position-based dynamics (XPBD), with the force in every link read back so a link can break
+ * at a real load rather than at a stretch.
+ *
+ * The method (Macklin, Muller and Chentanaput's XPBD) moves each node freely for a substep,
+ * then corrects positions so every link returns to its rest length, with a compliance of
+ * `rest / stiffness / dt^2`: a link behaves as a spring of the stated stiffness whatever the
+ * step or iteration count, and the correction's Lagrange multiplier divided by `dt^2` is the
+ * force it carried. Steps are fixed and nothing is random, so the same structure and the same
+ * calls give the same result on every machine, which is what replaying or validating a
+ * player's bridge needs.
+ *
+ * It is the engine of Pontifex (a bridge-building game), generalised: the vehicle, the water
+ * and the levels stay in the game, and what is here is only nodes, links, forces and breaking.
+ * Unlike `PhysicsWorld` it has no rigid bodies or collisions and no `matter-js` dependency.
+ *
+ * @example
+ * ```ts
+ * import { XpbdWorld } from '@datamoc/mw_games/physics/xpbd';
+ *
+ * const world = new XpbdWorld({ gravity: 520 });
+ * const wall = world.addNode({ x: 0, y: 0, fixed: true });
+ * const weight = world.addNode({ x: 40, y: 0, mass: 1 });
+ * const rope = world.addLink({ a: wall, b: weight, stiffness: 2e4, strength: 900 });
+ * world.breaking = true;
+ * for (let i = 0; i < 120; i++) world.step();
+ * console.log(world.links[rope].broken, world.nodes[weight].y > 0);
+ * ```
+ */
+export declare class XpbdWorld {
+    readonly nodes: XpbdNode[];
+    readonly links: XpbdLink[];
+    /** fires once for a link that passed its strength, which has already stopped carrying load */
+    readonly onBreak: Signal<{
+        link: number;
+        x: number;
+        y: number;
+    }>;
+    /** links break only while this is true, so a structure can settle under its own weight first */
+    breaking: boolean;
+    /** the highest smoothed load ratio across the links at the last step, for a strain gauge */
+    peakRatio: number;
+    gravity: number;
+    damping: number;
+    /** nodes are held on or above this; null for none. Water, a gorge or a cliff face is the game's own business */
+    ground: XpbdGround | null;
+    groundFriction: number;
+    private readonly frame;
+    private readonly substeps;
+    private readonly iterations;
+    private readonly smoothing;
+    private readonly forces;
+    private readonly masses;
+    private readonly lambda;
+    private readonly accumulated;
+    constructor(options?: XpbdOptions);
+    /** adds a node and returns its index */
+    addNode(spec: XpbdNodeSpec): number;
+    /** adds a link between two existing nodes and returns its index */
+    addLink(spec: XpbdLinkSpec): number;
+    /** an external force on a node for the next `step` only (a wheel's weight, wind) */
+    applyForce(node: number, fx: number, fy: number): void;
+    /** advances one frame: the substeps, then the link loads and any breaking */
+    step(): void;
+    private refreshInverseMass;
+    private substep;
+    /** lifts any node that sank below the ground back onto it, and takes some of its sideways motion with it */
+    private collideWithGround;
+    /** averages each link's force over the substeps, smooths the load ratio and breaks what passed its strength */
+    private settleLoads;
+}
+//# sourceMappingURL=XpbdWorld.d.ts.map

package/dist/physics/XpbdWorld.d.ts.map

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

package/dist/physics/XpbdWorld.js

@@ -0,0 +1,207 @@
+import { Signal } from '../core/Signal.js';
+/**
+ * A deterministic structure solver: point masses joined by springs, solved with extended
+ * position-based dynamics (XPBD), with the force in every link read back so a link can break
+ * at a real load rather than at a stretch.
+ *
+ * The method (Macklin, Muller and Chentanaput's XPBD) moves each node freely for a substep,
+ * then corrects positions so every link returns to its rest length, with a compliance of
+ * `rest / stiffness / dt^2`: a link behaves as a spring of the stated stiffness whatever the
+ * step or iteration count, and the correction's Lagrange multiplier divided by `dt^2` is the
+ * force it carried. Steps are fixed and nothing is random, so the same structure and the same
+ * calls give the same result on every machine, which is what replaying or validating a
+ * player's bridge needs.
+ *
+ * It is the engine of Pontifex (a bridge-building game), generalised: the vehicle, the water
+ * and the levels stay in the game, and what is here is only nodes, links, forces and breaking.
+ * Unlike `PhysicsWorld` it has no rigid bodies or collisions and no `matter-js` dependency.
+ *
+ * @example
+ * ```ts
+ * import { XpbdWorld } from '@datamoc/mw_games/physics/xpbd';
+ *
+ * const world = new XpbdWorld({ gravity: 520 });
+ * const wall = world.addNode({ x: 0, y: 0, fixed: true });
+ * const weight = world.addNode({ x: 40, y: 0, mass: 1 });
+ * const rope = world.addLink({ a: wall, b: weight, stiffness: 2e4, strength: 900 });
+ * world.breaking = true;
+ * for (let i = 0; i < 120; i++) world.step();
+ * console.log(world.links[rope].broken, world.nodes[weight].y > 0);
+ * ```
+ */
+export class XpbdWorld {
+    constructor(options = {}) {
+        this.nodes = [];
+        this.links = [];
+        /** fires once for a link that passed its strength, which has already stopped carrying load */
+        this.onBreak = new Signal();
+        /** links break only while this is true, so a structure can settle under its own weight first */
+        this.breaking = false;
+        /** the highest smoothed load ratio across the links at the last step, for a strain gauge */
+        this.peakRatio = 0;
+        /** nodes are held on or above this; null for none. Water, a gorge or a cliff face is the game's own business */
+        this.ground = null;
+        this.forces = [];
+        this.masses = [];
+        this.lambda = [];
+        this.accumulated = [];
+        this.gravity = options.gravity ?? 520;
+        this.damping = options.damping ?? 2.5;
+        this.groundFriction = options.groundFriction ?? 0.5;
+        this.frame = options.step ?? 1 / 60;
+        this.substeps = Math.max(1, Math.floor(options.substeps ?? 16));
+        this.iterations = Math.max(1, Math.floor(options.iterations ?? 2));
+        this.smoothing = options.smoothing ?? 0.06;
+    }
+    /** adds a node and returns its index */
+    addNode(spec) {
+        const mass = spec.mass ?? 1;
+        if (!(mass > 0) && !spec.fixed)
+            throw new Error('a moving node needs a positive mass');
+        this.nodes.push({ x: spec.x, y: spec.y, fixed: spec.fixed ?? false, vx: 0, vy: 0, w: 0 });
+        this.masses.push(mass);
+        this.forces.push({ x: 0, y: 0 });
+        this.refreshInverseMass();
+        return this.nodes.length - 1;
+    }
+    /** adds a link between two existing nodes and returns its index */
+    addLink(spec) {
+        const a = this.nodes[spec.a];
+        const b = this.nodes[spec.b];
+        if (!a || !b)
+            throw new Error('a link needs two existing nodes');
+        const rest = spec.rest ?? Math.hypot(a.x - b.x, a.y - b.y);
+        if (!(rest > 0))
+            throw new Error('a link needs a positive rest length');
+        if (!(spec.stiffness > 0))
+            throw new Error('a link needs a positive stiffness');
+        const share = (spec.mass ?? 0) / 2;
+        this.masses[spec.a] += share;
+        this.masses[spec.b] += share;
+        this.links.push({
+            a: spec.a,
+            b: spec.b,
+            stiffness: spec.stiffness,
+            rest,
+            tensionOnly: spec.tensionOnly ?? false,
+            strength: spec.strength,
+            tensionStrength: spec.tensionStrength,
+            broken: false,
+            force: 0,
+            ratio: 0,
+        });
+        this.lambda.push(0);
+        this.accumulated.push(0);
+        this.refreshInverseMass();
+        return this.links.length - 1;
+    }
+    /** an external force on a node for the next `step` only (a wheel's weight, wind) */
+    applyForce(node, fx, fy) {
+        this.forces[node].x += fx;
+        this.forces[node].y += fy;
+    }
+    /** advances one frame: the substeps, then the link loads and any breaking */
+    step() {
+        const dt = this.frame / this.substeps;
+        this.accumulated.fill(0);
+        for (let s = 0; s < this.substeps; s++)
+            this.substep(dt);
+        for (const force of this.forces) {
+            force.x = 0;
+            force.y = 0;
+        }
+        this.settleLoads();
+    }
+    refreshInverseMass() {
+        this.nodes.forEach((node, i) => {
+            node.w = node.fixed ? 0 : 1 / this.masses[i];
+        });
+    }
+    substep(dt) {
+        const damp = Math.exp(-this.damping * dt);
+        const previous = this.nodes.map((node) => ({ x: node.x, y: node.y }));
+        this.nodes.forEach((node, i) => {
+            if (node.fixed)
+                return;
+            const force = this.forces[i];
+            node.vx = (node.vx + force.x * node.w * dt) * damp;
+            node.vy = (node.vy + (force.y * node.w + this.gravity) * dt) * damp;
+            node.x += node.vx * dt;
+            node.y += node.vy * dt;
+        });
+        this.lambda.fill(0);
+        for (let iteration = 0; iteration < this.iterations; iteration++) {
+            this.links.forEach((link, i) => {
+                if (link.broken)
+                    return;
+                const p = this.nodes[link.a];
+                const q = this.nodes[link.b];
+                const w = p.w + q.w;
+                if (w === 0)
+                    return;
+                const dx = q.x - p.x;
+                const dy = q.y - p.y;
+                const length = Math.hypot(dx, dy) || 1e-9;
+                const c = length - link.rest;
+                if (link.tensionOnly && c < 0 && this.lambda[i] >= 0)
+                    return;
+                const alpha = link.rest / link.stiffness / (dt * dt);
+                const delta = (-c - alpha * this.lambda[i]) / (w + alpha);
+                this.lambda[i] += delta;
+                const nx = dx / length;
+                const ny = dy / length;
+                p.x -= p.w * delta * nx;
+                p.y -= p.w * delta * ny;
+                q.x += q.w * delta * nx;
+                q.y += q.w * delta * ny;
+            });
+        }
+        this.collideWithGround(previous);
+        this.nodes.forEach((node, i) => {
+            if (node.fixed)
+                return;
+            node.vx = (node.x - previous[i].x) / dt;
+            node.vy = (node.y - previous[i].y) / dt;
+        });
+        this.links.forEach((_, i) => {
+            this.accumulated[i] += -this.lambda[i] / (dt * dt);
+        });
+    }
+    /** lifts any node that sank below the ground back onto it, and takes some of its sideways motion with it */
+    collideWithGround(previous) {
+        const ground = this.ground;
+        if (ground === null)
+            return;
+        this.nodes.forEach((node, i) => {
+            if (node.fixed)
+                return;
+            const surface = typeof ground === 'number' ? ground : ground(node.x);
+            if (node.y <= surface)
+                return;
+            node.y = surface;
+            node.x -= (node.x - previous[i].x) * this.groundFriction;
+        });
+    }
+    /** averages each link's force over the substeps, smooths the load ratio and breaks what passed its strength */
+    settleLoads() {
+        const blend = 1 - Math.exp(-this.frame / this.smoothing);
+        let peak = 0;
+        this.links.forEach((link, i) => {
+            if (link.broken)
+                return;
+            link.force = this.accumulated[i] / this.substeps;
+            const limit = link.force > 0 ? (link.tensionStrength ?? link.strength) : link.strength;
+            const instant = limit === undefined ? 0 : Math.abs(link.force) / limit;
+            link.ratio += (instant - link.ratio) * blend;
+            peak = Math.max(peak, link.ratio);
+            if (this.breaking && link.ratio > 1) {
+                link.broken = true;
+                const p = this.nodes[link.a];
+                const q = this.nodes[link.b];
+                this.onBreak.dispatch({ link: i, x: (p.x + q.x) / 2, y: (p.y + q.y) / 2 });
+            }
+        });
+        this.peakRatio = peak;
+    }
+}
+//# sourceMappingURL=XpbdWorld.js.map

package/dist/physics/XpbdWorld.js.map

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

package/dist/physics/index.d.ts

@@ -0,0 +1,3 @@
+export { PhysicsWorld } from './PhysicsWorld.ts';
+export type { BodyOptions, ConstraintOptions, PhysicsBody, PhysicsConstraint, PhysicsOptions } from './PhysicsWorld.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/physics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/physics/index.js

@@ -0,0 +1,2 @@
+export { PhysicsWorld } from './PhysicsWorld.js';
+//# sourceMappingURL=index.js.map

package/dist/physics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/physics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/physics/xpbd.d.ts

@@ -0,0 +1,3 @@
+export { XpbdWorld } from './XpbdWorld.ts';
+export type { XpbdGround, XpbdLink, XpbdLinkSpec, XpbdNode, XpbdNodeSpec, XpbdOptions } from './XpbdWorld.ts';
+//# sourceMappingURL=xpbd.d.ts.map

package/dist/physics/xpbd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xpbd.d.ts","sourceRoot":"","sources":["../../src/physics/xpbd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/physics/xpbd.js

@@ -0,0 +1,2 @@
+export { XpbdWorld } from './XpbdWorld.js';
+//# sourceMappingURL=xpbd.js.map

package/dist/physics/xpbd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xpbd.js","sourceRoot":"","sources":["../../src/physics/xpbd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

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

@@ -0,0 +1,98 @@
+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';
+export type PresentationState = Readonly<Record<string, PresentationValue | readonly PresentationItem[]>>;
+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;
+}
+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 mount;
+    private reconcile;
+    private token;
+    private applyProperties;
+    private layout;
+    private layoutNode;
+    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