@woosh/meep-engine 2.165.1 → 2.165.3

package/package.json

@@ -6,7 +6,7 @@
   "description": "Pure JavaScript game engine. Fully featured and production ready.",
   "type": "module",
   "author": "Alexander Goldring",
-  "version": "2.165.1",
+  "version": "2.165.3",
   "main": "build/meep.module.js",
   "module": "build/meep.module.js",
   "exports": {

package/src/engine/ecs/EntityManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EntityManager.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/EntityManager.js"],"names":[],"mappings":"iCAgBU,MAAM;;;;;;;;;AAiBhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH;IAEI;;;;OAIG;IACH,kBAFU,iCAAQ,CAEL;IAEb;;;;;;OAMG;IACH,uCAA2B;IAE3B;;;;;OAKG;IACH,iCAA4B;IAE5B;;OAEG;IACH;;;QAGI;;WAEG;qBADO,uCAAc;;MAI1B;IAEF;;;OAGG;IACH,OAFU,kBAAkB,CAEO;IAEnC;;;;;;;;;OASG;IACH,qBAFU,MAAM,CAEqB;IAErC;;;;;;;;OAQG;IACH,wCAFU,MAAM,CAE4B;IAE5C;;;;;;;;OAQG;IACH,eAFU,MAAM,CAEE;IAElB;;;;;OAKG;IACH,+BAA2B;IAE3B;;;;OAIG;IACH,SAFU,sBAAsB,CAEjB;IAEf;;;;;OAKG;IACH,uCAAsC;IAEtC;;;OAGG;IACH,6BAmFC;IAED;;;OAGG;IACH,uBAFa,OAAO,CAuBnB;IAED;;;;;OAKG;IACH,uBAJW,sBAAsB,QA4ChC;IAGD;;;OAGG;IACH,sBA2BC;IAED;;;;OAIG;IACH,qCAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,6CAgBC;IAED;;;;;OAKG;IACH,wCAHW,MAAM,GACJ,IAAI,aAAS,CAiBzB;IAGD;;;OAGG;IACH,6BAFW,MAAM,QA8EhB;IAED;;;;;;;;;OASG;IACH,qBAFa,MAAM,CAKlB;IAED;;;;;OAKG;IACH,iEA2DC;IAED;;;;OAIG;IACH,uDAFa,QAAQ,OAAO,CAAC,CAyC5B;IAED;;;;;OAKG;IACH,mBAmCC;IAED;;;;;OAKG;IACH,oBAqFC;IAED;;;;;OAKG;IACH,kEAyEC;IAED;;;;OAIG;IACH,mCAFa,wCAAgB,CA0B5B;IAED;;;;OAIG;IACH,8DAFa,wCAAgB,CA0B5B;IAED;;;;;OAKG;IACH,mEAoFC;IAGL;;OAEG;IACH,yBAjtBe,sBAAsB,UAitBA;IACrC;;OAEG;IACH,0BAAqC;CATpC;uBA59BmC,aAAa;mBAR9B,oCAAoC;uCAMhB,6BAA6B"}
+{"version":3,"file":"EntityManager.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/EntityManager.js"],"names":[],"mappings":"iCAgBU,MAAM;;;;;;;;;AAiBhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH;IAEI;;;;OAIG;IACH,kBAFU,iCAAQ,CAEL;IAEb;;;;;;OAMG;IACH,uCAA2B;IAE3B;;;;;OAKG;IACH,iCAA4B;IAE5B;;OAEG;IACH;;;QAGI;;WAEG;qBADO,uCAAc;;MAI1B;IAEF;;;OAGG;IACH,OAFU,kBAAkB,CAEO;IAEnC;;;;;;;;;OASG;IACH,qBAFU,MAAM,CAEqB;IAErC;;;;;;;;OAQG;IACH,wCAFU,MAAM,CAE4B;IAE5C;;;;;;;;OAQG;IACH,eAFU,MAAM,CAEE;IAElB;;;;;OAKG;IACH,+BAA2B;IAE3B;;;;OAIG;IACH,SAFU,sBAAsB,CAEjB;IAEf;;;;;OAKG;IACH,uCAAsC;IAEtC;;;OAGG;IACH,6BAmFC;IAED;;;OAGG;IACH,uBAFa,OAAO,CAuBnB;IAED;;;;;OAKG;IACH,uBAJW,sBAAsB,QA4ChC;IAGD;;;OAGG;IACH,sBA2BC;IAED;;;;OAIG;IACH,qCAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,6CAgBC;IAED;;;;;OAKG;IACH,wCAHW,MAAM,GACJ,IAAI,aAAS,CAiBzB;IAGD;;;OAGG;IACH,6BAFW,MAAM,QA8EhB;IAED;;;;;;;;;OASG;IACH,qBAFa,MAAM,CAKlB;IAED;;;;;OAKG;IACH,iEA6DC;IAED;;;;OAIG;IACH,uDAFa,QAAQ,OAAO,CAAC,CA2C5B;IAED;;;;;OAKG;IACH,mBAmCC;IAED;;;;;OAKG;IACH,oBAqFC;IAED;;;;;OAKG;IACH,kEAyEC;IAED;;;;OAIG;IACH,mCAFa,wCAAgB,CA0B5B;IAED;;;;OAIG;IACH,8DAFa,wCAAgB,CA0B5B;IAED;;;;;OAKG;IACH,mEAoFC;IAGL;;OAEG;IACH,yBArtBe,sBAAsB,UAqtBA;IACrC;;OAEG;IACH,0BAAqC;CATpC;uBAh+BmC,aAAa;mBAR9B,oCAAoC;uCAMhB,6BAA6B"}

package/src/engine/ecs/EntityManager.js

@@ -557,9 +557,11 @@ export class EntityManager {
         systems[systemIndex] = system;
 
 
-        //build observer
-        const entityObserver = new EntityObserver(system.dependencies, system.link, system.unlink, system);
-        this.systemObservers.set(system, entityObserver);
+        //build observer; a dependency-less system observes no entity tuple and never links
+        if (system.dependencies.length > 0) {
+            const entityObserver = new EntityObserver(system.dependencies, system.link, system.unlink, system);
+            this.systemObservers.set(system, entityObserver);
+        }
 
         let result_promise;
         if (this.state === EntityManagerState.Running) {
@@ -596,11 +598,11 @@ export class EntityManager {
             return false;
         }
 
-        //unlink system observer
+        //unlink system observer, dependency-less systems don't have one
         const systemObserver = this.systemObservers.get(system);
         this.systemObservers.delete(system);
 
-        assert.notEqual(systemObserver, undefined, "System observer is undefined, it was possibly removed illegally or was not created");
+        assert.ok(systemObserver !== undefined || system.dependencies.length === 0, "System observer is undefined, it was possibly removed illegally or was not created");
 
         //shutdown system
         this.systems.splice(systemIndex, 1);
@@ -609,8 +611,10 @@ export class EntityManager {
         this.__execution_order_needs_update = true;
 
         if (this.dataset !== null) {
-            // remove observed and unlink entities
-            this.dataset.removeObserver(systemObserver, true);
+            if (systemObserver !== undefined) {
+                // remove observed and unlink entities
+                this.dataset.removeObserver(systemObserver, true);
+            }
             system.handleDatasetDetached(this.dataset);
         }
 

package/src/engine/ecs/System.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"System.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/System.js"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH;IAEI;;;;;OAKG;IACH,uCAAqB;IAErB;;;;OAIG;IACH,oBAA+C;IAE/C;;;;;;;OAOG;IACH,6BAAkB;IAElB;;;;;;;;;;OAUG;IACH,0BAFU,6BAA6B,CAElB;IAGrB;;OAEG;IACH,mCAcC;IAED;;;;;OAKG;IACH,oCAFY,MAAM,CA8BjB;IAED;;;;;;OAMG;IACH,uCAHa,QAAQ,IAAI,CAAC,CAKzB;IAED;;;;;;;OAOG;IACH,wCAHa,QAAQ,IAAI,CAAC,CAKzB;IAGD;;;;OAIG;IACH,wCAEC;IAED;;;;OAIG;IACH,0CAEC;IAED;;;;;;;;;;OAUG;IACH,6DAEC;IAED;;;;;;;;;;OAUG;IACH,6DAEC;IAIL;;;OAGG;IACH,mBAFU,OAAO,CAEQ;IAEzB;;;;OAIG;IACH,2CAFsC,MAAM,CAEhB;IAG5B;;;;;;OAMG;IACH,sCAFsC,MAAM,CAErB;CAvBtB;0BA2BS,MAAM"}
+{"version":3,"file":"System.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/System.js"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH;IAEI;;;;;OAKG;IACH,uCAAqB;IAErB;;;;OAIG;IACH,oBAA+C;IAE/C;;;;;;;;;OASG;IACH,6BAAkB;IAElB;;;;;;;;;;OAUG;IACH,0BAFU,6BAA6B,CAElB;IAGrB;;OAEG;IACH,mCAcC;IAED;;;;;OAKG;IACH,oCAFY,MAAM,CA8BjB;IAED;;;;;;OAMG;IACH,uCAHa,QAAQ,IAAI,CAAC,CAKzB;IAED;;;;;;;OAOG;IACH,wCAHa,QAAQ,IAAI,CAAC,CAKzB;IAGD;;;;;OAKG;IACH,wCAEC;IAED;;;;;OAKG;IACH,0CAEC;IAED;;;;;;;;;;OAUG;IACH,6DAEC;IAED;;;;;;;;;;OAUG;IACH,6DAEC;IAIL;;;OAGG;IACH,mBAFU,OAAO,CAEQ;IAEzB;;;;OAIG;IACH,2CAFsC,MAAM,CAEhB;IAG5B;;;;;;OAMG;IACH,sCAFsC,MAAM,CAErB;CAvBtB;0BA2BS,MAAM"}

package/src/engine/ecs/System.js

@@ -53,6 +53,8 @@ export class System {
 
     /**
      * Component classes which have to be present before the system links an entity.
+     * May be left empty: such a system observes no entity tuple, {@link link}/{@link unlink} are never invoked,
+     * and it is driven purely by {@link startup}/{@link shutdown} and the {@link update}/{@link fixedUpdate} methods.
      * NOTE: do not modify this while the system is running.
      * @see link
      * @see unlink
@@ -157,6 +159,7 @@ export class System {
     /**
      * Called automatically when an entity gets a complete component tuple {@link this.dependencies}.
      * Inputs are the same as dependencies, only instances instead of classes, plus there is an extra argument at the end, which is the entity ID.
+     * Never invoked when {@link this.dependencies} is empty.
      * see {@link EntityObserver} for more implementation detail
      */
     link(component, entity) {
@@ -166,6 +169,7 @@ export class System {
     /**
      * Called automatically when an entity breaks component tuple {@link this.dependencies}.
      * Inputs are the same as dependencies, only instances instead of classes, plus there is an extra argument at the end, which is the entity ID.
+     * Never invoked when {@link this.dependencies} is empty.
      * see {@link EntityObserver} for more implementation detail
      */
     unlink(component, entity) {

package/src/engine/ecs/fow/shader/screenSpaceFogOfWarShader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screenSpaceFogOfWarShader.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/fow/shader/screenSpaceFogOfWarShader.js"],"names":[],"mappings":"AAGA;;;GAGG;AACH,kDAFW,cAAc,CAyJxB;+BA9JyE,OAAO"}
+{"version":3,"file":"screenSpaceFogOfWarShader.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/fow/shader/screenSpaceFogOfWarShader.js"],"names":[],"mappings":"AAGA;;;GAGG;AACH,kDAFW,cAAc,CAmKxB;+BAxKyE,OAAO"}

package/src/engine/ecs/fow/shader/screenSpaceFogOfWarShader.js

@@ -28,16 +28,20 @@ export function buildScreenSpaceFogOfWarShader() {
         const float   c_samplesX    = 5.0;
         const float   c_samplesY    = 5.0;
 
-        const float   c_halfSamplesX = c_samplesX / 2.0;
-        const float   c_halfSamplesY = c_samplesY / 2.0;
+        // True kernel centre is (N-1)/2, so a 5-tap kernel is centred on index 2.
+        const float   c_halfSamplesX = (c_samplesX - 1.0) / 2.0;
+        const float   c_halfSamplesY = (c_samplesY - 1.0) / 2.0;
         
-        const vec2 sigma = vec2(23.0, 23.0);
+        // Std-dev in *sample-index* units (kernel is only c_samples wide), NOT
+        // fog-resolution units. ~1.2 gives a real bell over the 5 taps.
+        const vec2 sigma = vec2(1.2, 1.2);
         
         const vec2 sigma2_sq = sigma*sigma*2.0;
         
-        const float radius = 0.9;
-        
-        const vec2 samplingBias = vec2(c_halfSamplesX,c_halfSamplesY)/ vec2( radius );
+        // Spacing between adjacent taps, in fog texels. Controls blur width and
+        // therefore how strongly the coarse fog grid is smoothed. 1.0 = one texel
+        // per tap, so a 5-tap kernel reaches +/-2 texels either side of centre.
+        const float texelSpacing = 1.0;
         
 	     vec3 computeWorldPosition(){
                 // Convert screen coordinates to normalized device coordinates (NDC)
@@ -72,7 +76,8 @@ export function buildScreenSpaceFogOfWarShader() {
 	     
 	     float getFog(const in vec2 uv){
 	        
-	        vec2 texelSize = samplingBias * uResolution;
+	        // size of one fog texel, in UV space, scaled by the desired tap spacing
+	        vec2 texelSize = texelSpacing / uResolution;
 	     
 			float total = 0.0;
             
@@ -81,12 +86,12 @@ export function buildScreenSpaceFogOfWarShader() {
             for (float iy = 0.0; iy < c_samplesY; ++iy){
             
                 float fy = Gaussian(sigma2_sq.y, iy - c_halfSamplesY);
-                float offsety = (iy-c_halfSamplesY) / texelSize.y;
+                float offsety = (iy - c_halfSamplesY) * texelSize.y;
                 
                 for (float ix = 0.0; ix < c_samplesX; ++ix){
                 
                     float fx = Gaussian(sigma2_sq.x, ix - c_halfSamplesX);
-                    float offsetx = (ix-c_halfSamplesX) / texelSize.x;
+                    float offsetx = (ix - c_halfSamplesX) * texelSize.x;
                     
                     float weight = fx * fy;
                     
@@ -110,8 +115,13 @@ export function buildScreenSpaceFogOfWarShader() {
             gl_FragColor = uColor;
             gl_FragColor.a *= fogValue;
 
-            // dither the alpha ramp to break up 8-bit quantization banding
+            // The fog is written to an 8-bit intermediate layer target; both channels of
+            // that target carry a quantized ramp: alpha holds fogValue, rgb holds
+            // uColor.rgb * alpha (multiplied by ROP blending). Dither each at +/-0.5 LSB
+            // of its own quantizer to break up banding. The rgb noise is attenuated by
+            // alpha in the blend, exactly matching how the rgb band amplitude scales.
             gl_FragColor.a += gradientNoise(gl_FragCoord.xy) * (1.0 / 255.0) - (0.5 / 255.0);
+            gl_FragColor.rgb += vec3( gradientNoise(gl_FragCoord.xy + vec2(7.0, 13.0)) * (1.0 / 255.0) - (0.5 / 255.0) );
         }
         `;
     }

package/src/engine/ecs/system_validate_class.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system_validate_class.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/system_validate_class.js"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,qFA0FC;uBAjGsB,aAAa"}
+{"version":3,"file":"system_validate_class.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/system_validate_class.js"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,qFAiGC;uBAxGsB,aAAa"}

package/src/engine/ecs/system_validate_class.js

@@ -60,8 +60,15 @@ export function system_validate_class(system) {
 
     const numDependencies = dependencies.length;
 
-    if (numDependencies < 1) {
-        throw new Error(`A system must declare at least one dependency`);
+    if (numDependencies === 0) {
+        // no dependencies means no entity tuple is observed, so 'link'/'unlink' can never be invoked
+        if (system.link !== System.prototype.link) {
+            throw new Error(`'link' is overridden, but no dependencies are declared, so it would never be invoked`);
+        }
+
+        if (system.unlink !== System.prototype.unlink) {
+            throw new Error(`'unlink' is overridden, but no dependencies are declared, so it would never be invoked`);
+        }
     }
 
     if (numDependencies > 1) {

package/src/engine/graphics/ecs/trail2d/Trail2D.d.ts

@@ -43,6 +43,8 @@ declare class Trail2D {
      */
     distanceSinceLastUpdate: number;
     /**
+     * RGB tints the ribbon; alpha is the trail's base opacity, which the
+     * age-driven fade scales down to zero.
      * @readonly
      * @type {Color}
      */

package/src/engine/graphics/ecs/trail2d/Trail2D.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Trail2D.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/trail2d/Trail2D.js"],"names":[],"mappings":";AAwBA;IAgMI,oCAMC;IApMD;;;OAGG;IACH,QAFU,MAAM,CAES;IAEzB;;;OAGG;IACH,OAFU,MAAM,CAEM;IAEtB;;;OAGG;IACH,WAFU,cAAc,GAAC,MAAM,CAEC;IAEhC;;;;OAIG;IACH,eAFU,MAAM,CAEuB;IAEvC;;;OAGG;IACH,MAFU,MAAM,CAEP;IAET;;;OAGG;IACH,eAFU,MAAM,CAEE;IAElB;;;OAGG;IACH,qBAFU,MAAM,CAEQ;IAExB;;;OAGG;IACH,yBAFU,MAAM,CAEY;IAE5B;;;OAGG;IACH,gBAFU,KAAK,CAEe;IAE9B;;;;OAIG;IACH,iBAFU,OAAO,CAEM;IAEvB;;;OAGG;IACH,QAFU,OAAO,GAAC,IAAI,CAER;IAEd;;;OAGG;IACH,UAFU,mBAAmB,CAEQ;IAErC;;;OAGG;IACH,cAFU,SAAS,CAEG;IAEtB;;;OAGG;IACH,cAAsB;IAEtB,gBAQC;IAMD,4BAEC;IAND,yBAEC;IAMD;;;;OAIG;IACH,cAHW,MAAM,GAAC,YAAY,GACjB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,YAAY,GACjB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,YAAY,SACnB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,YAAY,GACjB,OAAO,CAInB;IAED;;;OAGG;IACH,qBAFW,MAAM,QAehB;IADG,kHAAgB;IAGpB;;OAEG;IACH,cAsBC;IAUD;;;;;;;;;;;;;aAkBC;IAGD;;;;;;;;;;;;;;;;;MAUC;IAED;;;OAGG;IACH,cAFW,OAAO,WAWjB;IAED;;;;;;;OAOG;IACH,cANW,MAAM,KACN,MAAM,KACN,MAAM,YACN,MAAM,GACJ,OAAO,CAkEnB;CAEJ;;;;;;+BAnV8B,+BAA+B;sBALxC,iCAAiC;oBACnC,kCAAkC;wBAM9B,0BAA0B;oCACd,sCAAsC;0BAThD,yCAAyC;6BAWtC,mBAAmB;kCADd,wBAAwB"}
+{"version":3,"file":"Trail2D.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/trail2d/Trail2D.js"],"names":[],"mappings":";AAwBA;IAkMI,oCAMC;IAtMD;;;OAGG;IACH,QAFU,MAAM,CAES;IAEzB;;;OAGG;IACH,OAFU,MAAM,CAEM;IAEtB;;;OAGG;IACH,WAFU,cAAc,GAAC,MAAM,CAEC;IAEhC;;;;OAIG;IACH,eAFU,MAAM,CAEuB;IAEvC;;;OAGG;IACH,MAFU,MAAM,CAEP;IAET;;;OAGG;IACH,eAFU,MAAM,CAEE;IAElB;;;OAGG;IACH,qBAFU,MAAM,CAEQ;IAExB;;;OAGG;IACH,yBAFU,MAAM,CAEY;IAE5B;;;;;OAKG;IACH,gBAFU,KAAK,CAEe;IAE9B;;;;OAIG;IACH,iBAFU,OAAO,CAEM;IAEvB;;;OAGG;IACH,QAFU,OAAO,GAAC,IAAI,CAER;IAEd;;;OAGG;IACH,UAFU,mBAAmB,CAEQ;IAErC;;;OAGG;IACH,cAFU,SAAS,CAEG;IAEtB;;;OAGG;IACH,cAAsB;IAEtB,gBAQC;IAMD,4BAEC;IAND,yBAEC;IAMD;;;;OAIG;IACH,cAHW,MAAM,GAAC,YAAY,GACjB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,YAAY,GACjB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,YAAY,SACnB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,YAAY,GACjB,OAAO,CAInB;IAED;;;OAGG;IACH,qBAFW,MAAM,QAehB;IADG,kHAAgB;IAGpB;;OAEG;IACH,cAsBC;IAUD;;;;;;;;;;;;;aAkBC;IAGD;;;;;;;;;;;;;;;;;MAUC;IAED;;;OAGG;IACH,cAFW,OAAO,WAWjB;IAED;;;;;;;OAOG;IACH,cANW,MAAM,KACN,MAAM,KACN,MAAM,YACN,MAAM,GACJ,OAAO,CAmEnB;CAEJ;;;;;;+BAtV8B,+BAA+B;sBALxC,iCAAiC;oBACnC,kCAAkC;wBAM9B,0BAA0B;oCACd,sCAAsC;0BAThD,yCAAyC;6BAWtC,mBAAmB;kCADd,wBAAwB"}

package/src/engine/graphics/ecs/trail2d/Trail2D.js

@@ -74,6 +74,8 @@ class Trail2D {
     distanceSinceLastUpdate = 0;
 
     /**
+     * RGB tints the ribbon; alpha is the trail's base opacity, which the
+     * age-driven fade scales down to zero.
      * @readonly
      * @type {Color}
      */
@@ -336,9 +338,10 @@ class Trail2D {
             this.setFlag(Trail2DFlags.BoundsNeedUpdate);
         }
 
-        // set head to fresh value
+        // set head to fresh value; alpha follows the same fade law the simulator
+        // applies every tick, so the point doesn't pop when it stops being the head
         ribbon.setPointAttribute_Scalar(head_index, RIBBON_ATTRIBUTE_ADDRESS_AGE, head_age);
-        ribbon.setPointAlpha(head_index, clamp01(head_age / maxAge));
+        ribbon.setPointAlpha(head_index, (1 - clamp01(head_age / maxAge)) * this.color.w);
         ribbon.setPointThickness(head_index, this.width);
 
         return head_position_changed;

package/src/engine/graphics/ecs/trail2d/Trail2DSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Trail2DSystem.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/trail2d/Trail2DSystem.js"],"names":[],"mappings":";AA0BA;IAkCI;;;OAGG;IACH,4BA4BC;IAjED,oDAAoC;IAEpC,+DAEE;IAEF;;;OAGG;IACH,WAFU,4BAA4B,CAES;IAE/C;;;;OAIG;IACH,wBAAiC;IAGjC;;;;OAIG;IACH,oBAAgB;IAEhB;;;OAGG;IACH,YAAgB;IAcZ;;;;OAIG;IACH,iBAAsB;IAEtB;;;OAGG;IACH,UAFU,cAAc,CAEO;IAE/B;;;OAGG;IACH,aAFU,cAAY,IAAI,CAEH;IAK3B,2CAmBC;IAED,4CAIC;IAED;;;;;OAKG;IACH,sBAqDC;IAED;;;;;OAKG;IACH,YAHW,OAAO,aADP,SAAS,YAET,MAAM,QAahB;IAED;;;;;OAKG;IACH,kBAJW,OAAO,aACP,SAAS,UACT,MAAM,QAShB;IAED;;;;OAIG;IACH,yBAHW,OAAO,aACP,SAAS,QAoCnB;IAED,6BAWC;CACJ;uBArQsB,wBAAwB;0BACrB,qCAAqC;oBAY3C,cAAc;4CAdU,uDAAuD;6CAYtD,yDAAyD;+BARvE,yBAAyB"}
+{"version":3,"file":"Trail2DSystem.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/trail2d/Trail2DSystem.js"],"names":[],"mappings":";AA0BA;IAkCI;;;OAGG;IACH,4BA4BC;IAjED,oDAAoC;IAEpC,+DAEE;IAEF;;;OAGG;IACH,WAFU,4BAA4B,CAES;IAE/C;;;;OAIG;IACH,wBAAiC;IAGjC;;;;OAIG;IACH,oBAAgB;IAEhB;;;OAGG;IACH,YAAgB;IAcZ;;;;OAIG;IACH,iBAAsB;IAEtB;;;OAGG;IACH,UAFU,cAAc,CAEO;IAE/B;;;OAGG;IACH,aAFU,cAAY,IAAI,CAEH;IAK3B,2CAmBC;IAED,4CAIC;IAED;;;;;OAKG;IACH,sBAsDC;IAED;;;;;OAKG;IACH,YAHW,OAAO,aADP,SAAS,YAET,MAAM,QAahB;IAED;;;;;OAKG;IACH,kBAJW,OAAO,aACP,SAAS,UACT,MAAM,QAShB;IAED;;;;OAIG;IACH,yBAHW,OAAO,aACP,SAAS,QAoCnB;IAED,6BAWC;CACJ;uBAtQsB,wBAAwB;0BACrB,qCAAqC;oBAY3C,cAAc;4CAdU,uDAAuD;6CAYtD,yDAAyD;+BARvE,yBAAyB"}

package/src/engine/graphics/ecs/trail2d/Trail2DSystem.js

@@ -167,7 +167,8 @@ class Trail2DSystem extends System {
             ribbon.setPointPosition(i, position_x, position_y, position_z);
             ribbon.setPointThickness(i, trail.width);
             ribbon.setPointAttribute_Scalar(i, RIBBON_ATTRIBUTE_ADDRESS_UV_OFFSET, f);
-            ribbon.setPointAlpha(i, color.w);
+            // seeded age = maxAge means "already expired", so alpha follows the fade law: 0
+            ribbon.setPointAlpha(i, 0);
             ribbon.setPointAttribute_Scalar(i, RIBBON_ATTRIBUTE_ADDRESS_AGE, trail.maxAge);
 
         }
@@ -238,7 +239,7 @@ class Trail2DSystem extends System {
 
         const ageOffset = max2(0, trail.maxAge - trail.time);
 
-        this.simulator.update(ribbon, trail.maxAge, timeDelta);
+        this.simulator.update(ribbon, trail.maxAge, timeDelta, trail.color.w);
 
         if (trail.getFlag(Trail2DFlags.Spawning)) {
             trail.updateHead(newPosition.x, newPosition.y, newPosition.z, ageOffset);

package/src/engine/graphics/ecs/trail3d/Trail3D.d.ts

@@ -54,6 +54,8 @@ declare class Trail3D {
      */
     distanceSinceLastUpdate: number;
     /**
+     * RGB tints the tube; alpha is the trail's base opacity, which the
+     * age-driven fade scales down to zero.
      * @readonly
      * @type {Color}
      */

package/src/engine/graphics/ecs/trail3d/Trail3D.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Trail3D.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/trail3d/Trail3D.js"],"names":[],"mappings":";AAgCA;;;;;GAKG;AACH;IA4MI,oCAMC;IAhND;;;OAGG;IACH,QAFU,MAAM,CAES;IAEzB;;;OAGG;IACH,OAFU,MAAM,CAEM;IAEtB;;;;OAIG;IACH,gBAFU,MAAM,CAEyB;IAEzC;;;OAGG;IACH,WAFU,cAAc,GAAC,MAAM,CAEC;IAEhC;;;;OAIG;IACH,eAFU,MAAM,CAEuB;IAEvC;;;OAGG;IACH,MAFU,MAAM,CAEP;IAET;;OAEG;IACH,eAFU,MAAM,CAEE;IAElB;;;OAGG;IACH,qBAFU,MAAM,CAEQ;IAExB;;;OAGG;IACH,yBAFU,MAAM,CAEY;IAE5B;;;OAGG;IACH,gBAFU,KAAK,CAEe;IAE9B;;;;OAIG;IACH,iBAFU,OAAO,CAEM;IAEvB;;;OAGG;IACH,MAFU,KAAK,GAAC,IAAI,CAER;IAEZ;;;OAGG;IACH,MAFU,OAAK,IAAI,CAEP;IAEZ;;;OAGG;IACH,UAFU,iBAAiB,CAEQ;IAEnC;;;OAGG;IACH,cAFU,SAAS,CAEG;IAEtB;;;OAGG;IACH,cAAsB;IAEtB,gBAQC;IAMD,4BAEC;IAND,yBAEC;IAUD,6BAEC;IAND,0BAEC;IAMD;;;OAGG;IACH,cAHW,MAAM,GAAC,YAAY,GACjB,IAAI,CAIhB;IAED;;;OAGG;IACH,gBAHW,MAAM,GAAC,YAAY,GACjB,IAAI,CAIhB;IAED;;;OAGG;IACH,gBAHW,MAAM,GAAC,YAAY,SACnB,OAAO,QAQjB;IAED;;;OAGG;IACH,cAHW,MAAM,GAAC,YAAY,GACjB,OAAO,CAInB;IAED;;OAEG;IACH,qBAFW,MAAM,QAehB;IAED;;OAEG;IACH,cAmBC;IAUD;;;;;;;;;;;;;;;aAsBC;IAED;;;;;;;;;;;;;;;;;;;MAYC;IAED;;OAEG;IACH,cAFW,OAAO,WAajB;IAkDD;;;;;;OAMG;IACH,cANW,MAAM,KACN,MAAM,KACN,MAAM,YACN,MAAM,GACJ,OAAO,CAgEnB;;CAEJ;;;;;+BA9Z8B,+BAA+B;sBAPxC,iCAAiC;oBACnC,kCAAkC;sBAShC,2BAA2B;kCACf,uCAAuC;0BAZ/C,yCAAyC;6BAatC,mBAAmB"}
+{"version":3,"file":"Trail3D.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/trail3d/Trail3D.js"],"names":[],"mappings":";AAgCA;;;;;GAKG;AACH;IA8MI,oCAMC;IAlND;;;OAGG;IACH,QAFU,MAAM,CAES;IAEzB;;;OAGG;IACH,OAFU,MAAM,CAEM;IAEtB;;;;OAIG;IACH,gBAFU,MAAM,CAEyB;IAEzC;;;OAGG;IACH,WAFU,cAAc,GAAC,MAAM,CAEC;IAEhC;;;;OAIG;IACH,eAFU,MAAM,CAEuB;IAEvC;;;OAGG;IACH,MAFU,MAAM,CAEP;IAET;;OAEG;IACH,eAFU,MAAM,CAEE;IAElB;;;OAGG;IACH,qBAFU,MAAM,CAEQ;IAExB;;;OAGG;IACH,yBAFU,MAAM,CAEY;IAE5B;;;;;OAKG;IACH,gBAFU,KAAK,CAEe;IAE9B;;;;OAIG;IACH,iBAFU,OAAO,CAEM;IAEvB;;;OAGG;IACH,MAFU,KAAK,GAAC,IAAI,CAER;IAEZ;;;OAGG;IACH,MAFU,OAAK,IAAI,CAEP;IAEZ;;;OAGG;IACH,UAFU,iBAAiB,CAEQ;IAEnC;;;OAGG;IACH,cAFU,SAAS,CAEG;IAEtB;;;OAGG;IACH,cAAsB;IAEtB,gBAQC;IAMD,4BAEC;IAND,yBAEC;IAUD,6BAEC;IAND,0BAEC;IAMD;;;OAGG;IACH,cAHW,MAAM,GAAC,YAAY,GACjB,IAAI,CAIhB;IAED;;;OAGG;IACH,gBAHW,MAAM,GAAC,YAAY,GACjB,IAAI,CAIhB;IAED;;;OAGG;IACH,gBAHW,MAAM,GAAC,YAAY,SACnB,OAAO,QAQjB;IAED;;;OAGG;IACH,cAHW,MAAM,GAAC,YAAY,GACjB,OAAO,CAInB;IAED;;OAEG;IACH,qBAFW,MAAM,QAehB;IAED;;OAEG;IACH,cAmBC;IAUD;;;;;;;;;;;;;;;aAsBC;IAED;;;;;;;;;;;;;;;;;;;MAYC;IAED;;OAEG;IACH,cAFW,OAAO,WAajB;IAkDD;;;;;;OAMG;IACH,cANW,MAAM,KACN,MAAM,KACN,MAAM,YACN,MAAM,GACJ,OAAO,CAiEnB;;CAEJ;;;;;+BAja8B,+BAA+B;sBAPxC,iCAAiC;oBACnC,kCAAkC;sBAShC,2BAA2B;kCACf,uCAAuC;0BAZ/C,yCAAyC;6BAatC,mBAAmB"}

package/src/engine/graphics/ecs/trail3d/Trail3D.js

@@ -94,6 +94,8 @@ class Trail3D {
     distanceSinceLastUpdate = 0;
 
     /**
+     * RGB tints the tube; alpha is the trail's base opacity, which the
+     * age-driven fade scales down to zero.
      * @readonly
      * @type {Color}
      */
@@ -413,9 +415,10 @@ class Trail3D {
             this.setFlag(Trail3DFlags.BoundsNeedUpdate);
         }
 
-        // set head to fresh value
+        // set head to fresh value; alpha follows the same fade law the simulator
+        // applies every tick, so the knot doesn't pop when it stops being the head
         tube.setKnotAttribute_Scalar(head_index, TUBE_ATTRIBUTE_ADDRESS_AGE, head_age);
-        tube.setKnotAlpha(head_index, clamp01(head_age / maxAge));
+        tube.setKnotAlpha(head_index, (1 - clamp01(head_age / maxAge)) * this.color.w);
         tube.setKnotThickness(head_index, this.width);
 
         return head_position_changed;

package/src/engine/graphics/ecs/trail3d/Trail3DSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Trail3DSystem.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/trail3d/Trail3DSystem.js"],"names":[],"mappings":";AAyBA;IAiCI;;;OAGG;IACH,4BAkBC;IAtDD,oDAAoC;IAEpC,+DAEE;IAEF;;OAEG;IACH,WAFU,0BAA0B,CAES;IAiB7C;;;OAGG;IACH,YAAgB;IAeZ;;OAEG;IACH,UAFU,cAAc,CAEO;IAE/B;;OAEG;IACH,aAFU,cAAY,IAAI,CAEH;IAG3B,2CAmBC;IAED,4CAIC;IA0DD;;;;OAIG;IACH,YAJW,OAAO,aACP,SAAS,YACT,MAAM,QAYhB;IAED;;;;OAIG;IACH,kBAJW,OAAO,aACP,SAAS,UACT,MAAM,QAQhB;IAED;;;OAGG;IACH,yBAHW,OAAO,aACP,SAAS,QAkCnB;IAED,6BAWC;;CACJ;uBA7OsB,wBAAwB;0BACrB,qCAAqC;oBAW3C,cAAc;4CAbU,uDAAuD;2CAUxD,0DAA0D;+BANtE,yBAAyB"}
+{"version":3,"file":"Trail3DSystem.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/trail3d/Trail3DSystem.js"],"names":[],"mappings":";AAyBA;IAiCI;;;OAGG;IACH,4BAkBC;IAtDD,oDAAoC;IAEpC,+DAEE;IAEF;;OAEG;IACH,WAFU,0BAA0B,CAES;IAiB7C;;;OAGG;IACH,YAAgB;IAeZ;;OAEG;IACH,UAFU,cAAc,CAEO;IAE/B;;OAEG;IACH,aAFU,cAAY,IAAI,CAEH;IAG3B,2CAmBC;IAED,4CAIC;IA2DD;;;;OAIG;IACH,YAJW,OAAO,aACP,SAAS,YACT,MAAM,QAYhB;IAED;;;;OAIG;IACH,kBAJW,OAAO,aACP,SAAS,UACT,MAAM,QAQhB;IAED;;;OAGG;IACH,yBAHW,OAAO,aACP,SAAS,QAkCnB;IAED,6BAWC;;CACJ;uBA9OsB,wBAAwB;0BACrB,qCAAqC;oBAW3C,cAAc;4CAbU,uDAAuD;2CAUxD,0DAA0D;+BANtE,yBAAyB"}

package/src/engine/graphics/ecs/trail3d/Trail3DSystem.js

@@ -151,7 +151,8 @@ class Trail3DSystem extends System {
             tube.setKnotPosition(i, position_x, position_y, position_z);
             tube.setKnotThickness(i, trail.width);
             tube.setKnotAttribute_Scalar(i, TUBE_ATTRIBUTE_ADDRESS_UV_V, f);
-            tube.setKnotAlpha(i, color.w);
+            // seeded age = maxAge means "already expired", so alpha follows the fade law: 0
+            tube.setKnotAlpha(i, 0);
             tube.setKnotAttribute_Scalar(i, TUBE_ATTRIBUTE_ADDRESS_AGE, trail.maxAge);
         }
 
@@ -215,7 +216,7 @@ class Trail3DSystem extends System {
 
         const ageOffset = max2(0, trail.maxAge - trail.time);
 
-        this.simulator.update(tube, trail.maxAge, timeDelta);
+        this.simulator.update(tube, trail.maxAge, timeDelta, trail.color.w);
 
         if (trail.getFlag(Trail3DFlags.Spawning)) {
             trail.updateHead(newPosition.x, newPosition.y, newPosition.z, ageOffset);

package/src/engine/graphics/trail/tube/simulator/TubeXFixedPhysicsSimulator.d.ts

@@ -1,14 +1,16 @@
 /**
  * Fixed-function simulation for {@link TubeX} tubes — the 3D analogue of
- * {@link RibbonXFixedPhysicsSimulator}. Ages every knot, fades its alpha to zero
- * as it approaches `max_age`, and flows the along-tube UV coordinate with age.
+ * {@link RibbonXFixedPhysicsSimulator}. Ages every knot, fades its alpha from
+ * `alpha` to zero as it approaches `max_age`, and flows the along-tube UV
+ * coordinate with age.
  */
 export class TubeXFixedPhysicsSimulator {
     /**
      * @param {TubeX} tube
      * @param {number} max_age
      * @param {number} timeDelta
+     * @param {number} [alpha] base alpha of an age-0 knot; the age fade scales it
      */
-    update(tube: TubeX, max_age: number, timeDelta: number): void;
+    update(tube: TubeX, max_age: number, timeDelta: number, alpha?: number): void;
 }
 //# sourceMappingURL=TubeXFixedPhysicsSimulator.d.ts.map

package/src/engine/graphics/trail/tube/simulator/TubeXFixedPhysicsSimulator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TubeXFixedPhysicsSimulator.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/trail/tube/simulator/TubeXFixedPhysicsSimulator.js"],"names":[],"mappings":"AAGA;;;;GAIG;AACH;IAEI;;;;OAIG;IACH,6BAHW,MAAM,aACN,MAAM,QAiBhB;CACJ"}
+{"version":3,"file":"TubeXFixedPhysicsSimulator.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/trail/tube/simulator/TubeXFixedPhysicsSimulator.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH;IAEI;;;;;OAKG;IACH,6BAJW,MAAM,aACN,MAAM,UACN,MAAM,QAiBhB;CACJ"}

package/src/engine/graphics/trail/tube/simulator/TubeXFixedPhysicsSimulator.js

@@ -3,8 +3,9 @@ import { TUBE_ATTRIBUTE_ADDRESS_AGE, TUBE_ATTRIBUTE_ADDRESS_UV_V } from "../tube
 
 /**
  * Fixed-function simulation for {@link TubeX} tubes — the 3D analogue of
- * {@link RibbonXFixedPhysicsSimulator}. Ages every knot, fades its alpha to zero
- * as it approaches `max_age`, and flows the along-tube UV coordinate with age.
+ * {@link RibbonXFixedPhysicsSimulator}. Ages every knot, fades its alpha from
+ * `alpha` to zero as it approaches `max_age`, and flows the along-tube UV
+ * coordinate with age.
  */
 export class TubeXFixedPhysicsSimulator {
 
@@ -12,8 +13,9 @@ export class TubeXFixedPhysicsSimulator {
      * @param {TubeX} tube
      * @param {number} max_age
      * @param {number} timeDelta
+     * @param {number} [alpha] base alpha of an age-0 knot; the age fade scales it
      */
-    update(tube, max_age, timeDelta) {
+    update(tube, max_age, timeDelta, alpha = 1) {
 
         const n = tube.getCount();
 
@@ -23,7 +25,7 @@ export class TubeXFixedPhysicsSimulator {
             const relative_age = clamp01(age / max_age);
 
             // fade out with age
-            tube.setKnotAlpha(i, 1.0 - relative_age);
+            tube.setKnotAlpha(i, (1.0 - relative_age) * alpha);
 
             // flow the along-tube UV with age
             tube.setKnotAttribute_Scalar(i, TUBE_ATTRIBUTE_ADDRESS_UV_V, relative_age);

package/src/engine/graphics/trail/x/simulator/RibbonXFixedPhysicsSimulator.d.ts

@@ -7,7 +7,8 @@ export class RibbonXFixedPhysicsSimulator {
      * @param {RibbonX} ribbon
      * @param {number} max_age
      * @param {number} timeDelta
+     * @param {number} [alpha] base alpha of an age-0 point; the age fade scales it
      */
-    update(ribbon: RibbonX, max_age: number, timeDelta: number): void;
+    update(ribbon: RibbonX, max_age: number, timeDelta: number, alpha?: number): void;
 }
 //# sourceMappingURL=RibbonXFixedPhysicsSimulator.d.ts.map

package/src/engine/graphics/trail/x/simulator/RibbonXFixedPhysicsSimulator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RibbonXFixedPhysicsSimulator.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/trail/x/simulator/RibbonXFixedPhysicsSimulator.js"],"names":[],"mappings":"AAIA;;GAEG;AACH;IAEI;;;;;OAKG;IACH,iCAHW,MAAM,aACN,MAAM,QAkBhB;CACJ"}
+{"version":3,"file":"RibbonXFixedPhysicsSimulator.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/trail/x/simulator/RibbonXFixedPhysicsSimulator.js"],"names":[],"mappings":"AAIA;;GAEG;AACH;IAEI;;;;;;OAMG;IACH,iCAJW,MAAM,aACN,MAAM,UACN,MAAM,QAkBhB;CACJ"}

package/src/engine/graphics/trail/x/simulator/RibbonXFixedPhysicsSimulator.js

@@ -12,8 +12,9 @@ export class RibbonXFixedPhysicsSimulator {
      * @param {RibbonX} ribbon
      * @param {number} max_age
      * @param {number} timeDelta
+     * @param {number} [alpha] base alpha of an age-0 point; the age fade scales it
      */
-    update(ribbon, max_age, timeDelta) {
+    update(ribbon, max_age, timeDelta, alpha = 1) {
 
         const n = ribbon.getCount();
         for (let i = 0; i < n; i++) {
@@ -23,7 +24,7 @@ export class RibbonXFixedPhysicsSimulator {
             const relative_age = clamp01(age / max_age);
 
             // apply alpha over-time
-            ribbon.setPointAlpha(i, 1.0 - relative_age);
+            ribbon.setPointAlpha(i, (1.0 - relative_age) * alpha);
 
             ribbon.setPointAttribute_Scalar(i, RIBBON_ATTRIBUTE_ADDRESS_UV_OFFSET, relative_age);
         }