@loaders.gl/textures 4.4.0-alpha.17 → 4.4.0-alpha.19

package/README.md

@@ -2,7 +2,7 @@
 
 [loaders.gl](https://loaders.gl/docs) is a collection of framework-independent 3D and geospatial parsers and encoders.
 
-This module contains loaders for compressed textures and [basis universal textures](https://github.com/BinomialLLC/basis_universal).
+This module contains loaders for compressed textures, Radiance HDR textures, and [basis universal textures](https://github.com/BinomialLLC/basis_universal).
 
 ## Texture Levels
 
@@ -12,11 +12,14 @@ This module contains loaders for compressed textures and [basis universal textur
 
 `CrunchLoader` returns `TextureLevel[]` for Crunch mip chains.
 
+`RadianceHDRLoader` returns a `Texture` with `shape: 'texture'`, `type: '2d'`, and one decoded `rgba32float` level for Radiance `.hdr` images.
+
 Each returned `TextureLevel` now exposes:
 
 - `shape`: always `'texture-level'`. <img src="https://img.shields.io/badge/From-v4.4-blue.svg?style=flat-square" alt="From-v4.4" />
 - `format`: the corresponding WebGL internal format number. <img src="https://img.shields.io/badge/From-v4.4-blue.svg?style=flat-square" alt="From-v4.4" />
 - `textureFormat`: the corresponding luma.gl / WebGPU-style texture format string. <img src="https://img.shields.io/badge/From-v4.4-blue.svg?style=flat-square" alt="From-v4.4" />
+- `data`: a typed array containing the mip level payload. Compressed textures expose byte data, while `RadianceHDRLoader` exposes `Float32Array`.
 
 ```ts
 import {load} from '@loaders.gl/core';
@@ -48,4 +51,153 @@ console.log(images[0][0].format);
 console.log(images[0][0].textureFormat);
 ```
 
+## Composite Image Texture Loaders
+
+The `textures` module also exports JSON manifest loaders for image-based composite textures:
+
+- `TextureLoader` for a single image or mip chain
+- `TextureArrayLoader` for texture arrays
+- `TextureCubeLoader` for cubemaps
+- `TextureCubeArrayLoader` for cube arrays
+
+Each manifest includes a `shape` discriminator and resolves relative member URLs against the manifest URL.
+Member assets are parsed with `ImageLoader` by default, and additional loaders passed to top-level `load()` are also available for manifest members.
+These loaders return schema `Texture` objects rather than raw image trees.
+
+```ts
+import {load} from '@loaders.gl/core';
+import {BasisLoader, CompressedTextureLoader, TextureCubeLoader} from '@loaders.gl/textures';
+
+const imageCube = await load('environment.image-texture-cube.json', [
+  TextureCubeLoader,
+  CompressedTextureLoader,
+  BasisLoader
+]);
+```
+
+### Manifest Shapes
+
+Single image:
+
+```json
+{
+  "shape": "image-texture",
+  "image": "texture.png"
+}
+```
+
+Single image with mipmaps:
+
+```json
+{
+  "shape": "image-texture",
+  "mipmaps": ["texture-0.png", "texture-1.png", "texture-2.png"]
+}
+```
+
+Texture array:
+
+```json
+{
+  "shape": "image-texture-array",
+  "layers": ["layer-0.png", "layer-1.png"]
+}
+```
+
+Texture array with mipmaps:
+
+```json
+{
+  "shape": "image-texture-array",
+  "layers": [
+    ["layer-0-0.png", "layer-0-1.png"],
+    ["layer-1-0.png", "layer-1-1.png"]
+  ]
+}
+```
+
+Cubemap:
+
+```json
+{
+  "shape": "image-texture-cube",
+  "faces": {
+    "+X": "right.png",
+    "-X": "left.png",
+    "+Y": "top.png",
+    "-Y": "bottom.png",
+    "+Z": "front.png",
+    "-Z": "back.png"
+  }
+}
+```
+
+Cubemap with mipmaps:
+
+```json
+{
+  "shape": "image-texture-cube",
+  "faces": {
+    "+X": ["right-0.png", "right-1.png"],
+    "-X": ["left-0.png", "left-1.png"],
+    "+Y": ["top-0.png", "top-1.png"],
+    "-Y": ["bottom-0.png", "bottom-1.png"],
+    "+Z": ["front-0.png", "front-1.png"],
+    "-Z": ["back-0.png", "back-1.png"]
+  }
+}
+```
+
+Cube array:
+
+```json
+{
+  "shape": "image-texture-cube-array",
+  "layers": [
+    {
+      "faces": {
+        "+X": "sky-right.png",
+        "-X": "sky-left.png",
+        "+Y": "sky-top.png",
+        "-Y": "sky-bottom.png",
+        "+Z": "sky-front.png",
+        "-Z": "sky-back.png"
+      }
+    },
+    {
+      "faces": {
+        "+X": "irr-right.png",
+        "-X": "irr-left.png",
+        "+Y": "irr-top.png",
+        "-Y": "irr-bottom.png",
+        "+Z": "irr-front.png",
+        "-Z": "irr-back.png"
+      }
+    }
+  ]
+}
+```
+
+Template-driven mipmaps:
+
+```json
+{
+  "shape": "image-texture",
+  "mipLevels": "auto",
+  "template": "texture-{lod}.png"
+}
+```
+
+Template placeholders are validated strictly. Supported placeholders are:
+
+- `{lod}` for mip level
+- `{index}` for array or cube-array layer index
+- `{face}`, `{direction}`, `{axis}`, `{sign}` for cubemap faces
+
+Use `\\{` and `\\}` to include literal braces in filenames.
+
+Cube manifests use luma.gl-style face names: `'+X'`, `'-X'`, `'+Y'`, `'-Y'`, `'+Z'`, `'-Z'`. Directional aliases such as `right`, `left`, `top`, `bottom`, `front`, and `back` are still accepted for compatibility, but new manifests should use the luma.gl names.
+
+If you parse an in-memory manifest instead of loading from a URL, provide `options.core.baseUrl` so relative member URLs can still be resolved.
+
 For documentation please visit the [website](https://loaders.gl).

package/dist/basis-loader.d.ts

@@ -21,8 +21,6 @@ export type BasisLoaderOptions = LoaderOptions & {
         format?: BasisTargetFormat;
         /** What module to use for transcoding? */
         module?: 'transcoder' | 'encoder';
-        /** @deprecated specify path of basis library */
-        libraryPath?: string;
     };
 };
 /**
@@ -43,7 +41,6 @@ export declare const BasisWorkerLoader: {
     readonly options: {
         readonly basis: {
             readonly format: "auto";
-            readonly libraryPath: "libs/";
             readonly containerFormat: "auto";
             readonly module: "transcoder";
         };
@@ -68,7 +65,6 @@ export declare const BasisLoader: {
     readonly options: {
         readonly basis: {
             readonly format: "auto";
-            readonly libraryPath: "libs/";
             readonly containerFormat: "auto";
             readonly module: "transcoder";
         };

package/dist/basis-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"basis-loader.d.ts","sourceRoot":"","sources":["../src/basis-loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAS,aAAa,EAAmB,MAAM,0BAA0B,CAAC;AACtF,OAAO,KAAK,EAAC,aAAa,EAAE,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAEpE,OAAO,EAAC,UAAU,EAAC,qCAAkC;AACrD,OAAO,KAAK,EAAC,WAAW,EAAC,qCAAkC;AAE3D,KAAK,iBAAiB,GAAG,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;AAC9D,KAAK,iBAAiB,GAClB,MAAM,GACN,iBAAiB,GACjB;IACE,KAAK,EAAE,iBAAiB,CAAC;IACzB,OAAO,EAAE,iBAAiB,CAAC;CAC5B,CAAC;AAEN,kCAAkC;AAClC,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG;IAC/C,kCAAkC;IAClC,KAAK,CAAC,EAAE;QACN,qIAAqI;QACrI,uBAAuB,CAAC,EAAE,aAAa,EAAE,CAAC;QAC1C,8EAA8E;QAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;QAEnB,qCAAqC;QACrC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;QAC5C,qHAAqH;QACrH,MAAM,CAAC,EAAE,iBAAiB,CAAC;QAC3B,0CAA0C;QAC1C,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;QAClC,gDAAgD;QAChD,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB;uBACC,YAAY,EAAE,EAAE;wBAC1B,KAAK;;;;;;;;;;;;;;;;;;CAmB8C,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,WAAW;;uBAzBO,YAAY,EAAE,EAAE;wBAC1B,KAAK;;;;;;;;;;;;;;;;;;CA2BmD,CAAC"}
+{"version":3,"file":"basis-loader.d.ts","sourceRoot":"","sources":["../src/basis-loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAS,aAAa,EAAmB,MAAM,0BAA0B,CAAC;AACtF,OAAO,KAAK,EAAC,aAAa,EAAE,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAEpE,OAAO,EAAC,UAAU,EAAC,qCAAkC;AACrD,OAAO,KAAK,EAAC,WAAW,EAAC,qCAAkC;AAE3D,KAAK,iBAAiB,GAAG,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;AAC9D,KAAK,iBAAiB,GAClB,MAAM,GACN,iBAAiB,GACjB;IACE,KAAK,EAAE,iBAAiB,CAAC;IACzB,OAAO,EAAE,iBAAiB,CAAC;CAC5B,CAAC;AAEN,kCAAkC;AAClC,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG;IAC/C,kCAAkC;IAClC,KAAK,CAAC,EAAE;QACN,qIAAqI;QACrI,uBAAuB,CAAC,EAAE,aAAa,EAAE,CAAC;QAC1C,8EAA8E;QAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;QAEnB,qCAAqC;QACrC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;QAC5C,qHAAqH;QACrH,MAAM,CAAC,EAAE,iBAAiB,CAAC;QAC3B,0CAA0C;QAC1C,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;KACnC,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB;uBACC,YAAY,EAAE,EAAE;wBAC1B,KAAK;;;;;;;;;;;;;;;;;CAkB8C,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,WAAW;;uBAxBO,YAAY,EAAE,EAAE;wBAC1B,KAAK;;;;;;;;;;;;;;;;;CA0BmD,CAAC"}

package/dist/basis-loader.js

@@ -21,7 +21,6 @@ export const BasisWorkerLoader = {
     options: {
         basis: {
             format: 'auto',
-            libraryPath: 'libs/',
             containerFormat: 'auto',
             module: 'transcoder'
         }

package/dist/basis-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"basis-loader.js","sourceRoot":"","sources":["../src/basis-loader.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAIpC,OAAO,EAAC,OAAO,EAAC,+BAA4B;AAC5C,OAAO,EAAC,UAAU,EAAC,qCAAkC;AAgCrD;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,QAAQ,EAAE,IAAmC;IAC7C,SAAS,EAAE,IAAa;IAExB,IAAI,EAAE,OAAO;IACb,EAAE,EAAE,OAAO;IACX,MAAM,EAAE,UAAU;IAClB,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,IAAI;IACZ,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC;IAC7B,SAAS,EAAE,CAAC,0BAA0B,EAAE,YAAY,CAAC;IACrD,KAAK,EAAE,CAAC,IAAI,CAAC;IACb,MAAM,EAAE,IAAI;IACZ,OAAO,EAAE;QACP,KAAK,EAAE;YACL,MAAM,EAAE,MAAM;YACd,WAAW,EAAE,OAAO;YACpB,eAAe,EAAE,MAAM;YACvB,MAAM,EAAE,YAAY;SACrB;KACF;CACqE,CAAC;AAEzE;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,GAAG,iBAAiB;IACpB,KAAK,EAAE,UAAU;CAC0D,CAAC"}
+{"version":3,"file":"basis-loader.js","sourceRoot":"","sources":["../src/basis-loader.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAIpC,OAAO,EAAC,OAAO,EAAC,+BAA4B;AAC5C,OAAO,EAAC,UAAU,EAAC,qCAAkC;AA8BrD;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,QAAQ,EAAE,IAAmC;IAC7C,SAAS,EAAE,IAAa;IAExB,IAAI,EAAE,OAAO;IACb,EAAE,EAAE,OAAO;IACX,MAAM,EAAE,UAAU;IAClB,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,IAAI;IACZ,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC;IAC7B,SAAS,EAAE,CAAC,0BAA0B,EAAE,YAAY,CAAC;IACrD,KAAK,EAAE,CAAC,IAAI,CAAC;IACb,MAAM,EAAE,IAAI;IACZ,OAAO,EAAE;QACP,KAAK,EAAE;YACL,MAAM,EAAE,MAAM;YACd,eAAe,EAAE,MAAM;YACvB,MAAM,EAAE,YAAY;SACrB;KACF;CACqE,CAAC;AAEzE;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,GAAG,iBAAiB;IACpB,KAAK,EAAE,UAAU;CAC0D,CAAC"}

package/dist/basis-worker-node.js

@@ -50494,7 +50494,7 @@ function getVersion() {
       globalThis._loadersgl_.version = NPM_TAG;
       warningIssued = true;
     } else {
-      globalThis._loadersgl_.version = "4.4.0-alpha.17";
+      globalThis._loadersgl_.version = "4.4.0-alpha.19";
     }
   }
   return globalThis._loadersgl_.version;
@@ -50656,6 +50656,17 @@ function isKnownMessage(message) {
 
 // ../worker-utils/src/lib/library-utils/library-utils.ts
 var loadLibraryPromises = {};
+function extractLoadLibraryOptions(options = {}) {
+  var _a, _b;
+  const useLocalLibraries = options.useLocalLibraries ?? ((_a = options.core) == null ? void 0 : _a.useLocalLibraries);
+  const CDN = options.CDN ?? ((_b = options.core) == null ? void 0 : _b.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);
@@ -54228,7 +54239,7 @@ if (nodeVersion2 < 18) {
 }
 
 // src/lib/utils/version.ts
-var VERSION2 = true ? "4.4.0-alpha.17" : "latest";
+var VERSION2 = true ? "4.4.0-alpha.19" : "latest";
 
 // src/lib/parsers/basis-module-loader.ts
 var BASIS_EXTERNAL_LIBRARIES = {
@@ -54347,7 +54358,7 @@ var WEBGL_TEXTURE_FORMATS = {
     "bc7-rgba-unorm",
     "bc7-rgba-unorm-srgb"
   ],
-  WEBGL_compressed_texture_etc1: ["etc1-rbg-unorm-webgl"],
+  WEBGL_compressed_texture_etc1: ["etc1-rgb-unorm-webgl"],
   WEBGL_compressed_texture_etc: [
     "etc2-rgb8unorm",
     "etc2-rgb8unorm-srgb",
@@ -54363,7 +54374,7 @@ var WEBGL_TEXTURE_FORMATS = {
   WEBGL_compressed_texture_pvrtc: [
     "pvrtc-rgb4unorm-webgl",
     "pvrtc-rgba4unorm-webgl",
-    "pvrtc-rbg2unorm-webgl",
+    "pvrtc-rgb2unorm-webgl",
     "pvrtc-rgba2unorm-webgl"
   ],
   WEBGL_compressed_texture_atc: [
@@ -54463,12 +54474,13 @@ function isKTX(data) {
 }
 
 // src/lib/parsers/parse-basis.ts
+var basisTranscodingLock = Promise.resolve();
 var BASIS_FORMAT_TO_OUTPUT_OPTIONS = {
   etc1: {
     basisFormat: 0,
     compressed: true,
     format: GL_COMPRESSED_RGB_ETC1_WEBGL,
-    textureFormat: "etc1-rbg-unorm-webgl"
+    textureFormat: "etc1-rgb-unorm-webgl"
   },
   etc2: {
     basisFormat: 1,
@@ -54570,31 +54582,47 @@ var BASIS_FORMAT_TO_OUTPUT_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 = {}) {
-  var _a;
-  if (!((_a = options.basis) == null ? void 0 : _a.containerFormat) || options.basis.containerFormat === "auto") {
-    if (isKTX(data)) {
-      const fileConstructors = await loadBasisEncoderModule((options == null ? void 0 : options.core) || {});
-      return parseKTX2File(fileConstructors.KTX2File, data, options);
-    }
-    const { BasisFile } = await loadBasisTranscoderModule((options == null ? void 0 : options.core) || {});
-    return parseBasisFile(BasisFile, data, options);
-  }
-  switch (options.basis.module) {
-    case "encoder":
-      const fileConstructors = await loadBasisEncoderModule((options == null ? void 0 : options.core) || {});
-      switch (options.basis.containerFormat) {
-        case "ktx2":
-          return parseKTX2File(fileConstructors.KTX2File, data, options);
-        case "basis":
-        default:
-          return parseBasisFile(fileConstructors.BasisFile, data, options);
+  const loadLibraryOptions = extractLoadLibraryOptions(options);
+  return await withBasisTranscodingLock(async () => {
+    var _a;
+    if (!((_a = options.basis) == null ? void 0 : _a.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.core || {});
+      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));
@@ -54740,7 +54768,7 @@ function selectSupportedBasisFormat(supportedTextureFormats = detectSupportedTex
   } else if (hasSupportedTextureFormat(textureFormats2, [
     "pvrtc-rgb4unorm-webgl",
     "pvrtc-rgba4unorm-webgl",
-    "pvrtc-rbg2unorm-webgl",
+    "pvrtc-rgb2unorm-webgl",
     "pvrtc-rgba2unorm-webgl"
   ])) {
     return {
@@ -54760,7 +54788,7 @@ function selectSupportedBasisFormat(supportedTextureFormats = detectSupportedTex
     "eac-rg11snorm"
   ])) {
     return "etc2";
-  } else if (textureFormats2.has("etc1-rbg-unorm-webgl")) {
+  } else if (textureFormats2.has("etc1-rgb-unorm-webgl")) {
     return "etc1";
   } else if (hasSupportedTextureFormat(textureFormats2, [
     "atc-rgb-unorm-webgl",
@@ -54796,7 +54824,6 @@ var BasisWorkerLoader = {
   options: {
     basis: {
       format: "auto",
-      libraryPath: "libs/",
       containerFormat: "auto",
       module: "transcoder"
     }

package/dist/basis-worker.js

@@ -22,7 +22,7 @@
         globalThis._loadersgl_.version = NPM_TAG;
         warningIssued = true;
       } else {
-        globalThis._loadersgl_.version = "4.4.0-alpha.17";
+        globalThis._loadersgl_.version = "4.4.0-alpha.19";
       }
     }
     return globalThis._loadersgl_.version;
@@ -176,6 +176,16 @@
 
   // ../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);
@@ -372,7 +382,7 @@
   }
 
   // src/lib/utils/version.ts
-  var VERSION2 = true ? "4.4.0-alpha.17" : "latest";
+  var VERSION2 = true ? "4.4.0-alpha.19" : "latest";
 
   // src/lib/parsers/basis-module-loader.ts
   var BASIS_EXTERNAL_LIBRARIES = {
@@ -491,7 +501,7 @@
       "bc7-rgba-unorm",
       "bc7-rgba-unorm-srgb"
     ],
-    WEBGL_compressed_texture_etc1: ["etc1-rbg-unorm-webgl"],
+    WEBGL_compressed_texture_etc1: ["etc1-rgb-unorm-webgl"],
     WEBGL_compressed_texture_etc: [
       "etc2-rgb8unorm",
       "etc2-rgb8unorm-srgb",
@@ -507,7 +517,7 @@
     WEBGL_compressed_texture_pvrtc: [
       "pvrtc-rgb4unorm-webgl",
       "pvrtc-rgba4unorm-webgl",
-      "pvrtc-rbg2unorm-webgl",
+      "pvrtc-rgb2unorm-webgl",
       "pvrtc-rgba2unorm-webgl"
     ],
     WEBGL_compressed_texture_atc: [
@@ -607,12 +617,13 @@
   }
 
   // src/lib/parsers/parse-basis.ts
+  var basisTranscodingLock = Promise.resolve();
   var BASIS_FORMAT_TO_OUTPUT_OPTIONS = {
     etc1: {
       basisFormat: 0,
       compressed: true,
       format: GL_COMPRESSED_RGB_ETC1_WEBGL,
-      textureFormat: "etc1-rbg-unorm-webgl"
+      textureFormat: "etc1-rgb-unorm-webgl"
     },
     etc2: {
       basisFormat: 1,
@@ -714,30 +725,46 @@
   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 = {}) {
-    if (!options.basis?.containerFormat || options.basis.containerFormat === "auto") {
-      if (isKTX(data)) {
-        const fileConstructors = await loadBasisEncoderModule(options?.core || {});
-        return parseKTX2File(fileConstructors.KTX2File, data, options);
-      }
-      const { BasisFile } = await loadBasisTranscoderModule(options?.core || {});
-      return parseBasisFile(BasisFile, data, options);
-    }
-    switch (options.basis.module) {
-      case "encoder":
-        const fileConstructors = await loadBasisEncoderModule(options?.core || {});
-        switch (options.basis.containerFormat) {
-          case "ktx2":
-            return parseKTX2File(fileConstructors.KTX2File, data, options);
-          case "basis":
-          default:
-            return parseBasisFile(fileConstructors.BasisFile, 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.core || {});
+        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));
@@ -882,7 +909,7 @@
     } else if (hasSupportedTextureFormat(textureFormats2, [
       "pvrtc-rgb4unorm-webgl",
       "pvrtc-rgba4unorm-webgl",
-      "pvrtc-rbg2unorm-webgl",
+      "pvrtc-rgb2unorm-webgl",
       "pvrtc-rgba2unorm-webgl"
     ])) {
       return {
@@ -902,7 +929,7 @@
       "eac-rg11snorm"
     ])) {
       return "etc2";
-    } else if (textureFormats2.has("etc1-rbg-unorm-webgl")) {
+    } else if (textureFormats2.has("etc1-rgb-unorm-webgl")) {
       return "etc1";
     } else if (hasSupportedTextureFormat(textureFormats2, [
       "atc-rgb-unorm-webgl",
@@ -938,7 +965,6 @@
     options: {
       basis: {
         format: "auto",
-        libraryPath: "libs/",
         containerFormat: "auto",
         module: "transcoder"
       }

package/dist/compressed-texture-loader.d.ts

@@ -2,8 +2,6 @@ import type { StrictLoaderOptions } from '@loaders.gl/loader-utils';
 /** Options for the CompressedTextureLoader */
 export type CompressedTextureLoaderOptions = StrictLoaderOptions & {
     'compressed-texture'?: {
-        /** @deprecated Specify path to libraries */
-        libraryPath?: string;
         /** Whether to use Basis decoding */
         useBasis?: boolean;
         /** Override the URL to the worker bundle (by default loads from unpkg.com) */
@@ -26,7 +24,6 @@ export declare const CompressedTextureWorkerLoader: {
     readonly binary: true;
     readonly options: {
         readonly 'compressed-texture': {
-            readonly libraryPath: "libs/";
             readonly useBasis: false;
         };
     };
@@ -48,7 +45,6 @@ export declare const CompressedTextureLoader: {
     readonly binary: true;
     readonly options: {
         readonly 'compressed-texture': {
-            readonly libraryPath: "libs/";
             readonly useBasis: false;
         };
     };

package/dist/compressed-texture-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compressed-texture-loader.d.ts","sourceRoot":"","sources":["../src/compressed-texture-loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAA2B,mBAAmB,EAAC,MAAM,0BAA0B,CAAC;AAK5F,8CAA8C;AAC9C,MAAM,MAAM,8BAA8B,GAAG,mBAAmB,GAAG;IACjE,oBAAoB,CAAC,EAAE;QACrB,4CAA4C;QAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,oCAAoC;QACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,8EAA8E;QAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,6BAA6B;uBACX,GAAG;wBACb,KAAK;;;;;;;;;;;;;;;CA2B6C,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,uBAAuB;kCAEP,WAAW,YAAY,8BAA8B;uBAnCnD,GAAG;wBACb,KAAK;;;;;;;;;;;;;;;CAmDuD,CAAC"}
+{"version":3,"file":"compressed-texture-loader.d.ts","sourceRoot":"","sources":["../src/compressed-texture-loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAA2B,mBAAmB,EAAC,MAAM,0BAA0B,CAAC;AAK5F,8CAA8C;AAC9C,MAAM,MAAM,8BAA8B,GAAG,mBAAmB,GAAG;IACjE,oBAAoB,CAAC,EAAE;QACrB,oCAAoC;QACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,8EAA8E;QAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,6BAA6B;uBACX,GAAG;wBACb,KAAK;;;;;;;;;;;;;;CA0B6C,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,uBAAuB;kCAEP,WAAW,YAAY,8BAA8B;uBAlCnD,GAAG;wBACb,KAAK;;;;;;;;;;;;;;CAkDuD,CAAC"}

package/dist/compressed-texture-loader.js

@@ -31,7 +31,6 @@ export const CompressedTextureWorkerLoader = {
     binary: true,
     options: {
         'compressed-texture': {
-            libraryPath: 'libs/',
             useBasis: false
         }
     }

package/dist/compressed-texture-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"compressed-texture-loader.js","sourceRoot":"","sources":["../src/compressed-texture-loader.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAGpC,OAAO,EAAC,OAAO,EAAC,+BAA4B;AAC5C,OAAO,EAAC,sBAAsB,EAAC,kDAA+C;AAC9E,OAAO,EAAC,UAAU,EAAC,qCAAkC;AAcrD;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,QAAQ,EAAE,IAAsB;IAChC,SAAS,EAAE,IAAa;IAExB,IAAI,EAAE,oBAAoB;IAC1B,EAAE,EAAE,oBAAoB;IACxB,MAAM,EAAE,UAAU;IAClB,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,IAAI;IACZ,UAAU,EAAE;QACV,KAAK;QACL,MAAM;QACN,KAAK,EAAE,8DAA8D;QACrE,KAAK,CAAC,iCAAiC;KACxC;IACD,SAAS,EAAE;QACT,YAAY;QACZ,WAAW;QACX,kBAAkB;QAClB,aAAa;QACb,0BAA0B;KAC3B;IACD,MAAM,EAAE,IAAI;IACZ,OAAO,EAAE;QACP,oBAAoB,EAAE;YACpB,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,KAAK;SAChB;KACF;CACoE,CAAC;AAExE;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,GAAG,6BAA6B;IAChC,KAAK,EAAE,KAAK,EAAE,WAAwB,EAAE,OAAwC,EAAE,EAAE;QAClF,OAAO,GAAG,EAAC,GAAG,OAAO,EAAC,CAAC;QACvB,IAAI,OAAO,EAAE,CAAC,oBAAoB,CAAC,EAAE,QAAQ,EAAE,CAAC;YAC9C,OAAO,CAAC,KAAK,GAAG;gBACd,MAAM,EAAE;oBACN,KAAK,EAAE,KAAK;oBACZ,OAAO,EAAE,KAAK;iBACf;gBACD,GAAG,OAAO,CAAC,KAAK;gBAChB,eAAe,EAAE,MAAM;gBACvB,MAAM,EAAE,SAAS;aAClB,CAAC;YACF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACtD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC;QACD,OAAO,sBAAsB,CAAC,WAAW,CAAC,CAAC;IAC7C,CAAC;CAC8E,CAAC"}
+{"version":3,"file":"compressed-texture-loader.js","sourceRoot":"","sources":["../src/compressed-texture-loader.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAGpC,OAAO,EAAC,OAAO,EAAC,+BAA4B;AAC5C,OAAO,EAAC,sBAAsB,EAAC,kDAA+C;AAC9E,OAAO,EAAC,UAAU,EAAC,qCAAkC;AAYrD;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,QAAQ,EAAE,IAAsB;IAChC,SAAS,EAAE,IAAa;IAExB,IAAI,EAAE,oBAAoB;IAC1B,EAAE,EAAE,oBAAoB;IACxB,MAAM,EAAE,UAAU;IAClB,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,IAAI;IACZ,UAAU,EAAE;QACV,KAAK;QACL,MAAM;QACN,KAAK,EAAE,8DAA8D;QACrE,KAAK,CAAC,iCAAiC;KACxC;IACD,SAAS,EAAE;QACT,YAAY;QACZ,WAAW;QACX,kBAAkB;QAClB,aAAa;QACb,0BAA0B;KAC3B;IACD,MAAM,EAAE,IAAI;IACZ,OAAO,EAAE;QACP,oBAAoB,EAAE;YACpB,QAAQ,EAAE,KAAK;SAChB;KACF;CACoE,CAAC;AAExE;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,GAAG,6BAA6B;IAChC,KAAK,EAAE,KAAK,EAAE,WAAwB,EAAE,OAAwC,EAAE,EAAE;QAClF,OAAO,GAAG,EAAC,GAAG,OAAO,EAAC,CAAC;QACvB,IAAI,OAAO,EAAE,CAAC,oBAAoB,CAAC,EAAE,QAAQ,EAAE,CAAC;YAC9C,OAAO,CAAC,KAAK,GAAG;gBACd,MAAM,EAAE;oBACN,KAAK,EAAE,KAAK;oBACZ,OAAO,EAAE,KAAK;iBACf;gBACD,GAAG,OAAO,CAAC,KAAK;gBAChB,eAAe,EAAE,MAAM;gBACvB,MAAM,EAAE,SAAS;aAClB,CAAC;YACF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACtD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC;QACD,OAAO,sBAAsB,CAAC,WAAW,CAAC,CAAC;IAC7C,CAAC;CAC8E,CAAC"}