@loaders.gl/textures 4.2.0-alpha.6 → 4.2.0-beta.2

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

@@ -1,38 +1,5 @@
 "use strict";
 (() => {
-  var __create = Object.create;
-  var __defProp = Object.defineProperty;
-  var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-  var __getOwnPropNames = Object.getOwnPropertyNames;
-  var __getProtoOf = Object.getPrototypeOf;
-  var __hasOwnProp = Object.prototype.hasOwnProperty;
-  var __commonJS = (cb, mod) => function __require() {
-    return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
-  };
-  var __copyProps = (to, from, except, desc) => {
-    if (from && typeof from === "object" || typeof from === "function") {
-      for (let key of __getOwnPropNames(from))
-        if (!__hasOwnProp.call(to, key) && key !== except)
-          __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-    }
-    return to;
-  };
-  var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-    // If the importer is in node compatibility mode or this is not an ESM
-    // file that has been converted to a CommonJS file using a Babel-
-    // compatible transform (i.e. "__esModule" has not been set), then set
-    // "default" to the CommonJS "module.exports" for node compatibility.
-    isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-    mod
-  ));
-
-  // (disabled):../worker-utils/src/lib/node/require-utils.node
-  var require_require_utils = __commonJS({
-    "(disabled):../worker-utils/src/lib/node/require-utils.node"() {
-      "use strict";
-    }
-  });
-
   // ../worker-utils/src/lib/env-utils/version.ts
   function getVersion() {
     if (!globalThis._loadersgl_?.version) {
@@ -43,7 +10,7 @@
         );
         globalThis._loadersgl_.version = NPM_TAG;
       } else {
-        globalThis._loadersgl_.version = "4.2.0-alpha.5";
+        globalThis._loadersgl_.version = "4.2.0-beta.1";
       }
     }
     return globalThis._loadersgl_.version;
@@ -196,7 +163,6 @@
   }
 
   // ../worker-utils/src/lib/library-utils/library-utils.ts
-  var node = __toESM(require_require_utils(), 1);
   var loadLibraryPromises = {};
   async function loadLibrary(libraryUrl, moduleName = null, options = {}, libraryName = null) {
     if (moduleName) {
@@ -233,7 +199,8 @@
     }
     if (!isBrowser) {
       try {
-        return node && void 0 && await (void 0)(libraryUrl);
+        const { requireFromFile } = globalThis.loaders || {};
+        return await requireFromFile?.(libraryUrl);
       } catch (error) {
         console.error(error);
         return null;
@@ -247,7 +214,8 @@
   }
   function loadLibraryFromString(scriptSource, id) {
     if (!isBrowser) {
-      return void 0 && (void 0)(scriptSource, id);
+      const { requireFromString } = globalThis.loaders || {};
+      return requireFromString?.(scriptSource, id);
     }
     if (isWorker) {
       eval.call(globalThis, scriptSource);
@@ -264,22 +232,24 @@
     return null;
   }
   async function loadAsArrayBuffer(url) {
-    if (isBrowser || !void 0 || url.startsWith("http")) {
+    const { readFileAsArrayBuffer } = globalThis.loaders || {};
+    if (isBrowser || !readFileAsArrayBuffer || url.startsWith("http")) {
       const response = await fetch(url);
       return await response.arrayBuffer();
     }
-    return await (void 0)(url);
+    return await readFileAsArrayBuffer(url);
   }
   async function loadAsText(url) {
-    if (isBrowser || !void 0 || url.startsWith("http")) {
+    const { readFileAsText } = globalThis.loaders || {};
+    if (isBrowser || !readFileAsText || url.startsWith("http")) {
       const response = await fetch(url);
       return await response.text();
     }
-    return await (void 0)(url);
+    return await readFileAsText(url);
   }
 
   // src/lib/utils/version.ts
-  var VERSION2 = true ? "4.2.0-alpha.5" : "latest";
+  var VERSION2 = true ? "4.2.0-beta.1" : "latest";
 
   // src/lib/parsers/basis-module-loader.ts
   var BASIS_EXTERNAL_LIBRARIES = {

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

@@ -1,5 +1,5 @@
-import type { WriterWithEncoder, WriterOptions } from '@loaders.gl/loader-utils';
-import type { ImageDataType } from '@loaders.gl/images';
+import type { WriterOptions } from '@loaders.gl/loader-utils';
+import { encodeKTX2BasisTexture } from "./lib/encoders/encode-ktx2-basis-texture.js";
 /** @todo should be in basis sub-object */
 export type KTX2BasisWriterOptions = WriterOptions & {
     ['ktx2-basis-writer']?: {
@@ -13,5 +13,20 @@ export type KTX2BasisWriterOptions = WriterOptions & {
  *  Basis Universal Supercompressed GPU Texture.
  *  Spec - https://github.com/Esri/i3s-spec/blob/master/docs/1.8/textureSetDefinitionFormat.cmn.md
  */
-export declare const KTX2BasisWriter: WriterWithEncoder<ImageDataType, unknown, KTX2BasisWriterOptions>;
+export declare const KTX2BasisWriter: {
+    readonly name: "Basis Universal Supercompressed GPU Texture";
+    readonly id: "ktx2-basis-writer";
+    readonly module: "textures";
+    readonly version: any;
+    readonly extensions: ["ktx2"];
+    readonly options: {
+        readonly "ktx2-basis-writer": {
+            readonly useSRGB: false;
+            readonly qualityLevel: 10;
+            readonly encodeUASTC: false;
+            readonly mipmaps: false;
+        };
+    };
+    readonly encode: typeof encodeKTX2BasisTexture;
+};
 //# 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":"AAIA,OAAO,KAAK,EAAC,iBAAiB,EAAE,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAE/E,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,iBAAiB,CAAC,aAAa,EAAE,OAAO,EAAE,sBAAsB,CAiB7F,CAAC"}
+{"version":3,"file":"ktx2-basis-writer.d.ts","sourceRoot":"","sources":["../src/ktx2-basis-writer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAoB,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAG/E,OAAO,EAAC,sBAAsB,EAAC,oDAAiD;AAEhF,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;;;;;;;;;;;;;;;CAiB0D,CAAC"}

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":"AAMA,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"}
+{"version":3,"file":"basis-module-loader.d.ts","sourceRoot":"","sources":["../../../src/lib/parsers/basis-module-loader.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,wBAAwB;IACnC,gDAAgD;;IAEhD,mDAAmD;;IAEnD,6CAA6C;;IAE7C,gDAAgD;;CAEjD,CAAC;AAIF;;;;GAIG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,KAAA,gBAStD;AA+CD;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,KAAA,gBAQnD"}

package/dist/lib/parsers/basis-module-loader.js

@@ -1,6 +1,7 @@
 // loaders.gl
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
+import { registerJSModules, getJSModuleOrNull } from '@loaders.gl/loader-utils';
 import { loadLibrary } from '@loaders.gl/worker-utils';
 export const BASIS_EXTERNAL_LIBRARIES = {
     /** Basis transcoder, javascript wrapper part */
@@ -19,11 +20,12 @@ let loadBasisTranscoderPromise;
  * @returns {BasisFile} promise
  */
 export async function loadBasisTranscoderModule(options) {
-    const modules = options.modules || {};
-    if (modules.basis) {
-        return modules.basis;
+    registerJSModules(options.modules);
+    const basis = getJSModuleOrNull('basis');
+    if (basis) {
+        return basis;
     }
-    loadBasisTranscoderPromise = loadBasisTranscoderPromise || loadBasisTranscoder(options);
+    loadBasisTranscoderPromise ||= loadBasisTranscoder(options);
     return await loadBasisTranscoderPromise;
 }
 /**

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

@@ -1,3 +1,4 @@
+import { LoaderOptions } from '@loaders.gl/loader-utils';
 export declare const CRUNCH_EXTERNAL_LIBRARIES: {
     /** Crunch decoder library. It is used as dynamically imported script */
     DECODER: string;
@@ -7,5 +8,5 @@ export declare const CRUNCH_EXTERNAL_LIBRARIES: {
  * @param options - loader options
  * @returns Promise of module object
  */
-export declare function loadCrunchModule(options: any): Promise<any>;
+export declare function loadCrunchModule(options: LoaderOptions): Promise<any>;
 //# sourceMappingURL=crunch-module-loader.d.ts.map

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":"AAOA,eAAO,MAAM,yBAAyB;IACpC,wEAAwE;;CAEzE,CAAC;AAEF;;;;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":"AAKA,OAAO,EAAoB,aAAa,EAAoB,MAAM,0BAA0B,CAAC;AAG7F,eAAO,MAAM,yBAAyB;IACpC,wEAAwE;;CAEzE,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAQ3E"}

package/dist/lib/parsers/crunch-module-loader.js

@@ -2,6 +2,7 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
 // @ts-nocheck
+import { getJSModuleOrNull, registerJSModules } from '@loaders.gl/loader-utils';
 import { loadLibrary } from '@loaders.gl/worker-utils';
 export const CRUNCH_EXTERNAL_LIBRARIES = {
     /** Crunch decoder library. It is used as dynamically imported script */
@@ -13,9 +14,10 @@ export const CRUNCH_EXTERNAL_LIBRARIES = {
  * @returns Promise of module object
  */
 export async function loadCrunchModule(options) {
-    const modules = options.modules || {};
-    if (modules.crunch) {
-        return modules.crunch;
+    registerJSModules(options.modules);
+    const crunch = getJSModuleOrNull('crunch');
+    if (crunch) {
+        return crunch;
     }
     return loadCrunch(options);
 }
@@ -32,7 +34,7 @@ async function loadCrunch(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
-    loadCrunchDecoder = loadCrunchDecoder || globalThis.LoadCrunchDecoder;
+    loadCrunchDecoder ||= globalThis.LoadCrunchDecoder;
     crunchModule = loadCrunchDecoder();
     return crunchModule;
 }

package/dist/lib/utils/version.js

@@ -4,4 +4,4 @@
 // Version constant cannot be imported, it needs to correspond to the build version of **this** module.
 // __VERSION__ is injected by babel-plugin-version-inline
 // @ts-ignore TS2304: Cannot find name '__VERSION__'.
-export const VERSION = typeof "4.2.0-alpha.5" !== 'undefined' ? "4.2.0-alpha.5" : 'latest';
+export const VERSION = typeof "4.2.0-beta.1" !== 'undefined' ? "4.2.0-beta.1" : 'latest';

package/dist/npy-loader.d.ts

@@ -1,14 +1,49 @@
-import type { Loader, LoaderWithParser, LoaderOptions } from '@loaders.gl/loader-utils';
-import { NPYTile } from "./lib/parsers/parse-npy.js";
+import type { LoaderOptions } from '@loaders.gl/loader-utils';
+import { parseNPY, NPYTile } from "./lib/parsers/parse-npy.js";
+/** NPYLoader for numpy tiles */
 export type NPYLoaderOptions = LoaderOptions & {
-    npy?: {};
+    /** NPYLoader for numpy tiles */
+    npy?: {
+        /** Override the URL to the worker bundle (by default loads from unpkg.com) */
+        workerUrl?: string;
+    };
 };
 /**
  * Worker loader for numpy "tiles"
  */
-export declare const NPYWorkerLoader: Loader<NPYTile, never, NPYLoaderOptions>;
+export declare const NPYWorkerLoader: {
+    readonly dataType: NPYTile;
+    readonly batchType: never;
+    readonly name: "NPY";
+    readonly id: "npy";
+    readonly module: "textures";
+    readonly version: any;
+    readonly worker: true;
+    readonly extensions: ["npy"];
+    readonly mimeTypes: [];
+    readonly tests: [ArrayBufferLike];
+    readonly options: {
+        readonly npy: {};
+    };
+};
 /**
  * Loader for numpy "tiles"
  */
-export declare const NPYLoader: LoaderWithParser<any, any, NPYLoaderOptions>;
+export declare const NPYLoader: {
+    readonly parseSync: typeof parseNPY;
+    readonly parse: (arrayBuffer: ArrayBuffer, options?: LoaderOptions) => Promise<NPYTile>;
+    readonly dataType: NPYTile;
+    readonly batchType: never;
+    readonly name: "NPY";
+    readonly id: "npy";
+    readonly module: "textures";
+    readonly version: any;
+    readonly worker: true;
+    readonly extensions: ["npy"];
+    readonly mimeTypes: [];
+    readonly tests: [ArrayBufferLike];
+    readonly options: {
+        readonly npy: {};
+    };
+};
 //# sourceMappingURL=npy-loader.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"npy-loader.d.ts","sourceRoot":"","sources":["../src/npy-loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,MAAM,EAAE,gBAAgB,EAAE,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAEtF,OAAO,EAAW,OAAO,EAAC,mCAAgC;AAK1D,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG;IAC7C,GAAG,CAAC,EAAE,EAAE,CAAC;CACV,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,gBAAgB,CAYpE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,gBAAgB,CAIlE,CAAC"}
+{"version":3,"file":"npy-loader.d.ts","sourceRoot":"","sources":["../src/npy-loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAA2B,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAEtF,OAAO,EAAC,QAAQ,EAAE,OAAO,EAAC,mCAAgC;AAK1D,gCAAgC;AAChC,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG;IAC7C,gCAAgC;IAChC,GAAG,CAAC,EAAE;QACJ,8EAA8E;QAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;CAeiC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,SAAS;;kCAGO,WAAW,YAAY,aAAa;;;;;;;;;;;;;;CACA,CAAC"}

package/dist/npy-loader.js

@@ -9,6 +9,8 @@ const NPY_MAGIC_NUMBER = new Uint8Array([147, 78, 85, 77, 80, 89]);
  * Worker loader for numpy "tiles"
  */
 export const NPYWorkerLoader = {
+    dataType: null,
+    batchType: null,
     name: 'NPY',
     id: 'npy',
     module: 'textures',

package/dist/npy-worker.js

@@ -1,7 +1,7 @@
 "use strict";
 (() => {
   // src/lib/utils/version.ts
-  var VERSION = true ? "4.2.0-alpha.5" : "latest";
+  var VERSION = true ? "4.2.0-beta.1" : "latest";
 
   // src/lib/parsers/parse-npy.ts
   var a = new Uint32Array([305419896]);
@@ -65,6 +65,8 @@
   // src/npy-loader.ts
   var NPY_MAGIC_NUMBER = new Uint8Array([147, 78, 85, 77, 80, 89]);
   var NPYWorkerLoader = {
+    dataType: null,
+    batchType: null,
     name: "NPY",
     id: "npy",
     module: "textures",

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

@@ -4,22 +4,20 @@ import { parseCrunch } from "../lib/parsers/parse-crunch.js";
  */
 export declare const CrunchLoaderWithParser: {
     parse: typeof parseCrunch;
-    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: string;
-    worker?: string | boolean | undefined;
-    category?: string | undefined;
-    extensions: string[];
-    mimeTypes: string[];
-    binary?: boolean | undefined;
-    text?: boolean | undefined;
-    tests?: (string | ArrayBuffer | ((ArrayBuffer: ArrayBuffer) => boolean))[] | undefined;
-    supported?: boolean | undefined;
-    testText?: ((string: string) => boolean) | undefined;
+    dataType: import("@loaders.gl/schema").TextureLevel[];
+    batchType: never;
+    id: "crunch";
+    name: "Crunch";
+    module: "textures";
+    version: any;
+    worker: true;
+    extensions: ["crn"];
+    mimeTypes: ["image/crn", "image/x-crn", "application/octet-stream"];
+    binary: true;
+    options: {
+        readonly crunch: {
+            readonly libraryPath: "libs/";
+        };
+    };
 };
 //# 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":"AAMA,OAAO,EAAC,WAAW,EAAC,uCAAoC;AAExD;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;CAGlC,CAAC"}
+{"version":3,"file":"crunch-worker.d.ts","sourceRoot":"","sources":["../../src/workers/crunch-worker.ts"],"names":[],"mappings":"AAMA,OAAO,EAAC,WAAW,EAAC,uCAAoC;AAExD;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;CAGlC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loaders.gl/textures",
-  "version": "4.2.0-alpha.6",
+  "version": "4.2.0-beta.2",
   "description": "Framework-independent loaders for compressed and super compressed (basis) textures ",
   "license": "MIT",
   "type": "module",
@@ -54,10 +54,10 @@
     "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.2.0-alpha.6",
-    "@loaders.gl/loader-utils": "4.2.0-alpha.6",
-    "@loaders.gl/schema": "4.2.0-alpha.6",
-    "@loaders.gl/worker-utils": "4.2.0-alpha.6",
+    "@loaders.gl/images": "4.2.0-beta.2",
+    "@loaders.gl/loader-utils": "4.2.0-beta.2",
+    "@loaders.gl/schema": "4.2.0-beta.2",
+    "@loaders.gl/worker-utils": "4.2.0-beta.2",
     "@math.gl/types": "^4.0.1",
     "ktx-parse": "^0.0.4",
     "texture-compressor": "^1.0.2"
@@ -65,5 +65,5 @@
   "peerDependencies": {
     "@loaders.gl/core": "^4.0.0"
   },
-  "gitHead": "37bd8ca71763529f18727ee4bf29dd176aa914ca"
+  "gitHead": "13c03663fec365a4d24c06377d50035cebd7ba9f"
 }

package/src/basis-loader.ts

@@ -7,10 +7,30 @@ import type {TextureLevel} from '@loaders.gl/schema';
 import {VERSION} from './lib/utils/version';
 import parseBasis from './lib/parsers/parse-basis';
 
+/** Options for the BasisLoader */
+export type BasisLoaderOptions = LoaderOptions & {
+  /** Options for the BasisLoader */
+  basis?: {
+    /** Format for texture data. auto selects based on platform caps (but gl context doesn't exist on a worker thread) */
+    format: 'auto' | 'rgb565' | 'etc1s' | 'etc2' | 'astc' | 'dxt1' | 'dxt3' | 'dxt5';
+    /** @deprecated specify path of basis library */
+    libraryPath?: string;
+    /** What container format is used? */
+    containerFormat: 'auto' | 'ktx2' | 'basis';
+    /** What module to use for transcoding? */
+    module?: 'transcoder' | 'encoder';
+    /** Override the URL to the worker bundle (by default loads from unpkg.com) */
+    workerUrl?: string;
+  };
+};
+
 /**
  * Worker loader for Basis super compressed textures
  */
-export const BasisWorkerLoader: Loader<TextureLevel[][], never, LoaderOptions> = {
+export const BasisWorkerLoader = {
+  dataType: null as unknown as TextureLevel[][],
+  batchType: null as never,
+
   name: 'Basis',
   id: 'basis',
   module: 'textures',
@@ -22,18 +42,18 @@ export const BasisWorkerLoader: Loader<TextureLevel[][], never, LoaderOptions> =
   binary: true,
   options: {
     basis: {
-      format: 'auto', // gl context doesn't exist on a worker thread
+      format: 'auto',
       libraryPath: 'libs/',
-      containerFormat: 'auto', // 'basis' || 'ktx2' || 'auto'
-      module: 'transcoder' // 'transcoder' || 'encoder'
+      containerFormat: 'auto',
+      module: 'transcoder'
     }
   }
-};
+} as const satisfies Loader<TextureLevel[][], never, BasisLoaderOptions>;
 
 /**
  * Loader for Basis super compressed textures
  */
-export const BasisLoader: LoaderWithParser<TextureLevel[][], never, LoaderOptions> = {
+export const BasisLoader = {
   ...BasisWorkerLoader,
   parse: parseBasis
-};
+} as const satisfies LoaderWithParser<TextureLevel[][], never, LoaderOptions>;

package/src/compressed-texture-loader.ts

@@ -7,17 +7,25 @@ import {VERSION} from './lib/utils/version';
 import {parseCompressedTexture} from './lib/parsers/parse-compressed-texture';
 import parseBasis from './lib/parsers/parse-basis';
 
-export type TextureLoaderOptions = {
+/** Options for the CompressedTextureLoader */
+export type CompressedTextureLoaderOptions = {
   '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) */
+    workerUrl?: string;
   };
 };
 
 /**
  * Worker Loader for KTX, DDS, and PVR texture container formats
  */
-export const CompressedTextureWorkerLoader: Loader<any, never, TextureLoaderOptions> = {
+export const CompressedTextureWorkerLoader = {
+  dataType: null as unknown as any,
+  batchType: null as never,
+
   name: 'Texture Containers',
   id: 'compressed-texture',
   module: 'textures',
@@ -43,14 +51,14 @@ export const CompressedTextureWorkerLoader: Loader<any, never, TextureLoaderOpti
       useBasis: false
     }
   }
-};
+} as const satisfies Loader<any, never, CompressedTextureLoaderOptions>;
 
 /**
  * Loader for KTX, DDS, and PVR texture container formats
  */
-export const CompressedTextureLoader: LoaderWithParser<any, never, TextureLoaderOptions> = {
+export const CompressedTextureLoader = {
   ...CompressedTextureWorkerLoader,
-  parse: async (arrayBuffer: ArrayBuffer, options?: TextureLoaderOptions) => {
+  parse: async (arrayBuffer: ArrayBuffer, options?: CompressedTextureLoaderOptions) => {
     if (options?.['compressed-texture']?.useBasis) {
       // @ts-expect-error TODO not allowed to modify inputs
       options.basis = {
@@ -68,4 +76,4 @@ export const CompressedTextureLoader: LoaderWithParser<any, never, TextureLoader
     }
     return parseCompressedTexture(arrayBuffer);
   }
-};
+} as const satisfies LoaderWithParser<any, never, CompressedTextureLoaderOptions>;

package/src/compressed-texture-writer.ts

@@ -6,8 +6,11 @@ import type {WriterWithEncoder, WriterOptions} from '@loaders.gl/loader-utils';
 import {VERSION} from './lib/utils/version';
 import {encodeImageURLToCompressedTextureURL} from './lib/encoders/encode-texture';
 
+/** Compressed Texture writer options */
 export type CompressedTextureWriterOptions = WriterOptions & {
+  /** @deprecated current working directory */
   cwd?: string;
+  /** Compressed Texture writer options */
   texture?: {
     format: string;
     compression: string;
@@ -21,11 +24,7 @@ export type CompressedTextureWriterOptions = WriterOptions & {
 /**
  * DDS Texture Container Exporter
  */
-export const CompressedTextureWriter: WriterWithEncoder<
-  unknown,
-  unknown,
-  CompressedTextureWriterOptions
-> = {
+export const CompressedTextureWriter = {
   name: 'DDS Texture Container',
   id: 'dds',
   module: 'textures',
@@ -48,13 +47,4 @@ export const CompressedTextureWriter: WriterWithEncoder<
   encode() {
     throw new Error('Not implemented');
   }
-};
-
-// TYPE TESTS - TODO find a better way than exporting junk
-// export const _TypecheckCompressedTextureWriter: typeof CompressedTextureWriter & {
-//   encodeURLtoURL: (
-//     inputUrl: string,
-//     outputUrl: string,
-//     options?: CompressedTextureWriterOptions
-//   ) => Promise<string>;
-// } = CompressedTextureWriter;
+} as const satisfies WriterWithEncoder<unknown, unknown, CompressedTextureWriterOptions>;

package/src/crunch-loader.ts

@@ -6,9 +6,14 @@ import type {Loader, LoaderOptions} from '@loaders.gl/loader-utils';
 import type {TextureLevel} from '@loaders.gl/schema';
 import {VERSION} from './lib/utils/version';
 
+/** CrunchLoader options */
 export type CrunchLoaderOptions = LoaderOptions & {
+  /** CrunchLoader options */
   crunch?: {
+    /** @deprecated Specify where to load the Crunch decoder library */
     libraryPath?: string;
+    /** Override the URL to the worker bundle (by default loads from unpkg.com) */
+    workerUrl?: string;
   };
 };
 
@@ -16,7 +21,10 @@ export type CrunchLoaderOptions = LoaderOptions & {
  * 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: Loader<TextureLevel[], never, CrunchLoaderOptions> = {
+export const CrunchLoader = {
+  dataType: null as unknown as TextureLevel[],
+  batchType: null as never,
+
   id: 'crunch',
   name: 'Crunch',
   module: 'textures',
@@ -30,4 +38,4 @@ export const CrunchLoader: Loader<TextureLevel[], never, CrunchLoaderOptions> =
       libraryPath: 'libs/'
     }
   }
-};
+} as const satisfies Loader<TextureLevel[], never, CrunchLoaderOptions>;

package/src/index.ts

@@ -6,12 +6,18 @@ import {VERSION} from './lib/utils/version';
 
 // Types
 export type {GPUTextureFormat} from '@loaders.gl/schema';
-export type {TextureLoaderOptions} from './compressed-texture-loader';
 
 // Loaders
+export type {BasisLoaderOptions} from './basis-loader';
 export {BasisLoader, BasisWorkerLoader} from './basis-loader';
+
+export type {CompressedTextureLoaderOptions} from './compressed-texture-loader';
 export {CompressedTextureLoader, CompressedTextureWorkerLoader} from './compressed-texture-loader';
+
+export type {CrunchLoaderOptions} from './crunch-loader';
 export {CrunchLoader} from './crunch-loader';
+
+export type {NPYLoaderOptions} from './npy-loader';
 export {NPYLoader, NPYWorkerLoader} from './npy-loader';
 
 // Module constants
@@ -48,4 +54,7 @@ export {selectSupportedBasisFormat} from './lib/parsers/parse-basis';
 export {getSupportedGPUTextureFormats} from './lib/utils/texture-formats';
 
 // DEPRECATED
+// @deprecated
 export {CrunchLoader as CrunchWorkerLoader} from './crunch-loader';
+// @deprecated
+export type {CompressedTextureLoaderOptions as TextureLoaderOptions} from './compressed-texture-loader';

package/src/ktx2-basis-writer.ts

@@ -21,7 +21,7 @@ export type KTX2BasisWriterOptions = WriterOptions & {
  *  Basis Universal Supercompressed GPU Texture.
  *  Spec - https://github.com/Esri/i3s-spec/blob/master/docs/1.8/textureSetDefinitionFormat.cmn.md
  */
-export const KTX2BasisWriter: WriterWithEncoder<ImageDataType, unknown, KTX2BasisWriterOptions> = {
+export const KTX2BasisWriter = {
   name: 'Basis Universal Supercompressed GPU Texture',
   id: 'ktx2-basis-writer',
   module: 'textures',
@@ -38,4 +38,4 @@ export const KTX2BasisWriter: WriterWithEncoder<ImageDataType, unknown, KTX2Basi
   },
 
   encode: encodeKTX2BasisTexture
-};
+} as const satisfies WriterWithEncoder<ImageDataType, unknown, KTX2BasisWriterOptions>;

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

@@ -2,6 +2,7 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
 
+import {registerJSModules, getJSModuleOrNull} from '@loaders.gl/loader-utils';
 import {loadLibrary} from '@loaders.gl/worker-utils';
 
 export const BASIS_EXTERNAL_LIBRARIES = {
@@ -23,12 +24,13 @@ let loadBasisTranscoderPromise;
  * @returns {BasisFile} promise
  */
 export async function loadBasisTranscoderModule(options) {
-  const modules = options.modules || {};
-  if (modules.basis) {
-    return modules.basis;
+  registerJSModules(options.modules);
+  const basis = getJSModuleOrNull('basis');
+  if (basis) {
+    return basis;
   }
 
-  loadBasisTranscoderPromise = loadBasisTranscoderPromise || loadBasisTranscoder(options);
+  loadBasisTranscoderPromise ||= loadBasisTranscoder(options);
   return await loadBasisTranscoderPromise;
 }