@woosh/meep-engine 3.52.0 → 3.53.0

package/package.json

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

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/graphics3/AnimationGraphSystem.d.ts

@@ -1,12 +1,13 @@
 /**
- * Drives every entity's {@link AnimationGraphController}: runs its clock, and tells the renderer
- * what its clips weigh and where they are playing.
+ * Drives every entity's {@link AnimationGraphController}: runs its clock, writes its clips' weights
+ * and times into the entity's {@link AnimationClips}, and hands that blend to the renderer through
+ * {@link AnimationClipsSink}.
  *
  * **The clips are the entity's {@link AnimationClips}.** An entity is driven while it carries both
  * components, whoever put them there — a model `MeshSystem` loaded, or a rig built in code. New
  * clips are a new component, which this system sees as the entity leaving and coming back.
  *
- * **Every node the clips key holds a row here** ({@link hold_clip_targets}), from the graph being
+ * **Every node the clips key holds a row here** ({@link AnimationClipsSink}), from the graph being
  * bound to the clips until they go. A clip binds only once all of them do, and a keyed node outside
  * every skin with nothing drawn under it — a socket, say — is held by no other system.
  *
@@ -27,8 +28,8 @@ export class AnimationGraphSystem extends System<any> {
      * @param {Scene} scene
      */
     constructor(graphics: GraphicsEngine, scene: Scene);
-    dependencies: (typeof AnimationGraphController | typeof AnimationClips)[];
-    components_used: ResourceAccessSpecification<typeof AnimationGraphController>[];
+    dependencies: (typeof AnimationClips | typeof AnimationGraphController)[];
+    components_used: (ResourceAccessSpecification<typeof AnimationClips> | ResourceAccessSpecification<typeof AnimationGraphController>)[];
     /**
      * Only noted here: the graph is bound to the clips by the next {@link update}. A link can happen
      * anywhere the components are added — inside a model's spawn, for one `MeshSystem` loads — and a
@@ -41,21 +42,8 @@ export class AnimationGraphSystem extends System<any> {
      */
     link(controller: AnimationGraphController, clips: AnimationClips, entity: number): void;
     /**
-     * What the entity is playing, in the form the CPU pose evaluator takes: one entry per clip
-     * **this graph names**, at the weight and the time the renderer has been given.
-     *
-     * **The clips the graph does not name are not here, because they are not registered** (D37).
-     * The GPU's accumulator marks a joint dirty for every bound clip that writes to it, weight and
-     * all — so a bound clip at weight zero resolves the joints only it drives to zero rather than
-     * leaving them at rest. The answer is not to hand those clips to the evaluator so it can make
-     * the same mistake; it is not to bind them. What the graph never names, nothing plays, and the
-     * joints it alone would have driven stay where they rest.
-     *
-     * A clip the graph names but is not currently playing **is** here, at weight zero, because it is
-     * bound and the accumulator does see it.
-     *
-     * The entries are this system's own and are rewritten by the next call, which is what keeps a
-     * query on a per-frame path from allocating.
+     * What the entity is playing, in the form the CPU pose evaluator takes: delegates to the
+     * entity's {@link AnimationClips#write_pose_playbacks}.
      *
      * @param {PosePlayback[]} target appended to
      * @param {number} entity
@@ -75,8 +63,7 @@ export class AnimationGraphSystem extends System<any> {
     #private;
 }
 import { System } from "../ecs/System.js";
-import { AnimationGraphController } from "./animation/AnimationGraphController.js";
 import { AnimationClips } from "./animation/AnimationClips.js";
+import { AnimationGraphController } from "./animation/AnimationGraphController.js";
 import { ResourceAccessSpecification } from "../../core/model/ResourceAccessSpecification.js";
-import { PosePlayback } from "../../shade/renderer/animation/pose/PosePlayback.js";
 //# sourceMappingURL=AnimationGraphSystem.d.ts.map

package/src/engine/graphics3/AnimationGraphSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnimationGraphSystem.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/AnimationGraphSystem.js"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH;IAyBI;;;OAGG;IACH,oDAgBC;IAPG,0EAA8D;IAI9D,gFAEC;IAGL;;;;;;;;;OASG;IACH,iBAJW,wBAAwB,SACxB,cAAc,UACd,MAAM,QAehB;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,6BANW,YAAY,EAAE,UACd,MAAM,GACJ,OAAO,CAgDnB;IAED;;;;OAIG;IACH,mBAJW,wBAAwB,SACxB,cAAc,UACd,MAAM,QAkBhB;IAED,2CAaC;IAED,4CAWC;;CA2JJ;uBAvXsB,kBAAkB;yCAEA,yCAAyC;+BADnD,+BAA+B;4CAHlB,iDAAiD;6BAChE,qDAAqD"}
+{"version":3,"file":"AnimationGraphSystem.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/AnimationGraphSystem.js"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH;IAWI;;;OAGG;IACH,oDAcC;IATG,0EAA8D;IAK9D,uIAGC;IAGL;;;;;;;;;OASG;IACH,iBAJW,wBAAwB,SACxB,cAAc,UACd,MAAM,QAShB;IAED;;;;;;;;;OASG;IACH,6BANW,cAAc,UACd,MAAM,GACJ,OAAO,CAYnB;IAED;;;;OAIG;IACH,mBAJW,wBAAwB,SACxB,cAAc,UACd,MAAM,QAYhB;IAED,2CAEC;IAED,4CAYC;;CAoGJ;uBAxOsB,kBAAkB;+BACV,+BAA+B;yCAErB,yCAAyC;4CAJtC,iDAAiD"}