@woosh/meep-engine 3.42.0 → 3.44.0

package/src/engine/physics/cloth/ecs/WorkerClothSystem.d.ts

@@ -88,7 +88,7 @@ export class WorkerClothSystem extends WorkerSystem {
         max_cloth_count?: number;
     });
     dependencies: (typeof Transform64 | typeof Cloth)[];
-    components_used: (ResourceAccessSpecification<typeof Transform64> | ResourceAccessSpecification<typeof TransformAttachment> | ResourceAccessSpecification<typeof ClothCollider> | ResourceAccessSpecification<typeof Cloth> | ResourceAccessSpecification<typeof ClothExclude> | ResourceAccessSpecification<typeof ClothRig>)[];
+    components_used: (ResourceAccessSpecification<typeof Transform64> | ResourceAccessSpecification<typeof TransformAttachment> | ResourceAccessSpecification<typeof GPUStateAuthority> | ResourceAccessSpecification<typeof ParentEntity> | ResourceAccessSpecification<typeof ClothCollider> | ResourceAccessSpecification<typeof Cloth> | ResourceAccessSpecification<typeof ClothExclude> | ResourceAccessSpecification<typeof ClothRig> | ResourceAccessSpecification<typeof ClothPin>)[];
     /**
      * The cloths, and everything about stepping one that is not arithmetic.
      * Shared with {@link ClothSystem}, which is what makes the two systems one
@@ -121,18 +121,6 @@ export class WorkerClothSystem extends WorkerSystem {
      * @returns {ClothInstance[]}
      */
     get instances(): ClothInstance[];
-    /**
-     * @param {{instance_of: function(number): (PrefabInstance|null)}|null} value
-     */
-    set models(value: {
-        instance_of: (arg0: number) => (PrefabInstance | null);
-    });
-    /**
-     * @returns {{instance_of: function(number): (PrefabInstance|null)}|null}
-     */
-    get models(): {
-        instance_of: (arg0: number) => (PrefabInstance | null);
-    };
     /**
      * @param {EntityComponentDataset} dataset
      * @returns {void}
@@ -172,6 +160,14 @@ export class WorkerClothSystem extends WorkerSystem {
      * @returns {ClothInstance|undefined}
      */
     instanceOf(entity: number): ClothInstance | undefined;
+    /**
+     * Which particle of a cloth an entity is, for a {@link ClothPin} that has
+     * the entity in hand — see {@link ClothWorld#particle_of}.
+     * @param {number} cloth the entity carrying the `Cloth`
+     * @param {number} entity
+     * @returns {number} the particle, or `−1`
+     */
+    particle_of(cloth: number, entity: number): number;
     /**
      * @returns {boolean} whether cloth *particle state* may currently be read
      *          from the main thread. False while a step is in flight. The poses
@@ -185,8 +181,11 @@ import { Transform64 } from "../../../ecs/transform/Transform64.js";
 import { Cloth } from "./Cloth.js";
 import { ResourceAccessSpecification } from "../../../../core/model/ResourceAccessSpecification.js";
 import { TransformAttachment } from "../../../ecs/transform-attachment/TransformAttachment.js";
+import { GPUStateAuthority } from "../../../ecs/gpu/GPUStateAuthority.js";
+import { ParentEntity } from "../../../ecs/parent/ParentEntity.js";
 import { ClothCollider } from "./ClothCollider.js";
 import { ClothExclude } from "./ClothExclude.js";
 import { ClothRig } from "./ClothRig.js";
+import { ClothPin } from "./ClothPin.js";
 import { ClothWorld } from "./ClothWorld.js";
 //# sourceMappingURL=WorkerClothSystem.d.ts.map

package/src/engine/physics/cloth/ecs/WorkerClothSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WorkerClothSystem.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/physics/cloth/ecs/WorkerClothSystem.js"],"names":[],"mappings":"AA0BA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0EG;AACH;IAoEI;;;;;;;;OAQG;IACH;QAPiC,cAAc,EAApC,MAAM,MAAM;QAIK,eAAe,GAAhC,MAAM;OAYhB;IApFD,oDAAoC;IAEpC,iUAOE;IAEF;;;;;OAKG;IACH,OAFU,UAAU,CAEK;IA6EzB;;OAEG;IACH,iCAEC;IAbD;;;OAGG;IACH,4BAEC;IAoBD;;OAEG;IACH,qBAEC;IAhBD;;;;;;OAMG;IACH,gBAEC;IASD;;OAEG;IACH,iCAEC;IASD;;OAEG;IACH;4BAToC,MAAM,KAAG,CAAC,iBAAe,IAAI,CAAC;OAWjE;IAZD;;OAEG;IACH;4BAFoC,MAAM,KAAG,CAAC,iBAAe,IAAI,CAAC;MAIjE;IAiCD;;;OAGG;IACH,wDAFa,IAAI,CAIhB;IAED;;;OAGG;IACH,wDAFa,IAAI,CAIhB;IAcD;;;;OAIG;IACH,YAJW,KAAK,aACL,WAAW,UACX,MAAM,QAIhB;IAED;;;;OAIG;IACH,cAJW,KAAK,aACL,WAAW,UACX,MAAM,QAQhB;IAED;;;;OAIG;IACH,eAHW,MAAM,GACJ,IAAI,CAIhB;IAED;;;;OAIG;IACH,aAHW,MAAM,GACJ,IAAI,CAIhB;IAED;;;OAGG;IACH,mBAHW,MAAM,GACJ,gBAAc,SAAS,CAInC;IAED;;;;OAIG;IACH,iCAEC;;CAmOJ;6BA/jB4B,oCAAoC;4BAIrC,uCAAuC;sBAE7C,YAAY;4CAPU,uDAAuD;oCAI5F,0DAA0D;8BAInC,oBAAoB;6BACrB,mBAAmB;yBACvB,eAAe;2BACb,iBAAiB"}
+{"version":3,"file":"WorkerClothSystem.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/physics/cloth/ecs/WorkerClothSystem.js"],"names":[],"mappings":"AA6BA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0EG;AACH;IAyEI;;;;;;;;OAQG;IACH;QAPiC,cAAc,EAApC,MAAM,MAAM;QAIK,eAAe,GAAhC,MAAM;OAYhB;IAzFD,oDAAoC;IAEpC,2dAYE;IAEF;;;;;OAKG;IACH,OAFU,UAAU,CAEK;IA6EzB;;OAEG;IACH,iCAEC;IAbD;;;OAGG;IACH,4BAEC;IAoBD;;OAEG;IACH,qBAEC;IAhBD;;;;;;OAMG;IACH,gBAEC;IASD;;OAEG;IACH,iCAEC;IA2BD;;;OAGG;IACH,wDAFa,IAAI,CAIhB;IAED;;;OAGG;IACH,wDAFa,IAAI,CAIhB;IAcD;;;;OAIG;IACH,YAJW,KAAK,aACL,WAAW,UACX,MAAM,QAIhB;IAED;;;;OAIG;IACH,cAJW,KAAK,aACL,WAAW,UACX,MAAM,QAQhB;IAED;;;;OAIG;IACH,eAHW,MAAM,GACJ,IAAI,CAIhB;IAED;;;;OAIG;IACH,aAHW,MAAM,GACJ,IAAI,CAIhB;IAED;;;OAGG;IACH,mBAHW,MAAM,GACJ,gBAAc,SAAS,CAInC;IAED;;;;;;OAMG;IACH,mBAJW,MAAM,UACN,MAAM,GACJ,MAAM,CAIlB;IAED;;;;OAIG;IACH,iCAEC;;CAmOJ;6BArkB4B,oCAAoC;4BAIrC,uCAAuC;sBAE7C,YAAY;4CAPU,uDAAuD;oCAI5F,0DAA0D;kCAQ/B,uCAAuC;6BAC5C,qCAAqC;8BALpC,oBAAoB;6BACrB,mBAAmB;yBAEvB,eAAe;yBADf,eAAe;2BAIb,iBAAiB"}

package/src/engine/physics/cloth/ecs/WorkerClothSystem.js

@@ -9,7 +9,10 @@ import { ClothStepParam } from "../solver/cloth_step_instance.js";
 import { Cloth } from "./Cloth.js";
 import { ClothCollider } from "./ClothCollider.js";
 import { ClothExclude } from "./ClothExclude.js";
+import { ClothPin } from "./ClothPin.js";
 import { ClothRig } from "./ClothRig.js";
+import { GPUStateAuthority } from "../../../ecs/gpu/GPUStateAuthority.js";
+import { ParentEntity } from "../../../ecs/parent/ParentEntity.js";
 import { ClothWorld } from "./ClothWorld.js";
 import {
     ClothCommand,
@@ -109,7 +112,12 @@ export class WorkerClothSystem extends WorkerSystem {
         ResourceAccessSpecification.from(TransformAttachment, ResourceAccessKind.Read | ResourceAccessKind.Write),
         ResourceAccessSpecification.from(ClothExclude, ResourceAccessKind.Read),
         ResourceAccessSpecification.from(ClothCollider, ResourceAccessKind.Read),
-        ResourceAccessSpecification.from(ClothRig, ResourceAccessKind.Read)
+        ResourceAccessSpecification.from(ClothRig, ResourceAccessKind.Read),
+        // What holds a cloth, and — to evaluate a holder a clip drives — the
+        // model it belongs to and who composes its transform.
+        ResourceAccessSpecification.from(ClothPin, ResourceAccessKind.Read),
+        ResourceAccessSpecification.from(ParentEntity, ResourceAccessKind.Read),
+        ResourceAccessSpecification.from(GPUStateAuthority, ResourceAccessKind.Read)
     ];
 
     /**
@@ -227,19 +235,6 @@ export class WorkerClothSystem extends WorkerSystem {
         return this.world.instances;
     }
 
-    /**
-     * @returns {{instance_of: function(number): (PrefabInstance|null)}|null}
-     */
-    get models() {
-        return this.world.models;
-    }
-
-    /**
-     * @param {{instance_of: function(number): (PrefabInstance|null)}|null} value
-     */
-    set models(value) {
-        this.world.models = value;
-    }
 
     /**
      * @returns {Worker}
@@ -341,6 +336,17 @@ export class WorkerClothSystem extends WorkerSystem {
         return this.world.instanceOf(entity);
     }
 
+    /**
+     * Which particle of a cloth an entity is, for a {@link ClothPin} that has
+     * the entity in hand — see {@link ClothWorld#particle_of}.
+     * @param {number} cloth the entity carrying the `Cloth`
+     * @param {number} entity
+     * @returns {number} the particle, or `−1`
+     */
+    particle_of(cloth, entity) {
+        return this.world.particle_of(cloth, entity);
+    }
+
     /**
      * @returns {boolean} whether cloth *particle state* may currently be read
      *          from the main thread. False while a step is in flight. The poses

package/src/engine/physics/cloth/ecs/cloth_build_rows.d.ts

@@ -5,8 +5,52 @@
  */
 export function cloth_build_children(instance: ClothInstance): void;
 /**
- * Rows, geodesics and the `ClothState` itself, from a seeded
- * `node_parent` / `animated_position` pair.
+ * The particle graph of a tree: a fabric edge from every node to its parent,
+ * and a skip pair from every node to its grandparent.
+ *
+ * The skip pair is a chain's bending model (`cloth_seed_subtree.js` carries the
+ * argument), and it is part of the graph rather than something the row builder
+ * derives from a parent array, so that the row builder never needs one.
+ *
+ * @param {ClothInstance} instance with {@link ClothInstance#node_parent} set
+ * @returns {void}
+ */
+export function cloth_tree_graph(instance: ClothInstance): void;
+/**
+ * The triangles around each node, CSR, and one neighbour per node to measure a
+ * tangent by — what `cloth_reconstruct_pose` turns a sheet's joints with. A
+ * cloth with no triangles gets none.
+ *
+ * @param {ClothInstance} instance with {@link ClothInstance#triangle} and
+ *   {@link ClothInstance#edge} set
+ * @returns {void}
+ */
+export function cloth_build_surface(instance: ClothInstance): void;
+/**
+ * How much a hinge resists, as a stiffness, for a fabric's `bend` ratio.
+ *
+ * The same rule the skip row follows: a ratio of the row's own effective
+ * inertia over the fixed step squared. A hinge's gradient on particle `k` is
+ * `w_k` along each axis, so its effective inertia is `1 / Σ (w_k² / m_k)` —
+ * `m / Σ w_k²` with one mass — and a hinge across a sliver, whose cotangents are
+ * large, is softer per unit `C` for exactly the reason its `C` is larger. A
+ * stiffness in newtons per metre, which is what Bergou's `6·modulus/A` is,
+ * would leave M0's dissipative band wherever the triangles are thin.
+ *
+ * @param {Float32Array} weight 4 per hinge
+ * @param {number} hinge
+ * @returns {number} the hinge's effective inertia, kg
+ */
+export function cloth_hinge_inertia(weight: Float32Array, hinge: number): number;
+/**
+ * Rows and the `ClothState` itself, from a seeded rest pose and the graph over
+ * it.
+ *
+ * **Nothing is held here.** Every particle is built free, with a tether row and
+ * — when the fabric is leashed at all — a slack row of radius `Infinity`, which
+ * say nothing until `cloth_apply_holds` points them at what the particle hangs
+ * from. The shape of the leash table is fixed by the particle count, so holding
+ * and letting go rewrite numbers in it rather than building it again.
  *
  * @param {ClothInstance} instance
  * @param {number} dt
@@ -53,12 +97,19 @@ export function cloth_dynamics_change_needs_reseed(before: ClothDynamics, after:
  * proxy's baked joint list — and what they do identically is everything after
  * that, because a row does not care what a node was made of.
  *
- * So the split is: a seeder produces `node_parent` and `animated_position`, and
- * {@link cloth_build_rows} turns those into geodesics, link rows, strain-limit
- * rows, skip rows, leashes and the `ClothState` itself. M3 moved this out of
- * `cloth_seed_subtree.js` unchanged rather than writing a second copy for the
- * rig path, which is the whole reason §11 could say "the solver is identical
- * either way; only seeding and write-back differ" and mean it.
+ * So the split is: a seeder produces the particles' rest pose and the **graph**
+ * joining them — {@link ClothInstance#edge}, {@link ClothInstance#skip},
+ * {@link ClothInstance#hinge} — and {@link cloth_build_rows} turns those into
+ * geodesics, fabric rows, strain-limit rows, bending rows, leashes and the
+ * `ClothState` itself. M3 moved this out of `cloth_seed_subtree.js` unchanged
+ * rather than writing a second copy for the rig path, which is the whole reason
+ * §11 could say "the solver is identical either way; only seeding and
+ * write-back differ" and mean it.
+ *
+ * The rows are built from a graph rather than from a parent array because a row
+ * is a pair or a quad and has no use for a parent. A tree hands over its parent
+ * links and its skip pairs ({@link cloth_tree_graph}); a mesh would hand over
+ * its edges and hinges; the rows below are the same code either way.
  *
  * @author Alex Goldring
  * @copyright Company Named Limited (c) 2026
@@ -73,9 +124,10 @@ export const CLOTH_PARTICLE_MASS: number;
  * Slack radius at `ClothDynamics#slack = 1`, as a multiple of `d_geo`.
  *
  * It is **2**, and that is a derivation rather than a taste. The tether row
- * already holds every particle within `d_geo` of the anchor, and the animated
- * position it is leashed to is itself within `d_geo` of the anchor — a chord is
- * never longer than the arc it subtends. By the triangle inequality the two can
+ * already holds every particle within `d_geo` of the held particle it hangs
+ * from, and the animated position it is leashed to is itself within `d_geo` of
+ * that particle — a chord is never longer than the arc it subtends, and the
+ * animated pose is the rest pose hung from it (`ClothInstance#animated_position`). By the triangle inequality the two can
  * therefore never be more than `2·d_geo` apart, so a slack radius of `2·d_geo`
  * is **provably inactive** and `slack = 1` means exactly "no leash" with no
  * sentinel value and no discontinuity to code around.

package/src/engine/physics/cloth/ecs/cloth_build_rows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloth_build_rows.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/physics/cloth/ecs/cloth_build_rows.js"],"names":[],"mappings":"AAuDA;;;;GAIG;AACH,+DAFa,IAAI,CAyBhB;AAID;;;;;;;GAOG;AACH,8DAHW,MAAM,GACJ,IAAI,CA6LhB;AAWD;;;;;;;;;;;;;;;;GAgBG;AACH,kEAHW,MAAM,GACJ,IAAI,CAoChB;AAED;;;;;;;;;;;GAWG;AACH,iGAFa,OAAO,CAkBnB;AAjXD;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;GAIG;AACH,kCAFU,MAAM,CAEwB;AAIxC;;;;;;;;;;;;;;;;GAgBG;AACH,gCAFU,MAAM,CAEmB"}
+{"version":3,"file":"cloth_build_rows.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/physics/cloth/ecs/cloth_build_rows.js"],"names":[],"mappings":"AAiEA;;;;GAIG;AACH,+DAFa,IAAI,CA6BhB;AAED;;;;;;;;;;GAUG;AACH,2DAFa,IAAI,CA6BhB;AAED;;;;;;;;GAQG;AACH,8DAFa,IAAI,CA2DhB;AAED;;;;;;;;;;;;;;GAcG;AACH,4CAJW,YAAY,SACZ,MAAM,GACJ,MAAM,CAYlB;AAkBD;;;;;;;;;;;;;GAaG;AACH,8DAHW,MAAM,GACJ,IAAI,CAoOhB;AAWD;;;;;;;;;;;;;;;;GAgBG;AACH,kEAHW,MAAM,GACJ,IAAI,CAiEhB;AAED;;;;;;;;;;;GAWG;AACH,iGAFa,OAAO,CAkBnB;AA5lBD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH;;;;GAIG;AACH,kCAFU,MAAM,CAEwB;AAIxC;;;;;;;;;;;;;;;;;GAiBG;AACH,gCAFU,MAAM,CAEmB"}