@woosh/meep-engine 2.165.7 → 2.166.0

package/src/engine/animation/keyed2/AnimationTrackPlayback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnimationTrackPlayback.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/keyed2/AnimationTrackPlayback.js"],"names":[],"mappings":";AAGA;IACI;;;;;;;;OAQG;IACH,4EAuBC;IAtBG,sBAAkB;IAClB,cAA+B;IAE/B,oBAAoC;IACpC,kBAAgC;IAEhC,uBAAuB;IACvB,8BAA8B;IAE9B,uBAAuB;IACvB,sBAAsB;IAEtB,gBAAmB;IAEnB,4BAA0D;IAG1D;;MAEC;IAKL;;;OAGG;IACH,oBAEC;IAED;;;OAGG;IACH,gBAFa,QAAQ,IAAI,CAAC,CAUzB;IAED;;;OAGG;IACH,WAFW,OAAO,QAIjB;IAED,cAEC;IAED;;;OAGG;IACH,kBAFW,MAAM,QA2BhB;IAED;;;OAGG;IACH,cAFa,OAAO,CA2CnB;IAED;;;OAGG;IACH,mBAFW,MAAM,QA+BhB;IAED,eAOC;IAED;;;OAGG;IACH,0BAFW,MAAM,EAAE,QA2ClB;CACJ;mBAhPkB,uCAAuC"}
+{"version":3,"file":"AnimationTrackPlayback.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/keyed2/AnimationTrackPlayback.js"],"names":[],"mappings":";AAGA;IACI;;;;;;;;OAQG;IACH,4EAuBC;IAtBG,sBAAkB;IAClB,cAA+B;IAE/B,oBAAoC;IACpC,kBAAgC;IAEhC,uBAAuB;IACvB,8BAA8B;IAE9B,uBAAuB;IACvB,sBAAsB;IAEtB,gBAAmB;IAEnB,4BAA0D;IAG1D;;MAEC;IAKL;;;OAGG;IACH,oBAEC;IAED;;;OAGG;IACH,gBAFa,QAAQ,IAAI,CAAC,CAUzB;IAED;;;OAGG;IACH,WAFW,OAAO,QAIjB;IAED,cAEC;IAED;;;OAGG;IACH,kBAFW,MAAM,QA2BhB;IAED;;;OAGG;IACH,cAFa,OAAO,CA2CnB;IAED;;;OAGG;IACH,mBAFW,MAAM,QAmChB;IAED,eAOC;IAED;;;OAGG;IACH,0BAFW,MAAM,EAAE,QA2ClB;CACJ;mBApPkB,uCAAuC"}

package/src/engine/animation/keyed2/AnimationTrackPlayback.js

@@ -159,7 +159,11 @@ class AnimationTrackPlayback {
         if (timeDelta < 0) {
             //negative delta, going back in time
             this.setPosition(newPosition);
-        } else if (newPosition > this.__nextKeyTime) {
+            // the `>= timeEnd` term catches a frame that lands EXACTLY on the end: __nextKeyTime equals
+            // timeEnd on the final segment, so the strict `> __nextKeyTime` test would skip it, and the
+            // one-shot `ended` (guarded by position < timeEnd) would then never fire. Mid-track exact
+            // landings do not reach timeEnd, so they stay on the plain else branch as before.
+        } else if (newPosition > this.__nextKeyTime || newPosition >= this.track.timeEnd) {
 
             if (newPosition >= this.track.timeEnd) {
                 if (this.__loop) {

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

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

package/src/engine/ecs/EntityComponentDataset.js

@@ -1,7 +1,6 @@
 import { assert } from "../../core/assert.js";
 import { BitSet } from "../../core/binary/BitSet.js";
 import { array_set_diff } from "../../core/collection/array/array_set_diff.js";
-import { array_shrink_to_size } from "../../core/collection/array/array_shrink_to_size.js";
 import { findSignalHandlerIndexByHandle } from "../../core/events/signal/findSignalHandlerIndexByHandle.js";
 import {
     findSignalHandlerIndexByHandleAndContext
@@ -107,18 +106,6 @@ function buildObserverCallbackArgs(entityIndex, mask, componentIndexMap, compone
     }
 }
 
-/**
- *
- * @type {number[]}
- */
-const scratch_indices = [];
-
-/**
- * Used for constructing arguments prior to traversal visitor call
- * @type {*[]}
- */
-const scratch_args = [];
-
 /**
  * Represents a storage for entities and their associated components.
  * Entities are just integer IDs and components are stored in a virtual table, where each component type has a separate column and each entity is a row in that table.
@@ -1327,8 +1314,10 @@ export class EntityComponentDataset {
 
         let entityIndex, i;
 
-        //map classes to indices
-        const indices = scratch_indices;
+        // Local arrays rather than the module-shared scratch pools: the visitor may itself call
+        // traverseEntities (an ordinary "for each A, scan the B entities" pattern), and a shared pool
+        // would let the inner call clobber this call's indices/args mid-scan. Matches traverseEntitiesExact.
+        const indices = [];
 
         // prepare sorted array of component indices
         const numClasses = classes.length;
@@ -1348,12 +1337,7 @@ export class EntityComponentDataset {
             indices[i] = componentIndex;
         }
 
-        const args = scratch_args;
-
-        // crop args array to the right length (since we're re-using a scratch array)
-        const args_length_intended = numClasses + 1;
-
-        array_shrink_to_size(scratch_args, args_length_intended);
+        const args = [];
 
         const entityOccupancy = this.entityOccupancy;
 

package/src/engine/ecs/fow/FogOfWar.d.ts

@@ -74,6 +74,14 @@ export class FogOfWar {
      * @param {number} radius
      */
     conceal(x: number, y: number, radius: number): void;
+    /**
+     * Rebuild the cell -> fade row index from the current {@link fadeMask}
+     * contents. Must be invoked whenever the fade mask is populated without
+     * going through {@link reveal}/{@link conceal}/{@link revealPoint} (e.g.
+     * after deserialization), otherwise those methods could stack duplicate
+     * fade rows for a cell.
+     */
+    rebuildFadeIndex(): void;
     dispose(): void;
     updateTexture(): void;
     /**
@@ -117,6 +125,7 @@ export class FogOfWar {
      * @param scale
      */
     resize(w: number, h: number, scale: any): void;
+    #private;
 }
 export namespace FogOfWar {
     let typeName: string;

package/src/engine/ecs/fow/FogOfWar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FogOfWar.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/fow/FogOfWar.js"],"names":[],"mappings":"AA+CA;;GAEG;AACH;IAEI;;;OAGG;IACH,oBAFU,OAAO,CAES;IAC1B;;;OAGG;IACH,0BAFU,OAAO,CAEgB;IAEjC;;;OAGG;IACH,SAFU,WAAW,GAAC,IAAI,CAEX;IAEf;;;OAGG;IACH,OAFU,OAAO,CAEM;IAEvB;;;OAGG;IACH,MAFU,OAAO,CAEQ;IAEzB,eAAsC;IAEtC;;;OAGG;IACH,UAFU,aAAa,CAE2B;IAElD;;MAEE;IAEF;;;OAGG;IACH,SAFU,SAAS,CAEgB;IAEnC;;;OAGG;IACH,iBAFU,SAAS,CAEwB;IAE3C;;;OAGG;IACH,sBAFW,MAAM,QAqDhB;IAED;;;;OAIG;IACH,eAHW,MAAM,KACN,MAAM,QAyBhB;IAED,cAOC;IAED,kBAOC;IAED,mBAEC;IAED;;;;;OAKG;IACH,UAJW,MAAM,KACN,MAAM,UACN,MAAM,QA+ChB;IAED;;;;;OAKG;IACH,WAJW,MAAM,KACN,MAAM,UACN,MAAM,QAgDhB;IAED,gBAIC;IAED,sBAqCC;IAED;;;OAGG;IACH,kBAFW,MAAM,QAYhB;IAED;;;OAGG;IACH,0DA+BC;IAED;;;;;OAKG;IACH,yBAJW,MAAM,KACN,MAAM,UACN,MAAM,EAAE,QAelB;IAED;;;;;OAKG;IACH,yEAFW,MAAM,WA+EhB;IAED;;;;;OAKG;IACH,qBAJW,MAAM,KACN,MAAM,GACJ,MAAM,CASlB;IAED,6BAKC;IAED,+BASC;IAED,uBAyBC;IAGD;;;;;OAKG;IACH,UAJW,MAAM,KACN,MAAM,oBAUhB;CACJ;;;;4BAxlB2F,OAAO;oBAM/E,+BAA+B;oBAC/B,+BAA+B;oBAC/B,+BAA+B;8BALrB,iDAAiD;mBAE5D,uCAAuC;0BAQhC,6CAA6C"}
+{"version":3,"file":"FogOfWar.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/fow/FogOfWar.js"],"names":[],"mappings":"AA+CA;;GAEG;AACH;IAEI;;;OAGG;IACH,oBAFU,OAAO,CAES;IAC1B;;;OAGG;IACH,0BAFU,OAAO,CAEgB;IAEjC;;;OAGG;IACH,SAFU,WAAW,GAAC,IAAI,CAEX;IAEf;;;OAGG;IACH,OAFU,OAAO,CAEM;IAEvB;;;OAGG;IACH,MAFU,OAAO,CAEQ;IAEzB,eAAsC;IAEtC;;;OAGG;IACH,UAFU,aAAa,CAE2B;IAWlD;;MAEE;IAEF;;;OAGG;IACH,SAFU,SAAS,CAEgB;IAEnC;;;OAGG;IACH,iBAFU,SAAS,CAEwB;IAE3C;;;OAGG;IACH,sBAFW,MAAM,QA6EhB;IA4DD;;;;OAIG;IACH,eAHW,MAAM,KACN,MAAM,QAUhB;IAED,cAQC;IAED,kBAQC;IAED,mBAEC;IAED;;;;;OAKG;IACH,UAJW,MAAM,KACN,MAAM,UACN,MAAM,QAmChB;IAED;;;;;OAKG;IACH,WAJW,MAAM,KACN,MAAM,UACN,MAAM,QAmChB;IAED;;;;;;OAMG;IACH,yBAcC;IAED,gBAIC;IAED,sBAqCC;IAED;;;OAGG;IACH,kBAFW,MAAM,QAYhB;IAED;;;OAGG;IACH,0DA+BC;IAED;;;;;OAKG;IACH,yBAJW,MAAM,KACN,MAAM,UACN,MAAM,EAAE,QAelB;IAED;;;;;OAKG;IACH,yEAFW,MAAM,WA+EhB;IAED;;;;;OAKG;IACH,qBAJW,MAAM,KACN,MAAM,GACJ,MAAM,CASlB;IAED,6BAKC;IAED,+BASC;IAED,uBAyBC;IAGD;;;;;OAKG;IACH,UAJW,MAAM,KACN,MAAM,oBAahB;;CACJ;;;;4BAvqB2F,OAAO;oBAM/E,+BAA+B;oBAC/B,+BAA+B;oBAC/B,+BAA+B;8BALrB,iDAAiD;mBAE5D,uCAAuC;0BAQhC,6CAA6C"}

package/src/engine/ecs/fow/FogOfWar.js

@@ -87,6 +87,15 @@ export class FogOfWar {
      */
     fadeMask = new RowFirstTable(revealMaskTableSpec);
 
+    /**
+     * Maps a sampler cell index to the row index of its in-progress fade in
+     * {@link fadeMask}. Enforces at most one fade row per cell, so that the
+     * latest reveal/conceal command for a cell re-aims its existing fade
+     * instead of stacking a second, opposing row.
+     * @type {Map<number, number>}
+     */
+    #fadeRowByCell = new Map();
+
     on = {
         textureChanged: new Signal()
     };
@@ -112,6 +121,8 @@ export class FogOfWar {
 
         const fadeMask = this.fadeMask;
 
+        const rowByCell = this.#fadeRowByCell;
+
         let numRows = fadeMask.length;
 
         let i = 0;
@@ -130,25 +141,24 @@ export class FogOfWar {
 
             let writeValue = value | 0;
 
-            //write new value
+            //store the advanced precise value
             fadeMask.writeCellValue(i, 1, value);
 
+            let completed = false;
+
             if (value <= 0) {
+                writeValue = 0;
+
                 if (speed < 0) {
-                    //we were going down and reached the end, clear row
-                    fadeMask.removeRows(i, 1);
-                    i--;
-                    numRows--;
+                    //revealing fade reached the bottom
+                    completed = true;
                 }
-                writeValue = 0;
             } else if (value >= 255) {
                 writeValue = 255;
 
                 if (speed > 0) {
-                    //we were going down and reached the end, clear row
-                    fadeMask.removeRows(i, 1);
-                    i--;
-                    numRows--;
+                    //concealing fade reached the top
+                    completed = true;
                 }
             }
 
@@ -157,41 +167,108 @@ export class FogOfWar {
                 samplerData[index] = writeValue;
                 this.textureNeedsUpdate = true;
             }
+
+            if (completed) {
+                //Drop the finished row while keeping the cell->row index
+                //consistent. Swap the last row into this slot (O(1)) instead of
+                //shifting the whole tail forward, so only one other row's index
+                //needs to be patched in the map.
+                rowByCell.delete(index);
+
+                const lastRow = numRows - 1;
+
+                if (i !== lastRow) {
+                    const movedCell = fadeMask.readCellValue(lastRow, 0);
+
+                    fadeMask.copyRow(lastRow, i);
+
+                    rowByCell.set(movedCell, i);
+                }
+
+                fadeMask.removeRows(lastRow, 1);
+
+                i--;
+                numRows--;
+            }
         }
     }
 
     /**
-     *
-     * @param {number} x
-     * @param {number} y
+     * Schedule (or re-aim) a fade for a single sampler cell so that it converges
+     * to `target`. Guarantees at most one fade row per cell: if the cell already
+     * has an in-progress fade its direction is updated in place, so the latest
+     * command wins instead of stacking a second, opposing row.
+     * @param {number} index sampler cell index
+     * @param {number} target target sampler value, either 0 (revealed) or 255 (concealed)
+     * @returns {boolean} whether the visible sampler value was changed (i.e. the distance field may need a rebuild)
      */
-    revealPoint(x, y) {
+    #scheduleCellFade(index, target) {
         const fadeMask = this.fadeMask;
+        const rowByCell = this.#fadeRowByCell;
 
-        const sampler = this.sampler;
+        const speed = target === 0 ? -FADE_SPEED : FADE_SPEED;
 
-        const samplerData = sampler.data;
+        const existingRow = rowByCell.get(index);
 
-        const samplerWidth = sampler.width;
+        if (existingRow !== undefined) {
+            //A fade is already in progress for this cell, re-aim it in place.
+            //The precise value column is left untouched so the fade resumes from
+            //its current progress and never snaps back through the far end.
+            fadeMask.writeCellValue(existingRow, 2, speed);
 
-        const index = (y + 1) * samplerWidth + (x + 1);
+            return false;
+        }
 
-        if (samplerData[index] === 255) {
+        const samplerData = this.sampler.data;
+
+        const current = samplerData[index];
+
+        if (current === target) {
+            //already fully at the target, nothing to fade
+            return false;
+        }
+
+        let seedValue = current;
+        let visibleChanged = false;
+
+        if (target === 0 && current === 255) {
+            //pre-fade off the fully-concealed value so the distance field
+            //immediately treats this cell as being revealed
+            seedValue = INITIAL_FADE_VALUE;
             samplerData[index] = INITIAL_FADE_VALUE;
+            visibleChanged = true;
+        }
+
+        //add record to fade mask
+        fadeRow[0] = index;
+        fadeRow[1] = seedValue;
+        fadeRow[2] = speed;
 
-            //add record to fade mask
-            fadeRow[0] = index;
-            fadeRow[1] = INITIAL_FADE_VALUE;
-            fadeRow[2] = -FADE_SPEED;
+        const rowIndex = fadeMask.addRow(fadeRow);
 
-            fadeMask.addRow(fadeRow);
+        rowByCell.set(index, rowIndex);
 
+        return visibleChanged;
+    }
+
+    /**
+     *
+     * @param {number} x
+     * @param {number} y
+     */
+    revealPoint(x, y) {
+        const samplerWidth = this.sampler.width;
+
+        const index = (y + 1) * samplerWidth + (x + 1);
+
+        if (this.#scheduleCellFade(index, 0)) {
             this.distanceFieldNeedsUpdate = true;
         }
     }
 
     clear() {
         this.fadeMask.clear();
+        this.#fadeRowByCell.clear();
 
         this.sampler.data.fill(255);
 
@@ -201,6 +278,7 @@ export class FogOfWar {
 
     revealAll() {
         this.fadeMask.clear();
+        this.#fadeRowByCell.clear();
 
         this.sampler.data.fill(0);
 
@@ -230,11 +308,8 @@ export class FogOfWar {
         const lastPixelX = samplerWidth - 1;
 
         let changeFlag = false;
-        const samplerData = sampler.data;
-
-        const fadeMask = this.fadeMask;
 
-        sampler.traverseCircle(x + 1, y + 1, radius, function (x, y, sampler) {
+        sampler.traverseCircle(x + 1, y + 1, radius, (x, y) => {
 
             if (x <= 0 || x >= lastPixelX || y <= 0 || y >= lastPixelY) {
                 //edges are reserved to preserve cover outside of the working area
@@ -243,16 +318,7 @@ export class FogOfWar {
 
             const index = y * samplerWidth + x;
 
-            if (samplerData[index] === 255) {
-                samplerData[index] = INITIAL_FADE_VALUE;
-
-                //add record to fade mask
-                fadeRow[0] = index;
-                fadeRow[1] = INITIAL_FADE_VALUE;
-                fadeRow[2] = -FADE_SPEED;
-
-                fadeMask.addRow(fadeRow);
-
+            if (this.#scheduleCellFade(index, 0)) {
                 changeFlag = true;
             }
 
@@ -283,11 +349,8 @@ export class FogOfWar {
         const lastPixelX = samplerWidth - 1;
 
         let changeFlag = false;
-        const samplerData = sampler.data;
-
-        const fadeMask = this.fadeMask;
 
-        sampler.traverseCircle(x + 1, y + 1, radius, function (x, y, sampler) {
+        sampler.traverseCircle(x + 1, y + 1, radius, (x, y) => {
 
             if (x <= 0 || x >= lastPixelX || y <= 0 || y >= lastPixelY) {
                 //edges are reserved to preserve cover outside of the working area
@@ -296,17 +359,7 @@ export class FogOfWar {
 
             const index = y * samplerWidth + x;
 
-            const value = samplerData[index];
-
-            if (value !== 255) {
-
-                //add record to fade mask
-                fadeRow[0] = index;
-                fadeRow[1] = value;
-                fadeRow[2] = FADE_SPEED;
-
-                fadeMask.addRow(fadeRow);
-
+            if (this.#scheduleCellFade(index, 255)) {
                 changeFlag = true;
             }
 
@@ -319,6 +372,29 @@ export class FogOfWar {
         }
     }
 
+    /**
+     * Rebuild the cell -> fade row index from the current {@link fadeMask}
+     * contents. Must be invoked whenever the fade mask is populated without
+     * going through {@link reveal}/{@link conceal}/{@link revealPoint} (e.g.
+     * after deserialization), otherwise those methods could stack duplicate
+     * fade rows for a cell.
+     */
+    rebuildFadeIndex() {
+        const rowByCell = this.#fadeRowByCell;
+
+        rowByCell.clear();
+
+        const fadeMask = this.fadeMask;
+
+        const numRows = fadeMask.length;
+
+        for (let i = 0; i < numRows; i++) {
+            const index = fadeMask.readCellValue(i, 0);
+
+            rowByCell.set(index, i);
+        }
+    }
+
     dispose() {
         if (this.texture !== null) {
             this.texture.dispose();
@@ -594,7 +670,10 @@ export class FogOfWar {
         this.size.set(w, h);
         this.scale.set(scale);
 
-        //TODO update fade mask as necessary
+        //TODO update fade mask as necessary - the sampler indices change with the
+        //new width, so any in-progress fade rows (and the #fadeRowByCell index that
+        //mirrors them) would need remapping or clearing. Only reachable at link time
+        //today, when both are empty.
 
         this.rebuildSampler();
     }

package/src/engine/ecs/fow/serialization/FogOfWarSerializationAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FogOfWarSerializationAdapter.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/fow/serialization/FogOfWarSerializationAdapter.js"],"names":[],"mappings":"AAQA;;IAEI,uBAAiB;IAGjB,oDAA2D;IAE3D;;;;OAIG;IACH,uCAFW,QAAQ,QAyBlB;IAED;;;;OAIG;IACH,yCAFW,QAAQ,QAgClB;CACJ;gDAjF+C,yDAAyD;yBAChF,gBAAgB;8CAKlC,kFAAkF"}
+{"version":3,"file":"FogOfWarSerializationAdapter.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/fow/serialization/FogOfWarSerializationAdapter.js"],"names":[],"mappings":"AAQA;;IAEI,uBAAiB;IAGjB,oDAA2D;IAE3D;;;;OAIG;IACH,uCAFW,QAAQ,QAyBlB;IAED;;;;OAIG;IACH,yCAFW,QAAQ,QAmClB;CACJ;gDApF+C,yDAAyD;yBAChF,gBAAgB;8CAKlC,kFAAkF"}

package/src/engine/ecs/fow/serialization/FogOfWarSerializationAdapter.js

@@ -75,6 +75,9 @@ export class FogOfWarSerializationAdapter extends BinaryClassSerializationAdapte
         //deserialize reveal state
         deserializeRowFirstTable(buffer, value.fadeMask);
 
+        //rebuild the cell -> fade row index to match the restored fade mask
+        value.rebuildFadeIndex();
+
         //
         value.textureNeedsUpdate = true;
         value.rebuildDistanceSampler();

package/src/engine/ecs/storage/binary/collection/BinaryCollectionDeSerializer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BinaryCollectionDeSerializer.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/ecs/storage/binary/collection/BinaryCollectionDeSerializer.js"],"names":[],"mappings":"AAkBA;;;;GAIG;AACH;IAEI;;;OAGG;IACH,iBAAgB;IAEhB;;;OAGG;IACH,eAAc;IAEd;;;;OAIG;IACH,4BAA4B;IAC5B;;;;OAIG;IACH,0BAA0B;IAE1B;;;OAGG;IACH,qBAAiB;IAEjB;;;OAGG;IACH,qBAAiB;IAEjB;;;OAGG;IACH,qBAAiB;IAEjB;;;OAGG;IACH,gBAAe;IAEf;;;OAGG;IACH,kBAAiB;IAEjB;;;;OAIG;IACH,yBAAsC;IACtC;;;;OAIG;IACH,yBAAsC;IAEtC;;;OAGG;IACH,cAAsB;IAGtB;;;OAGG;IACH,yDAKC;IAED;;;OAGG;IACH,2CAEC;IAED;;;OAGG;IACH,kBAFW,YAAY,QAOtB;IAED;;;OAGG;IACH,mBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,mBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,mBAFa,WAAS,IAAI,CAUzB;IAED;;;OAGG;IACH,wDAFyB,MAAM,QAgF9B;IAED,iBAWC;IAED;;;OAGG;IACH,uBAeC;IAED;;;OAGG;IACH;;aAF6B,MAAM;MA8DlC;CAEJ;6BAvV4B,4CAA4C"}
+{"version":3,"file":"BinaryCollectionDeSerializer.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/ecs/storage/binary/collection/BinaryCollectionDeSerializer.js"],"names":[],"mappings":"AAkBA;;;;GAIG;AACH;IAEI;;;OAGG;IACH,iBAAgB;IAEhB;;;OAGG;IACH,eAAc;IAEd;;;;OAIG;IACH,4BAA4B;IAC5B;;;;OAIG;IACH,0BAA0B;IAE1B;;;OAGG;IACH,qBAAiB;IAEjB;;;OAGG;IACH,qBAAiB;IAEjB;;;OAGG;IACH,qBAAiB;IAEjB;;;OAGG;IACH,gBAAe;IAEf;;;OAGG;IACH,kBAAiB;IAEjB;;;;OAIG;IACH,yBAAsC;IACtC;;;;OAIG;IACH,yBAAsC;IAEtC;;;OAGG;IACH,cAAsB;IAGtB;;;OAGG;IACH,yDAKC;IAED;;;OAGG;IACH,2CAEC;IAED;;;OAGG;IACH,kBAFW,YAAY,QAOtB;IAED;;;OAGG;IACH,mBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,mBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,mBAFa,WAAS,IAAI,CAUzB;IAED;;;OAGG;IACH,wDAFyB,MAAM,QAgF9B;IAED,iBAWC;IAED;;;OAGG;IACH,uBAeC;IAED;;;OAGG;IACH;;aAF6B,MAAM;MAgElC;CAEJ;6BAzV4B,4CAA4C"}

package/src/engine/ecs/storage/binary/collection/BinaryCollectionDeSerializer.js

@@ -315,7 +315,9 @@ export class BinaryCollectionDeSerializer {
                     header = buffer.readUint32LE();
                 }
 
-                const offset = header >> 2;
+                // unsigned: for a first-occurrence offset >= 2^29 the header sets bit 31, and a signed
+                // shift would sign-extend it into a negative (wrong) offset
+                const offset = header >>> 2;
 
                 //read address
                 const address = offset + this.startAddress;

package/src/engine/graphics/GraphicsEngine.d.ts

@@ -35,7 +35,11 @@ export class GraphicsEngine {
      */
     pixelRatio: Vector1;
     /**
-     * Final render-target resolution, in device pixels: `viewport.size × pixelRatio × devicePixelRatio`.
+     * Final render-target resolution, in whole device pixels: `viewport.size × pixelRatio ×
+     * devicePixelRatio`, floored and clamped the same way the attachments themselves are. This is
+     * the authority every full-resolution buffer is sized from -- frame buffers, composit layers,
+     * and anything that has to sample them on their own texel grid. Zero until the viewport has
+     * been sized for the first time.
      * Kept in sync by {@link GraphicsEngine#updateSize}. Subscribe to `output_resolution.onChanged` to
      * react to any change in the actual rendered resolution (viewport resize, supersample, or DPR change).
      * @readonly

package/src/engine/graphics/GraphicsEngine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GraphicsEngine.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics/GraphicsEngine.js"],"names":[],"mappings":"AAiEA;IAOI;;;;;OAKG;IACH,+BAJW,MAAM,EAgLhB;IAtLD,gCAEC;IAgBG;;;;OAIG;IACH,2BAA+C;IAK/C;;;;;QAOI;;WAEG;;QAEH;;WAEG;;;;;MAMN;IAED;;OAEG;IACH,YAFU,OAAO,CAEe;IAEhC;;;;;;OAMG;IACH,4BAFU,OAAO,CAEyB;IAE1C;;;OAGG;IACH,QAFU,kBAAkB,CAEU;IAWtC;;;OAGG;IACH,aAAkB;IAGlB;;;OAGG;IACH,cAFU,KAAK,CAEgB;IAK/B;;;OAGG;IACH,QAFU,MAAM,CAEI;IAEpB;;;OAGG;IACH,UAFU,aAAa,CAEH;IAGpB,+BAA0C;IAU1C;;OAEG;IACH,eAA+B;IAI/B;;;OAGG;IACH,uBAFU,kBAAkB,CAEgB;IAE5C;;;OAGG;IACH,oBAFU,iBAAiB,CAEsB;IAEjD;;;OAGG;IACH,gBAFU,iBAAiB,CAES;IAEpC;;;OAGG;IACH,sBAAoC;IAGpC;;;;OAIG;IACH,UAFU,OAAO,CAEG;IAEpB;;;OAGG;IACH,UAFU,OAAO,CAEG;IAEpB;;;OAGG;IACH,YAFU,MAAM,CAEG;IACnB,kKAcI;IAGR;;;OAGG;IACH,sBAFa,eAAe,CAI3B;IAED;;;OAGG;IACH,eAFa,aAAa,CAIzB;IAED;;;;;;;;;;;;;OAaG;IACH,iCAHW,MAAM,OAAO,eACb,4BAA4B,QAkCtC;IAED,mBA8BC;IAED;;;;OAIG;IACH,iCAEC;IAED;;;OAGG;IACH,0BAFa,MAAM,CAIlB;IAED,+BAcC;IAED,cAgEC;IAzBsB,8BAA0C;IA2BjE;;;OAGG;IACH,cAFa,MAAM,CAYlB;IAED;;OAEG;IACH,aAQC;IAED;;OAEG;IACH,yBAQC;IAED;;;;;;OAMG;IACH,yBALW,MAAM,KACN,MAAM,6CAMhB;IAED;;;;OAIG;IACH,8BAHW,OAAO,UAAQ,UACf,OAAO,UAAQ,QAczB;IAED;;;;;OAKG;IACH,8BAQC;IAED,0BAEC;IAED;;;OAGG;IACH,4BAFW,cAAc,QA8BxB;IAED;;OAEG;IACH,qBAqBC;IAED;;OAEG;IACH,0BAeC;IAED;;OAEG;IACH,eA8CC;;CACJ;mBA7oBkB,oCAAoC;oBACnC,4BAA4B;wBACxB,4BAA4B;mCAajB,uCAAuC;sBAlBnE,OAAO;uBAaS,wBAAwB;8BAbxC,OAAO;4BAYc,+BAA+B;mCAKxB,uCAAuC;kCAKxC,gCAAgC;kCADhC,oCAAoC;gCAPtC,uCAAuC;6CAW1B,2CAA2C;+BANzD,4BAA4B"}
+{"version":3,"file":"GraphicsEngine.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics/GraphicsEngine.js"],"names":[],"mappings":"AAiEA;IAOI;;;;;OAKG;IACH,+BAJW,MAAM,EAoLhB;IA1LD,gCAEC;IAgBG;;;;OAIG;IACH,2BAA+C;IAK/C;;;;;QAOI;;WAEG;;QAEH;;WAEG;;;;;MAMN;IAED;;OAEG;IACH,YAFU,OAAO,CAEe;IAEhC;;;;;;;;;;OAUG;IACH,4BAFU,OAAO,CAEyB;IAE1C;;;OAGG;IACH,QAFU,kBAAkB,CAEU;IAWtC;;;OAGG;IACH,aAAkB;IAGlB;;;OAGG;IACH,cAFU,KAAK,CAEgB;IAK/B;;;OAGG;IACH,QAFU,MAAM,CAEI;IAEpB;;;OAGG;IACH,UAFU,aAAa,CAEH;IAGpB,+BAA0C;IAU1C;;OAEG;IACH,eAA+B;IAI/B;;;OAGG;IACH,uBAFU,kBAAkB,CAEgB;IAE5C;;;OAGG;IACH,oBAFU,iBAAiB,CAEsB;IAEjD;;;OAGG;IACH,gBAFU,iBAAiB,CAES;IAEpC;;;OAGG;IACH,sBAAoC;IAGpC;;;;OAIG;IACH,UAFU,OAAO,CAEG;IAEpB;;;OAGG;IACH,UAFU,OAAO,CAEG;IAEpB;;;OAGG;IACH,YAFU,MAAM,CAEG;IACnB,kKAcI;IAGR;;;OAGG;IACH,sBAFa,eAAe,CAI3B;IAED;;;OAGG;IACH,eAFa,aAAa,CAIzB;IAED;;;;;;;;;;;;;OAaG;IACH,iCAHW,MAAM,OAAO,eACb,4BAA4B,QAkCtC;IAED,mBAqCC;IAED;;;;OAIG;IACH,iCAEC;IAED;;;OAGG;IACH,0BAFa,MAAM,CAIlB;IAED,+BAcC;IAED,cAgEC;IAzBsB,8BAA0C;IA2BjE;;;OAGG;IACH,cAFa,MAAM,CAYlB;IAED;;OAEG;IACH,aAQC;IAED;;OAEG;IACH,yBAQC;IAED;;;;;;OAMG;IACH,yBALW,MAAM,KACN,MAAM,6CAMhB;IAED;;;;OAIG;IACH,8BAHW,OAAO,UAAQ,UACf,OAAO,UAAQ,QAczB;IAED;;;;;OAKG;IACH,8BAQC;IAED,0BAEC;IAED;;;OAGG;IACH,4BAFW,cAAc,QA8BxB;IAED;;OAEG;IACH,qBAqBC;IAED;;OAEG;IACH,0BAeC;IAED;;OAEG;IACH,eA8CC;;CACJ;mBAxpBkB,oCAAoC;oBACnC,4BAA4B;wBACxB,4BAA4B;mCAajB,uCAAuC;sBAlBnE,OAAO;uBAaS,wBAAwB;8BAbxC,OAAO;4BAYc,+BAA+B;mCAKxB,uCAAuC;kCAKxC,gCAAgC;kCADhC,oCAAoC;gCAPtC,uCAAuC;6CAW1B,2CAA2C;+BANzD,4BAA4B"}

package/src/engine/graphics/GraphicsEngine.js

@@ -121,7 +121,11 @@ export class GraphicsEngine {
         this.pixelRatio = new Vector1(1);
 
         /**
-         * Final render-target resolution, in device pixels: `viewport.size × pixelRatio × devicePixelRatio`.
+         * Final render-target resolution, in whole device pixels: `viewport.size × pixelRatio ×
+         * devicePixelRatio`, floored and clamped the same way the attachments themselves are. This is
+         * the authority every full-resolution buffer is sized from -- frame buffers, composit layers,
+         * and anything that has to sample them on their own texel grid. Zero until the viewport has
+         * been sized for the first time.
          * Kept in sync by {@link GraphicsEngine#updateSize}. Subscribe to `output_resolution.onChanged` to
          * react to any change in the actual rendered resolution (viewport resize, supersample, or DPR change).
          * @readonly
@@ -342,8 +346,15 @@ export class GraphicsEngine {
         this.frameBuffers.setSize(_w, _h);
 
         // publish the final device-pixel render resolution; `_w/_h` already fold in the engine pixelRatio,
-        // so this matches the framebuffers/composit layers and what getResolution historically computed
-        this.output_resolution.set(_w * devicePixelRatio, _h * devicePixelRatio);
+        // so this matches the framebuffers/composit layers and what getResolution historically computed.
+        // Floored for the same reason three.js floors the drawing buffer: these are whole texels, and
+        // every buffer sized off this value must land on exactly the same grid. Clamped to 1 to match
+        // those buffers too -- a collapsed viewport still allocates 1x1 attachments, because a 0-sized
+        // one trips GL_INVALID_FRAMEBUFFER_OPERATION on clear/draw
+        this.output_resolution.set(
+            max2(1, Math.floor(_w * devicePixelRatio)),
+            max2(1, Math.floor(_h * devicePixelRatio))
+        );
     }
 
     /**

package/src/engine/graphics/composit/CompositLayer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CompositLayer.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics/composit/CompositLayer.js"],"names":[],"mappings":"AAsCA;IACI;;;;;OAKG;IACH,2DAJW,MAAM,iBAAiB,EAyDjC;IAhDG;;;OAGG;IACH,MAFU,MAAM,CAEF;IAEd;;;OAGG;IACH,YAFU,YAAY,CAEI;IAC1B;;;OAGG;IACH,gCAAgC;IAEhC;;;OAGG;IACH,mBAFU,MAAM,CAE0B;IAE1C,6DAA2E;IAE3E;;;OAGG;IACH,OAFU,MAAM,CAEF;IAEd,cAAyB;IAEzB;;;OAGG;IACH,WAFU,OAAO,CAEI;IAErB;;;OAGG;IACH,SAFU,MAAM,CAEA;IAEhB;;MAEC;IAOL,0BAQC;IAZD,uBAEC;IAYD;;;OAGG;IACH,uBAIC;IAED;;;OAGG;IACH,oBAEC;IAED;;;OAGG;IACH,0BAMC;IAED;;;OAGG;IACH,uBAEC;IAED,eAKC;IAED,gBAKC;IAED;;;;OAIG;IACH,WAHW,MAAM,KACN,MAAM,QAKhB;IAED,+BAaC;IAED;;;OAGG;IACH,4BAFW,MAAM,QAShB;IAED;;;;OAIG;IACH,4CAKC;IAGD,gCAoCC;CACJ;6BA/O4B,oCAAoC;+BAN1D,OAAO;qBAAP,OAAO;oBAGM,+BAA+B;mBADhC,uCAAuC"}
+{"version":3,"file":"CompositLayer.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics/composit/CompositLayer.js"],"names":[],"mappings":"AAsCA;IACI;;;;;OAKG;IACH,2DAJW,MAAM,iBAAiB,EAyDjC;IAhDG;;;OAGG;IACH,MAFU,MAAM,CAEF;IAEd;;;OAGG;IACH,YAFU,YAAY,CAEI;IAC1B;;;OAGG;IACH,gCAAgC;IAEhC;;;OAGG;IACH,mBAFU,MAAM,CAE0B;IAE1C,6DAA2E;IAE3E;;;OAGG;IACH,OAFU,MAAM,CAEF;IAEd,cAAyB;IAEzB;;;OAGG;IACH,WAFU,OAAO,CAEI;IAErB;;;OAGG;IACH,SAFU,MAAM,CAEA;IAEhB;;MAEC;IAOL,0BAQC;IAZD,uBAEC;IAYD;;;OAGG;IACH,uBAIC;IAED;;;OAGG;IACH,oBAEC;IAED;;;OAGG;IACH,0BAMC;IAED;;;OAGG;IACH,uBAEC;IAED,eAKC;IAED,gBAKC;IAED;;;;OAIG;IACH,WAHW,MAAM,KACN,MAAM,QAKhB;IAED,+BAgBC;IAED;;;OAGG;IACH,4BAFW,MAAM,QAShB;IAED;;;;OAIG;IACH,4CAKC;IAGD,gCAoCC;CACJ;6BAlP4B,oCAAoC;+BAN1D,OAAO;qBAAP,OAAO;oBAGM,+BAA+B;mBADhC,uCAAuC"}