@galacean/engine 1.3.10 → 1.3.11

package/dist/browser.js

@@ -11453,13 +11453,17 @@
      */ var DisorderedArray = /*#__PURE__*/ function() {
         var DisorderedArray = function DisorderedArray(count) {
             if (count === void 0) count = 0;
-            this.length = 0;
-            this._isLooping = false;
+            /** The length of the array. */ this.length = 0;
+            this._loopCounter = 0 // Ignore nested loops, use counter to solve the problem
+            ;
             this._blankCount = 0;
             this._elements = new Array(count);
         };
         var _proto = DisorderedArray.prototype;
-        _proto.add = function add(element) {
+        /**
+       * Add an element to disordered array.
+       * @param element - The element to be added
+       */ _proto.add = function add(element) {
             if (this.length === this._elements.length) {
                 this._elements.push(element);
             } else {
@@ -11467,18 +11471,29 @@
             }
             this.length++;
         };
-        _proto.delete = function _delete(element) {
+        /**
+       * Delete the specified element.
+       * @param element - The element to be deleted
+       */ _proto.delete = function _delete(element) {
             // @todo: It can be optimized for custom binary search and other algorithms, currently this._elements>=this.length wastes performance.
             var index = this._elements.indexOf(element);
             this.deleteByIndex(index);
         };
-        _proto.set = function set(index, element) {
+        /**
+       * Set the element at the specified index.
+       * @param index - The index of the element to be set
+       * @param element - The element to be set
+       */ _proto.set = function set(index, element) {
             if (index >= this.length) {
                 throw "Index is out of range.";
             }
             this._elements[index] = element;
         };
-        _proto.get = function get(index) {
+        /**
+       * Get the element at the specified index.
+       * @param index - The index of the element to be get
+       * @returns The element at the specified index
+       */ _proto.get = function get(index) {
             if (index >= this.length) {
                 throw "Index is out of range.";
             }
@@ -11491,7 +11506,7 @@
        */ _proto.deleteByIndex = function deleteByIndex(index) {
             var elements = this._elements;
             var end;
-            if (this._isLooping) {
+            if (this._loopCounter > 0) {
                 this._elements[index] = null;
                 this._blankCount++;
             } else {
@@ -11505,41 +11520,57 @@
             }
             return end;
         };
-        _proto.forEach = function forEach(callbackFn, swapFn) {
+        /**
+       * Loop through all elements.
+       * @param callbackFn - The callback function
+       * @param swapFn - The swap function can process the element after the callback function, it will be called after end looping(`isLopping` = true)
+       */ _proto.forEach = function forEach(callbackFn, swapFn) {
             this._startLoop();
             var elements = this._elements;
             for(var i = 0, n = this.length; i < n; i++){
                 var element = elements[i];
-                element && callbackFn(element);
+                element && callbackFn(element, i);
             }
             this._endLoop(swapFn);
         };
-        _proto.forEachAndClean = function forEachAndClean(callbackFn, swapFn) {
+        /**
+       * Loop through all elements and clean up the blank elements.
+       * @param callbackFn - The callback function
+       * @param swapFn - The swap function can process the element after the callback function,  it will be called after end looping(`isLopping` = true)
+       */ _proto.forEachAndClean = function forEachAndClean(callbackFn, swapFn) {
             this._startLoop();
             var preEnd = this.length;
             var elements = this._elements;
             for(var i = 0, n = preEnd; i < n; i++){
                 var element = elements[i];
-                element && callbackFn(element);
+                element && callbackFn(element, i);
             }
             this._endLoopAndClean(preEnd, elements, swapFn);
         };
-        _proto.sort = function sort(compareFn) {
+        /**
+       * Sort the array.
+       * @param compareFn - The comparison function
+       */ _proto.sort = function sort(compareFn) {
             Utils._quickSort(this._elements, 0, this.length, compareFn);
         };
-        _proto.garbageCollection = function garbageCollection() {
+        /**
+       * Garbage collection, clean up all cached elements.
+       */ _proto.garbageCollection = function garbageCollection() {
             this._elements.length = this.length;
         };
         _proto._startLoop = function _startLoop() {
-            this._isLooping = true;
+            ++this._loopCounter;
         };
         _proto._endLoop = function _endLoop(swapFn) {
-            this._isLooping = false;
+            if (--this._loopCounter !== 0) {
+                return;
+            }
             if (this._blankCount) {
                 var from = 0;
                 var to = this.length - 1;
                 var elements = this._elements;
                 partition: do {
+                    var _swapFn;
                     while(elements[from])if (++from >= to) {
                         break partition;
                     }
@@ -11547,7 +11578,7 @@
                         break partition;
                     }
                     var swapElement = elements[to];
-                    swapFn(swapElement, from);
+                    (_swapFn = swapFn) == null ? void 0 : _swapFn(swapElement, from);
                     elements[from++] = swapElement;
                     elements[to--] = null;
                 }while (from < to);
@@ -11556,18 +11587,31 @@
             }
         };
         _proto._endLoopAndClean = function _endLoopAndClean(preEnd, elements, swapFn) {
+            if (--this._loopCounter !== 0) {
+                return;
+            }
             var index = 0;
             for(var i = preEnd, n = this.length; i < n; i++){
+                var _swapFn;
                 var element = elements[i];
                 if (!element) continue;
                 elements[index] = element;
-                swapFn(element, index);
+                (_swapFn = swapFn) == null ? void 0 : _swapFn(element, index);
                 index++;
             }
-            this._isLooping = false;
             this.length = index;
             this._blankCount = 0;
         };
+        _create_class$2(DisorderedArray, [
+            {
+                key: "isLopping",
+                get: /**
+       * Get whether the array is in the loop.
+       */ function get() {
+                    return this._loopCounter > 0;
+                }
+            }
+        ]);
         return DisorderedArray;
     }();
     var _TiledSpriteAssembler;
@@ -39035,6 +39079,7 @@
         get DepthTextureMode () { return exports.DepthTextureMode; },
         get DiffuseMode () { return exports.DiffuseMode; },
         DirectLight: DirectLight,
+        DisorderedArray: DisorderedArray,
         get Downsampling () { return exports.Downsampling; },
         DynamicCollider: DynamicCollider,
         get DynamicColliderConstraints () { return exports.DynamicColliderConstraints; },
@@ -48101,7 +48146,7 @@
     ], EXT_texture_webp);
 
     //@ts-ignore
-    var version = "1.3.10";
+    var version = "1.3.11";
     console.log("Galacean engine version: " + version);
     for(var key in CoreObjects){
         Loader.registerClass(key, CoreObjects[key]);
@@ -48159,6 +48204,7 @@
     exports.CurveKey = CurveKey;
     exports.DepthState = DepthState;
     exports.DirectLight = DirectLight;
+    exports.DisorderedArray = DisorderedArray;
     exports.DynamicCollider = DynamicCollider;
     exports.EmissionModule = EmissionModule;
     exports.Engine = Engine;