@datamoc/mw_games 0.38.0 → 0.40.0

package/dist/two-d/render/SpringSprite.d.ts

@@ -0,0 +1,40 @@
+import { Graphics } from 'pixi.js';
+import type { Spring } from '../../physics/spring/index.ts';
+export interface SpringSpriteOptions {
+    /** the spring to draw */
+    spring: Spring;
+    /** line colour */
+    color?: number;
+    /** line opacity */
+    alpha?: number;
+    /** line width */
+    lineWidth?: number;
+}
+/**
+ * A debug line from a spring's anchor to its bob: one straight segment that stretches,
+ * overshoots and settles with the simulation. A game draws hair or hems by placing its
+ * own sprites with `Spring.place`, and keeps this around while tuning stiffness and
+ * damping. Call `sync` after stepping the spring; the line never steps anything itself.
+ *
+ * @example
+ * ```ts
+ * import { Spring } from '@datamoc/mw_games/physics';
+ * import { SpringSprite } from '@datamoc/mw_games/two-d/render';
+ *
+ * const spring = new Spring({ stiffness: 120, damping: 8 });
+ * const line = new SpringSprite({ spring });
+ * spring.setAnchor(10, 0);
+ * spring.update(1 / 60);
+ * line.sync(); // the segment now leans toward the anchor
+ * ```
+ */
+export declare class SpringSprite extends Graphics {
+    private readonly spring;
+    private readonly color;
+    private readonly opacity;
+    private readonly lineWidth;
+    constructor(options: SpringSpriteOptions);
+    /** redraw the anchor-to-bob segment from the spring's current state */
+    sync(): void;
+}
+//# sourceMappingURL=SpringSprite.d.ts.map

package/dist/two-d/render/SpringSprite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpringSprite.d.ts","sourceRoot":"","sources":["../../../src/two-d/render/SpringSprite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAE5D,MAAM,WAAW,mBAAmB;IACnC,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,YAAa,SAAQ,QAAQ;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,YAAY,OAAO,EAAE,mBAAmB,EAOvC;IAED,uEAAuE;IACvE,IAAI,IAAI,IAAI,CAOX;CACD"}

package/dist/two-d/render/SpringSprite.js

@@ -0,0 +1,39 @@
+import { Graphics } from 'pixi.js';
+/**
+ * A debug line from a spring's anchor to its bob: one straight segment that stretches,
+ * overshoots and settles with the simulation. A game draws hair or hems by placing its
+ * own sprites with `Spring.place`, and keeps this around while tuning stiffness and
+ * damping. Call `sync` after stepping the spring; the line never steps anything itself.
+ *
+ * @example
+ * ```ts
+ * import { Spring } from '@datamoc/mw_games/physics';
+ * import { SpringSprite } from '@datamoc/mw_games/two-d/render';
+ *
+ * const spring = new Spring({ stiffness: 120, damping: 8 });
+ * const line = new SpringSprite({ spring });
+ * spring.setAnchor(10, 0);
+ * spring.update(1 / 60);
+ * line.sync(); // the segment now leans toward the anchor
+ * ```
+ */
+export class SpringSprite extends Graphics {
+    constructor(options) {
+        super();
+        this.spring = options.spring;
+        this.color = options.color ?? 0xffffff;
+        this.opacity = options.alpha ?? 1;
+        this.lineWidth = options.lineWidth ?? 2;
+        this.sync();
+    }
+    /** redraw the anchor-to-bob segment from the spring's current state */
+    sync() {
+        const anchor = this.spring.anchorPosition;
+        const bob = this.spring.position;
+        this.clear();
+        this.moveTo(anchor.x, anchor.y)
+            .lineTo(bob.x, bob.y)
+            .stroke({ color: this.color, width: this.lineWidth, alpha: this.opacity });
+    }
+}
+//# sourceMappingURL=SpringSprite.js.map

package/dist/two-d/render/SpringSprite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpringSprite.js","sourceRoot":"","sources":["../../../src/two-d/render/SpringSprite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAcnC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,YAAa,SAAQ,QAAQ;IAMzC,YAAY,OAA4B;QACvC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,EAAE,CAAC;IACb,CAAC;IAED,uEAAuE;IACvE,IAAI;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;QAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;aAC7B,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;aACpB,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;CACD"}

package/dist/two-d/render/SpriteDeform.d.ts

@@ -0,0 +1,156 @@
+import { MeshPlane } from 'pixi.js';
+import type { Texture2D } from './Types2D.ts';
+/** A single control point on a deformation grid, in local pixels. */
+export interface DeformPoint {
+    x: number;
+    y: number;
+}
+/** Grid dimensions and rest size for {@link PinnedDeform}. */
+export interface PinnedDeformOptions {
+    /** control points across; an integer of at least 2 */
+    columns: number;
+    /** control points down; an integer of at least 2 */
+    rows: number;
+    /** rest width in local pixels; must be finite and above 0 */
+    width: number;
+    /** rest height in local pixels; must be finite and above 0 */
+    height: number;
+}
+/**
+ * A pinned-point deformation grid: the renderer-free math behind roadmap item 414.
+ *
+ * The grid holds `columns * rows` control points over a `width * height` rest
+ * rectangle. Every point stays exactly at its rest position until the game drags
+ * it with {@link PinnedDeform.drag} (or {@link PinnedDeform.nudge}); there is no
+ * falloff onto neighbours, no smoothing pass and no whole-sprite rotation, so a
+ * Pontifex wingtip can move while the wing root stays bit-identical. UVs are not
+ * modelled here at all: this class only tracks positions, and the GPU side
+ * (`DeformableSprite`) leaves its UV buffer untouched.
+ *
+ * @example
+ * ```ts
+ * import { PinnedDeform } from '@datamoc/mw_games/two-d/render';
+ *
+ * const wing = new PinnedDeform({ columns: 4, rows: 3, width: 96, height: 64 });
+ * wing.drag(wing.indexOf(3, 0), 99, -6); // the wingtip follows the bone
+ * console.log(wing.at(wing.indexOf(0, 1))); // { x: 0, y: 32 } - the pinned root never moves
+ * console.log(wing.movedCount()); // 1 - only the dragged tip left its rest position
+ * ```
+ */
+export declare class PinnedDeform {
+    readonly columns: number;
+    readonly rows: number;
+    readonly width: number;
+    readonly height: number;
+    private readonly rest;
+    private readonly offsets;
+    constructor(options: PinnedDeformOptions);
+    /** how many control points the grid holds */
+    get count(): number;
+    /** the flat index of the point at `(column, row)`; throws a RangeError outside the grid */
+    indexOf(column: number, row: number): number;
+    private checkIndex;
+    /** the rest position of one point; the value pinned points always report */
+    restAt(index: number): DeformPoint;
+    /** the current position of one point: rest plus whatever `drag`/`nudge` applied */
+    at(index: number): DeformPoint;
+    /** whether a point currently sits away from its rest position */
+    isMoved(index: number): boolean;
+    /** how many points currently sit away from their rest positions */
+    movedCount(): number;
+    /**
+     * Move one control point to an absolute local position. Only that point
+     * changes; every other point stays pinned at rest.
+     */
+    drag(index: number, x: number, y: number): void;
+    /** Move a batch of control points, validating the entire batch before changing any. */
+    dragMany(points: ReadonlyArray<DeformPoint & {
+        index: number;
+    }>): void;
+    /** Shift one control point by a delta; the rest stay pinned, as with `drag`. */
+    nudge(index: number, dx: number, dy: number): void;
+    /**
+     * Return one point to rest, or every point when called without an index.
+     */
+    reset(index?: number): void;
+    /**
+     * Adopt externally built rest positions, clearing every offset. `DeformableSprite`
+     * uses this to adopt the GPU plane's own floats, so pinned vertices stay
+     * bit-identical to what the mesh already renders instead of nearly equal.
+     */
+    rebase(rest: Float32Array): void;
+    /** a copy of every current position, row-major `(x, y)` pairs for a mesh buffer */
+    positions(): Float32Array;
+    /**
+     * Write every current position into `into`, which must hold exactly
+     * `count * 2` floats. The mesh side calls this with its GPU position array.
+     */
+    writePositions(into: Float32Array): void;
+}
+/** Grid density for {@link DeformableSprite}; both default to 4. */
+export interface DeformableSpriteOptions {
+    /** vertices across; an integer of at least 2, default 4 */
+    columns?: number;
+    /** vertices down; an integer of at least 2, default 4 */
+    rows?: number;
+}
+/**
+ * A sprite that deforms by pinned control points on the existing GPU mesh path.
+ *
+ * This is Pixi's `MeshPlane` with a `PinnedDeform` driving its position buffer:
+ * `dragVertex` moves one vertex while the rest stay pinned, and the mesh batch
+ * renders the result, so a Pontifex wing bends without the game touching Pixi's
+ * mesh directly. The routine itself never rotates, scales or repositions the
+ * sprite (`rotation` stays 0 through every drag) and never rewrites UVs; games
+ * that need a turned sprite rotate the texture art, not this mesh. Colour-batch
+ * and shader internals are untouched: this stays out of `ColorTransformBatcher`.
+ *
+ * @example
+ * ```ts
+ * import { DeformableSprite } from '@datamoc/mw_games/two-d/render';
+ * import type { Texture2D } from '@datamoc/mw_games/two-d/render';
+ *
+ * declare const wingTexture: Texture2D;
+ *
+ * const wing = new DeformableSprite(wingTexture, { columns: 4, rows: 4 });
+ * wing.dragVertex(wing.indexOf(3, 0), 99, -6); // the wingtip bends on the GPU mesh
+ * console.log(wing.vertexAt(wing.indexOf(0, 1)).x); // 0 - the pinned root stays put
+ * console.log(wing.rotation); // 0 - dragging never turns the whole sprite
+ * ```
+ */
+export declare class DeformableSprite extends MeshPlane {
+    private readonly deform;
+    constructor(texture: Texture2D, options?: DeformableSpriteOptions);
+    private positionArray;
+    private sync;
+    /** vertices across */
+    get columns(): number;
+    /** vertices down */
+    get rows(): number;
+    /** how many control vertices the mesh holds */
+    get count(): number;
+    /** the flat index of the vertex at `(column, row)` */
+    indexOf(column: number, row: number): number;
+    /** the rest position of one vertex */
+    restAt(index: number): DeformPoint;
+    /** the current position of one vertex */
+    vertexAt(index: number): DeformPoint;
+    /** whether a vertex currently sits away from its rest position */
+    isMoved(index: number): boolean;
+    /** how many vertices currently sit away from their rest positions */
+    movedCount(): number;
+    /**
+     * Move one mesh vertex to an absolute local position and re-upload the
+     * position buffer. Only that vertex changes; the rest stay pinned.
+     */
+    dragVertex(index: number, x: number, y: number): void;
+    /** Move several vertices with a single GPU buffer upload. Other vertices stay pinned. */
+    dragVertices(points: ReadonlyArray<DeformPoint & {
+        index: number;
+    }>): void;
+    /** Shift one mesh vertex by a delta and re-upload the position buffer. */
+    nudgeVertex(index: number, dx: number, dy: number): void;
+    /** Return one vertex to rest, or every vertex when called without an index. */
+    resetVertices(index?: number): void;
+}
+//# sourceMappingURL=SpriteDeform.d.ts.map

package/dist/two-d/render/SpriteDeform.d.ts.map

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

package/dist/two-d/render/SpriteDeform.js

@@ -0,0 +1,278 @@
+import { MeshPlane } from 'pixi.js';
+function assertGrid(options) {
+    for (const key of ['columns', 'rows']) {
+        if (!Number.isInteger(options[key]) || options[key] < 2) {
+            throw new RangeError(`a pinned deform grid needs integer ${key} of at least 2, saw ${options[key]}`);
+        }
+    }
+    for (const key of ['width', 'height']) {
+        if (!Number.isFinite(options[key]) || options[key] <= 0) {
+            throw new RangeError(`a pinned deform grid needs ${key} above 0, saw ${options[key]}`);
+        }
+    }
+}
+function assertPoint(x, y) {
+    if (!Number.isFinite(x) || !Number.isFinite(y)) {
+        throw new Error(`a deform control point needs finite coordinates, saw (${x}, ${y})`);
+    }
+}
+/**
+ * A pinned-point deformation grid: the renderer-free math behind roadmap item 414.
+ *
+ * The grid holds `columns * rows` control points over a `width * height` rest
+ * rectangle. Every point stays exactly at its rest position until the game drags
+ * it with {@link PinnedDeform.drag} (or {@link PinnedDeform.nudge}); there is no
+ * falloff onto neighbours, no smoothing pass and no whole-sprite rotation, so a
+ * Pontifex wingtip can move while the wing root stays bit-identical. UVs are not
+ * modelled here at all: this class only tracks positions, and the GPU side
+ * (`DeformableSprite`) leaves its UV buffer untouched.
+ *
+ * @example
+ * ```ts
+ * import { PinnedDeform } from '@datamoc/mw_games/two-d/render';
+ *
+ * const wing = new PinnedDeform({ columns: 4, rows: 3, width: 96, height: 64 });
+ * wing.drag(wing.indexOf(3, 0), 99, -6); // the wingtip follows the bone
+ * console.log(wing.at(wing.indexOf(0, 1))); // { x: 0, y: 32 } - the pinned root never moves
+ * console.log(wing.movedCount()); // 1 - only the dragged tip left its rest position
+ * ```
+ */
+export class PinnedDeform {
+    constructor(options) {
+        assertGrid(options);
+        this.columns = options.columns;
+        this.rows = options.rows;
+        this.width = options.width;
+        this.height = options.height;
+        this.rest = new Float32Array(this.count * 2);
+        this.offsets = new Float32Array(this.count * 2);
+        for (let row = 0; row < this.rows; row++) {
+            for (let column = 0; column < this.columns; column++) {
+                const index = (row * this.columns + column) * 2;
+                this.rest[index] = (column / (this.columns - 1)) * this.width;
+                this.rest[index + 1] = (row / (this.rows - 1)) * this.height;
+            }
+        }
+    }
+    /** how many control points the grid holds */
+    get count() {
+        return this.columns * this.rows;
+    }
+    /** the flat index of the point at `(column, row)`; throws a RangeError outside the grid */
+    indexOf(column, row) {
+        if (!Number.isInteger(column) ||
+            !Number.isInteger(row) ||
+            column < 0 ||
+            row < 0 ||
+            column >= this.columns ||
+            row >= this.rows) {
+            throw new RangeError(`control point (${column}, ${row}) is outside a ${this.columns}x${this.rows} grid`);
+        }
+        return row * this.columns + column;
+    }
+    checkIndex(index) {
+        if (!Number.isInteger(index) || index < 0 || index >= this.count) {
+            throw new RangeError(`control point ${index} is outside a grid of ${this.count} points`);
+        }
+    }
+    /** the rest position of one point; the value pinned points always report */
+    restAt(index) {
+        this.checkIndex(index);
+        return { x: this.rest[index * 2], y: this.rest[index * 2 + 1] };
+    }
+    /** the current position of one point: rest plus whatever `drag`/`nudge` applied */
+    at(index) {
+        this.checkIndex(index);
+        return {
+            x: this.rest[index * 2] + this.offsets[index * 2],
+            y: this.rest[index * 2 + 1] + this.offsets[index * 2 + 1],
+        };
+    }
+    /** whether a point currently sits away from its rest position */
+    isMoved(index) {
+        this.checkIndex(index);
+        return this.offsets[index * 2] !== 0 || this.offsets[index * 2 + 1] !== 0;
+    }
+    /** how many points currently sit away from their rest positions */
+    movedCount() {
+        let moved = 0;
+        for (let index = 0; index < this.count; index++) {
+            if (this.offsets[index * 2] !== 0 || this.offsets[index * 2 + 1] !== 0)
+                moved++;
+        }
+        return moved;
+    }
+    /**
+     * Move one control point to an absolute local position. Only that point
+     * changes; every other point stays pinned at rest.
+     */
+    drag(index, x, y) {
+        this.checkIndex(index);
+        assertPoint(x, y);
+        this.offsets[index * 2] = x - this.rest[index * 2];
+        this.offsets[index * 2 + 1] = y - this.rest[index * 2 + 1];
+    }
+    /** Move a batch of control points, validating the entire batch before changing any. */
+    dragMany(points) {
+        for (const point of points) {
+            this.checkIndex(point.index);
+            assertPoint(point.x, point.y);
+        }
+        for (const point of points)
+            this.drag(point.index, point.x, point.y);
+    }
+    /** Shift one control point by a delta; the rest stay pinned, as with `drag`. */
+    nudge(index, dx, dy) {
+        this.checkIndex(index);
+        assertPoint(dx, dy);
+        this.offsets[index * 2] += dx;
+        this.offsets[index * 2 + 1] += dy;
+    }
+    /**
+     * Return one point to rest, or every point when called without an index.
+     */
+    reset(index) {
+        if (index === undefined) {
+            this.offsets.fill(0);
+            return;
+        }
+        this.checkIndex(index);
+        this.offsets[index * 2] = 0;
+        this.offsets[index * 2 + 1] = 0;
+    }
+    /**
+     * Adopt externally built rest positions, clearing every offset. `DeformableSprite`
+     * uses this to adopt the GPU plane's own floats, so pinned vertices stay
+     * bit-identical to what the mesh already renders instead of nearly equal.
+     */
+    rebase(rest) {
+        if (!(rest instanceof Float32Array) || rest.length !== this.rest.length) {
+            throw new Error(`rebase needs a Float32Array of ${this.rest.length} floats, saw length ${rest?.length}`);
+        }
+        for (const value of rest) {
+            if (!Number.isFinite(value))
+                throw new Error('rebase needs finite rest positions');
+        }
+        this.rest.set(rest);
+        this.offsets.fill(0);
+    }
+    /** a copy of every current position, row-major `(x, y)` pairs for a mesh buffer */
+    positions() {
+        const out = new Float32Array(this.rest.length);
+        this.writePositions(out);
+        return out;
+    }
+    /**
+     * Write every current position into `into`, which must hold exactly
+     * `count * 2` floats. The mesh side calls this with its GPU position array.
+     */
+    writePositions(into) {
+        if (!(into instanceof Float32Array) || into.length !== this.rest.length) {
+            throw new Error(`a deform target needs a Float32Array of ${this.rest.length} floats, saw length ${into?.length}`);
+        }
+        for (let index = 0; index < this.rest.length; index++) {
+            into[index] = this.rest[index] + this.offsets[index];
+        }
+    }
+}
+/**
+ * A sprite that deforms by pinned control points on the existing GPU mesh path.
+ *
+ * This is Pixi's `MeshPlane` with a `PinnedDeform` driving its position buffer:
+ * `dragVertex` moves one vertex while the rest stay pinned, and the mesh batch
+ * renders the result, so a Pontifex wing bends without the game touching Pixi's
+ * mesh directly. The routine itself never rotates, scales or repositions the
+ * sprite (`rotation` stays 0 through every drag) and never rewrites UVs; games
+ * that need a turned sprite rotate the texture art, not this mesh. Colour-batch
+ * and shader internals are untouched: this stays out of `ColorTransformBatcher`.
+ *
+ * @example
+ * ```ts
+ * import { DeformableSprite } from '@datamoc/mw_games/two-d/render';
+ * import type { Texture2D } from '@datamoc/mw_games/two-d/render';
+ *
+ * declare const wingTexture: Texture2D;
+ *
+ * const wing = new DeformableSprite(wingTexture, { columns: 4, rows: 4 });
+ * wing.dragVertex(wing.indexOf(3, 0), 99, -6); // the wingtip bends on the GPU mesh
+ * console.log(wing.vertexAt(wing.indexOf(0, 1)).x); // 0 - the pinned root stays put
+ * console.log(wing.rotation); // 0 - dragging never turns the whole sprite
+ * ```
+ */
+export class DeformableSprite extends MeshPlane {
+    constructor(texture, options) {
+        const columns = options?.columns ?? 4;
+        const rows = options?.rows ?? 4;
+        const deform = new PinnedDeform({ columns, rows, width: texture.width, height: texture.height });
+        super({ texture, verticesX: columns, verticesY: rows });
+        this.deform = deform;
+        //a later texture resize must not rebuild the plane under the offsets
+        this.autoResize = false;
+        this.deform.rebase(Float32Array.from(this.positionArray()));
+        this.sync();
+    }
+    positionArray() {
+        return this.geometry.getAttribute('aPosition').buffer.data;
+    }
+    sync() {
+        const attribute = this.geometry.getAttribute('aPosition');
+        this.deform.writePositions(attribute.buffer.data);
+        attribute.buffer.update();
+    }
+    /** vertices across */
+    get columns() {
+        return this.deform.columns;
+    }
+    /** vertices down */
+    get rows() {
+        return this.deform.rows;
+    }
+    /** how many control vertices the mesh holds */
+    get count() {
+        return this.deform.count;
+    }
+    /** the flat index of the vertex at `(column, row)` */
+    indexOf(column, row) {
+        return this.deform.indexOf(column, row);
+    }
+    /** the rest position of one vertex */
+    restAt(index) {
+        return this.deform.restAt(index);
+    }
+    /** the current position of one vertex */
+    vertexAt(index) {
+        return this.deform.at(index);
+    }
+    /** whether a vertex currently sits away from its rest position */
+    isMoved(index) {
+        return this.deform.isMoved(index);
+    }
+    /** how many vertices currently sit away from their rest positions */
+    movedCount() {
+        return this.deform.movedCount();
+    }
+    /**
+     * Move one mesh vertex to an absolute local position and re-upload the
+     * position buffer. Only that vertex changes; the rest stay pinned.
+     */
+    dragVertex(index, x, y) {
+        this.deform.drag(index, x, y);
+        this.sync();
+    }
+    /** Move several vertices with a single GPU buffer upload. Other vertices stay pinned. */
+    dragVertices(points) {
+        this.deform.dragMany(points);
+        this.sync();
+    }
+    /** Shift one mesh vertex by a delta and re-upload the position buffer. */
+    nudgeVertex(index, dx, dy) {
+        this.deform.nudge(index, dx, dy);
+        this.sync();
+    }
+    /** Return one vertex to rest, or every vertex when called without an index. */
+    resetVertices(index) {
+        this.deform.reset(index);
+        this.sync();
+    }
+}
+//# sourceMappingURL=SpriteDeform.js.map

package/dist/two-d/render/SpriteDeform.js.map

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

package/dist/two-d/render/SvgSkeleton.d.ts

@@ -0,0 +1,54 @@
+import { type Mixer, type SkeletonBones } from '../../skeleton/index.ts';
+import { SkeletalSprite } from './SkeletalSprite.ts';
+import type { Texture2D } from './Types2D.ts';
+export interface SvgBoneBinding {
+    bone: string;
+    /** SVG group id; defaults to the bone name. */
+    group?: string;
+    /** Pivot in root SVG user coordinates. Overrides options.pivots and SVG data attributes. */
+    pivot?: {
+        x: number;
+        y: number;
+    };
+    /** Artwork's rest angle in degrees; defaults to the bone's resolved rest angle. */
+    rotation?: number;
+}
+export interface SvgSkeletonOptions {
+    skeleton: SkeletonBones;
+    /** Draw order. Omit to bind matching named groups in SVG document order. */
+    bindings?: readonly SvgBoneBinding[];
+    /** Root SVG user coordinates, keyed by group id (e.g. from a game's art manifest). */
+    pivots?: Readonly<Record<string, {
+        x: number;
+        y: number;
+    }>>;
+    resolution?: number;
+    mixer?: Mixer;
+}
+export interface LoadedSvgSkeleton {
+    sprite: SkeletalSprite;
+    /** Borrowed cached textures. Destroy sprites first, then releaseSvgParts once all users are done. */
+    textures: Readonly<Record<string, Texture2D>>;
+}
+/**
+ * Load authored SVG limbs, normalize each around its pivot, and bind them to a skeleton.
+ * Uses SVG data-pivot-x / data-pivot-y attributes or pivots supplied by the game. Art is
+ * rotated back from its rest angle before rasterization, so rest poses reconstruct the drawing
+ * and posed limbs turn around their joints. Separately bound descendant groups are removed
+ * from parent parts, avoiding duplicate limbs; ancestor transforms and shared defs/styles survive.
+ * Requires browser DOMParser and XMLSerializer. Compiled asset paths work directly under file://.
+ * @example
+ * ```ts
+ * import { create } from '@datamoc/mw_games/skeleton';
+ * import { loadSvgSkeleton } from '@datamoc/mw_games/two-d/render';
+ * import { releaseSvgParts } from '@datamoc/mw_games/assets';
+ * const loaded = await loadSvgSkeleton('<svg xmlns="http://www.w3.org/2000/svg" width="30" height="10"><g id="arm" data-pivot-x="0" data-pivot-y="5"><rect width="30" height="10"/></g></svg>', {
+ *   skeleton: create([{ name: 'arm', length: 30, origin: { x: 0, y: 5 } }]), resolution: 2,
+ * });
+ * loaded.sprite.apply({ arm: 45 });
+ * loaded.sprite.destroy({ children: true });
+ * await releaseSvgParts(loaded.textures);
+ * ```
+ */
+export declare function loadSvgSkeleton(source: string, options: SvgSkeletonOptions): Promise<LoadedSvgSkeleton>;
+//# sourceMappingURL=SvgSkeleton.d.ts.map

package/dist/two-d/render/SvgSkeleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SvgSkeleton.d.ts","sourceRoot":"","sources":["../../../src/two-d/render/SvgSkeleton.ts"],"names":[],"mappings":"AAEA,OAAO,EAAW,KAAK,KAAK,EAAE,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4FAA4F;IAC5F,KAAK,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,EAAE,aAAa,CAAC;IACxB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACrC,sFAAsF;IACtF,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IACjC,MAAM,EAAE,cAAc,CAAC;IACvB,qGAAqG;IACrG,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;CAC9C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAgF7G"}