@types/three 0.182.0 → 0.183.0

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

@@ -1,111 +1,56 @@
 import { BufferAttribute } from "../../../core/BufferAttribute.js";
 import { Light } from "../../../lights/Light.js";
-import { Matrix4 } from "../../../math/Matrix4.js";
 import NodeBuilder from "../../../nodes/core/NodeBuilder.js";
 import NodeFrame from "../../../nodes/core/NodeFrame.js";
 import LightsNode from "../../../nodes/lighting/LightsNode.js";
 import Renderer from "../../../renderers/common/Renderer.js";
 import RenderObject from "../../../renderers/common/RenderObject.js";
 import { Material } from "../../Material.js";
-declare const refreshUniforms: readonly [
-    "alphaMap",
-    "alphaTest",
-    "anisotropy",
-    "anisotropyMap",
-    "anisotropyRotation",
-    "aoMap",
-    "aoMapIntensity",
-    "attenuationColor",
-    "attenuationDistance",
-    "bumpMap",
-    "clearcoat",
-    "clearcoatMap",
-    "clearcoatNormalMap",
-    "clearcoatNormalScale",
-    "clearcoatRoughness",
-    "color",
-    "dispersion",
-    "displacementMap",
-    "emissive",
-    "emissiveIntensity",
-    "emissiveMap",
-    "envMap",
-    "envMapIntensity",
-    "gradientMap",
-    "ior",
-    "iridescence",
-    "iridescenceIOR",
-    "iridescenceMap",
-    "iridescenceThicknessMap",
-    "lightMap",
-    "lightMapIntensity",
-    "map",
-    "matcap",
-    "metalness",
-    "metalnessMap",
-    "normalMap",
-    "normalScale",
-    "opacity",
-    "roughness",
-    "roughnessMap",
-    "sheen",
-    "sheenColor",
-    "sheenColorMap",
-    "sheenRoughnessMap",
-    "shininess",
-    "specular",
-    "specularColor",
-    "specularColorMap",
-    "specularIntensity",
-    "specularIntensityMap",
-    "specularMap",
-    "thickness",
-    "transmission",
-    "transmissionMap",
-];
-type RefreshUniform = (typeof refreshUniforms)[number];
-type MaterialData = {
-    [K in RefreshUniform]?: unknown;
-};
-interface AttributesData {
-    [name: string]: {
-        version: number;
-    };
-}
-interface RenderObjectData {
-    material: MaterialData;
-    geometry: {
-        id: number;
-        attributes: AttributesData;
-        indexVersion: number | null;
-        drawRange: {
-            start: number;
-            count: number;
-        };
-    };
-    worldMatrix: Matrix4;
-    version?: number;
-}
-interface LightData {
-    map: number;
-}
+
 /**
  * This class is used by {@link WebGPURenderer} as management component.
  * It's primary purpose is to determine whether render objects require a
  * refresh right before they are going to be rendered or not.
  */
 declare class NodeMaterialObserver {
-    renderObjects: WeakMap<RenderObject, RenderObjectData>;
-    hasNode: boolean;
-    hasAnimation: boolean;
-    refreshUniforms: readonly RefreshUniform[];
-    renderId: number;
     /**
      * Constructs a new node material observer.
      *
      * @param {NodeBuilder} builder - The node builder.
      */
     constructor(builder: NodeBuilder);
+    /**
+     * A node material can be used by more than one render object so the
+     * monitor must maintain a list of render objects.
+     *
+     * @type {WeakMap<RenderObject,Object>}
+     */
+    renderObjects: WeakMap<RenderObject, unknown>;
+    /**
+     * Whether the material uses node objects or not.
+     *
+     * @type {boolean}
+     */
+    hasNode: boolean;
+    /**
+     * Whether the node builder's 3D object is animated or not.
+     *
+     * @type {boolean}
+     */
+    hasAnimation: boolean;
+    /**
+     * A list of all possible material uniforms
+     *
+     * @type {Array<string>}
+     */
+    refreshUniforms: string[];
+    /**
+     * Holds the current render ID from the node frame.
+     *
+     * @type {number}
+     * @default 0
+     */
+    renderId: number;
     /**
      * Returns `true` if the given render object is verified for the first time of this observer.
      *
@@ -126,7 +71,7 @@ declare class NodeMaterialObserver {
      * @param {RenderObject} renderObject - The render object.
      * @return {Object} The monitoring data.
      */
-    getRenderObjectData(renderObject: RenderObject): RenderObjectData;
+    getRenderObjectData(renderObject: RenderObject): unknown;
     /**
      * Returns an attribute data structure holding the attributes versions for
      * monitoring.
@@ -134,7 +79,7 @@ declare class NodeMaterialObserver {
      * @param {Object} attributes - The geometry attributes.
      * @return {Object} An object for monitoring the versions of attributes.
      */
-    getAttributesData(attributes: Record<string, BufferAttribute>): AttributesData;
+    getAttributesData(attributes: Record<string, BufferAttribute>): unknown;
     /**
      * Returns `true` if the node builder's material uses
      * node properties.
@@ -150,7 +95,7 @@ declare class NodeMaterialObserver {
      * @param {Material} material - The material.
      * @return {Object} An object for monitoring material properties.
      */
-    getMaterialData(material: Material): MaterialData;
+    getMaterialData(material: Material): unknown;
     /**
      * Returns `true` if the given render object has not changed its state.
      *
@@ -165,7 +110,7 @@ declare class NodeMaterialObserver {
      * @param {Array<Light>} materialLights - The material lights.
      * @return {Array<Object>} The lights data for the given material lights.
      */
-    getLightsData(materialLights: Light[]): LightData[];
+    getLightsData(materialLights: Light[]): unknown[];
     /**
      * Returns the lights for the given lights node and render ID.
      *
@@ -173,7 +118,7 @@ declare class NodeMaterialObserver {
      * @param {number} renderId - The render ID.
      * @return {Array<Object>} The lights for the given lights node and render ID.
      */
-    getLights(lightsNode: LightsNode, renderId: number): LightData[];
+    getLights(lightsNode: LightsNode, renderId: number): unknown[];
     /**
      * Checks if the given render object requires a refresh.
      *
@@ -183,4 +128,5 @@ declare class NodeMaterialObserver {
      */
     needsRefresh(renderObject: RenderObject, nodeFrame: NodeFrame): boolean;
 }
+
 export default NodeMaterialObserver;

three/src/math/Color.d.ts

@@ -221,6 +221,7 @@ export class Color {
      */
     b: number;
 
+    // eslint-disable-next-line @definitelytyped/no-single-element-tuple-type
     set(...args: [color: ColorRepresentation] | [r: number, g: number, b: number]): this;
 
     /**

three/src/math/Vector3.d.ts

@@ -98,7 +98,7 @@ export class Vector3 {
      */
     addVectors(a: Vector3Like, b: Vector3Like): this;
 
-    addScaledVector(v: Vector3, s: number): this;
+    addScaledVector(v: Vector3Like, s: number): this;
 
     /**
      * Subtracts v from this vector.
@@ -123,7 +123,7 @@ export class Vector3 {
 
     applyEuler(euler: Euler): this;
 
-    applyAxisAngle(axis: Vector3, angle: number): this;
+    applyAxisAngle(axis: Vector3Like, angle: number): this;
 
     applyMatrix3(m: Matrix3): this;
 

three/src/math/interpolants/BezierInterpolant.d.ts

@@ -0,0 +1,7 @@
+import { Interpolant } from "../Interpolant.js";
+
+export class BezierInterpolant extends Interpolant {
+    constructor(parameterPositions: any, samplesValues: any, sampleSize: number, resultBuffer?: any);
+
+    interpolate_(i1: number, t0: number, t: number, t1: number): any;
+}

three/src/nodes/Nodes.d.ts

@@ -9,6 +9,8 @@ export { default as BypassNode } from "./core/BypassNode.js";
 export { default as ConstNode } from "./core/ConstNode.js";
 export { default as ContextNode } from "./core/ContextNode.js";
 export { default as IndexNode, IndexNodeScope } from "./core/IndexNode.js";
+export { default as InputNode } from "./core/InputNode.js";
+export { default as InspectorNode } from "./core/InspectorNode.js";
 export { default as IsolateNode } from "./core/IsolateNode.js";
 export {
     default as LightingModel,
@@ -26,8 +28,9 @@ export {
     NodeBuilderContext,
     NodeData,
 } from "./core/NodeBuilder.js";
-export { default as NodeCache, ShaderStageNodeData } from "./core/NodeCache.js";
+export { default as NodeCache } from "./core/NodeCache.js";
 export { default as NodeCode } from "./core/NodeCode.js";
+export { default as NodeError } from "./core/NodeError.js";
 export { default as NodeFrame } from "./core/NodeFrame.js";
 export { default as NodeFunctionInput } from "./core/NodeFunctionInput.js";
 export { default as NodeUniform } from "./core/NodeUniform.js";
@@ -37,6 +40,7 @@ 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 StackTrace } from "./core/StackTrace.js";
 export { default as StructNode } from "./core/StructNode.js";
 export { default as StructTypeNode } from "./core/StructTypeNode.js";
 export { default as SubBuildNode } from "./core/SubBuildNode.js";
@@ -49,32 +53,12 @@ export { default as VaryingNode } from "./core/VaryingNode.js";
 import * as NodeUtils from "./core/NodeUtils.js";
 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 EventNode } from "./utils/EventNode.js";
-export { default as FunctionOverloadingNode } from "./utils/FunctionOverloadingNode.js";
-export { default as JoinNode } from "./utils/JoinNode.js";
-export { default as LoopNode } from "./utils/LoopNode.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";
-export { default as RTTNode, RTTNodeOptions } from "./utils/RTTNode.js";
-export { default as SetNode } from "./utils/SetNode.js";
-export { default as SplitNode } from "./utils/SplitNode.js";
-export { default as SpriteSheetUVNode } from "./utils/SpriteSheetUVNode.js";
-export { default as StorageArrayElementNode } from "./utils/StorageArrayElementNode.js";
-
-// math
-export { default as BitcastNode } from "./math/BitcastNode.js";
-
 // accessors
 export { default as BatchNode } from "./accessors/BatchNode.js";
 export { default as BufferAttributeNode } from "./accessors/BufferAttributeNode.js";
 export { default as BufferNode } from "./accessors/BufferNode.js";
+export { default as BuiltinNode } from "./accessors/BuiltinNode.js";
+export { default as ClippingNode } from "./accessors/ClippingNode.js";
 export { default as CubeTextureNode } from "./accessors/CubeTextureNode.js";
 export { default as InstancedMeshNode } from "./accessors/InstancedMeshNode.js";
 export { default as InstanceNode } from "./accessors/InstanceNode.js";
@@ -84,9 +68,9 @@ export { default as ModelNode } from "./accessors/ModelNode.js";
 export { default as MorphNode } from "./accessors/MorphNode.js";
 export { default as Object3DNode } from "./accessors/Object3DNode.js";
 export { default as PointUVNode } from "./accessors/PointUVNode.js";
+export { default as ReferenceBaseNode } from "./accessors/ReferenceBaseNode.js";
 export { default as ReferenceNode } from "./accessors/ReferenceNode.js";
 export { default as RendererReferenceNode } from "./accessors/RendererReferenceNode.js";
-export { default as SceneNode, SceneNodeScope } from "./accessors/SceneNode.js";
 export { default as SkinningNode } from "./accessors/SkinningNode.js";
 export { default as StorageBufferNode } from "./accessors/StorageBufferNode.js";
 export { default as StorageTextureNode } from "./accessors/StorageTextureNode.js";
@@ -95,42 +79,47 @@ export { default as TextureNode } from "./accessors/TextureNode.js";
 export { default as TextureSizeNode } from "./accessors/TextureSizeNode.js";
 export { default as UniformArrayNode } from "./accessors/UniformArrayNode.js";
 export { default as UserDataNode, NodeUserData } from "./accessors/UserDataNode.js";
+export { default as VelocityNode } from "./accessors/VelocityNode.js";
 export { default as VertexColorNode } from "./accessors/VertexColorNode.js";
 
+// code
+export { CodeNodeInclude, default as CodeNode } from "./code/CodeNode.js";
+export { default as ExpressionNode } from "./code/ExpressionNode.js";
+export { default as FunctionCallNode } from "./code/FunctionCallNode.js";
+export { default as FunctionNode } from "./code/FunctionNode.js";
+
 // display
 export { default as BumpMapNode } from "./display/BumpMapNode.js";
 export { default as ColorSpaceNode } from "./display/ColorSpaceNode.js";
 export { default as FrontFacingNode } from "./display/FrontFacingNode.js";
 export { default as NormalMapNode } from "./display/NormalMapNode.js";
 export { default as PassNode, PassNodeScope } from "./display/PassNode.js";
-export { default as PosterizeNode } from "./display/PosterizeNode.js";
 export { default as RenderOutputNode } from "./display/RenderOutputNode.js";
 export { default as ScreenNode, ScreenNodeScope } from "./display/ScreenNode.js";
 export { default as ToneMappingNode } from "./display/ToneMappingNode.js";
+export { default as ToonOutlinePassNode } from "./display/ToonOutlinePassNode.js";
 export { default as ViewportDepthNode, ViewportDepthNodeScope } from "./display/ViewportDepthNode.js";
 export { default as ViewportDepthTextureNode } from "./display/ViewportDepthTextureNode.js";
 export { default as ViewportSharedTextureNode } from "./display/ViewportSharedTextureNode.js";
 export { default as ViewportTextureNode } from "./display/ViewportTextureNode.js";
 
-// code
-export { CodeNodeInclude, default as CodeNode } from "./code/CodeNode.js";
-export { default as ExpressionNode } from "./code/ExpressionNode.js";
-export { default as FunctionCallNode } from "./code/FunctionCallNode.js";
-export { default as FunctionNode } from "./code/FunctionNode.js";
-export { default as ScriptableNode } from "./code/ScriptableNode.js";
-export { default as ScriptableValueNode } from "./code/ScriptableValueNode.js";
-
 // geometry
 export { default as RangeNode } from "./geometry/RangeNode.js";
 
 // gpgpu
+export { default as AtomicFunctionNode } from "./gpgpu/AtomicFunctionNode.js";
+export { default as BarrierNode } from "./gpgpu/BarrierNode.js";
+export { default as ComputeBuiltinNode } from "./gpgpu/ComputeBuiltinNode.js";
 export { default as ComputeNode } from "./gpgpu/ComputeNode.js";
+export { default as SubgroupFunctionNode } from "./gpgpu/SubgroupFunctionNode.js";
+export { default as WorkgroupInfoNode } from "./gpgpu/WorkgroupInfoNode.js";
 
 // lighting
 export { default as AmbientLightNode } from "./lighting/AmbientLightNode.js";
 export { default as AnalyticLightNode } from "./lighting/AnalyticLightNode.js";
 export { default as AONode } from "./lighting/AONode.js";
 export { default as BasicEnvironmentNode } from "./lighting/BasicEnvironmentNode.js";
+export { default as BasicLightMapNode } from "./lighting/BasicLightMapNode.js";
 export { default as DirectionalLightNode } from "./lighting/DirectionalLightNode.js";
 export { default as EnvironmentNode } from "./lighting/EnvironmentNode.js";
 export { default as HemisphereLightNode } from "./lighting/HemisphereLightNode.js";
@@ -141,18 +130,49 @@ export { default as LightingNode } from "./lighting/LightingNode.js";
 export { default as LightProbeNode } from "./lighting/LightProbeNode.js";
 export { default as LightsNode } from "./lighting/LightsNode.js";
 export { default as PointLightNode } from "./lighting/PointLightNode.js";
+export { default as PointShadowNode } from "./lighting/PointShadowNode.js";
 export { default as ProjectorLightNode } from "./lighting/ProjectorLightNode.js";
 export { default as RectAreaLightNode, RectAreaLightTexturesLib } from "./lighting/RectAreaLightNode.js";
 export { default as ShadowBaseNode } from "./lighting/ShadowBaseNode.js";
 export { default as ShadowNode } from "./lighting/ShadowNode.js";
 export { default as SpotLightNode } from "./lighting/SpotLightNode.js";
 
-// pmrem
-export { default as PMREMNode } from "./pmrem/PMREMNode.js";
+// math
+export { default as BitcastNode } from "./math/BitcastNode.js";
+export { default as BitcountNode } from "./math/BitcountNode.js";
+export { default as ConditionalNode } from "./math/ConditionalNode.js";
+export { default as MathNode } from "./math/MathNode.js";
+export { default as OperatorNode } from "./math/OperatorNode.js";
+export { default as PackFloatNode } from "./math/PackFloatNode.js";
+export { default as UnpackFloatNode } from "./math/UnpackFloatNode.js";
 
 // parsers
 export { default as GLSLNodeParser } from "./parsers/GLSLNodeParser.js";
 
+// pmrem
+export { default as PMREMNode } from "./pmrem/PMREMNode.js";
+
+// utils
+export { default as ArrayElementNode } from "./utils/ArrayElementNode.js";
+export { default as ConvertNode } from "./utils/ConvertNode.js";
+export { default as CubeMapNode } from "./utils/CubeMapNode.js";
+export { default as DebugNode } from "./utils/DebugNode.js";
+export { default as EventNode } from "./utils/EventNode.js";
+export { default as FlipNode } from "./utils/FlipNode.js";
+export { default as FunctionOverloadingNode } from "./utils/FunctionOverloadingNode.js";
+export { default as JoinNode } from "./utils/JoinNode.js";
+export { default as LoopNode } from "./utils/LoopNode.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";
+export { default as RTTNode, RTTNodeOptions } from "./utils/RTTNode.js";
+export { default as SampleNode } from "./utils/SampleNode.js";
+export { default as SetNode } from "./utils/SetNode.js";
+export { default as SplitNode } from "./utils/SplitNode.js";
+export { default as StorageArrayElementNode } from "./utils/StorageArrayElementNode.js";
+
 // lighting models
 export { default as PhongLightingModel } from "./functions/PhongLightingModel.js";
 export { default as PhysicalLightingModel } from "./functions/PhysicalLightingModel.js";

three/src/nodes/TSL.d.ts

@@ -42,7 +42,7 @@ export * from "./utils/RemapNode.js";
 export * from "./utils/RotateNode.js";
 export * from "./utils/RTTNode.js";
 export * from "./utils/SampleNode.js";
-export * from "./utils/SpriteSheetUVNode.js";
+export * from "./utils/SpriteSheetUV.js";
 export * from "./utils/SpriteUtils.js";
 export * from "./utils/Timer.js";
 export * from "./utils/TriplanarTextures.js";
@@ -77,7 +77,7 @@ export * from "./accessors/Position.js";
 export * from "./accessors/ReferenceNode.js";
 export * from "./accessors/ReflectVector.js";
 export * from "./accessors/RendererReferenceNode.js";
-export * from "./accessors/SceneNode.js";
+export * from "./accessors/SceneProperties.js";
 export * from "./accessors/SkinningNode.js";
 export * from "./accessors/StorageBufferNode.js";
 export * from "./accessors/StorageTextureNode.js";
@@ -99,7 +99,6 @@ export * from "./display/ColorAdjustment.js";
 export * from "./display/ColorSpaceNode.js";
 export * from "./display/FrontFacingNode.js";
 export * from "./display/NormalMapNode.js";
-export * from "./display/PosterizeNode.js";
 export * from "./display/RenderOutputNode.js";
 export * from "./display/ScreenNode.js";
 export * from "./display/ToneMappingNode.js";
@@ -119,8 +118,6 @@ export * from "./code/CodeNode.js";
 export * from "./code/ExpressionNode.js";
 export * from "./code/FunctionCallNode.js";
 export * from "./code/FunctionNode.js";
-export * from "./code/ScriptableNode.js";
-export * from "./code/ScriptableValueNode.js";
 
 // fog
 export * from "./fog/Fog.js";

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

@@ -1,13 +1,22 @@
-import { TypedArray } from "../../core/BufferAttribute.js";
-import { Struct } from "../core/StructNode.js";
 import StorageBufferNode from "./StorageBufferNode.js";
 
-export const attributeArray: (
-    count: TypedArray | number,
-    type?: string | Struct,
-) => StorageBufferNode;
+interface ArrayFunction {
+    (count: number | Float32Array, type?: "float"): StorageBufferNode<"float">;
+    (count: number | Int32Array, type: "int"): StorageBufferNode<"int">;
+    (count: number | Uint32Array, type: "uint"): StorageBufferNode<"uint">;
+    (count: number | Float32Array, type: "vec2"): StorageBufferNode<"vec2">;
+    (count: number | Int32Array, type: "ivec2"): StorageBufferNode<"ivec2">;
+    (count: number | Uint32Array, type: "uvec2"): StorageBufferNode<"uvec2">;
+    (count: number | Float32Array, type: "vec3"): StorageBufferNode<"vec3">;
+    (count: number | Int32Array, type: "ivec3"): StorageBufferNode<"ivec3">;
+    (count: number | Uint32Array, type: "uvec3"): StorageBufferNode<"uvec3">;
+    (count: number | Float32Array, type: "vec4"): StorageBufferNode<"vec4">;
+    (count: number | Int32Array, type: "ivec4"): StorageBufferNode<"ivec4">;
+    (count: number | Uint32Array, type: "uvec4"): StorageBufferNode<"uvec4">;
+}
 
-export const instancedArray: (
-    count: TypedArray | number,
-    type?: string | Struct,
-) => StorageBufferNode;
+export const attributeArray: ArrayFunction;
+
+export const instancedArray: ArrayFunction;
+
+export {};