@zephyr3d/scene 0.5.0 → 0.6.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as _zephyr3d_device from '@zephyr3d/device';
-import { TextureCube, Texture2D, PrimitiveType, VertexLayout, VertexLayoutOptions, StructuredBuffer, VertexSemantic, VertexBufferInfo, VertexAttribFormat, VertexStepMode, IndexBuffer, RenderStateSet, AbstractDevice, FrameBuffer, PBGlobalScope, PBInsideFunctionScope, PBShaderExp, BindGroup, ProgramBuilder, GPUProgram, FaceMode, PBFunctionScope, TextureSampler, ShaderTypeFunc, Texture2DArray, TextureFormat, BaseTexture, TextureType, GPUDataBuffer, SamplerOptions, BindGroupLayout, DeviceBackend } from '@zephyr3d/device';
+import { TextureCube, Texture2D, PrimitiveType, AbstractDevice, VertexLayout, VertexLayoutOptions, StructuredBuffer, VertexSemantic, VertexBufferInfo, VertexAttribFormat, VertexStepMode, IndexBuffer, RenderStateSet, PBGlobalScope, PBInsideFunctionScope, PBShaderExp, BindGroup, FrameBuffer, BindGroupLayout, ProgramBuilder, GPUProgram, FaceMode, PBFunctionScope, TextureSampler, ShaderTypeFunc, Texture2DArray, TextureFormat, BaseTexture, TextureType, GPUDataBuffer, SamplerOptions, ColorState, DeviceBackend } from '@zephyr3d/device';
 import * as _zephyr3d_base from '@zephyr3d/base';
-import { Vector3, TypedArray, Ray, AABB, Matrix4x4, Plane, Frustum, Vector2, Vector4, ClipState, CubeFace, Interpolator, Quaternion, HttpRequest, ObservableVector3, ObservableQuaternion, InterpolationMode } from '@zephyr3d/base';
+import { Vector3, TypedArray, Ray, AABB, Matrix4x4, Plane, Frustum, Vector4, CubeFace, Vector2, ClipState, Interpolator, Quaternion, HttpRequest, ObservableVector3, ObservableQuaternion, InterpolationMode } from '@zephyr3d/base';
 import { DecoderModule } from 'draco3d';
 
 type DistributionType = 'lambertian' | 'ggx';
@@ -172,31 +172,12 @@ declare class BoundingBox extends AABB implements BoundingVolume {
     /** {@inheritDoc BoundingVolume.toAABB} */
     toAABB(): AABB;
 }
-/**
- * Bounding box tree
- * @public
- */
-declare class BoundingBoxTree extends AABBTree implements BoundingVolume {
-    /**
-     * Creates an empty bounding box tree
-     */
-    constructor();
-    /**
-     * Creates a bounding box tree from an AABB tree
-     * @param aabbtree - The AABB tree to be copied from
-     */
-    constructor(aabbtree: AABBTree);
-    /** {@inheritDoc BoundingVolume.clone} */
-    clone(): BoundingVolume;
-    /** {@inheritDoc BoundingVolume.transform} */
-    transform(matrix: Matrix4x4): BoundingVolume;
-    /** {@inheritDoc BoundingVolume.behindPlane} */
-    behindPlane(plane: Plane): boolean;
-    /** {@inheritDoc BoundingVolume.outsideFrustum} */
-    outsideFrustum(frustum: Frustum | Matrix4x4): boolean;
-    /** {@inheritDoc BoundingVolume.toAABB} */
-    toAABB(): AABB;
-}
+
+/** @internal */
+declare function createGradientNoiseTexture(device: AbstractDevice, size: number, uvscale: number, mono?: boolean, seed?: number): _zephyr3d_device.Texture2D<unknown>;
+
+/** @internal */
+declare function createRandomNoiseTexture(device: AbstractDevice, size: number): _zephyr3d_device.Texture2D<unknown>;
 
 /**
  * Primitive contains only the vertex and index data of a mesh
@@ -451,15 +432,17 @@ declare class BoxFrameShape extends Shape<BoxCreationOptions> {
  */
 interface CylinderCreationOptions extends ShapeCreationOptions {
     /** Top radius, default is 1.0 **/
-    topRadius?: number;
-    /** Bottom radius, default is 1.0 */
     bottomRadius?: number;
+    /** Bottom radius, default is 1.0 */
+    topRadius?: number;
     /** Height, default is 1.0 */
     height?: number;
     /** Height detail, default is 1 */
     heightDetail?: number;
-    /** Radial detail, default is 20*/
+    /** Radial detail, default is 20 */
     radialDetail?: number;
+    /** Anchor point, default is 0 */
+    anchor?: number;
 }
 /**
  * Box shape
@@ -586,7 +569,8 @@ declare class SphereShape extends Shape<SphereCreationOptions> {
  * Base class for any type of post effect
  * @public
  */
-declare abstract class AbstractPostEffect {
+declare abstract class AbstractPostEffect<ClassName extends string> {
+    static readonly className: string;
     protected _outputTexture: Texture2D;
     protected _quadVertexLayout: VertexLayout;
     protected _quadRenderStateSet: RenderStateSet;
@@ -597,6 +581,8 @@ declare abstract class AbstractPostEffect {
      * @param name - Name of the post effect
      */
     constructor();
+    /** Gets class name of this instance */
+    getClassName(): ClassName;
     /** Whether this post effect is enabled */
     get enabled(): boolean;
     set enabled(val: boolean);
@@ -612,12 +598,12 @@ declare abstract class AbstractPostEffect {
      * Checks whether this post effect requires the linear depth texture
      * @returns true if the linear depth texture is required.
      */
-    abstract requireLinearDepthTexture(): boolean;
+    abstract requireLinearDepthTexture(ctx: DrawContext): boolean;
     /**
      * Checks whether this post effect requires the scene depth buffer
      * @returns true if the scene depth buffer is required.
      */
-    abstract requireDepthAttachment(): boolean;
+    abstract requireDepthAttachment(ctx: DrawContext): boolean;
     /**
      * Apply the post effect
      * @param camera - Camera used the render the scene
@@ -648,9 +634,9 @@ declare abstract class AbstractPostEffect {
  * Grayscale post effect
  * @public
  */
-declare class Grayscale extends AbstractPostEffect {
+declare class Grayscale extends AbstractPostEffect<'Grayscale'> {
+    static readonly className: "Grayscale";
     private static _program;
-    private static _sampler;
     private _bindgroup;
     /**
      * Creates an instance of grayscale post effect
@@ -672,8 +658,8 @@ declare class Grayscale extends AbstractPostEffect {
  * The tonemap post effect
  * @public
  */
-declare class Tonemap extends AbstractPostEffect {
-    private static _nearestSampler;
+declare class Tonemap extends AbstractPostEffect<'Tonemap'> {
+    static readonly className: "Tonemap";
     private static _programTonemap;
     private _bindgroupTonemap;
     private _exposure;
@@ -702,8 +688,8 @@ declare class Tonemap extends AbstractPostEffect {
  * The bloom post effect
  * @public
  */
-declare class Bloom extends AbstractPostEffect {
-    private static _nearestSampler;
+declare class Bloom extends AbstractPostEffect<'Bloom'> {
+    static readonly className: "Bloom";
     private static _programDownsampleH;
     private static _programDownsampleV;
     private static _programUpsample;
@@ -765,8 +751,8 @@ declare class Bloom extends AbstractPostEffect {
  * The Scalable Ambient Obscurance (SAO) post effect
  * @public
  */
-declare class SAO extends AbstractPostEffect {
-    private static _nearestSampler;
+declare class SAO extends AbstractPostEffect<'SAO'> {
+    static readonly className: "SAO";
     private static _program;
     private static _programPacked;
     private static _renderState;
@@ -782,7 +768,6 @@ declare class SAO extends AbstractPostEffect {
     private _saoBlurDepthCutoff;
     private _blitterH;
     private _blitterV;
-    private _copyBlitter;
     private _supported;
     /**
      * Creates an instance of SAO post effect
@@ -829,9 +814,9 @@ declare class SAO extends AbstractPostEffect {
  * FXAA post effect
  * @public
  */
-declare class FXAA extends AbstractPostEffect {
+declare class FXAA extends AbstractPostEffect<'FXAA'> {
+    static readonly className: "FXAA";
     private static _program;
-    private static _sampler;
     private _bindgroup;
     private _invTexSize;
     /**
@@ -850,14 +835,80 @@ declare class FXAA extends AbstractPostEffect {
     private _prepare;
 }
 
+/**
+ * Abstract class for wave generators.
+ * @public
+ */
+declare abstract class WaveGenerator {
+    /**
+     * Setup uniforms for the shader program.
+     * @param scope - Global scope of the shader program.
+     */
+    abstract setupUniforms(scope: PBGlobalScope): void;
+    /**
+     * Calculate vertex position and normal.
+     * @param scope - Global scope of the shader program.
+     * @param inPos - Input position.
+     * @param outPos - Output position.
+     * @param outNormal - Output normal.
+     */
+    abstract calcVertexPositionAndNormal(scope: PBInsideFunctionScope, inPos: PBShaderExp, outPos: PBShaderExp, outNormal: PBShaderExp): void;
+    /**
+     *
+     * @param scope - Global scope of the shader program.
+     * @param xz - XZ position.
+     * @param vertexNormal - Vertex normal.
+     */
+    abstract calcFragmentNormal(scope: PBInsideFunctionScope, xz: PBShaderExp, vertexNormal: PBShaderExp): PBShaderExp;
+    /**
+     * Calculate fragment normal and foam.
+     * @param scope - Global scope of the shader program.
+     * @param xz - XZ position.
+     * @param vertexNormal - Vertex normal.
+     */
+    abstract calcFragmentNormalAndFoam(scope: PBInsideFunctionScope, xz: PBShaderExp, vertexNormal: PBShaderExp): PBShaderExp;
+    /**
+     * Apply water bind group.
+     * @param bindGroup - Bind group to apply.
+     */
+    abstract applyWaterBindGroup(bindGroup: BindGroup): void;
+    /**
+     *
+     * @param minX - Minimum X position of the clipmap tile.
+     * @param maxX - Maximum X position of the clipmap tile.
+     * @param minZ - Minimum Z position of the clipmap tile.
+     * @param maxZ - Maximum Z position of the clipmap tile.
+     * @param y - Y position of the water surface.
+     * @param outAABB - Output AABB.
+     */
+    abstract calcClipmapTileAABB(minX: number, maxX: number, minZ: number, maxZ: number, y: number, outAABB: AABB): any;
+    /**
+     * Update the wave generator.
+     * @param timeInSeconds - Time in seconds.
+     */
+    abstract update(timeInSeconds: number): void;
+    /**
+     * Get the shader hash of the wave generator.
+     * @param device - Rendering device.
+     */
+    abstract getHash(device: AbstractDevice): string;
+    /**
+     * Check if the wave generator is ok.
+     * @param device - Rendering device.
+     */
+    abstract isOk(device: AbstractDevice): boolean;
+    /**
+     * Dispose the wave generator.
+     */
+    abstract dispose(): void;
+}
+
 /**
  * The post water effect
  * @public
  */
-declare class PostWater extends AbstractPostEffect {
-    private _elevation;
-    private _region;
-    private _gridScale;
+declare class PostWater extends AbstractPostEffect<'PostWater'> {
+    static readonly className: "PostWater";
     private _reflectSize;
     private _copyBlitter;
     private _renderingReflections;
@@ -865,58 +916,38 @@ declare class PostWater extends AbstractPostEffect {
     private _displace;
     private _depthMulti;
     private _refractionStrength;
+    private _causticsParams;
     private _absorptionGrad;
     private _scatterGrad;
     private _rampTex;
-    private _foamWidth;
-    private _foamContrast;
-    private _waterAlignment;
-    private _waterWireframe;
-    private _waterWind;
-    private _waveLength0;
-    private _waveStrength0;
-    private _waveCroppiness0;
-    private _waveLength1;
-    private _waveStrength1;
-    private _waveCroppiness1;
-    private _waveLength2;
-    private _waveStrength2;
-    private _waveCroppiness2;
-    private _currentWaterMesh;
-    private _waterMeshes;
+    private _targetSize;
+    private _envMap;
+    private _ssr;
+    private _ssrParams;
+    private _waterImpls;
+    private _waterMesh;
     /**
      * Creates an instance of PostWater.
      * @param elevation - Elevation of the water
      */
-    constructor(elevation: number);
+    constructor(elevation: number, waveGenerator: WaveGenerator);
+    get waveGenerator(): WaveGenerator;
     get wireframe(): boolean;
     set wireframe(val: boolean);
-    get alignment(): number;
-    set alignment(val: number);
-    get wind(): Vector2;
-    set wind(val: Vector2);
-    get foamWidth(): number;
-    set foamWidth(val: number);
-    get foamContrast(): number;
-    set foamContrast(val: number);
-    get waveLength0(): number;
-    set waveLength0(val: number);
-    get waveStrength0(): number;
-    set waveStrength0(val: number);
-    get waveCroppiness0(): number;
-    set waveCroppiness0(val: number);
-    get waveLength1(): number;
-    set waveLength1(val: number);
-    get waveStrength1(): number;
-    set waveStrength1(val: number);
-    get waveCroppiness1(): number;
-    set waveCroppiness1(val: number);
-    get waveLength2(): number;
-    set waveLength2(val: number);
-    get waveStrength2(): number;
-    set waveStrength2(val: number);
-    get waveCroppiness2(): number;
-    set waveCroppiness2(val: number);
+    get ssrMaxDistance(): number;
+    set ssrMaxDistance(val: number);
+    get causticsSlopeMin(): number;
+    set causticsSlopeMin(val: number);
+    get causticsSlopeMax(): number;
+    set causticsSlopeMax(val: number);
+    get causticsFalloff(): number;
+    set causticsFalloff(val: number);
+    get causticsIntensity(): number;
+    set causticsIntensity(val: number);
+    get ssrIterations(): number;
+    set ssrIterations(val: number);
+    get ssrThickness(): number;
+    set ssrThickness(val: number);
     /** Refraction strength */
     get refractionStrength(): number;
     set refractionStrength(val: number);
@@ -932,12 +963,21 @@ declare class PostWater extends AbstractPostEffect {
     /** Water clipmap grid scale */
     get gridScale(): number;
     set gridScale(val: number);
+    /** Water animation speed factor */
+    get speed(): number;
+    set speed(val: number);
     /** The amount for increasing the water elevation to reduce leaking artifact */
     get antiReflectanceLeak(): number;
     set antiReflectanceLeak(val: number);
     /** Texture displace */
     get displace(): number;
     set displace(val: number);
+    /** Environment map */
+    get envMap(): TextureCube;
+    set envMap(tex: TextureCube);
+    /** SSR */
+    get ssr(): boolean;
+    set ssr(val: boolean);
     /** {@inheritDoc AbstractPostEffect.requireLinearDepthTexture} */
     requireLinearDepthTexture(): boolean;
     /** {@inheritDoc AbstractPostEffect.requireDepthAttachment} */
@@ -966,11 +1006,11 @@ interface CompositorContext {
  */
 declare class Compositor {
     /** @internal */
-    protected _postEffectsOpaque: AbstractPostEffect[];
+    private static _SSRPostEffect;
     /** @internal */
-    protected _postEffectsTransparency: AbstractPostEffect[];
+    protected _postEffectsOpaque: AbstractPostEffect<any>[];
     /** @internal */
-    private static _blitSampler;
+    protected _postEffectsTransparency: AbstractPostEffect<any>[];
     /** @internal */
     private static _blitProgram;
     /** @internal */
@@ -984,20 +1024,20 @@ declare class Compositor {
      */
     constructor();
     /** @internal */
-    requireLinearDepth(): boolean;
+    requireLinearDepth(ctx: DrawContext): boolean;
     /**
      * Adds a posteffect
      *
      * @param postEffect - The post effect to add
      * @param opaque - true if the post effect should be applied after the opaque pass and before the transparent pass, otherwise the post effect should be applied after the transparent pass
      */
-    appendPostEffect(postEffect: AbstractPostEffect): void;
+    appendPostEffect(postEffect: AbstractPostEffect<any>): void;
     /**
      * Removes a posteffect that was previously added
      *
      * @param postEffect - The posteffect to be remove.
      */
-    removePostEffect(postEffect: AbstractPostEffect): void;
+    removePostEffect(postEffect: AbstractPostEffect<any>): void;
     /**
      * Removes all post effects
      */
@@ -1005,7 +1045,7 @@ declare class Compositor {
     /**
      * Gets all post effects
      */
-    getPostEffects(): AbstractPostEffect[];
+    getPostEffects(): AbstractPostEffect<any>[];
     /** @internal */
     begin(ctx: DrawContext): void;
     /** @internal */
@@ -1199,137 +1239,479 @@ declare abstract class OIT {
 }
 
 /**
- * Type of sky
- *
- * @remarks
- * none - Sky will not be rendered
- * color - Sky will be rendered with a solid color.
- * skybox - Sky will be rendered as box using a preloaded cube texture.
- * scatter - Render dynamic sky with atmospheric scattering.
- *
- * @public
- */
-type SkyType = 'color' | 'skybox' | 'scatter' | 'scatter-nocloud' | 'none';
-/**
- * Type of fog
+ * Camera pick result
  * @public
  */
-type FogType = 'linear' | 'exp' | 'exp2' | 'scatter' | 'none';
+type PickResult = {
+    drawable: Drawable;
+    target: PickTarget;
+};
 /**
- * The sky renderer
+ * The camera node class
  * @public
  */
-declare class SkyRenderer {
-    private _skyType;
-    private _skyColor;
-    private _skyboxTexture;
-    private _updateRadianceMaps;
-    private _radianceMapDirty;
-    private _scatterSkyboxFramebuffer;
-    private _scatterSkyboxTextureWidth;
-    private _aerialPerspectiveDensity;
-    private _radianceMap;
-    private _radianceMapWidth;
-    private _irradianceMap;
-    private _irradianceMapWidth;
-    private _fogType;
-    private _fogColor;
-    private _fogParams;
-    private _cloudy;
-    private _cloudIntensity;
-    private _wind;
-    private _nearestSampler;
-    private _programSky;
-    private _bindgroupSky;
-    private _programFog;
-    private _bindgroupFog;
-    private _programFogScatter;
-    private _bindgroupFogScatter;
-    private _vertexLayout;
-    private _primitiveSky;
-    private _skyWorldMatrix;
-    private _renderStatesSky;
-    private _renderStatesSkyNoDepthTest;
-    private _renderStatesFog;
-    private _renderStatesFogScatter;
-    private _drawGround;
-    private _lastSunDir;
-    /**
-     * Creates an instance of SkyRenderer
-     */
-    constructor();
+declare class Camera extends SceneNode {
     /** @internal */
-    getHash(ctx: DrawContext): string;
-    /** Which type of the sky should be rendered */
-    get skyType(): SkyType;
-    set skyType(val: SkyType);
-    /** Whether ground should be rendered */
-    get drawGround(): boolean;
-    set drawGround(val: boolean);
+    protected _projMatrix: Matrix4x4;
+    /** @internal */
+    protected _viewMatrix: Matrix4x4;
+    /** @internal */
+    protected _viewProjMatrix: Matrix4x4;
+    /** @internal */
+    protected _rotationMatrix: Matrix4x4;
+    /** @internal */
+    protected _invViewProjMatrix: Matrix4x4;
+    /** @internal */
+    protected _clipPlane: Plane;
+    /** @internal */
+    protected _controller: BaseCameraController;
+    /** @internal */
+    protected _frustum: Frustum;
+    /** @internal */
+    protected _frustumV: Frustum;
+    /** @internal */
+    protected _dirty: boolean;
+    /** @internal */
+    protected _sampleCount: number;
+    /** @internal */
+    protected _framebuffer: FrameBuffer;
+    /** @internal */
+    protected _viewport: number[];
+    /** @internal */
+    protected _scissor: number[];
+    /** @internal */
+    protected _clearColor: Vector4;
+    /** @internal */
+    protected _clipMask: number;
+    /** @internal */
+    protected _oit: OIT;
+    /** @internal */
+    protected _depthPrePass: boolean;
+    /** @internal */
+    protected _commandBufferReuse: boolean;
+    /** @internal */
+    protected _HiZ: boolean;
+    /** @internal */
+    protected _SSR: boolean;
+    /** @internal */
+    protected _ssrParams: Vector4;
+    /** @internal */
+    protected _ssrMaxRoughness: number;
+    /** @internal */
+    protected _ssrRoughnessFactor: number;
+    /** @internal */
+    protected _ssrStride: number;
+    /** @internal */
+    protected _ssrCalcThickness: boolean;
+    /** @internal */
+    protected _ssrBlurriness: number;
+    /** @internal */
+    protected _ssrBlurDepthCutoff: number;
+    /** @internal */
+    protected _ssrBlurKernelSize: number;
+    /** @internal */
+    protected _ssrBlurStdDev: number;
+    /** @internal */
+    protected _picking: boolean;
+    /** @internal */
+    protected _pickPosX: number;
+    /** @internal */
+    protected _pickPosY: number;
+    /** @internal */
+    protected _pickResultPromise: Promise<PickResult>;
+    /** @internal */
+    protected _pickResult: PickResult;
     /**
-     * Wether the IBL maps should be updated automatically.
-     *
-     * @remarks
-     * If use use the sky for image-based lighting, the value shoud be set to true. default is false
+     * Creates a new camera node
      *
+     * @param scene - The scene that the camera belongs to
+     * @param projectionMatrix - Projection matrix for this camera
      */
-    get autoUpdateIBLMaps(): boolean;
-    set autoUpdateIBLMaps(val: boolean);
+    constructor(scene: Scene, projectionMatrix?: Matrix4x4);
+    /** Clip plane in camera space */
+    get clipPlane(): Plane;
+    set clipPlane(plane: Plane);
     /**
-     * The solid sky color
+     * Gets whether Hi-Z acceleration is enabled.
+     * When enabled, it can significantly improve SSR performance with minimal quality impact.
      */
-    get skyColor(): Vector4;
-    set skyColor(val: Vector4);
-    /** Aerial perspective density */
-    get aerialPerspectiveDensity(): number;
-    set aerialPerspectiveDensity(val: number);
+    get HiZ(): boolean;
+    set HiZ(val: boolean);
     /**
-     * Light density of the sky.
-     *
-     * @remarks
-     * This value controls how much cloud should be rendered when the sky type is scatter.
-     * Typically, the value should be in the range of 0 to 1.
+     * Gets whether Screen Space Reflections (SSR) is enabled.
      */
-    get cloudy(): number;
-    set cloudy(val: number);
+    get SSR(): boolean;
+    set SSR(val: boolean);
     /**
-     * Intensity of the sky color
+     * Gets the maximum roughness value for screen space reflections.
+     * Controls the cutoff point where surfaces are considered too rough for SSR.
      */
-    get cloudIntensity(): number;
-    set cloudIntensity(val: number);
+    get ssrMaxRoughness(): number;
+    set ssrMaxRoughness(val: number);
     /**
-     * Wind velocity
-     *
-     * @remarks
-     * This value affects the movement of the cloud
+     * Gets the roughness factor for SSR calculations.
+     * Affects how surface roughness influences reflection clarity.
      */
-    get wind(): Vector2;
-    set wind(val: Vector2);
+    get ssrRoughnessFactor(): number;
+    set ssrRoughnessFactor(val: number);
     /**
-     * Radiance map of the sky.
+     * Gets the stride value for SSR ray marching.
+     * Controls the step size during ray marching. Larger values improve performance but may miss details.
      */
-    get radianceMap(): TextureCube;
+    get ssrStride(): number;
+    set ssrStride(val: number);
     /**
-     * Irradiance map of the sky.
+     * Gets the maximum distance for SSR ray marching.
+     * Defines how far rays will travel when searching for reflection intersections.
      */
-    get irradianceMap(): TextureCube;
+    get ssrMaxDistance(): number;
+    set ssrMaxDistance(val: number);
     /**
-     * Cube texture for skybox.
+     * Gets the number of iterations for SSR ray marching.
+     * Higher values provide more accurate reflections but impact performance.
      */
-    get skyboxTexture(): TextureCube;
-    set skyboxTexture(tex: TextureCube);
-    /** @internal */
-    get skyWorldMatrix(): Matrix4x4;
-    set skyWorldMatrix(val: Matrix4x4);
+    get ssrIterations(): number;
+    set ssrIterations(val: number);
+    /**
+     * Gets the thickness value for SSR calculations.
+     * Determines the thickness threshold for surfaces when calculating reflections.
+     */
+    get ssrThickness(): number;
+    set ssrThickness(val: number);
+    /**
+     * Gets whether SSR should calculate thickness automatically.
+     * When enabled, the system will dynamically compute surface thickness for reflections.
+     */
+    get ssrCalcThickness(): boolean;
+    set ssrCalcThickness(val: boolean);
+    /**
+     * Gets the blur scale factor for SSR.
+     * Controls the overall intensity of the blur effect applied to reflections.
+     */
+    get ssrBlurScale(): number;
+    set ssrBlurScale(val: number);
+    /**
+     * Gets the depth cutoff value for SSR blur.
+     * Determines at what depth difference the blur effect should be reduced or eliminated.
+     */
+    get ssrBlurDepthCutoff(): number;
+    set ssrBlurDepthCutoff(val: number);
+    /**
+     * Gets the kernel size for the SSR blur effect.
+     * Defines the size of the blur kernel. Larger values create softer, more spread-out blur.
+     */
+    get ssrBlurKernelSize(): number;
+    set ssrBlurKernelSize(val: number);
+    /**
+     * Gets the standard deviation for the SSR Gaussian blur.
+     * Controls the distribution of the blur effect. Higher values create more pronounced blur.
+     */
+    get ssrBlurStdDev(): number;
+    set ssrBlurStdDev(val: number);
     /** @internal */
-    get mappedFogType(): number;
-    /** Current fog type */
-    get fogType(): FogType;
-    set fogType(val: FogType);
-    /** Start distance of linear fog */
-    get fogStart(): number;
-    set fogStart(val: number);
-    /** End distance of linear fog */
+    get ssrParams(): Vector4;
+    /** Whether to perform a depth pass */
+    get depthPrePass(): boolean;
+    set depthPrePass(val: boolean);
+    /** Whether to allow command buffer reuse optimization */
+    get commandBufferReuse(): boolean;
+    set commandBufferReuse(val: boolean);
+    /** Whether GPU picking is enabled for this camera */
+    get enablePicking(): boolean;
+    set enablePicking(enable: boolean);
+    /** X coordinate for picking related to viewport  */
+    get pickPosX(): number;
+    set pickPosX(val: number);
+    /** Y coordinate for picking related to viewport  */
+    get pickPosY(): number;
+    set pickPosY(val: number);
+    /** Pick result */
+    get pickResult(): PickResult;
+    set pickResult(val: PickResult);
+    /** @internal */
+    get pickResultAsync(): Promise<PickResult>;
+    set pickResultAsync(val: Promise<PickResult>);
+    /**
+     * Sample count for MSAA
+     *
+     * @remarks
+     * If greater than one, force the scene to be rendered using multisampled framebuffer
+     */
+    get sampleCount(): number;
+    set sampleCount(val: number);
+    /** OIT */
+    get oit(): OIT;
+    set oit(val: OIT);
+    /** Clip plane mask */
+    get clipMask(): number;
+    set clipMask(val: number);
+    /** Framebuffer object into which the scene will be rendered */
+    get framebuffer(): FrameBuffer;
+    set framebuffer(fb: FrameBuffer);
+    /** Viewport used for rendering, if null, use full framebuffer size */
+    get viewport(): number[];
+    set viewport(rect: number[]);
+    /** Scissor rectangle used for rendering, if null, use viewport value */
+    get scissor(): number[];
+    set scissor(rect: number[]);
+    /** Color value used to clear color buffer before rendering, if null, color buffer will not be cleared */
+    get clearColor(): Vector4;
+    set clearColor(val: Vector4);
+    /**
+     * Handle input events
+     * @param ev - input event object
+     * @param type - event type, default to ev.type
+     * @returns Boolean value indicates whether the event was handled.
+     */
+    handleEvent(ev: Event, type?: string): boolean;
+    /**
+     * Constructs a ray based on the given screen coordinates.
+     *
+     * @param x - The x-component of the screen coordinates, relative to the top-left corner of the viewport.
+     * @param y - The y-component of the screen coordinates, relative to the top-left corner of the viewport.
+     * @returns The ray originating from the camera position and passing through the given screen coordinates.
+     */
+    constructRay(x: number, y: number): Ray;
+    /**
+     * Place the camera by specifying the camera position and the target point
+     * @param eye - The camera position
+     * @param target - The target point to look at
+     * @param up - The up vector
+     * @returns self
+     */
+    lookAt(eye: Vector3, target: Vector3, up: Vector3): this;
+    /**
+     * Place the camera to look at a given cube face at a given camera position
+     * @param face - The cube face to look at
+     * @param position - The camera position
+     * @returns self
+     */
+    lookAtCubeFace(face: CubeFace, position?: Vector3): this;
+    /**
+     * Setup a perspective projection matrix for the camera
+     * @param fovY - The vertical field of view in radians.
+     * @param aspect - The aspect ratio
+     * @param zNear - The near clip plane
+     * @param zFar - The far clip plane
+     * @returns self
+     */
+    setPerspective(fovY: number, aspect: number, zNear: number, zFar: number): this;
+    /**
+     * Setup a orthogonal projection matrix for the camera
+     * @param left - Left bound of the frustum
+     * @param right - Right bound of the frustum
+     * @param bottom - Bottom bound of the frustum
+     * @param top - Top bound of the frustum
+     * @param near - Near bound of the frustum.
+     * @param far - Far bound of the frustum.
+     * @returns self
+     */
+    setOrtho(left: number, right: number, bottom: number, top: number, near: number, far: number): this;
+    /**
+     * Setup a projection matrix for the camera
+     * @param matrix - The projection matrix
+     */
+    setProjectionMatrix(matrix: Matrix4x4): void;
+    /**
+     * Gets the projection matrix of the camera
+     * @returns The projection matrix
+     */
+    getProjectionMatrix(): Matrix4x4;
+    getRotationMatrix(): Matrix4x4;
+    /**
+     * View matrix of the camera
+     *
+     * @remarks
+     * Camera's view matrix will transform a point from the world space to the camera space
+     */
+    get viewMatrix(): Matrix4x4;
+    get viewProjectionMatrix(): Matrix4x4;
+    /**
+     * The inverse-view-projection matrix of the camera
+     *
+     * @remarks
+     * The inverse-view-projection matrix transforms a point from the clip space to the camera space
+     */
+    get invViewProjectionMatrix(): Matrix4x4;
+    /** Gets the frustum of the camera */
+    get frustum(): Frustum;
+    get frustumViewSpace(): Frustum;
+    /** The camera controller  */
+    get controller(): BaseCameraController;
+    set controller(controller: BaseCameraController);
+    /** {@inheritDoc SceneNode.isCamera} */
+    isCamera(): this is Camera;
+    /** Gets the near clip plane of the camera */
+    getNearPlane(): number;
+    /** Gets the far clip plane of the camera */
+    getFarPlane(): number;
+    /** Gets the vertical field of view of the camera */
+    getFOV(): number;
+    /** Gets the tangent of half of the vertical field of view */
+    getTanHalfFovy(): number;
+    /** Gets the aspect ratio */
+    getAspect(): number;
+    /**
+     * Renders a scene
+     * @param scene - The scene to be rendered
+     * @param compositor - Compositor instance that will be used to apply postprocess effects
+     */
+    render(scene: Scene, compositor?: Compositor): void;
+    /**
+     * Updates the controller state
+     */
+    updateController(): void;
+    /**
+     * Reset the controller
+     */
+    resetController(): void;
+    /** @internal */
+    private setController;
+    /** @internal */
+    protected _invalidate(projectMatrixChanged: boolean): void;
+    /** @internal */
+    protected _compute(): void;
+    /** @internal */
+    protected _computeProj(): void;
+    /** @internal */
+    protected _onTransformChanged(invalidateLocal: boolean): void;
+    /** {@inheritdoc SceneNode.dispose} */
+    dispose(): void;
+}
+
+/**
+ * Type of sky
+ *
+ * @remarks
+ * none - Sky will not be rendered
+ * color - Sky will be rendered with a solid color.
+ * skybox - Sky will be rendered as box using a preloaded cube texture.
+ * scatter - Render dynamic sky with atmospheric scattering.
+ *
+ * @public
+ */
+type SkyType = 'color' | 'skybox' | 'scatter' | 'scatter-nocloud' | 'none';
+/**
+ * Type of fog
+ * @public
+ */
+type FogType = 'linear' | 'exp' | 'exp2' | 'scatter' | 'none';
+/**
+ * The sky renderer
+ * @public
+ */
+declare class SkyRenderer {
+    private _skyType;
+    private _skyColor;
+    private _skyboxTexture;
+    private _updateRadianceMaps;
+    private _radianceMapDirty;
+    private _scatterSkyboxFramebuffer;
+    private _scatterSkyboxTextureWidth;
+    private _aerialPerspectiveDensity;
+    private _radianceMap;
+    private _radianceMapWidth;
+    private _irradianceMap;
+    private _irradianceMapWidth;
+    private _fogType;
+    private _fogColor;
+    private _fogParams;
+    private _cloudy;
+    private _cloudIntensity;
+    private _wind;
+    private _programSky;
+    private _bindgroupSky;
+    private _programFog;
+    private _bindgroupFog;
+    private _programFogScatter;
+    private _bindgroupFogScatter;
+    private _vertexLayout;
+    private _primitiveSky;
+    private _skyWorldMatrix;
+    private _renderStatesSky;
+    private _renderStatesSkyNoDepthTest;
+    private _renderStatesFog;
+    private _renderStatesFogScatter;
+    private _drawGround;
+    private _lastSunDir;
+    /**
+     * Creates an instance of SkyRenderer
+     */
+    constructor();
+    /** @internal */
+    getHash(ctx: DrawContext): string;
+    /** Which type of the sky should be rendered */
+    get skyType(): SkyType;
+    set skyType(val: SkyType);
+    /** Whether ground should be rendered */
+    get drawGround(): boolean;
+    set drawGround(val: boolean);
+    /** Baked sky texture */
+    get bakedSkyTexture(): TextureCube;
+    /**
+     * Wether the IBL maps should be updated automatically.
+     *
+     * @remarks
+     * If use use the sky for image-based lighting, the value shoud be set to true. default is false
+     *
+     */
+    get autoUpdateIBLMaps(): boolean;
+    set autoUpdateIBLMaps(val: boolean);
+    /**
+     * The solid sky color
+     */
+    get skyColor(): Vector4;
+    set skyColor(val: Vector4);
+    /** Aerial perspective density */
+    get aerialPerspectiveDensity(): number;
+    set aerialPerspectiveDensity(val: number);
+    /**
+     * Light density of the sky.
+     *
+     * @remarks
+     * This value controls how much cloud should be rendered when the sky type is scatter.
+     * Typically, the value should be in the range of 0 to 1.
+     */
+    get cloudy(): number;
+    set cloudy(val: number);
+    /**
+     * Intensity of the sky color
+     */
+    get cloudIntensity(): number;
+    set cloudIntensity(val: number);
+    /**
+     * Wind velocity
+     *
+     * @remarks
+     * This value affects the movement of the cloud
+     */
+    get wind(): Vector2;
+    set wind(val: Vector2);
+    /**
+     * Radiance map of the sky.
+     */
+    get radianceMap(): TextureCube;
+    /**
+     * Irradiance map of the sky.
+     */
+    get irradianceMap(): TextureCube;
+    /**
+     * Cube texture for skybox.
+     */
+    get skyboxTexture(): TextureCube;
+    set skyboxTexture(tex: TextureCube);
+    /** @internal */
+    get skyWorldMatrix(): Matrix4x4;
+    set skyWorldMatrix(val: Matrix4x4);
+    /** @internal */
+    get mappedFogType(): number;
+    /** Current fog type */
+    get fogType(): FogType;
+    set fogType(val: FogType);
+    /** Start distance of linear fog */
+    get fogStart(): number;
+    set fogStart(val: number);
+    /** End distance of linear fog */
     get fogEnd(): number;
     set fogEnd(val: number);
     /** Top distance of fog if fog type is not scatter */
@@ -1393,7 +1775,7 @@ declare class EnvLightWrapper {
     /** @internal */
     constructor();
     /** @internal */
-    getHash(ctx: DrawContext): string;
+    getHash(ctx?: DrawContext): string;
     /** @internal */
     get envLight(): EnvironmentLighting;
     /** The strength of environment lighting */
@@ -1756,6 +2138,8 @@ declare class ShaderHelper {
     /** @internal */
     private static readonly SKIN_MATRIX_NAME;
     /** @internal */
+    private static _drawableBindGroupLayouts;
+    /** @internal */
     private static _lightUniformShadow;
     /** @internal */
     private static _fogUniforms;
@@ -1769,6 +2153,7 @@ declare class ShaderHelper {
     static getMorphDataUniformName(): string;
     static getMorphInfoUniformName(): string;
     static getLightBufferUniformName(): string;
+    static getDrawableBindGroupLayout(skinning: boolean, morphing: boolean, instancing: boolean): BindGroupLayout;
     /**
      * Prepares the fragment shader which is going to be used in our material system
      *
@@ -1898,6 +2283,12 @@ declare class ShaderHelper {
      * @returns The camera position
      */
     static getCameraPosition(scope: PBInsideFunctionScope): PBShaderExp;
+    /**
+     * Gets the uniform variable of type float which holds the roughness factor
+     * @param scope - Current shader scope
+     * @returns The roughness factor
+     */
+    static getCameraRoughnessFactor(scope: PBInsideFunctionScope): PBShaderExp;
     /**
      * Discard the fragment if it was clipped by the clip plane
      * @param scope - Current shader scope
@@ -2398,7 +2789,7 @@ declare class MeshMaterial extends Material {
      *
      * @returns The final fragment color
      */
-    outputFragmentColor(scope: PBInsideFunctionScope, worldPos: PBShaderExp, color: PBShaderExp): void;
+    outputFragmentColor(scope: PBInsideFunctionScope, worldPos: PBShaderExp, color: PBShaderExp, ssrRoughness?: PBShaderExp, ssrNormal?: PBShaderExp): void;
 }
 
 /**
@@ -2538,7 +2929,7 @@ declare class LambertMaterial extends LambertMaterial_base {
  */
 type IMixinBlinnPhong = {
     shininess: number;
-    blinnPhongLight(scope: PBInsideFunctionScope, worldPos: PBShaderExp, normal: PBShaderExp, viewVec: PBShaderExp, albedo: PBShaderExp): PBShaderExp;
+    blinnPhongLight(scope: PBInsideFunctionScope, worldPos: PBShaderExp, normal: PBShaderExp, viewVec: PBShaderExp, albedo: PBShaderExp, outRoughness?: PBShaderExp): PBShaderExp;
 } & IMixinLight;
 /**
  * Blinn-phong lighting model mixin
@@ -2637,7 +3028,7 @@ type IMixinPBRCommon = {
     calculateEmissiveColor(scope: PBInsideFunctionScope): PBShaderExp;
     getF0(scope: PBInsideFunctionScope): PBShaderExp;
     directLighting(scope: PBInsideFunctionScope, lightDir: PBShaderExp, lightColor: PBShaderExp, normal: PBShaderExp, viewVec: PBShaderExp, commonData: PBShaderExp, outColor: PBShaderExp): any;
-    indirectLighting(scope: PBInsideFunctionScope, normal: PBShaderExp, viewVec: PBShaderExp, commonData: PBShaderExp, outColor: PBShaderExp): any;
+    indirectLighting(scope: PBInsideFunctionScope, normal: PBShaderExp, viewVec: PBShaderExp, commonData: PBShaderExp, outColor: PBShaderExp, outRoughness?: PBShaderExp): any;
 } & TextureMixinInstanceTypes<[
     'occlusion',
     'emissive',
@@ -2668,7 +3059,7 @@ type IMixinPBRMetallicRoughness = {
     metallic: number;
     roughness: number;
     specularFactor: Vector4;
-    PBRLight(scope: PBInsideFunctionScope, worldPos: PBShaderExp, normal: PBShaderExp, viewVec: PBShaderExp, albedo: PBShaderExp, TBN?: PBShaderExp): PBShaderExp;
+    PBRLight(scope: PBInsideFunctionScope, worldPos: PBShaderExp, normal: PBShaderExp, viewVec: PBShaderExp, albedo: PBShaderExp, TBN: PBShaderExp, outRoughness?: PBShaderExp): PBShaderExp;
     calculateCommonData(scope: PBInsideFunctionScope, albedo: PBShaderExp, normal: PBShaderExp, viewVec: PBShaderExp, TBN: PBShaderExp, data: PBShaderExp): void;
 } & IMixinPBRCommon & IMixinLight & TextureMixinInstanceTypes<['metallicRoughness', 'occlusion', 'specular', 'specularColor']>;
 /**
@@ -2831,7 +3222,7 @@ declare class PBRMetallicRoughnessMaterial extends PBRMetallicRoughnessMaterial_
 type IMixinPBRSpecularGlossiness = {
     specularFactor: Vector4;
     glossinessFactor: number;
-    PBRLight(scope: PBInsideFunctionScope, worldPos: PBShaderExp, normal: PBShaderExp, viewVec: PBShaderExp, albedo: PBShaderExp, TBN?: PBShaderExp): PBShaderExp;
+    PBRLight(scope: PBInsideFunctionScope, worldPos: PBShaderExp, normal: PBShaderExp, viewVec: PBShaderExp, albedo: PBShaderExp, TBN: PBShaderExp, outRoughness?: PBShaderExp): PBShaderExp;
     calculateCommonData(scope: PBInsideFunctionScope, albedo: PBShaderExp, viewVec: PBShaderExp, TBN: PBShaderExp, data: PBShaderExp): void;
 } & IMixinPBRCommon & IMixinLight & TextureMixinInstanceTypes<['specular']>;
 /**
@@ -2885,10 +3276,26 @@ declare function mixinLambert<T extends typeof MeshMaterial>(BaseCls: T): T & (n
 
 declare class RenderBundleWrapper {
     private _renderBundles;
+    private _disposed;
+    private static _drawableContainer;
+    private static _materialContainer;
+    /** @internal */
+    static addDrawable(drawable: Drawable, material: Material, wrapper: RenderBundleWrapper, hash: string): void;
+    /** @internal */
+    static drawableChanged(drawable: Drawable): void;
+    /** @internal */
+    static materialChanged(material: Material): void;
+    /** @internal */
+    static materialAttached(material: Material, drawable: Drawable): void;
+    /** @internal */
+    static materialDetached(material: Material, drawable: Drawable): void;
     constructor();
+    get disposed(): boolean;
     getRenderBundle(hash: string): unknown;
     beginRenderBundle(): void;
     endRenderBundle(hash: string): void;
+    invalidate(hash: string): void;
+    dispose(): void;
 }
 
 /** @internal */
@@ -2955,6 +3362,7 @@ interface RenderItemList {
     opaque: RenderItemListBundle;
     transmission: RenderItemListBundle;
     transparent: RenderItemListBundle;
+    transmission_trans: RenderItemListBundle;
 }
 /**
  * Render queue reference
@@ -3383,7 +3791,7 @@ declare class ShadowMapper {
     /** @internal */
     calcSplitDistances(nearPlane: number, farPlane: number, numCascades: number): number[];
     /** @internal */
-    protected calcDepthBiasParams(shadowMapCamera: Camera, shadowMapSize: number, depthBias: number, normalBias: number, depthScale: number, result: Vector4): void;
+    protected calcDepthBiasParams(camera: Camera, shadowMapSize: number, depthBias: number, normalBias: number, depthScale: number, result: Vector4): void;
     /** @internal */
     protected postRenderShadowMap(shadowMapParams: ShadowMapParams): void;
     /** @internal */
@@ -3572,7 +3980,7 @@ declare class DirectionalLight extends PunctualLight {
      */
     isDirectionLight(): this is DirectionalLight;
     /** @internal */
-    computeBoundingVolume(bv: BoundingVolume): BoundingVolume;
+    computeBoundingVolume(): BoundingVolume;
     /** @internal */
     computeUniforms(): void;
 }
@@ -3603,7 +4011,7 @@ declare class PointLight extends PunctualLight {
      */
     isPointLight(): this is PointLight;
     /** @internal */
-    computeBoundingVolume(bv: BoundingVolume): BoundingVolume;
+    computeBoundingVolume(): BoundingVolume;
     /** @internal */
     computeUniforms(): void;
 }
@@ -3645,7 +4053,7 @@ declare class SpotLight extends PunctualLight {
      */
     isSpotLight(): this is SpotLight;
     /** @internal */
-    computeBoundingVolume(bv: BoundingVolume): BoundingVolume;
+    computeBoundingVolume(): BoundingVolume;
     /** @internal */
     computeUniforms(): void;
 }
@@ -3682,8 +4090,6 @@ declare class Mesh extends Mesh_base implements BatchDrawable {
     /** @internal */
     protected _boneMatrices: Texture2D;
     /** @internal */
-    protected _invBindMatrix: Matrix4x4;
-    /** @internal */
     protected _morphData: Texture2D;
     /** @internal */
     protected _morphInfo: GPUDataBuffer;
@@ -3692,6 +4098,8 @@ declare class Mesh extends Mesh_base implements BatchDrawable {
     /** @internal */
     protected _batchable: boolean;
     /** @internal */
+    protected _pickTarget: PickTarget;
+    /** @internal */
     protected _boundingBoxNode: Mesh;
     /** @internal */
     protected _instanceColor: Vector4;
@@ -3719,7 +4127,8 @@ declare class Mesh extends Mesh_base implements BatchDrawable {
     /**
      * {@inheritDoc Drawable.getPickTarget }
      */
-    getPickTarget(): GraphNode;
+    getPickTarget(): PickTarget;
+    setPickTarget(node: SceneNode, label?: string): void;
     /** Wether the mesh node casts shadows */
     get castShadow(): boolean;
     set castShadow(b: boolean);
@@ -3735,7 +4144,7 @@ declare class Mesh extends Mesh_base implements BatchDrawable {
     /**
      * {@inheritDoc SceneNode.isMesh}
      */
-    isMesh(): boolean;
+    isMesh(): this is Mesh;
     /**
      * Sets the bounding box for animation
      * @param bbox - The bounding box for animation
@@ -3746,11 +4155,6 @@ declare class Mesh extends Mesh_base implements BatchDrawable {
      * @param matrices - The texture that contains the bone matrices
      */
     setBoneMatrices(matrices: Texture2D): void;
-    /**
-     * Sets the inverse bind matrix for skeletal animation
-     * @param matrix - The matrix to set
-     */
-    setInvBindMatrix(matrix: Matrix4x4): void;
     /**
      * Sets the texture that contains the morph target data
      * @param data - The texture that contains the morph target data
@@ -3799,16 +4203,12 @@ declare class Mesh extends Mesh_base implements BatchDrawable {
      * {@inheritDoc Drawable.getBoneMatrices}
      */
     getBoneMatrices(): Texture2D;
-    /**
-     * {@inheritDoc Drawable.getInvBindMatrix}
-     */
-    getInvBindMatrix(): Matrix4x4;
     /**
      * {@inheritDoc Drawable.getXForm}
      */
     getXForm(): XForm;
     /** @internal */
-    computeBoundingVolume(bv: BoundingVolume): BoundingVolume;
+    computeBoundingVolume(): BoundingVolume;
     /** @internal */
     private _onBoundingboxChange;
     /** @internal */
@@ -3827,6 +4227,7 @@ declare class BatchGroup extends GraphNode {
     private _renderQueueMap;
     private _bindGroupAllocator;
     private _changeTag;
+    private _staticBV;
     /**
      * Creates an instance of mesh node
      * @param scene - The scene to which the mesh node belongs
@@ -3839,10 +4240,21 @@ declare class BatchGroup extends GraphNode {
     /**
      * {@inheritDoc SceneNode.isBatchGroup}
      */
-    isBatchGroup(): boolean;
+    isBatchGroup(): this is BatchGroup;
+    /**
+     * Force the batch state to be rebuilt
+     */
+    invalidate(): void;
+    /** @internal */
+    protected _detached(): void;
+    /** @internal */
+    protected _attached(): void;
+    /** @internal */
+    computeBoundingVolume(): BoundingVolume;
     /** @internal */
-    computeBoundingVolume(bv: BoundingVolume): BoundingVolume;
-    getRenderQueue(cullVisitor: CullVisitor): RenderQueue;
+    setBoundingVolume(bv: BoundingVolume): void;
+    /** @internal */
+    cull(cullVisitor: CullVisitor): void;
 }
 
 /** @internal */
@@ -3871,13 +4283,12 @@ declare class TerrainPatch extends TerrainPatch_base implements Drawable {
     constructor(terrain: Terrain);
     initialize(quadtree: Quadtree, parent: TerrainPatch, rowIndex: number, colIndex: number, baseVertices: Float32Array, normals: Vector3[], heightScale: number, elevations: Float32Array): boolean;
     getInstanceColor(): Vector4;
-    getPickTarget(): GraphNode;
+    getPickTarget(): PickTarget;
     getMaterial(): MeshMaterial;
     draw(ctx: DrawContext): void;
     setupCamera(viewportH: number, tanHalfFovy: number, maxPixelError: number): void;
     getName(): string;
     getBoneMatrices(): Texture2D<unknown>;
-    getInvBindMatrix(): Matrix4x4;
     getMorphData(): Texture2D;
     getMorphInfo(): GPUDataBuffer;
     getSortDistance(camera: Camera): number;
@@ -3911,7 +4322,6 @@ declare class TerrainPatch extends TerrainPatch_base implements Drawable {
 /** @internal */
 interface HeightfieldBBoxTreeNode {
     bbox: BoundingBox;
-    h: number[];
     rc: {
         x: number;
         y: number;
@@ -3941,7 +4351,8 @@ declare class HeightfieldBBoxTree {
     computeNodeBoundingBox(node: HeightfieldBBoxTreeNode, bbox: BoundingBox, vertices: Vector4[]): void;
     createChildNode(node: HeightfieldBBoxTreeNode, x: number, y: number, w: number, h: number, vertices: Vector4[]): boolean;
     rayIntersect(ray: Ray): number | null;
-    rayIntersectR(ray: Ray, node: HeightfieldBBoxTreeNode): number | null;
+    rayIntersectLeaf(ray: Ray, node: HeightfieldBBoxTreeNode): number | null;
+    rayIntersectRecursive(ray: Ray): number | null;
 }
 /** @internal */
 declare class HeightField {
@@ -3977,15 +4388,15 @@ declare class HeightField {
  * Visior
  * @public
  */
-interface Visitor {
-    visit(target: unknown): unknown;
+interface Visitor<T> {
+    visit(target: T): unknown;
 }
 
 /**
  * Node visitor for culling
  * @public
  */
-declare class CullVisitor implements Visitor {
+declare class CullVisitor implements Visitor<SceneNode | OctreeNode> {
     /** @internal */
     private _primaryCamera;
     /** @internal */
@@ -4045,7 +4456,7 @@ declare class CullVisitor implements Visitor {
 }
 
 declare class GrassClusterBase {
-    protected _terrain: any;
+    protected _terrain: Terrain;
     constructor(terrain: Terrain);
     getXForm(): XForm<XForm<any>>;
 }
@@ -4060,9 +4471,8 @@ declare class GrassCluster extends GrassCluster_base implements Drawable {
     getName(): string;
     getMaterial(): MeshMaterial;
     getInstanceColor(): Vector4;
-    getPickTarget(): GraphNode;
+    getPickTarget(): PickTarget;
     getBoneMatrices(): Texture2D<unknown>;
-    getInvBindMatrix(): Matrix4x4;
     getMorphData(): Texture2D;
     getMorphInfo(): GPUDataBuffer;
     getSortDistance(camera: Camera): number;
@@ -4166,336 +4576,96 @@ declare class Terrain extends GraphNode {
     /** @internal */
     private _wireframe;
     /** @internal */
-    private _viewPoint;
-    /** @internal */
-    private _castShadow;
-    /** @internal */
-    private _instanceColor;
-    /**
-     * Creates an instance of Terrain
-     * @param scene - The scene to which the terrain belongs
-     */
-    constructor(scene: Scene);
-    /** @internal */
-    get quadtree(): Quadtree;
-    /**
-     * {@inheritDoc Drawable.getName}
-     */
-    getName(): string;
-    /**
-     * {@inheritDoc Drawable.getInstanceColor}
-     */
-    getInstanceColor(): Vector4;
-    /** Wether the mesh node casts shadows */
-    get castShadow(): boolean;
-    set castShadow(val: boolean);
-    /** The maximum pixel error for terrain LOD */
-    get maxPixelError(): number;
-    set maxPixelError(val: number);
-    /** Camera that will be used to compute LOD level of terrain patches */
-    get LODCamera(): Camera;
-    set LODCamera(camera: Camera);
-    /** Scaled terrain width */
-    get scaledWidth(): number;
-    /** Scaled terrain height */
-    get scaledHeight(): number;
-    /** Scale value of the height field */
-    get heightFieldScale(): Vector3;
-    /** @internal */
-    get patchSize(): number;
-    /** Width of the terrain */
-    get width(): number;
-    /** Height of the terrain */
-    get height(): number;
-    /** Material of the terrain */
-    get material(): TerrainMaterial;
-    /** Grass material */
-    get grassMaterial(): GrassMaterial;
-    /** Whether the terrain should be rendered in wireframe mode */
-    get wireframe(): boolean;
-    set wireframe(b: boolean);
-    /** Normal map of the terrain */
-    get normalMap(): Texture2D;
-    /**
-     * Creates the terrain
-     *
-     * @param sizeX - Terrain size in X axis
-     * @param sizeZ - Terrain size in Z axis
-     * @param elevations - Elevation data of the terrain
-     * @param scale - Scale of the terrain
-     * @param patchSize - Patch size of the terrain
-     * @returns true if succeeded
-     */
-    create(sizeX: number, sizeZ: number, elevations: Float32Array, scale: Vector3, patchSize: number, options?: TerrainMaterialOptions): boolean;
-    /**
-     * Create grass fields
-     * @param maxGrassPerCell - Maximum number of grasses in a cell (world space 1x1)
-     * @param density - The density map
-     */
-    createGrass(density: number[][], bladeWidth: number, bladeHeight: number, offset: number, grassTexture: Texture2D): void;
-    /** Get elevation at specified position in terrain coordinate space */
-    getElevation(x: number, z: number): number;
-    /** Get normal at specified position in terrain coordinate space */
-    getNormal(x: number, z: number, normal?: Vector3): Vector3;
-    /** Get intersection distance by a ray in terrain coordinate space */
-    rayIntersect(ray: Ray): number | null;
-    /**
-     * {@inheritDoc SceneNode.computeBoundingVolume}
-     * @override
-     */
-    computeBoundingVolume(bv: BoundingVolume): BoundingVolume;
-    /**
-     * Traverse quadtree node top down
-     * @param callback - the callback function
-     */
-    traverseQuadtree(callback: (node: QuadtreeNode) => void): void;
-    /** @internal */
-    cull(cullVisitor: CullVisitor): number;
-    /**
-     * {@inheritDoc SceneNode.isTerrain}
-     * @override
-     */
-    isTerrain(): this is Terrain;
-}
-
-/**
- * Camera pick result
- * @public
- */
-type PickResult = {
-    drawable: Drawable;
-    node: GraphNode;
-};
-/**
- * The camera node class
- * @public
- */
-declare class Camera extends SceneNode {
-    /** @internal */
-    protected _projMatrix: Matrix4x4;
-    /** @internal */
-    protected _viewMatrix: Matrix4x4;
-    /** @internal */
-    protected _viewProjMatrix: Matrix4x4;
-    /** @internal */
-    protected _rotationMatrix: Matrix4x4;
-    /** @internal */
-    protected _invViewProjMatrix: Matrix4x4;
-    /** @internal */
-    protected _clipPlane: Plane;
-    /** @internal */
-    protected _controller: BaseCameraController;
-    /** @internal */
-    protected _frustum: Frustum;
-    /** @internal */
-    protected _frustumV: Frustum;
-    /** @internal */
-    protected _dirty: boolean;
-    /** @internal */
-    protected _sampleCount: number;
-    /** @internal */
-    protected _framebuffer: FrameBuffer;
-    /** @internal */
-    protected _viewport: number[];
-    /** @internal */
-    protected _scissor: number[];
-    /** @internal */
-    protected _clearColor: Vector4;
-    /** @internal */
-    protected _clipMask: number;
-    /** @internal */
-    protected _oit: OIT;
-    /** @internal */
-    protected _depthPrePass: boolean;
-    /** @internal */
-    protected _commandBufferReuse: boolean;
-    /** @internal */
-    protected _picking: boolean;
-    /** @internal */
-    protected _pickPosX: number;
-    /** @internal */
-    protected _pickPosY: number;
-    /** @internal */
-    protected _pickResultPromise: Promise<PickResult>;
-    /** @internal */
-    protected _pickResult: PickResult;
-    /**
-     * Creates a new camera node
-     *
-     * @param scene - The scene that the camera belongs to
-     * @param projectionMatrix - Projection matrix for this camera
-     */
-    constructor(scene: Scene, projectionMatrix?: Matrix4x4);
-    /** Clip plane in camera space */
-    get clipPlane(): Plane;
-    set clipPlane(plane: Plane);
-    /** Whether to perform a depth pass */
-    get depthPrePass(): boolean;
-    set depthPrePass(val: boolean);
-    /** Whether to allow command buffer reuse optimization */
-    get commandBufferReuse(): boolean;
-    set commandBufferReuse(val: boolean);
-    /** Whether GPU picking is enabled for this camera */
-    get enablePicking(): boolean;
-    set enablePicking(enable: boolean);
-    /** X coordinate for picking related to viewport  */
-    get pickPosX(): number;
-    set pickPosX(val: number);
-    /** Y coordinate for picking related to viewport  */
-    get pickPosY(): number;
-    set pickPosY(val: number);
-    /** Pick result */
-    get pickResult(): PickResult;
-    set pickResult(val: PickResult);
+    private _viewPoint;
     /** @internal */
-    get pickResultAsync(): Promise<PickResult>;
-    set pickResultAsync(val: Promise<PickResult>);
-    /**
-     * Sample count for MSAA
-     *
-     * @remarks
-     * If greater than one, force the scene to be rendered using multisampled framebuffer
-     */
-    get sampleCount(): number;
-    set sampleCount(val: number);
-    /** OIT */
-    get oit(): OIT;
-    set oit(val: OIT);
-    /** Clip plane mask */
-    get clipMask(): number;
-    set clipMask(val: number);
-    /** Framebuffer object into which the scene will be rendered */
-    get framebuffer(): FrameBuffer;
-    set framebuffer(fb: FrameBuffer);
-    /** Viewport used for rendering, if null, use full framebuffer size */
-    get viewport(): number[];
-    set viewport(rect: number[]);
-    /** Scissor rectangle used for rendering, if null, use viewport value */
-    get scissor(): number[];
-    set scissor(rect: number[]);
-    /** Color value used to clear color buffer before rendering, if null, color buffer will not be cleared */
-    get clearColor(): Vector4;
-    set clearColor(val: Vector4);
-    /**
-     * Handle input events
-     * @param ev - input event object
-     * @param type - event type, default to ev.type
-     * @returns Boolean value indicates whether the event was handled.
-     */
-    handleEvent(ev: Event, type?: string): boolean;
-    /**
-     * Constructs a ray based on the given screen coordinates.
-     *
-     * @param x - The x-component of the screen coordinates, relative to the top-left corner of the viewport.
-     * @param y - The y-component of the screen coordinates, relative to the top-left corner of the viewport.
-     * @returns The ray originating from the camera position and passing through the given screen coordinates.
-     */
-    constructRay(x: number, y: number): Ray;
-    /**
-     * Place the camera by specifying the camera position and the target point
-     * @param eye - The camera position
-     * @param target - The target point to look at
-     * @param up - The up vector
-     * @returns self
-     */
-    lookAt(eye: Vector3, target: Vector3, up: Vector3): this;
-    /**
-     * Place the camera to look at a given cube face at a given camera position
-     * @param face - The cube face to look at
-     * @param position - The camera position
-     * @returns self
-     */
-    lookAtCubeFace(face: CubeFace, position?: Vector3): this;
-    /**
-     * Setup a perspective projection matrix for the camera
-     * @param fovY - The vertical field of view in radians.
-     * @param aspect - The aspect ratio
-     * @param zNear - The near clip plane
-     * @param zFar - The far clip plane
-     * @returns self
-     */
-    setPerspective(fovY: number, aspect: number, zNear: number, zFar: number): this;
+    private _castShadow;
+    /** @internal */
+    private _instanceColor;
     /**
-     * Setup a orthogonal projection matrix for the camera
-     * @param left - Left bound of the frustum
-     * @param right - Right bound of the frustum
-     * @param bottom - Bottom bound of the frustum
-     * @param top - Top bound of the frustum
-     * @param near - Near bound of the frustum.
-     * @param far - Far bound of the frustum.
-     * @returns self
+     * Creates an instance of Terrain
+     * @param scene - The scene to which the terrain belongs
      */
-    setOrtho(left: number, right: number, bottom: number, top: number, near: number, far: number): this;
+    constructor(scene: Scene);
+    /** @internal */
+    get quadtree(): Quadtree;
     /**
-     * Setup a projection matrix for the camera
-     * @param matrix - The projection matrix
+     * {@inheritDoc Drawable.getName}
      */
-    setProjectionMatrix(matrix: Matrix4x4): void;
+    getName(): string;
     /**
-     * Gets the projection matrix of the camera
-     * @returns The projection matrix
+     * {@inheritDoc Drawable.getInstanceColor}
      */
-    getProjectionMatrix(): Matrix4x4;
-    getRotationMatrix(): Matrix4x4;
+    getInstanceColor(): Vector4;
+    /** Wether the mesh node casts shadows */
+    get castShadow(): boolean;
+    set castShadow(val: boolean);
+    /** The maximum pixel error for terrain LOD */
+    get maxPixelError(): number;
+    set maxPixelError(val: number);
+    /** Camera that will be used to compute LOD level of terrain patches */
+    get LODCamera(): Camera;
+    set LODCamera(camera: Camera);
+    /** Scaled terrain width */
+    get scaledWidth(): number;
+    /** Scaled terrain height */
+    get scaledHeight(): number;
+    /** Scale value of the height field */
+    get heightFieldScale(): Vector3;
+    /** @internal */
+    get patchSize(): number;
+    /** Width of the terrain */
+    get width(): number;
+    /** Height of the terrain */
+    get height(): number;
+    /** Material of the terrain */
+    get material(): TerrainMaterial;
+    /** Grass material */
+    get grassMaterial(): GrassMaterial;
+    /** Whether the terrain should be rendered in wireframe mode */
+    get wireframe(): boolean;
+    set wireframe(b: boolean);
+    /** Normal map of the terrain */
+    get normalMap(): Texture2D;
     /**
-     * View matrix of the camera
+     * Creates the terrain
      *
-     * @remarks
-     * Camera's view matrix will transform a point from the world space to the camera space
+     * @param sizeX - Terrain size in X axis
+     * @param sizeZ - Terrain size in Z axis
+     * @param elevations - Elevation data of the terrain
+     * @param scale - Scale of the terrain
+     * @param patchSize - Patch size of the terrain
+     * @returns true if succeeded
      */
-    get viewMatrix(): Matrix4x4;
-    get viewProjectionMatrix(): Matrix4x4;
+    create(sizeX: number, sizeZ: number, elevations: Float32Array, scale: Vector3, patchSize: number, options?: TerrainMaterialOptions): boolean;
     /**
-     * The inverse-view-projection matrix of the camera
-     *
-     * @remarks
-     * The inverse-view-projection matrix transforms a point from the clip space to the camera space
+     * Create grass fields
+     * @param maxGrassPerCell - Maximum number of grasses in a cell (world space 1x1)
+     * @param density - The density map
      */
-    get invViewProjectionMatrix(): Matrix4x4;
-    /** Gets the frustum of the camera */
-    get frustum(): Frustum;
-    get frustumViewSpace(): Frustum;
-    /** The camera controller  */
-    get controller(): BaseCameraController;
-    set controller(controller: BaseCameraController);
-    /** {@inheritDoc SceneNode.isCamera} */
-    isCamera(): this is Camera;
-    /** Gets the near clip plane of the camera */
-    getNearPlane(): number;
-    /** Gets the far clip plane of the camera */
-    getFarPlane(): number;
-    /** Gets the vertical field of view of the camera */
-    getFOV(): number;
-    /** Gets the tangent of half of the vertical field of view */
-    getTanHalfFovy(): number;
-    /** Gets the aspect ratio */
-    getAspect(): number;
+    createGrass(density: number[][], bladeWidth: number, bladeHeight: number, offset: number, grassTexture: Texture2D): void;
+    /** Get elevation at specified position in terrain coordinate space */
+    getElevation(x: number, z: number): number;
+    /** Get normal at specified position in terrain coordinate space */
+    getNormal(x: number, z: number, normal?: Vector3): Vector3;
+    /** Get intersection distance by a ray in terrain coordinate space */
+    rayIntersect(ray: Ray): number | null;
     /**
-     * Renders a scene
-     * @param scene - The scene to be rendered
-     * @param compositor - Compositor instance that will be used to apply postprocess effects
+     * {@inheritDoc SceneNode.computeBoundingVolume}
+     * @override
      */
-    render(scene: Scene, compositor?: Compositor): void;
+    computeBoundingVolume(): BoundingVolume;
     /**
-     * Updates the controller state
+     * Traverse quadtree node top down
+     * @param callback - the callback function
      */
-    updateController(): void;
+    traverseQuadtree(callback: (node: QuadtreeNode) => void): void;
+    /** @internal */
+    cull(cullVisitor: CullVisitor): number;
     /**
-     * Reset the controller
+     * {@inheritDoc SceneNode.isTerrain}
+     * @override
      */
-    resetController(): void;
-    /** @internal */
-    private setController;
-    /** @internal */
-    protected _invalidate(projectMatrixChanged: boolean): void;
-    /** @internal */
-    protected _compute(): void;
-    /** @internal */
-    protected _computeProj(): void;
-    /** @internal */
-    protected _onTransformChanged(invalidateLocal: boolean): void;
-    /** {@inheritdoc SceneNode.dispose} */
-    dispose(): void;
+    isTerrain(): this is Terrain;
 }
 
 /**
@@ -4531,10 +4701,6 @@ declare class GraphNode extends SceneNode {
      * {@inheritDoc Drawable.getBoneMatrices}
      */
     getBoneMatrices(): Texture2D;
-    /**
-     * {@inheritDoc Drawable.getInvBindMatrix}
-     */
-    getInvBindMatrix(): Matrix4x4;
     /**
      * {@inheritDoc Drawable.getSortDistance}
      */
@@ -4682,7 +4848,7 @@ declare class OctreeNode {
      * Traverse this node by a visitor
      * @param v - The visitor
      */
-    traverse(v: Visitor): void;
+    traverse(v: Visitor<OctreeNode>): void;
 }
 /**
  * Octree node chunk
@@ -5178,7 +5344,6 @@ declare class AssetHierarchyNode extends NamedObject {
     private _mesh;
     private _skeleton;
     private _attachToSkeleton;
-    private _attachIndex;
     private _meshAttached;
     private _matrix;
     private _worldMatrix;
@@ -5226,9 +5391,7 @@ declare class AssetHierarchyNode extends NamedObject {
     /** Children of the node */
     get children(): AssetHierarchyNode[];
     /** The skeleton to which the node belongs if this is a joint node */
-    get skeletonAttached(): AssetSkeleton;
-    /** The joint index if this is a joint node */
-    get attachIndex(): number;
+    get skeletonAttached(): Set<AssetSkeleton>;
     /** @internal */
     computeTransforms(parentTransform: Matrix4x4): void;
     /**
@@ -5652,9 +5815,9 @@ declare class Skeleton {
      */
     get jointTexture(): Texture2D;
     /** @internal */
-    updateJointMatrices(jointTransforms?: Matrix4x4[]): void;
+    updateJointMatrices(jointTransforms?: Matrix4x4[], worldMatrix?: Matrix4x4): void;
     /** @internal */
-    computeBindPose(): void;
+    computeBindPose(model: SceneNode): void;
     /** @internal */
     computeJoints(): void;
     /** @internal */
@@ -5970,7 +6133,7 @@ declare class Scene extends Scene_base {
      * @returns The closest object hit by the ray
      */
     raycast(ray: Ray, length?: number): {
-        node: GraphNode;
+        target: PickTarget;
         dist: number;
         point: Vector3;
     };
@@ -5995,13 +6158,6 @@ declare class Scene extends Scene_base {
     updateNodePlacement(octree: Octree, list: Set<GraphNode>): void;
 }
 
-/**
- * Base interface for all scene node visitors
- * @public
- */
-interface SceneNodeVisitor {
-    visit(target: SceneNode): unknown;
-}
 /**
  * Scene node visible state
  * @public
@@ -6087,7 +6243,7 @@ declare class SceneNode extends XForm<SceneNode> {
      * @param v - The visitor that will travel the subtree of this node
      * @param inverse - true if traversing from bottom to top, otherwise top to bottom
      */
-    traverse(v: SceneNodeVisitor, inverse?: boolean): void;
+    traverse(v: Visitor<SceneNode>, inverse?: boolean): void;
     /**
      * Iterate self and all of the children
      *
@@ -6115,10 +6271,9 @@ declare class SceneNode extends XForm<SceneNode> {
     dispose(): void;
     /**
      * Computes the bounding volume of the node
-     * @param bv - The output bounding volume
      * @returns The output bounding volume
      */
-    computeBoundingVolume(bv: BoundingVolume): BoundingVolume;
+    computeBoundingVolume(): BoundingVolume;
     /**
      * Gets the bounding volume of the node
      * @returns The bounding volume of the node
@@ -6182,37 +6337,42 @@ declare const XForm_base: (new (...args: any[]) => {
                 noderemoved: SceneNode;
                 visiblechanged: SceneNode;
                 transformchanged: SceneNode;
+                bvchanged: SceneNode;
             }, any>;
             options: _zephyr3d_base.REventHandlerOptions;
             removed: boolean;
         }[];
     }>;
-    on<K extends "transformchanged" | "nodeattached" | "noderemoved" | "visiblechanged">(type: K, listener: _zephyr3d_base.EventListener<{
+    on<K extends "nodeattached" | "noderemoved" | "visiblechanged" | "transformchanged" | "bvchanged">(type: K, listener: _zephyr3d_base.EventListener<{
         nodeattached: SceneNode;
         noderemoved: SceneNode;
         visiblechanged: SceneNode;
         transformchanged: SceneNode;
+        bvchanged: SceneNode;
     }, K>, context?: unknown): void;
-    once<K_1 extends "transformchanged" | "nodeattached" | "noderemoved" | "visiblechanged">(type: K_1, listener: _zephyr3d_base.EventListener<{
+    once<K_1 extends "nodeattached" | "noderemoved" | "visiblechanged" | "transformchanged" | "bvchanged">(type: K_1, listener: _zephyr3d_base.EventListener<{
         nodeattached: SceneNode;
         noderemoved: SceneNode;
         visiblechanged: SceneNode;
         transformchanged: SceneNode;
+        bvchanged: SceneNode;
     }, K_1>, context?: unknown): void;
-    off<K_2 extends "transformchanged" | "nodeattached" | "noderemoved" | "visiblechanged">(type: K_2, listener: _zephyr3d_base.EventListener<{
+    off<K_2 extends "nodeattached" | "noderemoved" | "visiblechanged" | "transformchanged" | "bvchanged">(type: K_2, listener: _zephyr3d_base.EventListener<{
         nodeattached: SceneNode;
         noderemoved: SceneNode;
         visiblechanged: SceneNode;
         transformchanged: SceneNode;
+        bvchanged: SceneNode;
     }, K_2>): void;
-    dispatchEvent(evt: SceneNode, type?: "transformchanged" | "nodeattached" | "noderemoved" | "visiblechanged"): void;
-    _internalAddEventListener<K_3 extends "transformchanged" | "nodeattached" | "noderemoved" | "visiblechanged">(listenerMap: Partial<{
+    dispatchEvent(evt: SceneNode, type?: "nodeattached" | "noderemoved" | "visiblechanged" | "transformchanged" | "bvchanged"): void;
+    _internalAddEventListener<K_3 extends "nodeattached" | "noderemoved" | "visiblechanged" | "transformchanged" | "bvchanged">(listenerMap: Partial<{
         [type: string]: {
             handler: _zephyr3d_base.EventListener<{
                 nodeattached: SceneNode;
                 noderemoved: SceneNode;
                 visiblechanged: SceneNode;
                 transformchanged: SceneNode;
+                bvchanged: SceneNode;
             }, any>;
             options: _zephyr3d_base.REventHandlerOptions;
             removed: boolean;
@@ -6222,6 +6382,7 @@ declare const XForm_base: (new (...args: any[]) => {
         noderemoved: SceneNode;
         visiblechanged: SceneNode;
         transformchanged: SceneNode;
+        bvchanged: SceneNode;
     }, K_3>, options?: _zephyr3d_base.REventHandlerOptions): Partial<{
         [type: string]: {
             handler: _zephyr3d_base.EventListener<{
@@ -6229,18 +6390,20 @@ declare const XForm_base: (new (...args: any[]) => {
                 noderemoved: SceneNode;
                 visiblechanged: SceneNode;
                 transformchanged: SceneNode;
+                bvchanged: SceneNode;
             }, any>;
             options: _zephyr3d_base.REventHandlerOptions;
             removed: boolean;
         }[];
     }>;
-    _internalRemoveEventListener<K_4 extends "transformchanged" | "nodeattached" | "noderemoved" | "visiblechanged">(listenerMap: Partial<{
+    _internalRemoveEventListener<K_4 extends "nodeattached" | "noderemoved" | "visiblechanged" | "transformchanged" | "bvchanged">(listenerMap: Partial<{
         [type: string]: {
             handler: _zephyr3d_base.EventListener<{
                 nodeattached: SceneNode;
                 noderemoved: SceneNode;
                 visiblechanged: SceneNode;
                 transformchanged: SceneNode;
+                bvchanged: SceneNode;
             }, any>;
             options: _zephyr3d_base.REventHandlerOptions;
             removed: boolean;
@@ -6250,6 +6413,7 @@ declare const XForm_base: (new (...args: any[]) => {
         noderemoved: SceneNode;
         visiblechanged: SceneNode;
         transformchanged: SceneNode;
+        bvchanged: SceneNode;
     }, K_4>): void;
     _invokeLocalListeners(evt: SceneNode, type?: string): void;
 }) & ObjectConstructor;
@@ -6389,7 +6553,7 @@ declare class XForm<T extends XForm<T> = XForm<any>> extends XForm_base {
      */
     reparent(p?: T): this;
     /** @internal */
-    getTag(): number;
+    get transformTag(): number;
     /** @internal */
     private syncTRS;
     /** @internal */
@@ -6464,7 +6628,7 @@ declare abstract class Blitter {
      * @param srcLayer - The layer of the source texture
      * @returns The read texel
      */
-    readTexel(scope: PBInsideFunctionScope, type: BlitType, srcTex: PBShaderExp, uv: PBShaderExp, srcLayer: PBShaderExp, sampleType: 'float' | 'int' | 'uint'): PBShaderExp;
+    readTexel(scope: PBInsideFunctionScope, type: BlitType, srcTex: PBShaderExp, uv: PBShaderExp, srcLayer: PBShaderExp, sampleType: 'float' | 'int' | 'uint' | 'depth'): PBShaderExp;
     /**
      * Writes a texel to destination texture
      * @param scope - The shader scope
@@ -6494,7 +6658,7 @@ declare abstract class Blitter {
      * @param srcLayer - The layer of the source texture
      * @returns the destination texel
      */
-    abstract filter(scope: PBInsideFunctionScope, type: BlitType, srcTex: PBShaderExp, srcUV: PBShaderExp, srcLayer: PBShaderExp, sampeType: 'float' | 'int' | 'uint'): PBShaderExp;
+    abstract filter(scope: PBInsideFunctionScope, type: BlitType, srcTex: PBShaderExp, srcUV: PBShaderExp, srcLayer: PBShaderExp, sampeType: 'float' | 'int' | 'uint' | 'depth'): PBShaderExp;
     /**
      * Calculates the hash code
      * @returns the calculated hash code
@@ -6559,6 +6723,7 @@ declare abstract class Blitter {
      * @param sampler - Sampler for source texture
      */
     blit(source: TextureCube, dest: Texture2D | FrameBuffer, face: number, sampler?: TextureSampler): void;
+    blit(source: BaseTexture, dest: BaseTexture | FrameBuffer, layer?: number | TextureSampler, sampler?: TextureSampler): void;
 }
 
 /**
@@ -6924,6 +7089,14 @@ declare class GlobalBindGroupAllocator {
     getGlobalBindGroup(ctx: DrawContext): BindGroup;
 }
 
+/**
+ * Pick target
+ * @public
+ */
+type PickTarget = {
+    node: SceneNode;
+    label?: string;
+};
 /**
  * The context for drawing objects
  * @public
@@ -6941,6 +7114,10 @@ interface DrawContext {
     camera: Camera;
     /** OIT */
     oit: OIT;
+    /** hierarchical depth */
+    HiZ: boolean;
+    /** hierarchical depth buffer */
+    HiZTexture: Texture2D;
     /** The scene that is currently been drawing */
     scene: Scene;
     /** The render pass to which the current drawing task belongs */
@@ -6995,12 +7172,12 @@ interface DrawContext {
     sunLight?: DirectionalLight;
     /** clustered light index */
     clusteredLight?: ClusteredLight;
-    /** Whether skin animation is used */
-    skinAnimation?: boolean;
-    /** Whether morph animation is used */
-    morphAnimation?: boolean;
-    /** Whehter instance rendering is used */
-    instancing?: boolean;
+    /** Material varying flags */
+    materialFlags: number;
+    /** Force cull mode */
+    forceCullMode?: FaceMode;
+    /** Force color mask state */
+    forceColorState?: ColorState;
 }
 /**
  * Base interface for a drawble object
@@ -7016,11 +7193,9 @@ interface Drawable {
     /** Gets the instance color */
     getInstanceColor(): Vector4;
     /** If set, the pick target will be returned as the pick result  */
-    getPickTarget(): GraphNode;
+    getPickTarget(): PickTarget;
     /** Gets the texture that contains the bone matrices of the object */
     getBoneMatrices(): Texture2D;
-    /** Gets the inversed bind matrix for skeleton animation */
-    getInvBindMatrix(): Matrix4x4;
     /** Gets the object color used for GPU picking */
     getObjectColor(): Vector4;
     /** Gets the morph texture */
@@ -7101,10 +7276,16 @@ declare class LightPass extends RenderPass {
  * @public
  */
 declare class DepthPass extends RenderPass {
+    private _renderBackface;
+    private _encodeDepth;
     /**
      * Creates an instance of DepthRenderPass
      */
     constructor();
+    get renderBackface(): boolean;
+    set renderBackface(val: boolean);
+    get encodeDepth(): boolean;
+    set encodeDepth(val: boolean);
     /** @internal */
     protected _getGlobalBindGroupHash(ctx: DrawContext): string;
     /** @internal */
@@ -7116,6 +7297,8 @@ declare class DepthPass extends RenderPass {
  * @internal
  */
 declare class SceneRenderer {
+    /** @internal */
+    private static _defaultCompositor;
     /** @internal */
     private static _scenePass;
     /** @internal */
@@ -7125,6 +7308,10 @@ declare class SceneRenderer {
     /** @internal */
     private static _objectColorPass;
     /** @internal */
+    private static _frontDepthColorState;
+    /** @internal */
+    private static _backDepthColorState;
+    /** @internal */
     private static _clusters;
     /** lighting render pass */
     static get sceneRenderPass(): LightPass;
@@ -7146,7 +7333,7 @@ declare class SceneRenderer {
      */
     static renderScene(scene: Scene, camera: Camera, compositor?: Compositor): void;
     /** @internal */
-    protected static _renderSceneDepth(ctx: DrawContext, renderQueue: RenderQueue, depthFramebuffer: FrameBuffer): void;
+    protected static _renderSceneDepth(ctx: DrawContext, renderQueue: RenderQueue, depthFramebuffer: FrameBuffer, renderBackfaceDepth?: boolean): void;
     /** @internal */
     protected static _renderScene(ctx: DrawContext): void;
     /** @internal */
@@ -7164,9 +7351,9 @@ type ClipmapDrawContext = {
     camera: Camera;
     position: Vector3;
     gridScale: number;
-    minWorldPos: Vector2;
-    maxWorldPos: Vector2;
-    AABBExtents?: Vector2;
+    minMaxWorldPos: Vector4;
+    userData: unknown;
+    calcAABB(userData: unknown, minX: number, maxX: number, minZ: number, maxZ: number, outAABB: AABB): any;
     drawPrimitive(prim: Primitive, modelMatrix: Matrix4x4, offset: Vector2, scale: number, gridScale: number): any;
 };
 /** @internal */
@@ -7229,7 +7416,8 @@ declare abstract class EnvironmentLighting {
      * Get radiance for a fragment
      *
      * @param scope - The shader scope
-     * @param surfaceData - surface data of the fragment
+     * @param refl - Reflection vector
+     * @param roughness - Surface roughness
      *
      * @returns The radiance for the fragment
      */
@@ -7238,7 +7426,7 @@ declare abstract class EnvironmentLighting {
      * Get irradiance for a fragment
      *
      * @param scope - The shader scope
-     * @param surfaceData - surface data of the fragment
+     * @param normal - surface normal
      *
      * @returns The radiance for the fragment
      */
@@ -7494,143 +7682,68 @@ declare class EnvHemisphericAmbient extends EnvironmentLighting {
 }
 
 /** @internal */
-interface WaterShaderImpl {
-    setupUniforms(scope: PBGlobalScope): void;
-    shading(scope: PBInsideFunctionScope, worldPos: PBShaderExp, worldNormal: PBShaderExp, foamFactor: PBShaderExp): PBShaderExp;
-}
-/** @internal */
-declare function createProgramOcean(impl?: WaterShaderImpl): _zephyr3d_device.GPUProgram<unknown>;
+type WaterVertexFunc = (this: WaterShaderImpl, scope: PBInsideFunctionScope, pos: PBShaderExp, xz: PBShaderExp, waveGenerator: WaveGenerator) => void;
 /** @internal */
-declare function createProgramPostFFT2(limit?: 4 | 2): _zephyr3d_device.GPUProgram<unknown>;
+type WaterShadingFunc = (scope: PBInsideFunctionScope, worldPos: PBShaderExp, worldNormal: PBShaderExp, foamFactor: PBShaderExp, discardable: PBShaderExp, waveGenerator: WaveGenerator) => PBShaderExp;
 /** @internal */
-declare function createProgramHk(limit?: 4 | 2): _zephyr3d_device.GPUProgram<unknown>;
+type WaterSetupUniformFunc = (this: WaterShaderImpl, scope: PBGlobalScope) => void;
 /** @internal */
-declare function createProgramH0(): _zephyr3d_device.GPUProgram<unknown>;
+declare class WaterShaderImpl {
+    private _vertexFunc;
+    private _shadingFunc;
+    private _setupUniformsFunc;
+    constructor(setupUniformsFunc: WaterSetupUniformFunc, vertexFunc: WaterVertexFunc, shadingFunc: WaterShadingFunc);
+    setupUniforms(scope: PBGlobalScope): void;
+    vertex(scope: PBInsideFunctionScope, pos: PBShaderExp, xz: PBShaderExp, waveGenerator: WaveGenerator): void;
+    getVertexNormal(scope: PBInsideFunctionScope, xz: PBShaderExp, useComputeShader: boolean): PBShaderExp;
+    shading(scope: PBInsideFunctionScope, worldPos: PBShaderExp, worldNormal: PBShaderExp, foamFactor: PBShaderExp, discardable: PBShaderExp, waveGenerator: WaveGenerator): PBShaderExp;
+}
 /** @internal */
-declare function createProgramFFT2V(limit?: 4 | 2): _zephyr3d_device.GPUProgram<unknown>;
+declare function createProgramOcean(waveGenerator: WaveGenerator, shadingImpl: WaterShaderImpl): _zephyr3d_device.GPUProgram<unknown>;
 /** @internal */
-declare function createProgramFFT2H(limit?: 4 | 2): _zephyr3d_device.GPUProgram<unknown>;
-
+declare function createProgramPostFFT2(useComputeShader: boolean, threadGroupSize: number, targetFormat?: TextureFormat, limit?: 4 | 2): _zephyr3d_device.GPUProgram<unknown>;
 /** @internal */
-interface OceanFieldCascade {
-    /**
-     * The size of simulated patch of field. (in meters)
-     */
-    size: number;
-    /**
-     * How "croppy" this pattern would be
-     */
-    croppiness: number;
-    /**
-     * Strength factor for this pattern
-     */
-    strength: number;
-    /**
-     * Min wave length. Kind of spectrum filter. (Waves less that this thresold are not involved in spectrum generation)
-     */
-    minWave: number;
-    /**
-     * Max wave length. Kind of spectrum filter.
-     */
-    maxWave: number;
-}
+declare function createProgramHk(useComputeShader?: boolean, threadGroupSize?: number, targetFormat?: TextureFormat, limit?: 4 | 2): _zephyr3d_device.GPUProgram<unknown>;
 /** @internal */
-interface OceanFieldBuildParams {
-    /**
-     * Size of generated texture. Must be power of 2
-     */
-    resolution: number;
-    /**
-     * Ocean field sub-pattern options.
-     * @see OceanFieldCascade
-     */
-    cascades: [OceanFieldCascade, OceanFieldCascade, OceanFieldCascade];
-    /**
-     * Wind vector. Module correspond to wind force.
-     */
-    wind: Vector2;
-    /**
-     * Parameter for waves motion. 0 means no wave motion
-     */
-    alignment: number;
-    /**
-     * Foam parameters
-     */
-    foamParams: Vector2;
-    /**
-     * Seed of random generator
-     */
-    randomSeed: number;
-}
+declare function createProgramH0(useComputeShader?: boolean, threadGroupSize?: number, targetFormat?: TextureFormat): _zephyr3d_device.GPUProgram<unknown>;
 /** @internal */
-declare const defaultBuildParams: OceanFieldBuildParams;
+declare function createProgramFFT2V(useComputeShader: boolean, threadGroupSize: number, targetFormat?: TextureFormat, limit?: 4 | 2): _zephyr3d_device.GPUProgram<unknown>;
+/** @internal */
+declare function createProgramFFT2H(useComputeShader: boolean, threadGroupSize: number, targetFormat?: TextureFormat, limit?: 4 | 2): _zephyr3d_device.GPUProgram<unknown>;
+
 /** @internal */
 declare class WaterMesh {
-    private static _globals;
-    private _h0BindGroup;
-    private _hkBindGroup;
-    private _hkBindGroup2;
-    private _hkBindGroup4;
-    private _fft2hBindGroup;
-    private _fft2vBindGroup;
-    private _fft2hBindGroup2Used;
-    private _fft2hBindGroup2Free;
-    private _fft2hBindGroup4Used;
-    private _fft2hBindGroup4Free;
-    private _fft2vBindGroup2Used;
-    private _fft2vBindGroup2Free;
-    private _fft2vBindGroup4Used;
-    private _fft2vBindGroup4Free;
-    private _postfft2BindGroup;
-    private _postfft2BindGroup2;
-    private _postfft2BindGroup4;
+    private _impl;
+    private _waveGenerator;
     private _waterBindGroup;
     private _usedClipmapBindGroups;
     private _freeClipmapBindGroups;
-    private _nearestRepeatSampler;
-    private _linearRepeatSampler;
-    private _updateRenderStates;
     private _waterRenderStates;
     private _wireframe;
     private _gridScale;
+    private _speed;
     private _level;
     private _tileSize;
-    private _regionMin;
-    private _regionMax;
-    private _sizes;
-    private _croppinesses;
-    private _params;
-    private _instanceData;
-    private _ifftTextures;
+    private _region;
     private _clipmap;
-    private _aabbExtents;
-    private _cascades;
-    private _paramsChanged;
-    private _resolutionChanged;
-    private _textureFormat;
-    private _h0TextureFormat;
-    private _dataTextureFormat;
-    private _renderMode;
     private _updateFrameStamp;
     private _waterProgram;
-    constructor(device: AbstractDevice, impl?: WaterShaderImpl);
-    get params(): OceanFieldBuildParams;
-    private paramsChanged;
-    get alignment(): number;
-    set alignment(val: number);
-    get wind(): Vector2;
-    set wind(val: Vector2);
-    get foamWidth(): number;
-    set foamWidth(val: number);
-    get foamContrast(): number;
-    set foamContrast(val: number);
-    getWaveLength(cascade: number): number;
-    setWaveLength(cascade: number, size: number): void;
-    getWaveStrength(cascade: number): number;
-    setWaveStrength(cascade: number, strength: number): void;
-    getWaveCroppiness(cascade: number): number;
-    setWaveCroppiness(cascade: number, croppiness: number): void;
-    get bindGroup(): BindGroup;
+    private _waveGeneratorHash;
+    constructor();
+    get speed(): number;
+    set speed(val: number);
+    /** @internal */
+    get shadingImpl(): WaterShaderImpl;
+    /** @internal */
+    set shadingImpl(val: WaterShaderImpl);
+    /** @internal */
+    get waveImpl(): WaveGenerator;
+    /** @internal */
+    set waveImpl(val: WaveGenerator);
+    /** @internal */
+    getWaterBindGroup(device: AbstractDevice): BindGroup;
+    /** @internal */
+    prepareForRender(device: AbstractDevice): boolean;
     get level(): number;
     set level(val: number);
     get wireframe(): boolean;
@@ -7639,33 +7752,10 @@ declare class WaterMesh {
     set gridScale(val: number);
     get tileSize(): number;
     set tileSize(val: number);
-    get regionMin(): Vector2;
-    set regionMin(val: Vector2);
-    get regionMax(): Vector2;
-    set regionMax(val: Vector2);
+    get region(): Vector4;
+    set region(val: Vector4);
     getClipmapBindGroup(device: AbstractDevice): BindGroup;
-    render(camera: Camera, flip?: boolean): void;
-    update(device: AbstractDevice, time: number): void;
-    disposeInstanceData(): void;
-    private generateSpectrum;
-    private generateSpectrumTwoPass;
-    private ifft2;
-    private getFFT2hBindGroup2;
-    private getFFT2hBindGroup4;
-    private getFFT2vBindGroup2;
-    private getFFT2vBindGroup4;
-    private ifft2TwoPass;
-    private postIfft2;
-    private postIfft2TwoPass;
-    private createNTextures;
-    private getInstanceData;
-    private static createQuad;
-    private getButterflyTexture;
-    private generateInitialSpectrum;
-    private getNoiseTexture;
-    private getNoise2d;
-    private reverseBits;
-    private createButterflyTexture;
+    render(device: AbstractDevice, camera: Camera, flip?: boolean): void;
 }
 
 /**
@@ -7828,6 +7918,297 @@ declare class ABufferOIT extends OIT {
     private static getCompositeProgram;
 }
 
+type OceanFieldCascade = {
+    /** The size of simulated patch of field. (in meters) */
+    size: number;
+    /** How "croppy" this pattern would be */
+    croppiness: number;
+    /** Strength factor for this pattern */
+    strength: number;
+    /** Min wave length. Kind of spectrum filter. (Waves less that this thresold are not involved in spectrum generation) */
+    minWave: number;
+    /** Max wave length. Kind of spectrum filter. */
+    maxWave: number;
+};
+type OceanFieldBuildParams = {
+    /** Size of generated texture. Must be power of 2 */
+    resolution: number;
+    /** Ocean field sub-pattern options. */
+    cascades: [OceanFieldCascade, OceanFieldCascade, OceanFieldCascade];
+    /** Wind vector. Module correspond to wind force. */
+    wind: Vector2;
+    /** Parameter for waves motion. 0 means no wave motion */
+    alignment: number;
+    /** Foam parameters */
+    foamParams: Vector2;
+    /** Seed of random generator */
+    randomSeed: number;
+};
+/**
+ * This class generates a 2D ocean field using the Fast Fourier Transform (FFT) algorithm.
+ * @public
+ */
+declare class FFTWaveGenerator extends WaveGenerator {
+    private static _globals;
+    private _useComputeShader;
+    private _h0BindGroup;
+    private _hkBindGroup;
+    private _hkBindGroup2;
+    private _hkBindGroup4;
+    private _fft2hBindGroup;
+    private _fft2vBindGroup;
+    private _fft2hBindGroup2Used;
+    private _fft2hBindGroup2Free;
+    private _fft2hBindGroup4Used;
+    private _fft2hBindGroup4Free;
+    private _fft2vBindGroup2Used;
+    private _fft2vBindGroup2Free;
+    private _fft2vBindGroup4Used;
+    private _fft2vBindGroup4Free;
+    private _postfft2BindGroup;
+    private _postfft2BindGroup2;
+    private _postfft2BindGroup4;
+    private _updateRenderStates;
+    private _sizes;
+    private _croppinesses;
+    private _params;
+    private _instanceData;
+    private _ifftTextures;
+    private _cascades;
+    private _paramsChanged;
+    private _resolutionChanged;
+    private _textureFormat;
+    private _h0TextureFormat;
+    private _dataTextureFormat;
+    private _renderMode;
+    /**
+     * Create a new instance of the FFTWaveGenerator class.
+     * @param params - Ocean field build parameters. If not provided, default parameters will be used.
+     */
+    constructor(params?: OceanFieldBuildParams);
+    private paramsChanged;
+    /** Gets the wave alighment */
+    get alignment(): number;
+    set alignment(val: number);
+    /** Gets the wind vector */
+    get wind(): Vector2;
+    set wind(val: Vector2);
+    /** Gets the foam width */
+    get foamWidth(): number;
+    set foamWidth(val: number);
+    /** Gets the foam contrast */
+    get foamContrast(): number;
+    set foamContrast(val: number);
+    /** Gets the wave length for the specified cascade */
+    getWaveLength(cascade: number): number;
+    /**
+     * Sets the wave length for the specified cascade
+     * @param cascade - The cascade index
+     * @param length - The new wave length for the specified cascade
+     */
+    setWaveLength(cascade: number, length: number): void;
+    /** Gets the wave strength for the specified cascade */
+    getWaveStrength(cascade: number): number;
+    /**
+     * Sets the wave strength for the specified cascade
+     * @param cascade - The cascade index
+     * @param strength - The new wave strength for the specified cascade
+     */
+    setWaveStrength(cascade: number, strength: number): void;
+    /** Gets the wave croppiness for the specified cascade */
+    getWaveCroppiness(cascade: number): number;
+    /**
+     * Sets the wave croppiness for the specified cascade
+     * @param cascade - The cascade index
+     * @param croppiness - The new wave croppiness for the specified cascade
+     */
+    setWaveCroppiness(cascade: number, croppiness: number): void;
+    /** @internal */
+    private static createQuad;
+    /** @internal */
+    private getButterflyTexture;
+    /** @internal */
+    private generateInitialSpectrum;
+    /** @internal */
+    private getNoiseTexture;
+    /** @internal */
+    private getNoise2d;
+    /** @internal */
+    private reverseBits;
+    /** @internal */
+    private createButterflyTexture;
+    /** @internal */
+    private getInstanceData;
+    /** @internal */
+    private createNTextures;
+    /** {@inheritDoc WaveGenerator.update} */
+    update(time: number): void;
+    /** @internal */
+    private disposeNTextures;
+    /** @internal */
+    private disposeInstanceData;
+    /** @internal */
+    private generateSpectrum;
+    /** @internal */
+    private generateSpectrumTwoPass;
+    /** @internal */
+    private ifft2;
+    /** @internal */
+    private getFFT2hBindGroup2;
+    /** @internal */
+    private getFFT2hBindGroup4;
+    /** @internal */
+    private getFFT2vBindGroup2;
+    /** @internal */
+    private getFFT2vBindGroup4;
+    /** @internal */
+    private ifft2TwoPass;
+    /** @internal */
+    private postIfft2;
+    /** @internal */
+    private postIfft2TwoPass;
+    /** {@inheritDoc WaveGenerator.setupUniforms} */
+    setupUniforms(scope: PBGlobalScope): void;
+    /** {@inheritDoc WaveGenerator.calcVertexPositionAndNormal} */
+    calcVertexPositionAndNormal(scope: PBInsideFunctionScope, inPos: PBShaderExp, outPos: PBShaderExp, outNormal: PBShaderExp): void;
+    /** {@inheritDoc WaveGenerator.calcFragmentNormal} */
+    calcFragmentNormal(scope: PBInsideFunctionScope, xz: PBShaderExp, vertexNormal: PBShaderExp): PBShaderExp;
+    /** {@inheritDoc WaveGenerator.calcFragmentNormalAndFoam} */
+    calcFragmentNormalAndFoam(scope: PBInsideFunctionScope, xz: PBShaderExp): PBShaderExp;
+    /** {@inheritDoc WaveGenerator.isOk} */
+    isOk(): boolean;
+    /** {@inheritDoc WaveGenerator.applyWaterBindGroup} */
+    applyWaterBindGroup(bindGroup: BindGroup): void;
+    /** {@inheritDoc WaveGenerator.dispose} */
+    dispose(): void;
+    /** {@inheritDoc WaveGenerator.calcClipmapTileAABB} */
+    calcClipmapTileAABB(minX: number, maxX: number, minZ: number, maxZ: number, y: number, outAABB: AABB): void;
+    /** {@inheritDoc WaveGenerator.getHash} */
+    getHash(): string;
+}
+
+/**
+ * Gerstner wave generator.
+ * @public
+ */
+declare class GerstnerWaveGenerator extends WaveGenerator {
+    private _currentTime;
+    private _waveParams;
+    private _numWaves;
+    /**
+     * Creates a new Gerstner wave generator.
+     */
+    constructor();
+    /** Gets the number of waves. */
+    get numWaves(): number;
+    set numWaves(val: number);
+    /**
+     * Sets the angle of the wave direction in radians.
+     * @param waveIndex - index of the wave to set.
+     * @param angle - angle of the wave direction in radians.
+     */
+    setWaveDirection(waveIndex: number, angle: number): void;
+    /**
+     * Gets the angle of the wave direction in radians.
+     * @param waveIndex - index of the wave to get.
+     * @returns Angle of the wave direction in radians.
+     */
+    getWaveDirection(waveIndex: number): number;
+    /**
+     * Sets the steepness of the wave.
+     * @param waveIndex - index of the wave to set.
+     * @param steepness - Steepness of the wave.
+     */
+    setWaveSteepness(waveIndex: number, steepness: number): void;
+    /**
+     * Gets the steepness of the wave.
+     * @param waveIndex - index of the wave to set.
+     * @returns Steepness of the wave.
+     */
+    getWaveSteepness(waveIndex: number): number;
+    /**
+     * Sets the amplitude of the wave.
+     * @param waveIndex - index of the wave to set.
+     * @param val - Amplitude of the wave.
+     */
+    setWaveAmplitude(waveIndex: number, val: number): void;
+    /**
+     * Gets the amplitude of the wave.
+     * @param waveIndex - index of the wave to set.
+     * @returns Amplitude of the wave.
+     */
+    getWaveAmplitude(waveIndex: number): number;
+    /**
+     * Sets the length of the wave.
+     * @param waveIndex - index of the wave to set.
+     * @param val - Length of the wave.
+     */
+    setWaveLength(waveIndex: number, val: number): void;
+    /**
+     * Gets the length of the wave.
+     * @param waveIndex - index of the wave to set.
+     * @returns Length of the wave.
+     */
+    getWaveLength(waveIndex: number): number;
+    /**
+     * Query if the wave is an omni-directional wave.
+     * @param waveIndex - index of the wave to set.
+     * @returns true if the wave is an omni-directional wave, false otherwise.
+     */
+    isOmniWave(waveIndex: number): boolean;
+    /**
+     * Sets whether the wave is an omni-directional wave.
+     * @param waveIndex - index of the wave to set.
+     * @param isOmni - true if the wave is an omni-directional wave, false otherwise.
+     */
+    setOmniWave(waveIndex: number, isOmni: boolean): void;
+    /**
+     * Gets the X coordinate of the wave origin if it is an omni-directional wave.
+     * @param waveIndex - index of the wave to set.
+     * @returns X coordinate of the wave origin if it is an omni-directional wave, 0 otherwise.
+     */
+    getOriginX(waveIndex: number): number;
+    /**
+     * Gets the Z coordinate of the wave origin if it is an omni-directional wave.
+     * @param waveIndex - index of the wave to set.
+     * @returns Z coordinate of the wave origin if it is an omni-directional wave, 0 otherwise.
+     */
+    getOriginZ(waveIndex: number): number;
+    /**
+     * Sets the X and Z coordinates of the wave origin if it is an omni-directional wave.
+     * @param waveIndex - index of the wave to set.
+     * @param x - X coordinate of the wave origin
+     * @param z - Z coordinate of the wave origin
+     */
+    setOrigin(waveIndex: number, x: number, z: number): void;
+    /** @internal */
+    private randomWave;
+    /** {@inheritDoc WaveGenerator.update} */
+    update(timeInSeconds: number): void;
+    /** {@inheritDoc WaveGenerator.calcClipmapTileAABB} */
+    calcClipmapTileAABB(minX: number, maxX: number, minZ: number, maxZ: number, y: number, outAABB: AABB): void;
+    /** {@inheritDoc WaveGenerator.calcFragmentNormal} */
+    calcFragmentNormal(scope: PBInsideFunctionScope, xz: PBShaderExp): PBShaderExp;
+    /** {@inheritDoc WaveGenerator.calcFragmentNormalAndFoam} */
+    calcFragmentNormalAndFoam(scope: PBInsideFunctionScope, xz: PBShaderExp): PBShaderExp;
+    /** {@inheritDoc WaveGenerator.setupUniforms} */
+    setupUniforms(scope: PBGlobalScope): void;
+    /** @internal */
+    private gerstnerWave;
+    /** @internal */
+    private calcNormalAndPos;
+    /** {@inheritDoc WaveGenerator.calcVertexPositionAndNormal} */
+    calcVertexPositionAndNormal(scope: PBInsideFunctionScope, inPos: PBShaderExp, outPos: PBShaderExp, outNormal: PBShaderExp): void;
+    /** {@inheritDoc WaveGenerator.applyWaterBindGroup} */
+    applyWaterBindGroup(bindGroup: BindGroup): void;
+    /** {@inheritDoc WaveGenerator.isOk} */
+    isOk(): boolean;
+    /** {@inheritDoc WaveGenerator.getHash} */
+    getHash(device: AbstractDevice): string;
+    /** {@inheritDoc WaveGenerator.dispose} */
+    dispose(): void;
+}
+
 /**
  * Translate animation track
  * @public
@@ -8030,17 +8411,49 @@ declare function gammaToLinear(scope: PBInsideFunctionScope, color: PBShaderExp)
  * @public
  */
 declare function linearToGamma(scope: PBInsideFunctionScope, color: PBShaderExp): any;
+/** @internal */
+declare function fetchNormalizedFloatForDevice(scope: PBInsideFunctionScope, tex: PBShaderExp, uv: PBShaderExp, level?: PBShaderExp | number): PBShaderExp;
 
 /**
- * Generate single float noise from a vec2
+ * Generate random float value from a vec2
+ *
+ * @param scope - Current shader scope
+ * @param p - random seed
+ * @returns random float value
+ *
+ * @public
+ */
+declare function hash(scope: PBInsideFunctionScope, p: PBShaderExp): any;
+/**
+ * Generate random float value from a vec2
  *
  * @param scope - Current shader scope
  * @param p - random seed
+ * @returns random float value
+ *
+ * @public
+ */
+declare function gradient(scope: PBInsideFunctionScope, p: PBShaderExp, t: PBShaderExp | number): any;
+/**
+ * Generate a float perlin noise value from a vec2
+ *
+ * @param scope - Current shader scope
+ * @param p - 2d vector
+ * @returns a float noise value
+ *
+ * @public
+ */
+declare function perlinNoise2D(scope: PBInsideFunctionScope, p: PBShaderExp): any;
+/**
+ * Generate a float perlin noise value from a vec3
+ *
+ * @param scope - Current shader scope
+ * @param p - 3d vector
  * @returns a float noise value
  *
  * @public
  */
-declare function noisef(scope: PBInsideFunctionScope, p: PBShaderExp): any;
+declare function perlinNoise3D(scope: PBInsideFunctionScope, p: PBShaderExp): any;
 /**
  * worley 3d noise
  *
@@ -8084,6 +8497,16 @@ declare function noise3D(scope: PBInsideFunctionScope, p: PBShaderExp): PBShader
  * @public
  */
 declare function smoothNoise3D(scope: PBInsideFunctionScope, p: PBShaderExp): PBShaderExp;
+/**
+ * Calculate interleaved gradient noise
+ *
+ * @param scope - current shader scope
+ * @param c - 2d position at where to calculate noise
+ * @returns noise value
+ *
+ * @public
+ */
+declare function interleavedGradientNoise(scope: PBInsideFunctionScope, c: PBShaderExp): PBShaderExp;
 
 /**
  * Forward render pass type
@@ -8174,6 +8597,16 @@ declare const MAX_MORPH_TARGETS = 256;
 declare const MORPH_WEIGHTS_VECTOR_COUNT: number;
 /** @internal */
 declare const MORPH_ATTRIBUTE_VECTOR_COUNT: number;
+/**
+ * Material varying flags
+ * @public
+ */
+declare const enum MaterialVaryingFlags {
+    MORPH_ANIMATION = 1,
+    SKIN_ANIMATION = 2,
+    INSTANCING = 4,
+    SSR_STORE_ROUGHNESS = 8
+}
 
 /**
  * Input handler type
@@ -8398,4 +8831,4 @@ declare class Application extends Application_base {
     log(text: string, mode?: LogMode): void;
 }
 
-export { AABBTree, ABufferOIT, AbstractPostEffect, AnimationClip, AnimationSet, AnimationTrack, AppOptions, AppResizeEvent, AppTickEvent, Application, AssetAnimationData, AssetAnimationTrack, AssetHierarchyNode, AssetManager, AssetMaterial, AssetMaterialClearcoat, AssetMaterialCommon, AssetMaterialIridescence, AssetMaterialSheen, AssetMaterialTransmission, AssetMeshData, AssetPBRMaterialCommon, AssetPBRMaterialMR, AssetPBRMaterialSG, AssetRotationTrack, AssetScaleTrack, AssetScene, AssetSkeletalAnimationTrack, AssetSkeleton, AssetSubMeshData, AssetTranslationTrack, AssetUnlitMaterial, BUILTIN_ASSET_TEST_CUBEMAP, BUILTIN_ASSET_TEXTURE_SHEEN_LUT, BaseCameraController, BaseLight, BatchDrawable, BatchGroup, BlendMode, BlinnMaterial, BlitType, Blitter, Bloom, BoundingBox, BoundingBoxTree, BoundingVolume, BoxCreationOptions, BoxFilterBlitter, BoxFrameShape, BoxShape, CachedBindGroup, Camera, Clipmap, ClipmapDrawContext, Compositor, CompositorContext, CopyBlitter, CullVisitor, CylinderCreationOptions, CylinderShape, DepthPass, DirectionalLight, DrawContext, Drawable, DrawableInstanceInfo, ESM, EnvConstantAmbient, EnvHemisphericAmbient, EnvIBL, EnvLightType, EnvLightWrapper, EnvShIBL, Environment, EnvironmentLighting, EulerRotationTrack, ExtractMixinReturnType, ExtractMixinType, FPSCameraController, FPSCameraControllerOptions, FXAA, FogType, GaussianBlurBlitter, GraphNode, GrassMaterial, Grayscale, HeightField, HeightfieldBBoxTree, HeightfieldBBoxTreeNode, IMixinAlbedoColor, IMixinBlinnPhong, IMixinFoliage, IMixinLambert, IMixinLight, IMixinPBRCommon, IMixinPBRMetallicRoughness, IMixinPBRSpecularGlossiness, IMixinVertexColor, InstanceBindGroupAllocator, InstanceData, InstanceUniformType, LIGHT_TYPE_DIRECTIONAL, LIGHT_TYPE_NONE, LIGHT_TYPE_POINT, LIGHT_TYPE_SPOT, LambertMaterial, LightPass, LogMode, Logger, MAX_CLUSTERED_LIGHTS, MAX_MORPH_ATTRIBUTES, MAX_MORPH_TARGETS, MORPH_ATTRIBUTE_VECTOR_COUNT, MORPH_TARGET_COLOR, MORPH_TARGET_NORMAL, MORPH_TARGET_POSITION, MORPH_TARGET_TANGENT, MORPH_TARGET_TEX0, MORPH_TARGET_TEX1, MORPH_TARGET_TEX2, MORPH_TARGET_TEX3, MORPH_WEIGHTS_VECTOR_COUNT, Material, MaterialTextureInfo, Mesh, MeshMaterial, ModelFetchOptions, ModelInfo, NamedObject, OIT, OceanFieldBuildParams, OceanFieldCascade, Octree, OctreeNode, OctreeNodeChunk, OctreePlacement, OrbitCameraController, OrbitCameraControllerOptions, OrthoCamera, PBRMetallicRoughnessMaterial, PBRSpecularGlossinessMaterial, PCFOPT, PCFPD, PerspectiveCamera, PickResult, PlaneCreationOptions, PlaneShape, PlayAnimationOptions, PointLight, PostWater, Primitive, PunctualLight, QUEUE_OPAQUE, QUEUE_TRANSPARENT, Quadtree, QuadtreeNode, RENDER_PASS_TYPE_DEPTH, RENDER_PASS_TYPE_LIGHT, RENDER_PASS_TYPE_OBJECT_COLOR, RENDER_PASS_TYPE_SHADOWMAP, RenderItemList, RenderItemListBundle, RenderItemListInfo, RenderPass, RenderQueue, RenderQueueItem, RenderQueueRef, RotationTrack, SAO, ScaleTrack, Scene, SceneNode, SceneNodeVisible, SceneNodeVisitor, SceneRenderer, SceneUpdateEvent, ShaderHelper, ShadowConfig, ShadowMapParams, ShadowMapPass, ShadowMapType, ShadowMapper, ShadowMode, Shape, ShapeCreationOptions, SharedModel, Skeleton, SkyRenderer, SkyType, SphereCreationOptions, SphereShape, SpotLight, StopAnimationOptions, Terrain, TerrainDetailMapInfo, TerrainMaterial, TerrainMaterialOptions, TerrainPatch, TerrainPatchBase, TextureFetchOptions, TextureMixinInstanceTypes, TextureMixinTypes, TextureProp, TexturePropUniforms, ToMixedTextureType, Tonemap, TorusCreationOptions, TorusShape, TranslationTrack, UnlitMaterial, VSM, Visitor, WaterMesh, WaterShaderImpl, WeightedBlendedOIT, XForm, applyMaterialMixins, createProgramFFT2H, createProgramFFT2V, createProgramH0, createProgramHk, createProgramOcean, createProgramPostFFT2, decode2HalfFromRGBA, decodeFloatFromRGBA, decodeNormalizedFloatFromRGBA, decodeRGBM, defaultBuildParams, encode2HalfToRGBA, encodeFloatToRGBA, encodeNormalizedFloatToRGBA, encodeRGBM, gammaToLinear, linearToGamma, mixinAlbedoColor, mixinBlinnPhong, mixinFoliage, mixinLambert, mixinLight, mixinPBRCommon, mixinPBRMetallicRoughness, mixinPBRSpecularGlossness, mixinTextureProps, mixinVertexColor, noise3D, noisef, panoramaToCubemap, prefilterCubemap, projectCubemap, projectCubemapCPU, smoothNoise3D, worleyFBM, worleyNoise };
+export { AABBTree, ABufferOIT, AbstractPostEffect, AnimationClip, AnimationSet, AnimationTrack, AppOptions, AppResizeEvent, AppTickEvent, Application, AssetAnimationData, AssetAnimationTrack, AssetHierarchyNode, AssetManager, AssetMaterial, AssetMaterialClearcoat, AssetMaterialCommon, AssetMaterialIridescence, AssetMaterialSheen, AssetMaterialTransmission, AssetMeshData, AssetPBRMaterialCommon, AssetPBRMaterialMR, AssetPBRMaterialSG, AssetRotationTrack, AssetScaleTrack, AssetScene, AssetSkeletalAnimationTrack, AssetSkeleton, AssetSubMeshData, AssetTranslationTrack, AssetUnlitMaterial, BUILTIN_ASSET_TEST_CUBEMAP, BUILTIN_ASSET_TEXTURE_SHEEN_LUT, BaseCameraController, BaseLight, BatchDrawable, BatchGroup, BlendMode, BlinnMaterial, BlitType, Blitter, Bloom, BoundingBox, BoundingVolume, BoxCreationOptions, BoxFilterBlitter, BoxFrameShape, BoxShape, CachedBindGroup, Camera, Clipmap, ClipmapDrawContext, Compositor, CompositorContext, CopyBlitter, CullVisitor, CylinderCreationOptions, CylinderShape, DepthPass, DirectionalLight, DrawContext, Drawable, DrawableInstanceInfo, ESM, EnvConstantAmbient, EnvHemisphericAmbient, EnvIBL, EnvLightType, EnvLightWrapper, EnvShIBL, Environment, EnvironmentLighting, EulerRotationTrack, ExtractMixinReturnType, ExtractMixinType, FFTWaveGenerator, FPSCameraController, FPSCameraControllerOptions, FXAA, FogType, GaussianBlurBlitter, GerstnerWaveGenerator, GraphNode, GrassMaterial, Grayscale, HeightField, HeightfieldBBoxTree, HeightfieldBBoxTreeNode, IMixinAlbedoColor, IMixinBlinnPhong, IMixinFoliage, IMixinLambert, IMixinLight, IMixinPBRCommon, IMixinPBRMetallicRoughness, IMixinPBRSpecularGlossiness, IMixinVertexColor, InstanceBindGroupAllocator, InstanceData, InstanceUniformType, LIGHT_TYPE_DIRECTIONAL, LIGHT_TYPE_NONE, LIGHT_TYPE_POINT, LIGHT_TYPE_SPOT, LambertMaterial, LightPass, LogMode, Logger, MAX_CLUSTERED_LIGHTS, MAX_MORPH_ATTRIBUTES, MAX_MORPH_TARGETS, MORPH_ATTRIBUTE_VECTOR_COUNT, MORPH_TARGET_COLOR, MORPH_TARGET_NORMAL, MORPH_TARGET_POSITION, MORPH_TARGET_TANGENT, MORPH_TARGET_TEX0, MORPH_TARGET_TEX1, MORPH_TARGET_TEX2, MORPH_TARGET_TEX3, MORPH_WEIGHTS_VECTOR_COUNT, Material, MaterialTextureInfo, MaterialVaryingFlags, Mesh, MeshMaterial, ModelFetchOptions, ModelInfo, NamedObject, OIT, Octree, OctreeNode, OctreeNodeChunk, OctreePlacement, OrbitCameraController, OrbitCameraControllerOptions, OrthoCamera, PBRMetallicRoughnessMaterial, PBRSpecularGlossinessMaterial, PCFOPT, PCFPD, PerspectiveCamera, PickResult, PickTarget, PlaneCreationOptions, PlaneShape, PlayAnimationOptions, PointLight, PostWater, Primitive, PunctualLight, QUEUE_OPAQUE, QUEUE_TRANSPARENT, Quadtree, QuadtreeNode, RENDER_PASS_TYPE_DEPTH, RENDER_PASS_TYPE_LIGHT, RENDER_PASS_TYPE_OBJECT_COLOR, RENDER_PASS_TYPE_SHADOWMAP, RenderItemList, RenderItemListBundle, RenderItemListInfo, RenderPass, RenderQueue, RenderQueueItem, RenderQueueRef, RotationTrack, SAO, ScaleTrack, Scene, SceneNode, SceneNodeVisible, SceneRenderer, SceneUpdateEvent, ShaderHelper, ShadowConfig, ShadowMapParams, ShadowMapPass, ShadowMapType, ShadowMapper, ShadowMode, Shape, ShapeCreationOptions, SharedModel, Skeleton, SkyRenderer, SkyType, SphereCreationOptions, SphereShape, SpotLight, StopAnimationOptions, Terrain, TerrainDetailMapInfo, TerrainMaterial, TerrainMaterialOptions, TerrainPatch, TerrainPatchBase, TextureFetchOptions, TextureMixinInstanceTypes, TextureMixinTypes, TextureProp, TexturePropUniforms, ToMixedTextureType, Tonemap, TorusCreationOptions, TorusShape, TranslationTrack, UnlitMaterial, VSM, Visitor, WaterMesh, WaterSetupUniformFunc, WaterShaderImpl, WaterShadingFunc, WaterVertexFunc, WaveGenerator, WeightedBlendedOIT, XForm, applyMaterialMixins, createGradientNoiseTexture, createProgramFFT2H, createProgramFFT2V, createProgramH0, createProgramHk, createProgramOcean, createProgramPostFFT2, createRandomNoiseTexture, decode2HalfFromRGBA, decodeFloatFromRGBA, decodeNormalizedFloatFromRGBA, decodeRGBM, encode2HalfToRGBA, encodeFloatToRGBA, encodeNormalizedFloatToRGBA, encodeRGBM, fetchNormalizedFloatForDevice, gammaToLinear, gradient, hash, interleavedGradientNoise, linearToGamma, mixinAlbedoColor, mixinBlinnPhong, mixinFoliage, mixinLambert, mixinLight, mixinPBRCommon, mixinPBRMetallicRoughness, mixinPBRSpecularGlossness, mixinTextureProps, mixinVertexColor, noise3D, panoramaToCubemap, perlinNoise2D, perlinNoise3D, prefilterCubemap, projectCubemap, projectCubemapCPU, smoothNoise3D, worleyFBM, worleyNoise };