@react-three/drei 11.0.0-alpha.5 → 11.0.0-alpha.6

package/webgpu/index.d.mts

@@ -3,11 +3,10 @@ import { ForwardRefExoticComponent, PropsWithoutRef, RefAttributes, CSSPropertie
 import * as _react_three_fiber from '@react-three/fiber';
 import { ThreeElements, ReactThreeFiber, ComputeFunction, Vector2, Vector3, ThreeElement, ThreeEvent, Color as Color$1, ObjectMap, Euler } from '@react-three/fiber';
 import * as THREE from 'three/webgpu';
-import { MeshBasicNodeMaterial, MeshNormalNodeMaterial, MeshPhysicalNodeMaterial, Material, Color, ColorRepresentation, Object3D, Texture as Texture$1, Fog, FogExp2, WebGLCubeRenderTarget, CubeCamera as CubeCamera$1, OrthographicCamera as OrthographicCamera$1, PerspectiveCamera as PerspectiveCamera$1, Event, EventDispatcher, Camera, Matrix4, Vector3 as Vector3$1, Group, LOD, Mesh, ExtrudeGeometry, PositionalAudio as PositionalAudio$1, AnimationClip, AnimationMixer, AnimationAction, BufferGeometry, BufferAttribute, InstancedMesh as InstancedMesh$1, InstancedBufferAttribute, DepthTexture, CubeTexture as CubeTexture$1, Raycaster, Intersection, RenderTargetOptions, Box3, Sphere as Sphere$1, Loader as Loader$1, ColorSpace, Scene, PlaneGeometry, MeshBasicMaterial, SpriteNodeMaterial, SpotLight as SpotLight$1 } from 'three/webgpu';
-import { reflector, uniform, Fn } from 'three/tsl';
+import { MeshBasicNodeMaterial, MeshNormalNodeMaterial, MeshPhysicalNodeMaterial, Material, CubeRenderTarget, Color, ColorRepresentation, Object3D, Texture as Texture$1, Fog, FogExp2, CubeCamera as CubeCamera$1, OrthographicCamera as OrthographicCamera$1, PerspectiveCamera as PerspectiveCamera$1, Event, EventDispatcher, Camera, Matrix4, Vector3 as Vector3$1, Group, LOD, Mesh, ExtrudeGeometry, PositionalAudio as PositionalAudio$1, AnimationClip, AnimationMixer, AnimationAction, BufferGeometry, BufferAttribute, InstancedMesh as InstancedMesh$1, InstancedBufferAttribute, DepthTexture, CubeTexture as CubeTexture$1, Raycaster, Intersection, RenderTargetOptions, Box3, Sphere as Sphere$1, Loader as Loader$1, ColorSpace, Scene, PlaneGeometry, MeshBasicMaterial, SpriteNodeMaterial, ShadowNode, Light, SpotLight as SpotLight$1 } from 'three/webgpu';
+import { reflector, Fn } from 'three/tsl';
 import { LineSegments2 } from 'three/examples/jsm/lines/webgpu/LineSegments2.js';
 import { ArcballControls as ArcballControls$1 } from 'three/examples/jsm/controls/ArcballControls.js';
-import { DragConfig } from '@use-gesture/react';
 import { FirstPersonControls as FirstPersonControls$1 } from 'three/examples/jsm/controls/FirstPersonControls.js';
 import { FlyControls as FlyControls$1 } from 'three/examples/jsm/controls/FlyControls.js';
 import * as zustand from 'zustand';
@@ -17,6 +16,7 @@ import { OrbitControls as OrbitControls$1 } from 'three/addons/controls/OrbitCon
 import { PointerLockControls as PointerLockControls$1 } from 'three/examples/jsm/controls/PointerLockControls.js';
 import { TrackballControls as TrackballControls$1 } from 'three/examples/jsm/controls/TrackballControls.js';
 import * as three from 'three';
+import { Material as Material$1 } from 'three';
 import { Line2 as Line2$1 } from 'three/examples/jsm/lines/Line2.js';
 import { Line2 } from 'three/examples/jsm/lines/webgpu/Line2.js';
 import { Flow } from 'three/examples/jsm/modifiers/CurveModifier.js';
@@ -76,7 +76,7 @@ interface AccumulativeContext {
     frames: number;
     blend: number;
     count: number;
-    getMesh: () => THREE.Mesh<THREE.PlaneGeometry, THREE.ShaderMaterial>;
+    getMesh: () => THREE.Mesh<THREE.PlaneGeometry, SoftShadowMaterialImpl>;
     reset: () => void;
     update: (frames?: number) => void;
 }
@@ -84,6 +84,25 @@ interface AccumulativeLightContext {
     update: () => void;
 }
 declare const accumulativeContext: React.Context<AccumulativeContext>;
+declare class SoftShadowMaterialImpl extends MeshBasicNodeMaterial {
+    private _color;
+    private _blend;
+    private _alphaTest;
+    private _opacity;
+    private _map;
+    constructor();
+    private _buildShader;
+    get shadowColor(): THREE.ColorRepresentation;
+    set shadowColor(v: THREE.ColorRepresentation);
+    get blend(): number;
+    set blend(v: number);
+    get alphaTest(): number;
+    set alphaTest(v: number);
+    get opacity(): number;
+    set opacity(v: number);
+    get map(): THREE.Texture;
+    set map(v: THREE.Texture);
+}
 declare const AccumulativeShadows: ForwardRefComponent<AccumulativeShadowsProps, AccumulativeContext>;
 type RandomizedLightProps = Omit<ThreeElements['group'], 'ref'> & {
     frames?: number;
@@ -196,6 +215,7 @@ type MeshTransmissionMaterialType = Omit<ThreeElements['meshPhysicalMaterial'],
     temporalDistortion?: number;
     buffer?: THREE.Texture;
     time?: number;
+    debugMode?: number;
     args?: [samples: number, transmissionSampler: boolean];
 };
 type MeshTransmissionMaterialProps = Omit<MeshTransmissionMaterialType, 'ref' | 'args'> & {
@@ -213,44 +233,7 @@ declare module '@react-three/fiber' {
         meshTransmissionMaterial: MeshTransmissionMaterialType;
     }
 }
-declare class MeshTransmissionMaterialImpl extends MeshPhysicalNodeMaterial {
-    private _chromaticAberration;
-    private _anisotropicBlur;
-    private _time;
-    private _distortion;
-    private _distortionScale;
-    private _temporalDistortion;
-    private _buffer;
-    private _transmissionValue;
-    private _attenuationDistance;
-    private _attenuationColor;
-    private _samples;
-    private _transmissionSampler;
-    readonly isMeshTransmissionMaterial = true;
-    constructor(samples?: number, transmissionSampler?: boolean);
-    private _buildTransmissionShader;
-    get chromaticAberration(): number;
-    set chromaticAberration(v: number);
-    get anisotropicBlur(): number;
-    set anisotropicBlur(v: number);
-    get time(): number;
-    set time(v: number);
-    get distortion(): number;
-    set distortion(v: number);
-    get distortionScale(): number;
-    set distortionScale(v: number);
-    get temporalDistortion(): number;
-    set temporalDistortion(v: number);
-    get buffer(): THREE.Texture | null;
-    set buffer(v: THREE.Texture | null);
-    get _transmission(): number;
-    set _transmission(v: number);
-    get attenuationDistance(): number;
-    set attenuationDistance(v: number);
-    get attenuationColor(): THREE.Color;
-    set attenuationColor(v: THREE.Color);
-}
-declare const MeshTransmissionMaterial: ForwardRefComponent<MeshTransmissionMaterialProps, MeshTransmissionMaterialImpl>;
+declare const MeshTransmissionMaterial: ForwardRefComponent<MeshTransmissionMaterialProps, ThreeElements['meshTransmissionMaterial']>;
 
 interface MeshReflectorMaterialOptions {
     resolution?: number;
@@ -267,18 +250,18 @@ interface MeshReflectorMaterialOptions {
 }
 declare class MeshReflectorMaterial$1 extends THREE.MeshStandardNodeMaterial {
     reflection: ReturnType<typeof reflector>;
-    mirrorUniform: ReturnType<typeof uniform<number>>;
-    mixBlurUniform: ReturnType<typeof uniform<number>>;
-    mixStrengthUniform: ReturnType<typeof uniform<number>>;
-    minDepthThresholdUniform: ReturnType<typeof uniform<number>>;
-    maxDepthThresholdUniform: ReturnType<typeof uniform<number>>;
-    depthScaleUniform: ReturnType<typeof uniform<number>>;
-    depthToBlurRatioBiasUniform: ReturnType<typeof uniform<number>>;
-    distortionUniform: ReturnType<typeof uniform<number>>;
-    mixContrastUniform: ReturnType<typeof uniform<number>>;
-    blurRadiusUniform: ReturnType<typeof uniform<number>>;
-    hasBlurUniform: ReturnType<typeof uniform<number>>;
-    hasDepthUniform: ReturnType<typeof uniform<number>>;
+    mirrorUniform: THREE.UniformNode<'float', number>;
+    mixBlurUniform: THREE.UniformNode<'float', number>;
+    mixStrengthUniform: THREE.UniformNode<'float', number>;
+    minDepthThresholdUniform: THREE.UniformNode<'float', number>;
+    maxDepthThresholdUniform: THREE.UniformNode<'float', number>;
+    depthScaleUniform: THREE.UniformNode<'float', number>;
+    depthToBlurRatioBiasUniform: THREE.UniformNode<'float', number>;
+    distortionUniform: THREE.UniformNode<'float', number>;
+    mixContrastUniform: THREE.UniformNode<'float', number>;
+    blurRadiusUniform: THREE.UniformNode<'float', number>;
+    hasBlurUniform: THREE.UniformNode<'float', number>;
+    hasDepthUniform: THREE.UniformNode<'float', number>;
     constructor(options?: MeshReflectorMaterialOptions, parameters?: THREE.MeshStandardMaterialParameters);
     private setupNodes;
     get mirror(): number;
@@ -344,6 +327,7 @@ type MeshRefractionMaterialType = Omit<ThreeElements['meshPhysicalMaterial'], 'a
     fastChroma?: boolean;
     tintColor?: THREE.ColorRepresentation;
     opacity?: number;
+    args?: [fastChroma?: boolean];
 };
 type MeshRefractionMaterialProps = Omit<MeshRefractionMaterialType, 'ref'>;
 declare module '@react-three/fiber' {
@@ -359,8 +343,6 @@ declare class MeshRefractionMaterialImpl extends MeshPhysicalNodeMaterial {
     private _aberrationStrength;
     private _color;
     private _opacityValue;
-    private _resolution;
-    private _thickness;
     private _fastChroma;
     readonly isMeshRefractionMaterial = true;
     constructor(fastChroma?: boolean);
@@ -379,10 +361,6 @@ declare class MeshRefractionMaterialImpl extends MeshPhysicalNodeMaterial {
     set tintColor(v: THREE.Color | THREE.ColorRepresentation);
     get opacity(): number;
     set opacity(v: number);
-    get resolution(): THREE.Vector2;
-    set resolution(v: THREE.Vector2);
-    get thickness(): number;
-    set thickness(v: number);
 }
 declare const MeshRefractionMaterial: ForwardRefComponent<MeshRefractionMaterialProps, MeshRefractionMaterialImpl>;
 
@@ -421,16 +399,16 @@ declare class PortalMaterialImpl extends MeshBasicNodeMaterial {
 declare const MeshPortalMaterial: ForwardRefComponent<PortalProps, PortalMaterialImpl>;
 
 declare class DistortMaterialImplWebGPU extends THREE.MeshPhysicalNodeMaterial {
-    timeUniform: ReturnType<typeof uniform>;
-    distortUniform: ReturnType<typeof uniform>;
-    radiusUniform: ReturnType<typeof uniform>;
+    timeUniform: THREE.UniformNode<'float', number>;
+    distortUniform: THREE.UniformNode<'float', number>;
+    radiusUniform: THREE.UniformNode<'float', number>;
     constructor(parameters?: THREE.MeshPhysicalMaterialParameters);
-    get time(): unknown;
-    set time(v: unknown);
-    get distort(): unknown;
-    set distort(v: unknown);
-    get radius(): unknown;
-    set radius(v: unknown);
+    get time(): number;
+    set time(v: number);
+    get distort(): number;
+    set distort(v: number);
+    get radius(): number;
+    set radius(v: number);
 }
 declare module '@react-three/fiber' {
     interface ThreeElements {
@@ -448,13 +426,13 @@ type MeshDistortMaterialProps = Omit<ThreeElements['distortMaterialImplWebGPU'],
 declare const MeshDistortMaterial: ForwardRefComponent<MeshDistortMaterialProps, DistortMaterialImplWebGPU>;
 
 declare class WobbleMaterialImpl extends THREE.MeshStandardNodeMaterial {
-    timeUniform: ReturnType<typeof uniform>;
-    factorUniform: ReturnType<typeof uniform>;
+    timeUniform: THREE.UniformNode<'float', number>;
+    factorUniform: THREE.UniformNode<'float', number>;
     constructor(parameters?: THREE.MeshStandardMaterialParameters);
-    get time(): unknown;
-    set time(v: unknown);
-    get factor(): unknown;
-    set factor(v: unknown);
+    get time(): number;
+    set time(v: number);
+    get factor(): number;
+    set factor(v: number);
 }
 declare module '@react-three/fiber' {
     interface ThreeElements {
@@ -471,7 +449,7 @@ type WobbleMaterialProps = Omit<ThreeElements['meshStandardMaterial'], 'ref'> &
 };
 declare const MeshWobbleMaterial: ForwardRefComponent<WobbleMaterialProps, WobbleMaterialImpl>;
 
-declare function FakeCloudMaterial(BaseMaterial: typeof Material): Material;
+declare function FakeCloudMaterial(BaseMaterial: typeof Material): Material<three.MaterialEventMap>;
 
 type OutlinesProps = Omit<ThreeElements['group'], 'ref'> & {
     color?: ReactThreeFiber.Color;
@@ -525,7 +503,7 @@ type RenderCubeTextureProps = Omit<ThreeElements['texture'], 'ref' | 'args' | 'r
 };
 type RenderCubeTextureApi = {
     scene: THREE.Scene;
-    fbo: THREE.WebGLCubeRenderTarget;
+    fbo: CubeRenderTarget;
     camera: THREE.CubeCamera;
 };
 declare const RenderCubeTexture: ForwardRefComponent<RenderCubeTextureProps, RenderCubeTextureApi>;
@@ -601,7 +579,7 @@ type CubeCameraProps = Omit<ThreeElements['group'], 'children'> & {
     frames?: number;
 } & CubeCameraOptions;
 declare function useCubeCamera({ resolution, near, far, envMap, fog }?: CubeCameraOptions): {
-    fbo: WebGLCubeRenderTarget;
+    fbo: CubeRenderTarget;
     camera: CubeCamera$1;
     update: () => void;
 };
@@ -674,8 +652,9 @@ type DeviceOrientationControlsProps = Omit<ThreeElement<typeof DeviceOrientation
 };
 declare const DeviceOrientationControls: ForwardRefComponent<DeviceOrientationControlsProps, DeviceOrientationControls$1>;
 
-type ExpandedDragConfig = DragConfig & {
-    preventOverlap?: boolean;
+type DragConfig = {
+    threshold?: number;
+    filterTaps?: boolean;
 };
 type DragControlsProps = {
     autoTransform?: boolean;
@@ -687,7 +666,7 @@ type DragControlsProps = {
     onDrag?: (localMatrix: THREE.Matrix4, deltaLocalMatrix: THREE.Matrix4, worldMatrix: THREE.Matrix4, deltaWorldMatrix: THREE.Matrix4) => void;
     onDragEnd?: () => void;
     children: React.ReactNode;
-    dragConfig?: ExpandedDragConfig;
+    dragConfig?: DragConfig;
 };
 declare const DragControls: ForwardRefComponent<DragControlsProps, THREE.Group>;
 
@@ -928,6 +907,7 @@ type CloudsProps = Omit<ThreeElements['group'], 'ref'> & {
     frustumCulled?: boolean;
 };
 type CloudProps = Omit<ThreeElements['group'], 'ref'> & {
+    materialFactory?: (baseMaterial: typeof Material) => Material;
     seed?: number;
     segments?: number;
     bounds?: ReactThreeFiber.Vector3;
@@ -945,9 +925,52 @@ type CloudProps = Omit<ThreeElements['group'], 'ref'> & {
     opacity?: number;
     color?: ReactThreeFiber.Color;
 };
-declare const Clouds: React.ForwardRefExoticComponent<Omit<CloudsProps, "ref"> & React.RefAttributes<Group<three.Object3DEventMap>>>;
-declare const CloudInstance: React.ForwardRefExoticComponent<Omit<CloudProps, "ref"> & React.RefAttributes<Group<three.Object3DEventMap>>>;
-declare const Cloud: React.ForwardRefExoticComponent<Omit<CloudProps, "ref"> & React.RefAttributes<Group<three.Object3DEventMap>>>;
+declare const Clouds: React.ForwardRefExoticComponent<Omit<_react_three_fiber.Mutable<_react_three_fiber.Overwrite<Partial<_react_three_fiber.Overwrite<Group<three.Object3DEventMap>, _react_three_fiber.MathProps<Group<three.Object3DEventMap>> & _react_three_fiber.ReactProps<Group<three.Object3DEventMap>> & Partial<_react_three_fiber.EventHandlers> & _react_three_fiber.NodeProps<Group<three.Object3DEventMap>>>>, Omit<_react_three_fiber.InstanceProps<Group<three.Object3DEventMap>, typeof Group>, "object">>>, "ref"> & {
+    texture?: string;
+    limit?: number;
+    range?: number;
+    material?: typeof Material;
+    materialFactory?: (baseMaterial: typeof Material) => Material;
+    frustumCulled?: boolean;
+} & React.RefAttributes<Group<three.Object3DEventMap>>>;
+declare const CloudInstance: React.ForwardRefExoticComponent<Omit<_react_three_fiber.Mutable<_react_three_fiber.Overwrite<Partial<_react_three_fiber.Overwrite<Group<three.Object3DEventMap>, _react_three_fiber.MathProps<Group<three.Object3DEventMap>> & _react_three_fiber.ReactProps<Group<three.Object3DEventMap>> & Partial<_react_three_fiber.EventHandlers> & _react_three_fiber.NodeProps<Group<three.Object3DEventMap>>>>, Omit<_react_three_fiber.InstanceProps<Group<three.Object3DEventMap>, typeof Group>, "object">>>, "ref"> & {
+    materialFactory?: (baseMaterial: typeof Material) => Material;
+    seed?: number;
+    segments?: number;
+    bounds?: ReactThreeFiber.Vector3;
+    concentrate?: "random" | "inside" | "outside";
+    scale?: ReactThreeFiber.Vector3;
+    volume?: number;
+    smallestVolume?: number;
+    distribute?: (cloud: CloudState, index: number) => {
+        point: Vector3$1;
+        volume?: number;
+    };
+    growth?: number;
+    speed?: number;
+    fade?: number;
+    opacity?: number;
+    color?: ReactThreeFiber.Color;
+} & React.RefAttributes<Group<three.Object3DEventMap>>>;
+declare const Cloud: React.ForwardRefExoticComponent<Omit<_react_three_fiber.Mutable<_react_three_fiber.Overwrite<Partial<_react_three_fiber.Overwrite<Group<three.Object3DEventMap>, _react_three_fiber.MathProps<Group<three.Object3DEventMap>> & _react_three_fiber.ReactProps<Group<three.Object3DEventMap>> & Partial<_react_three_fiber.EventHandlers> & _react_three_fiber.NodeProps<Group<three.Object3DEventMap>>>>, Omit<_react_three_fiber.InstanceProps<Group<three.Object3DEventMap>, typeof Group>, "object">>>, "ref"> & {
+    materialFactory?: (baseMaterial: typeof Material) => Material;
+    seed?: number;
+    segments?: number;
+    bounds?: ReactThreeFiber.Vector3;
+    concentrate?: "random" | "inside" | "outside";
+    scale?: ReactThreeFiber.Vector3;
+    volume?: number;
+    smallestVolume?: number;
+    distribute?: (cloud: CloudState, index: number) => {
+        point: Vector3$1;
+        volume?: number;
+    };
+    growth?: number;
+    speed?: number;
+    fade?: number;
+    opacity?: number;
+    color?: ReactThreeFiber.Color;
+} & React.RefAttributes<Group<three.Object3DEventMap>>>;
 
 type CatmullRomLineProps = Omit<LineProps, 'ref' | 'segments'> & {
     closed?: boolean;
@@ -1067,25 +1090,25 @@ type Args<T> = T extends new (...args: any) => any ? ConstructorParameters<T> :
 type ShapeProps<T> = Omit<ThreeElements['mesh'], 'ref' | 'args'> & {
     args?: Args<T>;
 };
-declare const Box: ForwardRefComponent<ShapeProps<typeof THREE.BoxGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.Object3DEventMap>>;
-declare const Circle: ForwardRefComponent<ShapeProps<typeof THREE.CircleGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.Object3DEventMap>>;
-declare const Cone: ForwardRefComponent<ShapeProps<typeof THREE.ConeGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.Object3DEventMap>>;
-declare const Cylinder: ForwardRefComponent<ShapeProps<typeof THREE.CylinderGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.Object3DEventMap>>;
-declare const Sphere: ForwardRefComponent<ShapeProps<typeof THREE.SphereGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.Object3DEventMap>>;
-declare const Plane: ForwardRefComponent<ShapeProps<typeof THREE.PlaneGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.Object3DEventMap>>;
-declare const Tube: ForwardRefComponent<ShapeProps<typeof THREE.TubeGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.Object3DEventMap>>;
-declare const Torus: ForwardRefComponent<ShapeProps<typeof THREE.TorusGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.Object3DEventMap>>;
-declare const TorusKnot: ForwardRefComponent<ShapeProps<typeof THREE.TorusKnotGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.Object3DEventMap>>;
-declare const Tetrahedron: ForwardRefComponent<ShapeProps<typeof THREE.TetrahedronGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.Object3DEventMap>>;
-declare const Ring: ForwardRefComponent<ShapeProps<typeof THREE.RingGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.Object3DEventMap>>;
-declare const Polyhedron: ForwardRefComponent<ShapeProps<typeof THREE.PolyhedronGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.Object3DEventMap>>;
-declare const Icosahedron: ForwardRefComponent<ShapeProps<typeof THREE.IcosahedronGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.Object3DEventMap>>;
-declare const Octahedron: ForwardRefComponent<ShapeProps<typeof THREE.OctahedronGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.Object3DEventMap>>;
-declare const Dodecahedron: ForwardRefComponent<ShapeProps<typeof THREE.DodecahedronGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.Object3DEventMap>>;
-declare const Extrude: ForwardRefComponent<ShapeProps<typeof THREE.ExtrudeGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.Object3DEventMap>>;
-declare const Lathe: ForwardRefComponent<ShapeProps<typeof THREE.LatheGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.Object3DEventMap>>;
-declare const Capsule: ForwardRefComponent<ShapeProps<typeof THREE.CapsuleGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.Object3DEventMap>>;
-declare const Shape: ForwardRefComponent<ShapeProps<typeof THREE.ShapeGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.Object3DEventMap>>;
+declare const Box: ForwardRefComponent<ShapeProps<typeof THREE.BoxGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material<THREE.MaterialEventMap> | THREE.Material<THREE.MaterialEventMap>[], THREE.Object3DEventMap>>;
+declare const Circle: ForwardRefComponent<ShapeProps<typeof THREE.CircleGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material<THREE.MaterialEventMap> | THREE.Material<THREE.MaterialEventMap>[], THREE.Object3DEventMap>>;
+declare const Cone: ForwardRefComponent<ShapeProps<typeof THREE.ConeGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material<THREE.MaterialEventMap> | THREE.Material<THREE.MaterialEventMap>[], THREE.Object3DEventMap>>;
+declare const Cylinder: ForwardRefComponent<ShapeProps<typeof THREE.CylinderGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material<THREE.MaterialEventMap> | THREE.Material<THREE.MaterialEventMap>[], THREE.Object3DEventMap>>;
+declare const Sphere: ForwardRefComponent<ShapeProps<typeof THREE.SphereGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material<THREE.MaterialEventMap> | THREE.Material<THREE.MaterialEventMap>[], THREE.Object3DEventMap>>;
+declare const Plane: ForwardRefComponent<ShapeProps<typeof THREE.PlaneGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material<THREE.MaterialEventMap> | THREE.Material<THREE.MaterialEventMap>[], THREE.Object3DEventMap>>;
+declare const Tube: ForwardRefComponent<ShapeProps<typeof THREE.TubeGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material<THREE.MaterialEventMap> | THREE.Material<THREE.MaterialEventMap>[], THREE.Object3DEventMap>>;
+declare const Torus: ForwardRefComponent<ShapeProps<typeof THREE.TorusGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material<THREE.MaterialEventMap> | THREE.Material<THREE.MaterialEventMap>[], THREE.Object3DEventMap>>;
+declare const TorusKnot: ForwardRefComponent<ShapeProps<typeof THREE.TorusKnotGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material<THREE.MaterialEventMap> | THREE.Material<THREE.MaterialEventMap>[], THREE.Object3DEventMap>>;
+declare const Tetrahedron: ForwardRefComponent<ShapeProps<typeof THREE.TetrahedronGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material<THREE.MaterialEventMap> | THREE.Material<THREE.MaterialEventMap>[], THREE.Object3DEventMap>>;
+declare const Ring: ForwardRefComponent<ShapeProps<typeof THREE.RingGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material<THREE.MaterialEventMap> | THREE.Material<THREE.MaterialEventMap>[], THREE.Object3DEventMap>>;
+declare const Polyhedron: ForwardRefComponent<ShapeProps<typeof THREE.PolyhedronGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material<THREE.MaterialEventMap> | THREE.Material<THREE.MaterialEventMap>[], THREE.Object3DEventMap>>;
+declare const Icosahedron: ForwardRefComponent<ShapeProps<typeof THREE.IcosahedronGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material<THREE.MaterialEventMap> | THREE.Material<THREE.MaterialEventMap>[], THREE.Object3DEventMap>>;
+declare const Octahedron: ForwardRefComponent<ShapeProps<typeof THREE.OctahedronGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material<THREE.MaterialEventMap> | THREE.Material<THREE.MaterialEventMap>[], THREE.Object3DEventMap>>;
+declare const Dodecahedron: ForwardRefComponent<ShapeProps<typeof THREE.DodecahedronGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material<THREE.MaterialEventMap> | THREE.Material<THREE.MaterialEventMap>[], THREE.Object3DEventMap>>;
+declare const Extrude: ForwardRefComponent<ShapeProps<typeof THREE.ExtrudeGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material<THREE.MaterialEventMap> | THREE.Material<THREE.MaterialEventMap>[], THREE.Object3DEventMap>>;
+declare const Lathe: ForwardRefComponent<ShapeProps<typeof THREE.LatheGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material<THREE.MaterialEventMap> | THREE.Material<THREE.MaterialEventMap>[], THREE.Object3DEventMap>>;
+declare const Capsule: ForwardRefComponent<ShapeProps<typeof THREE.CapsuleGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material<THREE.MaterialEventMap> | THREE.Material<THREE.MaterialEventMap>[], THREE.Object3DEventMap>>;
+declare const Shape: ForwardRefComponent<ShapeProps<typeof THREE.ShapeGeometry>, THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material<THREE.MaterialEventMap> | THREE.Material<THREE.MaterialEventMap>[], THREE.Object3DEventMap>>;
 
 type Glyph = {
     _cachedOutline: string[];
@@ -1124,7 +1147,8 @@ type Text3DProps = Omit<ThreeElements['mesh'], 'ref'> & {
     font: FontData | string;
     bevelSegments?: number;
     smooth?: number;
-} & Omit<TextGeometryParameters, 'font'>;
+    height?: number;
+} & Omit<TextGeometryParameters, 'font' | 'depth'>;
 declare const Text3D: ForwardRefComponent<React.PropsWithChildren<Text3DProps & {
     letterSpacing?: number;
     lineHeight?: number;
@@ -1176,6 +1200,12 @@ type OnDragStartProps = {
     origin: THREE.Vector3;
     directions: THREE.Vector3[];
 };
+type OnDragProps = {
+    local: THREE.Matrix4;
+    deltaLocal: THREE.Matrix4;
+    world: THREE.Matrix4;
+    deltaWorld: THREE.Matrix4;
+};
 type OnHoverProps = {
     component: 'Arrow' | 'Slider' | 'Rotator' | 'Sphere';
     axis: 0 | 1 | 2;
@@ -1206,8 +1236,8 @@ type PivotControlsProps = {
     annotations?: boolean;
     annotationsClass?: string;
     onDragStart?: (props: OnDragStartProps) => void;
-    onDrag?: (l: THREE.Matrix4, deltaL: THREE.Matrix4, w: THREE.Matrix4, deltaW: THREE.Matrix4) => void;
-    onDragEnd?: () => void;
+    onDrag?: (props: OnDragProps) => void;
+    onDragEnd?: (props: OnDragProps) => void;
     onHover?: (props: OnHoverProps) => void;
     depthTest?: boolean;
     renderOrder?: number;
@@ -1250,8 +1280,8 @@ type HelperType = Object3D & {
     dispose: () => void;
 };
 type HelperConstructor = new (...args: any[]) => any;
-type HelperArgs<T> = T extends [infer _, ...infer R] ? R : never;
-declare function useHelper<T extends HelperConstructor>(object3D: React.RefObject<Object3D> | Falsey, helperConstructor: T, ...args: HelperArgs<ConstructorParameters<T>>): React.RefObject<HelperType | null>;
+type HelperArgs<T> = T extends [infer _, ...infer R] ? R : [];
+declare function useHelper<T extends HelperConstructor>(object3D: React.RefObject<Object3D | null> | Falsey, helperConstructor: T, ...args: HelperArgs<ConstructorParameters<T>>): React.RefObject<HelperType | null>;
 type HelperProps<T extends HelperConstructor> = {
     type: T;
     args?: HelperArgs<ConstructorParameters<T>>;
@@ -1308,7 +1338,7 @@ declare class PositionMesh extends THREE.Group {
     get geometry(): THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap> | undefined;
     raycast(raycaster: THREE.Raycaster, intersects: THREE.Intersection[]): void;
 }
-declare const Instance: React.ForwardRefExoticComponent<Omit<_react_three_fiber.Mutable<_react_three_fiber.Overwrite<Partial<_react_three_fiber.Overwrite<PositionMesh, _react_three_fiber.MathProps<PositionMesh> & _react_three_fiber.ReactProps<PositionMesh> & Partial<_react_three_fiber.EventHandlers>>>, Omit<_react_three_fiber.InstanceProps<PositionMesh, typeof PositionMesh>, "object">>>, "ref"> & {
+declare const Instance: React.ForwardRefExoticComponent<Omit<_react_three_fiber.Mutable<_react_three_fiber.Overwrite<Partial<_react_three_fiber.Overwrite<PositionMesh, _react_three_fiber.MathProps<PositionMesh> & _react_three_fiber.ReactProps<PositionMesh> & Partial<_react_three_fiber.EventHandlers> & _react_three_fiber.NodeProps<PositionMesh>>>, Omit<_react_three_fiber.InstanceProps<PositionMesh, typeof PositionMesh>, "object">>>, "ref"> & {
     context?: React.Context<Api$1>;
 } & React.RefAttributes<unknown>>;
 declare const Instances: ForwardRefComponent<InstancesProps, THREE.InstancedMesh>;
@@ -1317,10 +1347,21 @@ interface MergedProps extends Omit<InstancesProps, 'children'> {
     children: (...instances: [React.FC<InstanceProps> & Record<string, React.FC<InstanceProps>>, ...React.FC<InstanceProps>[]]) => React.ReactNode;
 }
 declare const Merged: ForwardRefComponent<MergedProps, THREE.Group>;
-declare function createInstances<T = InstanceProps>(): readonly [React.ForwardRefExoticComponent<Omit<InstancesProps, "ref"> & React.RefAttributes<THREE.InstancedMesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.InstancedMeshEventMap>>>, React.ForwardRefExoticComponent<React.PropsWithoutRef<T & Omit<_react_three_fiber.Mutable<_react_three_fiber.Overwrite<Partial<_react_three_fiber.Overwrite<PositionMesh, _react_three_fiber.MathProps<PositionMesh> & _react_three_fiber.ReactProps<PositionMesh> & Partial<_react_three_fiber.EventHandlers>>>, Omit<_react_three_fiber.InstanceProps<PositionMesh, typeof PositionMesh>, "object">>>, "ref"> & {
+declare function createInstances<T = InstanceProps>(): readonly [React.ForwardRefExoticComponent<Omit<_react_three_fiber.Mutable<_react_three_fiber.Overwrite<Partial<_react_three_fiber.Overwrite<THREE.InstancedMesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material<THREE.MaterialEventMap> | THREE.Material<THREE.MaterialEventMap>[], THREE.InstancedMeshEventMap>, _react_three_fiber.MathProps<THREE.InstancedMesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material<THREE.MaterialEventMap> | THREE.Material<THREE.MaterialEventMap>[], THREE.InstancedMeshEventMap>> & _react_three_fiber.ReactProps<THREE.InstancedMesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material<THREE.MaterialEventMap> | THREE.Material<THREE.MaterialEventMap>[], THREE.InstancedMeshEventMap>> & Partial<_react_three_fiber.EventHandlers> & _react_three_fiber.NodeProps<THREE.InstancedMesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material<THREE.MaterialEventMap> | THREE.Material<THREE.MaterialEventMap>[], THREE.InstancedMeshEventMap>>>>, Omit<_react_three_fiber.InstanceProps<THREE.InstancedMesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material<THREE.MaterialEventMap> | THREE.Material<THREE.MaterialEventMap>[], THREE.InstancedMeshEventMap>, typeof THREE.InstancedMesh>, "object">>>, "ref" | "args"> & {
+    context?: React.Context<Api$1>;
+    range?: number;
+    limit?: number;
+    frames?: number;
+} & React.RefAttributes<THREE.InstancedMesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material<THREE.MaterialEventMap> | THREE.Material<THREE.MaterialEventMap>[], THREE.InstancedMeshEventMap>>>, React.ForwardRefExoticComponent<React.PropsWithoutRef<T & Omit<_react_three_fiber.Mutable<_react_three_fiber.Overwrite<Partial<_react_three_fiber.Overwrite<PositionMesh, _react_three_fiber.MathProps<PositionMesh> & _react_three_fiber.ReactProps<PositionMesh> & Partial<_react_three_fiber.EventHandlers> & _react_three_fiber.NodeProps<PositionMesh>>>, Omit<_react_three_fiber.InstanceProps<PositionMesh, typeof PositionMesh>, "object">>>, "ref"> & {
     context?: React.Context<Api$1>;
 }> & React.RefAttributes<PositionMesh & T>>];
-declare const InstancedAttribute: React.ForwardRefExoticComponent<Omit<InstancedAttributeProps, "ref"> & React.RefAttributes<THREE.InstancedBufferAttribute>>;
+declare const InstancedAttribute: React.ForwardRefExoticComponent<Omit<_react_three_fiber.Mutable<_react_three_fiber.Overwrite<Partial<_react_three_fiber.Overwrite<THREE.InstancedBufferAttribute, _react_three_fiber.MathProps<THREE.InstancedBufferAttribute> & _react_three_fiber.ReactProps<THREE.InstancedBufferAttribute> & _react_three_fiber.NodeProps<THREE.InstancedBufferAttribute>>>, Omit<_react_three_fiber.InstanceProps<THREE.InstancedBufferAttribute, typeof THREE.InstancedBufferAttribute>, "object">>>, "ref" | "args"> & {
+    name: string;
+    defaultValue: any;
+    normalized?: boolean;
+    usage?: number;
+    type?: "float" | "int" | "uint" | "short" | "ushort" | "byte";
+} & React.RefAttributes<THREE.InstancedBufferAttribute>>;
 
 type Size = {
     w: number;
@@ -1424,7 +1465,40 @@ type SpriteAnimatorState = {
     ref: React.Ref<THREE.Group>;
 };
 declare function useSpriteAnimator(): SpriteAnimatorState | null;
-declare const SpriteAnimator: React.ForwardRefExoticComponent<Omit<SpriteAnimatorProps, "ref"> & React.RefAttributes<THREE.Group<THREE.Object3DEventMap>>>;
+declare const SpriteAnimator: React.ForwardRefExoticComponent<{
+    startFrame?: number;
+    endFrame?: number;
+    fps?: number;
+    frameName?: string;
+    textureDataURL?: string;
+    textureImageURL?: string;
+    loop?: boolean;
+    numberOfFrames?: number;
+    autoPlay?: boolean;
+    animationNames?: Array<string>;
+    onStart?: (data: AnimationEventData) => void;
+    onEnd?: (data: AnimationEventData) => void;
+    onLoopEnd?: (data: AnimationEventData) => void;
+    onFrame?: (data: AnimationEventData) => void;
+    play?: boolean;
+    pause?: boolean;
+    flipX?: boolean;
+    alphaTest?: number;
+    asSprite?: boolean;
+    offset?: number;
+    playBackwards?: boolean;
+    resetOnEnd?: boolean;
+    instanceItems?: Vector3[];
+    maxItems?: number;
+    spriteDataset?: {
+        spriteTexture: THREE.Texture;
+        spriteData: SpriteData | null;
+        aspect: Vector3;
+    } | null;
+    canvasRenderingContext2DSettings?: CanvasRenderingContext2DSettings;
+    roundFramePosition?: boolean;
+    meshProps?: CommonMeshProps;
+} & Omit<_react_three_fiber.Mutable<_react_three_fiber.Overwrite<Partial<_react_three_fiber.Overwrite<THREE.Group<THREE.Object3DEventMap>, _react_three_fiber.MathProps<THREE.Group<THREE.Object3DEventMap>> & _react_three_fiber.ReactProps<THREE.Group<THREE.Object3DEventMap>> & Partial<_react_three_fiber.EventHandlers> & _react_three_fiber.NodeProps<THREE.Group<THREE.Object3DEventMap>>>>, Omit<_react_three_fiber.InstanceProps<THREE.Group<THREE.Object3DEventMap>, typeof THREE.Group>, "object">>>, "ref"> & React.RefAttributes<THREE.Group<THREE.Object3DEventMap>>>;
 
 type Api<T extends AnimationClip> = {
     ref: React.RefObject<Object3D | undefined | null>;
@@ -1510,7 +1584,7 @@ declare const Svg: ForwardRefComponent<SvgProps, Object3D>;
 declare function useDepthBuffer({ size, frames }?: {
     size?: number;
     frames?: number;
-}): DepthTexture | null;
+}): DepthTexture<three.DepthTextureImageData> | null;
 
 interface CubeTextureOptions {
     path: string;
@@ -1609,27 +1683,42 @@ declare function Fbx({ path, ...props }: {
 type Path = string | string[];
 type UseDraco = boolean | string;
 type UseMeshopt = boolean;
+type UseKTX2 = boolean | string;
 type ExtendLoader$1 = (loader: GLTFLoader) => void;
-declare const useGLTF: {
-    <T extends Path>(path: T, useDraco?: UseDraco, useMeshopt?: UseMeshopt, extendLoader?: ExtendLoader$1): T extends any[] ? (GLTF & ObjectMap)[] : GLTF & ObjectMap;
-    preload(path: Path, useDraco?: UseDraco, useMeshopt?: UseMeshopt, extendLoader?: ExtendLoader$1): void;
-    clear(path: Path): void;
-    setDecoderPath(path: string): void;
-};
+interface UseGLTFOptions {
+    draco?: UseDraco;
+    meshopt?: UseMeshopt;
+    ktx2?: UseKTX2;
+    extendLoader?: ExtendLoader$1;
+}
+declare function useGLTF<T extends Path>(path: T, optionsOrDraco?: UseGLTFOptions | UseDraco, useMeshoptArg?: UseMeshopt, useKTX2Arg?: UseKTX2, extendLoaderArg?: ExtendLoader$1): T extends any[] ? (GLTF & ObjectMap)[] : GLTF & ObjectMap;
+declare namespace useGLTF {
+    var preload: (path: Path, optionsOrDraco?: UseGLTFOptions | UseDraco, useMeshoptArg?: UseMeshopt, useKTX2Arg?: UseKTX2, extendLoaderArg?: ExtendLoader$1) => void;
+    var clear: (path: Path) => void;
+    var setDecoderPath: (path: string) => void;
+    var setKTX2TranscoderPath: (path: string) => void;
+}
 type GltfProps = Omit<CloneProps, 'object'> & {
     src: string;
     useDraco?: UseDraco;
     useMeshOpt?: UseMeshopt;
     extendLoader?: ExtendLoader$1;
+    options?: UseGLTFOptions;
 };
-declare const Gltf: React.ForwardRefExoticComponent<Omit<GltfProps, "ref"> & React.RefAttributes<three.Group<three.Object3DEventMap>>>;
+declare const Gltf: React.ForwardRefExoticComponent<Omit<CloneProps, "object"> & {
+    src: string;
+    useDraco?: UseDraco;
+    useMeshOpt?: UseMeshopt;
+    extendLoader?: ExtendLoader$1;
+    options?: UseGLTFOptions;
+} & React.RefAttributes<three.Group<three.Object3DEventMap>>>;
 
 type ExtendLoader = (loader: KTX2Loader) => void;
 declare function useKTX2<Url extends string[] | string | Record<string, string>>(input: Url, basisPath?: boolean | string, extendLoader?: ExtendLoader): Url extends any[] ? Texture$1[] : Url extends object ? {
     [key in keyof Url]: Texture$1;
 } : Texture$1;
 declare namespace useKTX2 {
-    var preload: (url: string extends any[] ? string[] : string, basisPath?: boolean | string, extendLoader?: ExtendLoader) => void;
+    var preload: (url: string | string[], basisPath?: boolean | string, extendLoader?: ExtendLoader) => void;
     var clear: (input: string | string[]) => void;
     var setTranscoderPath: (path: string) => void;
 }
@@ -1670,6 +1759,13 @@ declare const Texture: ({ children, input, onLoad, }: {
     onLoad?: Parameters<typeof useTexture>[1];
 }) => React.JSX.Element;
 
+declare const useVariants: (model: GLTF, inVariant?: string) => {
+    variants: any;
+    activeVariant: string | null;
+    setVariant: (variantName: string | null) => void;
+    materials: Material$1<three.MaterialEventMap>[];
+};
+
 type WebcamVideoTextureProps = Omit<VideoTextureProps, 'src'> & {
     constraints?: MediaStreamConstraints;
 };
@@ -1755,7 +1851,7 @@ declare const StatsGl: ForwardRefComponent<StatsGlProps, HTMLDivElement>;
 type FBOSettings = {
     depth?: boolean;
 } & RenderTargetOptions;
-declare function useFBO(width?: number | FBOSettings, height?: number, settings?: FBOSettings): THREE.WebGLRenderTarget<THREE.Texture<unknown>>;
+declare function useFBO(width?: number | FBOSettings, height?: number, settings?: FBOSettings): THREE.WebGLRenderTarget<THREE.Texture<unknown, THREE.TextureEventMap>>;
 type UseFBOParams = Parameters<typeof useFBO>;
 type FboProps = {
     children?: (target: Fbo) => React.ReactNode;
@@ -1769,7 +1865,7 @@ declare const Fbo: React.ForwardRefExoticComponent<{
     height?: UseFBOParams[1];
 } & {
     depth?: boolean;
-} & THREE.RenderTargetOptions & React.RefAttributes<THREE.WebGLRenderTarget<THREE.Texture<unknown>>>>;
+} & THREE.RenderTargetOptions & React.RefAttributes<THREE.WebGLRenderTarget<THREE.Texture<unknown, THREE.TextureEventMap>>>>;
 
 type FisheyeProps = ThreeElements['mesh'] & {
     zoom?: number;
@@ -1942,7 +2038,7 @@ type EnvironmentLoaderProps = {
     extensions?: (loader: Loader$1) => void;
     colorSpace?: ColorSpace;
 };
-declare function useEnvironment({ files, path, preset, colorSpace, extensions, }?: Partial<EnvironmentLoaderProps>): Texture$1<unknown> | CubeTexture$1<unknown>;
+declare function useEnvironment({ files, path, preset, colorSpace, extensions, }?: Partial<EnvironmentLoaderProps>): Texture$1<unknown, three.TextureEventMap> | CubeTexture$1<unknown>;
 declare namespace useEnvironment {
     var preload: (preloadOptions?: EnvironmentLoaderPreloadOptions) => void;
     var clear: (clearOptions?: EnvironmentLoaderClearOptions) => void;
@@ -2013,7 +2109,13 @@ type ResizeProps = Omit<ThreeElements['group'], 'ref'> & {
     box3?: THREE.Box3;
     precise?: boolean;
 };
-declare const Resize: React.ForwardRefExoticComponent<Omit<ResizeProps, "ref"> & React.RefAttributes<THREE.Group<THREE.Object3DEventMap>>>;
+declare const Resize: React.ForwardRefExoticComponent<Omit<_react_three_fiber.Mutable<_react_three_fiber.Overwrite<Partial<_react_three_fiber.Overwrite<THREE.Group<THREE.Object3DEventMap>, _react_three_fiber.MathProps<THREE.Group<THREE.Object3DEventMap>> & _react_three_fiber.ReactProps<THREE.Group<THREE.Object3DEventMap>> & Partial<_react_three_fiber.EventHandlers> & _react_three_fiber.NodeProps<THREE.Group<THREE.Object3DEventMap>>>>, Omit<_react_three_fiber.InstanceProps<THREE.Group<THREE.Object3DEventMap>, typeof THREE.Group>, "object">>>, "ref"> & {
+    width?: boolean;
+    height?: boolean;
+    depth?: boolean;
+    box3?: THREE.Box3;
+    precise?: boolean;
+} & React.RefAttributes<THREE.Group<THREE.Object3DEventMap>>>;
 
 type ScreenSizerProps = Omit<ThreeElements['object3D'], 'ref'> & {
     scale?: number;
@@ -2320,7 +2422,7 @@ type GradientTextureProps = {
     type?: GradientType;
     innerCircleRadius?: number;
     outerCircleRadius?: number | 'auto';
-} & Omit<ThreeElements['canvasTexture'], 'args'>;
+} & Omit<ThreeElements['canvasTexture'], 'args' | 'type'>;
 declare function GradientTexture({ stops, colors, size, width, type, innerCircleRadius, outerCircleRadius, ...props }: GradientTextureProps): React.JSX.Element;
 
 type ImageProps = Omit<ThreeElements['mesh'], 'scale'> & {
@@ -2375,6 +2477,10 @@ declare class SpotLightMaterial extends MeshBasicNodeMaterial {
     set resolution(v: THREE.Vector2);
 }
 
+declare const HtmlMaterial: ({ transform }: {
+    transform: boolean;
+}) => React.JSX.Element;
+
 declare class StarfieldMaterial extends SpriteNodeMaterial {
     private _time;
     private _fade;
@@ -2422,12 +2528,26 @@ type GridProps = Omit<ThreeElements['mesh'], 'ref' | 'args'> & GridMaterialType
 };
 declare const Grid: ForwardRefComponent<GridProps, THREE.Mesh>;
 
+type PCSSShadowNodeOptions = {
+    size?: number;
+    samples?: number;
+    focus?: number;
+};
+declare class PCSSShadowNode extends ShadowNode {
+    size: number;
+    samples: number;
+    focus: number;
+    constructor(light: Light, { size, samples, focus }?: PCSSShadowNodeOptions);
+    setupRenderTarget(shadow: any, builder: any): any;
+    getShadowFilterFn(_type: number): ShaderCallable<THREE.Node>;
+}
+
 type SoftShadowsProps = {
     size?: number;
     samples?: number;
     focus?: number;
 };
-declare function SoftShadows(props: SoftShadowsProps): null;
+declare function SoftShadows({ size, samples, focus }: SoftShadowsProps): null;
 
 type SpotLightProps = Omit<ThreeElements['spotLight'], 'ref'> & {
     depthBuffer?: Texture$1;
@@ -2474,5 +2594,5 @@ type SparklesProps = Omit<ThreeElements['mesh'], 'ref'> & {
 };
 declare const Sparkles: ForwardRefComponent<SparklesProps, THREE.InstancedMesh>;
 
-export { AccumulativeShadows, AdaptiveDpr, AdaptiveEvents, ArcballControls, BBAnchor, Backdrop, BakeShadows, Billboard, Bounds, Box, CameraShake, Capsule, CatmullRomLine, Caustics, CausticsMaterial, CausticsNormalMaterial, CausticsProjectionMaterial, Center, Circle, Clone, Cloud, CloudInstance, Clouds, ComputedAttribute, Cone, ContactShadows, ConvolutionMaterial, CubeCamera, CubeTexture, CubicBezierLine, CurveModifier, CycleRaycast, Cylinder, Decal, Detailed, DetectGPU, DeviceOrientationControls, DiscardMaterial, Dodecahedron, DragControls, Edges, Environment, EnvironmentCube, EnvironmentMap, EnvironmentPortal, Example, Extrude, FakeCloudMaterial, Fbo, Fbx, FirstPersonControls, Fisheye, Float, FlyControls, GizmoHelper, GizmoViewcube, GizmoViewport, Gltf, GradientTexture, GradientType, Grid, Helper, Html, Hud, Icosahedron, Image, Instance, InstancedAttribute, Instances, IsObject, KeyboardControls, Ktx2, Lathe, Lightformer, Line, Loader, MapControls, Mask, MatcapTexture, Merged, MeshDistortMaterial, MeshPortalMaterial, MeshReflectorMaterial, MeshReflectorMaterial$1 as MeshReflectorMaterialImpl, MeshRefractionMaterial, MeshTransmissionMaterial, MeshWobbleMaterial, MotionPathControls, NormalTexture, Octahedron, OrbitControls, OrthographicCamera, Outlines, PerformanceMonitor, PerspectiveCamera, PivotControls, Plane, Point, PointMaterial, PointMaterialImpl, PointerLockControls, Points, PointsBuffer, Polyhedron, PositionMesh, PositionPoint, PositionalAudio, Preload, PresentationControls, Progress, QuadraticBezierLine, RandomizedLight, RenderCubeTexture, RenderTexture, Resize, Ring, RoundedBox, RoundedBoxGeometry, Sampler, ScreenQuad, ScreenSizer, ScreenSpace, ScreenVideoTexture, Scroll, ScrollControls, Segment, SegmentObject, Segments, Select, Shadow, Shape, Sky, SoftShadows, Sparkles, SparklesMaterial, Sphere, SpotLight, SpotLightMaterial, SpriteAnimator, Stage, StarfieldMaterial, Stars, Stats, StatsGl, Svg, Tetrahedron, Text3D, Texture, Torus, TorusKnot, TrackballControls, Trail, TrailTexture, TransformControls, Tube, VideoTexture, View, WebcamVideoTexture, Wireframe, WireframeMaterial, WireframeMaterialShaders, accumulativeContext, calcPosFromAngles, checkIfFrameIsEmpty, createInstances, getFirstFrame, meshBounds, presetsObj, setBarycentricCoordinates, setWireframeOverride, useAnimations, useAspect, useBounds, useContextBridge, useCubeCamera, useCubeTexture, useCursor, useCustomRaycast, useDepthBuffer, useDetectGPU, useEnvironment, useFBO, useFBX, useFont, useGLTF, useGizmoContext, useHelper, useIntersect, useKTX2, useKeyboardControls, useMask, useMatcapTexture, useMotion, useNormalTexture, usePerformanceMonitor, useProgress, useScroll, useSelect, useSpriteAnimator, useSpriteLoader, useSurfaceSampler, useTexture, useTrail, useTrailTexture, useVideoTexture, useWireframeUniforms };
-export type { AccumulativeShadowsProps, ArcballControlsProps, Args, BBAnchorProps, BackdropProps, BillboardProps, BoundsApi, BoundsProps, CalculatePosition, CameraShakeProps, CatmullRomLineProps, CausticsProps, CenterProps, CloneProps, CloudProps, CloudsProps, ComputedAttributeProps, ContactShadowsProps, ContainerProps, CubeCameraOptions, CubeCameraProps, CubeTextureProps, CubicBezierLineProps, CurveModifierProps, CurveModifierRef, CycleRaycastProps, DecalProps, DetailedProps, DetectGPUProps, DeviceOrientationControlsProps, DragControlsProps, EdgesProps, EdgesRef, EnvironmentLoaderProps, EnvironmentProps, ExampleApi, ExampleProps, ExpandedDragConfig, FboProps, FirstPersonControlsProps, FisheyeProps, FloatProps, FlyControlsProps, FontData, FrameData, GizmoHelperProps, GltfProps, Glyph, GradientTextureProps, GridMaterialType, GridProps, HelperProps, HtmlProps, HudProps, ImageProps, InstanceProps, InstancedAttributeProps, InstancesProps, KeyboardControlsEntry, KeyboardControlsProps, Ktx2Props, LightProps, LineProps, LoaderOptions, MapControlsProps, MaskProps, MergedProps, MeshDistortMaterialProps, MeshReflectorMaterialProps, MeshRefractionMaterialProps, MeshRefractionMaterialType, MeshTransmissionMaterialProps, MetaData, MotionPathProps, MotionPathRef, OnCenterCallbackProps, OnDragStartProps, OnHoverProps, OrbitControlsChangeEvent, OrbitControlsProps, OrthographicCameraProps, OutlinesProps, PerformanceMonitorApi, PerformanceMonitorProps, PerspectiveCameraProps, PivotControlsProps, PointMaterialProps, PointerLockControlsProps, PointsBuffersProps, PointsInstancesProps, PortalProps, PositionalAudioProps, PreloadProps, PresentationControlProps, PresetsType, QuadraticBezierLineProps, QuadraticBezierLineRef, RandomizedLightProps, RenderCubeTextureApi, RenderCubeTextureProps, RenderTextureProps, ResizeProps, RoundedBoxGeometryProps, RoundedBoxProps, SamplerProps, ScreenQuadProps, ScreenSizerProps, ScreenSpaceProps, ScreenVideoTextureProps, ScrollControlsProps, ScrollControlsState, ScrollProps, SegmentProps, SegmentsProps, SelectProps, ShadowProps, ShadowType, ShakeController, ShapeProps, Size, SizeProps, SkyProps, SoftShadowsProps, SparklesProps, SpotLightProps, SpriteAnimatorProps, SpriteData, StageProps, StarsProps, StatsGlProps, StatsProps, SvgProps, Text3DProps, TrackballControlsProps, TrailProps, TrailTextureProps, TransformControlsProps, TransformFn, VideoTextureProps, ViewProps, ViewportProps, WebcamVideoTextureProps, WireframeMaterialProps, WireframeMaterialType, WobbleMaterialProps, useSurfaceSamplerProps };
+export { AccumulativeShadows, AdaptiveDpr, AdaptiveEvents, ArcballControls, BBAnchor, Backdrop, BakeShadows, Billboard, Bounds, Box, CameraShake, Capsule, CatmullRomLine, Caustics, CausticsMaterial, CausticsNormalMaterial, CausticsProjectionMaterial, Center, Circle, Clone, Cloud, CloudInstance, Clouds, ComputedAttribute, Cone, ContactShadows, ConvolutionMaterial, CubeCamera, CubeTexture, CubicBezierLine, CurveModifier, CycleRaycast, Cylinder, Decal, Detailed, DetectGPU, DeviceOrientationControls, DiscardMaterial, Dodecahedron, DragControls, Edges, Environment, EnvironmentCube, EnvironmentMap, EnvironmentPortal, Example, Extrude, FakeCloudMaterial, Fbo, Fbx, FirstPersonControls, Fisheye, Float, FlyControls, GizmoHelper, GizmoViewcube, GizmoViewport, Gltf, GradientTexture, GradientType, Grid, Helper, Html, HtmlMaterial, Hud, Icosahedron, Image, Instance, InstancedAttribute, Instances, IsObject, KeyboardControls, Ktx2, Lathe, Lightformer, Line, Loader, MapControls, Mask, MatcapTexture, Merged, MeshDistortMaterial, MeshPortalMaterial, MeshReflectorMaterial, MeshReflectorMaterial$1 as MeshReflectorMaterialImpl, MeshRefractionMaterial, MeshTransmissionMaterial, MeshWobbleMaterial, MotionPathControls, NormalTexture, Octahedron, OrbitControls, OrthographicCamera, Outlines, PCSSShadowNode, PerformanceMonitor, PerspectiveCamera, PivotControls, Plane, Point, PointMaterial, PointMaterialImpl, PointerLockControls, Points, PointsBuffer, Polyhedron, PositionMesh, PositionPoint, PositionalAudio, Preload, PresentationControls, Progress, QuadraticBezierLine, RandomizedLight, RenderCubeTexture, RenderTexture, Resize, Ring, RoundedBox, RoundedBoxGeometry, Sampler, ScreenQuad, ScreenSizer, ScreenSpace, ScreenVideoTexture, Scroll, ScrollControls, Segment, SegmentObject, Segments, Select, Shadow, Shape, Sky, SoftShadows, Sparkles, SparklesMaterial, Sphere, SpotLight, SpotLightMaterial, SpriteAnimator, Stage, StarfieldMaterial, Stars, Stats, StatsGl, Svg, Tetrahedron, Text3D, Texture, Torus, TorusKnot, TrackballControls, Trail, TrailTexture, TransformControls, Tube, VideoTexture, View, WebcamVideoTexture, Wireframe, WireframeMaterial, WireframeMaterialShaders, accumulativeContext, calcPosFromAngles, checkIfFrameIsEmpty, createInstances, getFirstFrame, meshBounds, presetsObj, setBarycentricCoordinates, setWireframeOverride, useAnimations, useAspect, useBounds, useContextBridge, useCubeCamera, useCubeTexture, useCursor, useCustomRaycast, useDepthBuffer, useDetectGPU, useEnvironment, useFBO, useFBX, useFont, useGLTF, useGizmoContext, useHelper, useIntersect, useKTX2, useKeyboardControls, useMask, useMatcapTexture, useMotion, useNormalTexture, usePerformanceMonitor, useProgress, useScroll, useSelect, useSpriteAnimator, useSpriteLoader, useSurfaceSampler, useTexture, useTrail, useTrailTexture, useVariants, useVideoTexture, useWireframeUniforms };
+export type { AccumulativeShadowsProps, ArcballControlsProps, Args, BBAnchorProps, BackdropProps, BillboardProps, BoundsApi, BoundsProps, CalculatePosition, CameraShakeProps, CatmullRomLineProps, CausticsProps, CenterProps, CloneProps, CloudProps, CloudsProps, ComputedAttributeProps, ContactShadowsProps, ContainerProps, CubeCameraOptions, CubeCameraProps, CubeTextureProps, CubicBezierLineProps, CurveModifierProps, CurveModifierRef, CycleRaycastProps, DecalProps, DetailedProps, DetectGPUProps, DeviceOrientationControlsProps, DragConfig, DragControlsProps, EdgesProps, EdgesRef, EnvironmentLoaderProps, EnvironmentProps, ExampleApi, ExampleProps, FboProps, FirstPersonControlsProps, FisheyeProps, FloatProps, FlyControlsProps, FontData, FrameData, GizmoHelperProps, GltfProps, Glyph, GradientTextureProps, GridMaterialType, GridProps, HelperProps, HtmlProps, HudProps, ImageProps, InstanceProps, InstancedAttributeProps, InstancesProps, KeyboardControlsEntry, KeyboardControlsProps, Ktx2Props, LightProps, LineProps, LoaderOptions, MapControlsProps, MaskProps, MergedProps, MeshDistortMaterialProps, MeshReflectorMaterialProps, MeshRefractionMaterialProps, MeshRefractionMaterialType, MeshTransmissionMaterialProps, MetaData, MotionPathProps, MotionPathRef, OnCenterCallbackProps, OnDragProps, OnDragStartProps, OnHoverProps, OrbitControlsChangeEvent, OrbitControlsProps, OrthographicCameraProps, OutlinesProps, PCSSShadowNodeOptions, PerformanceMonitorApi, PerformanceMonitorProps, PerspectiveCameraProps, PivotControlsProps, PointMaterialProps, PointerLockControlsProps, PointsBuffersProps, PointsInstancesProps, PortalProps, PositionalAudioProps, PreloadProps, PresentationControlProps, PresetsType, QuadraticBezierLineProps, QuadraticBezierLineRef, RandomizedLightProps, RenderCubeTextureApi, RenderCubeTextureProps, RenderTextureProps, ResizeProps, RoundedBoxGeometryProps, RoundedBoxProps, SamplerProps, ScreenQuadProps, ScreenSizerProps, ScreenSpaceProps, ScreenVideoTextureProps, ScrollControlsProps, ScrollControlsState, ScrollProps, SegmentProps, SegmentsProps, SelectProps, ShadowProps, ShadowType, ShakeController, ShapeProps, Size, SizeProps, SkyProps, SoftShadowsProps, SparklesProps, SpotLightProps, SpriteAnimatorProps, SpriteData, StageProps, StarsProps, StatsGlProps, StatsOptions, StatsProps, SvgProps, Text3DProps, TrackballControlsProps, TrailProps, TrailTextureProps, TransformControlsProps, TransformFn, UseGLTFOptions, VideoTextureProps, ViewProps, ViewportProps, WebcamVideoTextureProps, WireframeMaterialProps, WireframeMaterialType, WobbleMaterialProps, useSurfaceSamplerProps };