@woosh/meep-engine 2.165.1 → 2.165.2

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.2",
   "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) {