@types/three 0.156.0 → 0.157.0

three/src/animation/AnimationUtils.d.ts

@@ -1,6 +1,5 @@
 import { AnimationClip } from './AnimationClip.js';
 
-export function arraySlice(array: any, from: number, to: number): any;
 export function convertArray(array: any, type: any, forceClone: boolean): any;
 export function isTypedArray(object: any): boolean;
 export function getKeyframeOrder(times: number[]): number[];

three/src/cameras/CubeCamera.d.ts

@@ -1,7 +1,7 @@
-import { WebGLCubeRenderTarget } from './../renderers/WebGLCubeRenderTarget.js';
-import { Scene } from './../scenes/Scene.js';
-import { WebGLRenderer } from './../renderers/WebGLRenderer.js';
-import { Object3D } from './../core/Object3D.js';
+import { WebGLCubeRenderTarget } from '../renderers/WebGLCubeRenderTarget.js';
+import { Scene } from '../scenes/Scene.js';
+import { WebGLRenderer } from '../renderers/WebGLRenderer.js';
+import { Object3D } from '../core/Object3D.js';
 import { CoordinateSystem } from '../constants.js';
 
 /**
@@ -56,6 +56,8 @@ export class CubeCamera extends Object3D {
 
     coordinateSystem: CoordinateSystem;
 
+    activeMipmapLevel: number;
+
     updateCoordinateSystem(): void;
 
     /**

three/src/constants.d.ts

@@ -724,6 +724,14 @@ export type ColorSpace =
     | typeof DisplayP3ColorSpace
     | typeof LinearDisplayP3ColorSpace;
 
+export const LinearTransfer: 'linear';
+export const SRGBTransfer: 'srgb';
+export type ColorSpaceTransfer = typeof LinearTransfer | typeof SRGBTransfer;
+
+export const Rec709Primaries: 'rec709';
+export const P3Primaries: 'p3';
+export type ColorSpacePrimaries = typeof Rec709Primaries | typeof P3Primaries;
+
 // Stencil Op types
 export const ZeroStencilOp: 0;
 export const KeepStencilOp: 7680;

three/src/core/Raycaster.d.ts

@@ -1,8 +1,8 @@
-import { Vector3 } from './../math/Vector3.js';
+import { Vector3 } from '../math/Vector3.js';
 import { Object3D } from './Object3D.js';
-import { Vector2 } from './../math/Vector2.js';
-import { Ray } from './../math/Ray.js';
-import { Camera } from './../cameras/Camera.js';
+import { Vector2 } from '../math/Vector2.js';
+import { Ray } from '../math/Ray.js';
+import { Camera } from '../cameras/Camera.js';
 import { Layers } from './Layers.js';
 
 export interface Face {
@@ -34,12 +34,12 @@ export interface Intersection<TIntersected extends Object3D = Object3D> {
 }
 
 export interface RaycasterParameters {
-    Mesh?: any;
-    Line?: { threshold: number } | undefined;
-    Line2?: { threshold: number } | undefined;
-    LOD?: any;
-    Points?: { threshold: number } | undefined;
-    Sprite?: any;
+    Mesh: any;
+    Line: { threshold: number };
+    Line2?: { threshold: number };
+    LOD: any;
+    Points: { threshold: number };
+    Sprite: any;
 }
 
 /**

three/src/core/RenderTarget.d.ts

@@ -9,6 +9,7 @@ import {
     MinificationTextureFilter,
     MagnificationTextureFilter,
     ColorSpace,
+    PixelFormatGPU,
 } from '../constants.js';
 
 export interface RenderTargetOptions {
@@ -21,6 +22,7 @@ export interface RenderTargetOptions {
     type?: TextureDataType | undefined; // UnsignedByteType;
     anisotropy?: number | undefined; // 1;
     colorSpace?: ColorSpace | undefined;
+    internalFormat?: PixelFormatGPU | null | undefined;
     depthBuffer?: boolean | undefined; // true;
     stencilBuffer?: boolean | undefined; // false;
     depthTexture?: DepthTexture | undefined;

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

@@ -1,5 +1,5 @@
 import { Curve } from './Curve.js';
-import { Vector } from './../../math/Vector2.js';
+import { Vector } from '../../math/Vector2.js';
 
 /**
  * Curved Path - a curve path is simply a array of connected curves, but retains the api of a curve.
@@ -41,7 +41,7 @@ export class CurvePath<T extends Vector> extends Curve<T> {
     /**
      * Adds a {@link LineCurve | lineCurve} to close the path.
      */
-    closePath(): void;
+    closePath(): this;
 
     getPoint(t: number, optionalTarget?: T): T;
 

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

@@ -52,9 +52,9 @@ export class Path extends CurvePath<Vector2> {
      * @param radius The radius of the arc. Expects a `Float`
      * @param startAngle The start angle in radians. Expects a `Float`
      * @param endAngle The end angle in radians. Expects a `Float`
-     * @param clockwise Sweep the arc clockwise. . Default `false`
+     * @param clockwise Sweep the arc clockwise. Default `false`
      */
-    absarc(aX: number, aY: number, aRadius: number, aStartAngle: number, aEndAngle: number, aClockwise: boolean): this;
+    absarc(aX: number, aY: number, aRadius: number, aStartAngle: number, aEndAngle: number, aClockwise?: boolean): this;
 
     /**
      * Adds an absolutely positioned {@link THREE.EllipseCurve | EllipseCurve} to the path.
@@ -64,7 +64,7 @@ export class Path extends CurvePath<Vector2> {
      * @param yRadius The radius of the ellipse in the y axis. Expects a `Float`
      * @param startAngle The start angle in radians. Expects a `Float`
      * @param endAngle The end angle in radians. Expects a `Float`
-     * @param clockwise Sweep the ellipse clockwise. . Default `false`
+     * @param clockwise Sweep the ellipse clockwise. Default `false`
      * @param rotation The rotation angle of the ellipse in radians, counterclockwise from the positive X axis. Optional, Expects a `Float`. Default `0`
      */
     absellipse(
@@ -74,7 +74,7 @@ export class Path extends CurvePath<Vector2> {
         yRadius: number,
         aStartAngle: number,
         aEndAngle: number,
-        aClockwise: boolean,
+        aClockwise?: boolean,
         aRotation?: number,
     ): this;
 
@@ -85,9 +85,9 @@ export class Path extends CurvePath<Vector2> {
      * @param radius The radius of the arc. Expects a `Float`
      * @param startAngle The start angle in radians. Expects a `Float`
      * @param endAngle The end angle in radians. Expects a `Float`
-     * @param clockwise Sweep the arc clockwise. . Default `false`
+     * @param clockwise Sweep the arc clockwise. Default `false`
      */
-    arc(aX: number, aY: number, aRadius: number, aStartAngle: number, aEndAngle: number, aClockwise: boolean): this;
+    arc(aX: number, aY: number, aRadius: number, aStartAngle: number, aEndAngle: number, aClockwise?: boolean): this;
 
     /**
      * This creates a bezier curve from {@link .currentPoint} with (cp1X, cp1Y) and (cp2X, cp2Y) as control points and updates {@link .currentPoint} to x and y.
@@ -108,7 +108,7 @@ export class Path extends CurvePath<Vector2> {
      * @param yRadius The radius of the ellipse in the y axis. Expects a `Float`
      * @param startAngle The start angle in radians. Expects a `Float`
      * @param endAngle The end angle in radians. Expects a `Float`
-     * @param clockwise Sweep the ellipse clockwise. . Default `false`
+     * @param clockwise Sweep the ellipse clockwise. Default `false`
      * @param rotation The rotation angle of the ellipse in radians, counterclockwise from the positive X axis. Optional, Expects a `Float`. Default `0`
      */
     ellipse(
@@ -118,8 +118,8 @@ export class Path extends CurvePath<Vector2> {
         yRadius: number,
         aStartAngle: number,
         aEndAngle: number,
-        aClockwise: boolean,
-        aRotation: number,
+        aClockwise?: boolean,
+        aRotation?: number,
     ): this;
 
     /**

three/src/loaders/FileLoader.d.ts

@@ -4,6 +4,13 @@ import { LoadingManager } from './LoadingManager.js';
 export class FileLoader extends Loader<string | ArrayBuffer> {
     constructor(manager?: LoadingManager);
 
+    load(
+        url: string,
+        onLoad?: (data: string | ArrayBuffer) => void,
+        onProgress?: (event: ProgressEvent) => void,
+        onError?: (err: unknown) => void,
+    ): void;
+
     mimeType: undefined | MimeType;
     responseType: undefined | string;
 

three/src/loaders/ImageBitmapLoader.d.ts

@@ -4,6 +4,13 @@ import { LoadingManager } from './LoadingManager.js';
 export class ImageBitmapLoader extends Loader<ImageBitmap> {
     constructor(manager?: LoadingManager);
 
+    load(
+        url: string,
+        onLoad?: (data: ImageBitmap) => void,
+        onProgress?: (event: ProgressEvent) => void,
+        onError?: (err: unknown) => void,
+    ): void;
+
     /**
      * @default { premultiplyAlpha: 'none' }
      */

three/src/loaders/Loader.d.ts

@@ -34,7 +34,7 @@ export class Loader<TData = unknown, TUrl = string> {
 
     load(
         url: TUrl,
-        onLoad?: (data: TData) => void,
+        onLoad: (data: TData) => void,
         onProgress?: (event: ProgressEvent) => void,
         onError?: (err: unknown) => void,
     ): void;

three/src/loaders/ObjectLoader.d.ts

@@ -11,6 +11,13 @@ import { Source } from '../textures/Source.js';
 export class ObjectLoader extends Loader<Object3D> {
     constructor(manager?: LoadingManager);
 
+    load(
+        url: string,
+        onLoad?: (data: Object3D) => void,
+        onProgress?: (event: ProgressEvent) => void,
+        onError?: (err: unknown) => void,
+    ): void;
+
     parse(json: unknown, onLoad?: (object: Object3D) => void): Object3D;
     parseAsync(json: unknown): Promise<Object3D>;
     parseGeometries(json: unknown): { [key: string]: InstancedBufferGeometry | BufferGeometry };

three/src/materials/Material.d.ts

@@ -66,6 +66,12 @@ export interface MaterialParameters {
 export class Material extends EventDispatcher<{ dispose: {} }> {
     constructor();
 
+    /**
+     * 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,
+     * but approximates alpha blending without the associated problems of sorting. Using TAARenderPass can reduce the
+     * resulting noise.
+     */
     alphaHash: boolean;
 
     /**

three/src/math/Color.d.ts

@@ -204,8 +204,7 @@ export class Color {
      */
     b: number;
 
-    set(color: ColorRepresentation): this;
-    set(r: number, g: number, b: number): this;
+    set(...args: [color: ColorRepresentation] | [r: number, g: number, b: number]): this;
 
     /**
      * Sets this color's {@link r}, {@link g} and {@link b} components from the x, y, and z components of the specified