three-stdlib 2.15.2 → 2.16.1

package/exporters/GLTFExporter.js

@@ -1,64 +1,93 @@
-"use strict";
-Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
-const THREE = require("three");
+import _defineProperty from '@babel/runtime/helpers/esm/defineProperty';
+import { PropertyBinding, InterpolateLinear, Vector3, RGBAFormat, ShaderMaterial, MeshStandardMaterial, MeshBasicMaterial, MeshPhysicalMaterial, MeshMatcapMaterial, MeshNormalMaterial, MeshPhongMaterial, MeshToonMaterial, MeshLambertMaterial, DoubleSide, LineSegments, LineLoop, Line, Points, MeshDepthMaterial, InterleavedBufferAttribute, BufferAttribute, Object3D, Material, OrthographicCamera, PerspectiveCamera, MathUtils, InterpolateDiscrete, SkinnedMesh, Matrix4, Mesh, Camera, Scene, DirectionalLight, PointLight, SpotLight, NearestFilter, NearestMipmapNearestFilter, NearestMipmapLinearFilter, LinearFilter, LinearMipmapNearestFilter, LinearMipmapLinearFilter, ClampToEdgeWrapping, RepeatWrapping, MirroredRepeatWrapping } from 'three';
+
 class GLTFExporter {
   constructor() {
+    _defineProperty(this, "pluginCallbacks", void 0);
+
     this.pluginCallbacks = [];
-    this.register(function(writer) {
+    this.register(function (writer) {
       return new GLTFLightExtension(writer);
     });
-    this.register(function(writer) {
+    this.register(function (writer) {
       return new GLTFMaterialsUnlitExtension(writer);
     });
-    this.register(function(writer) {
+    this.register(function (writer) {
       return new GLTFMaterialsPBRSpecularGlossiness(writer);
     });
-    this.register(function(writer) {
+    this.register(function (writer) {
       return new GLTFMaterialsTransmissionExtension(writer);
     });
-    this.register(function(writer) {
+    this.register(function (writer) {
       return new GLTFMaterialsVolumeExtension(writer);
     });
   }
+
   register(callback) {
     if (this.pluginCallbacks.indexOf(callback) === -1) {
       this.pluginCallbacks.push(callback);
     }
+
     return this;
   }
+
   unregister(callback) {
     if (this.pluginCallbacks.indexOf(callback) !== -1) {
       this.pluginCallbacks.splice(this.pluginCallbacks.indexOf(callback), 1);
     }
+
     return this;
   }
+
   parse(input, onDone, options) {
     const writer = new GLTFWriter();
     const plugins = [];
+
     for (let i = 0, il = this.pluginCallbacks.length; i < il; i++) {
       plugins.push(this.pluginCallbacks[i](writer));
     }
+
     writer.setPlugins(plugins);
     writer.write(input, onDone, options);
   }
-}
-GLTFExporter.Utils = {
-  insertKeyframe: function(track, time) {
-    const tolerance = 1e-3;
-    const valueSize = track.getValueSize();
-    const times = new track.TimeBufferType(track.times.length + 1);
+  /**
+   * Static utility functions
+   */
+
+
+} //------------------------------------------------------------------------------
+// Constants
+//------------------------------------------------------------------------------
+
+
+_defineProperty(GLTFExporter, "Utils", {
+  insertKeyframe: function (track, time) {
+    const tolerance = 0.001; // 1ms
+
+    const valueSize = track.getValueSize(); // @ts-expect-error
+
+    const times = new track.TimeBufferType(track.times.length + 1); // @ts-expect-error
+
     const values = new track.ValueBufferType(track.values.length + valueSize);
+    /**
+     * NOTE: createInterpolant does not exist in the type, but it does exist as a property of the class
+     * https://github.com/mrdoob/three.js/blob/77480d339d737b7505b335101ffd3cf29a30738d/src/animation/KeyframeTrack.js#L117
+     */
+    // @ts-expect-error
+
     const interpolant = track.createInterpolant(new track.ValueBufferType(valueSize));
     let index;
+
     if (track.times.length === 0) {
       times[0] = time;
+
       for (let i = 0; i < valueSize; i++) {
         values[i] = 0;
       }
+
       index = 0;
     } else if (time < track.times[0]) {
-      if (Math.abs(track.times[0] - time) < tolerance)
-        return 0;
+      if (Math.abs(track.times[0] - time) < tolerance) return 0;
       times[0] = time;
       times.set(track.times, 1);
       values.set(interpolant.evaluate(time), 0);
@@ -68,6 +97,7 @@ GLTFExporter.Utils = {
       if (Math.abs(track.times[track.times.length - 1] - time) < tolerance) {
         return track.times.length - 1;
       }
+
       times[times.length - 1] = time;
       times.set(track.times, 0);
       values.set(track.values, 0);
@@ -75,8 +105,8 @@ GLTFExporter.Utils = {
       index = times.length - 1;
     } else {
       for (let i = 0; i < track.times.length; i++) {
-        if (Math.abs(track.times[i] - time) < tolerance)
-          return i;
+        if (Math.abs(track.times[i] - time) < tolerance) return i;
+
         if (track.times[i] < time && track.times[i + 1] > time) {
           times.set(track.times.slice(0, i + 1), 0);
           times[i + 1] = time;
@@ -89,183 +119,264 @@ GLTFExporter.Utils = {
         }
       }
     }
+
     track.times = times;
     track.values = values;
     return index;
   },
-  mergeMorphTargetTracks: function(clip, root) {
+  mergeMorphTargetTracks: function (clip, root) {
     const tracks = [];
     const mergedTracks = {};
     const sourceTracks = clip.tracks;
+
     for (let i = 0; i < sourceTracks.length; ++i) {
       let sourceTrack = sourceTracks[i];
-      const sourceTrackBinding = THREE.PropertyBinding.parseTrackName(sourceTrack.name);
-      const sourceTrackNode = THREE.PropertyBinding.findNode(root, sourceTrackBinding.nodeName);
-      if (sourceTrackBinding.propertyName !== "morphTargetInfluences" || sourceTrackBinding.propertyIndex === void 0) {
+      const sourceTrackBinding = PropertyBinding.parseTrackName(sourceTrack.name);
+      const sourceTrackNode = PropertyBinding.findNode(root, sourceTrackBinding.nodeName);
+
+      if (sourceTrackBinding.propertyName !== 'morphTargetInfluences' || sourceTrackBinding.propertyIndex === undefined) {
+        // Tracks that don't affect morph targets, or that affect all morph targets together, can be left as-is.
         tracks.push(sourceTrack);
         continue;
       }
-      if (sourceTrack.createInterpolant !== sourceTrack.InterpolantFactoryMethodDiscrete && sourceTrack.createInterpolant !== sourceTrack.InterpolantFactoryMethodLinear) {
+
+      if ( // @ts-expect-error
+      sourceTrack.createInterpolant !== sourceTrack.InterpolantFactoryMethodDiscrete && // @ts-expect-error
+      sourceTrack.createInterpolant !== sourceTrack.InterpolantFactoryMethodLinear) {
+        // @ts-expect-error
         if (sourceTrack.createInterpolant.isInterpolantFactoryMethodGLTFCubicSpline) {
-          throw new Error("THREE.GLTFExporter: Cannot merge tracks with glTF CUBICSPLINE interpolation.");
+          // This should never happen, because glTF morph target animations
+          // affect all targets already.
+          throw new Error('THREE.GLTFExporter: Cannot merge tracks with glTF CUBICSPLINE interpolation.');
         }
-        console.warn("THREE.GLTFExporter: Morph target interpolation mode not yet supported. Using LINEAR instead.");
+
+        console.warn('THREE.GLTFExporter: Morph target interpolation mode not yet supported. Using LINEAR instead.');
         sourceTrack = sourceTrack.clone();
-        sourceTrack.setInterpolation(THREE.InterpolateLinear);
+        sourceTrack.setInterpolation(InterpolateLinear);
       }
+
       const targetCount = sourceTrackNode.morphTargetInfluences.length;
       const targetIndex = sourceTrackNode.morphTargetDictionary[sourceTrackBinding.propertyIndex];
-      if (targetIndex === void 0) {
-        throw new Error("THREE.GLTFExporter: Morph target name not found: " + sourceTrackBinding.propertyIndex);
+
+      if (targetIndex === undefined) {
+        throw new Error('THREE.GLTFExporter: Morph target name not found: ' + sourceTrackBinding.propertyIndex);
       }
-      let mergedTrack;
-      if (mergedTracks[sourceTrackNode.uuid] === void 0) {
-        mergedTrack = sourceTrack.clone();
+
+      let mergedTrack; // If this is the first time we've seen this object, create a new
+      // track to store merged keyframe data for each morph target.
+
+      if (mergedTracks[sourceTrackNode.uuid] === undefined) {
+        mergedTrack = sourceTrack.clone(); // @ts-expect-error
+
         const values = new mergedTrack.ValueBufferType(targetCount * mergedTrack.times.length);
+
         for (let j = 0; j < mergedTrack.times.length; j++) {
           values[j * targetCount + targetIndex] = mergedTrack.values[j];
-        }
-        mergedTrack.name = (sourceTrackBinding.nodeName || "") + ".morphTargetInfluences";
+        } // We need to take into consideration the intended target node
+        // of our original un-merged morphTarget animation.
+
+
+        mergedTrack.name = (sourceTrackBinding.nodeName || '') + '.morphTargetInfluences';
         mergedTrack.values = values;
         mergedTracks[sourceTrackNode.uuid] = mergedTrack;
         tracks.push(mergedTrack);
         continue;
-      }
+      } // @ts-expect-error
+
+
       const sourceInterpolant = sourceTrack.createInterpolant(new sourceTrack.ValueBufferType(1));
-      mergedTrack = mergedTracks[sourceTrackNode.uuid];
+      mergedTrack = mergedTracks[sourceTrackNode.uuid]; // For every existing keyframe of the merged track, write a (possibly
+      // interpolated) value from the source track.
+
       for (let j = 0; j < mergedTrack.times.length; j++) {
         mergedTrack.values[j * targetCount + targetIndex] = sourceInterpolant.evaluate(mergedTrack.times[j]);
-      }
+      } // For every existing keyframe of the source track, write a (possibly
+      // new) keyframe to the merged track. Values from the previous loop may
+      // be written again, but keyframes are de-duplicated.
+
+
       for (let j = 0; j < sourceTrack.times.length; j++) {
         const keyframeIndex = this.insertKeyframe(mergedTrack, sourceTrack.times[j]);
         mergedTrack.values[keyframeIndex * targetCount + targetIndex] = sourceTrack.values[j];
       }
     }
+
     clip.tracks = tracks;
     return clip;
   }
-};
+});
+
 const WEBGL_CONSTANTS = {
-  POINTS: 0,
-  LINES: 1,
-  LINE_LOOP: 2,
-  LINE_STRIP: 3,
-  TRIANGLES: 4,
-  TRIANGLE_STRIP: 5,
-  TRIANGLE_FAN: 6,
-  UNSIGNED_BYTE: 5121,
-  UNSIGNED_SHORT: 5123,
-  FLOAT: 5126,
-  UNSIGNED_INT: 5125,
-  ARRAY_BUFFER: 34962,
-  ELEMENT_ARRAY_BUFFER: 34963,
-  NEAREST: 9728,
-  LINEAR: 9729,
-  NEAREST_MIPMAP_NEAREST: 9984,
-  LINEAR_MIPMAP_NEAREST: 9985,
-  NEAREST_MIPMAP_LINEAR: 9986,
-  LINEAR_MIPMAP_LINEAR: 9987,
+  POINTS: 0x0000,
+  LINES: 0x0001,
+  LINE_LOOP: 0x0002,
+  LINE_STRIP: 0x0003,
+  TRIANGLES: 0x0004,
+  TRIANGLE_STRIP: 0x0005,
+  TRIANGLE_FAN: 0x0006,
+  UNSIGNED_BYTE: 0x1401,
+  UNSIGNED_SHORT: 0x1403,
+  FLOAT: 0x1406,
+  UNSIGNED_INT: 0x1405,
+  ARRAY_BUFFER: 0x8892,
+  ELEMENT_ARRAY_BUFFER: 0x8893,
+  NEAREST: 0x2600,
+  LINEAR: 0x2601,
+  NEAREST_MIPMAP_NEAREST: 0x2700,
+  LINEAR_MIPMAP_NEAREST: 0x2701,
+  NEAREST_MIPMAP_LINEAR: 0x2702,
+  LINEAR_MIPMAP_LINEAR: 0x2703,
   CLAMP_TO_EDGE: 33071,
   MIRRORED_REPEAT: 33648,
   REPEAT: 10497
 };
 const THREE_TO_WEBGL = {};
-THREE_TO_WEBGL[THREE.NearestFilter] = WEBGL_CONSTANTS.NEAREST;
-THREE_TO_WEBGL[THREE.NearestMipmapNearestFilter] = WEBGL_CONSTANTS.NEAREST_MIPMAP_NEAREST;
-THREE_TO_WEBGL[THREE.NearestMipmapLinearFilter] = WEBGL_CONSTANTS.NEAREST_MIPMAP_LINEAR;
-THREE_TO_WEBGL[THREE.LinearFilter] = WEBGL_CONSTANTS.LINEAR;
-THREE_TO_WEBGL[THREE.LinearMipmapNearestFilter] = WEBGL_CONSTANTS.LINEAR_MIPMAP_NEAREST;
-THREE_TO_WEBGL[THREE.LinearMipmapLinearFilter] = WEBGL_CONSTANTS.LINEAR_MIPMAP_LINEAR;
-THREE_TO_WEBGL[THREE.ClampToEdgeWrapping] = WEBGL_CONSTANTS.CLAMP_TO_EDGE;
-THREE_TO_WEBGL[THREE.RepeatWrapping] = WEBGL_CONSTANTS.REPEAT;
-THREE_TO_WEBGL[THREE.MirroredRepeatWrapping] = WEBGL_CONSTANTS.MIRRORED_REPEAT;
+THREE_TO_WEBGL[NearestFilter] = WEBGL_CONSTANTS.NEAREST;
+THREE_TO_WEBGL[NearestMipmapNearestFilter] = WEBGL_CONSTANTS.NEAREST_MIPMAP_NEAREST;
+THREE_TO_WEBGL[NearestMipmapLinearFilter] = WEBGL_CONSTANTS.NEAREST_MIPMAP_LINEAR;
+THREE_TO_WEBGL[LinearFilter] = WEBGL_CONSTANTS.LINEAR;
+THREE_TO_WEBGL[LinearMipmapNearestFilter] = WEBGL_CONSTANTS.LINEAR_MIPMAP_NEAREST;
+THREE_TO_WEBGL[LinearMipmapLinearFilter] = WEBGL_CONSTANTS.LINEAR_MIPMAP_LINEAR;
+THREE_TO_WEBGL[ClampToEdgeWrapping] = WEBGL_CONSTANTS.CLAMP_TO_EDGE;
+THREE_TO_WEBGL[RepeatWrapping] = WEBGL_CONSTANTS.REPEAT;
+THREE_TO_WEBGL[MirroredRepeatWrapping] = WEBGL_CONSTANTS.MIRRORED_REPEAT;
 const PATH_PROPERTIES = {
-  scale: "scale",
-  position: "translation",
-  quaternion: "rotation",
-  morphTargetInfluences: "weights"
-};
+  scale: 'scale',
+  position: 'translation',
+  quaternion: 'rotation',
+  morphTargetInfluences: 'weights'
+}; // GLB constants
+// https://github.com/KhronosGroup/glTF/blob/master/specification/2.0/README.md#glb-file-format-specification
+
 const GLB_HEADER_BYTES = 12;
-const GLB_HEADER_MAGIC = 1179937895;
+const GLB_HEADER_MAGIC = 0x46546c67;
 const GLB_VERSION = 2;
 const GLB_CHUNK_PREFIX_BYTES = 8;
-const GLB_CHUNK_TYPE_JSON = 1313821514;
-const GLB_CHUNK_TYPE_BIN = 5130562;
+const GLB_CHUNK_TYPE_JSON = 0x4e4f534a;
+const GLB_CHUNK_TYPE_BIN = 0x004e4942;
+/**
+ * Writer
+ */
+
 class GLTFWriter {
   constructor() {
+    _defineProperty(this, "plugins", void 0);
+
+    _defineProperty(this, "options", void 0);
+
+    _defineProperty(this, "pending", void 0);
+
+    _defineProperty(this, "buffers", void 0);
+
+    _defineProperty(this, "byteOffset", void 0);
+
+    _defineProperty(this, "nodeMap", void 0);
+
+    _defineProperty(this, "skins", void 0);
+
+    _defineProperty(this, "extensionsUsed", void 0);
+
+    _defineProperty(this, "uids", void 0);
+
+    _defineProperty(this, "uid", void 0);
+
+    _defineProperty(this, "json", void 0);
+
+    _defineProperty(this, "cache", void 0);
+
+    _defineProperty(this, "cachedCanvas", void 0);
+
     this.plugins = [];
     this.options = {};
     this.pending = [];
     this.buffers = [];
     this.byteOffset = 0;
-    this.nodeMap = /* @__PURE__ */ new Map();
+    this.nodeMap = new Map();
     this.skins = [];
     this.extensionsUsed = {};
-    this.uids = /* @__PURE__ */ new Map();
+    this.uids = new Map();
     this.uid = 0;
     this.json = {
       asset: {
-        version: "2.0",
-        generator: "THREE.GLTFExporter"
+        version: '2.0',
+        generator: 'THREE.GLTFExporter'
       }
     };
     this.cache = {
-      meshes: /* @__PURE__ */ new Map(),
-      attributes: /* @__PURE__ */ new Map(),
-      attributesNormalized: /* @__PURE__ */ new Map(),
-      materials: /* @__PURE__ */ new Map(),
-      textures: /* @__PURE__ */ new Map(),
-      images: /* @__PURE__ */ new Map()
+      meshes: new Map(),
+      attributes: new Map(),
+      attributesNormalized: new Map(),
+      materials: new Map(),
+      textures: new Map(),
+      images: new Map()
     };
     this.cachedCanvas = null;
   }
+
   setPlugins(plugins) {
     this.plugins = plugins;
   }
+  /**
+   * Parse scenes and generate GLTF output
+   * @param  {Scene or [THREE.Scenes]} input   Scene or Array of THREE.Scenes
+   * @param  {Function} onDone  Callback on completed
+   * @param  {Object} options options
+   */
+
+
   write(input, onDone, options) {
-    this.options = Object.assign(
-      {},
-      {
-        binary: false,
-        trs: false,
-        onlyVisible: true,
-        truncateDrawRange: true,
-        embedImages: true,
-        maxTextureSize: Infinity,
-        animations: [],
-        includeCustomExtensions: false
-      },
-      options
-    );
-    if (this.options.animations !== void 0 && this.options.animations.length > 0) {
+    this.options = Object.assign({}, {
+      // default options
+      binary: false,
+      trs: false,
+      onlyVisible: true,
+      truncateDrawRange: true,
+      embedImages: true,
+      maxTextureSize: Infinity,
+      animations: [],
+      includeCustomExtensions: false
+    }, options);
+
+    if (this.options.animations !== undefined && this.options.animations.length > 0) {
+      // Only TRS properties, and not matrices, may be targeted by animation.
       this.options.trs = true;
     }
+
     this.processInput(input);
     const writer = this;
     Promise.all(this.pending).then(() => {
       const buffers = writer.buffers;
       const json = writer.json;
-      const options2 = writer.options;
-      const extensionsUsed = writer.extensionsUsed;
-      const blob = new Blob(buffers, { type: "application/octet-stream" });
+      const options = writer.options;
+      const extensionsUsed = writer.extensionsUsed; // Merge buffers.
+
+      const blob = new Blob(buffers, {
+        type: 'application/octet-stream'
+      }); // Declare extensions.
+
       const extensionsUsedList = Object.keys(extensionsUsed);
-      if (extensionsUsedList.length > 0)
-        json.extensionsUsed = extensionsUsedList;
-      if (json.buffers && json.buffers.length > 0)
-        json.buffers[0].byteLength = blob.size;
-      if (options2.binary) {
+      if (extensionsUsedList.length > 0) json.extensionsUsed = extensionsUsedList; // Update bytelength of the single buffer.
+
+      if (json.buffers && json.buffers.length > 0) json.buffers[0].byteLength = blob.size;
+
+      if (options.binary) {
+        // https://github.com/KhronosGroup/glTF/blob/master/specification/2.0/README.md#glb-file-format-specification
         const reader = new window.FileReader();
         reader.readAsArrayBuffer(blob);
+
         reader.onloadend = () => {
-          if (reader.result !== null && typeof reader.result !== "string") {
+          if (reader.result !== null && typeof reader.result !== 'string') {
+            // Binary chunk.
             const binaryChunk = this.getPaddedArrayBuffer(reader.result);
             const binaryChunkPrefix = new DataView(new ArrayBuffer(GLB_CHUNK_PREFIX_BYTES));
             binaryChunkPrefix.setUint32(0, binaryChunk.byteLength, true);
-            binaryChunkPrefix.setUint32(4, GLB_CHUNK_TYPE_BIN, true);
-            const jsonChunk = this.getPaddedArrayBuffer(this.stringToArrayBuffer(JSON.stringify(json)), 32);
+            binaryChunkPrefix.setUint32(4, GLB_CHUNK_TYPE_BIN, true); // JSON chunk.
+
+            const jsonChunk = this.getPaddedArrayBuffer(this.stringToArrayBuffer(JSON.stringify(json)), 0x20);
             const jsonChunkPrefix = new DataView(new ArrayBuffer(GLB_CHUNK_PREFIX_BYTES));
             jsonChunkPrefix.setUint32(0, jsonChunk.byteLength, true);
-            jsonChunkPrefix.setUint32(4, GLB_CHUNK_TYPE_JSON, true);
+            jsonChunkPrefix.setUint32(4, GLB_CHUNK_TYPE_JSON, true); // GLB header.
+
             const header = new ArrayBuffer(GLB_HEADER_BYTES);
             const headerView = new DataView(header);
             headerView.setUint32(0, GLB_HEADER_MAGIC, true);
@@ -273,12 +384,13 @@ class GLTFWriter {
             const totalByteLength = GLB_HEADER_BYTES + jsonChunkPrefix.byteLength + jsonChunk.byteLength + binaryChunkPrefix.byteLength + binaryChunk.byteLength;
             headerView.setUint32(8, totalByteLength, true);
             const glbBlob = new Blob([header, jsonChunkPrefix, jsonChunk, binaryChunkPrefix, binaryChunk], {
-              type: "application/octet-stream"
+              type: 'application/octet-stream'
             });
             const glbReader = new window.FileReader();
             glbReader.readAsArrayBuffer(glbBlob);
-            glbReader.onloadend = function() {
-              if (glbReader.result !== null && typeof glbReader.result !== "string") {
+
+            glbReader.onloadend = function () {
+              if (glbReader.result !== null && typeof glbReader.result !== 'string') {
                 onDone(glbReader.result);
               }
             };
@@ -288,9 +400,11 @@ class GLTFWriter {
         if (json.buffers && json.buffers.length > 0) {
           const reader = new window.FileReader();
           reader.readAsDataURL(blob);
-          reader.onloadend = function() {
+
+          reader.onloadend = function () {
             const base64data = reader.result;
-            if (json.buffers !== void 0 && base64data !== null) {
+
+            if (json.buffers !== undefined && base64data !== null) {
               json.buffers[0].uri = base64data;
               onDone(json);
             }
@@ -301,100 +415,171 @@ class GLTFWriter {
       }
     });
   }
+  /**
+   * Serializes a userData.
+   *
+   * @param {THREE.Object3D|THREE.Material} object
+   * @param {Object} objectDef
+   */
+
+
   serializeUserData(object, objectDef) {
-    if (Object.keys(object.userData).length === 0)
-      return;
+    if (Object.keys(object.userData).length === 0) return;
     const options = this.options;
     const extensionsUsed = this.extensionsUsed;
+
     try {
       const json = JSON.parse(JSON.stringify(object.userData));
+
       if (options.includeCustomExtensions && json.gltfExtensions) {
-        if (objectDef.extensions === void 0)
-          objectDef.extensions = {};
+        if (objectDef.extensions === undefined) objectDef.extensions = {};
+
         for (const extensionName in json.gltfExtensions) {
           objectDef.extensions[extensionName] = json.gltfExtensions[extensionName];
           extensionsUsed[extensionName] = true;
         }
+
         delete json.gltfExtensions;
       }
-      if (Object.keys(json).length > 0)
-        objectDef.extras = json;
+
+      if (Object.keys(json).length > 0) objectDef.extras = json;
     } catch (error) {
       if (error instanceof Error) {
-        console.warn(
-          "THREE.GLTFExporter: userData of '" + object.name + "' won't be serialized because of JSON.stringify error - " + error.message
-        );
+        console.warn("THREE.GLTFExporter: userData of '" + object.name + "' " + "won't be serialized because of JSON.stringify error - " + error.message);
       }
     }
   }
+  /**
+   * Assign and return a temporal unique id for an object
+   * especially which doesn't have .uuid
+   * @param  {Object} object
+   * @return {Integer}
+   */
+
+
   getUID(object) {
-    if (!this.uids.has(object))
-      this.uids.set(object, this.uid++);
+    if (!this.uids.has(object)) this.uids.set(object, this.uid++);
     return this.uids.get(object);
   }
+  /**
+   * Checks if normal attribute values are normalized.
+   *
+   * @param {BufferAttribute} normal
+   * @returns {Boolean}
+   */
+
+
   isNormalizedNormalAttribute(normal) {
     const cache = this.cache;
-    if (cache.attributesNormalized.has(normal))
-      return false;
-    const v = new THREE.Vector3();
+    if (cache.attributesNormalized.has(normal)) return false;
+    const v = new Vector3();
+
     for (let i = 0, il = normal.count; i < il; i++) {
-      if (Math.abs(v.fromBufferAttribute(normal, i).length() - 1) > 5e-4)
-        return false;
+      // 0.0005 is from glTF-validator
+      if (Math.abs(v.fromBufferAttribute(normal, i).length() - 1.0) > 0.0005) return false;
     }
+
     return true;
   }
+  /**
+   * Creates normalized normal buffer attribute.
+   *
+   * @param {BufferAttribute} normal
+   * @returns {BufferAttribute}
+   *
+   */
+
+
   createNormalizedNormalAttribute(normal) {
     const cache = this.cache;
-    if (cache.attributesNormalized.has(normal))
-      return cache.attributesNormalized.get(normal);
+    if (cache.attributesNormalized.has(normal)) return cache.attributesNormalized.get(normal);
     const attribute = normal.clone();
-    const v = new THREE.Vector3();
+    const v = new Vector3();
+
     for (let i = 0, il = attribute.count; i < il; i++) {
       v.fromBufferAttribute(attribute, i);
+
       if (v.x === 0 && v.y === 0 && v.z === 0) {
-        v.setX(1);
+        // if values can't be normalized set (1, 0, 0)
+        v.setX(1.0);
       } else {
         v.normalize();
       }
+
       attribute.setXYZ(i, v.x, v.y, v.z);
     }
+
     cache.attributesNormalized.set(normal, attribute);
     return attribute;
   }
+  /**
+   * Applies a texture transform, if present, to the map definition. Requires
+   * the KHR_texture_transform extension.
+   *
+   * @param {Object} mapDef
+   * @param {THREE.Texture} texture
+   */
+
+
   applyTextureTransform(mapDef, texture) {
     let didTransform = false;
     const transformDef = {};
+
     if (texture.offset.x !== 0 || texture.offset.y !== 0) {
       transformDef.offset = texture.offset.toArray();
       didTransform = true;
     }
+
     if (texture.rotation !== 0) {
       transformDef.rotation = texture.rotation;
       didTransform = true;
     }
+
     if (texture.repeat.x !== 1 || texture.repeat.y !== 1) {
       transformDef.scale = texture.repeat.toArray();
       didTransform = true;
     }
+
     if (didTransform) {
       mapDef.extensions = mapDef.extensions || {};
-      mapDef.extensions["KHR_texture_transform"] = transformDef;
-      this.extensionsUsed["KHR_texture_transform"] = true;
+      mapDef.extensions['KHR_texture_transform'] = transformDef;
+      this.extensionsUsed['KHR_texture_transform'] = true;
     }
   }
+  /**
+   * Process a buffer to append to the default one.
+   * @param  {ArrayBuffer} buffer
+   * @return {Integer}
+   */
+
+
   processBuffer(buffer) {
     const json = this.json;
     const buffers = this.buffers;
-    if (!json.buffers)
-      json.buffers = [{ byteLength: 0 }];
+    if (!json.buffers) json.buffers = [{
+      byteLength: 0
+    }]; // All buffers are merged before export.
+
     buffers.push(buffer);
     return 0;
   }
+  /**
+   * Process and generate a BufferView
+   * @param  {BufferAttribute} attribute
+   * @param  {number} componentType
+   * @param  {number} start
+   * @param  {number} count
+   * @param  {number} target (Optional) Target usage of the BufferView
+   * @return {Object}
+   */
+
+
   processBufferView(attribute, componentType, start, count, target) {
     const json = this.json;
-    if (!json.bufferViews)
-      json.bufferViews = [];
+    if (!json.bufferViews) json.bufferViews = []; // Create a new dataview and dump the attribute's array into it
+
     let componentSize;
+
     if (componentType === WEBGL_CONSTANTS.UNSIGNED_BYTE) {
       componentSize = 1;
     } else if (componentType === WEBGL_CONSTANTS.UNSIGNED_SHORT) {
@@ -402,25 +587,23 @@ class GLTFWriter {
     } else {
       componentSize = 4;
     }
+
     const byteLength = this.getPaddedBufferSize(count * attribute.itemSize * componentSize);
     const dataView = new DataView(new ArrayBuffer(byteLength));
     let offset = 0;
+
     for (let i = start; i < start + count; i++) {
       for (let a = 0; a < attribute.itemSize; a++) {
         let value;
+
         if (attribute.itemSize > 4) {
+          // no support for interleaved data for itemSize > 4
           value = attribute.array[i * attribute.itemSize + a];
         } else {
-          if (a === 0)
-            value = attribute.getX(i);
-          else if (a === 1)
-            value = attribute.getY(i);
-          else if (a === 2)
-            value = attribute.getZ(i);
-          else if (a === 3)
-            value = attribute.getW(i);
+          if (a === 0) value = attribute.getX(i);else if (a === 1) value = attribute.getY(i);else if (a === 2) value = attribute.getZ(i);else if (a === 3) value = attribute.getW(i);
         }
-        if (value !== void 0) {
+
+        if (value !== undefined) {
           if (componentType === WEBGL_CONSTANTS.FLOAT) {
             dataView.setFloat32(offset, value, true);
           } else if (componentType === WEBGL_CONSTANTS.UNSIGNED_INT) {
@@ -431,37 +614,49 @@ class GLTFWriter {
             dataView.setUint8(offset, value);
           }
         }
+
         offset += componentSize;
       }
     }
+
     const bufferViewDef = {
       buffer: this.processBuffer(dataView.buffer),
       byteOffset: this.byteOffset,
-      byteLength
+      byteLength: byteLength
     };
-    if (target !== void 0)
-      bufferViewDef.target = target;
+    if (target !== undefined) bufferViewDef.target = target;
+
     if (target === WEBGL_CONSTANTS.ARRAY_BUFFER) {
+      // Only define byteStride for vertex attributes.
       bufferViewDef.byteStride = attribute.itemSize * componentSize;
     }
+
     this.byteOffset += byteLength;
-    json.bufferViews.push(bufferViewDef);
+    json.bufferViews.push(bufferViewDef); // @TODO Merge bufferViews where possible.
+
     const output = {
       id: json.bufferViews.length - 1,
       byteLength: 0
     };
     return output;
   }
+  /**
+   * Process and generate a BufferView from an image Blob.
+   * @param {Blob} blob
+   * @return {Promise<Integer>}
+   */
+
+
   processBufferViewImage(blob) {
     const writer = this;
     const json = writer.json;
-    if (!json.bufferViews)
-      json.bufferViews = [];
-    return new Promise((resolve) => {
+    if (!json.bufferViews) json.bufferViews = [];
+    return new Promise(resolve => {
       const reader = new window.FileReader();
       reader.readAsArrayBuffer(blob);
+
       reader.onloadend = () => {
-        if (reader.result !== null && typeof reader.result !== "string" && json.bufferViews !== void 0) {
+        if (reader.result !== null && typeof reader.result !== 'string' && json.bufferViews !== undefined) {
           const buffer = this.getPaddedArrayBuffer(reader.result);
           const bufferViewDef = {
             buffer: writer.processBuffer(buffer),
@@ -474,17 +669,28 @@ class GLTFWriter {
       };
     });
   }
+  /**
+   * Process attribute to generate an accessor
+   * @param  {BufferAttribute} attribute Attribute to process
+   * @param  {THREE.BufferGeometry} geometry (Optional) Geometry used for truncated draw range
+   * @param  {Integer} start (Optional)
+   * @param  {Integer} count (Optional)
+   * @return {Integer|null} Index of the processed accessor on the "accessors" array
+   */
+
+
   processAccessor(attribute, geometry, start, count) {
     const options = this.options;
     const json = this.json;
     const types = {
-      1: "SCALAR",
-      2: "VEC2",
-      3: "VEC3",
-      4: "VEC4",
-      16: "MAT4"
+      1: 'SCALAR',
+      2: 'VEC2',
+      3: 'VEC3',
+      4: 'VEC4',
+      16: 'MAT4'
     };
-    let componentType;
+    let componentType; // Detect the component type of the attribute array (float, uint or ushort)
+
     if (attribute.array.constructor === Float32Array) {
       componentType = WEBGL_CONSTANTS.FLOAT;
     } else if (attribute.array.constructor === Uint32Array) {
@@ -494,80 +700,95 @@ class GLTFWriter {
     } else if (attribute.array.constructor === Uint8Array) {
       componentType = WEBGL_CONSTANTS.UNSIGNED_BYTE;
     } else {
-      throw new Error("THREE.GLTFExporter: Unsupported bufferAttribute component type.");
+      throw new Error('THREE.GLTFExporter: Unsupported bufferAttribute component type.');
     }
-    if (start === void 0)
-      start = 0;
-    if (count === void 0)
-      count = attribute.count;
-    if (options.truncateDrawRange && geometry !== void 0 && geometry.index === null) {
+
+    if (start === undefined) start = 0;
+    if (count === undefined) count = attribute.count; // @TODO Indexed buffer geometry with drawRange not supported yet
+
+    if (options.truncateDrawRange && geometry !== undefined && geometry.index === null) {
       const end = start + count;
       const end2 = geometry.drawRange.count === Infinity ? attribute.count : geometry.drawRange.start + geometry.drawRange.count;
       start = Math.max(start, geometry.drawRange.start);
       count = Math.min(end, end2) - start;
-      if (count < 0)
-        count = 0;
-    }
-    if (count === 0)
-      return null;
+      if (count < 0) count = 0;
+    } // Skip creating an accessor if the attribute doesn't have data to export
+
+
+    if (count === 0) return null;
     const minMax = this.getMinMax(attribute, start, count);
-    let bufferViewTarget;
-    if (geometry !== void 0) {
+    let bufferViewTarget; // If geometry isn't provided, don't infer the target usage of the bufferView. For
+    // animation samplers, target must not be set.
+
+    if (geometry !== undefined) {
       bufferViewTarget = attribute === geometry.index ? WEBGL_CONSTANTS.ELEMENT_ARRAY_BUFFER : WEBGL_CONSTANTS.ARRAY_BUFFER;
     }
-    if (bufferViewTarget !== void 0) {
+
+    if (bufferViewTarget !== undefined) {
       const bufferView = this.processBufferView(attribute, componentType, start, count, bufferViewTarget);
       const accessorDef = {
         bufferView: bufferView.id,
         byteOffset: bufferView.byteOffset,
-        componentType,
-        count,
+        componentType: componentType,
+        count: count,
         max: minMax.max,
         min: minMax.min,
         type: types[attribute.itemSize]
       };
-      if (attribute.normalized)
-        accessorDef.normalized = true;
-      if (!json.accessors)
-        json.accessors = [];
+      if (attribute.normalized) accessorDef.normalized = true;
+      if (!json.accessors) json.accessors = [];
       return json.accessors.push(accessorDef) - 1;
     }
   }
+  /**
+   * Process image
+   * @param  {Image} image to process
+   * @param  {Integer} format of the image (RGBAFormat)
+   * @param  {Boolean} flipY before writing out the image
+   * @return {Integer}     Index of the processed texture in the "images" array
+   */
+
+
   processImage(image, format, flipY) {
     const writer = this;
     const cache = writer.cache;
     const json = writer.json;
     const options = writer.options;
     const pending = writer.pending;
-    if (!cache.images.has(image))
-      cache.images.set(image, {});
+    if (!cache.images.has(image)) cache.images.set(image, {});
     const cachedImages = cache.images.get(image);
-    const mimeType = format === THREE.RGBAFormat ? "image/png" : "image/jpeg";
-    const key = mimeType + ":flipY/" + flipY.toString();
-    if (cachedImages !== void 0 && cachedImages[key] !== void 0)
-      return cachedImages[key];
-    if (!json.images)
-      json.images = [];
-    const imageDef = { mimeType };
-    if (options.embedImages && options.maxTextureSize !== void 0) {
-      const canvas = this.cachedCanvas = this.cachedCanvas || document.createElement("canvas");
+    const mimeType = format === RGBAFormat ? 'image/png' : 'image/jpeg';
+    const key = mimeType + ':flipY/' + flipY.toString();
+    if (cachedImages !== undefined && cachedImages[key] !== undefined) return cachedImages[key];
+    if (!json.images) json.images = [];
+    const imageDef = {
+      mimeType: mimeType
+    };
+
+    if (options.embedImages && options.maxTextureSize !== undefined) {
+      const canvas = this.cachedCanvas = this.cachedCanvas || document.createElement('canvas');
       canvas.width = Math.min(image.width, options.maxTextureSize);
       canvas.height = Math.min(image.height, options.maxTextureSize);
-      const ctx = canvas.getContext("2d");
+      const ctx = canvas.getContext('2d');
+
       if (flipY) {
-        ctx == null ? void 0 : ctx.translate(0, canvas.height);
-        ctx == null ? void 0 : ctx.scale(1, -1);
+        ctx === null || ctx === void 0 ? void 0 : ctx.translate(0, canvas.height);
+        ctx === null || ctx === void 0 ? void 0 : ctx.scale(1, -1);
       }
-      if (typeof HTMLImageElement !== "undefined" && image instanceof HTMLImageElement || typeof HTMLCanvasElement !== "undefined" && image instanceof HTMLCanvasElement || typeof OffscreenCanvas !== "undefined" && image instanceof OffscreenCanvas || typeof ImageBitmap !== "undefined" && image instanceof ImageBitmap) {
-        ctx == null ? void 0 : ctx.drawImage(image, 0, 0, canvas.width, canvas.height);
+
+      if (typeof HTMLImageElement !== 'undefined' && image instanceof HTMLImageElement || typeof HTMLCanvasElement !== 'undefined' && image instanceof HTMLCanvasElement || typeof OffscreenCanvas !== 'undefined' && image instanceof OffscreenCanvas || typeof ImageBitmap !== 'undefined' && image instanceof ImageBitmap) {
+        ctx === null || ctx === void 0 ? void 0 : ctx.drawImage(image, 0, 0, canvas.width, canvas.height);
       } else {
-        if (format !== THREE.RGBAFormat) {
-          console.error("GLTFExporter: Only RGBA format is supported.");
+        if (format !== RGBAFormat) {
+          console.error('GLTFExporter: Only RGBA format is supported.');
         }
+
         if (image.width > options.maxTextureSize || image.height > options.maxTextureSize) {
-          console.warn("GLTFExporter: Image size is bigger than maxTextureSize", image);
+          console.warn('GLTFExporter: Image size is bigger than maxTextureSize', image);
         }
+
         const data = new Uint8ClampedArray(image.height * image.width * 4);
+
         if (image instanceof ImageData) {
           for (let i = 0; i < data.length; i += 4) {
             data[i + 0] = image.data[i + 0];
@@ -576,36 +797,43 @@ class GLTFWriter {
             data[i + 3] = image.data[i + 3];
           }
         }
-        ctx == null ? void 0 : ctx.putImageData(new ImageData(data, image.width, image.height), 0, 0);
+
+        ctx === null || ctx === void 0 ? void 0 : ctx.putImageData(new ImageData(data, image.width, image.height), 0, 0);
       }
+
       if (options.binary) {
-        pending.push(
-          new Promise(function(resolve) {
-            canvas.toBlob(function(blob) {
-              if (blob !== null) {
-                writer.processBufferViewImage(blob).then(function(bufferViewIndex) {
-                  imageDef.bufferView = bufferViewIndex;
-                  resolve();
-                });
-              }
-            }, mimeType);
-          })
-        );
+        pending.push(new Promise(function (resolve) {
+          canvas.toBlob(function (blob) {
+            if (blob !== null) {
+              writer.processBufferViewImage(blob).then(function (bufferViewIndex) {
+                imageDef.bufferView = bufferViewIndex; // @ts-expect-error
+
+                resolve();
+              });
+            }
+          }, mimeType);
+        }));
       } else {
         imageDef.uri = canvas.toDataURL(mimeType);
       }
     } else if (image instanceof Image) {
       imageDef.uri = image.src;
     }
+
     const index = json.images.push(imageDef) - 1;
-    if (cachedImages !== void 0)
-      cachedImages[key] = index;
+    if (cachedImages !== undefined) cachedImages[key] = index;
     return index;
   }
+  /**
+   * Process sampler
+   * @param  {Texture} map Texture to process
+   * @return {Integer}     Index of the processed texture in the "samplers" array
+   */
+
+
   processSampler(map) {
     const json = this.json;
-    if (!json.samplers)
-      json.samplers = [];
+    if (!json.samplers) json.samplers = [];
     const samplerDef = {
       magFilter: THREE_TO_WEBGL[map.magFilter],
       minFilter: THREE_TO_WEBGL[map.minFilter],
@@ -614,129 +842,189 @@ class GLTFWriter {
     };
     return json.samplers.push(samplerDef) - 1;
   }
+  /**
+   * Process texture
+   * @param  {Texture} map Map to process
+   * @return {Integer} Index of the processed texture in the "textures" array
+   */
+
+
   processTexture(map) {
     const cache = this.cache;
     const json = this.json;
-    if (cache.textures.has(map))
-      return cache.textures.get(map);
-    if (!json.textures)
-      json.textures = [];
+    if (cache.textures.has(map)) return cache.textures.get(map);
+    if (!json.textures) json.textures = [];
     const textureDef = {
       sampler: this.processSampler(map),
       source: this.processImage(map.image, map.format, map.flipY)
     };
-    if (map.name)
-      textureDef.name = map.name;
-    this._invokeAll(function(ext) {
+    if (map.name) textureDef.name = map.name;
+
+    this._invokeAll(function (ext) {
       ext.writeTexture && ext.writeTexture(map, textureDef);
     });
+
     const index = json.textures.push(textureDef) - 1;
     cache.textures.set(map, index);
     return index;
   }
+  /**
+   * Process material
+   * @param  {THREE.Material} material Material to process
+   * @return {Integer|null} Index of the processed material in the "materials" array
+   */
+
+
   processMaterial(material) {
     const cache = this.cache;
     const json = this.json;
-    if (cache.materials.has(material))
-      return cache.materials.get(material);
-    if (material instanceof THREE.ShaderMaterial && material.isShaderMaterial) {
-      console.warn("GLTFExporter: THREE.ShaderMaterial not supported.");
+    if (cache.materials.has(material)) return cache.materials.get(material);
+
+    if (material instanceof ShaderMaterial && material.isShaderMaterial) {
+      console.warn('GLTFExporter: THREE.ShaderMaterial not supported.');
       return null;
     }
-    if (!json.materials)
-      json.materials = [];
-    const materialDef = { pbrMetallicRoughness: {} };
-    if (!(material instanceof THREE.MeshStandardMaterial && material.isMeshStandardMaterial && material instanceof THREE.MeshBasicMaterial && material.isMeshBasicMaterial)) {
-      console.warn("GLTFExporter: Use MeshStandardMaterial or MeshBasicMaterial for best results.");
-    }
-    if (material instanceof THREE.MeshStandardMaterial || material instanceof THREE.MeshPhysicalMaterial) {
+
+    if (!json.materials) json.materials = []; // @QUESTION Should we avoid including any attribute that has the default value?
+
+    const materialDef = {
+      pbrMetallicRoughness: {}
+    };
+
+    if (!(material instanceof MeshStandardMaterial && material.isMeshStandardMaterial && material instanceof MeshBasicMaterial && // @ts-expect-error
+    material.isMeshBasicMaterial)) {
+      console.warn('GLTFExporter: Use MeshStandardMaterial or MeshBasicMaterial for best results.');
+    }
+
+    if (material instanceof MeshStandardMaterial || material instanceof MeshPhysicalMaterial) {
+      // pbrMetallicRoughness.baseColorFactor
       const color = material.color.toArray().concat([material.opacity]);
+
       if (!this.equalArray(color, [1, 1, 1, 1])) {
         materialDef.pbrMetallicRoughness.baseColorFactor = color;
       }
     }
-    if (material instanceof THREE.MeshStandardMaterial && material.isMeshStandardMaterial) {
+
+    if (material instanceof MeshStandardMaterial && material.isMeshStandardMaterial) {
       materialDef.pbrMetallicRoughness.metallicFactor = material.metalness;
       materialDef.pbrMetallicRoughness.roughnessFactor = material.roughness;
     } else {
       materialDef.pbrMetallicRoughness.metallicFactor = 0.5;
       materialDef.pbrMetallicRoughness.roughnessFactor = 0.5;
-    }
-    if (material instanceof THREE.MeshStandardMaterial && material.metalnessMap || material instanceof THREE.MeshStandardMaterial && material.roughnessMap) {
+    } // pbrMetallicRoughness.metallicRoughnessTexture
+
+
+    if (material instanceof MeshStandardMaterial && material.metalnessMap || material instanceof MeshStandardMaterial && material.roughnessMap) {
       if (material.metalnessMap === material.roughnessMap && material.metalnessMap !== null) {
-        const metalRoughMapDef = { index: this.processTexture(material.metalnessMap) };
+        const metalRoughMapDef = {
+          index: this.processTexture(material.metalnessMap)
+        };
         this.applyTextureTransform(metalRoughMapDef, material.metalnessMap);
         materialDef.pbrMetallicRoughness.metallicRoughnessTexture = metalRoughMapDef;
       } else {
-        console.warn(
-          "THREE.GLTFExporter: Ignoring metalnessMap and roughnessMap because they are not the same Texture."
-        );
+        console.warn('THREE.GLTFExporter: Ignoring metalnessMap and roughnessMap because they are not the same Texture.');
       }
-    }
-    if ((material instanceof THREE.MeshStandardMaterial || material instanceof THREE.MeshPhysicalMaterial) && material.map) {
-      const baseColorMapDef = { index: this.processTexture(material.map) };
+    } // pbrMetallicRoughness.baseColorTexture or pbrSpecularGlossiness diffuseTexture
+
+
+    if ((material instanceof MeshStandardMaterial || material instanceof MeshPhysicalMaterial) && material.map) {
+      const baseColorMapDef = {
+        index: this.processTexture(material.map)
+      };
       this.applyTextureTransform(baseColorMapDef, material.map);
       materialDef.pbrMetallicRoughness.baseColorTexture = baseColorMapDef;
     }
-    if ((material instanceof THREE.MeshStandardMaterial || material instanceof THREE.MeshPhysicalMaterial) && material.emissive) {
+
+    if ((material instanceof MeshStandardMaterial || material instanceof MeshPhysicalMaterial) && material.emissive) {
+      // note: emissive components are limited to stay within the 0 - 1 range to accommodate glTF spec. see #21849 and #22000.
       const emissive = material.emissive.clone().multiplyScalar(material.emissiveIntensity);
       const maxEmissiveComponent = Math.max(emissive.r, emissive.g, emissive.b);
+
       if (maxEmissiveComponent > 1) {
         emissive.multiplyScalar(1 / maxEmissiveComponent);
-        console.warn("THREE.GLTFExporter: Some emissive components exceed 1; emissive has been limited");
+        console.warn('THREE.GLTFExporter: Some emissive components exceed 1; emissive has been limited');
       }
+
       if (maxEmissiveComponent > 0) {
         materialDef.emissiveFactor = emissive.toArray();
-      }
+      } // emissiveTexture
+
+
       if (material.emissiveMap) {
-        const emissiveMapDef = { index: this.processTexture(material.emissiveMap) };
+        const emissiveMapDef = {
+          index: this.processTexture(material.emissiveMap)
+        };
         this.applyTextureTransform(emissiveMapDef, material.emissiveMap);
         materialDef.emissiveTexture = emissiveMapDef;
       }
-    }
-    if ((material instanceof THREE.MeshMatcapMaterial || material instanceof THREE.MeshNormalMaterial || material instanceof THREE.MeshPhongMaterial || material instanceof THREE.MeshStandardMaterial || material instanceof THREE.MeshToonMaterial) && material.normalMap) {
-      const normalMapDef = { index: this.processTexture(material.normalMap) };
+    } // normalTexture
+
+
+    if ((material instanceof MeshMatcapMaterial || material instanceof MeshNormalMaterial || material instanceof MeshPhongMaterial || material instanceof MeshStandardMaterial || material instanceof MeshToonMaterial) && material.normalMap) {
+      const normalMapDef = {
+        index: this.processTexture(material.normalMap)
+      };
+
       if (material.normalScale && material.normalScale.x !== 1) {
+        // glTF normal scale is univariate. Ignore `y`, which may be flipped.
+        // Context: https://github.com/mrdoob/three.js/issues/11438#issuecomment-507003995
         normalMapDef.scale = material.normalScale.x;
       }
+
       this.applyTextureTransform(normalMapDef, material.normalMap);
       materialDef.normalTexture = normalMapDef;
-    }
-    if ((material instanceof THREE.MeshBasicMaterial || material instanceof THREE.MeshLambertMaterial || material instanceof THREE.MeshPhongMaterial || material instanceof THREE.MeshStandardMaterial || material instanceof THREE.MeshToonMaterial) && material.aoMap) {
+    } // occlusionTexture
+
+
+    if ((material instanceof MeshBasicMaterial || material instanceof MeshLambertMaterial || material instanceof MeshPhongMaterial || material instanceof MeshStandardMaterial || material instanceof MeshToonMaterial) && material.aoMap) {
       const occlusionMapDef = {
         index: this.processTexture(material.aoMap),
         texCoord: 1
       };
-      if (material.aoMapIntensity !== 1) {
+
+      if (material.aoMapIntensity !== 1.0) {
         occlusionMapDef.strength = material.aoMapIntensity;
       }
+
       this.applyTextureTransform(occlusionMapDef, material.aoMap);
       materialDef.occlusionTexture = occlusionMapDef;
-    }
+    } // alphaMode
+
+
     if (material.transparent) {
-      materialDef.alphaMode = "BLEND";
+      materialDef.alphaMode = 'BLEND';
     } else {
-      if (material.alphaTest > 0) {
-        materialDef.alphaMode = "MASK";
+      if (material.alphaTest > 0.0) {
+        materialDef.alphaMode = 'MASK';
         materialDef.alphaCutoff = material.alphaTest;
       }
-    }
-    if (material.side === THREE.DoubleSide)
-      materialDef.doubleSided = true;
-    if (material.name !== "")
-      materialDef.name = material.name;
+    } // doubleSided
+
+
+    if (material.side === DoubleSide) materialDef.doubleSided = true;
+    if (material.name !== '') materialDef.name = material.name;
     this.serializeUserData(material, materialDef);
-    this._invokeAll(function(ext) {
+
+    this._invokeAll(function (ext) {
       ext.writeMaterial && ext.writeMaterial(material, materialDef);
     });
+
     const index = json.materials.push(materialDef) - 1;
     cache.materials.set(material, index);
     return index;
   }
+  /**
+   * Process mesh
+   * @param  {THREE.Mesh} mesh Mesh to process
+   * @return {Integer|null} Index of the processed mesh in the "meshes" array
+   */
+
+
   processMesh(mesh) {
     const cache = this.cache;
     const json = this.json;
     const meshCacheKeyParts = [mesh.geometry.uuid];
+
     if (Array.isArray(mesh.material)) {
       for (let i = 0, l = mesh.material.length; i < l; i++) {
         meshCacheKeyParts.push(mesh.material[i].uuid);
@@ -744,245 +1032,325 @@ class GLTFWriter {
     } else {
       meshCacheKeyParts.push(mesh.material.uuid);
     }
-    const meshCacheKey = meshCacheKeyParts.join(":");
-    if (cache.meshes.has(meshCacheKey))
-      return cache.meshes.get(meshCacheKey);
+
+    const meshCacheKey = meshCacheKeyParts.join(':');
+    if (cache.meshes.has(meshCacheKey)) return cache.meshes.get(meshCacheKey);
     const geometry = mesh.geometry;
-    let mode;
-    if (mesh instanceof THREE.LineSegments && mesh.isLineSegments) {
+    let mode; // Use the correct mode
+
+    if (mesh instanceof LineSegments && mesh.isLineSegments) {
       mode = WEBGL_CONSTANTS.LINES;
-    } else if (mesh instanceof THREE.LineLoop && mesh.isLineLoop) {
+    } else if (mesh instanceof LineLoop && mesh.isLineLoop) {
       mode = WEBGL_CONSTANTS.LINE_LOOP;
-    } else if (mesh instanceof THREE.Line && mesh.isLine) {
+    } else if (mesh instanceof Line && mesh.isLine) {
       mode = WEBGL_CONSTANTS.LINE_STRIP;
-    } else if (mesh instanceof THREE.Points && mesh.isPoints) {
+    } else if (mesh instanceof Points && mesh.isPoints) {
       mode = WEBGL_CONSTANTS.POINTS;
     } else {
-      mode = (mesh.material instanceof THREE.MeshBasicMaterial || mesh.material instanceof THREE.MeshDepthMaterial || mesh.material instanceof THREE.MeshLambertMaterial || mesh.material instanceof THREE.MeshNormalMaterial || mesh.material instanceof THREE.MeshPhongMaterial || mesh.material instanceof THREE.MeshStandardMaterial || mesh.material instanceof THREE.MeshToonMaterial || mesh.material instanceof THREE.ShaderMaterial) && mesh.material.wireframe ? WEBGL_CONSTANTS.LINES : WEBGL_CONSTANTS.TRIANGLES;
+      mode = (mesh.material instanceof MeshBasicMaterial || mesh.material instanceof MeshDepthMaterial || mesh.material instanceof MeshLambertMaterial || mesh.material instanceof MeshNormalMaterial || mesh.material instanceof MeshPhongMaterial || mesh.material instanceof MeshStandardMaterial || mesh.material instanceof MeshToonMaterial || mesh.material instanceof ShaderMaterial) && mesh.material.wireframe ? WEBGL_CONSTANTS.LINES : WEBGL_CONSTANTS.TRIANGLES;
     }
+
     if (!geometry.isBufferGeometry) {
-      throw new Error("THREE.GLTFExporter: Geometry is not of type THREE.BufferGeometry.");
+      throw new Error('THREE.GLTFExporter: Geometry is not of type THREE.BufferGeometry.');
     }
+
     const meshDef = {};
     const attributes = {};
     const primitives = [];
-    const targets = [];
+    const targets = []; // Conversion between attributes names in threejs and gltf spec
+
     const nameConversion = {
-      uv: "TEXCOORD_0",
-      uv2: "TEXCOORD_1",
-      color: "COLOR_0",
-      skinWeight: "WEIGHTS_0",
-      skinIndex: "JOINTS_0"
+      uv: 'TEXCOORD_0',
+      uv2: 'TEXCOORD_1',
+      color: 'COLOR_0',
+      skinWeight: 'WEIGHTS_0',
+      skinIndex: 'JOINTS_0'
     };
-    const originalNormal = geometry.getAttribute("normal");
-    if (originalNormal !== void 0 && !(originalNormal instanceof THREE.InterleavedBufferAttribute) && !this.isNormalizedNormalAttribute(originalNormal)) {
-      console.warn("THREE.GLTFExporter: Creating normalized normal attribute from the non-normalized one.");
-      geometry.setAttribute("normal", this.createNormalizedNormalAttribute(originalNormal));
-    }
+    const originalNormal = geometry.getAttribute('normal');
+
+    if (originalNormal !== undefined && !(originalNormal instanceof InterleavedBufferAttribute) && !this.isNormalizedNormalAttribute(originalNormal)) {
+      console.warn('THREE.GLTFExporter: Creating normalized normal attribute from the non-normalized one.');
+      geometry.setAttribute('normal', this.createNormalizedNormalAttribute(originalNormal));
+    } // @QUESTION Detect if .vertexColors = true?
+    // For every attribute create an accessor
+
+
     let modifiedAttribute = null;
+
     for (let attributeName in geometry.attributes) {
-      if (attributeName.substr(0, 5) === "morph")
-        continue;
+      // Ignore morph target attributes, which are exported later.
+      if (attributeName.substr(0, 5) === 'morph') continue;
       const attribute = geometry.attributes[attributeName];
-      attributeName = nameConversion[attributeName] || attributeName.toUpperCase();
+      attributeName = nameConversion[attributeName] || attributeName.toUpperCase(); // Prefix all geometry attributes except the ones specifically
+      // listed in the spec; non-spec attributes are considered custom.
+
       const validVertexAttributes = /^(POSITION|NORMAL|TANGENT|TEXCOORD_\d+|COLOR_\d+|JOINTS_\d+|WEIGHTS_\d+)$/;
-      if (!validVertexAttributes.test(attributeName))
-        attributeName = "_" + attributeName;
+      if (!validVertexAttributes.test(attributeName)) attributeName = '_' + attributeName;
+
       if (cache.attributes.has(this.getUID(attribute))) {
         attributes[attributeName] = cache.attributes.get(this.getUID(attribute));
         continue;
-      }
+      } // JOINTS_0 must be UNSIGNED_BYTE or UNSIGNED_SHORT.
+
+
       modifiedAttribute = null;
       const array = attribute.array;
-      if (attributeName === "JOINTS_0" && !(array instanceof Uint16Array) && !(array instanceof Uint8Array)) {
+
+      if (attributeName === 'JOINTS_0' && !(array instanceof Uint16Array) && !(array instanceof Uint8Array)) {
         console.warn('GLTFExporter: Attribute "skinIndex" converted to type UNSIGNED_SHORT.');
-        modifiedAttribute = new THREE.BufferAttribute(new Uint16Array(array), attribute.itemSize, attribute.normalized);
+        modifiedAttribute = new BufferAttribute(new Uint16Array(array), attribute.itemSize, attribute.normalized);
       }
+
       const accessor = modifiedAttribute !== null && this.processAccessor(modifiedAttribute || attribute, geometry);
+
       if (accessor) {
         attributes[attributeName] = accessor;
         cache.attributes.set(this.getUID(attribute), accessor);
       }
     }
-    if (originalNormal !== void 0)
-      geometry.setAttribute("normal", originalNormal);
-    if (Object.keys(attributes).length === 0)
-      return null;
-    if (mesh.morphTargetInfluences !== void 0 && mesh.morphTargetInfluences.length > 0) {
+
+    if (originalNormal !== undefined) geometry.setAttribute('normal', originalNormal); // Skip if no exportable attributes found
+
+    if (Object.keys(attributes).length === 0) return null; // Morph targets
+
+    if (mesh.morphTargetInfluences !== undefined && mesh.morphTargetInfluences.length > 0) {
       const weights = [];
       const targetNames = [];
       const reverseDictionary = {};
-      if (mesh.morphTargetDictionary !== void 0) {
+
+      if (mesh.morphTargetDictionary !== undefined) {
         for (const key in mesh.morphTargetDictionary) {
           reverseDictionary[mesh.morphTargetDictionary[key]] = key;
         }
       }
+
       for (let i = 0; i < mesh.morphTargetInfluences.length; ++i) {
         const target = {};
         let warned = false;
+
         for (const attributeName in geometry.morphAttributes) {
-          if (attributeName !== "position" && attributeName !== "normal") {
+          // glTF 2.0 morph supports only POSITION/NORMAL/TANGENT.
+          // Three.js doesn't support TANGENT yet.
+          if (attributeName !== 'position' && attributeName !== 'normal') {
             if (!warned) {
-              console.warn("GLTFExporter: Only POSITION and NORMAL morph are supported.");
+              console.warn('GLTFExporter: Only POSITION and NORMAL morph are supported.');
               warned = true;
             }
+
             continue;
           }
+
           const attribute = geometry.morphAttributes[attributeName][i];
-          const gltfAttributeName = attributeName.toUpperCase();
+          const gltfAttributeName = attributeName.toUpperCase(); // Three.js morph attribute has absolute values while the one of glTF has relative values.
+          //
+          // glTF 2.0 Specification:
+          // https://github.com/KhronosGroup/glTF/tree/master/specification/2.0#morph-targets
+
           const baseAttribute = geometry.attributes[attributeName];
+
           if (cache.attributes.has(this.getUID(attribute))) {
             target[gltfAttributeName] = cache.attributes.get(this.getUID(attribute));
             continue;
-          }
+          } // Clones attribute not to override
+
+
           const relativeAttribute = attribute.clone();
+
           if (!geometry.morphTargetsRelative) {
             for (let j = 0, jl = attribute.count; j < jl; j++) {
-              relativeAttribute.setXYZ(
-                j,
-                attribute.getX(j) - baseAttribute.getX(j),
-                attribute.getY(j) - baseAttribute.getY(j),
-                attribute.getZ(j) - baseAttribute.getZ(j)
-              );
+              relativeAttribute.setXYZ(j, attribute.getX(j) - baseAttribute.getX(j), attribute.getY(j) - baseAttribute.getY(j), attribute.getZ(j) - baseAttribute.getZ(j));
             }
           }
+
           const accessor = this.processAccessor(relativeAttribute, geometry);
-          if (accessor != void 0) {
+
+          if (accessor != undefined) {
             target[gltfAttributeName] = accessor;
           }
+
           cache.attributes.set(this.getUID(baseAttribute), target[gltfAttributeName]);
         }
+
         targets.push(target);
         weights.push(mesh.morphTargetInfluences[i]);
-        if (mesh.morphTargetDictionary !== void 0)
-          targetNames.push(reverseDictionary[i]);
+        if (mesh.morphTargetDictionary !== undefined) targetNames.push(reverseDictionary[i]);
       }
+
       meshDef.weights = weights;
+
       if (targetNames.length > 0) {
         meshDef.extras = {};
         meshDef.extras.targetNames = targetNames;
       }
     }
+
     const isMultiMaterial = Array.isArray(mesh.material);
-    if (isMultiMaterial && geometry.groups.length === 0)
-      return null;
+    if (isMultiMaterial && geometry.groups.length === 0) return null;
     const materials = isMultiMaterial ? mesh.material : [mesh.material];
-    const groups = isMultiMaterial ? geometry.groups : [{ materialIndex: 0, start: void 0, count: void 0 }];
+    const groups = isMultiMaterial ? geometry.groups : [{
+      materialIndex: 0,
+      start: undefined,
+      count: undefined
+    }];
+
     for (let i = 0, il = groups.length; i < il; i++) {
       const primitive = {
-        mode,
-        attributes
+        mode: mode,
+        attributes: attributes
       };
-      if (geometry instanceof THREE.Object3D || geometry instanceof THREE.Material) {
+
+      if (geometry instanceof Object3D || geometry instanceof Material) {
         this.serializeUserData(geometry, primitive);
       }
-      if (targets.length > 0)
-        primitive.targets = targets;
+
+      if (targets.length > 0) primitive.targets = targets;
+
       if (geometry.index !== null) {
         let cacheKey = this.getUID(geometry.index);
-        if (groups[i].start !== void 0 || groups[i].count !== void 0) {
+
+        if (groups[i].start !== undefined || groups[i].count !== undefined) {
+          // @ts-expect-error
           cacheKey += `:${groups[i].start}:${groups[i].count}`;
         }
+
         if (cache.attributes.has(cacheKey)) {
           primitive.indices = cache.attributes.get(cacheKey);
         } else {
           primitive.indices = this.processAccessor(geometry.index, geometry, groups[i].start, groups[i].count);
           cache.attributes.set(cacheKey, primitive.indices);
         }
-        if (primitive.indices === null)
-          delete primitive.indices;
+
+        if (primitive.indices === null) delete primitive.indices;
       }
+
       const materialIndex = groups[i].materialIndex;
-      if (materialIndex !== void 0 && Array.isArray(materials)) {
+
+      if (materialIndex !== undefined && Array.isArray(materials)) {
         const targetMaterials = materials[materialIndex];
+
         if (!Array.isArray(targetMaterials)) {
           const material = this.processMaterial(targetMaterials);
-          if (material !== null)
-            primitive.material = material;
+          if (material !== null) primitive.material = material;
           primitives.push(primitive);
         }
       }
     }
+
     meshDef.primitives = primitives;
-    if (!json.meshes)
-      json.meshes = [];
-    this._invokeAll(function(ext) {
+    if (!json.meshes) json.meshes = [];
+
+    this._invokeAll(function (ext) {
       ext.writeMesh && ext.writeMesh(mesh, meshDef);
     });
+
     const index = json.meshes.push(meshDef) - 1;
     cache.meshes.set(meshCacheKey, index);
     return index;
   }
+  /**
+   * Process camera
+   * @param  {THREE.Camera} camera Camera to process
+   * @return {Integer}      Index of the processed mesh in the "camera" array
+   */
+
+
   processCamera(camera) {
     const json = this.json;
-    if (!json.cameras)
-      json.cameras = [];
-    const isOrtho = camera instanceof THREE.OrthographicCamera && camera.isOrthographicCamera;
+    if (!json.cameras) json.cameras = [];
+    const isOrtho = camera instanceof OrthographicCamera && camera.isOrthographicCamera;
     const cameraDef = {
-      type: isOrtho ? "orthographic" : "perspective"
+      type: isOrtho ? 'orthographic' : 'perspective'
     };
-    if (camera instanceof THREE.OrthographicCamera && isOrtho) {
+
+    if (camera instanceof OrthographicCamera && isOrtho) {
       cameraDef.orthographic = {
         xmag: camera.right * 2,
         ymag: camera.top * 2,
-        zfar: camera.far <= 0 ? 1e-3 : camera.far,
+        zfar: camera.far <= 0 ? 0.001 : camera.far,
         znear: camera.near < 0 ? 0 : camera.near
       };
-    } else if (camera instanceof THREE.PerspectiveCamera) {
+    } else if (camera instanceof PerspectiveCamera) {
       cameraDef.perspective = {
         aspectRatio: camera.aspect,
-        yfov: THREE.MathUtils.degToRad(camera.fov),
-        zfar: camera.far <= 0 ? 1e-3 : camera.far,
+        yfov: MathUtils.degToRad(camera.fov),
+        zfar: camera.far <= 0 ? 0.001 : camera.far,
         znear: camera.near < 0 ? 0 : camera.near
       };
-    }
-    if (camera.name !== "")
-      cameraDef.name = camera.type;
+    } // Question: Is saving "type" as name intentional?
+
+
+    if (camera.name !== '') cameraDef.name = camera.type;
     return json.cameras.push(cameraDef) - 1;
   }
+  /**
+   * Creates glTF animation entry from AnimationClip object.
+   *
+   * Status:
+   * - Only properties listed in PATH_PROPERTIES may be animated.
+   *
+   * @param {THREE.AnimationClip} clip
+   * @param {THREE.Object3D} root
+   * @return {number|null}
+   */
+
+
   processAnimation(clip, root) {
     const json = this.json;
     const nodeMap = this.nodeMap;
-    if (!json.animations)
-      json.animations = [];
+    if (!json.animations) json.animations = [];
     clip = GLTFExporter.Utils.mergeMorphTargetTracks(clip.clone(), root);
     const tracks = clip.tracks;
     const channels = [];
     const samplers = [];
+
     for (let i = 0; i < tracks.length; ++i) {
       const track = tracks[i];
-      const trackBinding = THREE.PropertyBinding.parseTrackName(track.name);
-      let trackNode = THREE.PropertyBinding.findNode(root, trackBinding.nodeName);
+      const trackBinding = PropertyBinding.parseTrackName(track.name);
+      let trackNode = PropertyBinding.findNode(root, trackBinding.nodeName);
       const trackProperty = PATH_PROPERTIES[trackBinding.propertyName];
-      if (trackBinding.objectName === "bones") {
+
+      if (trackBinding.objectName === 'bones') {
         if (trackNode.isSkinnedMesh) {
           trackNode = trackNode.skeleton.getBoneByName(trackBinding.objectIndex);
         } else {
-          trackNode = void 0;
+          trackNode = undefined;
         }
       }
+
       if (!trackNode || !trackProperty) {
         console.warn('THREE.GLTFExporter: Could not export animation track "%s".', track.name);
         return null;
       }
+
       const inputItemSize = 1;
       let outputItemSize = track.values.length / track.times.length;
+
       if (trackProperty === PATH_PROPERTIES.morphTargetInfluences) {
         outputItemSize /= trackNode.morphTargetInfluences.length;
       }
-      let interpolation;
+
+      let interpolation; // @TODO export CubicInterpolant(InterpolateSmooth) as CUBICSPLINE
+      // Detecting glTF cubic spline interpolant by checking factory method's special property
+      // GLTFCubicSplineInterpolant is a custom interpolant and track doesn't return
+      // valid value from .getInterpolation().
+      // @ts-expect-error
+
       if (track.createInterpolant.isInterpolantFactoryMethodGLTFCubicSpline) {
-        interpolation = "CUBICSPLINE";
+        interpolation = 'CUBICSPLINE'; // itemSize of CUBICSPLINE keyframe is 9
+        // (VEC3 * 3: inTangent, splineVertex, and outTangent)
+        // but needs to be stored as VEC3 so dividing by 3 here.
+
         outputItemSize /= 3;
-      } else if (track.getInterpolation() === THREE.InterpolateDiscrete) {
-        interpolation = "STEP";
+      } else if (track.getInterpolation() === InterpolateDiscrete) {
+        interpolation = 'STEP';
       } else {
-        interpolation = "LINEAR";
+        interpolation = 'LINEAR';
       }
+
       samplers.push({
-        input: this.processAccessor(new THREE.BufferAttribute(track.times, inputItemSize)),
-        output: this.processAccessor(new THREE.BufferAttribute(track.values, outputItemSize)),
-        interpolation
+        input: this.processAccessor(new BufferAttribute(track.times, inputItemSize)),
+        output: this.processAccessor(new BufferAttribute(track.values, outputItemSize)),
+        interpolation: interpolation
       });
       channels.push({
         sampler: samplers.length - 1,
@@ -992,37 +1360,44 @@ class GLTFWriter {
         }
       });
     }
+
     json.animations.push({
-      name: clip.name || "clip_" + json.animations.length,
-      samplers,
-      channels
+      name: clip.name || 'clip_' + json.animations.length,
+      samplers: samplers,
+      channels: channels
     });
     return json.animations.length - 1;
   }
+  /**
+   * @param {THREE.Object3D} object
+   * @return {number|null}
+   */
+
+
   processSkin(object) {
     const json = this.json;
     const nodeMap = this.nodeMap;
-    if (json.nodes !== void 0 && object instanceof THREE.SkinnedMesh) {
+
+    if (json.nodes !== undefined && object instanceof SkinnedMesh) {
       const node = json.nodes[nodeMap.get(object)];
       const skeleton = object.skeleton;
-      if (skeleton === void 0)
-        return null;
+      if (skeleton === undefined) return null;
       const rootJoint = object.skeleton.bones[0];
-      if (rootJoint === void 0)
-        return null;
+      if (rootJoint === undefined) return null;
       const joints = [];
       const inverseBindMatrices = new Float32Array(skeleton.bones.length * 16);
-      const temporaryBoneInverse = new THREE.Matrix4();
+      const temporaryBoneInverse = new Matrix4();
+
       for (let i = 0; i < skeleton.bones.length; ++i) {
         joints.push(nodeMap.get(skeleton.bones[i]));
         temporaryBoneInverse.copy(skeleton.boneInverses[i]);
         temporaryBoneInverse.multiply(object.bindMatrix).toArray(inverseBindMatrices, i * 16);
       }
-      if (json.skins === void 0)
-        json.skins = [];
+
+      if (json.skins === undefined) json.skins = [];
       json.skins.push({
-        inverseBindMatrices: this.processAccessor(new THREE.BufferAttribute(inverseBindMatrices, 16)),
-        joints,
+        inverseBindMatrices: this.processAccessor(new BufferAttribute(inverseBindMatrices, 16)),
+        joints: joints,
         skeleton: nodeMap.get(rootJoint)
       });
       const skinIndex = node.skin = json.skins.length - 1;
@@ -1031,23 +1406,33 @@ class GLTFWriter {
       return null;
     }
   }
+  /**
+   * Process Object3D node
+   * @param  {THREE.Object3D} node Object3D to processNode
+   * @return {Integer} Index of the node in the nodes list
+   */
+
+
   processNode(object) {
     const json = this.json;
     const options = this.options;
     const nodeMap = this.nodeMap;
-    if (!json.nodes)
-      json.nodes = [];
+    if (!json.nodes) json.nodes = [];
     const nodeDef = {};
+
     if (options.trs) {
       const rotation = object.quaternion.toArray();
       const position = object.position.toArray();
       const scale = object.scale.toArray();
+
       if (!this.equalArray(rotation, [0, 0, 0, 1])) {
         nodeDef.rotation = rotation;
       }
+
       if (!this.equalArray(position, [0, 0, 0])) {
         nodeDef.translation = position;
       }
+
       if (!this.equalArray(scale, [1, 1, 1])) {
         nodeDef.scale = scale;
       }
@@ -1055,315 +1440,477 @@ class GLTFWriter {
       if (object.matrixAutoUpdate) {
         object.updateMatrix();
       }
+
       if (!this.isIdentityMatrix(object.matrix)) {
         nodeDef.matrix = object.matrix.elements;
       }
-    }
-    if (object.name !== "")
-      nodeDef.name = String(object.name);
+    } // We don't export empty strings name because it represents no-name in Three.js.
+
+
+    if (object.name !== '') nodeDef.name = String(object.name);
     this.serializeUserData(object, nodeDef);
-    if ((object instanceof THREE.Mesh && object.isMesh || object instanceof THREE.Line && object.isLine || object instanceof THREE.Points && object.isPoints) && object instanceof THREE.Mesh) {
+
+    if ((object instanceof Mesh && object.isMesh || object instanceof Line && object.isLine || object instanceof Points && object.isPoints) && object instanceof Mesh) {
       const meshIndex = this.processMesh(object);
-      if (meshIndex !== null)
-        nodeDef.mesh = meshIndex;
-    } else if (object instanceof THREE.Camera && object.isCamera) {
+      if (meshIndex !== null) nodeDef.mesh = meshIndex;
+    } else if (object instanceof Camera && object.isCamera) {
       nodeDef.camera = this.processCamera(object);
     }
-    if (object instanceof THREE.SkinnedMesh && object.isSkinnedMesh)
-      this.skins.push(object);
+
+    if (object instanceof SkinnedMesh && object.isSkinnedMesh) this.skins.push(object);
+
     if (object.children.length > 0) {
       const children = [];
+
       for (let i = 0, l = object.children.length; i < l; i++) {
         const child = object.children[i];
+
         if (child.visible || !options.onlyVisible) {
-          const nodeIndex2 = this.processNode(child);
-          if (nodeIndex2 !== null)
-            children.push(nodeIndex2);
+          const nodeIndex = this.processNode(child);
+          if (nodeIndex !== null) children.push(nodeIndex);
         }
       }
-      if (children.length > 0)
-        nodeDef.children = children;
+
+      if (children.length > 0) nodeDef.children = children;
     }
-    this._invokeAll(function(ext) {
+
+    this._invokeAll(function (ext) {
       ext.writeNode && ext.writeNode(object, nodeDef);
     });
+
     const nodeIndex = json.nodes.push(nodeDef) - 1;
     nodeMap.set(object, nodeIndex);
     return nodeIndex;
   }
+  /**
+   * Process Scene
+   * @param  {Scene} node Scene to process
+   */
+
+
   processScene(scene) {
     const json = this.json;
     const options = this.options;
+
     if (!json.scenes) {
       json.scenes = [];
       json.scene = 0;
     }
+
     const sceneDef = {};
-    if (scene.name !== "")
-      sceneDef.name = scene.name;
+    if (scene.name !== '') sceneDef.name = scene.name;
     json.scenes.push(sceneDef);
     const nodes = [];
+
     for (let i = 0, l = scene.children.length; i < l; i++) {
       const child = scene.children[i];
+
       if (child.visible || !options.onlyVisible) {
         const nodeIndex = this.processNode(child);
-        if (nodeIndex !== null)
-          nodes.push(nodeIndex);
+        if (nodeIndex !== null) nodes.push(nodeIndex);
       }
     }
-    if (nodes.length > 0)
-      sceneDef.nodes = nodes;
+
+    if (nodes.length > 0) sceneDef.nodes = nodes;
     this.serializeUserData(scene, sceneDef);
   }
+
   processObjects(objects) {
-    const scene = new THREE.Scene();
-    scene.name = "AuxScene";
+    const scene = new Scene();
+    scene.name = 'AuxScene';
+
     for (let i = 0; i < objects.length; i++) {
+      // We push directly to children instead of calling `add` to prevent
+      // modify the .parent and break its original scene and hierarchy
       scene.children.push(objects[i]);
     }
+
     this.processScene(scene);
   }
+  /**
+   * @param {THREE.Object3D|Array<THREE.Object3D>} input
+   */
+
+
   processInput(input) {
     const options = this.options;
     input = input instanceof Array ? input : [input];
-    this._invokeAll(function(ext) {
+
+    this._invokeAll(function (ext) {
       ext.beforeParse && ext.beforeParse(input);
     });
+
     const objectsWithoutScene = [];
+
     for (let i = 0; i < input.length; i++) {
       const inputScene = input[i];
-      if (inputScene instanceof THREE.Scene) {
+
+      if (inputScene instanceof Scene) {
         this.processScene(inputScene);
       } else {
         objectsWithoutScene.push(input[i]);
       }
     }
-    if (objectsWithoutScene.length > 0)
-      this.processObjects(objectsWithoutScene);
+
+    if (objectsWithoutScene.length > 0) this.processObjects(objectsWithoutScene);
+
     for (let i = 0; i < this.skins.length; ++i) {
       this.processSkin(this.skins[i]);
     }
-    for (let i = 0; options.animations !== void 0 && i < options.animations.length; ++i) {
+
+    for (let i = 0; options.animations !== undefined && i < options.animations.length; ++i) {
       this.processAnimation(options.animations[i], input[0]);
     }
-    this._invokeAll(function(ext) {
+
+    this._invokeAll(function (ext) {
       ext.afterParse && ext.afterParse(input);
     });
   }
+
   _invokeAll(func) {
     for (let i = 0, il = this.plugins.length; i < il; i++) {
       func(this.plugins[i]);
     }
-  }
+  } //------------------------------------------------------------------------------
+  // Utility functions
+  //------------------------------------------------------------------------------
+
+  /**
+   * Compare two arrays
+   * @param  {Array} array1 Array 1 to compare
+   * @param  {Array} array2 Array 2 to compare
+   * @return {Boolean}        Returns true if both arrays are equal
+   */
+
+
   equalArray(array1, array2) {
-    return array1.length === array2.length && array1.every(function(element, index) {
+    return array1.length === array2.length && array1.every(function (element, index) {
       return element === array2[index];
     });
   }
+  /**
+   * Converts a string to an ArrayBuffer.
+   * @param  {string} text
+   * @return {ArrayBuffer}
+   */
+
+
   stringToArrayBuffer(text) {
-    if (window.TextEncoder !== void 0) {
+    if (window.TextEncoder !== undefined) {
       return new TextEncoder().encode(text).buffer;
     }
+
     const array = new Uint8Array(new ArrayBuffer(text.length));
+
     for (let i = 0, il = text.length; i < il; i++) {
-      const value = text.charCodeAt(i);
-      array[i] = value > 255 ? 32 : value;
+      const value = text.charCodeAt(i); // Replacing multi-byte character with space(0x20).
+
+      array[i] = value > 0xff ? 0x20 : value;
     }
+
     return array.buffer;
   }
+
   isIdentityMatrix(matrix) {
     return this.equalArray(matrix.elements, [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1]);
   }
+
   getMinMax(attribute, start, count) {
     const output = {
       min: new Array(attribute.itemSize).fill(Number.POSITIVE_INFINITY),
       max: new Array(attribute.itemSize).fill(Number.NEGATIVE_INFINITY)
     };
+
     for (let i = start; i < start + count; i++) {
       for (let a = 0; a < attribute.itemSize; a++) {
         let value;
+
         if (attribute.itemSize > 4) {
+          // no support for interleaved data for itemSize > 4
           value = attribute.array[i * attribute.itemSize + a];
         } else {
-          if (a === 0)
-            value = attribute.getX(i);
-          else if (a === 1)
-            value = attribute.getY(i);
-          else if (a === 2)
-            value = attribute.getZ(i);
-          else if (a === 3)
-            value = attribute.getW(i);
+          if (a === 0) value = attribute.getX(i);else if (a === 1) value = attribute.getY(i);else if (a === 2) value = attribute.getZ(i);else if (a === 3) value = attribute.getW(i);
         }
-        if (value !== void 0) {
+
+        if (value !== undefined) {
           output.min[a] = Math.min(output.min[a], value);
           output.max[a] = Math.max(output.max[a], value);
         }
       }
     }
+
     return output;
   }
+  /**
+   * Get the required size + padding for a buffer, rounded to the next 4-byte boundary.
+   * https://github.com/KhronosGroup/glTF/tree/master/specification/2.0#data-alignment
+   */
+
+
   getPaddedBufferSize(bufferSize) {
     return Math.ceil(bufferSize / 4) * 4;
   }
+  /**
+   * Returns a buffer aligned to 4-byte boundary.
+   *
+   * @param {ArrayBuffer} arrayBuffer Buffer to pad
+   * @param {Integer} paddingByte (Optional)
+   * @returns {ArrayBuffer} The same buffer if it's already aligned to 4-byte boundary or a new buffer
+   */
+
+
   getPaddedArrayBuffer(arrayBuffer, paddingByte = 0) {
     const paddedLength = this.getPaddedBufferSize(arrayBuffer.byteLength);
+
     if (paddedLength !== arrayBuffer.byteLength) {
       const array = new Uint8Array(paddedLength);
       array.set(new Uint8Array(arrayBuffer));
+
       if (paddingByte !== 0) {
         for (let i = arrayBuffer.byteLength; i < paddedLength; i++) {
           array[i] = paddingByte;
         }
       }
+
       return array.buffer;
     }
+
     return arrayBuffer;
   }
+
 }
+/**
+ * Punctual Lights Extension
+ *
+ * Specification: https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Khronos/KHR_lights_punctual
+ */
+
+
 class GLTFLightExtension {
   constructor(writer) {
+    _defineProperty(this, "writer", void 0);
+
+    _defineProperty(this, "name", void 0);
+
     this.writer = writer;
-    this.name = "KHR_lights_punctual";
+    this.name = 'KHR_lights_punctual';
   }
+
   writeNode(light, nodeDef) {
-    if (!light.isLight)
-      return;
-    if (!(light instanceof THREE.DirectionalLight && light.isDirectionalLight) && !(light instanceof THREE.PointLight && light.isPointLight) && !(light instanceof THREE.SpotLight && light.isSpotLight)) {
-      console.warn("THREE.GLTFExporter: Only directional, point, and spot lights are supported.", light);
+    if (!light.isLight) return;
+
+    if (!(light instanceof DirectionalLight && light.isDirectionalLight) && // @ts-expect-error
+    !(light instanceof PointLight && light.isPointLight) && !(light instanceof SpotLight && light.isSpotLight)) {
+      console.warn('THREE.GLTFExporter: Only directional, point, and spot lights are supported.', light);
       return;
     }
+
     const writer = this.writer;
     const json = writer.json;
     const extensionsUsed = writer.extensionsUsed;
     const lightDef = {};
-    if (light.name)
-      lightDef.name = light.name;
+    if (light.name) lightDef.name = light.name;
     lightDef.color = light.color.toArray();
     lightDef.intensity = light.intensity;
-    if (light instanceof THREE.DirectionalLight && light.isDirectionalLight) {
-      lightDef.type = "directional";
-    } else if (light instanceof THREE.PointLight && light.isPointLight) {
-      lightDef.type = "point";
-      if (light.distance > 0)
-        lightDef.range = light.distance;
-    } else if (light instanceof THREE.SpotLight && light.isSpotLight) {
-      lightDef.type = "spot";
-      if (light.distance > 0)
-        lightDef.range = light.distance;
+
+    if (light instanceof DirectionalLight && light.isDirectionalLight) {
+      lightDef.type = 'directional';
+    } else if (light instanceof PointLight && // @ts-expect-error
+    light.isPointLight) {
+      lightDef.type = 'point';
+      if (light.distance > 0) lightDef.range = light.distance;
+    } else if (light instanceof SpotLight && light.isSpotLight) {
+      lightDef.type = 'spot';
+      if (light.distance > 0) lightDef.range = light.distance;
       lightDef.spot = {};
-      lightDef.spot.innerConeAngle = (light.penumbra - 1) * light.angle * -1;
+      lightDef.spot.innerConeAngle = (light.penumbra - 1.0) * light.angle * -1.0;
       lightDef.spot.outerConeAngle = light.angle;
     }
-    if (!(light instanceof THREE.DirectionalLight) && light.decay !== void 0 && light.decay !== 2) {
-      console.warn(
-        "THREE.GLTFExporter: Light decay may be lost. glTF is physically-based, and expects light.decay=2."
-      );
+
+    if (!(light instanceof DirectionalLight) && light.decay !== undefined && light.decay !== 2) {
+      console.warn('THREE.GLTFExporter: Light decay may be lost. glTF is physically-based, ' + 'and expects light.decay=2.');
     }
-    if (!(light instanceof THREE.PointLight) && light.target && (light.target.parent !== light || light.target.position.x !== 0 || light.target.position.y !== 0 || light.target.position.z !== -1)) {
-      console.warn(
-        "THREE.GLTFExporter: Light direction may be lost. For best results, make light.target a child of the light with position 0,0,-1."
-      );
+
+    if (!(light instanceof PointLight) && light.target && (light.target.parent !== light || light.target.position.x !== 0 || light.target.position.y !== 0 || light.target.position.z !== -1)) {
+      console.warn('THREE.GLTFExporter: Light direction may be lost. For best results, ' + 'make light.target a child of the light with position 0,0,-1.');
     }
+
     if (!extensionsUsed[this.name]) {
       json.extensions = json.extensions || {};
-      json.extensions[this.name] = { lights: [] };
+      json.extensions[this.name] = {
+        lights: []
+      };
       extensionsUsed[this.name] = true;
     }
-    if (json.extensions !== void 0) {
+
+    if (json.extensions !== undefined) {
       const lights = json.extensions[this.name].lights;
       lights.push(lightDef);
       nodeDef.extensions = nodeDef.extensions || {};
-      nodeDef.extensions[this.name] = { light: lights.length - 1 };
+      nodeDef.extensions[this.name] = {
+        light: lights.length - 1
+      };
     }
   }
+
 }
+/**
+ * Unlit Materials Extension
+ *
+ * Specification: https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Khronos/KHR_materials_unlit
+ */
+
+
 class GLTFMaterialsUnlitExtension {
   constructor(writer) {
+    _defineProperty(this, "writer", void 0);
+
+    _defineProperty(this, "name", void 0);
+
     this.writer = writer;
-    this.name = "KHR_materials_unlit";
+    this.name = 'KHR_materials_unlit';
   }
+
   writeMaterial(material, materialDef) {
-    if (!(material instanceof THREE.MeshBasicMaterial && material.isMeshBasicMaterial)) {
+    if (!(material instanceof MeshBasicMaterial && // @ts-expect-error
+    material.isMeshBasicMaterial)) {
       return;
     }
+
     const writer = this.writer;
     const extensionsUsed = writer.extensionsUsed;
     materialDef.extensions = materialDef.extensions || {};
     materialDef.extensions[this.name] = {};
     extensionsUsed[this.name] = true;
-    materialDef.pbrMetallicRoughness.metallicFactor = 0;
+    materialDef.pbrMetallicRoughness.metallicFactor = 0.0;
     materialDef.pbrMetallicRoughness.roughnessFactor = 0.9;
   }
+
 }
+/**
+ * Specular-Glossiness Extension
+ *
+ * Specification: https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Khronos/KHR_materials_pbrSpecularGlossiness
+ */
+
+
 class GLTFMaterialsPBRSpecularGlossiness {
   constructor(writer) {
+    _defineProperty(this, "writer", void 0);
+
+    _defineProperty(this, "name", void 0);
+
     this.writer = writer;
-    this.name = "KHR_materials_pbrSpecularGlossiness";
+    this.name = 'KHR_materials_pbrSpecularGlossiness';
   }
+
   writeMaterial(material, materialDef) {
-    if (!material.isGLTFSpecularGlossinessMaterial)
-      return;
+    // @ts-expect-error
+    if (!material.isGLTFSpecularGlossinessMaterial) return;
     const writer = this.writer;
     const extensionsUsed = writer.extensionsUsed;
     const extensionDef = {};
+
     if (materialDef.pbrMetallicRoughness.baseColorFactor) {
       extensionDef.diffuseFactor = materialDef.pbrMetallicRoughness.baseColorFactor;
     }
-    if (material instanceof THREE.MeshPhongMaterial) {
+
+    if (material instanceof MeshPhongMaterial) {
       const specularFactor = [1, 1, 1];
       material.specular.toArray(specularFactor, 0);
       extensionDef.specularFactor = specularFactor;
-      extensionDef.glossinessFactor = material.glossiness;
+      extensionDef.glossinessFactor = // @ts-expect-error
+      material.glossiness;
     }
+
     if (materialDef.pbrMetallicRoughness.baseColorTexture) {
       extensionDef.diffuseTexture = materialDef.pbrMetallicRoughness.baseColorTexture;
     }
-    if ((material instanceof THREE.MeshBasicMaterial || material instanceof THREE.MeshLambertMaterial || material instanceof THREE.MeshPhongMaterial) && material.specularMap) {
-      const specularMapDef = { index: writer.processTexture(material.specularMap) };
+
+    if ((material instanceof MeshBasicMaterial || material instanceof MeshLambertMaterial || material instanceof MeshPhongMaterial) && material.specularMap) {
+      const specularMapDef = {
+        index: writer.processTexture(material.specularMap)
+      };
       writer.applyTextureTransform(specularMapDef, material.specularMap);
       extensionDef.specularGlossinessTexture = specularMapDef;
     }
+
     materialDef.extensions = materialDef.extensions || {};
     materialDef.extensions[this.name] = extensionDef;
     extensionsUsed[this.name] = true;
   }
+
 }
+/**
+ * Transmission Materials Extension
+ *
+ * Specification: https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Khronos/KHR_materials_transmission
+ */
+
+
 class GLTFMaterialsTransmissionExtension {
   constructor(writer) {
+    _defineProperty(this, "writer", void 0);
+
+    _defineProperty(this, "name", void 0);
+
     this.writer = writer;
-    this.name = "KHR_materials_transmission";
+    this.name = 'KHR_materials_transmission';
   }
+
   writeMaterial(material, materialDef) {
-    if (!(material instanceof THREE.MeshPhysicalMaterial && material.isMeshPhysicalMaterial) || material.transmission === 0) {
+    if (!(material instanceof MeshPhysicalMaterial && // @ts-expect-error
+    material.isMeshPhysicalMaterial) || material.transmission === 0) {
       return;
     }
+
     const writer = this.writer;
     const extensionsUsed = writer.extensionsUsed;
     const extensionDef = {};
     extensionDef.transmissionFactor = material.transmission;
+
     if (material.transmissionMap) {
-      const transmissionMapDef = { index: writer.processTexture(material.transmissionMap) };
+      const transmissionMapDef = {
+        index: writer.processTexture(material.transmissionMap)
+      };
       writer.applyTextureTransform(transmissionMapDef, material.transmissionMap);
       extensionDef.transmissionTexture = transmissionMapDef;
     }
+
     materialDef.extensions = materialDef.extensions || {};
     materialDef.extensions[this.name] = extensionDef;
     extensionsUsed[this.name] = true;
   }
+
 }
+/**
+ * Materials Volume Extension
+ *
+ * Specification: https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Khronos/KHR_materials_volume
+ */
+
+
 class GLTFMaterialsVolumeExtension {
   constructor(writer) {
+    _defineProperty(this, "writer", void 0);
+
+    _defineProperty(this, "name", void 0);
+
     this.writer = writer;
-    this.name = "KHR_materials_volume";
+    this.name = 'KHR_materials_volume';
   }
+
   writeMaterial(material, materialDef) {
-    if (!(material instanceof THREE.MeshPhysicalMaterial && material.isMeshPhysicalMaterial) || material.thickness === 0) {
+    if (!(material instanceof MeshPhysicalMaterial && // @ts-expect-error
+    material.isMeshPhysicalMaterial) || material.thickness === 0) {
       return;
     }
+
     const writer = this.writer;
     const extensionsUsed = writer.extensionsUsed;
     const extensionDef = {};
     extensionDef.thickness = material.thickness;
+
     if (material.thicknessMap) {
       const thicknessMapDef = {
         index: writer.processTexture(material.thicknessMap)
@@ -1371,11 +1918,15 @@ class GLTFMaterialsVolumeExtension {
       writer.applyTextureTransform(thicknessMapDef, material.thicknessMap);
       extensionDef.thicknessTexture = thicknessMapDef;
     }
+
     extensionDef.attenuationDistance = material.attenuationDistance;
-    extensionDef.attenuationColor = material.attenuationTint.toArray();
+    extensionDef.attenuationColor = //@ts-expect-error
+    material.attenuationTint.toArray();
     materialDef.extensions = materialDef.extensions || {};
     materialDef.extensions[this.name] = extensionDef;
     extensionsUsed[this.name] = true;
   }
+
 }
-exports.GLTFExporter = GLTFExporter;
+
+export { GLTFExporter };