@woosh/meep-engine 3.24.0 → 3.25.0

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

@@ -0,0 +1,52 @@
+/**
+ * # Binary serialization for {@link ClothCollider}
+ *
+ * Five scalars, all of them authored, all of them written. §3.5's component is
+ * a marker that opts an existing `(Collider, Transform64)` into the cloth
+ * simulation, so everything it does *not* carry — geometry and friction from
+ * `Collider`, pose from `Transform64` — is already the concern of those two
+ * components' own adapters. There is nothing shared, nothing runtime and
+ * nothing to exclude: the packed record, the swept bounds and the handle are
+ * `ClothColliderIndex`'s, keyed by entity and rebuilt when
+ * `ClothColliderSystem` links the entity, exactly as `_bodyId` is rebuilt on
+ * `PhysicsSystem#link`.
+ *
+ * ## `layer` and `mask` are read back unsigned
+ *
+ * The pair carries `RigidBody` semantics (§3.5) but not `RigidBody`'s
+ * signedness: the default `mask` here is the unsigned `0xFFFFFFFF` and
+ * `ClothCollider.from` asserts `isNonNegativeInteger` on it, so the `| 0` that
+ * `RigidBodySerializationAdapter` and `ColliderSerializationAdapter` both apply
+ * would hand back `-1` and break the component's own contract.
+ * {@link ClothSerializationAdapter} has the long form of this, and the two
+ * components have to agree about it — a mask filter is evaluated between them.
+ *
+ * ## Version 0, and no upgrader
+ *
+ * A first version has no predecessor stream to upgrade from;
+ * `RigidBodySerializationUpgrader_0_1` is what a later field addition looks
+ * like. The spec's exact-size assertion is what makes a field added without the
+ * bump fail rather than silently shift every following component in a stream.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export class ClothColliderSerializationAdapter extends BinaryClassSerializationAdapter<any> {
+    constructor();
+    klass: typeof ClothCollider;
+    /**
+     *
+     * @param {BinaryBuffer} buffer
+     * @param {ClothCollider} value
+     */
+    serialize(buffer: BinaryBuffer, value: ClothCollider): void;
+    /**
+     *
+     * @param {BinaryBuffer} buffer
+     * @param {ClothCollider} value
+     */
+    deserialize(buffer: BinaryBuffer, value: ClothCollider): void;
+}
+import { BinaryClassSerializationAdapter } from "../../../ecs/storage/binary/BinaryClassSerializationAdapter.js";
+import { ClothCollider } from "./ClothCollider.js";
+//# sourceMappingURL=ClothColliderSerializationAdapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ClothColliderSerializationAdapter.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/physics/cloth/ecs/ClothColliderSerializationAdapter.js"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH;;IAEI,4BAAsB;IAGtB;;;;OAIG;IACH,uCAFW,aAAa,QASvB;IAED;;;;OAIG;IACH,yCAFW,aAAa,QAUvB;CACJ;gDArE+C,gEAAgE;8BAClF,oBAAoB"}

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

@@ -0,0 +1,70 @@
+import { BinaryClassSerializationAdapter } from "../../../ecs/storage/binary/BinaryClassSerializationAdapter.js";
+import { ClothCollider } from "./ClothCollider.js";
+
+/**
+ * # Binary serialization for {@link ClothCollider}
+ *
+ * Five scalars, all of them authored, all of them written. §3.5's component is
+ * a marker that opts an existing `(Collider, Transform64)` into the cloth
+ * simulation, so everything it does *not* carry — geometry and friction from
+ * `Collider`, pose from `Transform64` — is already the concern of those two
+ * components' own adapters. There is nothing shared, nothing runtime and
+ * nothing to exclude: the packed record, the swept bounds and the handle are
+ * `ClothColliderIndex`'s, keyed by entity and rebuilt when
+ * `ClothColliderSystem` links the entity, exactly as `_bodyId` is rebuilt on
+ * `PhysicsSystem#link`.
+ *
+ * ## `layer` and `mask` are read back unsigned
+ *
+ * The pair carries `RigidBody` semantics (§3.5) but not `RigidBody`'s
+ * signedness: the default `mask` here is the unsigned `0xFFFFFFFF` and
+ * `ClothCollider.from` asserts `isNonNegativeInteger` on it, so the `| 0` that
+ * `RigidBodySerializationAdapter` and `ColliderSerializationAdapter` both apply
+ * would hand back `-1` and break the component's own contract.
+ * {@link ClothSerializationAdapter} has the long form of this, and the two
+ * components have to agree about it — a mask filter is evaluated between them.
+ *
+ * ## Version 0, and no upgrader
+ *
+ * A first version has no predecessor stream to upgrade from;
+ * `RigidBodySerializationUpgrader_0_1` is what a later field addition looks
+ * like. The spec's exact-size assertion is what makes a field added without the
+ * bump fail rather than silently shift every following component in a stream.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export class ClothColliderSerializationAdapter extends BinaryClassSerializationAdapter {
+
+    klass = ClothCollider;
+    version = 0;
+
+    /**
+     *
+     * @param {BinaryBuffer} buffer
+     * @param {ClothCollider} value
+     */
+    serialize(buffer, value) {
+        buffer.writeFloat64(value.inflation);
+        buffer.writeFloat64(value.friction_scale);
+
+        buffer.writeUint32(value.layer >>> 0);
+        buffer.writeUint32(value.mask >>> 0);
+        buffer.writeUint32(value.flags >>> 0);
+    }
+
+    /**
+     *
+     * @param {BinaryBuffer} buffer
+     * @param {ClothCollider} value
+     */
+    deserialize(buffer, value) {
+        value.inflation = buffer.readFloat64();
+        value.friction_scale = buffer.readFloat64();
+
+        // Unsigned, deliberately — see the class docblock.
+        value.layer = buffer.readUint32();
+        value.mask = buffer.readUint32();
+        value.flags = buffer.readUint32();
+    }
+}

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

@@ -126,9 +126,18 @@ export class ClothDynamics {
      */
     inertia: number;
     /**
-     * Aerodynamic coupling to the air, `[0, 1]`. §10, and read from M6
-     * onwards; carried here from M1 so that a library entry says what the
-     * fabric is rather than what the current milestone can honour.
+     * Aerodynamic coupling to the air, `[0, 1]`. §10.
+     *
+     * A **relaxation rate** toward whatever the air is doing, linearly mapped
+     * onto `[0, CLOTH_DRAG_RATE_MAX]` by `cloth_drag_response` — `0` is a cloth
+     * the air cannot reach and `1` is one with no aerodynamic memory at all,
+     * taking the air's velocity within a fixed step. The library reads silk at
+     * 0.45 (a 37 ms time constant) down to leather and chain at 0.05 (a third of
+     * a second).
+     *
+     * It only does anything where there is air: a `ClothWorld` with no wind
+     * source feels none, and what a cloth does in air that is *not* moving is
+     * `damping`'s job rather than this one.
      * @type {number}
      */
     drag: number;

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

@@ -1 +1 @@
-{"version":3,"file":"ClothDynamics.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/physics/cloth/ecs/ClothDynamics.js"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH;IAuFI;;;;;;;;;;;;;;;;OAgBG;IACH;QAZyB,OAAO,GAArB,MAAM;QACQ,IAAI,GAAlB,MAAM;QACQ,OAAO,GAArB,MAAM;QACQ,KAAK,GAAnB,MAAM;QACQ,SAAS,GAAvB,MAAM;QACQ,OAAO,GAArB,MAAM;QACQ,IAAI,GAAlB,MAAM;QACQ,QAAQ,GAAtB,MAAM;QACQ,UAAU,GAAxB,MAAM;QACQ,KAAK,GAAnB,MAAM;QACJ,aAAa,CAQzB;IA5GD;;;;;OAKG;IACH,SAFU,MAAM,CAEF;IAEd;;;;OAIG;IACH,MAFU,MAAM,CAEL;IAEX;;;;OAIG;IACH,SAFU,MAAM,CAED;IAEf;;;;;;;OAOG;IACH,OAFU,MAAM,CAEJ;IAEZ;;;;;OAKG;IACH,WAFU,MAAM,CAEC;IAEjB;;;;;OAKG;IACH,SAFU,MAAM,CAEJ;IAEZ;;;;;OAKG;IACH,MAFU,MAAM,CAEL;IAEX;;;;;OAKG;IACH,UAFU,MAAM,CAEH;IAEb;;;;OAIG;IACH,YAFU,MAAM,CAED;IAEf;;;OAGG;IACH,OAFU,MAAM,CAEuB;IAEvC;;;OAGG;IACH,cAHW,MAAM,GAAC,kBAAkB,GACvB,OAAO,CAInB;IAkED;;;;;;OAMG;IACH,SAFa,aAAa,CAiBzB;IAED;;;OAGG;IACH,YAHW,aAAa,GACX,OAAO,CAenB;IAED;;;OAGG;IACH,cAHW,aAAa,GACX,OAAO,CAqBnB;IAED;;OAEG;IACH,QAFa,MAAM,CAelB;IAED;;;;;;;;;;;MAaC;IAED;;OAEG;IACH,eAFW,MAAM,QAIhB;IAED,mBAEC;IAGL;;;OAGG;IACH,0BAFU,OAAO,CAEsB;;CANtC;;;;mCA/TkC,yBAAyB"}
+{"version":3,"file":"ClothDynamics.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/physics/cloth/ecs/ClothDynamics.js"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH;IAgGI;;;;;;;;;;;;;;;;OAgBG;IACH;QAZyB,OAAO,GAArB,MAAM;QACQ,IAAI,GAAlB,MAAM;QACQ,OAAO,GAArB,MAAM;QACQ,KAAK,GAAnB,MAAM;QACQ,SAAS,GAAvB,MAAM;QACQ,OAAO,GAArB,MAAM;QACQ,IAAI,GAAlB,MAAM;QACQ,QAAQ,GAAtB,MAAM;QACQ,UAAU,GAAxB,MAAM;QACQ,KAAK,GAAnB,MAAM;QACJ,aAAa,CAQzB;IArHD;;;;;OAKG;IACH,SAFU,MAAM,CAEF;IAEd;;;;OAIG;IACH,MAFU,MAAM,CAEL;IAEX;;;;OAIG;IACH,SAFU,MAAM,CAED;IAEf;;;;;;;OAOG;IACH,OAFU,MAAM,CAEJ;IAEZ;;;;;OAKG;IACH,WAFU,MAAM,CAEC;IAEjB;;;;;OAKG;IACH,SAFU,MAAM,CAEJ;IAEZ;;;;;;;;;;;;;;OAcG;IACH,MAFU,MAAM,CAEL;IAEX;;;;;OAKG;IACH,UAFU,MAAM,CAEH;IAEb;;;;OAIG;IACH,YAFU,MAAM,CAED;IAEf;;;OAGG;IACH,OAFU,MAAM,CAEuB;IAEvC;;;OAGG;IACH,cAHW,MAAM,GAAC,kBAAkB,GACvB,OAAO,CAInB;IAkED;;;;;;OAMG;IACH,SAFa,aAAa,CAiBzB;IAED;;;OAGG;IACH,YAHW,aAAa,GACX,OAAO,CAenB;IAED;;;OAGG;IACH,cAHW,aAAa,GACX,OAAO,CAqBnB;IAED;;OAEG;IACH,QAFa,MAAM,CAelB;IAED;;;;;;;;;;;MAaC;IAED;;OAEG;IACH,eAFW,MAAM,QAIhB;IAED,mBAEC;IAGL;;;OAGG;IACH,0BAFU,OAAO,CAEsB;;CANtC;;;;mCAxUkC,yBAAyB"}