@galacean/engine-core 0.9.0 → 1.0.0-beta.0

package/types/material/BaseMaterial.d.ts

@@ -1,21 +1,21 @@
 import { Engine } from "../Engine";
-import { Shader } from "../shader";
+import { Shader, ShaderProperty } from "../shader";
 import { ShaderMacro } from "../shader/ShaderMacro";
 import { BlendMode } from "./enums/BlendMode";
 import { RenderFace } from "./enums/RenderFace";
 import { Material } from "./Material";
 export declare class BaseMaterial extends Material {
-    protected static _baseColorProp: import("../shader").ShaderProperty;
-    protected static _baseTextureProp: import("../shader").ShaderProperty;
     protected static _baseTextureMacro: ShaderMacro;
-    protected static _tilingOffsetProp: import("../shader").ShaderProperty;
-    protected static _normalTextureProp: import("../shader").ShaderProperty;
-    protected static _normalIntensityProp: import("../shader").ShaderProperty;
     protected static _normalTextureMacro: ShaderMacro;
-    protected static _emissiveColorProp: import("../shader").ShaderProperty;
-    protected static _emissiveTextureProp: import("../shader").ShaderProperty;
     protected static _emissiveTextureMacro: ShaderMacro;
     protected static _transparentMacro: ShaderMacro;
+    protected static _baseColorProp: ShaderProperty;
+    protected static _baseTextureProp: ShaderProperty;
+    protected static _tilingOffsetProp: ShaderProperty;
+    protected static _normalTextureProp: ShaderProperty;
+    protected static _normalIntensityProp: ShaderProperty;
+    protected static _emissiveColorProp: ShaderProperty;
+    protected static _emissiveTextureProp: ShaderProperty;
     private static _alphaCutoffProp;
     private static _alphaCutoffMacro;
     private _renderFace;

package/types/material/Material.d.ts

@@ -1,5 +1,5 @@
 import { IClone } from "@galacean/engine-design";
-import { RefObject } from "../asset/RefObject";
+import { ReferResource } from "../asset/ReferResource";
 import { Engine } from "../Engine";
 import { Shader } from "../shader/Shader";
 import { ShaderData } from "../shader/ShaderData";
@@ -7,7 +7,7 @@ import { RenderState } from "../shader/state/RenderState";
 /**
  * Material.
  */
-export declare class Material extends RefObject implements IClone {
+export declare class Material extends ReferResource implements IClone {
     /** Name. */
     name: string;
     /** Shader data. */
@@ -43,9 +43,5 @@ export declare class Material extends RefObject implements IClone {
     /**
      * @override
      */
-    _addRefCount(value: number): void;
-    /**
-     * @override
-     */
-    protected _onDestroy(): void;
+    _addReferCount(value: number): void;
 }

package/types/mesh/BlendShape.d.ts

@@ -6,7 +6,6 @@ import { BlendShapeFrame } from "./BlendShapeFrame";
 export declare class BlendShape {
     /** Name of BlendShape. */
     name: string;
-    private _dataChangeManager;
     private _frames;
     /**
      * Frames of BlendShape.
@@ -36,4 +35,5 @@ export declare class BlendShape {
     clearFrames(): void;
     private _addFrame;
     private _updateUseNormalAndTangent;
+    private _frameDataChangeListener;
 }

package/types/mesh/BlendShapeFrame.d.ts

@@ -5,12 +5,28 @@ import { Vector3 } from "@galacean/engine-math";
 export declare class BlendShapeFrame {
     /** Weight of BlendShapeFrame. */
     readonly weight: number;
-    /** Delta positions for the frame being added. */
-    readonly deltaPositions: Readonly<Readonly<Vector3>[]>;
-    /** Delta normals for the frame being added. */
-    readonly deltaNormals: Readonly<Readonly<Vector3[]> | null>;
-    /** Delta tangents for the frame being added. */
-    readonly deltaTangents: Readonly<Readonly<Vector3[]> | null>;
+    private _dirty;
+    private _deltaPositions;
+    private _deltaNormals;
+    private _deltaTangents;
+    /**
+     * Delta positions for the frame being added.
+     * @remarks Need to re-assign after modification to ensure that the modification takes effect.
+     */
+    get deltaPositions(): Vector3[];
+    set deltaPositions(value: Vector3[]);
+    /**
+     * Delta normals for the frame being added.
+     * @remarks Need to re-assign after modification to ensure that the modification takes effect.
+     */
+    get deltaNormals(): Vector3[];
+    set deltaNormals(value: Vector3[]);
+    /**
+     * Delta tangents for the frame being added.
+     * @remarks Need to re-assign after modification to ensure that the modification takes effect.
+     */
+    get deltaTangents(): Vector3[];
+    set deltaTangents(value: Vector3[]);
     /**
      * Create a BlendShapeFrame.
      * @param weight - Weight of BlendShapeFrame
@@ -20,3 +36,9 @@ export declare class BlendShapeFrame {
      */
     constructor(weight: number, deltaPositions: Vector3[], deltaNormals?: Vector3[], deltaTangents?: Vector3[]);
 }
+export declare enum BlendShapeFrameDirty {
+    Position = 1,
+    Normal = 2,
+    Tangent = 4,
+    All = 7
+}

package/types/mesh/ModelMesh.d.ts

@@ -15,7 +15,7 @@ export declare class ModelMesh extends Mesh {
     private static _tempVec3;
     private static _tempVec4;
     private _vertexCount;
-    private _accessible;
+    private _readable;
     private _verticesFloat32;
     private _verticesUint8;
     private _indices;
@@ -42,9 +42,9 @@ export declare class ModelMesh extends Mesh {
     private _customVertexElements;
     private _vertexCountChanged;
     /**
-     * Whether to access data of the mesh.
+     * Whether to read data of the mesh.
      */
-    get accessible(): boolean;
+    get readable(): boolean;
     /**
      * Vertex count of current mesh.
      */
@@ -207,9 +207,9 @@ export declare class ModelMesh extends Mesh {
     getBlendShapeName(index: number): string;
     /**
      * Upload Mesh Data to GPU.
-     * @param noLongerAccessible - Whether to access data later. If true, you'll never access data anymore (free memory cache)
+     * @param noLongerReadable - Whether to read data later. If true, you'll never read data anymore (free memory cache)
      */
-    uploadData(noLongerAccessible: boolean): void;
+    uploadData(noLongerReadable: boolean): void;
     /**
      * Calculate mesh tangent.
      * @remark need to set positions(with or not with indices), normals, uv before calculation.

package/types/mesh/PrimitiveMesh.d.ts

@@ -63,8 +63,8 @@ export declare class PrimitiveMesh {
      * @param engine - Engine
      * @param radius - The radius of cap
      * @param height - The height of torso
-     * @param radialSegments - Cylinder radial segments
-     * @param heightSegments - Cylinder height segments
+     * @param radialSegments - Cone radial segments
+     * @param heightSegments - Cone height segments
      * @param noLongerAccessible - No longer access the vertices of the mesh after creation
      * @returns Cone model mesh
      */
@@ -80,6 +80,8 @@ export declare class PrimitiveMesh {
      * @returns Capsule model mesh
      */
     static createCapsule(engine: Engine, radius?: number, height?: number, radialSegments?: number, heightSegments?: number, noLongerAccessible?: boolean): ModelMesh;
+    static _setCylinderData(cylinderMesh: ModelMesh, radiusTop: number, radiusBottom: number, height: number, radialSegments: number, heightSegments: number, noLongerAccessible: boolean, isRestoreMode: boolean): void;
+    static _setCapsuleData(capsuleMesh: ModelMesh, radius: number, height: number, radialSegments: number, heightSegments: number, noLongerAccessible: boolean, isRestoreMode: boolean): void;
     private static _initialize;
     private static _generateIndices;
     private static _createCapsuleCap;

package/types/mesh/PrimitiveMeshRestorer.d.ts

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

package/types/mesh/SkinnedMeshRenderer.d.ts

@@ -7,7 +7,6 @@ import { Skin } from "./Skin";
  * SkinnedMeshRenderer.
  */
 export declare class SkinnedMeshRenderer extends MeshRenderer {
-    private static _tempMatrix;
     private static _jointCountProperty;
     private static _jointSamplerProperty;
     private static _jointMatrixProperty;

package/types/particle/ParticleRenderer.d.ts

@@ -1,6 +1,6 @@
-import { Vector3, Color } from "@galacean/engine-math";
-import { Texture } from "../texture";
+import { Color, Vector3 } from "@galacean/engine-math";
 import { MeshRenderer } from "../mesh/MeshRenderer";
+import { Texture } from "../texture";
 /**
  * Blend mode enums of the particle renderer's material.
  */

package/types/physics/Collider.d.ts

@@ -3,7 +3,7 @@ import { Component } from "../Component";
 import { ColliderShape } from "./shape/ColliderShape";
 /**
  * Base class for all colliders.
- * @decorator `@dependentComponents(Transform)`
+ * @decorator `@dependentComponents(Transform, DependentMode.CheckOnly)`
  */
 export declare class Collider extends Component {
     protected _updateFlag: BoolUpdateFlag;

package/types/physics/Collision.d.ts

@@ -0,0 +1,4 @@
+import { ColliderShape } from "./shape";
+export declare class Collision {
+    shape: ColliderShape;
+}

package/types/physics/PhysicsManager.d.ts

@@ -1,4 +1,3 @@
-import { IPhysics } from "@galacean/engine-design";
 import { Ray, Vector3 } from "@galacean/engine-math";
 import { Engine } from "../Engine";
 import { Layer } from "../Layer";
@@ -7,6 +6,7 @@ import { HitResult } from "./HitResult";
  * A physics manager is a collection of colliders and constraints which can interact.
  */
 export declare class PhysicsManager {
+    private static _collision;
     private _engine;
     private _restTime;
     private _colliders;
@@ -21,31 +21,12 @@ export declare class PhysicsManager {
     private _onTriggerStay;
     /** The fixed time step in seconds at which physics are performed. */
     fixedTimeStep: number;
-    /**
-     * The max allowed time step in seconds one frame.
-     *
-     * @remarks
-     * When the frame rate is low or stutter occurs, the maximum execution time of physics will not exceed this value.
-     * So physics will slow down a bit when performance hitch occurs.
-     */
-    maxAllowedTimeStep: number;
     /**
      * The gravity of physics scene.
      */
     get gravity(): Vector3;
     set gravity(value: Vector3);
-    /**
-     * @deprecated
-     * Please use `maxAllowedTimeStep` instead.
-     */
-    get maxSumTimeStep(): number;
-    set maxSumTimeStep(value: number);
     constructor(engine: Engine);
-    /**
-     * initialize PhysicsManager.
-     * @param physics - Physics Engine
-     */
-    initialize(physics: IPhysics): void;
     /**
      * Casts a ray through the Scene and returns the first hit.
      * @param ray - The ray

package/types/physics/joint/Joint.d.ts

@@ -1,11 +1,11 @@
 import { IJoint } from "@galacean/engine-design";
 import { Vector3 } from "@galacean/engine-math";
 import { Component } from "../../Component";
-import { Collider } from "../Collider";
 import { Entity } from "../../Entity";
+import { Collider } from "../Collider";
 /**
  * A base class providing common functionality for joints.
- * @decorator `@dependentComponents(Collider)`
+ * @decorator `@dependentComponents(Collider, DependentMode.CheckOnly)`
  */
 export declare class Joint extends Component {
     protected _connectedCollider: JointCollider;

package/types/renderingHardwareInterface/IPlatformBuffer.d.ts

@@ -0,0 +1,8 @@
+import { SetDataOptions } from "../graphic";
+export interface IPlatformBuffer {
+    bind(): void;
+    setData(byteLength: number, data: ArrayBuffer | ArrayBufferView, bufferByteOffset?: number, dataOffset?: number, dataLength?: number, options?: SetDataOptions): void;
+    getData(data: ArrayBufferView, bufferByteOffset?: number, dataOffset?: number, dataLength?: number): void;
+    resize(byteLength: number): void;
+    destroy(): void;
+}

package/types/renderingHardwareInterface/index.d.ts

@@ -1,4 +1,5 @@
 export type { IHardwareRenderer } from "./IHardwareRenderer";
+export type { IPlatformBuffer } from "./IPlatformBuffer";
 export type { IPlatformRenderTarget } from "./IPlatformRenderTarget";
 export type { IPlatformTexture } from "./IPlatformTexture";
 export type { IPlatformTexture2D } from "./IPlatformTexture2D";

package/types/shader/Shader.d.ts

@@ -2,15 +2,13 @@ import { Engine } from "../Engine";
 import { ShaderMacro } from "./ShaderMacro";
 import { ShaderPass } from "./ShaderPass";
 import { ShaderProperty } from "./ShaderProperty";
+import { SubShader } from "./SubShader";
 /**
  * Shader for rendering.
  */
 export declare class Shader {
+    readonly name: string;
     private static _shaderMap;
-    private static _propertyNameMap;
-    private static _macroMaskMap;
-    private static _macroCounter;
-    private static _macroMap;
     /**
      * Create a shader.
      * @param name - Name of the shader
@@ -26,18 +24,46 @@ export declare class Shader {
      * @returns Shader
      */
     static create(name: string, shaderPasses: ShaderPass[]): Shader;
+    /**
+     * Create a shader.
+     * @param name - Name of the shader
+     * @param subShaders - Sub shaders
+     * @returns Shader
+     */
+    static create(name: string, subShaders: SubShader[]): Shader;
     /**
      * Find a shader by name.
      * @param name - Name of the shader
      */
     static find(name: string): Shader;
+    private _subShaders;
+    /**
+     * Sub shaders of the shader.
+     */
+    get subShaders(): ReadonlyArray<SubShader>;
+    private constructor();
+    /**
+     * Compile shader variant by macro name list.
+     *
+     * @remarks
+     * Usually a shader contains some macros,any combination of macros is called shader variant.
+     *
+     * @param engine - Engine to which the shader variant belongs
+     * @param macros - Macro name list
+     * @returns Is the compiled shader variant valid
+     */
+    compileVariant(engine: Engine, macros: string[]): boolean;
     /**
+     * @deprecated Please use `ShaderMacro.getByName` instead
+     *
      * Get shader macro by name.
      * @param name - Name of the shader macro
      * @returns Shader macro
      */
     static getMacroByName(name: string): ShaderMacro;
     /**
+     * @deprecated Please use `ShaderMacro.getByName` instead
+     *
      * Get shader macro by name.
      * @param name - Name of the shader macro
      * @param value - Value of the shader macro
@@ -45,28 +71,11 @@ export declare class Shader {
      */
     static getMacroByName(name: string, value: string): ShaderMacro;
     /**
+     * @deprecated Please use `ShaderProperty.getByName` instead
+     *
      * Get shader property by name.
      * @param name - Name of the shader property
      * @returns Shader property
      */
     static getPropertyByName(name: string): ShaderProperty;
-    /** The name of shader. */
-    readonly name: string;
-    /**
-     *  Shader passes.
-     */
-    get passes(): ReadonlyArray<ShaderPass>;
-    private _passes;
-    private constructor();
-    /**
-     * Compile shader variant by macro name list.
-     *
-     * @remarks
-     * Usually a shader contains some macros,any combination of macros is called shader variant.
-     *
-     * @param engine - Engine to which the shader variant belongs
-     * @param macros - Macro name list
-     * @returns Is the compiled shader variant valid
-     */
-    compileVariant(engine: Engine, macros: string[]): boolean;
 }

package/types/shader/ShaderData.d.ts

@@ -1,13 +1,13 @@
 import { IClone } from "@galacean/engine-design";
 import { Color, Matrix, Vector2, Vector3, Vector4 } from "@galacean/engine-math";
-import { IRefObject } from "../asset/IRefObject";
+import { IReferable } from "../asset/IReferable";
 import { Texture } from "../texture/Texture";
 import { ShaderMacro } from "./ShaderMacro";
 import { ShaderProperty } from "./ShaderProperty";
 /**
  * Shader data collection,Correspondence includes shader properties data and macros data.
  */
-export declare class ShaderData implements IRefObject, IClone {
+export declare class ShaderData implements IReferable, IClone {
     private _macroMap;
     private _refCount;
     /**
@@ -18,7 +18,7 @@ export declare class ShaderData implements IRefObject, IClone {
     getFloat(propertyName: string): number;
     /**
      * Get float by shader property.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @returns Float
      */
     getFloat(property: ShaderProperty): number;
@@ -32,7 +32,7 @@ export declare class ShaderData implements IRefObject, IClone {
     /**
      * Set float by shader property.
      * @remarks Corresponding float shader property type.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @param value - Float
      */
     setFloat(property: ShaderProperty, value: number): void;
@@ -44,7 +44,7 @@ export declare class ShaderData implements IRefObject, IClone {
     getInt(propertyName: string): number;
     /**
      * Get int by shader property.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @returns Int
      */
     getInt(property: ShaderProperty): number;
@@ -58,7 +58,7 @@ export declare class ShaderData implements IRefObject, IClone {
     /**
      * Set int by shader property.
      * @remarks Correspondence includes int and bool shader property type.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @param value - Int
      */
     setInt(property: ShaderProperty, value: number): void;
@@ -70,7 +70,7 @@ export declare class ShaderData implements IRefObject, IClone {
     getFloatArray(propertyName: string): Float32Array;
     /**
      * Get float array by shader property.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @returns Float array
      */
     getFloatArray(property: ShaderProperty): Float32Array;
@@ -84,7 +84,7 @@ export declare class ShaderData implements IRefObject, IClone {
     /**
      * Set float array by shader property.
      * @remarks Correspondence includes float array、vec2 array、vec3 array、vec4 array and matrix array shader property type.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @param value - Float array
      */
     setFloatArray(property: ShaderProperty, value: Float32Array): void;
@@ -96,7 +96,7 @@ export declare class ShaderData implements IRefObject, IClone {
     getIntArray(propertyName: string): Int32Array;
     /**
      * Get int array by shader property.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @returns Int Array
      */
     getIntArray(property: ShaderProperty): Int32Array;
@@ -110,7 +110,7 @@ export declare class ShaderData implements IRefObject, IClone {
     /**
      * Set int array by shader property.
      * @remarks Correspondence includes bool array、int array、bvec2 array、bvec3 array、bvec4 array、ivec2 array、ivec3 array and ivec4 array shader property type.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @param value - Int Array
      */
     setIntArray(property: ShaderProperty, value: Int32Array): void;
@@ -122,7 +122,7 @@ export declare class ShaderData implements IRefObject, IClone {
     getVector2(propertyName: string): Vector2;
     /**
      * Get two-dimensional from shader property.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @returns Two-dimensional vector
      */
     getVector2(property: ShaderProperty): Vector2;
@@ -136,7 +136,7 @@ export declare class ShaderData implements IRefObject, IClone {
     /**
      * Set two-dimensional vector from shader property.
      * @remarks Correspondence includes vec2、ivec2 and bvec2 shader property type.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @param value - Two-dimensional vector
      */
     setVector2(property: ShaderProperty, value: Vector2): void;
@@ -148,7 +148,7 @@ export declare class ShaderData implements IRefObject, IClone {
     getVector3(propertyName: string): Vector3;
     /**
      * Get vector3 by shader property.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @returns Three-dimensional vector
      */
     getVector3(property: ShaderProperty): Vector3;
@@ -162,7 +162,7 @@ export declare class ShaderData implements IRefObject, IClone {
     /**
      * Set three dimensional vector by shader property.
      * @remarks Correspondence includes vec3、ivec3 and bvec3 shader property type.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @param value - Three-dimensional vector
      */
     setVector3(property: ShaderProperty, value: Vector3): void;
@@ -174,7 +174,7 @@ export declare class ShaderData implements IRefObject, IClone {
     getVector4(propertyName: string): Vector4;
     /**
      * Get vector4 by shader property.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @returns Four-dimensional vector
      */
     getVector4(property: ShaderProperty): Vector4;
@@ -188,7 +188,7 @@ export declare class ShaderData implements IRefObject, IClone {
     /**
      * Set four-dimensional vector by shader property.
      * @remarks Correspondence includes vec4、ivec4 and bvec4 shader property type.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @param value - Four-dimensional vector
      */
     setVector4(property: ShaderProperty, value: Vector4): void;
@@ -200,7 +200,7 @@ export declare class ShaderData implements IRefObject, IClone {
     getMatrix(propertyName: string): Matrix;
     /**
      * Get matrix by shader property.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @returns Matrix
      */
     getMatrix(property: ShaderProperty): Matrix;
@@ -214,7 +214,7 @@ export declare class ShaderData implements IRefObject, IClone {
     /**
      * Set matrix by shader property.
      * @remarks Correspondence includes matrix shader property type.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @param value - Matrix
      */
     setMatrix(property: ShaderProperty, value: Matrix): any;
@@ -226,7 +226,7 @@ export declare class ShaderData implements IRefObject, IClone {
     getColor(propertyName: string): Color;
     /**
      * Get color by shader property.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @returns Color
      */
     getColor(property: ShaderProperty): Color;
@@ -240,7 +240,7 @@ export declare class ShaderData implements IRefObject, IClone {
     /**
      * Set color by shader property.
      * @remarks Correspondence includes vec4 shader property type.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @param value - Color
      */
     setColor(property: ShaderProperty, value: Color): void;
@@ -252,7 +252,7 @@ export declare class ShaderData implements IRefObject, IClone {
     getTexture(propertyName: string): Texture;
     /**
      * Get texture by shader property.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @returns Texture
      */
     getTexture(property: ShaderProperty): Texture;
@@ -264,7 +264,7 @@ export declare class ShaderData implements IRefObject, IClone {
     setTexture(propertyName: string, value: Texture): void;
     /**
      * Set texture by shader property.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @param value - Texture
      */
     setTexture(property: ShaderProperty, value: Texture): void;
@@ -276,7 +276,7 @@ export declare class ShaderData implements IRefObject, IClone {
     getTextureArray(propertyName: string): Texture[];
     /**
      * Get texture array by shader property.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @returns Texture array
      */
     getTextureArray(property: ShaderProperty): Texture[];
@@ -288,7 +288,7 @@ export declare class ShaderData implements IRefObject, IClone {
     setTextureArray(propertyName: string, value: Texture[]): void;
     /**
      * Set texture array by shader property.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @param value - Texture array
      */
     setTextureArray(property: ShaderProperty, value: Texture[]): void;

package/types/shader/ShaderMacro.d.ts

@@ -3,8 +3,24 @@
  */
 export declare class ShaderMacro {
     private static _macroNameCounter;
+    private static _macroCounter;
+    private static _macroMap;
+    /**
+     * Get shader macro by name.
+     * @param name - Name of the shader macro
+     * @returns Shader macro
+     */
+    static getByName(name: string): ShaderMacro;
+    /**
+     * Get shader macro by name.
+     * @param name - Name of the shader macro
+     * @param value - Value of the shader macro
+     * @returns Shader macro
+     */
+    static getByName(name: string, value: string): ShaderMacro;
     /** Name. */
     readonly name: string;
     /** Value. */
     readonly value: string;
+    private constructor();
 }

package/types/shader/ShaderPart.d.ts

@@ -0,0 +1,41 @@
+import { ShaderTagKey } from "./ShaderTagKey";
+/**
+ * Base class for shader structure.
+ */
+export declare abstract class ShaderPart {
+    private _tagsMap;
+    /**
+     * Set tag by key name.
+     * @param keyName - Key name of the tag
+     * @param value - Tag value
+     */
+    setTag<T extends number | string | boolean>(keyName: string, value: T): void;
+    /**
+     * Set tag.
+     * @param key - Key of the tag
+     * @param value - Tag value
+     */
+    setTag<T extends number | string | boolean>(key: ShaderTagKey, value: T): void;
+    /**
+     * Delete a tag by key name.
+     * @param KeyName - Key name of the tag
+     */
+    deleteTag(KeyName: string): void;
+    /**
+     * Delete a tag by key.
+     * @param key - Key of the tag
+     */
+    deleteTag(key: ShaderTagKey): void;
+    /**
+     * Get tag by key name.
+     * @param keyName - Key name of the tag
+     * @returns Tag value
+     */
+    getTagValue<T extends number | string | boolean>(keyName: string): T;
+    /**
+     * Get tag value by key.
+     * @param key - Key of the tag
+     * @returns Tag value
+     */
+    getTagValue<T extends number | string | boolean>(key: ShaderTagKey): T;
+}