@loaders.gl/gltf 4.4.0-alpha.2 → 4.4.0

package/dist/dist.dev.js

@@ -105,6 +105,9 @@ var __exports__ = (() => {
   var matches = typeof process !== "undefined" && process.version && /v([0-9]*)/.exec(process.version);
   var nodeVersion = matches && parseFloat(matches[1]) || 0;
 
+  // ../loader-utils/src/lib/javascript-utils/is-type.ts
+  var isSharedArrayBuffer = (value) => typeof SharedArrayBuffer !== "undefined" && value instanceof SharedArrayBuffer;
+
   // ../loader-utils/src/lib/module-utils/js-module-utils.ts
   function registerJSModules(modules) {
     globalThis.loaders ||= {};
@@ -120,14 +123,16 @@ var __exports__ = (() => {
   var NPM_TAG = "beta";
 
   // ../worker-utils/src/lib/env-utils/version.ts
+  var warningIssued = false;
   function getVersion() {
     if (!globalThis._loadersgl_?.version) {
       globalThis._loadersgl_ = globalThis._loadersgl_ || {};
-      if (typeof __VERSION__ === "undefined") {
+      if (typeof __VERSION__ === "undefined" && !warningIssued) {
         console.warn(
           "loaders.gl: The __VERSION__ variable is not injected using babel plugin. Latest unstable workers would be fetched from the CDN."
         );
         globalThis._loadersgl_.version = NPM_TAG;
+        warningIssued = true;
       } else {
         globalThis._loadersgl_.version = __VERSION__;
       }
@@ -165,6 +170,16 @@ var __exports__ = (() => {
 
   // ../worker-utils/src/lib/library-utils/library-utils.ts
   var loadLibraryPromises = {};
+  function extractLoadLibraryOptions(options = {}) {
+    const useLocalLibraries = options.useLocalLibraries ?? options.core?.useLocalLibraries;
+    const CDN = options.CDN ?? options.core?.CDN;
+    const modules = options.modules;
+    return {
+      ...useLocalLibraries !== void 0 ? { useLocalLibraries } : {},
+      ...CDN !== void 0 ? { CDN } : {},
+      ...modules !== void 0 ? { modules } : {}
+    };
+  }
   async function loadLibrary(libraryUrl, moduleName = null, options = {}, libraryName = null) {
     if (moduleName) {
       libraryUrl = getLibraryUrl(libraryUrl, moduleName, options, libraryName);
@@ -174,6 +189,9 @@ var __exports__ = (() => {
     return await loadLibraryPromises[libraryUrl];
   }
   function getLibraryUrl(library, moduleName, options = {}, libraryName = null) {
+    if (options?.core) {
+      throw new Error("loadLibrary: options.core must be pre-normalized");
+    }
     if (!options.useLocalLibraries && library.startsWith("http")) {
       return library;
     }
@@ -199,10 +217,20 @@ var __exports__ = (() => {
       return await loadAsArrayBuffer(libraryUrl);
     }
     if (!isBrowser2) {
+      const { requireFromFile } = globalThis.loaders || {};
       try {
-        const { requireFromFile } = globalThis.loaders || {};
-        return await requireFromFile?.(libraryUrl);
+        const result = await requireFromFile?.(libraryUrl);
+        if (result || !libraryUrl.includes("/dist/libs/")) {
+          return result;
+        }
+        return await requireFromFile?.(libraryUrl.replace("/dist/libs/", "/src/libs/"));
       } catch (error) {
+        if (libraryUrl.includes("/dist/libs/")) {
+          try {
+            return await requireFromFile?.(libraryUrl.replace("/dist/libs/", "/src/libs/"));
+          } catch {
+          }
+        }
         console.error(error);
         return null;
       }
@@ -238,7 +266,14 @@ var __exports__ = (() => {
       const response = await fetch(url);
       return await response.arrayBuffer();
     }
-    return await readFileAsArrayBuffer(url);
+    try {
+      return await readFileAsArrayBuffer(url);
+    } catch {
+      if (url.includes("/dist/libs/")) {
+        return await readFileAsArrayBuffer(url.replace("/dist/libs/", "/src/libs/"));
+      }
+      throw new Error(`Failed to load ArrayBuffer from ${url}`);
+    }
   }
   async function loadAsText(url) {
     const { readFileAsText } = globalThis.loaders || {};
@@ -246,7 +281,14 @@ var __exports__ = (() => {
       const response = await fetch(url);
       return await response.text();
     }
-    return await readFileAsText(url);
+    try {
+      return await readFileAsText(url);
+    } catch {
+      if (url.includes("/dist/libs/")) {
+        return await readFileAsText(url.replace("/dist/libs/", "/src/libs/"));
+      }
+      throw new Error(`Failed to load text from ${url}`);
+    }
   }
 
   // ../loader-utils/src/lib/binary-utils/get-first-characters.ts
@@ -334,6 +376,27 @@ var __exports__ = (() => {
     return byteOffset;
   }
 
+  // ../loader-utils/src/lib/binary-utils/memory-conversion-utils.ts
+  function ensureArrayBuffer(bufferSource) {
+    if (bufferSource instanceof ArrayBuffer) {
+      return bufferSource;
+    }
+    if (isSharedArrayBuffer(bufferSource)) {
+      return copyToArrayBuffer(bufferSource);
+    }
+    const { buffer, byteOffset, byteLength } = bufferSource;
+    if (buffer instanceof ArrayBuffer && byteOffset === 0 && byteLength === buffer.byteLength) {
+      return buffer;
+    }
+    return copyToArrayBuffer(buffer, byteOffset, byteLength);
+  }
+  function copyToArrayBuffer(buffer, byteOffset = 0, byteLength = buffer.byteLength - byteOffset) {
+    const view = new Uint8Array(buffer, byteOffset, byteLength);
+    const copy = new Uint8Array(view.length);
+    copy.set(view);
+    return copy.buffer;
+  }
+
   // ../images/src/lib/category-api/image-type.ts
   var parseImageNode = globalThis.loaders?.parseImageNode;
   var IMAGE_SUPPORTED = typeof Image !== "undefined";
@@ -470,7 +533,6 @@ var __exports__ = (() => {
   }
 
   // ../images/src/lib/parsers/parse-to-image-bitmap.ts
-  var EMPTY_OBJECT = {};
   var imagebitmapOptionsSupported = true;
   async function parseToImageBitmap(arrayBuffer, options, url) {
     let blob;
@@ -498,8 +560,13 @@ var __exports__ = (() => {
     return await createImageBitmap(blob);
   }
   function isEmptyObject(object) {
-    for (const key in object || EMPTY_OBJECT) {
-      return false;
+    if (!object) {
+      return true;
+    }
+    for (const key in object) {
+      if (Object.prototype.hasOwnProperty.call(object, key)) {
+        return false;
+      }
     }
     return true;
   }
@@ -1520,7 +1587,7 @@ var __exports__ = (() => {
       buffer = bufferArray.slice(offset, offset + byteLength).buffer;
       offset = 0;
     }
-    return new ArrayType(buffer, offset, length);
+    return new ArrayType(ensureArrayBuffer(buffer), offset, length);
   }
   function getPrimitiveTextureData(scenegraph, textureInfo, primitive) {
     const texCoordAccessorKey = `TEXCOORD_${textureInfo.texCoord || 0}`;
@@ -2278,7 +2345,7 @@ var __exports__ = (() => {
   }
   function createBufferView(typedArray, scenegraph) {
     scenegraph.gltf.buffers.push({
-      arrayBuffer: typedArray.buffer,
+      arrayBuffer: ensureArrayBuffer(typedArray.buffer),
       byteOffset: typedArray.byteOffset,
       byteLength: typedArray.byteLength
     });
@@ -2616,104 +2683,117 @@ var __exports__ = (() => {
   }
 
   // ../textures/src/lib/gl-extensions.ts
-  var GL_EXTENSIONS_CONSTANTS = {
-    // WEBGL_compressed_texture_s3tc
-    COMPRESSED_RGB_S3TC_DXT1_EXT: 33776,
-    COMPRESSED_RGBA_S3TC_DXT1_EXT: 33777,
-    COMPRESSED_RGBA_S3TC_DXT3_EXT: 33778,
-    COMPRESSED_RGBA_S3TC_DXT5_EXT: 33779,
-    // WEBGL_compressed_texture_es3
-    COMPRESSED_R11_EAC: 37488,
-    COMPRESSED_SIGNED_R11_EAC: 37489,
-    COMPRESSED_RG11_EAC: 37490,
-    COMPRESSED_SIGNED_RG11_EAC: 37491,
-    COMPRESSED_RGB8_ETC2: 37492,
-    COMPRESSED_RGBA8_ETC2_EAC: 37493,
-    COMPRESSED_SRGB8_ETC2: 37494,
-    COMPRESSED_SRGB8_ALPHA8_ETC2_EAC: 37495,
-    COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2: 37496,
-    COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2: 37497,
-    // WEBGL_compressed_texture_pvrtc
-    COMPRESSED_RGB_PVRTC_4BPPV1_IMG: 35840,
-    COMPRESSED_RGBA_PVRTC_4BPPV1_IMG: 35842,
-    COMPRESSED_RGB_PVRTC_2BPPV1_IMG: 35841,
-    COMPRESSED_RGBA_PVRTC_2BPPV1_IMG: 35843,
-    // WEBGL_compressed_texture_etc1
-    COMPRESSED_RGB_ETC1_WEBGL: 36196,
-    // WEBGL_compressed_texture_atc
-    COMPRESSED_RGB_ATC_WEBGL: 35986,
-    COMPRESSED_RGBA_ATC_EXPLICIT_ALPHA_WEBGL: 35987,
-    COMPRESSED_RGBA_ATC_INTERPOLATED_ALPHA_WEBGL: 34798,
-    // WEBGL_compressed_texture_astc
-    COMPRESSED_RGBA_ASTC_4X4_KHR: 37808,
-    COMPRESSED_RGBA_ASTC_5X4_KHR: 37809,
-    COMPRESSED_RGBA_ASTC_5X5_KHR: 37810,
-    COMPRESSED_RGBA_ASTC_6X5_KHR: 37811,
-    COMPRESSED_RGBA_ASTC_6X6_KHR: 37812,
-    COMPRESSED_RGBA_ASTC_8X5_KHR: 37813,
-    COMPRESSED_RGBA_ASTC_8X6_KHR: 37814,
-    COMPRESSED_RGBA_ASTC_8X8_KHR: 37815,
-    COMPRESSED_RGBA_ASTC_10X5_KHR: 37816,
-    COMPRESSED_RGBA_ASTC_10X6_KHR: 37817,
-    COMPRESSED_RGBA_ASTC_10X8_KHR: 37818,
-    COMPRESSED_RGBA_ASTC_10X10_KHR: 37819,
-    COMPRESSED_RGBA_ASTC_12X10_KHR: 37820,
-    COMPRESSED_RGBA_ASTC_12X12_KHR: 37821,
-    COMPRESSED_SRGB8_ALPHA8_ASTC_4X4_KHR: 37840,
-    COMPRESSED_SRGB8_ALPHA8_ASTC_5X4_KHR: 37841,
-    COMPRESSED_SRGB8_ALPHA8_ASTC_5X5_KHR: 37842,
-    COMPRESSED_SRGB8_ALPHA8_ASTC_6X5_KHR: 37843,
-    COMPRESSED_SRGB8_ALPHA8_ASTC_6X6_KHR: 37844,
-    COMPRESSED_SRGB8_ALPHA8_ASTC_8X5_KHR: 37845,
-    COMPRESSED_SRGB8_ALPHA8_ASTC_8X6_KHR: 37846,
-    COMPRESSED_SRGB8_ALPHA8_ASTC_8X8_KHR: 37847,
-    COMPRESSED_SRGB8_ALPHA8_ASTC_10X5_KHR: 37848,
-    COMPRESSED_SRGB8_ALPHA8_ASTC_10X6_KHR: 37849,
-    COMPRESSED_SRGB8_ALPHA8_ASTC_10X8_KHR: 37850,
-    COMPRESSED_SRGB8_ALPHA8_ASTC_10X10_KHR: 37851,
-    COMPRESSED_SRGB8_ALPHA8_ASTC_12X10_KHR: 37852,
-    COMPRESSED_SRGB8_ALPHA8_ASTC_12X12_KHR: 37853,
-    // EXT_texture_compression_rgtc
-    COMPRESSED_RED_RGTC1_EXT: 36283,
-    COMPRESSED_SIGNED_RED_RGTC1_EXT: 36284,
-    COMPRESSED_RED_GREEN_RGTC2_EXT: 36285,
-    COMPRESSED_SIGNED_RED_GREEN_RGTC2_EXT: 36286,
-    // WEBGL_compressed_texture_s3tc_srgb
-    COMPRESSED_SRGB_S3TC_DXT1_EXT: 35916,
-    COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT: 35917,
-    COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT: 35918,
-    COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT: 35919
-  };
+  var GL_RGBA4 = 32854;
+  var GL_RGBA8 = 32856;
+  var GL_RGB565 = 36194;
+  var GL_COMPRESSED_RGB_S3TC_DXT1_EXT = 33776;
+  var GL_COMPRESSED_RGBA_S3TC_DXT5_EXT = 33779;
+  var GL_COMPRESSED_RGBA8_ETC2_EAC = 37493;
+  var GL_COMPRESSED_RGB_PVRTC_4BPPV1_IMG = 35840;
+  var GL_COMPRESSED_RGBA_PVRTC_4BPPV1_IMG = 35842;
+  var GL_COMPRESSED_RGB_ETC1_WEBGL = 36196;
+  var GL_COMPRESSED_RGB_ATC_WEBGL = 35986;
+  var GL_COMPRESSED_RGBA_ATC_INTERPOLATED_ALPHA_WEBGL = 34798;
+  var GL_COMPRESSED_RGBA_ASTC_4x4_KHR = 37808;
+  var GL_COMPRESSED_RED_RGTC1_EXT = 36283;
+  var GL_COMPRESSED_RED_GREEN_RGTC2_EXT = 36285;
+  var GL_COMPRESSED_RGBA_BPTC_UNORM_EXT = 36492;
 
-  // ../textures/src/lib/utils/texture-formats.ts
+  // ../textures/src/lib/utils/detect-supported-texture-formats.ts
   var BROWSER_PREFIXES = ["", "WEBKIT_", "MOZ_"];
-  var WEBGL_EXTENSIONS = {
+  var WEBGL_TEXTURE_FORMATS = {
     /* eslint-disable camelcase */
-    WEBGL_compressed_texture_s3tc: "dxt",
-    WEBGL_compressed_texture_s3tc_srgb: "dxt-srgb",
-    WEBGL_compressed_texture_etc1: "etc1",
-    WEBGL_compressed_texture_etc: "etc2",
-    WEBGL_compressed_texture_pvrtc: "pvrtc",
-    WEBGL_compressed_texture_atc: "atc",
-    WEBGL_compressed_texture_astc: "astc",
-    EXT_texture_compression_rgtc: "rgtc"
+    WEBGL_compressed_texture_s3tc: [
+      "bc1-rgb-unorm-webgl",
+      "bc1-rgba-unorm",
+      "bc2-rgba-unorm",
+      "bc3-rgba-unorm"
+    ],
+    WEBGL_compressed_texture_s3tc_srgb: [
+      "bc1-rgb-unorm-srgb-webgl",
+      "bc1-rgba-unorm-srgb",
+      "bc2-rgba-unorm-srgb",
+      "bc3-rgba-unorm-srgb"
+    ],
+    EXT_texture_compression_rgtc: ["bc4-r-unorm", "bc4-r-snorm", "bc5-rg-unorm", "bc5-rg-snorm"],
+    EXT_texture_compression_bptc: [
+      "bc6h-rgb-ufloat",
+      "bc6h-rgb-float",
+      "bc7-rgba-unorm",
+      "bc7-rgba-unorm-srgb"
+    ],
+    WEBGL_compressed_texture_etc1: ["etc1-rgb-unorm-webgl"],
+    WEBGL_compressed_texture_etc: [
+      "etc2-rgb8unorm",
+      "etc2-rgb8unorm-srgb",
+      "etc2-rgb8a1unorm",
+      "etc2-rgb8a1unorm-srgb",
+      "etc2-rgba8unorm",
+      "etc2-rgba8unorm-srgb",
+      "eac-r11unorm",
+      "eac-r11snorm",
+      "eac-rg11unorm",
+      "eac-rg11snorm"
+    ],
+    WEBGL_compressed_texture_pvrtc: [
+      "pvrtc-rgb4unorm-webgl",
+      "pvrtc-rgba4unorm-webgl",
+      "pvrtc-rgb2unorm-webgl",
+      "pvrtc-rgba2unorm-webgl"
+    ],
+    WEBGL_compressed_texture_atc: [
+      "atc-rgb-unorm-webgl",
+      "atc-rgba-unorm-webgl",
+      "atc-rgbai-unorm-webgl"
+    ],
+    WEBGL_compressed_texture_astc: [
+      "astc-4x4-unorm",
+      "astc-4x4-unorm-srgb",
+      "astc-5x4-unorm",
+      "astc-5x4-unorm-srgb",
+      "astc-5x5-unorm",
+      "astc-5x5-unorm-srgb",
+      "astc-6x5-unorm",
+      "astc-6x5-unorm-srgb",
+      "astc-6x6-unorm",
+      "astc-6x6-unorm-srgb",
+      "astc-8x5-unorm",
+      "astc-8x5-unorm-srgb",
+      "astc-8x6-unorm",
+      "astc-8x6-unorm-srgb",
+      "astc-8x8-unorm",
+      "astc-8x8-unorm-srgb",
+      "astc-10x5-unorm",
+      "astc-10x5-unorm-srgb",
+      "astc-10x6-unorm",
+      "astc-10x6-unorm-srgb",
+      "astc-10x8-unorm",
+      "astc-10x8-unorm-srgb",
+      "astc-10x10-unorm",
+      "astc-10x10-unorm-srgb",
+      "astc-12x10-unorm",
+      "astc-12x10-unorm-srgb",
+      "astc-12x12-unorm",
+      "astc-12x12-unorm-srgb"
+    ]
     /* eslint-enable camelcase */
   };
-  var formats = null;
-  function getSupportedGPUTextureFormats(gl) {
-    if (!formats) {
+  var textureFormats = null;
+  function detectSupportedTextureFormats(gl) {
+    if (!textureFormats) {
       gl = gl || getWebGLContext() || void 0;
-      formats = /* @__PURE__ */ new Set();
+      textureFormats = /* @__PURE__ */ new Set();
       for (const prefix of BROWSER_PREFIXES) {
-        for (const extension in WEBGL_EXTENSIONS) {
+        for (const extension in WEBGL_TEXTURE_FORMATS) {
           if (gl && gl.getExtension(`${prefix}${extension}`)) {
-            const gpuTextureFormat = WEBGL_EXTENSIONS[extension];
-            formats.add(gpuTextureFormat);
+            for (const textureFormat of WEBGL_TEXTURE_FORMATS[extension]) {
+              textureFormats.add(textureFormat);
+            }
           }
         }
       }
     }
-    return formats;
+    return textureFormats;
   }
   function getWebGLContext() {
     try {
@@ -2758,73 +2838,154 @@ var __exports__ = (() => {
   }
 
   // ../textures/src/lib/parsers/parse-basis.ts
-  var OutputFormat = {
+  var basisTranscodingLock = Promise.resolve();
+  var BASIS_FORMAT_TO_OUTPUT_OPTIONS = {
     etc1: {
       basisFormat: 0,
       compressed: true,
-      format: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGB_ETC1_WEBGL
+      format: GL_COMPRESSED_RGB_ETC1_WEBGL,
+      textureFormat: "etc1-rgb-unorm-webgl"
+    },
+    etc2: {
+      basisFormat: 1,
+      compressed: true,
+      format: GL_COMPRESSED_RGBA8_ETC2_EAC,
+      textureFormat: "etc2-rgba8unorm"
     },
-    etc2: { basisFormat: 1, compressed: true },
     bc1: {
       basisFormat: 2,
       compressed: true,
-      format: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGB_S3TC_DXT1_EXT
+      format: GL_COMPRESSED_RGB_S3TC_DXT1_EXT,
+      textureFormat: "bc1-rgb-unorm-webgl"
     },
     bc3: {
       basisFormat: 3,
       compressed: true,
-      format: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_S3TC_DXT5_EXT
+      format: GL_COMPRESSED_RGBA_S3TC_DXT5_EXT,
+      textureFormat: "bc3-rgba-unorm"
+    },
+    bc4: {
+      basisFormat: 4,
+      compressed: true,
+      format: GL_COMPRESSED_RED_RGTC1_EXT,
+      textureFormat: "bc4-r-unorm"
+    },
+    bc5: {
+      basisFormat: 5,
+      compressed: true,
+      format: GL_COMPRESSED_RED_GREEN_RGTC2_EXT,
+      textureFormat: "bc5-rg-unorm"
+    },
+    "bc7-m6-opaque-only": {
+      basisFormat: 6,
+      compressed: true,
+      format: GL_COMPRESSED_RGBA_BPTC_UNORM_EXT,
+      textureFormat: "bc7-rgba-unorm"
+    },
+    "bc7-m5": {
+      basisFormat: 7,
+      compressed: true,
+      format: GL_COMPRESSED_RGBA_BPTC_UNORM_EXT,
+      textureFormat: "bc7-rgba-unorm"
     },
-    bc4: { basisFormat: 4, compressed: true },
-    bc5: { basisFormat: 5, compressed: true },
-    "bc7-m6-opaque-only": { basisFormat: 6, compressed: true },
-    "bc7-m5": { basisFormat: 7, compressed: true },
     "pvrtc1-4-rgb": {
       basisFormat: 8,
       compressed: true,
-      format: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGB_PVRTC_4BPPV1_IMG
+      format: GL_COMPRESSED_RGB_PVRTC_4BPPV1_IMG,
+      textureFormat: "pvrtc-rgb4unorm-webgl"
     },
     "pvrtc1-4-rgba": {
       basisFormat: 9,
       compressed: true,
-      format: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_PVRTC_4BPPV1_IMG
+      format: GL_COMPRESSED_RGBA_PVRTC_4BPPV1_IMG,
+      textureFormat: "pvrtc-rgba4unorm-webgl"
     },
     "astc-4x4": {
       basisFormat: 10,
       compressed: true,
-      format: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_4X4_KHR
+      format: GL_COMPRESSED_RGBA_ASTC_4x4_KHR,
+      textureFormat: "astc-4x4-unorm"
     },
-    "atc-rgb": { basisFormat: 11, compressed: true },
-    "atc-rgba-interpolated-alpha": { basisFormat: 12, compressed: true },
-    rgba32: { basisFormat: 13, compressed: false },
-    rgb565: { basisFormat: 14, compressed: false },
-    bgr565: { basisFormat: 15, compressed: false },
-    rgba4444: { basisFormat: 16, compressed: false }
+    "atc-rgb": {
+      basisFormat: 11,
+      compressed: true,
+      format: GL_COMPRESSED_RGB_ATC_WEBGL,
+      textureFormat: "atc-rgb-unorm-webgl"
+    },
+    "atc-rgba-interpolated-alpha": {
+      basisFormat: 12,
+      compressed: true,
+      format: GL_COMPRESSED_RGBA_ATC_INTERPOLATED_ALPHA_WEBGL,
+      textureFormat: "atc-rgbai-unorm-webgl"
+    },
+    rgba32: {
+      basisFormat: 13,
+      compressed: false,
+      format: GL_RGBA8,
+      textureFormat: "rgba8unorm"
+    },
+    rgb565: {
+      basisFormat: 14,
+      compressed: false,
+      format: GL_RGB565,
+      textureFormat: "rgb565unorm-webgl"
+    },
+    bgr565: {
+      basisFormat: 15,
+      compressed: false,
+      format: GL_RGB565,
+      textureFormat: "rgb565unorm-webgl"
+    },
+    rgba4444: {
+      basisFormat: 16,
+      compressed: false,
+      format: GL_RGBA4,
+      textureFormat: "rgba4unorm-webgl"
+    }
   };
-  async function parseBasis(data, options) {
-    if (options.basis.containerFormat === "auto") {
-      if (isKTX(data)) {
-        const fileConstructors = await loadBasisEncoderModule(options);
-        return parseKTX2File(fileConstructors.KTX2File, data, options);
-      }
-      const { BasisFile } = await loadBasisTranscoderModule(options);
-      return parseBasisFile(BasisFile, data, options);
-    }
-    switch (options.basis.module) {
-      case "encoder":
-        const fileConstructors = await loadBasisEncoderModule(options);
-        switch (options.basis.containerFormat) {
-          case "ktx2":
-            return parseKTX2File(fileConstructors.KTX2File, data, options);
-          case "basis":
-          default:
-            return parseBasisFile(fileConstructors.BasisFile, data, options);
+  var BASIS_FORMATS = Object.freeze(
+    Object.keys(BASIS_FORMAT_TO_OUTPUT_OPTIONS)
+  );
+  async function withBasisTranscodingLock(transcode) {
+    const previousLock = basisTranscodingLock;
+    let releaseLock;
+    basisTranscodingLock = new Promise((resolve) => {
+      releaseLock = resolve;
+    });
+    await previousLock;
+    try {
+      return await transcode();
+    } finally {
+      releaseLock();
+    }
+  }
+  async function parseBasis(data, options = {}) {
+    const loadLibraryOptions = extractLoadLibraryOptions(options);
+    return await withBasisTranscodingLock(async () => {
+      if (!options.basis?.containerFormat || options.basis.containerFormat === "auto") {
+        if (isKTX(data)) {
+          const fileConstructors = await loadBasisEncoderModule(loadLibraryOptions);
+          return parseKTX2File(fileConstructors.KTX2File, data, options);
         }
-      case "transcoder":
-      default:
-        const { BasisFile } = await loadBasisTranscoderModule(options);
+        const { BasisFile } = await loadBasisTranscoderModule(loadLibraryOptions);
         return parseBasisFile(BasisFile, data, options);
-    }
+      }
+      switch (options.basis.module) {
+        case "encoder":
+          const fileConstructors = await loadBasisEncoderModule(loadLibraryOptions);
+          switch (options.basis.containerFormat) {
+            case "ktx2":
+              return parseKTX2File(fileConstructors.KTX2File, data, options);
+            case "basis":
+            default:
+              return parseBasisFile(fileConstructors.BasisFile, data, options);
+          }
+        case "transcoder":
+        default:
+          const { BasisFile } = await loadBasisTranscoderModule(loadLibraryOptions);
+          return parseBasisFile(BasisFile, data, options);
+      }
+    });
   }
   function parseBasisFile(BasisFile, data, options) {
     const basisFile = new BasisFile(new Uint8Array(data));
@@ -2854,7 +3015,7 @@ var __exports__ = (() => {
     const hasAlpha = basisFile.getHasAlpha(
       /* imageIndex, levelIndex */
     );
-    const { compressed, format, basisFormat } = getBasisOptions(options, hasAlpha);
+    const { compressed, format, basisFormat, textureFormat } = getBasisOptions(options, hasAlpha);
     const decodedSize = basisFile.getImageTranscodedSizeInBytes(imageIndex, levelIndex, basisFormat);
     const decodedData = new Uint8Array(decodedSize);
     if (!basisFile.transcodeImage(decodedData, imageIndex, levelIndex, basisFormat, 0, 0)) {
@@ -2862,11 +3023,13 @@ var __exports__ = (() => {
     }
     return {
       // standard loaders.gl image category payload
+      shape: "texture-level",
       width,
       height,
       data: decodedData,
       compressed,
-      format,
+      ...format !== void 0 ? { format } : {},
+      ...textureFormat !== void 0 ? { textureFormat } : {},
       // Additional fields
       // Add levelSize field.
       hasAlpha
@@ -2891,7 +3054,7 @@ var __exports__ = (() => {
   }
   function transcodeKTX2Image(ktx2File, levelIndex, options) {
     const { alphaFlag, height, width } = ktx2File.getImageLevelInfo(levelIndex, 0, 0);
-    const { compressed, format, basisFormat } = getBasisOptions(options, alphaFlag);
+    const { compressed, format, basisFormat, textureFormat } = getBasisOptions(options, alphaFlag);
     const decodedSize = ktx2File.getImageTranscodedSizeInBytes(
       levelIndex,
       0,
@@ -2914,48 +3077,98 @@ var __exports__ = (() => {
     }
     return {
       // standard loaders.gl image category payload
+      shape: "texture-level",
       width,
       height,
       data: decodedData,
       compressed,
+      ...format !== void 0 ? { format } : {},
+      ...textureFormat !== void 0 ? { textureFormat } : {},
       // Additional fields
       levelSize: decodedSize,
-      hasAlpha: alphaFlag,
-      format
+      hasAlpha: alphaFlag
     };
   }
   function getBasisOptions(options, hasAlpha) {
-    let format = options && options.basis && options.basis.format;
+    let format = options.basis?.format || "auto";
     if (format === "auto") {
-      format = selectSupportedBasisFormat();
+      format = options.basis?.supportedTextureFormats ? selectSupportedBasisFormat(options.basis.supportedTextureFormats) : selectSupportedBasisFormat();
     }
     if (typeof format === "object") {
       format = hasAlpha ? format.alpha : format.noAlpha;
     }
-    format = format.toLowerCase();
-    return OutputFormat[format];
+    const normalizedFormat = format.toLowerCase();
+    const basisOutputOptions = BASIS_FORMAT_TO_OUTPUT_OPTIONS[normalizedFormat];
+    if (!basisOutputOptions) {
+      throw new Error(`Unknown Basis format ${format}`);
+    }
+    return basisOutputOptions;
   }
-  function selectSupportedBasisFormat() {
-    const supportedFormats = getSupportedGPUTextureFormats();
-    if (supportedFormats.has("astc")) {
+  function selectSupportedBasisFormat(supportedTextureFormats = detectSupportedTextureFormats()) {
+    const textureFormats2 = new Set(supportedTextureFormats);
+    if (hasSupportedTextureFormat(textureFormats2, ["astc-4x4-unorm", "astc-4x4-unorm-srgb"])) {
       return "astc-4x4";
-    } else if (supportedFormats.has("dxt")) {
+    } else if (hasSupportedTextureFormat(textureFormats2, ["bc7-rgba-unorm", "bc7-rgba-unorm-srgb"])) {
+      return {
+        alpha: "bc7-m5",
+        noAlpha: "bc7-m6-opaque-only"
+      };
+    } else if (hasSupportedTextureFormat(textureFormats2, [
+      "bc1-rgb-unorm-webgl",
+      "bc1-rgb-unorm-srgb-webgl",
+      "bc1-rgba-unorm",
+      "bc1-rgba-unorm-srgb",
+      "bc2-rgba-unorm",
+      "bc2-rgba-unorm-srgb",
+      "bc3-rgba-unorm",
+      "bc3-rgba-unorm-srgb"
+    ])) {
       return {
         alpha: "bc3",
         noAlpha: "bc1"
       };
-    } else if (supportedFormats.has("pvrtc")) {
+    } else if (hasSupportedTextureFormat(textureFormats2, [
+      "pvrtc-rgb4unorm-webgl",
+      "pvrtc-rgba4unorm-webgl",
+      "pvrtc-rgb2unorm-webgl",
+      "pvrtc-rgba2unorm-webgl"
+    ])) {
       return {
         alpha: "pvrtc1-4-rgba",
         noAlpha: "pvrtc1-4-rgb"
       };
-    } else if (supportedFormats.has("etc1")) {
-      return "etc1";
-    } else if (supportedFormats.has("etc2")) {
+    } else if (hasSupportedTextureFormat(textureFormats2, [
+      "etc2-rgb8unorm",
+      "etc2-rgb8unorm-srgb",
+      "etc2-rgb8a1unorm",
+      "etc2-rgb8a1unorm-srgb",
+      "etc2-rgba8unorm",
+      "etc2-rgba8unorm-srgb",
+      "eac-r11unorm",
+      "eac-r11snorm",
+      "eac-rg11unorm",
+      "eac-rg11snorm"
+    ])) {
       return "etc2";
+    } else if (textureFormats2.has("etc1-rgb-unorm-webgl")) {
+      return "etc1";
+    } else if (hasSupportedTextureFormat(textureFormats2, [
+      "atc-rgb-unorm-webgl",
+      "atc-rgba-unorm-webgl",
+      "atc-rgbai-unorm-webgl"
+    ])) {
+      return {
+        alpha: "atc-rgba-interpolated-alpha",
+        noAlpha: "atc-rgb"
+      };
     }
     return "rgb565";
   }
+  function hasSupportedTextureFormat(supportedTextureFormats, candidateTextureFormats) {
+    return candidateTextureFormats.some(
+      (textureFormat) => supportedTextureFormats.has(textureFormat)
+    );
+  }
 
   // ../textures/src/basis-loader.ts
   var BasisWorkerLoader = {
@@ -2973,7 +3186,6 @@ var __exports__ = (() => {
     options: {
       basis: {
         format: "auto",
-        libraryPath: "libs/",
         containerFormat: "auto",
         module: "transcoder"
       }
@@ -3095,16 +3307,26 @@ var __exports__ = (() => {
   }
 
   // src/lib/gltf-utils/resolve-url.ts
-  function resolveUrl(url, options) {
+  function resolveUrl(url, options, context) {
     const absolute = url.startsWith("data:") || url.startsWith("http:") || url.startsWith("https:");
     if (absolute) {
       return url;
     }
-    const baseUrl = options.baseUri || options.uri;
+    const baseUrl = context?.baseUrl || getResolveBaseUrl(options?.core?.baseUrl);
     if (!baseUrl) {
-      throw new Error(`'baseUri' must be provided to resolve relative url ${url}`);
+      throw new Error(`'baseUrl' must be provided to resolve relative url ${url}`);
     }
-    return baseUrl.substr(0, baseUrl.lastIndexOf("/") + 1) + url;
+    return baseUrl.endsWith("/") ? `${baseUrl}${url}` : `${baseUrl}/${url}`;
+  }
+  function getResolveBaseUrl(baseUrl) {
+    if (!baseUrl) {
+      return void 0;
+    }
+    if (baseUrl.endsWith("/")) {
+      return baseUrl;
+    }
+    const slashIndex = baseUrl.lastIndexOf("/");
+    return slashIndex >= 0 ? baseUrl.slice(0, slashIndex + 1) : "";
   }
 
   // src/lib/extensions/EXT_meshopt_compression.ts
@@ -3439,21 +3661,32 @@ var __exports__ = (() => {
     [DRACO_EXTERNAL_LIBRARIES.ENCODER]: `https://raw.githubusercontent.com/google/draco/${DRACO_ENCODER_VERSION}/javascript/${DRACO_EXTERNAL_LIBRARIES.ENCODER}`
   };
   var loadDecoderPromise;
-  async function loadDracoDecoderModule(options) {
+  async function loadDracoDecoderModule(options = {}, type) {
     const modules = options.modules || {};
     if (modules.draco3d) {
       loadDecoderPromise ||= modules.draco3d.createDecoderModule({}).then((draco) => {
         return { draco };
       });
     } else {
-      loadDecoderPromise ||= loadDracoDecoder(options);
+      loadDecoderPromise ||= loadDracoDecoder(options, type);
     }
     return await loadDecoderPromise;
   }
-  async function loadDracoDecoder(options) {
+  function getLibraryExport(library, exportName) {
+    if (library && typeof library === "object") {
+      if (library.default) {
+        return library.default;
+      }
+      if (library[exportName]) {
+        return library[exportName];
+      }
+    }
+    return library;
+  }
+  async function loadDracoDecoder(options, type) {
     let DracoDecoderModule;
     let wasmBinary;
-    switch (options.draco && options.draco.decoderType) {
+    switch (type) {
       case "js":
         DracoDecoderModule = await loadLibrary(
           DRACO_EXTERNAL_LIBRARY_URLS[DRACO_EXTERNAL_LIBRARIES.FALLBACK_DECODER],
@@ -3464,25 +3697,52 @@ var __exports__ = (() => {
         break;
       case "wasm":
       default:
-        [DracoDecoderModule, wasmBinary] = await Promise.all([
-          await loadLibrary(
-            DRACO_EXTERNAL_LIBRARY_URLS[DRACO_EXTERNAL_LIBRARIES.DECODER],
-            "draco",
-            options,
-            DRACO_EXTERNAL_LIBRARIES.DECODER
-          ),
-          await loadLibrary(
-            DRACO_EXTERNAL_LIBRARY_URLS[DRACO_EXTERNAL_LIBRARIES.DECODER_WASM],
-            "draco",
-            options,
-            DRACO_EXTERNAL_LIBRARIES.DECODER_WASM
-          )
-        ]);
+        try {
+          [DracoDecoderModule, wasmBinary] = await Promise.all([
+            await loadLibrary(
+              DRACO_EXTERNAL_LIBRARY_URLS[DRACO_EXTERNAL_LIBRARIES.DECODER],
+              "draco",
+              options,
+              DRACO_EXTERNAL_LIBRARIES.DECODER
+            ),
+            await loadLibrary(
+              DRACO_EXTERNAL_LIBRARY_URLS[DRACO_EXTERNAL_LIBRARIES.DECODER_WASM],
+              "draco",
+              options,
+              DRACO_EXTERNAL_LIBRARIES.DECODER_WASM
+            )
+          ]);
+        } catch {
+          DracoDecoderModule = null;
+          wasmBinary = null;
+        }
     }
+    DracoDecoderModule = getLibraryExport(DracoDecoderModule, "DracoDecoderModule");
     DracoDecoderModule = DracoDecoderModule || globalThis.DracoDecoderModule;
+    if (!DracoDecoderModule && !isBrowser2) {
+      [DracoDecoderModule, wasmBinary] = await Promise.all([
+        await loadLibrary(
+          DRACO_EXTERNAL_LIBRARY_URLS[DRACO_EXTERNAL_LIBRARIES.DECODER],
+          "draco",
+          { ...options, useLocalLibraries: true },
+          DRACO_EXTERNAL_LIBRARIES.DECODER
+        ),
+        await loadLibrary(
+          DRACO_EXTERNAL_LIBRARY_URLS[DRACO_EXTERNAL_LIBRARIES.DECODER_WASM],
+          "draco",
+          { ...options, useLocalLibraries: true },
+          DRACO_EXTERNAL_LIBRARIES.DECODER_WASM
+        )
+      ]);
+      DracoDecoderModule = getLibraryExport(DracoDecoderModule, "DracoDecoderModule");
+      DracoDecoderModule = DracoDecoderModule || globalThis.DracoDecoderModule;
+    }
     return await initializeDracoDecoder(DracoDecoderModule, wasmBinary);
   }
   function initializeDracoDecoder(DracoDecoderModule, wasmBinary) {
+    if (typeof DracoDecoderModule !== "function") {
+      throw new Error("DracoDecoderModule could not be loaded");
+    }
     const options = {};
     if (wasmBinary) {
       options.wasmBinary = wasmBinary;
@@ -4091,7 +4351,6 @@ var __exports__ = (() => {
       draco: {
         decoderType: typeof WebAssembly === "object" ? "wasm" : "js",
         // 'js' for IE11
-        libraryPath: "libs/",
         extraAttributes: {},
         attributeNameEntry: void 0
       }
@@ -4102,7 +4361,10 @@ var __exports__ = (() => {
     parse
   };
   async function parse(arrayBuffer, options) {
-    const { draco } = await loadDracoDecoderModule(options);
+    const { draco } = await loadDracoDecoderModule(
+      extractLoadLibraryOptions(options),
+      options?.draco?.decoderType || "wasm"
+    );
     const dracoParser = new DracoParser(draco);
     try {
       return dracoParser.parseSync(arrayBuffer, options?.draco);
@@ -5566,7 +5828,7 @@ var __exports__ = (() => {
     const texCoordAccessor = primitive.attributes[`TEXCOORD_${originalTexCoord}`];
     if (Number.isFinite(texCoordAccessor)) {
       const accessor = gltfData.json.accessors?.[texCoordAccessor];
-      if (accessor && accessor.bufferView) {
+      if (accessor && accessor.bufferView !== void 0) {
         const bufferView = gltfData.json.bufferViews?.[accessor.bufferView];
         if (bufferView) {
           const { arrayBuffer, byteOffset: bufferByteOffset } = gltfData.buffers[bufferView.buffer];
@@ -5583,7 +5845,7 @@ var __exports__ = (() => {
             result.set([scratchVector[0], scratchVector[1]], i * components);
           }
           if (originalTexCoord === texCoord) {
-            updateGltf(accessor, bufferView, gltfData.buffers, result);
+            updateGltf(accessor, gltfData, result, accessor.bufferView);
           } else {
             createAttribute(texCoord, accessor, primitive, gltfData, result);
           }
@@ -5591,28 +5853,49 @@ var __exports__ = (() => {
       }
     }
   }
-  function updateGltf(accessor, bufferView, buffers, newTexCoordArray) {
+  function updateGltf(accessor, gltfData, newTexCoordArray, originalBufferViewIndex) {
     accessor.componentType = 5126;
-    buffers.push({
-      arrayBuffer: newTexCoordArray.buffer,
+    accessor.byteOffset = 0;
+    const accessors = gltfData.json.accessors || [];
+    const bufferViewReferenceCount = accessors.reduce((count, currentAccessor) => {
+      return currentAccessor.bufferView === originalBufferViewIndex ? count + 1 : count;
+    }, 0);
+    const shouldCreateNewBufferView = bufferViewReferenceCount > 1;
+    gltfData.buffers.push({
+      arrayBuffer: ensureArrayBuffer(newTexCoordArray.buffer),
       byteOffset: 0,
       byteLength: newTexCoordArray.buffer.byteLength
     });
-    bufferView.buffer = buffers.length - 1;
-    bufferView.byteLength = newTexCoordArray.buffer.byteLength;
+    const newBufferIndex = gltfData.buffers.length - 1;
+    gltfData.json.bufferViews = gltfData.json.bufferViews || [];
+    if (shouldCreateNewBufferView) {
+      gltfData.json.bufferViews.push({
+        buffer: newBufferIndex,
+        byteLength: newTexCoordArray.buffer.byteLength,
+        byteOffset: 0
+      });
+      accessor.bufferView = gltfData.json.bufferViews.length - 1;
+      return;
+    }
+    const bufferView = gltfData.json.bufferViews[originalBufferViewIndex];
+    if (!bufferView) {
+      return;
+    }
+    bufferView.buffer = newBufferIndex;
     bufferView.byteOffset = 0;
-    delete bufferView.byteStride;
+    bufferView.byteLength = newTexCoordArray.buffer.byteLength;
+    if (bufferView.byteStride !== void 0) {
+      delete bufferView.byteStride;
+    }
   }
   function createAttribute(newTexCoord, originalAccessor, primitive, gltfData, newTexCoordArray) {
     gltfData.buffers.push({
-      arrayBuffer: newTexCoordArray.buffer,
+      arrayBuffer: ensureArrayBuffer(newTexCoordArray.buffer),
       byteOffset: 0,
       byteLength: newTexCoordArray.buffer.byteLength
     });
+    gltfData.json.bufferViews = gltfData.json.bufferViews || [];
     const bufferViews = gltfData.json.bufferViews;
-    if (!bufferViews) {
-      return;
-    }
     bufferViews.push({
       buffer: gltfData.buffers.length - 1,
       byteLength: newTexCoordArray.buffer.byteLength,
@@ -6088,10 +6371,10 @@ var __exports__ = (() => {
     return gltf;
   }
   function parseGLTFContainerSync(gltf, data, byteOffset, options) {
-    if (options.uri) {
-      gltf.baseUri = options.uri;
+    if (options.core?.baseUrl) {
+      gltf.baseUri = options.core?.baseUrl;
     }
-    if (data instanceof ArrayBuffer && !isGLB(data, byteOffset, options)) {
+    if (data instanceof ArrayBuffer && !isGLB(data, byteOffset, options.glb)) {
       const textDecoder = new TextDecoder();
       data = textDecoder.decode(data);
     }
@@ -6126,7 +6409,7 @@ var __exports__ = (() => {
       if (buffer.uri) {
         const { fetch: fetch2 } = context;
         assert3(fetch2);
-        const uri = resolveUrl(buffer.uri, options);
+        const uri = resolveUrl(buffer.uri, options, context);
         const response = await context?.fetch?.(uri);
         const arrayBuffer = await response?.arrayBuffer?.();
         gltf.buffers[i] = {
@@ -6166,7 +6449,7 @@ var __exports__ = (() => {
   async function loadImage(gltf, image, index, options, context) {
     let arrayBuffer;
     if (image.uri && !image.hasOwnProperty("bufferView")) {
-      const uri = resolveUrl(image.uri, options);
+      const uri = resolveUrl(image.uri, options, context);
       const { fetch: fetch2 } = context;
       const response = await fetch2(uri);
       arrayBuffer = await response.arrayBuffer();
@@ -6179,14 +6462,15 @@ var __exports__ = (() => {
       arrayBuffer = sliceArrayBuffer(array.buffer, array.byteOffset, array.byteLength);
     }
     assert3(arrayBuffer, "glTF image has no data");
+    const strictOptions = options;
+    const gltfOptions = {
+      ...strictOptions,
+      core: { ...strictOptions?.core, mimeType: image.mimeType }
+    };
     let parsedImage = await parseFromContext(
       arrayBuffer,
       [ImageLoader, BasisLoader],
-      {
-        ...options,
-        mimeType: image.mimeType,
-        basis: options.basis || { format: selectSupportedBasisFormat() }
-      },
+      gltfOptions,
       context
     );
     if (parsedImage && parsedImage[0]) {
@@ -6227,18 +6511,15 @@ var __exports__ = (() => {
         // Create image objects
         decompressMeshes: true
         // Decompress Draco encoded meshes
-      },
-      // common?
-      log: console
-      // eslint-disable-line
+      }
     }
   };
   async function parse2(arrayBuffer, options = {}, context) {
-    options = { ...GLTFLoader.options, ...options };
-    options.gltf = { ...GLTFLoader.options.gltf, ...options.gltf };
-    const { byteOffset = 0 } = options;
+    const mergedOptions = { ...GLTFLoader.options, ...options };
+    mergedOptions.gltf = { ...GLTFLoader.options.gltf, ...mergedOptions.gltf };
+    const byteOffset = options?.glb?.byteOffset || 0;
     const gltf = {};
-    return await parseGLTF(gltf, arrayBuffer, byteOffset, options, context);
+    return await parseGLTF(gltf, arrayBuffer, byteOffset, mergedOptions, context);
   }
 
   // src/lib/encoders/encode-glb.ts
@@ -6352,9 +6633,8 @@ var __exports__ = (() => {
     return parseSync(arrayBuffer, options);
   }
   function parseSync(arrayBuffer, options) {
-    const { byteOffset = 0 } = options || {};
     const glb = {};
-    parseGLBSync(glb, arrayBuffer, byteOffset, options?.glb);
+    parseGLBSync(glb, arrayBuffer, options?.glb?.byteOffset || 0, options?.glb);
     return glb;
   }
 
@@ -6685,7 +6965,7 @@ var __exports__ = (() => {
         const buffer = accessor.bufferView.buffer;
         const { ArrayType, byteLength } = getAccessorArrayTypeAndLength(accessor, accessor.bufferView);
         const byteOffset = (accessor.bufferView.byteOffset || 0) + (accessor.byteOffset || 0) + buffer.byteOffset;
-        let cutBuffer = buffer.arrayBuffer.slice(byteOffset, byteOffset + byteLength);
+        let cutBuffer = copyToArrayBuffer(buffer.arrayBuffer, byteOffset, byteLength);
         if (accessor.bufferView.byteStride) {
           cutBuffer = this._getValueFromInterleavedBuffer(
             buffer,