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

package/dist/input/enums.d.ts

@@ -1,13 +1,3 @@
-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,
@@ -28,40 +18,8 @@ export declare enum MouseButtonMask {
     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/plugin-system.d.ts

@@ -17,6 +17,7 @@ export declare function registerPlugin(name: string, pluginClass: PluginConstruc
 export declare function unregisterPlugin(name: string): void;
 export declare class PluginSystem {
     static getPlugins(): Plugin[];
+    static notifyCompositionCreating(composition: Composition, scene?: Scene): void;
     static notifyCompositionCreated(composition: Composition, scene?: Scene): void;
     static notifyCompositionDestroy(composition: Composition): void;
     static notifyEngineCreated(engine: Engine): void;

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

@@ -1,4 +1,6 @@
 import type { Engine } from '../../engine';
+import { EventEmitter } from '../../events';
+import { InputEvent } from '../../input';
 import type { Disposable } from '../../utils';
 export declare const EVENT_TYPE_CLICK = "click";
 export declare const EVENT_TYPE_TOUCH_START = "touchstart";
@@ -26,7 +28,12 @@ export declare enum PointerEventType {
     PointerUp = 1,
     PointerMove = 2
 }
-export declare class EventSystem implements Disposable {
+export type EventSystemEvent = {
+    input: [event: InputEvent];
+    canvasFocus: [];
+    canvasBlur: [];
+};
+export declare class EventSystem extends EventEmitter<EventSystemEvent> implements Disposable {
     engine: Engine;
     allowPropagation: boolean;
     skipPointerMovePicking: boolean;
@@ -37,6 +44,14 @@ export declare class EventSystem implements Disposable {
     private nativeHandlers;
     private target;
     private mouseState;
+    /**
+     * Logical mouse button state maintained from mousedown/mouseup transitions.
+     *
+     * On macOS, a trackpad may emit a release-edge pointermove with buttons=0
+     * before mouseup. Treating that motion as a release ends the drag early and
+     * may skip the final transform commit.
+     */
+    private mouseButtonMask;
     private touchStates;
     private mouseFromTouchIndex;
     private touchFromMousePressed;
@@ -44,7 +59,17 @@ export declare class EventSystem implements Disposable {
     private addedOutlineStyle;
     constructor(engine: Engine, allowPropagation?: boolean);
     get enabled(): boolean;
+    /**
+     * Enables native input processing.
+     *
+     * Change this only while there are no active key, mouse, touch, or drag sessions.
+     */
     set enabled(value: boolean);
+    /**
+     * Rebinds native input listeners to a canvas.
+     *
+     * Rebind or unbind only while there are no active key, mouse, touch, or drag sessions.
+     */
     bindListeners(target: HTMLCanvasElement | null): void;
     dispatchEvent(type: string, event: TouchEventType): void;
     addEventListener(type: string, callback: (event: TouchEventType) => void): () => void;
@@ -60,7 +85,8 @@ export declare class EventSystem implements Disposable {
     private onNativeTouchMove;
     private onNativeTouchEnd;
     private onNativeTouchCancel;
-    private onWindowBlur;
+    private onCanvasFocus;
+    private onCanvasBlur;
     private handleNativeMouseDown;
     private handleNativeKey;
     private handleNativeTouchEnd;
@@ -71,6 +97,7 @@ export declare class EventSystem implements Disposable {
     private pushEmulatedMouseButton;
     private pushEmulatedMouseMotion;
     private pushMouseButton;
+    private setMouseButtonPressed;
     private pushWheelButton;
     private pushMouseMotion;
     private pushScreenTouch;
@@ -88,8 +115,10 @@ export declare class EventSystem implements Disposable {
     private createPointerEvent;
     private getCanvasPosition;
     private consumeNativeEvent;
+    private pushInput;
     private preventTouchDefaults;
     private focusTarget;
+    private resetInputState;
     private addNativeHandler;
     private unbindListeners;
 }

package/dist/plugins/plugin.d.ts

@@ -27,6 +27,13 @@ export declare abstract class Plugin {
      * @param engine - 引擎实例
      */
     onAssetsLoadFinish(scene: Scene, options: SceneLoadOptions, engine: Engine): void;
+    /**
+     * 合成内容开始创建前触发。
+     * 此时 root、pluginRoot 和 sceneRoot 已创建，但场景内容尚未实例化。
+     * @param composition - 正在创建的合成对象
+     * @param scene - 场景对象
+     */
+    onCompositionCreating(composition: Composition, scene?: Scene): void;
     /**
      * 合成创建完成后触发。
      * @param composition - 合成对象

package/dist/render/graphics.d.ts

@@ -12,12 +12,33 @@ export type TextureRegion = {
     u1: number;
     v1: number;
 };
+export type NinePatchDrawOptions = {
+    sourceX: number;
+    sourceY: number;
+    sourceWidth: number;
+    sourceHeight: number;
+    marginLeft: number;
+    marginTop: number;
+    marginRight: number;
+    marginBottom: number;
+    horizontalMode?: number;
+    verticalMode?: number;
+    drawCenter?: boolean;
+};
+/** Logical text metrics produced by the glyph atlas used for rendering. */
+export type TextMeasurement = {
+    width: number;
+    lineHeight: number;
+    advances: number[];
+};
 export declare class Graphics {
     private engine;
     private geometry;
+    private ninePatchGeometry;
     private coloredMaterial;
     private texturedMaterial;
     private textMaterial;
+    private ninePatchMaterial;
     private readonly lineShape;
     private readonly bezierShape;
     private readonly triangleShape;
@@ -28,6 +49,10 @@ export declare class Graphics {
     private colors;
     private uvs;
     private indices;
+    private ninePatchDrawSourceSizes;
+    private ninePatchSourceRects;
+    private ninePatchMargins;
+    private ninePatchOptions;
     private lineStyle;
     private currentBatchType;
     private currentBatchTexture;
@@ -35,6 +60,9 @@ export declare class Graphics {
     private textCache;
     private transformStack;
     private currentTransform;
+    private clipStack;
+    private logicalWidth;
+    private logicalHeight;
     private get currentVertexCount();
     private get currentIndexCount();
     constructor(engine: Engine);
@@ -51,6 +79,10 @@ export declare class Graphics {
      * 恢复上一个变换
      */
     popTransform(): void;
+    /** Pushes a local rectangular child clip using a screen-space AABB scissor. */
+    pushClipRect(x: number, y: number, width: number, height: number): void;
+    /** Restores the parent rectangular clip. */
+    popClipRect(): void;
     /**
      * 刷新并渲染所有累积的绘制命令
      */
@@ -59,6 +91,8 @@ export declare class Graphics {
      * 切换到指定批次类型/纹理。若与当前批次不一致，先 flush 已累积顶点
      */
     private ensureBatch;
+    private applyClipRect;
+    private clipRectsEqual;
     /**
      * 提交当前累积的顶点到 renderer，清空缓冲(批次内部 flush 不重置 batchType)
      */
@@ -169,11 +203,16 @@ export declare class Graphics {
      * @param color - 乘色，默认白色
      */
     drawTexture(x: number, y: number, width: number, height: number, texture: Texture, region?: TextureRegion, color?: Color): void;
+    /**
+     * Draws a nine-patch as one quad. Stretching and repetition are resolved in the fragment shader,
+     * so Tile and TileFit do not expand into CPU-side geometry.
+     */
+    drawNinePatch(x: number, y: number, width: number, height: number, texture: Texture, options: NinePatchDrawOptions, color?: Color): void;
     /**
      * 绘制文本（本地坐标，Y 向下，(x, y) 为文本 cell 左上角）。
      *
      * 文本走字符级 bitmap atlas（同一字体下每个字只渲染一次，任意文本组合复用 atlas）;
-     * `color` 作为乘色与白色字形 alpha 相乘，任意颜色都不会污染 atlas。
+     * `color` 与 atlas 字形 RGBA 相乘，任意颜色都不会污染 atlas。
      *
      * 字体参数全部展开，避免调用方每帧创建临时 style 对象触发 GC
      * @param x - 文本左上角 X 坐标（首字 ink 起始处，含 padding 的 quad 会向左延伸）
@@ -186,9 +225,12 @@ export declare class Graphics {
      * @param fontStyle - 字形，默认 `normal`，支持 `'italic'`
      */
     drawText(x: number, y: number, text: string, fontSize: number, color?: Color, fontFamily?: string, fontWeight?: FontWeight, fontStyle?: FontStyle): void;
+    /** Measures text with the same glyph metrics used by {@link drawText}. */
+    measureText(text: string, fontSize: number, fontFamily?: string, fontWeight?: FontWeight, fontStyle?: FontStyle): TextMeasurement;
     dispose(): void;
     private buildShape;
     private buildShapeLine;
+    private getScreenScale;
     private setTriangleShape;
     private setRectangleShape;
     private setCircleShape;

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

@@ -7,7 +7,7 @@ export type FontWeight = 'normal' | 'bold' | number;
 /**
  * 字形（对齐 canvas 2d font 字符串可接受值）
  */
-export type FontStyle = 'normal' | 'italic';
+export type FontStyle = 'normal' | 'italic' | 'oblique';
 /**
  * 单张字符 atlas 的逻辑边长。实际 canvas 像素尺寸会乘以渲染 resolution。
  * 512×512 在 24px 字号下约可容纳 250+ 字形,常见 demo 文本足够
@@ -48,7 +48,7 @@ export declare class GlyphAtlas {
     readonly texture: Texture;
     /** cell 高（逻辑像素，含 padding），用于 quad 高度 */
     readonly lineHeight: number;
-    /** 字形 canvas 的像素密度，与 Pixi 的纹理 resolution 语义一致。 */
+    /** 字形 canvas 的像素密度。 */
     readonly resolution: number;
     private readonly ctx;
     private readonly glyphs;
@@ -87,7 +87,7 @@ export declare class GlyphAtlas {
  * `ATLAS_SIZE × ATLAS_SIZE` 的离屏 canvas atlas，字符按需逐个绘制并打包，
  * `Graphics.drawText` 通过逐字 quad 引用 atlas 子矩形渲染。
  *
- * - 同一段文本不同颜色不会重复 upload（颜色由顶点 `vColor` 乘上字形 alpha）
+ * - 同一段文本不同颜色不会重复 upload（颜色由顶点 `vColor` 与字形 RGBA 相乘）
  * - 同一字体/字号下重复字符只渲染一次，显著减少 canvas → texture 上传次数
  *
  * 入参全部展开（避免调用方每帧创建临时 style 对象触发 GC）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galacean/effects-core",
-  "version": "2.10.0-alpha.4",
+  "version": "2.10.0",
   "description": "Galacean Effects runtime core for the web",
   "module": "./dist/index.mjs",
   "main": "./dist/index.js",
@@ -42,8 +42,8 @@
     "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "@galacean/effects-specification": "^2.8.1",
-    "@galacean/effects-math": "1.2.0",
+    "@galacean/effects-specification": "^2.9.0",
+    "@galacean/effects-math": "1.2.1",
     "flatbuffers": "24.3.25",
     "uuid": "9.0.1",
     "libtess": "1.2.2"

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

@@ -1,28 +0,0 @@
-import type { Engine } from '../engine';
-import { CanvasRootControl } from '../gui';
-import { Component } from './component';
-export declare enum CanvasRenderMode {
-    ScreenSpace = 0,
-    CameraSpace = 1,
-    WorldSpace = 2,
-    WorldSpaceFaceCamera = 3
-}
-/** Canvas-layer boundary attached to a VFXItem. Input state remains owned by the window root. */
-export declare class UICanvas extends Component {
-    readonly rootControl: CanvasRootControl;
-    renderMode: CanvasRenderMode;
-    receivesEvents: boolean;
-    private _order;
-    private registered;
-    constructor(engine: Engine);
-    get order(): number;
-    set order(value: number);
-    get isVisible(): boolean;
-    onEnable(): void;
-    onDisable(): void;
-    onDestroy(): void;
-    dispose(): void;
-    private register;
-    private unregister;
-    private destroyCanvas;
-}

package/dist/components/ui-control.d.ts

@@ -1,38 +0,0 @@
-import type { ContainerControl, Control } from '../gui';
-import type { Engine } from '../engine';
-import { Component } from './component';
-/**
- * Scene-tree bridge for a GUI Control. The VFXItem tree owns lifecycle and
- * serialization while the Control tree owns layout, drawing and input.
- */
-export declare class UIControl extends Component {
-    static fallbackParentGetDelegate?: (control: UIControl) => ContainerControl | null;
-    private controlNode;
-    private linkedItemTransform;
-    private linkedControl;
-    private syncingLocation;
-    private readonly itemTransformChanged;
-    private readonly controlLocationChanged;
-    constructor(engine: Engine);
-    get control(): Control | null;
-    set control(value: Control | null);
-    get hasControl(): boolean;
-    onAwake(): void;
-    onEnable(): void;
-    onDisable(): void;
-    onParentChanged(): void;
-    onOrderInParentChanged(): void;
-    onDestroy(): void;
-    dispose(): void;
-    /** Unlinks the GUI object without disposing or modifying it. */
-    unlinkControl(): void;
-    private disposeControl;
-    private syncControl;
-    private syncControlOrder;
-    private resolveParent;
-    private bindLocationSync;
-    private unbindLocationSync;
-    private syncItemLocationToControl;
-    private syncControlLocationToItem;
-    private copyItemLocationToControl;
-}

package/dist/gui/control.d.ts

@@ -1,188 +0,0 @@
-import type { Color } from '@galacean/effects-math/es/core';
-import { Matrix3 } from '@galacean/effects-math/es/core/matrix3';
-import { Vector2 } from '@galacean/effects-math/es/core/vector2';
-import type { Engine } from '../engine';
-import type { CursorStyle, InputEventKey, InputEventMouseButton, InputEventMouseMotion, InputEventScreenDrag, InputEventScreenTouch } from '../input';
-import { FocusBehaviorRecursive, FocusMode, MouseBehaviorRecursive, MouseFilter } from '../input';
-import type { EventEmitterListener, EventEmitterOptions } from '../events';
-import type { FontStyle, FontWeight, TextureRegion } from '../render';
-import type { Texture } from '../texture';
-import type { UIControl } from '../components/ui-control';
-import type { VFXItem } from '../vfx-item';
-export type Rect = {
-    position: Vector2;
-    size: Vector2;
-};
-export type LayoutPreset = 'topLeft' | 'topRight' | 'bottomLeft' | 'bottomRight' | 'centerLeft' | 'centerTop' | 'centerRight' | 'centerBottom' | 'center' | 'leftWide' | 'topWide' | 'rightWide' | 'bottomWide' | 'vcenterWide' | 'hcenterWide' | 'fullRect';
-export type ControlEvent = {
-    locationChanged: [control: Control];
-    sizeChanged: [control: Control];
-    parentChanged: [control: Control];
-};
-/**
- * A drawable GUI object. Controls form a tree independent from the VFXItem
- * scene tree. UIControl is the bridge between both trees.
- */
-export declare class Control {
-    readonly engine: Engine;
-    private _parent;
-    private _visible;
-    private _enabled;
-    private _mouseFilter;
-    private _mouseBehaviorRecursive;
-    private _focusMode;
-    private _focusBehaviorRecursive;
-    private _defaultCursorShape;
-    private _rotation;
-    private transformDirty;
-    private readonly cachedTransform;
-    private readonly eventEmitter;
-    private disposed;
-    /** Scene-tree bridge that owns this GUI object, if any. */
-    owner: UIControl | null;
-    readonly position: Vector2;
-    readonly size: Vector2;
-    readonly anchorMin: Vector2;
-    readonly anchorMax: Vector2;
-    readonly offsetMin: Vector2;
-    readonly offsetMax: Vector2;
-    readonly pivot: Vector2;
-    readonly scale: Vector2;
-    readonly shear: Vector2;
-    mouseForcePassScrollEvents: boolean;
-    clipContents: boolean;
-    constructor(engine: Engine);
-    get parent(): ContainerControl | null;
-    /** Scene item exposed through the optional UIControl bridge. */
-    get item(): VFXItem | null;
-    set parent(value: ContainerControl | null);
-    get indexInParent(): number;
-    set indexInParent(value: number);
-    get visible(): boolean;
-    set visible(value: boolean);
-    get visibleInHierarchy(): boolean;
-    get enabled(): boolean;
-    set enabled(value: boolean);
-    get enabledInHierarchy(): boolean;
-    get mouseFilter(): MouseFilter;
-    set mouseFilter(value: MouseFilter);
-    get mouseBehaviorRecursive(): MouseBehaviorRecursive;
-    set mouseBehaviorRecursive(value: MouseBehaviorRecursive);
-    get focusMode(): FocusMode;
-    set focusMode(value: FocusMode);
-    get focusBehaviorRecursive(): FocusBehaviorRecursive;
-    set focusBehaviorRecursive(value: FocusBehaviorRecursive);
-    get defaultCursorShape(): CursorStyle;
-    set defaultCursorShape(value: CursorStyle);
-    get location(): Vector2;
-    set location(value: Vector2);
-    get rotation(): number;
-    get x(): number;
-    set x(value: number);
-    get y(): number;
-    set y(value: number);
-    get width(): number;
-    set width(value: number);
-    get height(): number;
-    set height(value: number);
-    on<E extends keyof ControlEvent>(eventName: E, listener: EventEmitterListener<ControlEvent[E]>, options?: EventEmitterOptions): void;
-    off<E extends keyof ControlEvent>(eventName: E, listener: EventEmitterListener<ControlEvent[E]>): void;
-    setPosition(x: number, y: number, keepOffsets?: boolean): void;
-    setSize(width: number, height: number): void;
-    setScale(x: number, y: number): void;
-    setRotation(degrees: number): void;
-    setShear(x: number, y: number): void;
-    setPivot(x: number, y: number): 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;
-    getRect(): Rect;
-    getTransform2D(): Matrix3;
-    setAnchorsPreset(preset: LayoutPreset, keepOffsets?: boolean): void;
-    setOffsetsPreset(preset: LayoutPreset, margin?: number): void;
-    setAnchorsAndOffsetsPreset(preset: LayoutPreset, margin?: number): void;
-    get root(): RootControl | null;
-    get isDisposed(): boolean;
-    getGlobalTransform2D(): Matrix3;
-    hasPoint(point: Vector2): boolean;
-    getEffectiveMouseFilter(): MouseFilter;
-    getFocusModeWithOverride(): FocusMode;
-    getCursorShape(position: Vector2): CursorStyle;
-    focus(): void;
-    grabFocus(): void;
-    grabClickFocus(): void;
-    releaseFocus(): void;
-    warpMouse(position: Vector2): void;
-    /** Converts a window-space position into this control's local coordinates. */
-    makePositionLocal(position: Vector2): Vector2;
-    /** Gets the current mouse position transformed into this control's coordinates. */
-    getLocalMousePosition(): Vector2;
-    update(deltaTime: number): void;
-    draw(): void;
-    onDestroy(): void;
-    drawLine(x1: number, y1: number, x2: number, y2: number, color?: Color, thickness?: number): void;
-    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;
-    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;
-    fillRect(x: number, y: number, width: number, height: number, color?: Color): void;
-    fillCircle(cx: number, cy: number, radius: number, color?: Color): void;
-    drawTexture(x: number, y: number, width: number, height: number, texture: Texture, region?: TextureRegion, color?: Color): void;
-    drawText(x: number, y: number, text: string, fontSize: number, color?: Color, fontFamily?: string, fontWeight?: FontWeight, fontStyle?: FontStyle): void;
-    onMouseEnter(location: Vector2): void;
-    onMouseMove(event: InputEventMouseMotion): void;
-    onMouseLeave(): void;
-    onMouseWheel(event: InputEventMouseButton): void;
-    onMouseDown(event: InputEventMouseButton): void;
-    onMouseUp(event: InputEventMouseButton): void;
-    onTouchDown(event: InputEventScreenTouch): void;
-    onTouchMove(event: InputEventScreenDrag): void;
-    onTouchUp(event: InputEventScreenTouch): void;
-    onKeyDown(event: InputEventKey): void;
-    onKeyUp(event: InputEventKey): void;
-    onGotFocus(): void;
-    onLostFocus(): void;
-    protected getDragData(position: Vector2): unknown;
-    protected canDropData(position: Vector2, data: unknown): boolean;
-    protected dropData(position: Vector2, data: unknown): void;
-    dispose(): void;
-    private applyBounds;
-    private markTransformDirty;
-    private getParentRect;
-    private computeOffsets;
-    private computeAnchors;
-    private isMouseRecursiveEnabled;
-    private isFocusRecursiveEnabled;
-}
-/** A Control that owns child Controls. */
-export declare class ContainerControl extends Control {
-    readonly children: Control[];
-    addChild<T extends Control>(child: T): T;
-    removeChild(child: Control): void;
-    getChildIndex(child: Control): number;
-    drawSelf(): void;
-    draw(): void;
-    protected drawChildren(): void;
-    update(deltaTime: number): void;
-    dispose(): void;
-}
-/** Base class for GUI tree roots and input dispatchers. */
-export declare abstract class RootControl extends ContainerControl {
-    abstract getMousePosition(): Vector2;
-    abstract guiGetFocusOwner(): Control | null;
-    abstract guiIsDragging(): boolean;
-    abstract guiGetDragData(): unknown;
-    abstract guiIsDragSuccessful(): boolean;
-    abstract guiCancelDrag(): void;
-    abstract grabControlFocus(control: Control): void;
-    abstract grabControlClickFocus(control: Control): void;
-    abstract releaseControlFocus(control?: Control): void;
-    abstract warpControlMouse(position: Vector2): void;
-    abstract updateMouseCursorState(): void;
-    abstract controlStateChanged(control: Control): void;
-    abstract controlRemoved(control: Control): void;
-    abstract controlTreeChanged(): void;
-}

package/dist/gui/index.d.ts

@@ -1,2 +0,0 @@
-export * from './control';
-export * from './roots';

package/dist/gui/roots.d.ts

@@ -1,79 +0,0 @@
-import { Vector2 } from '@galacean/effects-math/es/core/vector2';
-import type { UICanvas } from '../components/ui-canvas';
-import type { Engine } from '../engine';
-import type { InputEvent } from '../input';
-import type { Control } from './control';
-import { ContainerControl, RootControl } from './control';
-/** CanvasLayer-like boundary for a single UICanvas GUI tree. */
-export declare class CanvasRootControl extends ContainerControl {
-    readonly canvas: UICanvas;
-    constructor(engine: Engine, canvas: UICanvas);
-    get inputDisabled(): boolean;
-}
-/** Global ordered collection of UICanvas roots. */
-export declare class CanvasContainer extends ContainerControl {
-    constructor(engine: Engine);
-    sortCanvases(): void;
-    addChildInternal(child: Control): void;
-    draw(): void;
-}
-/** Engine window GUI root. Routes events across all UICanvas roots. */
-export declare class WindowRootControl extends RootControl {
-    readonly canvases: CanvasContainer;
-    dragThreshold: number;
-    private lastInput;
-    private readonly gui;
-    constructor(engine: Engine);
-    pushInput(event: InputEvent): void;
-    isInputHandled(): boolean;
-    getMousePosition(): Vector2;
-    guiGetFocusOwner(): Control | null;
-    guiReleaseFocus(): void;
-    guiIsDragging(): boolean;
-    guiGetDragData(): unknown;
-    guiIsDragSuccessful(): boolean;
-    guiCancelDrag(): void;
-    grabControlFocus(control: Control): void;
-    grabControlClickFocus(control: Control): void;
-    releaseControlFocus(control?: Control): void;
-    warpControlMouse(position: Vector2): void;
-    updateMouseCursorState(): void;
-    controlStateChanged(control: Control): void;
-    controlRemoved(control: Control): void;
-    controlTreeChanged(): void;
-    cancelPointerInput(): void;
-    resize(width: number, height: number): void;
-    render(): void;
-    update(deltaTime: number): void;
-    dispose(): void;
-    private processGUIInput;
-    private processMouseButton;
-    private processMouseMotion;
-    private processScreenTouch;
-    private processScreenDrag;
-    private callGUIInput;
-    private callControlInput;
-    private findInputControl;
-    private findControlAtPosition;
-    private updateMouseOver;
-    private buildHoverHierarchy;
-    private findClickFocus;
-    private beginDragging;
-    private finishDrop;
-    private findDropTarget;
-    private endDragging;
-    private updateCursor;
-    private postGrabClickFocus;
-    private cleanupInternalState;
-    private dropMouseFocus;
-    private dropMouseOver;
-    private dropControlState;
-    private requestMouseOverUpdate;
-    private getGlobalInverse;
-    private toLocal;
-    private controlBelongsToSubtree;
-    private isControlValid;
-    private isControlUsable;
-    private findCanvasRoot;
-    private isFocusTargetUsable;
-}