@galacean/effects-core 2.0.0-alpha.16 → 2.0.0-alpha.18

package/dist/index.js

@@ -3,7 +3,7 @@
  * Description: Galacean Effects runtime core for the web
  * Author: Ant Group CO., Ltd.
  * Contributors: 燃然,飂兮,十弦,云垣,茂安,意绮
- * Version: v2.0.0-alpha.16
+ * Version: v2.0.0-alpha.18
  */
 
 'use strict';
@@ -328,7 +328,6 @@ function isSimulatorCellPhone() {
 }
 function isAlipayMiniApp() {
     var _my;
-    // @ts-expect-error
     return typeof my !== 'undefined' && ((_my = my) == null ? void 0 : _my.renderTarget) === 'web';
 }
 
@@ -562,8 +561,8 @@ function noop() {}
  *
  * @static
  * @function isString
- * @param {object} obj - 要判断的对象
- * @return {boolean}
+ * @param obj - 要判断的对象
+ * @return
  */ function isString(obj) {
     return typeof obj === 'string';
 }
@@ -572,8 +571,8 @@ function noop() {}
  *
  * @static
  * @function isArray
- * @param {object} obj - 要判断的对象
- * @return {boolean}
+ * @param obj - 要判断的对象
+ * @return
  */ const isArray = Array.isArray || function(obj) {
     return Object.prototype.toString.call(obj) === '[object Array]';
 };
@@ -582,8 +581,8 @@ function noop() {}
  *
  * @static
  * @function isFunction
- * @param {object} obj - 要判断的对象
- * @return {boolean}
+ * @param obj - 要判断的对象
+ * @return
  */ function isFunction(obj) {
     return Object.prototype.toString.call(obj) === '[object Function]';
 }
@@ -592,8 +591,8 @@ function noop() {}
  *
  * @static
  * @function isObject
- * @param {object} obj - 要判断的对象
- * @return {boolean}
+ * @param obj - 要判断的对象
+ * @return
  */ function isObject(obj) {
     return Object.prototype.toString.call(obj) === '[object Object]';
 }
@@ -602,29 +601,16 @@ function isCanvas(canvas) {
     // 小程序 Canvas 无法使用 instanceof HTMLCanvasElement 判断
     return typeof canvas === 'object' && canvas !== null && ((_canvas_tagName = canvas.tagName) == null ? void 0 : _canvas_tagName.toUpperCase()) === 'CANVAS';
 }
-function deepClone(obj) {
-    if (isArray(obj)) {
-        return obj.map(deepClone);
-    } else if (obj && typeof obj === 'object') {
-        if (ArrayBuffer.isView(obj)) {
-            return obj.slice();
-        }
-        const ret = {};
-        const kas = Object.keys(obj);
-        for(let i = 0; i < kas.length; i++){
-            const key = kas[i];
-            ret[key] = deepClone(obj[key]);
-        }
-        return ret;
-    }
-    return obj;
-}
-// TODO: 改名
-function random(min, max) {
+/**
+ * 生成一个位于 min 和 max 之间的随机数
+ * @param min
+ * @param max
+ * @returns
+ */ function randomInRange(min, max) {
     return min + Math.random() * (max - min);
 }
 function throwDestroyedError() {
-    throw Error('destroyed item cannot be used again');
+    throw new Error('Destroyed item cannot be used again.');
 }
 function generateGUID() {
     return v4().replace(/-/g, '');
@@ -3860,7 +3846,7 @@ var CameraClipMode;
      * 蒙版形状切分
      */ ValueType[ValueType["SHAPE_SPLITS"] = 11] = "SHAPE_SPLITS";
     /**
-     *直线路径
+     * 直线路径
      */ ValueType[ValueType["LINEAR_PATH"] = 12] = "LINEAR_PATH";
     /**
      * 多色
@@ -4036,7 +4022,7 @@ var TextAlignment;
 (function(TextAlignment) {
     /**
      * text alignment starts from（x,y) to right direction
-     * 从(x,y)开始第一个字符，向右边延伸
+     * 从 (x,y) 开始第一个字符，向右边延伸
      */ TextAlignment[TextAlignment["left"] = 0] = "left";
     /**
      * (x,y) is middle position of text, where (left + right)/2 =(x,y)
@@ -4044,7 +4030,7 @@ var TextAlignment;
      */ TextAlignment[TextAlignment["middle"] = 1] = "middle";
     /**
      * text alignment ends with（x,y) from left direction
-     * 从(x,y)结束最后一个字符，向左边延伸
+     * 从 (x,y) 结束最后一个字符，向左边延伸
      */ TextAlignment[TextAlignment["right"] = 2] = "right";
 })(TextAlignment || (TextAlignment = {}));
 /**
@@ -4094,6 +4080,7 @@ var DataType;
     DataType["TimelineAsset"] = "TimelineAsset";
     DataType["TransformPlayableAsset"] = "TransformPlayableAsset";
     DataType["SpriteColorPlayableAsset"] = "SpriteColorPlayableAsset";
+    DataType["BinaryAsset"] = "BinaryAsset";
     // FIXME: 先完成ECS的场景转换，后面移到spec中
     DataType["MeshComponent"] = "MeshComponent";
     DataType["SkyboxComponent"] = "SkyboxComponent";
@@ -4102,6 +4089,7 @@ var DataType;
     DataType["ModelPluginComponent"] = "ModelPluginComponent";
     DataType["TreeComponent"] = "TreeComponent";
     DataType["AnimationComponent"] = "AnimationComponent";
+    DataType["SpineComponent"] = "SpineComponent";
     // Non-EffectObject
     DataType["TimelineClip"] = "TimelineClip";
 })(DataType || (DataType = {}));
@@ -4189,11 +4177,11 @@ var VertexBufferSemantic;
     VertexBufferSemantic["TangentBS3"] = "TANGENT_BS3";
 })(VertexBufferSemantic || (VertexBufferSemantic = {}));
 
-class BuiltinObjectGUID {
-}
-BuiltinObjectGUID.WhiteTexture = 'whitetexture00000000000000000000';
-BuiltinObjectGUID.PBRShader = 'pbr00000000000000000000000000000';
-BuiltinObjectGUID.UnlitShader = 'unlit000000000000000000000000000';
+const BuiltinObjectGUID = {
+    WhiteTexture: 'whitetexture00000000000000000000',
+    PBRShader: 'pbr00000000000000000000000000000',
+    UnlitShader: 'unlit000000000000000000000000000'
+};
 
 var index$1 = /*#__PURE__*/Object.freeze({
     __proto__: null,
@@ -4249,15 +4237,20 @@ var index$1 = /*#__PURE__*/Object.freeze({
     BuiltinObjectGUID: BuiltinObjectGUID
 });
 
-const effectsClassStore = {};
 const decoratorInitialStore = {};
 const mergedStore = {};
-function getDirectStore(target) {
-    const classKey = target.constructor.name;
-    if (!decoratorInitialStore[classKey]) {
-        decoratorInitialStore[classKey] = {};
-    }
-    return decoratorInitialStore[classKey];
+const effectsClassStore = {};
+function effectsClass(className) {
+    return (target, context)=>{
+        if (effectsClassStore[className]) {
+            console.warn(`Class ${className} is already registered.`);
+        }
+        // TODO: three修改json dataType, 这边重复注册直接 return
+        effectsClassStore[className] = target;
+    };
+}
+function serialize(type, sourceName) {
+    return generateSerializableMember(type, sourceName); // value member
 }
 function getMergedStore(target) {
     const classKey = target.constructor.name;
@@ -4282,34 +4275,32 @@ function getMergedStore(target) {
     }
     return store;
 }
-function serialize(type, sourceName) {
-    return generateSerializableMember(type, sourceName); // value member
-}
-function effectsClass(className) {
-    return (target, context)=>{
-        if (effectsClassStore[className]) {
-            console.warn('Class ' + className + ' 重复注册');
-        }
-        //TODO: three修改json dataType, 这边重复注册直接 return
-        effectsClassStore[className] = target;
-    };
-}
 function generateSerializableMember(type, sourceName) {
     return (target, propertyKey)=>{
         const classStore = getDirectStore(target);
         if (!classStore[propertyKey]) {
             classStore[propertyKey] = {
-                type: type,
-                sourceName: sourceName
+                type,
+                sourceName
             };
         }
     };
 }
+function getDirectStore(target) {
+    const classKey = target.constructor.name;
+    if (!decoratorInitialStore[classKey]) {
+        decoratorInitialStore[classKey] = {};
+    }
+    return decoratorInitialStore[classKey];
+}
 
 /**
  * @since 2.0.0
  * @internal
  */ class EffectsObject {
+    static is(obj) {
+        return obj instanceof EffectsObject && 'guid' in obj;
+    }
     getInstanceId() {
         return this.guid;
     }
@@ -4505,6 +4496,7 @@ __decorate([
         super(...args);
         this.started = false;
         this.materials = [];
+        this._priority = 0;
         this._enabled = true;
     }
 }
@@ -7032,8 +7024,8 @@ const SEMANTIC_MAIN_PRE_COLOR_ATTACHMENT_0 = 'PRE_MAIN_COLOR_0';
 const SEMANTIC_MAIN_PRE_COLOR_ATTACHMENT_SIZE_0 = 'PRE_MAIN_COLOR_SIZE_0';
 const PLAYER_OPTIONS_ENV_EDITOR = 'editor';
 const HELP_LINK = {
-    'Filter not imported': 'https://galacean.antgroup.com/effects/#/user/gasrv4ka5sacrwpg',
-    'Item duration can\'t be less than 0': 'https://galacean.antgroup.com/effects/#/user/gasrv4ka5sacrwpg'
+    'Item duration can\'t be less than 0': 'https://galacean.antgroup.com/effects/user/gasrv4ka5sacrwpg#AOnQS',
+    'ValueType: 21/22 is not supported': 'https://galacean.antgroup.com/effects/user/gasrv4ka5sacrwpg#smO1b'
 };
 
 /**
@@ -7214,17 +7206,17 @@ const downgradeKeywords = {
 };
 /**
  * 生成 shader，检测到 WebGL1 上下文会降级
- * @param marcos - 宏定义数组
+ * @param macros - 宏定义数组
  * @param shader - 原始 shader 文本
  * @param shaderType - shader 类型
  * @return 去除版本号的 shader 文本
- */ function createShaderWithMarcos(marcos, shader, shaderType, level) {
+ */ function createShaderWithMacros(macros, shader, shaderType, level) {
     const ret = [];
     let header = '';
     // shader 标志宏，没有其他含义，方便不支持完全的自定义 shader 的三方引擎接入使用
     ret.push('#define GE_RUNTIME');
-    if (marcos) {
-        marcos.forEach(([key, value])=>{
+    if (macros) {
+        macros.forEach(([key, value])=>{
             if (value === true) {
                 ret.push(`#define ${key}`);
             } else if (Number.isFinite(value)) {
@@ -7335,7 +7327,7 @@ function setBlendMode(material, blendMode) {
             ];
             break;
         default:
-            console.warn(`blendMode ${blendMode} not in specification, please set blend params separately`);
+            console.warn(`BlendMode ${blendMode} not in specification, please set blend params separately.`);
     }
 }
 function setSideMode(material, side) {
@@ -7381,7 +7373,7 @@ function setMaskMode(material, maskMode) {
             material.stencilTest = false;
             break;
         default:
-            console.warn(`maskMode ${maskMode} not in specification, please set stencil params seperately`);
+            console.warn(`MaskMode ${maskMode} not in specification, please set stencil params seperately.`);
     }
 }
 
@@ -7553,7 +7545,7 @@ function _loadImage() {
         }
         // 2. 非法类型
         if (!url) {
-            throw new Error(`Invalid url type: ${JSON.stringify(source)}`);
+            throw new Error(`Invalid url type: ${JSON.stringify(source)}.`);
         }
         return new Promise((resolve, reject)=>{
             const img = new Image();
@@ -7666,13 +7658,13 @@ function _loadMedia() {
     return _loadMedia.apply(this, arguments);
 }
 
-function deserializeMipmapTexture(texOpts, bins) {
+function deserializeMipmapTexture(textureOptions, bins, engine) {
     return _deserializeMipmapTexture.apply(this, arguments);
 }
 function _deserializeMipmapTexture() {
-    _deserializeMipmapTexture = _async_to_generator(function*(texOpts, bins, files = [], engine) {
-        if (texOpts.target === 34067) {
-            const { mipmaps, target } = texOpts;
+    _deserializeMipmapTexture = _async_to_generator(function*(textureOptions, bins, engine, files = []) {
+        if (textureOptions.target === 34067) {
+            const { mipmaps, target } = textureOptions;
             // const jobs = mipmaps.map(mipmap => Promise.all(mipmap.map(pointer => loadMipmapImage(pointer, bins))));
             const loadedMipmaps = [];
             for (const level of mipmaps){
@@ -7688,7 +7680,7 @@ function _deserializeMipmapTexture() {
             // const bin = files[mipmaps[0][0][1][0]].url;
             return _extends({
                 keepImageSource: false
-            }, texOpts, {
+            }, textureOptions, {
                 mipmaps: loadedMipmaps,
                 sourceFrom: {
                     target,
@@ -7698,13 +7690,13 @@ function _deserializeMipmapTexture() {
             });
         } else {
             // TODO: 补充测试用例
-            const { mipmaps, target } = texOpts;
+            const { mipmaps, target } = textureOptions;
             const jobs = mipmaps.map((pointer)=>loadMipmapImage(pointer, bins));
             const loadedMipmaps = yield Promise.all(jobs);
             const bin = files[mipmaps[0][1][0]].url;
             return _extends({
                 keepImageSource: false
-            }, texOpts, {
+            }, textureOptions, {
                 mipmaps: loadedMipmaps,
                 sourceType: exports.TextureSourceType.mipmaps,
                 sourceFrom: {
@@ -7729,7 +7721,7 @@ function _loadMipmapImage() {
         const [index, start, length] = pointer[1];
         const bin = bins[index];
         if (!bin) {
-            throw new Error(`invalid bin pointer: ${JSON.stringify(pointer)}`);
+            throw new Error(`Invalid bin pointer: ${JSON.stringify(pointer)}.`);
         }
         return loadImage(new Blob([
             new Uint8Array(bin, start, length)
@@ -7928,7 +7920,7 @@ class KTXTexture {
         // 0xAB, 0x4B, 0x54, 0x58, 0x20, 0x31, 0x31, 0xBB, 0x0D, 0x0A, 0x1A, 0x0A
         const identifier = new Uint8Array(this.arrayBuffer, this.baseOffset, 12);
         if (identifier[0] !== 0xab || identifier[1] !== 0x4b || identifier[2] !== 0x54 || identifier[3] !== 0x58 || identifier[4] !== 0x20 || identifier[5] !== 0x31 || identifier[6] !== 0x31 || identifier[7] !== 0xbb || identifier[8] !== 0x0d || identifier[9] !== 0x0a || identifier[10] !== 0x1a || identifier[11] !== 0x0a) {
-            throw Error('texture missing KTX identifier');
+            throw new Error('Texture missing KTX identifier.');
         }
         // load the reset of the header in native 32 bit uint
         const dataSize = Uint32Array.BYTES_PER_ELEMENT;
@@ -7950,15 +7942,15 @@ class KTXTexture {
         // value of zero is an indication to generate mipmaps @ runtime.  Not usually allowed for compressed, so disregard.
         this.numberOfMipmapLevels = Math.max(1, this.numberOfMipmapLevels);
         if (this.pixelHeight === 0 || this.pixelDepth !== 0) {
-            logger.warn('Only 2D textures currently supported');
+            logger.warn('Only 2D textures currently supported.');
             return;
         }
         if (this.numberOfArrayElements !== 0) {
-            logger.warn('Texture arrays not currently supported');
+            logger.warn('Texture arrays not currently supported.');
             return;
         }
         if (this.numberOfFaces !== facesExpected) {
-            logger.warn('Number of faces expected' + facesExpected + ', but found ' + this.numberOfFaces);
+            logger.warn(`Number of faces expected ${facesExpected}, but found ${this.numberOfFaces}.`);
             return;
         }
         // we now have a completely validated file, so could use existence of loadType as success
@@ -7998,7 +7990,7 @@ class TextureFactory {
                 texture.updateSource(sourceOpts);
                 _this.reloadPending[id] = false;
             } else {
-                throw new Error('No source from');
+                throw new Error('No source from.');
             }
         })();
     }
@@ -8125,7 +8117,7 @@ class TextureFactory {
                     });
                 }
             }
-            throw new Error(`Invalid resource type: ${type}`);
+            throw new Error(`Invalid resource type: ${type}.`);
         })();
     }
     loadMipmapImages(pointers, bin) {
@@ -8941,19 +8933,19 @@ function buildEasingCurve(leftKeyframe, rightKeyframe) {
         y2 = numberToFix((p2.y - p0.y) / valueInterval, 5);
     }
     if (x1 < 0) {
-        console.error('invalid bezier points, x1 < 0', p0, p1, p2, p3);
+        console.error('Invalid bezier points, x1 < 0', p0, p1, p2, p3);
         x1 = 0;
     }
     if (x2 < 0) {
-        console.error('invalid bezier points, x2 < 0', p0, p1, p2, p3);
+        console.error('Invalid bezier points, x2 < 0', p0, p1, p2, p3);
         x2 = 0;
     }
     if (x1 > 1) {
-        console.error('invalid bezier points, x1 >= 1', p0, p1, p2, p3);
+        console.error('Invalid bezier points, x1 >= 1', p0, p1, p2, p3);
         x1 = 1;
     }
     if (x2 > 1) {
-        console.error('invalid bezier points, x2 >= 1', p0, p1, p2, p3);
+        console.error('Invalid bezier points, x2 >= 1', p0, p1, p2, p3);
         x2 = 1;
     }
     const str = ('bez_' + x1 + '_' + y1 + '_' + x2 + '_' + y2).replace(/\./g, 'p');
@@ -9137,31 +9129,31 @@ class ValueGetter {
         return halfFloat ? ret.data : ret;
     }
     onCreate(props) {
-        throw Error(NOT_IMPLEMENT);
+        throw new Error(NOT_IMPLEMENT);
     }
     getIntegrateValue(t0, t1, timeScale = 1) {
-        throw Error(NOT_IMPLEMENT);
+        throw new Error(NOT_IMPLEMENT);
     }
     getIntegrateByTime(t0, time) {
-        throw Error(NOT_IMPLEMENT);
+        throw new Error(NOT_IMPLEMENT);
     }
     getValue(time) {
-        throw Error(NOT_IMPLEMENT);
+        throw new Error(NOT_IMPLEMENT);
     }
     getMaxTime() {
-        throw Error(NOT_IMPLEMENT);
+        throw new Error(NOT_IMPLEMENT);
     }
     toUniform(meta) {
-        throw Error(NOT_IMPLEMENT);
+        throw new Error(NOT_IMPLEMENT);
     }
     map(func) {
-        throw Error(NOT_IMPLEMENT);
+        throw new Error(NOT_IMPLEMENT);
     }
     scaleXCoord(scale) {
         return this;
     }
     toData() {
-        throw Error(NOT_IMPLEMENT);
+        throw new Error(NOT_IMPLEMENT);
     }
     constructor(arg){
         this.onCreate(arg);
@@ -9213,7 +9205,7 @@ class RandomValue extends ValueGetter {
         this.max = props[1];
     }
     getValue(time) {
-        return random(this.min, this.max);
+        return randomInRange(this.min, this.max);
     }
     toUniform() {
         return new Float32Array([
@@ -9793,7 +9785,7 @@ function createValueGetter(args) {
     if (isFunction(map$1[args[0]])) {
         return map$1[args[0]](args[1]);
     } else {
-        throw new Error(`ValueType: ${args[0]} is not support`);
+        throw new Error(`ValueType: ${args[0]} is not supported, see ${HELP_LINK['ValueType: 21/22 is not supported']}.`);
     }
 }
 function lineSegIntegrate(t, t0, t1, y0, y1) {
@@ -9967,7 +9959,7 @@ function createCopyShader(level, writeDepth) {
         vertex: version + '\n' + COPY_VERTEX_SHADER,
         fragment: version + '\n' + COPY_FRAGMENT_SHADER,
         glslVersion: webgl2 ? exports.GLSLVersion.GLSL3 : exports.GLSLVersion.GLSL1,
-        marcos: [
+        macros: [
             [
                 'WEBGL2',
                 !!webgl2
@@ -10031,7 +10023,7 @@ class PassTextureCache {
         const refCount = this.textureRef[id];
         if (refCount <= 1) {
             if (refCount < 0) {
-                console.error('ref count < 0');
+                console.error('Ref count < 0.');
             }
             const tex = this.textureCache[id];
             if (tex) {
@@ -10645,21 +10637,21 @@ let seed$6 = 1;
     }
 }
 
-var blend = "vec4 blendColor(vec4 color,vec4 vc,float mode){vec4 ret=color*vc;\n#ifdef PRE_MULTIPLY_ALPHA\nfloat alpha=vc.a;\n#else\nfloat alpha=ret.a;\n#endif\nif(mode==1.){ret.rgb*=alpha;}else if(mode==2.){ret.rgb*=alpha;ret.a=dot(ret.rgb,vec3(0.33333333));}else if(mode==3.){alpha=color.r*alpha;ret=vec4(vc.rgb*alpha,alpha);}return ret;}";
+var blend = "vec4 blendColor(vec4 color,vec4 vc,float mode){vec4 ret=color*vc;float alpha=ret.a;if(mode==1.){ret.rgb*=alpha;}else if(mode==2.){ret.rgb*=alpha;ret.a=dot(ret.rgb,vec3(0.33333333));}else if(mode==3.){alpha=color.r*alpha;ret=vec4(vc.rgb*alpha,alpha);}return ret;}";
 
 var compatible_frag = "#version 300 es\n#ifdef WEBGL2\n#define texture2D texture\n#define textureCube texture\n#define textureCubeLodEXT textureLod\nlayout(location=0)out vec4 fragColor;\n#else\n#define fragColor gl_FragColor\n#endif\n";
 
 var compatible_vert = "#version 300 es\n#ifdef WEBGL2\n#define texture2D texture\n#else\n#endif\n";
 
-var itemFrameFrag = "#version 300 es\nprecision highp float;\n#version 300 es\n#ifdef WEBGL2\n#define texture2D texture\n#define textureCube texture\n#define textureCubeLodEXT textureLod\nlayout(location=0)out vec4 fragColor;\n#else\n#define fragColor gl_FragColor\n#endif\nvec4 blendColor(vec4 color,vec4 vc,float mode){vec4 ret=color*vc;\n#ifdef PRE_MULTIPLY_ALPHA\nfloat alpha=vc.a;\n#else\nfloat alpha=ret.a;\n#endif\nif(mode==1.){ret.rgb*=alpha;}else if(mode==2.){ret.rgb*=alpha;ret.a=dot(ret.rgb,vec3(0.33333333));}else if(mode==3.){alpha=color.r*alpha;ret=vec4(vc.rgb*alpha,alpha);}return ret;}in vec4 vColor;in vec4 vTexCoord;in highp vec2 vParams;uniform vec3 uFrameColor;void main(){fragColor=vec4(uFrameColor.xyz,1.0);}";
+var itemFrameFrag = "#version 300 es\nprecision highp float;\n#version 300 es\n#ifdef WEBGL2\n#define texture2D texture\n#define textureCube texture\n#define textureCubeLodEXT textureLod\nlayout(location=0)out vec4 fragColor;\n#else\n#define fragColor gl_FragColor\n#endif\nvec4 blendColor(vec4 color,vec4 vc,float mode){vec4 ret=color*vc;float alpha=ret.a;if(mode==1.){ret.rgb*=alpha;}else if(mode==2.){ret.rgb*=alpha;ret.a=dot(ret.rgb,vec3(0.33333333));}else if(mode==3.){alpha=color.r*alpha;ret=vec4(vc.rgb*alpha,alpha);}return ret;}in vec4 vColor;in vec4 vTexCoord;in highp vec2 vParams;uniform vec3 uFrameColor;void main(){fragColor=vec4(uFrameColor.xyz,1.0);}";
 
 var integrate = "float calculateMovement(float t,vec2 p1,vec2 p2,vec2 p3,vec2 p4){float movement=0.0;float h=(t-p1.x)*0.05;for(int i=0;i<=20;i++){float t=float(i)*h;float nt=binarySearchT(t,p1.x,p2.x,p3.x,p4.x);float y=cubicBezier(nt,p1.y,p2.y,p3.y,p4.y);float weight=(i==0||i==20)? 1.0 :(mod(float(i),2.)!=0.)? 4.0 : 2.0;movement+=weight*y;}movement*=h/3.;return movement;}float integrateFromBezierCurveFrames(float time,float frameStart,float frameCount){int start=int(frameStart);int count=int(frameCount-1.);float ret=0.;for(int i=0;i<ITR_END;i+=2){vec4 k0=lookup_curve(i+start);vec4 k1=lookup_curve(i+1+start);if(i==0&&time<k0.x){return ret;}vec2 p1=vec2(k0.x,k0.y);vec2 p2=vec2(k0.z,k0.w);vec2 p3=vec2(k1.z,k1.w);vec2 p4=vec2(k1.x,k1.y);if(time>=k1.x){ret+=calculateMovement(k1.x,p1,p2,p3,p4);}if(time>=k0.x&&time<k1.x){return ret+calculateMovement(time,p1,p2,p3,p4);}}return ret;}float integrateByTimeLineSeg(float t,vec2 p0,vec2 p1){float t0=p0.x;float t1=p1.x;float y0=p0.y;float y1=p1.y;vec4 tSqr=vec4(t,t,t0,t0);tSqr=tSqr*tSqr;vec4 a=vec4(2.*t,3.,-t0,3.)*tSqr;float t1y0=t1*y0;vec4 b=vec4(y0-y1,t0*y1-t1y0,2.*y0+y1,t1y0);float r=dot(a,b);return r/(t0-t1)*0.16666667;}float integrateLineSeg(float time,vec2 p0,vec2 p1){float h=time-p0.x;float y0=p0.y;return(y0+y0+(p1.y-y0)*h/(p1.x-p0.x))*h/2.;}float integrateFromLineSeg(float time,float frameStart,float frameCount){if(time==0.){return 0.;}int start=int(frameStart);int count=int(frameCount-1.);float ret=0.;for(int i=0;i<ITR_END;i++){if(i>count){return ret;}vec4 ks=lookup_curve(i+start);vec2 k0=ks.xy;vec2 k1=ks.zw;if(time>k0.x&&time<=k1.x){return ret+integrateLineSeg(time,k0,k1);}ret+=integrateLineSeg(k1.x,k0,k1);vec2 k2=lookup_curve(i+start+1).xy;if(time>k1.x&&time<=k2.x){return ret+integrateLineSeg(time,k1,k2);}ret+=integrateLineSeg(k2.x,k1,k2);}return ret;}float integrateByTimeFromLineSeg(float time,float frameStart,float frameCount){if(time==0.){return 0.;}int start=int(frameStart);int count=int(frameCount-1.);float ret=0.;for(int i=0;i<ITR_END;i++){if(i>count){return ret;}vec4 ks=lookup_curve(i+start);vec2 k0=ks.xy;vec2 k1=ks.zw;if(time>k0.x&&time<=k1.x){return ret+integrateByTimeLineSeg(time,k0,k1);}ret+=integrateByTimeLineSeg(k1.x,k0,k1);vec2 k2=lookup_curve(i+start+1).xy;if(time>k1.x&&time<=k2.x){return ret+integrateByTimeLineSeg(time,k1,k2);}ret+=integrateByTimeLineSeg(k2.x,k1,k2);}return ret;}float getIntegrateFromTime0(float t1,vec4 value){float type=value.x;if(type==0.){return value.y*t1;}if(type==1.){vec2 p0=vec2(0.,value.y);vec2 p1=vec2(value.w,value.z);return integrateLineSeg(t1,p0,p1);}if(type==3.){return integrateFromLineSeg(t1,value.y,value.z);}if(type==4.){return mix(value.y,value.z,aSeed)*t1;}if(type==5.){return integrateFromBezierCurveFrames(t1,value.z,value.w);}return 0.;}float getIntegrateByTimeFromTime(float t0,float t1,vec4 value){float type=value.x;if(type==0.){return value.y*(t1*t1-t0*t0)/2.;}else if(type==1.){vec2 p0=vec2(0.,value.y);vec2 p1=vec2(value.w,value.z);return integrateByTimeLineSeg(t1,p0,p1)-integrateByTimeLineSeg(t0,p0,p1);}if(type==3.){return integrateByTimeFromLineSeg(t1,value.y,value.z)-integrateByTimeFromLineSeg(t0,value.y,value.z);}if(type==4.){return mix(value.y,value.z,aSeed)*(t1*t1-t0*t0)/2.;}if(type==5.){return integrateFromBezierCurveFrames(t1,value.z,value.w)-integrateFromBezierCurveFrames(t0,value.z,value.w);}return 0.;}";
 
 var itemVert = "precision highp float;attribute vec2 atlasOffset;attribute vec3 aPos;varying vec2 vTexCoord;varying vec3 vParams;varying vec4 vColor;uniform vec2 _Size;uniform vec4 _Color;uniform vec4 _TexParams;uniform vec4 _TexOffset;uniform mat4 effects_MatrixVP;uniform mat4 effects_MatrixInvV;uniform mat4 effects_ObjectToWorld;\n#ifdef ENV_EDITOR\nuniform vec4 uEditorTransform;\n#endif\nvoid main(){vec4 texParams=_TexParams;vTexCoord=vec2(atlasOffset.xy*_TexOffset.zw+_TexOffset.xy);vColor=_Color;vParams=vec3(0.0,texParams.y,texParams.x);vec4 pos=vec4(aPos.xy*_Size,aPos.z,1.0);gl_Position=effects_MatrixVP*effects_ObjectToWorld*pos;\n#ifdef ENV_EDITOR\ngl_Position=vec4(gl_Position.xy*uEditorTransform.xy+uEditorTransform.zw*gl_Position.w,gl_Position.zw);\n#endif\n}";
 
-var itemFrag = "precision highp float;varying vec4 vColor;varying vec2 vTexCoord;varying vec3 vParams;uniform sampler2D uSampler0;vec4 blendColor(vec4 color,vec4 vc,float mode){vec4 ret=color*vc;\n#ifdef PRE_MULTIPLY_ALPHA\nfloat alpha=vc.a;\n#else\nfloat alpha=ret.a;\n#endif\nif(mode==1.){ret.rgb*=alpha;}else if(mode==2.){ret.rgb*=alpha;ret.a=dot(ret.rgb,vec3(0.33333333));}else if(mode==3.){alpha=color.r*alpha;ret=vec4(vc.rgb*alpha,alpha);}return ret;}void main(){vec4 color=vec4(0.);vec4 texColor=texture2D(uSampler0,vTexCoord.xy);color=blendColor(texColor,vColor,floor(0.5+vParams.y));if(vParams.z==0.&&color.a<0.04){discard;}color.a=clamp(color.a,0.0,1.0);gl_FragColor=color;}";
+var itemFrag = "precision highp float;varying vec4 vColor;varying vec2 vTexCoord;varying vec3 vParams;uniform sampler2D uSampler0;vec4 blendColor(vec4 color,vec4 vc,float mode){vec4 ret=color*vc;float alpha=ret.a;if(mode==1.){ret.rgb*=alpha;}else if(mode==2.){ret.rgb*=alpha;ret.a=dot(ret.rgb,vec3(0.33333333));}else if(mode==3.){alpha=color.r*alpha;ret=vec4(vc.rgb*alpha,alpha);}return ret;}void main(){vec4 color=vec4(0.);vec4 texColor=texture2D(uSampler0,vTexCoord.xy);color=blendColor(texColor,vColor,floor(0.5+vParams.y));if(vParams.z==0.&&color.a<0.04){discard;}color.a=clamp(color.a,0.0,1.0);gl_FragColor=color;}";
 
-var particleFrag = "#version 300 es\nprecision mediump float;\n#version 300 es\n#ifdef WEBGL2\n#define texture2D texture\n#define textureCube texture\n#define textureCubeLodEXT textureLod\nlayout(location=0)out vec4 fragColor;\n#else\n#define fragColor gl_FragColor\n#endif\nvec4 blendColor(vec4 color,vec4 vc,float mode){vec4 ret=color*vc;\n#ifdef PRE_MULTIPLY_ALPHA\nfloat alpha=vc.a;\n#else\nfloat alpha=ret.a;\n#endif\nif(mode==1.){ret.rgb*=alpha;}else if(mode==2.){ret.rgb*=alpha;ret.a=dot(ret.rgb,vec3(0.33333333));}else if(mode==3.){alpha=color.r*alpha;ret=vec4(vc.rgb*alpha,alpha);}return ret;}\n#define PATICLE_SHADER 1\nin float vLife;in vec2 vTexCoord;in vec4 vColor;uniform vec3 emissionColor;uniform float emissionIntensity;uniform sampler2D uMaskTex;uniform vec4 uColorParams;uniform vec2 uTexOffset;\n#ifdef COLOR_OVER_LIFETIME\nuniform sampler2D uColorOverLifetime;\n#endif\n#ifdef USE_SPRITE\nin vec4 vTexCoordBlend;\n#endif\nin float vSeed;\n#ifdef PREVIEW_BORDER\nuniform vec4 uPreviewColor;\n#endif\n#ifdef USE_SPRITE\nvec4 getTextureColor(sampler2D tex,vec2 texCoord){if(vTexCoordBlend.w>0.){return mix(texture2D(tex,texCoord),texture2D(tex,vTexCoordBlend.xy+texCoord),vTexCoordBlend.z);}return texture2D(tex,texCoord);}\n#else\n#define getTextureColor texture2D\n#endif\n#ifndef WEBGL2\n#define round(a) floor(0.5+a)\n#endif\n#ifdef PREVIEW_BORDER\nvoid main(){fragColor=uPreviewColor;}\n#else\nvoid main(){vec4 color=vec4(1.0);vec4 tempColor=vColor;vec2 texOffset=uTexOffset;if(vLife<0.){discard;}if(uColorParams.x>0.0){color=getTextureColor(uMaskTex,vTexCoord);}\n#ifdef COLOR_OVER_LIFETIME\n#ifndef ENABLE_VERTEX_TEXTURE\ntempColor*=texture2D(uColorOverLifetime,vec2(vLife,0.));\n#endif\n#endif\ncolor=blendColor(color,tempColor,round(uColorParams.y));if(color.a<=0.01&&uColorParams.w>0.){float _at=texture2D(uMaskTex,vTexCoord+texOffset).a+texture2D(uMaskTex,vTexCoord+texOffset*-1.).a;if(_at<=0.02){discard;}}vec3 emission=emissionColor*pow(2.0,emissionIntensity);color=vec4(pow(pow(color.rgb,vec3(2.2))+emission,vec3(1.0/2.2)),color.a);fragColor=color;}\n#endif\n";
+var particleFrag = "#version 300 es\nprecision mediump float;\n#version 300 es\n#ifdef WEBGL2\n#define texture2D texture\n#define textureCube texture\n#define textureCubeLodEXT textureLod\nlayout(location=0)out vec4 fragColor;\n#else\n#define fragColor gl_FragColor\n#endif\nvec4 blendColor(vec4 color,vec4 vc,float mode){vec4 ret=color*vc;float alpha=ret.a;if(mode==1.){ret.rgb*=alpha;}else if(mode==2.){ret.rgb*=alpha;ret.a=dot(ret.rgb,vec3(0.33333333));}else if(mode==3.){alpha=color.r*alpha;ret=vec4(vc.rgb*alpha,alpha);}return ret;}\n#define PATICLE_SHADER 1\nin float vLife;in vec2 vTexCoord;in vec4 vColor;uniform vec3 emissionColor;uniform float emissionIntensity;uniform sampler2D uMaskTex;uniform vec4 uColorParams;uniform vec2 uTexOffset;\n#ifdef COLOR_OVER_LIFETIME\nuniform sampler2D uColorOverLifetime;\n#endif\n#ifdef USE_SPRITE\nin vec4 vTexCoordBlend;\n#endif\nin float vSeed;\n#ifdef PREVIEW_BORDER\nuniform vec4 uPreviewColor;\n#endif\n#ifdef USE_SPRITE\nvec4 getTextureColor(sampler2D tex,vec2 texCoord){if(vTexCoordBlend.w>0.){return mix(texture2D(tex,texCoord),texture2D(tex,vTexCoordBlend.xy+texCoord),vTexCoordBlend.z);}return texture2D(tex,texCoord);}\n#else\n#define getTextureColor texture2D\n#endif\n#ifndef WEBGL2\n#define round(a) floor(0.5+a)\n#endif\n#ifdef PREVIEW_BORDER\nvoid main(){fragColor=uPreviewColor;}\n#else\nvoid main(){vec4 color=vec4(1.0);vec4 tempColor=vColor;vec2 texOffset=uTexOffset;if(vLife<0.){discard;}if(uColorParams.x>0.0){color=getTextureColor(uMaskTex,vTexCoord);}\n#ifdef COLOR_OVER_LIFETIME\n#ifndef ENABLE_VERTEX_TEXTURE\ntempColor*=texture2D(uColorOverLifetime,vec2(vLife,0.));\n#endif\n#endif\ncolor=blendColor(color,tempColor,round(uColorParams.y));if(color.a<=0.01&&uColorParams.w>0.){float _at=texture2D(uMaskTex,vTexCoord+texOffset).a+texture2D(uMaskTex,vTexCoord+texOffset*-1.).a;if(_at<=0.02){discard;}}vec3 emission=emissionColor*pow(2.0,emissionIntensity);color=vec4(pow(pow(color.rgb,vec3(2.2))+emission,vec3(1.0/2.2)),color.a);fragColor=color;}\n#endif\n";
 
 var particleVert = "#version 300 es\nprecision mediump float;\n#define SHADER_VERTEX 1\n#define PATICLE_SHADER 1\n#version 300 es\n#ifdef WEBGL2\n#define texture2D texture\n#else\n#endif\n#ifdef SHADER_VERTEX\n#define CURVE_VALUE_TEXTURE uVCurveValueTexture\n#define CURVE_VALUE_ARRAY uVCurveValues\n#define CURVE_VALUE_COUNT VERT_CURVE_VALUE_COUNT\n#define FRAG_CURVE_VALUE_COUNT 0\n#else\n#define CURVE_VALUE_TEXTURE uFCurveValueTexture\n#define CURVE_VALUE_ARRAY uFCurveValues\n#define CURVE_VALUE_COUNT FRAG_CURVE_VALUE_COUNT\n#define VERT_CURVE_VALUE_COUNT 0\n#endif\n#if CURVE_VALUE_COUNT > 0\n#if LOOKUP_TEXTURE_CURVE\nuniform sampler2D CURVE_VALUE_TEXTURE;const float uCurveCount=1./float(CURVE_VALUE_COUNT);\n#define lookup_curve(i) texture2D(CURVE_VALUE_TEXTURE,vec2(float(i) * uCurveCount,0.))\n#else\nuniform vec4 CURVE_VALUE_ARRAY[CURVE_VALUE_COUNT];\n#define lookup_curve(i) CURVE_VALUE_ARRAY[i]\n#endif\n#else\n#define lookup_curve(i) vec4(0.)\n#endif\n#ifdef WEBGL2\n#define ITR_END (count + 1)\n#else\n#define ITR_END MAX_C\n#endif\n#define NONE_CONST_INDEX 1\n#ifdef SHADER_VERTEX\nin float aSeed;out float vSeed;\n#endif\n#ifdef SHADER_VERTEX\n#define MAX_C VERT_MAX_KEY_FRAME_COUNT\n#else\n#define MAX_C FRAG_MAX_KEY_FRAME_COUNT\n#endif\nmat4 cubicBezierMatrix=mat4(1.0,-3.0,3.0,-1.0,0.0,3.0,-6.0,3.0,0.0,0.0,3.0,-3.0,0.0,0.0,0.0,1.0);float cubicBezier(float t,float y1,float y2,float y3,float y4){vec4 tVec=vec4(1.0,t,t*t,t*t*t);vec4 yVec=vec4(y1,y2,y3,y4);vec4 result=tVec*cubicBezierMatrix*yVec;return result.x+result.y+result.z+result.w;}float binarySearchT(float x,float x1,float x2,float x3,float x4){float left=0.0;float right=1.0;float mid=0.0;float computedX;for(int i=0;i<8;i++){mid=(left+right)*0.5;computedX=cubicBezier(mid,x1,x2,x3,x4);if(abs(computedX-x)<0.0001){break;}else if(computedX>x){right=mid;}else{left=mid;}}return mid;}float valueFromBezierCurveFrames(float time,float frameStart,float frameCount){int start=int(frameStart);int count=int(frameCount-1.);for(int i=0;i<ITR_END;i+=2){if(i>=count){break;}vec4 k0=lookup_curve(i+start);vec4 k1=lookup_curve(i+1+start);if(i==0&&time<k0.x){return k0.y;}if(i==int(frameCount-2.)&&time>=k1.x){return k1.y;}if(time>=k0.x&&time<=k1.x){float t=(time-k0.x)/(k1.x-k0.x);float nt=binarySearchT(time,k0.x,k0.z,k1.z,k1.x);return cubicBezier(nt,k0.y,k0.w,k1.w,k1.y);}}}float evaluteLineSeg(float t,vec2 p0,vec2 p1){return p0.y+(p1.y-p0.y)*(t-p0.x)/(p1.x-p0.x);}float valueFromLineSegs(float time,float frameStart,float frameCount){int start=int(frameStart);int count=int(frameCount-1.);int end=start+count;for(int i=0;i<ITR_END;i++){if(i>count){return lookup_curve(i).w;}vec4 seg=lookup_curve(i+start);vec2 p0=seg.xy;vec2 p1=seg.zw;if(time>=p0.x&&time<=p1.x){return evaluteLineSeg(time,p0,p1);}vec2 p2=lookup_curve(i+start+1).xy;if(time>p1.x&&time<=p2.x){return evaluteLineSeg(time,p1,p2);}}return lookup_curve(0).y;}float getValueFromTime(float time,vec4 value){float type=value.x;if(type==0.){return value.y;}if(type==1.){return mix(value.y,value.z,time/value.w);}if(type==3.){return valueFromLineSegs(time,value.y,value.z);}if(type==4.){return mix(value.y,value.z,aSeed);}if(type==5.){return valueFromBezierCurveFrames(time,value.z,value.w);}return 0.;}float calculateMovement(float t,vec2 p1,vec2 p2,vec2 p3,vec2 p4){float movement=0.0;float h=(t-p1.x)*0.05;for(int i=0;i<=20;i++){float t=float(i)*h;float nt=binarySearchT(t,p1.x,p2.x,p3.x,p4.x);float y=cubicBezier(nt,p1.y,p2.y,p3.y,p4.y);float weight=(i==0||i==20)? 1.0 :(mod(float(i),2.)!=0.)? 4.0 : 2.0;movement+=weight*y;}movement*=h/3.;return movement;}float integrateFromBezierCurveFrames(float time,float frameStart,float frameCount){int start=int(frameStart);int count=int(frameCount-1.);float ret=0.;for(int i=0;i<ITR_END;i+=2){vec4 k0=lookup_curve(i+start);vec4 k1=lookup_curve(i+1+start);if(i==0&&time<k0.x){return ret;}vec2 p1=vec2(k0.x,k0.y);vec2 p2=vec2(k0.z,k0.w);vec2 p3=vec2(k1.z,k1.w);vec2 p4=vec2(k1.x,k1.y);if(time>=k1.x){ret+=calculateMovement(k1.x,p1,p2,p3,p4);}if(time>=k0.x&&time<k1.x){return ret+calculateMovement(time,p1,p2,p3,p4);}}return ret;}float integrateByTimeLineSeg(float t,vec2 p0,vec2 p1){float t0=p0.x;float t1=p1.x;float y0=p0.y;float y1=p1.y;vec4 tSqr=vec4(t,t,t0,t0);tSqr=tSqr*tSqr;vec4 a=vec4(2.*t,3.,-t0,3.)*tSqr;float t1y0=t1*y0;vec4 b=vec4(y0-y1,t0*y1-t1y0,2.*y0+y1,t1y0);float r=dot(a,b);return r/(t0-t1)*0.16666667;}float integrateLineSeg(float time,vec2 p0,vec2 p1){float h=time-p0.x;float y0=p0.y;return(y0+y0+(p1.y-y0)*h/(p1.x-p0.x))*h/2.;}float integrateFromLineSeg(float time,float frameStart,float frameCount){if(time==0.){return 0.;}int start=int(frameStart);int count=int(frameCount-1.);float ret=0.;for(int i=0;i<ITR_END;i++){if(i>count){return ret;}vec4 ks=lookup_curve(i+start);vec2 k0=ks.xy;vec2 k1=ks.zw;if(time>k0.x&&time<=k1.x){return ret+integrateLineSeg(time,k0,k1);}ret+=integrateLineSeg(k1.x,k0,k1);vec2 k2=lookup_curve(i+start+1).xy;if(time>k1.x&&time<=k2.x){return ret+integrateLineSeg(time,k1,k2);}ret+=integrateLineSeg(k2.x,k1,k2);}return ret;}float integrateByTimeFromLineSeg(float time,float frameStart,float frameCount){if(time==0.){return 0.;}int start=int(frameStart);int count=int(frameCount-1.);float ret=0.;for(int i=0;i<ITR_END;i++){if(i>count){return ret;}vec4 ks=lookup_curve(i+start);vec2 k0=ks.xy;vec2 k1=ks.zw;if(time>k0.x&&time<=k1.x){return ret+integrateByTimeLineSeg(time,k0,k1);}ret+=integrateByTimeLineSeg(k1.x,k0,k1);vec2 k2=lookup_curve(i+start+1).xy;if(time>k1.x&&time<=k2.x){return ret+integrateByTimeLineSeg(time,k1,k2);}ret+=integrateByTimeLineSeg(k2.x,k1,k2);}return ret;}float getIntegrateFromTime0(float t1,vec4 value){float type=value.x;if(type==0.){return value.y*t1;}if(type==1.){vec2 p0=vec2(0.,value.y);vec2 p1=vec2(value.w,value.z);return integrateLineSeg(t1,p0,p1);}if(type==3.){return integrateFromLineSeg(t1,value.y,value.z);}if(type==4.){return mix(value.y,value.z,aSeed)*t1;}if(type==5.){return integrateFromBezierCurveFrames(t1,value.z,value.w);}return 0.;}float getIntegrateByTimeFromTime(float t0,float t1,vec4 value){float type=value.x;if(type==0.){return value.y*(t1*t1-t0*t0)/2.;}else if(type==1.){vec2 p0=vec2(0.,value.y);vec2 p1=vec2(value.w,value.z);return integrateByTimeLineSeg(t1,p0,p1)-integrateByTimeLineSeg(t0,p0,p1);}if(type==3.){return integrateByTimeFromLineSeg(t1,value.y,value.z)-integrateByTimeFromLineSeg(t0,value.y,value.z);}if(type==4.){return mix(value.y,value.z,aSeed)*(t1*t1-t0*t0)/2.;}if(type==5.){return integrateFromBezierCurveFrames(t1,value.z,value.w)-integrateFromBezierCurveFrames(t0,value.z,value.w);}return 0.;}const float d2r=3.141592653589793/180.;in vec3 aPos;in vec4 aOffset;in vec3 aVel;in vec3 aRot;in vec4 aColor;in vec3 aDirX;in vec3 aDirY;\n#ifdef USE_SPRITE\nin vec3 aSprite;uniform vec4 uSprite;struct UVDetail{vec2 uv0;vec3 uv1;};UVDetail getSpriteUV(vec2 uv,float lifeTime);out vec4 vTexCoordBlend;\n#endif\n#ifdef FINAL_TARGET\nuniform vec3 uFinalTarget;uniform vec4 uForceCurve;\n#endif\nuniform mat4 effects_ObjectToWorld;uniform mat4 effects_MatrixV;uniform mat4 effects_MatrixVP;uniform vec4 uParams;uniform vec4 uAcceleration;uniform vec4 uGravityModifierValue;uniform vec4 uOpacityOverLifetimeValue;\n#ifdef ROT_X_LIFETIME\nuniform vec4 uRXByLifeTimeValue;\n#endif\n#ifdef ROT_Y_LIFETIME\nuniform vec4 uRYByLifeTimeValue;\n#endif\n#ifdef ROT_Z_LIFETIME\nuniform vec4 uRZByLifeTimeValue;\n#endif\n#ifdef COLOR_OVER_LIFETIME\nuniform sampler2D uColorOverLifetime;\n#endif\n#if LINEAR_VEL_X + LINEAR_VEL_Y + LINEAR_VEL_Z\n#if LINEAR_VEL_X\nuniform vec4 uLinearXByLifetimeValue;\n#endif\n#if LINEAR_VEL_Y\nuniform vec4 uLinearYByLifetimeValue;\n#endif\n#if LINEAR_VEL_Z\nuniform vec4 uLinearZByLifetimeValue;\n#endif\n#endif\n#ifdef SPEED_OVER_LIFETIME\nuniform vec4 uSpeedLifetimeValue;\n#endif\n#if ORB_VEL_X + ORB_VEL_Y + ORB_VEL_Z\n#if ORB_VEL_X\nuniform vec4 uOrbXByLifetimeValue;\n#endif\n#if ORB_VEL_Y\nuniform vec4 uOrbYByLifetimeValue;\n#endif\n#if ORB_VEL_Z\nuniform vec4 uOrbZByLifetimeValue;\n#endif\nuniform vec3 uOrbCenter;\n#endif\nuniform vec4 uSizeByLifetimeValue;\n#ifdef SIZE_Y_BY_LIFE\nuniform vec4 uSizeYByLifetimeValue;\n#endif\nout float vLife;out vec4 vColor;out vec2 vTexCoord;\n#ifdef ENV_EDITOR\nuniform vec4 uEditorTransform;\n#endif\nvec3 calOrbitalMov(float _life,float _dur){vec3 orb=vec3(0.0);\n#ifdef AS_ORBITAL_MOVEMENT\n#define FUNC(a) getValueFromTime(_life,a)\n#else\n#define FUNC(a) getIntegrateFromTime0(_life,a) * _dur\n#endif\n#if ORB_VEL_X\norb.x=FUNC(uOrbXByLifetimeValue);\n#endif\n#if ORB_VEL_Y\norb.y=FUNC(uOrbYByLifetimeValue);\n#endif\n#if ORB_VEL_Z\norb.z=FUNC(uOrbZByLifetimeValue);\n#endif\n#undef FUNC\nreturn orb;}vec3 calLinearMov(float _life,float _dur){vec3 mov=vec3(0.0);\n#ifdef AS_LINEAR_MOVEMENT\n#define FUNC(a) getValueFromTime(_life,a)\n#else\n#define FUNC(a) getIntegrateFromTime0(_life,a) * _dur\n#endif\n#if LINEAR_VEL_X\nmov.x=FUNC(uLinearXByLifetimeValue);\n#endif\n#if LINEAR_VEL_Y\nmov.y=FUNC(uLinearYByLifetimeValue);\n#endif\n#if LINEAR_VEL_Z\nmov.z=FUNC(uLinearZByLifetimeValue);\n#endif\n#undef FUNC\nreturn mov;}mat3 mat3FromRotation(vec3 rotation){vec3 sinR=sin(rotation*d2r);vec3 cosR=cos(rotation*d2r);return mat3(cosR.z,-sinR.z,0.,sinR.z,cosR.z,0.,0.,0.,1.)*mat3(cosR.y,0.,sinR.y,0.,1.,0.,-sinR.y,0,cosR.y)*mat3(1.,0.,0.,0,cosR.x,-sinR.x,0.,sinR.x,cosR.x);}\n#ifdef USE_SPRITE\nUVDetail getSpriteUV(vec2 uv,float lifeTime){float t=fract(clamp((lifeTime-aSprite.x)/aSprite.y,0.0,1.)*aSprite.z);float frame=uSprite.z*t;float frameIndex=max(ceil(frame)-1.,0.);float row=floor((frameIndex+0.1)/uSprite.x);float col=frameIndex-row*uSprite.x;vec2 retUV=(vec2(col,row)+uv)/uSprite.xy;UVDetail ret;if(uSprite.w>0.){float blend=frame-frameIndex;float frameIndex1=min(ceil(frame),uSprite.z-1.);float row1=floor((frameIndex1+0.1)/uSprite.x);float col1=frameIndex1-row1*uSprite.x;vec2 coord=(vec2(col1,row1)+uv)/uSprite.xy-retUV;ret.uv1=vec3(coord.x,1.-coord.y,blend);}ret.uv0=vec2(retUV.x,1.-retUV.y);return ret;}\n#endif\nvec3 calculateTranslation(vec3 vel,float t0,float t1,float dur){float dt=t1-t0;float d=getIntegrateByTimeFromTime(0.,dt,uGravityModifierValue);vec3 acc=uAcceleration.xyz*d;\n#ifdef SPEED_OVER_LIFETIME\nreturn vel*getIntegrateFromTime0(dt/dur,uSpeedLifetimeValue)*dur+acc;\n#endif\nreturn vel*dt+acc;}mat3 transformFromRotation(vec3 rot,float _life,float _dur){vec3 rotation=rot;\n#ifdef ROT_LIFETIME_AS_MOVEMENT\n#define FUNC1(a) getValueFromTime(_life,a)\n#else\n#define FUNC1(a) getIntegrateFromTime0(_life,a) * _dur\n#endif\n#ifdef ROT_X_LIFETIME\nrotation.x+=FUNC1(uRXByLifeTimeValue);\n#endif\n#ifdef ROT_Y_LIFETIME\nrotation.y+=FUNC1(uRYByLifeTimeValue);\n#endif\n#ifdef ROT_Z_LIFETIME\nrotation.z+=FUNC1(uRZByLifeTimeValue);\n#endif\nif(dot(rotation,rotation)==0.0){return mat3(1.0);}\n#undef FUNC1\nreturn mat3FromRotation(rotation);}void main(){float time=uParams.x-aOffset.z;float dur=aOffset.w;if(time<0.||time>dur){gl_Position=vec4(-3.,-3.,-3.,1.);}else{float life=clamp(time/dur,0.0,1.0);vLife=life;\n#ifdef USE_SPRITE\nUVDetail uvD=getSpriteUV(aOffset.xy,time);vTexCoord=uvD.uv0;vTexCoordBlend=vec4(uvD.uv1,uSprite.w);\n#else\nvTexCoord=aOffset.xy;\n#endif\nvColor=aColor;\n#ifdef COLOR_OVER_LIFETIME\n#ifdef ENABLE_VERTEX_TEXTURE\nvColor*=texture2D(uColorOverLifetime,vec2(life,0.));\n#endif\n#endif\nvColor.a*=clamp(getValueFromTime(life,uOpacityOverLifetimeValue),0.,1.);vec3 size=vec3(vec2(getValueFromTime(life,uSizeByLifetimeValue)),1.0);\n#ifdef SIZE_Y_BY_LIFE\nsize.y=getValueFromTime(life,uSizeYByLifetimeValue);\n#endif\nvec3 point=transformFromRotation(aRot,life,dur)*(aDirX*size.x+aDirY*size.y);vec3 pt=calculateTranslation(aVel,aOffset.z,uParams.x,dur);vec3 _pos=aPos+pt;\n#if ORB_VEL_X + ORB_VEL_Y + ORB_VEL_Z\n_pos=mat3FromRotation(calOrbitalMov(life,dur))*(_pos-uOrbCenter);_pos+=uOrbCenter;\n#endif\n#if LINEAR_VEL_X + LINEAR_VEL_Y + LINEAR_VEL_Z\n_pos.xyz+=calLinearMov(life,dur);\n#endif\n#ifdef FINAL_TARGET\nfloat force=getValueFromTime(life,uForceCurve);vec4 pos=vec4(mix(_pos,uFinalTarget,force),1.);\n#else\nvec4 pos=vec4(_pos,1.0);\n#endif\n#if RENDER_MODE == 1\npos.xyz+=point;pos=effects_ObjectToWorld*pos;\n#elif RENDER_MODE == 3\npos=effects_ObjectToWorld*pos;pos.xyz+=effects_MatrixV[0].xyz*point.x+effects_MatrixV[2].xyz*point.y;\n#elif RENDER_MODE == 2\npos=effects_ObjectToWorld*pos;pos.xy+=point.xy;\n#elif RENDER_MODE == 0\npos=effects_ObjectToWorld*pos;pos.xyz+=effects_MatrixV[0].xyz*point.x+effects_MatrixV[1].xyz*point.y;\n#endif\ngl_Position=effects_MatrixVP*pos;vSeed=aSeed;gl_PointSize=6.0;\n#ifdef ENV_EDITOR\ngl_Position=vec4(gl_Position.xy*uEditorTransform.xy+uEditorTransform.zw*gl_Position.w,gl_Position.zw);\n#endif\n}}";
 
@@ -11806,20 +11798,20 @@ class GPUCapability {
     framebufferTexture2D(gl, target, index, textarget, texture) {
         const ext = this.drawBufferExtension;
         if (this.level === 1 && !ext && index > 0) {
-            throw new Error('draw multiple color buffers not available');
+            throw new Error('Draw multiple color buffers not available.');
         }
         const attachment = ext ? ext[`COLOR_ATTACHMENT${index}_WEBGL`] : gl[`COLOR_ATTACHMENT${index}`];
         if (attachment) {
             gl.framebufferTexture2D(target, attachment, textarget, texture, 0);
         } else {
-            console.error('invalid color attachment index: ' + index);
+            console.error(`Invalid color attachment index: ${index}.`);
         }
     }
     drawBuffers(gl, bufferStates) {
         const ext = this.drawBufferExtension;
         if (this.level === 1 && !ext) {
             if (bufferStates.length > 1) {
-                throw Error('draw buffers not available');
+                throw new Error('Draw buffers not available.');
             } else {
                 return;
             }
@@ -12079,7 +12071,7 @@ class InteractMesh {
     }
     createMaterial(rendererOptions) {
         var _this_engine_renderer;
-        const marcos = [
+        const macros = [
             [
                 'ENV_EDITOR',
                 ((_this_engine_renderer = this.engine.renderer) == null ? void 0 : _this_engine_renderer.env) === PLAYER_OPTIONS_ENV_EDITOR
@@ -12092,7 +12084,7 @@ class InteractMesh {
                 fragment,
                 glslVersion: exports.GLSLVersion.GLSL1,
                 cacheId: `${rendererOptions.cachePrefix}_effects_interact`,
-                marcos
+                macros
             },
             uniformSemantics: {
                 effects_MatrixVP: 'VIEWPROJECTION',
@@ -12357,16 +12349,12 @@ function shouldIgnoreBouncing(arg, mul) {
 }
 
 exports.maxSpriteMeshItemCount = 8;
-exports.maxSpriteTextureCount = 8;
 function setSpriteMeshMaxItemCountByGPU(gpuCapability) {
-    // 8 or 16
-    exports.maxSpriteTextureCount = Math.min(gpuCapability.maxFragmentTextures, 16);
     if (gpuCapability.maxVertexUniforms >= 256) {
         return exports.maxSpriteMeshItemCount = 32;
     } else if (gpuCapability.maxVertexUniforms >= 128) {
         return exports.maxSpriteMeshItemCount = 16;
     }
-    exports.maxSpriteTextureCount = 8;
 }
 function getImageItemRenderInfo(item) {
     const { renderer } = item;
@@ -12384,27 +12372,11 @@ function getImageItemRenderInfo(item) {
     };
 }
 function spriteMeshShaderFromFilter(level, options) {
-    const { count = 2, env = '', ignoreBlend, wireframe } = options != null ? options : {};
-    const marcos = [
-        [
-            'MAX_ITEM_COUNT',
-            count
-        ],
-        [
-            'PRE_MULTIPLY_ALPHA',
-            false
-        ],
+    const { env = '', wireframe } = options != null ? options : {};
+    const macros = [
         [
             'ENV_EDITOR',
             env === PLAYER_OPTIONS_ENV_EDITOR
-        ],
-        [
-            'USE_BLEND',
-            !ignoreBlend
-        ],
-        [
-            'MAX_FRAG_TEX',
-            exports.maxSpriteTextureCount >= 16 ? 16 : 8
         ]
     ];
     const fragment = wireframe ? itemFrameFrag : itemFrag;
@@ -12413,7 +12385,7 @@ function spriteMeshShaderFromFilter(level, options) {
         fragment,
         vertex,
         glslVersion: level === 1 ? exports.GLSLVersion.GLSL1 : exports.GLSLVersion.GLSL3,
-        marcos,
+        macros,
         shared: true
     };
 }
@@ -12423,7 +12395,6 @@ function spriteMeshShaderIdFromRenderInfo(renderInfo, count) {
 function spriteMeshShaderFromRenderInfo(renderInfo, count, level, env) {
     const { wireframe } = renderInfo;
     const shader = spriteMeshShaderFromFilter(level, {
-        count,
         wireframe,
         env
     });
@@ -12437,9 +12408,6 @@ function spriteMeshShaderFromRenderInfo(renderInfo, count, level, env) {
 function setMaxSpriteMeshItemCount(count) {
     exports.maxSpriteMeshItemCount = count;
 }
-function setSpriteMeshMaxFragmentTextures(count) {
-    exports.maxSpriteTextureCount = count;
-}
 
 const defRenderInfo = {
     blending: 0,
@@ -13783,7 +13751,7 @@ class Cone {
         // dir + [0,0,1]
         dir.z += 1;
         return {
-            position: position.multiply(random(0, 1)),
+            position: position.multiply(randomInRange(0, 1)),
             direction: dir.normalize()
         };
     }
@@ -13795,7 +13763,7 @@ class Cone {
 }
 function getArcAngle(arc, arcMode, opt) {
     if (arcMode === ShapeArcMode.RANDOM) {
-        arc = random(0, arc);
+        arc = randomInRange(0, arc);
     } else if (arcMode === ShapeArcMode.UNIDIRECTIONAL_CYCLE) {
         const d = opt.index % (opt.total + 1);
         arc = arc / opt.total * d;
@@ -13827,8 +13795,8 @@ class Circle {
 }
 class Rectangle {
     generate(opt) {
-        const x = random(-this._d, this._d);
-        const y = random(-this._h, this._h);
+        const x = randomInRange(-this._d, this._d);
+        const y = randomInRange(-this._h, this._h);
         return {
             direction: new Vector3(0, 0, 1),
             position: new Vector3(x, y, 0)
@@ -13873,7 +13841,7 @@ class RectangleEdge {
 }
 class Edge {
     generate(options) {
-        const x = this.arcMode === ShapeArcMode.UNIFORM_BURST ? options.burstIndex % options.burstCount / (options.burstCount - 1) : random(0, 1);
+        const x = this.arcMode === ShapeArcMode.UNIFORM_BURST ? options.burstIndex % options.burstCount / (options.burstCount - 1) : randomInRange(0, 1);
         return {
             direction: new Vector3(0, 1, 0),
             position: new Vector3(this._d * (x - 0.5), 0, 0)
@@ -13891,7 +13859,7 @@ class Donut {
     generate(opt) {
         const dradius = this.donutRadius;
         const center = this.radius - dradius;
-        const angle = random(0, Math.PI * 2);
+        const angle = randomInRange(0, Math.PI * 2);
         const arc = getArcAngle(this.arc, this.arcMode, opt) * DEG2RAD;
         const rot = tempMat4$2.setFromRotationZ(arc);
         const direction = new Vector3(Math.cos(angle), Math.sin(angle), 0);
@@ -13911,7 +13879,7 @@ class Donut {
 const tempMat4$1 = new Matrix4();
 class Sphere {
     getHorizontalAngle() {
-        return random(-90, 90);
+        return randomInRange(-90, 90);
     }
     generate(opt) {
         const rz = getArcAngle(this.arc, this.arcMode, opt) * DEG2RAD;
@@ -13933,7 +13901,7 @@ class Sphere {
 }
 class Hemisphere extends Sphere {
     getHorizontalAngle() {
-        return random(0, 90);
+        return randomInRange(0, 90);
     }
 }
 
@@ -14003,7 +13971,7 @@ function createShape(shapeOptions) {
     const { type } = shapeOptions;
     const Ctrl = map[type];
     if (!Ctrl) {
-        throw Error('invalid shape:' + type);
+        throw new Error(`Invalid shape: ${type}.`);
     }
     const ctrl = new Ctrl(options);
     if (type !== ShapeType.NONE) {
@@ -14972,7 +14940,7 @@ class TrailMesh {
         const uniformValues = {};
         // const lookUpTexture = getConfig(RENDER_PREFER_LOOKUP_TEXTURE) ? 1 : 0;
         const lookUpTexture = 0;
-        const marcos = [
+        const macros = [
             [
                 'ENABLE_VERTEX_TEXTURE',
                 enableVertexTexture
@@ -14989,7 +14957,7 @@ class TrailMesh {
         const useAttributeTrailStart = maxTrailCount > 64;
         let shaderCacheId = 0;
         if (colorOverLifetime) {
-            marcos.push([
+            macros.push([
                 'COLOR_OVER_LIFETIME',
                 true
             ]);
@@ -14997,7 +14965,7 @@ class TrailMesh {
             uniformValues.uColorOverLifetime = Texture.createWithData(engine, imageDataFromGradient(colorOverLifetime));
         }
         if (colorOverTrail) {
-            marcos.push([
+            macros.push([
                 'COLOR_OVER_TRAIL',
                 true
             ]);
@@ -15005,7 +14973,7 @@ class TrailMesh {
             uniformValues.uColorOverTrail = Texture.createWithData(engine, imageDataFromGradient(colorOverTrail));
         }
         if (useAttributeTrailStart) {
-            marcos.push([
+            macros.push([
                 'ATTR_TRAIL_START',
                 1
             ]);
@@ -15015,7 +14983,7 @@ class TrailMesh {
         }
         uniformValues.uOpacityOverLifetimeValue = opacityOverLifetime.toUniform(keyFrameMeta);
         const uWidthOverTrail = widthOverTrail.toUniform(keyFrameMeta);
-        marcos.push([
+        macros.push([
             'VERT_CURVE_VALUE_COUNT',
             keyFrameMeta.index
         ], [
@@ -15034,7 +15002,7 @@ class TrailMesh {
             shader: {
                 vertex,
                 fragment,
-                marcos,
+                macros,
                 glslVersion: level === 1 ? exports.GLSLVersion.GLSL1 : exports.GLSLVersion.GLSL3,
                 shared: true,
                 name: `trail#${name}`,
@@ -15189,11 +15157,11 @@ function calculateDirection(prePoint, point, nextPoint) {
     }
     return dir.normalize().toArray();
 }
-function getTrailMeshShader(trails, particleMaxCount, name, env = '', gpuCapability) {
+function getTrailMeshShader(trails, particleMaxCount, name, gpuCapability, env = '') {
     let shaderCacheId = 0;
     const lookUpTexture = getConfig(RENDER_PREFER_LOOKUP_TEXTURE) ? 1 : 0;
     const enableVertexTexture = gpuCapability.detail.maxVertexTextures > 0;
-    const marcos = [
+    const macros = [
         [
             'ENABLE_VERTEX_TEXTURE',
             enableVertexTexture
@@ -15209,14 +15177,14 @@ function getTrailMeshShader(trails, particleMaxCount, name, env = '', gpuCapabil
     ];
     const keyFrameMeta = createKeyFrameMeta();
     if (trails.colorOverLifetime) {
-        marcos.push([
+        macros.push([
             'COLOR_OVER_LIFETIME',
             true
         ]);
         shaderCacheId |= 1;
     }
     if (trails.colorOverTrail) {
-        marcos.push([
+        macros.push([
             'COLOR_OVER_TRAIL',
             true
         ]);
@@ -15224,7 +15192,7 @@ function getTrailMeshShader(trails, particleMaxCount, name, env = '', gpuCapabil
     }
     const useAttributeTrailStart = particleMaxCount > 64;
     if (useAttributeTrailStart) {
-        marcos.push([
+        macros.push([
             'ATTR_TRAIL_START',
             1
         ]);
@@ -15232,7 +15200,7 @@ function getTrailMeshShader(trails, particleMaxCount, name, env = '', gpuCapabil
     }
     getKeyFrameMetaByRawValue(keyFrameMeta, trails.opacityOverLifetime);
     getKeyFrameMetaByRawValue(keyFrameMeta, trails.widthOverTrail);
-    marcos.push([
+    macros.push([
         'VERT_CURVE_VALUE_COUNT',
         keyFrameMeta.index
     ], [
@@ -15242,7 +15210,7 @@ function getTrailMeshShader(trails, particleMaxCount, name, env = '', gpuCapabil
     return {
         vertex: trailVert,
         fragment: particleFrag,
-        marcos,
+        macros,
         shared: true,
         name: 'trail#' + name,
         cacheId: `-t:+${shaderCacheId}+${keyFrameMeta.index}+${keyFrameMeta.max}`
@@ -15929,11 +15897,9 @@ class ParticleSystem extends Component {
         this.props = props;
         this.destroyed = false;
         const cachePrefix = '';
-        const options = props.options;
-        const positionOverLifetime = props.positionOverLifetime;
-        const shape = props.shape;
-        const gravityModifier = positionOverLifetime.gravityOverLifetime;
-        const gravity = ensureVec3(positionOverLifetime.gravity);
+        const { options, positionOverLifetime = {}, shape } = props;
+        const gravityModifier = positionOverLifetime == null ? void 0 : positionOverLifetime.gravityOverLifetime;
+        const gravity = ensureVec3(positionOverLifetime == null ? void 0 : positionOverLifetime.gravity);
         const _textureSheetAnimation = props.textureSheetAnimation;
         const textureSheetAnimation = _textureSheetAnimation ? {
             animationDelay: createValueGetter(_textureSheetAnimation.animationDelay || 0),
@@ -15944,7 +15910,7 @@ class ParticleSystem extends Component {
             row: _textureSheetAnimation.row,
             total: _textureSheetAnimation.total || _textureSheetAnimation.col * _textureSheetAnimation.row
         } : undefined;
-        const startTurbulence = !!(shape && shape.turbulenceX || shape.turbulenceY || shape.turbulenceZ);
+        const startTurbulence = !!(shape && shape.turbulenceX || (shape == null ? void 0 : shape.turbulenceY) || (shape == null ? void 0 : shape.turbulenceZ));
         let turbulence;
         if (startTurbulence) {
             var _shape_turbulenceX, _shape_turbulenceY, _shape_turbulenceZ;
@@ -15975,7 +15941,7 @@ class ParticleSystem extends Component {
             }
         }
         let forceTarget;
-        if (positionOverLifetime.forceTarget) {
+        if (positionOverLifetime == null ? void 0 : positionOverLifetime.forceTarget) {
             forceTarget = {
                 target: positionOverLifetime.target || [
                     0,
@@ -16555,15 +16521,12 @@ class ParticleMesh {
         const { speedOverLifetime, colorOverLifetime, linearVelOverLifetime, orbitalVelOverLifetime, sizeOverLifetime, rotationOverLifetime, sprite, gravityModifier, maxCount, textureFlip, useSprite, name, gravity, forceTarget, side, occlusion, anchor, blending, maskMode, mask, transparentOcclusion, meshSlots, renderMode = 0, diffuse = Texture.createWithData(engine) } = props;
         const { detail } = engine.gpuCapability;
         const { halfFloatTexture, maxVertexUniforms } = detail;
-        const marcos = [
+        const macros = [
+            // spec.RenderMode
             [
                 'RENDER_MODE',
                 +renderMode
             ],
-            [
-                'PRE_MULTIPLY_ALPHA',
-                false
-            ],
             [
                 'ENV_EDITOR',
                 env === PLAYER_OPTIONS_ENV_EDITOR
@@ -16579,13 +16542,13 @@ class ParticleMesh {
         let useOrbitalVel;
         this.useSprite = useSprite;
         if (enableVertexTexture) {
-            marcos.push([
+            macros.push([
                 'ENABLE_VERTEX_TEXTURE',
                 true
             ]);
         }
         if (speedOverLifetime) {
-            marcos.push([
+            macros.push([
                 'SPEED_OVER_LIFETIME',
                 true
             ]);
@@ -16593,7 +16556,7 @@ class ParticleMesh {
             uniformValues.uSpeedLifetimeValue = speedOverLifetime.toUniform(vertexKeyFrameMeta);
         }
         if (sprite == null ? void 0 : sprite.animate) {
-            marcos.push([
+            macros.push([
                 'USE_SPRITE',
                 true
             ]);
@@ -16607,7 +16570,7 @@ class ParticleMesh {
             this.useSprite = true;
         }
         if (colorOverLifetime == null ? void 0 : colorOverLifetime.color) {
-            marcos.push([
+            macros.push([
                 'COLOR_OVER_LIFETIME',
                 true
             ]);
@@ -16632,7 +16595,7 @@ class ParticleMesh {
                 shaderCacheId |= 1 << 7 + i;
                 linearVelOverLifetime.enabled = true;
             }
-            marcos.push([
+            macros.push([
                 `LINEAR_VEL_${pro.toUpperCase()}`,
                 defL
             ]);
@@ -16643,13 +16606,13 @@ class ParticleMesh {
                 useOrbitalVel = true;
                 orbitalVelOverLifetime.enabled = true;
             }
-            marcos.push([
+            macros.push([
                 `ORB_VEL_${pro.toUpperCase()}`,
                 defO
             ]);
         });
         if (linearVelOverLifetime == null ? void 0 : linearVelOverLifetime.asMovement) {
-            marcos.push([
+            macros.push([
                 'AS_LINEAR_MOVEMENT',
                 true
             ]);
@@ -16657,7 +16620,7 @@ class ParticleMesh {
         }
         if (useOrbitalVel) {
             if (orbitalVelOverLifetime == null ? void 0 : orbitalVelOverLifetime.asRotation) {
-                marcos.push([
+                macros.push([
                     'AS_ORBITAL_MOVEMENT',
                     true
                 ]);
@@ -16672,7 +16635,7 @@ class ParticleMesh {
         uniformValues.uSizeByLifetimeValue = sizeOverLifetime == null ? void 0 : sizeOverLifetime.x.toUniform(vertexKeyFrameMeta);
         if (sizeOverLifetime == null ? void 0 : sizeOverLifetime.separateAxes) {
             var _sizeOverLifetime_y;
-            marcos.push([
+            macros.push([
                 'SIZE_Y_BY_LIFE',
                 1
             ]);
@@ -16682,7 +16645,7 @@ class ParticleMesh {
         if (rotationOverLifetime == null ? void 0 : rotationOverLifetime.z) {
             uniformValues.uRZByLifeTimeValue = rotationOverLifetime.z.toUniform(vertexKeyFrameMeta);
             shaderCacheId |= 1 << 15;
-            marcos.push([
+            macros.push([
                 'ROT_Z_LIFETIME',
                 1
             ]);
@@ -16690,7 +16653,7 @@ class ParticleMesh {
         if (rotationOverLifetime == null ? void 0 : rotationOverLifetime.x) {
             uniformValues.uRXByLifeTimeValue = rotationOverLifetime.x.toUniform(vertexKeyFrameMeta);
             shaderCacheId |= 1 << 16;
-            marcos.push([
+            macros.push([
                 'ROT_X_LIFETIME',
                 1
             ]);
@@ -16698,13 +16661,13 @@ class ParticleMesh {
         if (rotationOverLifetime == null ? void 0 : rotationOverLifetime.y) {
             uniformValues.uRYByLifeTimeValue = rotationOverLifetime.y.toUniform(vertexKeyFrameMeta);
             shaderCacheId |= 1 << 17;
-            marcos.push([
+            macros.push([
                 'ROT_Y_LIFETIME',
                 1
             ]);
         }
         if (rotationOverLifetime == null ? void 0 : rotationOverLifetime.asRotation) {
-            marcos.push([
+            macros.push([
                 'ROT_LIFETIME_AS_MOVEMENT',
                 1
             ]);
@@ -16712,7 +16675,7 @@ class ParticleMesh {
         }
         uniformValues.uGravityModifierValue = gravityModifier.toUniform(vertexKeyFrameMeta);
         if (forceTarget) {
-            marcos.push([
+            macros.push([
                 'FINAL_TARGET',
                 true
             ]);
@@ -16758,7 +16721,7 @@ class ParticleMesh {
             fragmentKeyFrameMeta.index,
             fragmentKeyFrameMeta.max
         ].join('+');
-        marcos.push([
+        macros.push([
             'VERT_CURVE_VALUE_COUNT',
             vertexKeyFrameMeta.index
         ], [
@@ -16780,7 +16743,7 @@ class ParticleMesh {
             glslVersion: level === 1 ? exports.GLSLVersion.GLSL1 : exports.GLSLVersion.GLSL3,
             shared: true,
             cacheId: shaderCache,
-            marcos,
+            macros,
             name: `particle#${name}`
         };
         const mtlOptions = {
@@ -16857,7 +16820,7 @@ class ParticleMesh {
                     res.length = 0;
                     break;
                 default:
-                    console.warn(`uniform ${name}'s type not in typeMap`);
+                    console.warn(`Uniform ${name}'s type not in typeMap.`);
             }
         });
         material.setVector3('emissionColor', new Vector3(0, 0, 0));
@@ -16988,19 +16951,15 @@ function generateGeometryProps(maxVertex, useSprite, name) {
         maxVertex
     };
 }
-function getParticleMeshShader(item, env = '', gpuCapability) {
+function getParticleMeshShader(item, gpuCapability, env = '') {
     var _props_renderer;
     const props = item.content;
     const renderMode = +(((_props_renderer = props.renderer) == null ? void 0 : _props_renderer.renderMode) || 0);
-    const marcos = [
+    const macros = [
         [
             'RENDER_MODE',
             renderMode
         ],
-        [
-            'PRE_MULTIPLY_ALPHA',
-            false
-        ],
         [
             'ENV_EDITOR',
             env === PLAYER_OPTIONS_ENV_EDITOR
@@ -17015,13 +16974,13 @@ function getParticleMeshShader(item, env = '', gpuCapability) {
     let vertex_lookup_texture = 0;
     let shaderCacheId = 0;
     if (enableVertexTexture) {
-        marcos.push([
+        macros.push([
             'ENABLE_VERTEX_TEXTURE',
             true
         ]);
     }
     if (speedOverLifetime) {
-        marcos.push([
+        macros.push([
             'SPEED_OVER_LIFETIME',
             true
         ]);
@@ -17030,7 +16989,7 @@ function getParticleMeshShader(item, env = '', gpuCapability) {
     }
     const sprite = props.textureSheetAnimation;
     if (sprite && sprite.animate) {
-        marcos.push([
+        macros.push([
             'USE_SPRITE',
             true
         ]);
@@ -17038,7 +16997,7 @@ function getParticleMeshShader(item, env = '', gpuCapability) {
     }
     const colorOverLifetime = props.colorOverLifetime;
     if (colorOverLifetime && colorOverLifetime.color) {
-        marcos.push([
+        macros.push([
             'COLOR_OVER_LIFETIME',
             true
         ]);
@@ -17063,7 +17022,7 @@ function getParticleMeshShader(item, env = '', gpuCapability) {
             defL = 1;
             shaderCacheId |= 1 << 7 + i;
         }
-        marcos.push([
+        macros.push([
             `LINEAR_VEL_${pro.toUpperCase()}`,
             defL
         ]);
@@ -17074,13 +17033,13 @@ function getParticleMeshShader(item, env = '', gpuCapability) {
             shaderCacheId |= 1 << 10 + i;
             useOrbitalVel = true;
         }
-        marcos.push([
+        macros.push([
             `ORB_VEL_${pro.toUpperCase()}`,
             defO
         ]);
     });
     if (positionOverLifetime == null ? void 0 : positionOverLifetime.asMovement) {
-        marcos.push([
+        macros.push([
             'AS_LINEAR_MOVEMENT',
             true
         ]);
@@ -17088,7 +17047,7 @@ function getParticleMeshShader(item, env = '', gpuCapability) {
     }
     if (useOrbitalVel) {
         if (positionOverLifetime == null ? void 0 : positionOverLifetime.asRotation) {
-            marcos.push([
+            macros.push([
                 'AS_ORBITAL_MOVEMENT',
                 true
             ]);
@@ -17100,7 +17059,7 @@ function getParticleMeshShader(item, env = '', gpuCapability) {
         const separateAxes = sizeOverLifetime.separateAxes;
         if (separateAxes) {
             getKeyFrameMetaByRawValue(vertexKeyFrameMeta, sizeOverLifetime.x);
-            marcos.push([
+            macros.push([
                 'SIZE_Y_BY_LIFE',
                 1
             ]);
@@ -17115,7 +17074,7 @@ function getParticleMeshShader(item, env = '', gpuCapability) {
         if (rot.z) {
             getKeyFrameMetaByRawValue(vertexKeyFrameMeta, rot == null ? void 0 : rot.z);
             shaderCacheId |= 1 << 15;
-            marcos.push([
+            macros.push([
                 'ROT_Z_LIFETIME',
                 1
             ]);
@@ -17124,7 +17083,7 @@ function getParticleMeshShader(item, env = '', gpuCapability) {
             if (rot.x) {
                 getKeyFrameMetaByRawValue(vertexKeyFrameMeta, rot.x);
                 shaderCacheId |= 1 << 16;
-                marcos.push([
+                macros.push([
                     'ROT_X_LIFETIME',
                     1
                 ]);
@@ -17132,14 +17091,14 @@ function getParticleMeshShader(item, env = '', gpuCapability) {
             if (rot.y) {
                 getKeyFrameMetaByRawValue(vertexKeyFrameMeta, rot.y);
                 shaderCacheId |= 1 << 17;
-                marcos.push([
+                macros.push([
                     'ROT_Y_LIFETIME',
                     1
                 ]);
             }
         }
         if (rot == null ? void 0 : rot.asRotation) {
-            marcos.push([
+            macros.push([
                 'ROT_LIFETIME_AS_MOVEMENT',
                 1
             ]);
@@ -17149,7 +17108,7 @@ function getParticleMeshShader(item, env = '', gpuCapability) {
     getKeyFrameMetaByRawValue(vertexKeyFrameMeta, positionOverLifetime == null ? void 0 : positionOverLifetime.gravityOverLifetime);
     const forceOpt = positionOverLifetime == null ? void 0 : positionOverLifetime.forceTarget;
     if (forceOpt) {
-        marcos.push([
+        macros.push([
             'FINAL_TARGET',
             true
         ]);
@@ -17190,10 +17149,10 @@ function getParticleMeshShader(item, env = '', gpuCapability) {
         vertex: `#define LOOKUP_TEXTURE_CURVE ${vertex_lookup_texture}\n${particleVert}`,
         shared: true,
         cacheId: shaderCache,
-        marcos,
+        macros,
         name: `particle#${item.name}`
     };
-    marcos.push([
+    macros.push([
         'VERT_CURVE_VALUE_COUNT',
         vertexKeyFrameMeta.index
     ], [
@@ -17218,11 +17177,11 @@ function modifyMaxKeyframeShader(shader, maxVertex, maxFrag) {
     shaderIds[3] = maxVertex;
     shaderIds[5] = maxFrag;
     shader.cacheId = shaderIds.join('+');
-    if (!shader.marcos) {
+    if (!shader.macros) {
         return;
     }
-    for(let i = 0; i < shader.marcos.length; i++){
-        const marco = shader.marcos[i];
+    for(let i = 0; i < shader.macros.length; i++){
+        const marco = shader.macros[i];
         if (marco[0] === 'VERT_CURVE_VALUE_COUNT') {
             marco[1] = maxVertex;
         } else if (marco[0] === 'FRAG_CURVE_VALUE_COUNT') {
@@ -17251,17 +17210,17 @@ class ParticleLoader extends AbstractPlugin {
             });
         });
         items.forEach((item)=>{
-            const { shader, fragment, vertex } = getParticleMeshShader(item, env, gpuCapability);
+            const { shader, fragment, vertex } = getParticleMeshShader(item, gpuCapability, env);
             shaders.push(shader);
             maxFragmentCount = Math.max(maxFragmentCount, fragment);
             maxVertexCount = Math.max(maxVertexCount, vertex);
             // TODO 此处add是否有意义？shader变量似乎没有加到this.shaders数组。
             if (item.content.trails) {
-                const shader = getTrailMeshShader(item.content.trails, item.content.options.maxCount, item.name, env, gpuCapability);
-                var _shader_marcos;
-                shader.vertex = createShaderWithMarcos((_shader_marcos = shader.marcos) != null ? _shader_marcos : [], shader.vertex, exports.ShaderType.vertex, level);
-                var _shader_marcos1;
-                shader.fragment = createShaderWithMarcos((_shader_marcos1 = shader.marcos) != null ? _shader_marcos1 : [], shader.fragment, exports.ShaderType.fragment, level);
+                const shader = getTrailMeshShader(item.content.trails, item.content.options.maxCount, item.name, gpuCapability, env);
+                var _shader_macros;
+                shader.vertex = createShaderWithMacros((_shader_macros = shader.macros) != null ? _shader_macros : [], shader.vertex, exports.ShaderType.vertex, level);
+                var _shader_macros1;
+                shader.fragment = createShaderWithMacros((_shader_macros1 = shader.macros) != null ? _shader_macros1 : [], shader.fragment, exports.ShaderType.fragment, level);
                 shader.glslVersion = level === 2 ? exports.GLSLVersion.GLSL3 : exports.GLSLVersion.GLSL1;
                 shaderLibrary.addShader(shader);
             }
@@ -17273,10 +17232,10 @@ class ParticleLoader extends AbstractPlugin {
             } else {
                 shader.glslVersion = exports.GLSLVersion.GLSL1;
             }
-            var _shader_marcos;
-            shader.vertex = createShaderWithMarcos((_shader_marcos = shader.marcos) != null ? _shader_marcos : [], shader.vertex, exports.ShaderType.vertex, level);
-            var _shader_marcos1;
-            shader.fragment = createShaderWithMarcos((_shader_marcos1 = shader.marcos) != null ? _shader_marcos1 : [], shader.fragment, exports.ShaderType.fragment, level);
+            var _shader_macros;
+            shader.vertex = createShaderWithMacros((_shader_macros = shader.macros) != null ? _shader_macros : [], shader.vertex, exports.ShaderType.vertex, level);
+            var _shader_macros1;
+            shader.fragment = createShaderWithMacros((_shader_macros1 = shader.macros) != null ? _shader_macros1 : [], shader.fragment, exports.ShaderType.fragment, level);
             shaderLibrary.addShader(shader);
         });
         if (level === 2) {
@@ -17594,6 +17553,27 @@ class AnimationClipPlayable extends Playable {
     }
 }
 
+/**
+ * @since 2.0.0
+ * @internal
+ */ class TimelineClip {
+    toLocalTime(time) {
+        let localTime = time - this.start;
+        const duration = this.duration;
+        if (localTime - duration > 0.001) {
+            if (this.endBehaviour === ItemEndBehavior.loop) {
+                localTime = localTime % duration;
+            } else if (this.endBehaviour === ItemEndBehavior.freeze) {
+                localTime = Math.min(duration, localTime);
+            }
+        }
+        return localTime;
+    }
+    constructor(){
+        this.start = 0;
+        this.duration = 0;
+    }
+}
 class TrackAsset extends PlayableAsset {
     /**
    * 重写该方法以获取自定义对象绑定
@@ -17674,7 +17654,7 @@ class TrackAsset extends PlayableAsset {
     }
 }
 __decorate([
-    serialize('TimelineClip')
+    serialize(TimelineClip)
 ], TrackAsset.prototype, "clips", void 0);
 __decorate([
     serialize()
@@ -17687,27 +17667,6 @@ exports.TrackType = void 0;
     TrackType[TrackType["MasterTrack"] = 0] = "MasterTrack";
     TrackType[TrackType["ObjectTrack"] = 1] = "ObjectTrack";
 })(exports.TrackType || (exports.TrackType = {}));
-class TimelineClip {
-    toLocalTime(time) {
-        let localTime = time - this.start;
-        const duration = this.duration;
-        if (localTime - duration > 0.001) {
-            if (this.endBehaviour === ItemEndBehavior.loop) {
-                localTime = localTime % duration;
-            } else if (this.endBehaviour === ItemEndBehavior.freeze) {
-                localTime = Math.min(duration, localTime);
-            }
-        }
-        return localTime;
-    }
-    constructor(){
-        this.start = 0;
-        this.duration = 0;
-    }
-}
-TimelineClip = __decorate([
-    effectsClass('TimelineClip')
-], TimelineClip);
 class RuntimeClip {
     set enable(value) {
         if (value) {
@@ -17782,10 +17741,6 @@ class ObjectBindingTrack extends TrackAsset {
             particleClip.endBehaviour = boundItem.endBehavior;
         }
     }
-    fromData(data) {
-        super.fromData(data);
-        this.data = data;
-    }
 }
 ObjectBindingTrack = __decorate([
     effectsClass('ObjectBindingTrack')
@@ -17971,7 +17926,6 @@ function compareTracks(a, b) {
         this.startTime = startTime;
         this.resolveBindings();
         this.timelinePlayable = this.timelineAsset.createPlayable(this.graph);
-        this.timelinePlayable.play();
         // 重播不销毁元素
         if (this.item.endBehavior !== ItemEndBehavior.destroy) {
             this.setReusable(true);
@@ -18027,7 +17981,7 @@ function compareTracks(a, b) {
                     const refId = itemData.content.options.refId;
                     const props = this.item.composition.refCompositionProps.get(refId);
                     if (!props) {
-                        throw new Error(`引用的Id: ${refId} 的预合成不存在`);
+                        throw new Error(`Referenced precomposition with Id: ${refId} does not exist.`);
                     }
                     // endBehaviour 类型需优化
                     props.content = itemData.content;
@@ -18171,7 +18125,7 @@ function compareTracks(a, b) {
 class SubCompositionTrack extends TrackAsset {
     resolveBinding(parentBinding) {
         if (!(parentBinding instanceof VFXItem)) {
-            throw new Error('SubCompositionTrack needs to be set under the VFXItem track');
+            throw new Error('SubCompositionTrack needs to be set under the VFXItem track.');
         }
         return parentBinding.getComponent(CompositionComponent);
     }
@@ -18355,7 +18309,6 @@ class CanvasPool {
             return this.elements.shift();
         }
         if (getConfig(TEMPLATE_USE_OFFSCREEN_CANVAS)) {
-            // @ts-expect-error
             return window._createOffscreenCanvas(10, 10);
         } else {
             // in hongmeng system, create too many canvas will case render error
@@ -19179,7 +19132,6 @@ class VFXItem extends EffectsObject {
         this.parentId = parentId;
         this.duration = duration;
         this.endBehavior = endBehavior;
-        this.renderOrder = listIndex;
         //@ts-expect-error
         this.oldId = data.oldId;
         if (!data.content) {
@@ -19188,19 +19140,13 @@ class VFXItem extends EffectsObject {
             };
         }
         if (duration <= 0) {
-            throw Error(`Item duration can't be less than 0, see ${HELP_LINK['Item duration can\'t be less than 0']}`);
-        }
-        if (data.components) {
-            for (const component of data.components){
-                const newComponent = component;
-                this.components.push(newComponent);
-                if (newComponent instanceof RendererComponent) {
-                    this.rendererComponents.push(newComponent);
-                } else if (newComponent instanceof ItemBehaviour) {
-                    this.itemBehaviours.push(newComponent);
-                }
-            }
+            throw new Error(`Item duration can't be less than 0, see ${HELP_LINK['Item duration can\'t be less than 0']}.`);
+        }
+        for (const component of this.components){
+            component.onAttached();
         }
+        // renderOrder 在 component 初始化后设置。确保能拿到 rendererComponent。
+        this.renderOrder = listIndex;
     }
     toData() {
         var _this_parent;
@@ -19295,6 +19241,7 @@ class VFXItem extends EffectsObject {
         /**
    * 元素动画的速度
    */ this.speed = 1;
+        this.listIndex = 0;
         this.name = 'VFXItem';
         this.transform.name = this.name;
         this.transform.engine = engine;
@@ -19303,6 +19250,9 @@ class VFXItem extends EffectsObject {
         }
     }
 }
+__decorate([
+    serialize()
+], VFXItem.prototype, "components", void 0);
 VFXItem = __decorate([
     effectsClass(DataType.VFXItemData)
 ], VFXItem);
@@ -19356,7 +19306,7 @@ exports.Item = void 0;
                 pluginName = 'tree';
                 break;
             default:
-                throw new Error('invalid vfx item type');
+                throw new Error('Invalid vfx item type.');
         }
     }
     return composition.pluginSystem.createPluginItem(pluginName, props, composition);
@@ -19397,13 +19347,13 @@ class PluginSystem {
     createPluginItem(name, props, composition) {
         const CTRL = pluginCtrlMap[name];
         if (!CTRL) {
-            throw new Error(`plugin ${name} no registered constructor`);
+            throw new Error(`The plugin '${name}' does not have a registered constructor.`);
         }
         const engine = composition.getEngine();
         const item = new CTRL(engine, props, composition);
         item.composition = composition;
         if (!(item instanceof VFXItem)) {
-            throw new Error(`plugin ${name} invalid constructor type`);
+            throw new Error(`The plugin '${name}' invalid constructor type.`);
         }
         return item;
     }
@@ -19456,7 +19406,7 @@ class PluginSystem {
         this.plugins = Object.keys(loaders).map((name)=>{
             const CTRL = pluginLoaderMap[name];
             if (!CTRL) {
-                throw new Error(`plugin '${name}' not found.` + getPluginUsageInfo(name));
+                throw new Error(`The plugin '${name}' not found.` + getPluginUsageInfo(name));
             }
             const loader = new CTRL();
             loader.name = name;
@@ -19498,20 +19448,20 @@ class SerializationHelper {
             if (value === undefined) {
                 value = effectsObject[key];
             }
-            if (value instanceof EffectsObject) {
-                this.collectSerializableObject(value, res);
-            } else if (value instanceof Array) {
+            if (EffectsObject.is(value)) {
+                SerializationHelper.collectSerializableObject(value, res);
+            } else if (isArray(value)) {
                 for (const arrayValue of value){
-                    if (arrayValue instanceof EffectsObject) {
-                        this.collectSerializableObject(arrayValue, res);
+                    if (EffectsObject.is(arrayValue)) {
+                        SerializationHelper.collectSerializableObject(arrayValue, res);
                     }
                 }
-            } else if (value instanceof Object) {
+            } else if (isObject(value)) {
                 // 非 EffectsObject 对象只递归一层
                 for (const objectKey of Object.keys(value)){
                     const objectValue = value[objectKey];
-                    if (objectValue instanceof EffectsObject) {
-                        this.collectSerializableObject(objectValue, res);
+                    if (EffectsObject.is(objectValue)) {
+                        SerializationHelper.collectSerializableObject(objectValue, res);
                     }
                 }
             }
@@ -19546,17 +19496,17 @@ class SerializationHelper {
             if (typeof value === 'number' || typeof value === 'string' || typeof value === 'boolean' || SerializationHelper.checkTypedArray(value)) {
                 // TODO json 数据避免传 typedArray
                 serializedData[key] = value;
-            } else if (value instanceof Array) {
+            } else if (isArray(value)) {
                 if (!serializedData[key]) {
                     serializedData[key] = [];
                 }
                 SerializationHelper.serializeArrayProperty(value, serializedData[key], 0);
-            } else if (value instanceof EffectsObject) {
+            } else if (EffectsObject.is(value)) {
                 // TODO 处理 EffectsObject 递归序列化
                 serializedData[key] = {
                     id: value.getInstanceId()
                 };
-            } else if (value instanceof Object) {
+            } else if (isObject(value)) {
                 if (!serializedData[key]) {
                     serializedData[key] = {};
                 }
@@ -19569,17 +19519,17 @@ class SerializationHelper {
             if (typeof value === 'number' || typeof value === 'string' || typeof value === 'boolean' || SerializationHelper.checkTypedArray(value)) {
                 // TODO json 数据避免传 typedArray
                 serializedData[key] = value;
-            } else if (value instanceof Array) {
+            } else if (isArray(value)) {
                 if (!serializedData[key]) {
                     serializedData[key] = [];
                 }
                 SerializationHelper.serializeArrayProperty(value, serializedData[key], 0);
-            } else if (value instanceof EffectsObject) {
+            } else if (EffectsObject.is(value)) {
                 // TODO 处理 EffectsObject 递归序列化
                 serializedData[key] = {
                     id: value.getInstanceId()
                 };
-            } else if (value instanceof Object) {
+            } else if (isObject(value)) {
                 if (!serializedData[key]) {
                     serializedData[key] = {};
                 }
@@ -19639,24 +19589,24 @@ class SerializationHelper {
     static checkTypedArray(obj) {
         return obj instanceof Int8Array || obj instanceof Uint8Array || obj instanceof Uint8ClampedArray || obj instanceof Int16Array || obj instanceof Uint16Array || obj instanceof Int32Array || obj instanceof Uint32Array || obj instanceof Float32Array || obj instanceof Float64Array || obj instanceof ArrayBuffer;
     }
+    // check value is { id: 7e69662e964e4892ae8933f24562395b }
     static checkDataPath(value) {
-        // check value is { id: 7e69662e964e4892ae8933f24562395b }
-        return value instanceof Object && Object.keys(value).length === 1 && value.id && value.id.length === 32;
+        return !!(isObject(value) && Object.keys(value).length === 1 && 'id' in value && isString(value.id) && value.id.length === 32);
     }
     // TODO 测试函数，2.0 上线后移除
     static checkGLTFNode(value) {
-        return value instanceof Object && value.nodeIndex !== undefined && value.isJoint !== undefined;
+        return isObject(value) && value.nodeIndex !== undefined && value.isJoint !== undefined;
     }
     static checkImageSource(value) {
         return isCanvas(value) || value instanceof HTMLImageElement;
     }
     static deserializeProperty(property, engine, level, type) {
         if (level > 14) {
-            console.error('序列化数据的内嵌对象层数大于上限');
+            console.error('The nested object layers of the serialized data exceed the maximum limit.');
             return;
         }
         // 加载并链接 DataPath 字段表示的 EffectsObject 引用。Class 对象 copy [key, value] 会丢失对象信息，因此只递归数组对象和普通 js Object 结构对象。
-        if (property instanceof Array) {
+        if (isArray(property)) {
             const res = [];
             for (const value of property){
                 res.push(SerializationHelper.deserializeProperty(value, engine, level + 1, type));
@@ -19665,16 +19615,14 @@ class SerializationHelper {
         // TODO json 数据避免传 typedArray
         } else if (SerializationHelper.checkDataPath(property)) {
             return engine.assetLoader.loadGUID(property.id);
-        } else if (property instanceof Object && property.constructor === Object) {
+        } else if (isObject(property) && property.constructor === Object) {
             let res;
             if (type) {
-                const classConstructor = effectsClassStore[type];
-                res = new classConstructor();
+                res = new type();
             } else {
                 res = {};
             }
             for (const key of Object.keys(property)){
-                // @ts-expect-error
                 res[key] = SerializationHelper.deserializeProperty(property[key], engine, level + 1);
             }
             return res;
@@ -19685,10 +19633,10 @@ class SerializationHelper {
     static deserializePropertyAsync(property, engine, level, type) {
         return _async_to_generator(function*() {
             if (level > 14) {
-                console.error('序列化数据的内嵌对象层数大于上限');
+                console.error('The nested object layers of the serialized data exceed the maximum limit.');
                 return;
             }
-            if (property instanceof Array) {
+            if (isArray(property)) {
                 const res = [];
                 for (const value of property){
                     res.push((yield SerializationHelper.deserializePropertyAsync(value, engine, level + 1, type)));
@@ -19698,16 +19646,14 @@ class SerializationHelper {
             } else if (SerializationHelper.checkDataPath(property)) {
                 const res = yield engine.assetLoader.loadGUIDAsync(property.id);
                 return res;
-            } else if (property instanceof Object && property.constructor === Object) {
+            } else if (isObject(property) && property.constructor === Object) {
                 let res;
                 if (type) {
-                    const classConstructor = effectsClassStore[type];
-                    res = new classConstructor();
+                    res = new type();
                 } else {
                     res = {};
                 }
                 for (const key of Object.keys(property)){
-                    // @ts-expect-error
                     res[key] = SerializationHelper.deserializeProperty(property[key], engine, level + 1);
                 }
                 return res;
@@ -19718,7 +19664,7 @@ class SerializationHelper {
     }
     static serializeObjectProperty(objectProperty, serializedData, level) {
         if (level > 14) {
-            console.error('序列化数据的内嵌对象层数大于上限');
+            console.error('The nested object layers of the serialized data exceed the maximum limit.');
             return;
         }
         if (!serializedData) {
@@ -19729,17 +19675,17 @@ class SerializationHelper {
             if (typeof value === 'number' || typeof value === 'string' || typeof value === 'boolean' || SerializationHelper.checkTypedArray(objectProperty)) {
                 // TODO json 数据避免传 typedArray
                 serializedData[key] = value;
-            } else if (value instanceof Array) {
+            } else if (isArray(value)) {
                 if (!serializedData[key]) {
                     serializedData[key] = [];
                 }
                 SerializationHelper.serializeArrayProperty(value, serializedData[key], level + 1);
-            } else if (value instanceof EffectsObject) {
+            } else if (EffectsObject.is(value)) {
                 // TODO 处理 EffectsObject 递归序列化
                 serializedData[key] = {
                     id: value.getInstanceId()
                 };
-            } else if (value instanceof Object) {
+            } else if (isObject(value)) {
                 if (!serializedData[key]) {
                     serializedData[key] = {};
                 }
@@ -19749,7 +19695,7 @@ class SerializationHelper {
     }
     static serializeArrayProperty(arrayProperty, serializedData, level) {
         if (level > 14) {
-            console.error('序列化数据的内嵌对象层数大于上限');
+            console.error('The nested object layers of the serialized data exceed the maximum limit.');
             return;
         }
         if (!serializedData) {
@@ -19760,17 +19706,17 @@ class SerializationHelper {
             if (typeof value === 'number' || typeof value === 'string' || typeof value === 'boolean' || SerializationHelper.checkTypedArray(arrayProperty)) {
                 // TODO json 数据避免传 typedArray
                 serializedData[i] = value;
-            } else if (value instanceof Array) {
+            } else if (isArray(value)) {
                 if (!serializedData[i]) {
                     serializedData[i] = [];
                 }
-                this.serializeArrayProperty(value, serializedData[i], level + 1);
-            } else if (value instanceof EffectsObject) {
+                SerializationHelper.serializeArrayProperty(value, serializedData[i], level + 1);
+            } else if (EffectsObject.is(value)) {
                 // TODO 处理 EffectsObject 递归序列化
                 serializedData[i] = {
                     id: value.getInstanceId()
                 };
-            } else if (value instanceof Object) {
+            } else if (isObject(value)) {
                 if (!serializedData[i]) {
                     serializedData[i] = {};
                 }
@@ -19791,7 +19737,7 @@ class SerializationHelper {
         let effectsObject;
         const effectsObjectData = this.findData(guid);
         if (!effectsObjectData) {
-            console.error('未找到 uuid: ' + guid + '的对象数据');
+            console.error(`Object data with uuid: ${guid} not found.`);
             return undefined;
         }
         switch(effectsObjectData.dataType){
@@ -19813,7 +19759,7 @@ class SerializationHelper {
                 }
         }
         if (!effectsObject) {
-            console.error('未找到 DataType: ' + effectsObjectData.dataType + '的构造函数');
+            console.error(`Constructor for DataType: ${effectsObjectData.dataType} not found.`);
             return undefined;
         }
         effectsObject.setInstanceId(effectsObjectData.id);
@@ -19832,12 +19778,12 @@ class SerializationHelper {
             const effectsObjectData = _this.findData(guid);
             if (!effectsObjectData) {
                 if (!_this.engine.database) {
-                    console.error('未找到 uuid: ' + guid + '的对象数据');
+                    console.error(`Object data with uuid: ${guid} not found.`);
                     return undefined;
                 }
                 effectsObject = yield _this.engine.database.loadGUID(guid);
                 if (!effectsObject) {
-                    console.error('未找到 uuid: ' + guid + '的磁盘数据');
+                    console.error(`Disk data with uuid: ${guid} not found.`);
                     return undefined;
                 }
                 _this.engine.addInstance(effectsObject);
@@ -19862,7 +19808,7 @@ class SerializationHelper {
                     }
             }
             if (!effectsObject) {
-                console.error('未找到 DataType: ' + effectsObjectData.dataType + '的构造函数');
+                console.error(`Constructor for DataType: ${effectsObjectData.dataType} not found.`);
                 return undefined;
             }
             effectsObject.setInstanceId(effectsObjectData.id);
@@ -20701,8 +20647,6 @@ function getStandardCameraContent(model) {
 /**
  * 3.0 以下版本数据适配（runtime 2.0及以上版本支持）
  */ function version30Migration(json) {
-    var // 更正 spine 数据中的 images 属性
-    _json_spines;
     var // 兼容老版本数据中不存在textures的情况
     _result;
     const result = _extends({}, json, {
@@ -20712,7 +20656,8 @@ function getStandardCameraContent(model) {
         materials: [],
         shaders: [],
         geometries: [],
-        animations: []
+        animations: [],
+        miscs: []
     });
     // image数据添加 guid
     for (const image of result.images){
@@ -20741,17 +20686,10 @@ function getStandardCameraContent(model) {
             });
         }
     }
-    (_json_spines = json.spines) == null ? void 0 : _json_spines.forEach((spine)=>{
-        for(let i = 0; i < spine.images.length; i++){
-            var _json_textures_spine_images_i;
-            //@ts-expect-error
-            const textureId = (_json_textures_spine_images_i = json.textures[spine.images[i]]) == null ? void 0 : _json_textures_spine_images_i.id;
-            //@ts-expect-error
-            spine.images[i] = {
-                id: textureId
-            };
-        }
-    });
+    // 处理老版本数据中 bins 没有 id 的情况
+    if (json.bins) {
+        convertBinaryAsset(json.bins, result);
+    }
     const itemOldIdToGuidMap = {};
     const guidToItemMap = {};
     // 更正Composition.endBehavior
@@ -20972,6 +20910,10 @@ function getStandardCameraContent(model) {
             //@ts-expect-error
             item.type = 'orientation-transformer';
         }
+        // Spine 元素转为 guid 索引
+        if (item.type === ItemType.spine && json.spines && json.spines.length !== 0) {
+            convertSpineData(json.spines[item.content.options.spine], item.content, result);
+        }
         // item 的 content 转为 component data 加入 JSONScene.components
         if (item.type === ItemType.sprite || item.type === ItemType.particle || item.type === ItemType.mesh || item.type === ItemType.skybox || item.type === ItemType.light || item.type === 'camera' || item.type === ItemType.tree || item.type === ItemType.interact || item.type === ItemType.camera || item.type === ItemType.text || item.type === ItemType.spine || item.type === 'editor-gizmo' || item.type === 'orientation-transformer') {
             item.components = [];
@@ -21215,27 +21157,55 @@ function convertTimelineAsset(composition, guidToItemMap, jsonScene) {
         id: timelineAssetData.id
     };
     composition.sceneBindings = sceneBindings;
-    if (!jsonScene.animations) {
-        jsonScene.animations = [];
-    }
-    // @ts-expect-error
-    jsonScene.animations.push(timelineAssetData);
+    jsonScene.miscs.push(timelineAssetData);
     for (const trackData of trackDatas){
         //@ts-expect-error
-        jsonScene.animations.push(trackData);
+        jsonScene.miscs.push(trackData);
     }
     for (const playableAsset of playableAssetDatas){
         //@ts-expect-error
-        jsonScene.animations.push(playableAsset);
+        jsonScene.miscs.push(playableAsset);
     }
 }
+function convertBinaryAsset(bins, jsonScene) {
+    //@ts-expect-error
+    jsonScene.bins = bins.map((bin)=>({
+            url: bin.url,
+            'dataType': 'BinaryAsset',
+            id: generateGUID()
+        }));
+}
+function convertSpineData(resource, content, jsonScene) {
+    //@ts-expect-error
+    content.resource = {
+        'atlas': {
+            'bins': {
+                //@ts-expect-error
+                'id': jsonScene.bins[resource.atlas[1][0]].id
+            },
+            'source': resource.atlas[1].slice(1)
+        },
+        'skeleton': {
+            'bins': {
+                //@ts-expect-error
+                'id': jsonScene.bins[resource.skeleton[1][0]].id
+            },
+            'source': resource.skeleton[1].slice(1)
+        },
+        'skeletonType': resource.skeletonType,
+        'images': resource.images.map((i)=>({
+                //@ts-expect-error
+                id: jsonScene.textures[i].id
+            }))
+    };
+}
 
 const v0 = /^(\d+)\.(\d+)\.(\d+)(-(\w+)\.\d+)?$/;
 const standardVersion = /^(\d+)\.(\d+)$/;
 let reverseParticle = false;
 function getStandardJSON(json) {
     if (!json || typeof json !== 'object') {
-        throw Error('expect a json object');
+        throw new Error('Invalid input: Expected a JSON object.');
     }
     // 修正老版本数据中，meshItem 以及 lightItem 结束行为错误问题
     version22Migration(json);
@@ -21256,7 +21226,7 @@ function getStandardJSON(json) {
         }
         return json;
     }
-    throw Error('invalid json version ' + json.version);
+    throw new Error(`Invalid JSON version: ${json.version}.`);
 }
 let currentVersion = '1.0';
 function getStandardJSONFromV0(json) {
@@ -21342,7 +21312,7 @@ function getStandardImage(image, index, imageTags) {
     } else if (image && image.sourceType) {
         return image;
     }
-    throw Error('invalid image type');
+    throw new Error('Invalid image type.');
 }
 function getStandardComposition(composition, opt = {}) {
     var _composition_meta;
@@ -21609,7 +21579,7 @@ function _combineImageTemplate() {
             image = url;
         }
         if (!image) {
-            throw new Error('image not provided.');
+            throw new Error('Image not provided.');
         }
         if (!template) {
             return image;
@@ -21683,7 +21653,7 @@ let seed = 1;
                     cancelLoading = true;
                     _this.removeTimer(loadTimer);
                     const totalTime = performance.now() - startTime;
-                    reject(new Error(`Load time out: totalTime: ${totalTime.toFixed(4)}ms ${timeInfos.join(' ')}, url: ${assetUrl}`));
+                    reject(new Error(`Load time out: totalTime: ${totalTime.toFixed(4)}ms ${timeInfos.join(' ')}, url: ${assetUrl}.`));
                 }, _this.timeout * 1000);
                 _this.timers.push(loadTimer);
             });
@@ -21695,7 +21665,7 @@ let seed = 1;
                         timeInfos.push(`[${label}: ${(performance.now() - st).toFixed(2)}]`);
                         return result;
                     } catch (e) {
-                        throw new Error(`Load error in ${label}, ${e}`);
+                        throw new Error(`Load error in ${label}, ${e}.`);
                     }
                 }
                 throw new Error('Load canceled.');
@@ -21766,7 +21736,7 @@ let seed = 1;
                     yield hookTimeInfo('processPlugins', ()=>pluginSystem.loadResources(scene, _this.options));
                 }
                 const totalTime = performance.now() - startTime;
-                logger.info(`Load asset: totalTime: ${totalTime.toFixed(4)}ms ${timeInfos.join(' ')}, url: ${assetUrl}`);
+                logger.info(`Load asset: totalTime: ${totalTime.toFixed(4)}ms ${timeInfos.join(' ')}, url: ${assetUrl}.`);
                 window.clearTimeout(loadTimer);
                 _this.removeTimer(loadTimer);
                 scene.totalTime = totalTime;
@@ -21787,7 +21757,7 @@ let seed = 1;
             const shaderLibrary = renderer == null ? void 0 : renderer.getShaderLibrary();
             yield pluginSystem == null ? void 0 : pluginSystem.precompile(compositions, renderer, options);
             yield new Promise((resolve)=>{
-                shaderLibrary.compileAllShaders(()=>{
+                shaderLibrary == null ? void 0 : shaderLibrary.compileAllShaders(()=>{
                     resolve(null);
                 });
             });
@@ -21838,7 +21808,7 @@ let seed = 1;
                 if (passRenderLevel(bin.renderLevel, renderLevel)) {
                     return _this.loadBins(new URL(bin.url, baseUrl).href);
                 }
-                throw new Error(`Invalid bins source: ${JSON.stringify(bins)}`);
+                throw new Error(`Invalid bins source: ${JSON.stringify(bins)}.`);
             });
             return Promise.all(jobs);
         })();
@@ -21855,7 +21825,7 @@ let seed = 1;
                 if (font.fontURL && !AssetManager.fonts.has(font.fontFamily)) {
                     if (!isValidFontFamily(font.fontFamily)) {
                         // 在所有设备上提醒开发者
-                        console.warn(`Risky font family: ${font.fontFamily}`);
+                        console.warn(`Risky font family: ${font.fontFamily}.`);
                     }
                     try {
                         const url = new URL(font.fontURL, _this.baseUrl).href;
@@ -21867,7 +21837,7 @@ let seed = 1;
                         AssetManager.fonts.add(font.fontFamily);
                     // eslint-disable-next-line @typescript-eslint/no-unused-vars
                     } catch (e) {
-                        logger.warn(`Invalid font family or font source: ${JSON.stringify(font.fontURL)}`);
+                        logger.warn(`Invalid font family or font source: ${JSON.stringify(font.fontURL)}.`);
                     }
                 }
             }));
@@ -21909,7 +21879,7 @@ let seed = 1;
                             }
                         // eslint-disable-next-line @typescript-eslint/no-unused-vars
                         } catch (e) {
-                            throw new Error(`Failed to load. Check the template or if the URL is ${isVideo ? 'video' : 'image'} type, URL: ${url}, Error: ${e.message}`);
+                            throw new Error(`Failed to load. Check the template or if the URL is ${isVideo ? 'video' : 'image'} type, URL: ${url}, Error: ${e.message}.`);
                         }
                     }
                 } else if ('compressed' in img && useCompressedTexture && compressedTexture) {
@@ -21958,9 +21928,9 @@ let seed = 1;
                 }
                 if ('mipmaps' in texOpts) {
                     try {
-                        return yield deserializeMipmapTexture(texOpts, bins, jsonScene.bins, engine);
+                        return yield deserializeMipmapTexture(texOpts, bins, engine, jsonScene.bins);
                     } catch (e) {
-                        throw new Error(`load texture ${idx} fails, error message: ${e}`);
+                        throw new Error(`Load texture ${idx} fails, error message: ${e}.`);
                     }
                 }
                 const { source } = texOpts;
@@ -21977,7 +21947,7 @@ let seed = 1;
                     tex.dataType = DataType.Texture;
                     return tex.sourceType === exports.TextureSourceType.compressed ? tex : _extends({}, tex, texOpts);
                 }
-                throw new Error(`Invalid texture source: ${source}`);
+                throw new Error(`Invalid texture source: ${source}.`);
             }));
             return Promise.all(jobs);
         })();
@@ -22088,7 +22058,7 @@ function createTextureOptionsBySource(image, sourceFrom) {
             magFilter: glContext.NEAREST
         };
     }
-    throw new Error('Invalid texture options');
+    throw new Error('Invalid texture options.');
 }
 
 const tmpScale = new Vector3(1, 1, 1);
@@ -22395,7 +22365,7 @@ let listOrder = 0;
                 if (itemProps.type === ItemType.composition) {
                     const refId = sourceItemData.content.options.refId;
                     if (!this.refCompositions.get(refId)) {
-                        throw new Error('Invalid Ref Composition id: ' + refId);
+                        throw new Error(`Invalid ref composition id: ${refId}.`);
                     }
                     const ref = this.getContent(this.refCompositions.get(refId));
                     if (!this.refCompositionProps.has(refId)) {
@@ -22489,7 +22459,7 @@ let listOrder = 0;
         const { jsonScene, renderLevel, textureOptions, pluginSystem, totalTime } = scene;
         const { compositions, imgUsage, compositionId } = jsonScene;
         if (!textureOptions) {
-            throw new Error('scene.textures expected');
+            throw new Error('scene.textures expected.');
         }
         const cachedTextures = textureOptions;
         for (const comp of compositions){
@@ -22500,7 +22470,7 @@ let listOrder = 0;
             }
         }
         if (!this.composition) {
-            throw new Error('Invalid composition id: ' + compositionId);
+            throw new Error(`Invalid composition id: ${compositionId}.`);
         }
         this.jsonScene = jsonScene;
         this.renderLevel = renderLevel;
@@ -22870,7 +22840,7 @@ let listOrder = 0;
                     }
                     parent.children.push(item);
                 } else {
-                    throw Error('元素引用了不存在的元素，请检查数据');
+                    throw new Error('The element references a non-existent element, please check the data.');
                 }
             }
         }
@@ -23101,7 +23071,7 @@ let listOrder = 0;
    * 合成整体在水平方向移动 x 像素，垂直方向移动 y 像素
    */ translateByPixel(x, y) {
         if (!this.renderer) {
-            console.warn('Can not translate position when container not assigned');
+            console.warn('Renderer not assigned. Operation aborted.');
             return;
         }
         this.rootItem.translateByPixel(x, y);
@@ -23115,7 +23085,7 @@ let listOrder = 0;
    * @param y - y 坐标
    */ setPositionByPixel(x, y) {
         if (!this.renderer) {
-            console.warn('Can not setPosition when container not assigned');
+            console.warn('Renderer not assigned. Operation aborted.');
             return;
         }
         this.rootItem.setPositionByPixel(x, y);
@@ -23202,11 +23172,11 @@ let listOrder = 0;
         /**
    * 销毁状态位
    */ this.destroyed = false;
+        this.postLoaders = [];
         /**
    * 合成暂停/播放 标识
    */ this.paused = false;
         this.lastVideoUpdateTime = 0;
-        this.postLoaders = [];
         const { reusable = false, speed = 1, baseRenderOrder = 0, renderer, onPlayerPause, onMessageItem, onEnd, event, width, height } = props;
         this.compositionSourceManager = new CompositionSourceManager(scene, renderer.engine);
         scene.jsonScene.imgUsage = undefined;
@@ -23291,7 +23261,7 @@ let listOrder = 0;
     }
     addPackageDatas(scene) {
         const { jsonScene, textureOptions = [] } = scene;
-        const { items = [], materials = [], shaders = [], geometries = [], components = [], animations = [], bins = [] } = jsonScene;
+        const { items = [], materials = [], shaders = [], geometries = [], components = [], animations = [], bins = [], miscs = [] } = jsonScene;
         for (const vfxItemData of items){
             this.addEffectsObjectData(vfxItemData);
         }
@@ -23310,6 +23280,9 @@ let listOrder = 0;
         for (const animationData of animations){
             this.addEffectsObjectData(animationData);
         }
+        for (const miscData of miscs){
+            this.addEffectsObjectData(miscData);
+        }
         for(let i = 0; i < bins.length; i++){
             const binaryData = bins[i];
             const binaryBuffer = scene.bins[i];
@@ -23427,7 +23400,7 @@ let listOrder = 0;
             info.push(`Tex ${this.textures.length}`);
         }
         if (info.length > 0) {
-            logger.warn(`Release GPU memory: ${info.join(', ')}`);
+            logger.warn(`Release GPU memory: ${info.join(', ')}.`);
         }
         this.renderPasses.forEach((pass)=>pass.dispose());
         this.meshes.forEach((mesh)=>mesh.dispose());
@@ -23552,7 +23525,7 @@ let listOrder = 0;
    * @param ticker - 定时器类
    */ add(ticker) {
         if (typeof ticker !== 'function') {
-            throw new Error('Ticker: The tick object must implement the tick method.');
+            throw new Error('The tick object must implement the tick method.');
         }
         this.tickers.push(ticker);
     }
@@ -23684,7 +23657,9 @@ exports.SubCompositionPlayableAsset = SubCompositionPlayableAsset;
 exports.SubCompositionTrack = SubCompositionTrack;
 exports.TEMPLATE_USE_OFFSCREEN_CANVAS = TEMPLATE_USE_OFFSCREEN_CANVAS;
 exports.TextComponent = TextComponent;
+exports.TextLayout = TextLayout;
 exports.TextLoader = TextLoader;
+exports.TextStyle = TextStyle;
 exports.Texture = Texture;
 exports.TextureFactory = TextureFactory;
 exports.Ticker = Ticker;
@@ -23717,12 +23692,11 @@ exports.compatibleVert = compatible_vert;
 exports.createCopyShader = createCopyShader;
 exports.createGLContext = createGLContext;
 exports.createKeyFrameMeta = createKeyFrameMeta;
-exports.createShaderWithMarcos = createShaderWithMarcos;
+exports.createShaderWithMacros = createShaderWithMacros;
 exports.createShape = createShape;
 exports.createVFXItem = createVFXItem;
 exports.createValueGetter = createValueGetter;
 exports.decimalEqual = decimalEqual;
-exports.deepClone = deepClone;
 exports.defaultGlobalVolume = defaultGlobalVolume;
 exports.defaultPlugins = defaultPlugins;
 exports.deserializeMipmapTexture = deserializeMipmapTexture;
@@ -23809,7 +23783,7 @@ exports.particleUniformTypeMap = particleUniformTypeMap;
 exports.particleVert = particleVert;
 exports.pluginLoaderMap = pluginLoaderMap;
 exports.pointOnLine = pointOnLine;
-exports.random = random;
+exports.randomInRange = randomInRange;
 exports.registerPlugin = registerPlugin;
 exports.removeItem = removeItem;
 exports.rotateVec2 = rotateVec2;
@@ -23822,7 +23796,6 @@ exports.setMaskMode = setMaskMode;
 exports.setMaxSpriteMeshItemCount = setMaxSpriteMeshItemCount;
 exports.setRayFromCamera = setRayFromCamera;
 exports.setSideMode = setSideMode;
-exports.setSpriteMeshMaxFragmentTextures = setSpriteMeshMaxFragmentTextures;
 exports.setSpriteMeshMaxItemCountByGPU = setSpriteMeshMaxItemCountByGPU;
 exports.sortByOrder = sortByOrder;
 exports.spec = index$1;