@woosh/meep-engine 3.40.0 → 3.42.0

package/src/shade/wgsl/emulator/WGSLLanguageCore.js

@@ -1265,17 +1265,25 @@ export const WGSLLanguageCore = {
      * silently dropped (WGSL semantics). `coords` length matches the
      * texture dimensionality.
      *
+     * Four arguments is the `texture_storage_2d_array` form — `(t, coords, array_index, value)` —
+     * where the third argument selects the slice, stored along z as the sampling side reads it.
+     *
      * @param {import("./CPUBitmapData.js").CPUBitmapData} t
      * @param {Int32Array | Uint32Array | number[] | number} coords
-     * @param {Float32Array | Int32Array | Uint32Array | number[]} value
+     * @param {Float32Array | Int32Array | Uint32Array | number[] | number} value_or_index
+     * @param {Float32Array | Int32Array | Uint32Array | number[]} [array_value]
      */
-    textureStore(t, coords, value) {
+    textureStore(t, coords, value_or_index, array_value = undefined) {
         assert.defined(t, 'texture');
+        if (array_value !== undefined) {
+            t.write(coords[0] | 0, coords[1] | 0, value_or_index | 0, array_value);
+            return;
+        }
         const dim = t.dimensionality;
         const x = (dim >= 1 ? (typeof coords === 'number' ? coords : coords[0]) : 0) | 0;
         const y = (dim >= 2 ? coords[1] : 0) | 0;
         const z = (dim >= 3 ? coords[2] : 0) | 0;
-        t.write(x, y, z, value);
+        t.write(x, y, z, value_or_index);
     },
 
     // CPUBitmapData models one stored mip level.

package/src/core/geom/2d/polygon/polygon2_triangulate.corpus.d.ts

@@ -1,28 +0,0 @@
-/**
- * Inputs that have actually broken {@link polygon2_triangulate}, kept so they can
- * never break it again.
- *
- * This file only ever grows, and only from real failures -- a case someone
- * *imagines* might be hard belongs in the ordinary spec, not here. Every entry
- * records what went wrong when it was added, because that is the part that stops
- * a future change from quietly reintroducing the same class of bug. The practice
- * is borrowed from manifold, whose triangulator carries ~3 MB of recorded failing
- * polygons replayed as tests.
- *
- * `expect_full` says whether the polygon is well-formed enough that the whole of
- * its area must be covered. `false` means the input is genuinely invalid
- * (self-intersecting) and the only requirements are the universal ones: no throw,
- * no hang, no out-of-range index.
- *
- * @author Alex Goldring
- * @copyright Company Named Limited (c) 2026
- */
-export const POLYGON2_TRIANGULATE_CORPUS: {
-    name: string;
-    why: string;
-    points: number[];
-    contour_ends: number[];
-    contour_count: number;
-    expect_full: boolean;
-}[];
-//# sourceMappingURL=polygon2_triangulate.corpus.d.ts.map

package/src/core/geom/2d/polygon/polygon2_triangulate.corpus.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"polygon2_triangulate.corpus.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/2d/polygon/polygon2_triangulate.corpus.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH;;;;;;;IAkEE"}

package/src/core/geom/2d/polygon/polygon2_triangulate.corpus.js

@@ -1,86 +0,0 @@
-/**
- * Inputs that have actually broken {@link polygon2_triangulate}, kept so they can
- * never break it again.
- *
- * This file only ever grows, and only from real failures -- a case someone
- * *imagines* might be hard belongs in the ordinary spec, not here. Every entry
- * records what went wrong when it was added, because that is the part that stops
- * a future change from quietly reintroducing the same class of bug. The practice
- * is borrowed from manifold, whose triangulator carries ~3 MB of recorded failing
- * polygons replayed as tests.
- *
- * `expect_full` says whether the polygon is well-formed enough that the whole of
- * its area must be covered. `false` means the input is genuinely invalid
- * (self-intersecting) and the only requirements are the universal ones: no throw,
- * no hang, no out-of-range index.
- *
- * @author Alex Goldring
- * @copyright Company Named Limited (c) 2026
- */
-export const POLYGON2_TRIANGULATE_CORPUS = [
-    {
-        name: "unit-offset micro square",
-        why: "Winding was decided by the shoelace sum, whose sign here is pure "
-            + "rounding noise: the true area is 1e-18 against ~1e-16 per-term error. "
-            + "The ring came out backwards, every corner looked reflex, and the "
-            + "result was zero triangles. Fixed by deciding winding with one exact "
-            + "orientation predicate at a hull vertex (polygon2_is_counter_clockwise).",
-        points: [
-            1, 1,
-            1 + 1e-9, 1,
-            1 + 1e-9, 1 + 1e-9,
-            1, 1 + 1e-9,
-        ],
-        contour_ends: [4],
-        contour_count: 1,
-        expect_full: true,
-    },
-    {
-        name: "coarse-grid point soup (fuzz seed 24)",
-        why: "Twenty points on a 7x7 integer grid, with duplicates and collinear "
-            + "runs. The ear search exhausted itself, fell through to the "
-            + "cure-local-intersections pass, and that pass walked the "
-            + "collapsed-ring sentinel as if it were a node -- an infinite loop. "
-            + "Fixed by making the recovery pass accept and propagate the sentinel, "
-            + "and by stopping it once the ring holds fewer than three nodes.",
-        points: [
-            2, 3, 3, 6, 1, 5, 0, 4, 5, 0,
-            4, 2, 3, 3, 3, 6, 2, 3, 6, 1,
-            4, 4, 2, 6, 3, 2, 6, 4, 1, 1,
-            3, 0, 5, 0, 3, 2, 6, 4, 3, 3,
-        ],
-        contour_ends: [20],
-        contour_count: 1,
-        expect_full: false,
-    },
-    {
-        name: "two rectangular holes bridged through a shared edge",
-        why: "Produced 12 triangles where the Euler bound allows 14, which looked "
-            + "like dropped geometry. It was not: the bridges left collinear corners "
-            + "that were correctly absorbed rather than emitted as zero-area "
-            + "triangles. Kept as the standing reminder that V + 2H - 2 is an upper "
-            + "bound, not an equality -- area conservation is the real invariant.",
-        points: [
-            0, 0, 20, 0, 20, 10, 0, 10,
-            2, 8, 6, 8, 6, 2, 2, 2,
-            12, 8, 18, 8, 18, 2, 12, 2,
-        ],
-        contour_ends: [4, 8, 12],
-        contour_count: 3,
-        expect_full: true,
-    },
-    {
-        name: "hole touching the outer boundary at a vertex",
-        why: "Same class as above -- 6 triangles against a bound of 7. The hole's "
-            + "corner lands exactly on the outer edge, so the bridge is degenerate "
-            + "and one corner becomes collinear. Area is still exact and every input "
-            + "vertex is still used.",
-        points: [
-            0, 0, 10, 0, 10, 10, 0, 10,
-            4, 7, 4, 3, 0, 5,
-        ],
-        contour_ends: [4, 7],
-        contour_count: 2,
-        expect_full: true,
-    },
-];

package/src/engine/ecs/ik/IKConstraint.d.ts

@@ -1,52 +0,0 @@
-export class IKConstraint {
-    /**
-     * End bone that is going to be placed
-     * @type {String}
-     */
-    effector: string;
-    /**
-     * How far should effector be from the contact, positive values result in effector not reaching the surface, and negative result in penetration
-     * @example For a foot effector this would be distance above the ground
-     * @type {number}
-     */
-    offset: number;
-    /**
-     * Positive distance from the surface at which IK starts to take effect, low value represents full effect and high value represents where the influence begins
-     * @type {NumericInterval}
-     */
-    distance: NumericInterval;
-    /**
-     *
-     * @type {number}
-     */
-    strength: number;
-    /**
-     *
-     * @type {number}
-     */
-    limit: number;
-    /**
-     * Solver to be used for this constraint
-     * @type {string}
-     */
-    solver: string;
-    /**
-     *
-     * @param {IKConstraint} other
-     */
-    copy(other: IKConstraint): void;
-    clone(): IKConstraint;
-    /**
-     *
-     * @param {IKConstraint} other
-     * @returns {boolean}
-     */
-    equals(other: IKConstraint): boolean;
-    /**
-     *
-     * @return {number}
-     */
-    hash(): number;
-}
-import { NumericInterval } from "../../../core/math/interval/NumericInterval.js";
-//# sourceMappingURL=IKConstraint.d.ts.map

package/src/engine/ecs/ik/IKConstraint.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"IKConstraint.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/ik/IKConstraint.js"],"names":[],"mappings":"AAKA;IAEI;;;OAGG;IACH,iBAAc;IAEd;;;;OAIG;IACH,QAFU,MAAM,CAEL;IAEX;;;OAGG;IACH,UAFU,eAAe,CAEY;IAErC;;;OAGG;IACH,UAFU,MAAM,CAEH;IAEb;;;OAGG;IACH,OAFU,MAAM,CAEA;IAEhB;;;OAGG;IACH,QAFU,MAAM,CAEA;IAGhB;;;OAGG;IACH,YAFW,YAAY,QAStB;IAED,sBAMC;IAED;;;;OAIG;IACH,cAHW,YAAY,GACV,OAAO,CASnB;IAED;;;OAGG;IACH,QAFY,MAAM,CAWjB;CACJ;gCA7F+B,gDAAgD"}

package/src/engine/ecs/ik/IKConstraint.js

@@ -1,95 +0,0 @@
-import { combine_hash } from "../../../core/collection/array/combine_hash.js";
-import { NumericInterval } from "../../../core/math/interval/NumericInterval.js";
-import { computeHashFloat } from "../../../core/primitives/numbers/computeHashFloat.js";
-import { computeStringHash } from "../../../core/primitives/strings/computeStringHash.js";
-
-export class IKConstraint {
-
-    /**
-     * End bone that is going to be placed
-     * @type {String}
-     */
-    effector = "";
-
-    /**
-     * How far should effector be from the contact, positive values result in effector not reaching the surface, and negative result in penetration
-     * @example For a foot effector this would be distance above the ground
-     * @type {number}
-     */
-    offset = 0;
-
-    /**
-     * Positive distance from the surface at which IK starts to take effect, low value represents full effect and high value represents where the influence begins
-     * @type {NumericInterval}
-     */
-    distance = new NumericInterval(0, 0);
-
-    /**
-     *
-     * @type {number}
-     */
-    strength = 1;
-
-    /**
-     *
-     * @type {number}
-     */
-    limit = Math.PI;
-
-    /**
-     * Solver to be used for this constraint
-     * @type {string}
-     */
-    solver = "2BIK";
-
-
-    /**
-     *
-     * @param {IKConstraint} other
-     */
-    copy(other) {
-        this.effector = other.effector;
-        this.offset = other.offset;
-        this.distance.copy(other.distance);
-        this.strength = other.strength;
-        this.limit = other.limit;
-        this.solver = other.solver;
-    }
-
-    clone() {
-        const r = new IKConstraint();
-
-        r.copy(this);
-
-        return r;
-    }
-
-    /**
-     *
-     * @param {IKConstraint} other
-     * @returns {boolean}
-     */
-    equals(other) {
-        return this.effector === other.effector
-            && this.offset === other.offset
-            && this.distance.equals(other.distance)
-            && this.strength === other.strength
-            && this.limit === other.limit
-            && this.solver === other.solver;
-    }
-
-    /**
-     *
-     * @return {number}
-     */
-    hash() {
-        return combine_hash(
-            computeStringHash(this.effector),
-            computeHashFloat(this.offset),
-            this.distance.hash(),
-            computeHashFloat(this.strength),
-            computeHashFloat(this.limit),
-            computeStringHash(this.solver)
-        );
-    }
-}

package/src/engine/ecs/ik/IKProblem.d.ts

@@ -1,45 +0,0 @@
-export class IKProblem {
-    /**
-     *
-     * @type {IKConstraint}
-     */
-    constraint: IKConstraint;
-    /**
-     * Where the hierarchy lives. Bones are entities, so the chain is walked here rather than on a
-     * skeleton object.
-     *
-     * @type {EntityComponentDataset}
-     */
-    dataset: EntityComponentDataset;
-    /**
-     * The bone being placed. Its ancestors are the rest of the chain, reached through
-     * {@link transform_attachment_parent_of}.
-     *
-     * @type {number}
-     */
-    effector: number;
-    /**
-     *
-     * @type {Terrain}
-     */
-    terrain: Terrain;
-    /**
-     * The clips playing on the constrained entity's model, with their times and weights: what a
-     * chain under a GPU-composed ancestor is evaluated against. Empty for a model nothing plays.
-     *
-     * @type {PosePlayback[]}
-     */
-    playbacks: PosePlayback[];
-    /**
-     * The system's per-tick evaluation cache, shared by every problem of the tick; null where a
-     * chain is evaluated on its own.
-     *
-     * @type {T64WorldCache|null}
-     */
-    cache: T64WorldCache | null;
-}
-export namespace IKProblem {
-    let pool: ObjectPoolFactory<IKProblem>;
-}
-import { ObjectPoolFactory } from "../../../core/model/object/ObjectPoolFactory.js";
-//# sourceMappingURL=IKProblem.d.ts.map

package/src/engine/ecs/ik/IKProblem.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"IKProblem.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/ik/IKProblem.js"],"names":[],"mappings":"AAGA;IAEI;;;OAGG;IACH,yBAAkB;IAElB;;;;;OAKG;IACH,gCAAe;IAEf;;;;;OAKG;IACH,UAFU,MAAM,CAEF;IAEd;;;OAGG;IACH,iBAAe;IAEf;;;;;OAKG;IACH,WAFU,cAAc,CAET;IAEf;;;;;OAKG;IACH,OAFU,gBAAc,IAAI,CAEf;CAEhB;;cAIS,kBAAkB,SAAS,CAAC;;kCApDJ,iDAAiD"}

package/src/engine/ecs/ik/IKProblem.js

@@ -1,58 +0,0 @@
-import { noop } from "../../../core/function/noop.js";
-import { ObjectPoolFactory } from "../../../core/model/object/ObjectPoolFactory.js";
-
-export class IKProblem {
-
-    /**
-     *
-     * @type {IKConstraint}
-     */
-    constraint = null;
-
-    /**
-     * Where the hierarchy lives. Bones are entities, so the chain is walked here rather than on a
-     * skeleton object.
-     *
-     * @type {EntityComponentDataset}
-     */
-    dataset = null;
-
-    /**
-     * The bone being placed. Its ancestors are the rest of the chain, reached through
-     * {@link transform_attachment_parent_of}.
-     *
-     * @type {number}
-     */
-    effector = -1;
-
-    /**
-     *
-     * @type {Terrain}
-     */
-    terrain = null;
-
-    /**
-     * The clips playing on the constrained entity's model, with their times and weights: what a
-     * chain under a GPU-composed ancestor is evaluated against. Empty for a model nothing plays.
-     *
-     * @type {PosePlayback[]}
-     */
-    playbacks = [];
-
-    /**
-     * The system's per-tick evaluation cache, shared by every problem of the tick; null where a
-     * chain is evaluated on its own.
-     *
-     * @type {T64WorldCache|null}
-     */
-    cache = null;
-
-}
-
-/**
- *
- * @type {ObjectPoolFactory<IKProblem>}
- */
-IKProblem.pool = new ObjectPoolFactory(() => {
-    return new IKProblem();
-}, noop, noop);

package/src/engine/ecs/ik/IKSolver.d.ts

@@ -1,8 +0,0 @@
-export class IKSolver {
-    /**
-     *
-     * @param {IKProblem} problem
-     */
-    solve(problem: IKProblem): void;
-}
-//# sourceMappingURL=IKSolver.d.ts.map

package/src/engine/ecs/ik/IKSolver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"IKSolver.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/ik/IKSolver.js"],"names":[],"mappings":"AAAA;IACI;;;OAGG;IACH,gCAEC;CACJ"}

package/src/engine/ecs/ik/IKSolver.js

@@ -1,9 +0,0 @@
-export class IKSolver {
-    /**
-     *
-     * @param {IKProblem} problem
-     */
-    solve(problem) {
-        throw new Error('Not implemented');
-    }
-}

package/src/engine/ecs/ik/InverseKinematics.d.ts

@@ -1,48 +0,0 @@
-export class InverseKinematics {
-    /**
-     * @readonly
-     * @type {IKConstraint[]}
-     */
-    readonly constraints: IKConstraint[];
-    /**
-     *
-     * @param {InverseKinematics} other
-     */
-    copy(other: InverseKinematics): void;
-    clone(): InverseKinematics;
-    /**
-     *
-     * @param {Object} options
-     * @param {String} options.effector
-     * @param {number} options.offset
-     * @param {number} options.distanceMin
-     * @param {number} options.distanceMax
-     * @param {number} options.strength
-     * @param {number} options.limit
-     * @param {String} options.solver
-     */
-    add({ effector, offset, distanceMin, distanceMax, strength, limit, solver }: {
-        effector: string;
-        offset: number;
-        distanceMin: number;
-        distanceMax: number;
-        strength: number;
-        limit: number;
-        solver: string;
-    }): void;
-    /**
-     *
-     * @param {InverseKinematics} other
-     * @returns {boolean}
-     */
-    equals(other: InverseKinematics): boolean;
-    /**
-     * @returns {number}
-     */
-    hash(): number;
-}
-export namespace InverseKinematics {
-    let typeName: string;
-}
-import { IKConstraint } from "./IKConstraint.js";
-//# sourceMappingURL=InverseKinematics.d.ts.map

package/src/engine/ecs/ik/InverseKinematics.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"InverseKinematics.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/ik/InverseKinematics.js"],"names":[],"mappings":"AAGA;IAEI;;;OAGG;IACH,sBAFU,YAAY,EAAE,CAEP;IAEjB;;;OAGG;IACH,YAFW,iBAAiB,QAe3B;IAED,2BAMC;IAED;;;;;;;;;;OAUG;IACH;QAR2B,QAAQ;QACR,MAAM,EAAtB,MAAM;QACU,WAAW,EAA3B,MAAM;QACU,WAAW,EAA3B,MAAM;QACU,QAAQ,EAAxB,MAAM;QACU,KAAK,EAArB,MAAM;QACU,MAAM;aAqBhC;IAED;;;;OAIG;IACH,cAHW,iBAAiB,GACf,OAAO,CAsBnB;IAED;;OAEG;IACH,QAFa,MAAM,CAgBlB;CACJ;;;;6BAnH4B,mBAAmB"}

package/src/engine/ecs/ik/InverseKinematics.js

@@ -1,119 +0,0 @@
-import { IKConstraint } from "./IKConstraint.js";
-
-
-export class InverseKinematics {
-
-    /**
-     * @readonly
-     * @type {IKConstraint[]}
-     */
-    constraints = [];
-
-    /**
-     *
-     * @param {InverseKinematics} other
-     */
-    copy(other) {
-        this.constraints.splice(0, this.constraints.length);
-
-        const other_constraints = other.constraints;
-        const n = other_constraints.length;
-
-        for (let i = 0; i < n; i++) {
-            const constraint = other_constraints[i];
-
-            const constraintClone = constraint.clone();
-
-            this.constraints.push(constraintClone);
-        }
-    }
-
-    clone() {
-        const r = new InverseKinematics();
-
-        r.copy(this);
-
-        return r;
-    }
-
-    /**
-     *
-     * @param {Object} options
-     * @param {String} options.effector
-     * @param {number} options.offset
-     * @param {number} options.distanceMin
-     * @param {number} options.distanceMax
-     * @param {number} options.strength
-     * @param {number} options.limit
-     * @param {String} options.solver
-     */
-    add({
-            effector,
-            offset = 0,
-            distanceMin = 0,
-            distanceMax = 0.1,
-            strength = 1,
-            limit = Math.PI * 0.9,
-            solver = "2BIK"
-        }) {
-        const c = new IKConstraint();
-
-        c.effector = effector;
-        c.offset = offset;
-        c.strength = strength;
-        c.distance.set(distanceMin, distanceMax);
-        c.solver = solver;
-        c.limit = limit;
-
-        this.constraints.push(c);
-    }
-
-    /**
-     *
-     * @param {InverseKinematics} other
-     * @returns {boolean}
-     */
-    equals(other) {
-        const cs0 = this.constraints;
-        const cs1 = other.constraints;
-
-        const n0 = cs0.length;
-        const n1 = cs1.length;
-
-        if (n0 !== n1) {
-            return false;
-        }
-
-        for (let i = 0; i < n0; i++) {
-            const c0 = cs0[i];
-            const c1 = cs1[i];
-            if (!c0.equals(c1)) {
-                return false;
-            }
-        }
-
-        return true;
-    }
-
-    /**
-     * @returns {number}
-     */
-    hash() {
-
-        let hash = 0;
-        const constraints = this.constraints;
-        const length = constraints.length;
-
-        for (let i = 0; i < length; i++) {
-            const constraint = constraints[i];
-            const singleValue = constraint.hash();
-            hash = ((hash << 5) - hash) + singleValue;
-            hash |= 0; // Convert to 32bit integer
-        }
-
-        return hash;
-    }
-}
-
-InverseKinematics.typeName = "InverseKinematics";
-

package/src/engine/ecs/ik/InverseKinematicsSerializationAdapter.d.ts

@@ -1,19 +0,0 @@
-export class InverseKinematicsSerializationAdapter extends BinaryClassSerializationAdapter<any> {
-    constructor();
-    klass: typeof InverseKinematics;
-    /**
-     *
-     * @param {BinaryBuffer} buffer
-     * @param {InverseKinematics} value
-     */
-    serialize(buffer: BinaryBuffer, value: InverseKinematics): void;
-    /**
-     *
-     * @param {BinaryBuffer} buffer
-     * @param {InverseKinematics} value
-     */
-    deserialize(buffer: BinaryBuffer, value: InverseKinematics): void;
-}
-import { BinaryClassSerializationAdapter } from "../storage/binary/BinaryClassSerializationAdapter.js";
-import { InverseKinematics } from "./InverseKinematics.js";
-//# sourceMappingURL=InverseKinematicsSerializationAdapter.d.ts.map

package/src/engine/ecs/ik/InverseKinematicsSerializationAdapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"InverseKinematicsSerializationAdapter.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/ik/InverseKinematicsSerializationAdapter.js"],"names":[],"mappings":"AAIA;;IAEI,gCAA0B;IAG1B;;;;OAIG;IACH,uCAFW,iBAAiB,QAqB3B;IAED;;;;OAIG;IACH,yCAFW,iBAAiB,QAgC3B;CACJ;gDAvE+C,sDAAsD;kCAEpE,wBAAwB"}