@galacean/effects-threejs 2.10.0-alpha.3 → 2.10.0-alpha.4

package/dist/index.mjs

@@ -3,7 +3,7 @@
  * Description: Galacean Effects runtime threejs plugin for the web
  * Author: Ant Group CO., Ltd.
  * Contributors: 燃然,飂兮,十弦,云垣,茂安,意绮
- * Version: v2.10.0-alpha.3
+ * Version: v2.10.0-alpha.4
  */
 
 import * as THREE from 'three';
@@ -23128,10 +23128,10 @@ var Graphics = /*#__PURE__*/ function() {
         this.currentTransform = Matrix3.fromIdentity();
         this.currentBatchType = "colored";
         this.currentBatchTexture = null;
-        // 创建从屏幕坐标到 NDC 的投影矩阵，屏幕坐标: (0, 0) 在左下角，(width, height) 在右上角
+        // 创建从屏幕坐标到 NDC 的投影矩阵，屏幕坐标：(0, 0) 在左上角，(width, height) 在右下角，+Y 向下。
         var _this_engine_canvas_getBoundingClientRect = this.engine.canvas.getBoundingClientRect(), width = _this_engine_canvas_getBoundingClientRect.width, height = _this_engine_canvas_getBoundingClientRect.height;
         // 正交投影矩阵：将屏幕坐标 [0, width] x [0, height] 映射到 NDC [-1, 1] x [-1, 1]
-        var projectionMatrix = new Matrix4(2 / width, 0, 0, 0, 0, 2 / height, 0, 0, 0, 0, -1, 0, -1, -1, 0, 1 // 第四列
+        var projectionMatrix = new Matrix4(2 / width, 0, 0, 0, 0, -2 / height, 0, 0, 0, 0, -1, 0, -1, 1, 0, 1 // 第四列
         );
         this.coloredMaterial.setMatrix("effects_MatrixVP", projectionMatrix);
         this.texturedMaterial.setMatrix("effects_MatrixVP", projectionMatrix);
@@ -23296,8 +23296,8 @@ var Graphics = /*#__PURE__*/ function() {
     };
     /**
    * 绘制矩形边框
-   * @param x - 矩形左下角 X 坐标
-   * @param y - 矩形左下角 Y 坐标
+   * @param x - 矩形左上角 X 坐标
+   * @param y - 矩形左上角 Y 坐标
    * @param width - 矩形宽度
    * @param height - 矩形高度
    * @param color - 边框颜色，默认白色，范围 0-1
@@ -23340,8 +23340,8 @@ var Graphics = /*#__PURE__*/ function() {
     };
     /**
    * 绘制填充矩形
-   * @param x - 矩形左下角 X 坐标
-   * @param y - 矩形左下角 Y 坐标
+   * @param x - 矩形左上角 X 坐标
+   * @param y - 矩形左上角 Y 坐标
    * @param width - 矩形宽度
    * @param height - 矩形高度
    * @param color - 填充颜色，默认白色，范围 0-1
@@ -23367,9 +23367,9 @@ var Graphics = /*#__PURE__*/ function() {
         this.buildShape(this.circleShape, color);
     };
     /**
-   * 绘制纹理矩形（本地坐标，Y 向上，(x, y) 为左下角）
-   * @param x - 矩形左下角 X 坐标
-   * @param y - 矩形左下角 Y 坐标
+   * 绘制纹理矩形（本地坐标，Y 向下，(x, y) 为左上角）
+   * @param x - 矩形左上角 X 坐标
+   * @param y - 矩形左上角 Y 坐标
    * @param width - 矩形宽度
    * @param height - 矩形高度
    * @param texture - 要采样的纹理。同纹理连续绘制会合批，纹理切换会自动 flush 当前批次
@@ -23382,14 +23382,14 @@ var Graphics = /*#__PURE__*/ function() {
         this.pushQuad(x, y, width, height, color, region);
     };
     /**
-   * 绘制文本（本地坐标，Y 向上，(x, y) 为文本左下角）。
+   * 绘制文本（本地坐标，Y 向下，(x, y) 为文本 cell 左上角）。
    *
    * 文本走字符级 bitmap atlas（同一字体下每个字只渲染一次，任意文本组合复用 atlas）;
    * `color` 作为乘色与白色字形 alpha 相乘，任意颜色都不会污染 atlas。
    *
    * 字体参数全部展开，避免调用方每帧创建临时 style 对象触发 GC
-   * @param x - 文本左下角 X 坐标（首字 ink 起始处，含 padding 的 quad 会向左延伸）
-   * @param y - 文本左下角 Y 坐标（cell 底，含底部 padding；字形 ink 在其上方 padding+ascent 处）
+   * @param x - 文本左上角 X 坐标（首字 ink 起始处，含 padding 的 quad 会向左延伸）
+   * @param y - 文本 cell 顶部 Y 坐标
    * @param text - 要绘制的文本内容，空串直接 return
    * @param fontSize - 字号（逻辑像素）
    * @param color - 乘色，默认白色，范围 0-1
@@ -23504,7 +23504,7 @@ var Graphics = /*#__PURE__*/ function() {
    * 在像素级亚像素精度下会暴露 1-2 像素缝隙，叠层时底层颜色透出形成可见的对角痕迹
    */ _proto.pushQuad = function pushQuad(x, y, width, height, color, region) {
         var vertexOffset = this.vertices.length / 2;
-        // 4 顶点（本地坐标，左下/右下/左上/右上），应用当前变换写入 vertices
+        // 4 顶点（本地坐标，左上/右上/左下/右下），应用当前变换写入 vertices
         var corners = [
             [
                 x,
@@ -23530,19 +23530,19 @@ var Graphics = /*#__PURE__*/ function() {
         var cornerUVs = [
             [
                 u0,
-                v0
+                v1
             ],
             [
                 u1,
-                v0
+                v1
             ],
             [
                 u0,
-                v1
+                v0
             ],
             [
                 u1,
-                v1
+                v0
             ]
         ];
         for(var i = 0; i < 4; i++){
@@ -24636,8 +24636,18 @@ var InputEvent = /*#__PURE__*/ function() {
         this.device = 0;
         this.pressed = false;
         this.canceled = false;
+        this._accepted = false;
     }
     var _proto = InputEvent.prototype;
+    _proto.accept = function accept() {
+        this._accepted = true;
+    };
+    _proto.clearAccepted = function clearAccepted() {
+        this._accepted = false;
+    };
+    _proto.isAccepted = function isAccepted() {
+        return this._accepted;
+    };
     _proto.isPressed = function isPressed() {
         return this.pressed && !this.canceled;
     };
@@ -24651,11 +24661,7 @@ var InputEvent = /*#__PURE__*/ function() {
         return false;
     };
     _proto.xformedBy = function xformedBy(transform) {
-        var event = new InputEvent();
-        event.device = this.device;
-        event.pressed = this.pressed;
-        event.canceled = this.canceled;
-        return event;
+        return this;
     };
     return InputEvent;
 }();
@@ -24686,11 +24692,6 @@ var InputEventWithModifiers = /*#__PURE__*/ function(InputEvent) {
         event.metaPressed = this.metaPressed;
         event.ctrlPressed = this.ctrlPressed;
     };
-    _proto.xformedBy = function xformedBy(transform) {
-        var event = new InputEventWithModifiers();
-        this.copyModifiersTo(event);
-        return event;
-    };
     return InputEventWithModifiers;
 }(_wrap_native_super(InputEvent));
 var InputEventKey = /*#__PURE__*/ function(InputEventWithModifiers) {
@@ -24710,17 +24711,6 @@ var InputEventKey = /*#__PURE__*/ function(InputEventWithModifiers) {
     _proto.isEcho = function isEcho() {
         return this.echo;
     };
-    _proto.xformedBy = function xformedBy(transform) {
-        var event = new InputEventKey();
-        this.copyModifiersTo(event);
-        event.keycode = this.keycode;
-        event.physicalKeycode = this.physicalKeycode;
-        event.keyLabel = this.keyLabel;
-        event.unicode = this.unicode;
-        event.location = this.location;
-        event.echo = this.echo;
-        return event;
-    };
     return InputEventKey;
 }(InputEventWithModifiers);
 var InputEventMouse = /*#__PURE__*/ function(InputEventWithModifiers) {
@@ -24740,12 +24730,6 @@ var InputEventMouse = /*#__PURE__*/ function(InputEventWithModifiers) {
         event.position.copyFrom(this.position);
         event.globalPosition.copyFrom(this.globalPosition);
     };
-    _proto.xformedBy = function xformedBy(transform) {
-        var event = new InputEventMouse();
-        this.copyMouseTo(event);
-        event.position.copyFrom(transformPoint(transform, this.position));
-        return event;
-    };
     return InputEventMouse;
 }(InputEventWithModifiers);
 var InputEventMouseButton = /*#__PURE__*/ function(InputEventMouse) {
@@ -24862,27 +24846,27 @@ var InputEventScreenDrag = /*#__PURE__*/ function(InputEvent) {
 var ANCHOR_PRESET_TABLE = {
     topLeft: [
         0,
-        1,
         0,
-        1
+        0,
+        0
     ],
     topRight: [
         1,
+        0,
         1,
-        1,
-        1
+        0
     ],
     bottomLeft: [
         0,
+        1,
         0,
-        0,
-        0
+        1
     ],
     bottomRight: [
         1,
-        0,
         1,
-        0
+        1,
+        1
     ],
     centerLeft: [
         0,
@@ -24892,9 +24876,9 @@ var ANCHOR_PRESET_TABLE = {
     ],
     centerTop: [
         0.5,
-        1,
+        0,
         0.5,
-        1
+        0
     ],
     centerRight: [
         1,
@@ -24904,9 +24888,9 @@ var ANCHOR_PRESET_TABLE = {
     ],
     centerBottom: [
         0.5,
-        0,
+        1,
         0.5,
-        0
+        1
     ],
     center: [
         0.5,
@@ -24921,10 +24905,10 @@ var ANCHOR_PRESET_TABLE = {
         1
     ],
     topWide: [
+        0,
         0,
         1,
-        1,
-        1
+        0
     ],
     rightWide: [
         1,
@@ -24933,10 +24917,10 @@ var ANCHOR_PRESET_TABLE = {
         1
     ],
     bottomWide: [
-        0,
         0,
         1,
-        0
+        1,
+        1
     ],
     vcenterWide: [
         0.5,
@@ -25122,6 +25106,7 @@ var ANCHOR_PRESET_TABLE = {
         var a = this.anchorMin;
         var b = this.anchorMax;
         var minX = 0, maxX = 0, minY = 0, maxY = 0;
+        // Left edge.
         switch(preset){
             case "topLeft":
             case "bottomLeft":
@@ -25132,41 +25117,71 @@ var ANCHOR_PRESET_TABLE = {
             case "hcenterWide":
             case "fullRect":
                 minX = margin - a.x * parentSize.x;
-                maxX = margin + width - b.x * parentSize.x;
                 break;
             case "centerTop":
             case "centerBottom":
             case "center":
             case "vcenterWide":
                 minX = 0.5 * parentSize.x - width / 2 - a.x * parentSize.x;
-                maxX = 0.5 * parentSize.x + width / 2 - b.x * parentSize.x;
                 break;
             default:
                 minX = parentSize.x - margin - width - a.x * parentSize.x;
-                maxX = parentSize.x - margin - b.x * parentSize.x;
                 break;
         }
         switch(preset){
+            case "topLeft":
             case "bottomLeft":
-            case "bottomRight":
+            case "centerLeft":
+            case "leftWide":
+                maxX = margin + width - b.x * parentSize.x;
+                break;
+            case "centerTop":
             case "centerBottom":
+            case "center":
+            case "vcenterWide":
+                maxX = 0.5 * parentSize.x + width / 2 - b.x * parentSize.x;
+                break;
+            default:
+                maxX = parentSize.x - margin - b.x * parentSize.x;
+                break;
+        }
+        // Top edge.
+        switch(preset){
+            case "topLeft":
+            case "topRight":
+            case "centerTop":
             case "leftWide":
             case "rightWide":
-            case "bottomWide":
+            case "topWide":
             case "vcenterWide":
             case "fullRect":
                 minY = margin - a.y * parentSize.y;
-                maxY = margin + height - b.y * parentSize.y;
                 break;
             case "centerLeft":
             case "centerRight":
             case "center":
             case "hcenterWide":
                 minY = 0.5 * parentSize.y - height / 2 - a.y * parentSize.y;
-                maxY = 0.5 * parentSize.y + height / 2 - b.y * parentSize.y;
                 break;
             default:
                 minY = parentSize.y - margin - height - a.y * parentSize.y;
+                break;
+        }
+        // Bottom edge.
+        switch(preset){
+            case "topLeft":
+            case "topRight":
+            case "centerTop":
+            case "topWide":
+                maxY = margin + height - b.y * parentSize.y;
+                break;
+            case "centerLeft":
+            case "centerRight":
+            case "center":
+            case "hcenterWide":
+                maxY = 0.5 * parentSize.y + height / 2 - b.y * parentSize.y;
+                break;
+            default:
                 maxY = parentSize.y - margin - b.y * parentSize.y;
                 break;
         }
@@ -25195,10 +25210,6 @@ var ANCHOR_PRESET_TABLE = {
     _proto.getCursorShape = function getCursorShape(position) {
         return this.defaultCursorShape;
     };
-    _proto.acceptEvent = function acceptEvent() {
-        var _this_root;
-        (_this_root = this.root) == null ? void 0 : _this_root.acceptControlEvent(this);
-    };
     _proto.focus = function focus() {
         var _this_root;
         (_this_root = this.root) == null ? void 0 : _this_root.grabControlFocus(this);
@@ -25279,14 +25290,14 @@ var ANCHOR_PRESET_TABLE = {
         this.engine.graphics.drawText(x, y, text, fontSize, color, fontFamily, fontWeight, fontStyle);
     };
     _proto.onMouseEnter = function onMouseEnter(location) {};
-    _proto.onMouseMove = function onMouseMove(location, event) {};
+    _proto.onMouseMove = function onMouseMove(event) {};
     _proto.onMouseLeave = function onMouseLeave() {};
-    _proto.onMouseWheel = function onMouseWheel(location, delta, event) {};
-    _proto.onMouseDown = function onMouseDown(location, button, event) {};
-    _proto.onMouseUp = function onMouseUp(location, button, event) {};
-    _proto.onTouchDown = function onTouchDown(location, pointerId, event) {};
-    _proto.onTouchMove = function onTouchMove(location, pointerId, event) {};
-    _proto.onTouchUp = function onTouchUp(location, pointerId, event) {};
+    _proto.onMouseWheel = function onMouseWheel(event) {};
+    _proto.onMouseDown = function onMouseDown(event) {};
+    _proto.onMouseUp = function onMouseUp(event) {};
+    _proto.onTouchDown = function onTouchDown(event) {};
+    _proto.onTouchMove = function onTouchMove(event) {};
+    _proto.onTouchUp = function onTouchUp(event) {};
     _proto.onKeyDown = function onKeyDown(event) {};
     _proto.onKeyUp = function onKeyUp(event) {};
     _proto.onGotFocus = function onGotFocus() {};
@@ -25321,10 +25332,10 @@ var ANCHOR_PRESET_TABLE = {
         var _this_parent_size;
         var parentSize = (_this_parent_size = (_this_parent = this.parent) == null ? void 0 : _this_parent.size) != null ? _this_parent_size : new Vector2();
         var left = this.offsetMin.x + this.anchorMin.x * parentSize.x;
-        var bottom = this.offsetMin.y + this.anchorMin.y * parentSize.y;
+        var top = this.offsetMin.y + this.anchorMin.y * parentSize.y;
         var right = this.offsetMax.x + this.anchorMax.x * parentSize.x;
-        var top = this.offsetMax.y + this.anchorMax.y * parentSize.y;
-        this.applyBounds(left, bottom, right - left, top - bottom);
+        var bottom = this.offsetMax.y + this.anchorMax.y * parentSize.y;
+        this.applyBounds(left, top, right - left, bottom - top);
     };
     _proto.applyBounds = function applyBounds(x, y, width, height) {
         var locationChanged = this.position.x !== x || this.position.y !== y;
@@ -25535,7 +25546,12 @@ var ANCHOR_PRESET_TABLE = {
                 return this._defaultCursorShape;
             },
             set: function set(value) {
+                var _this_root;
+                if (this._defaultCursorShape === value) {
+                    return;
+                }
                 this._defaultCursorShape = value;
+                (_this_root = this.root) == null ? void 0 : _this_root.updateMouseCursorState();
             }
         },
         {
@@ -25719,9 +25735,6 @@ function getButtonMask(button) {
 function isWheelButton(button) {
     return button >= MouseButton.WheelUp && button <= MouseButton.WheelRight;
 }
-function getWheelDelta(event) {
-    return event.buttonIndex === MouseButton.WheelUp || event.buttonIndex === MouseButton.WheelLeft ? event.factor : -event.factor;
-}
 /** CanvasLayer-like boundary for a single UICanvas GUI tree. */ var CanvasRootControl = /*#__PURE__*/ function(ContainerControl) {
     _inherits(CanvasRootControl, ContainerControl);
     function CanvasRootControl(engine, canvas) {
@@ -25780,7 +25793,7 @@ function getWheelDelta(event) {
         var _this;
         _this = RootControl.call(this, engine) || this;
         _this.dragThreshold = 10;
-        _this.inputHandled = false;
+        _this.lastInput = null;
         _this.gui = {
             mouseFocus: null,
             mouseClickGrabber: null,
@@ -25807,13 +25820,16 @@ function getWheelDelta(event) {
     }
     var _proto = WindowRootControl.prototype;
     _proto.pushInput = function pushInput(event) {
-        this.inputHandled = false;
+        event.clearAccepted();
+        this.lastInput = event;
         this.cleanupInternalState();
         this.processGUIInput(event);
         this.postGrabClickFocus();
     };
     _proto.isInputHandled = function isInputHandled() {
-        return this.inputHandled;
+        var _this_lastInput;
+        var _this_lastInput_isAccepted;
+        return (_this_lastInput_isAccepted = (_this_lastInput = this.lastInput) == null ? void 0 : _this_lastInput.isAccepted()) != null ? _this_lastInput_isAccepted : false;
     };
     _proto.getMousePosition = function getMousePosition() {
         return this.gui.lastMousePosition.clone();
@@ -25836,11 +25852,6 @@ function getWheelDelta(event) {
     _proto.guiCancelDrag = function guiCancelDrag() {
         this.endDragging(false);
     };
-    _proto.acceptControlEvent = function acceptControlEvent(control) {
-        if (this.isControlUsable(control)) {
-            this.inputHandled = true;
-        }
-    };
     _proto.grabControlFocus = function grabControlFocus(control) {
         if (!this.isFocusTargetUsable(control) || this.gui.keyFocus === control) {
             return;
@@ -25874,6 +25885,12 @@ function getWheelDelta(event) {
     _proto.warpControlMouse = function warpControlMouse(position) {
         this.gui.lastMousePosition.copyFrom(position);
         this.updateMouseOver(position);
+        this.updateMouseCursorState();
+    };
+    _proto.updateMouseCursorState = function updateMouseCursorState() {
+        var position = this.gui.lastMousePosition;
+        var target = this.isControlUsable(this.gui.mouseFocus) ? this.gui.mouseFocus : this.isControlUsable(this.gui.mouseOver) ? this.gui.mouseOver : null;
+        this.updateCursor(target, position);
     };
     _proto.controlStateChanged = function controlStateChanged(control) {
         if (!this.isControlUsable(control)) {
@@ -26026,11 +26043,15 @@ function getWheelDelta(event) {
         while(current && current !== this && this.isControlUsable(current)){
             var filter = current.getEffectiveMouseFilter();
             if (filter !== MouseFilter.Ignore) {
-                this.callControlInput(current, event.xformedBy(this.getGlobalInverse(current)));
+                var localEvent = event.xformedBy(this.getGlobalInverse(current));
+                this.callControlInput(current, localEvent);
+                if (localEvent.isAccepted()) {
+                    event.accept();
+                }
             }
             var forcePassWheel = _instanceof1(event, InputEventMouseButton) && isWheelButton(event.buttonIndex) && current.mouseForcePassScrollEvents;
-            if (this.inputHandled || filter === MouseFilter.Stop && pointerEvent && !forcePassWheel) {
-                this.inputHandled = true;
+            if (event.isAccepted() || filter === MouseFilter.Stop && pointerEvent && !forcePassWheel) {
+                event.accept();
                 return;
             }
             current = current.parent;
@@ -26039,22 +26060,22 @@ function getWheelDelta(event) {
     _proto.callControlInput = function callControlInput(control, event) {
         if (_instanceof1(event, InputEventMouseButton)) {
             if (isWheelButton(event.buttonIndex)) {
-                control.onMouseWheel(event.position, getWheelDelta(event), event);
+                control.onMouseWheel(event);
             } else if (event.isPressed()) {
-                control.onMouseDown(event.position, event.buttonIndex, event);
+                control.onMouseDown(event);
             } else {
-                control.onMouseUp(event.position, event.buttonIndex, event);
+                control.onMouseUp(event);
             }
         } else if (_instanceof1(event, InputEventMouseMotion)) {
-            control.onMouseMove(event.position, event);
+            control.onMouseMove(event);
         } else if (_instanceof1(event, InputEventScreenTouch)) {
             if (event.isPressed()) {
-                control.onTouchDown(event.position, event.index, event);
+                control.onTouchDown(event);
             } else {
-                control.onTouchUp(event.position, event.index, event);
+                control.onTouchUp(event);
             }
         } else if (_instanceof1(event, InputEventScreenDrag)) {
-            control.onTouchMove(event.position, event.index, event);
+            control.onTouchMove(event);
         } else if (_instanceof1(event, InputEventKey)) {
             if (event.isPressed()) {
                 control.onKeyDown(event);
@@ -26205,11 +26226,11 @@ function getWheelDelta(event) {
     };
     _proto.updateCursor = function updateCursor(target, position) {
         var current = target;
-        var shape = CursorShape.Arrow;
+        var cursor = CursorShape.Arrow;
         while(current && current !== this){
             var candidate = current.getCursorShape(this.toLocal(current, position));
             if (candidate !== CursorShape.Arrow) {
-                shape = candidate;
+                cursor = candidate;
                 break;
             }
             if (current.getEffectiveMouseFilter() === MouseFilter.Stop) {
@@ -26217,7 +26238,7 @@ function getWheelDelta(event) {
             }
             current = current.parent;
         }
-        this.engine.canvas.style.cursor = cursorNames[shape];
+        this.engine.canvas.style.cursor = typeof cursor === "string" ? cursor : cursorNames[cursor];
     };
     _proto.postGrabClickFocus = function postGrabClickFocus() {
         var target = this.gui.mouseClickGrabber;
@@ -26869,8 +26890,8 @@ var EventSystem = /*#__PURE__*/ function() {
         if (!this.enabled || !this.target) {
             return;
         }
-        this.focusTarget();
         var position = this.getCanvasPosition(event.clientX, event.clientY);
+        this.focusTarget();
         var state = this.createPointerState(position);
         this.mouseState = state;
         state.pressed = true;
@@ -27162,12 +27183,14 @@ var EventSystem = /*#__PURE__*/ function() {
         var _target_width, _target_height;
         return {
             x: position.x / cssWidth * 2 - 1,
-            y: position.y / cssHeight * 2 - 1,
+            // Legacy composition picking uses bottom-left, Y-up NDC even though GUI
+            // input follows the DOM convention of top-left, Y-down pixels.
+            y: 1 - position.y / cssHeight * 2,
             vx: velocity.x / cssWidth * 2,
-            vy: velocity.y / cssHeight * 2,
+            vy: -velocity.y / cssHeight * 2,
             ts: performance.now(),
             dx: (position.x - state.start.x) / cssWidth * 2,
-            dy: (position.y - state.start.y) / cssHeight * 2,
+            dy: -(position.y - state.start.y) / cssHeight * 2,
             width: (_target_width = target == null ? void 0 : target.width) != null ? _target_width : 0,
             height: (_target_height = target == null ? void 0 : target.height) != null ? _target_height : 0,
             origin: origin
@@ -27179,7 +27202,7 @@ var EventSystem = /*#__PURE__*/ function() {
         if (!rect) {
             return new Vector2();
         }
-        return new Vector2(clientX - rect.left, rect.bottom - clientY);
+        return new Vector2(clientX - rect.left, clientY - rect.top);
     };
     _proto.consumeNativeEvent = function consumeNativeEvent(event, handled) {
         if (handled && !this.allowPropagation) {
@@ -27195,9 +27218,8 @@ var EventSystem = /*#__PURE__*/ function() {
         }
     };
     _proto.focusTarget = function focusTarget() {
-        if (this.target && document.activeElement !== this.target) {
-            this.target.focus();
-        }
+        var _this_target;
+        (_this_target = this.target) == null ? void 0 : _this_target.focus();
     };
     _proto.addNativeHandler = function addNativeHandler(target, name, handler, options) {
         target.addEventListener(name, handler, options);
@@ -39334,7 +39356,7 @@ function getStandardSpriteContent(sprite, transform) {
     return ret;
 }
 
-var version$2 = "2.10.0-alpha.3";
+var version$2 = "2.10.0-alpha.4";
 var v0 = /^(\d+)\.(\d+)\.(\d+)(-(\w+)\.\d+)?$/;
 var standardVersion = /^(\d+)\.(\d+)$/;
 var reverseParticle = false;
@@ -44564,7 +44586,7 @@ registerPlugin("text", TextLoader);
 registerPlugin("sprite", SpriteLoader);
 registerPlugin("particle", ParticleLoader);
 registerPlugin("interact", InteractLoader);
-var version$1 = "2.10.0-alpha.3";
+var version$1 = "2.10.0-alpha.4";
 logger.info("Core version: " + version$1 + ".");
 
 var _obj;
@@ -46057,7 +46079,7 @@ applyMixins(ThreeTextComponent, [
  */ Mesh.create = function(engine, props) {
     return new ThreeMesh(engine, props);
 };
-var version = "2.10.0-alpha.3";
+var version = "2.10.0-alpha.4";
 logger.info("THREEJS plugin version: " + version + ".");
 
 export { ATLAS_SIZE, ActivationMixerPlayable, ActivationPlayable, ActivationPlayableAsset, ActivationTrack, AndNode, AndNodeData, Animatable, AnimationClip, AnimationClipNode, AnimationClipNodeData, AnimationEvent, AnimationGraphAsset, Animator, ApplyAdditiveNode, ApplyAdditiveNodeData, Asset, AssetLoader, AssetManager, AssetService, BYTES_TYPE_MAP, Behaviour, BezierCurve, BezierCurvePath, BezierCurveQuat, BezierDataMap, BezierEasing, BezierLengthData, BezierMap, BezierPath, BezierQuat, BinaryAsset, BlendNode, BlendNodeData, BoolValueNode, BoundingBoxInfo, Buffer, BufferDataType, BufferUsage, CONSTANT_MAP_BLEND, CONSTANT_MAP_DEPTH, CONSTANT_MAP_STENCIL_FUNC, CONSTANT_MAP_STENCIL_OP, COPY_FRAGMENT_SHADER, COPY_MESH_SHADER_ID, COPY_VERTEX_SHADER, Camera, CameraController, CameraVFXItemLoader, CanvasContainer, CanvasRenderMode, CanvasRootControl, Circle$1 as Circle, ColorCurve, ColorPlayable, ColorPropertyMixerPlayable, ColorPropertyPlayableAsset, ColorPropertyTrack, Component, ComponentTimePlayable, ComponentTimePlayableAsset, ComponentTimeTrack, Composition, CompositionComponent, CompressTextureCapabilityType, ConstBoolNode, ConstBoolNodeData, ConstFloatNode, ConstFloatNodeData, ConstraintTarget, ContainerControl, Control, ControlParameterBoolNode, ControlParameterBoolNodeData, ControlParameterFloatNode, ControlParameterFloatNodeData, ControlParameterTriggerNode, ControlParameterTriggerNodeData, CursorShape, DEFAULT_FONTS, DEFAULT_FPS, DataBuffer, Database, Deferred, DestroyOptions, Downloader, DrawObjectPass, EFFECTS_COPY_MESH_NAME, EVENT_TYPE_CLICK, EVENT_TYPE_TOUCH_END, EVENT_TYPE_TOUCH_MOVE, EVENT_TYPE_TOUCH_START, EffectComponent, EffectComponentTimeTrack, EffectsObject, EffectsPackage, Ellipse, Engine, EqualNodeData, EventEmitter, EventSystem, Fake3DAnimationMode, Fake3DComponent, FilterMode, Float16ArrayWrapper, FloatComparisonNode, FloatComparisonNodeData, FloatPropertyMixerPlayable, FloatPropertyPlayableAsset, FloatPropertyTrack, FloatValueNode, FocusBehaviorRecursive, FocusMode, FrameComponent, Framebuffer, GLSLVersion, GPUCapability, Geometry, GlobalUniforms, GlyphAtlas, GradientValue, GraphInstance, GraphNode, GraphNodeData, Graphics, GreaterNodeData, HELP_LINK, HitTestType, InputEvent, InputEventKey, InputEventMouse, InputEventMouseButton, InputEventMouseMotion, InputEventScreenDrag, InputEventScreenTouch, InputEventWithModifiers, InteractComponent, InteractLoader, InteractMesh, InvalidIndex, Item, KeyLocation, LayerBlendNode, LayerBlendNodeData, LessNodeData, LineSegments, LinearValue, MaskMode, MaskProcessor, MaskableGraphic, Material, MaterialDataBlock, MaterialRenderType, MaterialState, MaterialTrack, Mesh, MouseBehaviorRecursive, MouseButton, MouseButtonMask, MouseFilter, NodeTransform, NotNode, NotNodeData, NotifyEvent, ObjectBindingTrack, OrNode, OrNodeData, OrderType, PLAYER_OPTIONS_ENV_EDITOR, POST_PROCESS_SETTINGS, ParticleBehaviourPlayable, ParticleBehaviourPlayableAsset, ParticleLoader, ParticleMesh, ParticleMixerPlayable, ParticleSystem, ParticleSystemRenderer, ParticleTrack, PassTextureCache, PathSegments, PlayState, Playable, PlayableAsset, PlayableOutput, Plugin, PluginSystem, PointerEventData, PointerEventType, PolyStar, Polygon, Pose, PoseNode, PositionConstraint, PostProcessVolume, Precomposition, PrecompositionManager, PropertyClipPlayable, PropertyTrack, REFERENCE_CURVE, RENDER_PREFER_LOOKUP_TEXTURE, RUNTIME_ENV, RandomSetValue, RandomValue, RandomVectorValue, RaycastResult, Rectangle$1 as Rectangle, ReferenceCurve, RenderFrame, RenderPass, RenderPassAttachmentStorageType, RenderPassDestroyAttachmentType, RenderPassPriorityNormal, RenderPassPriorityPostprocess, RenderPassPriorityPrepare, RenderTargetHandle, RenderTargetPool, RenderTextureFormat, Renderbuffer, Renderer, RendererComponent, RootControl, RuntimeClip, SEMANTIC_MAIN_PRE_COLOR_ATTACHMENT_0, SEMANTIC_MAIN_PRE_COLOR_ATTACHMENT_SIZE_0, SEMANTIC_PRE_COLOR_ATTACHMENT_0, SEMANTIC_PRE_COLOR_ATTACHMENT_SIZE_0, SPRITE_VERTEX_STRIDE, Scene, SceneLoader, SerializationHelper, Shader, ShaderCompileResultStatus, ShaderFactory, ShaderType, ShaderVariant, ShapeComponent, SourceType, Sprite, SpriteColorMixerPlayable, SpriteColorPlayableAsset, SpriteColorTrack, SpriteComponent, SpriteComponentTimeTrack, SpriteLoader, SpritePropertyMixerPlayable, SpritePropertyPlayableAsset, SpritePropertyTrack, SpriteRotation, StarType, StateMachineNode, StateMachineNodeData, StateNode, StateNodeData, StaticValue, SubCompositionClipPlayable, SubCompositionMixerPlayable, SubCompositionPlayableAsset, SubCompositionTrack, TEMPLATE_USE_OFFSCREEN_CANVAS, TEXTURE_UNIFORM_MAP, TangentMode, TextCache, TextComponent, TextComponentBase, TextLayout, TextLoader, TextStyle, Texture, TextureFactory, TextureLoadAction, TexturePaintScaleMode, TextureSourceType, TextureStoreAction, ThreeComposition, ThreeDisplayObject, ThreeEngine, ThreeMaterial, ThreeSpriteComponent, ThreeTextComponent, ThreeTexture, Ticker, TimelineAsset, TimelineClip, TimelineInstance, TrackAsset, TrackMixerPlayable, TrackType, Transform, TransformMixerPlayable, TransformPlayable, TransformPlayableAsset, TransformTrack, TransitionNode, TransitionNodeData, TransitionState, Triangle, TrimPath, TrimPathMode, UICanvas, UIControl, UpdateModes, VFXItem, ValueGetter, ValueNode, Vector2Curve, Vector2PropertyMixerPlayable, Vector2PropertyPlayableAsset, Vector2PropertyTrack, Vector3Curve, Vector3PropertyMixerPlayable, Vector3PropertyTrack, Vector3ropertyPlayableAsset, Vector4Curve, Vector4PropertyMixerPlayable, Vector4PropertyPlayableAsset, Vector4PropertyTrack, VertexBuffer, WeightedMode, WindowRootControl, addByOrder, addItem, addItemWithOrder, applyMixins, assertExist, asserts, base64ToFile, breakOpportunityAfter, buildBezierData, buildEasingCurve, buildLine, calculateTranslation, canUseBOM, canvasPool, closePointEps, colorGradingFrag, colorStopsFromGradient, colorToArr$1 as colorToArr, combineImageTemplate, createGLContext, createKeyFrameMeta, createShape, createTypedArray, createValueGetter, curveEps, decimalEqual, deserializeMipmapTexture, earcut, effectsClass, effectsClassStore, enlargeBuffer, ensureFixedNumber, ensureVec3, extractMinAndMax, gaussianDownHFrag, gaussianDownVFrag, gaussianUpFrag, generateEmptyTexture, generateEmptyTypedArray, generateGUID, generateHalfFloatTexture, generateWhiteTexture, getBackgroundImage, getBytesPerElement, getClass, getColorFromGradientStops, getConfig, getControlPoints, getDataByteLength, getDataType, getDefaultTextureFactory, getGeometryByShape, getGeometryTriangles, getKeyFrameMetaByRawValue, getMergedStore, getNodeDataClass, getParticleMeshShader, getPixelRatio, getPluginUsageInfo, getPreMultiAlpha, getStandardComposition, getStandardImage, getStandardItem, getStandardJSON, getTextureSize, glContext, glType2VertexFormatType, gpuTimer, imageDataFromColor, imageDataFromGradient, initErrors, initGLContext, integrate, interpolateColor, isAlipayMiniApp, isAndroid, isArray, isBreakChar, isCJKLike, isCanvas, isFunction, isIOS, isIOSByUA, isMiniProgram, isObject, isOpenHarmony, isPlainObject, isPowerOfTwo, isSafeFontFamily, isSimulatorCellPhone, isString, isUniformStruct, isUniformStructArray, isValidFontFamily, isWebGL2, isWechatMiniApp, itemFrag, itemVert, loadAVIFOptional, loadBinary, loadBlob, loadImage, loadMedia, loadVideo, loadWebPOptional, logger, index as math, modifyMaxKeyframeShader, nearestPowerOfTwo, nodeDataClass, noop, normalizeColor, numberToFix, oldBezierKeyFramesToNew, parsePercent$1 as parsePercent, particleFrag, particleOriginTranslateMap$1 as particleOriginTranslateMap, particleUniformTypeMap, particleVert, passRenderLevel, pluginLoaderMap, randomInRange, registerPlugin, removeItem, rotateVec2, screenMeshVert, serialize, setBlendMode, setConfig, setDefaultTextureFactory, setMaskMode, setRayFromCamera, setSideMode, setUniformValue, sortByOrder, index$1 as spec, textureLoaderRegistry, thresholdFrag, throwDestroyedError, toBufferView, trailVert, translatePoint, trianglesFromRect, unregisterPlugin, valIfUndefined, value, valueDefine, vecFill, vecMulCombine, version, vertexFormatType2GLType };