@galacean/engine-core 0.0.0-experimental-renderSort.4 → 0.0.0-experimental-stateMachine.0

package/package.json

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

package/types/BasicResources.d.ts

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

package/types/Camera.d.ts

@@ -3,6 +3,8 @@ import { Component } from "./Component";
 import { Layer } from "./Layer";
 import { CameraClearFlags } from "./enums/CameraClearFlags";
 import { DepthTextureMode } from "./enums/DepthTextureMode";
+import { Downsampling } from "./enums/Downsampling";
+import { MSAASamples } from "./enums/MSAASamples";
 import { Shader } from "./shader/Shader";
 import { ShaderData } from "./shader/ShaderData";
 import { ShaderTagKey } from "./shader/ShaderTagKey";
@@ -22,6 +24,7 @@ export declare class Camera extends Component {
     enableFrustumCulling: boolean;
     /**
      * Determining what to clear when rendering by a Camera.
+     *
      * @defaultValue `CameraClearFlags.All`
      */
     clearFlags: CameraClearFlags;
@@ -32,31 +35,59 @@ export declare class Camera extends Component {
     cullingMask: Layer;
     /**
      * Depth texture mode.
+     * If `DepthTextureMode.PrePass` is used, the depth texture can be accessed in the shader using `camera_DepthTexture`.
+     *
      * @defaultValue `DepthTextureMode.None`
      */
     depthTextureMode: DepthTextureMode;
+    /**
+     * Opacity texture down sampling.
+     *
+     * @defaultValue `Downsampling.TwoX`
+     */
+    opaqueTextureDownsampling: Downsampling;
+    /**
+     * Multi-sample anti-aliasing samples when use independent canvas mode.
+     *
+     * @remarks The `independentCanvasEnabled` property should be `true` to take effect, otherwise it will be invalid.
+     */
+    msaaSamples: MSAASamples;
     private _priority;
     private _shaderData;
-    private _isProjMatSetting;
-    private _nearClipPlane;
-    private _farClipPlane;
+    private _isCustomViewMatrix;
+    private _isCustomProjectionMatrix;
     private _fieldOfView;
     private _orthographicSize;
     private _isProjectionDirty;
     private _isInvProjMatDirty;
-    private _isFrustumProjectDirty;
     private _customAspectRatio;
     private _renderTarget;
     private _depthBufferParams;
-    private _frustumViewChangeFlag;
+    private _opaqueTextureEnabled;
+    private _frustumChangeFlag;
     private _transform;
     private _isViewMatrixDirty;
     private _isInvViewProjDirty;
     private _viewport;
     private _pixelViewport;
     private _inverseProjectionMatrix;
-    private _lastAspectSize;
     private _invViewProjMat;
+    /**
+     * Whether to enable opaque texture.
+     * If enabled, the opaque texture can be accessed in the shader using `camera_OpaqueTexture`.
+     *
+     * @defaultValue `false`
+     *
+     * @remarks If enabled, the `independentCanvasEnabled` property will be forced to be true.
+     */
+    get opaqueTextureEnabled(): boolean;
+    set opaqueTextureEnabled(value: boolean);
+    /**
+     * Whether independent canvas is enabled.
+     *
+     * @remarks If true, the msaa in viewport can turn or off independently by `msaaSamples` property.
+     */
+    get independentCanvasEnabled(): boolean;
     /**
      * Shader data.
      */
@@ -113,12 +144,13 @@ export declare class Camera extends Component {
      * View matrix.
      */
     get viewMatrix(): Readonly<Matrix>;
+    set viewMatrix(value: Matrix);
     /**
      * The projection matrix is ​​calculated by the relevant parameters of the camera by default.
      * If it is manually set, the manual value will be maintained. Call resetProjectionMatrix() to restore it.
      */
+    get projectionMatrix(): Readonly<Matrix>;
     set projectionMatrix(value: Matrix);
-    get projectionMatrix(): Matrix;
     /**
      * Whether to enable HDR.
      * @todo When render pipeline modification
@@ -130,6 +162,10 @@ export declare class Camera extends Component {
      */
     get renderTarget(): RenderTarget | null;
     set renderTarget(value: RenderTarget | null);
+    /**
+     * Restore the view matrix to the world matrix of the entity.
+     */
+    resetViewMatrix(): void;
     /**
      * Restore the automatic calculation of projection matrix through fieldOfView, nearClipPlane and farClipPlane.
      */
@@ -238,7 +274,8 @@ export declare class Camera extends Component {
      */
     _onDisableInScene(): void;
     private _updatePixelViewport;
-    private _projMatChange;
+    private _viewMatrixChange;
+    private _projectionMatrixChange;
     private _innerViewportToWorldPoint;
     private _updateShaderData;
     /**
@@ -249,4 +286,7 @@ export declare class Camera extends Component {
      * The inverse of the projection matrix.
      */
     private _getInverseProjectionMatrix;
+    private _forceUseInternalCanvas;
+    private _onPixelViewportChanged;
+    private _checkMainCanvasAntialiasWaste;
 }

package/types/Canvas.d.ts

@@ -1,9 +1,19 @@
 /**
  * Canvas.
  */
-export interface Canvas {
-    /** The width of the canvas. */
-    width: number;
-    /** The height of the canvas. */
-    height: number;
+export declare abstract class Canvas {
+    private _width;
+    private _height;
+    /**
+     * The width of the canvas.
+     */
+    get width(): number;
+    set width(value: number);
+    /**
+     *The height of the canvas.
+     */
+    get height(): number;
+    set height(value: number);
+    protected abstract _onWidthChanged(value: number): void;
+    protected abstract _onHeightChange(value: number): void;
 }

package/types/Component.d.ts

@@ -1,3 +1,4 @@
+import { IReferable } from "./asset/IReferable";
 import { EngineObject } from "./base";
 import { Entity } from "./Entity";
 import { Scene } from "./Scene";
@@ -22,4 +23,5 @@ export declare class Component extends EngineObject {
      */
     get scene(): Scene;
     constructor(entity: Entity);
+    protected _addResourceReferCount(resource: IReferable, count: number): void;
 }

package/types/ComponentsManager.d.ts

@@ -16,6 +16,9 @@ export declare class ComponentsManager {
     private _onUpdateAnimations;
     private _onUpdateRenderers;
     private _componentsContainerPool;
+    addCamera(camera: Camera): void;
+    removeCamera(camera: Camera): void;
+    sortCameras(): void;
     addRenderer(renderer: Renderer): void;
     removeRenderer(renderer: Renderer): void;
     addOnStartScript(script: Script): void;

package/types/DisorderedArray.d.ts

@@ -19,6 +19,7 @@ export declare class DisorderedArray<T> {
     deleteByIndex(index: number): T;
     forEach(callbackFn: (element: T) => void, swapFn: (element: T, index: number) => void): void;
     forEachAndClean(callbackFn: (e: T) => void): void;
+    sort(compareFn: (a: T, b: T) => number): void;
     garbageCollection(): void;
     private _startLoop;
     private _endLoop;

package/types/Engine.d.ts

@@ -1,4 +1,4 @@
-import { IPhysics, IShaderLab } from "@galacean/engine-design";
+import { IHardwareRenderer, IInputOptions, IPhysics, IShaderLab, IXRDevice } from "@galacean/engine-design";
 import { Canvas } from "./Canvas";
 import { EngineSettings } from "./EngineSettings";
 import { Entity } from "./Entity";
@@ -8,13 +8,15 @@ import { EventDispatcher, Time } from "./base";
 import { ColorSpace } from "./enums/ColorSpace";
 import { InputManager } from "./input";
 import { PhysicsScene } from "./physics/PhysicsScene";
-import { IHardwareRenderer } from "./renderingHardwareInterface";
+import { XRManager } from "./xr/XRManager";
 /**
  * Engine.
  */
 export declare class Engine extends EventDispatcher {
     /** Input manager of Engine. */
     readonly inputManager: InputManager;
+    /** XR manager of Engine. */
+    readonly xrManager: XRManager;
     private _settings;
     private _resourceManager;
     private _sceneManager;
@@ -130,8 +132,12 @@ export declare class Engine extends EventDispatcher {
 export interface EngineConfiguration {
     /** Physics. */
     physics?: IPhysics;
+    /** XR Device. */
+    xrDevice?: IXRDevice;
     /** Color space. */
     colorSpace?: ColorSpace;
-    /** Shader lab */
+    /** Shader lab. */
     shaderLab?: IShaderLab;
+    /** Input options. */
+    input?: IInputOptions;
 }

package/types/Entity.d.ts

@@ -15,6 +15,7 @@ export declare class Entity extends EngineObject {
     layer: Layer;
     /** Transform component. */
     readonly transform: Transform;
+    private _templateResource;
     private _parent;
     private _activeChangedComponents;
     /**

package/types/RenderPipeline/BasicRenderPipeline.d.ts

@@ -1,48 +1,23 @@
 import { Camera } from "../Camera";
-import { Layer } from "../Layer";
-import { Material } from "../material";
-import { RenderTarget, TextureCubeFace } from "../texture";
+import { CameraClearFlags } from "../enums/CameraClearFlags";
+import { TextureCubeFace } from "../texture";
 import { RenderContext } from "./RenderContext";
 import { RenderData } from "./RenderData";
-import { RenderPass } from "./RenderPass";
 /**
  * Basic render pipeline.
  */
 export declare class BasicRenderPipeline {
     private _camera;
-    private _defaultPass;
-    private _renderPassArray;
     private _lastCanvasSize;
-    private _cascadedShadowCaster;
+    private _internalColorTarget;
+    private _cascadedShadowCasterPass;
     private _depthOnlyPass;
+    private _opaqueTexturePass;
     /**
      * Create a basic render pipeline.
      * @param camera - Camera
      */
     constructor(camera: Camera);
-    /**
-     * Default render pass.
-     */
-    get defaultRenderPass(): RenderPass;
-    /**
-     * Add render pass.
-     * @param nameOrPass - The name of this Pass or RenderPass object. When it is a name, the following parameters need to be provided
-     * @param priority - Priority, less than 0 before the default pass, greater than 0 after the default pass
-     * @param renderTarget - The specified Render Target
-     * @param replaceMaterial -  Replaced material
-     * @param mask - Perform bit and operations with Entity.Layer to filter the objects that this Pass needs to render
-     */
-    addRenderPass(nameOrPass: string | RenderPass, priority?: number, renderTarget?: RenderTarget, replaceMaterial?: Material, mask?: Layer): void;
-    /**
-     * Remove render pass by name or render pass object.
-     * @param nameOrPass - Render pass name or render pass object
-     */
-    removeRenderPass(nameOrPass: string | RenderPass): void;
-    /**
-     * Get render pass by name.
-     * @param  name - Render pass name
-     */
-    getRenderPass(name: string): RenderPass;
     /**
      * Destroy internal resources.
      */
@@ -52,8 +27,9 @@ export declare class BasicRenderPipeline {
      * @param context - Render context
      * @param cubeFace - Render surface of cube texture
      * @param mipLevel - Set mip level the data want to write
+     * @param ignoreClear - Ignore clear flag
      */
-    render(context: RenderContext, cubeFace?: TextureCubeFace, mipLevel?: number): void;
+    render(context: RenderContext, cubeFace?: TextureCubeFace, mipLevel?: number, ignoreClear?: CameraClearFlags): void;
     private _drawRenderPass;
     /**
      * Push render data to render queue.
@@ -63,5 +39,6 @@ export declare class BasicRenderPipeline {
     pushRenderData(context: RenderContext, data: RenderData): void;
     private pushRenderDataWithShader;
     private _drawBackgroundTexture;
-    private _callRender;
+    private _prepareRender;
+    private _updateMVPShaderData;
 }

package/types/RenderPipeline/OpaqueTexturePass.d.ts

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

package/types/RenderPipeline/RenderQueue.d.ts

@@ -1,6 +1,5 @@
 import { Camera } from "../Camera";
 import { Engine } from "../Engine";
-import { Layer } from "../Layer";
 import { RenderQueueType } from "../shader";
 import { RenderElement } from "./RenderElement";
 /**
@@ -15,7 +14,7 @@ export declare class RenderQueue {
      * Push a render element.
      */
     pushRenderElement(element: RenderElement): void;
-    render(camera: Camera, mask: Layer, pipelineStageTagValue: string): void;
+    render(camera: Camera, pipelineStageTagValue: string): void;
     /**
      * Clear collection.
      */
@@ -28,11 +27,4 @@ export declare class RenderQueue {
      * Sort the elements.
      */
     sort(compareFunc: Function): void;
-    /**
-     * @remarks
-     * Modified based on v8.
-     * https://github.com/v8/v8/blob/7.2-lkgr/src/js/array.js
-     */
-    private _quickSort;
-    private _insertionSort;
 }

package/types/RenderPipeline/{Index.d.ts → index.d.ts}

@@ -1,4 +1,3 @@
 export { BasicRenderPipeline } from "./BasicRenderPipeline";
 export { PipelineStage } from "./enums/PipelineStage";
-export { RenderPass } from "./RenderPass";
 export { RenderQueue } from "./RenderQueue";

package/types/Renderer.d.ts

@@ -1,5 +1,6 @@
-import { BoundingBox, Vector4 } from "@galacean/engine-math";
+import { BoundingBox, Matrix, Vector4 } from "@galacean/engine-math";
 import { Component } from "./Component";
+import { RenderContext } from "./RenderPipeline/RenderContext";
 import { IComponentCustomClone } from "./clone/ComponentCloner";
 import { Material } from "./material";
 import { ShaderData } from "./shader/ShaderData";
@@ -110,5 +111,7 @@ export declare class Renderer extends Component implements IComponentCustomClone
      */
     setMaterials(materials: Material[]): void;
     update(deltaTime: number): void;
+    protected _updateTransformShaderData(context: RenderContext, worldMatrix: Matrix): void;
+    protected _updateMVPShaderData(context: RenderContext, worldMatrix: Matrix): void;
     private _setMaterial;
 }

package/types/Scene.d.ts

@@ -4,6 +4,7 @@ import { Engine } from "./Engine";
 import { Entity } from "./Entity";
 import { EngineObject } from "./base";
 import { FogMode } from "./enums/FogMode";
+import { DirectLight } from "./lighting";
 import { AmbientLight } from "./lighting/AmbientLight";
 import { PhysicsScene } from "./physics/PhysicsScene";
 import { ShaderData } from "./shader/ShaderData";
@@ -15,8 +16,6 @@ import { ShadowResolution } from "./shadow/enum/ShadowResolution";
 export declare class Scene extends EngineObject {
     private static _fogColorProperty;
     private static _fogParamsProperty;
-    private static _sunlightColorProperty;
-    private static _sunlightDirectionProperty;
     /** Scene name. */
     name: string;
     /** Physics. */
@@ -31,6 +30,11 @@ export declare class Scene extends EngineObject {
     shadowFourCascadeSplits: Vector3;
     /** Max Shadow distance. */
     shadowDistance: number;
+    /**
+     * Last shadow fade distance in percentage, range [0,1].
+     * @remarks Value 0 is used for no shadow fade.
+     */
+    shadowFadeBorder: number;
     private _background;
     private _shaderData;
     private _shadowCascades;
@@ -42,6 +46,7 @@ export declare class Scene extends EngineObject {
     private _fogDensity;
     private _fogParams;
     private _isActive;
+    private _sun;
     /**
      * Whether the scene is active.
      */
@@ -103,6 +108,12 @@ export declare class Scene extends EngineObject {
      * Root entity collection.
      */
     get rootEntities(): Readonly<Entity[]>;
+    /**
+     * Sun light source.
+     * @remarks If set this to null, scene will use the brightest directional light.
+     */
+    get sun(): DirectLight | null;
+    set sun(light: DirectLight | null);
     /**
      * Create scene.
      * @param engine - Engine
@@ -152,4 +163,5 @@ export declare class Scene extends EngineObject {
     private _addToRootEntityList;
     private _computeLinearFogParams;
     private _computeExponentialFogParams;
+    private _getSunlight;
 }

package/types/SystemInfo.d.ts

@@ -7,6 +7,8 @@ export declare class SystemInfo {
     static platform: Platform;
     /** The operating system is running on. */
     static operatingSystem: string;
+    /** Whether the system support SIMD. */
+    private static _simdSupported;
     /**
      * The pixel ratio of the device.
      */

package/types/Utils.d.ts

@@ -15,6 +15,12 @@ export declare class Utils {
      * @returns Whether the url is absolute url.
      */
     static isAbsoluteUrl(url: string): boolean;
+    /**
+     * Judge whether the url is base64 url.
+     * @param url - The url to be judged.
+     * @returns Whether the url is base64 url.
+     */
+    static isBase64Url(url: string): boolean;
     /**
      * Get the values of an object.
      */
@@ -27,5 +33,5 @@ export declare class Utils {
      */
     static resolveAbsoluteUrl(baseUrl: string, relativeUrl: string): string;
     private static _stringToPath;
-    private static _formatRelativePath;
+    private static _insertionSort;
 }

package/types/animation/AnimationClip.d.ts

@@ -46,12 +46,40 @@ export declare class AnimationClip extends EngineObject {
     clearEvents(): void;
     /**
      * Add curve binding for the clip.
-     * @param relativePath - Path to the game object this curve applies to. The relativePath is formatted similar to a pathname, e.g. "/root/spine/leftArm"
-     * @param type- The class type of the component that is animated
-     * @param propertyName - The name or path to the property being animated
+     * @param entityPath - Path to the game object this curve applies to. The entityPath is formatted similar to a pathname, e.g. "/root/spine/leftArm"
+     * @param componentType - The class type of the component that is animated
+     * @param propertyPath - The path to the property being animated, support "a.b" and "a.b[x]" description mode
      * @param curve - The animation curve
      */
-    addCurveBinding<T extends Component>(relativePath: string, type: new (entity: Entity) => T, propertyName: string, curve: AnimationCurve<KeyframeValueType>): void;
+    addCurveBinding<T extends Component>(entityPath: string, componentType: new (entity: Entity) => T, propertyPath: string, curve: AnimationCurve<KeyframeValueType>): void;
+    /**
+     * Add curve binding for the clip.
+     * @param entityPath - Path to the game object this curve applies to. The entityPath is formatted similar to a pathname, e.g. "/root/spine/leftArm"
+     * @param componentType - The class type of the component that is animated
+     * @param setPropertyPath - The path to set the property being animated, support "a.b", "a.b[x]" and "a.b('c', 0, $value)" description mode
+     * @param getPropertyPath - The path to get the value when being animated, support "a.b", "a.b[x]" and "a.b('c', 0, $value)" description mode
+     * @param curve - The animation curve
+     */
+    addCurveBinding<T extends Component>(entityPath: string, componentType: new (entity: Entity) => T, setPropertyPath: string, getPropertyPath: string, curve: AnimationCurve<KeyframeValueType>): void;
+    /**
+     * Add curve binding for the clip.
+     * @param entityPath - Path to the game object this curve applies to. The entityPath is formatted similar to a pathname, e.g. "/root/spine/leftArm"
+     * @param componentType - The type index of the component that is animated
+     * @param componentIndex - The class type of the component that is animated
+     * @param propertyPath - The path to the property being animated, support "a.b" and "a.b[x]" description mode
+     * @param curve - The animation curve
+     */
+    addCurveBinding<T extends Component>(entityPath: string, componentType: new (entity: Entity) => T, componentIndex: number, propertyPath: string, curve: AnimationCurve<KeyframeValueType>): void;
+    /**
+     * Add curve binding for the clip.
+     * @param entityPath - Path to the game object this curve applies to. The entityPath is formatted similar to a pathname, e.g. "/root/spine/leftArm"
+     * @param componentType - The class type of the component that is animated
+     * @param componentIndex - The class type of the component that is animated
+     * @param setPropertyPath - The path to set the property being animated, support "a.b", "a.b[x]" and "a.b('c', 0, $value)" description mode
+     * @param getPropertyPath - The path to get the value when being animated, support "a.b", "a.b[x]" and "a.b('c', 0, $value)" description mode
+     * @param curve - The animation curve
+     */
+    addCurveBinding<T extends Component>(entityPath: string, componentType: new (entity: Entity) => T, componentIndex: number, setPropertyPath: string, getPropertyPath: string, curve: AnimationCurve<KeyframeValueType>): void;
     /**
      * Clears all curve bindings from the clip.
      */

package/types/animation/AnimationClipCurveBinding.d.ts

@@ -1,7 +1,7 @@
 import { Component } from "../Component";
 import { Entity } from "../Entity";
-import { AnimationCurve } from "./animationCurve";
 import { KeyframeValueType } from "./Keyframe";
+import { AnimationCurve } from "./animationCurve";
 /**
  * Associate AnimationCurve and the Entity
  */
@@ -13,8 +13,18 @@ export declare class AnimationClipCurveBinding {
     relativePath: string;
     /** The class type of the component that is animated. */
     type: new (entity: Entity) => Component;
-    /** The name or path to the property being animated. */
+    /** The index of the component that is animated. */
+    typeIndex: number;
+    /**
+     * The name or path to the property being animated.
+     * @remarks support property:"a.b", array: "a.b[0]", method: "a.b('c', 0, $value)"
+     */
     property: string;
+    /**
+     * The name or path to get the value when being animated.
+     * @remarks support property:"a.b", array: "a.b[0]", method: "a.b('c', 0)"
+     */
+    getProperty?: string;
     /** The animation curve. */
     curve: AnimationCurve<KeyframeValueType>;
     private _tempCurveOwner;

package/types/animation/Animator.d.ts

@@ -2,7 +2,10 @@ import { BoolUpdateFlag } from "../BoolUpdateFlag";
 import { Component } from "../Component";
 import { AnimatorController } from "./AnimatorController";
 import { AnimatorState } from "./AnimatorState";
+import { AnimatorStateTransition } from "./AnimatorTransition";
 import { AnimatorCullingMode } from "./enums/AnimatorCullingMode";
+import { AnimatorControllerLayer } from "./AnimatorControllerLayer";
+import { AnimatorControllerParameter, AnimatorControllerParameterValue } from "./AnimatorControllerParameter";
 /**
  * The controller of the animation system.
  */
@@ -24,6 +27,14 @@ export declare class Animator extends Component {
      */
     get animatorController(): AnimatorController;
     set animatorController(animatorController: AnimatorController);
+    /**
+     * The layers in the animator's controller.
+     */
+    get layers(): Readonly<AnimatorControllerLayer[]>;
+    /**
+     * The parameters in the animator's controller.
+     */
+    get parameters(): Readonly<AnimatorControllerParameter[]>;
     /**
      * Play a state by name.
      * @param stateName - The state name
@@ -39,6 +50,7 @@ export declare class Animator extends Component {
      * @param normalizedTimeOffset - The time offset between 0 and 1(default 0)
      */
     crossFade(stateName: string, normalizedTransitionDuration: number, layerIndex?: number, normalizedTimeOffset?: number): void;
+    crossFade(transition: AnimatorStateTransition, layerIndex?: number): void;
     /**
      * Evaluates the animator component based on deltaTime.
      * @param deltaTime - The deltaTime when the animation update
@@ -55,6 +67,21 @@ export declare class Animator extends Component {
      * @param layerIndex - The layer index(default -1). If layer is -1, find the first state with the given state name
      */
     findAnimatorState(stateName: string, layerIndex?: number): AnimatorState;
+    /**
+     * Get the layer by name.
+     * @param name - The layer's name.
+     */
+    findLayerByName(name: string): AnimatorControllerLayer;
+    /**
+     * Get the parameter by name.
+     * @param name - The name of the parameter
+     */
+    getParameter(name: string): AnimatorControllerParameter;
+    /**
+     * Set the value of the given parameter.
+     * @param name - The name of the parameter
+     */
+    setParameter(name: string, value: AnimatorControllerParameterValue): void;
     private _getAnimatorStateInfo;
     private _getAnimatorStateData;
     private _saveAnimatorStateData;
@@ -77,6 +104,8 @@ export declare class Animator extends Component {
     private _checkTransition;
     private _checkSubTransition;
     private _checkBackwardsSubTransition;
+    _applyTransition(transition: AnimatorStateTransition, layerIndex: number): void;
+    private _checkConditions;
     private _crossFadeByTransition;
     private _fireAnimationEvents;
     private _fireSubAnimationEvents;
@@ -84,6 +113,6 @@ export declare class Animator extends Component {
     private _callAnimatorScriptOnEnter;
     private _callAnimatorScriptOnUpdate;
     private _callAnimatorScriptOnExit;
-    private _checkAutoPlay;
+    private _checkEntryState;
     private _checkRevertOwner;
 }

package/types/animation/AnimatorCondition.d.ts

@@ -0,0 +1,13 @@
+import { AnimatorControllerParameterValue } from "./AnimatorControllerParameter";
+import { AnimatorConditionMode } from "./enums/AnimatorConditionMode";
+/**
+ * Condition that is used to determine if a transition must be taken.
+ */
+export declare class AnimatorCondition {
+    /** The mode of the condition. */
+    mode: AnimatorConditionMode;
+    /** The name of the parameter used in the condition. */
+    parameter: string;
+    /** The AnimatorParameter's threshold value for the condition to be true. */
+    threshold: AnimatorControllerParameterValue;
+}

package/types/animation/AnimatorController.d.ts

@@ -1,15 +1,34 @@
+import { AnimatorControllerParameter, AnimatorControllerParameterValue } from "./AnimatorControllerParameter";
 import { AnimatorControllerLayer } from "./AnimatorControllerLayer";
 /**
  * Store the data for Animator playback.
  */
 export declare class AnimatorController {
     private _updateFlagManager;
-    private _layers;
-    private _layersMap;
     /**
      * The layers in the controller.
      */
     get layers(): Readonly<AnimatorControllerLayer[]>;
+    /**
+     * The parameters in the controller.
+     */
+    get parameters(): Readonly<AnimatorControllerParameter[]>;
+    /**
+     * Add a parameter to the controller.
+     * @param name - The name of the parameter
+     * @param defaultValue - The defaultValue of the parameter
+     */
+    addParameter(name: string, defaultValue?: AnimatorControllerParameterValue): AnimatorControllerParameter;
+    /**
+     * Add a parameter to the controller.
+     * @param parameter - The parameter
+     */
+    addParameter(parameter: AnimatorControllerParameter): AnimatorControllerParameter;
+    /**
+     * Remove a parameter from the controller.
+     * @param parameter - The parameter
+     */
+    removeParameter(parameter: AnimatorControllerParameter): void;
     /**
      * Get the layer by name.
      * @param name - The layer's name.