@types/three 0.165.0 → 0.167.0

three/src/Three.d.ts

@@ -1,11 +1,8 @@
-/**
- * SRC
- */
-export * from "./constants.js";
-export * from "./Three.Legacy.js";
-/**
- * Animation
- */
+export * from "./animation/AnimationAction.js";
+export * from "./animation/AnimationClip.js";
+export * from "./animation/AnimationMixer.js";
+export * from "./animation/AnimationObjectGroup.js";
+export { AnimationUtils } from "./animation/AnimationUtils.js";
 export * from "./animation/KeyframeTrack.js";
 export * from "./animation/PropertyBinding.js";
 export * from "./animation/PropertyMixer.js";
@@ -15,32 +12,18 @@ export * from "./animation/tracks/NumberKeyframeTrack.js";
 export * from "./animation/tracks/QuaternionKeyframeTrack.js";
 export * from "./animation/tracks/StringKeyframeTrack.js";
 export * from "./animation/tracks/VectorKeyframeTrack.js";
-import * as AnimationUtils from "./animation/AnimationUtils.js";
-export { AnimationUtils };
-export * from "./animation/AnimationAction.js";
-export * from "./animation/AnimationClip.js";
-export * from "./animation/AnimationMixer.js";
-export * from "./animation/AnimationObjectGroup.js";
-/**
- * Audio
- */
 export * from "./audio/Audio.js";
 export * from "./audio/AudioAnalyser.js";
 export * from "./audio/AudioContext.js";
 export * from "./audio/AudioListener.js";
 export * from "./audio/PositionalAudio.js";
-/**
- * Cameras
- */
 export * from "./cameras/ArrayCamera.js";
 export * from "./cameras/Camera.js";
 export * from "./cameras/CubeCamera.js";
 export * from "./cameras/OrthographicCamera.js";
 export * from "./cameras/PerspectiveCamera.js";
 export * from "./cameras/StereoCamera.js";
-/**
- * Core
- */
+export * from "./constants.js";
 export * from "./core/BufferAttribute.js";
 export * from "./core/BufferGeometry.js";
 export * from "./core/Clock.js";
@@ -57,27 +40,18 @@ export * from "./core/Raycaster.js";
 export * from "./core/RenderTarget.js";
 export * from "./core/Uniform.js";
 export * from "./core/UniformsGroup.js";
-/**
- * Extras
- */
 export * from "./extras/core/Curve.js";
 export * from "./extras/core/CurvePath.js";
-export * from "./extras/core/Interpolations.js";
 export * from "./extras/core/Path.js";
 export * from "./extras/core/Shape.js";
 export * from "./extras/core/ShapePath.js";
 export * from "./extras/curves/Curves.js";
-export * as DataUtils from "./extras/DataUtils.js";
+export { DataUtils } from "./extras/DataUtils.js";
 export * from "./extras/ImageUtils.js";
 export * from "./extras/PMREMGenerator.js";
 export * from "./extras/ShapeUtils.js";
-/**
- * Geometries
- */
+export { TextureUtils } from "./extras/TextureUtils.js";
 export * from "./geometries/Geometries.js";
-/**
- * Helpers
- */
 export * from "./helpers/ArrowHelper.js";
 export * from "./helpers/AxesHelper.js";
 export * from "./helpers/Box3Helper.js";
@@ -91,24 +65,14 @@ export * from "./helpers/PointLightHelper.js";
 export * from "./helpers/PolarGridHelper.js";
 export * from "./helpers/SkeletonHelper.js";
 export * from "./helpers/SpotLightHelper.js";
-/**
- * Lights
- */
 export * from "./lights/AmbientLight.js";
 export * from "./lights/DirectionalLight.js";
-export * from "./lights/DirectionalLightShadow.js";
 export * from "./lights/HemisphereLight.js";
 export * from "./lights/Light.js";
 export * from "./lights/LightProbe.js";
-export * from "./lights/LightShadow.js";
 export * from "./lights/PointLight.js";
-export * from "./lights/PointLightShadow.js";
 export * from "./lights/RectAreaLight.js";
 export * from "./lights/SpotLight.js";
-export * from "./lights/SpotLightShadow.js";
-/**
- * Loaders
- */
 export * from "./loaders/AnimationLoader.js";
 export * from "./loaders/AudioLoader.js";
 export * from "./loaders/BufferGeometryLoader.js";
@@ -125,13 +89,7 @@ export * from "./loaders/LoadingManager.js";
 export * from "./loaders/MaterialLoader.js";
 export * from "./loaders/ObjectLoader.js";
 export * from "./loaders/TextureLoader.js";
-/**
- * Materials
- */
 export * from "./materials/Materials.js";
-/**
- * Math
- */
 export * from "./math/Box2.js";
 export * from "./math/Box3.js";
 export * from "./math/Color.js";
@@ -145,6 +103,8 @@ export * from "./math/interpolants/DiscreteInterpolant.js";
 export * from "./math/interpolants/LinearInterpolant.js";
 export * from "./math/interpolants/QuaternionLinearInterpolant.js";
 export * from "./math/Line3.js";
+export { MathUtils } from "./math/MathUtils.js";
+export * from "./math/Matrix2.js";
 export * from "./math/Matrix3.js";
 export * from "./math/Matrix4.js";
 export * from "./math/Plane.js";
@@ -157,11 +117,6 @@ export * from "./math/Triangle.js";
 export * from "./math/Vector2.js";
 export * from "./math/Vector3.js";
 export * from "./math/Vector4.js";
-import * as MathUtils from "./math/MathUtils.js";
-export { MathUtils };
-/**
- * Objects
- */
 export * from "./objects/BatchedMesh.js";
 export * from "./objects/Bone.js";
 export * from "./objects/Group.js";
@@ -175,50 +130,32 @@ export * from "./objects/Points.js";
 export * from "./objects/Skeleton.js";
 export * from "./objects/SkinnedMesh.js";
 export * from "./objects/Sprite.js";
-/**
- * Renderers
- */
 export * from "./renderers/shaders/ShaderChunk.js";
 export * from "./renderers/shaders/ShaderLib.js";
 export * from "./renderers/shaders/UniformsLib.js";
-export * from "./renderers/shaders/UniformsUtils.js";
-export * from "./renderers/webgl/WebGLBufferRenderer.js";
-export * from "./renderers/webgl/WebGLCapabilities.js";
-export * from "./renderers/webgl/WebGLClipping.js";
-export * from "./renderers/webgl/WebGLCubeUVMaps.js";
-export * from "./renderers/webgl/WebGLExtensions.js";
-export * from "./renderers/webgl/WebGLGeometries.js";
-export * from "./renderers/webgl/WebGLIndexedBufferRenderer.js";
-export * from "./renderers/webgl/WebGLInfo.js";
-export * from "./renderers/webgl/WebGLLights.js";
-export * from "./renderers/webgl/WebGLObjects.js";
-export * from "./renderers/webgl/WebGLProgram.js";
-export * from "./renderers/webgl/WebGLPrograms.js";
-export * from "./renderers/webgl/WebGLProperties.js";
-export * from "./renderers/webgl/WebGLRenderLists.js";
-export * from "./renderers/webgl/WebGLShader.js";
-export * from "./renderers/webgl/WebGLShadowMap.js";
-export * from "./renderers/webgl/WebGLState.js";
-export * from "./renderers/webgl/WebGLTextures.js";
-export * from "./renderers/webgl/WebGLUniforms.js";
-export * from "./renderers/webgl/WebGLUniformsGroups.js";
-export { WebGLUtils } from "./renderers/webgl/WebGLUtils.js";
+export { UniformsUtils } from "./renderers/shaders/UniformsUtils.js";
+export type { WebGLProgramParameters, WebGLProgramParametersWithUniforms } from "./renderers/webgl/WebGLPrograms.js";
+export type { WebGLShadowMap } from "./renderers/webgl/WebGLShadowMap.js";
+export * from "./renderers/webgl/WebGLUtils.js";
 export * from "./renderers/WebGL3DRenderTarget.js";
 export * from "./renderers/WebGLArrayRenderTarget.js";
 export * from "./renderers/WebGLCubeRenderTarget.js";
 export * from "./renderers/WebGLRenderer.js";
 export * from "./renderers/WebGLRenderTarget.js";
-export * from "./renderers/webxr/WebXRController.js";
-export * from "./renderers/webxr/WebXRManager.js";
-/**
- * Scenes
- */
+export type {
+    WebXRController,
+    WebXRSpaceEventMap,
+    XRControllerEventType,
+    XRGripSpace,
+    XRHandInputState,
+    XRHandJoints,
+    XRHandSpace,
+    XRJointSpace,
+    XRTargetRaySpace,
+} from "./renderers/webxr/WebXRController.js";
 export * from "./scenes/Fog.js";
 export * from "./scenes/FogExp2.js";
 export * from "./scenes/Scene.js";
-/**
- * Textures
- */
 export * from "./textures/CanvasTexture.js";
 export * from "./textures/CompressedArrayTexture.js";
 export * from "./textures/CompressedCubeTexture.js";
@@ -232,7 +169,5 @@ export * from "./textures/FramebufferTexture.js";
 export * from "./textures/Source.js";
 export * from "./textures/Texture.js";
 export * from "./textures/VideoTexture.js";
-/**
- * Utils
- */
+export * from "./Three.Legacy.js";
 export { createCanvasElement } from "./utils.js";

three/src/animation/AnimationClip.d.ts

@@ -1,7 +1,15 @@
 import { AnimationBlendMode } from "../constants.js";
 import { Vector3 } from "../math/Vector3.js";
 import { Bone } from "../objects/Bone.js";
-import { KeyframeTrack } from "./KeyframeTrack.js";
+import { KeyframeTrack, KeyframeTrackJSON } from "./KeyframeTrack.js";
+
+export interface AnimationClipJSON {
+    name: string;
+    duration: number;
+    tracks: KeyframeTrackJSON[];
+    uuid: string;
+    blendMode: AnimationBlendMode;
+}
 
 export interface MorphTarget {
     name: string;
@@ -45,7 +53,7 @@ export class AnimationClip {
         fps: number,
         noLoop: boolean,
     ): AnimationClip[];
-    static parse(json: any): AnimationClip;
-    static parseAnimation(animation: any, bones: Bone[]): AnimationClip;
-    static toJSON(clip: AnimationClip): any;
+    static parse(json: AnimationClipJSON): AnimationClip;
+    static parseAnimation(animation: AnimationClipJSON, bones: Bone[]): AnimationClip;
+    static toJSON(clip: AnimationClip): AnimationClipJSON;
 }

three/src/animation/AnimationUtils.d.ts

@@ -1,10 +1,14 @@
 import { AnimationClip } from "./AnimationClip.js";
 
-export function convertArray(array: any, type: any, forceClone: boolean): any;
-export function isTypedArray(object: any): boolean;
-export function getKeyframeOrder(times: number[]): number[];
-export function sortedArray(values: any[], stride: number, order: number[]): any[];
-export function flattenJSON(jsonKeys: string[], times: any[], values: any[], valuePropertyName: string): void;
+declare function convertArray(array: any, type: any, forceClone: boolean): any;
+
+declare function isTypedArray(object: any): boolean;
+
+declare function getKeyframeOrder(times: number[]): number[];
+
+declare function sortedArray(values: any[], stride: number, order: number[]): any[];
+
+declare function flattenJSON(jsonKeys: string[], times: any[], values: any[], valuePropertyName: string): void;
 
 /**
  * @param sourceClip
@@ -13,7 +17,7 @@ export function flattenJSON(jsonKeys: string[], times: any[], values: any[], val
  * @param endFrame
  * @param [fps=30]
  */
-export function subclip(
+declare function subclip(
     sourceClip: AnimationClip,
     name: string,
     startFrame: number,
@@ -27,9 +31,30 @@ export function subclip(
  * @param [referenceClip=targetClip]
  * @param [fps=30]
  */
-export function makeClipAdditive(
+declare function makeClipAdditive(
     targetClip: AnimationClip,
     referenceFrame?: number,
     referenceClip?: AnimationClip,
     fps?: number,
 ): AnimationClip;
+
+declare const AnimationUtils: {
+    convertArray: typeof convertArray;
+    isTypedArray: typeof isTypedArray;
+    getKeyframeOrder: typeof getKeyframeOrder;
+    sortedArray: typeof sortedArray;
+    flattenJSON: typeof flattenJSON;
+    subclip: typeof subclip;
+    makeClipAdditive: typeof makeClipAdditive;
+};
+
+export {
+    AnimationUtils,
+    convertArray,
+    flattenJSON,
+    getKeyframeOrder,
+    isTypedArray,
+    makeClipAdditive,
+    sortedArray,
+    subclip,
+};

three/src/animation/KeyframeTrack.d.ts

@@ -4,6 +4,14 @@ import { CubicInterpolant } from "../math/interpolants/CubicInterpolant.js";
 import { DiscreteInterpolant } from "../math/interpolants/DiscreteInterpolant.js";
 import { LinearInterpolant } from "../math/interpolants/LinearInterpolant.js";
 
+export interface KeyframeTrackJSON {
+    name: string;
+    times: number[];
+    values: number[];
+    interpolation?: InterpolationModes;
+    type: string;
+}
+
 export class KeyframeTrack {
     /**
      * @param name
@@ -43,5 +51,5 @@ export class KeyframeTrack {
     optimize(): KeyframeTrack;
     clone(): this;
 
-    static toJSON(track: KeyframeTrack): any;
+    static toJSON(track: KeyframeTrack): KeyframeTrackJSON;
 }

three/src/animation/PropertyBinding.d.ts

@@ -6,7 +6,16 @@ export interface ParseTrackNameResults {
     propertyIndex: string;
 }
 
-export class PropertyBinding {
+declare class Composite {
+    constructor(targetGroup: any, path: any, parsedPath?: any);
+
+    getValue(array: any, offset: number): any;
+    setValue(array: any, offset: number): void;
+    bind(): void;
+    unbind(): void;
+}
+
+declare class PropertyBinding {
     constructor(rootNode: any, path: string, parsedPath?: any);
 
     path: string;
@@ -25,19 +34,10 @@ export class PropertyBinding {
     GetterByBindingType: Array<() => void>;
     SetterByBindingTypeAndVersioning: Array<Array<() => void>>;
 
-    static create(root: any, path: any, parsedPath?: any): PropertyBinding | PropertyBinding.Composite;
+    static create(root: any, path: any, parsedPath?: any): PropertyBinding | Composite;
     static sanitizeNodeName(name: string): string;
     static parseTrackName(trackName: string): ParseTrackNameResults;
     static findNode(root: any, nodeName: string): any;
 }
 
-export namespace PropertyBinding {
-    class Composite {
-        constructor(targetGroup: any, path: any, parsedPath?: any);
-
-        getValue(array: any, offset: number): any;
-        setValue(array: any, offset: number): void;
-        bind(): void;
-        unbind(): void;
-    }
-}
+export { PropertyBinding };

three/src/cameras/OrthographicCamera.d.ts

@@ -1,5 +1,30 @@
+import { JSONMeta, Object3DJSON, Object3DJSONObject } from "../core/Object3D.js";
 import { Camera } from "./Camera.js";
 
+export interface OrthographicCameraJSONObject extends Object3DJSONObject {
+    zoom: number;
+    left: number;
+    right: number;
+    top: number;
+    bottom: number;
+    near: number;
+    far: number;
+
+    view?: {
+        enabled: boolean;
+        fullWidth: number;
+        fullHeight: number;
+        offsetX: number;
+        offsetY: number;
+        width: number;
+        height: number;
+    };
+}
+
+export interface OrthographicCameraJSON extends Object3DJSON {
+    object: OrthographicCameraJSONObject;
+}
+
 /**
  * Camera that uses {@link https://en.wikipedia.org/wiki/Orthographic_projection | orthographic projection}.
  * In this projection mode, an object's size in the rendered image stays constant regardless of its distance from the camera.
@@ -144,4 +169,6 @@ export class OrthographicCamera extends Camera {
      * Removes any offset set by the {@link setViewOffset | .setViewOffset} method.
      */
     clearViewOffset(): void;
+
+    toJSON(meta?: JSONMeta): OrthographicCameraJSON;
 }

three/src/cameras/PerspectiveCamera.d.ts

@@ -1,6 +1,35 @@
+import { JSONMeta, Object3DJSON, Object3DJSONObject } from "../core/Object3D.js";
 import { Vector2 } from "../math/Vector2.js";
 import { Camera } from "./Camera.js";
 
+export interface PerspectiveCameraJSONObject extends Object3DJSONObject {
+    fov: number;
+    zoom: number;
+
+    near: number;
+    far: number;
+    focus: number;
+
+    aspect: number;
+
+    view?: {
+        enabled: boolean;
+        fullWidth: number;
+        fullHeight: number;
+        offsetX: number;
+        offsetY: number;
+        width: number;
+        height: number;
+    };
+
+    filmGauge: number;
+    filmOffset: number;
+}
+
+export interface PerspectiveCameraJSON extends Object3DJSON {
+    object: PerspectiveCameraJSONObject;
+}
+
 /**
  * Camera that uses {@link https://en.wikipedia.org/wiki/Perspective_(graphical) | perspective projection}.
  * This projection mode is designed to mimic the way the human eye sees
@@ -220,4 +249,6 @@ export class PerspectiveCamera extends Camera {
      * @deprecated Use {@link PerspectiveCamera.setFocalLength | .setFocalLength()} and {@link PerspectiveCamera.filmGauge | .filmGauge} instead.
      */
     setLens(focalLength: number, frameHeight?: number): void;
+
+    toJSON(meta?: JSONMeta): PerspectiveCameraJSON;
 }

three/src/constants.d.ts

@@ -419,6 +419,11 @@ export const RGFormat: 1030;
  */
 export const RGIntegerFormat: 1031;
 
+/**
+ * {@link RGBIntegerFormat} discrads the alpha components and reads the red, green, and blue components.
+ */
+export const RGBIntegerFormat: 1032;
+
 /**
  * {@link RGBAIntegerFormat} reads the red, green, blue and alpha component
  * @remarks This is the default for {@link THREE.Texture}.
@@ -443,6 +448,7 @@ export type PixelFormat =
     | typeof RedIntegerFormat
     | typeof RGFormat
     | typeof RGIntegerFormat
+    | typeof RGBIntegerFormat
     | typeof RGBAIntegerFormat;
 
 /**
@@ -673,7 +679,13 @@ export type TrianglesDrawModes = typeof TrianglesDrawMode | typeof TriangleStrip
 
 export const BasicDepthPacking: 3200;
 export const RGBADepthPacking: 3201;
-export type DepthPackingStrategies = typeof BasicDepthPacking | typeof RGBADepthPacking;
+export const RGBDepthPacking: 3202;
+export const RGDepthPacking: 3203;
+export type DepthPackingStrategies =
+    | typeof BasicDepthPacking
+    | typeof RGBADepthPacking
+    | typeof RGBDepthPacking
+    | typeof RGDepthPacking;
 
 ///////////////////////////////////////////////////////////////////////////////
 // Normal Map types

three/src/core/BufferAttribute.d.ts

@@ -13,6 +13,16 @@ export type TypedArray =
     | Float32Array
     | Float64Array;
 
+export interface BufferAttributeJSON {
+    itemSize: number;
+    type: string;
+    array: number[];
+    normalized: boolean;
+
+    name?: string;
+    usage?: Usage;
+}
+
 /**
  * This class stores data for an attribute (such as vertex positions, face indices, normals, colors, UVs, and any custom attributes )
  * associated with a {@link THREE.BufferGeometry | BufferGeometry}, which allows for more efficient passing of data to the GPU
@@ -336,12 +346,7 @@ export class BufferAttribute {
     /**
      * Convert this object to three.js to the `data.attributes` part of {@link https://github.com/mrdoob/three.js/wiki/JSON-Geometry-format-4 | JSON Geometry format v4},
      */
-    toJSON(): {
-        itemSize: number;
-        type: string;
-        array: number[];
-        normalized: boolean;
-    };
+    toJSON(): BufferAttributeJSON;
 }
 
 /**

three/src/core/BufferGeometry.d.ts

@@ -3,8 +3,8 @@ import { Matrix4 } from "../math/Matrix4.js";
 import { Quaternion } from "../math/Quaternion.js";
 import { Sphere } from "../math/Sphere.js";
 import { Vector2 } from "../math/Vector2.js";
-import { Vector3 } from "../math/Vector3.js";
-import { BufferAttribute } from "./BufferAttribute.js";
+import { Vector3, Vector3Tuple } from "../math/Vector3.js";
+import { BufferAttribute, BufferAttributeJSON } from "./BufferAttribute.js";
 import { EventDispatcher } from "./EventDispatcher.js";
 import { GLBufferAttribute } from "./GLBufferAttribute.js";
 import { InterleavedBufferAttribute } from "./InterleavedBufferAttribute.js";
@@ -15,6 +15,29 @@ export type NormalOrGLBufferAttributes = Record<
     BufferAttribute | InterleavedBufferAttribute | GLBufferAttribute
 >;
 
+export interface BufferGeometryJSON {
+    metadata?: { version: number; type: string; generator: string };
+
+    uuid: string;
+    type: string;
+
+    name?: string;
+    userData?: Record<string, unknown>;
+
+    data?: {
+        attributes: Record<string, BufferAttributeJSON>;
+
+        index?: { type: string; array: number[] };
+
+        morphAttributes?: Record<string, BufferAttributeJSON[]>;
+        morphTargetsRelative?: boolean;
+
+        groups?: GeometryGroup[];
+
+        boundingSphere?: { center: Vector3Tuple; radius: number };
+    };
+}
+
 export interface GeometryGroup {
     /**
      * Specifies the first element in this draw call – the first vertex for non-indexed geometry, otherwise the first triangle index.
@@ -378,7 +401,7 @@ export class BufferGeometry<
     /**
      * Convert the buffer geometry to three.js {@link https://github.com/mrdoob/three.js/wiki/JSON-Object-Scene-format-4 | JSON Object/Scene format}.
      */
-    toJSON(): {};
+    toJSON(): BufferGeometryJSON;
 
     /**
      * Creates a clone of this BufferGeometry

three/src/core/InterleavedBufferAttribute.d.ts

@@ -1,4 +1,4 @@
-import { Matrix } from "../math/Matrix3.js";
+import { Matrix3 } from "../math/Matrix3.js";
 import { Matrix4 } from "../math/Matrix4.js";
 import { BufferAttribute, TypedArray } from "./BufferAttribute.js";
 import { InterleavedBuffer } from "./InterleavedBuffer.js";
@@ -84,13 +84,13 @@ export class InterleavedBufferAttribute {
      * Applies normal matrix {@link Matrix3 | m} to every Vector3 element of this InterleavedBufferAttribute.
      * @param m
      */
-    applyNormalMatrix(m: Matrix): this;
+    applyNormalMatrix(m: Matrix3): this;
 
     /**
      * Applies matrix {@link Matrix4 | m} to every Vector3 element of this InterleavedBufferAttribute, interpreting the elements as a direction vectors.
      * @param m
      */
-    transformDirection(m: Matrix): this;
+    transformDirection(m: Matrix4): this;
 
     /**
      * Returns the given component of the vector at the given index.

three/src/core/Object3D.d.ts

@@ -1,19 +1,64 @@
-import { AnimationClip } from "../animation/AnimationClip.js";
+import { AnimationClip, AnimationClipJSON } from "../animation/AnimationClip.js";
 import { Camera } from "../cameras/Camera.js";
-import { Material } from "../materials/Material.js";
+import { ShapeJSON } from "../extras/core/Shape.js";
+import { Material, MaterialJSON } from "../materials/Material.js";
 import { Euler } from "../math/Euler.js";
 import { Matrix3 } from "../math/Matrix3.js";
-import { Matrix4 } from "../math/Matrix4.js";
+import { Matrix4, Matrix4Tuple } from "../math/Matrix4.js";
 import { Quaternion } from "../math/Quaternion.js";
-import { Vector3 } from "../math/Vector3.js";
+import { Vector3, Vector3Tuple } from "../math/Vector3.js";
 import { Group } from "../objects/Group.js";
+import { SkeletonJSON } from "../objects/Skeleton.js";
 import { WebGLRenderer } from "../renderers/WebGLRenderer.js";
 import { Scene } from "../scenes/Scene.js";
-import { BufferGeometry } from "./BufferGeometry.js";
+import { SourceJSON } from "../textures/Source.js";
+import { TextureJSON } from "../textures/Texture.js";
+import { BufferGeometry, BufferGeometryJSON } from "./BufferGeometry.js";
 import { EventDispatcher } from "./EventDispatcher.js";
 import { Layers } from "./Layers.js";
 import { Intersection, Raycaster } from "./Raycaster.js";
 
+export interface Object3DJSONObject {
+    uuid: string;
+    type: string;
+
+    name?: string;
+    castShadow?: boolean;
+    receiveShadow?: boolean;
+    visible?: boolean;
+    frustumCulled?: boolean;
+    renderOrder?: number;
+    userData?: Record<string, unknown>;
+
+    layers: number;
+    matrix: Matrix4Tuple;
+    up: Vector3Tuple;
+
+    matrixAutoUpdate?: boolean;
+
+    material?: string | string[];
+
+    children?: string[];
+
+    animations?: string[];
+}
+
+export interface Object3DJSON {
+    metadata?: { version: number; type: string; generator: string };
+    object: Object3DJSONObject;
+}
+
+export interface JSONMeta {
+    geometries: Record<string, BufferGeometryJSON>;
+    materials: Record<string, MaterialJSON>;
+    textures: Record<string, TextureJSON>;
+    images: Record<string, SourceJSON>;
+    shapes: Record<string, ShapeJSON>;
+    skeletons: Record<string, SkeletonJSON>;
+    animations: Record<string, AnimationClipJSON>;
+    nodes: Record<string, unknown>;
+}
+
 export interface Object3DEventMap {
     /**
      * Fires when the object has been added to its parent object.
@@ -608,7 +653,7 @@ export class Object3D<TEventMap extends Object3DEventMap = Object3DEventMap> ext
      * Convert the object to three.js {@link https://github.com/mrdoob/three.js/wiki/JSON-Object-Scene-format-4 | JSON Object/Scene format}.
      * @param meta Object containing metadata such as materials, textures or images for the object.
      */
-    toJSON(meta?: { geometries: any; materials: any; textures: any; images: any }): any;
+    toJSON(meta?: JSONMeta): Object3DJSON;
 
     /**
      * Returns a clone of `this` object and optionally all descendants.