@loaders.gl/scene 5.0.0-alpha.9 → 5.0.0-beta.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-url.d.ts","sourceRoot":"","sources":["../../../../src/gltf/lib/gltf-utils/resolve-url.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,aAAa,EAAE,mBAAmB,EAAC,MAAM,+BAA+B,CAAC;AAItF,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,aAAa,UAY7F;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMnD"}

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

@@ -0,0 +1,43 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+// Resolves a relative url against a baseUrl
+// If url is absolute, return it unchanged
+export function resolveUrl(url, options, context) {
+    // TODO: Use better logic to handle all protocols plus not delay on data
+    const absolute = url.startsWith('data:') || url.startsWith('http:') || url.startsWith('https:');
+    if (absolute) {
+        return canonicalizeUrl(url);
+    }
+    const baseUrl = context?.baseUrl || getResolveBaseUrl(options?.core?.baseUrl);
+    if (!baseUrl) {
+        throw new Error(`'baseUrl' must be provided to resolve relative url ${url}`);
+    }
+    const resolvedUrl = baseUrl.endsWith('/') ? `${baseUrl}${url}` : `${baseUrl}/${url}`;
+    return canonicalizeUrl(resolvedUrl);
+}
+/**
+ * Normalize equivalent absolute URLs for cache and cycle-detection keys.
+ * Non-URL paths are returned unchanged so local and virtual file-system resolution remains intact.
+ * @param url - URL to normalize.
+ * @returns Canonical URL when the input has a supported absolute scheme.
+ */
+export function canonicalizeUrl(url) {
+    try {
+        return new URL(url).href;
+    }
+    catch {
+        return url;
+    }
+}
+function getResolveBaseUrl(baseUrl) {
+    if (!baseUrl) {
+        return undefined;
+    }
+    if (baseUrl.endsWith('/')) {
+        return baseUrl;
+    }
+    const slashIndex = baseUrl.lastIndexOf('/');
+    return slashIndex >= 0 ? baseUrl.slice(0, slashIndex + 1) : '';
+}
+//# sourceMappingURL=resolve-url.js.map

package/dist/gltf/lib/gltf-utils/resolve-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-url.js","sourceRoot":"","sources":["../../../../src/gltf/lib/gltf-utils/resolve-url.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAIpC,4CAA4C;AAC5C,0CAA0C;AAC1C,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,OAA6B,EAAE,OAAuB;IAC5F,wEAAwE;IACxE,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAChG,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,iBAAiB,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC9E,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,sDAAsD,GAAG,EAAE,CAAC,CAAC;IAC/E,CAAC;IACD,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,GAAG,EAAE,CAAC;IACrF,OAAO,eAAe,CAAC,WAAW,CAAC,CAAC;AACtC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAgB;IACzC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC5C,OAAO,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACjE,CAAC"}

package/dist/gltf/lib/parsers/parse-glb.cjs

@@ -0,0 +1,185 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/gltf/lib/parsers/parse-glb.ts
+var parse_glb_exports = {};
+__export(parse_glb_exports, {
+  isGLB: () => isGLB,
+  parseGLBSync: () => parseGLBSync
+});
+module.exports = __toCommonJS(parse_glb_exports);
+var import_loader_utils = require("@loaders.gl/core/loader-utils");
+var LITTLE_ENDIAN = true;
+var MAGIC_glTF = 1735152710;
+var GLB_V1_V2_FILE_HEADER_SIZE = 12;
+var GLB_V3_FILE_HEADER_SIZE = 16;
+var GLB_V1_V2_CHUNK_HEADER_SIZE = 8;
+var GLB_V3_CHUNK_HEADER_SIZE = 16;
+var GLB_CHUNK_TYPE_JSON = 1313821514;
+var GLB_CHUNK_TYPE_BIN = 5130562;
+var GLB_V1_CONTENT_FORMAT_JSON = 0;
+var GLB_CHUNK_TYPE_JSON_XVIZ_DEPRECATED = 0;
+var GLB_CHUNK_TYPE_BIX_XVIZ_DEPRECATED = 1;
+function getMagicString(dataView, byteOffset = 0) {
+  return `${String.fromCharCode(dataView.getUint8(byteOffset + 0))}${String.fromCharCode(dataView.getUint8(byteOffset + 1))}${String.fromCharCode(dataView.getUint8(byteOffset + 2))}${String.fromCharCode(dataView.getUint8(byteOffset + 3))}`;
+}
+function isGLB(arrayBuffer, byteOffset = 0, options = {}) {
+  const dataView = new DataView(arrayBuffer);
+  const { magic = MAGIC_glTF } = options;
+  const magic1 = dataView.getUint32(byteOffset, false);
+  return magic1 === magic || magic1 === MAGIC_glTF;
+}
+function parseGLBSync(glb, arrayBuffer, byteOffset = 0, options = {}) {
+  const dataView = new DataView(arrayBuffer);
+  const type = getMagicString(dataView, byteOffset + 0);
+  const version = dataView.getUint32(byteOffset + 4, LITTLE_ENDIAN);
+  const byteLength = version === 3 ? getSafeUint64(dataView, byteOffset + 8, "GLB byte length") : dataView.getUint32(byteOffset + 8, LITTLE_ENDIAN);
+  Object.assign(glb, {
+    // Put less important stuff in a header, to avoid clutter
+    header: {
+      byteOffset,
+      // Byte offset into the initial arrayBuffer
+      byteLength,
+      hasBinChunk: false
+    },
+    type,
+    version,
+    json: {},
+    jsonChunkIndex: -1,
+    binChunks: []
+  });
+  switch (glb.version) {
+    case 1:
+      return parseGLBV1(glb, dataView, byteOffset + GLB_V1_V2_FILE_HEADER_SIZE);
+    case 2:
+      return parseGLBV2(glb, dataView, byteOffset + GLB_V1_V2_FILE_HEADER_SIZE, options);
+    case 3:
+      return parseGLBV3(glb, dataView, byteOffset + GLB_V3_FILE_HEADER_SIZE, options);
+    default:
+      throw new Error(`Invalid GLB version ${glb.version}. Only supports versions 1, 2 and 3.`);
+  }
+}
+function parseGLBV1(glb, dataView, byteOffset) {
+  (0, import_loader_utils.assert)(glb.header.byteLength > GLB_V1_V2_FILE_HEADER_SIZE + GLB_V1_V2_CHUNK_HEADER_SIZE);
+  const fileEndByteOffset = glb.header.byteOffset + glb.header.byteLength;
+  (0, import_loader_utils.assert)(fileEndByteOffset <= dataView.byteLength);
+  const contentLength = dataView.getUint32(byteOffset + 0, LITTLE_ENDIAN);
+  const contentFormat = dataView.getUint32(byteOffset + 4, LITTLE_ENDIAN);
+  byteOffset += GLB_V1_V2_CHUNK_HEADER_SIZE;
+  (0, import_loader_utils.assert)(contentFormat === GLB_V1_CONTENT_FORMAT_JSON);
+  if (byteOffset + contentLength > fileEndByteOffset) {
+    throw new Error("GLB JSON content extends beyond the declared file length.");
+  }
+  parseJSONChunk(glb, dataView, byteOffset, contentLength, 0);
+  byteOffset += contentLength;
+  const bodyByteLength = fileEndByteOffset - byteOffset;
+  if (bodyByteLength > 0) {
+    parseBINChunk(glb, dataView, byteOffset, bodyByteLength, 1);
+  }
+  return fileEndByteOffset;
+}
+function parseGLBV2(glb, dataView, byteOffset, options) {
+  (0, import_loader_utils.assert)(glb.header.byteLength > GLB_V1_V2_FILE_HEADER_SIZE + GLB_V1_V2_CHUNK_HEADER_SIZE);
+  parseGLBChunksSync(glb, dataView, byteOffset, GLB_V1_V2_CHUNK_HEADER_SIZE, options);
+  return glb.header.byteOffset + glb.header.byteLength;
+}
+function parseGLBV3(glb, dataView, byteOffset, options) {
+  (0, import_loader_utils.assert)(glb.header.byteLength >= GLB_V3_FILE_HEADER_SIZE + GLB_V3_CHUNK_HEADER_SIZE);
+  parseGLBChunksSync(glb, dataView, byteOffset, GLB_V3_CHUNK_HEADER_SIZE, options);
+  return glb.header.byteOffset + glb.header.byteLength;
+}
+function parseGLBChunksSync(glb, dataView, byteOffset, chunkHeaderSize, options) {
+  const fileEndByteOffset = glb.header.byteOffset + glb.header.byteLength;
+  (0, import_loader_utils.assert)(fileEndByteOffset <= dataView.byteLength);
+  let chunkIndex = 0;
+  while (byteOffset + chunkHeaderSize <= fileEndByteOffset) {
+    const isVersion3 = glb.version === 3;
+    const chunkFormat = dataView.getUint32(byteOffset + (isVersion3 ? 0 : 4), LITTLE_ENDIAN);
+    const chunkEncoding = isVersion3 ? dataView.getUint32(byteOffset + 4, LITTLE_ENDIAN) : 0;
+    const chunkLength = isVersion3 ? getSafeUint64(dataView, byteOffset + 8, "GLB chunk length") : dataView.getUint32(byteOffset + 0, LITTLE_ENDIAN);
+    byteOffset += chunkHeaderSize;
+    if (chunkEncoding !== 0) {
+      throw new Error(`Unsupported GLB chunk encoding ${chunkEncoding}.`);
+    }
+    if (byteOffset + chunkLength > fileEndByteOffset) {
+      throw new Error("GLB chunk extends beyond the declared file length.");
+    }
+    switch (chunkFormat) {
+      case GLB_CHUNK_TYPE_JSON:
+        if (glb.version !== 3 || glb.jsonChunkIndex === -1) {
+          parseJSONChunk(glb, dataView, byteOffset, chunkLength, chunkIndex);
+        }
+        break;
+      case GLB_CHUNK_TYPE_BIN:
+        parseBINChunk(glb, dataView, byteOffset, chunkLength, chunkIndex);
+        break;
+      // Backward compatibility for very old xviz files
+      case GLB_CHUNK_TYPE_JSON_XVIZ_DEPRECATED:
+        if (!options.strict) {
+          parseJSONChunk(glb, dataView, byteOffset, chunkLength, chunkIndex);
+        }
+        break;
+      case GLB_CHUNK_TYPE_BIX_XVIZ_DEPRECATED:
+        if (!options.strict) {
+          parseBINChunk(glb, dataView, byteOffset, chunkLength, chunkIndex);
+        }
+        break;
+      default:
+        break;
+    }
+    byteOffset += padToFourBytes(chunkLength);
+    chunkIndex++;
+  }
+  return byteOffset;
+}
+function parseJSONChunk(glb, dataView, byteOffset, chunkLength, chunkIndex) {
+  const jsonChunk = new Uint8Array(dataView.buffer, byteOffset, chunkLength);
+  const textDecoder = new TextDecoder("utf8");
+  const jsonText = textDecoder.decode(jsonChunk);
+  glb.json = JSON.parse(jsonText);
+  glb.jsonChunkIndex = chunkIndex;
+  return padToFourBytes(chunkLength);
+}
+function parseBINChunk(glb, dataView, byteOffset, chunkLength, chunkIndex) {
+  glb.header.hasBinChunk = true;
+  glb.binChunks.push({
+    chunkIndex,
+    byteOffset,
+    byteLength: chunkLength,
+    arrayBuffer: dataView.buffer
+    // TODO - copy, or create typed array view?
+  });
+  return padToFourBytes(chunkLength);
+}
+function getSafeUint64(dataView, byteOffset, label) {
+  const value = dataView.getBigUint64(byteOffset, LITTLE_ENDIAN);
+  if (value > BigInt(Number.MAX_SAFE_INTEGER)) {
+    throw new Error(`${label} exceeds JavaScript's safe integer range.`);
+  }
+  return Number(value);
+}
+function padToFourBytes(byteLength) {
+  return Math.ceil(byteLength / 4) * 4;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  isGLB,
+  parseGLBSync
+});
+//# sourceMappingURL=parse-glb.cjs.map

package/dist/gltf/lib/parsers/parse-glb.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/gltf/lib/parsers/parse-glb.ts"],
+  "sourcesContent": ["// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\n/* eslint-disable camelcase, max-statements */\n// https://github.com/KhronosGroup/glTF/tree/master/specification/2.0#glb-file-format-specification\n// Draft GLB v3 layout: https://github.com/KhronosGroup/glTF/issues/2594\n// https://github.com/KhronosGroup/glTF/tree/master/extensions/1.0/Khronos/KHR_binary_glTF\nimport type {GLB} from '../types/glb-types';\nimport {assert} from '@loaders.gl/core/loader-utils';\n\n/** Options for parsing a GLB */\nexport type ParseGLBOptions = {\n  /** @deprecated This option was used by XVIZ protocol to define a non-standard magic number */\n  magic?: number;\n  /** @deprecated This option was used by XVIZ protocol to embed non-standard chunks */\n  strict?: boolean;\n};\n\n/** Binary GLTF is little endian. */\nconst LITTLE_ENDIAN = true;\n\n/** 'glTF' in Big-Endian ASCII */\nconst MAGIC_glTF = 0x676c5446;\nconst GLB_V1_V2_FILE_HEADER_SIZE = 12;\nconst GLB_V3_FILE_HEADER_SIZE = 16;\nconst GLB_V1_V2_CHUNK_HEADER_SIZE = 8;\nconst GLB_V3_CHUNK_HEADER_SIZE = 16;\nconst GLB_CHUNK_TYPE_JSON = 0x4e4f534a;\nconst GLB_CHUNK_TYPE_BIN = 0x004e4942;\nconst GLB_V1_CONTENT_FORMAT_JSON = 0x0;\n\n/** @deprecated - Backward compatibility for old xviz files */\nconst GLB_CHUNK_TYPE_JSON_XVIZ_DEPRECATED = 0;\n/** @deprecated - Backward compatibility for old xviz files */\nconst GLB_CHUNK_TYPE_BIX_XVIZ_DEPRECATED = 1;\n\nfunction getMagicString(dataView, byteOffset = 0) {\n  return `\\\n${String.fromCharCode(dataView.getUint8(byteOffset + 0))}\\\n${String.fromCharCode(dataView.getUint8(byteOffset + 1))}\\\n${String.fromCharCode(dataView.getUint8(byteOffset + 2))}\\\n${String.fromCharCode(dataView.getUint8(byteOffset + 3))}`;\n}\n\n/** Check if the contents of an array buffer contains GLB byte markers */\nexport function isGLB(\n  arrayBuffer: ArrayBuffer,\n  byteOffset: number = 0,\n  options: ParseGLBOptions = {}\n): boolean {\n  const dataView = new DataView(arrayBuffer);\n  // Check that GLB Header starts with the magic number\n  const {magic = MAGIC_glTF} = options;\n  const magic1 = dataView.getUint32(byteOffset, false);\n  return magic1 === magic || magic1 === MAGIC_glTF;\n}\n\n/**\n * Synchronously parse a GLB\n * @param glb - Target, Output is stored there\n * @param arrayBuffer - Input data\n * @param byteOffset - Offset into arrayBuffer to start parsing from (for \"embedded\" GLBs, e.g. in 3D tiles)\n * @param options\n * @returns\n */\nexport function parseGLBSync(\n  glb: GLB,\n  arrayBuffer: ArrayBuffer,\n  byteOffset: number = 0,\n  options: ParseGLBOptions = {}\n) {\n  // Check that GLB Header starts with the magic number\n  const dataView = new DataView(arrayBuffer);\n\n  // Compare format with GLBLoader documentation\n  const type = getMagicString(dataView, byteOffset + 0);\n  const version = dataView.getUint32(byteOffset + 4, LITTLE_ENDIAN);\n  const byteLength =\n    version === 3\n      ? getSafeUint64(dataView, byteOffset + 8, 'GLB byte length')\n      : dataView.getUint32(byteOffset + 8, LITTLE_ENDIAN);\n\n  Object.assign(glb, {\n    // Put less important stuff in a header, to avoid clutter\n    header: {\n      byteOffset, // Byte offset into the initial arrayBuffer\n      byteLength,\n      hasBinChunk: false\n    },\n\n    type,\n    version,\n\n    json: {},\n    jsonChunkIndex: -1,\n    binChunks: []\n  } as GLB);\n\n  switch (glb.version) {\n    case 1:\n      return parseGLBV1(glb, dataView, byteOffset + GLB_V1_V2_FILE_HEADER_SIZE);\n    case 2:\n      return parseGLBV2(glb, dataView, byteOffset + GLB_V1_V2_FILE_HEADER_SIZE, options);\n    case 3:\n      return parseGLBV3(glb, dataView, byteOffset + GLB_V3_FILE_HEADER_SIZE, options);\n    default:\n      throw new Error(`Invalid GLB version ${glb.version}. Only supports versions 1, 2 and 3.`);\n  }\n}\n\n/**\n * Parse a V1 GLB\n * @param glb - target, output is stored in this object\n * @param dataView - Input, memory to be parsed\n * @param byteOffset - Offset of first byte of GLB data in the data view\n * @returns Number of bytes parsed (there could be additional non-GLB data after the GLB)\n */\nfunction parseGLBV1(glb: GLB, dataView: DataView, byteOffset: number): number {\n  // Sanity: ensure file is big enough to hold at least the headers\n  assert(glb.header.byteLength > GLB_V1_V2_FILE_HEADER_SIZE + GLB_V1_V2_CHUNK_HEADER_SIZE);\n  const fileEndByteOffset = glb.header.byteOffset + glb.header.byteLength;\n  assert(fileEndByteOffset <= dataView.byteLength);\n\n  // Explanation of GLB structure:\n  // https://cloud.githubusercontent.com/assets/3479527/22600725/36b87122-ea55-11e6-9d40-6fd42819fcab.png\n  const contentLength = dataView.getUint32(byteOffset + 0, LITTLE_ENDIAN); // Byte length of chunk\n  const contentFormat = dataView.getUint32(byteOffset + 4, LITTLE_ENDIAN); // Chunk format as uint32\n  byteOffset += GLB_V1_V2_CHUNK_HEADER_SIZE;\n\n  // GLB v1 only supports a single chunk type\n  assert(contentFormat === GLB_V1_CONTENT_FORMAT_JSON);\n  if (byteOffset + contentLength > fileEndByteOffset) {\n    throw new Error('GLB JSON content extends beyond the declared file length.');\n  }\n\n  parseJSONChunk(glb, dataView, byteOffset, contentLength, 0);\n  // No need to call the function padToBytes() from parseJSONChunk()\n  byteOffset += contentLength;\n  const bodyByteLength = fileEndByteOffset - byteOffset;\n  if (bodyByteLength > 0) {\n    parseBINChunk(glb, dataView, byteOffset, bodyByteLength, 1);\n  }\n\n  return fileEndByteOffset;\n}\n\n/**\n * Parse a V2 GLB\n * @param glb - target, output is stored in this object\n * @param dataView - Input, memory to be parsed\n * @param byteOffset - Offset of first byte of GLB data in the data view\n * @returns Number of bytes parsed (there could be additional non-GLB data after the GLB)\n */\nfunction parseGLBV2(\n  glb: GLB,\n  dataView: DataView,\n  byteOffset: number,\n  options: ParseGLBOptions\n): number {\n  // Sanity: ensure file is big enough to hold at least the first chunk header\n  assert(glb.header.byteLength > GLB_V1_V2_FILE_HEADER_SIZE + GLB_V1_V2_CHUNK_HEADER_SIZE);\n\n  parseGLBChunksSync(glb, dataView, byteOffset, GLB_V1_V2_CHUNK_HEADER_SIZE, options);\n\n  return glb.header.byteOffset + glb.header.byteLength;\n}\n\n/** Parse a draft V3 GLB with 64-bit file and chunk lengths. */\nfunction parseGLBV3(\n  glb: GLB,\n  dataView: DataView,\n  byteOffset: number,\n  options: ParseGLBOptions\n): number {\n  assert(glb.header.byteLength >= GLB_V3_FILE_HEADER_SIZE + GLB_V3_CHUNK_HEADER_SIZE);\n\n  parseGLBChunksSync(glb, dataView, byteOffset, GLB_V3_CHUNK_HEADER_SIZE, options);\n\n  return glb.header.byteOffset + glb.header.byteLength;\n}\n\n/** Iterate over GLB chunks and parse them */\nfunction parseGLBChunksSync(\n  glb: GLB,\n  dataView: DataView,\n  byteOffset: number,\n  chunkHeaderSize: number,\n  options: ParseGLBOptions\n) {\n  const fileEndByteOffset = glb.header.byteOffset + glb.header.byteLength;\n  assert(fileEndByteOffset <= dataView.byteLength);\n  let chunkIndex = 0;\n\n  // Per spec we must iterate over chunks, ignoring all except JSON and BIN\n  // Iterate as long as there is space left for another chunk header\n  while (byteOffset + chunkHeaderSize <= fileEndByteOffset) {\n    const isVersion3 = glb.version === 3;\n    const chunkFormat = dataView.getUint32(byteOffset + (isVersion3 ? 0 : 4), LITTLE_ENDIAN);\n    const chunkEncoding = isVersion3 ? dataView.getUint32(byteOffset + 4, LITTLE_ENDIAN) : 0;\n    const chunkLength = isVersion3\n      ? getSafeUint64(dataView, byteOffset + 8, 'GLB chunk length')\n      : dataView.getUint32(byteOffset + 0, LITTLE_ENDIAN);\n    byteOffset += chunkHeaderSize;\n\n    if (chunkEncoding !== 0) {\n      throw new Error(`Unsupported GLB chunk encoding ${chunkEncoding}.`);\n    }\n    if (byteOffset + chunkLength > fileEndByteOffset) {\n      throw new Error('GLB chunk extends beyond the declared file length.');\n    }\n\n    // Per spec we must iterate over chunks, ignoring all except JSON and BIN\n    switch (chunkFormat) {\n      case GLB_CHUNK_TYPE_JSON:\n        // GLB v3 defines the first JSON chunk as the glTF JSON chunk.\n        if (glb.version !== 3 || glb.jsonChunkIndex === -1) {\n          parseJSONChunk(glb, dataView, byteOffset, chunkLength, chunkIndex);\n        }\n        break;\n      case GLB_CHUNK_TYPE_BIN:\n        parseBINChunk(glb, dataView, byteOffset, chunkLength, chunkIndex);\n        break;\n\n      // Backward compatibility for very old xviz files\n      case GLB_CHUNK_TYPE_JSON_XVIZ_DEPRECATED:\n        if (!options.strict) {\n          parseJSONChunk(glb, dataView, byteOffset, chunkLength, chunkIndex);\n        }\n        break;\n      case GLB_CHUNK_TYPE_BIX_XVIZ_DEPRECATED:\n        if (!options.strict) {\n          parseBINChunk(glb, dataView, byteOffset, chunkLength, chunkIndex);\n        }\n        break;\n\n      default:\n        // Ignore, per spec\n        // console.warn(`Unknown GLB chunk type`); // eslint-disable-line\n        break;\n    }\n\n    byteOffset += padToFourBytes(chunkLength);\n    chunkIndex++;\n  }\n\n  return byteOffset;\n}\n\n/* Parse a GLB JSON chunk */\nfunction parseJSONChunk(\n  glb: GLB,\n  dataView: DataView,\n  byteOffset: number,\n  chunkLength: number,\n  chunkIndex: number\n) {\n  // 1. Create a \"view\" of the binary encoded JSON data inside the GLB\n  const jsonChunk = new Uint8Array(dataView.buffer, byteOffset, chunkLength);\n\n  // 2. Decode the JSON binary array into clear text\n  const textDecoder = new TextDecoder('utf8');\n  const jsonText = textDecoder.decode(jsonChunk);\n\n  // 3. Parse the JSON text into a JavaScript data structure\n  glb.json = JSON.parse(jsonText);\n  glb.jsonChunkIndex = chunkIndex;\n\n  return padToFourBytes(chunkLength);\n}\n\n/** Parse a GLB BIN chunk */\nfunction parseBINChunk(glb: GLB, dataView, byteOffset, chunkLength, chunkIndex: number) {\n  // Note: BIN chunk can be optional\n  glb.header.hasBinChunk = true;\n  glb.binChunks.push({\n    chunkIndex,\n    byteOffset,\n    byteLength: chunkLength,\n    arrayBuffer: dataView.buffer\n    // TODO - copy, or create typed array view?\n  });\n\n  return padToFourBytes(chunkLength);\n}\n\n/** Read a uint64 that can be represented exactly by JavaScript offsets and lengths. */\nfunction getSafeUint64(dataView: DataView, byteOffset: number, label: string): number {\n  const value = dataView.getBigUint64(byteOffset, LITTLE_ENDIAN);\n  if (value > BigInt(Number.MAX_SAFE_INTEGER)) {\n    throw new Error(`${label} exceeds JavaScript's safe integer range.`);\n  }\n  return Number(value);\n}\n\n/** Round a byte length up to the four-byte alignment required by GLB chunks. */\nfunction padToFourBytes(byteLength: number): number {\n  return Math.ceil(byteLength / 4) * 4;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,20 @@
+import type { GLB } from "../types/glb-types.js";
+/** 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;
+};
+/** 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/gltf/lib/parsers/parse-glb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-glb.d.ts","sourceRoot":"","sources":["../../../../src/gltf/lib/parsers/parse-glb.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAC,GAAG,EAAC,8BAA2B;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;AA4BF,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,UAuC9B"}

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

@@ -0,0 +1,216 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { assert } from '@loaders.gl/core/loader-utils';
+/** Binary GLTF is little endian. */
+const LITTLE_ENDIAN = true;
+/** 'glTF' in Big-Endian ASCII */
+const MAGIC_glTF = 0x676c5446;
+const GLB_V1_V2_FILE_HEADER_SIZE = 12;
+const GLB_V3_FILE_HEADER_SIZE = 16;
+const GLB_V1_V2_CHUNK_HEADER_SIZE = 8;
+const GLB_V3_CHUNK_HEADER_SIZE = 16;
+const GLB_CHUNK_TYPE_JSON = 0x4e4f534a;
+const GLB_CHUNK_TYPE_BIN = 0x004e4942;
+const GLB_V1_CONTENT_FORMAT_JSON = 0x0;
+/** @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))}\
+${String.fromCharCode(dataView.getUint8(byteOffset + 1))}\
+${String.fromCharCode(dataView.getUint8(byteOffset + 2))}\
+${String.fromCharCode(dataView.getUint8(byteOffset + 3))}`;
+}
+/** Check if the contents of an array buffer contains GLB byte markers */
+export function isGLB(arrayBuffer, byteOffset = 0, options = {}) {
+    const dataView = new DataView(arrayBuffer);
+    // Check that GLB Header starts with the magic number
+    const { magic = MAGIC_glTF } = options;
+    const magic1 = dataView.getUint32(byteOffset, false);
+    return magic1 === magic || magic1 === MAGIC_glTF;
+}
+/**
+ * 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 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, LITTLE_ENDIAN);
+    const byteLength = version === 3
+        ? getSafeUint64(dataView, byteOffset + 8, 'GLB byte length')
+        : dataView.getUint32(byteOffset + 8, LITTLE_ENDIAN);
+    Object.assign(glb, {
+        // Put less important stuff in a header, to avoid clutter
+        header: {
+            byteOffset, // Byte offset into the initial arrayBuffer
+            byteLength,
+            hasBinChunk: false
+        },
+        type,
+        version,
+        json: {},
+        jsonChunkIndex: -1,
+        binChunks: []
+    });
+    switch (glb.version) {
+        case 1:
+            return parseGLBV1(glb, dataView, byteOffset + GLB_V1_V2_FILE_HEADER_SIZE);
+        case 2:
+            return parseGLBV2(glb, dataView, byteOffset + GLB_V1_V2_FILE_HEADER_SIZE, options);
+        case 3:
+            return parseGLBV3(glb, dataView, byteOffset + GLB_V3_FILE_HEADER_SIZE, options);
+        default:
+            throw new Error(`Invalid GLB version ${glb.version}. Only supports versions 1, 2 and 3.`);
+    }
+}
+/**
+ * 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
+    assert(glb.header.byteLength > GLB_V1_V2_FILE_HEADER_SIZE + GLB_V1_V2_CHUNK_HEADER_SIZE);
+    const fileEndByteOffset = glb.header.byteOffset + glb.header.byteLength;
+    assert(fileEndByteOffset <= dataView.byteLength);
+    // Explanation of GLB structure:
+    // https://cloud.githubusercontent.com/assets/3479527/22600725/36b87122-ea55-11e6-9d40-6fd42819fcab.png
+    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_V1_V2_CHUNK_HEADER_SIZE;
+    // GLB v1 only supports a single chunk type
+    assert(contentFormat === GLB_V1_CONTENT_FORMAT_JSON);
+    if (byteOffset + contentLength > fileEndByteOffset) {
+        throw new Error('GLB JSON content extends beyond the declared file length.');
+    }
+    parseJSONChunk(glb, dataView, byteOffset, contentLength, 0);
+    // No need to call the function padToBytes() from parseJSONChunk()
+    byteOffset += contentLength;
+    const bodyByteLength = fileEndByteOffset - byteOffset;
+    if (bodyByteLength > 0) {
+        parseBINChunk(glb, dataView, byteOffset, bodyByteLength, 1);
+    }
+    return fileEndByteOffset;
+}
+/**
+ * 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
+    assert(glb.header.byteLength > GLB_V1_V2_FILE_HEADER_SIZE + GLB_V1_V2_CHUNK_HEADER_SIZE);
+    parseGLBChunksSync(glb, dataView, byteOffset, GLB_V1_V2_CHUNK_HEADER_SIZE, options);
+    return glb.header.byteOffset + glb.header.byteLength;
+}
+/** Parse a draft V3 GLB with 64-bit file and chunk lengths. */
+function parseGLBV3(glb, dataView, byteOffset, options) {
+    assert(glb.header.byteLength >= GLB_V3_FILE_HEADER_SIZE + GLB_V3_CHUNK_HEADER_SIZE);
+    parseGLBChunksSync(glb, dataView, byteOffset, GLB_V3_CHUNK_HEADER_SIZE, options);
+    return glb.header.byteOffset + glb.header.byteLength;
+}
+/** Iterate over GLB chunks and parse them */
+function parseGLBChunksSync(glb, dataView, byteOffset, chunkHeaderSize, options) {
+    const fileEndByteOffset = glb.header.byteOffset + glb.header.byteLength;
+    assert(fileEndByteOffset <= dataView.byteLength);
+    let chunkIndex = 0;
+    // 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 + chunkHeaderSize <= fileEndByteOffset) {
+        const isVersion3 = glb.version === 3;
+        const chunkFormat = dataView.getUint32(byteOffset + (isVersion3 ? 0 : 4), LITTLE_ENDIAN);
+        const chunkEncoding = isVersion3 ? dataView.getUint32(byteOffset + 4, LITTLE_ENDIAN) : 0;
+        const chunkLength = isVersion3
+            ? getSafeUint64(dataView, byteOffset + 8, 'GLB chunk length')
+            : dataView.getUint32(byteOffset + 0, LITTLE_ENDIAN);
+        byteOffset += chunkHeaderSize;
+        if (chunkEncoding !== 0) {
+            throw new Error(`Unsupported GLB chunk encoding ${chunkEncoding}.`);
+        }
+        if (byteOffset + chunkLength > fileEndByteOffset) {
+            throw new Error('GLB chunk extends beyond the declared file length.');
+        }
+        // Per spec we must iterate over chunks, ignoring all except JSON and BIN
+        switch (chunkFormat) {
+            case GLB_CHUNK_TYPE_JSON:
+                // GLB v3 defines the first JSON chunk as the glTF JSON chunk.
+                if (glb.version !== 3 || glb.jsonChunkIndex === -1) {
+                    parseJSONChunk(glb, dataView, byteOffset, chunkLength, chunkIndex);
+                }
+                break;
+            case GLB_CHUNK_TYPE_BIN:
+                parseBINChunk(glb, dataView, byteOffset, chunkLength, chunkIndex);
+                break;
+            // Backward compatibility for very old xviz files
+            case GLB_CHUNK_TYPE_JSON_XVIZ_DEPRECATED:
+                if (!options.strict) {
+                    parseJSONChunk(glb, dataView, byteOffset, chunkLength, chunkIndex);
+                }
+                break;
+            case GLB_CHUNK_TYPE_BIX_XVIZ_DEPRECATED:
+                if (!options.strict) {
+                    parseBINChunk(glb, dataView, byteOffset, chunkLength, chunkIndex);
+                }
+                break;
+            default:
+                // Ignore, per spec
+                // console.warn(`Unknown GLB chunk type`); // eslint-disable-line
+                break;
+        }
+        byteOffset += padToFourBytes(chunkLength);
+        chunkIndex++;
+    }
+    return byteOffset;
+}
+/* Parse a GLB JSON chunk */
+function parseJSONChunk(glb, dataView, byteOffset, chunkLength, chunkIndex) {
+    // 1. Create a "view" of the binary encoded JSON data inside the GLB
+    const jsonChunk = new Uint8Array(dataView.buffer, byteOffset, chunkLength);
+    // 2. Decode the JSON binary array into clear text
+    const textDecoder = new TextDecoder('utf8');
+    const jsonText = textDecoder.decode(jsonChunk);
+    // 3. Parse the JSON text into a JavaScript data structure
+    glb.json = JSON.parse(jsonText);
+    glb.jsonChunkIndex = chunkIndex;
+    return padToFourBytes(chunkLength);
+}
+/** Parse a GLB BIN chunk */
+function parseBINChunk(glb, dataView, byteOffset, chunkLength, chunkIndex) {
+    // Note: BIN chunk can be optional
+    glb.header.hasBinChunk = true;
+    glb.binChunks.push({
+        chunkIndex,
+        byteOffset,
+        byteLength: chunkLength,
+        arrayBuffer: dataView.buffer
+        // TODO - copy, or create typed array view?
+    });
+    return padToFourBytes(chunkLength);
+}
+/** Read a uint64 that can be represented exactly by JavaScript offsets and lengths. */
+function getSafeUint64(dataView, byteOffset, label) {
+    const value = dataView.getBigUint64(byteOffset, LITTLE_ENDIAN);
+    if (value > BigInt(Number.MAX_SAFE_INTEGER)) {
+        throw new Error(`${label} exceeds JavaScript's safe integer range.`);
+    }
+    return Number(value);
+}
+/** Round a byte length up to the four-byte alignment required by GLB chunks. */
+function padToFourBytes(byteLength) {
+    return Math.ceil(byteLength / 4) * 4;
+}
+//# sourceMappingURL=parse-glb.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse-glb.js","sourceRoot":"","sources":["../../../../src/gltf/lib/parsers/parse-glb.ts"],"names":[],"mappings":"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"}