@woosh/meep-engine 3.15.0 → 3.17.0

package/src/engine/graphics/ecs/camera/topdown/TopDownCameraControllerSystem.d.ts

@@ -1,24 +1,24 @@
 /**
  *
  * @param {TopDownCameraController} control
- * @param {Transform} result
+ * @param {Transform64} result
  */
-export function computeTopDownTransform(control: TopDownCameraController, result: Transform): void;
+export function computeTopDownTransform(control: TopDownCameraController, result: Transform64): void;
 /**
  *
- * @param {Transform} transform
+ * @param {Transform64} transform
  * @param {TopDownCameraController} controller
  * @param {number} distance
  */
-export function setCameraControllerFromTransform(transform: Transform, controller: TopDownCameraController, distance?: number): void;
+export function setCameraControllerFromTransform(transform: Transform64, controller: TopDownCameraController, distance?: number): void;
 export default TopDownCameraControllerSystem;
 import TopDownCameraController from './TopDownCameraController.js';
-import { Transform } from '../../../../ecs/transform/Transform.js';
+import { Transform64 } from '../../../../ecs/transform/Transform64.js';
 declare class TopDownCameraControllerSystem extends System<any> {
     constructor();
     enabled: ObservedValue;
     dependencies: (typeof TopDownCameraController)[];
-    components_used: ResourceAccessSpecification<typeof Transform>[];
+    components_used: ResourceAccessSpecification<typeof Transform64>[];
     /**
      *
      * @param {TopDownCameraController} ctrl

package/src/engine/graphics/ecs/camera/topdown/TopDownCameraControllerSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TopDownCameraControllerSystem.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/camera/topdown/TopDownCameraControllerSystem.js"],"names":[],"mappings":"AAqDA;;;;GAIG;AACH,iDAHW,uBAAuB,UACvB,SAAS,QAsBnB;AAED;;;;;GAKG;AACH,4DAJW,SAAS,cACT,uBAAuB,aACvB,MAAM,QAQhB;;oCAnF+D,8BAA8B;0BAHpE,wCAAwC;AAQlE;;IACI,uBAAkC;IAClC,iDAAyC;IACzC,iEAEE;IAEF;;;;;OAKG;IACH,8BAQC;IAED,6BAaC;CACJ;uBA9CsB,2BAA2B;0BAHxB,4CAA4C;4CAE1B,0DAA0D"}
+{"version":3,"file":"TopDownCameraControllerSystem.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/camera/topdown/TopDownCameraControllerSystem.js"],"names":[],"mappings":"AAwDA;;;;GAIG;AACH,iDAHW,uBAAuB,UACvB,WAAW,QA0BrB;AAED;;;;;GAKG;AACH,4DAJW,WAAW,cACX,uBAAuB,aACvB,MAAM,QAahB;;oCA/F+D,8BAA8B;4BAHlE,0CAA0C;AAWtE;;IACI,uBAAkC;IAClC,iDAAyC;IACzC,mEAEE;IAEF;;;;;OAKG;IACH,8BAQC;IAED,6BAaC;CACJ;uBAjDsB,2BAA2B;0BAHxB,4CAA4C;4CAE1B,0DAA0D"}

package/src/engine/graphics/ecs/camera/topdown/TopDownCameraControllerSystem.js

@@ -4,19 +4,22 @@ import ObservedValue from "../../../../../core/model/ObservedValue.js";
 import { ResourceAccessKind } from "../../../../../core/model/ResourceAccessKind.js";
 import { ResourceAccessSpecification } from "../../../../../core/model/ResourceAccessSpecification.js";
 import { System } from '../../../../ecs/System.js';
-import { Transform } from '../../../../ecs/transform/Transform.js';
+import { Transform64 } from '../../../../ecs/transform/Transform64.js';
 
 
 import TopDownCameraController, { top_down_view_rotation } from './TopDownCameraController.js';
+import Quaternion from "../../../../../core/geom/Quaternion.js";
+import { v3_quaternion_apply } from "../../../../../core/geom/vec3/v3_quaternion_apply.js";
 
 
 const v3_scratch = new Vector3();
+const q_scratch = new Quaternion();
 
 class TopDownCameraControllerSystem extends System {
     enabled = new ObservedValue(true);
     dependencies = [TopDownCameraController];
     components_used = [
-        ResourceAccessSpecification.from(Transform,ResourceAccessKind.Write)
+        ResourceAccessSpecification.from(Transform64,ResourceAccessKind.Write)
     ];
 
     /**
@@ -26,7 +29,7 @@ class TopDownCameraControllerSystem extends System {
      * @private
      */
     __visit_camera_entity(ctrl, entity){
-        const transform = this.entityManager.dataset.getComponent(entity,Transform);
+        const transform = this.entityManager.dataset.getComponent(entity,Transform64);
 
         if(transform === undefined){
             return;
@@ -54,42 +57,51 @@ class TopDownCameraControllerSystem extends System {
 /**
  *
  * @param {TopDownCameraController} control
- * @param {Transform} result
+ * @param {Transform64} result
  */
 export function computeTopDownTransform(control, result) {
 
-    const rotation = result.rotation;
-
     //clamp the distance
     const distance = clamp(control.distance, control.distanceMin, control.distanceMax);
     const target = control.target;
 
-    // compute rotation
-    top_down_view_rotation(rotation, control);
+    // compute rotation. The transform holds its rotation as four numbers rather than a Quaternion,
+    // so the euler composition runs in a scratch and lands in the transform afterwards.
+    top_down_view_rotation(q_scratch, control);
+
+    result.setRotation(q_scratch.x, q_scratch.y, q_scratch.z, q_scratch.w);
 
     // compute camera position
     v3_scratch.copy(Vector3.forward);
-    v3_scratch.applyQuaternion(rotation);
+    v3_scratch.applyQuaternion(q_scratch);
 
     v3_scratch.multiplyScalar(-distance);
 
     v3_scratch.add(target);
 
-    result.position.copy(v3_scratch);
+    result.setTranslation(v3_scratch.x, v3_scratch.y, v3_scratch.z);
+
+    // the rotation moved, so the matrix owes an update
+    result.updateMatrix();
 }
 
 /**
  *
- * @param {Transform} transform
+ * @param {Transform64} transform
  * @param {TopDownCameraController} controller
  * @param {number} distance
  */
 export function setCameraControllerFromTransform(transform, controller, distance = 20) {
     const v_f = Vector3.forward.clone();
     v_f.multiplyScalar(distance);
-    v_f.applyQuaternion(transform.rotation);
 
-    controller.setFromEyeAndTarget(transform.position,v_f);
+    v3_quaternion_apply(
+        v_f, 0,
+        v_f.x, v_f.y, v_f.z,
+        transform.rotation_x, transform.rotation_y, transform.rotation_z, transform.rotation_w
+    );
+
+    controller.setFromEyeAndTarget(transform.translation, v_f);
 }
 
 export default TopDownCameraControllerSystem;

package/src/engine/graphics/ecs/camera/topdown/TopDownCameraLanderSystem.js

@@ -63,7 +63,7 @@ function land(lander, controller, terrain, samplerCache) {
     const target = controller.target;
 
 
-    terrain.mapPointWorld2Grid(target, v2_scratch);
+    terrain.mapPointWorld2Grid(target.x, target.z, v2_scratch);
 
     v2_scratch.divide(terrain.size);
 

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

@@ -1,4 +1,4 @@
-import { Transform } from "../../../ecs/transform/Transform.js";
+import { Transform64 } from "../../../ecs/transform/Transform64.js";
 import { MeshEvents } from "./MeshEvents.js";
 
 /**
@@ -40,7 +40,7 @@ export function setMesh(dataset, entity, component, mesh) {
 
     component.mesh = mesh;
 
-    const transform = dataset.getComponent(entity, Transform);
+    const transform = dataset.getComponent(entity, Transform64);
 
     if (transform !== undefined) {
         // transform component found, apply transform

package/src/engine/graphics/ecs/path/entity/EntityPath.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EntityPath.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/path/entity/EntityPath.js"],"names":[],"mappings":"AAqBA;IACI;;;OAGG;IACH,uBAAa;IAEb;;;OAGG;IACH,WAAY;IAEZ;;;OAGG;IACH,SAFU,gBAAgB,EAAE,CAEf;IAEb;;;OAGG;IACH,0BAKC;IAED;;;OAGG;IACH,gBAEC;IAED;;OAEG;IACH,uCAEC;IAED;;;OAGG;IACH,4BAEC;IAED;;;;;OAKG;IACH,uBAYC;IAGD;;;;OAIG;IACH,0BAiCC;IAED,8BAiBC;IAED,cAmCC;IAED;;;;;OAKG;IACH,0BAJW,MAAM,mBACG,gBAAgB,+BAenC;IAED;;;;;OAKG;IACH,2BAJW,MAAM,mBACG,gBAAgB,+BAiBnC;CACJ;iCAvOgC,uBAAuB"}
+{"version":3,"file":"EntityPath.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/path/entity/EntityPath.js"],"names":[],"mappings":"AA6BA;IACI;;;OAGG;IACH,uBAAa;IAEb;;;OAGG;IACH,WAAY;IAEZ;;;OAGG;IACH,SAFU,gBAAgB,EAAE,CAEf;IAEb;;;OAGG;IACH,0BAKC;IAED;;;OAGG;IACH,gBAEC;IAED;;OAEG;IACH,uCAEC;IAED;;;OAGG;IACH,4BAEC;IAED;;;;;OAKG;IACH,uBAYC;IAGD;;;;OAIG;IACH,0BAuCC;IAED,8BAiBC;IAED,cAmCC;IAED;;;;;OAKG;IACH,0BAJW,MAAM,mBACG,gBAAgB,+BAenC;IAED;;;;;OAKG;IACH,2BAJW,MAAM,mBACG,gBAAgB,+BAiBnC;CACJ;iCArPgC,uBAAuB"}

package/src/engine/graphics/ecs/path/entity/EntityPath.js

@@ -1,13 +1,21 @@
 import { IllegalStateException } from "../../../../../core/fsm/exceptions/IllegalStateException.js";
 import { EntityPathMarker } from "./EntityPathMarker.js";
-import { Transform } from "../../../../ecs/transform/Transform.js";
+import { Transform64 } from "../../../../ecs/transform/Transform64.js";
 import Vector3 from "../../../../../core/geom/Vector3.js";
 import { assert } from "../../../../../core/assert.js";
 import { binarySearchHighIndex } from "../../../../../core/collection/array/binarySearchHighIndex.js";
 import { EPSILON } from "../../../../../core/math/EPSILON.js";
+import { t64_look_rotation } from "../../../../ecs/transform/t64_look_rotation.js";
 
 const scratch_v3 = new Vector3();
 
+/**
+ * Where the path says this marker goes, before it is written onto the component.
+ *
+ * @type {Vector3}
+ */
+const scratch_position = new Vector3();
+
 
 /**
  *
@@ -101,35 +109,41 @@ export class EntityPath {
     __position_marker(marker) {
         /**
          *
-         * @type {Transform}
+         * @type {Transform64}
          */
-        const transform = marker.entity.getComponent(Transform);
+        const transform = marker.entity.getComponent(Transform64);
 
         const offset = marker.offset;
 
         const path = this.path;
 
-        path.sample(transform.position, offset);
+        // sample into a vector, then place: the component's translation is a span of its array
+        // and the sampler wants somewhere with vector arithmetic on it
+        path.sample(scratch_position, offset);
+
+        transform.setTranslation(scratch_position.x, scratch_position.y, scratch_position.z);
 
         const def = marker.definition;
 
         if (def.align) {
             // get next point position to figure out orientation
             if (path.sample(scratch_v3, offset + EPSILON)) {
-                scratch_v3.sub(transform.position);
+                scratch_v3.sub(scratch_position);
 
             } else {
                 // sample behind
                 path.sample(scratch_v3, offset - EPSILON);
 
-                scratch_v3.subVectors(transform.position, scratch_v3);
+                scratch_v3.subVectors(scratch_position, scratch_v3);
             }
 
             scratch_v3.normalize();
 
-            transform.rotation.lookRotation(scratch_v3);
+            t64_look_rotation(transform, scratch_v3.x, scratch_v3.y, scratch_v3.z, 0, 1, 0);
         }
 
+        transform.updateMatrix();
+
         transform.multiplyTransforms(transform, def.transform);
     }
 

package/src/engine/graphics/ecs/path/entity/EntityPathMarkerDefinition.d.ts

@@ -8,7 +8,7 @@ export class EntityPathMarkerDefinition {
      */
     static from({ blueprint, transform, align }: {
         blueprint: any;
-        transform?: Transform;
+        transform?: Transform64;
         align?: boolean;
     }): EntityPathMarkerDefinition;
     static fromJSON(json: any, registry: any): EntityPathMarkerDefinition;
@@ -19,9 +19,9 @@ export class EntityPathMarkerDefinition {
     blueprint: EntityBlueprint;
     /**
      * Transform will be applied to every marker
-     * @type {Transform}
+     * @type {Transform64}
      */
-    transform: Transform;
+    transform: Transform64;
     /**
      * Align along the path
      * @type {boolean}
@@ -35,5 +35,5 @@ export class EntityPathMarkerDefinition {
     fromJSON({ blueprint, transform, align }: any, registry: ModuleRegistry): void;
 }
 import { EntityBlueprint } from "../../../../ecs/EntityBlueprint.js";
-import { Transform } from "../../../../ecs/transform/Transform.js";
+import { Transform64 } from "../../../../ecs/transform/Transform64.js";
 //# sourceMappingURL=EntityPathMarkerDefinition.d.ts.map

package/src/engine/graphics/ecs/path/entity/EntityPathMarkerDefinition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EntityPathMarkerDefinition.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/path/entity/EntityPathMarkerDefinition.js"],"names":[],"mappings":"AAGA;IAmBI;;;;;;OAMG;IACH;;;;QAFa,0BAA0B,CAetC;IAaD,sEAMC;IAzDD;;;OAGG;IACH,WAFU,eAAe,CAER;IAEjB;;;OAGG;IACH,WAFU,SAAS,CAES;IAE5B;;;OAGG;IACH,OAFU,OAAO,CAEJ;IAwBb;;;;OAIG;IACH,+EAIC;CASJ;gCA7D+B,oCAAoC;0BAD1C,wCAAwC"}
+{"version":3,"file":"EntityPathMarkerDefinition.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/path/entity/EntityPathMarkerDefinition.js"],"names":[],"mappings":"AAGA;IAmBI;;;;;;OAMG;IACH;;;;QAFa,0BAA0B,CAetC;IAaD,sEAMC;IAzDD;;;OAGG;IACH,WAFU,eAAe,CAER;IAEjB;;;OAGG;IACH,WAFU,WAAW,CAES;IAE9B;;;OAGG;IACH,OAFU,OAAO,CAEJ;IAwBb;;;;OAIG;IACH,+EAIC;CASJ;gCA7D+B,oCAAoC;4BADxC,0CAA0C"}

package/src/engine/graphics/ecs/path/entity/EntityPathMarkerDefinition.js

@@ -1,4 +1,4 @@
-import { Transform } from "../../../../ecs/transform/Transform.js";
+import { Transform64 } from "../../../../ecs/transform/Transform64.js";
 import { EntityBlueprint } from "../../../../ecs/EntityBlueprint.js";
 
 export class EntityPathMarkerDefinition {
@@ -10,9 +10,9 @@ export class EntityPathMarkerDefinition {
 
     /**
      * Transform will be applied to every marker
-     * @type {Transform}
+     * @type {Transform64}
      */
-    transform = new Transform();
+    transform = new Transform64();
 
     /**
      * Align along the path
@@ -29,7 +29,7 @@ export class EntityPathMarkerDefinition {
      */
     static from({
                     blueprint,
-                    transform = new Transform(),
+                    transform = new Transform64(),
                     align = true
                 }) {
 

package/src/engine/graphics/ecs/sprite/SpriteSystemPE.d.ts

@@ -1,8 +1,8 @@
 export class SpriteSystemPE extends AbstractContextSystem<any> {
     constructor();
-    dependencies: (typeof Transform | typeof Sprite)[];
+    dependencies: (typeof Transform64 | typeof Sprite)[];
 }
 import { AbstractContextSystem } from "../../../ecs/system/AbstractContextSystem.js";
-import { Transform } from "../../../ecs/transform/Transform.js";
+import { Transform64 } from "../../../ecs/transform/Transform64.js";
 import { Sprite } from "./Sprite.js";
 //# sourceMappingURL=SpriteSystemPE.d.ts.map

package/src/engine/graphics/ecs/sprite/SpriteSystemPE.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SpriteSystemPE.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/sprite/SpriteSystemPE.js"],"names":[],"mappings":"AAgIA;IAGI,cAEC;IAJD,mDAAmC;CAKtC;sCAnIqC,8CAA8C;0BAE1D,qCAAqC;uBAQxC,aAAa"}
+{"version":3,"file":"SpriteSystemPE.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/sprite/SpriteSystemPE.js"],"names":[],"mappings":"AAsIA;IAGI,cAEC;IAJD,qDAAqC;CAKxC;sCAzIqC,8CAA8C;4BAGxD,uCAAuC;uBAQ5C,aAAa"}

package/src/engine/graphics/ecs/sprite/SpriteSystemPE.js

@@ -1,135 +1,141 @@
-import { float_to_uint8 } from "../../../../core/binary/float_to_uint8.js";
-import { SerializationMetadata } from "../../../ecs/components/SerializationMetadata.js";
-import Entity from "../../../ecs/Entity.js";
-import { AbstractContextSystem } from "../../../ecs/system/AbstractContextSystem.js";
-import { SystemEntityContext } from "../../../ecs/system/SystemEntityContext.js";
-import { Transform } from "../../../ecs/transform/Transform.js";
-import {
-    PARTICLE_ATTRIBUTE_COLOR,
-    PARTICLE_ATTRIBUTE_POSITION
-} from "../../particles/particular/engine/emitter/PARTICLE_ATTRIBUTES.js";
-import { ParticleEmitter } from "../../particles/particular/engine/emitter/ParticleEmitter.js";
-import { ParticleEmitterFlag } from "../../particles/particular/engine/emitter/ParticleEmitterFlag.js";
-import { ParticleLayer } from "../../particles/particular/engine/emitter/ParticleLayer.js";
-import { Sprite } from "./Sprite.js";
-
-class Context extends SystemEntityContext {
-    constructor() {
-        super();
-
-        this.__emitter = new ParticleEmitter();
-        this.__layer = new ParticleLayer();
-
-        this.__layer.emissionRate = 0;
-        this.__layer.emissionImmediate = 1;
-        this.__layer.steps.reset();
-        this.__layer.particleLife.set(999999999, 999999999);
-
-        this.__emitter.addLayer(this.__layer);
-
-        this.__emitter_entity = new Entity()
-            .add(this.__emitter)
-            .add(new Transform())
-            .add(SerializationMetadata.Transient);
-    }
-
-    __copy_transform() {
-
-        /**
-         *
-         * @type {Transform}
-         */
-        const transform = this.components[1];
-
-        this.__emitter_entity.getComponent(Transform).copy(transform);
-
-        const emitter = this.__emitter;
-
-
-        emitter.particles?.writeAttributeVector3(0, PARTICLE_ATTRIBUTE_POSITION, transform.position.x, transform.position.y, transform.position.z);
-
-        emitter.setFlag(ParticleEmitterFlag.ParticleBoundsNeedUpdate);
-
-    }
-
-    link() {
-        if (this.__is_linked) {
-            return;
-        }
-
-        super.link();
-
-
-        /**
-         *
-         * @type {Transform}
-         */
-        const transform = this.components[1];
-
-        /**
-         *
-         * @type {Sprite}
-         */
-        const sprite = this.components[0];
-
-        this.__layer.imageURL = sprite.url;
-        this.__layer.particleSize.set(sprite.size, sprite.size);
-
-        const emitter = this.__emitter;
-
-        if (!emitter.getFlag(ParticleEmitterFlag.Built)) {
-            //particle pool needs to be set up first
-            emitter.build();
-        }
-
-        if (!emitter.getFlag(ParticleEmitterFlag.Initialized)) {
-            //particles are not initialized, do that
-            emitter.initialize();
-        }
-
-        emitter.particles?.writeAttributeVector4(
-            0, PARTICLE_ATTRIBUTE_COLOR,
-            float_to_uint8(sprite.color.r), float_to_uint8(sprite.color.g), float_to_uint8(sprite.color.b), float_to_uint8(sprite.opacity.getValue())
-        );
-
-
-        this.__copy_transform();
-
-        // subscribed only once the emitter is built and seeded: a throw above this point would
-        // otherwise leave the callback wired to a live transform whose every move re-throws, and
-        // Signal swallows handler errors, so it would never surface as anything but log noise
-        transform.position.onChanged.add(this.__copy_transform, this);
-        transform.scale.onChanged.add(this.__copy_transform, this);
-
-        emitter.computeBoundingBox();
-
-        this.__emitter_entity.build(this.getDataset());
-    }
-
-    unlink() {
-        if (!this.__is_linked) {
-            return;
-        }
-
-        /**
-         *
-         * @type {Transform}
-         */
-        const transform = this.components[1];
-
-        transform.position.onChanged.remove(this.__copy_transform, this);
-        transform.scale.onChanged.remove(this.__copy_transform, this);
-
-        super.unlink();
-
-        this.__emitter_entity.destroy();
-    }
-}
-
-export class SpriteSystemPE extends AbstractContextSystem {
-    dependencies = [Sprite, Transform];
-
-    constructor() {
-        super(Context);
-    }
-}
+import { float_to_uint8 } from "../../../../core/binary/float_to_uint8.js";
+import { SerializationMetadata } from "../../../ecs/components/SerializationMetadata.js";
+import Entity from "../../../ecs/Entity.js";
+import { AbstractContextSystem } from "../../../ecs/system/AbstractContextSystem.js";
+import { SystemEntityContext } from "../../../ecs/system/SystemEntityContext.js";
+import { TRANSFORM64_EVENT_CHANGE } from "../../../ecs/transform/TRANSFORM64_EVENT_CHANGE.js";
+import { Transform64 } from "../../../ecs/transform/Transform64.js";
+import {
+    PARTICLE_ATTRIBUTE_COLOR,
+    PARTICLE_ATTRIBUTE_POSITION
+} from "../../particles/particular/engine/emitter/PARTICLE_ATTRIBUTES.js";
+import { ParticleEmitter } from "../../particles/particular/engine/emitter/ParticleEmitter.js";
+import { ParticleEmitterFlag } from "../../particles/particular/engine/emitter/ParticleEmitterFlag.js";
+import { ParticleLayer } from "../../particles/particular/engine/emitter/ParticleLayer.js";
+import { Sprite } from "./Sprite.js";
+
+class Context extends SystemEntityContext {
+    constructor() {
+        super();
+
+        this.__emitter = new ParticleEmitter();
+        this.__layer = new ParticleLayer();
+
+        this.__layer.emissionRate = 0;
+        this.__layer.emissionImmediate = 1;
+        this.__layer.steps.reset();
+        this.__layer.particleLife.set(999999999, 999999999);
+
+        this.__emitter.addLayer(this.__layer);
+
+        this.__emitter_entity = new Entity()
+            .add(this.__emitter)
+            .add(new Transform64())
+            .add(SerializationMetadata.Transient);
+    }
+
+    __copy_transform() {
+
+        /**
+         *
+         * @type {Transform64}
+         */
+        const transform = this.components[1];
+
+        this.__emitter_entity.getComponent(Transform64).copy(transform);
+
+        const emitter = this.__emitter;
+
+
+        emitter.particles?.writeAttributeVector3(0, PARTICLE_ATTRIBUTE_POSITION, transform.translation_x, transform.translation_y, transform.translation_z);
+
+        emitter.setFlag(ParticleEmitterFlag.ParticleBoundsNeedUpdate);
+
+    }
+
+    link() {
+        if (this.__is_linked) {
+            return;
+        }
+
+        super.link();
+
+
+        /**
+         *
+         * @type {Transform64}
+         */
+        const transform = this.components[1];
+
+        /**
+         *
+         * @type {Sprite}
+         */
+        const sprite = this.components[0];
+
+        this.__layer.imageURL = sprite.url;
+        this.__layer.particleSize.set(sprite.size, sprite.size);
+
+        const emitter = this.__emitter;
+
+        if (!emitter.getFlag(ParticleEmitterFlag.Built)) {
+            //particle pool needs to be set up first
+            emitter.build();
+        }
+
+        if (!emitter.getFlag(ParticleEmitterFlag.Initialized)) {
+            //particles are not initialized, do that
+            emitter.initialize();
+        }
+
+        emitter.particles?.writeAttributeVector4(
+            0, PARTICLE_ATTRIBUTE_COLOR,
+            float_to_uint8(sprite.color.r), float_to_uint8(sprite.color.g), float_to_uint8(sprite.color.b), float_to_uint8(sprite.opacity.getValue())
+        );
+
+
+        this.__copy_transform();
+
+        // Subscribed only once the emitter is built and seeded: a throw above this point would
+        // otherwise leave the callback wired to a live entity whose every move re-throws, and
+        // Signal swallows handler errors, so it would never surface as anything but log noise.
+        //
+        // One listener where there were two, because a Transform64 announces itself whole rather
+        // than through a sub-object per component.
+        this.__on_transform_changed = () => this.__copy_transform();
+
+        this.getDataset().addEntityEventListener(
+            this.entity, TRANSFORM64_EVENT_CHANGE, this.__on_transform_changed
+        );
+
+        emitter.computeBoundingBox();
+
+        this.__emitter_entity.build(this.getDataset());
+    }
+
+    unlink() {
+        if (!this.__is_linked) {
+            return;
+        }
+
+        if (this.__on_transform_changed !== undefined) {
+            this.getDataset().removeEntityEventListener(
+                this.entity, TRANSFORM64_EVENT_CHANGE, this.__on_transform_changed
+            );
+
+            this.__on_transform_changed = undefined;
+        }
+
+        super.unlink();
+
+        this.__emitter_entity.destroy();
+    }
+}
+
+export class SpriteSystemPE extends AbstractContextSystem {
+    dependencies = [Sprite, Transform64];
+
+    constructor() {
+        super(Context);
+    }
+}

package/src/engine/graphics/geometry/MikkT/Build4RuleGroups.js

@@ -64,7 +64,7 @@ export function Build4RuleGroups(
                         assigned_group
                     );
 
-                    assert(bAnswer || (bOrPre !== ((pTriInfos[neigh_indexL].iFlag & ORIENT_PRESERVING) !== 0)) );
+                    assert.ok(bAnswer || (bOrPre !== ((pTriInfos[neigh_indexL].iFlag & ORIENT_PRESERVING) !== 0)) );
 
                 }
                 if (neigh_indexR >= 0) {
@@ -77,7 +77,7 @@ export function Build4RuleGroups(
                         assigned_group
                     );
 
-                    assert(bAnswer || bOrPre !== ((pTriInfos[neigh_indexR].iFlag & ORIENT_PRESERVING) !== 0));
+                    assert.ok(bAnswer || bOrPre !== ((pTriInfos[neigh_indexR].iFlag & ORIENT_PRESERVING) !== 0));
 
                 }
 

package/src/engine/graphics/geometry/MikkT/DegenEpilogue.js

@@ -215,6 +215,6 @@ export function DegenEpilogue(psTspace, pTriInfos, piTriListIn, pContext, iNrTri
 
         }
 
-        assert(!bNotFound);
+        assert.ok(!bNotFound);
     }
 }

package/src/engine/graphics/geometry/MikkT/DegenPrologue.js

@@ -110,6 +110,6 @@ export function DegenPrologue(
         }
     }
 
-    assert(bStillFindingGoodOnes);	// code will still work.
+    assert.ok(bStillFindingGoodOnes);	// code will still work.
     assert.equal(iNrTrianglesIn, t);
 }

package/src/engine/graphics/geometry/MikkT/EvalTspace.js

@@ -73,7 +73,7 @@ export function EvalTspace(res, face_indices, iFaces, piTriListIn, pTriInfos, pC
                 i = 2;
             }
 
-            assert(i >= 0 && i < 3);
+            assert.ok(i >= 0 && i < 3);
 
             // project
             const index = piTriListIn[f3 + i];