@inweb/viewer-three 26.8.1 → 26.9.0

package/dist/plugins/loaders/GLTFCloudLoader.js

@@ -5,9 +5,12 @@
 })(this, (function (three, viewerThree) { 'use strict';
 
 	/**
-	 * @param {BufferGeometry} geometry
-	 * @param {number} drawMode
-	 * @return {BufferGeometry}
+	 * Returns a new indexed geometry based on `TrianglesDrawMode` draw mode.
+	 * This mode corresponds to the `gl.TRIANGLES` primitive in WebGL.
+	 *
+	 * @param {BufferGeometry} geometry - The geometry to convert.
+	 * @param {number} drawMode - The current draw mode.
+	 * @return {BufferGeometry} The new geometry using `TrianglesDrawMode`.
 	 */
 	function toTrianglesDrawMode( geometry, drawMode ) {
 
@@ -114,8 +117,63 @@
 
 	}
 
+	/**
+	 * A loader for the glTF 2.0 format.
+	 *
+	 * [glTF]{@link https://www.khronos.org/gltf/} (GL Transmission Format) is an [open format specification]{@link https://github.com/KhronosGroup/glTF/tree/main/specification/2.0}
+	 * for efficient delivery and loading of 3D content. Assets may be provided either in JSON (.gltf) or binary (.glb)
+	 * format. External files store textures (.jpg, .png) and additional binary data (.bin). A glTF asset may deliver
+	 * one or more scenes, including meshes, materials, textures, skins, skeletons, morph targets, animations, lights,
+	 * and/or cameras.
+	 *
+	 * `GLTFLoader` uses {@link ImageBitmapLoader} whenever possible. Be advised that image bitmaps are not
+	 * automatically GC-collected when they are no longer referenced, and they require special handling during
+	 * the disposal process.
+	 *
+	 * `GLTFLoader` supports the following glTF 2.0 extensions:
+	 * - KHR_draco_mesh_compression
+	 * - KHR_materials_clearcoat
+	 * - KHR_materials_dispersion
+	 * - KHR_materials_ior
+	 * - KHR_materials_specular
+	 * - KHR_materials_transmission
+	 * - KHR_materials_iridescence
+	 * - KHR_materials_unlit
+	 * - KHR_materials_volume
+	 * - KHR_mesh_quantization
+	 * - KHR_lights_punctual
+	 * - KHR_texture_basisu
+	 * - KHR_texture_transform
+	 * - EXT_texture_webp
+	 * - EXT_meshopt_compression
+	 * - EXT_mesh_gpu_instancing
+	 *
+	 * The following glTF 2.0 extension is supported by an external user plugin:
+	 * - [KHR_materials_variants]{@link https://github.com/takahirox/three-gltf-extensions}
+	 * - [MSFT_texture_dds]{@link https://github.com/takahirox/three-gltf-extensions}
+	 *
+	 * ```js
+	 * const loader = new GLTFLoader();
+	 *
+	 * // Optional: Provide a DRACOLoader instance to decode compressed mesh data
+	 * const dracoLoader = new DRACOLoader();
+	 * dracoLoader.setDecoderPath( '/examples/jsm/libs/draco/' );
+	 * loader.setDRACOLoader( dracoLoader );
+	 *
+	 * const gltf = await loader.loadAsync( 'models/gltf/duck/duck.gltf' );
+	 * scene.add( gltf.scene );
+	 * ```
+	 *
+	 * @augments Loader
+	 * @three_import import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
+	 */
 	class GLTFLoader extends three.Loader {
 
+		/**
+		 * Constructs a new glTF loader.
+		 *
+		 * @param {LoadingManager} [manager] - The loading manager.
+		 */
 		constructor( manager ) {
 
 			super( manager );
@@ -230,6 +288,15 @@
 
 		}
 
+		/**
+		 * Starts loading from the given URL and passes the loaded glTF asset
+		 * to the `onLoad()` callback.
+		 *
+		 * @param {string} url - The path/URL of the file to be loaded. This can also be a data URI.
+		 * @param {function(GLTFLoader~LoadObject)} onLoad - Executed when the loading process has been finished.
+		 * @param {onProgressCallback} onProgress - Executed while the loading is in progress.
+		 * @param {onErrorCallback} onError - Executed when errors occur.
+		 */
 		load( url, onLoad, onProgress, onError ) {
 
 			const scope = this;
@@ -307,6 +374,13 @@
 
 		}
 
+		/**
+		 * Sets the given Draco loader to this loader. Required for decoding assets
+		 * compressed with the `KHR_draco_mesh_compression` extension.
+		 *
+		 * @param {DRACOLoader} dracoLoader - The Draco loader to set.
+		 * @return {GLTFLoader} A reference to this loader.
+		 */
 		setDRACOLoader( dracoLoader ) {
 
 			this.dracoLoader = dracoLoader;
@@ -314,6 +388,13 @@
 
 		}
 
+		/**
+		 * Sets the given KTX2 loader to this loader. Required for loading KTX2
+		 * compressed textures.
+		 *
+		 * @param {KTX2Loader} ktx2Loader - The KTX2 loader to set.
+		 * @return {GLTFLoader} A reference to this loader.
+		 */
 		setKTX2Loader( ktx2Loader ) {
 
 			this.ktx2Loader = ktx2Loader;
@@ -321,6 +402,13 @@
 
 		}
 
+		/**
+		 * Sets the given meshopt decoder. Required for decoding assets
+		 * compressed with the `EXT_meshopt_compression` extension.
+		 *
+		 * @param {Object} meshoptDecoder - The meshopt decoder to set.
+		 * @return {GLTFLoader} A reference to this loader.
+		 */
 		setMeshoptDecoder( meshoptDecoder ) {
 
 			this.meshoptDecoder = meshoptDecoder;
@@ -328,6 +416,14 @@
 
 		}
 
+		/**
+		 * Registers a plugin callback. This API is internally used to implement the various
+		 * glTF extensions but can also used by third-party code to add additional logic
+		 * to the loader.
+		 *
+		 * @param {function(parser:GLTFParser)} callback - The callback function to register.
+		 * @return {GLTFLoader} A reference to this loader.
+		 */
 		register( callback ) {
 
 			if ( this.pluginCallbacks.indexOf( callback ) === -1 ) {
@@ -340,6 +436,12 @@
 
 		}
 
+		/**
+		 * Unregisters a plugin callback.
+		 *
+		 * @param {Function} callback - The callback function to unregister.
+		 * @return {GLTFLoader} A reference to this loader.
+		 */
 		unregister( callback ) {
 
 			if ( this.pluginCallbacks.indexOf( callback ) !== -1 ) {
@@ -352,6 +454,14 @@
 
 		}
 
+		/**
+		 * Parses the given FBX data and returns the resulting group.
+		 *
+		 * @param {string|ArrayBuffer} data - The raw glTF data.
+		 * @param {string} path - The URL base path.
+		 * @param {function(GLTFLoader~LoadObject)} onLoad - Executed when the loading process has been finished.
+		 * @param {onErrorCallback} onError - Executed when errors occur.
+		 */
 		parse( data, path, onLoad, onError ) {
 
 			let json;
@@ -475,6 +585,14 @@
 
 		}
 
+		/**
+		 * Async version of {@link GLTFLoader#parse}.
+		 *
+		 * @async
+		 * @param {string|ArrayBuffer} data - The raw glTF data.
+		 * @param {string} path - The URL base path.
+		 * @return {Promise<GLTFLoader~LoadObject>} A Promise that resolves with the loaded glTF when the parsing has been finished.
+		 */
 		parseAsync( data, path ) {
 
 			const scope = this;
@@ -558,6 +676,8 @@
 	 * Punctual Lights Extension
 	 *
 	 * Specification: https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Khronos/KHR_lights_punctual
+	 *
+	 * @private
 	 */
 	class GLTFLightsExtension {
 
@@ -694,6 +814,8 @@
 	 * Unlit Materials Extension
 	 *
 	 * Specification: https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Khronos/KHR_materials_unlit
+	 *
+	 * @private
 	 */
 	class GLTFMaterialsUnlitExtension {
 
@@ -747,6 +869,8 @@
 	 * Materials Emissive Strength Extension
 	 *
 	 * Specification: https://github.com/KhronosGroup/glTF/blob/5768b3ce0ef32bc39cdf1bef10b948586635ead3/extensions/2.0/Khronos/KHR_materials_emissive_strength/README.md
+	 *
+	 * @private
 	 */
 	class GLTFMaterialsEmissiveStrengthExtension {
 
@@ -786,6 +910,8 @@
 	 * Clearcoat Materials Extension
 	 *
 	 * Specification: https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Khronos/KHR_materials_clearcoat
+	 *
+	 * @private
 	 */
 	class GLTFMaterialsClearcoatExtension {
 
@@ -870,6 +996,8 @@
 	 * Materials dispersion Extension
 	 *
 	 * Specification: https://github.com/KhronosGroup/glTF/tree/main/extensions/2.0/Khronos/KHR_materials_dispersion
+	 *
+	 * @private
 	 */
 	class GLTFMaterialsDispersionExtension {
 
@@ -916,6 +1044,8 @@
 	 * Iridescence Materials Extension
 	 *
 	 * Specification: https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Khronos/KHR_materials_iridescence
+	 *
+	 * @private
 	 */
 	class GLTFMaterialsIridescenceExtension {
 
@@ -1004,6 +1134,8 @@
 	 * Sheen Materials Extension
 	 *
 	 * Specification: https://github.com/KhronosGroup/glTF/tree/main/extensions/2.0/Khronos/KHR_materials_sheen
+	 *
+	 * @private
 	 */
 	class GLTFMaterialsSheenExtension {
 
@@ -1080,6 +1212,8 @@
 	 *
 	 * Specification: https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Khronos/KHR_materials_transmission
 	 * Draft: https://github.com/KhronosGroup/glTF/pull/1698
+	 *
+	 * @private
 	 */
 	class GLTFMaterialsTransmissionExtension {
 
@@ -1138,6 +1272,8 @@
 	 * Materials Volume Extension
 	 *
 	 * Specification: https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Khronos/KHR_materials_volume
+	 *
+	 * @private
 	 */
 	class GLTFMaterialsVolumeExtension {
 
@@ -1197,6 +1333,8 @@
 	 * Materials ior Extension
 	 *
 	 * Specification: https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Khronos/KHR_materials_ior
+	 *
+	 * @private
 	 */
 	class GLTFMaterialsIorExtension {
 
@@ -1243,6 +1381,8 @@
 	 * Materials specular Extension
 	 *
 	 * Specification: https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Khronos/KHR_materials_specular
+	 *
+	 * @private
 	 */
 	class GLTFMaterialsSpecularExtension {
 
@@ -1307,6 +1447,8 @@
 	 * Materials bump Extension
 	 *
 	 * Specification: https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Khronos/EXT_materials_bump
+	 *
+	 * @private
 	 */
 	class GLTFMaterialsBumpExtension {
 
@@ -1361,6 +1503,8 @@
 	 * Materials anisotropy Extension
 	 *
 	 * Specification: https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Khronos/KHR_materials_anisotropy
+	 *
+	 * @private
 	 */
 	class GLTFMaterialsAnisotropyExtension {
 
@@ -1425,6 +1569,8 @@
 	 * BasisU Texture Extension
 	 *
 	 * Specification: https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Khronos/KHR_texture_basisu
+	 *
+	 * @private
 	 */
 	class GLTFTextureBasisUExtension {
 
@@ -1476,6 +1622,8 @@
 	 * WebP Texture Extension
 	 *
 	 * Specification: https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Vendor/EXT_texture_webp
+	 *
+	 * @private
 	 */
 	class GLTFTextureWebPExtension {
 
@@ -1483,7 +1631,6 @@
 
 			this.parser = parser;
 			this.name = EXTENSIONS.EXT_TEXTURE_WEBP;
-			this.isSupported = null;
 
 		}
 
@@ -1512,46 +1659,7 @@
 
 			}
 
-			return this.detectSupport().then( function ( isSupported ) {
-
-				if ( isSupported ) return parser.loadTextureImage( textureIndex, extension.source, loader );
-
-				if ( json.extensionsRequired && json.extensionsRequired.indexOf( name ) >= 0 ) {
-
-					throw new Error( 'THREE.GLTFLoader: WebP required by asset but unsupported.' );
-
-				}
-
-				// Fall back to PNG or JPEG.
-				return parser.loadTexture( textureIndex );
-
-			} );
-
-		}
-
-		detectSupport() {
-
-			if ( ! this.isSupported ) {
-
-				this.isSupported = new Promise( function ( resolve ) {
-
-					const image = new Image();
-
-					// Lossy test image. Support for lossy images doesn't guarantee support for all
-					// WebP images, unfortunately.
-					image.src = 'data:image/webp;base64,UklGRiIAAABXRUJQVlA4IBYAAAAwAQCdASoBAAEADsD+JaQAA3AAAAAA';
-
-					image.onload = image.onerror = function () {
-
-						resolve( image.height === 1 );
-
-					};
-
-				} );
-
-			}
-
-			return this.isSupported;
+			return parser.loadTextureImage( textureIndex, extension.source, loader );
 
 		}
 
@@ -1561,6 +1669,8 @@
 	 * AVIF Texture Extension
 	 *
 	 * Specification: https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Vendor/EXT_texture_avif
+	 *
+	 * @private
 	 */
 	class GLTFTextureAVIFExtension {
 
@@ -1568,7 +1678,6 @@
 
 			this.parser = parser;
 			this.name = EXTENSIONS.EXT_TEXTURE_AVIF;
-			this.isSupported = null;
 
 		}
 
@@ -1597,44 +1706,7 @@
 
 			}
 
-			return this.detectSupport().then( function ( isSupported ) {
-
-				if ( isSupported ) return parser.loadTextureImage( textureIndex, extension.source, loader );
-
-				if ( json.extensionsRequired && json.extensionsRequired.indexOf( name ) >= 0 ) {
-
-					throw new Error( 'THREE.GLTFLoader: AVIF required by asset but unsupported.' );
-
-				}
-
-				// Fall back to PNG or JPEG.
-				return parser.loadTexture( textureIndex );
-
-			} );
-
-		}
-
-		detectSupport() {
-
-			if ( ! this.isSupported ) {
-
-				this.isSupported = new Promise( function ( resolve ) {
-
-					const image = new Image();
-
-					// Lossy test image.
-					image.src = 'data:image/avif;base64,AAAAIGZ0eXBhdmlmAAAAAGF2aWZtaWYxbWlhZk1BMUIAAADybWV0YQAAAAAAAAAoaGRscgAAAAAAAAAAcGljdAAAAAAAAAAAAAAAAGxpYmF2aWYAAAAADnBpdG0AAAAAAAEAAAAeaWxvYwAAAABEAAABAAEAAAABAAABGgAAABcAAAAoaWluZgAAAAAAAQAAABppbmZlAgAAAAABAABhdjAxQ29sb3IAAAAAamlwcnAAAABLaXBjbwAAABRpc3BlAAAAAAAAAAEAAAABAAAAEHBpeGkAAAAAAwgICAAAAAxhdjFDgQAMAAAAABNjb2xybmNseAACAAIABoAAAAAXaXBtYQAAAAAAAAABAAEEAQKDBAAAAB9tZGF0EgAKCBgABogQEDQgMgkQAAAAB8dSLfI=';
-					image.onload = image.onerror = function () {
-
-						resolve( image.height === 1 );
-
-					};
-
-				} );
-
-			}
-
-			return this.isSupported;
+			return parser.loadTextureImage( textureIndex, extension.source, loader );
 
 		}
 
@@ -1644,6 +1716,8 @@
 	 * meshopt BufferView Compression Extension
 	 *
 	 * Specification: https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Vendor/EXT_meshopt_compression
+	 *
+	 * @private
 	 */
 	class GLTFMeshoptCompression {
 
@@ -1729,6 +1803,7 @@
 	 *
 	 * Specification: https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Vendor/EXT_mesh_gpu_instancing
 	 *
+	 * @private
 	 */
 	class GLTFMeshGpuInstancing {
 
@@ -1957,6 +2032,8 @@
 	 * DRACO Mesh Compression Extension
 	 *
 	 * Specification: https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Khronos/KHR_draco_mesh_compression
+	 *
+	 * @private
 	 */
 	class GLTFDracoMeshCompressionExtension {
 
@@ -2040,6 +2117,8 @@
 	 * Texture Transform Extension
 	 *
 	 * Specification: https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Khronos/KHR_texture_transform
+	 *
+	 * @private
 	 */
 	class GLTFTextureTransformExtension {
 
@@ -2099,6 +2178,8 @@
 	 * Mesh Quantization Extension
 	 *
 	 * Specification: https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Khronos/KHR_mesh_quantization
+	 *
+	 * @private
 	 */
 	class GLTFMeshQuantizationExtension {
 
@@ -2186,7 +2267,7 @@
 
 	}
 
-	const _q = new three.Quaternion();
+	const _quaternion = new three.Quaternion();
 
 	class GLTFCubicSplineQuaternionInterpolant extends GLTFCubicSplineInterpolant {
 
@@ -2194,7 +2275,7 @@
 
 			const result = super.interpolate_( i1, t0, t, t1 );
 
-			_q.fromArray( result ).normalize().toArray( result );
+			_quaternion.fromArray( result ).normalize().toArray( result );
 
 			return result;
 
@@ -2288,7 +2369,8 @@
 	/**
 	 * Specification: https://github.com/KhronosGroup/glTF/blob/master/specification/2.0/README.md#default-material
 	 *
-	 * @param {Object<String, Material>} cache
+	 * @private
+	 * @param {Object<string, Material>} cache
 	 * @return {Material}
 	 */
 	function createDefaultMaterial( cache ) {
@@ -2329,7 +2411,9 @@
 	}
 
 	/**
-	 * @param {Object3D|Material|BufferGeometry} object
+	 *
+	 * @private
+	 * @param {Object3D|Material|BufferGeometry|Object} object
 	 * @param {GLTF.definition} gltfDef
 	 */
 	function assignExtrasToUserData( object, gltfDef ) {
@@ -2353,6 +2437,7 @@
 	/**
 	 * Specification: https://github.com/KhronosGroup/glTF/blob/master/specification/2.0/README.md#morph-targets
 	 *
+	 * @private
 	 * @param {BufferGeometry} geometry
 	 * @param {Array<GLTF.Target>} targets
 	 * @param {GLTFParser} parser
@@ -2440,6 +2525,8 @@
 	}
 
 	/**
+	 *
+	 * @private
 	 * @param {Mesh} mesh
 	 * @param {GLTF.Mesh} meshDef
 	 */
@@ -2728,6 +2815,8 @@
 
 		/**
 		 * Marks the special nodes/meshes in json for efficient parse.
+		 *
+		 * @private
 		 */
 		_markDefs() {
 
@@ -2789,6 +2878,7 @@
 		 *
 		 * Example: CesiumMilkTruck sample model reuses "Wheel" meshes.
 		 *
+		 * @private
 		 * @param {Object} cache
 		 * @param {Object3D} index
 		 */
@@ -2809,8 +2899,9 @@
 		/**
 		 * Returns a reference to a shared resource, cloning it if necessary.
 		 *
+		 * @private
 		 * @param {Object} cache
-		 * @param {Number} index
+		 * @param {number} index
 		 * @param {Object} object
 		 * @return {Object}
 		 */
@@ -2885,6 +2976,8 @@
 
 		/**
 		 * Requests the specified dependency asynchronously, with caching.
+		 *
+		 * @private
 		 * @param {string} type
 		 * @param {number} index
 		 * @return {Promise<Object3D|Material|THREE.Texture|AnimationClip|ArrayBuffer|Object>}
@@ -2993,6 +3086,8 @@
 
 		/**
 		 * Requests all dependencies of the specified type asynchronously, with caching.
+		 *
+		 * @private
 		 * @param {string} type
 		 * @return {Promise<Array<Object>>}
 		 */
@@ -3021,6 +3116,8 @@
 
 		/**
 		 * Specification: https://github.com/KhronosGroup/glTF/blob/master/specification/2.0/README.md#buffers-and-buffer-views
+		 *
+		 * @private
 		 * @param {number} bufferIndex
 		 * @return {Promise<ArrayBuffer>}
 		 */
@@ -3058,6 +3155,8 @@
 
 		/**
 		 * Specification: https://github.com/KhronosGroup/glTF/blob/master/specification/2.0/README.md#buffers-and-buffer-views
+		 *
+		 * @private
 		 * @param {number} bufferViewIndex
 		 * @return {Promise<ArrayBuffer>}
 		 */
@@ -3077,6 +3176,8 @@
 
 		/**
 		 * Specification: https://github.com/KhronosGroup/glTF/blob/master/specification/2.0/README.md#accessors
+		 *
+		 * @private
 		 * @param {number} accessorIndex
 		 * @return {Promise<BufferAttribute|InterleavedBufferAttribute>}
 		 */
@@ -3216,6 +3317,8 @@
 
 		/**
 		 * Specification: https://github.com/KhronosGroup/glTF/tree/master/specification/2.0#textures
+		 *
+		 * @private
 		 * @param {number} textureIndex
 		 * @return {Promise<THREE.Texture|null>}
 		 */
@@ -3386,10 +3489,11 @@
 		/**
 		 * Asynchronously assigns a texture to the given material parameters.
 		 *
+		 * @private
 		 * @param {Object} materialParams
 		 * @param {string} mapName
 		 * @param {Object} mapDef
-		 * @param {string} colorSpace
+		 * @param {string} [colorSpace]
 		 * @return {Promise<Texture>}
 		 */
 		assignTexture( materialParams, mapName, mapDef, colorSpace ) {
@@ -3441,7 +3545,9 @@
 		 * but reuse of the same glTF material may require multiple threejs materials
 		 * to accommodate different primitive types, defines, etc. New materials will
 		 * be created if necessary, and reused from a cache.
-		 * @param  {Object3D} mesh Mesh, Line, or Points instance.
+		 *
+		 * @private
+		 * @param {Object3D} mesh Mesh, Line, or Points instance.
 		 */
 		assignFinalMaterial( mesh ) {
 
@@ -3541,6 +3647,8 @@
 
 		/**
 		 * Specification: https://github.com/KhronosGroup/glTF/blob/master/specification/2.0/README.md#materials
+		 *
+		 * @private
 		 * @param {number} materialIndex
 		 * @return {Promise<Material>}
 		 */
@@ -3701,8 +3809,9 @@
 		/**
 		 * When Object3D instances are targeted by animation, they need unique names.
 		 *
-		 * @param {String} originalName
-		 * @return {String}
+		 * @private
+		 * @param {string} originalName
+		 * @return {string}
 		 */
 		createUniqueName( originalName ) {
 
@@ -3727,6 +3836,7 @@
 		 *
 		 * Creates BufferGeometries from primitives.
 		 *
+		 * @private
 		 * @param {Array<GLTF.Primitive>} primitives
 		 * @return {Promise<Array<BufferGeometry>>}
 		 */
@@ -3794,8 +3904,10 @@
 
 		/**
 		 * Specification: https://github.com/KhronosGroup/glTF/blob/master/specification/2.0/README.md#meshes
+		 *
+		 * @private
 		 * @param {number} meshIndex
-		 * @return {Promise<Group|Mesh|SkinnedMesh>}
+		 * @return {Promise<Group|Mesh|SkinnedMesh|Line|Points>}
 		 */
 		loadMesh( meshIndex ) {
 
@@ -3942,6 +4054,8 @@
 
 		/**
 		 * Specification: https://github.com/KhronosGroup/glTF/tree/master/specification/2.0#cameras
+		 *
+		 * @private
 		 * @param {number} cameraIndex
 		 * @return {Promise<THREE.Camera>}
 		 */
@@ -3978,6 +4092,8 @@
 
 		/**
 		 * Specification: https://github.com/KhronosGroup/glTF/tree/master/specification/2.0#skins
+		 *
+		 * @private
 		 * @param {number} skinIndex
 		 * @return {Promise<Skeleton>}
 		 */
@@ -4048,6 +4164,8 @@
 
 		/**
 		 * Specification: https://github.com/KhronosGroup/glTF/tree/master/specification/2.0#animations
+		 *
+		 * @private
 		 * @param {number} animationIndex
 		 * @return {Promise<AnimationClip>}
 		 */
@@ -4175,6 +4293,8 @@
 
 		/**
 		 * Specification: https://github.com/KhronosGroup/glTF/tree/master/specification/2.0#nodes-and-hierarchy
+		 *
+		 * @private
 		 * @param {number} nodeIndex
 		 * @return {Promise<Object3D>}
 		 */
@@ -4368,6 +4488,11 @@
 
 					parser.associations.set( node, {} );
 
+				} else if ( nodeDef.mesh !== undefined && parser.meshCache.refs[ nodeDef.mesh ] > 1 ) {
+
+					const mapping = parser.associations.get( node );
+					parser.associations.set( node, { ...mapping } );
+
 				}
 
 				parser.associations.get( node ).nodes = nodeIndex;
@@ -4382,6 +4507,8 @@
 
 		/**
 		 * Specification: https://github.com/KhronosGroup/glTF/tree/master/specification/2.0#scenes
+		 *
+		 * @private
 		 * @param {number} sceneIndex
 		 * @return {Promise<Group>}
 		 */
@@ -4497,7 +4624,7 @@
 					TypedKeyframeTrack = three.QuaternionKeyframeTrack;
 					break;
 
-				case PATH_PROPERTIES.position:
+				case PATH_PROPERTIES.translation:
 				case PATH_PROPERTIES.scale:
 
 					TypedKeyframeTrack = three.VectorKeyframeTrack;
@@ -4596,6 +4723,8 @@
 	}
 
 	/**
+	 *
+	 * @private
 	 * @param {BufferGeometry} geometry
 	 * @param {GLTF.Primitive} primitiveDef
 	 * @param {GLTFParser} parser
@@ -4711,6 +4840,8 @@
 	}
 
 	/**
+	 *
+	 * @private
 	 * @param {BufferGeometry} geometry
 	 * @param {GLTF.Primitive} primitiveDef
 	 * @param {GLTFParser} parser