@galacean/engine-core 1.3.9 → 1.3.11

package/dist/miniprogram.js

@@ -6612,13 +6612,17 @@ SlicedSpriteAssembler = __decorate([
  */ var DisorderedArray = /*#__PURE__*/ function() {
     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 {
@@ -6626,18 +6630,29 @@ SlicedSpriteAssembler = __decorate([
         }
         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.";
         }
@@ -6650,7 +6665,7 @@ SlicedSpriteAssembler = __decorate([
    */ _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 {
@@ -6664,41 +6679,57 @@ SlicedSpriteAssembler = __decorate([
         }
         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;
                 }
@@ -6706,7 +6737,7 @@ SlicedSpriteAssembler = __decorate([
                     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);
@@ -6715,18 +6746,31 @@ SlicedSpriteAssembler = __decorate([
         }
     };
     _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(DisorderedArray, [
+        {
+            key: "isLopping",
+            get: /**
+   * Get whether the array is in the loop.
+   */ function get() {
+                return this._loopCounter > 0;
+            }
+        }
+    ]);
     return DisorderedArray;
 }();
 
@@ -34465,6 +34509,7 @@ exports.CubeProbe = CubeProbe;
 exports.CurveKey = CurveKey;
 exports.DepthState = DepthState;
 exports.DirectLight = DirectLight;
+exports.DisorderedArray = DisorderedArray;
 exports.DynamicCollider = DynamicCollider;
 exports.EmissionModule = EmissionModule;
 exports.Engine = Engine;

package/dist/module.js

@@ -6607,13 +6607,17 @@ SlicedSpriteAssembler = __decorate([
  */ var DisorderedArray = /*#__PURE__*/ function() {
     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 {
@@ -6621,18 +6625,29 @@ SlicedSpriteAssembler = __decorate([
         }
         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.";
         }
@@ -6645,7 +6660,7 @@ SlicedSpriteAssembler = __decorate([
    */ _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 {
@@ -6659,41 +6674,57 @@ SlicedSpriteAssembler = __decorate([
         }
         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;
                 }
@@ -6701,7 +6732,7 @@ SlicedSpriteAssembler = __decorate([
                     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);
@@ -6710,18 +6741,31 @@ SlicedSpriteAssembler = __decorate([
         }
     };
     _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(DisorderedArray, [
+        {
+            key: "isLopping",
+            get: /**
+   * Get whether the array is in the loop.
+   */ function get() {
+                return this._loopCounter > 0;
+            }
+        }
+    ]);
     return DisorderedArray;
 }();
 
@@ -34415,5 +34459,5 @@ var cacheDir = new Vector3();
     return CubeProbe;
 }(Probe);
 
-export { AmbientLight, AnimationArrayCurve, AnimationBoolCurve, AnimationClip, AnimationClipCurveBinding, AnimationColorCurve, AnimationCurve, AnimationEvent, AnimationFloatArrayCurve, AnimationFloatCurve, AnimationQuaternionCurve, AnimationRectCurve, AnimationRefCurve, AnimationStringCurve, AnimationVector2Curve, AnimationVector3Curve, AnimationVector4Curve, Animator, AnimatorCondition, AnimatorConditionMode, AnimatorController, AnimatorControllerLayer, AnimatorControllerParameter, AnimatorCullingMode, AnimatorLayerBlendingMode, AnimatorLayerMask, AnimatorState, AnimatorStateMachine, AnimatorStateTransition, AssetPromise, AssetType, Background, BackgroundMode, BackgroundTextureFillMode, BaseMaterial, BasicRenderPipeline, BlendFactor, BlendMode, BlendOperation, BlendShape, BlendShapeFrame, BlendState, BlinnPhongMaterial, BloomDownScaleMode, BloomEffect, BoolUpdateFlag, BoxColliderShape, BoxShape, Buffer, BufferBindFlag, BufferMesh, BufferUsage, BufferUtil, Burst, Camera, CameraClearFlags, CameraType, Canvas, CapsuleColliderShape, CharacterController, CircleShape, ClearableObjectPool, CloneManager, Collider, ColliderShape, ColliderShapeUpAxis, CollisionDetectionMode, ColorOverLifetimeModule, ColorSpace, ColorWriteMask, CompareFunction, Component, ConeEmitType, ConeShape, ContentRestorer, ControllerCollisionFlag, ControllerNonWalkableMode, CubeProbe, CullMode, CurveKey, DataType, DependentMode, DepthState, DepthTextureMode, DiffuseMode, DirectLight, Downsampling, DynamicCollider, DynamicColliderConstraints, EmissionModule, Engine, EngineObject, Entity, EventDispatcher, FixedJoint, FogMode, Font, FontStyle, GLCapabilityType, GradientAlphaKey, GradientColorKey, HemisphereShape, HingeJoint, HitResult, IndexBufferBinding, IndexFormat, InputManager, InterpolationType, Joint, JointLimits, JointMotor, Keyframe, Keys, Layer, LayerPathMask, Light, Loader, Logger, MSAASamples, MainModule, Material, Mesh, MeshRenderer, MeshTopology, ModelMesh, OverflowMode, PBRBaseMaterial, PBRMaterial, PBRSpecularMaterial, ParticleCompositeCurve, ParticleCompositeGradient, ParticleCurve, ParticleCurveMode, ParticleGenerator, ParticleGradient, ParticleGradientMode, ParticleMaterial, ParticleRenderMode, ParticleRenderer, ParticleScaleMode, ParticleShapeArcMode, ParticleShapeType, ParticleSimulationSpace, ParticleStopMode, PhysicsMaterial, PhysicsMaterialCombineMode, PhysicsScene, PipelineStage, PlaneColliderShape, Platform, PointLight, Pointer, PointerButton, PointerPhase, Primitive, PrimitiveMesh, Probe, RasterState, ReferResource, RenderBufferDepthFormat, RenderFace, RenderQueue, RenderQueueType, RenderState, RenderStateElementKey as RenderStateDataKey, RenderTarget, RenderTargetBlendState, Renderer, ReplacementFailureStrategy, ResourceManager, ReturnableObjectPool, RotationOverLifetimeModule, SafeLoopArray, Scene, SceneManager, Script, SetDataOptions, Shader, ShaderData, ShaderFactory, ShaderLib, ShaderMacro, ShaderMacroCollection, ShaderPass, ShaderPlatformTarget, ShaderProperty, ShaderPropertyType, ShaderTagKey, ShadowCascadesMode, ShadowResolution, ShadowType, SizeOverLifetimeModule, Skin, SkinnedMeshRenderer, Sky, SkyBoxMaterial, SkyProceduralMaterial, SphereColliderShape, SphereShape, SpotLight, SpringJoint, Sprite, SpriteAtlas, SpriteDrawMode, SpriteMask, SpriteMaskInteraction, SpriteMaskLayer, SpriteRenderer, SpriteTileMode, StateMachineScript, StaticCollider, StencilOperation, StencilState, SubMesh, SubPrimitive, SubShader, SunMode, SystemInfo, TextHorizontalAlignment, TextRenderer, TextUtils, TextVerticalAlignment, Texture, Texture2D, Texture2DArray, TextureCoordinate, TextureCube, TextureCubeFace, TextureDepthCompareFunction, TextureFilterMode, TextureFormat, TextureSheetAnimationModule, TextureUsage, TextureWrapMode, Time, TonemappingEffect, TonemappingMode, TrailMaterial, TrailRenderer, Transform, UnlitMaterial, Utils, VelocityOverLifetimeModule, VertexAttribute, VertexBufferBinding, VertexElement, VertexElementFormat, WrapMode, XRManager, _PostProcessManager, assignmentClone, deepClone, dependentComponents, ignoreClone, request, resourceLoader, shallowClone };
+export { AmbientLight, AnimationArrayCurve, AnimationBoolCurve, AnimationClip, AnimationClipCurveBinding, AnimationColorCurve, AnimationCurve, AnimationEvent, AnimationFloatArrayCurve, AnimationFloatCurve, AnimationQuaternionCurve, AnimationRectCurve, AnimationRefCurve, AnimationStringCurve, AnimationVector2Curve, AnimationVector3Curve, AnimationVector4Curve, Animator, AnimatorCondition, AnimatorConditionMode, AnimatorController, AnimatorControllerLayer, AnimatorControllerParameter, AnimatorCullingMode, AnimatorLayerBlendingMode, AnimatorLayerMask, AnimatorState, AnimatorStateMachine, AnimatorStateTransition, AssetPromise, AssetType, Background, BackgroundMode, BackgroundTextureFillMode, BaseMaterial, BasicRenderPipeline, BlendFactor, BlendMode, BlendOperation, BlendShape, BlendShapeFrame, BlendState, BlinnPhongMaterial, BloomDownScaleMode, BloomEffect, BoolUpdateFlag, BoxColliderShape, BoxShape, Buffer, BufferBindFlag, BufferMesh, BufferUsage, BufferUtil, Burst, Camera, CameraClearFlags, CameraType, Canvas, CapsuleColliderShape, CharacterController, CircleShape, ClearableObjectPool, CloneManager, Collider, ColliderShape, ColliderShapeUpAxis, CollisionDetectionMode, ColorOverLifetimeModule, ColorSpace, ColorWriteMask, CompareFunction, Component, ConeEmitType, ConeShape, ContentRestorer, ControllerCollisionFlag, ControllerNonWalkableMode, CubeProbe, CullMode, CurveKey, DataType, DependentMode, DepthState, DepthTextureMode, DiffuseMode, DirectLight, DisorderedArray, Downsampling, DynamicCollider, DynamicColliderConstraints, EmissionModule, Engine, EngineObject, Entity, EventDispatcher, FixedJoint, FogMode, Font, FontStyle, GLCapabilityType, GradientAlphaKey, GradientColorKey, HemisphereShape, HingeJoint, HitResult, IndexBufferBinding, IndexFormat, InputManager, InterpolationType, Joint, JointLimits, JointMotor, Keyframe, Keys, Layer, LayerPathMask, Light, Loader, Logger, MSAASamples, MainModule, Material, Mesh, MeshRenderer, MeshTopology, ModelMesh, OverflowMode, PBRBaseMaterial, PBRMaterial, PBRSpecularMaterial, ParticleCompositeCurve, ParticleCompositeGradient, ParticleCurve, ParticleCurveMode, ParticleGenerator, ParticleGradient, ParticleGradientMode, ParticleMaterial, ParticleRenderMode, ParticleRenderer, ParticleScaleMode, ParticleShapeArcMode, ParticleShapeType, ParticleSimulationSpace, ParticleStopMode, PhysicsMaterial, PhysicsMaterialCombineMode, PhysicsScene, PipelineStage, PlaneColliderShape, Platform, PointLight, Pointer, PointerButton, PointerPhase, Primitive, PrimitiveMesh, Probe, RasterState, ReferResource, RenderBufferDepthFormat, RenderFace, RenderQueue, RenderQueueType, RenderState, RenderStateElementKey as RenderStateDataKey, RenderTarget, RenderTargetBlendState, Renderer, ReplacementFailureStrategy, ResourceManager, ReturnableObjectPool, RotationOverLifetimeModule, SafeLoopArray, Scene, SceneManager, Script, SetDataOptions, Shader, ShaderData, ShaderFactory, ShaderLib, ShaderMacro, ShaderMacroCollection, ShaderPass, ShaderPlatformTarget, ShaderProperty, ShaderPropertyType, ShaderTagKey, ShadowCascadesMode, ShadowResolution, ShadowType, SizeOverLifetimeModule, Skin, SkinnedMeshRenderer, Sky, SkyBoxMaterial, SkyProceduralMaterial, SphereColliderShape, SphereShape, SpotLight, SpringJoint, Sprite, SpriteAtlas, SpriteDrawMode, SpriteMask, SpriteMaskInteraction, SpriteMaskLayer, SpriteRenderer, SpriteTileMode, StateMachineScript, StaticCollider, StencilOperation, StencilState, SubMesh, SubPrimitive, SubShader, SunMode, SystemInfo, TextHorizontalAlignment, TextRenderer, TextUtils, TextVerticalAlignment, Texture, Texture2D, Texture2DArray, TextureCoordinate, TextureCube, TextureCubeFace, TextureDepthCompareFunction, TextureFilterMode, TextureFormat, TextureSheetAnimationModule, TextureUsage, TextureWrapMode, Time, TonemappingEffect, TonemappingMode, TrailMaterial, TrailRenderer, Transform, UnlitMaterial, Utils, VelocityOverLifetimeModule, VertexAttribute, VertexBufferBinding, VertexElement, VertexElementFormat, WrapMode, XRManager, _PostProcessManager, assignmentClone, deepClone, dependentComponents, ignoreClone, request, resourceLoader, shallowClone };
 //# sourceMappingURL=module.js.map