@types/three 0.150.2 → 0.152.0

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

@@ -1,7 +1,13 @@
 import { NodeValueOption } from './constants';
 import Node from './Node';
 
-export function getNodesKeys(object: Node): string[];
+export interface NodeChild {
+    property: string;
+    index?: number | string;
+    childNode: Node;
+}
+
+export function getCacheKey(object: Node): string;
+export function getNodeChildren(object: Node): Generator<NodeChild, void>;
 export function getValueType(value: NodeValueOption): string | null;
 export function getValueFromType(type: string, ...params: number[]): NodeValueOption | null;
-export function getCacheKey(object: Node): string;

three/examples/jsm/nodes/core/{VaryNode.d.ts → VaryingNode.d.ts}

@@ -1,6 +1,6 @@
 import Node from './Node';
 
-export default class VaryNode extends Node {
+export default class VaryingNode extends Node {
     node: Node;
     name: string | null;
 

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/fog/FogNode.d.ts

@@ -6,5 +6,5 @@ export default class FogNode extends Node {
     factorNode: Node;
 
     constructor(colorNode: Node, factorNode: Node);
-    mix(outputNode: Node): Node;
+    mixAssign(outputNode: Node): Node;
 }

three/examples/jsm/nodes/geometry/RangeNode.d.ts

@@ -1,5 +1,6 @@
 import { Color, Vector2, Vector3, Vector4 } from '../../../../src/Three';
 import Node from '../core/Node';
+import NodeBuilder from '../core/NodeBuilder';
 
 export type RangeModeBound = number | Color | Vector2 | Vector3 | Vector4;
 
@@ -8,5 +9,5 @@ export default class RangeNode extends Node {
     max: RangeModeBound;
 
     constructor(min: RangeModeBound, max: RangeModeBound);
-    getVectorLength(): number;
+    getVectorLength(builder: NodeBuilder): number;
 }

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/lighting/PointLightNode.d.ts

@@ -0,0 +1,10 @@
+import AnalyticLightNode from './AnalyticLightNode';
+import Node from '../core/Node';
+import { PointLight } from '../../../../src/Three';
+
+export default class PointLightNode extends AnalyticLightNode<PointLight> {
+    cutoffDistanceNode: Node;
+    decayExponentNode: Node;
+
+    constructor(light?: PointLight | null);
+}

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

@@ -0,0 +1,15 @@
+import AnalyticLightNode from './AnalyticLightNode';
+import Node from '../core/Node';
+import { SpotLight } from '../../../../src/Three';
+
+export default class PointLightNode extends AnalyticLightNode<SpotLight> {
+    directionNode: Node;
+
+    coneCosNode: Node;
+    penumbraCosNode: Node;
+
+    cutoffDistanceNode: Node;
+    decayExponentNode: Node;
+
+    constructor(light?: SpotLight | null);
+}

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/math/MathNode.d.ts

@@ -24,7 +24,7 @@ export type MathNodeMethod1 =
     | typeof MathNode.SIGN
     | typeof MathNode.LENGTH
     | typeof MathNode.NEGATE
-    | typeof MathNode.INVERT
+    | typeof MathNode.ONE_MINUS
     | typeof MathNode.DFDX
     | typeof MathNode.DFDY
     | typeof MathNode.ROUND;
@@ -76,7 +76,7 @@ export default class MathNode extends TempNode {
     static SIGN: 'sign';
     static LENGTH: 'length';
     static NEGATE: 'negate';
-    static INVERT: 'invert';
+    static ONE_MINUS: 'oneMinus';
     static DFDX: 'dFdx';
     static DFDY: 'dFdy';
     static ROUND: 'round';

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

@@ -50,7 +50,7 @@ import {
     UserDataNode,
     UVNode,
     VarNode,
-    VaryNode,
+    VaryingNode,
 } from '../Nodes';
 import StorageBufferNode from '../accessors/StorageBufferNode';
 import NodeCache from '../core/NodeCache';
@@ -130,7 +130,7 @@ export function fn<P extends FunctionNodeArguments>(
 export const instanceIndex: Swizzable<InstanceIndexNode>;
 export function label(node: NodeRepresentation, name?: string): Swizzable<VarNode>;
 export function temp(node: NodeRepresentation, name?: string): Swizzable<VarNode>;
-export function vary(node: NodeRepresentation, name?: string): Swizzable<VaryNode>;
+export function vary(node: NodeRepresentation, name?: string): Swizzable<VaryingNode>;
 
 // accesors
 

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/objects/{GroundProjectedEnv.d.ts → GroundProjectedSkybox.d.ts}

@@ -1,6 +1,6 @@
 import { Mesh, IcosahedronGeometry, ShaderMaterial, Texture } from '../../../src/Three';
 
-export class GroundProjectedEnv extends Mesh<IcosahedronGeometry, ShaderMaterial> {
+export class GroundProjectedSkybox extends Mesh<IcosahedronGeometry, ShaderMaterial> {
     constructor(texture: Texture, options?: { height?: number; radius?: number });
 
     set radius(radius: number);

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

@@ -2,6 +2,8 @@ import { Material, WebGLRenderer, WebGLRenderTarget } from '../../../src/Three';
 
 export class Pass {
     constructor();
+
+    isPass: boolean;
     enabled: boolean;
     needsSwap: boolean;
     clear: boolean;

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

@@ -1,8 +1,9 @@
-import { Object3D, Scene, Camera } from '../../../src/Three';
+import { Object3D, Scene, Camera, Vector2 } from '../../../src/Three';
 
 export class CSS2DObject extends Object3D {
     constructor(element: HTMLElement);
     element: HTMLElement;
+    center: Vector2;
 
     onBeforeRender: (renderer: unknown, scene: Scene, camera: Camera) => void;
     onAfterRender: (renderer: unknown, scene: Scene, camera: Camera) => void;

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

@@ -12,27 +12,7 @@ export class WebGLNodeBuilder extends NodeBuilder {
     );
 
     addSlot(shaderStage: NodeShaderStageOption, slotNode: SlotNode): Node;
-    addFlowCode(code: string): string;
-
-    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/BufferGeometryUtils.d.ts

@@ -11,8 +11,8 @@ import {
 } from '../../../src/Three';
 
 export function deepCloneAttribute(attribute: BufferAttribute): BufferAttribute;
-export function mergeBufferGeometries(geometries: BufferGeometry[], useGroups?: boolean): BufferGeometry;
-export function mergeBufferAttributes(attributes: BufferAttribute[]): BufferAttribute;
+export function mergeGeometries(geometries: BufferGeometry[], useGroups?: boolean): BufferGeometry;
+export function mergeAttributes(attributes: BufferAttribute[]): BufferAttribute;
 export function interleaveAttributes(attributes: BufferAttribute[]): InterleavedBufferAttribute;
 export function estimateBytesUsed(geometry: BufferGeometry): number;
 export function mergeVertices(geometry: BufferGeometry, tolerance?: number): BufferGeometry;
@@ -34,3 +34,13 @@ export function deinterleaveGeometry(geometry: BufferGeometry): void;
  * @param creaseAngle The crease angle.
  */
 export function toCreasedNormals(geometry: BufferGeometry, creaseAngle?: number): BufferGeometry;
+
+/**
+ * @deprecated Use mergeGeometries instead.
+ */
+export function mergeBufferGeometries(geometries: BufferGeometry[], useGroups?: boolean): BufferGeometry;
+
+/**
+ * @deprecated Use mergeAttributes instead.
+ */
+export function mergeBufferAttributes(attributes: BufferAttribute[]): BufferAttribute;

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.150
+// 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.150.2",
+    "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": "c2191d62aed43403a160d31f1eda315dcee3ba0c3154b0cd4cd4fed4226f8434",
+    "typesPublisherContentHash": "c206b6e9fcb60fc53d60b9c172bf339b663fa61d521aa358641f9b16d55913ed",
     "typeScriptVersion": "4.4",
     "exports": {
         ".": {

three/src/Three.d.ts

@@ -65,6 +65,7 @@ export * from './extras/core/Path';
 export * from './extras/core/ShapePath';
 export * from './extras/core/CurvePath';
 export * from './extras/core/Curve';
+export * from './extras/core/Interpolations';
 export * as DataUtils from './extras/DataUtils';
 export * from './extras/ImageUtils';
 export * from './extras/ShapeUtils';

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,8 @@ 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/extras/DataUtils.d.ts

@@ -1,2 +1,15 @@
+/**
+ * Returns a half precision floating point value from the given single precision floating point value.
+ * @param val A single precision floating point value.
+ * @see {@link https://threejs.org/docs/index.html#api/en/extras/DataUtils | Official Documentation}
+ * @see {@link https://github.com/mrdoob/three.js/blob/master/src/extras/DataUtils.js | Source}
+ */
 export function toHalfFloat(val: number): number;
+
+/**
+ * Returns a single precision floating point value from the given half precision floating point value.
+ * @param val A half precision floating point value.
+ * @see {@link https://threejs.org/docs/index.html#api/en/extras/DataUtils | Official Documentation}
+ * @see {@link https://github.com/mrdoob/three.js/blob/master/src/extras/DataUtils.js | Source}
+ */
 export function fromHalfFloat(val: number): number;

three/src/extras/Earcut.d.ts

@@ -1,3 +1,15 @@
+/**
+ * An implementation of the {@link Earcut} polygon triangulation algorithm
+ * @remarks
+ * The code is a port of {@link https://github.com/mapbox/earcut | mapbox/earcut}.
+ * @see {@link https://threejs.org/docs/index.html#api/en/extras/Earcut | Official Documentation}
+ * @see {@link https://github.com/mrdoob/three.js/blob/master/src/extras/Earcut.js | Source}
+ */
 export const Earcut: {
+    /**
+     * Triangulates the given shape definition by returning an array of triangles
+     * @remarks
+     * A triangle is defined by three consecutive integers representing vertex indices.
+     */
     triangulate(data: number[], holeIndices?: number[], dim?: number): number[];
 };