super-three 0.184.0 → 0.185.0

package/examples/jsm/Addons.js

@@ -46,6 +46,7 @@ export * from './exporters/USDZExporter.js';
 export * from './geometries/BoxLineGeometry.js';
 export * from './geometries/ConvexGeometry.js';
 export * from './geometries/DecalGeometry.js';
+export * from './geometries/LoftGeometry.js';
 export * from './geometries/ParametricFunctions.js';
 export * from './geometries/ParametricGeometry.js';
 export * from './geometries/RoundedBoxGeometry.js';
@@ -149,6 +150,7 @@ export * from './misc/MorphAnimMesh.js';
 export * from './misc/MorphBlendMesh.js';
 export * from './misc/ProgressiveLightMap.js';
 export * from './misc/RollerCoaster.js';
+export * from './misc/TileCreasedNormalsPlugin.js';
 export * from './misc/TubePainter.js';
 export * from './misc/Volume.js';
 export * from './misc/VolumeSlice.js';
@@ -284,6 +286,7 @@ export * from './webxr/OculusHandModel.js';
 export * from './webxr/OculusHandPointerModel.js';
 export * from './webxr/Text2D.js';
 export * from './webxr/VRButton.js';
+export * from './webxr/WebGLXRFallback.js';
 export * from './webxr/XRButton.js';
 export * from './webxr/XRControllerModelFactory.js';
 export * from './webxr/XREstimatedLight.js';

package/examples/jsm/controls/ArcballControls.js

@@ -265,6 +265,10 @@ class ArcballControls extends Controls {
 		 * performed trying to maintain the same visible portion given by initial near and far
 		 * values. Only works with perspective cameras.
 		 *
+		 * This feature only works as expected if the camera's initial state (position, near and far values)
+		 * is correctly configured before creating the controls. Otherwise {@link ArcballControls#setCamera}
+		 * must be called by the application.
+		 *
 		 * @type {boolean}
 		 * @default false
 		 */
@@ -2008,8 +2012,8 @@ class ArcballControls extends Controls {
 		const gizmoZ = new Line( curveGeometry, curveMaterialZ );
 
 		const rotation = Math.PI * 0.5;
-		gizmoX.rotation.x = rotation;
-		gizmoY.rotation.y = rotation;
+		gizmoX.rotation.y = rotation;
+		gizmoY.rotation.x = rotation;
 
 
 		//setting state

package/examples/jsm/controls/FirstPersonControls.js

@@ -9,6 +9,7 @@ const _lookDirection = new Vector3();
 const _spherical = new Spherical();
 const _target = new Vector3();
 const _targetPosition = new Vector3();
+const _targetVelocity = new Vector3();
 
 /**
  * This class is an alternative implementation of {@link FlyControls}.
@@ -44,6 +45,15 @@ class FirstPersonControls extends Controls {
 		 */
 		this.lookSpeed = 0.005;
 
+		/**
+		 * How quickly the movement and look velocity catches up to the input. Lower
+		 * values feel heavier (more inertia), `1` disables damping.
+		 *
+		 * @type {number}
+		 * @default 0.1
+		 */
+		this.dampingFactor = 0.1;
+
 		/**
 		 * Whether it's possible to vertically look around or not.
 		 *
@@ -128,7 +138,7 @@ class FirstPersonControls extends Controls {
 
 		// internals
 
-		this._autoSpeedFactor = 0.0;
+		this._velocity = new Vector3();
 
 		this._pointerX = 0;
 		this._pointerY = 0;
@@ -138,14 +148,23 @@ class FirstPersonControls extends Controls {
 
 		this._pointerCount = 0;
 
-		this._moveForward = false;
-		this._moveBackward = false;
+		// forward / backward come from keys and the pointer, tracked per source so they don't
+		// clobber: while a forward / backward key is held, a click only looks
+		this._keyForward = false;
+		this._keyBackward = false;
+		this._pointerForward = false;
+		this._pointerBackward = false;
 		this._moveLeft = false;
 		this._moveRight = false;
+		this._moveUp = false;
+		this._moveDown = false;
 
 		this._lat = 0;
 		this._lon = 0;
 
+		this._lonVelocity = 0;
+		this._latVelocity = 0;
+
 		// event listeners
 
 		this._onPointerMove = onPointerMove.bind( this );
@@ -174,11 +193,15 @@ class FirstPersonControls extends Controls {
 		window.addEventListener( 'keydown', this._onKeyDown );
 		window.addEventListener( 'keyup', this._onKeyUp );
 
-		this.domElement.addEventListener( 'pointermove', this._onPointerMove );
 		this.domElement.addEventListener( 'pointerdown', this._onPointerDown );
-		this.domElement.addEventListener( 'pointerup', this._onPointerUp );
 		this.domElement.addEventListener( 'contextmenu', this._onContextMenu );
 
+		const { ownerDocument } = this.domElement;
+
+		ownerDocument.addEventListener( 'pointermove', this._onPointerMove );
+		ownerDocument.addEventListener( 'pointerup', this._onPointerUp );
+		ownerDocument.addEventListener( 'pointercancel', this._onPointerUp );
+
 		this.domElement.style.touchAction = 'none'; // Disable touch scroll
 
 	}
@@ -188,11 +211,15 @@ class FirstPersonControls extends Controls {
 		window.removeEventListener( 'keydown', this._onKeyDown );
 		window.removeEventListener( 'keyup', this._onKeyUp );
 
-		this.domElement.removeEventListener( 'pointermove', this._onPointerMove );
 		this.domElement.removeEventListener( 'pointerdown', this._onPointerDown );
-		this.domElement.removeEventListener( 'pointerup', this._onPointerUp );
 		this.domElement.removeEventListener( 'contextmenu', this._onContextMenu );
 
+		const { ownerDocument } = this.domElement;
+
+		ownerDocument.removeEventListener( 'pointermove', this._onPointerMove );
+		ownerDocument.removeEventListener( 'pointerup', this._onPointerUp );
+		ownerDocument.removeEventListener( 'pointercancel', this._onPointerUp );
+
 		this.domElement.style.touchAction = ''; // Restore touch scroll
 
 	}
@@ -235,31 +262,35 @@ class FirstPersonControls extends Controls {
 
 		if ( this.enabled === false ) return;
 
-		if ( this.heightSpeed ) {
+		const moveForward = this._keyForward || this._pointerForward;
+		const moveBackward = this._keyBackward || this._pointerBackward;
 
-			const y = MathUtils.clamp( this.object.position.y, this.heightMin, this.heightMax );
-			const heightDelta = y - this.heightMin;
+		const forward = moveForward || ( this.autoForward && ! moveBackward );
 
-			this._autoSpeedFactor = delta * ( heightDelta * this.heightCoef );
+		// target velocity in the object's local space
 
-		} else {
+		_targetVelocity.set(
+			( this._moveRight ? 1 : 0 ) - ( this._moveLeft ? 1 : 0 ),
+			( this._moveUp ? 1 : 0 ) - ( this._moveDown ? 1 : 0 ),
+			( moveBackward ? 1 : 0 ) - ( forward ? 1 : 0 )
+		).multiplyScalar( this.movementSpeed );
 
-			this._autoSpeedFactor = 0.0;
+		// faster forward movement the higher the camera is
 
-		}
+		if ( forward && this.heightSpeed ) {
 
-		const actualMoveSpeed = delta * this.movementSpeed;
+			const y = MathUtils.clamp( this.object.position.y, this.heightMin, this.heightMax );
+			_targetVelocity.z -= ( y - this.heightMin ) * this.heightCoef;
 
-		if ( this._moveForward || ( this.autoForward && ! this._moveBackward ) ) this.object.translateZ( - ( actualMoveSpeed + this._autoSpeedFactor ) );
-		if ( this._moveBackward ) this.object.translateZ( actualMoveSpeed );
+		}
 
-		if ( this._moveLeft ) this.object.translateX( - actualMoveSpeed );
-		if ( this._moveRight ) this.object.translateX( actualMoveSpeed );
+		// ease toward the target velocity for smooth acceleration and deceleration
 
-		if ( this._moveUp ) this.object.translateY( actualMoveSpeed );
-		if ( this._moveDown ) this.object.translateY( - actualMoveSpeed );
+		this._velocity.lerp( _targetVelocity, this.dampingFactor );
 
-		const actualLookSpeed = delta * this.lookSpeed;
+		this.object.translateX( this._velocity.x * delta );
+		this.object.translateY( this._velocity.y * delta );
+		this.object.translateZ( this._velocity.z * delta );
 
 		let verticalLookRatio = 1;
 
@@ -269,12 +300,16 @@ class FirstPersonControls extends Controls {
 
 		}
 
-		if ( this.mouseDragOn ) {
+		// target look velocity, zero when not dragging so the view eases to a stop
 
-			this._lon -= this._pointerX * actualLookSpeed;
-			if ( this.lookVertical ) this._lat -= this._pointerY * actualLookSpeed * verticalLookRatio;
+		const targetLon = this.mouseDragOn ? - this._pointerX * this.lookSpeed : 0;
+		const targetLat = ( this.mouseDragOn && this.lookVertical ) ? - this._pointerY * this.lookSpeed * verticalLookRatio : 0;
 
-		}
+		this._lonVelocity = MathUtils.lerp( this._lonVelocity, targetLon, this.dampingFactor );
+		this._latVelocity = MathUtils.lerp( this._latVelocity, targetLat, this.dampingFactor );
+
+		this._lon += this._lonVelocity * delta;
+		this._lat += this._latVelocity * delta;
 
 		this._lat = Math.max( - 85, Math.min( 85, this._lat ) );
 
@@ -332,15 +367,15 @@ function onPointerDown( event ) {
 
 	if ( event.pointerType === 'touch' ) {
 
-		this._moveForward = this._pointerCount === 1;
-		this._moveBackward = this._pointerCount >= 2;
+		this._pointerForward = this._pointerCount === 1;
+		this._pointerBackward = this._pointerCount >= 2;
 
 	} else {
 
 		switch ( event.button ) {
 
-			case 0: this._moveForward = true; break;
-			case 2: this._moveBackward = true; break;
+			case 0: if ( ! this._keyForward && ! this._keyBackward ) this._pointerForward = true; break;
+			case 2: if ( ! this._keyForward && ! this._keyBackward ) this._pointerBackward = true; break;
 
 		}
 
@@ -358,21 +393,23 @@ function onPointerDown( event ) {
 
 function onPointerUp( event ) {
 
+	if ( this.mouseDragOn === false ) return;
+
 	this.domElement.releasePointerCapture( event.pointerId );
 
 	this._pointerCount --;
 
 	if ( event.pointerType === 'touch' ) {
 
-		this._moveForward = this._pointerCount === 1;
-		this._moveBackward = false;
+		this._pointerForward = this._pointerCount === 1;
+		this._pointerBackward = false;
 
 	} else {
 
 		switch ( event.button ) {
 
-			case 0: this._moveForward = false; break;
-			case 2: this._moveBackward = false; break;
+			case 0: this._pointerForward = false; break;
+			case 2: this._pointerBackward = false; break;
 
 		}
 
@@ -399,19 +436,19 @@ function onKeyDown( event ) {
 	switch ( event.code ) {
 
 		case 'ArrowUp':
-		case 'KeyW': this._moveForward = true; break;
+		case 'KeyW': this._keyForward = true; break;
 
 		case 'ArrowLeft':
 		case 'KeyA': this._moveLeft = true; break;
 
 		case 'ArrowDown':
-		case 'KeyS': this._moveBackward = true; break;
+		case 'KeyS': this._keyBackward = true; break;
 
 		case 'ArrowRight':
 		case 'KeyD': this._moveRight = true; break;
 
-		case 'KeyR': this._moveUp = true; break;
-		case 'KeyF': this._moveDown = true; break;
+		case 'KeyE': this._moveUp = true; break;
+		case 'KeyQ': this._moveDown = true; break;
 
 	}
 
@@ -422,19 +459,19 @@ function onKeyUp( event ) {
 	switch ( event.code ) {
 
 		case 'ArrowUp':
-		case 'KeyW': this._moveForward = false; break;
+		case 'KeyW': this._keyForward = false; break;
 
 		case 'ArrowLeft':
 		case 'KeyA': this._moveLeft = false; break;
 
 		case 'ArrowDown':
-		case 'KeyS': this._moveBackward = false; break;
+		case 'KeyS': this._keyBackward = false; break;
 
 		case 'ArrowRight':
 		case 'KeyD': this._moveRight = false; break;
 
-		case 'KeyR': this._moveUp = false; break;
-		case 'KeyF': this._moveDown = false; break;
+		case 'KeyE': this._moveUp = false; break;
+		case 'KeyQ': this._moveDown = false; break;
 
 	}
 

package/examples/jsm/controls/TransformControls.js

@@ -214,6 +214,17 @@ class TransformControls extends Controls {
 		 */
 		defineProperty( 'size', 1 );
 
+		/**
+		 * The viewport rectangle, in logical (CSS) pixels with the origin at the lower-left
+		 * of the canvas. Set this when the renderer uses a sub-canvas viewport so pointer
+		 * coordinates map to the correct region. If `null`, the full canvas is used.
+		 *
+		 * @name TransformControls#viewport
+		 * @type {?Vector4}
+		 * @default null
+		 */
+		this.viewport = null;
+
 		/**
 		 * Whether dragging is currently performed or not.
 		 *
@@ -278,6 +289,24 @@ class TransformControls extends Controls {
 		 */
 		defineProperty( 'showXZ', true );
 
+		/**
+		 * Whether the xyze rotation helper should be visible or not.
+		 *
+		 * @name TransformControls#showXYZE
+		 * @type {boolean}
+		 * @default true
+		 */
+		defineProperty( 'showXYZE', true );
+
+		/**
+		 * Whether the e rotation helper should be visible or not.
+		 *
+		 * @name TransformControls#showE
+		 * @type {boolean}
+		 * @default true
+		 */
+		defineProperty( 'showE', true );
+
 		/**
 		 * The minimum allowed X position during translation.
 		 *
@@ -567,35 +596,27 @@ class TransformControls extends Controls {
 
 				if ( space === 'world' ) {
 
-					if ( object.parent ) {
-
-						object.position.add( _tempVector.setFromMatrixPosition( object.parent.matrixWorld ) );
-
-					}
+					object.getWorldPosition( _tempVector );
 
 					if ( axis.search( 'X' ) !== - 1 ) {
 
-						object.position.x = Math.round( object.position.x / this.translationSnap ) * this.translationSnap;
+						_tempVector.x = Math.round( _tempVector.x / this.translationSnap ) * this.translationSnap;
 
 					}
 
 					if ( axis.search( 'Y' ) !== - 1 ) {
 
-						object.position.y = Math.round( object.position.y / this.translationSnap ) * this.translationSnap;
+						_tempVector.y = Math.round( _tempVector.y / this.translationSnap ) * this.translationSnap;
 
 					}
 
 					if ( axis.search( 'Z' ) !== - 1 ) {
 
-						object.position.z = Math.round( object.position.z / this.translationSnap ) * this.translationSnap;
+						_tempVector.z = Math.round( _tempVector.z / this.translationSnap ) * this.translationSnap;
 
 					}
 
-					if ( object.parent ) {
-
-						object.position.sub( _tempVector.setFromMatrixPosition( object.parent.matrixWorld ) );
-
-					}
+					object.position.copy( object.parent.worldToLocal( _tempVector ) );
 
 				}
 
@@ -966,10 +987,29 @@ function getPointer( event ) {
 	} else {
 
 		const rect = this.domElement.getBoundingClientRect();
+		const viewport = this.viewport;
+
+		let originX, originY, regionWidth, regionHeight;
+
+		if ( viewport !== null ) {
+
+			originX = viewport.x;
+			originY = rect.height - viewport.y - viewport.w;
+			regionWidth = viewport.z;
+			regionHeight = viewport.w;
+
+		} else {
+
+			originX = 0;
+			originY = 0;
+			regionWidth = rect.width;
+			regionHeight = rect.height;
+
+		}
 
 		return {
-			x: ( event.clientX - rect.left ) / rect.width * 2 - 1,
-			y: - ( event.clientY - rect.top ) / rect.height * 2 + 1,
+			x: ( event.clientX - rect.left - originX ) / regionWidth * 2 - 1,
+			y: - ( event.clientY - rect.top - originY ) / regionHeight * 2 + 1,
 			button: event.button
 		};
 
@@ -1120,6 +1160,15 @@ class TransformControlsRoot extends Object3D {
 
 		}
 
+		// Cancel out the parent's transform so the gizmo stays world-aligned.
+
+		if ( this.parent ) {
+
+			_tempMatrix.copy( this.parent.matrixWorld ).invert();
+			_tempMatrix.decompose( this.position, this.quaternion, this.scale );
+
+		}
+
 		super.updateMatrixWorld( force );
 
 	}
@@ -1816,6 +1865,10 @@ class TransformControlsGizmo extends Object3D {
 			handle.visible = handle.visible && ( handle.name.indexOf( 'YZ' ) === - 1 || this.showYZ );
 			handle.visible = handle.visible && ( handle.name.indexOf( 'XZ' ) === - 1 || this.showXZ );
 
+			// Hide disabled rotation helpers
+			handle.visible = handle.visible && ( handle.name !== 'E' || this.showE );
+			handle.visible = handle.visible && ( handle.name !== 'XYZE' || this.showXYZE );
+
 			// highlight selected axis
 
 			handle.material._color = handle.material._color || handle.material.color.clone();

package/examples/jsm/csm/CSMFrustum.js

@@ -27,6 +27,13 @@ class CSMFrustum {
 		 */
 		this.zNear = data.webGL === true ? - 1 : 0;
 
+		/**
+		 * The zFar value.
+		 *
+		 * @type {number}
+		 */
+		this.zFar = 1;
+
 		/**
 		 * An object representing the vertices of the near and
 		 * far plane in view space.
@@ -54,6 +61,15 @@ class CSMFrustum {
 
 		}
 
+		// In case of reversed depth buffer, zNear and zFar must be 1 and 0
+		// respectively regardless of the coordinate system.
+		if ( data.reversedDepth === true ) {
+
+			this.zNear = 1;
+			this.zFar = 0;
+
+		}
+
 	}
 
 	/**
@@ -66,6 +82,7 @@ class CSMFrustum {
 	setFromProjectionMatrix( projectionMatrix, maxFar ) {
 
 		const zNear = this.zNear;
+		const zFar = this.zFar;
 		const isOrthographic = projectionMatrix.elements[ 2 * 4 + 3 ] === 0;
 
 		inverseProjectionMatrix.copy( projectionMatrix ).invert();
@@ -85,10 +102,10 @@ class CSMFrustum {
 
 		} );
 
-		this.vertices.far[ 0 ].set( 1, 1, 1 );
-		this.vertices.far[ 1 ].set( 1, - 1, 1 );
-		this.vertices.far[ 2 ].set( - 1, - 1, 1 );
-		this.vertices.far[ 3 ].set( - 1, 1, 1 );
+		this.vertices.far[ 0 ].set( 1, 1, zFar );
+		this.vertices.far[ 1 ].set( 1, - 1, zFar );
+		this.vertices.far[ 2 ].set( - 1, - 1, zFar );
+		this.vertices.far[ 3 ].set( - 1, 1, zFar );
 		this.vertices.far.forEach( function ( v ) {
 
 			v.applyMatrix4( inverseProjectionMatrix );
@@ -128,6 +145,9 @@ class CSMFrustum {
 
 		target.length = breaks.length;
 
+		const near = this.vertices.near[ 0 ].z;
+		const far = this.vertices.far[ 0 ].z;
+
 		for ( let i = 0; i < breaks.length; i ++ ) {
 
 			const cascade = target[ i ];
@@ -142,9 +162,11 @@ class CSMFrustum {
 
 			} else {
 
+				const alpha = ( breaks[ i - 1 ] * far - near ) / ( far - near );
+
 				for ( let j = 0; j < 4; j ++ ) {
 
-					cascade.vertices.near[ j ].lerpVectors( this.vertices.near[ j ], this.vertices.far[ j ], breaks[ i - 1 ] );
+					cascade.vertices.near[ j ].lerpVectors( this.vertices.near[ j ], this.vertices.far[ j ], alpha );
 
 				}
 
@@ -160,9 +182,11 @@ class CSMFrustum {
 
 			} else {
 
+				const alpha = ( breaks[ i ] * far - near ) / ( far - near );
+
 				for ( let j = 0; j < 4; j ++ ) {
 
-					cascade.vertices.far[ j ].lerpVectors( this.vertices.near[ j ], this.vertices.far[ j ], breaks[ i ] );
+					cascade.vertices.far[ j ].lerpVectors( this.vertices.near[ j ], this.vertices.far[ j ], alpha );
 
 				}
 
@@ -202,6 +226,7 @@ class CSMFrustum {
  *
  * @typedef {Object} CSMFrustum~Data
  * @property {boolean} [webGL] - Whether this CSM frustum is used with WebGL or WebGPU.
+ * @property {boolean} [reversedDepth] - Whether reversed depth buffer is enabled.
  * @property {Matrix4} [projectionMatrix] - A projection matrix usually of the scene's camera.
  * @property {number} [maxFar] - The maximum far value.
  **/

package/examples/jsm/csm/CSMShadowNode.js

@@ -159,7 +159,10 @@ class CSMShadowNode extends ShadowBaseNode {
 
 		this.camera = camera;
 
-		const data = { webGL: renderer.coordinateSystem === WebGLCoordinateSystem };
+		const data = {
+			webGL: renderer.coordinateSystem === WebGLCoordinateSystem,
+			reversedDepth: renderer.reversedDepthBuffer
+		};
 		this.mainFrustum = new CSMFrustum( data );
 
 		const light = this.light;

package/examples/jsm/effects/AsciiEffect.js

@@ -119,6 +119,19 @@ class AsciiEffect {
 
 		}
 
+		const htmlEscapes = {
+			'&': '&',
+			'<': '&lt;',
+			'>': '&gt;',
+		};
+
+		const reUnescapedHtml = /[&<>]/g;
+
+		function escapeHTML( s ) {
+
+			return s.replace( reUnescapedHtml, ( ch ) => htmlEscapes[ ch ] );
+
+		}
 
 		const strFont = 'courier new, monospace';
 
@@ -141,7 +154,7 @@ class AsciiEffect {
 		let aCharList;
 		if ( charSet ) {
 
-			aCharList = ( charSet ).split( '' );
+			aCharList = ( charSet ).split( '' ).map( escapeHTML );
 
 		} else {
 

package/examples/jsm/exporters/DRACOExporter.js

@@ -15,9 +15,15 @@ import { Color, ColorManagement, SRGBColorSpace } from 'three';
  * inside of a glTF file. A normal glTF file can be converted to a Draco-compressed glTF file
  * using [glTF-Pipeline](https://github.com/AnalyticalGraphicsInc/gltf-pipeline).
  *
+ * The exporter requires the Draco encoder to be loaded as a global script in advance:
+ *
+ * ```html
+ * <script src="https://cdn.jsdelivr.net/gh/google/draco@1.5.7/javascript/draco_encoder.js"></script>
+ * ```
+ *
  * ```js
  * const exporter = new DRACOExporter();
- * const data = exporter.parse( mesh, options );
+ * const data = await exporter.parseAsync( mesh, options );
  * ```
  *
  * @three_import import { DRACOExporter } from 'three/addons/exporters/DRACOExporter.js';
@@ -27,11 +33,12 @@ class DRACOExporter {
 	/**
 	 * Parses the given mesh or point cloud and generates the Draco output.
 	 *
+	 * @async
 	 * @param {(Mesh|Points)} object - The mesh or point cloud to export.
 	 * @param {DRACOExporter~Options} options - The export options.
-	 * @return {Int8Array} The exported Draco.
+	 * @return {Promise<Int8Array>} A Promise that resolves with the exported Draco.
 	 */
-	parse( object, options = {} ) {
+	async parseAsync( object, options = {} ) {
 
 		options = Object.assign( {
 			decodeSpeed: 5,
@@ -43,7 +50,7 @@ class DRACOExporter {
 			exportColor: false,
 		}, options );
 
-		if ( DracoEncoderModule === undefined ) {
+		if ( typeof DracoEncoderModule === 'undefined' ) {
 
 			throw new Error( 'THREE.DRACOExporter: required the draco_encoder to work.' );
 
@@ -51,7 +58,12 @@ class DRACOExporter {
 
 		const geometry = object.geometry;
 
-		const dracoEncoder = DracoEncoderModule();
+		let dracoEncoder = DracoEncoderModule();
+
+		// older encoder builds expose the module synchronously, newer builds return a promise
+
+		if ( dracoEncoder.Encoder === undefined ) dracoEncoder = await dracoEncoder;
+
 		const encoder = new dracoEncoder.Encoder();
 		let builder;
 		let dracoObject;
@@ -146,7 +158,7 @@ class DRACOExporter {
 
 		} else {
 
-			throw new Error( 'DRACOExporter: Unsupported object type.' );
+			throw new Error( 'THREE.DRACOExporter: Unsupported object type.' );
 
 		}
 
@@ -222,6 +234,15 @@ class DRACOExporter {
 
 	}
 
+	/**
+	 * @deprecated Use {@link DRACOExporter#parseAsync} instead.
+	 */
+	parse() {
+
+		throw new Error( 'THREE.DRACOExporter: parse() has been replaced by parseAsync().' );
+
+	}
+
 }
 
 function createVertexColorSRGBArray( attribute ) {