@types/three 0.179.0 → 0.180.0

three/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for three (https://threejs.org/).
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/three.
 
 ### Additional Details
- * Last updated: Mon, 04 Aug 2025 15:38:34 GMT
+ * Last updated: Wed, 03 Sep 2025 18:38:35 GMT
  * Dependencies: [@dimforge/rapier3d-compat](https://npmjs.com/package/@dimforge/rapier3d-compat), [@tweenjs/tween.js](https://npmjs.com/package/@tweenjs/tween.js), [@types/stats.js](https://npmjs.com/package/@types/stats.js), [@types/webxr](https://npmjs.com/package/@types/webxr), [@webgpu/types](https://npmjs.com/package/@webgpu/types), [fflate](https://npmjs.com/package/fflate), [meshoptimizer](https://npmjs.com/package/meshoptimizer)
 
 # Credits

three/examples/jsm/Addons.d.ts

@@ -89,6 +89,7 @@ export * from "./loaders/FontLoader.js";
 export * from "./loaders/GCodeLoader.js";
 export * from "./loaders/GLTFLoader.js";
 export * from "./loaders/HDRCubeTextureLoader.js";
+export * from "./loaders/HDRLoader.js";
 export * from "./loaders/IESLoader.js";
 export * from "./loaders/KMZLoader.js";
 export * from "./loaders/KTX2Loader.js";
@@ -108,7 +109,6 @@ export * from "./loaders/PDBLoader.js";
 export * from "./loaders/PLYLoader.js";
 export * from "./loaders/PVRLoader.js";
 export * from "./loaders/RGBELoader.js";
-export * from "./loaders/RGBMLoader.js";
 export * from "./loaders/STLLoader.js";
 export * from "./loaders/SVGLoader.js";
 export * from "./loaders/TDSLoader.js";

three/examples/jsm/controls/DragControls.d.ts

@@ -76,36 +76,6 @@ declare class DragControls extends Controls<DragControlsEventMap> {
      * @param domElement The HTML element used for event listeners. (optional)
      */
     constructor(objects: Object3D[], camera: Camera, domElement?: HTMLElement | null);
-
-    /**
-     * Returns the internal {@link Raycaster} instance that is used for intersection tests.
-     * @deprecated getRaycaster() has been deprecated. Use controls.raycaster instead.
-     */
-    getRaycaster(): Raycaster;
-
-    /**
-     * Sets an array of draggable objects by overwriting the existing one.
-     * @deprecated setObjects() has been deprecated. Use controls.objects instead.
-     */
-    setObjects(objects: readonly Object3D[]): void;
-
-    /**
-     * Returns the array of draggable objects.
-     * @deprecated getObjects() has been deprecated. Use controls.objects instead.
-     */
-    getObjects(): Object3D[];
-
-    /**
-     * Adds the event listeners of the controls.
-     * @deprecated activate() has been renamed to connect().
-     */
-    activate(): void;
-
-    /**
-     * Removes the event listeners of the controls.
-     * @deprecated deactivate() has been renamed to disconnect().
-     */
-    deactivate(): void;
 }
 
 export { DragControls };

three/examples/jsm/controls/PointerLockControls.d.ts

@@ -49,11 +49,6 @@ declare class PointerLockControls extends Controls<PointerLockControlsEventMap>
      */
     constructor(camera: Camera, domElement?: HTMLElement | null);
 
-    /**
-     * @deprecated getObject() has been deprecated. Use controls.object instead.
-     */
-    getObject(): Camera;
-
     /**
      * Returns the look direction of the camera.
      * @param v The target vector.

three/examples/jsm/exporters/DRACOExporter.d.ts

@@ -13,5 +13,5 @@ export interface DRACOExporterOptions {
 export class DRACOExporter {
     constructor();
 
-    parse(object: Mesh | Points, options?: DRACOExporterOptions): Int8Array;
+    parse(object: Mesh | Points, options?: DRACOExporterOptions): Int8Array<ArrayBuffer>;
 }

three/examples/jsm/exporters/EXRExporter.d.ts

@@ -22,6 +22,6 @@ export class EXRExporter {
         renderer: WebGLRenderer | WebGPURenderer,
         renderTarget: WebGLRenderTarget,
         options?: EXRExporterParseOptions,
-    ): Promise<Uint8Array>;
-    parse(dataTexture: DataTexture, options?: EXRExporterParseOptions): Promise<Uint8Array>;
+    ): Promise<Uint8Array<ArrayBuffer>>;
+    parse(dataTexture: DataTexture, options?: EXRExporterParseOptions): Promise<Uint8Array<ArrayBuffer>>;
 }

three/examples/jsm/exporters/KTX2Exporter.d.ts

@@ -2,6 +2,6 @@ import { Data3DTexture, DataTexture, WebGLRenderer, WebGLRenderTarget } from "th
 import { WebGPURenderer } from "three/webgpu";
 
 export class KTX2Exporter {
-    parse(renderer: WebGLRenderer | WebGPURenderer, rtt?: WebGLRenderTarget): Promise<Uint8Array>;
-    parse(texture: Data3DTexture | DataTexture): Promise<Uint8Array>;
+    parse(renderer: WebGLRenderer | WebGPURenderer, rtt?: WebGLRenderTarget): Promise<Uint8Array<ArrayBuffer>>;
+    parse(texture: Data3DTexture | DataTexture): Promise<Uint8Array<ArrayBuffer>>;
 }

three/examples/jsm/exporters/STLExporter.d.ts

@@ -15,7 +15,7 @@ export interface STLExporterOptions {
 export class STLExporter {
     constructor();
 
-    parse(scene: Object3D, options: STLExporterOptionsBinary): DataView;
+    parse(scene: Object3D, options: STLExporterOptionsBinary): DataView<ArrayBuffer>;
     parse(scene: Object3D, options?: STLExporterOptionsString): string;
-    parse(scene: Object3D, options?: STLExporterOptions): string | DataView;
+    parse(scene: Object3D, options?: STLExporterOptions): string | DataView<ArrayBuffer>;
 }

three/examples/jsm/exporters/USDZExporter.d.ts

@@ -17,10 +17,10 @@ export class USDZExporter {
 
     parse(
         scene: Object3D,
-        onDone: (result: Uint8Array) => void,
+        onDone: (result: Uint8Array<ArrayBuffer>) => void,
         onError: (error: unknown) => void,
         options?: USDZExporterOptions,
     ): void;
 
-    parseAsync(scene: Object3D, options?: USDZExporterOptions): Promise<Uint8Array>;
+    parseAsync(scene: Object3D, options?: USDZExporterOptions): Promise<Uint8Array<ArrayBuffer>>;
 }

three/examples/jsm/loaders/HDRCubeTextureLoader.d.ts

@@ -1,10 +1,10 @@
 import { CubeTexture, Loader, LoadingManager, TextureDataType } from "three";
 
-import { RGBELoader } from "./RGBELoader.js";
+import { HDRLoader } from "./HDRLoader.js";
 
 export class HDRCubeTextureLoader extends Loader<CubeTexture, readonly string[]> {
     constructor(manager?: LoadingManager);
-    hdrLoader: RGBELoader;
+    hdrLoader: HDRLoader;
     type: TextureDataType;
 
     load(

three/examples/jsm/loaders/HDRLoader.d.ts

@@ -0,0 +1,22 @@
+import { DataTextureLoader, LoadingManager, TextureDataType } from "three";
+
+export interface HDR {
+    width: number;
+    height: number;
+    data: Float32Array | Uint8Array;
+    header: string;
+    gamma: number;
+    exposure: number;
+    type: TextureDataType;
+}
+
+declare class HDRLoader extends DataTextureLoader {
+    type: TextureDataType;
+
+    constructor(manager?: LoadingManager);
+
+    parse(buffer: ArrayBuffer): HDR;
+    setDataType(type: TextureDataType): this;
+}
+
+export { HDRLoader };

three/examples/jsm/loaders/LDrawLoader.d.ts

@@ -10,17 +10,21 @@ export class LDrawLoader extends Loader<Group> {
 
     smoothNormals: boolean;
 
+    partsLibraryPath: string;
+
     ConditionalLineMaterial: typeof LDrawConditionalLineMaterial | typeof LDrawConditionalLineNodeMaterial | null;
 
     constructor(manager?: LoadingManager);
 
+    setPartsLibraryPath(path: string): this;
+
     setConditionalLineMaterial(
         type: typeof LDrawConditionalLineMaterial | typeof LDrawConditionalLineNodeMaterial,
     ): this;
 
     preloadMaterials(url: string): Promise<void>;
 
-    parse(text: string, path: string, onLoad: (data: Group) => void, onError?: (error: unknown) => void): void;
+    parse(text: string, onLoad: (data: Group) => void, onError?: (error: unknown) => void): void;
 
     setMaterials(materials: Material[]): this;
     clearMaterials(): this;

three/examples/jsm/loaders/RGBELoader.d.ts

@@ -1,19 +1,13 @@
-import { DataTextureLoader, LoadingManager, PixelFormat, TextureDataType } from "three";
+import { HDR, HDRLoader } from "./HDRLoader.js";
 
-export interface RGBE {
-    width: number;
-    height: number;
-    data: Float32Array | Uint8Array;
-    header: string;
-    gamma: number;
-    exposure: number;
-    type: TextureDataType;
+/**
+ * @deprecated RGBELoader has been deprecated. Please use HDRLoader instead.
+ */
+export interface RGBE extends HDR {
 }
 
-export class RGBELoader extends DataTextureLoader {
-    constructor(manager?: LoadingManager);
-    type: TextureDataType;
-
-    parse(buffer: ArrayBuffer): RGBE;
-    setDataType(type: TextureDataType): this;
+/**
+ * @deprecated RGBELoader has been deprecated. Please use HDRLoader instead.
+ */
+export class RGBELoader extends HDRLoader {
 }

three/examples/jsm/materials/WoodNodeMaterial.d.ts

@@ -0,0 +1,75 @@
+import * as THREE from "three";
+
+export type WoodGenus =
+    | "teak"
+    | "walnut"
+    | "white_oak"
+    | "pine"
+    | "poplar"
+    | "maple"
+    | "red_oak"
+    | "cherry"
+    | "cedar"
+    | "mahogany";
+export type WoodFinish = "raw" | "matte" | "semigloss" | "gloss";
+
+export const WoodGenuses: WoodGenus[];
+export const Finishes: WoodFinish[];
+
+export interface WoodParameters {
+    transformationMatrix: THREE.Matrix4;
+    centerSize: number;
+    largeWarpScale: number;
+    largeGrainStretch: number;
+    smallWarpStrength: number;
+    smallWarpScale: number;
+    fineWarpStrength: number;
+    fineWarpScale: number;
+    ringThickness: number;
+    ringBias: number;
+    ringSizeVariance: number;
+    ringVarianceScale: number;
+    barkThickness: number;
+    splotchScale: number;
+    splotchIntensity: number;
+    cellScale: number;
+    cellSize: number;
+    darkGrainColor: string | THREE.Color;
+    lightGrainColor: string | THREE.Color;
+    genus: WoodGenus;
+    finish: WoodFinish;
+    clearcoat: number;
+    clearcoatRoughness: number;
+    clearcoatDarken: number;
+}
+
+export function GetWoodPreset(genus: WoodGenus, finish: WoodFinish): WoodParameters;
+
+export class WoodNodeMaterial extends THREE.MeshPhysicalMaterial {
+    readonly isWoodNodeMaterial: true;
+
+    transformationMatrix: THREE.Matrix4;
+    centerSize: number;
+    largeWarpScale: number;
+    largeGrainStretch: number;
+    smallWarpStrength: number;
+    smallWarpScale: number;
+    fineWarpStrength: number;
+    fineWarpScale: number;
+    ringThickness: number;
+    ringBias: number;
+    ringSizeVariance: number;
+    ringVarianceScale: number;
+    barkThickness: number;
+    splotchScale: number;
+    splotchIntensity: number;
+    cellScale: number;
+    cellSize: number;
+    darkGrainColor: THREE.Color;
+    lightGrainColor: THREE.Color;
+    clearcoatDarken: number;
+
+    constructor(params?: Partial<WoodParameters>);
+
+    static fromPreset(genus?: WoodGenus, finish?: WoodFinish): WoodNodeMaterial;
+}

three/examples/jsm/math/ColorSpaces.d.ts

@@ -9,3 +9,7 @@ export const LinearDisplayP3ColorSpaceImpl: ColorSpaceDefinition;
 export const LinearRec2020ColorSpace: "rec2020-linear";
 
 export const LinearRec2020ColorSpaceImpl: ColorSpaceDefinition;
+
+export const ExtendedSRGBColorSpace: "extended-srgb";
+
+export const ExtendedSRGBColorSpaceImpl: ColorSpaceDefinition;

three/examples/jsm/postprocessing/SSRPass.d.ts

@@ -1,8 +1,6 @@
 import {
     Camera,
     Color,
-    ColorRepresentation,
-    Material,
     Mesh,
     MeshBasicMaterial,
     MeshNormalMaterial,
@@ -12,7 +10,7 @@ import {
     WebGLRenderTarget,
 } from "three";
 import { ReflectorForSSRPass } from "../objects/ReflectorForSSRPass.js";
-import { FullScreenQuad, Pass } from "../postprocessing/Pass.js";
+import { FullScreenQuad, Pass } from "./Pass.js";
 
 export interface SSRPassParams {
     renderer: WebGLRenderer;
@@ -26,7 +24,7 @@ export interface SSRPassParams {
     groundReflector: ReflectorForSSRPass | null;
 }
 
-export class SSRPass extends Pass {
+declare class SSRPass extends Pass {
     width: number;
     height: number;
     clear: boolean;
@@ -94,29 +92,8 @@ export class SSRPass extends Pass {
 
     constructor(params: SSRPassParams);
 
-    dispose: () => void;
-
-    renderPass: (
-        renderer: WebGLRenderer,
-        passMaterial: Material,
-        renderTarget: WebGLRenderTarget,
-        clearColor: ColorRepresentation,
-        clearAlpha: ColorRepresentation,
-    ) => void;
-
-    renderOverride: (
-        renderer: WebGLRenderer,
-        passMaterial: Material,
-        renderTarget: WebGLRenderTarget,
-        clearColor: ColorRepresentation,
-        clearAlpha: ColorRepresentation,
-    ) => void;
-
-    renderMetalness: (
-        renderer: WebGLRenderer,
-        passMaterial: Material,
-        renderTarget: WebGLRenderTarget,
-        clearColor: ColorRepresentation,
-        clearAlpha: ColorRepresentation,
-    ) => void;
+    get resolutionScale(): number;
+    set resolutionScale(value: number);
 }
+
+export { SSRPass };

three/examples/jsm/tsl/display/AnamorphicNode.d.ts

@@ -6,13 +6,22 @@ export default class AnamorphicNode extends TempNode {
     thresholdNode: Node;
     scaleNode: Node;
     samples: number;
-    resolution: Vector2;
+    resolutionScale: number;
 
     constructor(textureNode: Node, thresholdNode: Node, scaleNode: Node, samples: number);
 
     getTextureNode(): Node;
 
     setSize(width: number, height: number): void;
+
+    /**
+     * @deprecated The "resolution" property has been renamed to "resolutionScale" and is now of type `number`.
+     */
+    get resolution(): Vector2;
+    /**
+     * @deprecated The "resolution" property has been renamed to "resolutionScale" and is now of type `number`.
+     */
+    set resolution(value: Vector2);
 }
 
 export const anamorphic: (

three/examples/jsm/tsl/display/DepthOfFieldNode.d.ts

@@ -1,15 +1,21 @@
 import { ShaderNodeObject } from "three/tsl";
-import { Node, TempNode, TextureNode, UniformNode } from "three/webgpu";
+import { Node, TempNode, TextureNode } from "three/webgpu";
 
 declare class DepthOfFieldNode extends TempNode {
     textureNode: TextureNode;
     viewZNode: Node;
 
-    focus: UniformNode<number>;
-    aperture: UniformNode<number>;
-    maxblur: UniformNode<number>;
+    focusDistanceNode: Node;
+    focalLengthNode: Node;
+    bokehScaleNode: Node;
 
-    constructor(textureNode: TextureNode, viewZNode: Node, focusNode: Node, apertureNode: Node, maxblurNode: Node);
+    constructor(
+        textureNode: TextureNode,
+        viewZNode: Node,
+        focusDistanceNode: Node,
+        focalLengthNode: Node,
+        bokehScaleNode: Node,
+    );
 }
 
 export default DepthOfFieldNode;
@@ -17,7 +23,7 @@ export default DepthOfFieldNode;
 export const dof: (
     node: Node,
     viewZNode: Node,
-    focus?: Node,
-    aperture?: Node,
-    maxblur?: Node,
+    focusDistance?: Node | number,
+    focalLength?: Node | number,
+    bokehScale?: Node | number,
 ) => ShaderNodeObject<DepthOfFieldNode>;

three/examples/jsm/tsl/display/GaussianBlurNode.d.ts

@@ -1,24 +1,39 @@
 import { ShaderNodeObject } from "three/tsl";
 import { Node, TempNode, TextureNode, Vector2 } from "three/webgpu";
 
+export interface GaussianBlurNodeOptions {
+    premultipliedAlpha?: boolean | undefined;
+    resolution?: Vector2 | undefined;
+}
+
 declare class GaussianBlurNode extends TempNode {
     textureNode: TextureNode;
     directionNode: Node | null;
     sigma: number;
 
-    resolution: Vector2;
+    resolutionScale: number;
 
     premultipliedAlpha: boolean;
 
-    constructor(textureNode: TextureNode, directionNode?: Node | null, sigma?: number);
-
-    setPremultipliedAlpha(value: boolean): this;
-
-    getPremultipliedAlpha(): boolean;
+    constructor(
+        textureNode: TextureNode,
+        directionNode?: Node | null,
+        sigma?: number,
+        options?: GaussianBlurNodeOptions,
+    );
 
     setSize(width: number, height: number): void;
 
     getTextureNode(): TextureNode;
+
+    /**
+     * @deprecated The "resolution" property has been renamed to "resolutionScale" and is now of type `number`.
+     */
+    get resolution(): Vector2;
+    /**
+     * @deprecated The "resolution" property has been renamed to "resolutionScale" and is now of type `number`.
+     */
+    set resolution(value: Vector2);
 }
 
 export default GaussianBlurNode;
@@ -27,7 +42,12 @@ export const gaussianBlur: (
     node: Node,
     directionNode?: Node | number | null,
     sigma?: number,
+    options?: GaussianBlurNodeOptions,
 ) => ShaderNodeObject<GaussianBlurNode>;
+
+/**
+ * @deprecated "premultipliedGaussianBlur()" is deprecated. Use "gaussianBlur()" with "premultipliedAlpha: true" option instead.
+ */
 export const premultipliedGaussianBlur: (
     node: Node,
     directionNode?: Node | number | null,

three/examples/jsm/tsl/display/SSRNode.d.ts

@@ -6,20 +6,24 @@ declare class SSRNode extends TempNode {
     depthNode: ShaderNodeObject<Node>;
     normalNode: ShaderNodeObject<Node>;
     metalnessNode: ShaderNodeObject<Node>;
-    camera: Camera;
+    roughnessNode: ShaderNodeObject<Node> | null;
+    camera: Camera | null;
 
     resolutionScale: number;
 
     maxDistance: UniformNode<number>;
     thickness: UniformNode<number>;
     opacity: UniformNode<number>;
+    quality: UniformNode<number>;
+    blurQuality: UniformNode<number>;
 
     constructor(
         colorNode: ShaderNodeObject<Node>,
         depthNode: ShaderNodeObject<Node>,
         normalNode: ShaderNodeObject<Node>,
         metalnessNode: ShaderNodeObject<Node>,
-        camera: Camera,
+        roughnessNode?: ShaderNodeObject<Node> | null,
+        camera?: Camera | null,
     );
 
     getTextureNode(): ShaderNodeObject<TextureNode>;
@@ -34,5 +38,6 @@ export const ssr: (
     depthNode: Node,
     normalNode: Node,
     metalnessNode: Node,
-    camera: Camera,
+    roughnessNode?: Node | null,
+    camera?: Camera | null,
 ) => ShaderNodeObject<SSRNode>;

three/examples/jsm/tsl/display/boxBlur.d.ts

@@ -0,0 +1,11 @@
+import { ShaderNodeObject } from "three/tsl";
+import { Node } from "three/webgpu";
+
+export interface BoxBlurOptions {
+    size?: Node | undefined;
+    separation?: Node | undefined;
+    mask?: Node | null | undefined;
+    premultipliedAlpha?: boolean | undefined;
+}
+
+export const boxBlur: (textureNode: Node, options?: BoxBlurOptions) => ShaderNodeObject<Node>;

three/examples/jsm/tsl/display/hashBlur.d.ts

@@ -2,7 +2,7 @@ import { ShaderNodeObject } from "three/tsl";
 import { Node } from "three/webgpu";
 
 interface HashBlurOptions {
-    repeats?: Node | undefined;
+    size?: Node | undefined;
     mask?: Node | null | undefined;
     premultipliedAlpha?: boolean | undefined;
 }

three/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/three",
-    "version": "0.179.0",
+    "version": "0.180.0",
     "description": "TypeScript definitions for three",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/three",
     "license": "MIT",
@@ -49,6 +49,6 @@
         "meshoptimizer": "~0.22.0"
     },
     "peerDependencies": {},
-    "typesPublisherContentHash": "184261baf6703d118d65b2d005bcc72af9877981f78da02aa9756329a95df8a8",
+    "typesPublisherContentHash": "b06ef6e25296a342a8cb4449c825b5786ae345270e744fa27908d1cb8d51f547",
     "typeScriptVersion": "5.2"
 }

three/src/Three.Core.d.ts

@@ -154,6 +154,7 @@ export * from "./textures/Data3DTexture.js";
 export * from "./textures/DataArrayTexture.js";
 export * from "./textures/DataTexture.js";
 export * from "./textures/DepthTexture.js";
+export * from "./textures/ExternalTexture.js";
 export * from "./textures/FramebufferTexture.js";
 export * from "./textures/Source.js";
 export * from "./textures/Texture.js";