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

package/dist/lib/texture-api/load-image-array.d.ts

@@ -1,4 +1,7 @@
-import type { GetUrl } from "./texture-api-types.js";
-export declare function loadImageTextureArray(count: number, getUrl: GetUrl, options?: {}): Promise<any>;
-export declare function getImageArrayUrls(count: number, getUrl: GetUrl, options?: {}): Promise<any>;
+import type { GetUrl, TextureLoaderOptions } from "./texture-api-types.js";
+/**
+ * @deprecated Use `load(url, TextureArrayLoader)` for manifest-driven loading.
+ */
+export declare function loadImageTextureArray(count: number, getUrl: GetUrl, options?: TextureLoaderOptions): Promise<any>;
+export declare function getImageArrayUrls(count: number, getUrl: GetUrl, options?: TextureLoaderOptions): Promise<any>;
 //# sourceMappingURL=load-image-array.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"load-image-array.d.ts","sourceRoot":"","sources":["../../../src/lib/texture-api/load-image-array.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,MAAM,EAAC,+BAA4B;AAIhD,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,KAAK,GACX,OAAO,CAAC,GAAG,CAAC,CAGd;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAOjG"}
+{"version":3,"file":"load-image-array.d.ts","sourceRoot":"","sources":["../../../src/lib/texture-api/load-image-array.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAC,MAAM,EAAE,oBAAoB,EAAC,+BAA4B;AAGtE;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,GAAG,CAAC,CAGd;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,GAAG,CAAC,CAOd"}

package/dist/lib/texture-api/load-image-array.js

@@ -1,12 +1,14 @@
 // loaders.gl
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
-import { ImageLoader } from '@loaders.gl/images';
+import { loadCompositeImageUrlTree, normalizeCompositeImageOptions } from "../composite-image/parse-composite-image.js";
 import { getImageUrls } from "./load-image.js";
-import { deepLoad } from "./deep-load.js";
+/**
+ * @deprecated Use `load(url, TextureArrayLoader)` for manifest-driven loading.
+ */
 export async function loadImageTextureArray(count, getUrl, options = {}) {
     const imageUrls = await getImageArrayUrls(count, getUrl, options);
-    return await deepLoad(imageUrls, ImageLoader.parse, options);
+    return await loadCompositeImageUrlTree(imageUrls, normalizeCompositeImageOptions(options));
 }
 export async function getImageArrayUrls(count, getUrl, options = {}) {
     const promises = [];
@@ -16,3 +18,4 @@ export async function getImageArrayUrls(count, getUrl, options = {}) {
     }
     return await Promise.all(promises);
 }
+//# sourceMappingURL=load-image-array.js.map

package/dist/lib/texture-api/load-image-array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-image-array.js","sourceRoot":"","sources":["../../../src/lib/texture-api/load-image-array.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAEpC,OAAO,EACL,yBAAyB,EACzB,8BAA8B,EAC/B,oDAAiD;AAElD,OAAO,EAAC,YAAY,EAAC,wBAAqB;AAE1C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAa,EACb,MAAc,EACd,UAAgC,EAAE;IAElC,MAAM,SAAS,GAAG,MAAM,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAClE,OAAO,MAAM,yBAAyB,CAAC,SAAS,EAAE,8BAA8B,CAAC,OAAO,CAAC,CAAC,CAAC;AAC7F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAa,EACb,MAAc,EACd,UAAgC,EAAE;IAElC,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,EAAC,KAAK,EAAC,CAAC,CAAC;QACvD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC"}

package/dist/lib/texture-api/load-image-cube.d.ts

@@ -1,12 +1,8 @@
-import type { GetUrl, UrlOptions } from "./texture-api-types.js";
-export type ImageCubeTexture = {
-    GL_TEXTURE_CUBE_MAP_POSITIVE_X: any;
-    GL_TEXTURE_CUBE_MAP_NEGATIVE_X: any;
-    GL_TEXTURE_CUBE_MAP_POSITIVE_Y: any;
-    GL_TEXTURE_CUBE_MAP_NEGATIVE_Y: any;
-    GL_TEXTURE_CUBE_MAP_POSITIVE_Z: any;
-    GL_TEXTURE_CUBE_MAP_NEGATIVE_Z: any;
-};
-export declare function getImageCubeUrls(getUrl: GetUrl, options: UrlOptions): Promise<Record<number, string | string[]>>;
-export declare function loadImageTextureCube(getUrl: GetUrl, options?: {}): Promise<ImageCubeTexture>;
+import { type ImageCubeTexture } from "../composite-image/image-texture-cube.js";
+import type { GetUrl, TextureLoaderOptions } from "./texture-api-types.js";
+export declare function getImageCubeUrls(getUrl: GetUrl, options: TextureLoaderOptions): Promise<Record<number, string | string[]>>;
+/**
+ * @deprecated Use `load(url, TextureCubeLoader)` for manifest-driven loading.
+ */
+export declare function loadImageTextureCube(getUrl: GetUrl, options?: TextureLoaderOptions): Promise<ImageCubeTexture>;
 //# sourceMappingURL=load-image-cube.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"load-image-cube.d.ts","sourceRoot":"","sources":["../../../src/lib/texture-api/load-image-cube.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,MAAM,EAAE,UAAU,EAAC,+BAA4B;AAqB5D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,8BAA8B,EAAE,GAAG,CAAC;IACpC,8BAA8B,EAAE,GAAG,CAAC;IACpC,8BAA8B,EAAE,GAAG,CAAC;IACpC,8BAA8B,EAAE,GAAG,CAAC;IACpC,8BAA8B,EAAE,GAAG,CAAC;IACpC,8BAA8B,EAAE,GAAG,CAAC;CACrC,CAAC;AAIF,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,8CAiBzE;AAID,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,OAAO,KAAK,GACX,OAAO,CAAC,gBAAgB,CAAC,CAG3B"}
+{"version":3,"file":"load-image-cube.d.ts","sourceRoot":"","sources":["../../../src/lib/texture-api/load-image-cube.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,KAAK,gBAAgB,EACtB,iDAA8C;AAC/C,OAAO,KAAK,EAAC,MAAM,EAAE,oBAAoB,EAAC,+BAA4B;AAKtE,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,8CAiBnF;AAID;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,gBAAgB,CAAC,CAM3B"}

package/dist/lib/texture-api/load-image-cube.js

@@ -1,24 +1,9 @@
 // loaders.gl
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
-import { ImageLoader } from '@loaders.gl/images';
+import { loadCompositeImageUrlTree, normalizeCompositeImageOptions } from "../composite-image/parse-composite-image.js";
+import { IMAGE_TEXTURE_CUBE_FACES } from "../composite-image/image-texture-cube.js";
 import { getImageUrls } from "./load-image.js";
-import { deepLoad } from "./deep-load.js";
-// Returned map will be have keys corresponding to GL cubemap constants
-const GL_TEXTURE_CUBE_MAP_POSITIVE_X = 0x8515;
-const GL_TEXTURE_CUBE_MAP_NEGATIVE_X = 0x8516;
-const GL_TEXTURE_CUBE_MAP_POSITIVE_Y = 0x8517;
-const GL_TEXTURE_CUBE_MAP_NEGATIVE_Y = 0x8518;
-const GL_TEXTURE_CUBE_MAP_POSITIVE_Z = 0x8519;
-const GL_TEXTURE_CUBE_MAP_NEGATIVE_Z = 0x851a;
-const CUBE_FACES = [
-    { face: GL_TEXTURE_CUBE_MAP_POSITIVE_X, direction: 'right', axis: 'x', sign: 'positive' },
-    { face: GL_TEXTURE_CUBE_MAP_NEGATIVE_X, direction: 'left', axis: 'x', sign: 'negative' },
-    { face: GL_TEXTURE_CUBE_MAP_POSITIVE_Y, direction: 'top', axis: 'y', sign: 'positive' },
-    { face: GL_TEXTURE_CUBE_MAP_NEGATIVE_Y, direction: 'bottom', axis: 'y', sign: 'negative' },
-    { face: GL_TEXTURE_CUBE_MAP_POSITIVE_Z, direction: 'front', axis: 'z', sign: 'positive' },
-    { face: GL_TEXTURE_CUBE_MAP_NEGATIVE_Z, direction: 'back', axis: 'z', sign: 'negative' }
-];
 // Returns an object with six key-value pairs containing the urls (or url mip arrays)
 // for each cube face
 export async function getImageCubeUrls(getUrl, options) {
@@ -26,8 +11,8 @@ export async function getImageCubeUrls(getUrl, options) {
     const urls = {};
     const promises = [];
     let index = 0;
-    for (let i = 0; i < CUBE_FACES.length; ++i) {
-        const face = CUBE_FACES[index];
+    for (let i = 0; i < IMAGE_TEXTURE_CUBE_FACES.length; ++i) {
+        const face = IMAGE_TEXTURE_CUBE_FACES[index];
         const promise = getImageUrls(getUrl, options, { ...face, index: index++ }).then((url) => {
             urls[face.face] = url;
         });
@@ -38,7 +23,11 @@ export async function getImageCubeUrls(getUrl, options) {
 }
 // Returns an object with six key-value pairs containing the images (or image mip arrays)
 // for each cube face
+/**
+ * @deprecated Use `load(url, TextureCubeLoader)` for manifest-driven loading.
+ */
 export async function loadImageTextureCube(getUrl, options = {}) {
     const urls = await getImageCubeUrls(getUrl, options);
-    return (await deepLoad(urls, ImageLoader.parse, options));
+    return (await loadCompositeImageUrlTree(urls, normalizeCompositeImageOptions(options)));
 }
+//# sourceMappingURL=load-image-cube.js.map

package/dist/lib/texture-api/load-image-cube.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-image-cube.js","sourceRoot":"","sources":["../../../src/lib/texture-api/load-image-cube.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAEpC,OAAO,EACL,yBAAyB,EACzB,8BAA8B,EAC/B,oDAAiD;AAClD,OAAO,EACL,wBAAwB,EAEzB,iDAA8C;AAE/C,OAAO,EAAC,YAAY,EAAC,wBAAqB;AAE1C,qFAAqF;AACrF,qBAAqB;AACrB,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAc,EAAE,OAA6B;IAClF,iBAAiB;IACjB,MAAM,IAAI,GAAsC,EAAE,CAAC;IACnD,MAAM,QAAQ,GAAmB,EAAE,CAAC;IAEpC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,wBAAwB,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,EAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;YACpF,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;QACxB,CAAC,CAAC,CAAC;QACH,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAE5B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,yFAAyF;AACzF,qBAAqB;AACrB;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAc,EACd,UAAgC,EAAE;IAElC,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrD,OAAO,CAAC,MAAM,yBAAyB,CACrC,IAAI,EACJ,8BAA8B,CAAC,OAAO,CAAC,CACxC,CAAqB,CAAC;AACzB,CAAC"}

package/dist/lib/texture-api/load-image.d.ts

@@ -1,6 +1,9 @@
-import type { GetUrl, UrlOptions } from "./texture-api-types.js";
-export declare function loadImageTexture(getUrl: string | GetUrl, options?: {}): Promise<any>;
-export declare function getImageUrls(getUrl: string | GetUrl, options: any, urlOptions?: UrlOptions): Promise<any>;
+import type { GetUrl, TextureLoaderOptions, UrlOptions } from "./texture-api-types.js";
+/**
+ * @deprecated Use `load(url, TextureLoader)` for manifest-driven loading.
+ */
+export declare function loadImageTexture(getUrl: string | GetUrl, options?: TextureLoaderOptions): Promise<any>;
+export declare function getImageUrls(getUrl: string | GetUrl, options: TextureLoaderOptions, urlOptions?: UrlOptions): Promise<any>;
 export declare function getMipLevels(size: {
     width: number;
     height: number;

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

@@ -1 +1 @@
-{"version":3,"file":"load-image.d.ts","sourceRoot":"","sources":["../../../src/lib/texture-api/load-image.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAC,MAAM,EAAE,UAAU,EAAC,+BAA4B;AAI5D,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAG1F;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,OAAO,EAAE,GAAG,EACZ,UAAU,GAAE,UAAe,GAC1B,OAAO,CAAC,GAAG,CAAC,CAKd;AAkCD,wBAAgB,YAAY,CAAC,IAAI,EAAE;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,GAAG,MAAM,CAE1E"}
+{"version":3,"file":"load-image.d.ts","sourceRoot":"","sources":["../../../src/lib/texture-api/load-image.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAC,MAAM,EAAE,oBAAoB,EAAE,UAAU,EAAC,+BAA4B;AAGlF;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,GAAG,CAAC,CAGd;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,OAAO,EAAE,oBAAoB,EAC7B,UAAU,GAAE,UAAe,GAC1B,OAAO,CAAC,GAAG,CAAC,CAKd;AAmCD,wBAAgB,YAAY,CAAC,IAAI,EAAE;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,GAAG,MAAM,CAE1E"}

package/dist/lib/texture-api/load-image.js

@@ -2,12 +2,15 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
 import { assert } from '@loaders.gl/loader-utils';
-import { ImageLoader, getImageSize } from '@loaders.gl/images';
+import { getImageSize } from '@loaders.gl/images';
+import { loadCompositeImageMember, loadCompositeImageUrlTree, normalizeCompositeImageOptions } from "../composite-image/parse-composite-image.js";
 import { generateUrl } from "./generate-url.js";
-import { deepLoad, shallowLoad } from "./deep-load.js";
+/**
+ * @deprecated Use `load(url, TextureLoader)` for manifest-driven loading.
+ */
 export async function loadImageTexture(getUrl, options = {}) {
     const imageUrls = await getImageUrls(getUrl, options);
-    return await deepLoad(imageUrls, ImageLoader.parse, options);
+    return await loadCompositeImageUrlTree(imageUrls, normalizeCompositeImageOptions(options));
 }
 export async function getImageUrls(getUrl, options, urlOptions = {}) {
     const mipLevels = (options && options.image && options.image.mipLevels) || 0;
@@ -17,10 +20,11 @@ export async function getImageUrls(getUrl, options, urlOptions = {}) {
 }
 async function getMipmappedImageUrls(getUrl, mipLevels, options, urlOptions) {
     const urls = [];
+    const normalizedOptions = normalizeCompositeImageOptions(options);
     // If no mip levels supplied, we need to load the level 0 image and calculate based on size
     if (mipLevels === 'auto') {
         const url = generateUrl(getUrl, options, { ...urlOptions, lod: 0 });
-        const image = await shallowLoad(url, ImageLoader.parse, options);
+        const image = await loadCompositeImageMember(url, normalizedOptions);
         const { width, height } = getImageSize(image);
         mipLevels = getMipLevels({ width, height });
         // TODO - push image and make `deepLoad` pass through non-url values, avoid loading twice?
@@ -38,3 +42,4 @@ async function getMipmappedImageUrls(getUrl, mipLevels, options, urlOptions) {
 export function getMipLevels(size) {
     return 1 + Math.floor(Math.log2(Math.max(size.width, size.height)));
 }
+//# sourceMappingURL=load-image.js.map

package/dist/lib/texture-api/load-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-image.js","sourceRoot":"","sources":["../../../src/lib/texture-api/load-image.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAEpC,OAAO,EAAC,MAAM,EAAC,MAAM,0BAA0B,CAAC;AAChD,OAAO,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAChD,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,8BAA8B,EAC/B,oDAAiD;AAElD,OAAO,EAAC,WAAW,EAAC,0BAAuB;AAE3C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAuB,EACvB,UAAgC,EAAE;IAElC,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtD,OAAO,MAAM,yBAAyB,CAAC,SAAS,EAAE,8BAA8B,CAAC,OAAO,CAAC,CAAC,CAAC;AAC7F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAuB,EACvB,OAA6B,EAC7B,aAAyB,EAAE;IAE3B,MAAM,SAAS,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7E,OAAO,SAAS,KAAK,CAAC;QACpB,CAAC,CAAC,MAAM,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC;QACrE,CAAC,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;AAC/C,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,MAAuB,EACvB,SAA0B,EAC1B,OAA6B,EAC7B,UAAsB;IAEtB,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,MAAM,iBAAiB,GAAG,8BAA8B,CAAC,OAAO,CAAC,CAAC;IAElE,2FAA2F;IAC3F,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,EAAC,GAAG,UAAU,EAAE,GAAG,EAAE,CAAC,EAAC,CAAC,CAAC;QAClE,MAAM,KAAK,GAAG,MAAM,wBAAwB,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;QAErE,MAAM,EAAC,KAAK,EAAE,MAAM,EAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QAC5C,SAAS,GAAG,YAAY,CAAC,EAAC,KAAK,EAAE,MAAM,EAAC,CAAC,CAAC;QAE1C,0FAA0F;QAC1F,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjB,CAAC;IAED,sFAAsF;IACtF,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IAEtB,KAAK,IAAI,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,EAAE,EAAE,QAAQ,EAAE,CAAC;QAClE,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,EAAC,GAAG,UAAU,EAAE,GAAG,EAAE,QAAQ,EAAC,CAAC,CAAC;QACzE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,YAAY,CAAC,IAAqC;IAChE,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACtE,CAAC"}

package/dist/lib/texture-api/texture-api-types.d.ts

@@ -1,3 +1,5 @@
+import type { LoaderOptions } from '@loaders.gl/loader-utils';
+import type { ImageLoaderOptions } from '@loaders.gl/images';
 export type { ImageType } from '@loaders.gl/images';
 export type UrlOptions = {
     baseUrl?: string;
@@ -7,4 +9,15 @@ export type UrlOptions = {
     direction?: string;
 };
 export type GetUrl = (options: UrlOptions) => string;
+export type TextureLoaderOptions = LoaderOptions & {
+    core?: NonNullable<LoaderOptions['core']> & {
+        /** Base URL for resolving composite image members when no loader context URL is available */
+        baseUrl?: string;
+    };
+    /** @deprecated Legacy helper alias kept for loadImageTexture* compatibility */
+    baseUrl?: string;
+    image?: NonNullable<ImageLoaderOptions['image']> & {
+        mipLevels?: number | 'auto';
+    };
+};
 //# sourceMappingURL=texture-api-types.d.ts.map

package/dist/lib/texture-api/texture-api-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"texture-api-types.d.ts","sourceRoot":"","sources":["../../../src/lib/texture-api/texture-api-types.ts"],"names":[],"mappings":"AAIA,YAAY,EAAC,SAAS,EAAC,MAAM,oBAAoB,CAAC;AAElD,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AACF,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,UAAU,KAAK,MAAM,CAAC"}
+{"version":3,"file":"texture-api-types.d.ts","sourceRoot":"","sources":["../../../src/lib/texture-api/texture-api-types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,oBAAoB,CAAC;AAE3D,YAAY,EAAC,SAAS,EAAC,MAAM,oBAAoB,CAAC;AAElD,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AACF,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,UAAU,KAAK,MAAM,CAAC;AAErD,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG;IACjD,IAAI,CAAC,EAAE,WAAW,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG;QAC1C,6FAA6F;QAC7F,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,WAAW,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,GAAG;QACjD,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;KAC7B,CAAC;CACH,CAAC"}

package/dist/lib/texture-api/texture-api-types.js

@@ -2,3 +2,4 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
 export {};
+//# sourceMappingURL=texture-api-types.js.map

package/dist/lib/texture-api/texture-api-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"texture-api-types.js","sourceRoot":"","sources":["../../../src/lib/texture-api/texture-api-types.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC"}

package/dist/lib/utils/detect-supported-texture-formats.d.ts

@@ -0,0 +1,14 @@
+import type { TextureFormat } from '@loaders.gl/schema';
+/**
+ * @deprecated Pass `basis.supportedTextureFormats` to Basis loaders instead of relying on global detection.
+ */
+export declare function detectSupportedTextureFormats(gl?: WebGLRenderingContext): Set<TextureFormat>;
+/**
+ * Returns a list of formats.
+ * Creates a temporary WebGLRenderingContext if none is provided.
+ *
+ * @deprecated Pass `basis.supportedTextureFormats` to Basis loaders instead of relying on global detection.
+ * @param gl - Optional context.
+ */
+export declare function detectSupportedGPUTextureFormats(gl?: WebGLRenderingContext): Set<string>;
+//# sourceMappingURL=detect-supported-texture-formats.d.ts.map

package/dist/lib/utils/detect-supported-texture-formats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-supported-texture-formats.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/detect-supported-texture-formats.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAmB,aAAa,EAAC,MAAM,oBAAoB,CAAC;AAmJxE;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,EAAE,CAAC,EAAE,qBAAqB,GAAG,GAAG,CAAC,aAAa,CAAC,CAiB5F;AAGD;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAAC,EAAE,CAAC,EAAE,qBAAqB,GAAG,GAAG,CAAC,MAAM,CAAC,CAgBxF"}

package/dist/lib/utils/detect-supported-texture-formats.js

@@ -0,0 +1,197 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+const BROWSER_PREFIXES = ['', 'WEBKIT_', 'MOZ_'];
+const WEBGL_TEXTURE_FORMATS = {
+    /* eslint-disable camelcase */
+    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 */
+};
+const GPU_TEXTURE_FORMATS = {
+    dxt: ['bc1-rgb-unorm-webgl', 'bc1-rgba-unorm', 'bc2-rgba-unorm', 'bc3-rgba-unorm'],
+    'dxt-srgb': [
+        'bc1-rgb-unorm-srgb-webgl',
+        'bc1-rgba-unorm-srgb',
+        'bc2-rgba-unorm-srgb',
+        'bc3-rgba-unorm-srgb'
+    ],
+    etc1: ['etc1-rgb-unorm-webgl'],
+    etc2: [
+        'etc2-rgb8unorm',
+        'etc2-rgb8unorm-srgb',
+        'etc2-rgb8a1unorm',
+        'etc2-rgb8a1unorm-srgb',
+        'etc2-rgba8unorm',
+        'etc2-rgba8unorm-srgb',
+        'eac-r11unorm',
+        'eac-r11snorm',
+        'eac-rg11unorm',
+        'eac-rg11snorm'
+    ],
+    pvrtc: [
+        'pvrtc-rgb4unorm-webgl',
+        'pvrtc-rgba4unorm-webgl',
+        'pvrtc-rgb2unorm-webgl',
+        'pvrtc-rgba2unorm-webgl'
+    ],
+    atc: ['atc-rgb-unorm-webgl', 'atc-rgba-unorm-webgl', 'atc-rgbai-unorm-webgl'],
+    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'
+    ],
+    rgtc: ['bc4-r-unorm', 'bc4-r-snorm', 'bc5-rg-unorm', 'bc5-rg-snorm']
+};
+let formats = null;
+let textureFormats = null;
+// DEPRECATED
+/**
+ * @deprecated Pass `basis.supportedTextureFormats` to Basis loaders instead of relying on global detection.
+ */
+export function detectSupportedTextureFormats(gl) {
+    if (!textureFormats) {
+        gl = gl || getWebGLContext() || undefined;
+        textureFormats = new Set();
+        for (const prefix of BROWSER_PREFIXES) {
+            for (const extension in WEBGL_TEXTURE_FORMATS) {
+                if (gl && gl.getExtension(`${prefix}${extension}`)) {
+                    for (const textureFormat of WEBGL_TEXTURE_FORMATS[extension]) {
+                        textureFormats.add(textureFormat);
+                    }
+                }
+            }
+        }
+    }
+    return textureFormats;
+}
+// DEPRECATED
+/**
+ * Returns a list of formats.
+ * Creates a temporary WebGLRenderingContext if none is provided.
+ *
+ * @deprecated Pass `basis.supportedTextureFormats` to Basis loaders instead of relying on global detection.
+ * @param gl - Optional context.
+ */
+export function detectSupportedGPUTextureFormats(gl) {
+    if (!formats) {
+        formats = new Set();
+        const supportedTextureFormats = detectSupportedTextureFormats(gl);
+        for (const gpuTextureFormat in GPU_TEXTURE_FORMATS) {
+            const textureFormatsForGroup = GPU_TEXTURE_FORMATS[gpuTextureFormat];
+            if (textureFormatsForGroup.some((textureFormat) => supportedTextureFormats.has(textureFormat))) {
+                formats.add(gpuTextureFormat);
+            }
+        }
+    }
+    return formats;
+}
+/**
+ * @returns {WebGLRenderingContext?}
+ */
+function getWebGLContext() {
+    try {
+        const canvas = document.createElement('canvas');
+        return canvas.getContext('webgl');
+    }
+    catch (error) {
+        return null;
+    }
+}
+//# sourceMappingURL=detect-supported-texture-formats.js.map

package/dist/lib/utils/detect-supported-texture-formats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-supported-texture-formats.js","sourceRoot":"","sources":["../../../src/lib/utils/detect-supported-texture-formats.ts"],"names":[],"mappings":"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"}

package/dist/lib/utils/extract-mipmap-images.d.ts

@@ -1,10 +1,13 @@
-import type { TextureLevel } from '@loaders.gl/schema';
+import type { TextureFormat, TextureLevel } from '@loaders.gl/schema';
+import type { GLTextureFormat } from "../gl-types.js";
 export type CompressedTextureExtractOptions = {
     mipMapLevels: number;
     width: number;
     height: number;
     sizeFunction: Function;
-    internalFormat: number;
+    internalFormat?: GLTextureFormat;
+    /** Canonical loaders.gl texture format for the mip levels being extracted. */
+    textureFormat?: TextureFormat;
 };
 /**
  * Extract mipmap images from compressed texture buffer
@@ -14,6 +17,7 @@ export type CompressedTextureExtractOptions = {
  * @param options.height - height of 0 - level
  * @param options.sizeFunction - format-related function to calculate level size in bytes
  * @param options.internalFormat - WebGL compatible format code
+ * @param options.textureFormat - canonical loaders.gl texture format
  * @returns Array of the texture levels
  */
 export declare function extractMipmapImages(data: Uint8Array | object[], options: CompressedTextureExtractOptions): TextureLevel[];

package/dist/lib/utils/extract-mipmap-images.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extract-mipmap-images.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/extract-mipmap-images.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAErD,MAAM,MAAM,+BAA+B,GAAG;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,QAAQ,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE,EAC3B,OAAO,EAAE,+BAA+B,GACvC,YAAY,EAAE,CA4BhB"}
+{"version":3,"file":"extract-mipmap-images.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/extract-mipmap-images.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,aAAa,EAAE,YAAY,EAAC,MAAM,oBAAoB,CAAC;AACpE,OAAO,KAAK,EAAC,eAAe,EAAC,uBAAoB;AAMjD,MAAM,MAAM,+BAA+B,GAAG;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,QAAQ,CAAC;IACvB,cAAc,CAAC,EAAE,eAAe,CAAC;IACjC,8EAA8E;IAC9E,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE,EAC3B,OAAO,EAAE,+BAA+B,GACvC,YAAY,EAAE,CAuChB"}

package/dist/lib/utils/extract-mipmap-images.js

@@ -1,6 +1,7 @@
 // loaders.gl
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
+import { getTextureFormatFromWebGLFormat, getWebGLFormatFromTextureFormat } from "./texture-format-map.js";
 /**
  * Extract mipmap images from compressed texture buffer
  * @param data - binary data of compressed texture or Array of level objects
@@ -9,10 +10,13 @@
  * @param options.height - height of 0 - level
  * @param options.sizeFunction - format-related function to calculate level size in bytes
  * @param options.internalFormat - WebGL compatible format code
+ * @param options.textureFormat - canonical loaders.gl texture format
  * @returns Array of the texture levels
  */
 export function extractMipmapImages(data, options) {
     const images = new Array(options.mipMapLevels);
+    const textureFormat = options.textureFormat || getTextureFormatFromWebGLFormat(options.internalFormat);
+    const format = options.internalFormat || getWebGLFormatFromTextureFormat(options.textureFormat);
     let levelWidth = options.width;
     let levelHeight = options.height;
     let offset = 0;
@@ -21,14 +25,21 @@ export function extractMipmapImages(data, options) {
         const levelSize = getLevelSize(options, levelWidth, levelHeight, data, i);
         // @ts-expect-error
         const levelData = getLevelData(data, i, offset, levelSize);
-        images[i] = {
+        const image = {
+            shape: 'texture-level',
             compressed: true,
-            format: options.internalFormat,
             data: levelData,
             width: levelWidth,
             height: levelHeight,
             levelSize
         };
+        if (format !== undefined) {
+            image.format = format;
+        }
+        if (textureFormat) {
+            image.textureFormat = textureFormat;
+        }
+        images[i] = image;
         levelWidth = Math.max(1, levelWidth >> 1);
         levelHeight = Math.max(1, levelHeight >> 1);
         offset += levelSize;
@@ -47,3 +58,4 @@ function getLevelSize(options, levelWidth, levelHeight, data, index) {
     }
     return options.sizeFunction(data[index]);
 }
+//# sourceMappingURL=extract-mipmap-images.js.map

package/dist/lib/utils/extract-mipmap-images.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-mipmap-images.js","sourceRoot":"","sources":["../../../src/lib/utils/extract-mipmap-images.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAIpC,OAAO,EACL,+BAA+B,EAC/B,+BAA+B,EAChC,gCAA6B;AAY9B;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAA2B,EAC3B,OAAwC;IAExC,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/C,MAAM,aAAa,GACjB,OAAO,CAAC,aAAa,IAAI,+BAA+B,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACnF,MAAM,MAAM,GAAG,OAAO,CAAC,cAAc,IAAI,+BAA+B,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAEhG,IAAI,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC;IAC/B,IAAI,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IACjC,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,EAAE,CAAC;QAC9C,mBAAmB;QACnB,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC1E,mBAAmB;QACnB,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QAE3D,MAAM,KAAK,GAAiB;YAC1B,KAAK,EAAE,eAAe;YACtB,UAAU,EAAE,IAAI;YAChB,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,UAAU;YACjB,MAAM,EAAE,WAAW;YACnB,SAAS;SACV,CAAC;QAEF,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;QACxB,CAAC;QACD,IAAI,aAAa,EAAE,CAAC;YAClB,KAAK,CAAC,aAAa,GAAG,aAAa,CAAC;QACtC,CAAC;QACD,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;QAElB,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,IAAI,CAAC,CAAC,CAAC;QAC1C,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,IAAI,CAAC,CAAC,CAAC;QAE5C,MAAM,IAAI,SAAS,CAAC;IACtB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CACnB,IAAgB,EAChB,KAAa,EACb,MAAc,EACd,SAAiB;IAEjB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,GAAG,MAAM,EAAE,SAAS,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC;AAC/B,CAAC;AAED,SAAS,YAAY,CACnB,OAAwC,EACxC,UAAkB,EAClB,WAAmB,EACnB,IAA6B,EAC7B,KAAa;IAEb,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,YAAY,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AAC3C,CAAC"}

package/dist/lib/utils/ktx-format-helper.d.ts

@@ -1,3 +1,5 @@
+import type { TextureFormat } from '@loaders.gl/schema';
+import type { GLTextureFormat } from "../gl-types.js";
 /**
  * Returns WebGl format based on Vulkan format
  * Vulkan to WebGl format mapping provided here http://github.khronos.org/KTX-Specification/#formatMapping
@@ -5,5 +7,11 @@
  * @param vkFormat
  * @returns WebGL / OpenGL constant
  */
-export declare function mapVkFormatToWebGL(vkFormat: number): number;
+export declare function mapVkFormatToWebGL(vkFormat: number): GLTextureFormat | undefined;
+/**
+ * Returns the canonical loaders.gl texture format corresponding to a Vulkan `vkFormat` value.
+ * @param vkFormat - Vulkan format constant from the KTX container.
+ * @returns Canonical texture format string, if known.
+ */
+export declare function mapVkFormatToTextureFormat(vkFormat: number): TextureFormat | undefined;
 //# sourceMappingURL=ktx-format-helper.d.ts.map

package/dist/lib/utils/ktx-format-helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ktx-format-helper.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/ktx-format-helper.ts"],"names":[],"mappings":"AAqHA;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3D"}
+{"version":3,"file":"ktx-format-helper.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/ktx-format-helper.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAC,eAAe,EAAC,uBAAoB;AA8HjD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEhF;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEtF"}