@types/three 0.172.0 → 0.174.0

three/src/nodes/Nodes.d.ts

@@ -2,6 +2,7 @@
 export * from "./core/constants.js";
 
 // core
+export { default as ArrayNode } from "./core/ArrayNode.js";
 export { default as AssignNode } from "./core/AssignNode.js";
 export { default as AttributeNode } from "./core/AttributeNode.js";
 export { default as BypassNode } from "./core/BypassNode.js";
@@ -13,7 +14,6 @@ export {
     default as LightingModel,
     LightingModelDirectInput,
     LightingModelDirectRectAreaInput,
-    LightingModelIndirectInput,
     LightingModelReflectedLight,
 } from "./core/LightingModel.js";
 export { default as MRTNode } from "./core/MRTNode.js";
@@ -37,6 +37,8 @@ export { default as OutputStructNode } from "./core/OutputStructNode.js";
 export { default as ParameterNode } from "./core/ParameterNode.js";
 export { default as PropertyNode } from "./core/PropertyNode.js";
 export { default as StackNode } from "./core/StackNode.js";
+export { default as StructNode } from "./core/StructNode.js";
+export { default as StructTypeNode } from "./core/StructTypeNode.js";
 export { default as TempNode } from "./core/TempNode.js";
 export { default as UniformGroupNode } from "./core/UniformGroupNode.js";
 export { default as UniformNode } from "./core/UniformNode.js";
@@ -55,6 +57,7 @@ export { default as JoinNode } from "./utils/JoinNode.js";
 export { default as LoopNode } from "./utils/LoopNode.js";
 export { default as MatcapUVNode } from "./utils/MatcapUVNode.js";
 export { default as MaxMipLevelNode } from "./utils/MaxMipLevelNode.js";
+export { default as MemberNode } from "./utils/MemberNode.js";
 export { default as ReflectorNode, ReflectorNodeParameters } from "./utils/ReflectorNode.js";
 export { default as RemapNode } from "./utils/RemapNode.js";
 export { default as RotateNode } from "./utils/RotateNode.js";
@@ -115,7 +118,7 @@ export { default as ScriptableNode } from "./code/ScriptableNode.js";
 export { default as ScriptableValueNode } from "./code/ScriptableValueNode.js";
 
 // geometry
-export { default as RangeNode, RangeModeBound } from "./geometry/RangeNode.js";
+export { default as RangeNode } from "./geometry/RangeNode.js";
 
 // gpgpu
 export { default as ComputeNode } from "./gpgpu/ComputeNode.js";
@@ -130,7 +133,7 @@ export { default as EnvironmentNode } from "./lighting/EnvironmentNode.js";
 export { default as HemisphereLightNode } from "./lighting/HemisphereLightNode.js";
 export { default as IESSpotLightNode } from "./lighting/IESSpotLightNode.js";
 export { default as IrradianceNode } from "./lighting/IrradianceNode.js";
-export { default as LightingContextNode } from "./lighting/LightingContextNode.js";
+export { default as LightingContextNode, LightingContext } from "./lighting/LightingContextNode.js";
 export { default as LightingNode } from "./lighting/LightingNode.js";
 export { default as LightProbeNode } from "./lighting/LightProbeNode.js";
 export { default as LightsNode } from "./lighting/LightsNode.js";

three/src/nodes/TSL.d.ts

@@ -13,6 +13,7 @@ export * from "./core/OutputStructNode.js";
 export * from "./core/ParameterNode.js";
 export * from "./core/PropertyNode.js";
 export * from "./core/StackNode.js";
+export * from "./core/StructNode.js";
 export * from "./core/UniformGroupNode.js";
 export * from "./core/UniformNode.js";
 export * from "./core/VaryingNode.js";
@@ -132,6 +133,7 @@ export * from "./accessors/Lights.js";
 export * from "./lighting/LightingContextNode.js";
 export * from "./lighting/LightsNode.js";
 export * from "./lighting/PointLightNode.js";
+export * from "./lighting/PointShadowNode.js";
 export * from "./lighting/ShadowBaseNode.js";
 export * from "./lighting/ShadowNode.js";
 
@@ -142,6 +144,9 @@ export * from "./pmrem/PMREMUtils.js";
 // procedural
 export * from "./procedural/Checker.js";
 
+// shapes
+export * from "./shapes/Shapes.js";
+
 // materialX
 export * from "./materialx/MaterialXNodes.js";
 

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

@@ -1,7 +1,14 @@
 import { TypedArray } from "../../core/BufferAttribute.js";
+import { Struct } from "../core/StructNode.js";
 import { ShaderNodeObject } from "../tsl/TSLCore.js";
 import StorageBufferNode from "./StorageBufferNode.js";
 
-export const attributeArray: (count: TypedArray | number, type?: string) => ShaderNodeObject<StorageBufferNode>;
+export const attributeArray: (
+    count: TypedArray | number,
+    type?: string | Struct,
+) => ShaderNodeObject<StorageBufferNode>;
 
-export const instancedArray: (count: TypedArray | number, type?: string) => ShaderNodeObject<StorageBufferNode>;
+export const instancedArray: (
+    count: TypedArray | number,
+    type?: string | Struct,
+) => ShaderNodeObject<StorageBufferNode>;

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

@@ -4,7 +4,6 @@ import { InterleavedBuffer } from "../../core/InterleavedBuffer.js";
 import { InterleavedBufferAttribute } from "../../core/InterleavedBufferAttribute.js";
 import InputNode from "../core/InputNode.js";
 import NodeBuilder from "../core/NodeBuilder.js";
-/** @module BufferAttributeNode **/
 /**
  * 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
@@ -40,9 +39,9 @@ declare class BufferAttributeNode extends InputNode<TypedArray | InterleavedBuff
      * Constructs a new buffer attribute node.
      *
      * @param {BufferAttribute|InterleavedBuffer|TypedArray} value - The attribute data.
-     * @param {String?} [bufferType=null] - The buffer type (e.g. `'vec3'`).
-     * @param {Number} [bufferStride=0] - The buffer stride.
-     * @param {Number} [bufferOffset=0] - The buffer offset.
+     * @param {?string} [bufferType=null] - The buffer type (e.g. `'vec3'`).
+     * @param {number} [bufferStride=0] - The buffer stride.
+     * @param {number} [bufferOffset=0] - The buffer offset.
      */
     constructor(
         value: TypedArray | InterleavedBuffer | BufferAttribute,
@@ -55,7 +54,7 @@ declare class BufferAttributeNode extends InputNode<TypedArray | InterleavedBuff
      * and thus the hash should be shared as well.
      *
      * @param {NodeBuilder} builder - The current node builder.
-     * @return {String} The hash.
+     * @return {string} The hash.
      */
     getHash(builder: NodeBuilder): string;
     /**
@@ -63,7 +62,7 @@ declare class BufferAttributeNode extends InputNode<TypedArray | InterleavedBuff
      * the buffer attribute.
      *
      * @param {NodeBuilder} builder - The current node builder.
-     * @return {String} The node type.
+     * @return {string} The node type.
      */
     getNodeType(builder: NodeBuilder): string | null;
     /**
@@ -78,27 +77,27 @@ declare class BufferAttributeNode extends InputNode<TypedArray | InterleavedBuff
      * Generates the code snippet of the buffer attribute node.
      *
      * @param {NodeBuilder} builder - The current node builder.
-     * @return {String} The generated code snippet.
+     * @return {string} The generated code snippet.
      */
     generate(builder: NodeBuilder): string | null | undefined;
     /**
      * Overwrites the default implementation to return a fixed value `'bufferAttribute'`.
      *
      * @param {NodeBuilder} builder - The current node builder.
-     * @return {String} The input type.
+     * @return {string} The input type.
      */
     getInputType(): string;
     /**
      * Sets the `usage` property to the given value.
      *
-     * @param {Number} value - The usage to set.
+     * @param {number} value - The usage to set.
      * @return {BufferAttributeNode} A reference to this node.
      */
     setUsage(value: Usage): this;
     /**
      * Sets the `instanced` property to the given value.
      *
-     * @param {Number} value - The value to set.
+     * @param {boolean} value - The value to set.
      * @return {BufferAttributeNode} A reference to this node.
      */
     setInstanced(value: boolean): this;
@@ -107,11 +106,12 @@ export default BufferAttributeNode;
 /**
  * TSL function for creating a buffer attribute node.
  *
+ * @tsl
  * @function
  * @param {BufferAttribute|InterleavedBuffer|TypedArray} array - The attribute data.
- * @param {String?} [type=null] - The buffer type (e.g. `'vec3'`).
- * @param {Number} [stride=0] - The buffer stride.
- * @param {Number} [offset=0] - The buffer offset.
+ * @param {?string} [type=null] - The buffer type (e.g. `'vec3'`).
+ * @param {number} [stride=0] - The buffer stride.
+ * @param {number} [offset=0] - The buffer offset.
  * @returns {BufferAttributeNode}
  */
 export declare const bufferAttribute: (
@@ -124,11 +124,12 @@ export declare const bufferAttribute: (
  * TSL function for creating a buffer attribute node but with dynamic draw usage.
  * Use this function if attribute data are updated per frame.
  *
+ * @tsl
  * @function
  * @param {BufferAttribute|InterleavedBuffer|TypedArray} array - The attribute data.
- * @param {String?} [type=null] - The buffer type (e.g. `'vec3'`).
- * @param {Number} [stride=0] - The buffer stride.
- * @param {Number} [offset=0] - The buffer offset.
+ * @param {?string} [type=null] - The buffer type (e.g. `'vec3'`).
+ * @param {number} [stride=0] - The buffer stride.
+ * @param {number} [offset=0] - The buffer offset.
  * @returns {BufferAttributeNode}
  */
 export declare const dynamicBufferAttribute: (
@@ -140,11 +141,12 @@ export declare const dynamicBufferAttribute: (
 /**
  * TSL function for creating a buffer attribute node but with enabled instancing
  *
+ * @tsl
  * @function
  * @param {BufferAttribute|InterleavedBuffer|TypedArray} array - The attribute data.
- * @param {String?} [type=null] - The buffer type (e.g. `'vec3'`).
- * @param {Number} [stride=0] - The buffer stride.
- * @param {Number} [offset=0] - The buffer offset.
+ * @param {?string} [type=null] - The buffer type (e.g. `'vec3'`).
+ * @param {number} [stride=0] - The buffer stride.
+ * @param {number} [offset=0] - The buffer offset.
  * @returns {BufferAttributeNode}
  */
 export declare const instancedBufferAttribute: (
@@ -156,11 +158,12 @@ export declare const instancedBufferAttribute: (
 /**
  * TSL function for creating a buffer attribute node but with dynamic draw usage and enabled instancing
  *
+ * @tsl
  * @function
  * @param {BufferAttribute|InterleavedBuffer|TypedArray} array - The attribute data.
- * @param {String?} [type=null] - The buffer type (e.g. `'vec3'`).
- * @param {Number} [stride=0] - The buffer stride.
- * @param {Number} [offset=0] - The buffer offset.
+ * @param {?string} [type=null] - The buffer type (e.g. `'vec3'`).
+ * @param {number} [stride=0] - The buffer stride.
+ * @param {number} [offset=0] - The buffer offset.
  * @returns {BufferAttributeNode}
  */
 export declare const instancedDynamicBufferAttribute: (

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

@@ -4,6 +4,7 @@ import { Vector3 } from "../../math/Vector3.js";
 import UniformNode from "../core/UniformNode.js";
 import { ShaderNodeObject } from "../tsl/TSLCore.js";
 
+export const cameraIndex: ShaderNodeObject<UniformNode<number>>;
 export const cameraNear: ShaderNodeObject<UniformNode<number>>;
 export const cameraFar: ShaderNodeObject<UniformNode<number>>;
 export const cameraProjectionMatrix: ShaderNodeObject<UniformNode<Matrix4>>;

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

@@ -4,7 +4,7 @@ import { ShaderNodeObject } from "../tsl/TSLCore.js";
 
 export function lightShadowMatrix(light: Light): ShaderNodeObject<Node>;
 
-export function lightProjectionUV(light: Light): ShaderNodeObject<Node>;
+export function lightProjectionUV(light: Light, position?: Node): ShaderNodeObject<Node>;
 
 export function lightPosition(light: Light): ShaderNodeObject<Node>;
 

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

@@ -37,7 +37,7 @@ export type MaterialNodeScope =
     | typeof MaterialNode.LINE_GAP_SIZE
     | typeof MaterialNode.LINE_WIDTH
     | typeof MaterialNode.LINE_DASH_OFFSET
-    | typeof MaterialNode.POINT_WIDTH
+    | typeof MaterialNode.POINT_SIZE
     | typeof MaterialNode.DISPERSION
     | typeof MaterialNode.LIGHT_MAP
     | typeof MaterialNode.AO
@@ -77,7 +77,7 @@ export default class MaterialNode extends Node {
     static LINE_GAP_SIZE: "gapSize";
     static LINE_WIDTH: "linewidth";
     static LINE_DASH_OFFSET: "dashOffset";
-    static POINT_WIDTH: "pointWidth";
+    static POINT_SIZE: "size";
     static DISPERSION: "dispersion";
     static LIGHT_MAP: "light";
     static AO: "ao";
@@ -122,7 +122,7 @@ export const materialLineDashSize: ShaderNodeObject<MaterialNode>;
 export const materialLineGapSize: ShaderNodeObject<MaterialNode>;
 export const materialLineWidth: ShaderNodeObject<MaterialNode>;
 export const materialLineDashOffset: ShaderNodeObject<MaterialNode>;
-export const materialPointWidth: ShaderNodeObject<MaterialNode>;
+export const materialPointSize: ShaderNodeObject<MaterialNode>;
 export const materialDispersion: ShaderNodeObject<MaterialNode>;
 export const materialLightMap: ShaderNodeObject<MaterialNode>;
 export const materialAO: ShaderNodeObject<MaterialNode>;

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

@@ -1,4 +1,9 @@
+import { Matrix4 } from "../../math/Matrix4.js";
 import UniformNode from "../core/UniformNode.js";
 import { ShaderNodeObject } from "../tsl/TSLCore.js";
 
 export const materialRefractionRatio: ShaderNodeObject<UniformNode<number>>;
+
+export const materialEnvIntensity: ShaderNodeObject<UniformNode<number>>;
+
+export const materialEnvRotation: ShaderNodeObject<UniformNode<Matrix4>>;

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

@@ -16,6 +16,7 @@ export const modelWorldMatrix: ShaderNodeObject<ModelNode>;
 export const modelPosition: ShaderNodeObject<ModelNode>;
 export const modelScale: ShaderNodeObject<ModelNode>;
 export const modelViewPosition: ShaderNodeObject<ModelNode>;
+export const modelRadius: ShaderNodeObject<ModelNode>;
 export const modelNormalMatrix: ShaderNodeObject<Node>;
 export const modelWorldMatrixInverse: ShaderNodeObject<UniformNode<Matrix4>>;
 

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

@@ -13,10 +13,12 @@ export default class Object3DNode extends Node {
     static SCALE: "scale";
     static VIEW_POSITION: "viewPosition";
     static DIRECTION: "direction";
+    static RADIUS: "radius";
 }
 
-export const objectDirection: (object3d: Object3D) => ShaderNodeObject<Object3DNode>;
-export const objectWorldMatrix: (object3d: Object3D) => ShaderNodeObject<Object3DNode>;
-export const objectPosition: (object3d: Object3D) => ShaderNodeObject<Object3DNode>;
-export const objectScale: (object3d: Object3D) => ShaderNodeObject<Object3DNode>;
-export const objectViewPosition: (object3d: Object3D) => ShaderNodeObject<Object3DNode>;
+export const objectDirection: (object3d?: Object3D | null) => ShaderNodeObject<Object3DNode>;
+export const objectWorldMatrix: (object3d?: Object3D | null) => ShaderNodeObject<Object3DNode>;
+export const objectPosition: (object3d?: Object3D | null) => ShaderNodeObject<Object3DNode>;
+export const objectScale: (object3d?: Object3D | null) => ShaderNodeObject<Object3DNode>;
+export const objectViewPosition: (object3d?: Object3D | null) => ShaderNodeObject<Object3DNode>;
+export const objectRadius: (object3d?: Object3D | null) => ShaderNodeObject<Object3DNode>;

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

@@ -1,6 +1,8 @@
 import StorageBufferAttribute from "../../renderers/common/StorageBufferAttribute.js";
 import StorageInstancedBufferAttribute from "../../renderers/common/StorageInstancedBufferAttribute.js";
 import { NodeAccess } from "../core/constants.js";
+import { Struct } from "../core/StructNode.js";
+import StructTypeNode from "../core/StructTypeNode.js";
 import { NodeRepresentation, ShaderNodeObject } from "../tsl/TSLCore.js";
 import StorageArrayElementNode from "../utils/StorageArrayElementNode.js";
 import BufferNode from "./BufferNode.js";
@@ -8,6 +10,8 @@ import BufferNode from "./BufferNode.js";
 export default class StorageBufferNode extends BufferNode<StorageBufferAttribute | StorageInstancedBufferAttribute> {
     readonly isStorageBufferNode: true;
 
+    structTypeNode: StructTypeNode | null;
+
     access: NodeAccess;
     isAtomic: boolean;
     isPBO: boolean;
@@ -16,7 +20,7 @@ export default class StorageBufferNode extends BufferNode<StorageBufferAttribute
 
     constructor(
         value: StorageBufferAttribute | StorageInstancedBufferAttribute,
-        bufferType?: string | null,
+        bufferType?: string | Struct | null,
         bufferCount?: number,
     );
 
@@ -37,7 +41,7 @@ export default class StorageBufferNode extends BufferNode<StorageBufferAttribute
 
 export const storage: (
     value: StorageBufferAttribute | StorageInstancedBufferAttribute,
-    type?: string | null,
+    type?: string | Struct | null,
     count?: number,
 ) => ShaderNodeObject<StorageBufferNode>;
 
@@ -46,6 +50,6 @@ export const storage: (
  */
 export const storageObject: (
     value: StorageBufferAttribute | StorageInstancedBufferAttribute,
-    type?: string | null,
+    type?: string | Struct | null,
     count?: number,
 ) => ShaderNodeObject<StorageBufferNode>;

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

@@ -12,6 +12,6 @@ export default class Texture3DNode extends TextureNode {
 
 export const texture3D: (
     value: Texture,
-    uvNode?: NodeRepresentation,
-    levelNode?: NodeRepresentation,
+    uvNode?: NodeRepresentation | null,
+    levelNode?: NodeRepresentation | null,
 ) => ShaderNodeObject<Texture3DNode>;

three/src/nodes/core/ArrayNode.d.ts

@@ -0,0 +1,26 @@
+import { ShaderNodeObject } from "../tsl/TSLCore.js";
+import Node from "./Node.js";
+import TempNode from "./TempNode.js";
+
+declare class ArrayNode extends TempNode {
+    count: number;
+    values: Node[];
+    readonly isArrayNode: true;
+
+    constructor(nodeType: string, count: number, values: Node[]);
+}
+
+export default ArrayNode;
+
+interface ArrayFunction {
+    (values: Node[]): ShaderNodeObject<ArrayNode>;
+    (nodeType: string, count: number): ShaderNodeObject<ArrayNode>;
+}
+
+export const array: ArrayFunction;
+
+declare module "../tsl/TSLCore.js" {
+    interface NodeElements {
+        toArray: typeof array;
+    }
+}

three/src/nodes/core/LightingModel.d.ts

@@ -1,6 +1,6 @@
+import { DirectLightData, DirectRectAreaLightData } from "../lighting/LightsNode.js";
 import Node from "./Node.js";
 import NodeBuilder from "./NodeBuilder.js";
-import StackNode from "./StackNode.js";
 
 export interface LightingModelReflectedLight {
     directDiffuse: Node;
@@ -9,38 +9,23 @@ export interface LightingModelReflectedLight {
     indirectSpecular: Node;
 }
 
-export interface LightingModelDirectInput {
-    lightDirection: Node;
-    lightColor: Node;
+export interface LightingModelDirectInput extends DirectLightData {
+    lightNode: Node;
     reflectedLight: LightingModelReflectedLight;
 }
 
-export interface LightingModelDirectRectAreaInput {
-    lightColor: Node;
-    lightPosition: Node;
-    halfWidth: Node;
-    halfHeight: Node;
+export interface LightingModelDirectRectAreaInput extends DirectRectAreaLightData {
+    lightNode: Node;
     reflectedLight: LightingModelReflectedLight;
-    ltc_1: Node;
-    ltc_2: Node;
 }
 
-export interface LightingModelIndirectInput {
-    radiance: Node;
-    irradiance: Node;
-    iblIrradiance: Node;
-    ambientOcclusion: Node;
-    reflectedLight: LightingModelReflectedLight;
-    backdrop: Node;
-    backdropAlpha: Node;
-    outgoingLight: Node;
+declare class LightingModel {
+    start(builder: NodeBuilder): void;
+    finish(builder: NodeBuilder): void;
+    direct(lightData: LightingModelDirectInput, builder: NodeBuilder): void;
+    directRectArea(lightData: LightingModelDirectRectAreaInput, builder: NodeBuilder): void;
+    indirect(builder: NodeBuilder): void;
+    ambientOcclusion(builder: NodeBuilder): void;
 }
 
-export default class LightingModel {
-    start(input: LightingModelIndirectInput, stack: StackNode, builder: NodeBuilder): void;
-    finish(input: LightingModelIndirectInput, stack: StackNode, builder: NodeBuilder): void;
-    direct(input: LightingModelDirectInput, stack: StackNode, builder: NodeBuilder): void;
-    directRectArea(input: LightingModelDirectRectAreaInput, stack: StackNode, builder: NodeBuilder): void;
-    indirect(input: LightingModelIndirectInput, stack: StackNode, builder: NodeBuilder): void;
-    ambientOcclusion(input: LightingModelIndirectInput, stack: StackNode, builder: NodeBuilder): void;
-}
+export default LightingModel;

three/src/nodes/core/Node.d.ts

@@ -81,13 +81,13 @@ declare class Node extends EventDispatcher<{
     /**
      * Constructs a new node.
      *
-     * @param {String?} nodeType - The node type.
+     * @param {?string} nodeType - The node type.
      */
     constructor(nodeType?: string | null);
     /**
      * Set this property to `true` when the node should be regenerated.
      *
-     * @type {Boolean}
+     * @type {boolean}
      * @default false
      * @param {boolean} value
      */
@@ -95,7 +95,7 @@ declare class Node extends EventDispatcher<{
     /**
      * The type of the class. The value is usually the constructor name.
      *
-     * @type {String}
+     * @type {string}
      * @readonly
      */
     get type(): string | undefined;
@@ -103,7 +103,7 @@ declare class Node extends EventDispatcher<{
      * Convenient method for defining {@link Node#update}.
      *
      * @param {Function} callback - The update method.
-     * @param {String} updateType - The update type.
+     * @param {string} updateType - The update type.
      * @return {Node} A reference to this node.
      */
     onUpdate(callback: (this: this, frame: NodeFrame) => unknown, updateType: NodeUpdateType): this;
@@ -149,8 +149,8 @@ declare class Node extends EventDispatcher<{
      * Nodes might refer to other objects like materials. This method allows to dynamically update the reference
      * to such objects based on a given state (e.g. the current node frame or builder).
      *
-     * @param {Any} state - This method can be invocated in different contexts so `state` can refer to any object type.
-     * @return {Any} The updated reference.
+     * @param {any} state - This method can be invocated in different contexts so `state` can refer to any object type.
+     * @return {any} The updated reference.
      */
     updateReference(state: NodeBuilder | NodeFrame): unknown;
     /**
@@ -159,7 +159,7 @@ declare class Node extends EventDispatcher<{
      * global status.
      *
      * @param {NodeBuilder} builder - The current node builder.
-     * @return {Boolean} Whether this node is global or not.
+     * @return {boolean} Whether this node is global or not.
      */
     isGlobal(builder: NodeBuilder): boolean;
     /**
@@ -189,14 +189,14 @@ declare class Node extends EventDispatcher<{
     /**
      * Returns the cache key for this node.
      *
-     * @param {Boolean} [force=false] - When set to `true`, a recomputation of the cache key is forced.
-     * @return {Number} The cache key of the node.
+     * @param {boolean} [force=false] - When set to `true`, a recomputation of the cache key is forced.
+     * @return {number} The cache key of the node.
      */
     getCacheKey(force?: boolean): number;
     /**
      * Generate a custom cache key for this node.
      *
-     * @return {Number} The cache key of the node.
+     * @return {number} The cache key of the node.
      */
     customCacheKey(): number;
     /**
@@ -211,7 +211,7 @@ declare class Node extends EventDispatcher<{
      * depending on their implementation.
      *
      * @param {NodeBuilder} builder - The current node builder.
-     * @return {String} The hash.
+     * @return {string} The hash.
      */
     getHash(builder: NodeBuilder): string;
     /**
@@ -238,14 +238,22 @@ declare class Node extends EventDispatcher<{
      * these elements.
      *
      * @param {NodeBuilder} builder - The current node builder.
-     * @return {String} The type of the node.
+     * @return {string} The type of the node.
      */
     getElementType(builder: NodeBuilder): "bool" | "int" | "float" | "vec2" | "vec3" | "vec4" | "uint" | null;
+    /**
+     * Returns the node member type for the given name.
+     *
+     * @param {NodeBuilder} builder - The current node builder.
+     * @param {string} name - The name of the member.
+     * @return {string} The type of the node.
+     */
+    getMemberType(builder: NodeBuilder, name: string): string;
     /**
      * Returns the node's type.
      *
      * @param {NodeBuilder} builder - The current node builder.
-     * @return {String} The type of the node.
+     * @return {string} The type of the node.
      */
     getNodeType(builder: NodeBuilder): string | null;
     /**
@@ -264,7 +272,7 @@ declare class Node extends EventDispatcher<{
      * The output node must be returned in the `return` statement.
      *
      * @param {NodeBuilder} builder - The current node builder.
-     * @return {Node?} The output node.
+     * @return {?Node} The output node.
      */
     setup(builder: NodeBuilder): unknown;
     /**
@@ -279,8 +287,8 @@ declare class Node extends EventDispatcher<{
      * This state builds the output node and returns the resulting shader string.
      *
      * @param {NodeBuilder} builder - The current node builder.
-     * @param {String?} output - Can be used to define the output type.
-     * @return {String?} The generated shader string.
+     * @param {?string} output - Can be used to define the output type.
+     * @return {?string} The generated shader string.
      */
     generate(builder: NodeBuilder, output?: string | null): string | null | undefined;
     /**
@@ -289,7 +297,7 @@ declare class Node extends EventDispatcher<{
      *
      * @abstract
      * @param {NodeFrame} frame - A reference to the current node frame.
-     * @return {Boolean?} An optional bool that indicates whether the implementation actually performed an update or not (e.g. due to caching).
+     * @return {?boolean} An optional bool that indicates whether the implementation actually performed an update or not (e.g. due to caching).
      */
     updateBefore(frame: NodeFrame): void;
     /**
@@ -298,7 +306,7 @@ declare class Node extends EventDispatcher<{
      *
      * @abstract
      * @param {NodeFrame} frame - A reference to the current node frame.
-     * @return {Boolean?} An optional bool that indicates whether the implementation actually performed an update or not (e.g. due to caching).
+     * @return {?boolean} An optional bool that indicates whether the implementation actually performed an update or not (e.g. due to caching).
      */
     updateAfter(frame: NodeFrame): void;
     /**
@@ -307,7 +315,7 @@ declare class Node extends EventDispatcher<{
      *
      * @abstract
      * @param {NodeFrame} frame - A reference to the current node frame.
-     * @return {Boolean?} An optional bool that indicates whether the implementation actually performed an update or not (e.g. due to caching).
+     * @return {?boolean} An optional bool that indicates whether the implementation actually performed an update or not (e.g. due to caching).
      */
     update(frame: NodeFrame): void;
     /**
@@ -315,14 +323,14 @@ declare class Node extends EventDispatcher<{
      * on the current build stage (setup, analyze or generate).
      *
      * @param {NodeBuilder} builder - The current node builder.
-     * @param {String?} output - Can be used to define the output type.
-     * @return {String?} When this method is executed in the setup or analyze stage, `null` is returned. In the generate stage, the generated shader string.
+     * @param {?string} output - Can be used to define the output type.
+     * @return {?string} When this method is executed in the setup or analyze stage, `null` is returned. In the generate stage, the generated shader string.
      */
     build(builder: NodeBuilder, output?: string | null): string | null;
     /**
      * Returns the child nodes as a JSON object.
      *
-     * @return {Object} The serialized child objects as JSON.
+     * @return {Array<Object>} An iterable list of serialized child objects as JSON.
      */
     getSerializeChildren(): Generator<import("./NodeUtils.js").NodeChild, void, unknown>;
     /**
@@ -340,7 +348,7 @@ declare class Node extends EventDispatcher<{
     /**
      * Serializes the node into the three.js JSON Object/Scene format.
      *
-     * @param {Object?} meta - An optional JSON object that already holds serialized data from other scene objects.
+     * @param {?Object} meta - An optional JSON object that already holds serialized data from other scene objects.
      * @return {Object} The serialized node.
      */
     toJSON(meta?: NodeJSONMeta | string): NodeJSONOutputData;

three/src/nodes/core/NodeAttribute.d.ts

@@ -13,9 +13,9 @@ declare class NodeAttribute {
     /**
      * Constructs a new node attribute.
      *
-     * @param {String} name - The name of the attribute.
-     * @param {String} type - The type of the attribute.
-     * @param {Node?} node - An optional reference to the node.
+     * @param {string} name - The name of the attribute.
+     * @param {string} type - The type of the attribute.
+     * @param {?Node} node - An optional reference to the node.
      */
     constructor(name: string, type: string | null, node?: Node | null);
 }