@galacean/engine-core 1.0.0-beta.9 → 1.1.0-alpha.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galacean/engine-core",
-  "version": "1.0.0-beta.9",
+  "version": "1.1.0-alpha.0",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
@@ -15,10 +15,10 @@
     "types/**/*"
   ],
   "dependencies": {
-    "@galacean/engine-math": "1.0.0-beta.9"
+    "@galacean/engine-math": "1.1.0-alpha.0"
   },
   "devDependencies": {
-    "@galacean/engine-design": "1.0.0-beta.9"
+    "@galacean/engine-design": "1.1.0-alpha.0"
   },
   "scripts": {
     "b:types": "tsc"

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

@@ -1,10 +1,9 @@
 import { Renderer } from "../../Renderer";
-import { ICustomClone } from "../../clone/ComponentCloner";
 import { Sprite } from "./Sprite";
 /**
  * A component for masking Sprites.
  */
-export declare class SpriteMask extends Renderer implements ICustomClone {
+export declare class SpriteMask extends Renderer {
     /** The mask layers the sprite mask influence to. */
     influenceLayers: number;
     private _sprite;

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

@@ -1,6 +1,5 @@
 import { Color } from "@galacean/engine-math";
 import { Renderer } from "../../Renderer";
-import { ICustomClone } from "../../clone/ComponentCloner";
 import { SpriteDrawMode } from "../enums/SpriteDrawMode";
 import { SpriteMaskInteraction } from "../enums/SpriteMaskInteraction";
 import { SpriteTileMode } from "../enums/SpriteTileMode";
@@ -8,7 +7,7 @@ import { Sprite } from "./Sprite";
 /**
  * Renders a Sprite for 2D graphics.
  */
-export declare class SpriteRenderer extends Renderer implements ICustomClone {
+export declare class SpriteRenderer extends Renderer {
     private _drawMode;
     private _assembler;
     private _tileMode;

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

@@ -1,7 +1,6 @@
 import { BoundingBox, Color } from "@galacean/engine-math";
 import { Entity } from "../../Entity";
 import { Renderer } from "../../Renderer";
-import { ICustomClone } from "../../clone/ComponentCloner";
 import { FontStyle } from "../enums/FontStyle";
 import { SpriteMaskInteraction } from "../enums/SpriteMaskInteraction";
 import { TextHorizontalAlignment, TextVerticalAlignment } from "../enums/TextAlignment";
@@ -10,7 +9,7 @@ import { Font } from "./Font";
 /**
  * Renders a text for 2D graphics.
  */
-export declare class TextRenderer extends Renderer implements ICustomClone {
+export declare class TextRenderer extends Renderer {
     private static _charRenderDataPool;
     private static _tempVec30;
     private static _tempVec31;

package/types/Camera.d.ts

@@ -1,12 +1,12 @@
 import { Matrix, Ray, Vector2, Vector3, Vector4 } from "@galacean/engine-math";
 import { Component } from "./Component";
-import { CameraClearFlags } from "./enums/CameraClearFlags";
 import { Layer } from "./Layer";
+import { CameraClearFlags } from "./enums/CameraClearFlags";
 import { Shader } from "./shader/Shader";
 import { ShaderData } from "./shader/ShaderData";
 import { ShaderTagKey } from "./shader/ShaderTagKey";
-import { TextureCubeFace } from "./texture/enums/TextureCubeFace";
 import { RenderTarget } from "./texture/RenderTarget";
+import { TextureCubeFace } from "./texture/enums/TextureCubeFace";
 /**
  * Camera component, as the entrance to the three-dimensional world.
  * @decorator `@dependentComponents(Transform, DependentMode.CheckOnly)`
@@ -14,8 +14,6 @@ import { RenderTarget } from "./texture/RenderTarget";
 export declare class Camera extends Component {
     /** Shader data. */
     readonly shaderData: ShaderData;
-    /** Rendering priority - A Camera with higher priority will be rendered on top of a camera with lower priority. */
-    priority: number;
     /** Whether to enable frustum culling, it is enabled by default. */
     enableFrustumCulling: boolean;
     /**
@@ -28,6 +26,7 @@ export declare class Camera extends Component {
      * @remarks Support bit manipulation, corresponding to `Layer`.
      */
     cullingMask: Layer;
+    private _priority;
     private _isProjMatSetting;
     private _nearClipPlane;
     private _farClipPlane;
@@ -73,6 +72,11 @@ export declare class Camera extends Component {
      */
     get viewport(): Vector4;
     set viewport(value: Vector4);
+    /**
+     * Rendering priority, higher priority will be rendered on top of a camera with lower priority.
+     */
+    get priority(): number;
+    set priority(value: number);
     /**
      * Whether it is orthogonal, the default is false. True will use orthographic projection, false will use perspective projection.
      */
@@ -206,11 +210,11 @@ export declare class Camera extends Component {
     /**
      * @inheritdoc
      */
-    _onEnable(): void;
+    _onEnableInScene(): void;
     /**
      * @inheritdoc
      */
-    _onDisable(): void;
+    _onDisableInScene(): void;
     private _projMatChange;
     private _innerViewportToWorldPoint;
     private _updateShaderData;

package/types/Component.d.ts

@@ -6,6 +6,7 @@ import { Scene } from "./Scene";
  */
 export declare class Component extends EngineObject {
     private _phasedActive;
+    private _phasedActiveInScene;
     private _enabled;
     /**
      * Indicates whether the component is enabled.

package/types/Engine.d.ts

@@ -1,20 +1,18 @@
 import { IPhysics } from "@galacean/engine-design";
-import { ResourceManager } from "./asset/ResourceManager";
-import { EventDispatcher, Time } from "./base";
 import { Canvas } from "./Canvas";
 import { EngineSettings } from "./EngineSettings";
 import { Entity } from "./Entity";
+import { SceneManager } from "./SceneManager";
+import { ResourceManager } from "./asset/ResourceManager";
+import { EventDispatcher, Time } from "./base";
 import { ColorSpace } from "./enums/ColorSpace";
 import { InputManager } from "./input";
-import { PhysicsManager } from "./physics";
+import { PhysicsScene } from "./physics/PhysicsScene";
 import { IHardwareRenderer } from "./renderingHardwareInterface";
-import { SceneManager } from "./SceneManager";
 /**
  * Engine.
  */
 export declare class Engine extends EventDispatcher {
-    /** Physics manager of Engine. */
-    readonly physicsManager: PhysicsManager;
     /** Input manager of Engine. */
     readonly inputManager: InputManager;
     private _settings;
@@ -118,6 +116,11 @@ export declare class Engine extends EventDispatcher {
     private _createSpriteMaskMaterial;
     private _onDeviceLost;
     private _onDeviceRestored;
+    /**
+     * @deprecated
+     * The first scene physics manager.
+     */
+    get physicsManager(): PhysicsScene;
 }
 /**
  * Engine configuration.

package/types/Renderer.d.ts

@@ -1,12 +1,13 @@
 import { BoundingBox, Vector4 } from "@galacean/engine-math";
 import { Component } from "./Component";
+import { ICustomClone } from "./clone/ComponentCloner";
 import { Material } from "./material";
 import { ShaderData } from "./shader/ShaderData";
 /**
  * Basis for all renderers.
  * @decorator `@dependentComponents(Transform, DependentMode.CheckOnly)`
  */
-export declare class Renderer extends Component {
+export declare class Renderer extends Component implements ICustomClone {
     private static _tempVector0;
     private static _receiveShadowMacro;
     private static _localMatrixProperty;

package/types/SafeLoopArray.d.ts

@@ -0,0 +1,37 @@
+export declare class SafeLoopArray<T> {
+    private _array;
+    private _loopArray;
+    private _loopArrayDirty;
+    /**
+     * Get the length of the array.
+     */
+    get length(): number;
+    /**
+     * Push item to the array.
+     * @param item - The item which want to be pushed
+     */
+    push(item: T): void;
+    /**
+     * Splice the array.
+     * @param index - The index of the array
+     * @param deleteCount - The count of the array which want to be deleted
+     * @param item - The item which want to be added
+     */
+    splice(index: number, deleteCount: number, item?: T): void;
+    /**
+     * The index of the item.
+     * @param item - The item which want to get the index
+     * @returns Index of the item
+     */
+    indexOf(item: T): number;
+    /**
+     * Get the array.
+     * @returns The array
+     */
+    getArray(): ReadonlyArray<T>;
+    /**
+     * Get the array use for loop.
+     * @returns The array use for loop
+     */
+    getLoopArray(): ReadonlyArray<T>;
+}

package/types/Scene.d.ts

@@ -5,6 +5,7 @@ import { Entity } from "./Entity";
 import { EngineObject } from "./base";
 import { FogMode } from "./enums/FogMode";
 import { AmbientLight } from "./lighting/AmbientLight";
+import { PhysicsScene } from "./physics/PhysicsScene";
 import { ShaderData } from "./shader/ShaderData";
 import { ShadowCascadesMode } from "./shadow/enum/ShadowCascadesMode";
 import { ShadowResolution } from "./shadow/enum/ShadowResolution";
@@ -18,6 +19,8 @@ export declare class Scene extends EngineObject {
     private static _sunlightDirectionProperty;
     /** Scene name. */
     name: string;
+    /** Physics. */
+    readonly physics: PhysicsScene;
     /** The background of the scene. */
     readonly background: Background;
     /** Scene-related shader data. */
@@ -134,10 +137,6 @@ export declare class Scene extends EngineObject {
      * @returns Entity
      */
     findEntityByPath(path: string): Entity | null;
-    /**
-     * Destroy this scene.
-     */
-    destroy(): void;
     private _addToRootEntityList;
     private _computeLinearFogParams;
     private _computeExponentialFogParams;

package/types/SceneManager.d.ts

@@ -1,20 +1,35 @@
-import { AssetPromise } from "./asset/AssetPromise";
 import { Engine } from "./Engine";
 import { Scene } from "./Scene";
+import { AssetPromise } from "./asset/AssetPromise";
 /**
  * Scene manager.
  */
 export declare class SceneManager {
     readonly engine: Engine;
     /**
-     * Get the activated scene.
+     * Get the scene list.
      */
-    get activeScene(): Scene;
-    set activeScene(scene: Scene);
+    get scenes(): ReadonlyArray<Scene>;
+    /**
+     * Add scene.
+     * @param scene - The scene which want to be added
+     */
+    addScene(scene: Scene): void;
+    /**
+     * Add scene at specified index.
+     * @param index - specified index
+     * @param child - The scene which want to be added
+     */
+    addScene(index: number, scene: Scene): void;
+    /**
+     * Remove scene.
+     * @param scene - The scene which want to be removed
+     */
+    removeScene(scene: Scene): void;
     /**
      * Load and activate scene.
      * @param url - the path of the scene
-     * @param destroyOldScene - whether to destroy old scene information
+     * @param destroyOldScene - whether to destroy old scene
      * @returns scene promise
      */
     loadScene(url: string, destroyOldScene?: boolean): AssetPromise<Scene>;
@@ -25,4 +40,12 @@ export declare class SceneManager {
      * @param destScene - target scene
      */
     mergeScenes(sourceScene: Scene, destScene: Scene): void;
+    /**
+     * @deprecated
+     * Please use `scenes` instead.
+     *
+     * Get the first scene.
+     */
+    get activeScene(): Scene;
+    set activeScene(scene: Scene);
 }

package/types/animation/Animator.d.ts

@@ -14,8 +14,7 @@ export declare class Animator extends Component {
     protected _animatorController: AnimatorController;
     protected _controllerUpdateFlag: BoolUpdateFlag;
     private _animatorLayersData;
-    private _crossOwnerCollection;
-    private _animationCurveOwners;
+    private _curveOwnerPool;
     private _animationEventHandlerPool;
     private _tempAnimatorStateInfo;
     private _controlledRenderers;
@@ -61,7 +60,7 @@ export declare class Animator extends Component {
     private _saveAnimatorStateData;
     private _saveAnimatorEventHandlers;
     private _clearCrossData;
-    private _addCrossCurveData;
+    private _addCrossOwner;
     private _prepareCrossFading;
     private _prepareStandbyCrossFading;
     private _prepareFixedPoseCrossFading;

package/types/animation/internal/AnimationCurveLayerOwner.d.ts

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

package/types/animation/internal/AnimationCurveOwnerLayerData.d.ts

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

package/types/enums/ActiveChangeFlag.d.ts

@@ -0,0 +1,6 @@
+export declare enum ActiveChangeFlag {
+    None = 0,
+    Scene = 1,
+    Hierarchy = 2,
+    All = 3
+}

package/types/index.d.ts

@@ -22,7 +22,7 @@ export { AssetPromise } from "./asset/AssetPromise";
 export type { LoadItem } from "./asset/LoadItem";
 export { AssetType } from "./asset/AssetType";
 export { ReferResource } from "./asset/ReferResource";
-export * from "./RenderPipeline";
+export * from "./RenderPipeline/Index";
 export * from "./base";
 export { Background } from "./Background";
 export { BackgroundMode } from "./enums/BackgroundMode";

package/types/input/InputManager.d.ts

@@ -1,7 +1,7 @@
+import { Vector3 } from "@galacean/engine-math";
 import { Keys } from "./enums/Keys";
-import { Pointer } from "./pointer/Pointer";
 import { PointerButton } from "./enums/PointerButton";
-import { Vector3 } from "@galacean/engine-math";
+import { Pointer } from "./pointer/Pointer";
 /**
  * InputManager manages device input such as mouse, touch, keyboard, etc.
  */

package/types/mesh/MeshRenderer.d.ts

@@ -1,10 +1,9 @@
 import { Renderer } from "../Renderer";
-import { ICustomClone } from "../clone/ComponentCloner";
 import { Mesh } from "../graphic/Mesh";
 /**
  * MeshRenderer Component.
  */
-export declare class MeshRenderer extends Renderer implements ICustomClone {
+export declare class MeshRenderer extends Renderer {
     private static _uvMacro;
     private static _uv1Macro;
     private static _normalMacro;

package/types/physics/PhysicsScene.d.ts

@@ -0,0 +1,75 @@
+import { Ray, Vector3 } from "@galacean/engine-math";
+import { Layer } from "../Layer";
+import { Scene } from "../Scene";
+import { HitResult } from "./HitResult";
+/**
+ * A physics scene is a collection of colliders and constraints which can interact.
+ */
+export declare class PhysicsScene {
+    private static _collision;
+    private _scene;
+    private _restTime;
+    private _colliders;
+    private _gravity;
+    private _nativePhysicsScene;
+    private _onContactEnter;
+    private _onContactExit;
+    private _onContactStay;
+    private _onTriggerEnter;
+    private _onTriggerExit;
+    private _onTriggerStay;
+    /** The fixed time step in seconds at which physics are performed. */
+    fixedTimeStep: number;
+    /**
+     * The gravity of physics scene.
+     */
+    get gravity(): Vector3;
+    set gravity(value: Vector3);
+    constructor(scene: Scene);
+    /**
+     * Casts a ray through the Scene and returns the first hit.
+     * @param ray - The ray
+     * @returns Returns True if the ray intersects with a collider, otherwise false
+     */
+    raycast(ray: Ray): boolean;
+    /**
+     * Casts a ray through the Scene and returns the first hit.
+     * @param ray - The ray
+     * @param outHitResult - If true is returned, outHitResult will contain more detailed collision information
+     * @returns Returns True if the ray intersects with a collider, otherwise false
+     */
+    raycast(ray: Ray, outHitResult: HitResult): boolean;
+    /**
+     * Casts a ray through the Scene and returns the first hit.
+     * @param ray - The ray
+     * @param distance - The max distance the ray should check
+     * @returns Returns True if the ray intersects with a collider, otherwise false
+     */
+    raycast(ray: Ray, distance: number): boolean;
+    /**
+     * Casts a ray through the Scene and returns the first hit.
+     * @param ray - The ray
+     * @param distance - The max distance the ray should check
+     * @param outHitResult - If true is returned, outHitResult will contain more detailed collision information
+     * @returns Returns True if the ray intersects with a collider, otherwise false
+     */
+    raycast(ray: Ray, distance: number, outHitResult: HitResult): boolean;
+    /**
+     * Casts a ray through the Scene and returns the first hit.
+     * @param ray - The ray
+     * @param distance - The max distance the ray should check
+     * @param layerMask - Layer mask that is used to selectively ignore Colliders when casting
+     * @returns Returns True if the ray intersects with a collider, otherwise false
+     */
+    raycast(ray: Ray, distance: number, layerMask: Layer): boolean;
+    /**
+     * Casts a ray through the Scene and returns the first hit.
+     * @param ray - The ray
+     * @param distance - The max distance the ray should check
+     * @param layerMask - Layer mask that is used to selectively ignore Colliders when casting
+     * @param outHitResult - If true is returned, outHitResult will contain more detailed collision information
+     * @returns Returns True if the ray intersects with a collider, otherwise false.
+     */
+    raycast(ray: Ray, distance: number, layerMask: Layer, outHitResult: HitResult): boolean;
+    private _setGravity;
+}

package/types/physics/index.d.ts

@@ -1,10 +1,10 @@
-export { HitResult } from "./HitResult";
-export { PhysicsManager } from "./PhysicsManager";
-export { PhysicsMaterial } from "./PhysicsMaterial";
 export { CharacterController } from "./CharacterController";
-export * from "./shape";
-export * from "./joint";
-export * from "./enums";
 export { Collider } from "./Collider";
+export { CollisionDetectionMode, DynamicCollider, DynamicColliderConstraints } from "./DynamicCollider";
+export { HitResult } from "./HitResult";
+export { PhysicsMaterial } from "./PhysicsMaterial";
+export { PhysicsScene } from "./PhysicsScene";
 export { StaticCollider } from "./StaticCollider";
-export { DynamicCollider, CollisionDetectionMode, DynamicColliderConstraints } from "./DynamicCollider";
+export * from "./enums";
+export * from "./joint";
+export * from "./shape";

package/types/shader/index.d.ts

@@ -13,3 +13,4 @@ export { ShaderPass } from "./ShaderPass";
 export { ShaderProperty } from "./ShaderProperty";
 export { ShaderTagKey } from "./ShaderTagKey";
 export { SubShader } from "./SubShader";
+export * from "./state";

package/types/shader/state/index.d.ts

@@ -0,0 +1,6 @@
+export { BlendState } from "./BlendState";
+export { DepthState } from "./DepthState";
+export { RasterState } from "./RasterState";
+export { RenderState } from "./RenderState";
+export { RenderTargetBlendState } from "./RenderTargetBlendState";
+export { StencilState } from "./StencilState";

package/types/utils/BoolUpdateFlag.d.ts

@@ -0,0 +1,12 @@
+import { UpdateFlag } from "./UpdateFlag";
+/**
+ * Bool update flag.
+ */
+export declare class BoolUpdateFlag extends UpdateFlag {
+    /** Bool flag. */
+    flag: boolean;
+    /**
+     * @inheritdoc
+     */
+    dispatch(): void;
+}

package/types/utils/DisorderedArray.d.ts

@@ -0,0 +1,18 @@
+/**
+ * High-performance unordered array, delete uses exchange method to improve performance, internal capacity only increases.
+ */
+export declare class DisorderedArray<T> {
+    _elements: T[];
+    length: number;
+    constructor(count?: number);
+    add(element: T): void;
+    delete(element: T): void;
+    get(index: number): T;
+    /**
+     *
+     * @param index
+     * @returns The replaced item is used to reset its index.
+     */
+    deleteByIndex(index: number): T;
+    garbageCollection(): void;
+}

package/types/utils/SafeLoopArray.d.ts

@@ -0,0 +1,41 @@
+export declare class SafeLoopArray<T> {
+    private _array;
+    private _loopArray;
+    private _loopArrayDirty;
+    /**
+     * Get the length of the array.
+     */
+    get length(): number;
+    /**
+     * Push item to the array.
+     * @param item - The item which want to be pushed
+     */
+    push(item: T): void;
+    /**
+     * Add item to the array.
+     * @param index - The index of the array
+     * @param item - The item which want to be added
+     */
+    add(index: number, item: T): void;
+    /**
+     * Remove item from the array.
+     * @param index - The index of the array
+     */
+    removeByIndex(index: number): void;
+    /**
+     * The index of the item.
+     * @param item - The item which want to get the index
+     * @returns Index of the item
+     */
+    indexOf(item: T): number;
+    /**
+     * Get the array.
+     * @returns The array
+     */
+    getArray(): ReadonlyArray<T>;
+    /**
+     * Get the array use for loop.
+     * @returns The array use for loop
+     */
+    getLoopArray(): ReadonlyArray<T>;
+}

package/types/utils/UpdateFlag.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Used to update tags.
+ */
+export declare abstract class UpdateFlag {
+    /**
+     * Dispatch.
+     * @param bit - Bit
+     * @param param - Parameter
+     */
+    abstract dispatch(bit?: number, param?: Object): void;
+    /**
+     * Clear.
+     */
+    clearFromManagers(): void;
+    /**
+     * Destroy.
+     */
+    destroy(): void;
+    private _removeFromManagers;
+}

package/types/utils/UpdateFlagManager.d.ts

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

package/types/utils/Utils.d.ts

@@ -0,0 +1,31 @@
+export declare class Utils {
+    /**
+     * Fast remove an element from array.
+     * @param array - Array
+     * @param item - Element
+     */
+    static removeFromArray(array: any[], item: any): boolean;
+    /**
+     * Decodes a given Uint8Array into a string.
+     */
+    static decodeText(array: Uint8Array): string;
+    /**
+     * Judge whether the url is absolute url.
+     * @param url - The url to be judged.
+     * @returns Whether the url is absolute url.
+     */
+    static isAbsoluteUrl(url: string): boolean;
+    /**
+     * Get the values of an object.
+     */
+    static objectValues(obj: any): any[];
+    /**
+     * Convert a relative URL to an absolute URL based on a given base URL.
+     * @param baseUrl - The base url.
+     * @param relativeUrl - The relative url.
+     * @returns The resolved url.
+     */
+    static resolveAbsoluteUrl(baseUrl: string, relativeUrl: string): string;
+    private static _stringToPath;
+    private static _formatRelativePath;
+}