@woosh/meep-engine 3.15.0 → 3.16.0

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

@@ -0,0 +1,18 @@
+/**
+ * Write a solved joint angle back onto a bone.
+ *
+ * Three separate things have to happen, where a signalling transform did them as one. The rotation
+ * is written as four numbers. The local matrix is recomposed, because only a translation write
+ * lands in the matrix on its own. And the change is announced, because a {@link Transform64}
+ * carries no signals and {@link TransformAttachmentSystem} is waiting to hear that this bone moved
+ * before it recomposes every world pose below it.
+ *
+ * The announcement names {@link TransformAttachment} and not the transform, because a bone's local
+ * pose is not a component in its own right - it lives inside the attachment.
+ *
+ * @param {EntityComponentDataset} dataset
+ * @param {IKBone} bone
+ * @param {Quaternion} rotation
+ */
+export function ik_write_local_rotation(dataset: EntityComponentDataset, bone: IKBone, rotation: Quaternion): void;
+//# sourceMappingURL=ik_write_local_rotation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ik_write_local_rotation.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/ik/ik_write_local_rotation.js"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;GAeG;AACH,mHAUC"}

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

@@ -0,0 +1,30 @@
+import { EventType } from "../EventType.js";
+import { TransformAttachment } from "../transform-attachment/TransformAttachment.js";
+
+/**
+ * Write a solved joint angle back onto a bone.
+ *
+ * Three separate things have to happen, where a signalling transform did them as one. The rotation
+ * is written as four numbers. The local matrix is recomposed, because only a translation write
+ * lands in the matrix on its own. And the change is announced, because a {@link Transform64}
+ * carries no signals and {@link TransformAttachmentSystem} is waiting to hear that this bone moved
+ * before it recomposes every world pose below it.
+ *
+ * The announcement names {@link TransformAttachment} and not the transform, because a bone's local
+ * pose is not a component in its own right - it lives inside the attachment.
+ *
+ * @param {EntityComponentDataset} dataset
+ * @param {IKBone} bone
+ * @param {Quaternion} rotation
+ */
+export function ik_write_local_rotation(dataset, bone, rotation) {
+    const local = bone.local;
+
+    local.setRotation(rotation.x, rotation.y, rotation.z, rotation.w);
+    local.updateMatrix();
+
+    dataset.sendEvent(bone.entity, EventType.ComponentChanged, {
+        klass: TransformAttachment,
+        instance: bone.attachment
+    });
+}

package/src/engine/ecs/parent/EntityNode.d.ts

@@ -28,7 +28,7 @@ export class EntityNode {
     private __children;
     /**
      * Local transform
-     * @type {Transform}
+     * @type {Transform64}
      * @private
      */
     private __transform;
@@ -89,10 +89,30 @@ export class EntityNode {
      */
     get children(): readonly EntityNode[];
     /**
+     * Push this node's pose into the components that carry it.
+     *
+     * A root's pose IS its world transform, so it lands on {@link Transform64}. A child's pose is an
+     * offset from its parent, so it lands on the {@link TransformAttachment} instead and the world
+     * transform is left to {@link TransformAttachmentSystem} to compose.
      *
      * @private
      */
     private __transform_sync_down;
+    /**
+     * Say that {@link EntityNode#transform} was written.
+     *
+     * The node's transform used to be a {@link Transform} whose three sub-objects the node listened
+     * to, so an edit propagated by itself. A {@link Transform64} is four spans of a plain array and
+     * announces nothing, so the caller that moved the node says so - which is the same rule the rest
+     * of the engine follows now, and the reason there is no listener here any more. Listening to the
+     * entity's own component would have been the wrong direction entirely: that component is this
+     * method's OUTPUT, and a hierarchy that composes into it would drive the node backwards.
+     *
+     * Cheap enough to over-call: it is a copy of at most 23 numbers and one event.
+     *
+     * @returns {void}
+     */
+    transform_changed(): void;
     /**
      *
      * @return {TransformAttachment}
@@ -100,9 +120,9 @@ export class EntityNode {
      */
     private __safe_get_attachment;
     /**
-     * @returns {Transform}
+     * @returns {Transform64}
      */
-    get transform(): Transform;
+    get transform(): Transform64;
     /**
      * Root of the hierarchy, will be `this` if node is already a root
      * @return {EntityNode}
@@ -136,8 +156,6 @@ export class EntityNode {
      */
     removeChild(node: EntityNode): boolean;
     get isBuilt(): boolean;
-    attachListeners(): void;
-    detachListeners(): void;
     /**
      *
      * @param {EntityComponentDataset} ecd
@@ -152,6 +170,6 @@ export class EntityNode {
 }
 import Signal from "../../../core/events/signal/Signal.js";
 import { EntityNodeFlags } from "./EntityNodeFlags.js";
-import { Transform } from "../transform/Transform.js";
+import { Transform64 } from "../transform/Transform64.js";
 import Entity from "../Entity.js";
 //# sourceMappingURL=EntityNode.d.ts.map

package/src/engine/ecs/parent/EntityNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EntityNode.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/parent/EntityNode.js"],"names":[],"mappings":"AAYA;;;GAGG;AACH;IAiJI;;;;OAIG;IACH,2CAFY,UAAU,CAYrB;IA/HD;;;OAGG;IACH,qBAFW,MAAM,EAWhB;IA7CD;;;;OAIG;IACH,iBAAgB;IAEhB;;;;OAIG;IACH,mBAAgB;IAEhB;;;;OAIG;IACH,oBAA8B;IAE9B;;;MAGE;IAEF;;;OAGG;IACH,OAFU,MAAM,CAEM;IAQlB;;;;OAIG;IACH,iBAAsB;IAI1B;;;;OAIG;IACH,cAHW,MAAM,GAAC,eAAe,GACpB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,eAAe,GACpB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,eAAe,SACtB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,eAAe,GACpB,OAAO,CAInB;IAED;;;;OAIG;IACH,yBAHkB,UAAU,+BAc3B;IAED;;;;OAIG;IACH,iCAHkB,UAAU,+BAK3B;IAED;;;OAGG;IACH,sCAEC;IAED;;;OAGG;IACH,8BAgBC;IAmBD;;;;OAIG;IACH,8BAaC;IAED;;OAEG;IACH,2BAEC;IAED;;;OAGG;IACH,uBAMC;IAUD;;;OAGG;IACH,4BAyCC;IArDD;;;OAGG;IACH,yBAEC;IAiDD;;;OAGG;IACH,qBAEC;IAED;;;;OAIG;IACH,eAHW,UAAU,GACR,OAAO,CAuBnB;IAED;;;;OAIG;IACH,kBAHW,UAAU,GACR,OAAO,CAenB;IAED,uBAEC;IAED,wBAWC;IAED,wBAOC;IAED;;;OAGG;IACH,yCAoDC;IAGD,gBA4BC;IAGL;;;OAGG;IACH,uBAFU,OAAO,CAEgB;CANhC;mBAvbkB,uCAAuC;gCAI1B,sBAAsB;0BAD5B,2BAA2B;mBAFlC,cAAc"}
+{"version":3,"file":"EntityNode.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/parent/EntityNode.js"],"names":[],"mappings":"AAaA;;;GAGG;AACH;IA+LI;;;;OAIG;IACH,2CAFY,UAAU,CAYrB;IA7KD;;;OAGG;IACH,qBAFW,MAAM,EAWhB;IA7CD;;;;OAIG;IACH,iBAAgB;IAEhB;;;;OAIG;IACH,mBAAgB;IAEhB;;;;OAIG;IACH,oBAAgC;IAEhC;;;MAGE;IAEF;;;OAGG;IACH,OAFU,MAAM,CAEM;IAQlB;;;;OAIG;IACH,iBAAsB;IAI1B;;;;OAIG;IACH,cAHW,MAAM,GAAC,eAAe,GACpB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,eAAe,GACpB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,eAAe,SACtB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,eAAe,GACpB,OAAO,CAInB;IAED;;;;OAIG;IACH,yBAHkB,UAAU,+BAc3B;IAED;;;;OAIG;IACH,iCAHkB,UAAU,+BAK3B;IAED;;;OAGG;IACH,sCAEC;IAED;;;;;;;;OAQG;IACH,8BAkCC;IAED;;;;;;;;;;;;;OAaG;IACH,qBAFa,IAAI,CAShB;IAmBD;;;;OAIG;IACH,8BAaC;IAED;;OAEG;IACH,6BAEC;IAED;;;OAGG;IACH,uBAMC;IAUD;;;OAGG;IACH,4BAyCC;IArDD;;;OAGG;IACH,yBAEC;IAiDD;;;OAGG;IACH,qBAEC;IAED;;;;OAIG;IACH,eAHW,UAAU,GACR,OAAO,CAuBnB;IAED;;;;OAIG;IACH,kBAHW,UAAU,GACR,OAAO,CAenB;IAED,uBAEC;IAED;;;OAGG;IACH,yCA+CC;IAGD,gBAoBC;IAGL;;;OAGG;IACH,uBAFU,OAAO,CAEgB;CANhC;mBAnckB,uCAAuC;gCAI1B,sBAAsB;4BAD1B,6BAA6B;mBAFtC,cAAc"}

package/src/engine/ecs/parent/EntityNode.js

@@ -4,9 +4,10 @@ import { array_remove_first } from "../../../core/collection/array/array_remove_
 import Signal from "../../../core/events/signal/Signal.js";
 import Entity from "../Entity.js";
 import { TransformAttachment, TransformAttachmentFlags } from "../transform-attachment/TransformAttachment.js";
-import { Transform } from "../transform/Transform.js";
+import { Transform64 } from "../transform/Transform64.js";
 import { EntityNodeFlags } from "./EntityNodeFlags.js";
 import { ParentEntity } from "./ParentEntity.js";
+import { EventType } from "../EventType.js";
 
 const DEFAULT_FLAGS = EntityNodeFlags.LiveManagement;
 
@@ -31,10 +32,10 @@ export class EntityNode {
 
     /**
      * Local transform
-     * @type {Transform}
+     * @type {Transform64}
      * @private
      */
-    __transform = new Transform();
+    __transform = new Transform64();
 
     on = {
         built: new Signal(),
@@ -138,6 +139,11 @@ export class EntityNode {
     }
 
     /**
+     * Push this node's pose into the components that carry it.
+     *
+     * A root's pose IS its world transform, so it lands on {@link Transform64}. A child's pose is an
+     * offset from its parent, so it lands on the {@link TransformAttachment} instead and the world
+     * transform is left to {@link TransformAttachmentSystem} to compose.
      *
      * @private
      */
@@ -145,18 +151,59 @@ export class EntityNode {
 
         const transform = this.__transform;
 
+        const entity = this.__entity;
+
         if (this.__parent === null) {
             // not attached to anything, world and local transforms match
-            const cTransform = this.__entity.getComponent(Transform);
+            const cTransform = entity.getComponent(Transform64);
 
             if (cTransform !== null) {
                 cTransform.copy(transform);
+
+                if (entity.isBuilt) {
+                    entity.dataset.sendEvent(entity.id, EventType.ComponentChanged, {
+                        klass: Transform64,
+                        instance: cTransform
+                    });
+                }
             }
 
         } else {
-            this.__safe_get_attachment().transform.copy(transform);
+            const attachment = this.__safe_get_attachment();
+
+            attachment.transform.copy(transform);
+
+            if (entity.isBuilt) {
+                entity.dataset.sendEvent(entity.id, EventType.ComponentChanged, {
+                    klass: TransformAttachment,
+                    instance: attachment
+                });
+            }
+        }
+
+    }
+
+    /**
+     * Say that {@link EntityNode#transform} was written.
+     *
+     * The node's transform used to be a {@link Transform} whose three sub-objects the node listened
+     * to, so an edit propagated by itself. A {@link Transform64} is four spans of a plain array and
+     * announces nothing, so the caller that moved the node says so - which is the same rule the rest
+     * of the engine follows now, and the reason there is no listener here any more. Listening to the
+     * entity's own component would have been the wrong direction entirely: that component is this
+     * method's OUTPUT, and a hierarchy that composes into it would drive the node backwards.
+     *
+     * Cheap enough to over-call: it is a copy of at most 23 numbers and one event.
+     *
+     * @returns {void}
+     */
+    transform_changed() {
+        if (!this.getFlag(EntityNodeFlags.LiveManagement)) {
+            // the caller drives the components itself
+            return;
         }
 
+        this.__transform_sync_down();
     }
 
     /**
@@ -197,7 +244,7 @@ export class EntityNode {
     }
 
     /**
-     * @returns {Transform}
+     * @returns {Transform64}
      */
     get transform() {
         return this.__transform;
@@ -330,28 +377,6 @@ export class EntityNode {
         return this.__entity.isBuilt;
     }
 
-    attachListeners() {
-        if (this.getFlag(EntityNodeFlags.TransformObserved)) {
-            // already observed
-            return;
-        }
-
-        this.__transform.position.onChanged.add(this.__transform_sync_down, this);
-        this.__transform.scale.onChanged.add(this.__transform_sync_down, this);
-        this.__transform.rotation.onChanged.add(this.__transform_sync_down, this);
-
-        this.setFlag(EntityNodeFlags.TransformObserved);
-    }
-
-    detachListeners() {
-
-        this.__transform.position.onChanged.remove(this.__transform_sync_down, this);
-        this.__transform.scale.onChanged.remove(this.__transform_sync_down, this);
-        this.__transform.rotation.onChanged.remove(this.__transform_sync_down, this);
-
-        this.clearFlag(EntityNodeFlags.TransformObserved);
-    }
-
     /**
      *
      * @param {EntityComponentDataset} ecd
@@ -382,7 +407,7 @@ export class EntityNode {
             const parent_entity_id = parent_entity_builder.id;
             parent_entity.entity = parent_entity_id;
 
-            assert.ok(parent.entity.hasComponent(Transform), "parent node must have a transform but doesn't. Transform is required for attachment transform hierarchy to work correctly");
+            assert.ok(parent.entity.hasComponent(Transform64), "parent node must have a transform but doesn't. Transform is required for attachment transform hierarchy to work correctly");
 
             const attachment = this.__safe_get_attachment();
 
@@ -391,11 +416,6 @@ export class EntityNode {
 
         this.__transform_sync_down();
 
-        // attach listeners
-        if (this.getFlag(EntityNodeFlags.LiveManagement)) {
-            this.attachListeners();
-        }
-
         this.__entity.build(ecd);
 
         // build children
@@ -414,17 +434,9 @@ export class EntityNode {
     destroy() {
         if (!this.__entity.isBuilt) {
             // not built
-
-            //TODO check for dangling listeners
             return;
         }
 
-        if (this.getFlag(EntityNodeFlags.TransformObserved)) {
-
-            // remove listeners
-            this.detachListeners();
-        }
-
         // destroy children first
         const children = this.__children;
         const child_count = children.length;

package/src/engine/ecs/parent/EntityNodeFlags.d.ts

@@ -1,6 +1,5 @@
 export type EntityNodeFlags = number;
 export namespace EntityNodeFlags {
     let LiveManagement: number;
-    let TransformObserved: number;
 }
 //# sourceMappingURL=EntityNodeFlags.d.ts.map

package/src/engine/ecs/parent/EntityNodeFlags.js

@@ -1,8 +1,7 @@
-/**
- *
- * @enum {number}
- */
-export const EntityNodeFlags = {
-    LiveManagement: 1,
-    TransformObserved: 2
-};
+/**
+ *
+ * @enum {number}
+ */
+export const EntityNodeFlags = {
+    LiveManagement: 1
+};

package/src/engine/ecs/speaker/VoiceSystem.d.ts

@@ -9,7 +9,7 @@ export class VoiceSystem extends AbstractContextSystem<any> {
         font_size: number;
     });
     dependencies: (typeof Voice)[];
-    components_used: (ResourceAccessSpecification<typeof Transform> | ResourceAccessSpecification<typeof GUIElement> | ResourceAccessSpecification<typeof ViewportPosition> | ResourceAccessSpecification<typeof HeadsUpDisplay> | ResourceAccessSpecification<typeof TransformAttachment> | ResourceAccessSpecification<typeof SerializationMetadata> | ResourceAccessSpecification<typeof BehaviorComponent>)[];
+    components_used: (ResourceAccessSpecification<typeof Transform64> | ResourceAccessSpecification<typeof GUIElement> | ResourceAccessSpecification<typeof ViewportPosition> | ResourceAccessSpecification<typeof HeadsUpDisplay> | ResourceAccessSpecification<typeof TransformAttachment> | ResourceAccessSpecification<typeof SerializationMetadata> | ResourceAccessSpecification<typeof BehaviorComponent>)[];
     /**
      *
      * @type {Localization}
@@ -101,7 +101,7 @@ export class VoiceSystem extends AbstractContextSystem<any> {
 }
 import { AbstractContextSystem } from "../system/AbstractContextSystem.js";
 import { Voice } from "./Voice.js";
-import { Transform } from "../transform/Transform.js";
+import { Transform64 } from "../transform/Transform64.js";
 import { ResourceAccessSpecification } from "../../../core/model/ResourceAccessSpecification.js";
 import GUIElement from "../gui/GUIElement.js";
 import ViewportPosition from "../gui/position/ViewportPosition.js";

package/src/engine/ecs/speaker/VoiceSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VoiceSystem.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/speaker/VoiceSystem.js"],"names":[],"mappings":"AA+JA;IA2CI;;;;OAIG;IACH;;;OA8CC;IA7FD,+BAAuB;IACvB,8YAQE;IAEF;;;OAGG;IACH,0BAAmB;IAEnB;;;OAGG;IACH,eAAW;IAEX;;;OAGG;IACH,4BAAa;IAEb;;;OAGG;IACH,8BAAY;IAEZ;;;;OAIG;IACH,iCAAqC;IAajC;;;OAGG;IACH,eAAoB;IAEpB;;;;OAIG;IACH,kBAAkC;IAGlC;;;;OAIG;IACH,eAAkB;IAElB;;;;OAIG;IACH,oBAAgC;IAEhC;;;OAGG;IACH,oBAAqC;IAErC;;;;OAIG;IACH,gBAAoB;IAGxB;;;OAGG;IACH,kBAFY,MAAM,CAIjB;IAEF,2CAqBE;IAED;;;;;OAKG;IACH,uBAJW,MAAM,UACN,MAAM,SACN,KAAK,QAsBf;IAED;;;;;;OAMG;IACH,wBAoBC;IAED;;;;;OAKG;IACH,gBAJW,MAAM,WACN,MAAM,SACN,KAAK,QA6Hf;CACJ;sCA/bqC,oCAAoC;sBAKpD,YAAY;0BAFR,2BAA2B;4CAxBT,oDAAoD;uBAkBzE,sBAAsB;6BAEhB,qCAAqC;2BADvC,8BAA8B;oCAIrB,gDAAgD;sCAR9C,wCAAwC;kCAP5C,sDAAsD"}
+{"version":3,"file":"VoiceSystem.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/speaker/VoiceSystem.js"],"names":[],"mappings":"AA+JA;IA2CI;;;;OAIG;IACH;;;OA8CC;IA7FD,+BAAuB;IACvB,gZAQE;IAEF;;;OAGG;IACH,0BAAmB;IAEnB;;;OAGG;IACH,eAAW;IAEX;;;OAGG;IACH,4BAAa;IAEb;;;OAGG;IACH,8BAAY;IAEZ;;;;OAIG;IACH,iCAAqC;IAajC;;;OAGG;IACH,eAAoB;IAEpB;;;;OAIG;IACH,kBAAkC;IAGlC;;;;OAIG;IACH,eAAkB;IAElB;;;;OAIG;IACH,oBAAgC;IAEhC;;;OAGG;IACH,oBAAqC;IAErC;;;;OAIG;IACH,gBAAoB;IAGxB;;;OAGG;IACH,kBAFY,MAAM,CAIjB;IAEF,2CAqBE;IAED;;;;;OAKG;IACH,uBAJW,MAAM,UACN,MAAM,SACN,KAAK,QAsBf;IAED;;;;;;OAMG;IACH,wBAoBC;IAED;;;;;OAKG;IACH,gBAJW,MAAM,WACN,MAAM,SACN,KAAK,QA6Hf;CACJ;sCA/bqC,oCAAoC;sBAKpD,YAAY;4BAFN,6BAA6B;4CAxBb,oDAAoD;uBAkBzE,sBAAsB;6BAEhB,qCAAqC;2BADvC,8BAA8B;oCAIrB,gDAAgD;sCAR9C,wCAAwC;kCAP5C,sDAAsD"}

package/src/engine/ecs/speaker/VoiceSystem.js

@@ -27,7 +27,7 @@ import ViewportPosition from "../gui/position/ViewportPosition.js";
 import { AbstractContextSystem } from "../system/AbstractContextSystem.js";
 import { SystemEntityContext } from "../system/SystemEntityContext.js";
 import { TransformAttachment } from "../transform-attachment/TransformAttachment.js";
-import { Transform } from "../transform/Transform.js";
+import { Transform64 } from "../transform/Transform64.js";
 import { SpeechBubbleView } from "./SpeechBubbleView.js";
 import { Voice } from "./Voice.js";
 import { VoiceEvents } from "./VoiceEvents.js";
@@ -163,7 +163,7 @@ export class VoiceSystem extends AbstractContextSystem {
         ResourceAccessSpecification.from(GUIElement, ResourceAccessKind.Create),
         ResourceAccessSpecification.from(ViewportPosition, ResourceAccessKind.Create),
         ResourceAccessSpecification.from(HeadsUpDisplay, ResourceAccessKind.Create),
-        ResourceAccessSpecification.from(Transform, ResourceAccessKind.Create),
+        ResourceAccessSpecification.from(Transform64, ResourceAccessKind.Create),
         ResourceAccessSpecification.from(TransformAttachment, ResourceAccessKind.Create),
         ResourceAccessSpecification.from(SerializationMetadata, ResourceAccessKind.Create),
         ResourceAccessSpecification.from(BehaviorComponent, ResourceAccessKind.Create),
@@ -401,10 +401,10 @@ export class VoiceSystem extends AbstractContextSystem {
             key: localization_key
         });
 
-        const transform = new Transform();
+        const transform = new Transform64();
 
         // copy transform from source entity
-        const source_transform = ecd.getComponent(entity, Transform);
+        const source_transform = ecd.getComponent(entity, Transform64);
 
         if (source_transform !== undefined) {
             transform.copy(source_transform);

package/src/engine/ecs/storage/populateEngineSerializationRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"populateEngineSerializationRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/storage/populateEngineSerializationRegistry.js"],"names":[],"mappings":"AAkLA;;;;;;;;GAQG;AACH,iGA0GC"}
+{"version":3,"file":"populateEngineSerializationRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/storage/populateEngineSerializationRegistry.js"],"names":[],"mappings":"AAmLA;;;;;;;;GAQG;AACH,iGA2GC"}

package/src/engine/ecs/storage/populateEngineSerializationRegistry.js

@@ -44,6 +44,7 @@ import {
     VolumetricLightMapSerializationAdapter
 } from "../../graphics3/VolumetricLightMapSerializationAdapter.js";
 import { Transform } from "../transform/Transform.js";
+import { Transform64SerializationAdapter } from "../transform/Transform64SerializationAdapter.js";
 import { TransformSerializationAdapter } from "../transform/TransformSerializationAdapter.js";
 import { TransformSerializationUpgrader_0_1 } from "../transform/TransformSerializationUpgrader_0_1.js";
 import {
@@ -198,6 +199,7 @@ export function populateEngineSerializationRegistry(registry) {
 
     registry.registerAdapters([
         new TransformSerializationAdapter(),
+        new Transform64SerializationAdapter(),
         new NameSerializationAdapter(),
         new TeamSerializationAdapter(),
         new PathFollowerSerializationAdapter(),

package/src/engine/ecs/terrain/ecs/Terrain.d.ts

@@ -202,11 +202,14 @@ declare class Terrain {
      */
     mapPointGrid2World(x: number, y: number, result: Vector3): void;
     /**
+     * The height axis plays no part, so the world point arrives as the two coordinates that do -
+     * which also lets a caller hand over a transform's translation without taking a view of it.
      *
-     * @param {Vector3} v3
+     * @param {number} world_x
+     * @param {number} world_z
      * @param {Vector2} result
      */
-    mapPointWorld2Grid(v3: Vector3, result: Vector2): void;
+    mapPointWorld2Grid(world_x: number, world_z: number, result: Vector2): void;
     /**
      *
      * @return {Promise}

package/src/engine/ecs/terrain/ecs/Terrain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Terrain.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/terrain/ecs/Terrain.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"Terrain.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/terrain/ecs/Terrain.js"],"names":[],"mappings":"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"}

package/src/engine/ecs/terrain/ecs/Terrain.js

@@ -412,15 +412,18 @@ class Terrain {
     }
 
     /**
+     * The height axis plays no part, so the world point arrives as the two coordinates that do -
+     * which also lets a caller hand over a transform's translation without taking a view of it.
      *
-     * @param {Vector3} v3
+     * @param {number} world_x
+     * @param {number} world_z
      * @param {Vector2} result
      */
-    mapPointWorld2Grid(v3, result) {
+    mapPointWorld2Grid(world_x, world_z, result) {
         const transform = this.gridTransform;
 
-        const x = (v3.x - transform.offset_x) / transform.scale_x;
-        const y = (v3.z - transform.offset_y) / transform.scale_y;
+        const x = (world_x - transform.offset_x) / transform.scale_x;
+        const y = (world_z - transform.offset_y) / transform.scale_y;
 
         result.set(x, y);
     }

package/src/engine/ecs/terrain/ecs/TerrainSystem.js

@@ -9,7 +9,7 @@ import { M4_IDENTITY } from "../../../../core/geom/3d/mat4/M4_IDENTITY.js";
 import { ImageRGBADataLoader } from "../../../asset/loaders/image/ImageRGBADataLoader.js";
 import { camera_active_frustum } from '../../../graphics/ecs/camera/camera_active_frustum.js';
 import { System } from '../../System.js';
-import { Transform } from "../../transform/Transform.js";
+import { Transform64 } from "../../transform/Transform64.js";
 import Terrain from './Terrain.js';
 import { TerrainFlags } from "./TerrainFlags.js";
 
@@ -151,9 +151,9 @@ class TerrainSystem extends System {
 
         /**
          *
-         * @type {Transform|undefined}
+         * @type {Transform64|undefined}
          */
-        const transform = ecd.getComponent(entity, Transform);
+        const transform = ecd.getComponent(entity, Transform64);
 
         if (transform !== undefined) {
             // terrain has a transform

package/src/engine/ecs/terrain/ecs/cling/ClingToTerrainSystem.d.ts

@@ -12,8 +12,8 @@ import Quaternion from "../../../../../core/geom/Quaternion.js";
 import Vector3 from '../../../../../core/geom/Vector3.js';
 declare class ClingToTerrainSystem extends System<any> {
     constructor();
-    dependencies: (typeof Transform | typeof ClingToTerrain)[];
-    components_used: (ResourceAccessSpecification<typeof Transform> | ResourceAccessSpecification<typeof Terrain>)[];
+    dependencies: (typeof Transform64 | typeof ClingToTerrain)[];
+    components_used: (ResourceAccessSpecification<typeof Transform64> | ResourceAccessSpecification<typeof Terrain>)[];
     /**
      *
      * @type {Deque<number>}
@@ -32,22 +32,22 @@ declare class ClingToTerrainSystem extends System<any> {
     requestUpdate(entity: number): void;
     /**
      *
-     * @param {Transform} transform
+     * @param {Transform64} transform
      * @param {ClingToTerrain} cling
      * @param {number} entityId
      */
-    link(cling: ClingToTerrain, transform: Transform, entityId: number): void;
+    link(cling: ClingToTerrain, transform: Transform64, entityId: number): void;
     /**
      *
-     * @param {Transform} transform
+     * @param {Transform64} transform
      * @param {ClingToTerrain} cling
      * @param {number} entityId
      */
-    unlink(cling: ClingToTerrain, transform: Transform, entityId: number): void;
+    unlink(cling: ClingToTerrain, transform: Transform64, entityId: number): void;
     update(timeDelta: any): void;
 }
 import { System } from '../../../System.js';
-import { Transform } from '../../../transform/Transform.js';
+import { Transform64 } from '../../../transform/Transform64.js';
 import ClingToTerrain from './ClingToTerrain.js';
 import { ResourceAccessSpecification } from "../../../../../core/model/ResourceAccessSpecification.js";
 import Terrain from "../Terrain.js";

package/src/engine/ecs/terrain/ecs/cling/ClingToTerrainSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClingToTerrainSystem.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/ecs/terrain/ecs/cling/ClingToTerrainSystem.js"],"names":[],"mappings":"AAyLA;;;;;;;GAOG;AACH,wCANW,UAAU,aACV,OAAO,gBACP,MAAM,yCAsChB;;uBAhOsB,wCAAwC;oBAE3C,qCAAqC;AAyCzD;;IAGI,2DAA2C;IAG3C,iHAGE;IAEF;;;OAGG;IACH,aAFU,MAAM,MAAM,CAAC,CAEG;IAE1B,YAAU;IAEV;;;OAGG;IACH,kBAFU,MAAM,CAEwB;IAExC;;;OAGG;IACH,sBAFW,MAAM,QAOhB;IAED;;;;;OAKG;IACH,YAHW,cAAc,aADd,SAAS,YAET,MAAM,QAgBhB;IAED;;;;;OAKG;IACH,cAHW,cAAc,aADd,SAAS,YAET,MAAM,QAgBhB;IAED,6BAiDC;CACJ;uBArKsB,oBAAoB;0BACjB,iCAAiC;2BAIhC,qBAAqB;4CANJ,0DAA0D;oBAIlF,eAAe;sBAbb,+CAA+C"}
+{"version":3,"file":"ClingToTerrainSystem.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/ecs/terrain/ecs/cling/ClingToTerrainSystem.js"],"names":[],"mappings":"AAkNA;;;;;;;GAOG;AACH,wCANW,UAAU,aACV,OAAO,gBACP,MAAM,yCAsChB;;uBAzPsB,wCAAwC;oBAE3C,qCAAqC;AAyCzD;;IAGI,6DAA6C;IAG7C,mHAGE;IAEF;;;OAGG;IACH,aAFU,MAAM,MAAM,CAAC,CAEG;IAE1B,YAAU;IAEV;;;OAGG;IACH,kBAFU,MAAM,CAEwB;IAExC;;;OAGG;IACH,sBAFW,MAAM,QAOhB;IAED;;;;;OAKG;IACH,YAHW,cAAc,aADd,WAAW,YAEX,MAAM,QA6BhB;IAED;;;;;OAKG;IACH,cAHW,cAAc,aADd,WAAW,YAEX,MAAM,QAgBhB;IAED,6BAiDC;CACJ;uBAlLsB,oBAAoB;4BACf,mCAAmC;2BAIpC,qBAAqB;4CANJ,0DAA0D;oBAIlF,eAAe;sBAbb,+CAA+C"}