@galacean/engine 1.2.0-alpha.3 → 1.2.0-alpha.5

package/dist/browser.js

@@ -8181,7 +8181,7 @@
         pbr_frag: pbr_frag
     };
     var ShadowCoord = "#define GLSLIFY 1\nuniform mat4 scene_ShadowMatrices[SCENE_SHADOW_CASCADED_COUNT+1];uniform vec4 scene_ShadowSplitSpheres[4];mediump int computeCascadeIndex(vec3 positionWS){vec3 fromCenter0=positionWS-scene_ShadowSplitSpheres[0].xyz;vec3 fromCenter1=positionWS-scene_ShadowSplitSpheres[1].xyz;vec3 fromCenter2=positionWS-scene_ShadowSplitSpheres[2].xyz;vec3 fromCenter3=positionWS-scene_ShadowSplitSpheres[3].xyz;mediump vec4 comparison=vec4(dot(fromCenter0,fromCenter0)<scene_ShadowSplitSpheres[0].w,dot(fromCenter1,fromCenter1)<scene_ShadowSplitSpheres[1].w,dot(fromCenter2,fromCenter2)<scene_ShadowSplitSpheres[2].w,dot(fromCenter3,fromCenter3)<scene_ShadowSplitSpheres[3].w);comparison.yzw=clamp(comparison.yzw-comparison.xyz,0.0,1.0);mediump vec4 indexCoefficient=vec4(4.0,3.0,2.0,1.0);mediump int index=4-int(dot(comparison,indexCoefficient));return index;}vec3 getShadowCoord(){\n#if SCENE_SHADOW_CASCADED_COUNT == 1\nmediump int cascadeIndex=0;\n#else\nmediump int cascadeIndex=computeCascadeIndex(v_pos);\n#endif\n#ifdef GRAPHICS_API_WEBGL2\nmat4 shadowMatrix=scene_ShadowMatrices[cascadeIndex];\n#else\nmat4 shadowMatrix;\n#if SCENE_SHADOW_CASCADED_COUNT == 4\nif(cascadeIndex==0){shadowMatrix=scene_ShadowMatrices[0];}else if(cascadeIndex==1){shadowMatrix=scene_ShadowMatrices[1];}else if(cascadeIndex==2){shadowMatrix=scene_ShadowMatrices[2];}else if(cascadeIndex==3){shadowMatrix=scene_ShadowMatrices[3];}else{shadowMatrix=scene_ShadowMatrices[4];}\n#endif\n#if SCENE_SHADOW_CASCADED_COUNT == 2\nif(cascadeIndex==0){shadowMatrix=scene_ShadowMatrices[0];}else if(cascadeIndex==1){shadowMatrix=scene_ShadowMatrices[1];}else{shadowMatrix=scene_ShadowMatrices[2];}\n#endif\n#if SCENE_SHADOW_CASCADED_COUNT == 1\nif(cascadeIndex==0){shadowMatrix=scene_ShadowMatrices[0];}else{shadowMatrix=scene_ShadowMatrices[1];}\n#endif\n#endif\nvec4 shadowCoord=shadowMatrix*vec4(v_pos,1.0);return shadowCoord.xyz;}"; // eslint-disable-line
-    var ShadowFragmentDeclaration = "#define GLSLIFY 1\n#if defined(SCENE_SHADOW_TYPE) && defined(RENDERER_IS_RECEIVE_SHADOWS)\n#define SCENE_IS_CALCULATE_SHADOWS\n#endif\n#ifdef SCENE_IS_CALCULATE_SHADOWS\n#if SCENE_SHADOW_CASCADED_COUNT == 1\nvarying vec3 v_shadowCoord;\n#else\n#include <ShadowCoord>\n#endif\nuniform vec3 scene_ShadowInfo;uniform vec4 scene_ShadowMapSize;\n#ifdef GRAPHICS_API_WEBGL2\nuniform mediump sampler2DShadow scene_ShadowMap;\n#define SAMPLE_TEXTURE2D_SHADOW(textureName, coord3) textureLod(textureName, coord3 , 0.0)\n#define TEXTURE2D_SHADOW_PARAM(shadowMap) mediump sampler2DShadow shadowMap\n#else\nuniform sampler2D scene_ShadowMap;\n#ifdef ENGINE_NO_DEPTH_TEXTURE\nconst vec4 bitShift=vec4(1.0,1.0/256.0,1.0/(256.0*256.0),1.0/(256.0*256.0*256.0));float unpack(const in vec4 rgbaDepth){return dot(rgbaDepth,bitShift);}\n#define SAMPLE_TEXTURE2D_SHADOW(textureName, coord3) (unpack(texture2D(textureName, coord3.xy)) < coord3.z ? 0.0 : 1.0)\n#else\n#define SAMPLE_TEXTURE2D_SHADOW(textureName, coord3) (texture2D(textureName, coord3.xy).r < coord3.z ? 0.0 : 1.0)\n#endif\n#define TEXTURE2D_SHADOW_PARAM(shadowMap) mediump sampler2D shadowMap\n#endif\n#if SCENE_SHADOW_TYPE == 2\nfloat sampleShadowMapFiltered4(TEXTURE2D_SHADOW_PARAM(shadowMap),vec3 shadowCoord,vec4 shadowMapSize){float attenuation;vec4 attenuation4;vec2 offset=shadowMapSize.xy/2.0;vec3 shadowCoord0=shadowCoord+vec3(-offset,0.0);vec3 shadowCoord1=shadowCoord+vec3(offset.x,-offset.y,0.0);vec3 shadowCoord2=shadowCoord+vec3(-offset.x,offset.y,0.0);vec3 shadowCoord3=shadowCoord+vec3(offset,0.0);attenuation4.x=SAMPLE_TEXTURE2D_SHADOW(shadowMap,shadowCoord0);attenuation4.y=SAMPLE_TEXTURE2D_SHADOW(shadowMap,shadowCoord1);attenuation4.z=SAMPLE_TEXTURE2D_SHADOW(shadowMap,shadowCoord2);attenuation4.w=SAMPLE_TEXTURE2D_SHADOW(shadowMap,shadowCoord3);attenuation=dot(attenuation4,vec4(0.25));return attenuation;}\n#endif\n#if SCENE_SHADOW_TYPE == 3\n#include <shadow_sample_tent>\nfloat sampleShadowMapFiltered9(TEXTURE2D_SHADOW_PARAM(shadowMap),vec3 shadowCoord,vec4 shadowmapSize){float attenuation;float fetchesWeights[9];vec2 fetchesUV[9];sampleShadowComputeSamplesTent5x5(shadowmapSize,shadowCoord.xy,fetchesWeights,fetchesUV);attenuation=fetchesWeights[0]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[0].xy,shadowCoord.z));attenuation+=fetchesWeights[1]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[1].xy,shadowCoord.z));attenuation+=fetchesWeights[2]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[2].xy,shadowCoord.z));attenuation+=fetchesWeights[3]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[3].xy,shadowCoord.z));attenuation+=fetchesWeights[4]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[4].xy,shadowCoord.z));attenuation+=fetchesWeights[5]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[5].xy,shadowCoord.z));attenuation+=fetchesWeights[6]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[6].xy,shadowCoord.z));attenuation+=fetchesWeights[7]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[7].xy,shadowCoord.z));attenuation+=fetchesWeights[8]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[8].xy,shadowCoord.z));return attenuation;}\n#endif\nfloat sampleShadowMap(){\n#if SCENE_SHADOW_CASCADED_COUNT == 1\nvec3 shadowCoord=v_shadowCoord;\n#else\nvec3 shadowCoord=getShadowCoord();\n#endif\nfloat attenuation=1.0;if(shadowCoord.z>0.0&&shadowCoord.z<1.0){\n#if SCENE_SHADOW_TYPE == 1\nattenuation=SAMPLE_TEXTURE2D_SHADOW(scene_ShadowMap,shadowCoord);\n#endif\n#if SCENE_SHADOW_TYPE == 2\nattenuation=sampleShadowMapFiltered4(scene_ShadowMap,shadowCoord,scene_ShadowMapSize);\n#endif\n#if SCENE_SHADOW_TYPE == 3\nattenuation=sampleShadowMapFiltered9(scene_ShadowMap,shadowCoord,scene_ShadowMapSize);\n#endif\nattenuation=mix(1.0,attenuation,scene_ShadowInfo.x);}return attenuation;}\n#endif\n"; // eslint-disable-line
+    var ShadowFragmentDeclaration = "#define GLSLIFY 1\n#if defined(SCENE_SHADOW_TYPE) && defined(RENDERER_IS_RECEIVE_SHADOWS)\n#define SCENE_IS_CALCULATE_SHADOWS\n#endif\n#ifdef SCENE_IS_CALCULATE_SHADOWS\n#if SCENE_SHADOW_CASCADED_COUNT == 1\nvarying vec3 v_shadowCoord;\n#else\n#include <ShadowCoord>\n#endif\nuniform vec4 scene_ShadowInfo;uniform vec4 scene_ShadowMapSize;\n#ifdef GRAPHICS_API_WEBGL2\nuniform mediump sampler2DShadow scene_ShadowMap;\n#define SAMPLE_TEXTURE2D_SHADOW(textureName, coord3) textureLod(textureName, coord3 , 0.0)\n#define TEXTURE2D_SHADOW_PARAM(shadowMap) mediump sampler2DShadow shadowMap\n#else\nuniform sampler2D scene_ShadowMap;\n#ifdef ENGINE_NO_DEPTH_TEXTURE\nconst vec4 bitShift=vec4(1.0,1.0/256.0,1.0/(256.0*256.0),1.0/(256.0*256.0*256.0));float unpack(const in vec4 rgbaDepth){return dot(rgbaDepth,bitShift);}\n#define SAMPLE_TEXTURE2D_SHADOW(textureName, coord3) (unpack(texture2D(textureName, coord3.xy)) < coord3.z ? 0.0 : 1.0)\n#else\n#define SAMPLE_TEXTURE2D_SHADOW(textureName, coord3) (texture2D(textureName, coord3.xy).r < coord3.z ? 0.0 : 1.0)\n#endif\n#define TEXTURE2D_SHADOW_PARAM(shadowMap) mediump sampler2D shadowMap\n#endif\n#if SCENE_SHADOW_TYPE == 2\nfloat sampleShadowMapFiltered4(TEXTURE2D_SHADOW_PARAM(shadowMap),vec3 shadowCoord,vec4 shadowMapSize){float attenuation;vec4 attenuation4;vec2 offset=shadowMapSize.xy/2.0;vec3 shadowCoord0=shadowCoord+vec3(-offset,0.0);vec3 shadowCoord1=shadowCoord+vec3(offset.x,-offset.y,0.0);vec3 shadowCoord2=shadowCoord+vec3(-offset.x,offset.y,0.0);vec3 shadowCoord3=shadowCoord+vec3(offset,0.0);attenuation4.x=SAMPLE_TEXTURE2D_SHADOW(shadowMap,shadowCoord0);attenuation4.y=SAMPLE_TEXTURE2D_SHADOW(shadowMap,shadowCoord1);attenuation4.z=SAMPLE_TEXTURE2D_SHADOW(shadowMap,shadowCoord2);attenuation4.w=SAMPLE_TEXTURE2D_SHADOW(shadowMap,shadowCoord3);attenuation=dot(attenuation4,vec4(0.25));return attenuation;}\n#endif\n#if SCENE_SHADOW_TYPE == 3\n#include <shadow_sample_tent>\nfloat sampleShadowMapFiltered9(TEXTURE2D_SHADOW_PARAM(shadowMap),vec3 shadowCoord,vec4 shadowmapSize){float attenuation;float fetchesWeights[9];vec2 fetchesUV[9];sampleShadowComputeSamplesTent5x5(shadowmapSize,shadowCoord.xy,fetchesWeights,fetchesUV);attenuation=fetchesWeights[0]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[0].xy,shadowCoord.z));attenuation+=fetchesWeights[1]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[1].xy,shadowCoord.z));attenuation+=fetchesWeights[2]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[2].xy,shadowCoord.z));attenuation+=fetchesWeights[3]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[3].xy,shadowCoord.z));attenuation+=fetchesWeights[4]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[4].xy,shadowCoord.z));attenuation+=fetchesWeights[5]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[5].xy,shadowCoord.z));attenuation+=fetchesWeights[6]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[6].xy,shadowCoord.z));attenuation+=fetchesWeights[7]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[7].xy,shadowCoord.z));attenuation+=fetchesWeights[8]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[8].xy,shadowCoord.z));return attenuation;}\n#endif\nfloat getShadowFade(vec3 positionWS){vec3 camToPixel=positionWS-camera_Position;float distanceCamToPixel2=dot(camToPixel,camToPixel);return saturate(distanceCamToPixel2*scene_ShadowInfo.z+scene_ShadowInfo.w);}float sampleShadowMap(){\n#if SCENE_SHADOW_CASCADED_COUNT == 1\nvec3 shadowCoord=v_shadowCoord;\n#else\nvec3 shadowCoord=getShadowCoord();\n#endif\nfloat attenuation=1.0;if(shadowCoord.z>0.0&&shadowCoord.z<1.0){\n#if SCENE_SHADOW_TYPE == 1\nattenuation=SAMPLE_TEXTURE2D_SHADOW(scene_ShadowMap,shadowCoord);\n#endif\n#if SCENE_SHADOW_TYPE == 2\nattenuation=sampleShadowMapFiltered4(scene_ShadowMap,shadowCoord,scene_ShadowMapSize);\n#endif\n#if SCENE_SHADOW_TYPE == 3\nattenuation=sampleShadowMapFiltered9(scene_ShadowMap,shadowCoord,scene_ShadowMapSize);\n#endif\nfloat shadowFade=getShadowFade(v_pos);attenuation=mix(1.0,mix(attenuation,1.0,shadowFade),scene_ShadowInfo.x);}return attenuation;}\n#endif\n"; // eslint-disable-line
     var shadow_sample_tent = "#define GLSLIFY 1\nfloat sampleShadowGetIRTriangleTexelArea(float triangleHeight){return triangleHeight-0.5;}void sampleShadowGetTexelAreasTent3x3(float offset,out vec4 computedArea,out vec4 computedAreaUncut){float a=offset+0.5;float offsetSquaredHalved=a*a*0.5;computedAreaUncut.x=computedArea.x=offsetSquaredHalved-offset;computedAreaUncut.w=computedArea.w=offsetSquaredHalved;computedAreaUncut.y=sampleShadowGetIRTriangleTexelArea(1.5-offset);float clampedOffsetLeft=min(offset,0.0);float areaOfSmallLeftTriangle=clampedOffsetLeft*clampedOffsetLeft;computedArea.y=computedAreaUncut.y-areaOfSmallLeftTriangle;computedAreaUncut.z=sampleShadowGetIRTriangleTexelArea(1.5+offset);float clampedOffsetRight=max(offset,0.0);float areaOfSmallRightTriangle=clampedOffsetRight*clampedOffsetRight;computedArea.z=computedAreaUncut.z-areaOfSmallRightTriangle;}void sampleShadowGetTexelWeightsTent5x5(float offset,out vec3 texelsWeightsA,out vec3 texelsWeightsB){vec4 areaFrom3texelTriangle;vec4 areaUncutFrom3texelTriangle;sampleShadowGetTexelAreasTent3x3(offset,areaFrom3texelTriangle,areaUncutFrom3texelTriangle);texelsWeightsA.x=0.16*(areaFrom3texelTriangle.x);texelsWeightsA.y=0.16*(areaUncutFrom3texelTriangle.y);texelsWeightsA.z=0.16*(areaFrom3texelTriangle.y+1.0);texelsWeightsB.x=0.16*(areaFrom3texelTriangle.z+1.0);texelsWeightsB.y=0.16*(areaUncutFrom3texelTriangle.z);texelsWeightsB.z=0.16*(areaFrom3texelTriangle.w);}void sampleShadowComputeSamplesTent5x5(vec4 shadowMapTextureTexelSize,vec2 coord,out float fetchesWeights[9],out vec2 fetchesUV[9]){vec2 tentCenterInTexelSpace=coord.xy*shadowMapTextureTexelSize.zw;vec2 centerOfFetchesInTexelSpace=floor(tentCenterInTexelSpace+0.5);vec2 offsetFromTentCenterToCenterOfFetches=tentCenterInTexelSpace-centerOfFetchesInTexelSpace;vec3 texelsWeightsUA,texelsWeightsUB;vec3 texelsWeightsVA,texelsWeightsVB;sampleShadowGetTexelWeightsTent5x5(offsetFromTentCenterToCenterOfFetches.x,texelsWeightsUA,texelsWeightsUB);sampleShadowGetTexelWeightsTent5x5(offsetFromTentCenterToCenterOfFetches.y,texelsWeightsVA,texelsWeightsVB);vec3 fetchesWeightsU=vec3(texelsWeightsUA.xz,texelsWeightsUB.y)+vec3(texelsWeightsUA.y,texelsWeightsUB.xz);vec3 fetchesWeightsV=vec3(texelsWeightsVA.xz,texelsWeightsVB.y)+vec3(texelsWeightsVA.y,texelsWeightsVB.xz);vec3 fetchesOffsetsU=vec3(texelsWeightsUA.y,texelsWeightsUB.xz)/fetchesWeightsU.xyz+vec3(-2.5,-0.5,1.5);vec3 fetchesOffsetsV=vec3(texelsWeightsVA.y,texelsWeightsVB.xz)/fetchesWeightsV.xyz+vec3(-2.5,-0.5,1.5);fetchesOffsetsU*=shadowMapTextureTexelSize.xxx;fetchesOffsetsV*=shadowMapTextureTexelSize.yyy;vec2 bilinearFetchOrigin=centerOfFetchesInTexelSpace*shadowMapTextureTexelSize.xy;fetchesUV[0]=bilinearFetchOrigin+vec2(fetchesOffsetsU.x,fetchesOffsetsV.x);fetchesUV[1]=bilinearFetchOrigin+vec2(fetchesOffsetsU.y,fetchesOffsetsV.x);fetchesUV[2]=bilinearFetchOrigin+vec2(fetchesOffsetsU.z,fetchesOffsetsV.x);fetchesUV[3]=bilinearFetchOrigin+vec2(fetchesOffsetsU.x,fetchesOffsetsV.y);fetchesUV[4]=bilinearFetchOrigin+vec2(fetchesOffsetsU.y,fetchesOffsetsV.y);fetchesUV[5]=bilinearFetchOrigin+vec2(fetchesOffsetsU.z,fetchesOffsetsV.y);fetchesUV[6]=bilinearFetchOrigin+vec2(fetchesOffsetsU.x,fetchesOffsetsV.z);fetchesUV[7]=bilinearFetchOrigin+vec2(fetchesOffsetsU.y,fetchesOffsetsV.z);fetchesUV[8]=bilinearFetchOrigin+vec2(fetchesOffsetsU.z,fetchesOffsetsV.z);fetchesWeights[0]=fetchesWeightsU.x*fetchesWeightsV.x;fetchesWeights[1]=fetchesWeightsU.y*fetchesWeightsV.x;fetchesWeights[2]=fetchesWeightsU.z*fetchesWeightsV.x;fetchesWeights[3]=fetchesWeightsU.x*fetchesWeightsV.y;fetchesWeights[4]=fetchesWeightsU.y*fetchesWeightsV.y;fetchesWeights[5]=fetchesWeightsU.z*fetchesWeightsV.y;fetchesWeights[6]=fetchesWeightsU.x*fetchesWeightsV.z;fetchesWeights[7]=fetchesWeightsU.y*fetchesWeightsV.z;fetchesWeights[8]=fetchesWeightsU.z*fetchesWeightsV.z;}"; // eslint-disable-line
     var ShadowVertexDeclaration = "#define GLSLIFY 1\n#if defined(SCENE_SHADOW_TYPE) && defined(RENDERER_IS_RECEIVE_SHADOWS)\n#define SCENE_IS_CALCULATE_SHADOWS\n#endif\n#ifdef SCENE_IS_CALCULATE_SHADOWS\n#if SCENE_SHADOW_CASCADED_COUNT==1\n#include <ShadowCoord>\nvarying vec3 v_shadowCoord;\n#endif\n#endif\n"; // eslint-disable-line
     var ShadowVertex = "#define GLSLIFY 1\n#ifdef SCENE_IS_CALCULATE_SHADOWS\n#if SCENE_SHADOW_CASCADED_COUNT == 1\nv_shadowCoord=getShadowCoord();\n#endif\n#endif\n"; // eslint-disable-line
@@ -8288,7 +8288,7 @@
                     Logger.error('Shader slice "' + match.trim() + '" not founded.');
                     return "";
                 }
-                return ShaderFactory.parseIncludes(replace);
+                return ShaderFactory.parseIncludes(replace, regex);
             };
             return src.replace(regex, replace);
         };
@@ -25650,6 +25650,10 @@
             /** The splits of two cascade distribution. */ _this.shadowTwoCascadeSplits = 1.0 / 3.0;
             /** The splits of four cascade distribution. */ _this.shadowFourCascadeSplits = new Vector3(1.0 / 15, 3.0 / 15.0, 7.0 / 15.0);
             /** Max Shadow distance. */ _this.shadowDistance = 50;
+            /**
+       * Last shadow fade distance in percentage, range [0,1].
+       * @remarks Value 0 is used for no shadow fade.
+       */ _this.shadowFadeBorder = 0.1;
             /* @internal */ _this._lightManager = new LightManager();
             /* @internal */ _this._componentsManager = new ComponentsManager();
             /** @internal */ _this._isActiveInEngine = false;
@@ -26271,47 +26275,65 @@
         DepthTextureMode[DepthTextureMode[/* No depth texture. */ "None"] = 0] = "None";
         DepthTextureMode[DepthTextureMode[/* Generate depth texture by pre-pass rendering. */ "PrePass"] = 1] = "PrePass";
     })(exports.DepthTextureMode || (exports.DepthTextureMode = {}));
-    var passNum = 0;
     /**
-     * RenderPass.
-     */ var RenderPass = /*#__PURE__*/ function() {
-        var RenderPass = function RenderPass(name1, priority, renderTarget, replaceMaterial, mask) {
-            if (name1 === void 0) name1 = "RENDER_PASS" + passNum++;
-            if (priority === void 0) priority = 0;
-            if (renderTarget === void 0) renderTarget = null;
-            if (replaceMaterial === void 0) replaceMaterial = null;
-            if (mask === void 0) mask = null;
-            this.name = name1;
-            this.enabled = true;
-            this.priority = priority;
-            this.renderTarget = renderTarget;
-            this.replaceMaterial = replaceMaterial;
-            this.mask = mask || exports.Layer.Everything;
-            this.renderOverride = false; // If renderOverride is set to true, you need to implement the render method
-        };
-        var _proto = RenderPass.prototype;
-        /**
-       * Rendering callback, will be executed if renderOverride is set to true.
-       * @param camera - Camera
-       * @param opaqueQueue - Opaque queue
-       * @param alphaTestQueue - Alpha test queue
-       * @param transparentQueue - Transparent queue
-       */ _proto.render = function render(camera, opaqueQueue, alphaTestQueue, transparentQueue) {};
+     * PipelinePass is a base class for all pipeline passes.
+     */ var PipelinePass = function PipelinePass(engine) {
+        this._engine = engine;
+    };
+    /**
+     * @internal
+     */ var PipelineUtils = /*#__PURE__*/ function() {
+        var PipelineUtils = function PipelineUtils() {};
         /**
-       * Post rendering callback.
-       * @param camera - Camera
-       * @param opaqueQueue - Opaque queue
-       * @param alphaTestQueue - Alpha test queue
-       * @param transparentQueue - Transparent queue
-       */ _proto.preRender = function preRender(camera, opaqueQueue, alphaTestQueue, transparentQueue) {};
+       * Recreate texture if needed.
+       * @param engine - Engine
+       * @param currentTexture - Current texture
+       * @param width - Need texture width
+       * @param height - Need texture height
+       * @param format - Need texture format
+       * @param mipmap - Need texture mipmap
+       * @returns Texture
+       */ PipelineUtils.recreateTextureIfNeeded = function recreateTextureIfNeeded(engine, currentTexture, width, height, format, mipmap) {
+            if (currentTexture) {
+                if (currentTexture.width !== width || currentTexture.height !== height || currentTexture.format !== format || currentTexture.mipmapCount > 1 !== mipmap) {
+                    currentTexture.destroy();
+                    var texture = new Texture2D(engine, width, height, format, mipmap);
+                    texture.isGCIgnored = true;
+                    return texture;
+                } else {
+                    return currentTexture;
+                }
+            } else {
+                var texture1 = new Texture2D(engine, width, height, format, mipmap);
+                texture1.isGCIgnored = true;
+                return texture1;
+            }
+        };
         /**
-       * Post rendering callback.
-       * @param camera - Camera
-       * @param opaqueQueue - Opaque queue
-       * @param alphaTestQueue - Alpha test queue
-       * @param transparentQueue - Transparent queue
-       */ _proto.postRender = function postRender(camera, opaqueQueue, alphaTestQueue, transparentQueue) {};
-        return RenderPass;
+       * Recreate render target if needed.
+       * @param engine - Engine
+       * @param currentRenderTarget - Current render target
+       * @param width - Need render target width
+       * @param height - Need render target height
+       * @param colorFormat - Need render target color format
+       * @param depthFormat - Need render target depth format
+       * @param mipmap - Need render target mipmap
+       * @returns Render target
+       */ PipelineUtils.recreateRenderTargetIfNeeded = function recreateRenderTargetIfNeeded(engine, currentRenderTarget, width, height, colorFormat, depthFormat, mipmap) {
+            var _currentRenderTarget, _currentRenderTarget1;
+            var currentColorTexture = (_currentRenderTarget = currentRenderTarget) == null ? void 0 : _currentRenderTarget.getColorTexture(0);
+            var currentDepthTexture = (_currentRenderTarget1 = currentRenderTarget) == null ? void 0 : _currentRenderTarget1.depthTexture;
+            var colorTexture = colorFormat ? PipelineUtils.recreateTextureIfNeeded(engine, currentColorTexture, width, height, colorFormat, mipmap) : null;
+            var depthTexture = depthFormat ? PipelineUtils.recreateTextureIfNeeded(engine, currentDepthTexture, width, height, depthFormat, mipmap) : null;
+            if (currentColorTexture !== colorTexture || currentDepthTexture !== depthTexture) {
+                var _currentRenderTarget2;
+                (_currentRenderTarget2 = currentRenderTarget) == null ? void 0 : _currentRenderTarget2.destroy();
+                currentRenderTarget = new RenderTarget(engine, width, height, colorTexture, depthTexture);
+                currentRenderTarget.isGCIgnored = true;
+            }
+            return currentRenderTarget;
+        };
+        return PipelineUtils;
     }();
     /**
      * @internal
@@ -26615,60 +26637,47 @@
         };
         return RenderQueue;
     }();
+    var passNum = 0;
     /**
-     * @internal
-     */ var PipelineUtils = /*#__PURE__*/ function() {
-        var PipelineUtils = function PipelineUtils() {};
-        /**
-       * Recreate texture if needed.
-       * @param engine - Engine
-       * @param currentTexture - Current texture
-       * @param width - Need texture width
-       * @param height - Need texture height
-       * @param format - Need texture format
-       * @param mipmap - Need texture mipmap
-       * @returns Texture
-       */ PipelineUtils.recreateTextureIfNeeded = function recreateTextureIfNeeded(engine, currentTexture, width, height, format, mipmap) {
-            if (currentTexture) {
-                if (currentTexture.width !== width || currentTexture.height !== height || currentTexture.format !== format || currentTexture.mipmapCount > 1 !== mipmap) {
-                    currentTexture.destroy();
-                    var texture = new Texture2D(engine, width, height, format, mipmap);
-                    texture.isGCIgnored = true;
-                    return texture;
-                } else {
-                    return currentTexture;
-                }
-            } else {
-                var texture1 = new Texture2D(engine, width, height, format, mipmap);
-                texture1.isGCIgnored = true;
-                return texture1;
-            }
+     * RenderPass.
+     */ var RenderPass = /*#__PURE__*/ function() {
+        var RenderPass = function RenderPass(name1, priority, renderTarget, replaceMaterial, mask) {
+            if (name1 === void 0) name1 = "RENDER_PASS" + passNum++;
+            if (priority === void 0) priority = 0;
+            if (renderTarget === void 0) renderTarget = null;
+            if (replaceMaterial === void 0) replaceMaterial = null;
+            if (mask === void 0) mask = null;
+            this.name = name1;
+            this.enabled = true;
+            this.priority = priority;
+            this.renderTarget = renderTarget;
+            this.replaceMaterial = replaceMaterial;
+            this.mask = mask || exports.Layer.Everything;
+            this.renderOverride = false; // If renderOverride is set to true, you need to implement the render method
         };
+        var _proto = RenderPass.prototype;
         /**
-       * Recreate render target if needed.
-       * @param engine - Engine
-       * @param currentRenderTarget - Current render target
-       * @param width - Need render target width
-       * @param height - Need render target height
-       * @param colorFormat - Need render target color format
-       * @param depthFormat - Need render target depth format
-       * @param mipmap - Need render target mipmap
-       * @returns Render target
-       */ PipelineUtils.recreateRenderTargetIfNeeded = function recreateRenderTargetIfNeeded(engine, currentRenderTarget, width, height, colorFormat, depthFormat, mipmap) {
-            var _currentRenderTarget, _currentRenderTarget1;
-            var currentColorTexture = (_currentRenderTarget = currentRenderTarget) == null ? void 0 : _currentRenderTarget.getColorTexture(0);
-            var currentDepthTexture = (_currentRenderTarget1 = currentRenderTarget) == null ? void 0 : _currentRenderTarget1.depthTexture;
-            var colorTexture = colorFormat ? PipelineUtils.recreateTextureIfNeeded(engine, currentColorTexture, width, height, colorFormat, mipmap) : null;
-            var depthTexture = depthFormat ? PipelineUtils.recreateTextureIfNeeded(engine, currentDepthTexture, width, height, depthFormat, mipmap) : null;
-            if (currentColorTexture !== colorTexture || currentDepthTexture !== depthTexture) {
-                var _currentRenderTarget2;
-                (_currentRenderTarget2 = currentRenderTarget) == null ? void 0 : _currentRenderTarget2.destroy();
-                currentRenderTarget = new RenderTarget(engine, width, height, colorTexture, depthTexture);
-                currentRenderTarget.isGCIgnored = true;
-            }
-            return currentRenderTarget;
-        };
-        return PipelineUtils;
+       * Rendering callback, will be executed if renderOverride is set to true.
+       * @param camera - Camera
+       * @param opaqueQueue - Opaque queue
+       * @param alphaTestQueue - Alpha test queue
+       * @param transparentQueue - Transparent queue
+       */ _proto.render = function render(camera, opaqueQueue, alphaTestQueue, transparentQueue) {};
+        /**
+       * Post rendering callback.
+       * @param camera - Camera
+       * @param opaqueQueue - Opaque queue
+       * @param alphaTestQueue - Alpha test queue
+       * @param transparentQueue - Transparent queue
+       */ _proto.preRender = function preRender(camera, opaqueQueue, alphaTestQueue, transparentQueue) {};
+        /**
+       * Post rendering callback.
+       * @param camera - Camera
+       * @param opaqueQueue - Opaque queue
+       * @param alphaTestQueue - Alpha test queue
+       * @param transparentQueue - Transparent queue
+       */ _proto.postRender = function postRender(camera, opaqueQueue, alphaTestQueue, transparentQueue) {};
+        return RenderPass;
     }();
     /**
      * @internal
@@ -26933,6 +26942,26 @@
             var offset = cascadeIndex * 16;
             Utils._floatMatrixMultiply(sliceMatrix, outShadowMatrices, offset, outShadowMatrices, offset);
         };
+        /**
+       * Extract scale and bias from a fade distance to achieve a linear fading of the fade distance.
+       */ ShadowUtils.getScaleAndBiasForLinearDistanceFade = function getScaleAndBiasForLinearDistanceFade(fadeDistance, border, outInfo) {
+            // (P^2-N^2)/(F^2-N^2)
+            // To avoid division from zero
+            // This values ensure that fade within cascade will be 0 and outside 1
+            if (border < 0.0001) {
+                var multiplier = 1000; // To avoid blending if difference is in fractions
+                outInfo.z = multiplier;
+                outInfo.w = -fadeDistance * multiplier;
+                return;
+            }
+            border = 1 - border;
+            border *= border;
+            // Fade with distance calculation is just a linear fade from 90% of fade distance to fade distance. 90% arbitrarily chosen but should work well enough.
+            var distanceFadeNear = border * fadeDistance;
+            var fadeRange = fadeDistance - distanceFadeNear;
+            outInfo.z = 1.0 / fadeRange;
+            outInfo.w = -distanceFadeNear / fadeRange;
+        };
         return ShadowUtils;
     }();
     (function() {
@@ -27176,11 +27205,6 @@
         //now max shadow sample tent is 5x5, atlas borderSize at least 3=ceil(2.5),and +1 pixel is for global border for no cascade mode.
         ShadowUtils.atlasBorderSize = 4.0;
     })();
-    /**
-     * PipelinePass is a base class for all pipeline passes.
-     */ var PipelinePass = function PipelinePass(engine) {
-        this._engine = engine;
-    };
     /**
      * Cascade shadow caster pass.
      */ var CascadedShadowCasterPass = /*#__PURE__*/ function(PipelinePass1) {
@@ -27193,11 +27217,10 @@
             _this._shadowSliceData = new ShadowSliceData();
             _this._lightUp = new Vector3();
             _this._lightSide = new Vector3();
-            _this._existShadowMap = false;
             _this._splitBoundSpheres = new Float32Array(CascadedShadowCasterPass._maxCascades * 4);
             /** The end is project precision problem in shader. */ _this._shadowMatrices = new Float32Array((CascadedShadowCasterPass._maxCascades + 1) * 16);
-            // strength, null, lightIndex
-            _this._shadowInfos = new Vector3();
+            // intensity, null, fadeScale, fadeBias
+            _this._shadowInfos = new Vector4();
             _this._viewportOffsets = [
                 new Vector2(),
                 new Vector2(),
@@ -27213,14 +27236,12 @@
         /**
        * @internal
        */ _proto.onRender = function onRender(context) {
+            var light = this._camera.scene._lightManager._sunlight;
             this._updateShadowSettings();
-            this._existShadowMap = false;
-            this._renderDirectShadowMap(context);
-            if (this._existShadowMap) {
-                this._updateReceiversShaderData();
-            }
+            this._renderDirectShadowMap(context, light);
+            this._updateReceiversShaderData(light);
         };
-        _proto._renderDirectShadowMap = function _renderDirectShadowMap(context) {
+        _proto._renderDirectShadowMap = function _renderDirectShadowMap(context, light) {
             var _this = this, engine = _this._engine, camera = _this._camera, viewports = _this._viewportOffsets, shadowSliceData = _this._shadowSliceData, splitBoundSpheres = _this._splitBoundSpheres, shadowMatrices = _this._shadowMatrices;
             var _camera__renderPipeline__cullingResults = camera._renderPipeline._cullingResults, opaqueQueue = _camera__renderPipeline__cullingResults.opaqueQueue, alphaTestQueue = _camera__renderPipeline__cullingResults.alphaTestQueue, transparentQueue = _camera__renderPipeline__cullingResults.transparentQueue;
             var scene = camera.scene;
@@ -27234,91 +27255,87 @@
             var lightUp = this._lightUp;
             var lightSide = this._lightSide;
             var lightForward = shadowSliceData.virtualCamera.forward;
-            var light = scene._lightManager._sunlight;
-            if (light) {
-                var shadowFar = Math.min(camera.scene.shadowDistance, camera.farClipPlane);
-                this._getCascadesSplitDistance(shadowFar);
-                // Prepare render target
-                var _this__shadowMapSize = this._shadowMapSize, width = _this__shadowMapSize.z, height = _this__shadowMapSize.w;
-                var format = this._shadowMapFormat;
-                var renderTarget;
-                var shadowTexture;
-                if (this._supportDepthTexture) {
-                    renderTarget = PipelineUtils.recreateRenderTargetIfNeeded(engine, this._renderTarget, width, height, null, format, false);
-                    shadowTexture = renderTarget.depthTexture;
-                } else {
-                    renderTarget = PipelineUtils.recreateRenderTargetIfNeeded(engine, this._renderTarget, width, height, format, null, false);
-                    shadowTexture = renderTarget.getColorTexture(0);
-                }
-                shadowTexture.wrapModeU = shadowTexture.wrapModeV = exports.TextureWrapMode.Clamp;
-                if (engine._hardwareRenderer._isWebGL2) {
-                    shadowTexture.depthCompareFunction = exports.TextureDepthCompareFunction.Less;
-                }
-                this._renderTarget = renderTarget;
-                this._depthTexture = shadowTexture;
-                // @todo: shouldn't set viewport and scissor in activeRenderTarget
-                rhi.activeRenderTarget(renderTarget, CascadedShadowCasterPass._viewport, 0);
-                if (this._supportDepthTexture) {
-                    rhi.clearRenderTarget(engine, exports.CameraClearFlags.Depth, null);
-                } else {
-                    rhi.clearRenderTarget(engine, exports.CameraClearFlags.All, CascadedShadowCasterPass._clearColor);
-                }
-                this._shadowInfos.x = light.shadowStrength;
-                this._shadowInfos.z = 0; // @todo: sun light index always 0
-                // prepare light and camera direction
-                Matrix.rotationQuaternion(light.entity.transform.worldRotationQuaternion, lightWorld);
-                lightSide.set(lightWorldE[0], lightWorldE[1], lightWorldE[2]);
-                lightUp.set(lightWorldE[4], lightWorldE[5], lightWorldE[6]);
-                lightForward.set(-lightWorldE[8], -lightWorldE[9], -lightWorldE[10]);
-                var cameraForward = CascadedShadowCasterPass._tempVector;
-                cameraForward.copyFrom(camera.entity.transform.worldForward);
-                var shadowTileResolution = this._shadowTileResolution;
-                for(var j = 0; j < shadowCascades; j++){
-                    ShadowUtils.getBoundSphereByFrustum(splitDistance[j], splitDistance[j + 1], camera, cameraForward, shadowSliceData);
-                    ShadowUtils.getDirectionLightShadowCullPlanes(camera._frustum, splitDistance[j], camera.nearClipPlane, lightForward, shadowSliceData);
-                    ShadowUtils.getDirectionalLightMatrices(lightUp, lightSide, lightForward, j, light.shadowNearPlane, shadowTileResolution, shadowSliceData, shadowMatrices);
-                    if (shadowCascades > 1) {
-                        ShadowUtils.applySliceTransform(shadowTileResolution, width, height, j, this._viewportOffsets[j], shadowMatrices);
-                    }
-                    this._updateSingleShadowCasterShaderData(light, shadowSliceData, context);
-                    // upload pre-cascade infos.
-                    var center = boundSphere.center;
-                    var radius = boundSphere.radius;
-                    var offset = j * 4;
-                    splitBoundSpheres[offset] = center.x;
-                    splitBoundSpheres[offset + 1] = center.y;
-                    splitBoundSpheres[offset + 2] = center.z;
-                    splitBoundSpheres[offset + 3] = radius * radius;
-                    opaqueQueue.clear();
-                    alphaTestQueue.clear();
-                    transparentQueue.clear();
-                    var renderers = componentsManager._renderers;
-                    var elements = renderers._elements;
-                    for(var k = renderers.length - 1; k >= 0; --k){
-                        ShadowUtils.shadowCullFrustum(context, light, elements[k], shadowSliceData);
-                    }
-                    if (opaqueQueue.elements.length || alphaTestQueue.elements.length) {
-                        opaqueQueue.sort(RenderQueue._compareFromNearToFar);
-                        alphaTestQueue.sort(RenderQueue._compareFromNearToFar);
-                        var _viewports_j = viewports[j], x = _viewports_j.x, y = _viewports_j.y;
-                        rhi.setGlobalDepthBias(1.0, 1.0);
-                        rhi.viewport(x, y, shadowTileResolution, shadowTileResolution);
-                        // for no cascade is for the edge,for cascade is for the beyond maxCascade pixel can use (0,0,0) trick sample the shadowMap
-                        rhi.scissor(x + 1, y + 1, shadowTileResolution - 2, shadowTileResolution - 2);
-                        engine._renderCount++;
-                        opaqueQueue.render(camera, exports.Layer.Everything, exports.PipelineStage.ShadowCaster);
-                        alphaTestQueue.render(camera, exports.Layer.Everything, exports.PipelineStage.ShadowCaster);
-                        rhi.setGlobalDepthBias(0, 0);
-                    }
-                }
-                this._existShadowMap = true;
-            }
-        };
-        _proto._updateReceiversShaderData = function _updateReceiversShaderData() {
-            var scene = this._camera.scene;
+            // Prepare render target
+            var _this__shadowMapSize = this._shadowMapSize, width = _this__shadowMapSize.z, height = _this__shadowMapSize.w;
+            var format = this._shadowMapFormat;
+            var renderTarget;
+            var shadowTexture;
+            if (this._supportDepthTexture) {
+                renderTarget = PipelineUtils.recreateRenderTargetIfNeeded(engine, this._renderTarget, width, height, null, format, false);
+                shadowTexture = renderTarget.depthTexture;
+            } else {
+                renderTarget = PipelineUtils.recreateRenderTargetIfNeeded(engine, this._renderTarget, width, height, format, null, false);
+                shadowTexture = renderTarget.getColorTexture(0);
+            }
+            shadowTexture.wrapModeU = shadowTexture.wrapModeV = exports.TextureWrapMode.Clamp;
+            if (engine._hardwareRenderer._isWebGL2) {
+                shadowTexture.depthCompareFunction = exports.TextureDepthCompareFunction.Less;
+            }
+            this._renderTarget = renderTarget;
+            this._depthTexture = shadowTexture;
+            // @todo: shouldn't set viewport and scissor in activeRenderTarget
+            rhi.activeRenderTarget(renderTarget, CascadedShadowCasterPass._viewport, 0);
+            if (this._supportDepthTexture) {
+                rhi.clearRenderTarget(engine, exports.CameraClearFlags.Depth, null);
+            } else {
+                rhi.clearRenderTarget(engine, exports.CameraClearFlags.All, CascadedShadowCasterPass._clearColor);
+            }
+            // prepare light and camera direction
+            Matrix.rotationQuaternion(light.entity.transform.worldRotationQuaternion, lightWorld);
+            lightSide.set(lightWorldE[0], lightWorldE[1], lightWorldE[2]);
+            lightUp.set(lightWorldE[4], lightWorldE[5], lightWorldE[6]);
+            lightForward.set(-lightWorldE[8], -lightWorldE[9], -lightWorldE[10]);
+            var cameraForward = CascadedShadowCasterPass._tempVector;
+            cameraForward.copyFrom(camera.entity.transform.worldForward);
+            var shadowTileResolution = this._shadowTileResolution;
+            for(var j = 0; j < shadowCascades; j++){
+                ShadowUtils.getBoundSphereByFrustum(splitDistance[j], splitDistance[j + 1], camera, cameraForward, shadowSliceData);
+                ShadowUtils.getDirectionLightShadowCullPlanes(camera._frustum, splitDistance[j], camera.nearClipPlane, lightForward, shadowSliceData);
+                ShadowUtils.getDirectionalLightMatrices(lightUp, lightSide, lightForward, j, light.shadowNearPlane, shadowTileResolution, shadowSliceData, shadowMatrices);
+                if (shadowCascades > 1) {
+                    ShadowUtils.applySliceTransform(shadowTileResolution, width, height, j, this._viewportOffsets[j], shadowMatrices);
+                }
+                this._updateSingleShadowCasterShaderData(light, shadowSliceData, context);
+                // upload pre-cascade infos.
+                var center = boundSphere.center;
+                var radius = boundSphere.radius;
+                var offset = j * 4;
+                splitBoundSpheres[offset] = center.x;
+                splitBoundSpheres[offset + 1] = center.y;
+                splitBoundSpheres[offset + 2] = center.z;
+                splitBoundSpheres[offset + 3] = radius * radius;
+                opaqueQueue.clear();
+                alphaTestQueue.clear();
+                transparentQueue.clear();
+                var renderers = componentsManager._renderers;
+                var elements = renderers._elements;
+                for(var k = renderers.length - 1; k >= 0; --k){
+                    ShadowUtils.shadowCullFrustum(context, light, elements[k], shadowSliceData);
+                }
+                if (opaqueQueue.elements.length || alphaTestQueue.elements.length) {
+                    opaqueQueue.sort(RenderQueue._compareFromNearToFar);
+                    alphaTestQueue.sort(RenderQueue._compareFromNearToFar);
+                    var _viewports_j = viewports[j], x = _viewports_j.x, y = _viewports_j.y;
+                    rhi.setGlobalDepthBias(1.0, 1.0);
+                    rhi.viewport(x, y, shadowTileResolution, shadowTileResolution);
+                    // for no cascade is for the edge,for cascade is for the beyond maxCascade pixel can use (0,0,0) trick sample the shadowMap
+                    rhi.scissor(x + 1, y + 1, shadowTileResolution - 2, shadowTileResolution - 2);
+                    engine._renderCount++;
+                    opaqueQueue.render(camera, exports.Layer.Everything, exports.PipelineStage.ShadowCaster);
+                    alphaTestQueue.render(camera, exports.Layer.Everything, exports.PipelineStage.ShadowCaster);
+                    rhi.setGlobalDepthBias(0, 0);
+                }
+            }
+        };
+        _proto._updateReceiversShaderData = function _updateReceiversShaderData(light) {
+            var camera = this._camera;
+            var scene = camera.scene;
             var splitBoundSpheres = this._splitBoundSpheres;
             var shadowMatrices = this._shadowMatrices;
             var shadowCascades = scene.shadowCascades;
+            var shadowFar = Math.min(scene.shadowDistance, camera.farClipPlane);
+            ShadowUtils.getScaleAndBiasForLinearDistanceFade(Math.pow(shadowFar, 2), scene.shadowFadeBorder, this._shadowInfos);
+            this._shadowInfos.x = light.shadowStrength;
             // set zero matrix to project the index out of max cascade
             if (shadowCascades > 1) {
                 for(var i = shadowCascades * 4, n = splitBoundSpheres.length; i < n; i++){
@@ -27331,7 +27348,7 @@
             }
             var shaderData = scene.shaderData;
             shaderData.setFloatArray(CascadedShadowCasterPass._shadowMatricesProperty, this._shadowMatrices);
-            shaderData.setVector3(CascadedShadowCasterPass._shadowInfosProperty, this._shadowInfos);
+            shaderData.setVector4(CascadedShadowCasterPass._shadowInfosProperty, this._shadowInfos);
             shaderData.setTexture(CascadedShadowCasterPass._shadowMapsProperty, this._depthTexture);
             shaderData.setFloatArray(CascadedShadowCasterPass._shadowSplitSpheresProperty, this._splitBoundSpheres);
             shaderData.setVector4(CascadedShadowCasterPass._shadowMapSize, this._shadowMapSize);
@@ -27367,10 +27384,13 @@
             return Math.sqrt(radius * radius / denominator);
         };
         _proto._updateShadowSettings = function _updateShadowSettings() {
-            var scene = this._camera.scene;
+            var camera = this._camera;
+            var scene = camera.scene;
             var shadowFormat = ShadowUtils.shadowDepthFormat(scene.shadowResolution, this._supportDepthTexture);
             var shadowResolution = ShadowUtils.shadowResolution(scene.shadowResolution);
             var shadowCascades = scene.shadowCascades;
+            var shadowFar = Math.min(scene.shadowDistance, camera.farClipPlane);
+            this._getCascadesSplitDistance(shadowFar);
             if (shadowFormat !== this._shadowMapFormat || shadowResolution !== this._shadowMapResolution || shadowCascades !== this._shadowCascadeMode) {
                 this._shadowMapFormat = shadowFormat;
                 this._shadowMapResolution = shadowResolution;
@@ -28543,6 +28563,7 @@
        * @param obj - class object
        */ Loader.registerClass = function registerClass(className, classDefine) {
             this._engineObjects[className] = classDefine;
+            this._classNameMap.set(classDefine, className);
         };
         /**
        * Get the class object by class name.
@@ -28551,11 +28572,21 @@
        */ Loader.getClass = function getClass(className) {
             return this._engineObjects[className];
         };
+        /**
+       * Get the class name by class object.
+       * @param obj - class object
+       * @returns class name
+       */ Loader.getClassName = function getClassName(obj) {
+            return this._classNameMap.get(obj);
+        };
         return Loader;
     }();
     (function() {
         Loader._engineObjects = {};
     })();
+    (function() {
+        Loader._classNameMap = new Map();
+    })();
     /**
      * Alpha blend mode.
      */ exports.BlendMode = void 0;
@@ -32276,7 +32307,7 @@
                     this._clip = clip;
                     this._clipEndTime = Math.min(this._clipEndTime, 1);
                     this._onClipChanged();
-                    clip._updateFlagManager.addListener(this._onClipChanged);
+                    clip && clip._updateFlagManager.addListener(this._onClipChanged);
                 }
             },
             {
@@ -32965,6 +32996,7 @@
         ParticleRandomSubSeeds[ParticleRandomSubSeeds["RotationOverLifetime"] = 0x40eb95e4] = "RotationOverLifetime";
         ParticleRandomSubSeeds[ParticleRandomSubSeeds["TextureSheetAnimation"] = 0xbc524e5] = "TextureSheetAnimation";
         ParticleRandomSubSeeds[ParticleRandomSubSeeds["Shape"] = 0xaf502044] = "Shape";
+        ParticleRandomSubSeeds[ParticleRandomSubSeeds["GravityModifier"] = 0xa47b8c4d] = "GravityModifier";
     })(ParticleRandomSubSeeds || (ParticleRandomSubSeeds = {}));
     /**
      * Particle gradient.
@@ -33670,6 +33702,7 @@
             /** @internal */ this._startColorRand = new Rand(0, ParticleRandomSubSeeds.StartColor);
             /** @internal */ this._startSizeRand = new Rand(0, ParticleRandomSubSeeds.StartSize);
             /** @internal */ this._startRotationRand = new Rand(0, ParticleRandomSubSeeds.StartRotation);
+            this._gravityModifierRand = new Rand(0, ParticleRandomSubSeeds.GravityModifier);
             this._gravity = new Vector3();
             this._generator = generator;
         };
@@ -33730,7 +33763,7 @@
                     break;
             }
             var particleGravity = this._gravity;
-            var gravityModifierValue = this.gravityModifier.evaluate(undefined, undefined);
+            var gravityModifierValue = this.gravityModifier.evaluate(undefined, this._gravityModifierRand.random());
             Vector3.scale(renderer.scene.physics.gravity, gravityModifierValue, particleGravity);
             shaderData.setVector3(MainModule._gravity, particleGravity);
             shaderData.setInt(MainModule._simulationSpace, this.simulationSpace);
@@ -33849,6 +33882,9 @@
     __decorate$1([
         ignoreClone
     ], MainModule.prototype, "_startRotationRand", void 0);
+    __decorate$1([
+        ignoreClone
+    ], MainModule.prototype, "_gravityModifierRand", void 0);
     __decorate$1([
         ignoreClone
     ], MainModule.prototype, "_generator", void 0);
@@ -35152,22 +35188,22 @@
     }();
     /**
      * The emission shape.
-     */ var ParticleShapeType;
+     */ exports.ParticleShapeType = void 0;
     (function(ParticleShapeType) {
         ParticleShapeType[ParticleShapeType[/** Emit from the volume of a box. */ "Box"] = 0] = "Box";
         ParticleShapeType[ParticleShapeType[/** Emit from a circle. */ "Circle"] = 1] = "Circle";
         ParticleShapeType[ParticleShapeType[/** Emit from the base of a cone. */ "Cone"] = 2] = "Cone";
         ParticleShapeType[ParticleShapeType[/** Emit from a half-sphere. */ "Hemisphere"] = 3] = "Hemisphere";
         ParticleShapeType[ParticleShapeType[/** Emit from a sphere. */ "Sphere"] = 4] = "Sphere";
-    })(ParticleShapeType || (ParticleShapeType = {}));
+    })(exports.ParticleShapeType || (exports.ParticleShapeType = {}));
     /**
      * Particle shape that emits particles from a box.
      */ var BoxShape = /*#__PURE__*/ function(BaseShape1) {
         var BoxShape = function BoxShape() {
             var _this;
-            _this = BaseShape1.call(this) || this;
+            _this = BaseShape1.apply(this, arguments) || this;
+            _this.shapeType = exports.ParticleShapeType.Box;
             /** The size of the box. */ _this.size = new Vector3(1, 1, 1);
-            _this.shapeType = ParticleShapeType.Box;
             return _this;
         };
         _inherits$2(BoxShape, BaseShape1);
@@ -35202,12 +35238,12 @@
      */ var CircleShape = /*#__PURE__*/ function(BaseShape1) {
         var CircleShape = function CircleShape() {
             var _this;
-            _this = BaseShape1.call(this) || this;
+            _this = BaseShape1.apply(this, arguments) || this;
+            _this.shapeType = exports.ParticleShapeType.Circle;
             /** Radius of the shape to emit particles from. */ _this.radius = 1.0;
             /** Angle of the circle arc to emit particles from. */ _this.arc = 360.0;
             /** The mode to generate particles around the arc. */ _this.arcMode = exports.ParticleShapeArcMode.Random;
             /** The speed of complete 360 degree rotation. */ _this.arcSpeed = 1.0;
-            _this.shapeType = ParticleShapeType.Circle;
             return _this;
         };
         _inherits$2(CircleShape, BaseShape1);
@@ -35242,12 +35278,12 @@
      */ var ConeShape = /*#__PURE__*/ function(BaseShape1) {
         var ConeShape = function ConeShape() {
             var _this;
-            _this = BaseShape1.call(this) || this;
+            _this = BaseShape1.apply(this, arguments) || this;
+            _this.shapeType = exports.ParticleShapeType.Cone;
             /** Angle of the cone to emit particles from. */ _this.angle = 25.0;
             /** Radius of the shape to emit particles from. */ _this.radius = 1.0;
             /** Length of the cone to emit particles from. */ _this.length = 5.0;
             /** Cone emitter type. */ _this.emitType = /** Emit particles from the base of the cone. */ 0;
-            _this.shapeType = ParticleShapeType.Cone;
             return _this;
         };
         _inherits$2(ConeShape, BaseShape1);
@@ -35306,9 +35342,9 @@
      */ var HemisphereShape = /*#__PURE__*/ function(BaseShape1) {
         var HemisphereShape = function HemisphereShape() {
             var _this;
-            _this = BaseShape1.call(this) || this;
+            _this = BaseShape1.apply(this, arguments) || this;
+            _this.shapeType = exports.ParticleShapeType.Hemisphere;
             /** Radius of the shape to emit particles from. */ _this.radius = 1.0;
-            _this.shapeType = ParticleShapeType.Hemisphere;
             return _this;
         };
         _inherits$2(HemisphereShape, BaseShape1);
@@ -35330,9 +35366,9 @@
      */ var SphereShape = /*#__PURE__*/ function(BaseShape1) {
         var SphereShape = function SphereShape() {
             var _this;
-            _this = BaseShape1.call(this) || this;
+            _this = BaseShape1.apply(this, arguments) || this;
+            _this.shapeType = exports.ParticleShapeType.Sphere;
             /** Radius of the shape to emit particles from. */ _this.radius = 1.0;
-            _this.shapeType = ParticleShapeType.Sphere;
             return _this;
         };
         _inherits$2(SphereShape, BaseShape1);
@@ -35836,6 +35872,7 @@
         ParticleRenderer: ParticleRenderer,
         get ParticleScaleMode () { return exports.ParticleScaleMode; },
         get ParticleShapeArcMode () { return exports.ParticleShapeArcMode; },
+        get ParticleShapeType () { return exports.ParticleShapeType; },
         get ParticleSimulationSpace () { return exports.ParticleSimulationSpace; },
         get ParticleStopMode () { return exports.ParticleStopMode; },
         PhysicsMaterial: PhysicsMaterial,
@@ -38627,8 +38664,7 @@
             var assetRefId = entityConfig.assetRefId;
             var engine = this._context.engine;
             if (assetRefId) {
-                return engine.resourceManager // @ts-ignore
-                .getResourceByRef({
+                return engine.resourceManager.getResourceByRef({
                     refId: assetRefId,
                     key: entityConfig.key,
                     isClone: entityConfig.isClone
@@ -38658,36 +38694,355 @@
     (function() {
         ReflectionParser.customParseComponentHandles = new Map();
     })();
-    var PrefabParser = /*#__PURE__*/ function() {
-        var PrefabParser = function PrefabParser() {};
-        PrefabParser.parseChildren = function parseChildren(entitiesConfig, entities, parentId) {
-            var children = entitiesConfig.get(parentId).children;
+    /**
+     * Parser context
+     * @export
+     * @abstract
+     * @class ParserContext
+     * @template T
+     * @template I
+     */ var ParserContext = /*#__PURE__*/ function() {
+        var ParserContext = function ParserContext(originalData, engine, target) {
+            this.originalData = originalData;
+            this.engine = engine;
+            this.target = target;
+            this.entityMap = new Map();
+            this.components = new Map();
+            this.assets = new Map();
+            this.entityConfigMap = new Map();
+            this.rootIds = [];
+            this.strippedIds = [];
+            this.resourceManager = engine.resourceManager;
+        };
+        var _proto = ParserContext.prototype;
+        /**
+       * Destroy the context.
+       * @abstract
+       * @memberof ParserContext
+       */ _proto.destroy = function destroy() {
+            this.entityMap.clear();
+            this.components.clear();
+            this.assets.clear();
+            this.entityConfigMap.clear();
+            this.rootIds.length = 0;
+        };
+        return ParserContext;
+    }();
+    var PrefabParserContext = /*#__PURE__*/ function(ParserContext1) {
+        var PrefabParserContext = function PrefabParserContext() {
+            return ParserContext1.apply(this, arguments);
+        };
+        _inherits(PrefabParserContext, ParserContext1);
+        return PrefabParserContext;
+    }(ParserContext);
+    function _array_like_to_array(arr, len) {
+        if (len == null || len > arr.length) len = arr.length;
+        for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
+        return arr2;
+    }
+    function _unsupported_iterable_to_array(o, minLen) {
+        if (!o) return;
+        if (typeof o === "string") return _array_like_to_array(o, minLen);
+        var n = Object.prototype.toString.call(o).slice(8, -1);
+        if (n === "Object" && o.constructor) n = o.constructor.name;
+        if (n === "Map" || n === "Set") return Array.from(n);
+        if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+    }
+    function _create_for_of_iterator_helper_loose(o, allowArrayLike) {
+        var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"];
+        if (it) return (it = it.call(o)).next.bind(it);
+        // Fallback for engines without symbol support
+        if (Array.isArray(o) || (it = _unsupported_iterable_to_array(o)) || allowArrayLike && o && typeof o.length === "number") {
+            if (it) o = it;
+            var i = 0;
+            return function() {
+                if (i >= o.length) return {
+                    done: true
+                };
+                return {
+                    done: false,
+                    value: o[i++]
+                };
+            };
+        }
+        throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+    }
+    var HierarchyParser = /*#__PURE__*/ function() {
+        var HierarchyParser = function HierarchyParser(context) {
+            var _this = this;
+            this.context = context;
+            this.prefabContextMap = new WeakMap();
+            this.prefabPromiseMap = new Map();
+            this._engine = this.context.engine;
+            this._organizeEntities = this._organizeEntities.bind(this);
+            this._parseComponents = this._parseComponents.bind(this);
+            this._parsePrefabModification = this._parsePrefabModification.bind(this);
+            this._parsePrefabRemovedEntities = this._parsePrefabRemovedEntities.bind(this);
+            this._parsePrefabRemovedComponents = this._parsePrefabRemovedComponents.bind(this);
+            this._clearAndResolve = this._clearAndResolve.bind(this);
+            this.promise = new Promise(function(resolve, reject) {
+                _this._reject = reject;
+                _this._resolve = resolve;
+            });
+            this._reflectionParser = new ReflectionParser(context);
+        };
+        var _proto = HierarchyParser.prototype;
+        /** start parse the scene or prefab or others */ _proto.start = function start() {
+            this._parseEntities().then(this._organizeEntities).then(this._parseComponents).then(this._parsePrefabModification).then(this._parsePrefabRemovedEntities).then(this._parsePrefabRemovedComponents).then(this._clearAndResolve).then(this._resolve).catch(this._reject);
+        };
+        _proto._parseEntities = function _parseEntities() {
+            var _this = this;
+            var entitiesConfig = this.context.originalData.entities;
+            var entityConfigMap = this.context.entityConfigMap;
+            var entityMap = this.context.entityMap;
+            var engine = this._engine;
+            var promises = entitiesConfig.map(function(entityConfig) {
+                var _entityConfig_strippedId;
+                var id = (_entityConfig_strippedId = entityConfig.strippedId) != null ? _entityConfig_strippedId : entityConfig.id;
+                entityConfig.id = id;
+                entityConfigMap.set(id, entityConfig);
+                return _this._getEntityByConfig(entityConfig, engine);
+            });
+            return Promise.all(promises).then(function(entities) {
+                for(var i = 0, l = entities.length; i < l; i++){
+                    entityMap.set(entitiesConfig[i].id, entities[i]);
+                }
+                return entities;
+            });
+        };
+        _proto._parseComponents = function _parseComponents() {
+            var entitiesConfig = this.context.originalData.entities;
+            var entityMap = this.context.entityMap;
+            var components = this.context.components;
+            var promises = [];
+            for(var i = 0, l = entitiesConfig.length; i < l; i++){
+                var entityConfig = entitiesConfig[i];
+                var entity = entityMap.get(entityConfig.id);
+                for(var i1 = 0; i1 < entityConfig.components.length; i1++){
+                    var componentConfig = entityConfig.components[i1];
+                    var key = !componentConfig.refId ? componentConfig.class : componentConfig.refId;
+                    var component = entity.addComponent(Loader.getClass(key));
+                    components.set(componentConfig.id, component);
+                    var promise = this._reflectionParser.parsePropsAndMethods(component, componentConfig);
+                    promises.push(promise);
+                }
+            }
+            return Promise.all(promises);
+        };
+        _proto._parsePrefabModification = function _parsePrefabModification() {
+            var _loop = function _loop(i, l) {
+                var _modifications;
+                var entityConfig = entitiesConfig[i];
+                var id = entityConfig.id, modifications = entityConfig.modifications;
+                if ((_modifications = modifications) == null ? void 0 : _modifications.length) {
+                    var _promises;
+                    var rootEntity = entityMap.get(id);
+                    (_promises = promises).push.apply(_promises, [].concat(modifications.map(function(modification) {
+                        var target = modification.target, props = modification.props, methods = modification.methods;
+                        var entityId = target.entityId, componentId = target.componentId;
+                        var context = _this.prefabContextMap.get(rootEntity);
+                        var targetEntity = context.entityMap.get(entityId);
+                        var targetComponent = context.components.get(componentId);
+                        if (targetComponent) {
+                            return _this._reflectionParser.parsePropsAndMethods(targetComponent, {
+                                props: props,
+                                methods: methods
+                            });
+                        } else if (targetEntity) {
+                            return Promise.resolve(_this._applyEntityData(targetEntity, props));
+                        }
+                    })));
+                }
+            };
+            var _this = this;
+            var entitiesConfig = this.context.originalData.entities;
+            var entityMap = this.context.entityMap;
+            var promises = [];
+            for(var i = 0, l = entitiesConfig.length; i < l; i++)_loop(i);
+            return Promise.all(promises);
+        };
+        _proto._parsePrefabRemovedEntities = function _parsePrefabRemovedEntities() {
+            var _loop = function _loop(i, l) {
+                var _removedEntities;
+                var entityConfig = entitiesConfig[i];
+                var id = entityConfig.id, removedEntities = entityConfig.removedEntities;
+                if ((_removedEntities = removedEntities) == null ? void 0 : _removedEntities.length) {
+                    var _promises;
+                    var rootEntity = entityMap.get(id);
+                    (_promises = promises).push.apply(_promises, [].concat(removedEntities.map(function(target) {
+                        var entityId = target.entityId;
+                        var context = _this.prefabContextMap.get(rootEntity);
+                        var targetEntity = context.entityMap.get(entityId);
+                        if (targetEntity) {
+                            targetEntity.destroy();
+                        }
+                    })));
+                }
+            };
+            var _this = this;
+            var entitiesConfig = this.context.originalData.entities;
+            var entityMap = this.context.entityMap;
+            var promises = [];
+            for(var i = 0, l = entitiesConfig.length; i < l; i++)_loop(i);
+            return Promise.all(promises);
+        };
+        _proto._parsePrefabRemovedComponents = function _parsePrefabRemovedComponents() {
+            var _loop = function _loop(i, l) {
+                var _removedComponents;
+                var entityConfig = entitiesConfig[i];
+                var id = entityConfig.id, removedComponents = entityConfig.removedComponents;
+                if ((_removedComponents = removedComponents) == null ? void 0 : _removedComponents.length) {
+                    var _promises;
+                    var rootEntity = entityMap.get(id);
+                    (_promises = promises).concat.apply(_promises, [].concat(removedComponents.map(function(target) {
+                        var componentId = target.componentId;
+                        var context = _this.prefabContextMap.get(rootEntity);
+                        var targetComponent = context.components.get(componentId);
+                        if (targetComponent) {
+                            targetComponent.destroy();
+                        }
+                    })));
+                }
+            };
+            var _this = this;
+            var entitiesConfig = this.context.originalData.entities;
+            var entityMap = this.context.entityMap;
+            var promises = [];
+            for(var i = 0, l = entitiesConfig.length; i < l; i++)_loop(i);
+            return Promise.all(promises);
+        };
+        _proto._clearAndResolve = function _clearAndResolve() {
+            var target = this.context.target;
+            return target;
+        };
+        _proto._organizeEntities = function _organizeEntities() {
+            var _this_context = this.context, rootIds = _this_context.rootIds, strippedIds = _this_context.strippedIds;
+            var parentIds = rootIds.concat(strippedIds);
+            for(var _iterator = _create_for_of_iterator_helper_loose(parentIds), _step; !(_step = _iterator()).done;){
+                var parentId = _step.value;
+                this._parseChildren(parentId);
+            }
+            for(var i = 0; i < rootIds.length; i++){
+                this.handleRootEntity(rootIds[i]);
+            }
+        };
+        _proto._getEntityByConfig = function _getEntityByConfig(entityConfig, engine) {
+            var _this = this;
+            var entityPromise;
+            if (entityConfig.assetRefId) {
+                entityPromise = this._parseGLTF(entityConfig, engine);
+            } else if (entityConfig.strippedId) {
+                entityPromise = this._parseStrippedEntity(entityConfig);
+            } else {
+                entityPromise = this._parseEntity(entityConfig, engine);
+            }
+            return entityPromise.then(function(entity) {
+                return _this._applyEntityData(entity, entityConfig);
+            });
+        };
+        _proto._parseEntity = function _parseEntity(entityConfig, engine) {
+            var entity = new Entity(engine, entityConfig.name);
+            if (!entityConfig.parent) this.context.rootIds.push(entityConfig.id);
+            return Promise.resolve(entity);
+        };
+        _proto._parseGLTF = function _parseGLTF(entityConfig, engine) {
+            var _this = this;
+            var assetRefId = entityConfig.assetRefId;
+            var context = new ParserContext(null, engine);
+            return engine.resourceManager // @ts-ignore
+            .getResourceByRef({
+                refId: assetRefId
+            }).then(function(glTFResource) {
+                var entity = glTFResource.instantiateSceneRoot();
+                if (!entityConfig.parent) _this.context.rootIds.push(entityConfig.id);
+                _this._traverseAddEntityToMap(entity, context, "");
+                _this.prefabContextMap.set(entity, context);
+                var cbArray = _this.prefabPromiseMap.get(entityConfig.id);
+                cbArray && cbArray.forEach(function(cb) {
+                    cb.resolve(context);
+                });
+                return entity;
+            });
+        };
+        _proto._parseStrippedEntity = function _parseStrippedEntity(entityConfig) {
+            var _this = this;
+            this.context.strippedIds.push(entityConfig.id);
+            return new Promise(function(resolve, reject) {
+                var _this_prefabPromiseMap_get;
+                var cbArray = (_this_prefabPromiseMap_get = _this.prefabPromiseMap.get(entityConfig.prefabInstanceId)) != null ? _this_prefabPromiseMap_get : [];
+                cbArray.push({
+                    resolve: resolve,
+                    reject: reject
+                });
+                _this.prefabPromiseMap.set(entityConfig.prefabInstanceId, cbArray);
+            }).then(function(context) {
+                var entityId = entityConfig.prefabSource.entityId;
+                return context.entityMap.get(entityId);
+            });
+        };
+        _proto._parseChildren = function _parseChildren(parentId) {
+            var _this_context = this.context, entityConfigMap = _this_context.entityConfigMap, entityMap = _this_context.entityMap;
+            var children = entityConfigMap.get(parentId).children;
             if (children && children.length > 0) {
-                var parent = entities.get(parentId);
+                var parent = entityMap.get(parentId);
                 for(var i = 0; i < children.length; i++){
                     var childId = children[i];
-                    var entity = entities.get(childId);
+                    var entity = entityMap.get(childId);
                     parent.addChild(entity);
-                    this.parseChildren(entitiesConfig, entities, childId);
+                    this._parseChildren(childId);
                 }
             }
         };
-        return PrefabParser;
+        _proto._applyEntityData = function _applyEntityData(entity, entityConfig) {
+            var _entityConfig_isActive;
+            entity.isActive = (_entityConfig_isActive = entityConfig.isActive) != null ? _entityConfig_isActive : entity.isActive;
+            var _entityConfig_name;
+            entity.name = (_entityConfig_name = entityConfig.name) != null ? _entityConfig_name : entity.name;
+            var position = entityConfig.position, rotation = entityConfig.rotation, scale = entityConfig.scale;
+            if (position) entity.transform.position.copyFrom(position);
+            if (rotation) entity.transform.rotation.copyFrom(rotation);
+            if (scale) entity.transform.scale.copyFrom(scale);
+            return entity;
+        };
+        _proto._traverseAddEntityToMap = function _traverseAddEntityToMap(entity, context, path) {
+            var entityMap = context.entityMap, components = context.components;
+            entityMap.set(path, entity);
+            // @ts-ignore
+            entity._components.forEach(function(component) {
+                // @ts-ignore
+                var name = Loader.getClassName(component.constructor);
+                components.set(path + ":" + name, component);
+            });
+            for(var i = 0; i < entity.children.length; i++){
+                var child = entity.children[i];
+                var childPath = path ? path + "/" + child.name : child.name;
+                this._traverseAddEntityToMap(child, context, childPath);
+            }
+        };
+        return HierarchyParser;
     }();
-    var ComponentMap = {
-        Transform: Transform,
-        Animator: Animator,
-        DirectLight: DirectLight,
-        Camera: exports.Camera,
-        MeshRenderer: MeshRenderer,
-        ParticleRenderer: ParticleRenderer,
-        PointLight: PointLight,
-        SpotLight: SpotLight,
-        Script: Script,
-        SpriteMask: SpriteMask,
-        SpriteRenderer: SpriteRenderer,
-        TextRenderer: TextRenderer
-    };
+    var PrefabParser = /*#__PURE__*/ function(HierarchyParser1) {
+        var PrefabParser = function PrefabParser() {
+            return HierarchyParser1.apply(this, arguments);
+        };
+        _inherits(PrefabParser, HierarchyParser1);
+        var _proto = PrefabParser.prototype;
+        _proto.handleRootEntity = function handleRootEntity(id) {
+            this.context.target = this.context.entityMap.get(id);
+        };
+        /**
+       * Parse prefab data.
+       * @param engine - the engine of the parser context
+       * @param prefabData - prefab data which is exported by editor
+       * @returns a promise of prefab
+       */ PrefabParser.parse = function parse(engine, prefabData) {
+            var context = new PrefabParserContext(prefabData, engine);
+            var parser = new PrefabParser(context);
+            parser.start();
+            return parser;
+        };
+        return PrefabParser;
+    }(HierarchyParser);
     exports.InterpolableValueType = void 0;
     (function(InterpolableValueType) {
         InterpolableValueType[InterpolableValueType["Float"] = 0] = "Float";
@@ -38720,7 +39075,7 @@
                 for(var i1 = 0; i1 < curveBindingsLen; ++i1){
                     var relativePath = bufferReader.nextStr();
                     var componentStr = bufferReader.nextStr();
-                    var componentType = ComponentMap[componentStr];
+                    var componentType = Loader.getClass(componentStr);
                     var property = bufferReader.nextStr();
                     var getProperty = bufferReader.nextStr();
                     var curve = void 0;
@@ -38897,137 +39252,27 @@
         SpecularMode["Sky"] = "Sky";
         SpecularMode["Custom"] = "Custom";
     })(exports.SpecularMode || (exports.SpecularMode = {}));
-    function _array_like_to_array(arr, len) {
-        if (len == null || len > arr.length) len = arr.length;
-        for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
-        return arr2;
-    }
-    function _unsupported_iterable_to_array(o, minLen) {
-        if (!o) return;
-        if (typeof o === "string") return _array_like_to_array(o, minLen);
-        var n = Object.prototype.toString.call(o).slice(8, -1);
-        if (n === "Object" && o.constructor) n = o.constructor.name;
-        if (n === "Map" || n === "Set") return Array.from(n);
-        if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
-    }
-    function _create_for_of_iterator_helper_loose(o, allowArrayLike) {
-        var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"];
-        if (it) return (it = it.call(o)).next.bind(it);
-        // Fallback for engines without symbol support
-        if (Array.isArray(o) || (it = _unsupported_iterable_to_array(o)) || allowArrayLike && o && typeof o.length === "number") {
-            if (it) o = it;
-            var i = 0;
-            return function() {
-                if (i >= o.length) return {
-                    done: true
-                };
-                return {
-                    done: false,
-                    value: o[i++]
-                };
-            };
-        }
-        throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
-    }
-    var SceneParserContext = /*#__PURE__*/ function() {
-        var SceneParserContext = function SceneParserContext(originalData, scene) {
-            this.originalData = originalData;
-            this.scene = scene;
-            this.entityMap = new Map();
-            this.components = new Map();
-            this.assets = new Map();
-            this.entityConfigMap = new Map();
-            this.rootIds = [];
-            this.engine = scene.engine;
-            this.resourceManager = scene.engine.resourceManager;
-        };
-        var _proto = SceneParserContext.prototype;
-        _proto.destroy = function destroy() {
-            this.entityMap.clear();
-            this.components.clear();
-            this.assets.clear();
-            this.entityConfigMap.clear();
-            this.rootIds.length = 0;
+    var SceneParserContext = /*#__PURE__*/ function(ParserContext1) {
+        var SceneParserContext = function SceneParserContext(originalData, engine, scene) {
+            var _this;
+            _this = ParserContext1.call(this, originalData, engine, scene) || this;
+            _this.originalData = originalData;
+            _this.engine = engine;
+            _this.scene = scene;
+            return _this;
         };
+        _inherits(SceneParserContext, ParserContext1);
         return SceneParserContext;
-    }();
-    /** @Internal */ var SceneParser = /*#__PURE__*/ function() {
-        var SceneParser = function SceneParser(context) {
-            var _this = this;
-            this.context = context;
-            this._engine = context.scene.engine;
-            this._organizeEntities = this._organizeEntities.bind(this);
-            this._parseComponents = this._parseComponents.bind(this);
-            this._clearAndResolveScene = this._clearAndResolveScene.bind(this);
-            this.promise = new Promise(function(resolve, reject) {
-                _this._reject = reject;
-                _this._resolve = resolve;
-            });
-            this._reflectionParser = new ReflectionParser(context);
+    }(ParserContext);
+    /** @Internal */ var SceneParser = /*#__PURE__*/ function(HierarchyParser1) {
+        var SceneParser = function SceneParser() {
+            return HierarchyParser1.apply(this, arguments);
         };
+        _inherits(SceneParser, HierarchyParser1);
         var _proto = SceneParser.prototype;
-        /** start parse the scene */ _proto.start = function start() {
-            this._parseEntities().then(this._organizeEntities).then(this._parseComponents).then(this._clearAndResolveScene).then(this._resolve).catch(this._reject);
-        };
-        _proto._parseEntities = function _parseEntities() {
-            var _this = this;
-            var entitiesConfig = this.context.originalData.entities;
-            var entityConfigMap = this.context.entityConfigMap;
-            var entitiesMap = this.context.entityMap;
-            var rootIds = this.context.rootIds;
-            this._engine;
-            var promises = entitiesConfig.map(function(entityConfig) {
-                entityConfigMap.set(entityConfig.id, entityConfig);
-                // record root entities
-                if (!entityConfig.parent) rootIds.push(entityConfig.id);
-                return _this._reflectionParser.parseEntity(entityConfig);
-            });
-            return Promise.all(promises).then(function(entities) {
-                for(var i = 0, l = entities.length; i < l; i++){
-                    entitiesMap.set(entitiesConfig[i].id, entities[i]);
-                }
-                return entities;
-            });
-        };
-        _proto._organizeEntities = function _organizeEntities() {
-            var _this_context = this.context, entityConfigMap = _this_context.entityConfigMap, entityMap = _this_context.entityMap, scene = _this_context.scene, rootIds = _this_context.rootIds;
-            for(var _iterator = _create_for_of_iterator_helper_loose(rootIds), _step; !(_step = _iterator()).done;){
-                var rootId = _step.value;
-                PrefabParser.parseChildren(entityConfigMap, entityMap, rootId);
-            }
-            var rootEntities = rootIds.map(function(id) {
-                return entityMap.get(id);
-            });
-            for(var i = 0; i < rootEntities.length; i++){
-                scene.addRootEntity(rootEntities[i]);
-            }
-        };
-        _proto._parseComponents = function _parseComponents() {
-            var entitiesConfig = this.context.originalData.entities;
-            var entityMap = this.context.entityMap;
-            var promises = [];
-            for(var i = 0, l = entitiesConfig.length; i < l; i++){
-                var entityConfig = entitiesConfig[i];
-                var entity = entityMap.get(entityConfig.id);
-                for(var i1 = 0; i1 < entityConfig.components.length; i1++){
-                    var componentConfig = entityConfig.components[i1];
-                    var key = !componentConfig.refId ? componentConfig.class : componentConfig.refId;
-                    var component = void 0;
-                    // TODO: remove hack code when support additional edit
-                    if (key === "Animator") {
-                        component = entity.getComponent(Loader.getClass(key));
-                    }
-                    component = component || entity.addComponent(Loader.getClass(key));
-                    var promise = this._reflectionParser.parsePropsAndMethods(component, componentConfig);
-                    promises.push(promise);
-                }
-            }
-            return Promise.all(promises);
-        };
-        _proto._clearAndResolveScene = function _clearAndResolveScene() {
-            var scene = this.context.scene;
-            this.context.destroy();
-            return scene;
+        _proto.handleRootEntity = function handleRootEntity(id) {
+            var _this_context = this.context, target = _this_context.target, entityMap = _this_context.entityMap;
+            target.addRootEntity(entityMap.get(id));
         };
         /**
        * Parse scene data.
@@ -39036,13 +39281,13 @@
        * @returns a promise of scene
        */ SceneParser.parse = function parse(engine, sceneData) {
             var scene = new Scene(engine);
-            var context = new SceneParserContext(sceneData, scene);
+            var context = new SceneParserContext(sceneData, engine, scene);
             var parser = new SceneParser(context);
             parser.start();
             return parser.promise;
         };
         return SceneParser;
-    }();
+    }(HierarchyParser);
     exports.MeshLoader = /*#__PURE__*/ function(Loader1) {
         var MeshLoader = function MeshLoader() {
             return Loader1.apply(this, arguments);
@@ -39143,7 +39388,7 @@
                     resourceManager // @ts-ignore
                     .getResourceByRef(value).then(function(asset) {
                         keyframe.value = asset;
-                        resolve(keyframe);
+                        resolve(keyframe.value);
                     });
                 });
             } else {
@@ -44431,7 +44676,7 @@
     ], KHR_materials_anisotropy);
 
     //@ts-ignore
-    var version = "1.2.0-alpha.3";
+    var version = "1.2.0-alpha.5";
     console.log("Galacean engine version: " + version);
     for(var key in CoreObjects){
         Loader.registerClass(key, CoreObjects[key]);
@@ -44479,7 +44724,6 @@
     exports.Color = Color;
     exports.ColorOverLifetimeModule = ColorOverLifetimeModule;
     exports.Component = Component;
-    exports.ComponentMap = ComponentMap;
     exports.ConeShape = ConeShape;
     exports.ContentRestorer = ContentRestorer;
     exports.CubeProbe = CubeProbe;
@@ -44523,6 +44767,7 @@
     exports.PBRBaseMaterial = PBRBaseMaterial;
     exports.PBRMaterial = PBRMaterial;
     exports.PBRSpecularMaterial = PBRSpecularMaterial;
+    exports.ParserContext = ParserContext;
     exports.ParticleCompositeCurve = ParticleCompositeCurve;
     exports.ParticleCompositeGradient = ParticleCompositeGradient;
     exports.ParticleCurve = ParticleCurve;