@woosh/meep-engine 3.52.0 → 3.54.0

package/package.json

@@ -6,7 +6,7 @@
   "description": "Advanced 3D game engine",
   "type": "module",
   "author": "Alexander Goldring",
-  "version": "3.52.0",
+  "version": "3.54.0",
   "exports": {
     "./build/*": "./build/*",
     "./src/*": "./src/*",

package/src/core/math/noise/worley_noise_2d.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Evaluates a seamlessly tileable 2D cellular Worley (Voronoi) noise on `[0, 1)^2`
+ * with periodic lattice dimensions `(cells_u, cells_v)`.
+ * Writes `[F1, F2 - F1, cell_id]` into `out`.
+ *
+ * @param {Float32Array|number[]} out
+ * @param {number} u
+ * @param {number} v
+ * @param {number} cells_u
+ * @param {number} cells_v
+ * @param {number} seed
+ */
+export function worley_noise_2d(out: Float32Array | number[], u: number, v: number, cells_u: number, cells_v: number, seed: number): void;
+//# sourceMappingURL=worley_noise_2d.d.ts.map

package/src/core/math/noise/worley_noise_2d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worley_noise_2d.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/noise/worley_noise_2d.js"],"names":[],"mappings":"AAgBA;;;;;;;;;;;GAWG;AACH,qCAPW,YAAY,GAAC,MAAM,EAAE,KACrB,MAAM,KACN,MAAM,WACN,MAAM,WACN,MAAM,QACN,MAAM,QA+ChB"}

package/src/core/math/noise/worley_noise_2d.js

@@ -0,0 +1,74 @@
+import { clamp } from "../clamp.js";
+
+/**
+ * Fast deterministic integer hash in [0, 1).
+ * @param {number} ix
+ * @param {number} iy
+ * @param {number} seed
+ * @returns {number}
+ */
+function cell_hash_01(ix, iy, seed) {
+    let h = (ix * 374761393 + iy * 668265263 + seed * 1442695041) | 0;
+    h = Math.imul(h ^ (h >>> 13), 1274126177);
+    h = (h ^ (h >>> 16)) >>> 0;
+    return h / 4294967296.0;
+}
+
+/**
+ * Evaluates a seamlessly tileable 2D cellular Worley (Voronoi) noise on `[0, 1)^2`
+ * with periodic lattice dimensions `(cells_u, cells_v)`.
+ * Writes `[F1, F2 - F1, cell_id]` into `out`.
+ *
+ * @param {Float32Array|number[]} out
+ * @param {number} u
+ * @param {number} v
+ * @param {number} cells_u
+ * @param {number} cells_v
+ * @param {number} seed
+ */
+export function worley_noise_2d(out, u, v, cells_u, cells_v, seed) {
+    const cu = Math.max(1, cells_u | 0);
+    const cv = Math.max(1, cells_v | 0);
+    const u_wrap = ((u % 1.0) + 1.0) % 1.0;
+    const v_wrap = ((v % 1.0) + 1.0) % 1.0;
+
+    const gx = u_wrap * cu;
+    const gy = v_wrap * cv;
+    const ix0 = Math.floor(gx);
+    const iy0 = Math.floor(gy);
+
+    let d1 = 1e9;
+    let d2 = 1e9;
+    let best_id = 0.0;
+
+    for (let dy = -1; dy <= 1; dy++) {
+        const ny = iy0 + dy;
+        const wy = ((ny % cv) + cv) % cv;
+        for (let dx = -1; dx <= 1; dx++) {
+            const nx = ix0 + dx;
+            const wx = ((nx % cu) + cu) % cu;
+
+            const jx = cell_hash_01(wx, wy, seed);
+            const jy = cell_hash_01(wx, wy, seed ^ 0x6C8E9CF5);
+            const cid = cell_hash_01(wx, wy, seed ^ 0xB5297A4D);
+
+            const px = nx + 0.15 + 0.70 * jx - gx;
+            const py = ny + 0.15 + 0.70 * jy - gy;
+            const dist2 = px * px + py * py;
+
+            if (dist2 < d1) {
+                d2 = d1;
+                d1 = dist2;
+                best_id = cid;
+            } else if (dist2 < d2) {
+                d2 = dist2;
+            }
+        }
+    }
+
+    const f1 = Math.sqrt(d1);
+    const f2 = Math.sqrt(d2);
+    out[0] = f1;
+    out[1] = clamp(f2 - f1, 0.0, 1.0);
+    out[2] = best_id;
+}

package/src/engine/ecs/animation/Animation.d.ts

@@ -8,38 +8,17 @@ export class Animation {
      * @returns {Animation}
      */
     static fromJSON(json: any): Animation;
-    /**
-     * Takes nothing. Build the component, then populate it — {@link Animation.fromJSON} for the
-     * serialized form, or `clips.add(...)` for clips you already hold.
-     *
-     * It used to take an options object, forwarded straight to {@link fromJSON}, while its own
-     * docblock declared `@property {List.<AnimationClip>} clips` and the field is declared
-     * `@type {List<AnimationClip>}`. Both named the component type; `fromJSON` calls
-     * `this.clips.fromJSON(json.clips, AnimationClip)`, which wants **plain objects**. So
-     * `new Animation({clips: [clip1, clip2]})` with real {@link AnimationClip} instances built an
-     * Animation whose list was the right length, whose entries were real clips, and whose every
-     * clip name was the empty string. Nothing then matched any clip in the model, `ClipListPlayer`
-     * produced zero playbacks, and the entity stood still — with no error anywhere, because the
-     * documented type and the accepted type were both silently tolerated. Reported from a port as
-     * GAP-015, at 40 minutes spent believing the model had not loaded.
-     *
-     * The ambiguity is removed rather than widened: there is now one way in per representation,
-     * and neither is the constructor.
-     *
-     * @constructor
-     */
-    constructor(...args: any[]);
     /**
      *
      * @type {List<AnimationClip>}
      */
     clips: List<AnimationClip>;
-    debtTime: number;
     /**
-     * @protected
-     * @type {Future|null}
+     * How far behind is this animation currently? Need to play catchup.
+     * used primarily for culling and synchronization.
+     * @type {number}
      */
-    protected mixer: Future | null;
+    debtTime: number;
     /**
      *
      * @type {number}

package/src/engine/ecs/animation/Animation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Animation.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/animation/Animation.js"],"names":[],"mappings":"AAOA;;GAEG;AACH;IAyII;;;;OAIG;IACH,4BAFa,SAAS,CAMrB;IAzID;;;;;;;;;;;;;;;;;;;OAmBG;IACH,4BAqBC;IAjDD;;;OAGG;IACH,OAFU,KAAK,aAAa,CAAC,CAEV;IAEnB,iBAAa;IAgCT;;;OAGG;IACH,iBAFU,SAAO,IAAI,CAEJ;IAEjB;;;OAGG;IACH,OAFU,MAAM,CAEoD;IAWxE;;;OAGG;IACH,0BAEC;IAdD;;;OAGG;IACH,yBAEC;IAUD;;;;OAIG;IACH,cAHW,MAAM,GAAC,cAAc,GACnB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,cAAc,GACnB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,cAAc,SACrB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,cAAc,GACnB,OAAO,CAInB;IAED;;;;OAIG;IACH,cAHW,SAAS,GACP,OAAO,CAanB;IAED;;;OAGG;IACH,QAFa,MAAM,CAOlB;IAaD,0BAYC;IAED;;;MAKC;IAIL;;;OAGG;IACH,sBAFU,OAAO,CAEc;CAN9B;;kBAUS,MAAM;;iBA3LC,uCAAuC;8BAE1B,oBAAoB;+BACnB,qBAAqB"}
+{"version":3,"file":"Animation.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/animation/Animation.js"],"names":[],"mappings":"AAMA;;GAEG;AACH;IA0GI;;;;OAIG;IACH,4BAFa,SAAS,CAMrB;IAlHD;;;OAGG;IACH,OAFU,KAAK,aAAa,CAAC,CAEV;IAEnB;;;;OAIG;IACH,UAFU,MAAM,CAEH;IAEb;;;OAGG;IACH,OAFU,MAAM,CAEgD;IAWhE;;;OAGG;IACH,0BAEC;IAdD;;;OAGG;IACH,yBAEC;IAUD;;;;OAIG;IACH,cAHW,MAAM,GAAC,cAAc,GACnB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,cAAc,GACnB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,cAAc,SACrB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,cAAc,GACnB,OAAO,CAInB;IAED;;;;OAIG;IACH,cAHW,SAAS,GACP,OAAO,CAanB;IAED;;;OAGG;IACH,QAFa,MAAM,CAOlB;IAaD,0BAYC;IAED;;;MAKC;IAIL;;;OAGG;IACH,sBAFU,OAAO,CAEc;CAN9B;;kBAUS,MAAM;;iBA7JC,uCAAuC;8BAG1B,oBAAoB;+BACnB,qBAAqB"}

package/src/engine/ecs/animation/Animation.js

@@ -1,6 +1,5 @@
-import { assert } from "../../../core/assert.js";
-import { hash_mix2 } from "../../../core/math/hash/hash_mix2.js";
 import List from '../../../core/collection/list/List.js';
+import { hash_mix2 } from "../../../core/math/hash/hash_mix2.js";
 import { computeHashFloat } from "../../../core/primitives/numbers/computeHashFloat.js";
 import { AnimationClip } from "./AnimationClip.js";
 import { AnimationFlags } from "./AnimationFlags.js";
@@ -15,50 +14,19 @@ export class Animation {
      */
     clips = new List();
 
+    /**
+     * How far behind is this animation currently? Need to play catchup.
+     * used primarily for culling and synchronization.
+     * @type {number}
+     */
     debtTime = 0;
 
     /**
-     * Takes nothing. Build the component, then populate it — {@link Animation.fromJSON} for the
-     * serialized form, or `clips.add(...)` for clips you already hold.
      *
-     * It used to take an options object, forwarded straight to {@link fromJSON}, while its own
-     * docblock declared `@property {List.<AnimationClip>} clips` and the field is declared
-     * `@type {List<AnimationClip>}`. Both named the component type; `fromJSON` calls
-     * `this.clips.fromJSON(json.clips, AnimationClip)`, which wants **plain objects**. So
-     * `new Animation({clips: [clip1, clip2]})` with real {@link AnimationClip} instances built an
-     * Animation whose list was the right length, whose entries were real clips, and whose every
-     * clip name was the empty string. Nothing then matched any clip in the model, `ClipListPlayer`
-     * produced zero playbacks, and the entity stood still — with no error anywhere, because the
-     * documented type and the accepted type were both silently tolerated. Reported from a port as
-     * GAP-015, at 40 minutes spent believing the model had not loaded.
-     *
-     * The ambiguity is removed rather than widened: there is now one way in per representation,
-     * and neither is the constructor.
-     *
-     * @constructor
+     * @type {number}
      */
-    constructor() {
-        /*
-         Dropping the parameter silently would ship a fresh instance of the exact failure this
-         change exists to remove: `new Animation(json)` worked, and would now build an empty
-         component with no error and no animation. A removal has to be loud or it is not an
-         improvement on the trap. Named rather than asserted generically, because the message is
-         the migration.
-        */
-        assert.equal(arguments.length, 0, 'Animation takes no constructor arguments; use Animation.fromJSON(json) for the serialized form, or clips.add(clip) for clips you already hold');
-
-        /**
-         * @protected
-         * @type {Future|null}
-         */
-        this.mixer = null;
-
-        /**
-         *
-         * @type {number}
-         */
-        this.flags = AnimationFlags.MeshSizeCulling | AnimationFlags.Playing;
-    }
+    flags = AnimationFlags.MeshSizeCulling | AnimationFlags.Playing;
+
 
     /**
      *

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

@@ -24,8 +24,8 @@
  * A target hanging below another goal's bones in the same group is read from the solver's frames on
  * every iteration. One hanging below another group's bones waits for that group to solve and write.
  *
- * Declared access: IK reads {@link Animation} and {@link AnimationGraphController}, which their
- * drivers write, so it runs after the drivers have set this tick's clip times. A system that places a
+ * Declared access: IK reads {@link AnimationClips}, which the animation drivers write, so it runs
+ * after the drivers have set this tick's clip times. A system that places a
  * target through its own `TransformAttachment` (a physics contact probe) reads and writes that
  * component as IK does: declared access leaves the two a cycle, and the scheduler keeps their
  * registration order, so register it first.
@@ -36,7 +36,7 @@
 export class IKGoalSystem extends System<any> {
     constructor();
     dependencies: (typeof TransformAttachment | typeof IKGoal)[];
-    components_used: (ResourceAccessSpecification<typeof Transform64> | ResourceAccessSpecification<typeof AnimationGraphController> | ResourceAccessSpecification<typeof Animation> | ResourceAccessSpecification<typeof IKGoal> | ResourceAccessSpecification<typeof TransformAttachment> | ResourceAccessSpecification<typeof GPUStateAuthority> | ResourceAccessSpecification<typeof ParentEntity> | ResourceAccessSpecification<typeof Joint>)[];
+    components_used: (ResourceAccessSpecification<typeof Transform64> | ResourceAccessSpecification<typeof IKGoal> | ResourceAccessSpecification<typeof TransformAttachment> | ResourceAccessSpecification<typeof GPUStateAuthority> | ResourceAccessSpecification<typeof ParentEntity> | ResourceAccessSpecification<typeof Joint> | ResourceAccessSpecification<typeof AnimationClips>)[];
     /**
      * The most iterations a frame FABRIK solve runs.
      * @type {number}
@@ -67,9 +67,8 @@ import { TransformAttachment } from "../transform-attachment/TransformAttachment
 import { IKGoal } from "./IKGoal.js";
 import { Transform64 } from "../transform/Transform64.js";
 import { ResourceAccessSpecification } from "../../../core/model/ResourceAccessSpecification.js";
-import { AnimationGraphController } from "../../graphics3/animation/AnimationGraphController.js";
-import { Animation } from "../animation/Animation.js";
 import { GPUStateAuthority } from "../gpu/GPUStateAuthority.js";
 import { ParentEntity } from "../parent/ParentEntity.js";
 import { Joint } from "../../physics/ecs/Joint.js";
+import { AnimationClips } from "../../graphics3/animation/AnimationClips.js";
 //# sourceMappingURL=IKGoalSystem.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"IKGoalSystem.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/ik/IKGoalSystem.js"],"names":[],"mappings":"AA0OA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH;;IAEI,6DAA6C;IAE7C,kbASE;IAEF;;;OAGG;IACH,gBAFU,MAAM,CAEI;IAEpB;;;OAGG;IACH,WAFU,MAAM,CAEC;IAkDjB;;;;OAIG;IACH,WAJW,MAAM,cACN,mBAAmB,UACnB,MAAM,QAgChB;IAED;;;;OAIG;IACH,aAJW,MAAM,cACN,mBAAmB,UACnB,MAAM,QAkBhB;IAED,sCA+BC;;CA6nBJ;uBA1hCsB,cAAc;oCAED,gDAAgD;uBAQ7D,aAAa;4BAD7B,6BAA6B;4CA3BQ,oDAAoD;yCAEvD,uDAAuD;0BAQtE,2BAA2B;kCAEnB,6BAA6B;6BAIlC,2BAA2B;sBAPlC,4BAA4B"}
+{"version":3,"file":"IKGoalSystem.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/ik/IKGoalSystem.js"],"names":[],"mappings":"AAyOA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH;;IAEI,6DAA6C;IAE7C,wXAQE;IAEF;;;OAGG;IACH,gBAFU,MAAM,CAEI;IAEpB;;;OAGG;IACH,WAFU,MAAM,CAEC;IAkDjB;;;;OAIG;IACH,WAJW,MAAM,cACN,mBAAmB,UACnB,MAAM,QAgChB;IAED;;;;OAIG;IACH,aAJW,MAAM,cACN,mBAAmB,UACnB,MAAM,QAkBhB;IAED,sCA+BC;;CA6nBJ;uBAzhCsB,cAAc;oCAED,gDAAgD;uBAQ7D,aAAa;4BAD7B,6BAA6B;4CA1BQ,oDAAoD;kCAW9D,6BAA6B;6BAIlC,2BAA2B;sBANlC,4BAA4B;+BAPnB,6CAA6C"}

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

@@ -4,7 +4,7 @@ import Vector3 from "../../../core/geom/Vector3.js";
 import { ResourceAccessKind } from "../../../core/model/ResourceAccessKind.js";
 import { ResourceAccessSpecification } from "../../../core/model/ResourceAccessSpecification.js";
 import { pose_evaluate_local } from "../../../shade/renderer/animation/pose/pose_evaluate_local.js";
-import { AnimationGraphController } from "../../graphics3/animation/AnimationGraphController.js";
+import { AnimationClips } from "../../graphics3/animation/AnimationClips.js";
 import { collect_entity_playbacks } from "../../graphics3/pose/collect_entity_playbacks.js";
 import { FrameFabrikProblem } from "../../physics/inverse_kinematics/frame_fabrik/FrameFabrikProblem.js";
 import { frame_fabrik_limit_from_joint } from "../../physics/inverse_kinematics/frame_fabrik/frame_fabrik_limit_from_joint.js";
@@ -12,7 +12,6 @@ import { frame_fabrik_solve } from "../../physics/inverse_kinematics/frame_fabri
 import { joint_hinge_mid_axis } from "../../physics/inverse_kinematics/joint_hinge_mid_axis.js";
 import { two_bone_path_solve } from "../../physics/inverse_kinematics/two_bone_path_solve.js";
 import { Joint } from "../../physics/ecs/Joint.js";
-import { Animation } from "../animation/Animation.js";
 import { EventType } from "../EventType.js";
 import { GPUStateAuthority } from "../gpu/GPUStateAuthority.js";
 import { GPUStateAuthorityFlags } from "../gpu/GPUStateAuthorityFlags.js";
@@ -258,8 +257,8 @@ const q_2 = new Quaternion();
  * A target hanging below another goal's bones in the same group is read from the solver's frames on
  * every iteration. One hanging below another group's bones waits for that group to solve and write.
  *
- * Declared access: IK reads {@link Animation} and {@link AnimationGraphController}, which their
- * drivers write, so it runs after the drivers have set this tick's clip times. A system that places a
+ * Declared access: IK reads {@link AnimationClips}, which the animation drivers write, so it runs
+ * after the drivers have set this tick's clip times. A system that places a
  * target through its own `TransformAttachment` (a physics contact probe) reads and writes that
  * component as IK does: declared access leaves the two a cycle, and the scheduler keeps their
  * registration order, so register it first.
@@ -278,8 +277,7 @@ export class IKGoalSystem extends System {
         ResourceAccessSpecification.from(GPUStateAuthority, ResourceAccessKind.Read | ResourceAccessKind.Write),
         ResourceAccessSpecification.from(ParentEntity, ResourceAccessKind.Read),
         ResourceAccessSpecification.from(Joint, ResourceAccessKind.Read),
-        ResourceAccessSpecification.from(Animation, ResourceAccessKind.Read),
-        ResourceAccessSpecification.from(AnimationGraphController, ResourceAccessKind.Read),
+        ResourceAccessSpecification.from(AnimationClips, ResourceAccessKind.Read),
     ];
 
     /**

package/src/engine/graphics/ecs/mesh/assetTypeByPath.js

@@ -25,7 +25,7 @@ export function assetTypeByPath(url) {
             case "usdz":
                 return "model/vnd.usd";
             default:
-                console.warn(`Unknown 3d mesh format extension: '${ext}'`);
+                console.warn(`Unknown asset format extension: '${ext}'`);
                 return null;
         }
     }

package/src/engine/graphics/texture/atlas/CachingTextureAtlas.d.ts

@@ -27,7 +27,12 @@ export class CachingTextureAtlas extends AbstractTextureAtlas {
      * @type {TextureAtlas}
      * @private
      */
-    private __atals;
+    private __atlas;
+    /**
+     * @param {AtlasPatch} patch
+     * @private
+     */
+    private __handle_patch_removed;
     /**
      * Finds an entry in the cache to evict
      * @returns {number}

package/src/engine/graphics/texture/atlas/CachingTextureAtlas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CachingTextureAtlas.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/texture/atlas/CachingTextureAtlas.js"],"names":[],"mappings":"AAgBA;;;;;;;;GAQG;AACH;IAQI;;;;OAIG;IACH;QAFyC,KAAK,EAAnC,oBAAoB;OAa9B;IAvBD;;;;OAIG;IACH,yBAAsB;IAYlB;;;;OAIG;IACH,gBAAoB;IAGxB;;;;OAIG;IACH,+BAoBC;IAED;;;;;;OAMG;IACH,kCA6CC;IAED;;;;OAIG;IACH,gBAMC;IAED;;;OAGG;IACH,oBAIC;IAED;;;;;;OAMG;IACH,oBAyBC;IAuBD;;;OAGG;IACH,kCAEC;IAED;;;OAGG;IACH,yBAEC;IAED,cAGC;IAED;;;;;OAKG;IACH,kCAUC;IAED;;;;;OAKG;IACH,2CAUC;IAED,yCA2BC;CA8BJ;qCApUoC,2BAA2B"}
+{"version":3,"file":"CachingTextureAtlas.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/texture/atlas/CachingTextureAtlas.js"],"names":[],"mappings":"AAiBA;;;;;;;;GAQG;AACH;IAQI;;;;OAIG;IACH;QAFyC,KAAK,EAAnC,oBAAoB;OAiB9B;IA3BD;;;;OAIG;IACH,yBAAsB;IAYlB;;;;OAIG;IACH,gBAAoB;IAOxB;;;OAGG;IACH,+BAMC;IAED;;;;OAIG;IACH,+BAoBC;IAED;;;;;;OAMG;IACH,kCA6CC;IAED;;;;OAIG;IACH,gBAMC;IAED;;;OAGG;IACH,oBAIC;IAED;;;;;;OAMG;IACH,oBAyBC;IAwCD;;;OAGG;IACH,kCAEC;IAED;;;OAGG;IACH,yBAEC;IAED,cAGC;IAED;;;;;OAKG;IACH,kCAUC;IAED;;;;;OAKG;IACH,2CAUC;IAED,yCA+BC;CA8BJ;qCA1WoC,2BAA2B"}