@woosh/meep-engine 3.15.0 → 3.17.0

package/src/engine/animation/AnimatedActions.js

@@ -1,111 +1,111 @@
-import Vector3 from "../../core/geom/Vector3.js";
-import { SerializationMetadata } from "../ecs/components/SerializationMetadata.js";
-import Entity from "../ecs/Entity.js";
-import { Transform } from "../ecs/transform/Transform.js";
-import { removeComponentsExcept } from "../ecs/util/removeComponentsExcept.js";
-import { SGMesh } from "../graphics/ecs/mesh-v2/aggregate/SGMesh.js";
-import { ParticleEmitter } from "../graphics/particles/particular/engine/emitter/ParticleEmitter.js";
-import { SequenceBehavior } from "../intelligence/behavior/composite/SequenceBehavior.js";
-import { BehaviorComponent } from "../intelligence/behavior/ecs/BehaviorComponent.js";
-import { DieBehavior } from "../intelligence/behavior/ecs/DieBehavior.js";
-import { ActionBehavior } from "../intelligence/behavior/primitive/ActionBehavior.js";
-import { AudioEmitter } from "../sound/ecs/audio/AudioEmitter.js";
-import { shutdownParticleEmitter, stopTrailAndNotifyOnceFinished } from "./AnimationUtils.js";
-import EntityAnimation from "./EntityAnimation.js";
-import AnimationTrack from "./keyed2/AnimationTrack.js";
-import AnimationTrackPlayback from "./keyed2/AnimationTrackPlayback.js";
-import { AnimationBehavior } from "./keyed2/behavior/AnimationBehavior.js";
-import TransitionFunctions from "./TransitionFunctions.js";
-
-
-/**
- *
- * @param {number}  entity
- * @param {EntityComponentDataset} ecd
- * @returns {Promise}
- */
-export function removeEntityStylish(entity, ecd) {
-    //leave only model and transform
-    removeComponentsExcept(ecd, entity, [Transform, SGMesh, ParticleEmitter]);
-
-    const duration = 2;
-
-    //create animation
-    const animation = new EntityAnimation(entity);
-
-    const result = Promise.all([
-        animation.promiseEnd(),
-        stopEntityAndNotifyWhenStopped(entity, ecd)
-    ]).then(function () {
-        ecd.removeEntity(entity);
-    });
-
-
-    animation
-        .translate(new Vector3(0, 2, 0), duration, TransitionFunctions.EaseIn)
-        .fade(0, duration)
-        .start(ecd);
-
-
-    return result;
-}
-
-/**
- * Fade an entity's {@link AudioEmitter} to silence and resolve once it is quiet.
- *
- * The fade is driven on the component's `volume` rather than on the voice: a live volume write reaches
- * the instance gain on both of `AudioEmitterSystem`'s play routes, so this one handle works for a
- * spatially managed emitter and a direct one alike, and it needs no reference to the system.
- *
- * @param {number} entity
- * @param {EntityComponentDataset} ecd
- */
-export async function stopAudioEmitterAndNotifyOnceFinished(entity, ecd) {
-
-    if (!ecd.entityExists(entity)) {
-        return;
-    }
-
-    const audioEmitter = ecd.getComponent(entity, AudioEmitter);
-
-    if (audioEmitter === undefined) {
-        return;
-    }
-
-    const fadeOutDuration = 0.3;
-
-    const volume = audioEmitter.volume;
-
-    const fade = new AnimationTrack(['volume']);
-
-    fade.addKey(0, [volume.getValue()]);
-    fade.addKey(fadeOutDuration, [0]);
-    fade.addTransition(0, TransitionFunctions.Linear);
-
-    //wait out the fade before reporting the emitter as stopped
-    await new Promise(resolve => {
-        new Entity()
-            .add(SerializationMetadata.Transient)
-            .add(BehaviorComponent.from(SequenceBehavior.from([
-                new AnimationBehavior(new AnimationTrackPlayback(fade, v => volume.set(v))),
-                new ActionBehavior(resolve),
-                DieBehavior.create()
-            ])))
-            .build(ecd);
-    });
-}
-
-
-/**
- *
- * @param {number} entity
- * @param {EntityComponentDataset} ecd
- * @returns {Promise}
- */
-export function stopEntityAndNotifyWhenStopped(entity, ecd) {
-    return Promise.all([
-        shutdownParticleEmitter(entity, ecd),
-        stopTrailAndNotifyOnceFinished(entity, ecd),
-        stopAudioEmitterAndNotifyOnceFinished(entity, ecd)
-    ]);
-}
+import Vector3 from "../../core/geom/Vector3.js";
+import { SerializationMetadata } from "../ecs/components/SerializationMetadata.js";
+import Entity from "../ecs/Entity.js";
+import { Transform64 } from "../ecs/transform/Transform64.js";
+import { removeComponentsExcept } from "../ecs/util/removeComponentsExcept.js";
+import { SGMesh } from "../graphics/ecs/mesh-v2/aggregate/SGMesh.js";
+import { ParticleEmitter } from "../graphics/particles/particular/engine/emitter/ParticleEmitter.js";
+import { SequenceBehavior } from "../intelligence/behavior/composite/SequenceBehavior.js";
+import { BehaviorComponent } from "../intelligence/behavior/ecs/BehaviorComponent.js";
+import { DieBehavior } from "../intelligence/behavior/ecs/DieBehavior.js";
+import { ActionBehavior } from "../intelligence/behavior/primitive/ActionBehavior.js";
+import { AudioEmitter } from "../sound/ecs/audio/AudioEmitter.js";
+import { shutdownParticleEmitter, stopTrailAndNotifyOnceFinished } from "./AnimationUtils.js";
+import EntityAnimation from "./EntityAnimation.js";
+import AnimationTrack from "./keyed2/AnimationTrack.js";
+import AnimationTrackPlayback from "./keyed2/AnimationTrackPlayback.js";
+import { AnimationBehavior } from "./keyed2/behavior/AnimationBehavior.js";
+import TransitionFunctions from "./TransitionFunctions.js";
+
+
+/**
+ *
+ * @param {number}  entity
+ * @param {EntityComponentDataset} ecd
+ * @returns {Promise}
+ */
+export function removeEntityStylish(entity, ecd) {
+    //leave only model and transform
+    removeComponentsExcept(ecd, entity, [Transform64, SGMesh, ParticleEmitter]);
+
+    const duration = 2;
+
+    //create animation
+    const animation = new EntityAnimation(entity);
+
+    const result = Promise.all([
+        animation.promiseEnd(),
+        stopEntityAndNotifyWhenStopped(entity, ecd)
+    ]).then(function () {
+        ecd.removeEntity(entity);
+    });
+
+
+    animation
+        .translate(new Vector3(0, 2, 0), duration, TransitionFunctions.EaseIn)
+        .fade(0, duration)
+        .start(ecd);
+
+
+    return result;
+}
+
+/**
+ * Fade an entity's {@link AudioEmitter} to silence and resolve once it is quiet.
+ *
+ * The fade is driven on the component's `volume` rather than on the voice: a live volume write reaches
+ * the instance gain on both of `AudioEmitterSystem`'s play routes, so this one handle works for a
+ * spatially managed emitter and a direct one alike, and it needs no reference to the system.
+ *
+ * @param {number} entity
+ * @param {EntityComponentDataset} ecd
+ */
+export async function stopAudioEmitterAndNotifyOnceFinished(entity, ecd) {
+
+    if (!ecd.entityExists(entity)) {
+        return;
+    }
+
+    const audioEmitter = ecd.getComponent(entity, AudioEmitter);
+
+    if (audioEmitter === undefined) {
+        return;
+    }
+
+    const fadeOutDuration = 0.3;
+
+    const volume = audioEmitter.volume;
+
+    const fade = new AnimationTrack(['volume']);
+
+    fade.addKey(0, [volume.getValue()]);
+    fade.addKey(fadeOutDuration, [0]);
+    fade.addTransition(0, TransitionFunctions.Linear);
+
+    //wait out the fade before reporting the emitter as stopped
+    await new Promise(resolve => {
+        new Entity()
+            .add(SerializationMetadata.Transient)
+            .add(BehaviorComponent.from(SequenceBehavior.from([
+                new AnimationBehavior(new AnimationTrackPlayback(fade, v => volume.set(v))),
+                new ActionBehavior(resolve),
+                DieBehavior.create()
+            ])))
+            .build(ecd);
+    });
+}
+
+
+/**
+ *
+ * @param {number} entity
+ * @param {EntityComponentDataset} ecd
+ * @returns {Promise}
+ */
+export function stopEntityAndNotifyWhenStopped(entity, ecd) {
+    return Promise.all([
+        shutdownParticleEmitter(entity, ecd),
+        stopTrailAndNotifyOnceFinished(entity, ecd),
+        stopAudioEmitterAndNotifyOnceFinished(entity, ecd)
+    ]);
+}

package/src/engine/animation/AnimationUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnimationUtils.d.ts","sourceRoot":"","sources":["../../../../src/engine/animation/AnimationUtils.js"],"names":[],"mappings":"AAsBA;;;;;GAKG;AACH,uDAJW,MAAM,6CA2BhB;AAED;;;;;GAKG;AACH,yDAJW,MAAM,6CA2ChB;AAGD;;;;;GAKG;AACH,gDAJW,MAAM,6CAmChB;AAED;;;;;;;;GAQG;AACH;;;;;;iBAoFC"}
+{"version":3,"file":"AnimationUtils.d.ts","sourceRoot":"","sources":["../../../../src/engine/animation/AnimationUtils.js"],"names":[],"mappings":"AAyBA;;;;;GAKG;AACH,uDAJW,MAAM,6CA2BhB;AAED;;;;;GAKG;AACH,yDAJW,MAAM,6CA2ChB;AAGD;;;;;GAKG;AACH,gDAJW,MAAM,6CAmChB;AAED;;;;;;;;GAQG;AACH;;;;;;iBA6FC"}

package/src/engine/animation/AnimationUtils.js

@@ -1,6 +1,9 @@
 import { SerializationMetadata } from "../ecs/components/SerializationMetadata.js";
 import Entity from "../ecs/Entity.js";
-import { Transform } from "../ecs/transform/Transform.js";
+import Vector3 from "../../core/geom/Vector3.js";
+import { Transform64 } from "../ecs/transform/Transform64.js";
+import { t64_announce_change } from "../ecs/transform/t64_announce_change.js";
+import { t64_read_translation } from "../ecs/transform/t64_read_translation.js";
 import { whenAllEntitiesDestroyed, whenEntityDestroyed } from "../ecs/util/EntityBuilderUtils.js";
 import { removeComponentsExcept } from "../ecs/util/removeComponentsExcept.js";
 import { createSound, createTimer } from "../EntityCreator.js";
@@ -150,12 +153,12 @@ export function shutdownParticleEmitter(entity, ecd) {
 export function removeEntityWithEffect({ entity, ecd, emitter, soundEffect, timeout }) {
     /**
      *
-     * @type {Transform}
+     * @type {Transform64}
      */
-    const transform = ecd.getComponent(entity, Transform);
+    const transform = ecd.getComponent(entity, Transform64);
 
     //prevent further interactions
-    removeComponentsExcept(ecd, entity, [SGMesh, ParticleEmitter, Trail2D, Transform]);
+    removeComponentsExcept(ecd, entity, [SGMesh, ParticleEmitter, Trail2D, Transform64]);
 
     //make entity volatile so it does not end up in game saves
     ecd.addComponentToEntity(entity, SerializationMetadata.Transient);
@@ -173,10 +176,19 @@ export function removeEntityWithEffect({ entity, ecd, emitter, soundEffect, time
         animationTrack.addTransition(1, TransitionFunctions.EaseOut);
 
 
-        const originalScale = transform.scale.clone();
+        const originalScale = new Vector3(
+            transform.scale_x, transform.scale_y, transform.scale_z
+        );
 
         const trackPlayback = new AnimationTrackPlayback(animationTrack, function (s) {
-            transform.scale.copy(originalScale.clone().multiplyScalar(s));
+            transform.setScale(
+                originalScale.x * s, originalScale.y * s, originalScale.z * s
+            );
+
+            // a scale write leaves the matrix describing the previous size
+            transform.updateMatrix();
+
+            t64_announce_change(ecd, entity);
         }, null);
 
         trackPlayback.on.ended.add(() => {
@@ -199,7 +211,7 @@ export function removeEntityWithEffect({ entity, ecd, emitter, soundEffect, time
 
             });
 
-        const t = new Transform();
+        const t = new Transform64();
         t.copy(transform);
 
         const emitterBuilder = new Entity();
@@ -216,7 +228,7 @@ export function removeEntityWithEffect({ entity, ecd, emitter, soundEffect, time
         });
 
         const sound = createSound({
-            position: transform.position,
+            position: t64_read_translation(new Vector3(), transform),
             url: soundEffect,
             positioned: true
         });

package/src/engine/animation/Animations.d.ts

@@ -27,5 +27,6 @@ declare function translate(entity: number, ecd: EntityComponentDataset, paramete
  * @returns {Tween}
  */
 declare function fade(entity: number, ecd: EntityComponentDataset, parameter: Vector3, time: number, transitionFunction: (x: number) => number): Tween;
+import Vector3 from "../../core/geom/Vector3.js";
 import Tween from "./Tween.js";
 //# sourceMappingURL=Animations.d.ts.map

package/src/engine/animation/Animations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Animations.d.ts","sourceRoot":"","sources":["../../../../src/engine/animation/Animations.js"],"names":[],"mappings":";;;;;AAIA;;;;;;;;GAQG;AACH,mCAPW,MAAM,yDAGN,MAAM,0BACF,MAAM,KAAK,MAAM,GACnB,KAAK,CAcjB;AAED;;;;;;;;;;;;GAYG;AACH,8BAPW,MAAM,yDAGN,MAAM,0BACF,MAAM,KAAK,MAAM,GACnB,KAAK,CAsBjB;kBA1DiB,YAAY"}
+{"version":3,"file":"Animations.d.ts","sourceRoot":"","sources":["../../../../src/engine/animation/Animations.js"],"names":[],"mappings":";;;;;AAOA;;;;;;;;GAQG;AACH,mCAPW,MAAM,0CAEN,OAAO,QACP,MAAM,0BACF,MAAM,KAAK,MAAM,GACnB,KAAK,CAmBjB;AAED;;;;;;;;;;;;GAYG;AACH,8BAPW,MAAM,0CAEN,OAAO,QACP,MAAM,0BACF,MAAM,KAAK,MAAM,GACnB,KAAK,CAsBjB;oBAnEmB,4BAA4B;kBAI9B,YAAY"}

package/src/engine/animation/Animations.js

@@ -1,66 +1,74 @@
-import GUIElement from "../ecs/gui/GUIElement.js";
-import { Transform } from "../ecs/transform/Transform.js";
-import Tween from "./Tween.js";
-
-/**
- *
- * @param {number} entity
- * @param {EntityComponentDataset} ecd
- * @param {Vector3} parameter destination in local offset from current position
- * @param {number} time duration
- * @param {(x: number) => number} transitionFunction
- * @returns {Tween}
- */
-function translate(entity, ecd, parameter, time, transitionFunction) {
-    const transform = ecd.getComponent(entity, Transform);
-
-    const origin = transform.position.clone();
-    const target = origin.clone().add(parameter);
-
-    const temp = origin.clone();
-    return new Tween(function (v) {
-        const position = transform.position;
-        temp.copy(origin).lerp(target, v);
-        position.copy(temp);
-    }, 0, 1, time, transitionFunction);
-}
-
-/**
- * **A model does not fade.** This used to clone the three material off the entity's mesh and animate
- * its opacity; the renderer 3.0 ships has a transparency mode but no per-instance opacity, and
- * `Mesh.opacity` did not come across the mesh cutover (D45), so what fades is what has an opacity to
- * fade — the entity's GUI element (D56).
- *
- * @param {number} entity
- * @param {EntityComponentDataset} ecd
- * @param {Vector3} parameter final opacity, 1 - fully opaque, 0 - fully transparent
- * @param {number} time duration
- * @param {(x: number) => number} transitionFunction
- * @returns {Tween}
- */
-function fade(entity, ecd, parameter, time, transitionFunction) {
-
-    const tweenUpdateCallbacks = [];
-
-    const original = 1;
-
-    const guiElement = ecd.getComponent(entity, GUIElement);
-
-    if (guiElement !== undefined) {
-        tweenUpdateCallbacks.push(function (v) {
-            guiElement.view.el.style.opacity = v;
-        });
-    }
-
-    return new Tween(function (v) {
-        for (let i = 0; i < tweenUpdateCallbacks.length; i++) {
-            tweenUpdateCallbacks[i](v);
-        }
-
-    }, original, parameter, time, transitionFunction);
-}
-
-export default {
-    translate: translate,
-    fade: fade
-};
+import GUIElement from "../ecs/gui/GUIElement.js";
+import Vector3 from "../../core/geom/Vector3.js";
+import { Transform64 } from "../ecs/transform/Transform64.js";
+import { t64_announce_change } from "../ecs/transform/t64_announce_change.js";
+import { t64_read_translation } from "../ecs/transform/t64_read_translation.js";
+import Tween from "./Tween.js";
+
+/**
+ *
+ * @param {number} entity
+ * @param {EntityComponentDataset} ecd
+ * @param {Vector3} parameter destination in local offset from current position
+ * @param {number} time duration
+ * @param {(x: number) => number} transitionFunction
+ * @returns {Tween}
+ */
+function translate(entity, ecd, parameter, time, transitionFunction) {
+    const transform = ecd.getComponent(entity, Transform64);
+
+    const origin = t64_read_translation(new Vector3(), transform);
+    const target = origin.clone().add(parameter);
+
+    const temp = origin.clone();
+
+    return new Tween(function (v) {
+        temp.copy(origin).lerp(target, v);
+
+        // the translation is the matrix's own column, so nothing is left to recompose - but the
+        // component still has to say it moved, or nothing following the entity will move with it
+        transform.setTranslation(temp.x, temp.y, temp.z);
+
+        t64_announce_change(ecd, entity);
+    }, 0, 1, time, transitionFunction);
+}
+
+/**
+ * **A model does not fade.** This used to clone the three material off the entity's mesh and animate
+ * its opacity; the renderer 3.0 ships has a transparency mode but no per-instance opacity, and
+ * `Mesh.opacity` did not come across the mesh cutover (D45), so what fades is what has an opacity to
+ * fade — the entity's GUI element (D56).
+ *
+ * @param {number} entity
+ * @param {EntityComponentDataset} ecd
+ * @param {Vector3} parameter final opacity, 1 - fully opaque, 0 - fully transparent
+ * @param {number} time duration
+ * @param {(x: number) => number} transitionFunction
+ * @returns {Tween}
+ */
+function fade(entity, ecd, parameter, time, transitionFunction) {
+
+    const tweenUpdateCallbacks = [];
+
+    const original = 1;
+
+    const guiElement = ecd.getComponent(entity, GUIElement);
+
+    if (guiElement !== undefined) {
+        tweenUpdateCallbacks.push(function (v) {
+            guiElement.view.el.style.opacity = v;
+        });
+    }
+
+    return new Tween(function (v) {
+        for (let i = 0; i < tweenUpdateCallbacks.length; i++) {
+            tweenUpdateCallbacks[i](v);
+        }
+
+    }, original, parameter, time, transitionFunction);
+}
+
+export default {
+    translate: translate,
+    fade: fade
+};

package/src/engine/animation/clip/bind_property_writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bind_property_writer.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/clip/bind_property_writer.js"],"names":[],"mappings":"AA2FA;;;;;GAKG;AACH,mEAHW,MAAM,EAAE,GACN,gBAAgB,CA+B5B;iCA3HgC,sCAAsC"}
+{"version":3,"file":"bind_property_writer.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/clip/bind_property_writer.js"],"names":[],"mappings":"AA6FA;;;;;GAKG;AACH,mEAHW,MAAM,EAAE,GACN,gBAAgB,CAoC5B;iCAnIgC,sCAAsC"}

package/src/engine/animation/clip/bind_property_writer.js

@@ -1,8 +1,10 @@
 import { assert } from "../../../core/assert.js";
 import Name from "../../ecs/name/Name.js";
-import { BoundQuaternionWriter } from "../curve/binding/BoundQuaternionWriter.js";
 import { BoundValueWriter } from "../curve/binding/BoundValueWriter.js";
-import { BoundVector3Writer } from "../curve/binding/BoundVector3Writer.js";
+import {
+    BoundTransform64Writer,
+    Transform64Channel
+} from "../curve/binding/BoundTransform64Writer.js";
 
 /**
  *
@@ -108,14 +110,19 @@ export function bind_property_writer(node, path_parts) {
     let writer;
 
     switch (property_name) {
+        /*
+         The three names are the glTF ones and stay as they are; what they bind to is a span of the
+         node's Transform64 rather than an object hanging off it, so all three go through the writer
+         that knows how to put one back.
+        */
         case "position":
-            writer = new BoundVector3Writer(parent.transform.position);
+            writer = new BoundTransform64Writer(parent, Transform64Channel.Translation);
             break;
         case "quaternion":
-            writer = new BoundQuaternionWriter(parent.transform.rotation);
+            writer = new BoundTransform64Writer(parent, Transform64Channel.Rotation);
             break;
         case "scale":
-            writer = new BoundVector3Writer(parent.transform.scale);
+            writer = new BoundTransform64Writer(parent, Transform64Channel.Scale);
             break;
         default:
             console.log(`Unsupported property name: ${property_name}`);

package/src/engine/animation/curve/binding/BoundTransform64Writer.d.ts

@@ -0,0 +1,29 @@
+export type Transform64Channel = string;
+export namespace Transform64Channel {
+    let Translation: string;
+    let Rotation: string;
+    let Scale: string;
+}
+/**
+ * Animate one component of an {@link EntityNode}'s pose.
+ *
+ * A {@link Transform64} keeps its three components as spans of one array, so there is no
+ * {@link Vector3} or {@link Quaternion} on it for {@link BoundVector3Writer} to hold on to - which
+ * is why the pose gets a writer of its own rather than reusing those.
+ *
+ * The writer owns three obligations a curve should not have to know about: only a translation write
+ * lands in the matrix by itself, so a rotation or a scale write recomposes; and the node's pose is
+ * not the entity's, so the write is followed by the sync that pushes it into the components the
+ * rest of the engine reads.
+ */
+export class BoundTransform64Writer extends BoundValueWriter {
+    /**
+     * @param {EntityNode} node
+     * @param {string} channel one of {@link Transform64Channel}
+     */
+    constructor(node: EntityNode, channel: string);
+    write(data: any): void;
+    #private;
+}
+import { BoundValueWriter } from "./BoundValueWriter.js";
+//# sourceMappingURL=BoundTransform64Writer.d.ts.map

package/src/engine/animation/curve/binding/BoundTransform64Writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoundTransform64Writer.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/animation/curve/binding/BoundTransform64Writer.js"],"names":[],"mappings":"iCAIU,MAAM;;;;;;AAahB;;;;;;;;;;;GAWG;AACH;IAWI;;;OAGG;IACH,uCAFW,MAAM,EAOhB;IAED,uBA2BC;;CACJ;iCA9EgC,uBAAuB"}

package/src/engine/animation/curve/binding/BoundTransform64Writer.js

@@ -0,0 +1,80 @@
+import Quaternion from "../../../../core/geom/Quaternion.js";
+import { BoundValueWriter } from "./BoundValueWriter.js";
+
+/**
+ * @enum {string}
+ */
+export const Transform64Channel = {
+    Translation: "translation",
+    Rotation: "rotation",
+    Scale: "scale"
+};
+
+/**
+ * @type {Quaternion}
+ */
+const SCRATCH_ROTATION = new Quaternion();
+
+/**
+ * Animate one component of an {@link EntityNode}'s pose.
+ *
+ * A {@link Transform64} keeps its three components as spans of one array, so there is no
+ * {@link Vector3} or {@link Quaternion} on it for {@link BoundVector3Writer} to hold on to - which
+ * is why the pose gets a writer of its own rather than reusing those.
+ *
+ * The writer owns three obligations a curve should not have to know about: only a translation write
+ * lands in the matrix by itself, so a rotation or a scale write recomposes; and the node's pose is
+ * not the entity's, so the write is followed by the sync that pushes it into the components the
+ * rest of the engine reads.
+ */
+export class BoundTransform64Writer extends BoundValueWriter {
+    /**
+     * @type {EntityNode|null}
+     */
+    #node = null;
+
+    /**
+     * @type {string}
+     */
+    #channel = Transform64Channel.Translation;
+
+    /**
+     * @param {EntityNode} node
+     * @param {string} channel one of {@link Transform64Channel}
+     */
+    constructor(node, channel) {
+        super();
+
+        this.#node = node;
+        this.#channel = channel;
+    }
+
+    write(data) {
+        const transform = this.#node.transform;
+
+        switch (this.#channel) {
+            case Transform64Channel.Translation:
+                // the translation IS the matrix's fourth column, so this is already whole
+                transform.setTranslation(data[0], data[1], data[2]);
+                break;
+
+            case Transform64Channel.Rotation:
+                // curve output is interpolated, so it is very slightly off unit length
+                SCRATCH_ROTATION.set(data[0], data[1], data[2], data[3]).normalize();
+
+                transform.setRotation(
+                    SCRATCH_ROTATION.x, SCRATCH_ROTATION.y,
+                    SCRATCH_ROTATION.z, SCRATCH_ROTATION.w
+                );
+                transform.updateMatrix();
+                break;
+
+            case Transform64Channel.Scale:
+                transform.setScale(data[0], data[1], data[2]);
+                transform.updateMatrix();
+                break;
+        }
+
+        this.#node.transform_changed();
+    }
+}

package/src/engine/animation/removeEntityWithMeshParticlesEffect.js

@@ -3,7 +3,7 @@ import { SerializationMetadata } from "../ecs/components/SerializationMetadata.j
 import { removeComponentsExcept } from "../ecs/util/removeComponentsExcept.js";
 import { ParticleEmitter } from "../graphics/particles/particular/engine/emitter/ParticleEmitter.js";
 import Trail2D from "../graphics/ecs/trail2d/Trail2D.js";
-import { Transform } from "../ecs/transform/Transform.js";
+import { Transform64 } from "../ecs/transform/Transform64.js";
 import Entity from "../ecs/Entity.js";
 import { stopEntityAndNotifyWhenStopped } from "./AnimatedActions.js";
 
@@ -157,7 +157,7 @@ export function removeEntityWithMeshParticlesEffect(
     const emitter = ParticleEmitter.fromJSON(lib[particles]);
 
     //prevent further interactions
-    removeComponentsExcept(ecd, entity, [SGMesh, ParticleEmitter, Trail2D, Transform]);
+    removeComponentsExcept(ecd, entity, [SGMesh, ParticleEmitter, Trail2D, Transform64]);
 
     //make entity volatile so it does not end up in game saves. The entity is mid-death here;
     //without this a save taken during the effect would restore a corpse that never finishes dying.
@@ -165,9 +165,9 @@ export function removeEntityWithMeshParticlesEffect(
 
     /**
      *
-     * @type {Transform}
+     * @type {Transform64}
      */
-    const originalTransform = ecd.getComponent(entity, Transform);
+    const originalTransform = ecd.getComponent(entity, Transform64);
 
     if (originalTransform === undefined) {
         throw new Error(`entity ${entity} doesn't have Transform`);

package/src/engine/asset/loaders/gltf_test_fixtures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gltf_test_fixtures.d.ts","sourceRoot":"","sources":["../../../../../src/engine/asset/loaders/gltf_test_fixtures.js"],"names":[],"mappings":"AAoBA;;GAEG;AACH,sCAFa,WAAW,CAWvB;AAED;;;GAGG;AACH,qDAHW,MAAM,GAAC,SAAS,GACd,MAAM,CA+BlB;AAED;;;;;;;;;;GAUG;AACH,8DAJW,MAAM,aACN,MAAM,GACJ,MAAM,CAiBlB;AAED;;;;GAIG;AACH,sCAFa,WAAW,CAiCvB;AAsCD;;;;;;;;;;;;;;;;;GAiBG;AACH;IAJ4B,aAAa,GAA9B,MAAM;IACY,MAAM,GAAxB,OAAO;;YACI,WAAW;;oBAAsB,MAAM;oBAAa,MAAM;;EA2C/E;AAED;;;;;;;GAOG;AACH,iEAPW,MAAM,cACN,MAAM,GAAC,SAAS;IAEC,aAAa,GAA9B,MAAM;IACY,MAAM,GAAxB,OAAO;IACL,MAAM,CA8ElB;AAED;;;;;;GAMG;AACH,2DAJW,MAAM,kBAEJ,WAAW,CAkCvB;AA3VD,iDAAkD;AAClD,iDAAkD;AAElD;;;;GAIG;AACH,2CAFU,MAAM,CAEgC;AA2HhD;;;;;GAKG;AACH,gDAFU,MAAM,CAE8D;AAa9E;;;;GAIG;AACH,mCAFU,MAAM,EAAE,CAMhB"}
+{"version":3,"file":"gltf_test_fixtures.d.ts","sourceRoot":"","sources":["../../../../../src/engine/asset/loaders/gltf_test_fixtures.js"],"names":[],"mappings":"AAqBA;;GAEG;AACH,sCAFa,WAAW,CAWvB;AAED;;;GAGG;AACH,qDAHW,MAAM,GAAC,SAAS,GACd,MAAM,CA+BlB;AAED;;;;;;;;;;GAUG;AACH,8DAJW,MAAM,aACN,MAAM,GACJ,MAAM,CAiBlB;AAED;;;;GAIG;AACH,sCAFa,WAAW,CAiCvB;AAsCD;;;;;;;;;;;;;;;;;GAiBG;AACH;IAJ4B,aAAa,GAA9B,MAAM;IACY,MAAM,GAAxB,OAAO;;YACI,WAAW;;oBAAsB,MAAM;oBAAa,MAAM;;EA2C/E;AAED;;;;;;;GAOG;AACH,iEAPW,MAAM,cACN,MAAM,GAAC,SAAS;IAEC,aAAa,GAA9B,MAAM;IACY,MAAM,GAAxB,OAAO;IACL,MAAM,CA8ElB;AAED;;;;;;GAMG;AACH,2DAJW,MAAM,kBAEJ,WAAW,CAkCvB;AA3VD,iDAAkD;AAClD,iDAAkD;AAElD;;;;GAIG;AACH,2CAFU,MAAM,CAEgC;AA2HhD;;;;;GAKG;AACH,gDAFU,MAAM,CAE8D;AAa9E;;;;GAIG;AACH,mCAFU,MAAM,EAAE,CAMhB"}