@loaders.gl/gltf 4.0.0-alpha.6 → 4.0.0-alpha.8

package/dist/lib/extensions/deprecated/KHR_lights_punctual.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"KHR_lights_punctual.d.ts","sourceRoot":"","sources":["../../../../src/lib/extensions/deprecated/KHR_lights_punctual.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,wBAAwB,CAAC;AAOjD,eAAO,MAAM,IAAI,wBAAsB,CAAC;AAExC,wBAAsB,MAAM,CAAC,QAAQ,EAAE;IAAC,IAAI,EAAE,IAAI,CAAA;CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBlE;AAGD,wBAAsB,MAAM,CAAC,QAAQ,KAAA,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BpD"}
+{"version":3,"file":"KHR_lights_punctual.d.ts","sourceRoot":"","sources":["../../../../src/lib/extensions/deprecated/KHR_lights_punctual.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,8BAA8B,CAAC;AAOvD,eAAO,MAAM,IAAI,wBAAsB,CAAC;AAExC,wBAAsB,MAAM,CAAC,QAAQ,EAAE;IAAC,IAAI,EAAE,IAAI,CAAA;CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBlE;AAGD,wBAAsB,MAAM,CAAC,QAAQ,KAAA,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BpD"}

package/dist/lib/extensions/deprecated/KHR_lights_punctual.js

@@ -1,17 +1,14 @@
 "use strict";
 // GLTF EXTENSION: KHR_lights_punctual
 // https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Khronos/KHR_lights_punctual
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.encode = exports.decode = exports.name = void 0;
 const assert_1 = require("../../utils/assert");
-const gltf_scenegraph_1 = __importDefault(require("../../api/gltf-scenegraph"));
+const gltf_scenegraph_1 = require("../../api/gltf-scenegraph");
 const KHR_LIGHTS_PUNCTUAL = 'KHR_lights_punctual';
 exports.name = KHR_LIGHTS_PUNCTUAL;
 async function decode(gltfData) {
-    const gltfScenegraph = new gltf_scenegraph_1.default(gltfData);
+    const gltfScenegraph = new gltf_scenegraph_1.GLTFScenegraph(gltfData);
     const { json } = gltfScenegraph;
     // Move the light array out of the extension and remove the extension
     const extension = gltfScenegraph.getExtension(KHR_LIGHTS_PUNCTUAL);
@@ -34,7 +31,7 @@ async function decode(gltfData) {
 exports.decode = decode;
 // Move the light ar ray out of the extension and remove the extension
 async function encode(gltfData) {
-    const gltfScenegraph = new gltf_scenegraph_1.default(gltfData);
+    const gltfScenegraph = new gltf_scenegraph_1.GLTFScenegraph(gltfData);
     const { json } = gltfScenegraph;
     // @ts-ignore
     if (json.lights) {

package/dist/lib/extensions/deprecated/KHR_materials_unlit.d.ts

@@ -1,4 +1,4 @@
-import type { GLTF } from '../../types/gltf-types';
+import type { GLTF } from '../../types/gltf-json-schema';
 export declare const name = "KHR_materials_unlit";
 export declare function decode(gltfData: {
     json: GLTF;

package/dist/lib/extensions/deprecated/KHR_materials_unlit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"KHR_materials_unlit.d.ts","sourceRoot":"","sources":["../../../../src/lib/extensions/deprecated/KHR_materials_unlit.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,wBAAwB,CAAC;AAMjD,eAAO,MAAM,IAAI,wBAAsB,CAAC;AAExC,wBAAsB,MAAM,CAAC,QAAQ,EAAE;IAAC,IAAI,EAAE,IAAI,CAAA;CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBlE;AAED,wBAAgB,MAAM,CAAC,QAAQ,KAAA,QAkB9B"}
+{"version":3,"file":"KHR_materials_unlit.d.ts","sourceRoot":"","sources":["../../../../src/lib/extensions/deprecated/KHR_materials_unlit.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,8BAA8B,CAAC;AAMvD,eAAO,MAAM,IAAI,wBAAsB,CAAC;AAExC,wBAAsB,MAAM,CAAC,QAAQ,EAAE;IAAC,IAAI,EAAE,IAAI,CAAA;CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBlE;AAED,wBAAgB,MAAM,CAAC,QAAQ,KAAA,QAkB9B"}

package/dist/lib/extensions/deprecated/KHR_materials_unlit.js

@@ -1,16 +1,13 @@
 "use strict";
 // GLTF EXTENSION: KHR_materials_unlit
 // https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Khronos/KHR_materials_unlit
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.encode = exports.decode = exports.name = void 0;
-const gltf_scenegraph_1 = __importDefault(require("../../api/gltf-scenegraph"));
+const gltf_scenegraph_1 = require("../../api/gltf-scenegraph");
 const KHR_MATERIALS_UNLIT = 'KHR_materials_unlit';
 exports.name = KHR_MATERIALS_UNLIT;
 async function decode(gltfData) {
-    const gltfScenegraph = new gltf_scenegraph_1.default(gltfData);
+    const gltfScenegraph = new gltf_scenegraph_1.GLTFScenegraph(gltfData);
     const { json } = gltfScenegraph;
     // Any nodes that have the extension, add lights field pointing to light object
     // and remove the extension
@@ -27,7 +24,7 @@ async function decode(gltfData) {
 }
 exports.decode = decode;
 function encode(gltfData) {
-    const gltfScenegraph = new gltf_scenegraph_1.default(gltfData);
+    const gltfScenegraph = new gltf_scenegraph_1.GLTFScenegraph(gltfData);
     const { json } = gltfScenegraph;
     // Any nodes that have lights field pointing to light object
     // add the extension

package/dist/lib/extensions/deprecated/KHR_techniques_webgl.d.ts

@@ -1,4 +1,4 @@
-import type { GLTF } from '../../types/gltf-types';
+import type { GLTF } from '../../types/gltf-json-schema';
 export declare const name = "KHR_techniques_webgl";
 export declare function decode(gltfData: {
     json: GLTF;

package/dist/lib/extensions/deprecated/KHR_techniques_webgl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"KHR_techniques_webgl.d.ts","sourceRoot":"","sources":["../../../../src/lib/extensions/deprecated/KHR_techniques_webgl.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,wBAAwB,CAAC;AAMjD,eAAO,MAAM,IAAI,yBAAuB,CAAC;AAEzC,wBAAsB,MAAM,CAAC,QAAQ,EAAE;IAAC,IAAI,EAAE,IAAI,CAAA;CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BlE;AAED,wBAAsB,MAAM,CAAC,QAAQ,KAAA,EAAE,OAAO,KAAA,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7D"}
+{"version":3,"file":"KHR_techniques_webgl.d.ts","sourceRoot":"","sources":["../../../../src/lib/extensions/deprecated/KHR_techniques_webgl.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,8BAA8B,CAAC;AAMvD,eAAO,MAAM,IAAI,yBAAuB,CAAC;AAEzC,wBAAsB,MAAM,CAAC,QAAQ,EAAE;IAAC,IAAI,EAAE,IAAI,CAAA;CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BlE;AAED,wBAAsB,MAAM,CAAC,QAAQ,KAAA,EAAE,OAAO,KAAA,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7D"}

package/dist/lib/extensions/deprecated/KHR_techniques_webgl.js

@@ -1,16 +1,13 @@
 "use strict";
 // GLTF EXTENSION: KHR_techniques_webgl
 // https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Khronos/KHR_techniques_webgl
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.encode = exports.decode = exports.name = void 0;
-const gltf_scenegraph_1 = __importDefault(require("../../api/gltf-scenegraph"));
+const gltf_scenegraph_1 = require("../../api/gltf-scenegraph");
 const KHR_TECHNIQUES_WEBGL = 'KHR_techniques_webgl';
 exports.name = KHR_TECHNIQUES_WEBGL;
 async function decode(gltfData) {
-    const gltfScenegraph = new gltf_scenegraph_1.default(gltfData);
+    const gltfScenegraph = new gltf_scenegraph_1.GLTFScenegraph(gltfData);
     const { json } = gltfScenegraph;
     const extension = gltfScenegraph.getExtension(KHR_TECHNIQUES_WEBGL);
     if (extension) {

package/dist/lib/gltf-utils/gltf-attribute-utils.d.ts

@@ -1,4 +1,4 @@
-import type { GLTFAccessor } from '../types/gltf-types';
+import type { GLTFAccessor } from '../types/gltf-json-schema';
 export declare function getGLTFAccessors(attributes: any): {
     [key: string]: GLTFAccessor;
 };

package/dist/lib/gltf-utils/gltf-attribute-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gltf-attribute-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/gltf-utils/gltf-attribute-utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAOtD,wBAAgB,gBAAgB,CAAC,UAAU,KAAA,GAAG;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAA;CAAC,CAU1E;AAKD,wBAAgB,eAAe,CAAC,SAAS,KAAA,gBAmBxC"}
+{"version":3,"file":"gltf-attribute-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/gltf-utils/gltf-attribute-utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,2BAA2B,CAAC;AAO5D,wBAAgB,gBAAgB,CAAC,UAAU,KAAA,GAAG;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAA;CAAC,CAU1E;AAKD,wBAAgB,eAAe,CAAC,SAAS,KAAA,gBAmBxC"}

package/dist/lib/gltf-utils/gltf-utils.d.ts

@@ -1,3 +1,4 @@
+import type { GLTFPostprocessed } from '../types/gltf-postprocessed-schema';
 export declare function getAccessorTypeFromSize(size: any): string;
 export declare function getComponentTypeFromArray(typedArray: any): number;
 export declare function getAccessorArrayTypeAndLength(accessor: any, bufferView: any): {
@@ -5,4 +6,10 @@ export declare function getAccessorArrayTypeAndLength(accessor: any, bufferView:
     length: number;
     byteLength: number;
 };
+/**
+ * Calculate the GPU memory used by a GLTF tile, for both buffer and texture memory
+ * @param gltf - the gltf content of a GLTF tile
+ * @returns - total memory usage in bytes
+ */
+export declare function getMemoryUsageGLTF(gltf: GLTFPostprocessed): number;
 //# sourceMappingURL=gltf-utils.d.ts.map

package/dist/lib/gltf-utils/gltf-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gltf-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/gltf-utils/gltf-utils.ts"],"names":[],"mappings":"AAyDA,wBAAgB,uBAAuB,CAAC,IAAI,KAAA,UAG3C;AAED,wBAAgB,yBAAyB,CAAC,UAAU,KAAA,UAMnD;AAED,wBAAgB,6BAA6B,CAAC,QAAQ,KAAA,EAAE,UAAU,KAAA;;;;EAQjE"}
+{"version":3,"file":"gltf-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/gltf-utils/gltf-utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,oCAAoC,CAAC;AA+D1E,wBAAgB,uBAAuB,CAAC,IAAI,KAAA,UAG3C;AAED,wBAAgB,yBAAyB,CAAC,UAAU,KAAA,UAMnD;AAED,wBAAgB,6BAA6B,CAAC,QAAQ,KAAA,EAAE,UAAU,KAAA;;;;EAQjE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAiBlE"}

package/dist/lib/gltf-utils/gltf-utils.js

@@ -1,7 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAccessorArrayTypeAndLength = exports.getComponentTypeFromArray = exports.getAccessorTypeFromSize = void 0;
+exports.getMemoryUsageGLTF = exports.getAccessorArrayTypeAndLength = exports.getComponentTypeFromArray = exports.getAccessorTypeFromSize = void 0;
 const assert_1 = require("../utils/assert");
+/**
+ * Memory needed to store texture and all mipmap levels 1 + 1/4 + 1/16 + 1/64 + ...
+ * Minimum 1.33, but due to GPU layout may be 1.5
+ */
+const MIPMAP_FACTOR = 1.33;
 const TYPES = ['SCALAR', 'VEC2', 'VEC3', 'VEC4'];
 const ARRAY_CONSTRUCTOR_TO_WEBGL_CONSTANT = [
     [Int8Array, 5120],
@@ -61,3 +66,25 @@ function getAccessorArrayTypeAndLength(accessor, bufferView) {
     return { ArrayType, length, byteLength };
 }
 exports.getAccessorArrayTypeAndLength = getAccessorArrayTypeAndLength;
+/**
+ * Calculate the GPU memory used by a GLTF tile, for both buffer and texture memory
+ * @param gltf - the gltf content of a GLTF tile
+ * @returns - total memory usage in bytes
+ */
+function getMemoryUsageGLTF(gltf) {
+    let { images, bufferViews } = gltf;
+    images = images || [];
+    bufferViews = bufferViews || [];
+    const imageBufferViews = images.map((i) => i.bufferView);
+    bufferViews = bufferViews.filter((view) => !imageBufferViews.includes(view));
+    const bufferMemory = bufferViews.reduce((acc, view) => acc + view.byteLength, 0);
+    // Assume each pixel of the texture is 4 channel with mimmaps (which add 33%)
+    // TODO correctly handle compressed textures
+    const pixelCount = images.reduce((acc, image) => {
+        // @ts-ignore
+        const { width, height } = image.image;
+        return acc + width * height;
+    }, 0);
+    return bufferMemory + Math.ceil(4 * pixelCount * MIPMAP_FACTOR);
+}
+exports.getMemoryUsageGLTF = getMemoryUsageGLTF;

package/dist/lib/parsers/parse-glb.d.ts

@@ -1,8 +1,20 @@
 import type { GLB } from '../types/glb-types';
-export type GLBParseOptions = {
+/** Options for parsing a GLB */
+export type ParseGLBOptions = {
+    /** @deprecated This option was used by XVIZ protocol to define a non-standard magic number */
     magic?: number;
+    /** @deprecated This option was used by XVIZ protocol to embed non-standard chunks */
     strict?: boolean;
 };
-export declare function isGLB(arrayBuffer: ArrayBuffer, byteOffset?: number, options?: GLBParseOptions): boolean;
-export default function parseGLBSync(glb: GLB, arrayBuffer: ArrayBuffer, byteOffset?: number, options?: GLBParseOptions): number;
+/** Check if the contents of an array buffer contains GLB byte markers */
+export declare function isGLB(arrayBuffer: ArrayBuffer, byteOffset?: number, options?: ParseGLBOptions): boolean;
+/**
+ * Synchronously parse a GLB
+ * @param glb - Target, Output is stored there
+ * @param arrayBuffer - Input data
+ * @param byteOffset - Offset into arrayBuffer to start parsing from (for "embedded" GLBs, e.g. in 3D tiles)
+ * @param options
+ * @returns
+ */
+export declare function parseGLBSync(glb: GLB, arrayBuffer: ArrayBuffer, byteOffset?: number, options?: ParseGLBOptions): number;
 //# sourceMappingURL=parse-glb.d.ts.map

package/dist/lib/parsers/parse-glb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-glb.d.ts","sourceRoot":"","sources":["../../../src/lib/parsers/parse-glb.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,oBAAoB,CAAC;AAG5C,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAyBF,wBAAgB,KAAK,CACnB,WAAW,EAAE,WAAW,EACxB,UAAU,GAAE,MAAU,EACtB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAMT;AAED,MAAM,CAAC,OAAO,UAAU,YAAY,CAClC,GAAG,EAAE,GAAG,EACR,WAAW,EAAE,WAAW,EACxB,UAAU,GAAE,MAAU,EACtB,OAAO,GAAE,eAAoB,UAqC9B"}
+{"version":3,"file":"parse-glb.d.ts","sourceRoot":"","sources":["../../../src/lib/parsers/parse-glb.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,oBAAoB,CAAC;AAG5C,gCAAgC;AAChC,MAAM,MAAM,eAAe,GAAG;IAC5B,8FAA8F;IAC9F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AA0BF,yEAAyE;AACzE,wBAAgB,KAAK,CACnB,WAAW,EAAE,WAAW,EACxB,UAAU,GAAE,MAAU,EACtB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAMT;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,GAAG,EACR,WAAW,EAAE,WAAW,EACxB,UAAU,GAAE,MAAU,EACtB,OAAO,GAAE,eAAoB,UAmC9B"}

package/dist/lib/parsers/parse-glb.js

@@ -1,16 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isGLB = void 0;
+exports.parseGLBSync = exports.isGLB = void 0;
 const loader_utils_1 = require("@loaders.gl/loader-utils");
-const MAGIC_glTF = 0x676c5446; // glTF in Big-Endian ASCII
+/** Binary GLTF is little endian. */
+const LITTLE_ENDIAN = true;
+/** 'glTF' in Big-Endian ASCII */
+const MAGIC_glTF = 0x676c5446;
 const GLB_FILE_HEADER_SIZE = 12;
 const GLB_CHUNK_HEADER_SIZE = 8;
 const GLB_CHUNK_TYPE_JSON = 0x4e4f534a;
 const GLB_CHUNK_TYPE_BIN = 0x004e4942;
-const GLB_CHUNK_TYPE_JSON_XVIZ_DEPRECATED = 0; // DEPRECATED - Backward compatibility for old xviz files
-const GLB_CHUNK_TYPE_BIX_XVIZ_DEPRECATED = 1; // DEPRECATED - Backward compatibility for old xviz files
 const GLB_V1_CONTENT_FORMAT_JSON = 0x0;
-const LE = true; // Binary GLTF is little endian.
+/** @deprecated - Backward compatibility for old xviz files */
+const GLB_CHUNK_TYPE_JSON_XVIZ_DEPRECATED = 0;
+/** @deprecated - Backward compatibility for old xviz files */
+const GLB_CHUNK_TYPE_BIX_XVIZ_DEPRECATED = 1;
 function getMagicString(dataView, byteOffset = 0) {
     return `\
 ${String.fromCharCode(dataView.getUint8(byteOffset + 0))}\
@@ -18,7 +22,7 @@ ${String.fromCharCode(dataView.getUint8(byteOffset + 1))}\
 ${String.fromCharCode(dataView.getUint8(byteOffset + 2))}\
 ${String.fromCharCode(dataView.getUint8(byteOffset + 3))}`;
 }
-// Check if a data view is a GLB
+/** Check if the contents of an array buffer contains GLB byte markers */
 function isGLB(arrayBuffer, byteOffset = 0, options = {}) {
     const dataView = new DataView(arrayBuffer);
     // Check that GLB Header starts with the magic number
@@ -27,13 +31,21 @@ function isGLB(arrayBuffer, byteOffset = 0, options = {}) {
     return magic1 === magic || magic1 === MAGIC_glTF;
 }
 exports.isGLB = isGLB;
+/**
+ * Synchronously parse a GLB
+ * @param glb - Target, Output is stored there
+ * @param arrayBuffer - Input data
+ * @param byteOffset - Offset into arrayBuffer to start parsing from (for "embedded" GLBs, e.g. in 3D tiles)
+ * @param options
+ * @returns
+ */
 function parseGLBSync(glb, arrayBuffer, byteOffset = 0, options = {}) {
     // Check that GLB Header starts with the magic number
     const dataView = new DataView(arrayBuffer);
     // Compare format with GLBLoader documentation
     const type = getMagicString(dataView, byteOffset + 0);
-    const version = dataView.getUint32(byteOffset + 4, LE); // Version 2 of binary glTF container format
-    const byteLength = dataView.getUint32(byteOffset + 8, LE); // Total byte length of binary file
+    const version = dataView.getUint32(byteOffset + 4, LITTLE_ENDIAN); // Version 2 of binary glTF container format
+    const byteLength = dataView.getUint32(byteOffset + 8, LITTLE_ENDIAN); // Total byte length of binary file
     Object.assign(glb, {
         // Put less important stuff in a header, to avoid clutter
         header: {
@@ -49,23 +61,28 @@ function parseGLBSync(glb, arrayBuffer, byteOffset = 0, options = {}) {
     byteOffset += GLB_FILE_HEADER_SIZE;
     switch (glb.version) {
         case 1:
-            // eslint-disable-next-line
             return parseGLBV1(glb, dataView, byteOffset);
         case 2:
-            // eslint-disable-next-line
             return parseGLBV2(glb, dataView, byteOffset, (options = {}));
         default:
-            throw new Error(`Invalid GLB version ${glb.version}. Only supports v1 and v2.`);
+            throw new Error(`Invalid GLB version ${glb.version}. Only supports version 1 and 2.`);
     }
 }
-exports.default = parseGLBSync;
+exports.parseGLBSync = parseGLBSync;
+/**
+ * Parse a V1 GLB
+ * @param glb - target, output is stored in this object
+ * @param dataView - Input, memory to be parsed
+ * @param byteOffset - Offset of first byte of GLB data in the data view
+ * @returns Number of bytes parsed (there could be additional non-GLB data after the GLB)
+ */
 function parseGLBV1(glb, dataView, byteOffset) {
     // Sanity: ensure file is big enough to hold at least the headers
     (0, loader_utils_1.assert)(glb.header.byteLength > GLB_FILE_HEADER_SIZE + GLB_CHUNK_HEADER_SIZE);
     // Explanation of GLB structure:
     // https://cloud.githubusercontent.com/assets/3479527/22600725/36b87122-ea55-11e6-9d40-6fd42819fcab.png
-    const contentLength = dataView.getUint32(byteOffset + 0, LE); // Byte length of chunk
-    const contentFormat = dataView.getUint32(byteOffset + 4, LE); // Chunk format as uint32
+    const contentLength = dataView.getUint32(byteOffset + 0, LITTLE_ENDIAN); // Byte length of chunk
+    const contentFormat = dataView.getUint32(byteOffset + 4, LITTLE_ENDIAN); // Chunk format as uint32
     byteOffset += GLB_CHUNK_HEADER_SIZE;
     // GLB v1 only supports a single chunk type
     (0, loader_utils_1.assert)(contentFormat === GLB_V1_CONTENT_FORMAT_JSON);
@@ -75,18 +92,26 @@ function parseGLBV1(glb, dataView, byteOffset) {
     byteOffset += parseBINChunk(glb, dataView, byteOffset, glb.header.byteLength);
     return byteOffset;
 }
+/**
+ * Parse a V2 GLB
+ * @param glb - target, output is stored in this object
+ * @param dataView - Input, memory to be parsed
+ * @param byteOffset - Offset of first byte of GLB data in the data view
+ * @returns Number of bytes parsed (there could be additional non-GLB data after the GLB)
+ */
 function parseGLBV2(glb, dataView, byteOffset, options) {
     // Sanity: ensure file is big enough to hold at least the first chunk header
     (0, loader_utils_1.assert)(glb.header.byteLength > GLB_FILE_HEADER_SIZE + GLB_CHUNK_HEADER_SIZE);
     parseGLBChunksSync(glb, dataView, byteOffset, options);
     return byteOffset + glb.header.byteLength;
 }
+/** Iterate over GLB chunks and parse them */
 function parseGLBChunksSync(glb, dataView, byteOffset, options) {
     // Per spec we must iterate over chunks, ignoring all except JSON and BIN
     // Iterate as long as there is space left for another chunk header
     while (byteOffset + 8 <= glb.header.byteLength) {
-        const chunkLength = dataView.getUint32(byteOffset + 0, LE); // Byte length of chunk
-        const chunkFormat = dataView.getUint32(byteOffset + 4, LE); // Chunk format as uint32
+        const chunkLength = dataView.getUint32(byteOffset + 0, LITTLE_ENDIAN); // Byte length of chunk
+        const chunkFormat = dataView.getUint32(byteOffset + 4, LITTLE_ENDIAN); // Chunk format as uint32
         byteOffset += GLB_CHUNK_HEADER_SIZE;
         // Per spec we must iterate over chunks, ignoring all except JSON and BIN
         switch (chunkFormat) {
@@ -116,7 +141,7 @@ function parseGLBChunksSync(glb, dataView, byteOffset, options) {
     }
     return byteOffset;
 }
-// Parse a GLB JSON chunk
+/* Parse a GLB JSON chunk */
 function parseJSONChunk(glb, dataView, byteOffset, chunkLength) {
     // 1. Create a "view" of the binary encoded JSON data inside the GLB
     const jsonChunk = new Uint8Array(dataView.buffer, byteOffset, chunkLength);
@@ -127,7 +152,7 @@ function parseJSONChunk(glb, dataView, byteOffset, chunkLength) {
     glb.json = JSON.parse(jsonText);
     return (0, loader_utils_1.padToNBytes)(chunkLength, 4);
 }
-// Parse a GLB BIN chunk
+/** Parse a GLB BIN chunk */
 function parseBINChunk(glb, dataView, byteOffset, chunkLength) {
     // Note: BIN chunk can be optional
     glb.header.hasBinChunk = true;

package/dist/lib/parsers/parse-gltf.d.ts

@@ -1,14 +1,18 @@
 import type { LoaderContext } from '@loaders.gl/loader-utils';
 import type { GLTFLoaderOptions } from '../../gltf-loader';
 import type { GLTFWithBuffers } from '../types/gltf-types';
-export type GLTFParseOptions = {
+import type { ParseGLBOptions } from './parse-glb';
+/**  */
+export type ParseGLTFOptions = ParseGLBOptions & {
     normalize?: boolean;
     loadImages?: boolean;
     loadBuffers?: boolean;
     decompressMeshes?: boolean;
-    postProcess?: boolean;
     excludeExtensions?: string[];
+    /** @deprecated not supported in v4. `postProcessGLTF()` must be called by the application */
+    postProcess?: false;
 };
-export declare function isGLTF(arrayBuffer: any, options?: any): boolean;
-export declare function parseGLTF(gltf: GLTFWithBuffers, arrayBufferOrString: any, byteOffset: number | undefined, options: GLTFLoaderOptions, context: LoaderContext): Promise<Record<string, any> | GLTFWithBuffers>;
+/** Check if an array buffer appears to contain GLTF data */
+export declare function isGLTF(arrayBuffer: ArrayBuffer, options?: ParseGLTFOptions): boolean;
+export declare function parseGLTF(gltf: GLTFWithBuffers, arrayBufferOrString: any, byteOffset: number | undefined, options: GLTFLoaderOptions, context: LoaderContext): Promise<GLTFWithBuffers>;
 //# sourceMappingURL=parse-gltf.d.ts.map

package/dist/lib/parsers/parse-gltf.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-gltf.d.ts","sourceRoot":"","sources":["../../../src/lib/parsers/parse-gltf.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAE5D,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AAEzD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,qBAAqB,CAAC;AAYzD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B,CAAC;AAMF,wBAAgB,MAAM,CAAC,WAAW,KAAA,EAAE,OAAO,CAAC,KAAA,GAAG,OAAO,CAGrD;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE,eAAe,EACrB,mBAAmB,KAAA,EACnB,UAAU,oBAAI,EACd,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,aAAa,kDA4BvB"}
+{"version":3,"file":"parse-gltf.d.ts","sourceRoot":"","sources":["../../../src/lib/parsers/parse-gltf.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,qBAAqB,CAAC;AAEzD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,aAAa,CAAC;AAajD,OAAO;AACP,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG;IAC/C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE7B,6FAA6F;IAC7F,WAAW,CAAC,EAAE,KAAK,CAAC;CACrB,CAAC;AAEF,4DAA4D;AAC5D,wBAAgB,MAAM,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAGpF;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE,eAAe,EACrB,mBAAmB,KAAA,EACnB,UAAU,oBAAI,EACd,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,eAAe,CAAC,CAqB1B"}

package/dist/lib/parsers/parse-gltf.js

@@ -1,42 +1,16 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseGLTF = exports.isGLTF = void 0;
-const textures_1 = require("@loaders.gl/textures");
-const images_1 = require("@loaders.gl/images");
 const loader_utils_1 = require("@loaders.gl/loader-utils");
+const images_1 = require("@loaders.gl/images");
+const textures_1 = require("@loaders.gl/textures");
 const assert_1 = require("../utils/assert");
+const parse_glb_1 = require("./parse-glb");
 const resolve_url_1 = require("../gltf-utils/resolve-url");
 const get_typed_array_1 = require("../gltf-utils/get-typed-array");
 const gltf_extensions_1 = require("../api/gltf-extensions");
 const normalize_gltf_v1_1 = require("../api/normalize-gltf-v1");
-const post_process_gltf_1 = require("../api/post-process-gltf");
-const parse_glb_1 = __importStar(require("./parse-glb"));
-// export type GLTFOptions = {
-//   gltf?: GLTFParseOptions;
-// };
+/** Check if an array buffer appears to contain GLTF data */
 function isGLTF(arrayBuffer, options) {
     const byteOffset = 0;
     return (0, parse_glb_1.isGLB)(arrayBuffer, byteOffset, options);
@@ -46,24 +20,26 @@ async function parseGLTF(gltf, arrayBufferOrString, byteOffset = 0, options, con
     parseGLTFContainerSync(gltf, arrayBufferOrString, byteOffset, options);
     (0, normalize_gltf_v1_1.normalizeGLTFV1)(gltf, { normalize: options?.gltf?.normalize });
     (0, gltf_extensions_1.preprocessExtensions)(gltf, options, context);
-    const promises = [];
     // Load linked buffers asynchronously and decodes base64 buffers in parallel
     if (options?.gltf?.loadBuffers && gltf.json.buffers) {
         await loadBuffers(gltf, options, context);
     }
+    // loadImages and decodeExtensions should not be running in parallel, because
+    // decodeExtensions uses data from images taken during the loadImages call.
     if (options?.gltf?.loadImages) {
-        const promise = loadImages(gltf, options, context);
-        promises.push(promise);
+        await loadImages(gltf, options, context);
     }
-    const promise = (0, gltf_extensions_1.decodeExtensions)(gltf, options, context);
-    promises.push(promise);
-    // Parallelize image loading and buffer loading/extension decoding
-    await Promise.all(promises);
-    // Post processing resolves indices to objects, buffers
-    return options?.gltf?.postProcess ? (0, post_process_gltf_1.postProcessGLTF)(gltf, options) : gltf;
+    await (0, gltf_extensions_1.decodeExtensions)(gltf, options, context);
+    return gltf;
 }
 exports.parseGLTF = parseGLTF;
-// `data` - can be ArrayBuffer (GLB), ArrayBuffer (Binary JSON), String (JSON), or Object (parsed JSON)
+/**
+ *
+ * @param gltf
+ * @param data - can be ArrayBuffer (GLB), ArrayBuffer (Binary JSON), String (JSON), or Object (parsed JSON)
+ * @param byteOffset
+ * @param options
+ */
 function parseGLTFContainerSync(gltf, data, byteOffset, options) {
     // Initialize gltf container
     if (options.uri) {
@@ -81,7 +57,7 @@ function parseGLTFContainerSync(gltf, data, byteOffset, options) {
     else if (data instanceof ArrayBuffer) {
         // If still ArrayBuffer, parse as GLB container
         const glb = {};
-        byteOffset = (0, parse_glb_1.default)(glb, data, byteOffset, options.glb);
+        byteOffset = (0, parse_glb_1.parseGLBSync)(glb, data, byteOffset, options.glb);
         (0, assert_1.assert)(glb.type === 'glTF', `Invalid GLB magic string ${glb.type}`);
         gltf._glb = glb;
         gltf.json = glb.json;