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

package/dist/input/enums.d.ts

@@ -0,0 +1,65 @@
+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
+}

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,77 @@
+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;
+    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;
+    xformedBy(transform: Matrix3): InputEventWithModifiers;
+}
+export declare class InputEventKey extends InputEventWithModifiers {
+    keycode: string;
+    physicalKeycode: string;
+    keyLabel: string;
+    unicode: number;
+    location: KeyLocation;
+    echo: boolean;
+    isEcho(): boolean;
+    xformedBy(transform: Matrix3): InputEventKey;
+}
+export declare class InputEventMouse extends InputEventWithModifiers {
+    buttonMask: MouseButtonMask;
+    position: Vector2;
+    globalPosition: Vector2;
+    protected copyMouseTo(event: InputEventMouse): void;
+    xformedBy(transform: Matrix3): InputEventMouse;
+}
+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;

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.3",
   "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;
-}

package/dist/rect-transform.d.ts

@@ -1,145 +0,0 @@
-import { Vector2 } from '@galacean/effects-math/es/core/vector2';
-import type * as spec from '@galacean/effects-specification';
-import { Transform } from './transform';
-/**
- * 2D 矩形，`position` 为左下角（Y 向上），`size` 为宽高
- */
-export type Rect = {
-    position: Vector2;
-    size: Vector2;
-};
-/**
- * 16 个内建锚点预设，字面意义对应屏幕视觉位置（Y 向上）
- */
-export type LayoutPreset = 'topLeft' | 'topRight' | 'bottomLeft' | 'bottomRight' | 'centerLeft' | 'centerTop' | 'centerRight' | 'centerBottom' | 'center' | 'leftWide' | 'topWide' | 'rightWide' | 'bottomWide' | 'vcenterWide' | 'hcenterWide' | 'fullRect';
-/**
- * 锚点布局变换。`RectTransform extends Transform`，在 Transform 的 position/rotation/scale/size/anchor（=pivot 偏移）
- * 之上额外维护 4 边锚点 + 4 边像素偏移，提供 rect 解算与编辑 API。
- *
- * 解算公式（Y 向上，父 vertex 坐标原点 = 父 rect 左下角）：
- * ```
- * left   = offsetMin.x + anchorMin.x * parentSize.x
- * bottom = offsetMin.y + anchorMin.y * parentSize.y
- * right  = offsetMax.x + anchorMax.x * parentSize.x
- * top    = offsetMax.y + anchorMax.y * parentSize.y
- * ```
- *
- * 写回 Transform：
- * - `position` ← `(left, bottom)`（rect 左下角，父 vertex 坐标）
- * - `size`     ← rect 尺寸
- * - `anchor`（Vector3 像素 pivot 偏移）由用户独立设置，仅作旋转/缩放中心
- *
- * **解算入口** 是 `sizeChanged()` 方法：
- * - 父是 RectTransform → 用 `parent.size` 作 parentSize 解算自身，写回 `position` / `size`
- * - 否则（顶层 / 没父）：自身 size 视为权威值（由外部 — 通常是 CanvasLayer — 直接写），不再自解算
- * - 末尾遍历 `children` 中的 RectTransform，直接调它们的 `sizeChanged()`，链式向下传播
- *
- * **重写 `setPosition` / `setSize`** 让其语义变为"用户输入 rect 位置 / 尺寸"：
- * - 顶层（无 RectTransform 父）：直接写 `super.setPosition / super.setSize`，然后 `sizeChanged` 传播给子节点
- * - 否则：反推 offset 维持当前 anchor，然后 `sizeChanged` 重算并向下传
- */
-export declare class RectTransform extends Transform {
-    /**
-     * 父 rect 上的归一化最小角 `(anchorLeft, anchorBottom)`
-     */
-    readonly anchorMin: Vector2;
-    /**
-     * 父 rect 上的归一化最大角 `(anchorRight, anchorTop)`
-     */
-    readonly anchorMax: Vector2;
-    /**
-     * rect 左/下边相对 anchorMin 锚点的像素偏移 `(offsetLeft, offsetBottom)`
-     */
-    readonly offsetMin: Vector2;
-    /**
-     * rect 右/上边相对 anchorMax 锚点的像素偏移 `(offsetRight, offsetTop)`
-     */
-    readonly offsetMax: Vector2;
-    /**
-     * 自身 rect 上的归一化轴心 `(0..1)`，默认 `(0.5, 0.5)`(中心)。两层效果：
-     * 1. **Layout**：`setSize` 时 rect 围绕此点对称缩放（pivot=(0.5, 0.5) → 居中扩展；pivot=(0, 0) → 从左下扩展；pivot=(1, 1) → 向左下缩）
-     * 2. **矩阵**：`pivot` 自动同步到 `transform.anchor = pivot * size`（像素值，矩阵旋转/缩放中心），
-     *    所以旋转/缩放也围绕同一点。`setPivot` 和每次 `sizeChanged`（size 重算后）都会刷新 `transform.anchor`
-     */
-    readonly pivot: Vector2;
-    /**
-     * 用既有 Transform 的状态创建 RectTransform。
-     * 用于 Control / CanvasLayer 接管 VFXItem 时，把 VFXItem 自带的 Transform 升级为 RectTransform 而不丢失 position/rotation/scale 等已设置好的状态。
-     */
-    static fromTransform(t: Transform): RectTransform;
-    /**
-     * 反序列化：在 `Transform.fromData` 基础上还原 RectTransform 特有的 `pivot` /
-     * `anchorMin` / `anchorMax` / `offsetMin` / `offsetMax`。
-     *
-     * 顺序：
-     * 1. `super.fromData` 还原 `position` / `rotation` / `scale` / `size` / `anchor`
-     * 2. 若数据有 size，从 `anchor / size` 反推 `pivot`，保持 `anchor = pivot * size` 一致
-     * 3. 应用 `anchorMin/Max` / `offsetMin/Max`，每个 setter 末尾会触发 `sizeChanged`
-     *    重新解算 rect 与同步 `transform.anchor`
-     */
-    fromData(data: spec.TransformData): void;
-    setAnchorMin(x: number, y: number): void;
-    setAnchorMax(x: number, y: number): void;
-    setOffsetMin(x: number, y: number): void;
-    setOffsetMax(x: number, y: number): void;
-    /**
-     * 设置 rect 内的归一化轴心 `(0..1)`，同时把 `transform.anchor`（矩阵旋转/缩放中心）同步到 `pivot * size`。
-     * 不重算 rect（pivot 只决定 setSize 行为，不直接影响当前 rect 位置 / 尺寸）
-     */
-    setPivot(x: number, y: number): void;
-    /**
-     * 重写父类 `setPosition`：
-     * - 顶层（无 RectTransform 父）：直接 `super.setPosition` 写位置，触发 `sizeChanged` 传播
-     * - 非顶层：语义为"设置 rect 左下角到 (x, y)"，反推 offset 维持当前 anchor，然后 `sizeChanged` 重算
-     *
-     * @param keepOffsets - 默认 false。true 时反推 anchor 而非 offset（rect 在屏幕上不动，但 anchor 比例改变）
-     */
-    setPosition(x: number, y: number, z: number, keepOffsets?: boolean): void;
-    /**
-     * 重写父类 `setSize`：
-     * - 顶层：直接 `super.setSize`，触发 `sizeChanged` 传播
-     * - 非顶层：反推 offset 维持当前 anchor，然后 `sizeChanged` 重算
-     */
-    setSize(x: number, y: number): void;
-    /**
-     * 当前自身 rect（在父 vertex 坐标下，Y 向上）。`sizeChanged` 之后才有意义
-     */
-    getRect(): Rect;
-    private onCanvasResize;
-    /**
-     * 解算入口：
-     *
-     * 1. 父是 RectTransform → 从 `parent.size` 求自身 rect，通过 `super.setPosition / super.setSize` 写回
-     *    （避免触发本类 setPosition / setSize 重写）
-     * 2. 顶层（无 RectTransform 父）：自身 size 视为权威值（由 CanvasLayer 等外部直接写），不自解算
-     * 3. 遍历 `children` 中所有 RectTransform 子节点，直接调它们的 `sizeChanged()` 链式传播
-     */
-    sizeChanged(): void;
-    /**
-     * 给定目标 rect 反推 offsetMin/Max，保持当前 anchor 不变
-     */
-    private computeOffsets;
-    /**
-     * 给定目标 rect 反推 anchorMin/Max，保持当前 offset 不变。父 size 为 0 的方向不修改
-     */
-    private computeAnchors;
-    /**
-     * 把 anchorMin/Max 设为内建预设。
-     * @param keepOffsets - 默认 true：offset 不动，rect 实际位置会跳到新 anchor 计算的位置（要求保留视觉位置请用 setAnchorsAndOffsetsPreset）
-     */
-    setAnchorsPreset(preset: LayoutPreset, keepOffsets?: boolean): void;
-    /**
-     * 把 offsetMin/Max 设为预设值，使 rect 在父 rect 内落在视觉上对应的位置（留 margin 像素边距）。
-     * 当 anchor 已经按相同 preset 设定时，等价于“贴边放置带 margin 的 rect”。
-     * 使用当前 size 作为 rect 尺寸。
-     */
-    setOffsetsPreset(preset: LayoutPreset, margin?: number): void;
-    /**
-     * 同时设置 anchor 和 offset，达到“按 preset 摆放并贴边带 margin”的效果。
-     *
-     * 注意第一步用 `keepOffsets=false`（反推 offset 维持 rect 视觉位置），不能用默认 `true`：
-     * 后者会让 rect 的 size 在中间步先跳到错值（因为 anchor 改了 offset 没改），
-     * 第二步 `setOffsetsPreset` 又用这个错 size 算 offset，最终 rect size 不对
-     */
-    setAnchorsAndOffsetsPreset(preset: LayoutPreset, margin?: number): void;
-}