@types/three 0.154.0 → 0.155.1

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: Wed, 12 Jul 2023 17:02:45 GMT
+ * Last updated: Tue, 22 Aug 2023 18:04:44 GMT
  * Dependencies: [@types/fflate](https://npmjs.com/package/@types/fflate), [@types/lil-gui](https://npmjs.com/package/@types/lil-gui), [@types/meshoptimizer](https://npmjs.com/package/@types/meshoptimizer), [@types/stats.js](https://npmjs.com/package/@types/stats.js), [@types/tweenjs__tween.js](https://npmjs.com/package/@types/tweenjs__tween.js), [@types/webxr](https://npmjs.com/package/@types/webxr)
  * Global values: `THREE`
 

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

@@ -122,6 +122,12 @@ export class OrbitControls {
      */
     zoomSpeed: number;
 
+    /**
+     * Setting this property to `true` allows to zoom to the cursor's position.
+     * @default false
+     */
+    zoomToCursor: boolean;
+
     /**
      * Enable or disable horizontal and
      * vertical rotation of the camera.

three/examples/jsm/csm/CSM.d.ts

@@ -1,18 +1,13 @@
 import { Camera, Vector3, DirectionalLight, Material, Vector2, Object3D } from '../../../src/Three.js';
 
-export enum CMSMode {
-    practical = 'practical',
-    uniform = 'uniform',
-    logarithmic = 'logarithmic',
-    custom = 'custom',
-}
+export type CSMMode = 'uniform' | 'logarithmic' | 'practical' | 'custom';
 
-export interface CMSParameters {
+export interface CSMParameters {
     camera?: Camera;
     parent?: Object3D;
     cascades?: number;
     maxFar?: number;
-    mode?: CMSMode;
+    mode?: CSMMode;
     shadowMapSize?: number;
     shadowBias?: number;
     lightDirection?: Vector3;
@@ -24,12 +19,12 @@ export interface CMSParameters {
 }
 
 export class CSM {
-    constructor(data: CMSParameters);
+    constructor(data: CSMParameters);
     camera: Camera;
     parent: Object3D;
     cascades: number;
     maxFar: number;
-    mode: CMSMode;
+    mode: CSMMode;
     shadowMapSize: number;
     shadowBias: number;
     lightDirection: Vector3;

three/examples/jsm/interactive/HTMLMesh.d.ts

@@ -1,6 +1,6 @@
-import { Mesh } from 'three';
+import { Mesh, MeshBasicMaterial, PlaneGeometry } from 'three';
 
-export class HTMLMesh extends Mesh {
+export class HTMLMesh extends Mesh<PlaneGeometry, MeshBasicMaterial> {
     constructor(dom: HTMLElement);
     dispose(): void;
 }

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

@@ -1,4 +1,4 @@
-import { BufferGeometry, Color, Mesh, Vector3 } from '../../../src/Three.js';
+import { BufferGeometry, Color, Mesh, Vector2, Vector3 } from '../../../src/Three.js';
 
 export class MeshSurfaceSampler {
     distribution: Float32Array | null;
@@ -9,7 +9,13 @@ export class MeshSurfaceSampler {
     constructor(mesh: Mesh);
     binarySearch(x: number): number;
     build(): this;
-    sample(targetPosition: Vector3, targetNormal?: Vector3, targetColor?: Color): this;
-    sampleFace(faceIndex: number, targetPosition: Vector3, targetNormal?: Vector3, targetColor?: Color): this;
+    sample(targetPosition: Vector3, targetNormal?: Vector3, targetColor?: Color, targetUV?: Vector2): this;
+    sampleFace(
+        faceIndex: number,
+        targetPosition: Vector3,
+        targetNormal?: Vector3,
+        targetColor?: Color,
+        targetUV?: Vector2,
+    ): this;
     setWeightAttribute(name: string | null): this;
 }

three/examples/jsm/misc/RollerCoaster.d.ts

@@ -1,19 +1,24 @@
-import { BufferGeometry, Curve, Mesh, Vector3 } from '../../../src/Three.js';
+import { BufferGeometry, Mesh, Vector3 } from '../../../src/Three.js';
+
+interface Curve {
+    getPointAt(u: number): Vector3;
+    getTangentAt(u: number): Vector3;
+}
 
 export class RollerCoasterGeometry extends BufferGeometry {
-    constructor(curve: Curve<Vector3>, divisions: number);
+    constructor(curve: Curve, divisions: number);
 }
 
 export class RollerCoasterLiftersGeometry extends BufferGeometry {
-    constructor(curve: Curve<Vector3>, divisions: number);
+    constructor(curve: Curve, divisions: number);
 }
 
 export class RollerCoasterShadowGeometry extends BufferGeometry {
-    constructor(curve: Curve<Vector3>, divisions: number);
+    constructor(curve: Curve, divisions: number);
 }
 
 export class SkyGeometry extends BufferGeometry {
-    constructor(curve: Curve<Vector3>, divisions: number);
+    constructor();
 }
 
 export class TreesGeometry extends BufferGeometry {

three/examples/jsm/nodes/loaders/NodeObjectLoader.d.ts

@@ -5,7 +5,5 @@ import { AnyJson } from '../core/constants.js';
 export default class NodeObjectLoader extends ObjectLoader {
     parseNodes(json: AnyJson, textures: { [key: string]: Texture }): NodeLoaderResult;
 
-    // tslint:disable-next-line:comment-format
-    //@ts-expect-error
     parseMaterials(json: AnyJson, textures: { [key: string]: Texture }): { [key: string]: Material };
 }

three/examples/jsm/nodes/shadernode/ShaderNodeBaseElements.d.ts

@@ -117,13 +117,13 @@ export type Fn<P extends FunctionNodeArguments> = P extends readonly [...unknown
 export function func<P extends FunctionNodeArguments>(
     code: string,
     includes?: CodeNodeInclude[],
-    // eslint-disable-next-line no-unnecessary-generics
+    // eslint-disable-next-line @definitelytyped/no-unnecessary-generics
 ): { call: (...params: Fn<P>) => Swizzable };
 
 export function fn<P extends FunctionNodeArguments>(
     code: string,
     includes?: CodeNodeInclude[],
-    // eslint-disable-next-line no-unnecessary-generics
+    // eslint-disable-next-line @definitelytyped/no-unnecessary-generics
 ): (...params: Fn<P>) => Swizzable;
 
 export function label(node: NodeRepresentation, name?: string): Swizzable<VarNode>;

three/examples/jsm/objects/ReflectorForSSRPass.d.ts

@@ -7,6 +7,8 @@ import {
     Scene,
     Camera,
     IUniform,
+    Color,
+    Vector2,
 } from '../../../src/Three.js';
 
 export interface ReflectorShader {
@@ -39,6 +41,8 @@ export class ReflectorForSSRPass<TGeometry extends BufferGeometry = BufferGeomet
     needsUpdate: boolean;
     maxDistance: number;
     opacity: number;
+    color: Color;
+    resolution: Vector2;
 
     get distanceAttenuation(): boolean;
     set distanceAttenuation(val: boolean);

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

@@ -1,11 +1,11 @@
-import { WebGLRenderTarget, ShaderMaterial } from '../../../src/Three.js';
+import { WebGLRenderTarget, ShaderMaterial, IUniform } from '../../../src/Three.js';
 
 import { Pass, FullScreenQuad } from './Pass.js';
 
 export class AfterimagePass extends Pass {
     constructor(damp?: number);
     shader: object;
-    uniforms: object;
+    uniforms: Record<string, IUniform>;
     textureComp: WebGLRenderTarget;
     textureOld: WebGLRenderTarget;
     shaderMaterial: ShaderMaterial;

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

@@ -1,4 +1,4 @@
-import { ShaderMaterial } from '../../../src/Three.js';
+import { IUniform, ShaderMaterial } from '../../../src/Three.js';
 
 import { Pass, FullScreenQuad } from './Pass.js';
 
@@ -17,7 +17,21 @@ export interface HalftonePassParameters {
 
 export class HalftonePass extends Pass {
     constructor(width: number, height: number, params: HalftonePassParameters);
-    uniforms: object;
+    uniforms: {
+        tDiffuse: IUniform;
+        shape: IUniform<number>;
+        radius: IUniform<number>;
+        rotateR: IUniform<number>;
+        rotateG: IUniform<number>;
+        rotateB: IUniform<number>;
+        scatter: IUniform<number>;
+        width: IUniform<number>;
+        height: IUniform<number>;
+        blending: IUniform<number>;
+        blendingMode: IUniform<number>;
+        greyscale: IUniform<boolean>;
+        disable: IUniform<boolean>;
+    };
     material: ShaderMaterial;
     fsQuad: FullScreenQuad;
 }

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

@@ -1,13 +1,10 @@
 import { ShaderMaterial } from '../../../src/Three.js';
-import { ToneMapping } from '../../../src/constants.js';
 
 import { Pass, FullScreenQuad } from './Pass.js';
 
 export class OutputPass extends Pass {
-    constructor(toneMapping?: ToneMapping, toneMappingExposure?: number);
+    constructor();
     uniforms: object;
     material: ShaderMaterial;
     fsQuad: FullScreenQuad;
-    toneMapping: ToneMapping;
-    toneMappingExposure: number;
 }

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

@@ -25,4 +25,6 @@ export class RenderPixelatedPass extends Pass {
 
     beautyRenderTarget: WebGLRenderTarget;
     normalRenderTarget: WebGLRenderTarget;
+
+    setPixelSize(pixelSize: number): void;
 }

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

@@ -49,7 +49,7 @@ export class SSAOPass extends Pass {
     fsQuad: FullScreenQuad;
     originalClearColor: Color;
 
-    static OUTPUT: SSAOPassOUTPUT;
+    static OUTPUT: typeof SSAOPassOUTPUT;
 
     dipose(): void;
     generateSampleKernel(): Vector3[];

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

@@ -43,19 +43,17 @@ export class SSRPass extends Pass {
     get selects(): Mesh[] | null;
     set selects(val: Mesh[] | null);
     selective: boolean;
-    get isBouncing(): boolean;
-    set isBouncing(val: boolean);
+    get bouncing(): boolean;
+    set bouncing(val: boolean);
 
     blur: boolean;
 
-    get isDistanceAttenuation(): boolean;
-    set isDistanceAttenuation(val: boolean);
-    get isFresnel(): boolean;
-    set isFresnel(val: boolean);
-    get isInfiniteThick(): boolean;
-    set isInfiniteThick(val: boolean);
-
-    thickTolerance: number;
+    get distanceAttenuation(): boolean;
+    set distanceAttenuation(val: boolean);
+    get fresnel(): boolean;
+    set fresnel(val: boolean);
+    get infiniteThick(): boolean;
+    set infiniteThick(val: boolean);
 
     beautyRenderTarget: WebGLRenderTarget;
     prevRenderTarget: WebGLRenderTarget;

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

@@ -3,6 +3,6 @@ import { Scene, Camera, ColorRepresentation } from '../../../src/Three.js';
 import { SSAARenderPass } from './SSAARenderPass.js';
 
 export class TAARenderPass extends SSAARenderPass {
-    constructor(scene: Scene, camera: Camera, clearColor: ColorRepresentation, clearAlpha: number);
+    constructor(scene: Scene, camera: Camera, clearColor?: ColorRepresentation, clearAlpha?: number);
     accumulate: boolean;
 }

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

@@ -1,12 +1,12 @@
-import { Texture, ShaderMaterial } from '../../../src/Three.js';
+import { Texture, ShaderMaterial, IUniform } from '../../../src/Three.js';
 
 import { Pass, FullScreenQuad } from './Pass.js';
 
 export class TexturePass extends Pass {
-    constructor(map: Texture, opacity?: number);
-    map: Texture;
+    constructor(map?: Texture, opacity?: number);
+    map: Texture | undefined;
     opacity: number;
-    uniforms: object;
+    uniforms: Record<string, IUniform>;
     material: ShaderMaterial;
     fsQuad: FullScreenQuad;
 }

three/examples/jsm/utils/BufferGeometryUtils.d.ts

@@ -28,10 +28,11 @@ export function deinterleaveAttribute(geometry: BufferGeometry): void;
 export function deinterleaveGeometry(geometry: BufferGeometry): void;
 
 /**
- * Creates a new, non-indexed geometry with smooth normals everywhere except faces that meet at an angle greater than the crease angle.
+ * Modifies the supplied geometry if it is non-indexed, otherwise creates a new, non-indexed geometry. Returns the
+ * geometry with smooth normals everywhere except faces that meet at an angle greater than the crease angle.
  *
  * @param geometry The input geometry.
- * @param creaseAngle The crease angle.
+ * @param creaseAngle The crease angle in radians.
  */
 export function toCreasedNormals(geometry: BufferGeometry, creaseAngle?: number): BufferGeometry;
 

three/examples/jsm/webxr/XRPlanes.d.ts

@@ -0,0 +1,5 @@
+import { Object3D } from '../../../src/Three.js';
+
+export class XRPlanes extends Object3D {
+    constructor(renderer: THREE.WebGLRenderer);
+}

three/index.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for three 0.154
+// Type definitions for three 0.155
 // Project: https://threejs.org/
 // Definitions by: Josh Ellis <https://github.com/joshuaellis>
 //                 Nathan Bierema <https://github.com/Methuselah96>

three/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/three",
-    "version": "0.154.0",
+    "version": "0.155.1",
     "description": "TypeScript definitions for three",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/three",
     "license": "MIT",
@@ -32,7 +32,7 @@
         "lil-gui": "~0.17.0",
         "meshoptimizer": "~0.18.1"
     },
-    "typesPublisherContentHash": "60f6509ecc6c3bb0d7b3dc3f363893442c279d1e28b9a39b682525c84ea96ca0",
+    "typesPublisherContentHash": "e95ca925c70bfdbc8f8ae36c5d54552fba9db84a9fa72acb7f66e8234540c623",
     "typeScriptVersion": "4.4",
     "exports": {
         ".": {

three/src/Three.d.ts

@@ -41,6 +41,7 @@ export * from './cameras/Camera.js';
 /**
  * Core
  */
+export * from './core/RenderTarget.js';
 export * from './core/Uniform.js';
 export * from './core/UniformsGroup.js';
 export * from './core/InstancedBufferGeometry.js';

three/src/core/BufferAttribute.d.ts

@@ -114,11 +114,11 @@ export class BufferAttribute {
     normalized: boolean;
 
     /**
-     * Stores the {@link BufferAttribute.array | array}'s length divided by the {@link BufferAttribute.itemSize | itemSize}.
-     * @remarks If the buffer is storing a 3-component vector (such as a position, normal, or color), then this will count the number of such vectors stored.
-     * @remarks Expects a `Integer`
+     * Represents the number of items this buffer attribute stores. It is internally computed by dividing the
+     * {@link BufferAttribute.array | array}'s length by the {@link BufferAttribute.itemSize | itemSize}. Read-only
+     * property.
      */
-    count: number;
+    readonly count: number;
 
     /**
      * Flag to indicate that this attribute has changed and should be re-sent to the GPU.
@@ -217,6 +217,16 @@ export class BufferAttribute {
      */
     set(value: ArrayLike<number> | ArrayBufferView, offset?: number): this;
 
+    /**
+     * Returns the given component of the vector at the given index.
+     */
+    getComponent(index: number, component: number): number;
+
+    /**
+     * Sets the given component of the vector at the given index.
+     */
+    setComponent(index: number, component: number, value: number): void;
+
     /**
      * Returns the x component of the vector at the given index.
      * @param index Expects a `Integer`

three/src/core/RenderTarget.d.ts

@@ -0,0 +1,78 @@
+import { Vector4 } from '../math/Vector4.js';
+import { Texture } from '../textures/Texture.js';
+import { DepthTexture } from '../textures/DepthTexture.js';
+import { EventDispatcher } from './EventDispatcher.js';
+import {
+    Wrapping,
+    TextureDataType,
+    TextureEncoding,
+    MinificationTextureFilter,
+    MagnificationTextureFilter,
+    ColorSpace,
+} from '../constants.js';
+
+export interface RenderTargetOptions {
+    wrapS?: Wrapping | undefined;
+    wrapT?: Wrapping | undefined;
+    magFilter?: MagnificationTextureFilter | undefined;
+    minFilter?: MinificationTextureFilter | undefined;
+    generateMipmaps?: boolean | undefined; // true;
+    format?: number | undefined; // RGBAFormat;
+    type?: TextureDataType | undefined; // UnsignedByteType;
+    anisotropy?: number | undefined; // 1;
+    colorSpace?: ColorSpace | undefined;
+    depthBuffer?: boolean | undefined; // true;
+    stencilBuffer?: boolean | undefined; // false;
+    depthTexture?: DepthTexture | undefined;
+    /**
+     * Defines the count of MSAA samples. Can only be used with WebGL 2. Default is **0**.
+     * @default 0
+     */
+    samples?: number;
+    /** @deprecated Use 'colorSpace' in three.js r152+. */
+    encoding?: TextureEncoding | undefined;
+}
+
+export class RenderTarget<TTexture extends Texture | Texture[] = Texture> extends EventDispatcher {
+    constructor(width?: number, height?: number, options?: RenderTargetOptions);
+
+    readonly isRenderTarget: true;
+
+    width: number;
+    height: number;
+    depth: number;
+
+    scissor: Vector4;
+    /**
+     * @default false
+     */
+    scissorTest: boolean;
+    viewport: Vector4;
+    texture: TTexture;
+
+    /**
+     * @default true
+     */
+    depthBuffer: boolean;
+
+    /**
+     * @default true
+     */
+    stencilBuffer: boolean;
+
+    /**
+     * @default null
+     */
+    depthTexture: DepthTexture;
+
+    /**
+     * Defines the count of MSAA samples. Can only be used with WebGL 2. Default is **0**.
+     * @default 0
+     */
+    samples: number;
+
+    setSize(width: number, height: number, depth?: number): void;
+    clone(): this;
+    copy(source: RenderTarget): this;
+    dispose(): void;
+}

three/src/extras/core/ShapePath.d.ts

@@ -5,9 +5,8 @@ import { Path } from './Path.js';
 
 /**
  * This class is used to convert a series of shapes to an array of {@link THREE.Path | Path's},
- * for example an SVG shape to a path (see the example below).
- * @see Example: {@link https://threejs.org/examples/#webgl_geometry_extrude_shapes2 | geometry / extrude / shapes2}
- *  @see {@link https://threejs.org/docs/index.html#api/en/extras/core/ShapePath | Official Documentation}
+ * for example an SVG shape to a path.
+ * @see {@link https://threejs.org/docs/index.html#api/en/extras/core/ShapePath | Official Documentation}
  * @see {@link https://github.com/mrdoob/three.js/blob/master/src/extras/core/ShapePath.js | Source}
  */
 export class ShapePath {

three/src/helpers/BoxHelper.d.ts

@@ -1,6 +1,8 @@
 import { ColorRepresentation } from '../math/Color.js';
-import { Object3D } from './../core/Object3D.js';
-import { LineSegments } from './../objects/LineSegments.js';
+import { Object3D } from '../core/Object3D.js';
+import { LineSegments } from '../objects/LineSegments.js';
+import { BufferGeometry } from '../core/BufferGeometry.js';
+import { LineBasicMaterial } from '../materials/LineBasicMaterial.js';
 
 /**
  * Helper object to graphically show the world-axis-aligned bounding box around an object
@@ -21,7 +23,7 @@ import { LineSegments } from './../objects/LineSegments.js';
  * @see {@link https://threejs.org/docs/index.html#api/en/helpers/BoxHelper | Official Documentation}
  * @see {@link https://github.com/mrdoob/three.js/blob/master/src/helpers/BoxHelper.js | Source}
  */
-export class BoxHelper extends LineSegments {
+export class BoxHelper extends LineSegments<BufferGeometry, LineBasicMaterial> {
     /**
      * Creates a new wireframe box that bounds the passed object
      * @remarks

three/src/loaders/ObjectLoader.d.ts

@@ -1,9 +1,9 @@
 import { Loader } from './Loader.js';
 import { LoadingManager } from './LoadingManager.js';
-import { Object3D } from './../core/Object3D.js';
-import { Texture } from './../textures/Texture.js';
-import { Material } from './../materials/Material.js';
-import { AnimationClip } from './../animation/AnimationClip.js';
+import { Object3D } from '../core/Object3D.js';
+import { Texture } from '../textures/Texture.js';
+import { Material } from '../materials/Material.js';
+import { AnimationClip } from '../animation/AnimationClip.js';
 import { InstancedBufferGeometry } from '../core/InstancedBufferGeometry.js';
 import { BufferGeometry } from '../core/BufferGeometry.js';
 import { Source } from '../textures/Source.js';
@@ -26,12 +26,12 @@ export class ObjectLoader extends Loader {
     parse<T extends Object3D>(json: any, onLoad?: (object: Object3D) => void): T;
     // tslint:disable-next-line:no-unnecessary-generics
     parseAsync<T extends Object3D>(json: any): Promise<T>;
-    parseGeometries(json: any): { [key: string]: InstancedBufferGeometry | BufferGeometry }; // Array of BufferGeometry or Geometry or Geometry2.
-    parseMaterials(json: any, textures: { [key: string]: Texture }): Material[]; // Array of Classes that inherits from Matrial.
+    parseGeometries(json: any): { [key: string]: InstancedBufferGeometry | BufferGeometry };
+    parseMaterials(json: any, textures: { [key: string]: Texture }): { [key: string]: Material };
     parseAnimations(json: any): AnimationClip[];
     parseImages(json: any, onLoad?: () => void): { [key: string]: Source };
     parseImagesAsync(json: any): Promise<{ [key: string]: Source }>;
-    parseTextures(json: any, images: any): Texture[];
+    parseTextures(json: any, images: { [key: string]: Source }): { [key: string]: Texture };
     parseObject<T extends Object3D>(
         data: any,
         geometries: any[],

three/src/materials/Material.d.ts

@@ -1,7 +1,7 @@
-import { Plane } from './../math/Plane.js';
-import { EventDispatcher } from './../core/EventDispatcher.js';
-import { WebGLRenderer } from './../renderers/WebGLRenderer.js';
-import { Shader } from './../renderers/shaders/ShaderLib.js';
+import { Plane } from '../math/Plane.js';
+import { EventDispatcher } from '../core/EventDispatcher.js';
+import { WebGLRenderer } from '../renderers/WebGLRenderer.js';
+import { Shader } from '../renderers/shaders/ShaderLib.js';
 import {
     BlendingDstFactor,
     BlendingEquation,
@@ -135,7 +135,7 @@ export class Material extends EventDispatcher {
      * See the WebGL / clipping /intersection example. Default is null.
      * @default null
      */
-    clippingPlanes: any;
+    clippingPlanes: Plane[];
 
     /**
      * Defines whether to clip shadows according to the clipping planes specified on this material. Default is false.

three/src/objects/Group.d.ts

@@ -24,7 +24,7 @@ import { Object3D } from './../core/Object3D.js';
  */
 export class Group extends Object3D {
     /**
-     * Creates a new {@link Bone}.
+     * Creates a new {@link Group}.
      */
     constructor();
 

three/src/renderers/WebGLRenderTarget.d.ts

@@ -1,78 +1,11 @@
-import { Vector4 } from '../math/Vector4.js';
 import { Texture } from '../textures/Texture.js';
-import { DepthTexture } from '../textures/DepthTexture.js';
-import { EventDispatcher } from '../core/EventDispatcher.js';
-import {
-    Wrapping,
-    TextureDataType,
-    TextureEncoding,
-    MinificationTextureFilter,
-    MagnificationTextureFilter,
-    ColorSpace,
-} from '../constants.js';
+import { RenderTarget, RenderTargetOptions } from '../core/RenderTarget.js';
 
-export interface WebGLRenderTargetOptions {
-    wrapS?: Wrapping | undefined;
-    wrapT?: Wrapping | undefined;
-    magFilter?: MagnificationTextureFilter | undefined;
-    minFilter?: MinificationTextureFilter | undefined;
-    generateMipmaps?: boolean | undefined; // true;
-    format?: number | undefined; // RGBAFormat;
-    type?: TextureDataType | undefined; // UnsignedByteType;
-    anisotropy?: number | undefined; // 1;
-    colorSpace?: ColorSpace | undefined;
-    depthBuffer?: boolean | undefined; // true;
-    stencilBuffer?: boolean | undefined; // false;
-    depthTexture?: DepthTexture | undefined;
-    /**
-     * Defines the count of MSAA samples. Can only be used with WebGL 2. Default is **0**.
-     * @default 0
-     */
-    samples?: number;
-    /** @deprecated Use 'colorSpace' in three.js r152+. */
-    encoding?: TextureEncoding | undefined;
-}
+// tslint:disable-next-line:no-empty-interface
+export interface WebGLRenderTargetOptions extends RenderTargetOptions {}
 
-export class WebGLRenderTarget<TTexture extends Texture | Texture[] = Texture> extends EventDispatcher {
-    constructor(width?: number, height?: number, options?: WebGLRenderTargetOptions);
+export class WebGLRenderTarget<TTexture extends Texture | Texture[] = Texture> extends RenderTarget<TTexture> {
+    constructor(width?: number, height?: number, options?: RenderTargetOptions);
 
     readonly isWebGLRenderTarget: true;
-
-    width: number;
-    height: number;
-    depth: number;
-
-    scissor: Vector4;
-    /**
-     * @default false
-     */
-    scissorTest: boolean;
-    viewport: Vector4;
-    texture: TTexture;
-
-    /**
-     * @default true
-     */
-    depthBuffer: boolean;
-
-    /**
-     * @default true
-     */
-    stencilBuffer: boolean;
-
-    /**
-     * @default null
-     */
-    depthTexture: DepthTexture;
-
-    /**
-     * Defines the count of MSAA samples. Can only be used with WebGL 2. Default is **0**.
-     * @default 0
-     */
-    samples: number;
-
-    setSize(width: number, height: number, depth?: number): void;
-    clone(): this;
-    copy(source: WebGLRenderTarget): this;
-    dispose(): void;
 }

three/src/renderers/WebGLRenderer.d.ts

@@ -1,5 +1,5 @@
-import { Scene } from './../scenes/Scene.js';
-import { Camera } from './../cameras/Camera.js';
+import { Scene } from '../scenes/Scene.js';
+import { Camera } from '../cameras/Camera.js';
 import { WebGLExtensions } from './webgl/WebGLExtensions.js';
 import { WebGLInfo } from './webgl/WebGLInfo.js';
 import { WebGLShadowMap } from './webgl/WebGLShadowMap.js';
@@ -7,13 +7,13 @@ import { WebGLCapabilities } from './webgl/WebGLCapabilities.js';
 import { WebGLProperties } from './webgl/WebGLProperties.js';
 import { WebGLRenderLists } from './webgl/WebGLRenderLists.js';
 import { WebGLState } from './webgl/WebGLState.js';
-import { Vector2 } from './../math/Vector2.js';
-import { Vector4 } from './../math/Vector4.js';
-import { Color, ColorRepresentation } from './../math/Color.js';
+import { Vector2 } from '../math/Vector2.js';
+import { Vector4 } from '../math/Vector4.js';
+import { Color, ColorRepresentation } from '../math/Color.js';
 import { WebGLRenderTarget } from './WebGLRenderTarget.js';
 import { WebGLMultipleRenderTargets } from './WebGLMultipleRenderTargets.js';
-import { Object3D } from './../core/Object3D.js';
-import { Material } from './../materials/Material.js';
+import { Object3D } from '../core/Object3D.js';
+import { Material } from '../materials/Material.js';
 import {
     ToneMapping,
     ShadowMapType,
@@ -22,14 +22,15 @@ import {
     ColorSpace,
     WebGLCoordinateSystem,
 } from '../constants.js';
-import { WebXRManager } from '../renderers/webxr/WebXRManager.js';
-import { BufferGeometry } from './../core/BufferGeometry.js';
+import { WebXRManager } from './webxr/WebXRManager.js';
+import { BufferGeometry } from '../core/BufferGeometry.js';
 import { OffscreenCanvas, Texture } from '../textures/Texture.js';
 import { Data3DTexture } from '../textures/Data3DTexture.js';
 import { Vector3 } from '../math/Vector3.js';
 import { Box3 } from '../math/Box3.js';
 import { DataArrayTexture } from '../textures/DataArrayTexture.js';
 import { WebGLProgram } from './webgl/WebGLProgram.js';
+import { Plane } from '../math/Plane.js';
 
 export interface Renderer {
     domElement: HTMLCanvasElement;
@@ -184,7 +185,7 @@ export class WebGLRenderer implements Renderer {
     /**
      * @default []
      */
-    clippingPlanes: any[];
+    clippingPlanes: readonly Plane[];
 
     /**
      * @default false
@@ -210,6 +211,8 @@ export class WebGLRenderer implements Renderer {
     get coordinateSystem(): typeof WebGLCoordinateSystem;
 
     /**
+     * @deprecated Migrate your lighting according to the following guide:
+     * https://discourse.threejs.org/t/updates-to-lighting-in-three-js-r155/53733.
      * @default true
      */
     useLegacyLights: boolean;

three/src/renderers/webgl/WebGLAttributes.d.ts

@@ -6,12 +6,14 @@ import { GLBufferAttribute } from '../../core/GLBufferAttribute.js';
 export class WebGLAttributes {
     constructor(gl: WebGLRenderingContext | WebGL2RenderingContext, capabilities: WebGLCapabilities);
 
-    get(attribute: BufferAttribute | InterleavedBufferAttribute | GLBufferAttribute): {
-        buffer: WebGLBuffer;
-        type: number;
-        bytesPerElement: number;
-        version: number;
-    };
+    get(attribute: BufferAttribute | InterleavedBufferAttribute | GLBufferAttribute):
+        | {
+              buffer: WebGLBuffer;
+              type: number;
+              bytesPerElement: number;
+              version: number;
+          }
+        | undefined;
 
     remove(attribute: BufferAttribute | InterleavedBufferAttribute | GLBufferAttribute): void;
 

three/src/renderers/webgl/WebGLCapabilities.d.ts

@@ -7,6 +7,7 @@ export class WebGLCapabilities {
     constructor(gl: WebGLRenderingContext, extensions: any, parameters: WebGLCapabilitiesParameters);
 
     readonly isWebGL2: boolean;
+    readonly drawBuffers: boolean;
     precision: string;
     logarithmicDepthBuffer: boolean;
     maxTextures: number;

three/src/renderers/webgl/WebGLState.d.ts

@@ -10,6 +10,7 @@ import { WebGLCapabilities } from './WebGLCapabilities.js';
 import { WebGLExtensions } from './WebGLExtensions.js';
 import { Material } from '../../materials/Material.js';
 import { Vector4 } from '../../math/Vector4.js';
+import { WebGLRenderTarget } from '../WebGLRenderTarget.js';
 
 export class WebGLColorBuffer {
     constructor();
@@ -52,22 +53,10 @@ export class WebGLState {
         stencil: WebGLStencilBuffer;
     };
 
-    initAttributes(): void;
-    enableAttribute(attribute: number): void;
-    enableAttributeAndDivisor(attribute: number, meshPerAttribute: number): void;
-    disableUnusedAttributes(): void;
-    vertexAttribPointer(
-        index: number,
-        size: number,
-        type: number,
-        normalized: boolean,
-        stride: number,
-        offset: number,
-    ): void;
     enable(id: number): void;
     disable(id: number): void;
     bindFramebuffer(target: number, framebuffer: WebGLFramebuffer | null): void;
-    bindXRFramebuffer(framebuffer: WebGLFramebuffer | null): void;
+    drawBuffers(renderTarget: WebGLRenderTarget | null, framebuffer: WebGLFramebuffer | null): void;
     useProgram(program: any): boolean;
     setBlending(
         blending: Blending,