@types/three 0.177.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: Mon, 02 Jun 2025 15:36:26 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/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/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/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/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>;

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

@@ -1,12 +1,12 @@
-import { NodeRepresentation, ShaderNodeObject } from "three/tsl";
-import { TempNode, TextureNode, UniformNode, Vector3 } from "three/webgpu";
+import { ShaderNodeObject } from "three/tsl";
+import { Node, TempNode, TextureNode, UniformNode, Vector3 } from "three/webgpu";
 
 interface LensflareNodeParams {
-    ghostTint?: NodeRepresentation | undefined;
-    threshold?: NodeRepresentation | undefined;
-    ghostSamples?: NodeRepresentation | undefined;
-    ghostSpacing?: NodeRepresentation | undefined;
-    ghostAttenuationFactor?: NodeRepresentation | undefined;
+    ghostTint?: Node | undefined;
+    threshold?: Node | undefined;
+    ghostSamples?: Node | undefined;
+    ghostSpacing?: Node | undefined;
+    ghostAttenuationFactor?: Node | undefined;
     downSampleRatio?: number | undefined;
 }
 
@@ -30,6 +30,6 @@ declare class LensflareNode extends TempNode {
 export default LensflareNode;
 
 export const lensflare: (
-    inputNode: NodeRepresentation,
+    inputNode: Node,
     params?: LensflareNodeParams,
 ) => ShaderNodeObject<LensflareNode>;

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

@@ -1,4 +1,4 @@
-import { NodeRepresentation, ShaderNodeObject } from "three/tsl";
+import { ShaderNodeObject } from "three/tsl";
 import { Data3DTexture, Node, TempNode, Texture3DNode, UniformNode } from "three/webgpu";
 
 declare class Lut3DNode extends TempNode {
@@ -13,8 +13,8 @@ declare class Lut3DNode extends TempNode {
 export default Lut3DNode;
 
 export const lut3D: (
-    node: NodeRepresentation,
-    lut: NodeRepresentation,
+    node: Node,
+    lut: Node,
     size: number,
-    intensity: NodeRepresentation,
+    intensity: Node,
 ) => ShaderNodeObject<Lut3DNode>;

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

@@ -1,8 +1,8 @@
-import { NodeRepresentation, ShaderNodeObject } from "three/tsl";
+import { ShaderNodeObject } from "three/tsl";
 import { Node } from "three/webgpu";
 
 export const motionBlur: (
-    inputNode: NodeRepresentation,
-    velocity: NodeRepresentation,
-    numSamples?: NodeRepresentation,
+    inputNode: Node,
+    velocity: Node,
+    numSamples?: Node,
 ) => ShaderNodeObject<Node>;

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

@@ -1,10 +1,10 @@
-import { NodeRepresentation, ShaderNodeObject } from "three/tsl";
+import { ShaderNodeObject } from "three/tsl";
 import { Camera, Node, Object3D, Scene, TempNode, TextureNode, UniformNode } from "three/webgpu";
 
 export interface OutlineNodeParams {
     selectedObjects?: Object3D[] | undefined;
-    edgeThickness?: NodeRepresentation | undefined;
-    edgeGlow?: NodeRepresentation | undefined;
+    edgeThickness?: Node | undefined;
+    edgeGlow?: Node | undefined;
     downSampleRatio?: number | undefined;
 }