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

package/dist/gltf/lib/extensions/KHR_binary_gltf.cjs

@@ -0,0 +1,53 @@
+"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 name2 in all)
+    __defProp(target, name2, { get: all[name2], 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/extensions/KHR_binary_gltf.ts
+var KHR_binary_gltf_exports = {};
+__export(KHR_binary_gltf_exports, {
+  name: () => name,
+  preprocess: () => preprocess
+});
+module.exports = __toCommonJS(KHR_binary_gltf_exports);
+var import_gltf_iterator = require("../api/gltf-iterator.cjs");
+var KHR_BINARY_GLTF = "KHR_binary_glTF";
+var name = KHR_BINARY_GLTF;
+function preprocess(gltfData) {
+  const iterator = new import_gltf_iterator.GLTFIterator(gltfData);
+  for (const image of iterator.images) {
+    const extension = iterator.getExtension(image, KHR_BINARY_GLTF);
+    if (extension) {
+      image.bufferView = extension.bufferView;
+      image.mimeType = extension.mimeType;
+      delete image.uri;
+    }
+    iterator.removeExtension(image, KHR_BINARY_GLTF);
+  }
+  for (const buffer of iterator.data.buffers || []) {
+    if (buffer.id === "binary_glTF") {
+      delete buffer.uri;
+    }
+  }
+  iterator.removeExtension(KHR_BINARY_GLTF);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  name,
+  preprocess
+});
+//# sourceMappingURL=KHR_binary_gltf.cjs.map

package/dist/gltf/lib/extensions/KHR_binary_gltf.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/gltf/lib/extensions/KHR_binary_gltf.ts"],
+  "sourcesContent": ["// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\n// GLTF 1.0 EXTENSION: KHR_binary_glTF\n// https://github.com/KhronosGroup/glTF/tree/master/extensions/1.0/Khronos/KHR_binary_glTF\n/* eslint-disable camelcase */\n\nimport type {GLTF_KHR_binary_glTF} from '../types/gltf-json-schema';\nimport type {GLTFWithBuffers} from '../types/gltf-types';\n\nimport {GLTFIterator} from '../api/gltf-iterator';\n\nconst KHR_BINARY_GLTF = 'KHR_binary_glTF';\n\n/** Extension name */\nexport const name = KHR_BINARY_GLTF;\n\n/** Convert embedded glTF 1 images and the named binary body to core glTF 2 fields. */\nexport function preprocess(gltfData: GLTFWithBuffers): void {\n  const iterator = new GLTFIterator(gltfData);\n\n  // Note: json.buffers.binary_glTF also needs to be replaced\n  // This is currently done during gltf normalization\n\n  // Image and shader nodes can have the extension\n  // https://github.com/KhronosGroup/glTF/blob/master/extensions/1.0/Khronos/KHR_binary_glTF/schema/image.KHR_binary_glTF.schema.json\n  for (const image of iterator.images) {\n    const extension = iterator.getExtension<GLTF_KHR_binary_glTF>(image, KHR_BINARY_GLTF);\n    // Copy core image fields, omitting extension-only dimensions.\n    if (extension) {\n      image.bufferView = extension.bufferView;\n      image.mimeType = extension.mimeType;\n      delete image.uri;\n    }\n    iterator.removeExtension(image, KHR_BINARY_GLTF);\n  }\n\n  // TODO shaders - At least traverse and throw error if used?\n  // https://github.com/KhronosGroup/glTF/blob/master/extensions/1.0/Khronos/KHR_binary_glTF/schema/shader.KHR_binary_glTF.schema.json\n\n  // Only the reserved GLB body has an ignored URI; external buffers retain theirs.\n  for (const buffer of iterator.data.buffers || []) {\n    if ((buffer as typeof buffer & {id?: string}).id === 'binary_glTF') {\n      delete buffer.uri;\n    }\n  }\n\n  // Remove the top-level extension as it has now been processed\n  iterator.removeExtension(KHR_BINARY_GLTF);\n}\n\n// KHR_binary_gltf is a 1.0 extension that is supported natively by 2.0\n// export function encode() {\n//   throw new Error(KHR_BINARY_GLTF);\n// }\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAWA,2BAA2B;AAE3B,IAAM,kBAAkB;AAGjB,IAAM,OAAO;AAGb,SAAS,WAAW,UAAiC;AAC1D,QAAM,WAAW,IAAI,kCAAa,QAAQ;AAO1C,aAAW,SAAS,SAAS,QAAQ;AACnC,UAAM,YAAY,SAAS,aAAmC,OAAO,eAAe;AAEpF,QAAI,WAAW;AACb,YAAM,aAAa,UAAU;AAC7B,YAAM,WAAW,UAAU;AAC3B,aAAO,MAAM;AAAA,IACf;AACA,aAAS,gBAAgB,OAAO,eAAe;AAAA,EACjD;AAMA,aAAW,UAAU,SAAS,KAAK,WAAW,CAAC,GAAG;AAChD,QAAK,OAAyC,OAAO,eAAe;AAClE,aAAO,OAAO;AAAA,IAChB;AAAA,EACF;AAGA,WAAS,gBAAgB,eAAe;AAC1C;",
+  "names": []
+}

package/dist/gltf/lib/extensions/KHR_binary_gltf.d.ts

@@ -0,0 +1,6 @@
+import type { GLTFWithBuffers } from "../types/gltf-types.js";
+/** Extension name */
+export declare const name = "KHR_binary_glTF";
+/** Convert embedded glTF 1 images and the named binary body to core glTF 2 fields. */
+export declare function preprocess(gltfData: GLTFWithBuffers): void;
+//# sourceMappingURL=KHR_binary_gltf.d.ts.map

package/dist/gltf/lib/extensions/KHR_binary_gltf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KHR_binary_gltf.d.ts","sourceRoot":"","sources":["../../../../src/gltf/lib/extensions/KHR_binary_gltf.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAC,eAAe,EAAC,+BAA4B;AAMzD,qBAAqB;AACrB,eAAO,MAAM,IAAI,oBAAkB,CAAC;AAEpC,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CA+B1D"}

package/dist/gltf/lib/extensions/KHR_binary_gltf.js

@@ -0,0 +1,40 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { GLTFIterator } from "../api/gltf-iterator.js";
+const KHR_BINARY_GLTF = 'KHR_binary_glTF';
+/** Extension name */
+export const name = KHR_BINARY_GLTF;
+/** Convert embedded glTF 1 images and the named binary body to core glTF 2 fields. */
+export function preprocess(gltfData) {
+    const iterator = new GLTFIterator(gltfData);
+    // Note: json.buffers.binary_glTF also needs to be replaced
+    // This is currently done during gltf normalization
+    // Image and shader nodes can have the extension
+    // https://github.com/KhronosGroup/glTF/blob/master/extensions/1.0/Khronos/KHR_binary_glTF/schema/image.KHR_binary_glTF.schema.json
+    for (const image of iterator.images) {
+        const extension = iterator.getExtension(image, KHR_BINARY_GLTF);
+        // Copy core image fields, omitting extension-only dimensions.
+        if (extension) {
+            image.bufferView = extension.bufferView;
+            image.mimeType = extension.mimeType;
+            delete image.uri;
+        }
+        iterator.removeExtension(image, KHR_BINARY_GLTF);
+    }
+    // TODO shaders - At least traverse and throw error if used?
+    // https://github.com/KhronosGroup/glTF/blob/master/extensions/1.0/Khronos/KHR_binary_glTF/schema/shader.KHR_binary_glTF.schema.json
+    // Only the reserved GLB body has an ignored URI; external buffers retain theirs.
+    for (const buffer of iterator.data.buffers || []) {
+        if (buffer.id === 'binary_glTF') {
+            delete buffer.uri;
+        }
+    }
+    // Remove the top-level extension as it has now been processed
+    iterator.removeExtension(KHR_BINARY_GLTF);
+}
+// KHR_binary_gltf is a 1.0 extension that is supported natively by 2.0
+// export function encode() {
+//   throw new Error(KHR_BINARY_GLTF);
+// }
+//# sourceMappingURL=KHR_binary_gltf.js.map

package/dist/gltf/lib/extensions/KHR_binary_gltf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KHR_binary_gltf.js","sourceRoot":"","sources":["../../../../src/gltf/lib/extensions/KHR_binary_gltf.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AASpC,OAAO,EAAC,YAAY,EAAC,gCAA6B;AAElD,MAAM,eAAe,GAAG,iBAAiB,CAAC;AAE1C,qBAAqB;AACrB,MAAM,CAAC,MAAM,IAAI,GAAG,eAAe,CAAC;AAEpC,sFAAsF;AACtF,MAAM,UAAU,UAAU,CAAC,QAAyB;IAClD,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC;IAE5C,2DAA2D;IAC3D,mDAAmD;IAEnD,gDAAgD;IAChD,mIAAmI;IACnI,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,QAAQ,CAAC,YAAY,CAAuB,KAAK,EAAE,eAAe,CAAC,CAAC;QACtF,8DAA8D;QAC9D,IAAI,SAAS,EAAE,CAAC;YACd,KAAK,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU,CAAC;YACxC,KAAK,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;YACpC,OAAO,KAAK,CAAC,GAAG,CAAC;QACnB,CAAC;QACD,QAAQ,CAAC,eAAe,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;IACnD,CAAC;IAED,4DAA4D;IAC5D,oIAAoI;IAEpI,iFAAiF;IACjF,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;QACjD,IAAK,MAAwC,CAAC,EAAE,KAAK,aAAa,EAAE,CAAC;YACnE,OAAO,MAAM,CAAC,GAAG,CAAC;QACpB,CAAC;IACH,CAAC;IAED,8DAA8D;IAC9D,QAAQ,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;AAC5C,CAAC;AAED,uEAAuE;AACvE,6BAA6B;AAC7B,sCAAsC;AACtC,IAAI"}

package/dist/gltf/lib/extensions/KHR_draco_mesh_compression.cjs

@@ -0,0 +1,131 @@
+"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 name2 in all)
+    __defProp(target, name2, { get: all[name2], 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/extensions/KHR_draco_mesh_compression.ts
+var KHR_draco_mesh_compression_exports = {};
+__export(KHR_draco_mesh_compression_exports, {
+  decode: () => decode,
+  name: () => name,
+  preprocess: () => preprocess
+});
+module.exports = __toCommonJS(KHR_draco_mesh_compression_exports);
+var import_loader_utils = require("@loaders.gl/core/loader-utils");
+var import_draco = require("@loaders.gl/draco");
+var import_gltf_iterator = require("../api/gltf-iterator.cjs");
+var import_gltf_attribute_utils = require("../gltf-utils/gltf-attribute-utils.cjs");
+var import_get_typed_array = require("../gltf-utils/get-typed-array.cjs");
+var KHR_DRACO_MESH_COMPRESSION = "KHR_draco_mesh_compression";
+var name = KHR_DRACO_MESH_COMPRESSION;
+function preprocess(gltfData, options, context) {
+  const iterator = new import_gltf_iterator.GLTFIterator(gltfData);
+  for (const mesh of iterator.meshes) {
+    for (const primitive of iterator.getReferences(mesh).primitives) {
+      if (iterator.getExtension(primitive, KHR_DRACO_MESH_COMPRESSION)) {
+      }
+    }
+  }
+}
+async function decode(gltfData, options, context) {
+  if (!options?.gltf?.decompressMeshes) {
+    return;
+  }
+  const iterator = new import_gltf_iterator.GLTFIterator(gltfData);
+  const promises = [];
+  for (const mesh of iterator.meshes) {
+    for (const primitive of iterator.getReferences(mesh).primitives) {
+      if (iterator.getExtension(primitive, KHR_DRACO_MESH_COMPRESSION)) {
+        promises.push(decompressPrimitive(iterator, primitive, options, context));
+      }
+    }
+  }
+  await Promise.all(promises);
+  iterator.removeExtension(KHR_DRACO_MESH_COMPRESSION);
+}
+async function decompressPrimitive(iterator, primitive, options, context) {
+  const dracoExtension = iterator.getExtension(
+    primitive,
+    KHR_DRACO_MESH_COMPRESSION
+  );
+  if (!dracoExtension) {
+    return;
+  }
+  const buffer = (0, import_get_typed_array.getTypedArrayForBufferView)(
+    iterator.data,
+    iterator.gltf.buffers,
+    dracoExtension.bufferView
+  );
+  const compressedData = (0, import_loader_utils.sliceArrayBuffer)(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+  const dracoOptions = {
+    ...options,
+    draco: {
+      ...options.draco,
+      // Internal glTF decoding consumes the legacy mesh contract.
+      shape: "mesh",
+      // Normalize compressed strips to the triangle indices returned below.
+      topology: "triangle-list",
+      decoderProfile: options.draco?.decoderProfile || "gltf",
+      extraAttributes: dracoExtension.attributes
+    }
+  };
+  delete dracoOptions["3d-tiles"];
+  const decodedData = await (0, import_loader_utils.parseFromContext)(
+    compressedData,
+    import_draco.DracoLoader,
+    dracoOptions,
+    context
+  );
+  const decodedAttributes = (0, import_gltf_attribute_utils.getGLTFAccessors)(decodedData.attributes);
+  for (const attributeName of Object.keys(dracoExtension.attributes)) {
+    if (!Object.hasOwn(decodedAttributes, attributeName)) {
+      throw new Error(`glTF: Draco decompression did not produce attribute ${attributeName}`);
+    }
+  }
+  for (const [attributeName, decodedAttribute] of Object.entries(decodedAttributes)) {
+    if (attributeName in primitive.attributes) {
+      const accessorIndex = primitive.attributes[attributeName];
+      const accessor = iterator.data.accessors?.[accessorIndex];
+      if (accessor?.normalized !== void 0) {
+        decodedAttribute.normalized = accessor.normalized;
+      }
+      if (accessor?.min && accessor?.max) {
+        decodedAttribute.min = accessor.min;
+        decodedAttribute.max = accessor.max;
+      }
+    }
+  }
+  primitive.attributes = { ...primitive.attributes, ...decodedAttributes };
+  if (decodedData.indices) {
+    primitive.indices = (0, import_gltf_attribute_utils.getGLTFAccessor)(decodedData.indices);
+    primitive.mode = 4;
+  }
+  iterator.removeExtension(primitive, KHR_DRACO_MESH_COMPRESSION);
+  checkPrimitive(primitive);
+}
+function checkPrimitive(primitive) {
+  if (!primitive.attributes || Object.keys(primitive.attributes).length === 0) {
+    throw new Error("glTF: Empty primitive detected: Draco decompression failure?");
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  decode,
+  name,
+  preprocess
+});
+//# sourceMappingURL=KHR_draco_mesh_compression.cjs.map

package/dist/gltf/lib/extensions/KHR_draco_mesh_compression.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/gltf/lib/extensions/KHR_draco_mesh_compression.ts"],
+  "sourcesContent": ["// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\n// https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Khronos/KHR_draco_mesh_compression\n// Only TRIANGLES: 0x0004 and TRIANGLE_STRIP: 0x0005 are supported\n/* eslint-disable camelcase */\n\nimport type {LoaderContext} from '@loaders.gl/core/loader-utils';\nimport {sliceArrayBuffer, parseFromContext} from '@loaders.gl/core/loader-utils';\n\nimport {DracoLoader, DracoLoaderOptions, type DracoMesh} from '@loaders.gl/draco';\n\nimport type {\n  GLTFWithBuffers,\n  GLTFAccessor,\n  GLTFMeshPrimitive,\n  GLTF_KHR_draco_mesh_compression\n} from '../types/gltf-types';\nimport type {GLTFLoaderOptions} from '../../gltf-loader-types';\n\nimport {GLTFIterator} from '../api/gltf-iterator';\nimport {getGLTFAccessors, getGLTFAccessor} from '../gltf-utils/gltf-attribute-utils';\nimport {getTypedArrayForBufferView} from '../gltf-utils/get-typed-array';\n\nconst KHR_DRACO_MESH_COMPRESSION = 'KHR_draco_mesh_compression';\n\n/** Extension name */\nexport const name = KHR_DRACO_MESH_COMPRESSION;\n\nexport function preprocess(\n  gltfData: GLTFWithBuffers,\n  options: GLTFLoaderOptions,\n  context: LoaderContext\n): void {\n  const iterator = new GLTFIterator(gltfData);\n  for (const mesh of iterator.meshes) {\n    for (const primitive of iterator.getReferences(mesh).primitives) {\n      if (iterator.getExtension(primitive, KHR_DRACO_MESH_COMPRESSION)) {\n        // TODO - Remove fallback accessors to make sure we don't load unnecessary buffers\n      }\n    }\n  }\n}\n\nexport async function decode(\n  gltfData: GLTFWithBuffers,\n  options: GLTFLoaderOptions,\n  context: LoaderContext\n): Promise<void> {\n  if (!options?.gltf?.decompressMeshes) {\n    return;\n  }\n\n  const iterator = new GLTFIterator(gltfData);\n  const promises: Promise<void>[] = [];\n  for (const mesh of iterator.meshes) {\n    for (const primitive of iterator.getReferences(mesh).primitives) {\n      if (iterator.getExtension(primitive, KHR_DRACO_MESH_COMPRESSION)) {\n        promises.push(decompressPrimitive(iterator, primitive, options, context));\n      }\n    }\n  }\n\n  // Decompress meshes in parallel\n  await Promise.all(promises);\n\n  // We have now decompressed all primitives, so remove the top-level extension\n  iterator.removeExtension(KHR_DRACO_MESH_COMPRESSION);\n}\n\n// DECODE\n\n// Unpacks one mesh primitive and removes the extension from the primitive\n// DracoDecoder needs to be imported and registered by app\n// Returns: Promise that resolves when all pending draco decoder jobs for this mesh complete\n\n// TODO - Implement fallback behavior per KHR_DRACO_MESH_COMPRESSION spec\n\nasync function decompressPrimitive(\n  iterator: GLTFIterator,\n  primitive: GLTFMeshPrimitive,\n  options: GLTFLoaderOptions,\n  context: LoaderContext\n): Promise<void> {\n  const dracoExtension = iterator.getExtension<GLTF_KHR_draco_mesh_compression>(\n    primitive,\n    KHR_DRACO_MESH_COMPRESSION\n  );\n  if (!dracoExtension) {\n    return;\n  }\n\n  const buffer = getTypedArrayForBufferView(\n    iterator.data,\n    iterator.gltf.buffers,\n    dracoExtension.bufferView\n  );\n  // A decoder worker can transfer its input, so it must not own the shared glTF buffer.\n  const compressedData = sliceArrayBuffer(buffer.buffer, buffer.byteOffset, buffer.byteLength);\n\n  const dracoOptions: DracoLoaderOptions = {\n    ...options,\n    draco: {\n      ...options.draco,\n      // Internal glTF decoding consumes the legacy mesh contract.\n      shape: 'mesh',\n      // Normalize compressed strips to the triangle indices returned below.\n      topology: 'triangle-list',\n      decoderProfile: options.draco?.decoderProfile || 'gltf',\n      extraAttributes: dracoExtension.attributes\n    }\n  };\n\n  // TODO - remove hack: The entire tileset might be included, too expensive to serialize\n  delete dracoOptions['3d-tiles'];\n  const decodedData = (await parseFromContext(\n    compressedData,\n    DracoLoader,\n    dracoOptions,\n    context\n  )) as DracoMesh;\n\n  const decodedAttributes: {[key: string]: GLTFAccessor} = getGLTFAccessors(decodedData.attributes);\n\n  // A declared compressed attribute cannot fall back to its raw accessor: it may have no buffer view.\n  for (const attributeName of Object.keys(dracoExtension.attributes)) {\n    if (!Object.hasOwn(decodedAttributes, attributeName)) {\n      throw new Error(`glTF: Draco decompression did not produce attribute ${attributeName}`);\n    }\n  }\n\n  // Restore accessor bounds and integer normalization from the glTF declaration.\n  for (const [attributeName, decodedAttribute] of Object.entries(decodedAttributes)) {\n    if (attributeName in primitive.attributes) {\n      const accessorIndex: number = primitive.attributes[attributeName];\n      const accessor = iterator.data.accessors?.[accessorIndex];\n      if (accessor?.normalized !== undefined) {\n        decodedAttribute.normalized = accessor.normalized;\n      }\n      if (accessor?.min && accessor?.max) {\n        decodedAttribute.min = accessor.min;\n        decodedAttribute.max = accessor.max;\n      }\n    }\n  }\n\n  // Attributes outside the Draco bitstream still reference ordinary glTF accessors.\n  // @ts-ignore\n  primitive.attributes = {...primitive.attributes, ...decodedAttributes};\n  if (decodedData.indices) {\n    // @ts-ignore\n    primitive.indices = getGLTFAccessor(decodedData.indices);\n    primitive.mode = 4;\n  }\n\n  // Extension has been processed, delete it\n  iterator.removeExtension(primitive, KHR_DRACO_MESH_COMPRESSION);\n\n  checkPrimitive(primitive);\n}\n\n// UTILS\n\nfunction checkPrimitive(primitive: GLTFMeshPrimitive): void {\n  if (!primitive.attributes || Object.keys(primitive.attributes).length === 0) {\n    throw new Error('glTF: Empty primitive detected: Draco decompression failure?');\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/gltf/lib/extensions/KHR_draco_mesh_compression.d.ts

@@ -0,0 +1,8 @@
+import type { LoaderContext } from '@loaders.gl/core/loader-utils';
+import type { GLTFWithBuffers } from "../types/gltf-types.js";
+import type { GLTFLoaderOptions } from "../../gltf-loader-types.js";
+/** Extension name */
+export declare const name = "KHR_draco_mesh_compression";
+export declare function preprocess(gltfData: GLTFWithBuffers, options: GLTFLoaderOptions, context: LoaderContext): void;
+export declare function decode(gltfData: GLTFWithBuffers, options: GLTFLoaderOptions, context: LoaderContext): Promise<void>;
+//# sourceMappingURL=KHR_draco_mesh_compression.d.ts.map

package/dist/gltf/lib/extensions/KHR_draco_mesh_compression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KHR_draco_mesh_compression.d.ts","sourceRoot":"","sources":["../../../../src/gltf/lib/extensions/KHR_draco_mesh_compression.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,+BAA+B,CAAC;AAKjE,OAAO,KAAK,EACV,eAAe,EAIhB,+BAA4B;AAC7B,OAAO,KAAK,EAAC,iBAAiB,EAAC,mCAAgC;AAQ/D,qBAAqB;AACrB,eAAO,MAAM,IAAI,+BAA6B,CAAC;AAE/C,wBAAgB,UAAU,CACxB,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,aAAa,GACrB,IAAI,CASN;AAED,wBAAsB,MAAM,CAC1B,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC,CAoBf"}

package/dist/gltf/lib/extensions/KHR_draco_mesh_compression.js

@@ -0,0 +1,107 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { sliceArrayBuffer, parseFromContext } from '@loaders.gl/core/loader-utils';
+import { DracoLoader } from '@loaders.gl/draco';
+import { GLTFIterator } from "../api/gltf-iterator.js";
+import { getGLTFAccessors, getGLTFAccessor } from "../gltf-utils/gltf-attribute-utils.js";
+import { getTypedArrayForBufferView } from "../gltf-utils/get-typed-array.js";
+const KHR_DRACO_MESH_COMPRESSION = 'KHR_draco_mesh_compression';
+/** Extension name */
+export const name = KHR_DRACO_MESH_COMPRESSION;
+export function preprocess(gltfData, options, context) {
+    const iterator = new GLTFIterator(gltfData);
+    for (const mesh of iterator.meshes) {
+        for (const primitive of iterator.getReferences(mesh).primitives) {
+            if (iterator.getExtension(primitive, KHR_DRACO_MESH_COMPRESSION)) {
+                // TODO - Remove fallback accessors to make sure we don't load unnecessary buffers
+            }
+        }
+    }
+}
+export async function decode(gltfData, options, context) {
+    if (!options?.gltf?.decompressMeshes) {
+        return;
+    }
+    const iterator = new GLTFIterator(gltfData);
+    const promises = [];
+    for (const mesh of iterator.meshes) {
+        for (const primitive of iterator.getReferences(mesh).primitives) {
+            if (iterator.getExtension(primitive, KHR_DRACO_MESH_COMPRESSION)) {
+                promises.push(decompressPrimitive(iterator, primitive, options, context));
+            }
+        }
+    }
+    // Decompress meshes in parallel
+    await Promise.all(promises);
+    // We have now decompressed all primitives, so remove the top-level extension
+    iterator.removeExtension(KHR_DRACO_MESH_COMPRESSION);
+}
+// DECODE
+// Unpacks one mesh primitive and removes the extension from the primitive
+// DracoDecoder needs to be imported and registered by app
+// Returns: Promise that resolves when all pending draco decoder jobs for this mesh complete
+// TODO - Implement fallback behavior per KHR_DRACO_MESH_COMPRESSION spec
+async function decompressPrimitive(iterator, primitive, options, context) {
+    const dracoExtension = iterator.getExtension(primitive, KHR_DRACO_MESH_COMPRESSION);
+    if (!dracoExtension) {
+        return;
+    }
+    const buffer = getTypedArrayForBufferView(iterator.data, iterator.gltf.buffers, dracoExtension.bufferView);
+    // A decoder worker can transfer its input, so it must not own the shared glTF buffer.
+    const compressedData = sliceArrayBuffer(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+    const dracoOptions = {
+        ...options,
+        draco: {
+            ...options.draco,
+            // Internal glTF decoding consumes the legacy mesh contract.
+            shape: 'mesh',
+            // Normalize compressed strips to the triangle indices returned below.
+            topology: 'triangle-list',
+            decoderProfile: options.draco?.decoderProfile || 'gltf',
+            extraAttributes: dracoExtension.attributes
+        }
+    };
+    // TODO - remove hack: The entire tileset might be included, too expensive to serialize
+    delete dracoOptions['3d-tiles'];
+    const decodedData = (await parseFromContext(compressedData, DracoLoader, dracoOptions, context));
+    const decodedAttributes = getGLTFAccessors(decodedData.attributes);
+    // A declared compressed attribute cannot fall back to its raw accessor: it may have no buffer view.
+    for (const attributeName of Object.keys(dracoExtension.attributes)) {
+        if (!Object.hasOwn(decodedAttributes, attributeName)) {
+            throw new Error(`glTF: Draco decompression did not produce attribute ${attributeName}`);
+        }
+    }
+    // Restore accessor bounds and integer normalization from the glTF declaration.
+    for (const [attributeName, decodedAttribute] of Object.entries(decodedAttributes)) {
+        if (attributeName in primitive.attributes) {
+            const accessorIndex = primitive.attributes[attributeName];
+            const accessor = iterator.data.accessors?.[accessorIndex];
+            if (accessor?.normalized !== undefined) {
+                decodedAttribute.normalized = accessor.normalized;
+            }
+            if (accessor?.min && accessor?.max) {
+                decodedAttribute.min = accessor.min;
+                decodedAttribute.max = accessor.max;
+            }
+        }
+    }
+    // Attributes outside the Draco bitstream still reference ordinary glTF accessors.
+    // @ts-ignore
+    primitive.attributes = { ...primitive.attributes, ...decodedAttributes };
+    if (decodedData.indices) {
+        // @ts-ignore
+        primitive.indices = getGLTFAccessor(decodedData.indices);
+        primitive.mode = 4;
+    }
+    // Extension has been processed, delete it
+    iterator.removeExtension(primitive, KHR_DRACO_MESH_COMPRESSION);
+    checkPrimitive(primitive);
+}
+// UTILS
+function checkPrimitive(primitive) {
+    if (!primitive.attributes || Object.keys(primitive.attributes).length === 0) {
+        throw new Error('glTF: Empty primitive detected: Draco decompression failure?');
+    }
+}
+//# sourceMappingURL=KHR_draco_mesh_compression.js.map

package/dist/gltf/lib/extensions/KHR_draco_mesh_compression.js.map

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

package/dist/gltf/lib/extensions/KHR_gaussian_splatting.cjs

@@ -0,0 +1,209 @@
+"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 name2 in all)
+    __defProp(target, name2, { get: all[name2], 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/extensions/KHR_gaussian_splatting.ts
+var KHR_gaussian_splatting_exports = {};
+__export(KHR_gaussian_splatting_exports, {
+  SPZ_COMPRESSION_EXTENSION_NAME: () => SPZ_COMPRESSION_EXTENSION_NAME,
+  decode: () => decode,
+  getGaussianSplatPrimitives: () => getGaussianSplatPrimitives,
+  name: () => name
+});
+module.exports = __toCommonJS(KHR_gaussian_splatting_exports);
+var import_gltf_iterator = require("../api/gltf-iterator.cjs");
+var name = "KHR_gaussian_splatting";
+var SPZ_COMPRESSION_EXTENSION_NAME = "KHR_gaussian_splatting_compression_spz_2";
+var REQUIRED_ATTRIBUTES = [
+  "POSITION",
+  "KHR_gaussian_splatting:ROTATION",
+  "KHR_gaussian_splatting:SCALE",
+  "KHR_gaussian_splatting:OPACITY",
+  "KHR_gaussian_splatting:SH_DEGREE_0_COEF_0"
+];
+async function decode(gltfData, options) {
+  const descriptors = getGaussianSplatPrimitives(gltfData);
+  const iterator = new import_gltf_iterator.GLTFIterator(gltfData);
+  for (const [meshIndex, mesh] of (gltfData.json.meshes || []).entries()) {
+    for (const [primitiveIndex, primitive] of mesh.primitives.entries()) {
+      const extension = primitive.extensions?.[name];
+      if (!extension) continue;
+      validateGaussianSplatPrimitive(
+        gltfData.json,
+        primitive,
+        extension,
+        meshIndex,
+        primitiveIndex,
+        iterator
+      );
+      const compression = extension.extensions?.[SPZ_COMPRESSION_EXTENSION_NAME];
+      if (compression) {
+        const descriptor = descriptors.find(
+          (item) => item.meshIndex === meshIndex && item.primitiveIndex === primitiveIndex
+        );
+        if (descriptor) {
+          const decoder = options?.gltf?.splatDecoder;
+          const bufferView = gltfData.json.bufferViews?.[compression.bufferView];
+          if (bufferView && gltfData.buffers[bufferView.buffer]) {
+            descriptor.compressedBytes = getBufferViewBytes(gltfData, compression.bufferView);
+          } else if (decoder) {
+            throw new Error(
+              `KHR_gaussian_splatting: bufferView ${compression.bufferView} is not loaded for SPZ2 decoding.`
+            );
+          }
+          if (decoder && descriptor.compressedBytes) {
+            descriptor.decoded = await decoder(descriptor.compressedBytes.buffer, {
+              sourceCoordinateSystem: "LUF"
+            });
+          }
+        }
+      }
+    }
+  }
+  if (descriptors.length) {
+    gltfData.gaussianSplatPrimitives = descriptors;
+  }
+}
+function getBufferViewBytes(gltfData, bufferViewIndex) {
+  const bufferView = gltfData.json.bufferViews?.[bufferViewIndex];
+  if (!bufferView) {
+    throw new Error(`KHR_gaussian_splatting: bufferView ${bufferViewIndex} is not defined.`);
+  }
+  const buffer = gltfData.buffers[bufferView.buffer];
+  if (!buffer) {
+    throw new Error(
+      `KHR_gaussian_splatting: buffer ${bufferView.buffer} is not loaded for SPZ2 payload.`
+    );
+  }
+  const byteOffset = buffer.byteOffset + (bufferView.byteOffset || 0);
+  return new Uint8Array(buffer.arrayBuffer, byteOffset, bufferView.byteLength).slice();
+}
+function getGaussianSplatPrimitives(gltf) {
+  const json = "json" in gltf ? gltf.json : gltf;
+  const descriptors = [];
+  for (const [meshIndex, mesh] of (json.meshes || []).entries()) {
+    for (const [primitiveIndex, primitive] of mesh.primitives.entries()) {
+      const extension = primitive.extensions?.[name];
+      if (!extension) continue;
+      const compressedBufferView = extension.extensions?.[SPZ_COMPRESSION_EXTENSION_NAME]?.bufferView;
+      descriptors.push({
+        meshIndex,
+        primitiveIndex,
+        attributes: { ...primitive.attributes },
+        extension,
+        compressedBufferView
+      });
+    }
+  }
+  return descriptors;
+}
+function validateGaussianSplatPrimitive(gltf, primitive, extension, meshIndex, primitiveIndex, iterator) {
+  if ((primitive.mode ?? 4) !== 0) {
+    throw new Error(
+      `KHR_gaussian_splatting: mesh ${meshIndex} primitive ${primitiveIndex} must use POINTS mode.`
+    );
+  }
+  if (typeof extension.kernel !== "string" || extension.kernel.length === 0) {
+    throw new Error(
+      `KHR_gaussian_splatting: mesh ${meshIndex} primitive ${primitiveIndex} is missing kernel.`
+    );
+  }
+  if (typeof extension.colorSpace !== "string" || extension.colorSpace.length === 0) {
+    throw new Error(
+      `KHR_gaussian_splatting: mesh ${meshIndex} primitive ${primitiveIndex} is missing colorSpace.`
+    );
+  }
+  const compressedBufferView = extension.extensions?.[SPZ_COMPRESSION_EXTENSION_NAME]?.bufferView;
+  if (compressedBufferView !== void 0) {
+    if (!Number.isInteger(compressedBufferView) || compressedBufferView < 0 || compressedBufferView >= (gltf.bufferViews || []).length) {
+      throw new Error(
+        `KHR_gaussian_splatting: mesh ${meshIndex} primitive ${primitiveIndex} has an invalid SPZ bufferView.`
+      );
+    }
+  } else {
+    for (const attributeName of REQUIRED_ATTRIBUTES) {
+      if (primitive.attributes[attributeName] === void 0) {
+        throw new Error(
+          `KHR_gaussian_splatting: mesh ${meshIndex} primitive ${primitiveIndex} is missing ${attributeName}.`
+        );
+      }
+    }
+  }
+  for (const [attributeName, accessorIndex] of Object.entries(primitive.attributes)) {
+    if (!Number.isInteger(accessorIndex) || accessorIndex < 0 || accessorIndex >= (gltf.accessors || []).length) {
+      throw new Error(
+        `KHR_gaussian_splatting: mesh ${meshIndex} primitive ${primitiveIndex} has invalid accessor ${attributeName}.`
+      );
+    }
+  }
+  validateGaussianValues(gltf, primitive, iterator, meshIndex, primitiveIndex);
+  for (let degree = 1; degree <= 3; degree++) {
+    const coefficientCount = degree * 2 + 1;
+    const present = Array.from(
+      { length: coefficientCount },
+      (_, coefficientIndex) => primitive.attributes[`KHR_gaussian_splatting:SH_DEGREE_${degree}_COEF_${coefficientIndex}`] !== void 0
+    );
+    if (present.some(Boolean) && !present.every(Boolean)) {
+      throw new Error(
+        `KHR_gaussian_splatting: mesh ${meshIndex} primitive ${primitiveIndex} has incomplete SH degree ${degree}.`
+      );
+    }
+    if (present.some(Boolean) && degree > 1) {
+      const lowerDegree = degree - 1;
+      const lowerCount = lowerDegree * 2 + 1;
+      for (let coefficientIndex = 0; coefficientIndex < lowerCount; coefficientIndex++) {
+        if (primitive.attributes[`KHR_gaussian_splatting:SH_DEGREE_${lowerDegree}_COEF_${coefficientIndex}`] === void 0) {
+          throw new Error(
+            `KHR_gaussian_splatting: mesh ${meshIndex} primitive ${primitiveIndex} skips SH degree ${lowerDegree}.`
+          );
+        }
+      }
+    }
+  }
+}
+function validateGaussianValues(gltf, primitive, iterator, meshIndex, primitiveIndex) {
+  const scaleAccessor = primitive.attributes["KHR_gaussian_splatting:SCALE"];
+  const opacityAccessor = primitive.attributes["KHR_gaussian_splatting:OPACITY"];
+  for (const [attributeName, accessorIndex, predicate] of [
+    ["KHR_gaussian_splatting:SCALE", scaleAccessor, (value) => value >= 0],
+    ["KHR_gaussian_splatting:OPACITY", opacityAccessor, (value) => value >= 0 && value <= 1]
+  ]) {
+    if (accessorIndex === void 0 || !isAccessorLoaded(gltf, iterator, accessorIndex)) continue;
+    const values = iterator.getTypedArrayForAccessor(accessorIndex);
+    for (let valueIndex = 0; valueIndex < values.length; valueIndex++) {
+      if (!predicate(Number(values[valueIndex]))) {
+        throw new Error(
+          `KHR_gaussian_splatting: mesh ${meshIndex} primitive ${primitiveIndex} has an invalid ${attributeName} value.`
+        );
+      }
+    }
+  }
+}
+function isAccessorLoaded(gltf, iterator, accessorIndex) {
+  const accessor = gltf.accessors?.[accessorIndex];
+  const bufferView = accessor?.bufferView === void 0 ? void 0 : gltf.bufferViews?.[accessor.bufferView];
+  return Boolean(bufferView && iterator.gltf.buffers[bufferView.buffer]);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SPZ_COMPRESSION_EXTENSION_NAME,
+  decode,
+  getGaussianSplatPrimitives,
+  name
+});
+//# sourceMappingURL=KHR_gaussian_splatting.cjs.map