@galacean/engine-core 0.0.0-experimental-2.0-skill.0 → 0.0.0-experimental-2.0-migrate.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galacean/engine-core",
-  "version": "0.0.0-experimental-2.0-skill.0",
+  "version": "0.0.0-experimental-2.0-migrate.7",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
@@ -18,10 +18,10 @@
     "types/**/*"
   ],
   "dependencies": {
-    "@galacean/engine-math": "0.0.0-experimental-2.0-skill.0"
+    "@galacean/engine-math": "0.0.0-experimental-2.0-migrate.7"
   },
   "devDependencies": {
-    "@galacean/engine-design": "0.0.0-experimental-2.0-skill.0"
+    "@galacean/engine-design": "0.0.0-experimental-2.0-migrate.7"
   },
   "scripts": {
     "b:types": "tsc"

package/types/2d/assembler/FilledSpriteAssembler.d.ts

@@ -0,0 +1,32 @@
+import { Matrix, Vector2 } from "@galacean/engine-math";
+import { ISpriteRenderer } from "./ISpriteRenderer";
+/**
+ * Assemble vertex data for the sprite renderer in filled mode.
+ */
+export declare class FilledSpriteAssembler {
+    private static _matrix;
+    private static _worldPositions;
+    private static _uvs;
+    private static _inPositions;
+    private static _inUVs;
+    private static _outPositions;
+    private static _outUVs;
+    private static _vertexOffset;
+    private static _indicesOffset;
+    private static readonly _fillAmountEpsilon;
+    static resetData(renderer: ISpriteRenderer): void;
+    static updatePositions(renderer: ISpriteRenderer, worldMatrix: Matrix, width: number, height: number, pivot: Vector2, flipX: boolean, flipY: boolean): void;
+    static updateUVs(renderer: ISpriteRenderer): void;
+    static updateColor(renderer: ISpriteRenderer, alpha: number): void;
+    private static _filledLinear;
+    private static _filledRadial90;
+    private static _filledRadial180;
+    private static _filledRadial360;
+    /**
+     * Prepare the 3x3 grid and process 4 quadrants for radial fill.
+     */
+    private static _processRadialGrid;
+    private static _radialCut;
+    private static _addTriangle;
+    private static _addQuad;
+}

package/types/2d/assembler/ISpriteRenderer.d.ts

@@ -1,6 +1,8 @@
 import { Color } from "@galacean/engine-math";
 import { PrimitiveChunkManager } from "../../RenderPipeline/PrimitiveChunkManager";
 import { SubPrimitiveChunk } from "../../RenderPipeline/SubPrimitiveChunk";
+import { SpriteFilledMode } from "../enums/SpriteFilledMode";
+import { SpriteFilledOrigin } from "../enums/SpriteFilledOrigin";
 import { SpriteTileMode } from "../enums/SpriteTileMode";
 import { Sprite } from "../sprite";
 /**
@@ -11,6 +13,10 @@ export interface ISpriteRenderer {
     color?: Color;
     tileMode?: SpriteTileMode;
     tiledAdaptiveThreshold?: number;
+    filledMode?: SpriteFilledMode;
+    filledAmount?: number;
+    filledOrigin?: SpriteFilledOrigin;
+    filledClockWise?: boolean;
     _subChunk: SubPrimitiveChunk;
     _getChunkManager(): PrimitiveChunkManager;
 }

package/types/2d/enums/SpriteDrawMode.d.ts

@@ -7,5 +7,7 @@ export declare enum SpriteDrawMode {
     /** When modifying the size of the renderer, it scales to fill the range according to the sprite border settings. */
     Sliced = 1,
     /** When modifying the size of the renderer, it will tile to fill the range according to the sprite border settings. */
-    Tiled = 2
+    Tiled = 2,
+    /** Fill the sprite partially, controlled by fill amount, mode and origin. */
+    Filled = 3
 }

package/types/2d/enums/SpriteFilledMode.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Sprite's filled mode enumeration.
+ */
+export declare enum SpriteFilledMode {
+    /** Fill horizontally. */
+    Horizontal = 0,
+    /** Fill vertically. */
+    Vertical = 1,
+    /** Fill radially over 90 degrees. */
+    Radial90 = 2,
+    /** Fill radially over 180 degrees. */
+    Radial180 = 3,
+    /** Fill radially over 360 degrees. */
+    Radial360 = 4
+}

package/types/2d/enums/SpriteFilledOrigin.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Sprite's filled origin enumeration.
+ */
+export declare enum SpriteFilledOrigin {
+    /** Origin at the right. */
+    Right = 0,
+    /** Origin at the top-right. */
+    TopRight = 1,
+    /** Origin at the top. */
+    Top = 2,
+    /** Origin at the top-left. */
+    TopLeft = 3,
+    /** Origin at the left. */
+    Left = 4,
+    /** Origin at the bottom-left. */
+    BottomLeft = 5,
+    /** Origin at the bottom. */
+    Bottom = 6,
+    /** Origin at the bottom-right. */
+    BottomRight = 7
+}

package/types/2d/enums/TextOverflow.d.ts

@@ -1,9 +1,11 @@
 /**
- * The way to handle the situation where wrapped text is too tall to fit in the height.
+ * The way to handle the situation where the text is too large to fit in the bounds.
  */
 export declare enum OverflowMode {
     /** Overflow when the text is too tall */
     Overflow = 0,
     /** Truncate with height when the text is too tall */
-    Truncate = 1
+    Truncate = 1,
+    /** Shrink the font size until the text fits within the bounds (both width and height) */
+    Shrink = 2
 }

package/types/2d/index.d.ts

@@ -1,11 +1,14 @@
 export type { ISpriteAssembler } from "./assembler/ISpriteAssembler";
 export type { ISpriteRenderer } from "./assembler/ISpriteRenderer";
+export { FilledSpriteAssembler } from "./assembler/FilledSpriteAssembler";
 export { SimpleSpriteAssembler } from "./assembler/SimpleSpriteAssembler";
 export { SlicedSpriteAssembler } from "./assembler/SlicedSpriteAssembler";
 export { TiledSpriteAssembler } from "./assembler/TiledSpriteAssembler";
 export { SpriteAtlas } from "./atlas/SpriteAtlas";
 export { FontStyle } from "./enums/FontStyle";
 export { SpriteDrawMode } from "./enums/SpriteDrawMode";
+export { SpriteFilledMode } from "./enums/SpriteFilledMode";
+export { SpriteFilledOrigin } from "./enums/SpriteFilledOrigin";
 export { SpriteMaskInteraction } from "./enums/SpriteMaskInteraction";
 export { SpriteModifyFlags } from "./enums/SpriteModifyFlags";
 export { SpriteTileMode } from "./enums/SpriteTileMode";

package/types/2d/sprite/MaskRenderable.d.ts

@@ -0,0 +1,48 @@
+import { BoundingBox, Vector2, Vector3 } from "@galacean/engine-math";
+import { RenderElement } from "../../RenderPipeline/RenderElement";
+import { Renderer } from "../../Renderer";
+import { SpriteMaskLayer } from "../../enums/SpriteMaskLayer";
+import { SpriteModifyFlags } from "../enums/SpriteModifyFlags";
+import { Sprite } from "./Sprite";
+/**
+ * Public contract of the MaskRenderable mixin, used for declaration file generation.
+ */
+export interface IMaskRenderable {
+    influenceLayers: SpriteMaskLayer;
+    flipX: boolean;
+    flipY: boolean;
+    sprite: Sprite;
+    alphaCutoff: number;
+    _renderElement: RenderElement;
+    _maskIndex: number;
+    _containsWorldPoint(worldPoint: Vector3): boolean;
+    _initMask(): void;
+    _cloneMaskData(target: IMaskRenderable): void;
+    _destroyMaskResources(): void;
+    _updateMaskBounds(worldBounds: BoundingBox): void;
+    _renderMask(distanceForSort: number): void;
+    _onSpriteChange(type: SpriteModifyFlags): void;
+    _onSpriteChangeExtra(type: SpriteModifyFlags): void;
+    _getSpriteWidth(): number;
+    _getSpriteHeight(): number;
+    _getSpritePivot(): Vector2;
+}
+type RendererConstructor = abstract new (...args: any[]) => Renderer;
+/**
+ * Mixin that provides shared mask rendering logic for both 2D SpriteMask and UI Mask.
+ */
+export declare function MaskRenderable<T extends RendererConstructor>(Base: T): (abstract new (...args: any[]) => IMaskRenderable) & T;
+/**
+ * @remarks Extends `RendererUpdateFlags`.
+ */
+export declare enum MaskDirtyFlags {
+    /** UV. */
+    UV = 2,
+    /** Automatic Size. */
+    AutomaticSize = 8,
+    /** WorldVolume and UV. */
+    WorldVolumeAndUV = 3,
+    /** All. */
+    All = 11
+}
+export {};

package/types/2d/sprite/SpriteMask.d.ts

@@ -1,23 +1,16 @@
 import { BoundingBox } from "@galacean/engine-math";
 import { RenderContext } from "../../RenderPipeline/RenderContext";
 import { Renderer } from "../../Renderer";
-import { SpriteMaskLayer } from "../../enums/SpriteMaskLayer";
-import { ISpriteRenderer } from "../assembler/ISpriteRenderer";
-import { Sprite } from "./Sprite";
+import { SpriteModifyFlags } from "../enums/SpriteModifyFlags";
+declare const SpriteMask_base: (abstract new (...args: any[]) => import("./MaskRenderable").IMaskRenderable) & typeof Renderer;
 /**
  * A component for masking Sprites.
  */
-export declare class SpriteMask extends Renderer implements ISpriteRenderer {
-    /** The mask layers the sprite mask influence to. */
-    influenceLayers: SpriteMaskLayer;
-    private _sprite;
+export declare class SpriteMask extends SpriteMask_base {
     private _automaticWidth;
     private _automaticHeight;
     private _customWidth;
     private _customHeight;
-    private _flipX;
-    private _flipY;
-    private _alphaCutoff;
     /**
      * Render width (in world coordinates).
      *
@@ -36,26 +29,6 @@ export declare class SpriteMask extends Renderer implements ISpriteRenderer {
      */
     get height(): number;
     set height(value: number);
-    /**
-     * Flips the sprite on the X axis.
-     */
-    get flipX(): boolean;
-    set flipX(value: boolean);
-    /**
-     * Flips the sprite on the Y axis.
-     */
-    get flipY(): boolean;
-    set flipY(value: boolean);
-    /**
-     * The Sprite to render.
-     */
-    get sprite(): Sprite;
-    set sprite(value: Sprite | null);
-    /**
-     * The minimum alpha value used by the mask to select the area of influence defined over the mask's sprite. Value between 0 and 1.
-     */
-    get alphaCutoff(): number;
-    set alphaCutoff(value: number);
     /**
      * @inheritdoc
      */
@@ -69,6 +42,10 @@ export declare class SpriteMask extends Renderer implements ISpriteRenderer {
      * @inheritdoc
      */
     protected _onDestroy(): void;
+    _getSpriteWidth(): number;
+    _getSpriteHeight(): number;
+    _getSpritePivot(): import("@galacean/engine-math").Vector2;
+    _onSpriteChangeExtra(type: SpriteModifyFlags): void;
     private _calDefaultSize;
-    private _onSpriteChange;
 }
+export {};

package/types/2d/sprite/SpriteMaskUtils.d.ts

@@ -0,0 +1 @@
+export {};

package/types/2d/sprite/SpriteRenderer.d.ts

@@ -3,6 +3,8 @@ import { RenderContext } from "../../RenderPipeline/RenderContext";
 import { Renderer } from "../../Renderer";
 import { ISpriteRenderer } from "../assembler/ISpriteRenderer";
 import { SpriteDrawMode } from "../enums/SpriteDrawMode";
+import { SpriteFilledMode } from "../enums/SpriteFilledMode";
+import { SpriteFilledOrigin } from "../enums/SpriteFilledOrigin";
 import { SpriteMaskInteraction } from "../enums/SpriteMaskInteraction";
 import { SpriteTileMode } from "../enums/SpriteTileMode";
 import { Sprite } from "./Sprite";
@@ -15,6 +17,10 @@ export declare class SpriteRenderer extends Renderer implements ISpriteRenderer
     private _assembler;
     private _tileMode;
     private _tiledAdaptiveThreshold;
+    private _filledMode;
+    private _filledAmount;
+    private _filledOrigin;
+    private _filledClockWise;
     private _color;
     private _sprite;
     private _automaticWidth;
@@ -38,6 +44,26 @@ export declare class SpriteRenderer extends Renderer implements ISpriteRenderer
      */
     get tiledAdaptiveThreshold(): number;
     set tiledAdaptiveThreshold(value: number);
+    /**
+     * The fill amount of the sprite renderer, range from 0 to 1. (Only works in filled mode.)
+     */
+    get filledAmount(): number;
+    set filledAmount(value: number);
+    /**
+     * The fill mode of the sprite renderer. (Only works in filled mode.)
+     */
+    get filledMode(): SpriteFilledMode;
+    set filledMode(value: SpriteFilledMode);
+    /**
+     * The fill origin of the sprite renderer. (Only works in filled mode.)
+     */
+    get filledOrigin(): SpriteFilledOrigin;
+    set filledOrigin(value: SpriteFilledOrigin);
+    /**
+     * Whether the fill is clockwise. (Only works in filled radial mode.)
+     */
+    get filledClockWise(): boolean;
+    set filledClockWise(value: boolean);
     /**
      * The Sprite to render.
      */
@@ -96,4 +122,9 @@ export declare class SpriteRenderer extends Renderer implements ISpriteRenderer
     private _calDefaultSize;
     private _onSpriteChange;
     private _onColorChanged;
+    /**
+     * Returns an origin valid for the given fill mode: the passed origin when it belongs to the mode's
+     * accepted subset, otherwise the mode's default. Keeps `filledMode`/`filledOrigin` always consistent.
+     */
+    private static _correctOrigin;
 }

package/types/2d/sprite/index.d.ts

@@ -1,3 +1,6 @@
+export type { IMaskRenderable } from "./MaskRenderable";
+export { MaskDirtyFlags, MaskRenderable } from "./MaskRenderable";
 export { Sprite } from "./Sprite";
 export { SpriteMask } from "./SpriteMask";
+export { SpriteMaskUtils } from "./SpriteMaskUtils";
 export { SpriteRenderer } from "./SpriteRenderer";

package/types/2d/text/TextRenderer.d.ts

@@ -3,20 +3,24 @@ import { Entity } from "../../Entity";
 import { RenderContext } from "../../RenderPipeline/RenderContext";
 import { Renderer } from "../../Renderer";
 import { TransformModifyFlags } from "../../Transform";
+import { SpriteMaskLayer } from "../../enums/SpriteMaskLayer";
 import { FontStyle } from "../enums/FontStyle";
 import { SpriteMaskInteraction } from "../enums/SpriteMaskInteraction";
 import { TextHorizontalAlignment, TextVerticalAlignment } from "../enums/TextAlignment";
 import { OverflowMode } from "../enums/TextOverflow";
 import { Font } from "./Font";
 import { ITextRenderer } from "./ITextRenderer";
-import { SpriteMaskLayer } from "../../enums/SpriteMaskLayer";
 /**
  * Renders a text for 2D graphics.
  */
 export declare class TextRenderer extends Renderer implements ITextRenderer {
-    private static _textureProperty;
+    private static _tempVec20;
     private static _tempVec30;
     private static _tempVec31;
+    private static _textureProperty;
+    private static _textTextureSizeProperty;
+    private static _outlineColorProperty;
+    private static _outlineWidthProperty;
     private static _worldPositions;
     private static _charRenderInfos;
     private _textChunks;
@@ -34,6 +38,8 @@ export declare class TextRenderer extends Renderer implements ITextRenderer {
     private _verticalAlignment;
     private _enableWrapping;
     private _overflowMode;
+    private _outlineColor;
+    private _outlineWidth;
     /**
      * Rendering color for the Text.
      */
@@ -99,6 +105,16 @@ export declare class TextRenderer extends Renderer implements ITextRenderer {
      */
     get overflowMode(): OverflowMode;
     set overflowMode(value: OverflowMode);
+    /**
+     * The outline width in pixels. 0 means outline is disabled. Clamped to [0, 8].
+     */
+    get outlineWidth(): number;
+    set outlineWidth(value: number);
+    /**
+     * The outline color. Only effective when outlineWidth > 0.
+     */
+    get outlineColor(): Color;
+    set outlineColor(value: Color);
     /**
      * Interacts with the masks.
      */
@@ -117,6 +133,10 @@ export declare class TextRenderer extends Renderer implements ITextRenderer {
     protected _updateBounds(worldBounds: BoundingBox): void;
     protected _render(context: RenderContext): void;
     private _resetSubFont;
+    /**
+     * Switch the sub font to a specific font size, used by the SHRINK overflow measurement.
+     */
+    private _applyFontSizeForShrink;
     private _updatePosition;
     private _updateColor;
     private _updateLocalData;
@@ -125,4 +145,5 @@ export declare class TextRenderer extends Renderer implements ITextRenderer {
     private _buildChunk;
     private _freeTextChunks;
     private _onColorChanged;
+    private _onOutlineColorChanged;
 }

package/types/Entity.d.ts

@@ -10,6 +10,7 @@ import { EngineObject } from "./base";
  * Entity, be used as components container.
  */
 export declare class Entity extends EngineObject {
+    private static _isTransformType;
     /** The name of entity. */
     name: string;
     /** The layer the entity belongs to. */
@@ -159,7 +160,7 @@ export declare class Entity extends EngineObject {
     private _setActiveInHierarchy;
     private _setInActiveInHierarchy;
     private _setSiblingIndex;
-    private _setTransform;
+    private _replaceTransform;
     private _invModelMatrix;
     private _inverseWorldMatFlag;
     /**

package/types/Renderer.d.ts

@@ -1,4 +1,5 @@
 import { BoundingBox, Vector4 } from "@galacean/engine-math";
+import { SpriteMaskInteraction } from "./2d/enums/SpriteMaskInteraction";
 import { Component } from "./Component";
 import { Entity } from "./Entity";
 import { RenderContext } from "./RenderPipeline/RenderContext";
@@ -18,6 +19,7 @@ export declare class Renderer extends Component implements ICloneHook<Renderer>
     private static _mvpMatrixProperty;
     private static _normalMatrixProperty;
     _renderFrameCount: number;
+    _maskInteraction: SpriteMaskInteraction;
     _maskLayer: SpriteMaskLayer;
     protected _overrideUpdate: boolean;
     protected _materials: Material[];

package/types/Script.d.ts

@@ -130,6 +130,7 @@ export declare class Script extends Component {
      * Called at the end of the destroyed frame.
      */
     onDestroy(): void;
+    private _hasCollisionEventCallbacks;
 }
 export declare enum PointerMethods {
     onPointerDown = "onPointerDown",

package/types/Transform.d.ts

@@ -30,6 +30,7 @@ export declare class Transform extends Component implements ICloneHook<Transform
     private _worldForward;
     private _worldRight;
     private _worldUp;
+    private _frontFaceInvert;
     protected _isParentDirty: boolean;
     private _parentTransformCache;
     private _dirtyFlag;
@@ -286,24 +287,25 @@ export declare enum TransformModifyFlags {
      *  of world scaling dirty flags in the case of non-uniform scaling.
      */
     IsWorldUniformScaling = 256,
+    WorldFrontFaceInvert = 2048,
     /** WorldMatrix | WorldPosition */
     WmWp = 132,
     /** WorldMatrix | WorldEuler | WorldQuat */
     WmWeWq = 152,
-    /** WorldMatrix | WorldEuler | WorldQuat | WorldScale*/
-    WmWeWqWs = 184,
+    /** WorldMatrix | WorldEuler | WorldQuat | WorldScale | WorldFrontFaceInvert */
+    WmWeWqWs = 2232,
     /** WorldMatrix | WorldPosition | WorldEuler | WorldQuat */
     WmWpWeWq = 156,
-    /** WorldMatrix | WorldScale */
-    WmWs = 160,
-    /** WorldMatrix | WorldScale | WorldUniformScaling */
-    WmWsWus = 416,
-    /** WorldMatrix | WorldPosition | WorldScale */
-    WmWpWs = 164,
-    /** WorldMatrix | WorldPosition | WorldEuler | WorldQuat | WorldScale */
-    WmWpWeWqWs = 188,
-    /** WorldMatrix | WorldPosition | WorldEuler | WorldQuat | WorldScale | WorldUniformScaling */
-    WmWpWeWqWsWus = 444,
-    /** LocalQuat | LocalMatrix | WorldMatrix | WorldPosition | WorldEuler | WorldQuat | WorldScale | WorldUniformScaling */
-    LqLmWmWpWeWqWsWus = 510
+    /** WorldMatrix | WorldScale | WorldFrontFaceInvert */
+    WmWs = 2208,
+    /** WorldMatrix | WorldScale | WorldUniformScaling | WorldFrontFaceInvert */
+    WmWsWus = 2464,
+    /** WorldMatrix | WorldPosition | WorldScale | WorldFrontFaceInvert */
+    WmWpWs = 2212,
+    /** WorldMatrix | WorldPosition | WorldEuler | WorldQuat | WorldScale | WorldFrontFaceInvert */
+    WmWpWeWqWs = 2236,
+    /** WorldMatrix | WorldPosition | WorldEuler | WorldQuat | WorldScale | WorldUniformScaling | WorldFrontFaceInvert */
+    WmWpWeWqWsWus = 2492,
+    /** LocalQuat | LocalMatrix | WorldMatrix | WorldPosition | WorldEuler | WorldQuat | WorldScale | WorldUniformScaling | WorldFrontFaceInvert */
+    LqLmWmWpWeWqWsWus = 2558
 }

package/types/asset/AssetPromise.d.ts

@@ -57,7 +57,7 @@ export declare class AssetPromise<T> implements PromiseLike<T> {
      * @param onTaskDetail - This callback function provides detailed progress information about the task. For instance, in file downloading scenarios, you can use the loaded and total parameters to calculate the download progress percentage and utilize the url parameter to provide additional details such as download speed and estimated remaining time
      * @returns AssetPromise
      */
-    onProgress(onTaskComplete: (loaded: number, total: number) => void, onTaskDetail?: (identifier: string, loaded: number, total: number) => void): AssetPromise<T>;
+    onProgress(onTaskComplete?: (loaded: number, total: number) => void, onTaskDetail?: (identifier: string, loaded: number, total: number) => void): AssetPromise<T>;
     then<TResult1 = T, TResult2 = never>(onfulfilled?: (value: T) => TResult1 | PromiseLike<TResult1>, onrejected?: (reason: any) => TResult2 | PromiseLike<TResult2>): AssetPromise<TResult1 | TResult2>;
     /**
      * Attaches a callback for only the rejection of the Promise.

package/types/asset/LoadItem.d.ts

@@ -29,7 +29,8 @@ export type LoadItem = {
     params?: Record<string, any>;
 } & PickOnlyOne<{
     /**
-     * Loading url.
+     * Requested resource identity. Virtual resources keep their virtual path so
+     * loaders can resolve dependent resources through ResourceManager.
      */
     url: string;
     /**

package/types/clone/CloneDecorators.d.ts

@@ -1,17 +1,17 @@
 /**
- * Property decorator — deep clone this field's whole subtree, overriding the value type's default
+ * Field decorator — deep clone this field's whole subtree, overriding the value type's default
  * clone mode (field-level decorators have the highest priority). The deep intent carries into
  * field-cloneable members; engine-bound and platform objects keep their defaults. A decorator is
  * an explicit intent: if the decorated value itself can't be deep cloned (an entity reference,
  * asset, function, or object with opaque internal state), cloning throws rather than falling back.
  * Field-cloned classes reproduce only their own enumerable string-keyed properties.
  */
-export declare function deepClone(target: object, propertyKey: string): void;
+export declare function deepClone<This extends object, Value>(_value: undefined, context: ClassFieldDecoratorContext<This, Value>): void;
 /**
- * Property decorator — assign (share the reference) this field, overriding the value type's default clone mode.
+ * Field decorator — assign (share the reference) this field, overriding the value type's default clone mode.
  */
-export declare function assignmentClone(target: object, propertyKey: string): void;
+export declare function assignmentClone<This extends object, Value>(_value: undefined, context: ClassFieldDecoratorContext<This, Value>): void;
 /**
- * Property decorator — ignore this field when cloning; keep the clone's own constructor-built value.
+ * Field decorator — ignore this field when cloning; keep the clone's own constructor-built value.
  */
-export declare function ignoreClone(target: object, propertyKey: string): void;
+export declare function ignoreClone<This extends object, Value>(_value: undefined, context: ClassFieldDecoratorContext<This, Value>): void;

package/types/input/pointer/Pointer.d.ts

@@ -18,6 +18,8 @@ export declare class Pointer {
     pressedButtons: PointerButton;
     /** The position of the pointer in screen space pixel coordinates. */
     position: Vector2;
+    /** The position of the pointer when it was last pressed down (in screen space pixel coordinates). */
+    pressedPosition: Vector2;
     /** The change of the pointer. */
     deltaPosition: Vector2;
 }

package/types/input/pointer/PointerEventData.d.ts

@@ -1,4 +1,5 @@
 import { Vector3 } from "@galacean/engine-math";
+import { Entity } from "../../Entity";
 import { IPoolElement } from "../../utils/ObjectPool";
 import { Pointer } from "./Pointer";
 /**
@@ -9,4 +10,8 @@ export declare class PointerEventData implements IPoolElement {
     pointer: Pointer;
     /** The position of the event trigger (in world space). */
     worldPosition: Vector3;
+    /** The hit-tested target entity (deepest entity on the bubble path). */
+    target: Entity;
+    /** The entity currently handling the event (same as target on non-bubbling fire, varies on bubble). */
+    currentTarget: Entity;
 }

package/types/input/pointer/emitter/PointerEventEmitter.d.ts

@@ -17,7 +17,7 @@ export declare abstract class PointerEventEmitter {
     abstract processLeave(pointer: Pointer): void;
     abstract dispose(): void;
     protected abstract _init(): void;
-    protected _createEventData(pointer: Pointer): PointerEventData;
+    protected _createEventData(pointer: Pointer, target: Entity, currentTarget?: Entity): PointerEventData;
     protected _fireDown(entity: Entity, eventData: PointerEventData): void;
     protected _fireUp(entity: Entity, eventData: PointerEventData): void;
     protected _fireClick(entity: Entity, eventData: PointerEventData): void;

package/types/physics/CharacterController.d.ts

@@ -1,4 +1,4 @@
-import { Vector3 } from "@galacean/engine-math";
+import { Quaternion, Vector3 } from "@galacean/engine-math";
 import { Collider } from "./Collider";
 import { ControllerNonWalkableMode } from "./enums/ControllerNonWalkableMode";
 import { ColliderShape } from "./shape";
@@ -46,6 +46,7 @@ export declare class CharacterController extends Collider {
      */
     addShape(shape: ColliderShape): void;
     protected _syncNative(): void;
+    protected _teleportToEntityTransform(worldPosition: Vector3, _worldRotation: Quaternion): void;
     private _syncWorldPositionFromPhysicalSpace;
     private _setUpDirection;
 }

package/types/physics/Collider.d.ts

@@ -1,3 +1,4 @@
+import { Quaternion, Vector3 } from "@galacean/engine-math";
 import { BoolUpdateFlag } from "../BoolUpdateFlag";
 import type { ICloneHook } from "../clone/ICloneHook";
 import { Component } from "../Component";
@@ -11,6 +12,14 @@ export declare class Collider extends Component implements ICloneHook<Collider>
     protected _updateFlag: BoolUpdateFlag;
     protected _shapes: ColliderShape[];
     protected _collisionLayerIndex: number;
+    /**
+     * A collider must teleport on the next transform sync when its native actor
+     * already exists at a stale pose, such as after re-entering the scene or after
+     * clone-time native reconstruction. Ordinary first entry can use subclass sync
+     * semantics so kinematic actors still use setKinematicTarget.
+     */
+    private _pendingReenterTeleport;
+    private _enteredScene;
     /**
      * The shapes of this collider.
      */
@@ -41,6 +50,19 @@ export declare class Collider extends Component implements ICloneHook<Collider>
      */
     _onClone(target: Collider): void;
     protected _syncNative(): void;
+    /**
+     * Teleport native actor to a world pose (instant, no implied velocity).
+     * Used during initialization paths (clone) where the native actor must be re-aligned
+     * with the entity transform after construction-time pose was based on stale defaults.
+     */
+    protected _teleportToEntityTransform(worldPosition: Vector3, worldRotation: Quaternion): void;
+    /**
+     * Sync entity world transform to native actor for per-frame updates.
+     * Default semantics: teleport (setGlobalPose). Subclasses override to express
+     * physics-aware movement (e.g. DynamicCollider routes kinematic actors through
+     * setKinematicTarget to generate contact events on swept motion).
+     */
+    protected _syncEntityTransformToNative(worldPosition: Vector3, worldRotation: Quaternion): void;
     protected _addNativeShape(shape: ColliderShape): void;
     protected _removeNativeShape(shape: ColliderShape): void;
     private _setCollisionLayer;