@types/three 0.160.0 → 0.161.0

three/src/math/Vector3.d.ts

@@ -1,19 +1,24 @@
 import { Euler } from './Euler.js';
 import { Matrix3 } from './Matrix3.js';
 import { Matrix4 } from './Matrix4.js';
-import { Quaternion } from './Quaternion.js';
+import { QuaternionLike } from './Quaternion.js';
 import { Camera } from '../cameras/Camera.js';
 import { Spherical } from './Spherical.js';
 import { Cylindrical } from './Cylindrical.js';
 import { BufferAttribute } from '../core/BufferAttribute.js';
 import { InterleavedBufferAttribute } from '../core/InterleavedBufferAttribute.js';
-import { Vector } from './Vector2.js';
-import { Color } from './Color.js';
+import { RGB } from './Color.js';
 
 export type Vector3Tuple = [number, number, number];
 
+export interface Vector3Like {
+    readonly x: number;
+    readonly y: number;
+    readonly z: number;
+}
+
 /**
- * 3D vector. ( class Vector3 implements Vector<Vector3> )
+ * 3D vector.
  *
  * see {@link https://github.com/mrdoob/three.js/blob/master/src/math/Vector3.js}
  *
@@ -23,7 +28,7 @@ export type Vector3Tuple = [number, number, number];
  * const c = new THREE.Vector3();
  * c.crossVectors( a, b );
  */
-export class Vector3 implements Vector {
+export class Vector3 {
     constructor(x?: number, y?: number, z?: number);
 
     /**
@@ -55,26 +60,20 @@ export class Vector3 implements Vector {
     /**
      * Sets x value of this vector.
      */
-    setX(x: number): Vector3;
+    setX(x: number): this;
 
     /**
      * Sets y value of this vector.
      */
-    setY(y: number): Vector3;
+    setY(y: number): this;
 
     /**
      * Sets z value of this vector.
      */
-    setZ(z: number): Vector3;
+    setZ(z: number): this;
 
     setComponent(index: number, value: number): this;
 
-    /**
-     * Sets this vector's {@link x}, {@link y} and {@link z} components from the r, g, and b components of the specified
-     * {@link Color | color}.
-     */
-    setFromColor(color: Color): this;
-
     getComponent(index: number): number;
 
     /**
@@ -85,42 +84,42 @@ export class Vector3 implements Vector {
     /**
      * Copies value of v to this vector.
      */
-    copy(v: Vector3): this;
+    copy(v: Vector3Like): this;
 
     /**
      * Adds v to this vector.
      */
-    add(v: Vector3): this;
+    add(v: Vector3Like): this;
 
     addScalar(s: number): this;
 
-    addScaledVector(v: Vector3, s: number): this;
-
     /**
      * Sets this vector to a + b.
      */
-    addVectors(a: Vector3, b: Vector3): this;
+    addVectors(a: Vector3Like, b: Vector3Like): this;
+
+    addScaledVector(v: Vector3, s: number): this;
 
     /**
      * Subtracts v from this vector.
      */
-    sub(a: Vector3): this;
+    sub(a: Vector3Like): this;
 
     subScalar(s: number): this;
 
     /**
      * Sets this vector to a - b.
      */
-    subVectors(a: Vector3, b: Vector3): this;
+    subVectors(a: Vector3Like, b: Vector3Like): this;
 
-    multiply(v: Vector3): this;
+    multiply(v: Vector3Like): this;
 
     /**
      * Multiplies this vector by scalar s.
      */
     multiplyScalar(s: number): this;
 
-    multiplyVectors(a: Vector3, b: Vector3): this;
+    multiplyVectors(a: Vector3Like, b: Vector3Like): this;
 
     applyEuler(euler: Euler): this;
 
@@ -132,7 +131,7 @@ export class Vector3 implements Vector {
 
     applyMatrix4(m: Matrix4): this;
 
-    applyQuaternion(q: Quaternion): this;
+    applyQuaternion(q: QuaternionLike): this;
 
     project(camera: Camera): this;
 
@@ -140,7 +139,7 @@ export class Vector3 implements Vector {
 
     transformDirection(m: Matrix4): this;
 
-    divide(v: Vector3): this;
+    divide(v: Vector3Like): this;
 
     /**
      * Divides this vector by scalar s.
@@ -148,11 +147,11 @@ export class Vector3 implements Vector {
      */
     divideScalar(s: number): this;
 
-    min(v: Vector3): this;
+    min(v: Vector3Like): this;
 
-    max(v: Vector3): this;
+    max(v: Vector3Like): this;
 
-    clamp(min: Vector3, max: Vector3): this;
+    clamp(min: Vector3Like, max: Vector3Like): this;
 
     clampScalar(min: number, max: number): this;
 
@@ -174,7 +173,7 @@ export class Vector3 implements Vector {
     /**
      * Computes dot product of this vector and v.
      */
-    dot(v: Vector3): number;
+    dot(v: Vector3Like): number;
 
     /**
      * Computes squared length of this vector.
@@ -186,14 +185,6 @@ export class Vector3 implements Vector {
      */
     length(): number;
 
-    /**
-     * Computes Manhattan length of this vector.
-     * http://en.wikipedia.org/wiki/Taxicab_geometry
-     *
-     * @deprecated Use {@link Vector3#manhattanLength .manhattanLength()} instead.
-     */
-    lengthManhattan(): number;
-
     /**
      * Computes the Manhattan length of this vector.
      *
@@ -201,13 +192,6 @@ export class Vector3 implements Vector {
      */
     manhattanLength(): number;
 
-    /**
-     * Computes the Manhattan length (distance) from this vector to the given vector v
-     *
-     * see {@link http://en.wikipedia.org/wiki/Taxicab_geometry|Wikipedia: Taxicab Geometry}
-     */
-    manhattanDistanceTo(v: Vector3): number;
-
     /**
      * Normalizes this vector.
      */
@@ -217,38 +201,40 @@ export class Vector3 implements Vector {
      * Normalizes this vector and multiplies it by l.
      */
     setLength(l: number): this;
-    lerp(v: Vector3, alpha: number): this;
+    lerp(v: Vector3Like, alpha: number): this;
 
-    lerpVectors(v1: Vector3, v2: Vector3, alpha: number): this;
+    lerpVectors(v1: Vector3Like, v2: Vector3Like, alpha: number): this;
 
     /**
      * Sets this vector to cross product of itself and v.
      */
-    cross(a: Vector3): this;
+    cross(a: Vector3Like): this;
 
     /**
      * Sets this vector to cross product of a and b.
      */
-    crossVectors(a: Vector3, b: Vector3): this;
+    crossVectors(a: Vector3Like, b: Vector3Like): this;
     projectOnVector(v: Vector3): this;
     projectOnPlane(planeNormal: Vector3): this;
-    reflect(vector: Vector3): this;
+    reflect(vector: Vector3Like): this;
     angleTo(v: Vector3): number;
 
     /**
      * Computes distance of this vector to v.
      */
-    distanceTo(v: Vector3): number;
+    distanceTo(v: Vector3Like): number;
 
     /**
      * Computes squared distance of this vector to v.
      */
-    distanceToSquared(v: Vector3): number;
+    distanceToSquared(v: Vector3Like): number;
 
     /**
-     * @deprecated Use {@link Vector3#manhattanDistanceTo .manhattanDistanceTo()} instead.
+     * Computes the Manhattan length (distance) from this vector to the given vector v
+     *
+     * see {@link http://en.wikipedia.org/wiki/Taxicab_geometry|Wikipedia: Taxicab Geometry}
      */
-    distanceToManhattan(v: Vector3): number;
+    manhattanDistanceTo(v: Vector3Like): number;
 
     setFromSpherical(s: Spherical): this;
     setFromSphericalCoords(r: number, phi: number, theta: number): this;
@@ -264,10 +250,16 @@ export class Vector3 implements Vector {
      */
     setFromEuler(e: Euler): this;
 
+    /**
+     * Sets this vector's {@link x}, {@link y} and {@link z} components from the r, g, and b components of the specified
+     * {@link Color | color}.
+     */
+    setFromColor(color: RGB): this;
+
     /**
      * Checks for strict equality of this vector and v.
      */
-    equals(v: Vector3): boolean;
+    equals(v: Vector3Like): boolean;
 
     /**
      * Sets this vector's x, y and z value from the provided array or array-like.

three/src/math/Vector4.d.ts

@@ -1,16 +1,20 @@
 import { Matrix4 } from './Matrix4.js';
-import { Quaternion } from './Quaternion.js';
+import { QuaternionLike } from './Quaternion.js';
 import { BufferAttribute } from '../core/BufferAttribute.js';
-import { Vector } from './Vector2.js';
 
 export type Vector4Tuple = [number, number, number, number];
 
+export interface Vector4Like {
+    readonly x: number;
+    readonly y: number;
+    readonly z: number;
+    readonly w: number;
+}
+
 /**
  * 4D vector.
- *
- * ( class Vector4 implements Vector<Vector4> )
  */
-export class Vector4 implements Vector {
+export class Vector4 {
     constructor(x?: number, y?: number, z?: number, w?: number);
 
     /**
@@ -79,34 +83,34 @@ export class Vector4 implements Vector {
     /**
      * Copies value of v to this vector.
      */
-    copy(v: Vector4): this;
+    copy(v: Vector4Like): this;
 
     /**
      * Adds v to this vector.
      */
-    add(v: Vector4): this;
+    add(v: Vector4Like): this;
 
     addScalar(scalar: number): this;
 
     /**
      * Sets this vector to a + b.
      */
-    addVectors(a: Vector4, b: Vector4): this;
+    addVectors(a: Vector4Like, b: Vector4Like): this;
 
-    addScaledVector(v: Vector4, s: number): this;
+    addScaledVector(v: Vector4Like, s: number): this;
     /**
      * Subtracts v from this vector.
      */
-    sub(v: Vector4): this;
+    sub(v: Vector4Like): this;
 
     subScalar(s: number): this;
 
     /**
      * Sets this vector to a - b.
      */
-    subVectors(a: Vector4, b: Vector4): this;
+    subVectors(a: Vector4Like, b: Vector4Like): this;
 
-    multiply(v: Vector4): this;
+    multiply(v: Vector4Like): this;
 
     /**
      * Multiplies this vector by scalar s.
@@ -125,7 +129,7 @@ export class Vector4 implements Vector {
      * http://www.euclideanspace.com/maths/geometry/rotations/conversions/quaternionToAngle/index.htm
      * @param q is assumed to be normalized
      */
-    setAxisAngleFromQuaternion(q: Quaternion): this;
+    setAxisAngleFromQuaternion(q: QuaternionLike): this;
 
     /**
      * http://www.euclideanspace.com/maths/geometry/rotations/conversions/matrixToAngle/index.htm
@@ -133,9 +137,9 @@ export class Vector4 implements Vector {
      */
     setAxisAngleFromRotationMatrix(m: Matrix4): this;
 
-    min(v: Vector4): this;
-    max(v: Vector4): this;
-    clamp(min: Vector4, max: Vector4): this;
+    min(v: Vector4Like): this;
+    max(v: Vector4Like): this;
+    clamp(min: Vector4Like, max: Vector4Like): this;
     clampScalar(min: number, max: number): this;
     floor(): this;
     ceil(): this;
@@ -150,7 +154,7 @@ export class Vector4 implements Vector {
     /**
      * Computes dot product of this vector and v.
      */
-    dot(v: Vector4): number;
+    dot(v: Vector4Like): number;
 
     /**
      * Computes squared length of this vector.
@@ -173,6 +177,7 @@ export class Vector4 implements Vector {
      * Normalizes this vector.
      */
     normalize(): this;
+
     /**
      * Normalizes this vector and multiplies it by l.
      */
@@ -181,14 +186,14 @@ export class Vector4 implements Vector {
     /**
      * Linearly interpolate between this vector and v with alpha factor.
      */
-    lerp(v: Vector4, alpha: number): this;
+    lerp(v: Vector4Like, alpha: number): this;
 
-    lerpVectors(v1: Vector4, v2: Vector4, alpha: number): this;
+    lerpVectors(v1: Vector4Like, v2: Vector4Like, alpha: number): this;
 
     /**
      * Checks for strict equality of this vector and v.
      */
-    equals(v: Vector4): boolean;
+    equals(v: Vector4Like): boolean;
 
     /**
      * Sets this vector's x, y, z and w value from the provided array or array-like.

three/src/objects/BatchedMesh.d.ts

@@ -162,8 +162,8 @@ declare class BatchedMesh extends Mesh<BufferGeometry, Material> {
      */
     deleteGeometry(index: number): this;
 
-    getBoundingBoxAt(index: number, target: Box3): Box3;
-    getBoundingSphereAt(index: number, target: Sphere): Sphere;
+    getBoundingBoxAt(index: number, target: Box3): Box3 | null;
+    getBoundingSphereAt(index: number, target: Sphere): Sphere | null;
 }
 
 export { BatchedMesh };

three/src/objects/Bone.d.ts

@@ -1,4 +1,4 @@
-import { Object3D } from '../core/Object3D.js';
+import { Object3D, Object3DEventMap } from '../core/Object3D.js';
 
 /**
  * A {@link Bone} which is part of a {@link THREE.Skeleton | Skeleton}
@@ -15,7 +15,7 @@ import { Object3D } from '../core/Object3D.js';
  * @see {@link https://threejs.org/docs/index.html#api/en/objects/Bone | Official Documentation}
  * @see {@link https://github.com/mrdoob/three.js/blob/master/src/objects/Bone.js | Source}
  */
-export class Bone extends Object3D {
+export class Bone<TEventMap extends Object3DEventMap = Object3DEventMap> extends Object3D<TEventMap> {
     /**
      * Creates a new {@link Bone}.
      */

three/src/objects/InstancedMesh.d.ts

@@ -28,7 +28,8 @@ export interface InstancedMeshEventMap extends Object3DEventMap {
 export class InstancedMesh<
     TGeometry extends BufferGeometry = BufferGeometry,
     TMaterial extends Material | Material[] = Material | Material[],
-> extends Mesh<TGeometry, TMaterial, InstancedMeshEventMap> {
+    TEventMap extends InstancedMeshEventMap = InstancedMeshEventMap,
+> extends Mesh<TGeometry, TMaterial, TEventMap> {
     /**
      * Create a new instance of {@link InstancedMesh}
      * @param geometry An instance of {@link THREE.BufferGeometry | BufferGeometry}.

three/src/objects/LOD.d.ts

@@ -1,4 +1,4 @@
-import { Object3D } from '../core/Object3D.js';
+import { Object3D, Object3DEventMap } from '../core/Object3D.js';
 import { Camera } from '../cameras/Camera.js';
 
 /**
@@ -20,7 +20,7 @@ import { Camera } from '../cameras/Camera.js';
  * @see {@link https://threejs.org/docs/index.html#api/en/objects/LOD | Official Documentation}
  * @see {@link https://github.com/mrdoob/three.js/blob/master/src/objects/LOD.js | Source}
  */
-export class LOD extends Object3D {
+export class LOD<TEventMap extends Object3DEventMap = Object3DEventMap> extends Object3D<TEventMap> {
     /**
      * Creates a new {@link LOD}.
      */

three/src/objects/Line.d.ts

@@ -1,5 +1,5 @@
 import { Material } from '../materials/Material.js';
-import { Object3D } from '../core/Object3D.js';
+import { Object3D, Object3DEventMap } from '../core/Object3D.js';
 import { BufferGeometry } from '../core/BufferGeometry.js';
 
 /**
@@ -27,7 +27,8 @@ import { BufferGeometry } from '../core/BufferGeometry.js';
 export class Line<
     TGeometry extends BufferGeometry = BufferGeometry,
     TMaterial extends Material | Material[] = Material | Material[],
-> extends Object3D {
+    TEventMap extends Object3DEventMap = Object3DEventMap,
+> extends Object3D<TEventMap> {
     /**
      * Create a new instance of {@link Line}
      * @param geometry Vertices representing the {@link Line} segment(s). Default {@link THREE.BufferGeometry | `new THREE.BufferGeometry()`}.

three/src/objects/LineLoop.d.ts

@@ -1,6 +1,7 @@
 import { Line } from './Line.js';
 import { Material } from '../materials/Material.js';
 import { BufferGeometry } from '../core/BufferGeometry.js';
+import { Object3DEventMap } from '../core/Object3D.js';
 
 /**
  * A continuous line that connects back to the start.
@@ -15,7 +16,8 @@ import { BufferGeometry } from '../core/BufferGeometry.js';
 export class LineLoop<
     TGeometry extends BufferGeometry = BufferGeometry,
     TMaterial extends Material | Material[] = Material | Material[],
-> extends Line<TGeometry, TMaterial> {
+    TEventMap extends Object3DEventMap = Object3DEventMap,
+> extends Line<TGeometry, TMaterial, TEventMap> {
     /**
      * Create a new instance of {@link LineLoop}
      * @param geometry  List of vertices representing points on the line loop. Default {@link THREE.BufferGeometry | `new THREE.BufferGeometry()`}.

three/src/objects/LineSegments.d.ts

@@ -1,6 +1,7 @@
 import { Material } from '../materials/Material.js';
 import { Line } from './Line.js';
 import { BufferGeometry } from '../core/BufferGeometry.js';
+import { Object3DEventMap } from '../core/Object3D.js';
 
 /**
  * A series of lines drawn between pairs of vertices.
@@ -14,7 +15,8 @@ import { BufferGeometry } from '../core/BufferGeometry.js';
 export class LineSegments<
     TGeometry extends BufferGeometry = BufferGeometry,
     TMaterial extends Material | Material[] = Material | Material[],
-> extends Line<TGeometry, TMaterial> {
+    TEventMap extends Object3DEventMap = Object3DEventMap,
+> extends Line<TGeometry, TMaterial, TEventMap> {
     /**
      * Create a new instance of {@link LineSegments}
      * @param geometry Pair(s) of vertices representing each line segment(s). Default {@link THREE.BufferGeometry | `new THREE.BufferGeometry()`}.

three/src/objects/Points.d.ts

@@ -1,5 +1,5 @@
 import { Material } from '../materials/Material.js';
-import { Object3D } from '../core/Object3D.js';
+import { Object3D, Object3DEventMap } from '../core/Object3D.js';
 import { BufferGeometry, NormalOrGLBufferAttributes } from '../core/BufferGeometry.js';
 import { BufferAttribute } from '../core/BufferAttribute.js';
 import { InterleavedBufferAttribute } from '../core/InterleavedBufferAttribute.js';
@@ -15,7 +15,8 @@ import { GLBufferAttribute } from '../core/GLBufferAttribute.js';
 export class Points<
     TGeometry extends BufferGeometry<NormalOrGLBufferAttributes> = BufferGeometry,
     TMaterial extends Material | Material[] = Material | Material[],
-> extends Object3D {
+    TEventMap extends Object3DEventMap = Object3DEventMap,
+> extends Object3D<TEventMap> {
     /**
      * Create a new instance of {@link Points}
      * @param geometry An instance of {@link THREE.BufferGeometry | BufferGeometry}. Default {@link THREE.BufferGeometry | `new THREE.BufferGeometry()`}.

three/src/objects/SkinnedMesh.d.ts

@@ -5,6 +5,7 @@ import { Vector3 } from '../math/Vector3.js';
 import { Skeleton } from './Skeleton.js';
 import { Mesh } from './Mesh.js';
 import { BufferGeometry } from '../core/BufferGeometry.js';
+import { Object3DEventMap } from '../core/Object3D.js';
 import { Sphere } from '../math/Sphere.js';
 import { BindMode } from '../constants.js';
 
@@ -50,7 +51,8 @@ import { BindMode } from '../constants.js';
 export class SkinnedMesh<
     TGeometry extends BufferGeometry = BufferGeometry,
     TMaterial extends Material | Material[] = Material | Material[],
-> extends Mesh<TGeometry, TMaterial> {
+    TEventMap extends Object3DEventMap = Object3DEventMap,
+> extends Mesh<TGeometry, TMaterial, TEventMap> {
     /**
      * Create a new instance of {@link SkinnedMesh}
      * @param geometry An instance of {@link THREE.BufferGeometry | BufferGeometry}. Default {@link THREE.BufferGeometry | `new THREE.BufferGeometry()`}.
@@ -148,9 +150,4 @@ export class SkinnedMesh<
      * @param vector
      */
     applyBoneTransform(index: number, vector: Vector3): Vector3;
-
-    /**
-     * @deprecated {@link THREE.SkinnedMesh}: {@link boneTransform | .boneTransform()} was renamed to {@link applyBoneTransform | .applyBoneTransform()} in **r151**.
-     */
-    boneTransform(index: number, target: Vector3): Vector3;
 }

three/src/objects/Sprite.d.ts

@@ -1,5 +1,5 @@
 import { Vector2 } from '../math/Vector2.js';
-import { Object3D } from '../core/Object3D.js';
+import { Object3D, Object3DEventMap } from '../core/Object3D.js';
 import { SpriteMaterial } from '../materials/Materials.js';
 import { BufferGeometry } from '../core/BufferGeometry.js';
 
@@ -18,7 +18,7 @@ import { BufferGeometry } from '../core/BufferGeometry.js';
  * @see {@link https://threejs.org/docs/index.html#api/en/objects/Sprite | Official Documentation}
  * @see {@link https://github.com/mrdoob/three.js/blob/master/src/objects/Sprite.js | Source}
  */
-export class Sprite extends Object3D {
+export class Sprite<TEventMap extends Object3DEventMap = Object3DEventMap> extends Object3D<TEventMap> {
     /**
      * Creates a new Sprite.
      * @param material An instance of {@link THREE.SpriteMaterial | SpriteMaterial}. Default {@link THREE.SpriteMaterial | `new SpriteMaterial()`}, _with white color_.

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

@@ -1,5 +1,4 @@
 import { WebGLRenderer } from '../WebGLRenderer.js';
-import { WebGLShader } from './WebGLShader.js';
 import { WebGLUniforms } from './WebGLUniforms.js';
 
 export class WebGLProgram {

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

@@ -46,6 +46,7 @@ export interface WebGLProgramParameters {
 
     supportsVertexTextures: boolean;
     outputColorSpace: ColorSpace;
+    alphaToCoverage: boolean;
 
     map: boolean;
     matcap: boolean;
@@ -146,7 +147,7 @@ export interface WebGLProgramParameters {
 
     fog: boolean;
     useFog: boolean;
-    fogExp2: boolean | null; // null is possible because of a bug: ( fog && fog.isFogExp2 )
+    fogExp2: boolean;
 
     flatShading: boolean;
 
@@ -203,6 +204,7 @@ export interface WebGLProgramParameters {
     extensionDrawBuffers: boolean;
     extensionShaderTextureLOD: boolean;
     extensionClipCullDistance: boolean;
+    extensionMultiDraw: boolean;
 
     rendererExtensionFragDepth: boolean;
     rendererExtensionDrawBuffers: boolean;

three/src/renderers/webxr/WebXRDepthSensing.d.ts

@@ -0,0 +1,27 @@
+import { Texture } from '../../textures/Texture.js';
+import { Mesh } from '../../objects/Mesh.js';
+import { WebGLRenderer } from '../WebGLRenderer.js';
+import { WebXRArrayCamera } from './WebXRManager.js';
+
+// FIXME Replace by XRWebGLDepthInformation when typed in @types/webxr
+interface XRWebGLDepthInformation {
+    readonly texture: WebGLTexture;
+    readonly depthNear: number;
+    readonly depthFar: number;
+}
+
+export class WebXRDepthSensing {
+    texture: Texture | null;
+    mesh: Mesh | null;
+
+    depthNear: number;
+    depthFar: number;
+
+    constructor();
+
+    init(renderer: WebGLRenderer, depthData: XRWebGLDepthInformation, renderState: XRRenderState): void;
+
+    render(renderer: WebGLRenderer, cameraXR: WebXRArrayCamera): void;
+
+    reset(): void;
+}

three/src/renderers/webxr/WebXRManager.d.ts

@@ -7,6 +7,7 @@ import { ArrayCamera } from '../../cameras/ArrayCamera.js';
 import { PerspectiveCamera } from '../../cameras/PerspectiveCamera.js';
 import { EventDispatcher } from '../../core/EventDispatcher.js';
 import { XRTargetRaySpace, XRGripSpace, XRHandSpace } from './WebXRController.js';
+import { WebGLRenderer } from '../WebGLRenderer.js';
 
 export type WebXRCamera = PerspectiveCamera & { viewport: Vector4 };
 export type WebXRArrayCamera = Omit<ArrayCamera, 'cameras'> & { cameras: [WebXRCamera, WebXRCamera] };
@@ -21,7 +22,7 @@ export interface WebXRManagerEventMap {
 }
 
 export class WebXRManager extends EventDispatcher<WebXRManagerEventMap> {
-    constructor(renderer: any, gl: WebGLRenderingContext);
+    constructor(renderer: WebGLRenderer, gl: WebGLRenderingContext);
 
     /**
      * @default false

three/src/textures/DataArrayTexture.d.ts

@@ -53,7 +53,7 @@ export class DataArrayTexture extends Texture {
      * @param height Height of the texture. Default `1`.
      * @param depth Depth of the texture. Default `1`.
      */
-    constructor(data?: BufferSource, width?: number, height?: number, depth?: number);
+    constructor(data?: BufferSource | null, width?: number, height?: number, depth?: number);
 
     /**
      * Read-only flag to check if a given object is of type {@link DataArrayTexture}.

three/src/textures/Source.d.ts

@@ -26,7 +26,17 @@ export class Source {
     data: any;
 
     /**
-     * Set this to `true` to trigger a data upload to the GPU next time the {@link Source} is used.
+     * This property is only relevant when {@link .needsUpdate} is set to `true` and provides more control on how
+     * texture data should be processed.
+     * When `dataReady` is set to `false`, the engine performs the memory allocation (if necessary) but does not
+     * transfer the data into the GPU memory.
+     * @default true
+     */
+    dataReady: boolean;
+
+    /**
+     * When the property is set to `true`, the engine allocates the memory for the texture (if necessary) and triggers
+     * the actual texture upload to the GPU next time the source is used.
      */
     set needsUpdate(value: boolean);
 

three/build/three.d.ts

@@ -1,2 +0,0 @@
-export * from '../src/Three.js';
-export as namespace THREE;

three/build/three.min.d.ts

@@ -1,2 +0,0 @@
-export * from '../src/Three.js';
-export as namespace THREE;