@galacean/engine-core 0.0.0-experimental-renderSort.3 → 0.0.0-experimental-shaderlab.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galacean/engine-core",
-  "version": "0.0.0-experimental-renderSort.3",
+  "version": "0.0.0-experimental-shaderlab.2",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
@@ -15,10 +15,10 @@
     "types/**/*"
   ],
   "dependencies": {
-    "@galacean/engine-math": "0.0.0-experimental-renderSort.3"
+    "@galacean/engine-math": "0.0.0-experimental-shaderlab.2"
   },
   "devDependencies": {
-    "@galacean/engine-design": "0.0.0-experimental-renderSort.3"
+    "@galacean/engine-design": "0.0.0-experimental-shaderlab.2"
   },
   "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/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/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/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/AnimatorControllerLayer.d.ts

@@ -1,5 +1,6 @@
 import { AnimatorStateMachine } from "./AnimatorStateMachine";
 import { AnimatorLayerBlendingMode } from "./enums/AnimatorLayerBlendingMode";
+import { AnimatorLayerMask } from "./AnimatorLayerMask";
 /**
  * The Animation Layer contains a state machine that controls animations of a model or part of it.
  */
@@ -11,6 +12,8 @@ export declare class AnimatorControllerLayer {
     blendingMode: AnimatorLayerBlendingMode;
     /** The state machine for the layer. */
     stateMachine: AnimatorStateMachine;
+    /** The AnimatorLayerMask is used to mask out certain entities from being animated by an AnimatorLayer. */
+    mask: AnimatorLayerMask;
     /**
      * @param name - The layer's name
      */

package/types/animation/AnimatorLayerMask.d.ts

@@ -0,0 +1,45 @@
+import { Entity } from "../Entity";
+import { LayerPathMask } from "./LayerPathMask";
+/**
+ * AnimatorLayerMask is used to mask out certain entities from being animated by an AnimatorLayer.
+ */
+export declare class AnimatorLayerMask {
+    /**
+     * Creates an AnimatorLayerMask instance by specifying an entity.
+     * This will automatically add path masks for the entity and all its children.
+     * @param entity - The root entity to create path masks for
+     */
+    static createByEntity(entity: Entity): AnimatorLayerMask;
+    private static _addPathMaskWithChildren;
+    private _pathMasks;
+    private _pathMaskMap;
+    /**
+     * The list of path masks.
+     */
+    get pathMasks(): Readonly<LayerPathMask[]>;
+    /**
+     * Adds a path mask to the AnimatorLayerMask, the root path is "".
+     * @param path - The path to add a mask for
+     * @returns The created or existing LayerPathMask
+     */
+    addPathMask(path: string): LayerPathMask;
+    /**
+     * Removes a path mask from the AnimatorLayerMask.
+     * @param path - The path of the mask to remove
+     */
+    removePathMask(path: string): void;
+    /**
+     * Get a path mask based on the given path.
+     * @param path - The path of the mask to get
+     * @returns The LayerPathMask for the given path
+     */
+    getPathMask(path: string): LayerPathMask;
+    /**
+     * Sets the active state of a path mask.
+     * If recursive is true, it also sets the active state of all child path masks.
+     * @param path - The path of the mask to modify
+     * @param active - The active state to set
+     * @param withChildren - Whether to apply the active state recursively to child paths
+     */
+    setPathMaskActive(path: string, active: boolean, withChildren?: boolean): void;
+}

package/types/animation/Keyframe.d.ts

@@ -17,4 +17,4 @@ export declare class Keyframe<V extends KeyframeValueType, T = V extends number
 /**
  * Type of Keyframe value.
  */
-export type KeyframeValueType = number | Vector2 | Vector3 | Vector4 | number[] | Float32Array | Quaternion | Color | Rect | boolean | ReferResource;
+export type KeyframeValueType = number | Vector2 | Vector3 | Vector4 | number[] | Float32Array | Quaternion | Color | Rect | string | boolean | ReferResource;

package/types/animation/LayerPathMask.d.ts

@@ -0,0 +1,16 @@
+/**
+ * LayerPathMask represents a mask for a specific entity in an animation layer.
+ * It is used to control the animation whether to be applied to the entity or not.
+ */
+export declare class LayerPathMask {
+    /**
+     * It identifies a particular entity in the hierarchy.
+     * Example: "arm/left/hand" could be a path to the left hand of a character.
+     */
+    path: string;
+    /**
+     * The active property is indicating whether the animation at this path is active or not.
+     * When true, the animation for this path is applied; when false, the animation for this path is ignored.
+     */
+    active: boolean;
+}

package/types/animation/animationCurve/AnimationStringCurve.d.ts

@@ -0,0 +1,7 @@
+import { AnimationCurve } from "./AnimationCurve";
+/**
+ * Store a collection of Keyframes that can be evaluated over time.
+ */
+export declare class AnimationStringCurve extends AnimationCurve<string> {
+    constructor();
+}

package/types/animation/animationCurve/index.d.ts

@@ -10,3 +10,4 @@ export { AnimationVector3Curve } from "./AnimationVector3Curve";
 export { AnimationVector4Curve } from "./AnimationVector4Curve";
 export { AnimationRefCurve } from "./AnimationRefCurve";
 export { AnimationRectCurve } from "./AnimationRectCurve";
+export { AnimationStringCurve } from "./AnimationStringCurve";

package/types/animation/index.d.ts

@@ -18,4 +18,5 @@ export { AnimatorCullingMode } from "./enums/AnimatorCullingMode";
 export { InterpolationType } from "./enums/InterpolationType";
 export { WrapMode } from "./enums/WrapMode";
 export * from "./Keyframe";
+export * from "./AnimatorLayerMask";
 export { StateMachineScript } from "./StateMachineScript";