@types/three 0.176.0 → 0.178.0

three/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for three (https://threejs.org/).
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/three.
 
 ### Additional Details
- * Last updated: Thu, 24 Apr 2025 08:02:30 GMT
+ * Last updated: Tue, 01 Jul 2025 17:03:03 GMT
  * Dependencies: [@dimforge/rapier3d-compat](https://npmjs.com/package/@dimforge/rapier3d-compat), [@tweenjs/tween.js](https://npmjs.com/package/@tweenjs/tween.js), [@types/stats.js](https://npmjs.com/package/@types/stats.js), [@types/webxr](https://npmjs.com/package/@types/webxr), [@webgpu/types](https://npmjs.com/package/@webgpu/types), [fflate](https://npmjs.com/package/fflate), [meshoptimizer](https://npmjs.com/package/meshoptimizer)
 
 # Credits

three/examples/jsm/Addons.d.ts

@@ -28,7 +28,6 @@ export * from "./effects/AnaglyphEffect.js";
 export * from "./effects/AsciiEffect.js";
 export * from "./effects/OutlineEffect.js";
 export * from "./effects/ParallaxBarrierEffect.js";
-export * from "./effects/PeppersGhostEffect.js";
 export * from "./effects/StereoEffect.js";
 
 export * from "./environments/DebugEnvironment.js";

three/examples/jsm/capabilities/WebGL.d.ts

@@ -3,15 +3,4 @@ export default class WebGL {
     static isColorSpaceAvailable(colorSpace: PredefinedColorSpace): boolean;
     static getWebGL2ErrorMessage(): HTMLElement;
     static getErrorMessage(version: number): HTMLElement;
-
-    /**
-     * @deprecated isWebGLAvailable() has been deprecated and will be removed in r178. Use isWebGL2Available() instead.
-     */
-    static isWebGLAvailable(): boolean;
-
-    /**
-     * @deprecated getWebGLErrorMessage() has been deprecated and will be removed in r178. Use getWebGL2ErrorMessage()
-     * instead.
-     */
-    static getWebGLErrorMessage(): HTMLElement;
 }

three/examples/jsm/controls/TransformControls.d.ts

@@ -1,4 +1,4 @@
-import { Camera, Controls, Mesh, Object3D, Quaternion, Raycaster, Vector3 } from "three";
+import { Camera, ColorRepresentation, Controls, Mesh, Object3D, Quaternion, Raycaster, Vector3 } from "three";
 
 export type TransformControlsMode = "translate" | "rotate" | "scale";
 
@@ -240,6 +240,21 @@ declare class TransformControls extends Controls<TransformControlsEventMap> {
      * @param space The coordinate space in which transformations are applied.
      */
     setSpace(space: "world" | "local"): void;
+
+    /**
+     * Sets the colors of the control's gizmo.
+     *
+     * @param {number|Color|string} xAxis - The x-axis color.
+     * @param {number|Color|string} yAxis - The y-axis color.
+     * @param {number|Color|string} zAxis - The z-axis color.
+     * @param {number|Color|string} active - The color for active elements.
+     */
+    setColors(
+        xAxis: ColorRepresentation,
+        yAxis: ColorRepresentation,
+        zAxis: ColorRepresentation,
+        active: ColorRepresentation,
+    ): void;
 }
 
 declare class TransformControlsRoot extends Object3D {

three/examples/jsm/helpers/TextureHelper.d.ts

@@ -1,6 +1,6 @@
-import { Mesh, Texture } from "three";
+import { BufferGeometry, Mesh, ShaderMaterial, Texture } from "three";
 
-export class TextureHelper extends Mesh {
+export class TextureHelper extends Mesh<BufferGeometry, ShaderMaterial> {
     texture: Texture;
     type: "TextureHelper";
 

three/examples/jsm/helpers/TextureHelperGPU.d.ts

@@ -1,6 +1,6 @@
-import { Mesh, Texture } from "three";
+import { BufferGeometry, Mesh, NodeMaterial, Texture } from "three/webgpu";
 
-export class TextureHelper extends Mesh {
+export class TextureHelper extends Mesh<BufferGeometry, NodeMaterial> {
     texture: Texture;
     type: "TextureHelper";
 

three/examples/jsm/loaders/LDrawLoader.d.ts

@@ -19,11 +19,16 @@ export class LDrawLoader extends Loader<Group> {
     ): this;
 
     preloadMaterials(url: string): Promise<void>;
-    setFileMap(fileMap: Record<string, string>): void;
-    setMaterials(materials: Material[]): void;
 
     parse(text: string, path: string, onLoad: (data: Group) => void, onError?: (error: unknown) => void): void;
 
-    addMaterial(material: Material): void;
+    setMaterials(materials: Material[]): this;
+    clearMaterials(): this;
+    addMaterials(materials: Material[]): this;
+    addDefaultMaterials(): this;
+
+    setFileMap(fileMap: Record<string, string>): this;
+
+    addMaterial(material: Material): this;
     getMaterial(colourCode: string): Material | null;
 }

three/examples/jsm/loaders/SVGLoader.d.ts

@@ -34,7 +34,7 @@ export class SVGLoader extends Loader<SVGResult> {
     ): StrokeStyle;
 
     /**
-     * Generates a stroke with some witdh around the given path.
+     * Generates a stroke with some width around the given path.
      * @remarks The path can be open or closed (last point equals to first point)
      * @param points  Array of Vector2D (the path). Minimum 2 points.
      * @param style  Object with SVG properties as returned by SVGLoader.getStrokeStyle(), or SVGLoader.parse() in the path.userData.style object

three/examples/jsm/math/Octree.d.ts

@@ -10,6 +10,9 @@ export class Octree {
     triangles: Triangle[];
     layers: Layers;
 
+    trianglesPerLeaf: number;
+    maxLevel: number;
+
     constructor(box?: Box3 | null);
 
     addTriangle(triangle: Triangle): this;

three/examples/jsm/physics/RapierPhysics.d.ts

@@ -8,6 +8,7 @@ export interface RapierPhysicsObject {
     world: RAPIER.World;
     addScene: (scene: Object3D) => void;
     addMesh: (mesh: Mesh, mass?: number, restitution?: number) => void;
+    removeMesh: (mesh: Mesh) => void;
     setMeshPosition: (mesh: Mesh, position: Vector, index?: number) => void;
     setMeshVelocity: (mesh: Mesh, velocity: Vector, index?: number) => void;
     addHeightfield: (

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

@@ -1,14 +1,17 @@
-import { IUniform, ShaderMaterial, WebGLRenderTarget } from "three";
+import { IUniform, ShaderMaterial } from "three";
 
-import { FullScreenQuad, Pass } from "./Pass.js";
+import { Pass } from "./Pass.js";
 
-export class AfterimagePass extends Pass {
-    constructor(damp?: number);
-    shader: object;
+declare class AfterimagePass extends Pass {
     uniforms: Record<string, IUniform>;
-    textureComp: WebGLRenderTarget;
-    textureOld: WebGLRenderTarget;
-    shaderMaterial: ShaderMaterial;
-    compFsQuad: FullScreenQuad;
-    copyFsQuad: FullScreenQuad;
+
+    compFsMaterial: ShaderMaterial;
+    copyFsMaterial: ShaderMaterial;
+
+    constructor(damp?: number);
+
+    get damp(): number;
+    set damp(value: number);
 }
+
+export { AfterimagePass };

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

@@ -0,0 +1,7 @@
+import { ShaderPass } from "./ShaderPass.js";
+
+declare class FXAAPass extends ShaderPass {
+    constructor();
+}
+
+export { FXAAPass };

three/examples/jsm/transpiler/AST.d.ts

@@ -1,9 +1,17 @@
+export class Comment {
+    constructor(comment: string);
+
+    comment: string;
+
+    readonly isComment: true;
+}
+
 export class Program {
-    constructor();
+    constructor(body?: Statement[]);
 
     body: Statement[];
 
-    isProgram: true;
+    readonly isProgram: true;
 }
 
 // Boolean seems to be handled as a Unary
@@ -23,11 +31,16 @@ export type Statement =
     | FunctionCall
     | Return
     | Discard
+    | Continue
+    | Break
     | Accessor
     | StaticElement
     | DynamicElement
     | AccessorElements
     | For
+    | While
+    | Switch
+    | SwitchCase
     | null;
 
 export class VariableDeclaration {
@@ -46,7 +59,7 @@ export class VariableDeclaration {
 
     immutable: boolean;
 
-    isVariableDeclaration: true;
+    readonly isVariableDeclaration: true;
 }
 
 export class Uniform {
@@ -55,7 +68,7 @@ export class Uniform {
     type: string;
     name: string;
 
-    isUniform: true;
+    readonly isUniform: true;
 }
 
 export class Varying {
@@ -64,7 +77,7 @@ export class Varying {
     type: string;
     name: string;
 
-    isVarying: true;
+    readonly isVarying: true;
 }
 
 export class FunctionParameter {
@@ -75,18 +88,18 @@ export class FunctionParameter {
     qualifier: string | null;
     immutable: boolean;
 
-    isFunctionParameter: true;
+    readonly isFunctionParameter: true;
 }
 
 export class FunctionDeclaration {
-    constructor(type: string, name: string, params?: FunctionParameter[]);
+    constructor(type: string, name: string, params?: FunctionParameter[], body?: Statement[]);
 
     type: string;
     name: string;
     params: FunctionParameter[];
     body: Statement[];
 
-    isFunctionDeclaration: true;
+    readonly isFunctionDeclaration: true;
 }
 
 export class Expression {
@@ -94,7 +107,7 @@ export class Expression {
 
     expression: string;
 
-    isExpression: true;
+    readonly isExpression: true;
 }
 
 export class Ternary {
@@ -104,7 +117,7 @@ export class Ternary {
     left: Statement;
     right: Statement;
 
-    isTernary: true;
+    readonly isTernary: true;
 }
 
 export class Operator {
@@ -114,7 +127,7 @@ export class Operator {
     left: Statement;
     right: Statement;
 
-    isOperator: true;
+    readonly isOperator: true;
 }
 
 export class Unary {
@@ -124,7 +137,7 @@ export class Unary {
     expression: Statement;
     after: boolean;
 
-    isUnary: true;
+    readonly isUnary: true;
 }
 
 export class Number {
@@ -133,7 +146,7 @@ export class Number {
     type: string;
     value: string;
 
-    isNumber: true;
+    readonly isNumber: true;
 }
 
 export class String {
@@ -141,18 +154,17 @@ export class String {
 
     value: string;
 
-    isString: true;
+    readonly isString: true;
 }
 
 export class Conditional {
-    constructor(cond?: Conditional | null);
+    constructor(cond?: Conditional | null, body?: Statement[]);
 
     cond: Conditional | null;
-
     body: Statement[];
     elseConditional: Conditional | null;
 
-    isConditional: true;
+    readonly isConditional: true;
 }
 
 export class FunctionCall {
@@ -161,7 +173,7 @@ export class FunctionCall {
     name: string;
     params: Statement[];
 
-    isFunctionCall: true;
+    readonly isFunctionCall: true;
 }
 
 export class Return {
@@ -169,13 +181,25 @@ export class Return {
 
     value: Statement;
 
-    isReturn: true;
+    readonly isReturn: true;
 }
 
 export class Discard {
     constructor();
 
-    isDiscard: true;
+    readonly isDiscard: true;
+}
+
+export class Continue {
+    constructor();
+
+    readonly isContinue: true;
+}
+
+export class Break {
+    constructor();
+
+    readonly isBreak: true;
 }
 
 export class Accessor {
@@ -183,7 +207,7 @@ export class Accessor {
 
     property: string;
 
-    isAccessor: true;
+    readonly isAccessor: true;
 }
 
 export class StaticElement {
@@ -191,7 +215,7 @@ export class StaticElement {
 
     value: Statement;
 
-    isStaticElement: true;
+    readonly isStaticElement: true;
 }
 
 export class DynamicElement {
@@ -199,7 +223,7 @@ export class DynamicElement {
 
     value: Statement;
 
-    isDynamicElement: true;
+    readonly isDynamicElement: true;
 }
 
 export class AccessorElements {
@@ -208,17 +232,44 @@ export class AccessorElements {
     object: FunctionCall | Accessor;
     elements: (StaticElement | DynamicElement)[];
 
-    isAccessorElements: true;
+    readonly isAccessorElements: true;
 }
 
 export class For {
-    constructor(initialization: Statement, condition: Statement, afterthought: Statement);
+    constructor(initialization: Statement, condition: Statement, afterthought: Statement, body?: Statement[]);
 
     initialization: Statement;
     condition: Statement;
     afterthought: Statement;
+    body: Statement[];
+
+    readonly isFor: true;
+}
+
+export class While {
+    constructor(condition: Statement, body?: Statement[]);
+
+    condition: Statement;
+    body: Statement[];
+
+    readonly isWhile: true;
+}
+
+export class Switch {
+    constructor(discriminant: Statement, cases: Statement[]);
+
+    discriminant: Statement;
+    cases: Statement[];
+
+    readonly isSwitch: true;
+}
+
+export class SwitchCase {
+    constructor(body: Statement, conditions?: Statement[] | null);
 
     body: Statement[];
+    conditions: Statement[];
 
-    isFor: true;
+    isDefault: boolean;
+    readonly isSwitchCase: true;
 }

three/examples/jsm/transpiler/TSLEncoder.d.ts

@@ -1,14 +1,17 @@
 import {
+    Comment,
     Conditional,
     Expression,
     For,
     FunctionDeclaration,
     Program,
     Statement,
+    Switch,
     Ternary,
     Uniform,
     VariableDeclaration,
     Varying,
+    While,
 } from "./AST.js";
 
 export default class TSLEncoder {
@@ -19,23 +22,26 @@ export default class TSLEncoder {
     global: Set<string>;
     overloadings: Map<string, string>;
     iife: boolean;
-    uniqueNames: boolean;
     reference: boolean;
+    block: Statement | null;
 
     addImport(name: string): void;
     emitUniform(node: Uniform): string;
-    emitExpression(node: Expression): string;
+    emitExpression(node: Expression, output?: string | null): string;
     emitBody(body: Statement[]): string;
     emitTernary(node: Ternary): string;
     emitConditional(node: Conditional): string;
     emitLoop(node: For): string;
+    emitSwitch(switchNode: Switch): string;
     emitFor(node: For): string;
     emitForWhile(node: For): string;
+    emitWhile(node: While): string;
     emitVariables(node: VariableDeclaration, isRoot?: boolean): string;
     emitVarying(node: Varying): string;
     emitOverloadingFunction(nodes: FunctionDeclaration[]): string;
     emitFunction(node: FunctionDeclaration): string;
     setLastStatement(statement: Statement | null): void;
-    emitExtraLine(statement: Statement): string;
+    emitComment(statement: Comment, body: Statement[]): string;
+    emitExtraLine(statement: Statement, body: Statement[]): string;
     emit(ast: Program): string;
 }

three/examples/jsm/tsl/display/AnamorphicNode.d.ts

@@ -1,4 +1,4 @@
-import { NodeRepresentation, ShaderNodeObject } from "three/tsl";
+import { ShaderNodeObject } from "three/tsl";
 import { Node, TempNode, Vector2 } from "three/webgpu";
 
 export default class AnamorphicNode extends TempNode {
@@ -17,7 +17,7 @@ export default class AnamorphicNode extends TempNode {
 
 export const anamorphic: (
     node: Node,
-    threshold?: NodeRepresentation,
-    scale?: NodeRepresentation,
-    samples?: NodeRepresentation,
+    threshold?: Node,
+    scale?: Node,
+    samples?: Node | number,
 ) => ShaderNodeObject<AnamorphicNode>;

three/examples/jsm/tsl/display/BleachBypass.d.ts

@@ -1,4 +1,4 @@
-import { NodeRepresentation, ShaderNodeObject } from "three/tsl";
+import { ShaderNodeObject } from "three/tsl";
 import { Node } from "three/webgpu";
 
-export const bleach: (color: NodeRepresentation, opacity?: number) => ShaderNodeObject<Node>;
+export const bleach: (color: Node, opacity?: number) => ShaderNodeObject<Node>;

three/examples/jsm/tsl/display/BloomNode.d.ts

@@ -1,4 +1,4 @@
-import { NodeRepresentation, ShaderNodeObject } from "three/tsl";
+import { ShaderNodeObject } from "three/tsl";
 import { Node, TempNode, TextureNode, UniformNode } from "three/webgpu";
 
 declare class BloomNode extends TempNode {
@@ -17,7 +17,7 @@ declare class BloomNode extends TempNode {
 }
 
 export const bloom: (
-    node: NodeRepresentation,
+    node: Node,
     strength?: number,
     radius?: number,
     threshold?: number,

three/examples/jsm/tsl/display/ChromaticAberrationNode.d.ts

@@ -0,0 +1,20 @@
+import { ShaderNodeObject } from "three/tsl";
+import { Node, TempNode, Vector2 } from "three/webgpu";
+
+declare class ChromaticAberrationNode extends TempNode {
+    textureNode: Node;
+    strengthNode: Node;
+    centerNode: Node;
+    scaleNode: Node;
+
+    constructor(textureNode: Node, strengthNode: Node, centerNode: Node, scaleNode: Node);
+}
+
+export default ChromaticAberrationNode;
+
+export const chromaticAberration: (
+    node: Node,
+    strength?: Node,
+    center?: Node | Vector2 | null,
+    scale?: Node,
+) => ShaderNodeObject<ChromaticAberrationNode>;

three/examples/jsm/tsl/display/DenoiseNode.d.ts

@@ -1,4 +1,4 @@
-import { NodeRepresentation, ShaderNodeObject } from "three/tsl";
+import { ShaderNodeObject } from "three/tsl";
 import { Camera, Node, TempNode, UniformNode } from "three/webgpu";
 
 declare class DenoiseNode extends TempNode {
@@ -20,8 +20,8 @@ declare class DenoiseNode extends TempNode {
 export default DenoiseNode;
 
 export const denoise: (
-    node: NodeRepresentation,
-    depthNode: NodeRepresentation,
-    normalNode: NodeRepresentation,
+    node: Node,
+    depthNode: Node,
+    normalNode: Node,
     camera: Camera,
 ) => ShaderNodeObject<DenoiseNode>;

three/examples/jsm/tsl/display/DepthOfFieldNode.d.ts

@@ -1,4 +1,4 @@
-import { NodeRepresentation, ShaderNodeObject } from "three/tsl";
+import { ShaderNodeObject } from "three/tsl";
 import { Node, TempNode, TextureNode, UniformNode } from "three/webgpu";
 
 declare class DepthOfFieldNode extends TempNode {
@@ -15,9 +15,9 @@ declare class DepthOfFieldNode extends TempNode {
 export default DepthOfFieldNode;
 
 export const dof: (
-    node: NodeRepresentation,
-    viewZNode: NodeRepresentation,
-    focus?: NodeRepresentation,
-    aperture?: NodeRepresentation,
-    maxblur?: NodeRepresentation,
+    node: Node,
+    viewZNode: Node,
+    focus?: Node,
+    aperture?: Node,
+    maxblur?: Node,
 ) => ShaderNodeObject<DepthOfFieldNode>;

three/examples/jsm/tsl/display/DotScreenNode.d.ts

@@ -1,4 +1,4 @@
-import { NodeRepresentation, ShaderNodeObject } from "three/tsl";
+import { ShaderNodeObject } from "three/tsl";
 import { Node, TempNode, UniformNode, Vector2 } from "three/webgpu";
 
 declare class DotScreenNode extends TempNode {
@@ -13,7 +13,7 @@ declare class DotScreenNode extends TempNode {
 export default DotScreenNode;
 
 export const dotScreen: (
-    node: NodeRepresentation,
+    node: Node,
     center?: Vector2,
     angle?: number,
     scale?: number,

three/examples/jsm/tsl/display/FXAANode.d.ts

@@ -1,5 +1,5 @@
-import { NodeRepresentation, ShaderNodeObject } from "three/tsl";
-import { TempNode, TextureNode } from "three/webgpu";
+import { ShaderNodeObject } from "three/tsl";
+import { Node, TempNode, TextureNode } from "three/webgpu";
 
 declare class FXAANode extends TempNode {
     textureNode: TextureNode;
@@ -9,4 +9,4 @@ declare class FXAANode extends TempNode {
 
 export default FXAANode;
 
-export const fxaa: (node: NodeRepresentation) => ShaderNodeObject<FXAANode>;
+export const fxaa: (node: Node) => ShaderNodeObject<FXAANode>;

three/examples/jsm/tsl/display/FilmNode.d.ts

@@ -1,4 +1,4 @@
-import { NodeRepresentation, ShaderNodeObject } from "three/tsl";
+import { ShaderNodeObject } from "three/tsl";
 import { Node, TempNode } from "three/webgpu";
 
 declare class FilmNode extends TempNode {
@@ -12,7 +12,7 @@ declare class FilmNode extends TempNode {
 export default FilmNode;
 
 export const film: (
-    inputNode: NodeRepresentation,
-    intensityNode?: NodeRepresentation | null,
-    uvNode?: NodeRepresentation | null,
+    inputNode: Node,
+    intensityNode?: Node | null,
+    uvNode?: Node | null,
 ) => ShaderNodeObject<FilmNode>;

three/examples/jsm/tsl/display/GTAONode.d.ts

@@ -1,4 +1,4 @@
-import { NodeRepresentation, ShaderNodeObject } from "three/tsl";
+import { ShaderNodeObject } from "three/tsl";
 import { Camera, Node, TempNode, TextureNode, UniformNode, Vector2 } from "three/webgpu";
 
 declare class GTAONode extends TempNode {
@@ -25,7 +25,7 @@ declare class GTAONode extends TempNode {
 export default GTAONode;
 
 export const ao: (
-    depthNode: NodeRepresentation,
-    normalNode: NodeRepresentation,
+    depthNode: Node,
+    normalNode: Node,
     camera: Camera,
 ) => ShaderNodeObject<GTAONode>;

three/examples/jsm/tsl/display/GaussianBlurNode.d.ts

@@ -1,4 +1,4 @@
-import { NodeRepresentation, ShaderNodeObject } from "three/tsl";
+import { ShaderNodeObject } from "three/tsl";
 import { Node, TempNode, TextureNode, Vector2 } from "three/webgpu";
 
 declare class GaussianBlurNode extends TempNode {
@@ -24,12 +24,12 @@ declare class GaussianBlurNode extends TempNode {
 export default GaussianBlurNode;
 
 export const gaussianBlur: (
-    node: NodeRepresentation,
-    directionNode?: NodeRepresentation | null,
+    node: Node,
+    directionNode?: Node | number | null,
     sigma?: number,
 ) => ShaderNodeObject<GaussianBlurNode>;
 export const premultipliedGaussianBlur: (
-    node: NodeRepresentation,
-    directionNode?: NodeRepresentation | null,
+    node: Node,
+    directionNode?: Node | number | null,
     sigma?: number,
 ) => ShaderNodeObject<GaussianBlurNode>;