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

package/experimental/index.d.mts

@@ -1,12 +1,12 @@
 import * as THREE from 'three';
 import { Color, MeshStandardMaterial, Texture, Matrix4, ColorRepresentation, Object3D } from 'three';
-import { MarchingCubes as MarchingCubes$1 } from 'three/examples/jsm/objects/MarchingCubes';
+import { MarchingCubes as MarchingCubes$1 } from 'three/examples/jsm/objects/MarchingCubes.js';
 import { ThreeElements, ReactThreeFiber, ThreeElement } from '@react-three/fiber';
 import * as React from 'react';
 import { ForwardRefExoticComponent, PropsWithoutRef, RefAttributes } from 'react';
-import { RenderPass } from 'three/examples/jsm/postprocessing/RenderPass';
-import { ShaderPass } from 'three/examples/jsm/postprocessing/ShaderPass';
-import { EffectComposer } from 'three/examples/jsm/postprocessing/EffectComposer';
+import { RenderPass } from 'three/examples/jsm/postprocessing/RenderPass.js';
+import { ShaderPass } from 'three/examples/jsm/postprocessing/ShaderPass.js';
+import { EffectComposer } from 'three/examples/jsm/postprocessing/EffectComposer.js';
 import { Line2 } from 'three/examples/jsm/lines/Line2.js';
 
 type ForwardRefComponent<P, T> = ForwardRefExoticComponent<PropsWithoutRef<P> & RefAttributes<T>>;
@@ -153,8 +153,8 @@ declare module '@react-three/fiber' {
     interface ThreeElements {
         portalMaterialImpl: ThreeElements['shaderMaterial'] & {
             resolution: ReactThreeFiber.Vector2;
-            blur: number;
-            blend: number;
+            blur?: number;
+            blend?: number;
             size?: number;
             sdf?: THREE.Texture;
             map?: THREE.Texture;
@@ -197,8 +197,8 @@ declare module '@react-three/fiber' {
 }
 declare class SegmentObject {
     color: THREE.Color;
-    start: THREE.Vector3;
-    end: THREE.Vector3;
+    start?: THREE.Vector3;
+    end?: THREE.Vector3;
     constructor();
 }
 

package/experimental/index.d.ts

@@ -1,12 +1,12 @@
 import * as THREE from 'three';
 import { Color, MeshStandardMaterial, Texture, Matrix4, ColorRepresentation, Object3D } from 'three';
-import { MarchingCubes as MarchingCubes$1 } from 'three/examples/jsm/objects/MarchingCubes';
+import { MarchingCubes as MarchingCubes$1 } from 'three/examples/jsm/objects/MarchingCubes.js';
 import { ThreeElements, ReactThreeFiber, ThreeElement } from '@react-three/fiber';
 import * as React from 'react';
 import { ForwardRefExoticComponent, PropsWithoutRef, RefAttributes } from 'react';
-import { RenderPass } from 'three/examples/jsm/postprocessing/RenderPass';
-import { ShaderPass } from 'three/examples/jsm/postprocessing/ShaderPass';
-import { EffectComposer } from 'three/examples/jsm/postprocessing/EffectComposer';
+import { RenderPass } from 'three/examples/jsm/postprocessing/RenderPass.js';
+import { ShaderPass } from 'three/examples/jsm/postprocessing/ShaderPass.js';
+import { EffectComposer } from 'three/examples/jsm/postprocessing/EffectComposer.js';
 import { Line2 } from 'three/examples/jsm/lines/Line2.js';
 
 type ForwardRefComponent<P, T> = ForwardRefExoticComponent<PropsWithoutRef<P> & RefAttributes<T>>;
@@ -153,8 +153,8 @@ declare module '@react-three/fiber' {
     interface ThreeElements {
         portalMaterialImpl: ThreeElements['shaderMaterial'] & {
             resolution: ReactThreeFiber.Vector2;
-            blur: number;
-            blend: number;
+            blur?: number;
+            blend?: number;
             size?: number;
             sdf?: THREE.Texture;
             map?: THREE.Texture;
@@ -197,8 +197,8 @@ declare module '@react-three/fiber' {
 }
 declare class SegmentObject {
     color: THREE.Color;
-    start: THREE.Vector3;
-    end: THREE.Vector3;
+    start?: THREE.Vector3;
+    end?: THREE.Vector3;
     constructor();
 }
 

package/experimental/index.mjs

@@ -1,9 +1,9 @@
 import * as THREE from 'three';
 import { REVISION, Object3D, Vector2, Vector3 } from 'three';
 import * as React from 'react';
-import { MarchingCubes as MarchingCubes$1 } from 'three/examples/jsm/objects/MarchingCubes';
+import { MarchingCubes as MarchingCubes$1 } from 'three/examples/jsm/objects/MarchingCubes.js';
 import { useFrame, useThree, extend, applyProps, createPortal } from '@react-three/fiber';
-import { toCreasedNormals } from 'three/examples/jsm/utils/BufferGeometryUtils';
+import { toCreasedNormals } from 'three/examples/jsm/utils/BufferGeometryUtils.js';
 import { Line2 } from 'three/examples/jsm/lines/Line2.js';
 import { LineGeometry } from 'three/examples/jsm/lines/LineGeometry.js';
 import { LineMaterial } from 'three/examples/jsm/lines/LineMaterial.js';
@@ -75,6 +75,7 @@ function shaderMaterial(uniforms, vertexShader, fragmentShader, onInit) {
         });
       }
       this.uniforms = THREE.UniformsUtils.clone(this.uniforms);
+      Object.assign(this, parameters);
     }
   };
 }

package/external/index.d.mts

@@ -8,9 +8,9 @@ import CameraControlsImpl from 'camera-controls';
 export { default as CameraControlsImpl } from 'camera-controls';
 import { FaceLandmarkerResult, FaceLandmarkerOptions, FaceLandmarker as FaceLandmarker$1 } from '@mediapipe/tasks-vision';
 import Hls from 'hls.js';
-import { RenderPass } from 'three/examples/jsm/postprocessing/RenderPass';
-import { ShaderPass } from 'three/examples/jsm/postprocessing/ShaderPass';
-import { EffectComposer } from 'three/examples/jsm/postprocessing/EffectComposer';
+import { RenderPass } from 'three/examples/jsm/postprocessing/RenderPass.js';
+import { ShaderPass } from 'three/examples/jsm/postprocessing/ShaderPass.js';
+import { EffectComposer } from 'three/examples/jsm/postprocessing/EffectComposer.js';
 import { Line2 } from 'three/examples/jsm/lines/Line2.js';
 import { LineMaterialParameters, LineMaterial } from 'three/examples/jsm/lines/LineMaterial.js';
 
@@ -209,8 +209,8 @@ declare module '@react-three/fiber' {
     interface ThreeElements {
         portalMaterialImpl: ThreeElements['shaderMaterial'] & {
             resolution: ReactThreeFiber.Vector2;
-            blur: number;
-            blend: number;
+            blur?: number;
+            blend?: number;
             size?: number;
             sdf?: THREE.Texture;
             map?: THREE.Texture;
@@ -262,8 +262,8 @@ declare module '@react-three/fiber' {
 }
 declare class SegmentObject {
     color: THREE.Color;
-    start: THREE.Vector3;
-    end: THREE.Vector3;
+    start?: THREE.Vector3;
+    end?: THREE.Vector3;
     constructor();
 }
 

package/external/index.d.ts

@@ -8,9 +8,9 @@ import CameraControlsImpl from 'camera-controls';
 export { default as CameraControlsImpl } from 'camera-controls';
 import { FaceLandmarkerResult, FaceLandmarkerOptions, FaceLandmarker as FaceLandmarker$1 } from '@mediapipe/tasks-vision';
 import Hls from 'hls.js';
-import { RenderPass } from 'three/examples/jsm/postprocessing/RenderPass';
-import { ShaderPass } from 'three/examples/jsm/postprocessing/ShaderPass';
-import { EffectComposer } from 'three/examples/jsm/postprocessing/EffectComposer';
+import { RenderPass } from 'three/examples/jsm/postprocessing/RenderPass.js';
+import { ShaderPass } from 'three/examples/jsm/postprocessing/ShaderPass.js';
+import { EffectComposer } from 'three/examples/jsm/postprocessing/EffectComposer.js';
 import { Line2 } from 'three/examples/jsm/lines/Line2.js';
 import { LineMaterialParameters, LineMaterial } from 'three/examples/jsm/lines/LineMaterial.js';
 
@@ -209,8 +209,8 @@ declare module '@react-three/fiber' {
     interface ThreeElements {
         portalMaterialImpl: ThreeElements['shaderMaterial'] & {
             resolution: ReactThreeFiber.Vector2;
-            blur: number;
-            blend: number;
+            blur?: number;
+            blend?: number;
             size?: number;
             sdf?: THREE.Texture;
             map?: THREE.Texture;
@@ -262,8 +262,8 @@ declare module '@react-three/fiber' {
 }
 declare class SegmentObject {
     color: THREE.Color;
-    start: THREE.Vector3;
-    end: THREE.Vector3;
+    start?: THREE.Vector3;
+    end?: THREE.Vector3;
     constructor();
 }
 

package/external/index.mjs

@@ -355,6 +355,7 @@ function shaderMaterial(uniforms, vertexShader, fragmentShader, onInit) {
         });
       }
       this.uniforms = THREE.UniformsUtils.clone(this.uniforms);
+      Object.assign(this, parameters);
     }
   };
 }

package/index.d.mts

@@ -3,14 +3,13 @@ import { ForwardRefExoticComponent, PropsWithoutRef, RefAttributes, CSSPropertie
 import * as _react_three_fiber from '@react-three/fiber';
 import { ThreeElements, ReactThreeFiber, ThreeElement, Vector2, Vector3, ThreeEvent, Color as Color$1, ObjectMap, ComputeFunction, Euler } from '@react-three/fiber';
 import * as THREE from 'three';
-import { MeshStandardMaterial, Texture as Texture$1, Matrix4, Color, ColorRepresentation, Object3D, Fog, FogExp2, WebGLCubeRenderTarget, CubeCamera as CubeCamera$1, OrthographicCamera as OrthographicCamera$1, PerspectiveCamera as PerspectiveCamera$1, Event, Camera, Material, 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, EventDispatcher } from 'three';
-import { RenderPass } from 'three/examples/jsm/postprocessing/RenderPass';
-import { ShaderPass } from 'three/examples/jsm/postprocessing/ShaderPass';
-import { EffectComposer } from 'three/examples/jsm/postprocessing/EffectComposer';
+import { MeshStandardMaterial, Texture as Texture$1, Matrix4, Color, ColorRepresentation, Object3D, Fog, FogExp2, WebGLCubeRenderTarget, CubeCamera as CubeCamera$1, OrthographicCamera as OrthographicCamera$1, PerspectiveCamera as PerspectiveCamera$1, Event, EventDispatcher, Camera, Material, 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 } from 'three';
+import { RenderPass } from 'three/examples/jsm/postprocessing/RenderPass.js';
+import { ShaderPass } from 'three/examples/jsm/postprocessing/ShaderPass.js';
+import { EffectComposer } from 'three/examples/jsm/postprocessing/EffectComposer.js';
 import { ArcballControls as ArcballControls$1 } from 'three/examples/jsm/controls/ArcballControls.js';
-import { DeviceOrientationControls as DeviceOrientationControls$1 } from 'three-stdlib';
 import { DragConfig } from '@use-gesture/react';
-import { FirstPersonControls as FirstPersonControls$1 } from 'three/examples/jsm/controls/FirstPersonControls';
+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';
 import { StoreApi } from 'zustand';
@@ -20,24 +19,25 @@ import { PointerLockControls as PointerLockControls$1 } from 'three/examples/jsm
 import { TrackballControls as TrackballControls$1 } from 'three/examples/jsm/controls/TrackballControls.js';
 import { Line2 } from 'three/examples/jsm/lines/Line2.js';
 import { LineMaterialParameters, LineMaterial } from 'three/examples/jsm/lines/LineMaterial.js';
-import { Flow } from 'three/examples/jsm/modifiers/CurveModifier';
-import { TextGeometry, TextGeometryParameters } from 'three/examples/jsm/geometries/TextGeometry';
-import * as three_examples_jsm_loaders_FontLoader from 'three/examples/jsm/loaders/FontLoader';
-import { TransformControls as TransformControls$1 } from 'three/examples/jsm/controls/TransformControls';
+import { Flow } from 'three/examples/jsm/modifiers/CurveModifier.js';
+import { TextGeometry, TextGeometryParameters } from 'three/examples/jsm/geometries/TextGeometry.js';
+import * as three_examples_jsm_loaders_FontLoader_js from 'three/examples/jsm/loaders/FontLoader.js';
+import { TransformControls as TransformControls$1 } from 'three/examples/jsm/controls/TransformControls.js';
 import { Falsey, Assign } from 'utility-types';
 import * as hls_js from 'hls.js';
 import hls_js__default from 'hls.js';
-import { GLTFLoader, GLTF } from 'three/examples/jsm/loaders/GLTFLoader';
+import { GLTFLoader, GLTF } from 'three/examples/jsm/loaders/GLTFLoader.js';
+import { KTX2Loader } from 'three/examples/jsm/loaders/KTX2Loader.js';
 import * as detect_gpu from 'detect-gpu';
 import { GetGPUTier } from 'detect-gpu';
 import Stats$1 from 'stats-gl';
-import { GroundedSkybox } from 'three/examples/jsm/objects/GroundedSkybox';
+import { GroundedSkybox } from 'three/examples/jsm/objects/GroundedSkybox.js';
 import { Sky as Sky$1 } from 'three/examples/jsm/objects/Sky.js';
 import { SplitStrategy } from 'three-mesh-bvh';
 import CameraControlsImpl from 'camera-controls';
 export { default as CameraControlsImpl } from 'camera-controls';
 import { FaceLandmarkerResult, FaceLandmarkerOptions, FaceLandmarker as FaceLandmarker$1 } from '@mediapipe/tasks-vision';
-import { MarchingCubes as MarchingCubes$1 } from 'three/examples/jsm/objects/MarchingCubes';
+import { MarchingCubes as MarchingCubes$1 } from 'three/examples/jsm/objects/MarchingCubes.js';
 
 type NamedArrayTuple<T extends (...args: any) => any> = Parameters<T>;
 type ForwardRefComponent<P, T> = ForwardRefExoticComponent<PropsWithoutRef<P> & RefAttributes<T>>;
@@ -195,8 +195,8 @@ declare module '@react-three/fiber' {
     interface ThreeElements {
         portalMaterialImpl: ThreeElements['shaderMaterial'] & {
             resolution: ReactThreeFiber.Vector2;
-            blur: number;
-            blend: number;
+            blur?: number;
+            blend?: number;
             size?: number;
             sdf?: THREE.Texture;
             map?: THREE.Texture;
@@ -278,8 +278,8 @@ declare module '@react-three/fiber' {
 }
 declare class SegmentObject {
     color: THREE.Color;
-    start: THREE.Vector3;
-    end: THREE.Vector3;
+    start?: THREE.Vector3;
+    end?: THREE.Vector3;
     constructor();
 }
 
@@ -349,6 +349,34 @@ type ArcballControlsProps = Omit<Overwrite<ThreeElement<typeof ArcballControls$1
 }>, 'ref' | 'args'>;
 declare const ArcballControls: ForwardRefComponent<ArcballControlsProps, ArcballControls$1>;
 
+interface StandardControlsEventMap {
+    change: {};
+    start: {};
+    end: {};
+}
+declare class DeviceOrientationControls$1 extends EventDispatcher<StandardControlsEventMap> {
+    object: Camera;
+    private changeEvent;
+    private EPS;
+    enabled: boolean;
+    deviceOrientation: Partial<DeviceOrientationEvent>;
+    screenOrientation: string | number;
+    alphaOffset: number;
+    constructor(object: Camera);
+    private onDeviceOrientationChangeEvent;
+    private onScreenOrientationChangeEvent;
+    private zee;
+    private euler;
+    private q0;
+    private q1;
+    private setObjectQuaternion;
+    connect: () => void;
+    disconnect: () => void;
+    private lastQuaternion;
+    update: () => void;
+    dispose: () => void;
+}
+
 type DeviceOrientationControlsProps = Omit<ThreeElement<typeof DeviceOrientationControls$1>, 'ref' | 'args'> & {
     camera?: THREE.Camera;
     onChange?: (e?: THREE.Event) => void;
@@ -356,6 +384,9 @@ type DeviceOrientationControlsProps = Omit<ThreeElement<typeof DeviceOrientation
 };
 declare const DeviceOrientationControls: ForwardRefComponent<DeviceOrientationControlsProps, DeviceOrientationControls$1>;
 
+type ExpandedDragConfig = DragConfig & {
+    preventOverlap?: boolean;
+};
 type DragControlsProps = {
     autoTransform?: boolean;
     matrix?: THREE.Matrix4;
@@ -366,7 +397,7 @@ type DragControlsProps = {
     onDrag?: (localMatrix: THREE.Matrix4, deltaLocalMatrix: THREE.Matrix4, worldMatrix: THREE.Matrix4, deltaWorldMatrix: THREE.Matrix4) => void;
     onDragEnd?: () => void;
     children: React.ReactNode;
-    dragConfig?: DragConfig;
+    dragConfig?: ExpandedDragConfig;
 };
 declare const DragControls: ForwardRefComponent<DragControlsProps, THREE.Group>;
 
@@ -515,6 +546,7 @@ type ScrollControlsProps = {
     maxSpeed?: number;
     prepend?: boolean;
     enabled?: boolean;
+    pixelPerfect?: boolean;
     style?: React.CSSProperties;
     children: React.ReactNode;
 };
@@ -531,9 +563,10 @@ type ScrollControlsState = {
     range(from: number, distance: number, margin?: number): number;
     curve(from: number, distance: number, margin?: number): number;
     visible(from: number, distance: number, margin?: number): boolean;
+    pixelPerfect: boolean;
 };
 declare function useScroll(): ScrollControlsState;
-declare function ScrollControls({ eps, enabled, infinite, horizontal, pages, distance, damping, maxSpeed, prepend, style, children, }: ScrollControlsProps): React.JSX.Element;
+declare function ScrollControls({ eps, enabled, infinite, horizontal, pages, distance, damping, maxSpeed, prepend, pixelPerfect, style, children, }: ScrollControlsProps): React.JSX.Element;
 interface ScrollPropsWithFalseHtml {
     children?: React.ReactNode;
     html?: false;
@@ -786,7 +819,7 @@ type FontData = {
     original_font_information?: Record<string, unknown>;
 };
 type FontInput = string | FontData;
-declare function useFont(font: FontInput): three_examples_jsm_loaders_FontLoader.Font;
+declare function useFont(font: FontInput): three_examples_jsm_loaders_FontLoader_js.Font;
 declare namespace useFont {
     var preload: (font: FontInput) => undefined;
     var clear: (font: FontInput) => void;
@@ -807,54 +840,6 @@ declare const Text3D: ForwardRefComponent<React.PropsWithChildren<Text3DProps &
     lineHeight?: number;
 }>, THREE.Mesh>;
 
-interface WireframeMaterialProps extends THREE.ShaderMaterialParameters {
-    fillOpacity?: number;
-    fillMix?: number;
-    strokeOpacity?: number;
-    thickness?: number;
-    colorBackfaces?: boolean;
-    dashInvert?: boolean;
-    dash?: boolean;
-    dashRepeats?: number;
-    dashLength?: number;
-    squeeze?: boolean;
-    squeezeMin?: number;
-    squeezeMax?: number;
-    stroke?: THREE.ColorRepresentation;
-    backfaceStroke?: THREE.ColorRepresentation;
-    fill?: THREE.ColorRepresentation;
-}
-declare const WireframeMaterial: _react_three_fiber.ConstructorRepresentation<THREE.ShaderMaterial & {
-    strokeOpacity: number;
-    fillOpacity: number;
-    fillMix: number;
-    thickness: number;
-    colorBackfaces: boolean;
-    dashInvert: boolean;
-    dash: boolean;
-    dashRepeats: number;
-    dashLength: number;
-    squeeze: boolean;
-    squeezeMin: number;
-    squeezeMax: number;
-    stroke: THREE.Color;
-    backfaceStroke: THREE.Color;
-    fill: THREE.Color;
-}> & {
-    key: string;
-};
-
-declare module '@react-three/fiber' {
-    interface ThreeElements {
-        meshWireframeMaterial: ThreeElement<typeof WireframeMaterial>;
-    }
-}
-interface WireframeProps {
-    geometry?: THREE.BufferGeometry | React.RefObject<THREE.BufferGeometry>;
-    simplify?: boolean;
-}
-declare function Wireframe({ geometry: customGeometry, ...props }: WireframeProps & WireframeMaterialProps): React.JSX.Element;
-
 type GizmoHelperContext = {
     tweenCamera: (direction: Vector3$1) => void;
 };
@@ -901,6 +886,11 @@ type OnDragStartProps = {
     origin: THREE.Vector3;
     directions: THREE.Vector3[];
 };
+type OnHoverProps = {
+    component: 'Arrow' | 'Slider' | 'Rotator' | 'Sphere';
+    axis: 0 | 1 | 2;
+    hovering: boolean;
+};
 
 type PivotControlsProps = {
     enabled?: boolean;
@@ -910,6 +900,7 @@ type PivotControlsProps = {
     offset?: [number, number, number];
     rotation?: [number, number, number];
     matrix?: THREE.Matrix4;
+    object?: THREE.Object3D | React.MutableRefObject<THREE.Object3D>;
     anchor?: [number, number, number];
     autoTransform?: boolean;
     activeAxes?: [boolean, boolean, boolean];
@@ -927,6 +918,7 @@ type PivotControlsProps = {
     onDragStart?: (props: OnDragStartProps) => void;
     onDrag?: (l: THREE.Matrix4, deltaL: THREE.Matrix4, w: THREE.Matrix4, deltaW: THREE.Matrix4) => void;
     onDragEnd?: () => void;
+    onHover?: (props: OnHoverProps) => void;
     depthTest?: boolean;
     renderOrder?: number;
     opacity?: number;
@@ -1012,6 +1004,7 @@ type InstancedAttributeProps = Omit<ThreeElements['instancedBufferAttribute'], '
     defaultValue: any;
     normalized?: boolean;
     usage?: number;
+    type?: 'float' | 'int' | 'uint' | 'short' | 'ushort' | 'byte';
 };
 type InstancedMesh = Omit<THREE.InstancedMesh, 'instanceMatrix' | 'instanceColor'> & {
     instanceMatrix: THREE.InstancedBufferAttribute;
@@ -1326,10 +1319,10 @@ declare function Fbx({ path, ...props }: {
 type Path = string | string[];
 type UseDraco = boolean | string;
 type UseMeshopt = boolean;
-type ExtendLoader = (loader: GLTFLoader) => void;
+type ExtendLoader$1 = (loader: GLTFLoader) => void;
 declare const useGLTF: {
-    <T extends Path>(path: T, useDraco?: UseDraco, useMeshopt?: UseMeshopt, extendLoader?: ExtendLoader): T extends any[] ? (GLTF & ObjectMap)[] : GLTF & ObjectMap;
-    preload(path: Path, useDraco?: UseDraco, useMeshopt?: UseMeshopt, extendLoader?: ExtendLoader): void;
+    <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;
 };
@@ -1337,22 +1330,26 @@ type GltfProps = Omit<CloneProps, 'object'> & {
     src: string;
     useDraco?: UseDraco;
     useMeshOpt?: UseMeshopt;
-    extendLoader?: ExtendLoader;
+    extendLoader?: ExtendLoader$1;
 };
 declare const Gltf: React.ForwardRefExoticComponent<Omit<GltfProps, "ref"> & React.RefAttributes<THREE.Group<THREE.Object3DEventMap>>>;
 
-declare function useKTX2<Url extends string[] | string | Record<string, string>>(input: Url, basisPath?: string): Url extends any[] ? Texture$1[] : Url extends object ? {
+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?: string) => void;
+    var preload: (url: string extends any[] ? string[] : string, basisPath?: boolean | string, extendLoader?: ExtendLoader) => void;
     var clear: (input: string | string[]) => void;
+    var setTranscoderPath: (path: string) => void;
 }
-declare const Ktx2: ({ children, input, basisPath, }: {
+type Ktx2Props = {
     children?: (texture: ReturnType<typeof useKTX2>) => React.ReactNode;
     input: Parameters<typeof useKTX2>[0];
     basisPath?: Parameters<typeof useKTX2>[1];
-}) => React.JSX.Element;
+    extendLoader?: ExtendLoader;
+};
+declare const Ktx2: ({ children, input, basisPath, extendLoader }: Ktx2Props) => React.JSX.Element;
 
 type Data = {
     errors: string[];
@@ -1688,7 +1685,7 @@ type EnvironmentLoaderProps = {
     extensions?: (loader: Loader$1) => void;
     colorSpace?: ColorSpace;
 };
-declare function useEnvironment({ files, path, preset, colorSpace, extensions, }?: Partial<EnvironmentLoaderProps>): CubeTexture$1<unknown> | Texture$1<unknown>;
+declare function useEnvironment({ files, path, preset, colorSpace, extensions, }?: Partial<EnvironmentLoaderProps>): Texture$1<unknown> | CubeTexture$1<unknown>;
 declare namespace useEnvironment {
     var preload: (preloadOptions?: EnvironmentLoaderPreloadOptions) => void;
     var clear: (clearOptions?: EnvironmentLoaderClearOptions) => void;
@@ -1864,6 +1861,7 @@ interface HtmlProps extends Omit<Assign<React.HTMLAttributes<HTMLDivElement>, Th
     geometry?: React.ReactNode;
     castShadow?: boolean;
     receiveShadow?: boolean;
+    pixelPerfect?: boolean;
 }
 declare const Html: ForwardRefComponent<HtmlProps, HTMLDivElement>;
 
@@ -2162,5 +2160,5 @@ type MarchingPlaneProps = {
 } & ThreeElements['group'];
 declare const MarchingPlane: ForwardRefComponent<MarchingPlaneProps, THREE.Group>;
 
-export { AdaptiveDpr, AdaptiveEvents, ArcballControls, BBAnchor, Backdrop, Billboard, Bounds, Box, Bvh, CameraControls, CameraShake, Capsule, CatmullRomLine, Center, Circle, Clone, Cloud, CloudInstance, Clouds, ComputedAttribute, Cone, CubeCamera, CubeTexture, CubicBezierLine, CurveModifier, CycleRaycast, Cylinder, Decal, Detailed, DetectGPU, DeviceOrientationControls, Dodecahedron, DragControls, Edges, Environment, EnvironmentCube, EnvironmentMap, EnvironmentPortal, Example, Extrude, FaceControls, FaceLandmarker, FaceLandmarkerDefaults, Facemesh, FacemeshDatas, FacemeshEye, FacemeshEyeDefaults, Fbo, Fbx, FirstPersonControls, Fisheye, Float, FlyControls, GizmoHelper, GizmoViewcube, GizmoViewport, Gltf, Helper, Html, Hud, Icosahedron, Instance, InstancedAttribute, Instances, IsObject, KeyboardControls, Ktx2, Lathe, Lightformer, Loader, MapControls, MarchingCube, MarchingCubes, MarchingPlane, Mask, MatcapTexture, Merged, MotionPathControls, NormalTexture, Octahedron, OrbitControls, OrthographicCamera, Outlines, PerformanceMonitor, PerspectiveCamera, PivotControls, Plane, Point, PointMaterial, PointMaterialImpl, PointerLockControls, Points, PointsBuffer, Polyhedron, PositionMesh, PositionPoint, PositionalAudio, Preload, PresentationControls, Progress, QuadraticBezierLine, RenderCubeTexture, RenderTexture, Resize, Ring, RoundedBox, RoundedBoxGeometry, Sampler, ScreenQuad, ScreenSizer, ScreenSpace, ScreenVideoTexture, Scroll, ScrollControls, Select, Shadow, Shape, Sky, Sphere, Splat, SpriteAnimator, Stage, Stats, StatsGl, Svg, Tetrahedron, Text3D, Texture, Torus, TorusKnot, TrackballControls, Trail, TrailTexture, TransformControls, Tube, VideoTexture, View, WebcamVideoTexture, Wireframe, calcPosFromAngles, checkIfFrameIsEmpty, createInstances, getFirstFrame, meshBounds, presetsObj, useAnimations, useAspect, useBVH, useBounds, useContextBridge, useCubeCamera, useCubeTexture, useCursor, useCustomRaycast, useDepthBuffer, useDetectGPU, useEnvironment, useFBO, useFBX, useFaceControls, useFaceLandmarker, useFont, useGLTF, useGizmoContext, useHelper, useIntersect, useKTX2, useKeyboardControls, useMask, useMatcapTexture, useMotion, useNormalTexture, usePerformanceMonitor, useProgress, useScroll, useSelect, useSpriteAnimator, useSpriteLoader, useSurfaceSampler, useTexture, useTrail, useTrailTexture, useVideoTexture };
-export type { ArcballControlsProps, Args, BBAnchorProps, BVHOptions, BackdropProps, BillboardProps, BoundsApi, BoundsProps, BvhProps, CalculatePosition, CameraControlsProps, CameraShakeProps, CatmullRomLineProps, CenterProps, CloneProps, CloudProps, CloudsProps, ComputedAttributeProps, ContainerProps, CubeCameraOptions, CubeCameraProps, CubeTextureProps, CubicBezierLineProps, CurveModifierProps, CurveModifierRef, CycleRaycastProps, DecalProps, DetailedProps, DetectGPUProps, DeviceOrientationControlsProps, DragControlsProps, EdgesProps, EnvironmentLoaderProps, EnvironmentProps, ExampleApi, ExampleProps, FaceControlsApi, FaceControlsProps, FaceLandmarkerProps, FacemeshApi, FacemeshEyeApi, FacemeshEyeProps, FacemeshProps, FboProps, FirstPersonControlsProps, FisheyeProps, FloatProps, FlyControlsProps, FontData, FrameData, GizmoHelperProps, GltfProps, Glyph, HelperProps, HtmlProps, HudProps, InstanceProps, InstancedAttributeProps, InstancesProps, KeyboardControlsEntry, KeyboardControlsProps, LightProps, LoaderOptions, MapControlsProps, MarchingCubeProps, MarchingCubesProps, MarchingPlaneProps, MaskProps, MediaPipeFaceMesh, MediaPipePoints, MergedProps, MetaData, MotionPathProps, MotionPathRef, OnCenterCallbackProps, OrbitControlsChangeEvent, OrbitControlsProps, OrthographicCameraProps, OutlinesProps, PerformanceMonitorApi, PerformanceMonitorProps, PerspectiveCameraProps, PivotControlsProps, PointMaterialProps, PointerLockControlsProps, PointsBuffersProps, PointsInstancesProps, PositionalAudioProps, PreloadProps, PresentationControlProps, PresetsType, QuadraticBezierLineProps, QuadraticBezierLineRef, RenderCubeTextureApi, RenderCubeTextureProps, RenderTextureProps, ResizeProps, RoundedBoxGeometryProps, RoundedBoxProps, SamplerProps, ScreenQuadProps, ScreenSizerProps, ScreenSpaceProps, ScreenVideoTextureProps, ScrollControlsProps, ScrollControlsState, ScrollProps, SelectProps, ShadowProps, ShadowType, ShakeController, ShapeProps, SharedState, Size, SizeProps, SkyProps, SplatMaterialType, SplatProps, SpriteAnimatorProps, SpriteData, StageProps, StatsGlProps, StatsProps, SvgProps, TargetMesh, Text3DProps, TrackballControlsProps, TrailProps, TrailTextureProps, TransformControlsProps, TransformFn, VideoTextureProps, ViewProps, ViewportProps, WebcamVideoTextureProps, useSurfaceSamplerProps };
+export { AdaptiveDpr, AdaptiveEvents, ArcballControls, BBAnchor, Backdrop, Billboard, Bounds, Box, Bvh, CameraControls, CameraShake, Capsule, CatmullRomLine, Center, Circle, Clone, Cloud, CloudInstance, Clouds, ComputedAttribute, Cone, CubeCamera, CubeTexture, CubicBezierLine, CurveModifier, CycleRaycast, Cylinder, Decal, Detailed, DetectGPU, DeviceOrientationControls, Dodecahedron, DragControls, Edges, Environment, EnvironmentCube, EnvironmentMap, EnvironmentPortal, Example, Extrude, FaceControls, FaceLandmarker, FaceLandmarkerDefaults, Facemesh, FacemeshDatas, FacemeshEye, FacemeshEyeDefaults, Fbo, Fbx, FirstPersonControls, Fisheye, Float, FlyControls, GizmoHelper, GizmoViewcube, GizmoViewport, Gltf, Helper, Html, Hud, Icosahedron, Instance, InstancedAttribute, Instances, IsObject, KeyboardControls, Ktx2, Lathe, Lightformer, Loader, MapControls, MarchingCube, MarchingCubes, MarchingPlane, Mask, MatcapTexture, Merged, MotionPathControls, NormalTexture, Octahedron, OrbitControls, OrthographicCamera, Outlines, PerformanceMonitor, PerspectiveCamera, PivotControls, Plane, Point, PointMaterial, PointMaterialImpl, PointerLockControls, Points, PointsBuffer, Polyhedron, PositionMesh, PositionPoint, PositionalAudio, Preload, PresentationControls, Progress, QuadraticBezierLine, RenderCubeTexture, RenderTexture, Resize, Ring, RoundedBox, RoundedBoxGeometry, Sampler, ScreenQuad, ScreenSizer, ScreenSpace, ScreenVideoTexture, Scroll, ScrollControls, Select, Shadow, Shape, Sky, Sphere, Splat, SpriteAnimator, Stage, Stats, StatsGl, Svg, Tetrahedron, Text3D, Texture, Torus, TorusKnot, TrackballControls, Trail, TrailTexture, TransformControls, Tube, VideoTexture, View, WebcamVideoTexture, calcPosFromAngles, checkIfFrameIsEmpty, createInstances, getFirstFrame, meshBounds, presetsObj, useAnimations, useAspect, useBVH, useBounds, useContextBridge, useCubeCamera, useCubeTexture, useCursor, useCustomRaycast, useDepthBuffer, useDetectGPU, useEnvironment, useFBO, useFBX, useFaceControls, useFaceLandmarker, useFont, useGLTF, useGizmoContext, useHelper, useIntersect, useKTX2, useKeyboardControls, useMask, useMatcapTexture, useMotion, useNormalTexture, usePerformanceMonitor, useProgress, useScroll, useSelect, useSpriteAnimator, useSpriteLoader, useSurfaceSampler, useTexture, useTrail, useTrailTexture, useVideoTexture };
+export type { ArcballControlsProps, Args, BBAnchorProps, BVHOptions, BackdropProps, BillboardProps, BoundsApi, BoundsProps, BvhProps, CalculatePosition, CameraControlsProps, CameraShakeProps, CatmullRomLineProps, CenterProps, CloneProps, CloudProps, CloudsProps, ComputedAttributeProps, ContainerProps, CubeCameraOptions, CubeCameraProps, CubeTextureProps, CubicBezierLineProps, CurveModifierProps, CurveModifierRef, CycleRaycastProps, DecalProps, DetailedProps, DetectGPUProps, DeviceOrientationControlsProps, DragControlsProps, EdgesProps, EdgesRef, EnvironmentLoaderProps, EnvironmentProps, ExampleApi, ExampleProps, ExpandedDragConfig, FaceControlsApi, FaceControlsProps, FaceLandmarkerProps, FacemeshApi, FacemeshEyeApi, FacemeshEyeProps, FacemeshProps, FboProps, FirstPersonControlsProps, FisheyeProps, FloatProps, FlyControlsProps, FontData, FrameData, GizmoHelperProps, GltfProps, Glyph, HelperProps, HtmlProps, HudProps, InstanceProps, InstancedAttributeProps, InstancesProps, KeyboardControlsEntry, KeyboardControlsProps, Ktx2Props, LightProps, LoaderOptions, MapControlsProps, MarchingCubeProps, MarchingCubesProps, MarchingPlaneProps, MaskProps, MediaPipeFaceMesh, MediaPipePoints, MergedProps, MetaData, MotionPathProps, MotionPathRef, OnCenterCallbackProps, OnDragStartProps, OnHoverProps, OrbitControlsChangeEvent, OrbitControlsProps, OrthographicCameraProps, OutlinesProps, PerformanceMonitorApi, PerformanceMonitorProps, PerspectiveCameraProps, PivotControlsProps, PointMaterialProps, PointerLockControlsProps, PointsBuffersProps, PointsInstancesProps, PositionalAudioProps, PreloadProps, PresentationControlProps, PresetsType, QuadraticBezierLineProps, QuadraticBezierLineRef, RenderCubeTextureApi, RenderCubeTextureProps, RenderTextureProps, ResizeProps, RoundedBoxGeometryProps, RoundedBoxProps, SamplerProps, ScreenQuadProps, ScreenSizerProps, ScreenSpaceProps, ScreenVideoTextureProps, ScrollControlsProps, ScrollControlsState, ScrollProps, SelectProps, ShadowProps, ShadowType, ShakeController, ShapeProps, SharedState, Size, SizeProps, SkyProps, SplatMaterialType, SplatProps, SpriteAnimatorProps, SpriteData, StageProps, StatsGlProps, StatsProps, SvgProps, TargetMesh, Text3DProps, TrackballControlsProps, TrailProps, TrailTextureProps, TransformControlsProps, TransformFn, VideoTextureProps, ViewProps, ViewportProps, WebcamVideoTextureProps, useSurfaceSamplerProps };