@types/three 0.159.0 → 0.161.0

three/src/core/Object3D.d.ts

@@ -42,7 +42,7 @@ export class Object3D<TEventMap extends Object3DEventMap = Object3DEventMap> ext
     /**
      * Unique number for this {@link Object3D} instance.
      * @remarks Note that ids are assigned in chronological order: 1, 2, 3, ..., incrementing by one for each new object.
-     * @remarks Expects a `Integer`
+     * Expects a `Integer`
      */
     readonly id: number;
 
@@ -62,7 +62,7 @@ export class Object3D<TEventMap extends Object3DEventMap = Object3DEventMap> ext
     /**
      * A Read-only _string_ to check `this` object type.
      * @remarks This can be used to find a specific type of Object3D in a scene.
-     * @remarks Sub-classes will update this value.
+     * Sub-classes will update this value.
      * @defaultValue `Object3D`
      */
     readonly type: string | 'Object3D';
@@ -158,7 +158,7 @@ export class Object3D<TEventMap extends Object3DEventMap = Object3DEventMap> ext
     /**
      * The layer membership of the object.
      * @remarks The object is only visible if it has at least one layer in common with the {@link THREE.Object3DCamera | Camera} in use.
-     * @remarks This property can also be used to filter out unwanted objects in ray-intersection tests when using {@link THREE.Raycaster | Raycaster}.
+     * This property can also be used to filter out unwanted objects in ray-intersection tests when using {@link THREE.Raycaster | Raycaster}.
      * @defaultValue `new THREE.Layers()`
      */
     layers: Layers;
@@ -192,7 +192,7 @@ export class Object3D<TEventMap extends Object3DEventMap = Object3DEventMap> ext
      * This value allows the default rendering order of {@link https://en.wikipedia.org/wiki/Scene_graph | scene graph}
      * objects to be overridden although opaque and transparent objects remain sorted independently.
      * @remarks When this property is set for an instance of {@link Group | Group}, all descendants objects will be sorted and rendered together.
-     * @remarks Sorting is from lowest to highest renderOrder.
+     * Sorting is from lowest to highest renderOrder.
      * @defaultValue `0`
      */
     renderOrder: number;
@@ -213,7 +213,7 @@ export class Object3D<TEventMap extends Object3DEventMap = Object3DEventMap> ext
     /**
      * Custom depth material to be used when rendering to the depth map.
      * @remarks Can only be used in context of meshes.
-     * @remarks When shadow-casting with a {@link THREE.DirectionalLight | DirectionalLight} or {@link THREE.SpotLight | SpotLight},
+     * When shadow-casting with a {@link THREE.DirectionalLight | DirectionalLight} or {@link THREE.SpotLight | SpotLight},
      * if you are modifying vertex positions in the vertex shader you must specify a customDepthMaterial for proper shadows.
      * @defaultValue `undefined`
      */
@@ -229,7 +229,7 @@ export class Object3D<TEventMap extends Object3DEventMap = Object3DEventMap> ext
      * An optional callback that is executed immediately before a 3D object is rendered to a shadow map.
      * @remarks This function is called with the following parameters: renderer, scene, camera, shadowCamera, geometry,
      * depthMaterial, group.
-     * @remarks Please notice that this callback is only executed for `renderable` 3D objects. Meaning 3D objects which
+     * Please notice that this callback is only executed for `renderable` 3D objects. Meaning 3D objects which
      * define their visual appearance with geometries and materials like instances of {@link Mesh}, {@link Line},
      * {@link Points} or {@link Sprite}. Instances of {@link Object3D}, {@link Group} or {@link Bone} are not renderable
      * and thus this callback is not executed for such objects.
@@ -247,7 +247,7 @@ export class Object3D<TEventMap extends Object3DEventMap = Object3DEventMap> ext
      * An optional callback that is executed immediately after a 3D object is rendered to a shadow map.
      * @remarks This function is called with the following parameters: renderer, scene, camera, shadowCamera, geometry,
      * depthMaterial, group.
-     * @remarks Please notice that this callback is only executed for `renderable` 3D objects. Meaning 3D objects which
+     * Please notice that this callback is only executed for `renderable` 3D objects. Meaning 3D objects which
      * define their visual appearance with geometries and materials like instances of {@link Mesh}, {@link Line},
      * {@link Points} or {@link Sprite}. Instances of {@link Object3D}, {@link Group} or {@link Bone} are not renderable
      * and thus this callback is not executed for such objects.
@@ -264,7 +264,7 @@ export class Object3D<TEventMap extends Object3DEventMap = Object3DEventMap> ext
     /**
      * An optional callback that is executed immediately before a 3D object is rendered.
      * @remarks This function is called with the following parameters: renderer, scene, camera, geometry, material, group.
-     * @remarks Please notice that this callback is only executed for `renderable` 3D objects. Meaning 3D objects which
+     * Please notice that this callback is only executed for `renderable` 3D objects. Meaning 3D objects which
      * define their visual appearance with geometries and materials like instances of {@link Mesh}, {@link Line},
      * {@link Points} or {@link Sprite}. Instances of {@link Object3D}, {@link Group} or {@link Bone} are not renderable
      * and thus this callback is not executed for such objects.
@@ -281,7 +281,7 @@ export class Object3D<TEventMap extends Object3DEventMap = Object3DEventMap> ext
     /**
      * An optional callback that is executed immediately after a 3D object is rendered.
      * @remarks This function is called with the following parameters: renderer, scene, camera, geometry, material, group.
-     * @remarks Please notice that this callback is only executed for `renderable` 3D objects. Meaning 3D objects which
+     * Please notice that this callback is only executed for `renderable` 3D objects. Meaning 3D objects which
      * define their visual appearance with geometries and materials like instances of {@link Mesh}, {@link Line},
      * {@link Points} or {@link Sprite}. Instances of {@link Object3D}, {@link Group} or {@link Bone} are not renderable
      * and thus this callback is not executed for such objects.
@@ -363,7 +363,7 @@ export class Object3D<TEventMap extends Object3DEventMap = Object3DEventMap> ext
     /**
      * Rotate an object along an axis in world space.
      * @remarks The axis is assumed to be normalized
-     * @remarks Method Assumes no rotated parent.
+     * Method Assumes no rotated parent.
      * @param axis A normalized vector in world space.
      * @param angle The angle in radians. Expects a `Float`
      */
@@ -443,7 +443,7 @@ export class Object3D<TEventMap extends Object3DEventMap = Object3DEventMap> ext
     /**
      * Adds another {@link Object3D} as child of this {@link Object3D}.
      * @remarks An arbitrary number of objects may be added
-     * @remarks Any current parent on an {@link object} passed in here will be removed, since an {@link Object3D} can have at most one parent.
+     * Any current parent on an {@link object} passed in here will be removed, since an {@link Object3D} can have at most one parent.
      * @see {@link attach}
      * @see {@link THREE.Group | Group} for info on manually grouping objects.
      * @param object
@@ -487,7 +487,7 @@ export class Object3D<TEventMap extends Object3DEventMap = Object3DEventMap> ext
     /**
      * Searches through an object and its children, starting with the object itself, and returns the first with a matching name.
      * @remarks Note that for most objects the name is an empty string by default
-     * @remarks You will have to set it manually to make use of this method.
+     * You will have to set it manually to make use of this method.
      * @param name String to match to the children's Object3D.name property.
      */
     getObjectByName(name: string): Object3D | undefined;
@@ -555,7 +555,7 @@ export class Object3D<TEventMap extends Object3DEventMap = Object3DEventMap> ext
     /**
      * Like traverse, but the callback will only be executed for visible objects
      * @remarks Descendants of invisible objects are not traversed.
-     * @remarks Note: Modifying the scene graph inside the callback is discouraged.
+     * Note: Modifying the scene graph inside the callback is discouraged.
      * @param callback A function with as first argument an {@link Object3D} object.
      */
     traverseVisible(callback: (object: Object3D) => any): void;

three/src/core/UniformsGroup.d.ts

@@ -15,11 +15,11 @@ export class UniformsGroup extends EventDispatcher<{ dispose: {} }> {
 
     usage: Usage;
 
-    uniforms: Uniform[];
+    uniforms: Array<Uniform | Uniform[]>;
 
-    add(uniform: Uniform): this;
+    add(uniform: Uniform | Uniform[]): this;
 
-    remove(uniform: Uniform): this;
+    remove(uniform: Uniform | Uniform[]): this;
 
     setName(name: string): this;
 

three/src/extras/core/Curve.d.ts

@@ -1,4 +1,4 @@
-import { Vector } from '../../math/Vector2.js';
+import { Vector2 } from '../../math/Vector2.js';
 import { Vector3 } from '../../math/Vector3.js';
 
 /**
@@ -25,7 +25,7 @@ import { Vector3 } from '../../math/Vector3.js';
  * @see {@link https://threejs.org/docs/index.html#api/en/extras/core/Curve | Official Documentation}
  * @see {@link https://github.com/mrdoob/three.js/blob/master/src/extras/core/Curve.js | Source}
  */
-export abstract class Curve<T extends Vector> {
+export abstract class Curve<TVector extends Vector2 | Vector3> {
     protected constructor();
 
     /**
@@ -49,26 +49,26 @@ export abstract class Curve<T extends Vector> {
      * @param t A position on the curve. Must be in the range `[ 0, 1 ]`. Expects a `Float`
      * @param optionalTarget If specified, the result will be copied into this Vector, otherwise a new Vector will be created. Default `new T`.
      */
-    getPoint(t: number, optionalTarget?: T): T;
+    getPoint(t: number, optionalTarget?: TVector): TVector;
 
     /**
      * Returns a vector for a given position on the {@link Curve} according to the arc length.
      * @param u A position on the {@link Curve} according to the arc length. Must be in the range `[ 0, 1 ]`. Expects a `Float`
      * @param optionalTarget If specified, the result will be copied into this Vector, otherwise a new Vector will be created. Default `new T`.
      */
-    getPointAt(u: number, optionalTarget?: T): T;
+    getPointAt(u: number, optionalTarget?: TVector): TVector;
 
     /**
      * Returns a set of divisions `+1` points using {@link .getPoint | getPoint(t)}.
      * @param divisions Number of pieces to divide the {@link Curve} into. Expects a `Integer`. Default `5`
      */
-    getPoints(divisions?: number): T[];
+    getPoints(divisions?: number): TVector[];
 
     /**
      * Returns a set of divisions `+1` equi-spaced points using {@link .getPointAt | getPointAt(u)}.
      * @param divisions Number of pieces to divide the {@link Curve} into. Expects a `Integer`. Default `5`
      */
-    getSpacedPoints(divisions?: number): T[];
+    getSpacedPoints(divisions?: number): TVector[];
 
     /**
      * Get total {@link Curve} arc length.
@@ -107,14 +107,14 @@ export abstract class Curve<T extends Vector> {
      * @param t A position on the curve. Must be in the range `[ 0, 1 ]`. Expects a `Float`
      * @param optionalTarget If specified, the result will be copied into this Vector, otherwise a new Vector will be created.
      */
-    getTangent(t: number, optionalTarget?: T): T;
+    getTangent(t: number, optionalTarget?: TVector): TVector;
 
     /**
      * Returns tangent at a point which is equidistant to the ends of the {@link Curve} from the point given in {@link .getTangent}.
      * @param u A position on the {@link Curve} according to the arc length. Must be in the range `[ 0, 1 ]`. Expects a `Float`
      * @param optionalTarget If specified, the result will be copied into this Vector, otherwise a new Vector will be created.
      */
-    getTangentAt(u: number, optionalTarget?: T): T;
+    getTangentAt(u: number, optionalTarget?: TVector): TVector;
 
     /**
      * Generates the Frenet Frames
@@ -141,7 +141,7 @@ export abstract class Curve<T extends Vector> {
      * Copies another {@link Curve} object to this instance.
      * @param source
      */
-    copy(source: Curve<T>): this;
+    copy(source: Curve<TVector>): this;
 
     /**
      * Returns a JSON object representation of this instance.

three/src/extras/core/CurvePath.d.ts

@@ -1,5 +1,6 @@
 import { Curve } from './Curve.js';
-import { Vector } from '../../math/Vector2.js';
+import { Vector2 } from '../../math/Vector2.js';
+import { Vector3 } from '../../math/Vector3.js';
 
 /**
  * Curved Path - a curve path is simply a array of connected curves, but retains the api of a curve.
@@ -8,7 +9,7 @@ import { Vector } from '../../math/Vector2.js';
  * @see {@link https://threejs.org/docs/index.html#api/en/extras/core/CurvePath | Official Documentation}
  * @see {@link https://github.com/mrdoob/three.js/blob/master/src/extras/core/CurvePath.js | Source}
  */
-export class CurvePath<T extends Vector> extends Curve<T> {
+export class CurvePath<TVector extends Vector2 | Vector3> extends Curve<TVector> {
     /**
      * The constructor take no parameters.
      */
@@ -25,7 +26,7 @@ export class CurvePath<T extends Vector> extends Curve<T> {
      * The array of {@link Curve | Curves}.
      * @defaultValue `[]`
      */
-    curves: Array<Curve<T>>;
+    curves: Array<Curve<TVector>>;
 
     /**
      * Whether or not to automatically close the path.
@@ -37,13 +38,13 @@ export class CurvePath<T extends Vector> extends Curve<T> {
      * Add a curve to the {@link .curves} array.
      * @param curve
      */
-    add(curve: Curve<T>): void;
+    add(curve: Curve<TVector>): void;
     /**
      * Adds a {@link LineCurve | lineCurve} to close the path.
      */
     closePath(): this;
 
-    getPoint(t: number, optionalTarget?: T): T;
+    getPoint(t: number, optionalTarget?: TVector): TVector;
 
     /**
      * Get list of cumulative curve lengths of the curves in the {@link .curves} array.
@@ -58,11 +59,11 @@ export class CurvePath<T extends Vector> extends Curve<T> {
      * For example, for a {@link THREE.LineCurve | LineCurve}, the returned number of points is always just 2.
      * @param divisions Number of pieces to divide the curve into. Expects a `Integer`. Default `12`
      */
-    override getPoints(divisions?: number): T[];
+    override getPoints(divisions?: number): TVector[];
 
     /**
      * Returns a set of divisions `+1` equi-spaced points using {@link .getPointAt | getPointAt(u)}.
      * @param divisions Number of pieces to divide the curve into. Expects a `Integer`. Default `40`
      */
-    override getSpacedPoints(divisions?: number): T[];
+    override getSpacedPoints(divisions?: number): TVector[];
 }

three/src/geometries/RingGeometry.d.ts

@@ -21,7 +21,7 @@ export class RingGeometry extends BufferGeometry {
      * @param innerRadius Expects a `Float`. Default `0.5`.
      * @param outerRadius Expects a `Float`. Default `1`.
      * @param thetaSegments Number of segments. A higher number means the ring will be more round. Minimum is 3. Expects a `Integer`. Default `32`.
-     * @param phiSegments Minimum is 1. Expects a `Integer`. Default `1`.
+     * @param phiSegments Number of segments per ring segment. Minimum is `1`. Expects a `Integer`. Default `1`.
      * @param thetaStart Starting angle. Expects a `Float`. Default `0`.
      * @param thetaLength Central angle. Expects a `Float`. Default `Math.PI * 2`.
      */

three/src/lights/PointLight.d.ts

@@ -29,6 +29,13 @@ export class PointLight extends Light<PointLightShadow> {
      */
     constructor(color?: ColorRepresentation, intensity?: number, distance?: number, decay?: number);
 
+    /**
+     * Read-only flag to check if a given object is of type {@link PointLight}.
+     * @remarks This is a _constant_ value
+     * @defaultValue `true`
+     */
+    readonly isPointLight: true;
+
     /**
      * @default 'PointLight'
      */

three/src/loaders/MaterialLoader.d.ts

@@ -4,13 +4,16 @@ import { Texture } from '../textures/Texture.js';
 import { Material } from '../materials/Material.js';
 
 export class MaterialLoader extends Loader<Material> {
-    constructor(manager?: LoadingManager);
-
     /**
      * @default {}
      */
     textures: { [key: string]: Texture };
 
-    setTextures(textures: { [key: string]: Texture }): this;
+    constructor(manager?: LoadingManager);
+
     parse(json: unknown): Material;
+
+    setTextures(textures: { [key: string]: Texture }): this;
+
+    static createMaterialFromType(type: string): Material;
 }

three/src/materials/LineBasicMaterial.d.ts

@@ -13,6 +13,13 @@ export interface LineBasicMaterialParameters extends MaterialParameters {
 export class LineBasicMaterial extends Material {
     constructor(parameters?: LineBasicMaterialParameters);
 
+    /**
+     * Read-only flag to check if a given object is of type {@link LineBasicMaterial}.
+     * @remarks This is a _constant_ value
+     * @defaultValue `true`
+     */
+    readonly isLineBasicMaterial: true;
+
     /**
      * @default 'LineBasicMaterial'
      */

three/src/materials/LineDashedMaterial.d.ts

@@ -9,6 +9,13 @@ export interface LineDashedMaterialParameters extends LineBasicMaterialParameter
 export class LineDashedMaterial extends LineBasicMaterial {
     constructor(parameters?: LineDashedMaterialParameters);
 
+    /**
+     * Read-only flag to check if a given object is of type {@link LineDashedMaterial}.
+     * @remarks This is a _constant_ value
+     * @defaultValue `true`
+     */
+    readonly isLineDashedMaterial: true;
+
     /**
      * @default 'LineDashedMaterial'
      */
@@ -28,7 +35,6 @@ export class LineDashedMaterial extends LineBasicMaterial {
      * @default 1
      */
     gapSize: number;
-    readonly isLineDashedMaterial: true;
 
     setValues(parameters: LineDashedMaterialParameters): void;
 }

three/src/materials/Material.d.ts

@@ -1,7 +1,7 @@
 import { Plane } from '../math/Plane.js';
 import { EventDispatcher } from '../core/EventDispatcher.js';
+import { WebGLProgramParametersWithUniforms } from '../renderers/webgl/WebGLPrograms.js';
 import { WebGLRenderer } from '../renderers/WebGLRenderer.js';
-import { Shader } from '../renderers/shaders/ShaderLib.js';
 import {
     BlendingDstFactor,
     BlendingEquation,
@@ -69,6 +69,13 @@ export interface MaterialParameters {
 export class Material extends EventDispatcher<{ dispose: {} }> {
     constructor();
 
+    /**
+     * Read-only flag to check if a given object is of type {@link Material}.
+     * @remarks This is a _constant_ value
+     * @defaultValue `true`
+     */
+    readonly isMaterial: true;
+
     /**
      * Enables alpha hashed transparency, an alternative to {@link .transparent} or {@link .alphaTest}. The material
      * will not be rendered if opacity is lower than a random threshold. Randomization introduces some grain or noise,
@@ -84,7 +91,9 @@ export class Material extends EventDispatcher<{ dispose: {} }> {
     alphaTest: number;
 
     /**
-     * Enables alpha to coverage. Can only be used with MSAA-enabled rendering contexts.
+     * Enables alpha to coverage. Can only be used with MSAA-enabled rendering contexts (meaning when the renderer was
+     * created with *antialias* parameter set to `true`). Enabling this will smooth aliasing on clip plane edges and
+     * alphaTest-clipped edges.
      * @default false
      */
     alphaToCoverage: boolean;
@@ -256,12 +265,6 @@ export class Material extends EventDispatcher<{ dispose: {} }> {
      */
     stencilZPass: StencilOp;
 
-    /**
-     * Used to check whether this or derived classes are materials. Default is true.
-     * You should not change this, as it used internally for optimisation.
-     */
-    readonly isMaterial: true;
-
     /**
      * Material name. Default is an empty string.
      * @default ''
@@ -338,8 +341,8 @@ export class Material extends EventDispatcher<{ dispose: {} }> {
     shadowSide: Side | null;
 
     /**
-     * Defines whether this material is tone mapped according to the renderer's toneMapping setting.
-     * Default is true.
+     * Defines whether this material is tone mapped according to the renderer's
+     * {@link WebGLRenderer.toneMapping toneMapping} setting. It is ignored when rendering to a render target.
      * @default true
      */
     toneMapped: boolean;
@@ -347,7 +350,6 @@ export class Material extends EventDispatcher<{ dispose: {} }> {
     /**
      * Defines whether this material is transparent. This has an effect on rendering as transparent objects need special treatment and are rendered after non-transparent objects.
      * When set to true, the extent to which the material is transparent is controlled by setting it's .opacity property.
-     * Default is false.
      * @default false
      */
     transparent: boolean;
@@ -405,12 +407,12 @@ export class Material extends EventDispatcher<{ dispose: {} }> {
 
     /**
      * An optional callback that is executed immediately before the shader program is compiled.
-     * This function is called with the shader source code as a parameter.
+     * This function is called with the associated WebGL program parameters and renderer.
      * Useful for the modification of built-in materials.
-     * @param shader Source code of the shader
-     * @param renderer WebGLRenderer Context that is initializing the material
+     * @param parameters WebGL program parameters
+     * @param renderer WebGLRenderer context that is initializing the material
      */
-    onBeforeCompile(shader: Shader, renderer: WebGLRenderer): void;
+    onBeforeCompile(parameters: WebGLProgramParametersWithUniforms, renderer: WebGLRenderer): void;
 
     /**
      * In case onBeforeCompile is used, this callback can be used to identify values of settings used in onBeforeCompile, so three.js can reuse a cached shader or recompile the shader as needed.

three/src/materials/MeshBasicMaterial.d.ts

@@ -29,6 +29,13 @@ export interface MeshBasicMaterialParameters extends MaterialParameters {
 export class MeshBasicMaterial extends Material {
     constructor(parameters?: MeshBasicMaterialParameters);
 
+    /**
+     * Read-only flag to check if a given object is of type {@link MeshBasicMaterial}.
+     * @remarks This is a _constant_ value
+     * @defaultValue `true`
+     */
+    readonly isMeshBasicMaterial: true;
+
     /**
      * @default 'MeshBasicMaterial'
      */

three/src/materials/MeshDepthMaterial.d.ts

@@ -15,6 +15,12 @@ export interface MeshDepthMaterialParameters extends MaterialParameters {
 
 export class MeshDepthMaterial extends Material {
     constructor(parameters?: MeshDepthMaterialParameters);
+    /**
+     * Read-only flag to check if a given object is of type {@link MeshDepthMaterial}.
+     * @remarks This is a _constant_ value
+     * @defaultValue `true`
+     */
+    readonly isMeshDepthMaterial: true;
 
     /**
      * @default 'MeshDepthMaterial'

three/src/materials/MeshDistanceMaterial.d.ts

@@ -16,6 +16,13 @@ export interface MeshDistanceMaterialParameters extends MaterialParameters {
 export class MeshDistanceMaterial extends Material {
     constructor(parameters?: MeshDistanceMaterialParameters);
 
+    /**
+     * Read-only flag to check if a given object is of type {@link MeshDistanceMaterial}.
+     * @remarks This is a _constant_ value
+     * @defaultValue `true`
+     */
+    readonly isMeshDistanceMaterial: true;
+
     /**
      * @default 'MeshDistanceMaterial'
      */

three/src/materials/MeshLambertMaterial.d.ts

@@ -38,6 +38,13 @@ export interface MeshLambertMaterialParameters extends MaterialParameters {
 export class MeshLambertMaterial extends Material {
     constructor(parameters?: MeshLambertMaterialParameters);
 
+    /**
+     * Read-only flag to check if a given object is of type {@link MeshLambertMaterial}.
+     * @remarks This is a _constant_ value
+     * @defaultValue `true`
+     */
+    readonly isMeshLambertMaterial: true;
+
     /**
      * @default 'MeshLambertMaterial'
      */

three/src/materials/MeshMatcapMaterial.d.ts

@@ -24,6 +24,13 @@ export interface MeshMatcapMaterialParameters extends MaterialParameters {
 export class MeshMatcapMaterial extends Material {
     constructor(parameters?: MeshMatcapMaterialParameters);
 
+    /**
+     * Read-only flag to check if a given object is of type {@link MeshMatcapMaterial}.
+     * @remarks This is a _constant_ value
+     * @defaultValue `true`
+     */
+    readonly isMeshMatcapMaterial: true;
+
     /**
      * @default 'MeshMatcapMaterial'
      */

three/src/materials/MeshNormalMaterial.d.ts

@@ -21,6 +21,13 @@ export interface MeshNormalMaterialParameters extends MaterialParameters {
 export class MeshNormalMaterial extends Material {
     constructor(parameters?: MeshNormalMaterialParameters);
 
+    /**
+     * Read-only flag to check if a given object is of type {@link MeshNormalMaterial}.
+     * @remarks This is a _constant_ value
+     * @defaultValue `true`
+     */
+    readonly isMeshNormalMaterial: true;
+
     /**
      * @default 'MeshNormalMaterial'
      */

three/src/materials/MeshPhongMaterial.d.ts

@@ -43,6 +43,13 @@ export interface MeshPhongMaterialParameters extends MaterialParameters {
 export class MeshPhongMaterial extends Material {
     constructor(parameters?: MeshPhongMaterialParameters);
 
+    /**
+     * Read-only flag to check if a given object is of type {@link MeshPhongMaterial}.
+     * @remarks This is a _constant_ value
+     * @defaultValue `true`
+     */
+    readonly isMeshPhongMaterial: true;
+
     /**
      * @default 'MeshNormalMaterial'
      */

three/src/materials/MeshPhysicalMaterial.d.ts

@@ -48,7 +48,12 @@ export interface MeshPhysicalMaterialParameters extends MeshStandardMaterialPara
 export class MeshPhysicalMaterial extends MeshStandardMaterial {
     constructor(parameters?: MeshPhysicalMaterialParameters);
 
-    isMeshPhysicalMaterial: boolean;
+    /**
+     * Read-only flag to check if a given object is of type {@link MeshPhysicalMaterial}.
+     * @remarks This is a _constant_ value
+     * @defaultValue `true`
+     */
+    readonly isMeshPhysicalMaterial: true;
 
     /**
      * @default 'MeshPhysicalMaterial'

three/src/materials/MeshStandardMaterial.d.ts

@@ -38,6 +38,13 @@ export interface MeshStandardMaterialParameters extends MaterialParameters {
 export class MeshStandardMaterial extends Material {
     constructor(parameters?: MeshStandardMaterialParameters);
 
+    /**
+     * Read-only flag to check if a given object is of type {@link MeshStandardMaterial}.
+     * @remarks This is a _constant_ value
+     * @defaultValue `true`
+     */
+    readonly isMeshStandardMaterial: true;
+
     /**
      * @default 'MeshStandardMaterial'
      */
@@ -200,7 +207,5 @@ export class MeshStandardMaterial extends Material {
      */
     fog: boolean;
 
-    isMeshStandardMaterial: boolean;
-
     setValues(parameters: MeshStandardMaterialParameters): void;
 }

three/src/materials/MeshToonMaterial.d.ts

@@ -36,6 +36,13 @@ export interface MeshToonMaterialParameters extends MaterialParameters {
 export class MeshToonMaterial extends Material {
     constructor(parameters?: MeshToonMaterialParameters);
 
+    /**
+     * Read-only flag to check if a given object is of type {@link MeshToonMaterial}.
+     * @remarks This is a _constant_ value
+     * @defaultValue `true`
+     */
+    readonly isMeshToonMaterial: true;
+
     /**
      * @default 'MeshToonMaterial'
      */

three/src/materials/PointsMaterial.d.ts

@@ -14,6 +14,13 @@ export interface PointsMaterialParameters extends MaterialParameters {
 export class PointsMaterial extends Material {
     constructor(parameters?: PointsMaterialParameters);
 
+    /**
+     * Read-only flag to check if a given object is of type {@link PointsMaterial}.
+     * @remarks This is a _constant_ value
+     * @defaultValue `true`
+     */
+    readonly isPointsMaterial: true;
+
     /**
      * @default 'PointsMaterial'
      */

three/src/materials/RawShaderMaterial.d.ts

@@ -2,4 +2,13 @@ import { ShaderMaterialParameters, ShaderMaterial } from './ShaderMaterial.js';
 
 export class RawShaderMaterial extends ShaderMaterial {
     constructor(parameters?: ShaderMaterialParameters);
+
+    /**
+     * Read-only flag to check if a given object is of type {@link RawShaderMaterial}.
+     * @remarks This is a _constant_ value
+     * @defaultValue `true`
+     */
+    readonly isRawShaderMaterial: true;
+
+    override readonly type: 'RawShaderMaterial';
 }

three/src/materials/ShaderMaterial.d.ts

@@ -28,6 +28,13 @@ export interface ShaderMaterialParameters extends MaterialParameters {
 export class ShaderMaterial extends Material {
     constructor(parameters?: ShaderMaterialParameters);
 
+    /**
+     * Read-only flag to check if a given object is of type {@link ShaderMaterial}.
+     * @remarks This is a _constant_ value
+     * @defaultValue `true`
+     */
+    readonly isShaderMaterial: true;
+
     /**
      * @default 'ShaderMaterial'
      */
@@ -85,13 +92,22 @@ export class ShaderMaterial extends Material {
     derivatives: any;
 
     /**
-     * @default { derivatives: false, fragDepth: false, drawBuffers: false, shaderTextureLOD: false }
+     * @default {
+     *   derivatives: false,
+     *   fragDepth: false,
+     *   drawBuffers: false,
+     *   shaderTextureLOD: false,
+     *   clipCullDistance: false,
+     *   multiDraw: false
+     * }
      */
     extensions: {
         derivatives: boolean;
         fragDepth: boolean;
         drawBuffers: boolean;
         shaderTextureLOD: boolean;
+        clipCullDistance: boolean;
+        multiDraw: boolean;
     };
 
     /**
@@ -114,8 +130,6 @@ export class ShaderMaterial extends Material {
      */
     glslVersion: GLSLVersion | null;
 
-    isShaderMaterial: boolean;
-
     setValues(parameters: ShaderMaterialParameters): void;
     toJSON(meta: any): any;
 }