@types/three 0.174.0 → 0.176.0

three/src/animation/tracks/BooleanKeyframeTrack.d.ts

@@ -1,10 +1,18 @@
 import { KeyframeTrack } from "../KeyframeTrack.js";
 
+/**
+ * A track for boolean keyframe values.
+ */
 export class BooleanKeyframeTrack extends KeyframeTrack {
-    constructor(name: string, times: ArrayLike<number>, values: ArrayLike<any>);
-
     /**
-     * @default 'bool'
+     * Constructs a new boolean keyframe track.
+     *
+     * This keyframe track type has no `interpolation` parameter because the
+     * interpolation is always discrete.
+     *
+     * @param {string} name - The keyframe track's name.
+     * @param {Array<number>} times - A list of keyframe times.
+     * @param {Array<number>} values - A list of keyframe values.
      */
-    ValueTypeName: string;
+    constructor(name: string, times: ArrayLike<number>, values: ArrayLike<number>);
 }

three/src/animation/tracks/ColorKeyframeTrack.d.ts

@@ -1,11 +1,17 @@
 import { InterpolationModes } from "../../constants.js";
 import { KeyframeTrack } from "../KeyframeTrack.js";
 
+/**
+ * A track for color keyframe values.
+ */
 export class ColorKeyframeTrack extends KeyframeTrack {
-    constructor(name: string, times: ArrayLike<number>, values: ArrayLike<number>, interpolation?: InterpolationModes);
-
     /**
-     * @default 'color'
+     * Constructs a new color keyframe track.
+     *
+     * @param {string} name - The keyframe track's name.
+     * @param {Array<number>} times - A list of keyframe times.
+     * @param {Array<number>} values - A list of keyframe values.
+     * @param {(InterpolateLinear|InterpolateDiscrete|InterpolateSmooth)} [interpolation] - The interpolation type.
      */
-    ValueTypeName: string;
+    constructor(name: string, times: ArrayLike<number>, values: ArrayLike<number>, interpolation?: InterpolationModes);
 }

three/src/animation/tracks/NumberKeyframeTrack.d.ts

@@ -1,11 +1,17 @@
 import { InterpolationModes } from "../../constants.js";
 import { KeyframeTrack } from "../KeyframeTrack.js";
 
+/**
+ * A track for numeric keyframe values.
+ */
 export class NumberKeyframeTrack extends KeyframeTrack {
-    constructor(name: string, times: ArrayLike<number>, values: ArrayLike<number>, interpolation?: InterpolationModes);
-
     /**
-     * @default 'number'
+     * Constructs a new number keyframe track.
+     *
+     * @param {string} name - The keyframe track's name.
+     * @param {Array<number>} times - A list of keyframe times.
+     * @param {Array<number>} values - A list of keyframe values.
+     * @param {(InterpolateLinear|InterpolateDiscrete|InterpolateSmooth)} [interpolation] - The interpolation type.
      */
-    ValueTypeName: string;
+    constructor(name: string, times: Array<number>, values: Array<number>, interpolation?: InterpolationModes);
 }

three/src/animation/tracks/QuaternionKeyframeTrack.d.ts

@@ -1,11 +1,17 @@
 import { InterpolationModes } from "../../constants.js";
 import { KeyframeTrack } from "../KeyframeTrack.js";
 
+/**
+ * A track for Quaternion keyframe values.
+ */
 export class QuaternionKeyframeTrack extends KeyframeTrack {
-    constructor(name: string, times: ArrayLike<number>, values: ArrayLike<number>, interpolation?: InterpolationModes);
-
     /**
-     * @default 'quaternion'
+     * Constructs a new Quaternion keyframe track.
+     *
+     * @param {string} name - The keyframe track's name.
+     * @param {Array<number>} times - A list of keyframe times.
+     * @param {Array<number>} values - A list of keyframe values.
+     * @param {(InterpolateLinear|InterpolateDiscrete|InterpolateSmooth)} [interpolation] - The interpolation type.
      */
-    ValueTypeName: string;
+    constructor(name: string, times: Array<number>, values: Array<number>, interpolation?: InterpolationModes);
 }

three/src/animation/tracks/StringKeyframeTrack.d.ts

@@ -1,10 +1,18 @@
 import { KeyframeTrack } from "../KeyframeTrack.js";
 
+/**
+ * A track for string keyframe values.
+ */
 export class StringKeyframeTrack extends KeyframeTrack {
-    constructor(name: string, times: ArrayLike<number>, values: ArrayLike<any>);
-
     /**
-     * @default 'string'
+     * Constructs a new string keyframe track.
+     *
+     * This keyframe track type has no `interpolation` parameter because the
+     * interpolation is always discrete.
+     *
+     * @param {string} name - The keyframe track's name.
+     * @param {Array<number>} times - A list of keyframe times.
+     * @param {Array<number>} values - A list of keyframe values.
      */
-    ValueTypeName: string;
+    constructor(name: string, times: Array<number>, values: Array<number>);
 }

three/src/animation/tracks/VectorKeyframeTrack.d.ts

@@ -1,11 +1,17 @@
 import { InterpolationModes } from "../../constants.js";
 import { KeyframeTrack } from "../KeyframeTrack.js";
 
+/**
+ * A track for vector keyframe values.
+ */
 export class VectorKeyframeTrack extends KeyframeTrack {
-    constructor(name: string, times: ArrayLike<number>, values: ArrayLike<number>, interpolation?: InterpolationModes);
-
     /**
-     * @default 'vector'
+     * Constructs a new vector keyframe track.
+     *
+     * @param {string} name - The keyframe track's name.
+     * @param {Array<number>} times - A list of keyframe times.
+     * @param {Array<number>} values - A list of keyframe values.
+     * @param {(InterpolateLinear|InterpolateDiscrete|InterpolateSmooth)} [interpolation] - The interpolation type.
      */
-    ValueTypeName: string;
+    constructor(name: string, times: Array<number>, values: Array<number>, interpolation?: InterpolationModes);
 }

three/src/audio/AudioListener.d.ts

@@ -4,7 +4,7 @@ import { AudioContext } from "./AudioContext.js";
 /**
  * The {@link AudioListener} represents a virtual {@link https://developer.mozilla.org/en-US/docs/Web/API/AudioListener | listener} of the all positional and non-positional audio effects in the scene.
  * A three.js application usually creates a single instance of {@link AudioListener}  * @remarks
- * It is a mandatory construtor parameter for audios entities like {@link Audio | Audio} and {@link PositionalAudio | PositionalAudio}.
+ * It is a mandatory constructor parameter for audios entities like {@link Audio | Audio} and {@link PositionalAudio | PositionalAudio}.
  * In most cases, the listener object is a child of the camera
  * So the 3D transformation of the camera represents the 3D transformation of the listener.
  * @example

three/src/cameras/ArrayCamera.d.ts

@@ -18,6 +18,11 @@ export class ArrayCamera extends PerspectiveCamera {
      */
     readonly isArrayCamera: true;
 
+    /**
+     * Whether this camera is used with multiview rendering or not.
+     */
+    isMultiViewCamera: boolean;
+
     /**
      * An array of cameras.
      * @defaultValue `[]`

three/src/constants.d.ts

@@ -371,19 +371,6 @@ export const RGBFormat: 1022;
 /** {@link RGBAFormat} is the default and reads the red, green, blue and alpha components. */
 export const RGBAFormat: 1023;
 
-/**
- * {@link LuminanceFormat} reads each element as a single luminance component.
- * This is then converted to a floating point, clamped to the range `[0,1]`, and then assembled into an RGBA element by
- * placing the luminance value in the red, green and blue channels, and attaching `1.0` to the alpha channel.
- */
-export const LuminanceFormat: 1024;
-
-/**
- * {@link LuminanceAlphaFormat} reads each element as a luminance/alpha double.
- * The same process occurs as for the {@link LuminanceFormat}, except that the alpha channel may have values other than `1.0`.
- */
-export const LuminanceAlphaFormat: 1025;
-
 /**
  * {@link DepthFormat} reads each element as a single depth value, converts it to floating point, and clamps to the range `[0,1]`.
  * @remarks This is the default for {@link THREE.DepthTexture}.
@@ -420,7 +407,7 @@ export const RGFormat: 1030;
 export const RGIntegerFormat: 1031;
 
 /**
- * {@link RGBIntegerFormat} discrads the alpha components and reads the red, green, and blue components.
+ * {@link RGBIntegerFormat} discards the alpha components and reads the red, green, and blue components.
  */
 export const RGBIntegerFormat: 1032;
 
@@ -440,8 +427,6 @@ export type PixelFormat =
     | typeof AlphaFormat
     | typeof RGBFormat
     | typeof RGBAFormat
-    | typeof LuminanceFormat
-    | typeof LuminanceAlphaFormat
     | typeof DepthFormat
     | typeof DepthStencilFormat
     | typeof RedFormat
@@ -478,7 +463,7 @@ export const RGBA_S3TC_DXT1_Format: 33777;
  */
 export const RGBA_S3TC_DXT3_Format: 33778;
 /**
- * A DXT5-compressed image in an RGBA image format. It also provides a 4:1 compression, but differs to the DXT3 compression in how the alpha compression is done.
+ * A DXT5-compressed image in an RGBA image format. It also provides a 4:1 compression, but differs from the DXT3 compression in how the alpha compression is done.
  * @remarks Require support for the _WEBGL_compressed_texture_s3tc_ WebGL extension.
  */
 export const RGBA_S3TC_DXT5_Format: 33779;
@@ -797,6 +782,22 @@ export const TimestampQuery: {
 };
 export type TimestampQuery = "compute" | "render";
 
+export const InterpolationSamplingType: {
+    PERSPECTIVE: "perspective";
+    LINEAR: "linear";
+    FLAT: "flat";
+};
+export type InterpolationSamplingType = "perspective" | "linear" | "flat";
+
+export const InterpolationSamplingMode: {
+    NORMAL: "normal";
+    CENTROID: "centroid";
+    SAMPLE: "sample";
+    FLAT_FIRST: "flat first";
+    FLAT_EITHER: "flat either";
+};
+export type InterpolationSamplingMode = "normal" | "centroid" | "sample" | "flat first" | "flat either";
+
 ///////////////////////////////////////////////////////////////////////////////
 // Texture - Internal Pixel Formats
 

three/src/core/BufferAttribute.d.ts

@@ -13,6 +13,17 @@ export type TypedArray =
     | Float32Array
     | Float64Array;
 
+export type TypedArrayConstructor =
+    | Int8ArrayConstructor
+    | Uint8ArrayConstructor
+    | Uint8ClampedArrayConstructor
+    | Int16ArrayConstructor
+    | Uint16ArrayConstructor
+    | Int32ArrayConstructor
+    | Uint32ArrayConstructor
+    | Float32ArrayConstructor
+    | Float64ArrayConstructor;
+
 export interface BufferAttributeJSON {
     itemSize: number;
     type: string;

three/src/core/BufferGeometry.d.ts

@@ -172,9 +172,7 @@ export class BufferGeometry<
      * You will have to call {@link dispose | .dispose}(), and create a new instance of {@link THREE.BufferGeometry | BufferGeometry}.
      * @defaultValue `{}`
      */
-    morphAttributes: {
-        [name: string]: Array<BufferAttribute | InterleavedBufferAttribute>; // TODO Replace for 'Record<>'
-    };
+    morphAttributes: Record<"position" | "normal" | "color", Array<BufferAttribute | InterleavedBufferAttribute>>;
 
     /**
      * Used to control the morph target behavior; when set to true, the morph target data is treated as relative offsets, rather than as absolute positions/normals.

three/src/core/RenderTarget.d.ts

@@ -11,6 +11,7 @@ import { Texture } from "../textures/Texture.js";
 import { EventDispatcher } from "./EventDispatcher.js";
 
 export interface RenderTargetOptions {
+    depth?: number | undefined;
     wrapS?: Wrapping | undefined;
     wrapT?: Wrapping | undefined;
     magFilter?: MagnificationTextureFilter | undefined;
@@ -32,6 +33,7 @@ export interface RenderTargetOptions {
      */
     samples?: number | undefined;
     count?: number | undefined;
+    multiview?: boolean | undefined;
 }
 
 export class RenderTarget<TTexture extends Texture | Texture[] = Texture> extends EventDispatcher<{ dispose: {} }> {
@@ -78,6 +80,13 @@ export class RenderTarget<TTexture extends Texture | Texture[] = Texture> extend
      */
     samples: number;
 
+    /**
+     * Whether to this target is used in multiview rendering.
+     *
+     * @default false
+     */
+    multiview: boolean;
+
     constructor(width?: number, height?: number, options?: RenderTargetOptions);
 
     get texture(): TTexture;

three/src/extras/Controls.d.ts

@@ -32,7 +32,7 @@ declare abstract class Controls<TEventMap extends {}> extends EventDispatcher<TE
      * Connects the controls to the DOM. This method has so called "side effects" since it adds the module's event
      * listeners to the DOM.
      */
-    connect(): void;
+    connect(element: HTMLElement): void;
 
     /**
      * Disconnects the controls from the DOM.

three/src/extras/Earcut.d.ts

@@ -5,11 +5,13 @@
  * @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: {
+declare class 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[];
-};
+    static triangulate(data: number[], holeIndices?: number[], dim?: number): number[];
+}
+
+export { Earcut };

three/src/extras/ImageUtils.d.ts

@@ -10,6 +10,7 @@ declare class ImageUtils {
      */
     static getDataURL(
         image: HTMLImageElement | HTMLCanvasElement | CanvasImageSource | ImageBitmap | ImageData,
+        type?: string,
     ): string;
 
     /**

three/src/geometries/CapsuleGeometry.d.ts

@@ -19,11 +19,18 @@ export class CapsuleGeometry extends BufferGeometry {
     /**
      * Create a new instance of {@link CapsuleGeometry}
      * @param radius Radius of the capsule. Expects a `Float`. Default `1`
-     * @param length Length of the middle section. Expects a `Float`. Default `1`
+     * @param height Height of the middle section. Expects a `Float`. Default `1`
      * @param capSegments Number of curve segments used to build the caps. Expects a `Integer`. Default `4`
      * @param radialSegments Number of segmented faces around the circumference of the capsule. Expects a `Integer`. Default `8`
+     * @param heightSegments Number of rows of faces along the height of the capsule. Optional; defaults to `1`.
      */
-    constructor(radius?: number, length?: number, capSegments?: number, radialSegments?: number);
+    constructor(
+        radius?: number,
+        height?: number,
+        capSegments?: number,
+        radialSegments?: number,
+        heightSegments?: number,
+    );
 
     /**
      * A Read-only _string_ to check if `this` object type.
@@ -38,7 +45,7 @@ export class CapsuleGeometry extends BufferGeometry {
      */
     readonly parameters: {
         readonly radius: number;
-        readonly length: number;
+        readonly height: number;
         readonly capSegments: number;
         readonly radialSegments: number;
     };

three/src/lights/LightShadow.d.ts

@@ -1,4 +1,5 @@
 import { Camera } from "../cameras/Camera.js";
+import { TextureDataType } from "../constants.js";
 import { Object3DJSONObject } from "../core/Object3D.js";
 import { Frustum } from "../math/Frustum.js";
 import { Matrix4 } from "../math/Matrix4.js";
@@ -86,6 +87,13 @@ export class LightShadow<TCamera extends Camera = Camera> {
      */
     mapSize: Vector2;
 
+    /**
+     * The type of shadow texture. The default is `UnsignedByteType`.
+     *
+     * @default UnsignedByteType
+     */
+    mapType: TextureDataType;
+
     /**
      * The depth map generated using the internal camera; a location beyond a pixel's depth is in shadow. Computed internally during rendering.
      * @defaultValue null

three/src/lights/PointLight.d.ts

@@ -22,7 +22,7 @@ import { PointLightShadow } from "./PointLightShadow.js";
 export class PointLight extends Light<PointLightShadow> {
     /**
      * Creates a new PointLight.
-     * @param color Hexadecimal color of the light. Default is 0xffffff (white). Expects a `Integer`
+     * @param color Hexadecimal color of the light. Default is 0xffffff (white). Expects an `Integer`
      * @param intensity Numeric value of the light's strength/intensity. Expects a `Float`. Default `1`
      * @param distance Maximum range of the light. Default is 0 (no limit).
      * @param decay The amount the light dims along the distance of the light. Expects a `Float`. Default `2`

three/src/loaders/FileLoader.d.ts

@@ -11,8 +11,8 @@ export class FileLoader extends Loader<string | ArrayBuffer> {
         onError?: (err: unknown) => void,
     ): void;
 
-    mimeType: string | undefined;
-    responseType: string | undefined;
+    mimeType: string;
+    responseType: string;
 
     setMimeType(mimeType: string): FileLoader;
     setResponseType(responseType: string): FileLoader;

three/src/loaders/LoaderUtils.d.ts

@@ -1,9 +1,4 @@
 export class LoaderUtils {
-    /**
-     * @deprecated decodeText() has been deprecated with r165 and will be removed with r175. Use TextDecoder instead.
-     */
-    static decodeText(array: BufferSource): string;
-
     static extractUrlBase(url: string): string;
 
     static resolveURL(url: string, path: string): string;

three/src/materials/Material.d.ts

@@ -52,6 +52,7 @@ export interface MaterialParameters {
     precision?: "highp" | "mediump" | "lowp" | null | undefined;
     premultipliedAlpha?: boolean | undefined;
     forceSinglePass?: boolean | undefined;
+    allowOverride?: boolean | undefined;
     dithering?: boolean | undefined;
     side?: Side | undefined;
     shadowSide?: Side | undefined;
@@ -286,7 +287,7 @@ export class Material extends EventDispatcher<{ dispose: {} }> {
     blendDst: BlendingDstFactor;
 
     /**
-     * The tranparency of the .blendDst. Default is null.
+     * The transparency of the .blendDst. Default is null.
      * @default null
      */
     blendDstAlpha: number | null;
@@ -298,7 +299,7 @@ export class Material extends EventDispatcher<{ dispose: {} }> {
     blendEquation: BlendingEquation;
 
     /**
-     * The tranparency of the .blendEquation. Default is null.
+     * The transparency of the .blendEquation. Default is null.
      * @default null
      */
     blendEquationAlpha: number | null;
@@ -316,7 +317,7 @@ export class Material extends EventDispatcher<{ dispose: {} }> {
     blendSrc: BlendingSrcFactor | BlendingDstFactor;
 
     /**
-     * The tranparency of the .blendSrc. Default is null.
+     * The transparency of the .blendSrc. Default is null.
      * @default null
      */
     blendSrcAlpha: number | null;
@@ -479,6 +480,8 @@ export class Material extends EventDispatcher<{ dispose: {} }> {
      */
     forceSinglePass: boolean;
 
+    allowOverride: boolean;
+
     /**
      * Whether to apply dithering to the color to remove the appearance of banding. Default is false.
      * @default false
@@ -625,9 +628,4 @@ export class Material extends EventDispatcher<{ dispose: {} }> {
      * @default false
      */
     set needsUpdate(value: boolean);
-
-    /**
-     * @deprecated onBuild() has been removed.
-     */
-    onBuild(object: Object3D, parameters: WebGLProgramParametersWithUniforms, renderer: WebGLRenderer): void;
 }

three/src/materials/ShaderMaterial.d.ts

@@ -61,7 +61,7 @@ export interface ShaderMaterialJSON extends MaterialJSON {
     defines?: Record<string, unknown>;
 
     vertexShader: string;
-    ragmentShader: string;
+    fragmentShader: string;
 
     lights: boolean;
     clipping: boolean;

three/src/materials/nodes/NodeMaterial.d.ts

@@ -27,7 +27,8 @@ export interface NodeMaterialParameters extends MaterialParameters {
     geometryNode?: Node | null | undefined;
 
     depthNode?: Node | null | undefined;
-    shadowNode?: Node | null | undefined;
+    receivedShadowPositionNode?: Node | null | undefined;
+    castShadowPositionNode?: Node | null | undefined;
 
     outputNode?: Node | null | undefined;
 
@@ -59,7 +60,8 @@ declare class NodeMaterial extends Material {
     geometryNode: Node | null;
 
     depthNode: Node | null;
-    shadowPositionNode: Node | null;
+    receivedShadowPositionNode: Node | null;
+    castShadowPositionNode: Node | null;
     receivedShadowNode: (() => Node) | null;
     castShadowNode: Node | null;
 
@@ -69,6 +71,12 @@ declare class NodeMaterial extends Material {
     fragmentNode: Node | null;
     vertexNode: Node | null;
 
+    /**
+     * @deprecated ".shadowPositionNode" was renamed to ".receivedShadowPositionNode".'
+     */
+    get shadowPositionNode(): Node | null;
+    set shadowPositionNode(value: Node | null);
+
     constructor();
 
     build(builder: NodeBuilder): void;

three/src/materials/nodes/manager/NodeMaterialObserver.d.ts

@@ -2,6 +2,7 @@ import { BufferAttribute } from "../../../core/BufferAttribute.js";
 import { Matrix4 } from "../../../math/Matrix4.js";
 import NodeBuilder from "../../../nodes/core/NodeBuilder.js";
 import NodeFrame from "../../../nodes/core/NodeFrame.js";
+import Renderer from "../../../renderers/common/Renderer.js";
 import RenderObject from "../../../renderers/common/RenderObject.js";
 import { Material } from "../../Material.js";
 declare const refreshUniforms: readonly [
@@ -103,6 +104,13 @@ declare class NodeMaterialObserver {
      * @return {boolean} Whether the given render object is verified for the first time of this observer.
      */
     firstInitialization(renderObject: RenderObject): boolean;
+    /**
+     * Returns `true` if the current rendering produces motion vectors.
+     *
+     * @param {Renderer} renderer - The renderer.
+     * @return {boolean} Whether the current rendering produces motion vectors or not.
+     */
+    needsVelocity(renderer: Renderer): boolean;
     /**
      * Returns monitoring data for the given render object.
      *

three/src/math/FrustumArray.d.ts

@@ -0,0 +1,27 @@
+import { ArrayCamera } from "../cameras/ArrayCamera.js";
+import { CoordinateSystem } from "../constants.js";
+import { Object3D } from "../core/Object3D.js";
+import { Sprite } from "../objects/Sprite.js";
+import { Box3 } from "./Box3.js";
+import { Sphere } from "./Sphere.js";
+import { Vector3 } from "./Vector3.js";
+
+declare class FrustumArray {
+    coordinateSystem: CoordinateSystem;
+
+    constructor();
+
+    intersectsObject(object: Object3D, cameraArray: ArrayCamera): boolean;
+
+    intersectsSprite(sprite: Sprite, cameraArray: ArrayCamera): boolean;
+
+    intersectsSprite(sphere: Sphere, cameraArray: ArrayCamera): boolean;
+
+    intersectsBox(box: Box3, cameraArray: ArrayCamera): boolean;
+
+    containsPoint(point: Vector3, cameraArray: ArrayCamera): boolean;
+
+    clone(): FrustumArray;
+}
+
+export { FrustumArray };

three/src/nodes/Nodes.d.ts

@@ -51,6 +51,7 @@ export { NodeUtils };
 // utils
 export { default as ArrayElementNode } from "./utils/ArrayElementNode.js";
 export { default as ConvertNode } from "./utils/ConvertNode.js";
+export { default as DebugNode } from "./utils/DebugNode.js";
 export { default as EquirectUVNode } from "./utils/EquirectUVNode.js";
 export { default as FunctionOverloadingNode } from "./utils/FunctionOverloadingNode.js";
 export { default as JoinNode } from "./utils/JoinNode.js";

three/src/nodes/TSL.d.ts

@@ -135,6 +135,7 @@ export * from "./lighting/LightsNode.js";
 export * from "./lighting/PointLightNode.js";
 export * from "./lighting/PointShadowNode.js";
 export * from "./lighting/ShadowBaseNode.js";
+export * from "./lighting/ShadowFilterNode.js";
 export * from "./lighting/ShadowNode.js";
 
 // pmrem

three/src/nodes/accessors/BufferAttributeNode.d.ts

@@ -4,6 +4,8 @@ import { InterleavedBuffer } from "../../core/InterleavedBuffer.js";
 import { InterleavedBufferAttribute } from "../../core/InterleavedBufferAttribute.js";
 import InputNode from "../core/InputNode.js";
 import NodeBuilder from "../core/NodeBuilder.js";
+import { ShaderNodeObject } from "../tsl/TSLCore.js";
+import BufferNode from "./BufferNode.js";
 /**
  * In earlier `three.js` versions it was only possible to define attribute data
  * on geometry level. With `BufferAttributeNode`, it is also possible to do this
@@ -119,7 +121,7 @@ export declare const bufferAttribute: (
     type?: string | null,
     stride?: number,
     offset?: number,
-) => import("../tsl/TSLCore.js").ShaderNodeObject<BufferAttributeNode>;
+) => ShaderNodeObject<BufferAttributeNode>;
 /**
  * TSL function for creating a buffer attribute node but with dynamic draw usage.
  * Use this function if attribute data are updated per frame.
@@ -137,7 +139,7 @@ export declare const dynamicBufferAttribute: (
     type?: string | null,
     stride?: number,
     offset?: number,
-) => import("../tsl/TSLCore.js").ShaderNodeObject<BufferAttributeNode>;
+) => ShaderNodeObject<BufferAttributeNode>;
 /**
  * TSL function for creating a buffer attribute node but with enabled instancing
  *
@@ -154,7 +156,7 @@ export declare const instancedBufferAttribute: (
     type?: string | null,
     stride?: number,
     offset?: number,
-) => import("../tsl/TSLCore.js").ShaderNodeObject<BufferAttributeNode>;
+) => ShaderNodeObject<BufferAttributeNode>;
 /**
  * TSL function for creating a buffer attribute node but with dynamic draw usage and enabled instancing
  *
@@ -171,4 +173,9 @@ export declare const instancedDynamicBufferAttribute: (
     type?: string | null,
     stride?: number,
     offset?: number,
-) => import("../tsl/TSLCore.js").ShaderNodeObject<BufferAttributeNode>;
+) => ShaderNodeObject<BufferAttributeNode>;
+declare module "../tsl/TSLCore.js" {
+    interface NodeElements {
+        toAttribute: <TValue>(bufferNode: BufferNode<TValue>) => ShaderNodeObject<BufferAttributeNode>;
+    }
+}

three/src/nodes/accessors/InstanceNode.d.ts

@@ -1,5 +1,4 @@
 import { InstancedBufferAttribute } from "../../core/InstancedBufferAttribute.js";
-import { InstancedMesh } from "../../objects/InstancedMesh.js";
 import Node from "../core/Node.js";
 import { ShaderNodeObject } from "../tsl/TSLCore.js";
 
@@ -14,12 +13,12 @@ export default class InstanceNode extends Node {
     constructor(
         count: number,
         instanceMatrix: InstancedBufferAttribute,
-        instanceColor: InstancedBufferAttribute | null,
+        instanceColor?: InstancedBufferAttribute | null,
     );
 }
 
 export const instance: (
     count: number,
     instanceMatrix: InstancedBufferAttribute,
-    instanceColor: InstancedBufferAttribute | null,
+    instanceColor?: InstancedBufferAttribute | null,
 ) => ShaderNodeObject<InstanceNode>;