@types/three 0.143.2 → 0.146.0

three/src/geometries/BoxGeometry.d.ts

@@ -34,5 +34,3 @@ export class BoxGeometry extends BufferGeometry {
 
     static fromJSON(data: any): BoxGeometry;
 }
-
-export { BoxGeometry as BoxBufferGeometry };

three/src/geometries/CapsuleGeometry.d.ts

@@ -23,5 +23,3 @@ export class CapsuleGeometry extends BufferGeometry {
 
     static fromJSON(data: any): CapsuleGeometry;
 }
-
-export { CapsuleGeometry as CapsuleBufferGeometry };

three/src/geometries/CircleGeometry.d.ts

@@ -23,5 +23,3 @@ export class CircleGeometry extends BufferGeometry {
 
     static fromJSON(data: any): CircleGeometry;
 }
-
-export { CircleGeometry as CircleBufferGeometry };

three/src/geometries/ConeGeometry.d.ts

@@ -27,5 +27,3 @@ export class ConeGeometry extends CylinderGeometry {
 
     static fromJSON(data: any): ConeGeometry;
 }
-
-export { ConeGeometry as ConeBufferGeometry };

three/src/geometries/CylinderGeometry.d.ts

@@ -40,5 +40,3 @@ export class CylinderGeometry extends BufferGeometry {
 
     static fromJSON(data: any): CylinderGeometry;
 }
-
-export { CylinderGeometry as CylinderBufferGeometry };

three/src/geometries/DodecahedronGeometry.d.ts

@@ -14,5 +14,3 @@ export class DodecahedronGeometry extends PolyhedronGeometry {
 
     static fromJSON(data: any): DodecahedronGeometry;
 }
-
-export { DodecahedronGeometry as DodecahedronBufferGeometry };

three/src/geometries/ExtrudeGeometry.d.ts

@@ -69,5 +69,3 @@ export class ExtrudeGeometry extends BufferGeometry {
 
     static fromJSON(data: any): ExtrudeGeometry;
 }
-
-export { ExtrudeGeometry as ExtrudeBufferGeometry };

three/src/geometries/IcosahedronGeometry.d.ts

@@ -14,5 +14,3 @@ export class IcosahedronGeometry extends PolyhedronGeometry {
 
     static fromJSON(data: any): IcosahedronGeometry;
 }
-
-export { IcosahedronGeometry as IcosahedronBufferGeometry };

three/src/geometries/LatheGeometry.d.ts

@@ -24,5 +24,3 @@ export class LatheGeometry extends BufferGeometry {
 
     static fromJSON(data: any): LatheGeometry;
 }
-
-export { LatheGeometry as LatheBufferGeometry };

three/src/geometries/OctahedronGeometry.d.ts

@@ -14,5 +14,3 @@ export class OctahedronGeometry extends PolyhedronGeometry {
 
     static fromJSON(data: any): OctahedronGeometry;
 }
-
-export { OctahedronGeometry as OctahedronBufferGeometry };

three/src/geometries/PlaneGeometry.d.ts

@@ -23,5 +23,3 @@ export class PlaneGeometry extends BufferGeometry {
 
     static fromJSON(data: any): PlaneGeometry;
 }
-
-export { PlaneGeometry as PlaneBufferGeometry };

three/src/geometries/PolyhedronGeometry.d.ts

@@ -23,5 +23,3 @@ export class PolyhedronGeometry extends BufferGeometry {
 
     static fromJSON(data: any): PolyhedronGeometry;
 }
-
-export { PolyhedronGeometry as PolyhedronBufferGeometry };

three/src/geometries/RingGeometry.d.ts

@@ -34,5 +34,3 @@ export class RingGeometry extends BufferGeometry {
 
     static fromJSON(data: any): RingGeometry;
 }
-
-export { RingGeometry as RingBufferGeometry };

three/src/geometries/ShapeGeometry.d.ts

@@ -11,5 +11,3 @@ export class ShapeGeometry extends BufferGeometry {
 
     static fromJSON(data: any): ShapeGeometry;
 }
-
-export { ShapeGeometry as ShapeBufferGeometry };

three/src/geometries/SphereGeometry.d.ts

@@ -37,5 +37,3 @@ export class SphereGeometry extends BufferGeometry {
 
     static fromJSON(data: any): SphereGeometry;
 }
-
-export { SphereGeometry as SphereBufferGeometry };

three/src/geometries/TetrahedronGeometry.d.ts

@@ -14,5 +14,3 @@ export class TetrahedronGeometry extends PolyhedronGeometry {
 
     static fromJSON(data: any): TetrahedronGeometry;
 }
-
-export { TetrahedronGeometry as TetrahedronBufferGeometry };

three/src/geometries/TorusGeometry.d.ts

@@ -25,5 +25,3 @@ export class TorusGeometry extends BufferGeometry {
 
     static fromJSON(data: any): TorusGeometry;
 }
-
-export { TorusGeometry as TorusBufferGeometry };

three/src/geometries/TorusKnotGeometry.d.ts

@@ -34,5 +34,3 @@ export class TorusKnotGeometry extends BufferGeometry {
 
     static fromJSON(data: any): TorusKnotGeometry;
 }
-
-export { TorusKnotGeometry as TorusKnotBufferGeometry };

three/src/geometries/TubeGeometry.d.ts

@@ -36,5 +36,3 @@ export class TubeGeometry extends BufferGeometry {
 
     static fromJSON(data: any): TubeGeometry;
 }
-
-export { TubeGeometry as TubeBufferGeometry };

three/src/helpers/ArrowHelper.d.ts

@@ -55,4 +55,8 @@ export class ArrowHelper extends Object3D {
      * @param color The desired color.
      */
     setColor(color: ColorRepresentation): void;
+
+    copy(source: this): this;
+
+    dispose(): void;
 }

three/src/helpers/Box3Helper.d.ts

@@ -15,4 +15,6 @@ export class Box3Helper extends LineSegments {
     type: string;
 
     box: Box3;
+
+    dispose(): void;
 }

three/src/helpers/BoxHelper.d.ts

@@ -17,4 +17,6 @@ export class BoxHelper extends LineSegments {
     update(object?: Object3D): void;
 
     setFromObject(object: Object3D): this;
+
+    dispose(): void;
 }

three/src/helpers/GridHelper.d.ts

@@ -15,8 +15,5 @@ export class GridHelper extends LineSegments {
      */
     type: string;
 
-    /**
-     * @deprecated Colors should be specified in the constructor.
-     */
-    setColors(color1?: ColorRepresentation, color2?: ColorRepresentation): void;
+    dispose(): void;
 }

three/src/helpers/PlaneHelper.d.ts

@@ -22,4 +22,6 @@ export class PlaneHelper extends LineSegments {
     size: number;
 
     updateMatrixWorld(force?: boolean): void;
+
+    dispose(): void;
 }

three/src/helpers/PolarGridHelper.d.ts

@@ -23,4 +23,6 @@ export class PolarGridHelper extends LineSegments {
      * @default 'PolarGridHelper'
      */
     type: string;
+
+    dispose(): void;
 }

three/src/helpers/SkeletonHelper.d.ts

@@ -25,4 +25,6 @@ export class SkeletonHelper extends LineSegments {
 
     getBoneList(object: Object3D): Bone[];
     update(): void;
+
+    dispose(): void;
 }

three/src/loaders/DataTextureLoader.d.ts

@@ -7,7 +7,7 @@ export class DataTextureLoader extends Loader {
 
     load(
         url: string,
-        onLoad: (dataTexture: DataTexture, texData: object) => void,
+        onLoad?: (dataTexture: DataTexture, texData: object) => void,
         onProgress?: (event: ProgressEvent) => void,
         onError?: (event: ErrorEvent) => void,
     ): DataTexture;

three/src/materials/LineBasicMaterial.d.ts

@@ -4,6 +4,7 @@ import { MaterialParameters, Material } from './Material';
 
 export interface LineBasicMaterialParameters extends MaterialParameters {
     color?: ColorRepresentation | undefined;
+    fog?: boolean | undefined;
     linewidth?: number | undefined;
     linecap?: string | undefined;
     linejoin?: string | undefined;
@@ -22,6 +23,12 @@ export class LineBasicMaterial extends Material {
      */
     color: Color;
 
+    /**
+     * Whether the material is affected by fog. Default is true.
+     * @default true
+     */
+    fog: boolean;
+
     /**
      * @default 1
      */

three/src/materials/MeshLambertMaterial.d.ts

@@ -1,17 +1,26 @@
 import { Color } from './../math/Color';
 import { Texture } from './../textures/Texture';
 import { MaterialParameters, Material } from './Material';
-import { Combine } from '../constants';
+import { Combine, NormalMapTypes } from '../constants';
 import { ColorRepresentation } from '../utils';
+import { Vector2 } from '../Three';
 
 export interface MeshLambertMaterialParameters extends MaterialParameters {
+    bumpMap?: Texture | undefined;
+    bumpScale?: number | undefined;
     color?: ColorRepresentation | undefined;
+    displacementMap?: Texture | undefined;
+    displacementScale?: number | undefined;
+    displacementBias?: number | undefined;
     emissive?: ColorRepresentation | undefined;
     emissiveIntensity?: number | undefined;
     emissiveMap?: Texture | null | undefined;
+    flatShading?: boolean | undefined;
     map?: Texture | null | undefined;
     lightMap?: Texture | null | undefined;
     lightMapIntensity?: number | undefined;
+    normalMap?: Texture | undefined;
+    normalScale?: Vector2 | undefined;
     aoMap?: Texture | null | undefined;
     aoMapIntensity?: number | undefined;
     specularMap?: Texture | null | undefined;
@@ -40,6 +49,31 @@ export class MeshLambertMaterial extends Material {
      */
     color: Color;
 
+    /**
+     * @default null
+     */
+    bumpMap: Texture | null;
+
+    /**
+     * @default 1
+     */
+    bumpScale: number;
+
+    /**
+     * @default null
+     */
+    displacementMap: Texture | null;
+
+    /**
+     * @default 1
+     */
+    displacementScale: number;
+
+    /**
+     * @default 0
+     */
+    displacementBias: number;
+
     /**
      * @default new THREE.Color( 0x000000 )
      */
@@ -55,6 +89,11 @@ export class MeshLambertMaterial extends Material {
      */
     emissiveMap: Texture | null;
 
+    /**
+     * @default false
+     */
+    flatShading: boolean;
+
     /**
      * @default null
      */
@@ -70,6 +109,18 @@ export class MeshLambertMaterial extends Material {
      */
     lightMapIntensity: number;
 
+    /**
+     * @default null
+     */
+    normalMap: Texture | null;
+
+    normalMapType: NormalMapTypes;
+
+    /**
+     * @default new THREE.Vector2( 1, 1 )
+     */
+    normalScale: Vector2;
+
     /**
      * @default null
      */

three/src/materials/MeshPhysicalMaterial.d.ts

@@ -167,6 +167,11 @@ export class MeshPhysicalMaterial extends MeshStandardMaterial {
      */
     iridescenceIOR: number;
 
+    /**
+     * @default 0
+     */
+    iridescence: number;
+
     /**
      * @default [100, 400]
      */

three/src/materials/ShaderMaterial.d.ts

@@ -11,7 +11,7 @@ export interface ShaderMaterialParameters extends MaterialParameters {
     wireframeLinewidth?: number | undefined;
     lights?: boolean | undefined;
     clipping?: boolean | undefined;
-
+    fog?: boolean | undefined;
     extensions?:
         | {
               derivatives?: boolean | undefined;

three/src/math/ColorManagement.d.ts

@@ -1,4 +1,4 @@
-import { LinearSRGBColorSpace, SRGBColorSpace } from '../constants';
+import { ColorSpace, LinearSRGBColorSpace, SRGBColorSpace } from '../constants';
 import { Color } from './Color';
 
 export function SRGBToLinear(c: number): number;
@@ -6,6 +6,16 @@ export function SRGBToLinear(c: number): number;
 export function LinearToSRGB(c: number): number;
 
 export namespace ColorManagement {
+    /**
+     * @default true
+     */
+    let legacyMode: boolean;
+
+    /**
+     * @default LinearSRGBColorSpace
+     */
+    let workingColorSpace: ColorSpace;
+
     function convert(
         color: Color,
         sourceColorSpace: SRGBColorSpace | LinearSRGBColorSpace,

three/src/math/Euler.d.ts

@@ -2,8 +2,10 @@ import { Matrix4 } from './Matrix4';
 import { Quaternion } from './Quaternion';
 import { Vector3 } from './Vector3';
 
+export type EulerOrder = 'XYZ' | 'YXZ' | 'ZXY' | 'ZYX' | 'YZX' | 'XZY';
+
 export class Euler {
-    constructor(x?: number, y?: number, z?: number, order?: string);
+    constructor(x?: number, y?: number, z?: number, order?: EulerOrder);
 
     /**
      * @default 0
@@ -23,25 +25,25 @@ export class Euler {
     /**
      * @default THREE.Euler.DefaultOrder
      */
-    order: string;
+    order: EulerOrder;
     readonly isEuler: true;
 
     _onChangeCallback: () => void;
 
-    set(x: number, y: number, z: number, order?: string): Euler;
+    set(x: number, y: number, z: number, order?: EulerOrder): Euler;
     clone(): this;
     copy(euler: Euler): this;
-    setFromRotationMatrix(m: Matrix4, order?: string, update?: boolean): Euler;
-    setFromQuaternion(q: Quaternion, order?: string, update?: boolean): Euler;
-    setFromVector3(v: Vector3, order?: string): Euler;
-    reorder(newOrder: string): Euler;
+    setFromRotationMatrix(m: Matrix4, order?: EulerOrder, update?: boolean): Euler;
+    setFromQuaternion(q: Quaternion, order?: EulerOrder, update?: boolean): Euler;
+    setFromVector3(v: Vector3, order?: EulerOrder): Euler;
+    reorder(newOrder: EulerOrder): Euler;
     equals(euler: Euler): boolean;
-    fromArray(xyzo: any[]): Euler;
-    toArray(array?: number[], offset?: number): number[];
+    fromArray(xyzo: [number, number, number, EulerOrder?, ...any[]]): Euler;
+    toArray(array?: Array<number | string | undefined>, offset?: number): Array<number | string | undefined>;
     _onChange(callback: () => void): this;
 
-    static RotationOrders: string[];
-    static DefaultOrder: string;
+    static RotationOrders: EulerOrder[];
+    static DefaultOrder: 'XYZ';
 
     [Symbol.iterator](): Generator<string | number, void>;
 }

three/src/math/Quaternion.d.ts

@@ -1,6 +1,8 @@
 import { Euler } from './Euler';
 import { Vector3 } from './Vector3';
 import { Matrix4 } from './Matrix4';
+import { BufferAttribute } from '../core/BufferAttribute';
+import { InterleavedBufferAttribute } from '../core/InterleavedBufferAttribute';
 
 /**
  * Implementation of a quaternion. This is used for rotating things without incurring in the dreaded gimbal lock issue, amongst other advantages.
@@ -136,6 +138,13 @@ export class Quaternion {
      */
     toArray(array: ArrayLike<number>, offset?: number): ArrayLike<number>;
 
+    /**
+     * Sets x, y, z, w properties of this quaternion from the attribute.
+     * @param attribute the source attribute.
+     * @param index index in the attribute.
+     */
+    fromBufferAttribute(attribute: BufferAttribute | InterleavedBufferAttribute, index: number): Quaternion;
+
     _onChange(callback: () => void): Quaternion;
     _onChangeCallback: () => void;
 
@@ -147,7 +156,7 @@ export class Quaternion {
         src1: number[],
         stcOffset1: number,
         t: number,
-    ): Quaternion;
+    ): void;
 
     static multiplyQuaternionsFlat(
         dst: number[],
@@ -168,11 +177,6 @@ export class Quaternion {
      */
     multiplyVector3(v: any): any;
 
-    /**
-     * @deprecated Use {@link Quaternion#invert .invert()} instead.
-     */
-    inverse(): Quaternion;
-
     random(): Quaternion;
 
     [Symbol.iterator](): Generator<number, void>;

three/src/renderers/WebGL3DRenderTarget.d.ts

@@ -12,7 +12,7 @@ export class WebGL3DRenderTarget extends WebGLRenderTarget {
      * @param height the height of the render target, in pixels.
      * @param depth the depth of the render target.
      */
-    constructor(width: number, height: number, depth: number);
+    constructor(width?: number, height?: number, depth?: number);
 
     /**
      * The depth of the render target.

three/src/renderers/WebGLArrayRenderTarget.d.ts

@@ -12,7 +12,7 @@ export class WebGLArrayRenderTarget extends WebGLRenderTarget {
      * @param height the height of the render target, in pixels.
      * @param depth the depth/layer count of the render target.
      */
-    constructor(width: number, height: number, depth: number);
+    constructor(width?: number, height?: number, depth?: number);
 
     /**
      * The depth of the render target.

three/src/renderers/WebGLCubeRenderTarget.d.ts

@@ -4,7 +4,7 @@ import { Texture } from './../textures/Texture';
 import { CubeTexture } from './../textures/CubeTexture';
 
 export class WebGLCubeRenderTarget extends WebGLRenderTarget {
-    constructor(size: number, options?: WebGLRenderTargetOptions);
+    constructor(size?: number, options?: WebGLRenderTargetOptions);
 
     texture: CubeTexture;
 

three/src/renderers/WebGLMultipleRenderTargets.d.ts

@@ -18,7 +18,7 @@ export class WebGLMultipleRenderTargets extends EventDispatcher {
      * @param options object that holds texture parameters for an auto-generated target texture and depthBuffer/stencilBuffer booleans.
      * For an explanation of the texture parameters see {@link Texture}.
      */
-    constructor(width: number, height: number, count: number, options?: WebGLRenderTargetOptions);
+    constructor(width?: number, height?: number, count?: number, options?: WebGLRenderTargetOptions);
 
     setSize(width: number, height: number, depth?: number): this;
     copy(source: WebGLMultipleRenderTargets): this;

three/src/renderers/WebGLRenderTarget.d.ts

@@ -26,7 +26,7 @@ export interface WebGLRenderTargetOptions {
 }
 
 export class WebGLRenderTarget extends EventDispatcher {
-    constructor(width: number, height: number, options?: WebGLRenderTargetOptions);
+    constructor(width?: number, height?: number, options?: WebGLRenderTargetOptions);
 
     width: number;
     height: number;

three/src/renderers/WebGLRenderer.d.ts

@@ -17,7 +17,7 @@ import { Material } from './../materials/Material';
 import { ToneMapping, ShadowMapType, CullFace, TextureEncoding } from '../constants';
 import { WebXRManager } from '../renderers/webxr/WebXRManager';
 import { BufferGeometry } from './../core/BufferGeometry';
-import { Texture } from '../textures/Texture';
+import { OffscreenCanvas, Texture } from '../textures/Texture';
 import { Data3DTexture } from '../textures/Data3DTexture';
 import { Vector3 } from '../math/Vector3';
 import { Box3 } from '../math/Box3';
@@ -31,10 +31,6 @@ export interface Renderer {
     setSize(width: number, height: number, updateStyle?: boolean): void;
 }
 
-/** This is only available in worker JS contexts, not the DOM. */
-// tslint:disable-next-line:no-empty-interface
-export interface OffscreenCanvas extends EventTarget {}
-
 export interface WebGLRendererParameters {
     /**
      * A Canvas where the renderer draws its output.

three/src/renderers/shaders/UniformsLib.d.ts

@@ -19,8 +19,9 @@ export let UniformsLib: {
         envMap: IUniform;
         flipEnvMap: IUniform;
         reflectivity: IUniform;
-        refractionRatio: IUniform;
-        maxMipLevel: IUniform;
+        ior: IUniform;
+        refractRatio: IUniform;
+        backgroundBlurriness: IUniform;
     };
     aomap: {
         aoMap: IUniform;

three/src/renderers/shaders/UniformsUtils.d.ts

@@ -1,4 +1,3 @@
-import { Uniform } from '../../core/Uniform';
 import { UniformsGroup } from '../../core/UniformsGroup';
 
 export function cloneUniforms(uniforms_src: any): any;

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

@@ -20,6 +20,7 @@ export class WebGLCapabilities {
     vertexTextures: boolean;
     floatFragmentTextures: boolean;
     floatVertexTextures: boolean;
+    maxSamples: number;
 
     getMaxAnisotropy(): number;
     getMaxPrecision(precision: string): string;

three/src/scenes/Scene.d.ts

@@ -22,17 +22,14 @@ export class Scene extends Object3D {
      */
     fog: FogBase | null;
 
+    backgroundBlurriness: number;
+
     /**
      * If not null, it will force everything in the scene to be rendered with that material. Default is null.
      * @default null
      */
     overrideMaterial: Material | null;
 
-    /**
-     * @default true
-     */
-    autoUpdate: boolean;
-
     /**
      * @default null
      */

three/src/textures/CanvasTexture.d.ts

@@ -1,4 +1,4 @@
-import { Texture } from './Texture';
+import { OffscreenCanvas, Texture } from './Texture';
 import { Mapping, Wrapping, TextureFilter, PixelFormat, TextureDataType } from '../constants';
 
 export class CanvasTexture extends Texture {
@@ -15,7 +15,7 @@ export class CanvasTexture extends Texture {
      * @param [encoding=THREE.LinearEncoding]
      */
     constructor(
-        canvas: HTMLImageElement | HTMLCanvasElement | HTMLVideoElement | ImageBitmap,
+        canvas: TexImageSource | OffscreenCanvas,
         mapping?: Mapping,
         wrapS?: Wrapping,
         wrapT?: Wrapping,

three/src/textures/CompressedArrayTexture.d.ts

@@ -0,0 +1,17 @@
+import { CompressedPixelFormat, TextureDataType, Wrapping } from '../constants';
+import { CompressedTexture } from './CompressedTexture.js';
+
+export class CompressedArrayTexture extends CompressedTexture {
+    isCompressedArrayTexture: true;
+
+    wrapR: Wrapping;
+
+    constructor(
+        mipmaps: ImageData[],
+        width: number,
+        height: number,
+        depth: number,
+        format?: CompressedPixelFormat,
+        type?: TextureDataType,
+    );
+}

three/src/textures/Texture.d.ts

@@ -12,6 +12,10 @@ import {
     TextureEncoding,
 } from '../constants';
 
+/** Shim for OffscreenCanvas. */
+// tslint:disable-next-line:no-empty-interface
+export interface OffscreenCanvas extends EventTarget {}
+
 export class Texture extends EventDispatcher {
     /**
      * @param [image]
@@ -26,7 +30,7 @@ export class Texture extends EventDispatcher {
      * @param [encoding=THREE.LinearEncoding]
      */
     constructor(
-        image?: HTMLImageElement | HTMLCanvasElement | HTMLVideoElement,
+        image?: TexImageSource | OffscreenCanvas,
         mapping?: Mapping,
         wrapS?: Wrapping,
         wrapT?: Wrapping,

three/examples/jsm/nodes/core/NodeVary.d.ts

@@ -1,6 +0,0 @@
-export default class NodeVary {
-    name: string;
-    type: string;
-    isNodeVary: boolean;
-    constructor(name: string, type: string);
-}

three/examples/jsm/renderers/webgl/nodes/WebGLPhysicalContextNode.d.ts

@@ -1,13 +0,0 @@
-import ContextNode from '../../../nodes/core/ContextNode.js';
-import Node from '../../../nodes/core/Node';
-
-export type WebGLPhysicalContextScope =
-    | typeof WebGLPhysicalContextNode.RADIANCE
-    | typeof WebGLPhysicalContextNode.IRRADIANCE;
-
-export default class WebGLPhysicalContextNode extends ContextNode {
-    static RADIANCE: 'radiance';
-    static IRRADIANCE: 'irradiance';
-
-    constructor(scope: WebGLPhysicalContextScope, node: Node);
-}