minerender 2.1.0-alpha.66 → 2.1.0-alpha.68

package/dist/node/index.mjs

@@ -3598,7 +3598,7 @@ var init_InstanceReference = __esm({
 });
 
 // src/renderer/SceneObject.ts
-import { Color as Color2, Euler as Euler4, InstancedBufferAttribute, InstancedMesh, MathUtils, Matrix4 as Matrix44, Mesh as Mesh3, Object3D as Object3D2, Quaternion as Quaternion3, Vector3 as Vector36 } from "three";
+import { Color as Color2, Euler as Euler4, InstancedBufferAttribute, InstancedMesh, Matrix4 as Matrix44, Mesh as Mesh3, Object3D as Object3D2, Quaternion as Quaternion3, Vector3 as Vector36 } from "three";
 function isSceneObject(obj) {
   return obj.isSceneObject;
 }
@@ -4034,6 +4034,7 @@ var init_SceneObject = __esm({
       dispose() {
         this.disposeAndRemoveAllChildren();
         this.notifyDirty();
+        super.dispose();
       }
       disposeAndRemoveAllChildren() {
         if (this.instanceMesh) {
@@ -4247,6 +4248,7 @@ var init_EntityObject = __esm({
             else matrix.makeRotationFromEuler(new Euler5(...op.rotate, "ZYX"));
             modelRoot.matrix.multiply(matrix);
           }
+          modelRoot.matrixWorldNeedsUpdate = true;
           modelRoot.matrixAutoUpdate = false;
         } else if (this.options.flip ?? true) {
           modelRoot.scale.set(-1, -1, 1);
@@ -4333,8 +4335,8 @@ var init_EntityObject = __esm({
 // src/three/BufferGeometryUtils.js
 import {
   BufferAttribute as BufferAttribute4,
-  BufferGeometry as BufferGeometry2,
-  Float32BufferAttribute as Float32BufferAttribute4,
+  BufferGeometry as BufferGeometry3,
+  Float32BufferAttribute as Float32BufferAttribute5,
   InterleavedBuffer,
   InterleavedBufferAttribute,
   TriangleFanDrawMode,
@@ -4353,7 +4355,7 @@ function mergeBufferGeometries(geometries, useGroups = false) {
   const attributes = {};
   const morphAttributes = {};
   const morphTargetsRelative = geometries[0].morphTargetsRelative;
-  const mergedGeometry = new BufferGeometry2();
+  const mergedGeometry = new BufferGeometry3();
   let offset = 0;
   for (let i = 0; i < geometries.length; ++i) {
     const geometry = geometries[i];
@@ -4862,8 +4864,8 @@ function computeMorphedAttributes(object) {
       }
     }
   }
-  const morphedPositionAttribute = new Float32BufferAttribute4(modifiedPosition, 3);
-  const morphedNormalAttribute = new Float32BufferAttribute4(modifiedNormal, 3);
+  const morphedPositionAttribute = new Float32BufferAttribute5(modifiedPosition, 3);
+  const morphedNormalAttribute = new Float32BufferAttribute5(modifiedNormal, 3);
   return {
     positionAttribute,
     normalAttribute,
@@ -5163,6 +5165,7 @@ var init_ModelObject = __esm({
             for (const part of parts) {
               const object = new EntityObject(part.model, { flip: false, wireframe: this.options.wireframe });
               object.matrix.copy(transform).multiply(part.transform);
+              object.matrixWorldNeedsUpdate = true;
               object.matrixAutoUpdate = false;
               this.add(object);
               await object.init();
@@ -5356,7 +5359,7 @@ var init_fluidBlocks = __esm({
 });
 
 // src/model/fluid/FluidGeometry.ts
-import { BufferGeometry as BufferGeometry4, Float32BufferAttribute as Float32BufferAttribute5 } from "three";
+import { BufferGeometry as BufferGeometry5, Float32BufferAttribute as Float32BufferAttribute6 } from "three";
 function getBlockFluidState(key, state) {
   const rule = key && fluidRules[key.toNamespacedString()];
   if (rule) return {
@@ -5374,7 +5377,7 @@ function ownHeight(sample) {
   return (level === 0 || level >= 8 ? 8 : 8 - level) / 9;
 }
 function createFluidGeometry(kind, sample) {
-  const geometry = new BufferGeometry4();
+  const geometry = new BufferGeometry5();
   const positions = [], normals = [], uvs = [], indices = [];
   const self = sample(0, 0, 0);
   const height = (x, z) => {
@@ -5473,9 +5476,9 @@ function createFluidGeometry(kind, sample) {
       1
     );
   }
-  geometry.setAttribute("position", new Float32BufferAttribute5(positions, 3));
-  geometry.setAttribute("normal", new Float32BufferAttribute5(normals, 3));
-  geometry.setAttribute("uv", new Float32BufferAttribute5(uvs, 2));
+  geometry.setAttribute("position", new Float32BufferAttribute6(positions, 3));
+  geometry.setAttribute("normal", new Float32BufferAttribute6(normals, 3));
+  geometry.setAttribute("uv", new Float32BufferAttribute6(uvs, 2));
   geometry.setIndex(indices);
   return geometry;
 }
@@ -5834,16 +5837,26 @@ init_EntityObject();
 init_MineRenderError();
 
 // src/export/SceneExporter.ts
-import { ClampToEdgeWrapping as ClampToEdgeWrapping2, Color as Color7, Float32BufferAttribute as Float32BufferAttribute3, Matrix4 as Matrix47, Mesh as Mesh5, MeshBasicMaterial as MeshBasicMaterial2, NearestFilter as NearestFilter3, RGBAFormat as RGBAFormat3, Scene as Scene4, Source as Source2, Texture as Texture4, UnsignedByteType } from "three";
+import { ClampToEdgeWrapping as ClampToEdgeWrapping2, Color as Color7, Float32BufferAttribute as Float32BufferAttribute3, Matrix4 as Matrix47, Mesh as Mesh4, MeshBasicMaterial as MeshBasicMaterial2, NearestFilter as NearestFilter3, RGBAFormat as RGBAFormat3, Scene as Scene3, TextureSource as TextureSource2, Texture as Texture3, UnsignedByteType } from "three";
 
 // ../../node_modules/three/examples/jsm/exporters/OBJExporter.js
 import {
   Color as Color4,
+  ColorManagement,
   Matrix3,
+  SRGBColorSpace as SRGBColorSpace3,
   Vector2 as Vector22,
   Vector3 as Vector37
 } from "three";
 var OBJExporter = class {
+  /**
+   * Parses the given 3D object and generates the OBJ output.
+   *
+   * If the 3D object is composed of multiple children and geometry, they are merged into a single mesh in the file.
+   *
+   * @param {Object3D} object - The 3D object to export.
+   * @return {string} The exported OBJ.
+   */
   parse(object) {
     let output = "";
     let indexVertex = 0;
@@ -5949,7 +5962,8 @@ var OBJExporter = class {
           vertex.applyMatrix4(points.matrixWorld);
           output += "v " + vertex.x + " " + vertex.y + " " + vertex.z;
           if (colors !== void 0) {
-            color.fromBufferAttribute(colors, i).convertLinearToSRGB();
+            color.fromBufferAttribute(colors, i);
+            ColorManagement.workingToColorSpace(color, SRGBColorSpace3);
             output += " " + color.r + " " + color.g + " " + color.b;
           }
           output += "\n";
@@ -5981,9 +5995,21 @@ var OBJExporter = class {
 import {
   Matrix3 as Matrix32,
   Vector3 as Vector38,
-  Color as Color5
+  Color as Color5,
+  ColorManagement as ColorManagement2,
+  SRGBColorSpace as SRGBColorSpace4
 } from "three";
 var PLYExporter = class {
+  /**
+   * Parses the given 3D object and generates the PLY output.
+   *
+   * If the 3D object is composed of multiple children and geometry, they are merged into a single mesh in the file.
+   *
+   * @param {Object3D} object - The 3D object to export.
+   * @param {PLYExporter~OnDone} onDone - A callback function that is executed when the export has finished.
+   * @param {PLYExporter~Options} options - The export options.
+   * @return {?(string|ArrayBuffer)} The exported PLY.
+   */
   parse(object, onDone, options = {}) {
     function traverseMeshes(cb) {
       object.traverse(function(child) {
@@ -6000,14 +6026,23 @@ var PLYExporter = class {
       binary: false,
       excludeAttributes: [],
       // normal, uv, color, index
-      littleEndian: false
+      littleEndian: false,
+      customPropertyMapping: {}
     };
     options = Object.assign(defaultOptions, options);
     const excludeAttributes = options.excludeAttributes;
+    const customPropertyMapping = options.customPropertyMapping;
+    const customAttributeNames = Object.keys(customPropertyMapping);
     let includeIndices = true;
     let includeNormals = false;
     let includeColors = false;
     let includeUVs = false;
+    let positionType = "float";
+    let normalType = "float";
+    let uvType = "float";
+    let colorType = "uchar";
+    const customTypes = {};
+    for (const name of customAttributeNames) customTypes[name] = "float";
     let vertexCount = 0;
     let faceCount = 0;
     object.traverse(function(child) {
@@ -6024,9 +6059,23 @@ var PLYExporter = class {
         }
         vertexCount += vertices.count;
         faceCount += indices ? indices.count / 3 : vertices.count / 3;
-        if (normals !== void 0) includeNormals = true;
-        if (uvs !== void 0) includeUVs = true;
-        if (colors !== void 0) includeColors = true;
+        positionType = getPlyType(vertices.array);
+        if (normals !== void 0) {
+          includeNormals = true;
+          normalType = getPlyType(normals.array);
+        }
+        if (uvs !== void 0) {
+          includeUVs = true;
+          uvType = getPlyType(uvs.array);
+        }
+        if (colors !== void 0) {
+          includeColors = true;
+          colorType = getPlyType(colors.array);
+        }
+        for (const name of customAttributeNames) {
+          const attr = geometry.getAttribute(name);
+          if (attr !== void 0) customTypes[name] = getPlyType(attr.array);
+        }
       } else if (child.isPoints) {
         const mesh = child;
         const geometry = mesh.geometry;
@@ -6034,8 +6083,19 @@ var PLYExporter = class {
         const normals = geometry.getAttribute("normal");
         const colors = geometry.getAttribute("color");
         vertexCount += vertices.count;
-        if (normals !== void 0) includeNormals = true;
-        if (colors !== void 0) includeColors = true;
+        positionType = getPlyType(vertices.array);
+        if (normals !== void 0) {
+          includeNormals = true;
+          normalType = getPlyType(normals.array);
+        }
+        if (colors !== void 0) {
+          includeColors = true;
+          colorType = getPlyType(colors.array);
+        }
+        for (const name of customAttributeNames) {
+          const attr = geometry.getAttribute(name);
+          if (attr !== void 0) customTypes[name] = getPlyType(attr.array);
+        }
         includeIndices = false;
       }
     });
@@ -6054,18 +6114,33 @@ var PLYExporter = class {
     let header = `ply
 format ${options.binary ? options.littleEndian ? "binary_little_endian" : "binary_big_endian" : "ascii"} 1.0
 element vertex ${vertexCount}
-property float x
-property float y
-property float z
+property ${positionType} x
+property ${positionType} y
+property ${positionType} z
 `;
     if (includeNormals === true) {
-      header += "property float nx\nproperty float ny\nproperty float nz\n";
+      header += `property ${normalType} nx
+property ${normalType} ny
+property ${normalType} nz
+`;
     }
     if (includeUVs === true) {
-      header += "property float s\nproperty float t\n";
+      header += `property ${uvType} s
+property ${uvType} t
+`;
     }
     if (includeColors === true) {
-      header += "property uchar red\nproperty uchar green\nproperty uchar blue\n";
+      header += `property ${colorType} red
+property ${colorType} green
+property ${colorType} blue
+`;
+    }
+    for (const name of customAttributeNames) {
+      const type = customTypes[name];
+      for (const propName of customPropertyMapping[name]) {
+        header += `property ${type} ${propName}
+`;
+      }
     }
     if (includeIndices === true) {
       header += `element face ${faceCount}
@@ -6078,7 +6153,23 @@ property list uchar int vertex_index
     let result = null;
     if (options.binary === true) {
       const headerBin = new TextEncoder().encode(header);
-      const vertexListLength = vertexCount * (4 * 3 + (includeNormals ? 4 * 3 : 0) + (includeColors ? 3 : 0) + (includeUVs ? 4 * 2 : 0));
+      const posWriter = getBinaryWriter(positionType);
+      const normalWriter = includeNormals ? getBinaryWriter(normalType) : null;
+      const uvWriter = includeUVs ? getBinaryWriter(uvType) : null;
+      const colorWriter = includeColors ? getBinaryWriter(colorType) : null;
+      const colorIsFloat = isFloatType(colorType);
+      const colorScale = getColorScale(colorType);
+      const customWriters = {};
+      const customIsFloat = {};
+      let customStride = 0;
+      for (const name of customAttributeNames) {
+        const type = customTypes[name];
+        const writer = getBinaryWriter(type);
+        customWriters[name] = writer;
+        customIsFloat[name] = isFloatType(type);
+        customStride += customPropertyMapping[name].length * writer.size;
+      }
+      const vertexListLength = vertexCount * (3 * posWriter.size + (includeNormals ? 3 * normalWriter.size : 0) + (includeUVs ? 2 * uvWriter.size : 0) + (includeColors ? 3 * colorWriter.size : 0) + customStride);
       const faceListLength = includeIndices ? faceCount * (indexByteCount * 3 + 1) : 0;
       const output = new DataView(new ArrayBuffer(headerBin.length + vertexListLength + faceListLength));
       new Uint8Array(output.buffer).set(headerBin, 0);
@@ -6095,60 +6186,76 @@ property list uchar int vertex_index
         for (let i = 0, l = vertices.count; i < l; i++) {
           vertex.fromBufferAttribute(vertices, i);
           vertex.applyMatrix4(mesh.matrixWorld);
-          output.setFloat32(vOffset, vertex.x, options.littleEndian);
-          vOffset += 4;
-          output.setFloat32(vOffset, vertex.y, options.littleEndian);
-          vOffset += 4;
-          output.setFloat32(vOffset, vertex.z, options.littleEndian);
-          vOffset += 4;
+          posWriter.write(output, vOffset, vertex.x, options.littleEndian);
+          vOffset += posWriter.size;
+          posWriter.write(output, vOffset, vertex.y, options.littleEndian);
+          vOffset += posWriter.size;
+          posWriter.write(output, vOffset, vertex.z, options.littleEndian);
+          vOffset += posWriter.size;
           if (includeNormals === true) {
             if (normals != null) {
               vertex.fromBufferAttribute(normals, i);
               vertex.applyMatrix3(normalMatrixWorld).normalize();
-              output.setFloat32(vOffset, vertex.x, options.littleEndian);
-              vOffset += 4;
-              output.setFloat32(vOffset, vertex.y, options.littleEndian);
-              vOffset += 4;
-              output.setFloat32(vOffset, vertex.z, options.littleEndian);
-              vOffset += 4;
+              normalWriter.write(output, vOffset, vertex.x, options.littleEndian);
+              vOffset += normalWriter.size;
+              normalWriter.write(output, vOffset, vertex.y, options.littleEndian);
+              vOffset += normalWriter.size;
+              normalWriter.write(output, vOffset, vertex.z, options.littleEndian);
+              vOffset += normalWriter.size;
             } else {
-              output.setFloat32(vOffset, 0, options.littleEndian);
-              vOffset += 4;
-              output.setFloat32(vOffset, 0, options.littleEndian);
-              vOffset += 4;
-              output.setFloat32(vOffset, 0, options.littleEndian);
-              vOffset += 4;
+              normalWriter.write(output, vOffset, 0, options.littleEndian);
+              vOffset += normalWriter.size;
+              normalWriter.write(output, vOffset, 0, options.littleEndian);
+              vOffset += normalWriter.size;
+              normalWriter.write(output, vOffset, 0, options.littleEndian);
+              vOffset += normalWriter.size;
             }
           }
           if (includeUVs === true) {
             if (uvs != null) {
-              output.setFloat32(vOffset, uvs.getX(i), options.littleEndian);
-              vOffset += 4;
-              output.setFloat32(vOffset, uvs.getY(i), options.littleEndian);
-              vOffset += 4;
+              uvWriter.write(output, vOffset, uvs.getX(i), options.littleEndian);
+              vOffset += uvWriter.size;
+              uvWriter.write(output, vOffset, uvs.getY(i), options.littleEndian);
+              vOffset += uvWriter.size;
             } else {
-              output.setFloat32(vOffset, 0, options.littleEndian);
-              vOffset += 4;
-              output.setFloat32(vOffset, 0, options.littleEndian);
-              vOffset += 4;
+              uvWriter.write(output, vOffset, 0, options.littleEndian);
+              vOffset += uvWriter.size;
+              uvWriter.write(output, vOffset, 0, options.littleEndian);
+              vOffset += uvWriter.size;
             }
           }
           if (includeColors === true) {
             if (colors != null) {
-              tempColor.fromBufferAttribute(colors, i).convertLinearToSRGB();
-              output.setUint8(vOffset, Math.floor(tempColor.r * 255));
-              vOffset += 1;
-              output.setUint8(vOffset, Math.floor(tempColor.g * 255));
-              vOffset += 1;
-              output.setUint8(vOffset, Math.floor(tempColor.b * 255));
-              vOffset += 1;
+              tempColor.fromBufferAttribute(colors, i);
+              ColorManagement2.workingToColorSpace(tempColor, SRGBColorSpace4);
+              const r = colorIsFloat ? tempColor.r : Math.round(tempColor.r * colorScale);
+              const g = colorIsFloat ? tempColor.g : Math.round(tempColor.g * colorScale);
+              const b = colorIsFloat ? tempColor.b : Math.round(tempColor.b * colorScale);
+              colorWriter.write(output, vOffset, r, options.littleEndian);
+              vOffset += colorWriter.size;
+              colorWriter.write(output, vOffset, g, options.littleEndian);
+              vOffset += colorWriter.size;
+              colorWriter.write(output, vOffset, b, options.littleEndian);
+              vOffset += colorWriter.size;
             } else {
-              output.setUint8(vOffset, 255);
-              vOffset += 1;
-              output.setUint8(vOffset, 255);
-              vOffset += 1;
-              output.setUint8(vOffset, 255);
-              vOffset += 1;
+              const white = colorIsFloat ? 1 : colorScale;
+              colorWriter.write(output, vOffset, white, options.littleEndian);
+              vOffset += colorWriter.size;
+              colorWriter.write(output, vOffset, white, options.littleEndian);
+              vOffset += colorWriter.size;
+              colorWriter.write(output, vOffset, white, options.littleEndian);
+              vOffset += colorWriter.size;
+            }
+          }
+          for (const name of customAttributeNames) {
+            const writer = customWriters[name];
+            const propCount = customPropertyMapping[name].length;
+            const attr = geometry.getAttribute(name);
+            const isFloat = customIsFloat[name];
+            for (let c = 0; c < propCount; c++) {
+              const raw = attr != null ? getAttributeComponent(attr, i, c) : 0;
+              writer.write(output, vOffset, isFloat ? raw : Math.round(raw), options.littleEndian);
+              vOffset += writer.size;
             }
           }
         }
@@ -6184,6 +6291,14 @@ property list uchar int vertex_index
       let writtenVertices = 0;
       let vertexList = "";
       let faceList = "";
+      const positionIsFloat = isFloatType(positionType);
+      const normalIsFloat = isFloatType(normalType);
+      const uvIsFloat = isFloatType(uvType);
+      const colorIsFloat = isFloatType(colorType);
+      const colorScale = getColorScale(colorType);
+      const customIsFloat = {};
+      for (const name of customAttributeNames) customIsFloat[name] = isFloatType(customTypes[name]);
+      const encode = (v, isFloat) => isFloat ? v : Math.round(v);
       traverseMeshes(function(mesh, geometry) {
         const vertices = geometry.getAttribute("position");
         const normals = geometry.getAttribute("normal");
@@ -6194,29 +6309,43 @@ property list uchar int vertex_index
         for (let i = 0, l = vertices.count; i < l; i++) {
           vertex.fromBufferAttribute(vertices, i);
           vertex.applyMatrix4(mesh.matrixWorld);
-          let line = vertex.x + " " + vertex.y + " " + vertex.z;
+          let line = encode(vertex.x, positionIsFloat) + " " + encode(vertex.y, positionIsFloat) + " " + encode(vertex.z, positionIsFloat);
           if (includeNormals === true) {
             if (normals != null) {
               vertex.fromBufferAttribute(normals, i);
               vertex.applyMatrix3(normalMatrixWorld).normalize();
-              line += " " + vertex.x + " " + vertex.y + " " + vertex.z;
+              line += " " + encode(vertex.x, normalIsFloat) + " " + encode(vertex.y, normalIsFloat) + " " + encode(vertex.z, normalIsFloat);
             } else {
               line += " 0 0 0";
             }
           }
           if (includeUVs === true) {
             if (uvs != null) {
-              line += " " + uvs.getX(i) + " " + uvs.getY(i);
+              line += " " + encode(uvs.getX(i), uvIsFloat) + " " + encode(uvs.getY(i), uvIsFloat);
             } else {
               line += " 0 0";
             }
           }
           if (includeColors === true) {
             if (colors != null) {
-              tempColor.fromBufferAttribute(colors, i).convertLinearToSRGB();
-              line += " " + Math.floor(tempColor.r * 255) + " " + Math.floor(tempColor.g * 255) + " " + Math.floor(tempColor.b * 255);
+              tempColor.fromBufferAttribute(colors, i);
+              ColorManagement2.workingToColorSpace(tempColor, SRGBColorSpace4);
+              const r = colorIsFloat ? tempColor.r : Math.round(tempColor.r * colorScale);
+              const g = colorIsFloat ? tempColor.g : Math.round(tempColor.g * colorScale);
+              const b = colorIsFloat ? tempColor.b : Math.round(tempColor.b * colorScale);
+              line += ` ${r} ${g} ${b}`;
             } else {
-              line += " 255 255 255";
+              const white = colorIsFloat ? 1 : colorScale;
+              line += ` ${white} ${white} ${white}`;
+            }
+          }
+          for (const name of customAttributeNames) {
+            const propCount = customPropertyMapping[name].length;
+            const attr = geometry.getAttribute(name);
+            const isFloat = customIsFloat[name];
+            for (let c = 0; c < propCount; c++) {
+              const raw = attr != null ? getAttributeComponent(attr, i, c) : 0;
+              line += " " + encode(raw, isFloat);
             }
           }
           vertexList += line + "\n";
@@ -6246,6 +6375,62 @@ property list uchar int vertex_index
     return result;
   }
 };
+function getPlyType(array) {
+  if (array instanceof Int8Array) return "char";
+  if (array instanceof Uint8Array || array instanceof Uint8ClampedArray) return "uchar";
+  if (array instanceof Int16Array) return "short";
+  if (array instanceof Uint16Array) return "ushort";
+  if (array instanceof Int32Array) return "int";
+  if (array instanceof Uint32Array) return "uint";
+  if (array instanceof Float32Array) return "float";
+  if (array instanceof Float64Array) return "double";
+  return "float";
+}
+function getBinaryWriter(type) {
+  switch (type) {
+    case "char":
+      return { write: (dv, at, v) => dv.setInt8(at, v), size: 1 };
+    case "uchar":
+      return { write: (dv, at, v) => dv.setUint8(at, v), size: 1 };
+    case "short":
+      return { write: (dv, at, v, le) => dv.setInt16(at, v, le), size: 2 };
+    case "ushort":
+      return { write: (dv, at, v, le) => dv.setUint16(at, v, le), size: 2 };
+    case "int":
+      return { write: (dv, at, v, le) => dv.setInt32(at, v, le), size: 4 };
+    case "uint":
+      return { write: (dv, at, v, le) => dv.setUint32(at, v, le), size: 4 };
+    case "float":
+      return { write: (dv, at, v, le) => dv.setFloat32(at, v, le), size: 4 };
+    case "double":
+      return { write: (dv, at, v, le) => dv.setFloat64(at, v, le), size: 8 };
+  }
+}
+function isFloatType(type) {
+  return type === "float" || type === "double";
+}
+function getAttributeComponent(attr, i, c) {
+  switch (c) {
+    case 0:
+      return attr.getX(i);
+    case 1:
+      return attr.getY(i);
+    case 2:
+      return attr.getZ(i);
+    case 3:
+      return attr.getW(i);
+  }
+}
+function getColorScale(type) {
+  switch (type) {
+    case "uchar":
+      return 255;
+    case "ushort":
+      return 65535;
+    default:
+      return 1;
+  }
+}
 
 // ../../node_modules/three/examples/jsm/exporters/GLTFExporter.js
 import {
@@ -6259,7 +6444,7 @@ import {
   LinearFilter,
   LinearMipmapLinearFilter,
   LinearMipmapNearestFilter,
-  MathUtils as MathUtils2,
+  MathUtils,
   Matrix4 as Matrix46,
   MirroredRepeatWrapping,
   NearestFilter as NearestFilter2,
@@ -6268,84 +6453,15 @@ import {
   PropertyBinding,
   RGBAFormat as RGBAFormat2,
   RepeatWrapping as RepeatWrapping2,
-  Scene as Scene3,
-  Source,
-  SRGBColorSpace as SRGBColorSpace4,
+  Scene as Scene2,
+  SRGBColorSpace as SRGBColorSpace5,
+  TextureSource,
   CompressedTexture,
   Vector3 as Vector39,
-  Quaternion as Quaternion4
-} from "three";
-
-// ../../node_modules/three/examples/jsm/utils/TextureUtils.js
-import {
-  PlaneGeometry,
-  ShaderMaterial as ShaderMaterial2,
-  Uniform,
-  Mesh as Mesh4,
-  PerspectiveCamera,
-  Scene as Scene2,
-  WebGLRenderer,
-  Texture as Texture3,
-  SRGBColorSpace as SRGBColorSpace3
+  Quaternion as Quaternion4,
+  REVISION,
+  ImageUtils
 } from "three";
-var _renderer;
-var fullscreenQuadGeometry;
-var fullscreenQuadMaterial;
-var fullscreenQuad;
-function decompress(texture, maxTextureSize = Infinity, renderer = null) {
-  if (!fullscreenQuadGeometry) fullscreenQuadGeometry = new PlaneGeometry(2, 2, 1, 1);
-  if (!fullscreenQuadMaterial) fullscreenQuadMaterial = new ShaderMaterial2({
-    uniforms: { blitTexture: new Uniform(texture) },
-    vertexShader: `
-            varying vec2 vUv;
-            void main(){
-                vUv = uv;
-                gl_Position = vec4(position.xy * 1.0,0.,.999999);
-            }`,
-    fragmentShader: `
-            uniform sampler2D blitTexture; 
-            varying vec2 vUv;
-
-            void main(){ 
-                gl_FragColor = vec4(vUv.xy, 0, 1);
-                
-                #ifdef IS_SRGB
-                gl_FragColor = LinearTosRGB( texture2D( blitTexture, vUv) );
-                #else
-                gl_FragColor = texture2D( blitTexture, vUv);
-                #endif
-            }`
-  });
-  fullscreenQuadMaterial.uniforms.blitTexture.value = texture;
-  fullscreenQuadMaterial.defines.IS_SRGB = texture.colorSpace == SRGBColorSpace3;
-  fullscreenQuadMaterial.needsUpdate = true;
-  if (!fullscreenQuad) {
-    fullscreenQuad = new Mesh4(fullscreenQuadGeometry, fullscreenQuadMaterial);
-    fullscreenQuad.frustrumCulled = false;
-  }
-  const _camera = new PerspectiveCamera();
-  const _scene = new Scene2();
-  _scene.add(fullscreenQuad);
-  if (!renderer) {
-    renderer = _renderer = new WebGLRenderer({ antialias: false });
-  }
-  renderer.setSize(Math.min(texture.image.width, maxTextureSize), Math.min(texture.image.height, maxTextureSize));
-  renderer.clear();
-  renderer.render(_scene, _camera);
-  const readableTexture = new Texture3(renderer.domElement);
-  readableTexture.minFilter = texture.minFilter;
-  readableTexture.magFilter = texture.magFilter;
-  readableTexture.wrapS = texture.wrapS;
-  readableTexture.wrapT = texture.wrapT;
-  readableTexture.name = texture.name;
-  if (_renderer) {
-    _renderer.dispose();
-    _renderer = null;
-  }
-  return readableTexture;
-}
-
-// ../../node_modules/three/examples/jsm/exporters/GLTFExporter.js
 var KHR_mesh_quantization_ExtraAttrTypes = {
   POSITION: [
     "byte",
@@ -6375,7 +6491,11 @@ var KHR_mesh_quantization_ExtraAttrTypes = {
   ]
 };
 var GLTFExporter = class {
+  /**
+   * Constructs a new glTF exporter.
+   */
   constructor() {
+    this.textureUtils = null;
     this.pluginCallbacks = [];
     this.register(function(writer) {
       return new GLTFLightExtension(writer);
@@ -6398,6 +6518,9 @@ var GLTFExporter = class {
     this.register(function(writer) {
       return new GLTFMaterialsClearcoatExtension(writer);
     });
+    this.register(function(writer) {
+      return new GLTFMaterialsDispersionExtension(writer);
+    });
     this.register(function(writer) {
       return new GLTFMaterialsIridescenceExtension(writer);
     });
@@ -6410,16 +6533,33 @@ var GLTFExporter = class {
     this.register(function(writer) {
       return new GLTFMaterialsEmissiveStrengthExtension(writer);
     });
+    this.register(function(writer) {
+      return new GLTFMaterialsBumpExtension(writer);
+    });
     this.register(function(writer) {
       return new GLTFMeshGpuInstancing(writer);
     });
   }
+  /**
+   * 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 exporter.
+   *
+   * @param {function(writer:GLTFWriter)} callback - The callback function to register.
+   * @return {GLTFExporter} A reference to this exporter.
+   */
   register(callback) {
     if (this.pluginCallbacks.indexOf(callback) === -1) {
       this.pluginCallbacks.push(callback);
     }
     return this;
   }
+  /**
+   * Unregisters a plugin callback.
+   *
+   * @param {Function} callback - The callback function to unregister.
+   * @return {GLTFExporter} A reference to this exporter.
+   */
   unregister(callback) {
     if (this.pluginCallbacks.indexOf(callback) !== -1) {
       this.pluginCallbacks.splice(this.pluginCallbacks.indexOf(callback), 1);
@@ -6427,11 +6567,25 @@ var GLTFExporter = class {
     return this;
   }
   /**
-   * 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  {Function} onError  Callback on errors
-   * @param  {Object} options options
+   * Sets the texture utils for this exporter. Only relevant when compressed textures have to be exported.
+   *
+   * Depending on whether you use {@link WebGLRenderer} or {@link WebGPURenderer}, you must inject the
+   * corresponding texture utils {@link module:WebGLTextureUtils} or {@link module:WebGPUTextureUtils}.
+   *
+   * @param {WebGLTextureUtils|WebGPUTextureUtils} utils - The texture utils.
+   * @return {GLTFExporter} A reference to this exporter.
+   */
+  setTextureUtils(utils) {
+    this.textureUtils = utils;
+    return this;
+  }
+  /**
+   * Parses the given scenes and generates the glTF output.
+   *
+   * @param {Scene|Array<Scene>} input - A scene or an array of scenes.
+   * @param {GLTFExporter~OnDone} onDone - A callback function that is executed when the export has finished.
+   * @param {GLTFExporter~OnError} onError - A callback function that is executed when an error happens.
+   * @param {GLTFExporter~Options} options - options
    */
   parse(input, onDone, onError, options) {
     const writer = new GLTFWriter();
@@ -6440,8 +6594,16 @@ var GLTFExporter = class {
       plugins.push(this.pluginCallbacks[i](writer));
     }
     writer.setPlugins(plugins);
-    writer.write(input, onDone, options).catch(onError);
+    writer.setTextureUtils(this.textureUtils);
+    writer.writeAsync(input, onDone, options).catch(onError);
   }
+  /**
+   * Async version of {@link GLTFExporter#parse}.
+   *
+   * @param {Scene|Array<Scene>} input - A scene or an array of scenes.
+   * @param {GLTFExporter~Options} options - options.
+   * @return {Promise<ArrayBuffer|string>} A Promise that resolved with the exported glTF data.
+   */
   parseAsync(input, options) {
     const scope = this;
     return new Promise(function(resolve, reject) {
@@ -6527,7 +6689,7 @@ function getMinMax(attribute, start, count) {
         else if (a === 2) value = attribute.getZ(i);
         else if (a === 3) value = attribute.getW(i);
         if (attribute.normalized === true) {
-          value = MathUtils2.normalize(value, attribute.array);
+          value = MathUtils.normalize(value, attribute.array);
         }
       }
       output.min[a] = Math.min(output.min[a], value);
@@ -6560,19 +6722,20 @@ function getCanvas() {
   return document.createElement("canvas");
 }
 function getToBlobPromise(canvas, mimeType) {
-  if (canvas.toBlob !== void 0) {
+  if (typeof OffscreenCanvas !== "undefined" && canvas instanceof OffscreenCanvas) {
+    let quality;
+    if (mimeType === "image/jpeg") {
+      quality = 0.92;
+    } else if (mimeType === "image/webp") {
+      quality = 0.8;
+    }
+    return canvas.convertToBlob({
+      type: mimeType,
+      quality
+    });
+  } else {
     return new Promise((resolve) => canvas.toBlob(resolve, mimeType));
   }
-  let quality;
-  if (mimeType === "image/jpeg") {
-    quality = 0.92;
-  } else if (mimeType === "image/webp") {
-    quality = 0.8;
-  }
-  return canvas.convertToBlob({
-    type: mimeType,
-    quality
-  });
 }
 var GLTFWriter = class {
   constructor() {
@@ -6591,7 +6754,7 @@ var GLTFWriter = class {
     this.json = {
       asset: {
         version: "2.0",
-        generator: "THREE.GLTFExporter"
+        generator: "THREE.GLTFExporter r" + REVISION
       }
     };
     this.cache = {
@@ -6600,19 +6763,25 @@ var GLTFWriter = class {
       attributesNormalized: /* @__PURE__ */ new Map(),
       materials: /* @__PURE__ */ new Map(),
       textures: /* @__PURE__ */ new Map(),
-      images: /* @__PURE__ */ new Map()
+      images: /* @__PURE__ */ new Map(),
+      normalMaps: /* @__PURE__ */ new Map()
     };
+    this.textureUtils = null;
   }
   setPlugins(plugins) {
     this.plugins = plugins;
   }
+  setTextureUtils(utils) {
+    this.textureUtils = utils;
+  }
   /**
    * 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
+   *
+   * @param {Scene|Array<Scene>} input Scene or Array of THREE.Scenes
+   * @param {Function} onDone Callback on completed
+   * @param {Object} options options
    */
-  async write(input, onDone, options = {}) {
+  async writeAsync(input, onDone, options = {}) {
     this.options = Object.assign({
       // default options
       binary: false,
@@ -6620,12 +6789,13 @@ var GLTFWriter = class {
       onlyVisible: true,
       maxTextureSize: Infinity,
       animations: [],
-      includeCustomExtensions: false
+      includeCustomExtensions: false,
+      copyright: null
     }, options);
     if (this.options.animations.length > 0) {
       this.options.trs = true;
     }
-    this.processInput(input);
+    await this.processInputAsync(input);
     await Promise.all(this.pending);
     const writer = this;
     const buffers = writer.buffers;
@@ -6639,6 +6809,7 @@ var GLTFWriter = class {
     if (extensionsUsedList.length > 0) json.extensionsUsed = extensionsUsedList;
     if (extensionsRequiredList.length > 0) json.extensionsRequired = extensionsRequiredList;
     if (json.buffers && json.buffers.length > 0) json.buffers[0].byteLength = blob.size;
+    if (options.copyright) json.asset.copyright = options.copyright;
     if (options.binary === true) {
       const reader = new FileReader();
       reader.readAsArrayBuffer(blob);
@@ -6687,7 +6858,7 @@ var GLTFWriter = class {
   /**
    * Serializes a userData.
    *
-   * @param {THREE.Object3D|THREE.Material} object
+   * @param {THREE.Object3D|THREE.Material|THREE.BufferGeometry|THREE.AnimationClip} object
    * @param {Object} objectDef
    */
   serializeUserData(object, objectDef) {
@@ -6711,8 +6882,10 @@ var GLTFWriter = class {
   }
   /**
    * Returns ids for buffer attributes.
-   * @param  {Object} object
-   * @return {Integer}
+   *
+   * @param {Object} attribute
+   * @param {boolean} [isRelativeCopy=false]
+   * @return {number} An integer
    */
   getUID(attribute, isRelativeCopy = false) {
     if (this.uids.has(attribute) === false) {
@@ -6728,7 +6901,7 @@ var GLTFWriter = class {
    * Checks if normal attribute values are normalized.
    *
    * @param {BufferAttribute} normal
-   * @returns {Boolean}
+   * @returns {boolean}
    */
   isNormalizedNormalAttribute(normal) {
     const cache = this.cache;
@@ -6791,10 +6964,10 @@ var GLTFWriter = class {
       this.extensionsUsed["KHR_texture_transform"] = true;
     }
   }
-  buildMetalRoughTexture(metalnessMap, roughnessMap) {
+  async buildMetalRoughTextureAsync(metalnessMap, roughnessMap) {
     if (metalnessMap === roughnessMap) return metalnessMap;
     function getEncodingConversion(map) {
-      if (map.colorSpace === SRGBColorSpace4) {
+      if (map.colorSpace === SRGBColorSpace5) {
         return function SRGBToLinear(c) {
           return c < 0.04045 ? c * 0.0773993808 : Math.pow(c * 0.9478672986 + 0.0521327014, 2.4);
         };
@@ -6803,12 +6976,11 @@ var GLTFWriter = class {
         return c;
       };
     }
-    console.warn("THREE.GLTFExporter: Merged metalnessMap and roughnessMap textures.");
     if (metalnessMap instanceof CompressedTexture) {
-      metalnessMap = decompress(metalnessMap);
+      metalnessMap = await this.decompressTextureAsync(metalnessMap);
     }
     if (roughnessMap instanceof CompressedTexture) {
-      roughnessMap = decompress(roughnessMap);
+      roughnessMap = await this.decompressTextureAsync(roughnessMap);
     }
     const metalness = metalnessMap ? metalnessMap.image : null;
     const roughness = roughnessMap ? roughnessMap.image : null;
@@ -6817,7 +6989,9 @@ var GLTFWriter = class {
     const canvas = getCanvas();
     canvas.width = width;
     canvas.height = height;
-    const context = canvas.getContext("2d");
+    const context = canvas.getContext("2d", {
+      willReadFrequently: true
+    });
     context.fillStyle = "#00ffff";
     context.fillRect(0, 0, width, height);
     const composite = context.getImageData(0, 0, width, height);
@@ -6840,18 +7014,60 @@ var GLTFWriter = class {
     context.putImageData(composite, 0, 0);
     const reference = metalnessMap || roughnessMap;
     const texture = reference.clone();
-    texture.source = new Source(canvas);
+    texture.source = new TextureSource(canvas);
     texture.colorSpace = NoColorSpace;
     texture.channel = (metalnessMap || roughnessMap).channel;
     if (metalnessMap && roughnessMap && metalnessMap.channel !== roughnessMap.channel) {
       console.warn("THREE.GLTFExporter: UV channels for metalnessMap and roughnessMap textures must match.");
     }
+    console.warn("THREE.GLTFExporter: Merged metalnessMap and roughnessMap textures.");
+    return texture;
+  }
+  /**
+   * Builds a copy of the given normal map with the red and/or green channels
+   * inverted (`color = 255 - color`). This is used to bake the sign of
+   * `material.normalScale` and the tangent-space convention into the texture,
+   * since glTF only supports OpenGL-style normal maps with a univariate,
+   * positive scale.
+   *
+   * @param {THREE.Texture} normalMap The source normal map.
+   * @param {boolean} flipX Whether to invert the red channel (normal X).
+   * @param {boolean} flipY Whether to invert the green channel (normal Y).
+   * @return {Promise<THREE.Texture>} The derived normal map texture.
+   */
+  async buildNormalMapTextureAsync(normalMap, flipX, flipY) {
+    if (normalMap instanceof CompressedTexture) {
+      normalMap = await this.decompressTextureAsync(normalMap);
+    }
+    const image = normalMap.image;
+    const canvas = getCanvas();
+    canvas.width = image.width;
+    canvas.height = image.height;
+    const context = canvas.getContext("2d", {
+      willReadFrequently: true
+    });
+    context.drawImage(image, 0, 0, canvas.width, canvas.height);
+    const imageData = context.getImageData(0, 0, canvas.width, canvas.height);
+    const data = imageData.data;
+    for (let i = 0; i < data.length; i += 4) {
+      if (flipX) data[i + 0] = 255 - data[i + 0];
+      if (flipY) data[i + 1] = 255 - data[i + 1];
+    }
+    context.putImageData(imageData, 0, 0);
+    const texture = normalMap.clone();
+    texture.source = new TextureSource(canvas);
     return texture;
   }
+  async decompressTextureAsync(texture, maxTextureSize = Infinity) {
+    if (this.textureUtils === null) {
+      throw new Error("THREE.GLTFExporter: setTextureUtils() must be called to process compressed textures.");
+    }
+    return await this.textureUtils.decompress(texture, maxTextureSize);
+  }
   /**
    * Process a buffer to append to the default one.
-   * @param  {ArrayBuffer} buffer
-   * @return {Integer}
+   * @param {ArrayBuffer} buffer
+   * @return {0}
    */
   processBuffer(buffer) {
     const json = this.json;
@@ -6862,11 +7078,11 @@ var GLTFWriter = class {
   }
   /**
    * 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
+   * @param {BufferAttribute} attribute
+   * @param {number} componentType
+   * @param {number} start
+   * @param {number} count
+   * @param {number} [target] Target usage of the BufferView
    * @return {Object}
    */
   processBufferView(attribute, componentType, start, count, target) {
@@ -6885,7 +7101,11 @@ var GLTFWriter = class {
       default:
         componentSize = 4;
     }
-    const byteLength = getPaddedBufferSize(count * attribute.itemSize * componentSize);
+    let byteStride = attribute.itemSize * componentSize;
+    if (target === WEBGL_CONSTANTS.ARRAY_BUFFER) {
+      byteStride = Math.ceil(byteStride / 4) * 4;
+    }
+    const byteLength = getPaddedBufferSize(count * byteStride);
     const dataView = new DataView(new ArrayBuffer(byteLength));
     let offset = 0;
     for (let i = start; i < start + count; i++) {
@@ -6899,7 +7119,7 @@ var GLTFWriter = class {
           else if (a === 2) value = attribute.getZ(i);
           else if (a === 3) value = attribute.getW(i);
           if (attribute.normalized === true) {
-            value = MathUtils2.normalize(value, attribute.array);
+            value = MathUtils.normalize(value, attribute.array);
           }
         }
         if (componentType === WEBGL_CONSTANTS.FLOAT) {
@@ -6919,6 +7139,9 @@ var GLTFWriter = class {
         }
         offset += componentSize;
       }
+      if (offset % byteStride !== 0) {
+        offset += byteStride - offset % byteStride;
+      }
     }
     const bufferViewDef = {
       buffer: this.processBuffer(dataView.buffer),
@@ -6927,7 +7150,7 @@ var GLTFWriter = class {
     };
     if (target !== void 0) bufferViewDef.target = target;
     if (target === WEBGL_CONSTANTS.ARRAY_BUFFER) {
-      bufferViewDef.byteStride = attribute.itemSize * componentSize;
+      bufferViewDef.byteStride = byteStride;
     }
     this.byteOffset += byteLength;
     json.bufferViews.push(bufferViewDef);
@@ -6940,7 +7163,7 @@ var GLTFWriter = class {
   /**
    * Process and generate a BufferView from an image Blob.
    * @param {Blob} blob
-   * @return {Promise<Integer>}
+   * @return {Promise<number>} An integer
    */
   processBufferViewImage(blob) {
     const writer = this;
@@ -6963,11 +7186,11 @@ var GLTFWriter = class {
   }
   /**
    * 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
+   * @param {BufferAttribute} attribute Attribute to process
+   * @param {?BufferGeometry} [geometry] Geometry used for truncated draw range
+   * @param {number} [start=0]
+   * @param {number} [count=Infinity]
+   * @return {?number} Index of the processed accessor on the "accessors" array
    */
   processAccessor(attribute, geometry, start, count) {
     const json = this.json;
@@ -7021,11 +7244,11 @@ var GLTFWriter = class {
   }
   /**
    * Process image
-   * @param  {Image} image to process
-   * @param  {Integer} format of the image (RGBAFormat)
-   * @param  {Boolean} flipY before writing out the image
-   * @param  {String} mimeType export format
-   * @return {Integer}     Index of the processed texture in the "images" array
+   * @param {Image} image to process
+   * @param {number} format Identifier of the format (RGBAFormat)
+   * @param {boolean} flipY before writing out the image
+   * @param {string} mimeType export format
+   * @return {number}     Index of the processed texture in the "images" array
    */
   processImage(image, format, flipY, mimeType = "image/png") {
     if (image !== null) {
@@ -7043,7 +7266,9 @@ var GLTFWriter = class {
       const canvas = getCanvas();
       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", {
+        willReadFrequently: true
+      });
       if (flipY === true) {
         ctx.translate(0, canvas.height);
         ctx.scale(1, -1);
@@ -7064,7 +7289,11 @@ var GLTFWriter = class {
         }
         ctx.putImageData(new ImageData(data, image.width, image.height), 0, 0);
       } else {
-        ctx.drawImage(image, 0, 0, canvas.width, canvas.height);
+        if (typeof HTMLImageElement !== "undefined" && image instanceof HTMLImageElement || typeof HTMLCanvasElement !== "undefined" && image instanceof HTMLCanvasElement || typeof ImageBitmap !== "undefined" && image instanceof ImageBitmap || typeof OffscreenCanvas !== "undefined" && image instanceof OffscreenCanvas) {
+          ctx.drawImage(image, 0, 0, canvas.width, canvas.height);
+        } else {
+          throw new Error("THREE.GLTFExporter: Invalid image type. Use HTMLImageElement, HTMLCanvasElement, ImageBitmap or OffscreenCanvas.");
+        }
       }
       if (options.binary === true) {
         pending.push(
@@ -7073,15 +7302,7 @@ var GLTFWriter = class {
           })
         );
       } else {
-        if (canvas.toDataURL !== void 0) {
-          imageDef.uri = canvas.toDataURL(mimeType);
-        } else {
-          pending.push(
-            getToBlobPromise(canvas, mimeType).then((blob) => new FileReader().readAsDataURL(blob)).then((dataURL) => {
-              imageDef.uri = dataURL;
-            })
-          );
-        }
+        imageDef.uri = ImageUtils.getDataURL(canvas, mimeType);
       }
       const index = json.images.push(imageDef) - 1;
       cachedImages[key] = index;
@@ -7092,8 +7313,8 @@ var GLTFWriter = class {
   }
   /**
    * Process sampler
-   * @param  {Texture} map Texture to process
-   * @return {Integer}     Index of the processed texture in the "samplers" array
+   * @param {Texture} map Texture to process
+   * @return {number}      Index of the processed texture in the "samplers" array
    */
   processSampler(map) {
     const json = this.json;
@@ -7108,10 +7329,10 @@ var GLTFWriter = class {
   }
   /**
    * Process texture
-   * @param  {Texture} map Map to process
-   * @return {Integer} Index of the processed texture in the "textures" array
+   * @param {Texture} map Map to process
+   * @return {Promise<number>} Index of the processed texture in the "textures" array
    */
-  processTexture(map) {
+  async processTextureAsync(map) {
     const writer = this;
     const options = writer.options;
     const cache = this.cache;
@@ -7119,17 +7340,26 @@ var GLTFWriter = class {
     if (cache.textures.has(map)) return cache.textures.get(map);
     if (!json.textures) json.textures = [];
     if (map instanceof CompressedTexture) {
-      map = decompress(map, options.maxTextureSize);
+      map = await this.decompressTextureAsync(map, options.maxTextureSize);
     }
-    let mimeType = map.userData.mimeType;
-    if (mimeType === "image/webp") mimeType = "image/png";
+    const mimeType = map.userData.mimeType;
+    const imageIndex = this.processImage(map.image, map.format, map.flipY, mimeType);
     const textureDef = {
-      sampler: this.processSampler(map),
-      source: this.processImage(map.image, map.format, map.flipY, mimeType)
+      sampler: this.processSampler(map)
     };
+    if (mimeType === "image/webp") {
+      textureDef.extensions = textureDef.extensions || {};
+      textureDef.extensions["EXT_texture_webp"] = {
+        source: imageIndex
+      };
+      this.extensionsUsed["EXT_texture_webp"] = true;
+      this.extensionsRequired["EXT_texture_webp"] = true;
+    } else {
+      textureDef.source = imageIndex;
+    }
     if (map.name) textureDef.name = map.name;
-    this._invokeAll(function(ext) {
-      ext.writeTexture && ext.writeTexture(map, textureDef);
+    await this._invokeAllAsync(async function(ext) {
+      ext.writeTexture && await ext.writeTexture(map, textureDef);
     });
     const index = json.textures.push(textureDef) - 1;
     cache.textures.set(map, index);
@@ -7137,13 +7367,16 @@ var GLTFWriter = class {
   }
   /**
    * Process material
-   * @param  {THREE.Material} material Material to process
-   * @return {Integer|null} Index of the processed material in the "materials" array
+   * @param {THREE.Material} material Material to process
+   * @param {THREE.BufferGeometry} [geometry] Geometry the material is used with.
+   * @return {Promise<?number>} Index of the processed material in the "materials" array
    */
-  processMaterial(material) {
+  async processMaterialAsync(material, geometry) {
     const cache = this.cache;
     const json = this.json;
-    if (cache.materials.has(material)) return cache.materials.get(material);
+    const hasTangent = geometry !== void 0 && geometry.hasAttribute("tangent");
+    const cacheKey = material.normalMap ? material.uuid + ":" + hasTangent : material.uuid;
+    if (cache.materials.has(cacheKey)) return cache.materials.get(cacheKey);
     if (material.isShaderMaterial) {
       console.warn("GLTFExporter: THREE.ShaderMaterial not supported.");
       return null;
@@ -7161,21 +7394,21 @@ var GLTFWriter = class {
       materialDef.pbrMetallicRoughness.metallicFactor = material.metalness;
       materialDef.pbrMetallicRoughness.roughnessFactor = material.roughness;
     } else {
-      materialDef.pbrMetallicRoughness.metallicFactor = 0.5;
-      materialDef.pbrMetallicRoughness.roughnessFactor = 0.5;
+      materialDef.pbrMetallicRoughness.metallicFactor = 0;
+      materialDef.pbrMetallicRoughness.roughnessFactor = 1;
     }
     if (material.metalnessMap || material.roughnessMap) {
-      const metalRoughTexture = this.buildMetalRoughTexture(material.metalnessMap, material.roughnessMap);
+      const metalRoughTexture = await this.buildMetalRoughTextureAsync(material.metalnessMap, material.roughnessMap);
       const metalRoughMapDef = {
-        index: this.processTexture(metalRoughTexture),
-        channel: metalRoughTexture.channel
+        index: await this.processTextureAsync(metalRoughTexture),
+        texCoord: metalRoughTexture.channel
       };
       this.applyTextureTransform(metalRoughMapDef, metalRoughTexture);
       materialDef.pbrMetallicRoughness.metallicRoughnessTexture = metalRoughMapDef;
     }
     if (material.map) {
       const baseColorMapDef = {
-        index: this.processTexture(material.map),
+        index: await this.processTextureAsync(material.map),
         texCoord: material.map.channel
       };
       this.applyTextureTransform(baseColorMapDef, material.map);
@@ -7189,7 +7422,7 @@ var GLTFWriter = class {
       }
       if (material.emissiveMap) {
         const emissiveMapDef = {
-          index: this.processTexture(material.emissiveMap),
+          index: await this.processTextureAsync(material.emissiveMap),
           texCoord: material.emissiveMap.channel
         };
         this.applyTextureTransform(emissiveMapDef, material.emissiveMap);
@@ -7197,19 +7430,32 @@ var GLTFWriter = class {
       }
     }
     if (material.normalMap) {
+      const normalScale = material.normalScale;
+      const flipX = normalScale.x < 0;
+      const flipY = hasTangent ? normalScale.y < 0 : normalScale.y > 0;
+      let normalMap = material.normalMap;
+      if (flipX || flipY) {
+        if (cache.normalMaps.has(material.normalMap) === false) cache.normalMaps.set(material.normalMap, {});
+        const cachedVariants = cache.normalMaps.get(material.normalMap);
+        const cacheKey2 = `${flipX}:${flipY}`;
+        if (cachedVariants[cacheKey2] === void 0) {
+          cachedVariants[cacheKey2] = await this.buildNormalMapTextureAsync(material.normalMap, flipX, flipY);
+        }
+        normalMap = cachedVariants[cacheKey2];
+      }
       const normalMapDef = {
-        index: this.processTexture(material.normalMap),
+        index: await this.processTextureAsync(normalMap),
         texCoord: material.normalMap.channel
       };
-      if (material.normalScale && material.normalScale.x !== 1) {
-        normalMapDef.scale = material.normalScale.x;
+      if (Math.abs(normalScale.x) !== 1) {
+        normalMapDef.scale = Math.abs(normalScale.x);
       }
       this.applyTextureTransform(normalMapDef, material.normalMap);
       materialDef.normalTexture = normalMapDef;
     }
     if (material.aoMap) {
       const occlusionMapDef = {
-        index: this.processTexture(material.aoMap),
+        index: await this.processTextureAsync(material.aoMap),
         texCoord: material.aoMap.channel
       };
       if (material.aoMapIntensity !== 1) {
@@ -7229,19 +7475,19 @@ var GLTFWriter = class {
     if (material.side === DoubleSide2) materialDef.doubleSided = true;
     if (material.name !== "") materialDef.name = material.name;
     this.serializeUserData(material, materialDef);
-    this._invokeAll(function(ext) {
-      ext.writeMaterial && ext.writeMaterial(material, materialDef);
+    await this._invokeAllAsync(async function(ext) {
+      ext.writeMaterialAsync && await ext.writeMaterialAsync(material, materialDef);
     });
     const index = json.materials.push(materialDef) - 1;
-    cache.materials.set(material, index);
+    cache.materials.set(cacheKey, index);
     return index;
   }
   /**
    * Process mesh
-   * @param  {THREE.Mesh} mesh Mesh to process
-   * @return {Integer|null} Index of the processed mesh in the "meshes" array
+   * @param {THREE.Mesh} mesh Mesh to process
+   * @return {Promise<?number>} Index of the processed mesh in the "meshes" array
    */
-  processMesh(mesh) {
+  async processMeshAsync(mesh) {
     const cache = this.cache;
     const json = this.json;
     const meshCacheKeyParts = [mesh.geometry.uuid];
@@ -7291,7 +7537,7 @@ var GLTFWriter = class {
       const attribute = geometry.attributes[attributeName];
       attributeName = nameConversion[attributeName] || attributeName.toUpperCase();
       const validVertexAttributes = /^(POSITION|NORMAL|TANGENT|TEXCOORD_\d+|COLOR_\d+|JOINTS_\d+|WEIGHTS_\d+)$/;
-      if (!validVertexAttributes.test(attributeName)) attributeName = "_" + attributeName;
+      if (!validVertexAttributes.test(attributeName) && !attributeName.startsWith("_")) attributeName = "_" + attributeName;
       if (cache.attributes.has(this.getUID(attribute))) {
         attributes[attributeName] = cache.attributes.get(this.getUID(attribute));
         continue;
@@ -7300,7 +7546,10 @@ var GLTFWriter = class {
       const array = attribute.array;
       if (attributeName === "JOINTS_0" && !(array instanceof Uint16Array) && !(array instanceof Uint8Array)) {
         console.warn('GLTFExporter: Attribute "skinIndex" converted to type UNSIGNED_SHORT.');
-        modifiedAttribute = new BufferAttribute3(new Uint16Array(array), attribute.itemSize, attribute.normalized);
+        modifiedAttribute = GLTFExporter.Utils.toTypedBufferAttribute(attribute, Uint16Array);
+      } else if ((array instanceof Uint32Array || array instanceof Int32Array) && !attributeName.startsWith("_")) {
+        console.warn(`GLTFExporter: Attribute "${attributeName}" converted to type FLOAT.`);
+        modifiedAttribute = GLTFExporter.Utils.toTypedBufferAttribute(attribute, Float32Array);
       }
       const accessor = this.processAccessor(modifiedAttribute || attribute, geometry);
       if (accessor !== null) {
@@ -7366,6 +7615,15 @@ var GLTFWriter = class {
     }
     const isMultiMaterial = Array.isArray(mesh.material);
     if (isMultiMaterial && geometry.groups.length === 0) return null;
+    let didForceIndices = false;
+    if (isMultiMaterial && geometry.index === null) {
+      const indices = [];
+      for (let i = 0, il = geometry.attributes.position.count; i < il; i++) {
+        indices[i] = i;
+      }
+      geometry.setIndex(indices);
+      didForceIndices = true;
+    }
     const materials = isMultiMaterial ? mesh.material : [mesh.material];
     const groups = isMultiMaterial ? geometry.groups : [{ materialIndex: 0, start: void 0, count: void 0 }];
     for (let i = 0, il = groups.length; i < il; i++) {
@@ -7388,13 +7646,16 @@ var GLTFWriter = class {
         }
         if (primitive.indices === null) delete primitive.indices;
       }
-      const material = this.processMaterial(materials[groups[i].materialIndex]);
+      const material = await this.processMaterialAsync(materials[groups[i].materialIndex], geometry);
       if (material !== null) primitive.material = material;
       primitives.push(primitive);
     }
+    if (didForceIndices === true) {
+      geometry.setIndex(null);
+    }
     meshDef.primitives = primitives;
     if (!json.meshes) json.meshes = [];
-    this._invokeAll(function(ext) {
+    await this._invokeAllAsync(function(ext) {
       ext.writeMesh && ext.writeMesh(mesh, meshDef);
     });
     const index = json.meshes.push(meshDef) - 1;
@@ -7440,8 +7701,8 @@ var GLTFWriter = class {
   }
   /**
    * Process camera
-   * @param  {THREE.Camera} camera Camera to process
-   * @return {Integer}      Index of the processed mesh in the "camera" array
+   * @param {THREE.Camera} camera Camera to process
+   * @return {number} Index of the processed mesh in the "camera" array
    */
   processCamera(camera) {
     const json = this.json;
@@ -7460,7 +7721,7 @@ var GLTFWriter = class {
     } else {
       cameraDef.perspective = {
         aspectRatio: camera.aspect,
-        yfov: MathUtils2.degToRad(camera.fov),
+        yfov: MathUtils.degToRad(camera.fov),
         zfar: camera.far <= 0 ? 1e-3 : camera.far,
         znear: camera.near < 0 ? 0 : camera.near
       };
@@ -7476,7 +7737,7 @@ var GLTFWriter = class {
    *
    * @param {THREE.AnimationClip} clip
    * @param {THREE.Object3D} root
-   * @return {number|null}
+   * @return {?number}
    */
   processAnimation(clip, root) {
     const json = this.json;
@@ -7500,7 +7761,7 @@ var GLTFWriter = class {
       }
       if (!trackNode || !trackProperty) {
         console.warn('THREE.GLTFExporter: Could not export animation track "%s".', track.name);
-        return null;
+        continue;
       }
       const inputItemSize = 1;
       let outputItemSize = track.values.length / track.times.length;
@@ -7529,16 +7790,18 @@ var GLTFWriter = class {
         }
       });
     }
-    json.animations.push({
+    const animationDef = {
       name: clip.name || "clip_" + json.animations.length,
       samplers,
       channels
-    });
+    };
+    this.serializeUserData(clip, animationDef);
+    json.animations.push(animationDef);
     return json.animations.length - 1;
   }
   /**
    * @param {THREE.Object3D} object
-   * @return {number|null}
+   * @return {?number}
    */
   processSkin(object) {
     const json = this.json;
@@ -7567,14 +7830,17 @@ var GLTFWriter = class {
   }
   /**
    * Process Object3D node
-   * @param  {THREE.Object3D} node Object3D to processNode
-   * @return {Integer} Index of the node in the nodes list
+   * @param {THREE.Object3D} object Object3D to processNodeAsync
+   * @return {Promise<number>} Index of the node in the nodes list
    */
-  processNode(object) {
+  async processNodeAsync(object) {
     const json = this.json;
     const options = this.options;
     const nodeMap = this.nodeMap;
     if (!json.nodes) json.nodes = [];
+    if (object.pivot !== null) {
+      return await this._processNodeWithPivotAsync(object);
+    }
     const nodeDef = {};
     if (options.trs) {
       const rotation = object.quaternion.toArray();
@@ -7600,35 +7866,98 @@ var GLTFWriter = class {
     if (object.name !== "") nodeDef.name = String(object.name);
     this.serializeUserData(object, nodeDef);
     if (object.isMesh || object.isLine || object.isPoints) {
-      const meshIndex = this.processMesh(object);
+      const meshIndex = await this.processMeshAsync(object);
       if (meshIndex !== null) nodeDef.mesh = meshIndex;
     } else if (object.isCamera) {
       nodeDef.camera = this.processCamera(object);
     }
     if (object.isSkinnedMesh) this.skins.push(object);
+    const nodeIndex = json.nodes.push(nodeDef) - 1;
+    nodeMap.set(object, nodeIndex);
     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 === false) {
-          const nodeIndex2 = this.processNode(child);
-          if (nodeIndex2 !== null) children.push(nodeIndex2);
+          const childNodeIndex = await this.processNodeAsync(child);
+          if (childNodeIndex !== null) children.push(childNodeIndex);
         }
       }
       if (children.length > 0) nodeDef.children = children;
     }
-    this._invokeAll(function(ext) {
+    await this._invokeAllAsync(function(ext) {
       ext.writeNode && ext.writeNode(object, nodeDef);
     });
-    const nodeIndex = json.nodes.push(nodeDef) - 1;
-    nodeMap.set(object, nodeIndex);
     return nodeIndex;
   }
+  /**
+   * Process Object3D node with pivot using container approach
+   * @param {THREE.Object3D} object Object3D with pivot
+   * @return {Promise<number>} Index of the container node
+   */
+  async _processNodeWithPivotAsync(object) {
+    const json = this.json;
+    const options = this.options;
+    const nodeMap = this.nodeMap;
+    const pivot = object.pivot;
+    const containerDef = {};
+    const rotation = object.quaternion.toArray();
+    const position = [
+      object.position.x + pivot.x,
+      object.position.y + pivot.y,
+      object.position.z + pivot.z
+    ];
+    const scale = object.scale.toArray();
+    if (!equalArray(rotation, [0, 0, 0, 1])) {
+      containerDef.rotation = rotation;
+    }
+    if (!equalArray(position, [0, 0, 0])) {
+      containerDef.translation = position;
+    }
+    if (!equalArray(scale, [1, 1, 1])) {
+      containerDef.scale = scale;
+    }
+    containerDef.extras = { pivot: pivot.toArray() };
+    if (object.name !== "") containerDef.name = String(object.name);
+    this.serializeUserData(object, containerDef);
+    const containerIndex = json.nodes.push(containerDef) - 1;
+    nodeMap.set(object, containerIndex);
+    const childDef = {};
+    const childPosition = [-pivot.x, -pivot.y, -pivot.z];
+    if (!equalArray(childPosition, [0, 0, 0])) {
+      childDef.translation = childPosition;
+    }
+    if (object.isMesh || object.isLine || object.isPoints) {
+      const meshIndex = await this.processMeshAsync(object);
+      if (meshIndex !== null) childDef.mesh = meshIndex;
+    } else if (object.isCamera) {
+      childDef.camera = this.processCamera(object);
+    }
+    if (object.isSkinnedMesh) this.skins.push(object);
+    const childIndex = json.nodes.push(childDef) - 1;
+    const containerChildren = [childIndex];
+    if (object.children.length > 0) {
+      const grandchildren = [];
+      for (let i = 0, l = object.children.length; i < l; i++) {
+        const child = object.children[i];
+        if (child.visible || options.onlyVisible === false) {
+          const childNodeIndex = await this.processNodeAsync(child);
+          if (childNodeIndex !== null) grandchildren.push(childNodeIndex);
+        }
+      }
+      if (grandchildren.length > 0) childDef.children = grandchildren;
+    }
+    containerDef.children = containerChildren;
+    await this._invokeAllAsync(function(ext) {
+      ext.writeNode && ext.writeNode(object, containerDef);
+    });
+    return containerIndex;
+  }
   /**
    * Process Scene
-   * @param  {Scene} node Scene to process
+   * @param {Scene} scene Scene to process
    */
-  processScene(scene) {
+  async processSceneAsync(scene) {
     const json = this.json;
     const options = this.options;
     if (!json.scenes) {
@@ -7642,7 +7971,7 @@ var GLTFWriter = class {
     for (let i = 0, l = scene.children.length; i < l; i++) {
       const child = scene.children[i];
       if (child.visible || options.onlyVisible === false) {
-        const nodeIndex = this.processNode(child);
+        const nodeIndex = await this.processNodeAsync(child);
         if (nodeIndex !== null) nodes.push(nodeIndex);
       }
     }
@@ -7651,47 +7980,58 @@ var GLTFWriter = class {
   }
   /**
    * Creates a Scene to hold a list of objects and parse it
-   * @param  {Array} objects List of objects to process
+   * @param {Array<THREE.Object3D>} objects List of objects to process
    */
-  processObjects(objects) {
-    const scene = new Scene3();
+  async processObjectsAsync(objects) {
+    const scene = new Scene2();
     scene.name = "AuxScene";
     for (let i = 0; i < objects.length; i++) {
       scene.children.push(objects[i]);
     }
-    this.processScene(scene);
+    await this.processSceneAsync(scene);
   }
   /**
    * @param {THREE.Object3D|Array<THREE.Object3D>} input
    */
-  processInput(input) {
+  async processInputAsync(input) {
     const options = this.options;
     input = input instanceof Array ? input : [input];
-    this._invokeAll(function(ext) {
+    await this._invokeAllAsync(function(ext) {
       ext.beforeParse && ext.beforeParse(input);
     });
     const objectsWithoutScene = [];
     for (let i = 0; i < input.length; i++) {
-      if (input[i] instanceof Scene3) {
-        this.processScene(input[i]);
+      if (input[i] instanceof Scene2) {
+        await this.processSceneAsync(input[i]);
       } else {
         objectsWithoutScene.push(input[i]);
       }
     }
-    if (objectsWithoutScene.length > 0) this.processObjects(objectsWithoutScene);
+    if (objectsWithoutScene.length > 0) {
+      await this.processObjectsAsync(objectsWithoutScene);
+    }
     for (let i = 0; i < this.skins.length; ++i) {
       this.processSkin(this.skins[i]);
     }
-    for (let i = 0; i < options.animations.length; ++i) {
-      this.processAnimation(options.animations[i], input[0]);
+    if (input.length === 1) {
+      for (let i = 0; i < options.animations.length; ++i) {
+        this.processAnimation(options.animations[i], input[0]);
+      }
+    } else {
+      for (let i = 0; i < input.length; i++) {
+        const animations = options.animations[i] || [];
+        for (let j = 0; j < animations.length; ++j) {
+          this.processAnimation(animations[j], input[i]);
+        }
+      }
     }
-    this._invokeAll(function(ext) {
+    await this._invokeAllAsync(function(ext) {
       ext.afterParse && ext.afterParse(input);
     });
   }
-  _invokeAll(func) {
+  async _invokeAllAsync(func) {
     for (let i = 0, il = this.plugins.length; i < il; i++) {
-      func(this.plugins[i]);
+      await func(this.plugins[i]);
     }
   }
 };
@@ -7747,7 +8087,7 @@ var GLTFMaterialsUnlitExtension = class {
     this.writer = writer;
     this.name = "KHR_materials_unlit";
   }
-  writeMaterial(material, materialDef) {
+  async writeMaterialAsync(material, materialDef) {
     if (!material.isMeshBasicMaterial) return;
     const writer = this.writer;
     const extensionsUsed = writer.extensionsUsed;
@@ -7763,7 +8103,7 @@ var GLTFMaterialsClearcoatExtension = class {
     this.writer = writer;
     this.name = "KHR_materials_clearcoat";
   }
-  writeMaterial(material, materialDef) {
+  async writeMaterialAsync(material, materialDef) {
     if (!material.isMeshPhysicalMaterial || material.clearcoat === 0) return;
     const writer = this.writer;
     const extensionsUsed = writer.extensionsUsed;
@@ -7771,7 +8111,7 @@ var GLTFMaterialsClearcoatExtension = class {
     extensionDef.clearcoatFactor = material.clearcoat;
     if (material.clearcoatMap) {
       const clearcoatMapDef = {
-        index: writer.processTexture(material.clearcoatMap),
+        index: await writer.processTextureAsync(material.clearcoatMap),
         texCoord: material.clearcoatMap.channel
       };
       writer.applyTextureTransform(clearcoatMapDef, material.clearcoatMap);
@@ -7780,7 +8120,7 @@ var GLTFMaterialsClearcoatExtension = class {
     extensionDef.clearcoatRoughnessFactor = material.clearcoatRoughness;
     if (material.clearcoatRoughnessMap) {
       const clearcoatRoughnessMapDef = {
-        index: writer.processTexture(material.clearcoatRoughnessMap),
+        index: await writer.processTextureAsync(material.clearcoatRoughnessMap),
         texCoord: material.clearcoatRoughnessMap.channel
       };
       writer.applyTextureTransform(clearcoatRoughnessMapDef, material.clearcoatRoughnessMap);
@@ -7788,9 +8128,10 @@ var GLTFMaterialsClearcoatExtension = class {
     }
     if (material.clearcoatNormalMap) {
       const clearcoatNormalMapDef = {
-        index: writer.processTexture(material.clearcoatNormalMap),
+        index: await writer.processTextureAsync(material.clearcoatNormalMap),
         texCoord: material.clearcoatNormalMap.channel
       };
+      if (material.clearcoatNormalScale.x !== 1) clearcoatNormalMapDef.scale = material.clearcoatNormalScale.x;
       writer.applyTextureTransform(clearcoatNormalMapDef, material.clearcoatNormalMap);
       extensionDef.clearcoatNormalTexture = clearcoatNormalMapDef;
     }
@@ -7799,12 +8140,28 @@ var GLTFMaterialsClearcoatExtension = class {
     extensionsUsed[this.name] = true;
   }
 };
+var GLTFMaterialsDispersionExtension = class {
+  constructor(writer) {
+    this.writer = writer;
+    this.name = "KHR_materials_dispersion";
+  }
+  async writeMaterialAsync(material, materialDef) {
+    if (!material.isMeshPhysicalMaterial || material.dispersion === 0) return;
+    const writer = this.writer;
+    const extensionsUsed = writer.extensionsUsed;
+    const extensionDef = {};
+    extensionDef.dispersion = material.dispersion;
+    materialDef.extensions = materialDef.extensions || {};
+    materialDef.extensions[this.name] = extensionDef;
+    extensionsUsed[this.name] = true;
+  }
+};
 var GLTFMaterialsIridescenceExtension = class {
   constructor(writer) {
     this.writer = writer;
     this.name = "KHR_materials_iridescence";
   }
-  writeMaterial(material, materialDef) {
+  async writeMaterialAsync(material, materialDef) {
     if (!material.isMeshPhysicalMaterial || material.iridescence === 0) return;
     const writer = this.writer;
     const extensionsUsed = writer.extensionsUsed;
@@ -7812,7 +8169,7 @@ var GLTFMaterialsIridescenceExtension = class {
     extensionDef.iridescenceFactor = material.iridescence;
     if (material.iridescenceMap) {
       const iridescenceMapDef = {
-        index: writer.processTexture(material.iridescenceMap),
+        index: await writer.processTextureAsync(material.iridescenceMap),
         texCoord: material.iridescenceMap.channel
       };
       writer.applyTextureTransform(iridescenceMapDef, material.iridescenceMap);
@@ -7823,7 +8180,7 @@ var GLTFMaterialsIridescenceExtension = class {
     extensionDef.iridescenceThicknessMaximum = material.iridescenceThicknessRange[1];
     if (material.iridescenceThicknessMap) {
       const iridescenceThicknessMapDef = {
-        index: writer.processTexture(material.iridescenceThicknessMap),
+        index: await writer.processTextureAsync(material.iridescenceThicknessMap),
         texCoord: material.iridescenceThicknessMap.channel
       };
       writer.applyTextureTransform(iridescenceThicknessMapDef, material.iridescenceThicknessMap);
@@ -7839,7 +8196,7 @@ var GLTFMaterialsTransmissionExtension = class {
     this.writer = writer;
     this.name = "KHR_materials_transmission";
   }
-  writeMaterial(material, materialDef) {
+  async writeMaterialAsync(material, materialDef) {
     if (!material.isMeshPhysicalMaterial || material.transmission === 0) return;
     const writer = this.writer;
     const extensionsUsed = writer.extensionsUsed;
@@ -7847,7 +8204,7 @@ var GLTFMaterialsTransmissionExtension = class {
     extensionDef.transmissionFactor = material.transmission;
     if (material.transmissionMap) {
       const transmissionMapDef = {
-        index: writer.processTexture(material.transmissionMap),
+        index: await writer.processTextureAsync(material.transmissionMap),
         texCoord: material.transmissionMap.channel
       };
       writer.applyTextureTransform(transmissionMapDef, material.transmissionMap);
@@ -7863,7 +8220,7 @@ var GLTFMaterialsVolumeExtension = class {
     this.writer = writer;
     this.name = "KHR_materials_volume";
   }
-  writeMaterial(material, materialDef) {
+  async writeMaterialAsync(material, materialDef) {
     if (!material.isMeshPhysicalMaterial || material.transmission === 0) return;
     const writer = this.writer;
     const extensionsUsed = writer.extensionsUsed;
@@ -7871,13 +8228,15 @@ var GLTFMaterialsVolumeExtension = class {
     extensionDef.thicknessFactor = material.thickness;
     if (material.thicknessMap) {
       const thicknessMapDef = {
-        index: writer.processTexture(material.thicknessMap),
+        index: await writer.processTextureAsync(material.thicknessMap),
         texCoord: material.thicknessMap.channel
       };
       writer.applyTextureTransform(thicknessMapDef, material.thicknessMap);
       extensionDef.thicknessTexture = thicknessMapDef;
     }
-    extensionDef.attenuationDistance = material.attenuationDistance;
+    if (material.attenuationDistance !== Infinity) {
+      extensionDef.attenuationDistance = material.attenuationDistance;
+    }
     extensionDef.attenuationColor = material.attenuationColor.toArray();
     materialDef.extensions = materialDef.extensions || {};
     materialDef.extensions[this.name] = extensionDef;
@@ -7889,7 +8248,7 @@ var GLTFMaterialsIorExtension = class {
     this.writer = writer;
     this.name = "KHR_materials_ior";
   }
-  writeMaterial(material, materialDef) {
+  async writeMaterialAsync(material, materialDef) {
     if (!material.isMeshPhysicalMaterial || material.ior === 1.5) return;
     const writer = this.writer;
     const extensionsUsed = writer.extensionsUsed;
@@ -7905,14 +8264,14 @@ var GLTFMaterialsSpecularExtension = class {
     this.writer = writer;
     this.name = "KHR_materials_specular";
   }
-  writeMaterial(material, materialDef) {
-    if (!material.isMeshPhysicalMaterial || material.specularIntensity === 1 && material.specularColor.equals(DEFAULT_SPECULAR_COLOR) && !material.specularIntensityMap && !material.specularColorTexture) return;
+  async writeMaterialAsync(material, materialDef) {
+    if (!material.isMeshPhysicalMaterial || material.specularIntensity === 1 && material.specularColor.equals(DEFAULT_SPECULAR_COLOR) && !material.specularIntensityMap && !material.specularColorMap) return;
     const writer = this.writer;
     const extensionsUsed = writer.extensionsUsed;
     const extensionDef = {};
     if (material.specularIntensityMap) {
       const specularIntensityMapDef = {
-        index: writer.processTexture(material.specularIntensityMap),
+        index: await writer.processTextureAsync(material.specularIntensityMap),
         texCoord: material.specularIntensityMap.channel
       };
       writer.applyTextureTransform(specularIntensityMapDef, material.specularIntensityMap);
@@ -7920,7 +8279,7 @@ var GLTFMaterialsSpecularExtension = class {
     }
     if (material.specularColorMap) {
       const specularColorMapDef = {
-        index: writer.processTexture(material.specularColorMap),
+        index: await writer.processTextureAsync(material.specularColorMap),
         texCoord: material.specularColorMap.channel
       };
       writer.applyTextureTransform(specularColorMapDef, material.specularColorMap);
@@ -7938,14 +8297,14 @@ var GLTFMaterialsSheenExtension = class {
     this.writer = writer;
     this.name = "KHR_materials_sheen";
   }
-  writeMaterial(material, materialDef) {
+  async writeMaterialAsync(material, materialDef) {
     if (!material.isMeshPhysicalMaterial || material.sheen == 0) return;
     const writer = this.writer;
     const extensionsUsed = writer.extensionsUsed;
     const extensionDef = {};
     if (material.sheenRoughnessMap) {
       const sheenRoughnessMapDef = {
-        index: writer.processTexture(material.sheenRoughnessMap),
+        index: await writer.processTextureAsync(material.sheenRoughnessMap),
         texCoord: material.sheenRoughnessMap.channel
       };
       writer.applyTextureTransform(sheenRoughnessMapDef, material.sheenRoughnessMap);
@@ -7953,7 +8312,7 @@ var GLTFMaterialsSheenExtension = class {
     }
     if (material.sheenColorMap) {
       const sheenColorMapDef = {
-        index: writer.processTexture(material.sheenColorMap),
+        index: await writer.processTextureAsync(material.sheenColorMap),
         texCoord: material.sheenColorMap.channel
       };
       writer.applyTextureTransform(sheenColorMapDef, material.sheenColorMap);
@@ -7971,13 +8330,13 @@ var GLTFMaterialsAnisotropyExtension = class {
     this.writer = writer;
     this.name = "KHR_materials_anisotropy";
   }
-  writeMaterial(material, materialDef) {
+  async writeMaterialAsync(material, materialDef) {
     if (!material.isMeshPhysicalMaterial || material.anisotropy == 0) return;
     const writer = this.writer;
     const extensionsUsed = writer.extensionsUsed;
     const extensionDef = {};
     if (material.anisotropyMap) {
-      const anisotropyMapDef = { index: writer.processTexture(material.anisotropyMap) };
+      const anisotropyMapDef = { index: await writer.processTextureAsync(material.anisotropyMap) };
       writer.applyTextureTransform(anisotropyMapDef, material.anisotropyMap);
       extensionDef.anisotropyTexture = anisotropyMapDef;
     }
@@ -7993,7 +8352,7 @@ var GLTFMaterialsEmissiveStrengthExtension = class {
     this.writer = writer;
     this.name = "KHR_materials_emissive_strength";
   }
-  writeMaterial(material, materialDef) {
+  async writeMaterialAsync(material, materialDef) {
     if (!material.isMeshStandardMaterial || material.emissiveIntensity === 1) return;
     const writer = this.writer;
     const extensionsUsed = writer.extensionsUsed;
@@ -8004,6 +8363,30 @@ var GLTFMaterialsEmissiveStrengthExtension = class {
     extensionsUsed[this.name] = true;
   }
 };
+var GLTFMaterialsBumpExtension = class {
+  constructor(writer) {
+    this.writer = writer;
+    this.name = "EXT_materials_bump";
+  }
+  async writeMaterialAsync(material, materialDef) {
+    if (!material.isMeshStandardMaterial || material.bumpScale === 1 && !material.bumpMap) return;
+    const writer = this.writer;
+    const extensionsUsed = writer.extensionsUsed;
+    const extensionDef = {};
+    if (material.bumpMap) {
+      const bumpMapDef = {
+        index: await writer.processTextureAsync(material.bumpMap),
+        texCoord: material.bumpMap.channel
+      };
+      writer.applyTextureTransform(bumpMapDef, material.bumpMap);
+      extensionDef.bumpTexture = bumpMapDef;
+    }
+    extensionDef.bumpFactor = material.bumpScale;
+    materialDef.extensions = materialDef.extensions || {};
+    materialDef.extensions[this.name] = extensionDef;
+    extensionsUsed[this.name] = true;
+  }
+};
 var GLTFMeshGpuInstancing = class {
   constructor(writer) {
     this.writer = writer;
@@ -8139,6 +8522,19 @@ GLTFExporter.Utils = {
     }
     clip.tracks = tracks;
     return clip;
+  },
+  toTypedBufferAttribute: function(srcAttribute, TypedArray) {
+    const dstAttribute = new BufferAttribute3(new TypedArray(srcAttribute.count * srcAttribute.itemSize), srcAttribute.itemSize, false);
+    if (!srcAttribute.normalized && !srcAttribute.isInterleavedBufferAttribute) {
+      dstAttribute.array.set(srcAttribute.array);
+      return dstAttribute;
+    }
+    for (let i = 0, il = srcAttribute.count; i < il; i++) {
+      for (let j = 0; j < srcAttribute.itemSize; j++) {
+        dstAttribute.setComponent(i, j, srcAttribute.getComponent(i, j));
+      }
+    }
+    return dstAttribute;
   }
 };
 
@@ -8193,7 +8589,7 @@ function localMatrix(object) {
   return object.matrixAutoUpdate ? new Matrix47().compose(object.position, object.quaternion, object.scale) : object.matrix.clone();
 }
 function createSnapshot(root, gltf, bakeColors = false) {
-  const scene = new Scene4();
+  const scene = new Scene3();
   const geometries = [];
   const materials = [];
   const textures = [];
@@ -8288,7 +8684,7 @@ function createSnapshot(root, gltf, bakeColors = false) {
           material.color.copy(tint);
         }
       }
-      const copy = new Mesh5(geometry, material);
+      const copy = new Mesh4(geometry, material);
       copy.name = mesh.name;
       copy.renderOrder = mesh.renderOrder;
       scene.add(copy);
@@ -8367,7 +8763,7 @@ function selectAlphaMode(material, geometry) {
 }
 function copyDataTexture(source) {
   const image = source.image;
-  if (source.format !== RGBAFormat3 || source.type !== UnsignedByteType) {
+  if (!image.data || source.format !== RGBAFormat3 || source.type !== UnsignedByteType) {
     throw new MineRenderError("glTF export requires RGBA unsigned-byte data textures");
   }
   const canvas = createCanvas2(image.width, image.height);
@@ -8378,8 +8774,8 @@ function copyDataTexture(source) {
   context.putImageData(pixels, 0, 0);
   const copySource = Object.create(source);
   copySource.userData = {};
-  copySource.source = new Source2(canvas);
-  return new Texture4().copy(copySource);
+  copySource.source = new TextureSource2(canvas);
+  return new Texture3().copy(copySource);
 }
 
 // src/gui/GuiHelper.ts
@@ -8448,6 +8844,85 @@ var GuiHelper = class {
   }
 };
 
+// src/gui/GuiTextureGeometry.ts
+import { BufferGeometry as BufferGeometry2, Float32BufferAttribute as Float32BufferAttribute4, PlaneGeometry } from "three";
+function createGuiTextureGeometry(width, height, imageWidth, imageHeight, crop, scaling) {
+  if (crop || !scaling || scaling.type === "stretch") {
+    const [x, y, w, h] = crop ?? [0, 0, imageWidth, imageHeight];
+    const geometry = new PlaneGeometry(width, height);
+    const uv = geometry.getAttribute("uv");
+    for (let i = 0; i < uv.count; i++) {
+      uv.setXY(
+        i,
+        (x + uv.getX(i) * w) / imageWidth,
+        1 - (y + (1 - uv.getY(i)) * h) / imageHeight
+      );
+    }
+    return geometry;
+  }
+  const sw = scaling.width, sh = scaling.height;
+  if (![sw, sh].every((value) => Number.isInteger(value) && value > 0)) {
+    throw new Error("GUI sprite dimensions must be positive integers");
+  }
+  if (![width, height].every((value) => Number.isFinite(value) && value >= 0)) {
+    throw new Error("GUI output dimensions must be finite and nonnegative");
+  }
+  const positions = [], uvs = [], normals = [], indices = [];
+  function quad(x, y, w, h, u, v, uw, vh) {
+    if (w <= 0 || h <= 0) return;
+    const index = positions.length / 3;
+    const left = x - width / 2, top = height / 2 - y;
+    positions.push(left, top, 0, left + w, top, 0, left, top - h, 0, left + w, top - h, 0);
+    uvs.push(
+      u / sw,
+      1 - v / sh,
+      (u + uw) / sw,
+      1 - v / sh,
+      u / sw,
+      1 - (v + vh) / sh,
+      (u + uw) / sw,
+      1 - (v + vh) / sh
+    );
+    normals.push(0, 0, 1, 0, 0, 1, 0, 0, 1, 0, 0, 1);
+    indices.push(index, index + 2, index + 1, index + 2, index + 3, index + 1);
+  }
+  function tile(x, y, w, h, u, v, tw, th) {
+    for (let dy = 0; dy < h; dy += th) {
+      for (let dx = 0; dx < w; dx += tw) {
+        const cw = Math.min(tw, w - dx), ch = Math.min(th, h - dy);
+        quad(x + dx, y + dy, cw, ch, u, v, cw, ch);
+      }
+    }
+  }
+  if (scaling.type === "tile") {
+    tile(0, 0, width, height, 0, 0, sw, sh);
+  } else {
+    let segments = function(size, sourceSize, start, end) {
+      if (size === sourceSize) return [[0, size, 0, sourceSize]];
+      start = Math.min(start, Math.floor(size / 2));
+      end = Math.min(end, Math.floor(size / 2));
+      return [
+        [0, start, 0, start],
+        [start, size - start - end, start, sourceSize - start - end],
+        [size - end, end, sourceSize - end, end]
+      ];
+    };
+    const border = typeof scaling.border === "number" ? { left: scaling.border, top: scaling.border, right: scaling.border, bottom: scaling.border } : scaling.border;
+    if (!border || typeof scaling.border === "number" && scaling.border <= 0 || ![border.left, border.top, border.right, border.bottom].every((value) => Number.isInteger(value) && value >= 0) || border.left + border.right >= sw || border.top + border.bottom >= sh) {
+      throw new Error("GUI nine-slice borders must be nonnegative integers with a nonempty center");
+    }
+    const columns = segments(width, sw, border.left, border.right);
+    const rows = segments(height, sh, border.top, border.bottom);
+    for (const [y, h, v, vh] of rows) {
+      for (const [x, w, u, uw] of columns) {
+        if (w <= 0 || h <= 0) continue;
+        (scaling.stretch_inner ? quad : tile)(x, y, w, h, u, v, uw, vh);
+      }
+    }
+  }
+  return new BufferGeometry2().setAttribute("position", new Float32BufferAttribute4(positions, 3)).setAttribute("normal", new Float32BufferAttribute4(normals, 3)).setAttribute("uv", new Float32BufferAttribute4(uvs, 2)).setIndex(indices);
+}
+
 // src/gui/scene/GuiObject.ts
 init_AssetKey();
 init_ModelTextures();
@@ -8458,7 +8933,7 @@ init_Materials();
 init_ModelObject();
 init_DisplayPosition();
 init_GuiLight();
-import { Box2, Box3 as Box32, Matrix4 as Matrix410, Mesh as Mesh7, PlaneGeometry as PlaneGeometry2, Vector2 as Vector23 } from "three";
+import { Box2, Box3 as Box32, Matrix4 as Matrix410, Mesh as Mesh6, Vector2 as Vector23 } from "three";
 var GuiObject = class extends SceneObject {
   constructor(textureLayers, options) {
     super({ ...options, instanceMeshes: false, mergeMeshes: false });
@@ -8499,19 +8974,11 @@ var GuiObject = class extends SceneObject {
         const key = typeof layer.texture === "string" ? AssetKey.parse("textures", layer.texture) : layer.texture;
         const material = await this.loadMaterial(key);
         const image = material.map.image;
-        const [cropX, cropY, cropWidth, cropHeight] = layer.crop ?? [0, 0, image.width, image.height];
-        const [width, height] = layer.size ?? [cropWidth, cropHeight];
-        const geometry = new PlaneGeometry2(width, height);
+        const scaling = layer.crop ? void 0 : (await ModelTextures.getMeta(key))?.gui?.scaling;
+        const [width, height] = layer.size ?? (layer.crop ? layer.crop.slice(2) : scaling && scaling.type !== "stretch" ? [scaling.width, scaling.height] : [image.width, image.height]);
+        const geometry = createGuiTextureGeometry(width, height, image.width, image.height, layer.crop, scaling);
         this.geometries.add(geometry);
-        const uv = geometry.getAttribute("uv");
-        for (let i = 0; i < uv.count; i++) {
-          uv.setXY(
-            i,
-            (cropX + uv.getX(i) * cropWidth) / image.width,
-            1 - (cropY + (1 - uv.getY(i)) * cropHeight) / image.height
-          );
-        }
-        const mesh = new Mesh7(geometry, material);
+        const mesh = new Mesh6(geometry, material);
         mesh.name = `mesh:${layer.name ?? index}`;
         mesh.position.set(x + width / 2, -y - height / 2, depth);
         mesh.renderOrder = index;
@@ -9353,6 +9820,7 @@ var BlockObject = class _BlockObject extends SceneObject {
           replacement.setMatrix(matrix);
         } else {
           replacement.matrix.copy(matrix);
+          replacement.matrixWorldNeedsUpdate = true;
           matrix.decompose(replacement.position, replacement.quaternion, replacement.scale);
           replacement.matrixAutoUpdate = object.matrixAutoUpdate;
           replacement.visible = object.visible;
@@ -11411,7 +11879,7 @@ init_nbt();
 init_SceneObject();
 var import_ts_deepmerge8 = __toESM(require_dist());
 init_ModelObject();
-import { Scene as Scene5 } from "three";
+import { Scene as Scene4 } from "three";
 
 // src/skin/scene/SkinObject.ts
 init_SceneObject();
@@ -12144,7 +12612,7 @@ init_util();
 init_Caching();
 init_CacheKey();
 init_MineRenderError();
-import { DataTexture as DataTexture2, DoubleSide as DoubleSide4, FrontSide as FrontSide2, MeshBasicMaterial as MeshBasicMaterial6, SRGBColorSpace as SRGBColorSpace5 } from "three";
+import { DataTexture as DataTexture2, DoubleSide as DoubleSide4, FrontSide as FrontSide2, MeshBasicMaterial as MeshBasicMaterial6, SRGBColorSpace as SRGBColorSpace6 } from "three";
 
 // src/skin/SkinImage.ts
 init_Caching();
@@ -12226,7 +12694,7 @@ var SkinTextures = class {
   }
   static createMaterial(pixels, width, height, transparent = true) {
     const texture = Textures.initTextureProps(new DataTexture2(pixels, width, height));
-    texture.colorSpace = SRGBColorSpace5;
+    texture.colorSpace = SRGBColorSpace6;
     texture.flipY = true;
     texture.needsUpdate = true;
     return new MeshBasicMaterial6({ map: texture, transparent, side: transparent ? DoubleSide4 : FrontSide2, alphaTest: transparent ? 0.1 : 0 });
@@ -12459,7 +12927,7 @@ var SkinObject = class extends SceneObject {
 // src/renderer/MineRenderScene.ts
 init_EntityObject();
 init_ItemTints();
-var MineRenderScene = class _MineRenderScene extends Scene5 {
+var MineRenderScene = class _MineRenderScene extends Scene4 {
   constructor(options) {
     super();
     this.isMineRenderScene = true;
@@ -12505,12 +12973,13 @@ var MineRenderScene = class _MineRenderScene extends Scene5 {
   }
   updateObjectRegistration(object, attached) {
     if (this.observedObjects.has(object) === attached) return;
+    const observable = object;
     if (attached) {
       this.observedObjects.add(object);
-      object.addEventListener("change", this.onObjectChange);
+      observable.addEventListener("change", this.onObjectChange);
     } else {
       this.observedObjects.delete(object);
-      object.removeEventListener("change", this.onObjectChange);
+      observable.removeEventListener("change", this.onObjectChange);
     }
     const change = attached ? 1 : -1;
     this.stats.objectCount += change;
@@ -12588,7 +13057,7 @@ function isMineRenderScene(obj) {
 }
 
 // src/renderer/Renderer.ts
-import { AxesHelper as AxesHelper2, GridHelper, OrthographicCamera, PCFSoftShadowMap, PerspectiveCamera as PerspectiveCamera2, SRGBColorSpace as SRGBColorSpace6, Vector3 as Vector314, WebGLRenderer as WebGLRenderer2 } from "three";
+import { AxesHelper as AxesHelper2, GridHelper, OrthographicCamera, PCFShadowMap, PerspectiveCamera, SRGBColorSpace as SRGBColorSpace7, Vector3 as Vector314, WebGLRenderer } from "three";
 var import_ts_deepmerge9 = __toESM(require_dist());
 init_util();
 init_Model();
@@ -13333,7 +13802,7 @@ var Renderer = class _Renderer {
     switch (this.options.camera.type) {
       case "perspective":
       default:
-        return new PerspectiveCamera2(
+        return new PerspectiveCamera(
           this.options.camera.perspective.fov,
           this.options.camera.perspective.aspect ?? this.viewWidth / this.viewHeight,
           this.options.camera.near,
@@ -13351,7 +13820,7 @@ var Renderer = class _Renderer {
     }
   }
   createRenderer() {
-    const renderer = new WebGLRenderer2({
+    const renderer = new WebGLRenderer({
       antialias: this.options.render.antialias,
       alpha: true,
       powerPreference: "high-performance",
@@ -13359,8 +13828,8 @@ var Renderer = class _Renderer {
     });
     renderer.setClearColor(0, 0);
     renderer.shadowMap.enabled = true;
-    renderer.shadowMap.type = PCFSoftShadowMap;
-    renderer.outputColorSpace = SRGBColorSpace6;
+    renderer.shadowMap.type = PCFShadowMap;
+    renderer.outputColorSpace = SRGBColorSpace7;
     renderer.setPixelRatio(this.options.render.pixelRatio ?? 1);
     renderer.setSize(this.viewWidth, this.viewHeight);
     return renderer;
@@ -14438,7 +14907,7 @@ init_Model();
 // src/world/SectionMesh.ts
 init_CanvasCompat();
 init_Materials();
-import { BufferGeometry as BufferGeometry6, Float32BufferAttribute as Float32BufferAttribute6, Group, Mesh as Mesh10 } from "three";
+import { BufferGeometry as BufferGeometry7, Float32BufferAttribute as Float32BufferAttribute7, Group, Mesh as Mesh9 } from "three";
 var SectionMesh = class _SectionMesh extends Group {
   constructor() {
     super(...arguments);
@@ -14512,18 +14981,18 @@ var SectionMesh = class _SectionMesh extends Group {
           for (let corner = 0; corner < 6; corner++) indices.push(start + sourceIndices.getX(face * 6 + corner) - face * 4);
         }
       }
-      const geometry = new BufferGeometry6();
-      geometry.setAttribute("position", new Float32BufferAttribute6(positions, 3));
-      geometry.setAttribute("normal", new Float32BufferAttribute6(normals, 3));
-      geometry.setAttribute("uv", new Float32BufferAttribute6(uvs, 2));
-      geometry.setAttribute("color", new Float32BufferAttribute6(colors, 3));
+      const geometry = new BufferGeometry7();
+      geometry.setAttribute("position", new Float32BufferAttribute7(positions, 3));
+      geometry.setAttribute("normal", new Float32BufferAttribute7(normals, 3));
+      geometry.setAttribute("uv", new Float32BufferAttribute7(uvs, 2));
+      geometry.setAttribute("color", new Float32BufferAttribute7(colors, 3));
       geometry.setIndex(indices);
       geometry.computeBoundingBox();
       geometry.computeBoundingSphere();
       const material = Materials.createShadedCanvasMaterial(canvas, false);
       material.vertexColors = true;
       const texture = material.uniforms?.map?.value ?? material.map;
-      const mesh = new Mesh10(geometry, material);
+      const mesh = new Mesh9(geometry, material);
       section.add(mesh);
       section.ownedMeshes.push({ mesh, texture });
     }
@@ -14537,6 +15006,7 @@ var SectionMesh = class _SectionMesh extends Group {
       texture?.dispose();
     }
     this.removeFromParent();
+    super.dispose();
   }
 };
 
@@ -14840,6 +15310,7 @@ export {
   computeTangents,
   createCanvas2 as createCanvas,
   createFluidGeometry,
+  createGuiTextureGeometry,
   createImage,
   entityAnimationTime,
   estimateBytesUsed,