@galacean/effects-core 2.10.0-alpha.2 → 2.10.0-alpha.4

package/dist/input/enums.d.ts

@@ -0,0 +1,67 @@
+export declare enum MouseFilter {
+    Stop = 0,
+    Pass = 1,
+    Ignore = 2
+}
+export declare enum MouseBehaviorRecursive {
+    Inherited = 0,
+    Disabled = 1,
+    Enabled = 2
+}
+export declare enum MouseButton {
+    None = 0,
+    Left = 1,
+    Right = 2,
+    Middle = 3,
+    WheelUp = 4,
+    WheelDown = 5,
+    WheelLeft = 6,
+    WheelRight = 7,
+    Xbutton1 = 8,
+    Xbutton2 = 9
+}
+export declare enum MouseButtonMask {
+    None = 0,
+    Left = 1,
+    Right = 2,
+    Middle = 4,
+    Xbutton1 = 128,
+    Xbutton2 = 256
+}
+export declare enum FocusMode {
+    None = 0,
+    Click = 1,
+    All = 2,
+    Accessibility = 3
+}
+export declare enum FocusBehaviorRecursive {
+    Inherited = 0,
+    Disabled = 1,
+    Enabled = 2
+}
+export declare enum KeyLocation {
+    Unspecified = 0,
+    Left = 1,
+    Right = 2
+}
+export declare enum CursorShape {
+    Arrow = 0,
+    Ibeam = 1,
+    PointingHand = 2,
+    Cross = 3,
+    Wait = 4,
+    Busy = 5,
+    Drag = 6,
+    CanDrop = 7,
+    Forbidden = 8,
+    Vsize = 9,
+    Hsize = 10,
+    Bdiagsize = 11,
+    Fdiagsize = 12,
+    Move = 13,
+    Vsplit = 14,
+    Hsplit = 15,
+    Help = 16
+}
+/** A preset cursor shape or a complete CSS cursor value. */
+export type CursorStyle = CursorShape | string;

package/dist/input/index.d.ts

@@ -0,0 +1,2 @@
+export * from './enums';
+export * from './input-event';

package/dist/input/input-event.d.ts

@@ -0,0 +1,78 @@
+import type { Matrix3 } from '@galacean/effects-math/es/core/matrix3';
+import { Vector2 } from '@galacean/effects-math/es/core/vector2';
+import { KeyLocation, MouseButton, MouseButtonMask } from './enums';
+export declare class InputEvent {
+    static readonly deviceIdEmulation = -1;
+    static readonly deviceIdInternal = -2;
+    static readonly deviceIdKeyboard = 16;
+    static readonly deviceIdMouse = 32;
+    device: number;
+    pressed: boolean;
+    canceled: boolean;
+    private _accepted;
+    accept(): void;
+    clearAccepted(): void;
+    isAccepted(): boolean;
+    isPressed(): boolean;
+    isReleased(): boolean;
+    isCanceled(): boolean;
+    isEcho(): boolean;
+    xformedBy(transform: Matrix3): InputEvent;
+}
+export declare class InputEventWithModifiers extends InputEvent {
+    commandOrControlAutoremap: boolean;
+    shiftPressed: boolean;
+    altPressed: boolean;
+    metaPressed: boolean;
+    ctrlPressed: boolean;
+    protected copyModifiersTo(event: InputEventWithModifiers): void;
+}
+export declare class InputEventKey extends InputEventWithModifiers {
+    keycode: string;
+    physicalKeycode: string;
+    keyLabel: string;
+    unicode: number;
+    location: KeyLocation;
+    echo: boolean;
+    isEcho(): boolean;
+}
+export declare class InputEventMouse extends InputEventWithModifiers {
+    buttonMask: MouseButtonMask;
+    position: Vector2;
+    globalPosition: Vector2;
+    protected copyMouseTo(event: InputEventMouse): void;
+}
+export declare class InputEventMouseButton extends InputEventMouse {
+    factor: number;
+    buttonIndex: MouseButton;
+    doubleClick: boolean;
+    xformedBy(transform: Matrix3): InputEventMouseButton;
+}
+export declare class InputEventMouseMotion extends InputEventMouse {
+    tilt: Vector2;
+    pressure: number;
+    relative: Vector2;
+    screenRelative: Vector2;
+    velocity: Vector2;
+    screenVelocity: Vector2;
+    penInverted: boolean;
+    xformedBy(transform: Matrix3): InputEventMouseMotion;
+}
+export declare class InputEventScreenTouch extends InputEvent {
+    index: number;
+    position: Vector2;
+    doubleTap: boolean;
+    xformedBy(transform: Matrix3): InputEventScreenTouch;
+}
+export declare class InputEventScreenDrag extends InputEvent {
+    index: number;
+    position: Vector2;
+    relative: Vector2;
+    screenRelative: Vector2;
+    velocity: Vector2;
+    screenVelocity: Vector2;
+    pressure: number;
+    tilt: Vector2;
+    penInverted: boolean;
+    xformedBy(transform: Matrix3): InputEventScreenDrag;
+}

package/dist/plugins/interact/event-system.d.ts

@@ -29,20 +29,67 @@ export declare enum PointerEventType {
 export declare class EventSystem implements Disposable {
     engine: Engine;
     allowPropagation: boolean;
-    enabled: boolean;
     skipPointerMovePicking: boolean;
+    private readonly emulateMouseFromTouch;
+    private readonly emulateTouchFromMouse;
+    private _enabled;
     private handlers;
     private nativeHandlers;
     private target;
+    private mouseState;
+    private touchStates;
+    private mouseFromTouchIndex;
+    private touchFromMousePressed;
+    private addedTabIndex;
+    private addedOutlineStyle;
     constructor(engine: Engine, allowPropagation?: boolean);
+    get enabled(): boolean;
+    set enabled(value: boolean);
     bindListeners(target: HTMLCanvasElement | null): void;
     dispatchEvent(type: string, event: TouchEventType): void;
     addEventListener(type: string, callback: (event: TouchEventType) => void): () => void;
     removeEventListener(type: string, callback: (event: TouchEventType) => void): void;
+    dispose(): void;
+    private onNativeWheel;
+    private onNativeKeyDown;
+    private onNativeKeyUp;
+    private onNativeMouseDown;
+    private onNativeMouseMove;
+    private onNativeMouseUp;
+    private onNativeTouchStart;
+    private onNativeTouchMove;
+    private onNativeTouchEnd;
+    private onNativeTouchCancel;
+    private onWindowBlur;
+    private handleNativeMouseDown;
+    private handleNativeKey;
+    private handleNativeTouchEnd;
+    private pushNativeMouseButton;
+    private pushNativeMouseMotion;
+    private pushNativeScreenTouch;
+    private pushNativeScreenDrag;
+    private pushEmulatedMouseButton;
+    private pushEmulatedMouseMotion;
+    private pushMouseButton;
+    private pushWheelButton;
+    private pushMouseMotion;
+    private pushScreenTouch;
+    private pushScreenDrag;
+    private copyMouseFields;
     private onClick;
     private onPointerDown;
     private onPointerUp;
     private onPointerMove;
     private handlePointerEvent;
-    dispose(): void;
+    private createPointerState;
+    private updatePointerState;
+    private getVelocity;
+    private isClick;
+    private createPointerEvent;
+    private getCanvasPosition;
+    private consumeNativeEvent;
+    private preventTouchDefaults;
+    private focusTarget;
+    private addNativeHandler;
+    private unbindListeners;
 }

package/dist/render/graphics.d.ts

@@ -17,6 +17,7 @@ export declare class Graphics {
     private geometry;
     private coloredMaterial;
     private texturedMaterial;
+    private textMaterial;
     private readonly lineShape;
     private readonly bezierShape;
     private readonly triangleShape;
@@ -108,8 +109,8 @@ export declare class Graphics {
     drawTriangle(x1: number, y1: number, x2: number, y2: number, x3: number, y3: number, color?: Color, thickness?: number): void;
     /**
      * 绘制矩形边框
-     * @param x - 矩形左下角 X 坐标
-     * @param y - 矩形左下角 Y 坐标
+     * @param x - 矩形左上角 X 坐标
+     * @param y - 矩形左上角 Y 坐标
      * @param width - 矩形宽度
      * @param height - 矩形高度
      * @param color - 边框颜色，默认白色，范围 0-1
@@ -138,8 +139,8 @@ export declare class Graphics {
     fillTriangle(x1: number, y1: number, x2: number, y2: number, x3: number, y3: number, color?: Color): void;
     /**
      * 绘制填充矩形
-     * @param x - 矩形左下角 X 坐标
-     * @param y - 矩形左下角 Y 坐标
+     * @param x - 矩形左上角 X 坐标
+     * @param y - 矩形左上角 Y 坐标
      * @param width - 矩形宽度
      * @param height - 矩形高度
      * @param color - 填充颜色，默认白色，范围 0-1
@@ -158,9 +159,9 @@ export declare class Graphics {
      */
     fillCircle(cx: number, cy: number, radius: number, color?: Color): void;
     /**
-     * 绘制纹理矩形（本地坐标，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 当前批次
@@ -169,14 +170,14 @@ export declare class Graphics {
      */
     drawTexture(x: number, y: number, width: number, height: number, texture: Texture, region?: TextureRegion, color?: Color): void;
     /**
-     * 绘制文本（本地坐标，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

package/dist/render/text-cache.d.ts

@@ -9,19 +9,14 @@ export type FontWeight = 'normal' | 'bold' | number;
  */
 export type FontStyle = 'normal' | 'italic';
 /**
- * 字形纹理超采样倍数。canvas 按 `fontSize * FONT_SCALE` 渲染，纹理像素也是 scale 倍，
- * 但 quad 仍按 1x 逻辑尺寸绘制 — 双线性 downsample 后比原 1x 渲染清晰得多
- */
-export declare const FONT_SCALE = 2;
-/**
- * 单张字符 atlas 的边长(像素,scale 后的实际像素,非逻辑尺寸)。
+ * 单张字符 atlas 的逻辑边长。实际 canvas 像素尺寸会乘以渲染 resolution。
  * 512×512 在 24px 字号下约可容纳 250+ 字形,常见 demo 文本足够
  */
 export declare const ATLAS_SIZE = 512;
 /**
  * 单个字形在 atlas 中的位置 / 度量。
  *
- * `px/py/pw/ph` 是 atlas canvas 像素（scale 后，含四周 padding）。
+ * `px/py/pw/ph` 是 atlas canvas 像素（resolution 后，含四周 padding）。
  * `advance` 是逻辑像素光标前进量（1x，不含 padding）— quad 宽度含 padding，
  * 但相邻字只按 advance 前进，padding 区透明因此重叠无妨。
  * `paddingLeft` 是逻辑像素左侧留白（1x），quad 起点左偏此量使字形 ink 落在 cursorX
@@ -47,12 +42,14 @@ export type GlyphInfo = {
 export declare class GlyphAtlas {
     private engine;
     private readonly scaledFontString;
-    /** atlas canvas（像素 = ATLAS_SIZE × ATLAS_SIZE，自有不进 canvasPool） */
+    /** atlas canvas（像素 = ATLAS_SIZE × resolution，自有不进 canvasPool） */
     readonly canvas: HTMLCanvasElement;
     /** 与 canvas 绑定的纹理，内容变更后通过 updateSource 重传 */
     readonly texture: Texture;
     /** cell 高（逻辑像素，含 padding），用于 quad 高度 */
     readonly lineHeight: number;
+    /** 字形 canvas 的像素密度，与 Pixi 的纹理 resolution 语义一致。 */
+    readonly resolution: number;
     private readonly ctx;
     private readonly glyphs;
     /** baseline 距 cell 顶距离（像素，scale 后，含顶部 padding） */
@@ -74,7 +71,7 @@ export declare class GlyphAtlas {
     /** baseline 距 cell 顶距离（像素，scale 后，仅 ascent 部分，不含 padding） */
     ascentPx: number, 
     /** baseline 距 cell 底距离（像素，scale 后，仅 descent 部分） */
-    descentPx: number, fontStyle: FontStyle);
+    descentPx: number, fontStyle: FontStyle, resolution: number);
     /**
      * 取（必要时渲染并打包）单字。返回 GlyphInfo 或 null（atlas 已满）
      */
@@ -99,6 +96,7 @@ export declare class TextCache {
     private engine;
     /** fontKey -> 该字体的字符 atlas */
     private readonly atlases;
+    private resolution;
     constructor(engine: Engine);
     /**
      * 取(必要时新建)对应字体的字符 atlas
@@ -114,4 +112,5 @@ export declare class TextCache {
      * 清空所有 atlas 并 dispose 对应纹理。Engine dispose 时调用
      */
     dispose(): void;
+    private clear;
 }

package/dist/transform.d.ts

@@ -3,6 +3,7 @@ import { Matrix3 } from '@galacean/effects-math/es/core/matrix3';
 import type * as spec from '@galacean/effects-specification';
 import type { Disposable } from './utils';
 import type { Engine } from './engine';
+import type { EventEmitterListener, EventEmitterOptions } from './events';
 export interface TransformProps {
     position?: spec.vec3 | Vector3;
     rotation?: spec.vec3 | Euler;
@@ -13,6 +14,9 @@ export interface TransformProps {
     anchor?: spec.vec2 | Vector2;
     valid?: boolean;
 }
+export type TransformEvent = {
+    changed: [transform: Transform];
+};
 /**
  * 变换组件，用于描述元素的位置、旋转、缩放等信息
  */
@@ -87,6 +91,7 @@ export declare class Transform implements Disposable {
      * 最终模型矩阵对应变换的缓存，当自身矩阵或父矩阵有修改时需要更新
      */
     private readonly worldTRSCache;
+    private readonly eventEmitter;
     /**
      *
      * @param props
@@ -95,6 +100,8 @@ export declare class Transform implements Disposable {
     constructor(props?: TransformProps, parent?: Transform);
     set parentTransform(transform: Transform | null);
     get parentTransform(): Transform | null;
+    on<E extends keyof TransformEvent>(eventName: E, listener: EventEmitterListener<TransformEvent[E]>, options?: EventEmitterOptions): void;
+    off<E extends keyof TransformEvent>(eventName: E, listener: EventEmitterListener<TransformEvent[E]>): void;
     private set worldMatrixDirty(value);
     private get worldMatrixDirty();
     /**

package/dist/vfx-item.d.ts

@@ -141,6 +141,9 @@ export declare class VFXItem extends EffectsObject implements Disposable {
      */
     get renderOrder(): number;
     set renderOrder(value: number);
+    /** Zero-based sibling order within the parent item. */
+    get orderInParent(): number;
+    set orderInParent(value: number);
     /**
      * 元素监听事件
      * @param eventName - 事件名称
@@ -301,6 +304,7 @@ export declare class VFXItem extends EffectsObject implements Disposable {
      */
     duplicate(): VFXItem;
     private onParentChanged;
+    private onOrderInParentChanged;
     fromData(data: spec.VFXItemData): void;
     toData(): void;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galacean/effects-core",
-  "version": "2.10.0-alpha.2",
+  "version": "2.10.0-alpha.4",
   "description": "Galacean Effects runtime core for the web",
   "module": "./dist/index.mjs",
   "main": "./dist/index.js",

package/dist/components/canvas-item.d.ts

@@ -1,131 +0,0 @@
-import type { Color } from '@galacean/effects-math/es/core';
-import type { FontStyle, FontWeight, TextureRegion } from '../render';
-import type { Texture } from '../texture';
-import { CanvasLayer } from './canvas-layer';
-import { Component } from './component';
-/**
- * 画布元素组件
- *
- * 进入场景树时沿父链向上查找最近的 CanvasLayer 祖先并注册自己；
- * 父级改变或自身销毁时,刷新 / 注销在所属 CanvasLayer 的登记。
- *
- * 注:拓扑(parent / children / 所属 layer)与 enabled/active 解耦 —
- * `component.enabled=false` 仅让自身 draw 被跳过,**不**改父子关系,也**不**从 layer 注销;
- * 整棵子树的隐藏由 `vfxItem.setActive(false)` 配合 drawInternal 中的 `isActive` 检查处理
- */
-export declare class CanvasItem extends Component {
-    /**
-     * 父 CanvasItem
-     * 沿 VFXItem 父链向上查找到的最近的 CanvasItem(只看类型,不看 active/enabled — 拓扑跟激活状态解耦)。
-     * 若不存在 CanvasItem 祖先（即直属于 CanvasLayer 或处于游离状态），该值为 null。
-     */
-    parent: CanvasItem | null;
-    /**
-     * 子 CanvasItem 列表（按注册顺序）
-     * 由子节点在维护自身 parent 时反向写入，draw 时按数组顺序递归绘制
-     */
-    readonly children: CanvasItem[];
-    /**
-     * 当前所属的 CanvasLayer，未注册到任何 CanvasLayer 时为 null
-     */
-    protected canvasLayerNode: CanvasLayer | null;
-    /**
-     * 获取当前所属的 CanvasLayer
-     */
-    get canvasLayer(): CanvasLayer | null;
-    onEnable(): void;
-    onDisable(): void;
-    onParentChanged(): void;
-    onDestroy(): void;
-    /**
-     * 绘制函数
-     * 子类重写此方法以输出实际的绘制内容；调用时 graphics 的变换栈顶已经累积了从根到当前节点的所有父变换，
-     * 子类直接使用 this.drawXxx / this.fillXxx 系列封装方法绘制即可，绘制坐标视为本地坐标。
-     */
-    draw(): void;
-    /**
-     * 绘制单条线段
-     * @param x1 - 起点 x
-     * @param y1 - 起点 y
-     * @param x2 - 终点 x
-     * @param y2 - 终点 y
-     * @param color - 线条颜色
-     * @param thickness - 线宽
-     */
-    drawLine(x1: number, y1: number, x2: number, y2: number, color?: Color, thickness?: number): void;
-    /**
-     * 按顺序连接所有点绘制折线（首尾相同则视为闭合）
-     * @param points - 点数组，格式 [x1,y1,x2,y2,...]
-     * @param color - 线条颜色
-     * @param thickness - 线宽
-     */
-    drawPolyline(points: number[], color?: Color, thickness?: number): void;
-    /**
-     * 绘制三次贝塞尔曲线
-     */
-    drawBezier(x1: number, y1: number, x2: number, y2: number, x3: number, y3: number, x4: number, y4: number, color?: Color, thickness?: number): void;
-    /**
-     * 绘制三角形边框
-     */
-    drawTriangle(x1: number, y1: number, x2: number, y2: number, x3: number, y3: number, color?: Color, thickness?: number): void;
-    /**
-     * 绘制矩形边框
-     * @param x - 矩形左下角 x 坐标
-     * @param y - 矩形左下角 y 坐标
-     */
-    drawRect(x: number, y: number, width: number, height: number, color?: Color, thickness?: number): void;
-    /**
-     * 绘制圆形边框
-     */
-    drawCircle(cx: number, cy: number, radius: number, color?: Color, thickness?: number): void;
-    /**
-     * 绘制填充三角形
-     */
-    fillTriangle(x1: number, y1: number, x2: number, y2: number, x3: number, y3: number, color?: Color): void;
-    /**
-     * 绘制填充矩形
-     * @param x - 矩形左下角 x 坐标
-     * @param y - 矩形左下角 y 坐标
-     */
-    fillRect(x: number, y: number, width: number, height: number, color?: Color): void;
-    /**
-     * 绘制填充圆形
-     */
-    fillCircle(cx: number, cy: number, radius: number, color?: Color): void;
-    /**
-     * 绘制纹理矩形(本地坐标,Y 向上,(x, y) 为左下角)
-     * @param region - 纹理 UV 子矩形,默认全图。Y 向上,(u0, v0) 为左下角 UV
-     * @param color - 乘色,默认白色
-     */
-    drawTexture(x: number, y: number, width: number, height: number, texture: Texture, region?: TextureRegion, color?: Color): void;
-    /**
-     * 绘制文本(本地坐标,Y 向上,(x, y) 为文本左下角)。
-     *
-     * 同一段文本不同颜色不会重复 upload — 颜色由 `color` 参数透传作为乘色,纹理只缓存白色字形。
-     * 字体参数全部展开,避免调用方每帧创建临时 style 对象触发 GC
-     */
-    drawText(x: number, y: number, text: string, fontSize: number, color?: Color, fontFamily?: string, fontWeight?: FontWeight, fontStyle?: FontStyle): void;
-    /**
-     * 从当前所属的 CanvasLayer 注销自身（如果有）
-     * 仅当自身是顶层 CanvasItem 时，才会触发 layer 顶层列表的移除
-     */
-    private removeFromCanvasLayer;
-    /**
-     * 从当前父 CanvasItem 的 children 中移除自身（如果有）
-     */
-    private removeFromParent;
-    /**
-     * 更新所有子 CanvasItem 的层级归属。
-     * 自身失效时调用，子节点会跳过自己向上找到新的父 CanvasItem（可能为 null）。
-     */
-    private updateChildrenParentItems;
-    /**
-     * 沿父链向上查找最近的 CanvasLayer 祖先
-     * 注意：自身所在 VFXItem 上的 CanvasLayer 也参与查找（同节点上可能并存 CanvasLayer 与 CanvasItem）
-     */
-    private getCanvasLayerNode;
-    /**
-     * 沿 VFXItem 父链向上查找最近的 CanvasItem 祖先(不包含自身,只看类型不看 active/enabled)
-     */
-    private getParentItem;
-}

package/dist/components/canvas-layer.d.ts

@@ -1,23 +0,0 @@
-import type { CanvasItem } from './canvas-item';
-import { Component } from './component';
-/**
- * 画布层组件
- *
- * 作为一组顶层 CanvasItem 的容器：本层内所有 parent 为 null 的 CanvasItem 都登记在 canvasItems 中。
- * 嵌套关系下的子 CanvasItem 通过其父 CanvasItem 的 children 数组管理，由父节点在 draw 时递归绘制。
- */
-export declare class CanvasLayer extends Component {
-    /**
-     * 当前层中的顶层 CanvasItem 列表(按注册顺序)。
-     * 仅包含 parent 为 null 的 CanvasItem;嵌套的子 CanvasItem 不会出现在此列表
-     */
-    readonly canvasItems: CanvasItem[];
-    /**
-     * 绘制层级，数值越小越先绘制
-     */
-    layer: number;
-    onEnable(): void;
-    onDisable(): void;
-    private removeFromComposition;
-    private refreshCanvasItemsLayer;
-}

package/dist/components/control.d.ts

@@ -1,18 +0,0 @@
-import { CanvasItem } from './canvas-item';
-/**
- * 锚点布局组件
- *
- * `Control extends CanvasItem`。CanvasItem 仅承担绘制与节点层级，Control 在挂到 VFXItem 时把
- * `item.transform` 升级为 {@link RectTransform}。
- *
- * 布局完全由 RectTransform 自治:父子节点关系沿 `Transform.parentTransform / children` 走，
- * 父节点 size 变化时通过 `RectTransform.sizeChanged()` 直接调用子节点 sizeChanged 链式传播。
- * Control 本身不持有任何与布局相关的状态
- */
-export declare class Control extends CanvasItem {
-    /**
-     * 在挂到 VFXItem 时确保 `item.transform` 是 `RectTransform`。
-     * 既有 Transform 状态(position / rotation / scale / size / anchor 等)通过 `RectTransform.fromTransform` 复制
-     */
-    onAwake(): void;
-}