@loaders.gl/textures 4.0.0-alpha.8 → 4.0.0-beta.1

package/dist/ktx2-basis-writer-worker.js

@@ -28,10 +28,19 @@
   });
 
   // ../worker-utils/src/lib/env-utils/version.ts
-  var VERSION = true ? "4.0.0-alpha.8" : DEFAULT_VERSION;
-  if (false) {
-    console.error("loaders.gl: The __VERSION__ variable is not injected using babel plugin. Latest unstable workers would be fetched from the CDN.");
+  function getVersion() {
+    if (!globalThis._loadersgl_?.version) {
+      globalThis._loadersgl_ = globalThis._loadersgl_ || {};
+      if (false) {
+        console.error("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;
+      } else {
+        globalThis._loadersgl_.version = "4.0.0-beta.1";
+      }
+    }
+    return globalThis._loadersgl_.version;
   }
+  var VERSION = getVersion();
 
   // ../worker-utils/src/lib/env-utils/assert.ts
   function assert(condition, message) {
@@ -168,40 +177,38 @@
 
   // ../worker-utils/src/lib/library-utils/library-utils.ts
   var node = __toModule(require_require_utils());
-  var LATEST = "beta";
-  var VERSION2 = typeof VERSION !== "undefined" ? VERSION : LATEST;
   var loadLibraryPromises = {};
-  async function loadLibrary(libraryUrl, moduleName = null, options = {}) {
+  async function loadLibrary(libraryUrl, moduleName = null, options = {}, libraryName = null) {
     if (moduleName) {
-      libraryUrl = getLibraryUrl(libraryUrl, moduleName, options);
+      libraryUrl = getLibraryUrl(libraryUrl, moduleName, options, libraryName);
     }
     loadLibraryPromises[libraryUrl] = loadLibraryPromises[libraryUrl] || loadLibraryFromFile(libraryUrl);
     return await loadLibraryPromises[libraryUrl];
   }
-  function getLibraryUrl(library, moduleName, options) {
-    if (library.startsWith("http")) {
+  function getLibraryUrl(library, moduleName, options = {}, libraryName = null) {
+    if (!options.useLocalLibraries && library.startsWith("http")) {
       return library;
     }
+    libraryName = libraryName || library;
     const modules = options.modules || {};
-    if (modules[library]) {
-      return modules[library];
+    if (modules[libraryName]) {
+      return modules[libraryName];
     }
     if (!isBrowser) {
-      return `modules/${moduleName}/dist/libs/${library}`;
+      return `modules/${moduleName}/dist/libs/${libraryName}`;
     }
     if (options.CDN) {
       assert(options.CDN.startsWith("http"));
-      return `${options.CDN}/${moduleName}@${VERSION2}/dist/libs/${library}`;
+      return `${options.CDN}/${moduleName}@${VERSION}/dist/libs/${libraryName}`;
     }
     if (isWorker) {
-      return `../src/libs/${library}`;
+      return `../src/libs/${libraryName}`;
     }
-    return `modules/${moduleName}/src/libs/${library}`;
+    return `modules/${moduleName}/src/libs/${libraryName}`;
   }
   async function loadLibraryFromFile(libraryUrl) {
     if (libraryUrl.endsWith("wasm")) {
-      const response2 = await fetch(libraryUrl);
-      return await response2.arrayBuffer();
+      return await loadAsArrayBuffer(libraryUrl);
     }
     if (!isBrowser) {
       try {
@@ -213,8 +220,7 @@
     if (isWorker) {
       return importScripts(libraryUrl);
     }
-    const response = await fetch(libraryUrl);
-    const scriptSource = await response.text();
+    const scriptSource = await loadAsText(libraryUrl);
     return loadLibraryFromString(scriptSource, libraryUrl);
   }
   function loadLibraryFromString(scriptSource, id) {
@@ -235,14 +241,31 @@
     document.body.appendChild(script);
     return null;
   }
+  async function loadAsArrayBuffer(url) {
+    if (!node.readFileAsArrayBuffer || url.startsWith("http")) {
+      const response = await fetch(url);
+      return await response.arrayBuffer();
+    }
+    return await node.readFileAsArrayBuffer(url);
+  }
+  async function loadAsText(url) {
+    if (!node.readFileAsText || url.startsWith("http")) {
+      const response = await fetch(url);
+      return await response.text();
+    }
+    return await node.readFileAsText(url);
+  }
 
   // src/lib/utils/version.ts
-  var VERSION3 = true ? "4.0.0-alpha.8" : "beta";
+  var VERSION2 = true ? "4.0.0-beta.1" : "beta";
 
   // src/lib/parsers/basis-module-loader.ts
-  var VERSION4 = true ? "4.0.0-alpha.8" : "beta";
-  var BASIS_CDN_ENCODER_WASM = `https://unpkg.com/@loaders.gl/textures@${VERSION4}/dist/libs/basis_encoder.wasm`;
-  var BASIS_CDN_ENCODER_JS = `https://unpkg.com/@loaders.gl/textures@${VERSION4}/dist/libs/basis_encoder.js`;
+  var BASIS_EXTERNAL_LIBRARIES = {
+    TRANSCODER: "basis_transcoder.js",
+    TRANSCODER_WASM: "basis_transcoder.wasm",
+    ENCODER: "basis_encoder.js",
+    ENCODER_WASM: "basis_encoder.wasm"
+  };
   var loadBasisEncoderPromise;
   async function loadBasisEncoderModule(options) {
     const modules = options.modules || {};
@@ -256,8 +279,8 @@
     let BASIS_ENCODER = null;
     let wasmBinary = null;
     [BASIS_ENCODER, wasmBinary] = await Promise.all([
-      await loadLibrary(BASIS_CDN_ENCODER_JS, "textures", options),
-      await loadLibrary(BASIS_CDN_ENCODER_WASM, "textures", options)
+      await loadLibrary(BASIS_EXTERNAL_LIBRARIES.ENCODER, "textures", options),
+      await loadLibrary(BASIS_EXTERNAL_LIBRARIES.ENCODER_WASM, "textures", options)
     ]);
     BASIS_ENCODER = BASIS_ENCODER || globalThis.BASIS;
     return await initializeBasisEncoderModule(BASIS_ENCODER, wasmBinary);
@@ -278,7 +301,12 @@
 
   // src/lib/encoders/encode-ktx2-basis-texture.ts
   async function encodeKTX2BasisTexture(image, options = {}) {
-    const { useSRGB = false, qualityLevel = 10, encodeUASTC = false, mipmaps = false } = options;
+    const {
+      useSRGB = false,
+      qualityLevel = 10,
+      encodeUASTC = false,
+      mipmaps = false
+    } = options?.["ktx2-basis-writer"] || {};
     const { BasisEncoder } = await loadBasisEncoderModule(options);
     const basisEncoder = new BasisEncoder();
     try {
@@ -308,13 +336,15 @@
     name: "Basis Universal Supercompressed GPU Texture",
     id: "ktx2-basis-writer",
     module: "textures",
-    version: VERSION3,
+    version: VERSION2,
     extensions: ["ktx2"],
     options: {
-      useSRGB: false,
-      qualityLevel: 10,
-      encodeUASTC: false,
-      mipmaps: false
+      ["ktx2-basis-writer"]: {
+        useSRGB: false,
+        qualityLevel: 10,
+        encodeUASTC: false,
+        mipmaps: false
+      }
     },
     encode: encodeKTX2BasisTexture
   };

package/dist/ktx2-basis-writer.d.ts

@@ -1,16 +1,17 @@
-import type { Writer } from '@loaders.gl/loader-utils';
+import type { Writer, WriterOptions } from '@loaders.gl/loader-utils';
 import type { ImageDataType } from '@loaders.gl/images';
 /** @todo should be in basis sub-object */
-export type KTX2BasisWriterOptions = {
-    useSRGB?: boolean;
-    qualityLevel?: number;
-    encodeUASTC?: boolean;
-    mipmaps?: boolean;
+export type KTX2BasisWriterOptions = WriterOptions & {
+    ['ktx2-basis-writer']?: {
+        useSRGB?: boolean;
+        qualityLevel?: number;
+        encodeUASTC?: boolean;
+        mipmaps?: boolean;
+    };
 };
 /**
  *  Basis Universal Supercompressed GPU Texture.
  *  Spec - https://github.com/Esri/i3s-spec/blob/master/docs/1.8/textureSetDefinitionFormat.cmn.md
  */
 export declare const KTX2BasisWriter: Writer<ImageDataType, unknown, KTX2BasisWriterOptions>;
-export declare const _TypecheckKTX2TextureWriter: Writer;
 //# sourceMappingURL=ktx2-basis-writer.d.ts.map

package/dist/ktx2-basis-writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ktx2-basis-writer.d.ts","sourceRoot":"","sources":["../src/ktx2-basis-writer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,0BAA0B,CAAC;AAErD,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AAGtD,0CAA0C;AAC1C,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,aAAa,EAAE,OAAO,EAAE,sBAAsB,CAelF,CAAC;AAGF,eAAO,MAAM,2BAA2B,EAAE,MAAwB,CAAC"}
+{"version":3,"file":"ktx2-basis-writer.d.ts","sourceRoot":"","sources":["../src/ktx2-basis-writer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,MAAM,EAAE,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAEpE,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AAGtD,0CAA0C;AAC1C,MAAM,MAAM,sBAAsB,GAAG,aAAa,GAAG;IACnD,CAAC,mBAAmB,CAAC,CAAC,EAAE;QACtB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,aAAa,EAAE,OAAO,EAAE,sBAAsB,CAiBlF,CAAC"}

package/dist/lib/encoders/encode-ktx2-basis-texture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"encode-ktx2-basis-texture.d.ts","sourceRoot":"","sources":["../../../src/lib/encoders/encode-ktx2-basis-texture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AAGtD;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,aAAa,EACpB,OAAO,GAAE,GAAQ,GAChB,OAAO,CAAC,WAAW,CAAC,CA8BtB"}
+{"version":3,"file":"encode-ktx2-basis-texture.d.ts","sourceRoot":"","sources":["../../../src/lib/encoders/encode-ktx2-basis-texture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AAGtD;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,aAAa,EACpB,OAAO,GAAE,GAAQ,GAChB,OAAO,CAAC,WAAW,CAAC,CAmCtB"}

package/dist/lib/parsers/basis-module-loader.d.ts

@@ -1,9 +1,19 @@
+export declare const BASIS_EXTERNAL_LIBRARIES: {
+    /** Basis transcoder, javascript wrapper part */
+    TRANSCODER: string;
+    /** Basis transcoder, compiled web assembly part */
+    TRANSCODER_WASM: string;
+    /** Basis encoder, javascript wrapper part */
+    ENCODER: string;
+    /** Basis encoder, compiled web assembly part */
+    ENCODER_WASM: string;
+};
 /**
  * Loads wasm transcoder module
  * @param options
  * @returns {BasisFile} promise
  */
-export declare function loadBasisTrascoderModule(options: any): Promise<any>;
+export declare function loadBasisTranscoderModule(options: any): Promise<any>;
 /**
  * Loads wasm encoder module
  * @param options

package/dist/lib/parsers/basis-module-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"basis-module-loader.d.ts","sourceRoot":"","sources":["../../../src/lib/parsers/basis-module-loader.ts"],"names":[],"mappings":"AAYA;;;;GAIG;AACH,wBAAsB,wBAAwB,CAAC,OAAO,KAAA,gBAQrD;AA+CD;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,KAAA,gBAQnD"}
+{"version":3,"file":"basis-module-loader.d.ts","sourceRoot":"","sources":["../../../src/lib/parsers/basis-module-loader.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,wBAAwB;IACnC,gDAAgD;;IAEhD,mDAAmD;;IAEnD,6CAA6C;;IAE7C,gDAAgD;;CAEjD,CAAC;AAIF;;;;GAIG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,KAAA,gBAQtD;AA+CD;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,KAAA,gBAQnD"}

package/dist/lib/parsers/crunch-module-loader.d.ts

@@ -1,3 +1,7 @@
+export declare const CRUNCH_EXTERNAL_LIBRARIES: {
+    /** Crunch decoder library. It is used as dynamically imported script */
+    DECODER: string;
+};
 /**
  * Load crunch decoder module
  * @param options - loader options

package/dist/lib/parsers/crunch-module-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crunch-module-loader.d.ts","sourceRoot":"","sources":["../../../src/lib/parsers/crunch-module-loader.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,KAAA,GAAG,OAAO,CAAC,GAAG,CAAC,CAO5D"}
+{"version":3,"file":"crunch-module-loader.d.ts","sourceRoot":"","sources":["../../../src/lib/parsers/crunch-module-loader.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,yBAAyB;IACpC,wEAAwE;;CAEzE,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,KAAA,GAAG,OAAO,CAAC,GAAG,CAAC,CAO5D"}

package/dist/lib/texture-api/deep-load.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deep-load.d.ts","sourceRoot":"","sources":["../../../src/lib/texture-api/deep-load.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC9C,MAAM,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;AAErF,wBAAsB,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,oBAEhF;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAK7F"}
+{"version":3,"file":"deep-load.d.ts","sourceRoot":"","sources":["../../../src/lib/texture-api/deep-load.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC9C,MAAM,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;AAErF,wBAAsB,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,oBAEhF;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAI7F"}

package/dist/npy-worker.js

@@ -1,6 +1,6 @@
 (() => {
   // src/lib/utils/version.ts
-  var VERSION = true ? "4.0.0-alpha.8" : "beta";
+  var VERSION = true ? "4.0.0-beta.1" : "beta";
 
   // src/lib/parsers/parse-npy.ts
   var a = new Uint32Array([305419896]);
@@ -206,7 +206,7 @@
               options,
               context: {
                 ...context,
-                parse: parseOnMainThread
+                _parse: parseOnMainThread
               }
             });
             WorkerBody.postMessage("done", { result });
@@ -219,7 +219,7 @@
       }
     };
   }
-  function parseOnMainThread(arrayBuffer, options) {
+  function parseOnMainThread(arrayBuffer, loader, options, context) {
     return new Promise((resolve, reject) => {
       const id = requestId++;
       const onMessage = (type, payload2) => {
@@ -243,7 +243,12 @@
       WorkerBody.postMessage("process", payload);
     });
   }
-  async function parseData({ loader, arrayBuffer, options, context }) {
+  async function parseData({
+    loader,
+    arrayBuffer,
+    options,
+    context
+  }) {
     let data;
     let parser;
     if (loader.parseSync || loader.parse) {

package/dist/workers/crunch-worker.d.ts

@@ -4,18 +4,22 @@ import { parseCrunch } from '../lib/parsers/parse-crunch';
  */
 export declare const CrunchLoaderWithParser: {
     parse: typeof parseCrunch;
-    id: string;
+    dataType?: import("@loaders.gl/schema").TextureLevel[] | undefined;
+    batchType?: undefined;
+    options: import("../crunch-loader").CrunchLoaderOptions;
+    deprecatedOptions?: Record<string, string | Record<string, string>> | undefined;
     name: string;
+    id: string;
     module: string;
-    version: any;
-    worker: boolean;
+    version: string;
+    worker?: string | boolean | undefined;
+    category?: string | undefined;
     extensions: string[];
     mimeTypes: string[];
-    binary: boolean;
-    options: {
-        crunch: {
-            libraryPath: string;
-        };
-    };
+    binary?: boolean | undefined;
+    text?: boolean | undefined;
+    tests?: (string | ArrayBuffer | ((ArrayBuffer: ArrayBuffer) => boolean))[] | undefined;
+    supported?: boolean | undefined;
+    testText?: ((string: string) => boolean) | undefined;
 };
 //# sourceMappingURL=crunch-worker.d.ts.map

package/dist/workers/crunch-worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crunch-worker.d.ts","sourceRoot":"","sources":["../../src/workers/crunch-worker.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,WAAW,EAAC,MAAM,6BAA6B,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;CAGlC,CAAC"}
+{"version":3,"file":"crunch-worker.d.ts","sourceRoot":"","sources":["../../src/workers/crunch-worker.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,WAAW,EAAC,MAAM,6BAA6B,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;CAGlC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loaders.gl/textures",
-  "version": "4.0.0-alpha.8",
+  "version": "4.0.0-beta.1",
   "description": "Framework-independent loaders for compressed and super compressed (basis) textures ",
   "license": "MIT",
   "publishConfig": {
@@ -45,15 +45,15 @@
     "build-crunch-worker": "esbuild src/workers/crunch-worker.ts --outfile=dist/crunch-worker.js --target=esnext --bundle --define:__VERSION__=\\\"$npm_package_version\\\""
   },
   "dependencies": {
-    "@loaders.gl/images": "4.0.0-alpha.8",
-    "@loaders.gl/loader-utils": "4.0.0-alpha.8",
-    "@loaders.gl/schema": "4.0.0-alpha.8",
-    "@loaders.gl/worker-utils": "4.0.0-alpha.8",
+    "@loaders.gl/images": "4.0.0-beta.1",
+    "@loaders.gl/loader-utils": "4.0.0-beta.1",
+    "@loaders.gl/schema": "4.0.0-beta.1",
+    "@loaders.gl/worker-utils": "4.0.0-beta.1",
     "ktx-parse": "^0.0.4",
     "texture-compressor": "^1.0.2"
   },
   "devDependencies": {
-    "@loaders.gl/polyfills": "4.0.0-alpha.8"
+    "@loaders.gl/polyfills": "4.0.0-beta.1"
   },
-  "gitHead": "c35d6640c8d26deab99e277a8e698b5174233789"
+  "gitHead": "35c625e67132b0784e597d9ddabae8aefea29ff2"
 }

package/src/compressed-texture-loader.ts

@@ -10,17 +10,10 @@ export type TextureLoaderOptions = {
   };
 };
 
-const DEFAULT_TEXTURE_LOADER_OPTIONS = {
-  'compressed-texture': {
-    libraryPath: 'libs/',
-    useBasis: false
-  }
-};
-
 /**
  * Worker Loader for KTX, DDS, and PVR texture container formats
  */
-export const CompressedTextureWorkerLoader = {
+export const CompressedTextureWorkerLoader: Loader<any, never, TextureLoaderOptions> = {
   name: 'Texture Containers',
   id: 'compressed-texture',
   module: 'textures',
@@ -40,31 +33,35 @@ export const CompressedTextureWorkerLoader = {
     'application/octet-stream'
   ],
   binary: true,
-  options: DEFAULT_TEXTURE_LOADER_OPTIONS
+  options: {
+    'compressed-texture': {
+      libraryPath: 'libs/',
+      useBasis: false
+    }
+  }
 };
 
 /**
  * Loader for KTX, DDS, and PVR texture container formats
  */
-export const CompressedTextureLoader = {
+export const CompressedTextureLoader: LoaderWithParser<any, never, TextureLoaderOptions> = {
   ...CompressedTextureWorkerLoader,
-  parse: async (arrayBuffer, options) => {
-    if (options['compressed-texture'].useBasis) {
+  parse: async (arrayBuffer: ArrayBuffer, options?: TextureLoaderOptions) => {
+    if (options?.['compressed-texture']?.useBasis) {
+      // @ts-expect-error TODO not allowed to modify inputs
       options.basis = {
         format: {
           alpha: 'BC3',
           noAlpha: 'BC1'
         },
+        // @ts-expect-error TODO not allowed to modify inputs
         ...options.basis,
         containerFormat: 'ktx2',
         module: 'encoder'
       };
-      return (await parseBasis(arrayBuffer, options))[0];
+      const result = await parseBasis(arrayBuffer, options);
+      return result[0];
     }
     return parseCompressedTexture(arrayBuffer);
   }
 };
-
-// TYPE TESTS - TODO find a better way than exporting junk
-export const _TypecheckCompressedTextureWorkerLoader: Loader = CompressedTextureWorkerLoader;
-export const _TypecheckCompressedTextureLoader: LoaderWithParser = CompressedTextureLoader;

package/src/crunch-loader.ts

@@ -1,10 +1,18 @@
-import type {Loader} from '@loaders.gl/loader-utils';
+import type {Loader, LoaderOptions} from '@loaders.gl/loader-utils';
+import type {TextureLevel} from '@loaders.gl/schema';
 import {VERSION} from './lib/utils/version';
 
+export type CrunchLoaderOptions = LoaderOptions & {
+  crunch?: {
+    libraryPath?: string;
+  };
+};
+
 /**
  * Worker loader for the Crunch compressed texture container format
+ * @note We avoid bundling crunch - it is a rare format and large lib, so we only offer worker loader
  */
-export const CrunchLoader = {
+export const CrunchLoader: Loader<TextureLevel[], never, CrunchLoaderOptions> = {
   id: 'crunch',
   name: 'Crunch',
   module: 'textures',
@@ -19,8 +27,3 @@ export const CrunchLoader = {
     }
   }
 };
-
-// We avoid bundling crunch - rare format, only offer worker loader
-
-// TYPE TESTS - TODO find a better way than exporting junk
-export const _TypecheckCrunchLoader: Loader = CrunchLoader;

package/src/index.ts

@@ -10,6 +10,10 @@ export {CompressedTextureLoader, CompressedTextureWorkerLoader} from './compress
 export {CrunchLoader} from './crunch-loader';
 export {NPYLoader, NPYWorkerLoader} from './npy-loader';
 
+// Module constants
+export {BASIS_EXTERNAL_LIBRARIES} from './lib/parsers/basis-module-loader';
+export {CRUNCH_EXTERNAL_LIBRARIES} from './lib/parsers/crunch-module-loader';
+
 // Writers
 export {CompressedTextureWriter} from './compressed-texture-writer';
 export {KTX2BasisWriter} from './ktx2-basis-writer';

package/src/ktx2-basis-writer.ts

@@ -1,16 +1,18 @@
 // loaders.gl, MIT license
 
-import type {Writer} from '@loaders.gl/loader-utils';
+import type {Writer, WriterOptions} from '@loaders.gl/loader-utils';
 import {VERSION} from './lib/utils/version';
 import type {ImageDataType} from '@loaders.gl/images';
 import {encodeKTX2BasisTexture} from './lib/encoders/encode-ktx2-basis-texture';
 
 /** @todo should be in basis sub-object */
-export type KTX2BasisWriterOptions = {
-  useSRGB?: boolean;
-  qualityLevel?: number;
-  encodeUASTC?: boolean;
-  mipmaps?: boolean;
+export type KTX2BasisWriterOptions = WriterOptions & {
+  ['ktx2-basis-writer']?: {
+    useSRGB?: boolean;
+    qualityLevel?: number;
+    encodeUASTC?: boolean;
+    mipmaps?: boolean;
+  };
 };
 
 /**
@@ -25,14 +27,13 @@ export const KTX2BasisWriter: Writer<ImageDataType, unknown, KTX2BasisWriterOpti
 
   extensions: ['ktx2'],
   options: {
-    useSRGB: false,
-    qualityLevel: 10,
-    encodeUASTC: false,
-    mipmaps: false
+    ['ktx2-basis-writer']: {
+      useSRGB: false,
+      qualityLevel: 10,
+      encodeUASTC: false,
+      mipmaps: false
+    }
   },
 
   encode: encodeKTX2BasisTexture
 };
-
-// TYPE TESTS - TODO find a better way than exporting junk
-export const _TypecheckKTX2TextureWriter: Writer = KTX2BasisWriter;

package/src/lib/encoders/encode-ktx2-basis-texture.ts

@@ -13,7 +13,12 @@ export async function encodeKTX2BasisTexture(
   options: any = {}
 ): Promise<ArrayBuffer> {
   // TODO remove default values after writer options will be normalized like it done in load module.
-  const {useSRGB = false, qualityLevel = 10, encodeUASTC = false, mipmaps = false} = options;
+  const {
+    useSRGB = false,
+    qualityLevel = 10,
+    encodeUASTC = false,
+    mipmaps = false
+  } = options?.['ktx2-basis-writer'] || {};
   const {BasisEncoder} = await loadBasisEncoderModule(options);
   const basisEncoder = new BasisEncoder();
 

package/src/lib/parsers/basis-module-loader.ts

@@ -1,12 +1,15 @@
-// __VERSION__ is injected by babel-plugin-version-inline
-// @ts-ignore TS2304: Cannot find name '__VERSION__'.
-const VERSION = typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'beta';
-
-// @ts-nocheck
 import {loadLibrary} from '@loaders.gl/worker-utils';
 
-const BASIS_CDN_ENCODER_WASM = `https://unpkg.com/@loaders.gl/textures@${VERSION}/dist/libs/basis_encoder.wasm`;
-const BASIS_CDN_ENCODER_JS = `https://unpkg.com/@loaders.gl/textures@${VERSION}/dist/libs/basis_encoder.js`;
+export const BASIS_EXTERNAL_LIBRARIES = {
+  /** Basis transcoder, javascript wrapper part */
+  TRANSCODER: 'basis_transcoder.js',
+  /** Basis transcoder, compiled web assembly part */
+  TRANSCODER_WASM: 'basis_transcoder.wasm',
+  /** Basis encoder, javascript wrapper part */
+  ENCODER: 'basis_encoder.js',
+  /** Basis encoder, compiled web assembly part */
+  ENCODER_WASM: 'basis_encoder.wasm'
+};
 
 let loadBasisTranscoderPromise;
 
@@ -15,13 +18,13 @@ let loadBasisTranscoderPromise;
  * @param options
  * @returns {BasisFile} promise
  */
-export async function loadBasisTrascoderModule(options) {
+export async function loadBasisTranscoderModule(options) {
   const modules = options.modules || {};
   if (modules.basis) {
     return modules.basis;
   }
 
-  loadBasisTranscoderPromise = loadBasisTranscoderPromise || loadBasisTrascoder(options);
+  loadBasisTranscoderPromise = loadBasisTranscoderPromise || loadBasisTranscoder(options);
   return await loadBasisTranscoderPromise;
 }
 
@@ -30,19 +33,19 @@ export async function loadBasisTrascoderModule(options) {
  * @param options
  * @returns {BasisFile} promise
  */
-async function loadBasisTrascoder(options) {
+async function loadBasisTranscoder(options) {
   let BASIS = null;
   let wasmBinary = null;
 
   [BASIS, wasmBinary] = await Promise.all([
-    await loadLibrary('basis_transcoder.js', 'textures', options),
-    await loadLibrary('basis_transcoder.wasm', 'textures', options)
+    await loadLibrary(BASIS_EXTERNAL_LIBRARIES.TRANSCODER, 'textures', options),
+    await loadLibrary(BASIS_EXTERNAL_LIBRARIES.TRANSCODER_WASM, 'textures', options)
   ]);
 
   // Depends on how import happened...
   // @ts-ignore TS2339: Property does not exist on type
   BASIS = BASIS || globalThis.BASIS;
-  return await initializeBasisTrascoderModule(BASIS, wasmBinary);
+  return await initializeBasisTranscoderModule(BASIS, wasmBinary);
 }
 
 /**
@@ -51,7 +54,7 @@ async function loadBasisTrascoder(options) {
  * @param wasmBinary - wasm part of the module
  * @returns {BasisFile} promise
  */
-function initializeBasisTrascoderModule(BasisModule, wasmBinary) {
+function initializeBasisTranscoderModule(BasisModule, wasmBinary) {
   const options: {wasmBinary?} = {};
 
   if (wasmBinary) {
@@ -95,8 +98,8 @@ async function loadBasisEncoder(options) {
   let wasmBinary = null;
 
   [BASIS_ENCODER, wasmBinary] = await Promise.all([
-    await loadLibrary(BASIS_CDN_ENCODER_JS, 'textures', options),
-    await loadLibrary(BASIS_CDN_ENCODER_WASM, 'textures', options)
+    await loadLibrary(BASIS_EXTERNAL_LIBRARIES.ENCODER, 'textures', options),
+    await loadLibrary(BASIS_EXTERNAL_LIBRARIES.ENCODER_WASM, 'textures', options)
   ]);
 
   // Depends on how import happened...

package/src/lib/parsers/crunch-module-loader.ts

@@ -1,6 +1,11 @@
 // @ts-nocheck
 import {loadLibrary} from '@loaders.gl/worker-utils';
 
+export const CRUNCH_EXTERNAL_LIBRARIES = {
+  /** Crunch decoder library. It is used as dynamically imported script */
+  DECODER: 'crunch.js'
+};
+
 /**
  * Load crunch decoder module
  * @param options - loader options
@@ -27,7 +32,7 @@ async function loadCrunch(options) {
     return crunchModule;
   }
 
-  let loadCrunchDecoder = await loadLibrary('crunch.js', 'textures', options);
+  let loadCrunchDecoder = await loadLibrary(CRUNCH_EXTERNAL_LIBRARIES.DECODER, 'textures', options);
 
   // Depends on how import happened...
   // @ts-ignore TS2339: Property does not exist on type

package/src/lib/parsers/parse-basis.ts

@@ -1,6 +1,6 @@
 /* eslint-disable indent */
 import type {TextureLevel} from '@loaders.gl/schema';
-import {loadBasisEncoderModule, loadBasisTrascoderModule} from './basis-module-loader';
+import {loadBasisEncoderModule, loadBasisTranscoderModule} from './basis-module-loader';
 import {GL_EXTENSIONS_CONSTANTS} from '../gl-extensions';
 import {getSupportedGPUTextureFormats} from '../utils/texture-formats';
 import {isKTX} from './parse-ktx';
@@ -86,7 +86,7 @@ export default async function parseBasis(data: ArrayBuffer, options): Promise<Te
       const fileConstructors = await loadBasisEncoderModule(options);
       return parseKTX2File(fileConstructors.KTX2File, data, options);
     }
-    const {BasisFile} = await loadBasisTrascoderModule(options);
+    const {BasisFile} = await loadBasisTranscoderModule(options);
     return parseBasisFile(BasisFile, data, options);
   }
   switch (options.basis.module) {
@@ -101,7 +101,7 @@ export default async function parseBasis(data: ArrayBuffer, options): Promise<Te
       }
     case 'transcoder':
     default:
-      const {BasisFile} = await loadBasisTrascoderModule(options);
+      const {BasisFile} = await loadBasisTranscoderModule(options);
       return parseBasisFile(BasisFile, data, options);
   }
 }