@galacean/effects-core 2.8.0-alpha.3 → 2.8.0-alpha.5

package/dist/index.js

@@ -3,7 +3,7 @@
  * Description: Galacean Effects runtime core for the web
  * Author: Ant Group CO., Ltd.
  * Contributors: 燃然,飂兮,十弦,云垣,茂安,意绮
- * Version: v2.8.0-alpha.3
+ * Version: v2.8.0-alpha.5
  */
 
 'use strict';
@@ -2668,355 +2668,6 @@ function asserts(condition, msg) {
     return /^[^\d.][\w-]*$/.test(fontFamily);
 }
 
-/**
- * Simple implementation of the deferred pattern.
- * An object that exposes a promise and functions to resolve and reject it.
- */ var Deferred = function Deferred() {
-    var _this = this;
-    this.promise = new Promise(function(resolve, reject) {
-        _this.resolve = resolve;
-        _this.reject = reject;
-    });
-};
-
-var prefix = "[Galacean Effects]";
-var localLogger;
-function format(message) {
-    return [
-        "%c" + prefix,
-        "color: #AA0100",
-        "" + message
-    ];
-}
-function error(message) {
-    for(var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++){
-        args[_key - 1] = arguments[_key];
-    }
-    var _console;
-    (_console = console).error.apply(_console, [].concat(format(message), [
-        args
-    ]));
-    localLogger == null ? void 0 : localLogger("error", message, args);
-}
-/**
- * info 会转换成浏览器的 console.debug
- * @param message
- * @param args
- */ function info(message) {
-    for(var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++){
-        args[_key - 1] = arguments[_key];
-    }
-    var _console;
-    (_console = console).debug.apply(_console, [].concat(format(message)));
-    localLogger == null ? void 0 : localLogger("info", message, args);
-}
-function warn(message) {
-    for(var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++){
-        args[_key - 1] = arguments[_key];
-    }
-    var _console;
-    (_console = console).warn.apply(_console, [].concat(format(message)));
-    localLogger == null ? void 0 : localLogger("warn", message, args);
-}
-/**
- * 注册自定义埋点函数
- *
- * @param fn
- */ function register(fn) {
-    if (fn && isFunction(fn)) {
-        localLogger = fn;
-    }
-}
-var logger = {
-    error: error,
-    info: info,
-    warn: warn,
-    register: register
-};
-
-exports.DestroyOptions = void 0;
-(function(DestroyOptions) {
-    DestroyOptions[DestroyOptions["destroy"] = 0] = "destroy";
-    DestroyOptions[DestroyOptions["keep"] = 1] = "keep";
-    DestroyOptions[DestroyOptions["force"] = 0] = "force";
-})(exports.DestroyOptions || (exports.DestroyOptions = {}));
-function noop() {}
-/**
- * 判断对象是否是`String`类型
- *
- * @static
- * @function isString
- * @param obj - 要判断的对象
- * @return
- */ function isString(obj) {
-    return typeof obj === "string";
-}
-/**
- * 判断对象是否是`Array`类型
- *
- * @static
- * @function isArray
- * @param obj - 要判断的对象
- * @return
- */ var isArray = Array.isArray || function(obj) {
-    return Object.prototype.toString.call(obj) === "[object Array]";
-};
-/**
- * 判断对象是否是函数类型
- *
- * @static
- * @function isFunction
- * @param obj - 要判断的对象
- * @return
- */ function isFunction(obj) {
-    return Object.prototype.toString.call(obj) === "[object Function]";
-}
-/**
- * 判断对象是否是`Object`类型
- *
- * @static
- * @function isObject
- * @param obj - 要判断的对象
- * @return
- */ function isObject(obj) {
-    return Object.prototype.toString.call(obj) === "[object Object]";
-}
-/**
- * 判断对象是否是`Plain Object`类型
- *
- * @param obj - 要判断的对象
- * @returns
- */ function isPlainObject(obj) {
-    if (obj === null || typeof obj !== "object") {
-        return false;
-    }
-    // 先排除 Array/Date/Map/Set/RegExp 等
-    if (Object.prototype.toString.call(obj) !== "[object Object]") {
-        return false;
-    }
-    var proto = Object.getPrototypeOf(obj);
-    if (proto === null) {
-        return true;
-    } // Object.create(null)
-    var hasOwn = Object.prototype.hasOwnProperty;
-    var Ctor = hasOwn.call(proto, "constructor") && proto.constructor;
-    // 构造器需要是 Object（跨 realm 用函数源码比对）
-    return typeof Ctor === "function" && Function.prototype.toString.call(Ctor) === Function.prototype.toString.call(Object);
-}
-function isCanvas(canvas) {
-    var _canvas_tagName;
-    // 小程序 Canvas 无法使用 instanceof HTMLCanvasElement 判断
-    return typeof canvas === "object" && canvas !== null && ((_canvas_tagName = canvas.tagName) == null ? void 0 : _canvas_tagName.toUpperCase()) === "CANVAS";
-}
-function isPowerOfTwo(value) {
-    return (value & value - 1) === 0 && value !== 0;
-}
-/**
- * 生成一个位于 min 和 max 之间的随机数
- * @param min
- * @param max
- * @returns
- */ function randomInRange(min, max) {
-    return min + Math.random() * (max - min);
-}
-function throwDestroyedError() {
-    throw new Error("Destroyed item cannot be used again.");
-}
-function generateGUID() {
-    return v4().replace(/-/g, "");
-}
-function base64ToFile(base64, filename, contentType) {
-    if (filename === void 0) filename = "base64File";
-    if (contentType === void 0) contentType = "";
-    // 去掉 Base64 字符串的 Data URL 部分（如果存在）
-    var base64WithoutPrefix = base64.split(",")[1] || base64;
-    // 将 base64 编码的字符串转换为二进制字符串
-    var byteCharacters = atob(base64WithoutPrefix);
-    // 创建一个 8 位无符号整数值的数组，即“字节数组”
-    var byteArrays = [];
-    // 切割二进制字符串为多个片段，并将每个片段转换成一个字节数组
-    for(var offset = 0; offset < byteCharacters.length; offset += 512){
-        var slice = byteCharacters.slice(offset, offset + 512);
-        var byteNumbers = new Array(slice.length);
-        for(var i = 0; i < slice.length; i++){
-            byteNumbers[i] = slice.charCodeAt(i);
-        }
-        var byteArray = new Uint8Array(byteNumbers);
-        byteArrays.push(byteArray);
-    }
-    // 使用字节数组创建 Blob 对象
-    var blob = new Blob(byteArrays, {
-        type: contentType
-    });
-    // 创建 File 对象
-    var file = new File([
-        blob
-    ], filename, {
-        type: contentType
-    });
-    return file;
-}
-function applyMixins(derivedCtrl, baseCtrls) {
-    baseCtrls.forEach(function(baseCtrl) {
-        Object.getOwnPropertyNames(baseCtrl.prototype).forEach(function(name) {
-            var propertyDescriptor = Object.getOwnPropertyDescriptor(baseCtrl.prototype, name);
-            if (!propertyDescriptor) {
-                throw new Error("Cannot find property descriptor of class " + baseCtrl);
-            }
-            Object.defineProperty(derivedCtrl.prototype, name, propertyDescriptor);
-        });
-    });
-}
-
-var pluginLoaderMap = {};
-var plugins = [];
-/**
- * 注册 plugin
- * @param name
- * @param pluginClass class of plugin
- * @param itemClass class of item
- * @param isDefault load
- */ function registerPlugin(name, pluginClass) {
-    if (pluginLoaderMap[name]) {
-        logger.error("Duplicate registration for plugin " + name + ".");
-    }
-    pluginLoaderMap[name] = pluginClass;
-    var pluginInstance = new pluginClass();
-    pluginInstance.name = name;
-    pluginInstance.initialize();
-    plugins.push(pluginInstance);
-    plugins.sort(function(a, b) {
-        return a.order - b.order;
-    });
-}
-/**
- * 注销 plugin
- */ function unregisterPlugin(name) {
-    delete pluginLoaderMap[name];
-    var pluginIndex = plugins.findIndex(function(plugin) {
-        return plugin.name === name;
-    });
-    if (pluginIndex !== -1) {
-        plugins.splice(pluginIndex, 1);
-    }
-}
-var PluginSystem = /*#__PURE__*/ function() {
-    function PluginSystem() {}
-    PluginSystem.getPlugins = function getPlugins() {
-        return plugins;
-    };
-    PluginSystem.initializeComposition = function initializeComposition(composition, scene) {
-        plugins.forEach(function(loader) {
-            return loader.onCompositionConstructed(composition, scene);
-        });
-    };
-    PluginSystem.destroyComposition = function destroyComposition(comp) {
-        plugins.forEach(function(loader) {
-            return loader.onCompositionDestroyed(comp);
-        });
-    };
-    PluginSystem.processAssets = function processAssets(scene, options) {
-        return _async_to_generator(function() {
-            return __generator(this, function(_state) {
-                return [
-                    2,
-                    Promise.all(plugins.map(function(plugin) {
-                        return plugin.processAssets(scene, options);
-                    }))
-                ];
-            });
-        })();
-    };
-    PluginSystem.loadResources = function loadResources(scene, options, engine) {
-        plugins.forEach(function(loader) {
-            return loader.prepareResource(scene, options, engine);
-        });
-    };
-    return PluginSystem;
-}();
-var pluginInfoMap = {
-    "alipay-downgrade": "@galacean/effects-plugin-alipay-downgrade",
-    "downgrade": "@galacean/effects-plugin-downgrade",
-    "editor-gizmo": "@galacean/effects-plugin-editor-gizmo",
-    "ffd": "@galacean/effects-plugin-ffd",
-    "ktx2": "@galacean/effects-plugin-ktx2",
-    "model": "@galacean/effects-plugin-model",
-    "video": "@galacean/effects-plugin-multimedia",
-    "audio": "@galacean/effects-plugin-multimedia",
-    "orientation-transformer": "@galacean/effects-plugin-orientation-transformer",
-    "rich-text": "@galacean/effects-plugin-rich-text",
-    "spine": "@galacean/effects-plugin-spine"
-};
-function getPluginUsageInfo(name) {
-    var info = pluginInfoMap[name];
-    if (info) {
-        return "\n请按如下命令进行操作（Please follow the commands below to proceed）：\n1、使用 npm 安装插件（Install Plugin）：npm i " + info + "@latest --save\n2、导入插件（Import Plugin）：import '" + info + "'";
-    } else {
-        return "";
-    }
-}
-
-/**
- * 抽象插件类
- * 注册合成不同生命周期的回调函数
- */ var AbstractPlugin = /*#__PURE__*/ function() {
-    function AbstractPlugin() {
-        this.order = 100;
-        this.name = "";
-    }
-    var _proto = AbstractPlugin.prototype;
-    _proto.initialize = function initialize() {};
-    /**
-   * loadScene 函数调用的时候会触发此函数，
-   * 此阶段可以加载插件所需类型资源，并返回原始资源和加载后的资源。
-   * @param scene
-   * @param options
-   * @returns
-   */ _proto.processAssets = function processAssets(scene, options) {
-        return _async_to_generator(function() {
-            return __generator(this, function(_state) {
-                return [
-                    2
-                ];
-            });
-        })();
-    };
-    /**
-   * loadScene 函数调用的时候会触发此函数，
-   * 此阶段时，json 中的图片和二进制已经被加载完成，可以对加载好的资源做进一步处理，
-   * 如果 promise 被 reject, loadScene 函数同样会被 reject，表示场景加载失败。
-   * 请记住，整个 load 阶段都不要创建 GL 相关的对象，只创建 JS 对象
-   * 此阶段晚于 processAssets
-   * @param {Scene} scene
-   * @param {SceneLoadOptions} options
-   */ _proto.prepareResource = function prepareResource(scene, options, engine) {};
-    _proto.onCompositionConstructed = function onCompositionConstructed(composition, scene) {};
-    _proto.onCompositionDestroyed = function onCompositionDestroyed(composition) {};
-    return AbstractPlugin;
-}();
-
-function _set_prototype_of(o, p) {
-    _set_prototype_of = Object.setPrototypeOf || function setPrototypeOf(o, p) {
-        o.__proto__ = p;
-        return o;
-    };
-    return _set_prototype_of(o, p);
-}
-
-function _inherits(subClass, superClass) {
-    if (typeof superClass !== "function" && superClass !== null) {
-        throw new TypeError("Super expression must either be null or a function");
-    }
-    subClass.prototype = Object.create(superClass && superClass.prototype, {
-        constructor: {
-            value: subClass,
-            writable: true,
-            configurable: true
-        }
-    });
-    if (superClass) _set_prototype_of(subClass, superClass);
-}
-
 /**
  * JSON 版本
  */ var JSONSceneVersion;
@@ -3764,6 +3415,17 @@ var NodeDataType;
     MultimediaType["video"] = "video";
     MultimediaType["audio"] = "audio";
 })(MultimediaType || (MultimediaType = {}));
+var HevcVideoCodec;
+(function(HevcVideoCodec) {
+    HevcVideoCodec["L30"] = "hev1.1.0.L30.B0";
+    HevcVideoCodec["L60"] = "hev1.1.0.L60.B0";
+    HevcVideoCodec["L63"] = "hev1.1.0.L63.B0";
+    HevcVideoCodec["L90"] = "hev1.1.0.L90.B0";
+    HevcVideoCodec["L93"] = "hev1.1.0.L93.B0";
+    HevcVideoCodec["L120"] = "hev1.1.0.L120.B0";
+    HevcVideoCodec["L150"] = "hev1.1.0.L150.B0";
+    HevcVideoCodec["L180"] = "hev1.1.0.L180.B0";
+})(HevcVideoCodec || (HevcVideoCodec = {}));
 
 var DataType;
 (function(DataType) {
@@ -3969,6 +3631,7 @@ var index$1 = /*#__PURE__*/Object.freeze({
     get NodeDataType () { return NodeDataType; },
     get BackgroundType () { return BackgroundType; },
     get MultimediaType () { return MultimediaType; },
+    get HevcVideoCodec () { return HevcVideoCodec; },
     get DataType () { return DataType; },
     get GeometryType () { return GeometryType; },
     get VertexFormatType () { return VertexFormatType; },
@@ -3976,6 +3639,391 @@ var index$1 = /*#__PURE__*/Object.freeze({
     get VertexBufferSemantic () { return VertexBufferSemantic; }
 });
 
+/**
+ * Check if the browser can play the given HEVC codec.
+ * @param codec - The HEVC codec to check.
+ * @returns True if the browser can probably or maybe play the codec, false otherwise.
+ */ function canPlayHevcCodec(codec) {
+    var video = document.createElement("video");
+    var contentType = 'video/mp4; codecs="' + codec + '"';
+    var result = video.canPlayType(contentType);
+    return result === "probably" || result === "maybe";
+}
+/**
+ * Parse the given codec string into a HEVC video codec enum value.
+ * @param codec - The codec string to parse.
+ * @returns The corresponding HEVC video codec enum value, or undefined if the codec is invalid.
+ */ function parseCodec(codec) {
+    // 传入的是完整的枚举值
+    if (isCodecValue(codec)) {
+        return codec;
+    }
+    // 传入的是枚举名称
+    if (isCodecKey(codec)) {
+        return HevcVideoCodec[codec];
+    }
+    return undefined;
+}
+function isCodecValue(codec) {
+    return Object.keys(HevcVideoCodec).some(function(key) {
+        return HevcVideoCodec[key] === codec;
+    });
+}
+function isCodecKey(codec) {
+    return codec in HevcVideoCodec;
+}
+
+/**
+ * Simple implementation of the deferred pattern.
+ * An object that exposes a promise and functions to resolve and reject it.
+ */ var Deferred = function Deferred() {
+    var _this = this;
+    this.promise = new Promise(function(resolve, reject) {
+        _this.resolve = resolve;
+        _this.reject = reject;
+    });
+};
+
+var prefix = "[Galacean Effects]";
+var localLogger;
+function format(message) {
+    return [
+        "%c" + prefix,
+        "color: #AA0100",
+        "" + message
+    ];
+}
+function error(message) {
+    for(var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++){
+        args[_key - 1] = arguments[_key];
+    }
+    var _console;
+    (_console = console).error.apply(_console, [].concat(format(message), [
+        args
+    ]));
+    localLogger == null ? void 0 : localLogger("error", message, args);
+}
+/**
+ * info 会转换成浏览器的 console.debug
+ * @param message
+ * @param args
+ */ function info(message) {
+    for(var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++){
+        args[_key - 1] = arguments[_key];
+    }
+    var _console;
+    (_console = console).debug.apply(_console, [].concat(format(message)));
+    localLogger == null ? void 0 : localLogger("info", message, args);
+}
+function warn(message) {
+    for(var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++){
+        args[_key - 1] = arguments[_key];
+    }
+    var _console;
+    (_console = console).warn.apply(_console, [].concat(format(message)));
+    localLogger == null ? void 0 : localLogger("warn", message, args);
+}
+/**
+ * 注册自定义埋点函数
+ *
+ * @param fn
+ */ function register(fn) {
+    if (fn && isFunction(fn)) {
+        localLogger = fn;
+    }
+}
+var logger = {
+    error: error,
+    info: info,
+    warn: warn,
+    register: register
+};
+
+exports.DestroyOptions = void 0;
+(function(DestroyOptions) {
+    DestroyOptions[DestroyOptions["destroy"] = 0] = "destroy";
+    DestroyOptions[DestroyOptions["keep"] = 1] = "keep";
+    DestroyOptions[DestroyOptions["force"] = 0] = "force";
+})(exports.DestroyOptions || (exports.DestroyOptions = {}));
+function noop() {}
+/**
+ * 判断对象是否是`String`类型
+ *
+ * @static
+ * @function isString
+ * @param obj - 要判断的对象
+ * @return
+ */ function isString(obj) {
+    return typeof obj === "string";
+}
+/**
+ * 判断对象是否是`Array`类型
+ *
+ * @static
+ * @function isArray
+ * @param obj - 要判断的对象
+ * @return
+ */ var isArray = Array.isArray || function(obj) {
+    return Object.prototype.toString.call(obj) === "[object Array]";
+};
+/**
+ * 判断对象是否是函数类型
+ *
+ * @static
+ * @function isFunction
+ * @param obj - 要判断的对象
+ * @return
+ */ function isFunction(obj) {
+    return Object.prototype.toString.call(obj) === "[object Function]";
+}
+/**
+ * 判断对象是否是`Object`类型
+ *
+ * @static
+ * @function isObject
+ * @param obj - 要判断的对象
+ * @return
+ */ function isObject(obj) {
+    return Object.prototype.toString.call(obj) === "[object Object]";
+}
+/**
+ * 判断对象是否是`Plain Object`类型
+ *
+ * @param obj - 要判断的对象
+ * @returns
+ */ function isPlainObject(obj) {
+    if (obj === null || typeof obj !== "object") {
+        return false;
+    }
+    // 先排除 Array/Date/Map/Set/RegExp 等
+    if (Object.prototype.toString.call(obj) !== "[object Object]") {
+        return false;
+    }
+    var proto = Object.getPrototypeOf(obj);
+    if (proto === null) {
+        return true;
+    } // Object.create(null)
+    var hasOwn = Object.prototype.hasOwnProperty;
+    var Ctor = hasOwn.call(proto, "constructor") && proto.constructor;
+    // 构造器需要是 Object（跨 realm 用函数源码比对）
+    return typeof Ctor === "function" && Function.prototype.toString.call(Ctor) === Function.prototype.toString.call(Object);
+}
+function isCanvas(canvas) {
+    var _canvas_tagName;
+    // 小程序 Canvas 无法使用 instanceof HTMLCanvasElement 判断
+    return typeof canvas === "object" && canvas !== null && ((_canvas_tagName = canvas.tagName) == null ? void 0 : _canvas_tagName.toUpperCase()) === "CANVAS";
+}
+function isPowerOfTwo(value) {
+    return (value & value - 1) === 0 && value !== 0;
+}
+/**
+ * 生成一个位于 min 和 max 之间的随机数
+ * @param min
+ * @param max
+ * @returns
+ */ function randomInRange(min, max) {
+    return min + Math.random() * (max - min);
+}
+function throwDestroyedError() {
+    throw new Error("Destroyed item cannot be used again.");
+}
+function generateGUID() {
+    return v4().replace(/-/g, "");
+}
+function base64ToFile(base64, filename, contentType) {
+    if (filename === void 0) filename = "base64File";
+    if (contentType === void 0) contentType = "";
+    // 去掉 Base64 字符串的 Data URL 部分（如果存在）
+    var base64WithoutPrefix = base64.split(",")[1] || base64;
+    // 将 base64 编码的字符串转换为二进制字符串
+    var byteCharacters = atob(base64WithoutPrefix);
+    // 创建一个 8 位无符号整数值的数组，即“字节数组”
+    var byteArrays = [];
+    // 切割二进制字符串为多个片段，并将每个片段转换成一个字节数组
+    for(var offset = 0; offset < byteCharacters.length; offset += 512){
+        var slice = byteCharacters.slice(offset, offset + 512);
+        var byteNumbers = new Array(slice.length);
+        for(var i = 0; i < slice.length; i++){
+            byteNumbers[i] = slice.charCodeAt(i);
+        }
+        var byteArray = new Uint8Array(byteNumbers);
+        byteArrays.push(byteArray);
+    }
+    // 使用字节数组创建 Blob 对象
+    var blob = new Blob(byteArrays, {
+        type: contentType
+    });
+    // 创建 File 对象
+    var file = new File([
+        blob
+    ], filename, {
+        type: contentType
+    });
+    return file;
+}
+function applyMixins(derivedCtrl, baseCtrls) {
+    baseCtrls.forEach(function(baseCtrl) {
+        Object.getOwnPropertyNames(baseCtrl.prototype).forEach(function(name) {
+            var propertyDescriptor = Object.getOwnPropertyDescriptor(baseCtrl.prototype, name);
+            if (!propertyDescriptor) {
+                throw new Error("Cannot find property descriptor of class " + baseCtrl);
+            }
+            Object.defineProperty(derivedCtrl.prototype, name, propertyDescriptor);
+        });
+    });
+}
+
+var pluginLoaderMap = {};
+var plugins = [];
+/**
+ * 注册 plugin
+ * @param name
+ * @param pluginClass class of plugin
+ * @param itemClass class of item
+ * @param isDefault load
+ */ function registerPlugin(name, pluginClass) {
+    if (pluginLoaderMap[name]) {
+        logger.error("Duplicate registration for plugin " + name + ".");
+    }
+    pluginLoaderMap[name] = pluginClass;
+    var pluginInstance = new pluginClass();
+    pluginInstance.name = name;
+    plugins.push(pluginInstance);
+    plugins.sort(function(a, b) {
+        return a.order - b.order;
+    });
+}
+/**
+ * 注销 plugin
+ */ function unregisterPlugin(name) {
+    delete pluginLoaderMap[name];
+    var pluginIndex = plugins.findIndex(function(plugin) {
+        return plugin.name === name;
+    });
+    if (pluginIndex !== -1) {
+        plugins.splice(pluginIndex, 1);
+    }
+}
+var PluginSystem = /*#__PURE__*/ function() {
+    function PluginSystem() {}
+    PluginSystem.getPlugins = function getPlugins() {
+        return plugins;
+    };
+    PluginSystem.initializeComposition = function initializeComposition(composition, scene) {
+        plugins.forEach(function(loader) {
+            return loader.onCompositionCreated(composition, scene);
+        });
+    };
+    PluginSystem.destroyComposition = function destroyComposition(comp) {
+        plugins.forEach(function(loader) {
+            return loader.onCompositionDestroy(comp);
+        });
+    };
+    PluginSystem.onAssetsLoadStart = function onAssetsLoadStart(scene, options) {
+        return _async_to_generator(function() {
+            return __generator(this, function(_state) {
+                return [
+                    2,
+                    Promise.all(plugins.map(function(plugin) {
+                        return plugin.onAssetsLoadStart(scene, options);
+                    }))
+                ];
+            });
+        })();
+    };
+    PluginSystem.onAssetsLoadFinish = function onAssetsLoadFinish(scene, options, engine) {
+        plugins.forEach(function(loader) {
+            return loader.onAssetsLoadFinish(scene, options, engine);
+        });
+    };
+    return PluginSystem;
+}();
+var pluginInfoMap = {
+    "alipay-downgrade": "@galacean/effects-plugin-alipay-downgrade",
+    "downgrade": "@galacean/effects-plugin-downgrade",
+    "editor-gizmo": "@galacean/effects-plugin-editor-gizmo",
+    "ffd": "@galacean/effects-plugin-ffd",
+    "ktx2": "@galacean/effects-plugin-ktx2",
+    "model": "@galacean/effects-plugin-model",
+    "video": "@galacean/effects-plugin-multimedia",
+    "audio": "@galacean/effects-plugin-multimedia",
+    "orientation-transformer": "@galacean/effects-plugin-orientation-transformer",
+    "rich-text": "@galacean/effects-plugin-rich-text",
+    "spine": "@galacean/effects-plugin-spine"
+};
+function getPluginUsageInfo(name) {
+    var info = pluginInfoMap[name];
+    if (info) {
+        return "\n请按如下命令进行操作（Please follow the commands below to proceed）：\n1、使用 npm 安装插件（Install Plugin）：npm i " + info + "@latest --save\n2、导入插件（Import Plugin）：import '" + info + "'";
+    } else {
+        return "";
+    }
+}
+
+/**
+ * 抽象插件类
+ * 注册合成不同生命周期的回调函数
+ */ var Plugin = /*#__PURE__*/ function() {
+    function Plugin() {
+        this.order = 100;
+        this.name = "Plugin";
+    }
+    var _proto = Plugin.prototype;
+    /**
+   * 场景加载时触发，用于加载插件所需的自定义资源。
+   * 此阶段适合发起异步资源请求。
+   * @param scene - 场景对象
+   * @param options - 场景加载选项
+   */ _proto.onAssetsLoadStart = function onAssetsLoadStart(scene, options) {
+        return _async_to_generator(function() {
+            return __generator(this, function(_state) {
+                return [
+                    2
+                ];
+            });
+        })();
+    };
+    /**
+   * 场景资源加载完成后触发。
+   * 此时 JSON 中的图片和二进制已加载完成，可对资源做进一步处理。
+   * @param scene - 场景对象
+   * @param options - 场景加载选项
+   * @param engine - 引擎实例
+   */ _proto.onAssetsLoadFinish = function onAssetsLoadFinish(scene, options, engine) {};
+    /**
+   * 合成创建完成后触发。
+   * @param composition - 合成对象
+   * @param scene - 场景对象
+   */ _proto.onCompositionCreated = function onCompositionCreated(composition, scene) {};
+    /**
+   * 合成销毁时触发。
+   * @param composition - 合成对象
+   */ _proto.onCompositionDestroy = function onCompositionDestroy(composition) {};
+    return Plugin;
+}();
+
+function _set_prototype_of(o, p) {
+    _set_prototype_of = Object.setPrototypeOf || function setPrototypeOf(o, p) {
+        o.__proto__ = p;
+        return o;
+    };
+    return _set_prototype_of(o, p);
+}
+
+function _inherits(subClass, superClass) {
+    if (typeof superClass !== "function" && superClass !== null) {
+        throw new TypeError("Super expression must either be null or a function");
+    }
+    subClass.prototype = Object.create(superClass && superClass.prototype, {
+        constructor: {
+            value: subClass,
+            writable: true,
+            configurable: true
+        }
+    });
+    if (superClass) _set_prototype_of(subClass, superClass);
+}
+
 function _array_like_to_array(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
@@ -10652,6 +10700,9 @@ var DrawObjectPass = /*#__PURE__*/ function(RenderPass) {
                 stencilAction: exports.TextureLoadAction.clear
             });
         }
+        this.meshes.sort(function(a, b) {
+            return a.priority - b.priority;
+        });
         renderer.renderMeshes(this.meshes);
     };
     _proto.onCameraCleanup = function onCameraCleanup(renderer) {
@@ -16589,13 +16640,49 @@ exports.CameraController = __decorate([
     effectsClass(DataType.CameraController)
 ], exports.CameraController);
 
-var CameraVFXItemLoader = /*#__PURE__*/ function(AbstractPlugin) {
-    _inherits(CameraVFXItemLoader, AbstractPlugin);
+function _get_prototype_of(o) {
+    _get_prototype_of = Object.setPrototypeOf ? Object.getPrototypeOf : function getPrototypeOf(o) {
+        return o.__proto__ || Object.getPrototypeOf(o);
+    };
+    return _get_prototype_of(o);
+}
+
+function _is_native_function(fn) {
+    return Function.toString.call(fn).indexOf("[native code]") !== -1;
+}
+
+function _wrap_native_super(Class) {
+    var _cache = typeof Map === "function" ? new Map() : undefined;
+    _wrap_native_super = function _wrap_native_super(Class) {
+        if (Class === null || !_is_native_function(Class)) return Class;
+        if (typeof Class !== "function") throw new TypeError("Super expression must either be null or a function");
+        if (typeof _cache !== "undefined") {
+            if (_cache.has(Class)) return _cache.get(Class);
+            _cache.set(Class, Wrapper);
+        }
+        function Wrapper() {
+            return _construct(Class, arguments, _get_prototype_of(this).constructor);
+        }
+        Wrapper.prototype = Object.create(Class.prototype, {
+            constructor: {
+                value: Wrapper,
+                enumerable: false,
+                writable: true,
+                configurable: true
+            }
+        });
+        return _set_prototype_of(Wrapper, Class);
+    };
+    return _wrap_native_super(Class);
+}
+
+var CameraVFXItemLoader = /*#__PURE__*/ function(Plugin) {
+    _inherits(CameraVFXItemLoader, Plugin);
     function CameraVFXItemLoader() {
-        return AbstractPlugin.apply(this, arguments);
+        return Plugin.apply(this, arguments);
     }
     return CameraVFXItemLoader;
-}(AbstractPlugin);
+}(_wrap_native_super(Plugin));
 
 exports.HitTestType = void 0;
 (function(HitTestType) {
@@ -16879,13 +16966,13 @@ function getCoord(event) {
     };
 }
 
-var InteractLoader = /*#__PURE__*/ function(AbstractPlugin) {
-    _inherits(InteractLoader, AbstractPlugin);
+var InteractLoader = /*#__PURE__*/ function(Plugin) {
+    _inherits(InteractLoader, Plugin);
     function InteractLoader() {
-        return AbstractPlugin.apply(this, arguments);
+        return Plugin.apply(this, arguments);
     }
     return InteractLoader;
-}(AbstractPlugin);
+}(_wrap_native_super(Plugin));
 
 var vertex = "\nprecision highp float;\n\nattribute vec2 aPoint;\nuniform vec4 uPos;\nuniform vec2 uSize;\nuniform vec4 uQuat;\nuniform vec4 uColor;\nuniform mat4 effects_ObjectToWorld;\nuniform mat4 effects_MatrixInvV;\nuniform mat4 effects_MatrixVP;\nvarying vec4 vColor;\n\nvec3 rotateByQuat(vec3 a, vec4 quat){\n  vec3 qvec = quat.xyz;\n  vec3 uv = cross(qvec, a);\n  vec3 uuv = cross(qvec, uv) * 2.;\n  return a +(uv * 2. * quat.w + uuv);\n}\n\nvoid main() {\n  vec4 _pos = uPos;\n  vec3 point = rotateByQuat(vec3(aPoint.xy * uSize, 0.),uQuat);\n  vec4 pos = vec4(_pos.xyz, 1.0);\n  pos = effects_ObjectToWorld * pos;\n  pos.xyz += effects_MatrixInvV[0].xyz * point.x+ effects_MatrixInvV[1].xyz * point.y;\n  gl_Position = effects_MatrixVP * pos;\n  vColor = uColor;\n}\n";
 var fragment = "\nprecision highp float;\n\n#define fragColor gl_FragColor\n\nvarying vec4 vColor;\nvoid main() {\n  gl_FragColor = vColor*vColor.a;\n}\n";
@@ -17484,16 +17571,16 @@ function shouldIgnoreBouncing(arg, mul) {
     return MeshCollider;
 }();
 
-var SpriteLoader = /*#__PURE__*/ function(AbstractPlugin) {
-    _inherits(SpriteLoader, AbstractPlugin);
+var SpriteLoader = /*#__PURE__*/ function(Plugin) {
+    _inherits(SpriteLoader, Plugin);
     function SpriteLoader() {
         var _this;
-        _this = AbstractPlugin.apply(this, arguments) || this;
+        _this = Plugin.apply(this, arguments) || this;
         _this.name = "sprite";
         return _this;
     }
     return SpriteLoader;
-}(AbstractPlugin);
+}(_wrap_native_super(Plugin));
 
 /**
  * 动画图可播放节点对象
@@ -19984,7 +20071,7 @@ function calculateDirection(prePoint, point, nextPoint) {
             if (this.time >= 0 && this.time < particleSystem.item.duration && particleSystem.isEnded()) {
                 particleSystem.reset();
             }
-            particleSystem.update(this.time - particleSystem.time);
+            particleSystem.simulate(this.time - particleSystem.time);
         }
         this.lastTime = this.time;
     };
@@ -21435,126 +21522,133 @@ exports.ParticleSystem = /*#__PURE__*/ function(Component) {
         this.initEmitterTransform();
     };
     _proto.onUpdate = function onUpdate(dt) {
-        this.update(dt);
+        if (!this.frozen) {
+            this.update(dt);
+        }
+    };
+    _proto.simulate = function simulate(time) {
+        this.update(time * 1000);
+        this.frozen = true;
     };
     _proto.update = function update(delta) {
         var _this = this;
-        if (this.started && !this.frozen) {
-            var now = this.time + delta / 1000;
-            var options = this.options;
-            var loopStartTime = this.loopStartTime;
-            var emission = this.emission;
-            this.time = now;
-            this.upDirectionWorld = null;
-            this.renderer.updateTime(now, delta);
-            var link = this.particleLink;
-            var emitterLifetime = (now - loopStartTime) / this.item.duration;
-            var timePassed = this.timePassed;
-            var trailUpdated = false;
-            var updateTrail = function() {
-                if (_this.trails && !trailUpdated) {
-                    trailUpdated = true;
-                    link.forEach(function(param) {
-                        var time = param[0], pointIndex = param[1], delay = param[2], point = param[3];
-                        if (time < timePassed) {
-                            _this.clearPointTrail(pointIndex);
-                        } else if (timePassed > delay) {
-                            _this.updatePointTrail(pointIndex, emitterLifetime, point, delay);
-                        }
-                    });
+        if (!this.started) {
+            return;
+        }
+        var now = this.time + delta / 1000;
+        var options = this.options;
+        var loopStartTime = this.loopStartTime;
+        var emission = this.emission;
+        this.time = now;
+        this.upDirectionWorld = null;
+        this.renderer.updateTime(now, delta);
+        var link = this.particleLink;
+        var emitterLifetime = (now - loopStartTime) / this.item.duration;
+        var timePassed = this.timePassed;
+        var trailUpdated = false;
+        var updateTrail = function() {
+            if (_this.trails && !trailUpdated) {
+                trailUpdated = true;
+                link.forEach(function(param) {
+                    var time = param[0], pointIndex = param[1], delay = param[2], point = param[3];
+                    if (time < timePassed) {
+                        _this.clearPointTrail(pointIndex);
+                    } else if (timePassed > delay) {
+                        _this.updatePointTrail(pointIndex, emitterLifetime, point, delay);
+                    }
+                });
+            }
+        };
+        if (!this.ended) {
+            var duration = this.item.duration;
+            var lifetime = this.lifetime;
+            if (timePassed < duration) {
+                var interval = 1 / emission.rateOverTime.getValue(lifetime);
+                var pointCount = Math.floor((timePassed - this.lastEmitTime) / interval);
+                var maxEmissionCount = pointCount;
+                var timeDelta = interval / pointCount;
+                var meshTime = now;
+                var maxCount = options.maxCount;
+                this.updateEmitterTransform(timePassed);
+                var shouldSkipGenerate = function() {
+                    var first = link.first;
+                    return _this.emissionStopped || link.length === maxCount && first && first.content[0] - loopStartTime > timePassed;
+                };
+                for(var i = 0; i < maxEmissionCount && i < maxCount; i++){
+                    if (shouldSkipGenerate()) {
+                        break;
+                    }
+                    var p = this.createPoint(lifetime);
+                    p.delay += meshTime + i * timeDelta;
+                    this.addParticle(p, maxCount);
+                    this.lastEmitTime = timePassed;
                 }
-            };
-            if (!this.ended) {
-                var duration = this.item.duration;
-                var lifetime = this.lifetime;
-                if (timePassed < duration) {
-                    var interval = 1 / emission.rateOverTime.getValue(lifetime);
-                    var pointCount = Math.floor((timePassed - this.lastEmitTime) / interval);
-                    var maxEmissionCount = pointCount;
-                    var timeDelta = interval / pointCount;
-                    var meshTime = now;
-                    var maxCount = options.maxCount;
-                    this.updateEmitterTransform(timePassed);
-                    var shouldSkipGenerate = function() {
-                        var first = link.first;
-                        return _this.emissionStopped || link.length === maxCount && first && first.content[0] - loopStartTime > timePassed;
-                    };
-                    for(var i = 0; i < maxEmissionCount && i < maxCount; i++){
-                        if (shouldSkipGenerate()) {
-                            break;
-                        }
-                        var p = this.createPoint(lifetime);
-                        p.delay += meshTime + i * timeDelta;
-                        this.addParticle(p, maxCount);
-                        this.lastEmitTime = timePassed;
+                var bursts = emission.bursts;
+                for(var j = (bursts == null ? void 0 : bursts.length) - 1, cursor = 0; j >= 0 && cursor < maxCount; j--){
+                    if (shouldSkipGenerate()) {
+                        break;
                     }
-                    var bursts = emission.bursts;
-                    for(var j = (bursts == null ? void 0 : bursts.length) - 1, cursor = 0; j >= 0 && cursor < maxCount; j--){
-                        if (shouldSkipGenerate()) {
-                            break;
+                    var burst = bursts[j];
+                    var opts = !burst.disabled && burst.getGeneratorOptions(timePassed, lifetime);
+                    if (opts) {
+                        var originVec = [
+                            0,
+                            0,
+                            0
+                        ];
+                        var offsets = emission.burstOffsets[j];
+                        var burstOffset = offsets && offsets[opts.cycleIndex] || originVec;
+                        if (burst.once) {
+                            this.removeBurst(j);
                         }
-                        var burst = bursts[j];
-                        var opts = !burst.disabled && burst.getGeneratorOptions(timePassed, lifetime);
-                        if (opts) {
-                            var originVec = [
-                                0,
-                                0,
-                                0
-                            ];
-                            var offsets = emission.burstOffsets[j];
-                            var burstOffset = offsets && offsets[opts.cycleIndex] || originVec;
-                            if (burst.once) {
-                                this.removeBurst(j);
-                            }
-                            for(var i1 = 0; i1 < opts.count && cursor < maxCount; i1++){
-                                var _p_transform;
-                                if (shouldSkipGenerate()) {
-                                    break;
-                                }
-                                var p1 = this.initPoint(this.shape.generate({
-                                    total: opts.total,
-                                    index: opts.index,
-                                    burstIndex: i1,
-                                    burstCount: opts.count
-                                }));
-                                p1.delay += meshTime;
-                                cursor++;
-                                (_p_transform = p1.transform).translate.apply(_p_transform, [].concat(burstOffset));
-                                this.addParticle(p1, maxCount);
+                        for(var i1 = 0; i1 < opts.count && cursor < maxCount; i1++){
+                            var _p_transform;
+                            if (shouldSkipGenerate()) {
+                                break;
                             }
+                            var p1 = this.initPoint(this.shape.generate({
+                                total: opts.total,
+                                index: opts.index,
+                                burstIndex: i1,
+                                burstCount: opts.count
+                            }));
+                            p1.delay += meshTime;
+                            cursor++;
+                            (_p_transform = p1.transform).translate.apply(_p_transform, [].concat(burstOffset));
+                            this.addParticle(p1, maxCount);
                         }
                     }
-                } else if (this.item.endBehavior === EndBehavior.restart) {
-                    updateTrail();
-                    this.loopStartTime = now - duration;
-                    this.lastEmitTime -= duration;
-                    this.time -= duration;
-                    emission.bursts.forEach(function(b) {
-                        return b.reset();
-                    });
-                    this.particleLink.forEach(function(content) {
-                        content[0] -= duration;
-                        content[2] -= duration;
-                        content[3].delay -= duration;
-                    });
-                    this.renderer.minusTimeForLoop(duration);
-                } else {
-                    this.ended = true;
-                    var endBehavior = this.item.endBehavior;
-                    if (endBehavior === EndBehavior.freeze) {
-                        this.frozen = true;
-                    }
                 }
-            } else if (this.item.endBehavior !== EndBehavior.restart) {
-                if (EndBehavior.destroy === this.item.endBehavior) {
-                    var node = link.last;
-                    if (node && node.content[0] < this.time) {
-                        this.destroyed = true;
-                    }
+            } else if (this.item.endBehavior === EndBehavior.restart) {
+                updateTrail();
+                this.loopStartTime = now - duration;
+                this.lastEmitTime -= duration;
+                this.time -= duration;
+                emission.bursts.forEach(function(b) {
+                    return b.reset();
+                });
+                this.particleLink.forEach(function(content) {
+                    content[0] -= duration;
+                    content[2] -= duration;
+                    content[3].delay -= duration;
+                });
+                this.renderer.minusTimeForLoop(duration);
+            } else {
+                this.ended = true;
+                var endBehavior = this.item.endBehavior;
+                if (endBehavior === EndBehavior.freeze) {
+                    this.frozen = true;
+                }
+            }
+        } else if (this.item.endBehavior !== EndBehavior.restart) {
+            if (EndBehavior.destroy === this.item.endBehavior) {
+                var node = link.last;
+                if (node && node.content[0] < this.time) {
+                    this.destroyed = true;
                 }
             }
-            updateTrail();
         }
+        updateTrail();
     };
     _proto.drawStencilMask = function drawStencilMask(renderer) {
         if (!this.isActiveAndEnabled) {
@@ -25594,7 +25688,6 @@ exports.SpriteComponent = /*#__PURE__*/ function(MaskableGraphic) {
         _this = MaskableGraphic.call(this, engine) || this;
         _this.time = 0;
         _this.duration = 1;
-        _this.loop = true;
         /**
    * @internal
   */ _this.splits = singleSplits;
@@ -25609,11 +25702,13 @@ exports.SpriteComponent = /*#__PURE__*/ function(MaskableGraphic) {
         var _this = this;
         var time = this.time;
         var duration = this.duration;
-        if (time > duration && this.loop) {
+        var textureAnimation = this.textureSheetAnimation;
+        var _textureAnimation_loop;
+        var loop = (_textureAnimation_loop = textureAnimation == null ? void 0 : textureAnimation.loop) != null ? _textureAnimation_loop : true;
+        if (time > duration && loop) {
             time = time % duration;
         }
         var life = Math.min(Math.max(time / duration, 0.0), 1.0);
-        var ta = this.textureSheetAnimation;
         var video = this.renderer.texture.source.video;
         if (video) {
             if (time === 0) {
@@ -25625,9 +25720,9 @@ exports.SpriteComponent = /*#__PURE__*/ function(MaskableGraphic) {
             }
             this.renderer.texture.uploadCurrentVideoFrame();
         }
-        if (ta) {
+        if (textureAnimation) {
             var _this_material_getVector4;
-            var total = ta.total || ta.row * ta.col;
+            var total = textureAnimation.total || textureAnimation.row * textureAnimation.col;
             var texRectX = 0;
             var texRectY = 0;
             var texRectW = 1;
@@ -25648,20 +25743,20 @@ exports.SpriteComponent = /*#__PURE__*/ function(MaskableGraphic) {
             }
             var dx, dy;
             if (flip) {
-                dx = 1 / ta.row * texRectW;
-                dy = 1 / ta.col * texRectH;
+                dx = 1 / textureAnimation.row * texRectW;
+                dy = 1 / textureAnimation.col * texRectH;
             } else {
-                dx = 1 / ta.col * texRectW;
-                dy = 1 / ta.row * texRectH;
+                dx = 1 / textureAnimation.col * texRectW;
+                dy = 1 / textureAnimation.row * texRectH;
             }
             var texOffset;
-            if (ta.animate) {
+            if (textureAnimation.animate) {
                 var frameIndex = Math.round(life * (total - 1));
-                var yIndex = Math.floor(frameIndex / ta.col);
-                var xIndex = frameIndex - yIndex * ta.col;
+                var yIndex = Math.floor(frameIndex / textureAnimation.col);
+                var xIndex = frameIndex - yIndex * textureAnimation.col;
                 texOffset = flip ? [
                     dx * yIndex,
-                    dy * (ta.col - xIndex)
+                    dy * (textureAnimation.col - xIndex)
                 ] : [
                     dx * xIndex,
                     dy * (1 + yIndex)
@@ -25849,8 +25944,6 @@ exports.SpriteComponent = /*#__PURE__*/ function(MaskableGraphic) {
         var _data_duration;
         //@ts-expect-error
         this.duration = (_data_duration = data.duration) != null ? _data_duration : this.item.duration;
-        var _data_loop;
-        this.loop = (_data_loop = data.loop) != null ? _data_loop : true;
     };
     return SpriteComponent;
 }(MaskableGraphic);
@@ -25858,21 +25951,21 @@ exports.SpriteComponent = __decorate([
     effectsClass(DataType.SpriteComponent)
 ], exports.SpriteComponent);
 
-var ParticleLoader = /*#__PURE__*/ function(AbstractPlugin) {
-    _inherits(ParticleLoader, AbstractPlugin);
+var ParticleLoader = /*#__PURE__*/ function(Plugin) {
+    _inherits(ParticleLoader, Plugin);
     function ParticleLoader() {
-        return AbstractPlugin.apply(this, arguments);
+        return Plugin.apply(this, arguments);
     }
     return ParticleLoader;
-}(AbstractPlugin);
+}(_wrap_native_super(Plugin));
 
-var CalculateLoader = /*#__PURE__*/ function(AbstractPlugin) {
-    _inherits(CalculateLoader, AbstractPlugin);
+var CalculateLoader = /*#__PURE__*/ function(Plugin) {
+    _inherits(CalculateLoader, Plugin);
     function CalculateLoader() {
-        return AbstractPlugin.apply(this, arguments);
+        return Plugin.apply(this, arguments);
     }
     return CalculateLoader;
-}(AbstractPlugin);
+}(_wrap_native_super(Plugin));
 
 // Based on:
 /**
@@ -28974,6 +29067,12 @@ exports.TextComponent = /*#__PURE__*/ function(MaskableGraphic) {
         /**
    * 每一行文本的最大宽度
    */ _this.maxLineWidth = 0;
+        /**
+   * 初始文本宽度，用于计算缩放比例
+   */ _this.baseTextWidth = 0;
+        /**
+   * 初始 `transform.size.x`，用于按比例更新显示宽度
+   */ _this.baseScaleX = 1;
         _this.name = "MText" + seed$1++;
         // 初始化canvas资源
         _this.canvas = canvasPool.getCanvas();
@@ -28999,10 +29098,11 @@ exports.TextComponent = /*#__PURE__*/ function(MaskableGraphic) {
                 text: "默认文本",
                 fontFamily: "AlibabaSans-BoldItalic",
                 fontSize: 40,
+                // 统一使用 0-1 颜色值
                 textColor: [
-                    255,
-                    255,
-                    255,
+                    1,
+                    1,
+                    1,
                     1
                 ],
                 fontWeight: TextWeight.normal,
@@ -29039,6 +29139,10 @@ exports.TextComponent = /*#__PURE__*/ function(MaskableGraphic) {
         // TextComponentBase
         this.updateWithOptions(options);
         this.renderText(options);
+        // 记录初始的 textWidth 和 x 缩放，用于后续按比例更新显示宽度
+        // 添加兜底值 1 防止除 0
+        this.baseTextWidth = options.textWidth || this.textLayout.width || 1;
+        this.baseScaleX = this.item.transform.size.x;
         // 恢复默认颜色
         this.material.setColor("_Color", new Color(1, 1, 1, 1));
     };
@@ -29237,9 +29341,9 @@ exports.TextComponent = /*#__PURE__*/ function(MaskableGraphic) {
             if (style.isOutlined) {
                 _this.setupOutline();
             }
-            // 文本颜色 - 直接使用 vec4 原值，不乘以 255
+            // textColor 统一是 0-1，写入 canvas 时乘 255
             var _style_textColor = style.textColor, r = _style_textColor[0], g = _style_textColor[1], b = _style_textColor[2], a = _style_textColor[3];
-            context.fillStyle = "rgba(" + r + ", " + g + ", " + b + ", " + a + ")";
+            context.fillStyle = "rgba(" + r * 255 + ", " + g * 255 + ", " + b * 255 + ", " + a + ")";
             var charsInfo = [];
             var x = 0;
             var y = layout.getOffsetY(style, _this.lineCount, lineHeight, fontSize);
@@ -29301,6 +29405,31 @@ exports.TextComponent = /*#__PURE__*/ function(MaskableGraphic) {
         layout.autoWidth = normalizedValue;
         this.isDirty = true;
     };
+    /**
+   * 设置文本框宽度
+   * 手动设置宽度时会自动关闭 `autoWidth`
+   * 同时会按比例更新 `transform.size.x`，让 UI 框宽度也跟着变化
+   * @param value - 文本框宽度
+   */ _proto.setTextWidth = function setTextWidth(value) {
+        var width = Math.max(0, Number(value) || 0);
+        var layout = this.textLayout;
+        // 宽度没变且已是非 autoWidth 模式,直接返回
+        if (layout.width === width && layout.autoWidth === false) {
+            return;
+        }
+        // 手动设置宽度时关闭 autoWidth
+        layout.autoWidth = false;
+        layout.width = width;
+        // 按当前 overflow 模式重新计算行数和 maxLineWidth
+        this.lineCount = this.getLineCount(this.text || "");
+        this.isDirty = true;
+        // 同步更新外层显示宽度(按比例缩放 transform)
+        // 这样 UI 框的视觉宽度也会跟着文本宽度变化
+        if (this.baseTextWidth > 0) {
+            var scale = width / this.baseTextWidth;
+            this.item.transform.size.x = this.baseScaleX * scale;
+        }
+    };
     _proto.setFontSize = function setFontSize(value) {
         if (this.textStyle.fontSize === value) {
             return;
@@ -29368,13 +29497,13 @@ applyMixins(exports.TextComponent, [
 ]);
 
 // TODO: 注册必须用
-var TextLoader = /*#__PURE__*/ function(AbstractPlugin) {
-    _inherits(TextLoader, AbstractPlugin);
+var TextLoader = /*#__PURE__*/ function(Plugin) {
+    _inherits(TextLoader, Plugin);
     function TextLoader() {
-        return AbstractPlugin.apply(this, arguments);
+        return Plugin.apply(this, arguments);
     }
     return TextLoader;
-}(AbstractPlugin);
+}(_wrap_native_super(Plugin));
 
 var Asset = /*#__PURE__*/ function(EffectsObject) {
     _inherits(Asset, EffectsObject);
@@ -30431,6 +30560,10 @@ function version35Migration(json) {
             if (component.dataType === DataType.TextComponent || component.dataType === DataType.RichTextComponent && component.options) {
                 ensureTextVerticalAlign(component.options);
             }
+            // 处理文本颜色从 0-255 到 0-1 的转换
+            if (component.dataType === DataType.TextComponent) {
+                convertTextColorTo01(component.options);
+            }
         }
     }
     //@ts-expect-error
@@ -30450,6 +30583,22 @@ function version35Migration(json) {
         options.TextVerticalAlign = options.textBaseline;
     }
 }
+/**
+ * 将文本颜色从 0-255 转换到 0-1
+ */ function convertTextColorTo01(options) {
+    if (!options || !options.textColor) {
+        return;
+    }
+    var textColor = options.textColor;
+    var _textColor_;
+    // 将 RGB 从 0-255 转换到 0-1（alpha 通道已经是 0-1，不需要转换）
+    options.textColor = [
+        textColor[0] / 255.0,
+        textColor[1] / 255.0,
+        textColor[2] / 255.0,
+        (_textColor_ = textColor[3]) != null ? _textColor_ : 1
+    ];
+}
 /**
  * 根据形状获取形状几何体数据
  * @param shape - 形状
@@ -31226,6 +31375,7 @@ function getStandardParticleContent(particle) {
     }
     var textureSheetAnimation = particle.textureSheetAnimation;
     if (textureSheetAnimation) {
+        // @ts-expect-error
         ret.textureSheetAnimation = {
             row: textureSheetAnimation.row,
             col: textureSheetAnimation.col,
@@ -31355,6 +31505,7 @@ function getStandardSpriteContent(sprite, transform) {
     var ret = getStandardNullContent(sprite, transform);
     var texAni = sprite.textureSheetAnimation;
     if (texAni) {
+        // @ts-expect-error
         ret.textureSheetAnimation = {
             row: texAni.row,
             col: texAni.col,
@@ -31372,7 +31523,7 @@ function getStandardSpriteContent(sprite, transform) {
     return ret;
 }
 
-var version$1 = "2.8.0-alpha.3";
+var version$1 = "2.8.0-alpha.5";
 var v0 = /^(\d+)\.(\d+)\.(\d+)(-(\w+)\.\d+)?$/;
 var standardVersion = /^(\d+)\.(\d+)$/;
 var reverseParticle = false;
@@ -32012,8 +32163,8 @@ var seed = 1;
                                 };
                                 return [
                                     4,
-                                    hookTimeInfo("plugin:processAssets", function() {
-                                        return _this.processPluginAssets(scene);
+                                    hookTimeInfo("plugin:onAssetsLoadStart", function() {
+                                        return _this.onPluginSceneLoadStart(scene);
                                     })
                                 ];
                             case 6:
@@ -32021,7 +32172,7 @@ var seed = 1;
                                 _jsonScene_bins = jsonScene.bins, bins = _jsonScene_bins === void 0 ? [] : _jsonScene_bins, images = jsonScene.images, fonts = jsonScene.fonts;
                                 return [
                                     4,
-                                    Promise.all([
+                                    Promise.all([].concat([
                                         hookTimeInfo("processBins", function() {
                                             return _this.processBins(bins);
                                         }),
@@ -32031,7 +32182,11 @@ var seed = 1;
                                         hookTimeInfo("processFontURL", function() {
                                             return _this.processFontURL(fonts);
                                         })
-                                    ])
+                                    ], _this.options.useHevcVideo ? [
+                                        hookTimeInfo("processVideoURL", function() {
+                                            return _this.processVideoURL(jsonScene);
+                                        })
+                                    ] : []))
                                 ];
                             case 7:
                                 _ref = _state.sent(), loadedBins = _ref[0], loadedImages = _ref[1];
@@ -32301,7 +32456,7 @@ var seed = 1;
             });
         })();
     };
-    _proto.processPluginAssets = function processPluginAssets(scene) {
+    _proto.onPluginSceneLoadStart = function onPluginSceneLoadStart(scene) {
         var _this = this;
         return _async_to_generator(function() {
             return __generator(this, function(_state) {
@@ -32309,7 +32464,7 @@ var seed = 1;
                     case 0:
                         return [
                             4,
-                            PluginSystem.processAssets(scene, _this.options)
+                            PluginSystem.onAssetsLoadStart(scene, _this.options)
                         ];
                     case 1:
                         _state.sent();
@@ -32417,6 +32572,30 @@ var seed = 1;
             });
         })();
     };
+    _proto.processVideoURL = function processVideoURL(jsonScene) {
+        return _async_to_generator(function() {
+            return __generator(this, function(_state) {
+                if (!(jsonScene == null ? void 0 : jsonScene.videos) || !Array.isArray(jsonScene.videos)) {
+                    return [
+                        2
+                    ];
+                }
+                jsonScene.videos.forEach(function(video) {
+                    var hevc = video.hevc;
+                    if (!(hevc == null ? void 0 : hevc.url) || !(hevc == null ? void 0 : hevc.codec)) {
+                        return;
+                    }
+                    var codec = parseCodec(hevc.codec);
+                    if (codec && canPlayHevcCodec(codec)) {
+                        video.url = hevc.url;
+                    }
+                });
+                return [
+                    2
+                ];
+            });
+        })();
+    };
     _proto.loadJSON = function loadJSON(url) {
         var _this = this;
         return _async_to_generator(function() {
@@ -35010,8 +35189,8 @@ var SceneLoader = /*#__PURE__*/ function() {
                     case 1:
                         loadedScene = _state.sent();
                         engine.clearResources();
-                        // 触发插件系统 pluginSystem 的回调 prepareResource
-                        PluginSystem.loadResources(loadedScene, assetManager.options, engine);
+                        // 触发插件系统 pluginSystem 的回调 onAssetsLoadFinish
+                        PluginSystem.onAssetsLoadFinish(loadedScene, assetManager.options, engine);
                         engine.assetService.prepareAssets(loadedScene, loadedScene.assets);
                         engine.assetService.updateTextVariables(loadedScene, options.variables);
                         engine.assetService.initializeTexture(loadedScene);
@@ -35073,10 +35252,9 @@ registerPlugin("sprite", SpriteLoader);
 registerPlugin("particle", ParticleLoader);
 registerPlugin("cal", CalculateLoader);
 registerPlugin("interact", InteractLoader);
-var version = "2.8.0-alpha.3";
+var version = "2.8.0-alpha.5";
 logger.info("Core version: " + version + ".");
 
-exports.AbstractPlugin = AbstractPlugin;
 exports.ActivationMixerPlayable = ActivationMixerPlayable;
 exports.ActivationPlayable = ActivationPlayable;
 exports.AndNode = AndNode;
@@ -35176,6 +35354,7 @@ exports.PathSegments = PathSegments;
 exports.Playable = Playable;
 exports.PlayableAsset = PlayableAsset;
 exports.PlayableOutput = PlayableOutput;
+exports.Plugin = Plugin;
 exports.PluginSystem = PluginSystem;
 exports.PointerEventData = PointerEventData;
 exports.PolyStar = PolyStar;
@@ -35252,6 +35431,7 @@ exports.asserts = asserts;
 exports.base64ToFile = base64ToFile;
 exports.buildLine = buildLine;
 exports.calculateTranslation = calculateTranslation;
+exports.canPlayHevcCodec = canPlayHevcCodec;
 exports.canUseBOM = canUseBOM;
 exports.canvasPool = canvasPool;
 exports.closePointEps = closePointEps;
@@ -35345,6 +35525,7 @@ exports.noop = noop;
 exports.normalizeColor = normalizeColor;
 exports.numberToFix = numberToFix;
 exports.oldBezierKeyFramesToNew = oldBezierKeyFramesToNew;
+exports.parseCodec = parseCodec;
 exports.parsePercent = parsePercent$1;
 exports.particleFrag = particleFrag;
 exports.particleOriginTranslateMap = particleOriginTranslateMap$1;