@types/three 0.151.0 → 0.152.0

three/README.md

@@ -8,8 +8,8 @@ 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: Fri, 28 Apr 2023 20:02:51 GMT
- * Dependencies: [@types/fflate](https://npmjs.com/package/@types/fflate), [@types/lil-gui](https://npmjs.com/package/@types/lil-gui), [@types/stats.js](https://npmjs.com/package/@types/stats.js), [@types/webxr](https://npmjs.com/package/@types/webxr)
+ * Last updated: Thu, 04 May 2023 00:02:50 GMT
+ * Dependencies: [@types/fflate](https://npmjs.com/package/@types/fflate), [@types/lil-gui](https://npmjs.com/package/@types/lil-gui), [@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`
 
 # Credits

three/build/three.min.d.ts

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

three/build/three.module.min.d.ts

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

three/examples/jsm/libs/tween.module.d.ts

@@ -0,0 +1,2 @@
+export * from '@tweenjs/tween.js';
+export { default } from '@tweenjs/tween.js';

three/examples/jsm/nodes/Nodes.d.ts

@@ -27,7 +27,8 @@ export { default as UniformNode } from './core/UniformNode';
 export { default as VarNode } from './core/VarNode';
 export { default as VaryingNode } from './core/VaryingNode';
 
-export * as NodeUtils from './core/NodeUtils.js';
+import * as NodeUtils from './core/NodeUtils.js';
+export { NodeUtils };
 
 // math
 export {
@@ -141,7 +142,7 @@ export { default as DFGApprox } from './functions/BSDF/DFGApprox';
 export { default as F_Schlick } from './functions/BSDF/F_Schlick';
 export { default as V_GGX_SmithCorrelated } from './functions/BSDF/V_GGX_SmithCorrelated';
 
-export { default as getDistanceAttenuation } from './functions/light/getDistanceAttenuation';
+export { getDistanceAttenuation } from './lighting/LightUtils';
 
 export { default as getGeometryRoughness } from './functions/material/getGeometryRoughness';
 export { default as getRoughness } from './functions/material/getRoughness';

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

@@ -45,7 +45,6 @@ export default abstract class NodeBuilder {
     updateNodes: Node[];
     hashNodes: { [hash: string]: Node };
 
-    scene: Scene;
     lightsNode: LightsNode;
     fogNode: FogNode;
 
@@ -85,13 +84,6 @@ export default abstract class NodeBuilder {
 
     isFlipY(): boolean;
 
-    abstract getTexture(textureProperty: string, uvSnippet: string): string;
-
-    abstract getTextureLevel(textureProperty: string, uvSnippet: string, levelSnippet: string): string;
-
-    abstract getCubeTexture(textureProperty: string, uvSnippet: string): string;
-    abstract getCubeTextureLevel(textureProperty: string, uvSnippet: string, levelSnippet: string): string;
-
     // @TODO: rename to .generateConst()
     getConst(type: NodeTypeOption, value?: unknown): Node;
     getType(type: NodeTypeOption): NodeTypeOption;

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

@@ -9,6 +9,7 @@ export const NodeShaderStage: {
 export const NodeUpdateType: {
     NONE: 'none';
     FRAME: 'frame';
+    RENDER: 'render';
     OBJECT: 'object';
 };
 

three/examples/jsm/nodes/lighting/LightUtils.d.ts

@@ -0,0 +1,4 @@
+import { ShaderNode } from '../shadernode/ShaderNode';
+import Node from '../core/Node';
+
+export const getDistanceAttenuation: ShaderNode<{ lightDistance: Node; cutoffDistance: Node; decayExponent: Node }>;

three/examples/jsm/nodes/materials/LineBasicNodeMaterial.d.ts

@@ -1,16 +1,9 @@
 import NodeMaterial from './NodeMaterial';
 import { ShaderMaterialParameters } from '../../../../src/Three';
-import { Node } from '../Nodes';
 
 export default class LineBasicNodeMaterial extends NodeMaterial {
     isLineBasicNodeMaterial: true;
 
-    colorNode: Node | null;
-    opacityNode: Node | null;
-    alphaTestNode: Node | null;
-    lightNode: Node | null;
-    positionNode: Node | null;
-
     constructor(parameters?: ShaderMaterialParameters);
     copy(source: LineBasicNodeMaterial): this;
 }

three/examples/jsm/nodes/materials/MeshBasicNodeMaterial.d.ts

@@ -1,19 +1,10 @@
 import NodeMaterial from './NodeMaterial';
-import Node from '../core/Node';
 import { ShaderMaterialParameters } from '../../../../src/Three';
 
 export default class MeshBasicNodeMaterial extends NodeMaterial {
     isMeshBasicNodeMaterial: true;
     lights: true;
 
-    colorNode: Node | null;
-    opacityNode: Node | null;
-
-    alphaTestNode: Node | null;
-    lightNode: Node | null;
-
-    positionNode: Node | null;
-
     constructor(paramters?: ShaderMaterialParameters);
     copy(source: MeshBasicNodeMaterial): this;
 }

three/examples/jsm/nodes/materials/MeshStandardNodeMaterial.d.ts

@@ -5,10 +5,6 @@ import NodeMaterial from './NodeMaterial';
 export default class MeshStandardNodeMaterial extends NodeMaterial {
     isMeshStandardNodeMaterial: true;
 
-    colorNode: Node | null;
-    opacityNode: Node | null;
-    alphaTestNode: Node | null;
-    normalNode: Node | null;
     emissiveNode: Node | null;
 
     metalnessNode: Node | null;
@@ -17,11 +13,6 @@ export default class MeshStandardNodeMaterial extends NodeMaterial {
     clearcoatNode: Node | null;
     clearcoatRoughnessNode: Node | null;
 
-    envNode: Node | null;
-
-    lightsNode: Node | null;
-    positionNode: Node | null;
-
     constructor(paramters?: ShaderMaterialParameters);
     copy(source: MeshStandardNodeMaterial): this;
 }

three/examples/jsm/nodes/materials/NodeMaterial.d.ts

@@ -5,8 +5,24 @@ import { LightingModelNode } from '../lighting/LightingContextNode';
 
 export default class NodeMaterial extends ShaderMaterial {
     isNodeMaterial: true;
-    lights: true;
+
     type: string;
+
+    lights: true;
+    normals: true;
+
+    lightsNode: Node | null;
+    envNode: Node | null;
+
+    colorNode: Node | null;
+    normalNode: Node | null;
+    opacityNode: Node | null;
+    backdropNode: Node | null;
+    backdropAlphaNode: Node | null;
+    alphaTestNode: Node | null;
+
+    positionNode: Node | null;
+
     constructor();
 
     build(builder: NodeBuilder): void;

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

@@ -56,8 +56,6 @@ export { default as DFGApprox } from '../functions/BSDF/DFGApprox';
 export { default as F_Schlick } from '../functions/BSDF/F_Schlick';
 export { default as V_GGX_SmithCorrelated } from '../functions/BSDF/V_GGX_SmithCorrelated';
 
-export { default as getDistanceAttenuation } from '../functions/light/getDistanceAttenuation';
-
 export { default as getGeometryRoughness } from '../functions/material/getGeometryRoughness';
 export { default as getRoughness } from '../functions/material/getRoughness';
 

three/examples/jsm/renderers/CSS3DRenderer.d.ts

@@ -12,9 +12,9 @@ export class CSS3DSprite extends CSS3DObject {
     constructor(element: HTMLElement);
 }
 
-export type CSS3DParameters = {
+export interface CSS3DParameters {
     element?: HTMLElement;
-};
+}
 
 export class CSS3DRenderer {
     constructor(parameters?: CSS3DParameters);

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

@@ -13,25 +13,6 @@ export class WebGLNodeBuilder extends NodeBuilder {
 
     addSlot(shaderStage: NodeShaderStageOption, slotNode: SlotNode): Node;
 
-    getTexture(textureProperty: string, uvSnippet: string): string;
-    getTextureBias(textureProperty: string, uvSnippet: string, biasSnippet: string): string;
-
-    getTextureLevel(
-        textureProperty: string,
-        uvSnippet: string,
-        biasSnippet: string,
-        shaderStage?: NodeShaderStageOption,
-    ): string;
-    getCubeTexture(texturePropert: string, uvSnippet: string, shaderStage?: NodeShaderStageOption): string;
-
-    getCubeTextureLevel(
-        textureProperty: string,
-        uvSnippet: string,
-        biasSnippet: string,
-        shaderStage?: NodeShaderStageOption,
-    ): string;
-
-    getCubeTextureBias(textureProperty: string, uvSnippet: string, biasSnippet: string): string;
     getUniforms(shaderStage: string): string;
 
     getAttributes(shaderStage: string): string;

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

@@ -1,4 +1,6 @@
-import { AnimationClip, Bone, Matrix4, Object3D, Skeleton, SkeletonHelper } from '../../../src/Three';
+import { AnimationClip, Object3D, Skeleton } from '../../../src/Three';
+
+export function clone(source: Object3D): Object3D;
 
 export function retarget(target: Object3D | Skeleton, source: Object3D | Skeleton, options: {}): void;
 
@@ -8,21 +10,3 @@ export function retargetClip(
     clip: AnimationClip,
     options: {},
 ): AnimationClip;
-
-export function getHelperFromSkeleton(skeleton: Skeleton): SkeletonHelper;
-
-export function getSkeletonOffsets(target: Object3D | Skeleton, source: Object3D | Skeleton, options: {}): Matrix4[];
-
-export function renameBones(skeleton: Skeleton, names: {}): any;
-
-export function getBones(skeleton: Skeleton | Bone[]): Bone[];
-
-export function getBoneByName(name: string, skeleton: Skeleton): Bone;
-
-export function getNearestBone(bone: Bone, names: {}): Bone;
-
-export function findBoneTrackData(name: string, tracks: any[]): {};
-
-export function getEqualsBonesNames(skeleton: Skeleton, targetSkeleton: Skeleton): string[];
-
-export function clone(source: Object3D): Object3D;

three/index.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for three 0.151
+// Type definitions for three 0.152
 // 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.151.0",
+    "version": "0.152.0",
     "description": "TypeScript definitions for three",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/three",
     "license": "MIT",
@@ -25,12 +25,13 @@
     },
     "scripts": {},
     "dependencies": {
+        "@tweenjs/tween.js": "~18.6.4",
         "@types/stats.js": "*",
         "@types/webxr": "*",
         "fflate": "~0.6.9",
         "lil-gui": "~0.17.0"
     },
-    "typesPublisherContentHash": "d8fac10d09ead80aa5112cb6407ef75e354363f34bdd002bfb12b3c5d40cb691",
+    "typesPublisherContentHash": "c206b6e9fcb60fc53d60b9c172bf339b663fa61d521aa358641f9b16d55913ed",
     "typeScriptVersion": "4.4",
     "exports": {
         ".": {

three/src/constants.d.ts

@@ -681,11 +681,14 @@ export type TrianglesDrawModes = typeof TrianglesDrawMode | typeof TriangleStrip
 ///////////////////////////////////////////////////////////////////////////////
 // Texture Encodings
 
+/** @deprecated Use {@link LinearSRGBColorSpace} or {@link NoColorSpace} in three.js r152+. */
 export const LinearEncoding: 3000;
+/** @deprecated Use {@link SRGBColorSpace} in three.js r152+. */
 export const sRGBEncoding: 3001;
 /**
  * Texture Encodings.
  * @see {@link https://threejs.org/docs/index.html#api/en/constants/Textures | Texture Constants}
+ * @deprecated Use {@link ColorSpace} in three.js r152+.
  */
 export type TextureEncoding = typeof LinearEncoding | typeof sRGBEncoding;
 
@@ -901,26 +904,3 @@ export type PixelFormatGPU =
     | 'DEPTH_COMPONENT32F'
     | 'DEPTH24_STENCIL8'
     | 'DEPTH32F_STENCIL8';
-
-///////////////////////////////////////////////////////////////////////////////
-
-export type BuiltinShaderAttributeName =
-    | 'position'
-    | 'normal'
-    | 'uv'
-    | 'color'
-    | 'skinIndex'
-    | 'skinWeight'
-    | 'instanceMatrix'
-    | 'morphTarget0'
-    | 'morphTarget1'
-    | 'morphTarget2'
-    | 'morphTarget3'
-    | 'morphTarget4'
-    | 'morphTarget5'
-    | 'morphTarget6'
-    | 'morphTarget7'
-    | 'morphNormal0'
-    | 'morphNormal1'
-    | 'morphNormal2'
-    | 'morphNormal3';

three/src/core/BufferGeometry.d.ts

@@ -1,15 +1,19 @@
 import { BufferAttribute } from './BufferAttribute';
 import { InterleavedBufferAttribute } from './InterleavedBufferAttribute';
-import { GLBufferAttribute } from './GLBufferAttribute';
-import { Box3 } from './../math/Box3';
-import { Sphere } from './../math/Sphere';
-import { Matrix4 } from './../math/Matrix4';
-import { Quaternion } from './../math/Quaternion';
-import { Vector2 } from './../math/Vector2';
-import { Vector3 } from './../math/Vector3';
+import { Box3 } from '../math/Box3';
+import { Sphere } from '../math/Sphere';
+import { Matrix4 } from '../math/Matrix4';
+import { Quaternion } from '../math/Quaternion';
+import { Vector2 } from '../math/Vector2';
+import { Vector3 } from '../math/Vector3';
 import { EventDispatcher } from './EventDispatcher';
-import { BuiltinShaderAttributeName } from '../constants';
-import * as BufferGeometryUtils from '../../examples/jsm/utils/BufferGeometryUtils';
+import { GLBufferAttribute } from './GLBufferAttribute';
+
+export type NormalBufferAttributes = Record<string, BufferAttribute | InterleavedBufferAttribute>;
+export type NormalOrGLBufferAttributes = Record<
+    string,
+    BufferAttribute | InterleavedBufferAttribute | GLBufferAttribute
+>;
 
 /**
  * A representation of mesh, line, or point geometry
@@ -19,20 +23,46 @@ import * as BufferGeometryUtils from '../../examples/jsm/utils/BufferGeometryUti
  * @example
  * ```typescript
  * const geometry = new THREE.BufferGeometry();
+ *
  * // create a simple square shape. We duplicate the top left and bottom right
  * // vertices because each vertex needs to appear once per triangle.
- * const vertices = new Float32Array([
- *         -1.0, -1.0, 1.0,
- *          1.0, -1.0, 1.0,
- *          1.0,  1.0, 1.0,
+ * const vertices = new Float32Array( [
+ *   -1.0, -1.0,  1.0, // v0
+ *    1.0, -1.0,  1.0, // v1
+ *    1.0,  1.0,  1.0, // v2
+ *
+ *    1.0,  1.0,  1.0, // v3
+ *   -1.0,  1.0,  1.0, // v4
+ *   -1.0, -1.0,  1.0  // v5
+ * ] );
  *
- *          1.0,  1.0, 1.0,
- *         -1.0,  1.0, 1.0,
- *         -1.0, -1.0, 1.0]);
  * // itemSize = 3 because there are 3 values (components) per vertex
- * geometry.setAttribute('position', new THREE.BufferAttribute(vertices, 3));
- * const material = new THREE.MeshBasicMaterial({ color: 0xff0000 });
- * const mesh = new THREE.Mesh(geometry, material);
+ * geometry.setAttribute( 'position', new THREE.BufferAttribute( vertices, 3 ) );
+ * const material = new THREE.MeshBasicMaterial( { color: 0xff0000 } );
+ * const mesh = new THREE.Mesh( geometry, material );
+ * ```
+ * @example
+ * ```typescript
+ * const geometry = new THREE.BufferGeometry();
+ *
+ * const vertices = new Float32Array( [
+ *   -1.0, -1.0,  1.0, // v0
+ *    1.0, -1.0,  1.0, // v1
+ *    1.0,  1.0,  1.0, // v2
+ *   -1.0,  1.0,  1.0, // v3
+ * ] );
+ * geometry.setAttribute( 'position', new THREE.BufferAttribute( vertices, 3 ) );
+ *
+ * const indices = [
+ *   0, 1, 2,
+ *   2, 3, 0,
+ * ];
+ *
+ * geometry.setIndex( indices );
+ * geometry.setAttribute( 'position', new THREE.BufferAttribute( vertices, 3 ) );
+ *
+ * const material = new THREE.MeshBasicMaterial( { color: 0xff0000 } );
+ * const mesh = new THREE.Mesh( geometry, material );
  * ```
  * @see Example: {@link https://threejs.org/examples/#webgl_buffergeometry | Mesh with non-indexed faces}
  * @see Example: {@link https://threejs.org/examples/#webgl_buffergeometry_indexed | Mesh with indexed faces}
@@ -43,7 +73,9 @@ import * as BufferGeometryUtils from '../../examples/jsm/utils/BufferGeometryUti
  * @see {@link https://threejs.org/docs/index.html#api/en/core/BufferGeometry | Official Documentation}
  * @see {@link https://github.com/mrdoob/three.js/blob/master/src/core/BufferGeometry.js | Source}
  */
-export class BufferGeometry extends EventDispatcher {
+export class BufferGeometry<
+    Attributes extends NormalOrGLBufferAttributes = NormalBufferAttributes,
+> extends EventDispatcher {
     /**
      * This creates a new {@link THREE.BufferGeometry | BufferGeometry} object.
      */
@@ -87,9 +119,7 @@ export class BufferGeometry extends EventDispatcher {
      * use {@link setAttribute | .setAttribute} and {@link getAttribute | .getAttribute} to access attributes of this geometry.
      * @defaultValue `{}`
      */
-    attributes: {
-        [name: string]: BufferAttribute | InterleavedBufferAttribute | GLBufferAttribute; // TODO Replace for 'Record<>'
-    };
+    attributes: Attributes;
 
     /**
      * Hashmap of {@link THREE.BufferAttribute | BufferAttributes} holding details of the geometry's morph targets.
@@ -185,30 +215,25 @@ export class BufferGeometry extends EventDispatcher {
      * @param name
      * @param attribute
      */
-    setAttribute(
-        name: BuiltinShaderAttributeName | (string & {}),
-        attribute: BufferAttribute | InterleavedBufferAttribute | GLBufferAttribute,
-    ): this;
+    setAttribute<K extends keyof Attributes>(name: K, attribute: Attributes[K]): this;
 
     /**
      * Returns the {@link attributes | attribute} with the specified name.
      * @param name
      */
-    getAttribute(
-        name: BuiltinShaderAttributeName | (string & {}),
-    ): BufferAttribute | InterleavedBufferAttribute | GLBufferAttribute;
+    getAttribute<K extends keyof Attributes>(name: K): Attributes[K];
 
     /**
      * Deletes the  {@link attributes | attribute} with the specified name.
      * @param name
      */
-    deleteAttribute(name: BuiltinShaderAttributeName | (string & {})): BufferGeometry;
+    deleteAttribute(name: keyof Attributes): this;
 
     /**
      * Returns true if the {@link attributes | attribute} with the specified name exists.
      * @param name
      */
-    hasAttribute(name: BuiltinShaderAttributeName | (string & {})): boolean;
+    hasAttribute(name: keyof Attributes): boolean;
 
     /**
      * Adds a group to this geometry
@@ -329,7 +354,9 @@ export class BufferGeometry extends EventDispatcher {
     computeTangents(): void;
 
     /**
-     * Computes vertex normals by averaging face normals.
+     * Computes vertex normals for the given vertex data. For indexed geometries, the method sets each vertex normal to
+     * be the average of the face normals of the faces that share that vertex. For non-indexed geometries, vertices are
+     * not shared, and the method sets each vertex normal to be the same as the face normal.
      */
     computeVertexNormals(): void;
 

three/src/core/Raycaster.d.ts

@@ -27,7 +27,7 @@ export interface Intersection<TIntersected extends Object3D = Object3D> {
     /** The intersected object */
     object: TIntersected;
     uv?: Vector2 | undefined;
-    uv2?: Vector2 | undefined;
+    uv1?: Vector2 | undefined;
     normal?: Vector3;
     /** The index number of the instance where the ray intersects the {@link THREE.InstancedMesh | InstancedMesh } */
     instanceId?: number | undefined;

three/src/materials/ShaderMaterial.d.ts

@@ -89,7 +89,7 @@ export class ShaderMaterial extends Material {
     };
 
     /**
-     * @default { 'color': [ 1, 1, 1 ], 'uv': [ 0, 0 ], 'uv2': [ 0, 0 ] }
+     * @default { 'color': [ 1, 1, 1 ], 'uv': [ 0, 0 ], 'uv1': [ 0, 0 ] }
      */
     defaultAttributeValues: any;
 

three/src/objects/Points.d.ts

@@ -1,8 +1,9 @@
-import { Material } from './../materials/Material';
-import { Raycaster } from './../core/Raycaster';
-import { Object3D } from './../core/Object3D';
-import { BufferGeometry } from '../core/BufferGeometry';
-import { Intersection } from '../core/Raycaster';
+import { Material } from '../materials/Material';
+import { Object3D } from '../core/Object3D';
+import { BufferGeometry, NormalOrGLBufferAttributes } from '../core/BufferGeometry';
+import { BufferAttribute } from '../core/BufferAttribute';
+import { InterleavedBufferAttribute } from '../core/InterleavedBufferAttribute';
+import { GLBufferAttribute } from '../core/GLBufferAttribute';
 
 /**
  * A class for displaying {@link Points}
@@ -12,7 +13,7 @@ import { Intersection } from '../core/Raycaster';
  * @see {@link https://github.com/mrdoob/three.js/blob/master/src/objects/Points.js | Source}
  */
 export class Points<
-    TGeometry extends BufferGeometry = BufferGeometry,
+    TGeometry extends BufferGeometry<NormalOrGLBufferAttributes> = BufferGeometry,
     TMaterial extends Material | Material[] = Material | Material[],
 > extends Object3D {
     /**

three/src/renderers/WebGLRenderTarget.d.ts

@@ -8,6 +8,7 @@ import {
     TextureEncoding,
     MinificationTextureFilter,
     MagnificationTextureFilter,
+    ColorSpace,
 } from '../constants';
 
 export interface WebGLRenderTargetOptions {
@@ -22,7 +23,9 @@ export interface WebGLRenderTargetOptions {
     stencilBuffer?: boolean | undefined; // false;
     generateMipmaps?: boolean | undefined; // true;
     depthTexture?: DepthTexture | undefined;
+    /** @deprecated Use 'colorSpace' in three.js r152+. */
     encoding?: TextureEncoding | undefined;
+    colorSpace?: ColorSpace | undefined;
 
     /**
      * Defines the count of MSAA samples. Can only be used with WebGL 2. Default is **0**.

three/src/renderers/WebGLRenderer.d.ts

@@ -14,7 +14,7 @@ import { WebGLRenderTarget } from './WebGLRenderTarget';
 import { WebGLMultipleRenderTargets } from './WebGLMultipleRenderTargets';
 import { Object3D } from './../core/Object3D';
 import { Material } from './../materials/Material';
-import { ToneMapping, ShadowMapType, CullFace, TextureEncoding } from '../constants';
+import { ToneMapping, ShadowMapType, CullFace, TextureEncoding, ColorSpace } from '../constants';
 import { WebXRManager } from '../renderers/webxr/WebXRManager';
 import { BufferGeometry } from './../core/BufferGeometry';
 import { OffscreenCanvas, Texture } from '../textures/Texture';
@@ -189,9 +189,17 @@ export class WebGLRenderer implements Renderer {
     /**
      * Default is LinearEncoding.
      * @default THREE.LinearEncoding
+     * @deprecated Use {@link WebGLRenderer.outputColorSpace .outputColorSpace} in three.js r152+.
      */
     outputEncoding: TextureEncoding;
 
+    /**
+     * Color space used for output to HTMLCanvasElement. Supported values are
+     * {@link SRGBColorSpace} and {@link LinearSRGBColorSpace}.
+     * @default THREE.SRGBColorSpace.
+     */
+    outputColorSpace: ColorSpace;
+
     /**
      * @default true
      */

three/src/textures/CanvasTexture.d.ts

@@ -29,7 +29,6 @@ export class CanvasTexture extends Texture {
      * @param format See {@link Texture.format | .format}. Default {@link THREE.RGBAFormat}
      * @param type See {@link Texture.type | .type}. Default {@link THREE.UnsignedByteType}
      * @param anisotropy See {@link Texture.anisotropy | .anisotropy}. Default {@link THREE.Texture.DEFAULT_ANISOTROPY}
-     * @param encoding See {@link Texture.encoding | .encoding}. Default {@link THREE.LinearEncoding}
      */
     constructor(
         canvas: TexImageSource | OffscreenCanvas,

three/src/textures/CompressedTexture.d.ts

@@ -4,9 +4,9 @@ import {
     Wrapping,
     CompressedPixelFormat,
     TextureDataType,
-    TextureEncoding,
     MagnificationTextureFilter,
     MinificationTextureFilter,
+    ColorSpace,
 } from '../constants';
 
 /**
@@ -30,6 +30,7 @@ export class CompressedTexture extends Texture {
      * @param magFilter See {@link Texture.magFilter | .magFilter}. Default {@link THREE.LinearFilter}
      * @param minFilter  See {@link Texture.minFilter | .minFilter}. Default {@link THREE.LinearMipmapLinearFilter}
      * @param anisotropy See {@link Texture.anisotropy | .anisotropy}. Default {@link THREE.Texture.DEFAULT_ANISOTROPY}
+     * @param colorSpace See {@link Texture.colorSpace .colorSpace}. Default {@link NoColorSpace}
      */
     constructor(
         mipmaps: ImageData[],
@@ -43,7 +44,7 @@ export class CompressedTexture extends Texture {
         magFilter?: MagnificationTextureFilter,
         minFilter?: MinificationTextureFilter,
         anisotropy?: number,
-        encoding?: TextureEncoding,
+        colorSpace?: ColorSpace,
     );
 
     /**

three/src/textures/CubeTexture.d.ts

@@ -1,13 +1,12 @@
 import { Texture } from './Texture';
 import {
-    Mapping,
     Wrapping,
     PixelFormat,
     TextureDataType,
-    TextureEncoding,
     MagnificationTextureFilter,
     MinificationTextureFilter,
     CubeTextureMapping,
+    ColorSpace,
 } from '../constants';
 
 /**
@@ -41,7 +40,7 @@ export class CubeTexture extends Texture {
      * @param format See {@link Texture.format | .format}. Default {@link THREE.RGBAFormat}
      * @param type See {@link Texture.type | .type}. Default {@link THREE.UnsignedByteType}
      * @param anisotropy See {@link Texture.anisotropy | .anisotropy}. Default {@link THREE.Texture.DEFAULT_ANISOTROPY}
-     * @param encoding See {@link Texture.encoding | .encoding}. Default {@link THREE.LinearEncoding}
+     * @param colorSpace See {@link Texture.colorSpace | .colorSpace}. Default {@link NoColorSpace}
      */
     constructor(
         images?: any[], // HTMLImageElement or HTMLCanvasElement
@@ -53,7 +52,7 @@ export class CubeTexture extends Texture {
         format?: PixelFormat,
         type?: TextureDataType,
         anisotropy?: number,
-        encoding?: TextureEncoding,
+        colorSpace?: ColorSpace,
     );
 
     /**

three/src/textures/DataTexture.d.ts

@@ -4,9 +4,9 @@ import {
     Wrapping,
     PixelFormat,
     TextureDataType,
-    TextureEncoding,
     MagnificationTextureFilter,
     MinificationTextureFilter,
+    ColorSpace,
 } from '../constants';
 import { TextureImageData } from './types';
 
@@ -50,7 +50,7 @@ export class DataTexture extends Texture {
      * @param magFilter See {@link Texture.magFilter | .magFilter}. Default {@link THREE.NearestFilter}
      * @param minFilter  See {@link Texture.minFilter | .minFilter}. Default {@link THREE.NearestFilter}
      * @param anisotropy See {@link Texture.anisotropy | .anisotropy}. Default {@link THREE.Texture.DEFAULT_ANISOTROPY}
-     * @param encoding See {@link Texture.encoding | .encoding}. Default {@link THREE.LinearEncoding}
+     * @param colorSpace See {@link Texture.colorSpace | .colorSpace}. Default {@link NoColorSpace}
      */
     constructor(
         data?: BufferSource | null,
@@ -64,7 +64,7 @@ export class DataTexture extends Texture {
         magFilter?: MagnificationTextureFilter,
         minFilter?: MinificationTextureFilter,
         anisotropy?: number,
-        encoding?: TextureEncoding,
+        colorSpace?: ColorSpace,
     );
 
     /**

three/src/textures/Texture.d.ts

@@ -13,6 +13,7 @@ import {
     MinificationTextureFilter,
     AnyPixelFormat,
     AnyMapping,
+    ColorSpace,
 } from '../constants';
 
 /** Shim for OffscreenCanvas. */
@@ -49,7 +50,7 @@ export class Texture extends EventDispatcher {
      * @param format See {@link Texture.format | .format}. Default {@link THREE.RGBAFormat}
      * @param type See {@link Texture.type | .type}. Default {@link THREE.UnsignedByteType}
      * @param anisotropy See {@link Texture.anisotropy | .anisotropy}. Default {@link THREE.Texture.DEFAULT_ANISOTROPY}
-     * @param encoding See {@link Texture.encoding | .encoding}. Default {@link THREE.LinearEncoding}
+     * @param colorSpace See {@link Texture.colorSpace | .colorSpace}. Default {@link THREE.NoColorSpace}
      */
     constructor(
         image?: TexImageSource | OffscreenCanvas,
@@ -61,7 +62,23 @@ export class Texture extends EventDispatcher {
         format?: PixelFormat,
         type?: TextureDataType,
         anisotropy?: number,
-        encoding?: TextureEncoding,
+        colorSpace?: ColorSpace,
+    );
+
+    /**
+     * @deprecated
+     */
+    constructor(
+        image: TexImageSource | OffscreenCanvas,
+        mapping: Mapping,
+        wrapS: Wrapping,
+        wrapT: Wrapping,
+        magFilter: MagnificationTextureFilter,
+        minFilter: MinificationTextureFilter,
+        format: PixelFormat,
+        type: TextureDataType,
+        anisotropy: number,
+        encoding: TextureEncoding,
     );
 
     /**
@@ -124,7 +141,8 @@ export class Texture extends EventDispatcher {
     mapping: AnyMapping;
 
     /**
-     * Lets you select the uv attribute to map the texture to. `0` for `uv` and `1` for `uv2`.
+     * Lets you select the uv attribute to map the texture to. `0` for `uv`, `1` for `uv1`, `2` for `uv2` and `3` for
+     * `uv3`.
      */
     channel: number;
 
@@ -315,9 +333,21 @@ export class Texture extends EventDispatcher {
      * @see {@link https://threejs.org/docs/index.html#api/en/constants/Textures | Texture Constants}
      * @see {@link THREE.TextureDataType}
      * @defaultValue {@link THREE.LinearEncoding}
+     * @deprecated Use {@link Texture.colorSpace .colorSpace} in three.js r152+.
      */
     encoding: TextureEncoding;
 
+    /**
+     * The {@link Textures | {@link Texture} constants} page for details of other color spaces.
+     * @remarks
+     * Textures containing color data should be annotated with {@link SRGBColorSpace THREE.SRGBColorSpace} or
+     * {@link LinearSRGBColorSpace THREE.LinearSRGBColorSpace}.
+     * @see {@link https://threejs.org/docs/index.html#api/en/constants/Textures | Texture Constants}
+     * @see {@link THREE.TextureDataType}
+     * @defaultValue {@link THREE.NoColorSpace}
+     */
+    colorSpace: ColorSpace;
+
     /**
      * Indicates whether a texture belongs to a render target or not
      * @defaultValue `false`

three/examples/jsm/nodes/functions/light/getDistanceAttenuation.d.ts

@@ -1,5 +0,0 @@
-import { ShaderNode } from '../../shadernode/ShaderNodeBaseElements';
-import Node from '../../core/Node';
-declare const getDistanceAttenuation: ShaderNode<{ lightDistance: Node; cutoffDistance: Node; decayExponent: Node }>;
-
-export default getDistanceAttenuation;