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

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/gltf/lib/extensions/KHR_gaussian_splatting.ts"],
+  "sourcesContent": ["// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright vis.gl contributors\n\n/* eslint-disable camelcase */\n\nimport type {GLTF, GLTFMeshPrimitive} from '../types/gltf-json-schema';\nimport type {GLTFWithBuffers} from '../types/gltf-types';\nimport type {GLTFLoaderOptions} from '../../gltf-loader-types';\nimport {GLTFIterator} from '../api/gltf-iterator';\nimport type {\n  GLTFGaussianSplatPrimitive,\n  GLTF_KHR_gaussian_splatting\n} from '../types/gltf-ext-gaussian-splatting-schema';\n\n/** Name of the ratified Gaussian splatting glTF extension. */\nexport const name = 'KHR_gaussian_splatting';\n\n/** Name of the draft SPZ2 compression companion extension. */\nexport const SPZ_COMPRESSION_EXTENSION_NAME = 'KHR_gaussian_splatting_compression_spz_2';\n\nconst REQUIRED_ATTRIBUTES = [\n  'POSITION',\n  'KHR_gaussian_splatting:ROTATION',\n  'KHR_gaussian_splatting:SCALE',\n  'KHR_gaussian_splatting:OPACITY',\n  'KHR_gaussian_splatting:SH_DEGREE_0_COEF_0'\n] as const;\n\n/** Validates Gaussian splat primitives while preserving all source JSON. */\nexport async function decode(gltfData: GLTFWithBuffers, options: GLTFLoaderOptions): Promise<void> {\n  const descriptors = getGaussianSplatPrimitives(gltfData);\n  const iterator = new GLTFIterator(gltfData);\n  for (const [meshIndex, mesh] of (gltfData.json.meshes || []).entries()) {\n    for (const [primitiveIndex, primitive] of mesh.primitives.entries()) {\n      const extension = primitive.extensions?.[name] as GLTF_KHR_gaussian_splatting | undefined;\n      if (!extension) continue;\n      validateGaussianSplatPrimitive(\n        gltfData.json,\n        primitive,\n        extension,\n        meshIndex,\n        primitiveIndex,\n        iterator\n      );\n      const compression = extension.extensions?.[SPZ_COMPRESSION_EXTENSION_NAME];\n      if (compression) {\n        const descriptor = descriptors.find(\n          item => item.meshIndex === meshIndex && item.primitiveIndex === primitiveIndex\n        );\n        if (descriptor) {\n          const decoder = options?.gltf?.splatDecoder;\n          const bufferView = gltfData.json.bufferViews?.[compression.bufferView];\n          if (bufferView && gltfData.buffers[bufferView.buffer]) {\n            descriptor.compressedBytes = getBufferViewBytes(gltfData, compression.bufferView);\n          } else if (decoder) {\n            throw new Error(\n              `KHR_gaussian_splatting: bufferView ${compression.bufferView} is not loaded for SPZ2 decoding.`\n            );\n          }\n          if (decoder && descriptor.compressedBytes) {\n            descriptor.decoded = await decoder(descriptor.compressedBytes.buffer as ArrayBuffer, {\n              sourceCoordinateSystem: 'LUF'\n            });\n          }\n        }\n      }\n    }\n  }\n  if (descriptors.length) {\n    gltfData.gaussianSplatPrimitives = descriptors;\n  }\n}\n\n/** Returns a copied buffer-view payload so applications can retain compressed bytes safely. */\nfunction getBufferViewBytes(gltfData: GLTFWithBuffers, bufferViewIndex: number): Uint8Array {\n  const bufferView = gltfData.json.bufferViews?.[bufferViewIndex];\n  if (!bufferView) {\n    throw new Error(`KHR_gaussian_splatting: bufferView ${bufferViewIndex} is not defined.`);\n  }\n  const buffer = gltfData.buffers[bufferView.buffer];\n  if (!buffer) {\n    throw new Error(\n      `KHR_gaussian_splatting: buffer ${bufferView.buffer} is not loaded for SPZ2 payload.`\n    );\n  }\n  const byteOffset = buffer.byteOffset + (bufferView.byteOffset || 0);\n  return new Uint8Array(buffer.arrayBuffer, byteOffset, bufferView.byteLength).slice();\n}\n\n/** Returns normalized Gaussian splat primitive descriptors without mutating the glTF. */\nexport function getGaussianSplatPrimitives(\n  gltf: GLTF | GLTFWithBuffers\n): GLTFGaussianSplatPrimitive[] {\n  const json: GLTF = 'json' in gltf ? (gltf as GLTFWithBuffers).json : (gltf as GLTF);\n  const descriptors: GLTFGaussianSplatPrimitive[] = [];\n  for (const [meshIndex, mesh] of (json.meshes || []).entries()) {\n    for (const [primitiveIndex, primitive] of mesh.primitives.entries()) {\n      const extension = primitive.extensions?.[name] as GLTF_KHR_gaussian_splatting | undefined;\n      if (!extension) continue;\n      const compressedBufferView =\n        extension.extensions?.[SPZ_COMPRESSION_EXTENSION_NAME]?.bufferView;\n      descriptors.push({\n        meshIndex,\n        primitiveIndex,\n        attributes: {...primitive.attributes},\n        extension,\n        compressedBufferView\n      });\n    }\n  }\n  return descriptors;\n}\n\n/** Validates one Gaussian splat primitive against the base extension invariants. */\nfunction validateGaussianSplatPrimitive(\n  gltf: GLTF,\n  primitive: GLTFMeshPrimitive,\n  extension: GLTF_KHR_gaussian_splatting,\n  meshIndex: number,\n  primitiveIndex: number,\n  iterator: GLTFIterator\n): void {\n  if ((primitive.mode ?? 4) !== 0) {\n    throw new Error(\n      `KHR_gaussian_splatting: mesh ${meshIndex} primitive ${primitiveIndex} must use POINTS mode.`\n    );\n  }\n  if (typeof extension.kernel !== 'string' || extension.kernel.length === 0) {\n    throw new Error(\n      `KHR_gaussian_splatting: mesh ${meshIndex} primitive ${primitiveIndex} is missing kernel.`\n    );\n  }\n  if (typeof extension.colorSpace !== 'string' || extension.colorSpace.length === 0) {\n    throw new Error(\n      `KHR_gaussian_splatting: mesh ${meshIndex} primitive ${primitiveIndex} is missing colorSpace.`\n    );\n  }\n\n  const compressedBufferView = extension.extensions?.[SPZ_COMPRESSION_EXTENSION_NAME]?.bufferView;\n  if (compressedBufferView !== undefined) {\n    if (\n      !Number.isInteger(compressedBufferView) ||\n      compressedBufferView < 0 ||\n      compressedBufferView >= (gltf.bufferViews || []).length\n    ) {\n      throw new Error(\n        `KHR_gaussian_splatting: mesh ${meshIndex} primitive ${primitiveIndex} has an invalid SPZ bufferView.`\n      );\n    }\n  } else {\n    for (const attributeName of REQUIRED_ATTRIBUTES) {\n      if (primitive.attributes[attributeName] === undefined) {\n        throw new Error(\n          `KHR_gaussian_splatting: mesh ${meshIndex} primitive ${primitiveIndex} is missing ${attributeName}.`\n        );\n      }\n    }\n  }\n\n  for (const [attributeName, accessorIndex] of Object.entries(primitive.attributes)) {\n    if (\n      !Number.isInteger(accessorIndex) ||\n      accessorIndex < 0 ||\n      accessorIndex >= (gltf.accessors || []).length\n    ) {\n      throw new Error(\n        `KHR_gaussian_splatting: mesh ${meshIndex} primitive ${primitiveIndex} has invalid accessor ${attributeName}.`\n      );\n    }\n  }\n\n  validateGaussianValues(gltf, primitive, iterator, meshIndex, primitiveIndex);\n\n  for (let degree = 1; degree <= 3; degree++) {\n    const coefficientCount = degree * 2 + 1;\n    const present = Array.from(\n      {length: coefficientCount},\n      (_, coefficientIndex) =>\n        primitive.attributes[\n          `KHR_gaussian_splatting:SH_DEGREE_${degree}_COEF_${coefficientIndex}`\n        ] !== undefined\n    );\n    if (present.some(Boolean) && !present.every(Boolean)) {\n      throw new Error(\n        `KHR_gaussian_splatting: mesh ${meshIndex} primitive ${primitiveIndex} has incomplete SH degree ${degree}.`\n      );\n    }\n    if (present.some(Boolean) && degree > 1) {\n      const lowerDegree = degree - 1;\n      const lowerCount = lowerDegree * 2 + 1;\n      for (let coefficientIndex = 0; coefficientIndex < lowerCount; coefficientIndex++) {\n        if (\n          primitive.attributes[\n            `KHR_gaussian_splatting:SH_DEGREE_${lowerDegree}_COEF_${coefficientIndex}`\n          ] === undefined\n        ) {\n          throw new Error(\n            `KHR_gaussian_splatting: mesh ${meshIndex} primitive ${primitiveIndex} skips SH degree ${lowerDegree}.`\n          );\n        }\n      }\n    }\n  }\n}\n\n/** Checks decoded scale and opacity ranges when the referenced buffers are available. */\nfunction validateGaussianValues(\n  gltf: GLTF,\n  primitive: GLTFMeshPrimitive,\n  iterator: GLTFIterator,\n  meshIndex: number,\n  primitiveIndex: number\n): void {\n  const scaleAccessor = primitive.attributes['KHR_gaussian_splatting:SCALE'];\n  const opacityAccessor = primitive.attributes['KHR_gaussian_splatting:OPACITY'];\n  for (const [attributeName, accessorIndex, predicate] of [\n    ['KHR_gaussian_splatting:SCALE', scaleAccessor, (value: number) => value >= 0],\n    ['KHR_gaussian_splatting:OPACITY', opacityAccessor, (value: number) => value >= 0 && value <= 1]\n  ] as const) {\n    if (accessorIndex === undefined || !isAccessorLoaded(gltf, iterator, accessorIndex)) continue;\n    const values = iterator.getTypedArrayForAccessor(accessorIndex) as ArrayLike<number>;\n    for (let valueIndex = 0; valueIndex < values.length; valueIndex++) {\n      if (!predicate(Number(values[valueIndex]))) {\n        throw new Error(\n          `KHR_gaussian_splatting: mesh ${meshIndex} primitive ${primitiveIndex} has an invalid ${attributeName} value.`\n        );\n      }\n    }\n  }\n}\n\n/** Returns whether an accessor's source buffer has been resolved by the loader. */\nfunction isAccessorLoaded(gltf: GLTF, iterator: GLTFIterator, accessorIndex: number): boolean {\n  const accessor = gltf.accessors?.[accessorIndex];\n  const bufferView =\n    accessor?.bufferView === undefined ? undefined : gltf.bufferViews?.[accessor.bufferView];\n  return Boolean(bufferView && iterator.gltf.buffers[bufferView.buffer]);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,13 @@
+import type { GLTF } from "../types/gltf-json-schema.js";
+import type { GLTFWithBuffers } from "../types/gltf-types.js";
+import type { GLTFLoaderOptions } from "../../gltf-loader-types.js";
+import type { GLTFGaussianSplatPrimitive } from "../types/gltf-ext-gaussian-splatting-schema.js";
+/** Name of the ratified Gaussian splatting glTF extension. */
+export declare const name = "KHR_gaussian_splatting";
+/** Name of the draft SPZ2 compression companion extension. */
+export declare const SPZ_COMPRESSION_EXTENSION_NAME = "KHR_gaussian_splatting_compression_spz_2";
+/** Validates Gaussian splat primitives while preserving all source JSON. */
+export declare function decode(gltfData: GLTFWithBuffers, options: GLTFLoaderOptions): Promise<void>;
+/** Returns normalized Gaussian splat primitive descriptors without mutating the glTF. */
+export declare function getGaussianSplatPrimitives(gltf: GLTF | GLTFWithBuffers): GLTFGaussianSplatPrimitive[];
+//# sourceMappingURL=KHR_gaussian_splatting.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"KHR_gaussian_splatting.d.ts","sourceRoot":"","sources":["../../../../src/gltf/lib/extensions/KHR_gaussian_splatting.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAC,IAAI,EAAoB,qCAAkC;AACvE,OAAO,KAAK,EAAC,eAAe,EAAC,+BAA4B;AACzD,OAAO,KAAK,EAAC,iBAAiB,EAAC,mCAAgC;AAE/D,OAAO,KAAK,EACV,0BAA0B,EAE3B,uDAAoD;AAErD,8DAA8D;AAC9D,eAAO,MAAM,IAAI,2BAA2B,CAAC;AAE7C,8DAA8D;AAC9D,eAAO,MAAM,8BAA8B,6CAA6C,CAAC;AAUzF,4EAA4E;AAC5E,wBAAsB,MAAM,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0CjG;AAkBD,yFAAyF;AACzF,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,IAAI,GAAG,eAAe,GAC3B,0BAA0B,EAAE,CAmB9B"}

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

@@ -0,0 +1,160 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright vis.gl contributors
+import { GLTFIterator } from "../api/gltf-iterator.js";
+/** Name of the ratified Gaussian splatting glTF extension. */
+export const name = 'KHR_gaussian_splatting';
+/** Name of the draft SPZ2 compression companion extension. */
+export const SPZ_COMPRESSION_EXTENSION_NAME = 'KHR_gaussian_splatting_compression_spz_2';
+const REQUIRED_ATTRIBUTES = [
+    'POSITION',
+    'KHR_gaussian_splatting:ROTATION',
+    'KHR_gaussian_splatting:SCALE',
+    'KHR_gaussian_splatting:OPACITY',
+    'KHR_gaussian_splatting:SH_DEGREE_0_COEF_0'
+];
+/** Validates Gaussian splat primitives while preserving all source JSON. */
+export async function decode(gltfData, options) {
+    const descriptors = getGaussianSplatPrimitives(gltfData);
+    const iterator = new 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;
+    }
+}
+/** Returns a copied buffer-view payload so applications can retain compressed bytes safely. */
+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();
+}
+/** Returns normalized Gaussian splat primitive descriptors without mutating the glTF. */
+export 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;
+}
+/** Validates one Gaussian splat primitive against the base extension invariants. */
+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 !== undefined) {
+        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] === undefined) {
+                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}`] !== undefined);
+        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}`] === undefined) {
+                    throw new Error(`KHR_gaussian_splatting: mesh ${meshIndex} primitive ${primitiveIndex} skips SH degree ${lowerDegree}.`);
+                }
+            }
+        }
+    }
+}
+/** Checks decoded scale and opacity ranges when the referenced buffers are available. */
+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 === undefined || !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.`);
+            }
+        }
+    }
+}
+/** Returns whether an accessor's source buffer has been resolved by the loader. */
+function isAccessorLoaded(gltf, iterator, accessorIndex) {
+    const accessor = gltf.accessors?.[accessorIndex];
+    const bufferView = accessor?.bufferView === undefined ? undefined : gltf.bufferViews?.[accessor.bufferView];
+    return Boolean(bufferView && iterator.gltf.buffers[bufferView.buffer]);
+}
+//# sourceMappingURL=KHR_gaussian_splatting.js.map

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

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

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

@@ -0,0 +1,110 @@
+"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_mesh_primitive_restart.ts
+var KHR_mesh_primitive_restart_exports = {};
+__export(KHR_mesh_primitive_restart_exports, {
+  decode: () => decode,
+  getPrimitiveRestartRanges: () => getPrimitiveRestartRanges,
+  name: () => name
+});
+module.exports = __toCommonJS(KHR_mesh_primitive_restart_exports);
+var import_gltf_iterator = require("../api/gltf-iterator.cjs");
+var name = "KHR_mesh_primitive_restart";
+var SUPPORTED_MODES = /* @__PURE__ */ new Set([2, 3, 5, 6]);
+async function decode(gltfData, options) {
+  if (!gltfData.json.extensionsUsed?.includes(name)) {
+    return;
+  }
+  if (!gltfData.json.extensionsRequired?.includes(name)) {
+    throw new Error(`${name} must be declared in extensionsRequired`);
+  }
+  if (!options.gltf?.loadBuffers) {
+    return;
+  }
+  const iterator = new import_gltf_iterator.GLTFIterator(gltfData);
+  for (const mesh of iterator.meshes) {
+    for (const primitive of iterator.getReferences(mesh).primitives) {
+      decodePrimitiveRestart(iterator, primitive);
+    }
+  }
+}
+function decodePrimitiveRestart(iterator, primitive) {
+  if (primitive.indices === void 0) {
+    return;
+  }
+  const indicesAccessor = primitive.indices;
+  const accessor = typeof indicesAccessor === "number" ? iterator.data.accessors?.[indicesAccessor] : indicesAccessor;
+  if (!accessor) {
+    throw new Error(`${name}: primitive references missing indices accessor ${primitive.indices}`);
+  }
+  const restartIndex = getRestartIndex(accessor);
+  const indices = iterator.getTypedArrayForAccessor(primitive.indices);
+  const containsRestart = Array.prototype.includes.call(indices, restartIndex);
+  if (!SUPPORTED_MODES.has(primitive.mode ?? 4)) {
+    if (containsRestart) {
+      throw new Error(`${name}: primitive restart is not valid for mode ${primitive.mode ?? 4}`);
+    }
+    return;
+  }
+  Object.defineProperty(primitive, "primitiveRestart", {
+    configurable: true,
+    enumerable: false,
+    writable: true,
+    value: {
+      restartIndex,
+      ranges: getPrimitiveRestartRanges(indices, restartIndex)
+    }
+  });
+}
+function getRestartIndex(accessor) {
+  if (accessor.type !== "SCALAR") {
+    throw new Error(`${name}: indices accessor must have SCALAR type`);
+  }
+  switch (accessor.componentType) {
+    case 5121:
+      return 255;
+    case 5123:
+      return 65535;
+    case 5125:
+      return 4294967295;
+    default:
+      throw new Error(`${name}: indices accessor must use an unsigned integer component type`);
+  }
+}
+function getPrimitiveRestartRanges(indices, restartIndex) {
+  const ranges = [];
+  let rangeStart = 0;
+  for (let index = 0; index <= indices.length; index++) {
+    if (index === indices.length || indices[index] === restartIndex) {
+      if (index > rangeStart) {
+        ranges.push({ offset: rangeStart, count: index - rangeStart });
+      }
+      rangeStart = index + 1;
+    }
+  }
+  return ranges;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  decode,
+  getPrimitiveRestartRanges,
+  name
+});
+//# sourceMappingURL=KHR_mesh_primitive_restart.cjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/gltf/lib/extensions/KHR_mesh_primitive_restart.ts"],
+  "sourcesContent": ["// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright vis.gl contributors\n\nimport type {NumericArray} from '@loaders.gl/core/loader-utils';\nimport type {GLTFLoaderOptions} from '../../gltf-loader-types';\nimport type {GLTFAccessor, GLTFMeshPrimitive} from '../types/gltf-json-schema';\nimport type {GLTFWithBuffers} from '../types/gltf-types';\nimport type {\n  GLTFPrimitiveIndexRange,\n  GLTFPrimitiveRestartData\n} from '../types/gltf-vector-topology';\nimport {GLTFIterator} from '../api/gltf-iterator';\n\n/** Draft Khronos primitive-restart extension name. */\nexport const name = 'KHR_mesh_primitive_restart';\n\nconst SUPPORTED_MODES = new Set([2, 3, 5, 6]);\n\n/** Decode primitive-restart ranges for all indexed primitives in the asset. */\nexport async function decode(gltfData: GLTFWithBuffers, options: GLTFLoaderOptions): Promise<void> {\n  if (!gltfData.json.extensionsUsed?.includes(name)) {\n    return;\n  }\n  if (!gltfData.json.extensionsRequired?.includes(name)) {\n    throw new Error(`${name} must be declared in extensionsRequired`);\n  }\n  if (!options.gltf?.loadBuffers) {\n    return;\n  }\n\n  const iterator = new GLTFIterator(gltfData);\n  for (const mesh of iterator.meshes) {\n    for (const primitive of iterator.getReferences(mesh).primitives) {\n      decodePrimitiveRestart(iterator, primitive);\n    }\n  }\n}\n\n/** Decode and validate one primitive's restart markers. */\nfunction decodePrimitiveRestart(iterator: GLTFIterator, primitive: GLTFMeshPrimitive): void {\n  if (primitive.indices === undefined) {\n    return;\n  }\n  const indicesAccessor = primitive.indices as number | GLTFAccessor;\n  const accessor =\n    typeof indicesAccessor === 'number'\n      ? iterator.data.accessors?.[indicesAccessor]\n      : indicesAccessor;\n  if (!accessor) {\n    throw new Error(`${name}: primitive references missing indices accessor ${primitive.indices}`);\n  }\n  const restartIndex = getRestartIndex(accessor);\n  const indices = iterator.getTypedArrayForAccessor(primitive.indices) as NumericArray;\n  const containsRestart = Array.prototype.includes.call(indices, restartIndex);\n\n  if (!SUPPORTED_MODES.has(primitive.mode ?? 4)) {\n    if (containsRestart) {\n      throw new Error(`${name}: primitive restart is not valid for mode ${primitive.mode ?? 4}`);\n    }\n    return;\n  }\n\n  Object.defineProperty(primitive, 'primitiveRestart', {\n    configurable: true,\n    enumerable: false,\n    writable: true,\n    value: {\n      restartIndex,\n      ranges: getPrimitiveRestartRanges(indices, restartIndex)\n    } satisfies GLTFPrimitiveRestartData\n  });\n}\n\n/** Return the restart value for a valid unsigned scalar index accessor. */\nfunction getRestartIndex(accessor: GLTFAccessor): number {\n  if (accessor.type !== 'SCALAR') {\n    throw new Error(`${name}: indices accessor must have SCALAR type`);\n  }\n  switch (accessor.componentType) {\n    case 5121:\n      return 0xff;\n    case 5123:\n      return 0xffff;\n    case 5125:\n      return 0xffffffff;\n    default:\n      throw new Error(`${name}: indices accessor must use an unsigned integer component type`);\n  }\n}\n\n/** Split an index accessor into non-empty source ranges without copying index data. */\nexport function getPrimitiveRestartRanges(\n  indices: ArrayLike<number>,\n  restartIndex: number\n): GLTFPrimitiveIndexRange[] {\n  const ranges: GLTFPrimitiveIndexRange[] = [];\n  let rangeStart = 0;\n  for (let index = 0; index <= indices.length; index++) {\n    if (index === indices.length || indices[index] === restartIndex) {\n      if (index > rangeStart) {\n        ranges.push({offset: rangeStart, count: index - rangeStart});\n      }\n      rangeStart = index + 1;\n    }\n  }\n  return ranges;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAYA,2BAA2B;AAGpB,IAAM,OAAO;AAEpB,IAAM,kBAAkB,oBAAI,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;AAG5C,eAAsB,OAAO,UAA2B,SAA2C;AACjG,MAAI,CAAC,SAAS,KAAK,gBAAgB,SAAS,IAAI,GAAG;AACjD;AAAA,EACF;AACA,MAAI,CAAC,SAAS,KAAK,oBAAoB,SAAS,IAAI,GAAG;AACrD,UAAM,IAAI,MAAM,GAAG,IAAI,yCAAyC;AAAA,EAClE;AACA,MAAI,CAAC,QAAQ,MAAM,aAAa;AAC9B;AAAA,EACF;AAEA,QAAM,WAAW,IAAI,kCAAa,QAAQ;AAC1C,aAAW,QAAQ,SAAS,QAAQ;AAClC,eAAW,aAAa,SAAS,cAAc,IAAI,EAAE,YAAY;AAC/D,6BAAuB,UAAU,SAAS;AAAA,IAC5C;AAAA,EACF;AACF;AAGA,SAAS,uBAAuB,UAAwB,WAAoC;AAC1F,MAAI,UAAU,YAAY,QAAW;AACnC;AAAA,EACF;AACA,QAAM,kBAAkB,UAAU;AAClC,QAAM,WACJ,OAAO,oBAAoB,WACvB,SAAS,KAAK,YAAY,eAAe,IACzC;AACN,MAAI,CAAC,UAAU;AACb,UAAM,IAAI,MAAM,GAAG,IAAI,mDAAmD,UAAU,OAAO,EAAE;AAAA,EAC/F;AACA,QAAM,eAAe,gBAAgB,QAAQ;AAC7C,QAAM,UAAU,SAAS,yBAAyB,UAAU,OAAO;AACnE,QAAM,kBAAkB,MAAM,UAAU,SAAS,KAAK,SAAS,YAAY;AAE3E,MAAI,CAAC,gBAAgB,IAAI,UAAU,QAAQ,CAAC,GAAG;AAC7C,QAAI,iBAAiB;AACnB,YAAM,IAAI,MAAM,GAAG,IAAI,6CAA6C,UAAU,QAAQ,CAAC,EAAE;AAAA,IAC3F;AACA;AAAA,EACF;AAEA,SAAO,eAAe,WAAW,oBAAoB;AAAA,IACnD,cAAc;AAAA,IACd,YAAY;AAAA,IACZ,UAAU;AAAA,IACV,OAAO;AAAA,MACL;AAAA,MACA,QAAQ,0BAA0B,SAAS,YAAY;AAAA,IACzD;AAAA,EACF,CAAC;AACH;AAGA,SAAS,gBAAgB,UAAgC;AACvD,MAAI,SAAS,SAAS,UAAU;AAC9B,UAAM,IAAI,MAAM,GAAG,IAAI,0CAA0C;AAAA,EACnE;AACA,UAAQ,SAAS,eAAe;AAAA,IAC9B,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,YAAM,IAAI,MAAM,GAAG,IAAI,gEAAgE;AAAA,EAC3F;AACF;AAGO,SAAS,0BACd,SACA,cAC2B;AAC3B,QAAM,SAAoC,CAAC;AAC3C,MAAI,aAAa;AACjB,WAAS,QAAQ,GAAG,SAAS,QAAQ,QAAQ,SAAS;AACpD,QAAI,UAAU,QAAQ,UAAU,QAAQ,KAAK,MAAM,cAAc;AAC/D,UAAI,QAAQ,YAAY;AACtB,eAAO,KAAK,EAAC,QAAQ,YAAY,OAAO,QAAQ,WAAU,CAAC;AAAA,MAC7D;AACA,mBAAa,QAAQ;AAAA,IACvB;AAAA,EACF;AACA,SAAO;AACT;",
+  "names": []
+}

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

@@ -0,0 +1,10 @@
+import type { GLTFLoaderOptions } from "../../gltf-loader-types.js";
+import type { GLTFWithBuffers } from "../types/gltf-types.js";
+import type { GLTFPrimitiveIndexRange } from "../types/gltf-vector-topology.js";
+/** Draft Khronos primitive-restart extension name. */
+export declare const name = "KHR_mesh_primitive_restart";
+/** Decode primitive-restart ranges for all indexed primitives in the asset. */
+export declare function decode(gltfData: GLTFWithBuffers, options: GLTFLoaderOptions): Promise<void>;
+/** Split an index accessor into non-empty source ranges without copying index data. */
+export declare function getPrimitiveRestartRanges(indices: ArrayLike<number>, restartIndex: number): GLTFPrimitiveIndexRange[];
+//# sourceMappingURL=KHR_mesh_primitive_restart.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"KHR_mesh_primitive_restart.d.ts","sourceRoot":"","sources":["../../../../src/gltf/lib/extensions/KHR_mesh_primitive_restart.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,iBAAiB,EAAC,mCAAgC;AAE/D,OAAO,KAAK,EAAC,eAAe,EAAC,+BAA4B;AACzD,OAAO,KAAK,EACV,uBAAuB,EAExB,yCAAsC;AAGvC,sDAAsD;AACtD,eAAO,MAAM,IAAI,+BAA+B,CAAC;AAIjD,+EAA+E;AAC/E,wBAAsB,MAAM,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBjG;AAsDD,uFAAuF;AACvF,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,EAC1B,YAAY,EAAE,MAAM,GACnB,uBAAuB,EAAE,CAY3B"}

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

@@ -0,0 +1,87 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright vis.gl contributors
+import { GLTFIterator } from "../api/gltf-iterator.js";
+/** Draft Khronos primitive-restart extension name. */
+export const name = 'KHR_mesh_primitive_restart';
+const SUPPORTED_MODES = new Set([2, 3, 5, 6]);
+/** Decode primitive-restart ranges for all indexed primitives in the asset. */
+export async function decode(gltfData, options) {
+    if (!gltfData.json.extensionsUsed?.includes(name)) {
+        return;
+    }
+    if (!gltfData.json.extensionsRequired?.includes(name)) {
+        throw new Error(`${name} must be declared in extensionsRequired`);
+    }
+    if (!options.gltf?.loadBuffers) {
+        return;
+    }
+    const iterator = new GLTFIterator(gltfData);
+    for (const mesh of iterator.meshes) {
+        for (const primitive of iterator.getReferences(mesh).primitives) {
+            decodePrimitiveRestart(iterator, primitive);
+        }
+    }
+}
+/** Decode and validate one primitive's restart markers. */
+function decodePrimitiveRestart(iterator, primitive) {
+    if (primitive.indices === undefined) {
+        return;
+    }
+    const indicesAccessor = primitive.indices;
+    const accessor = typeof indicesAccessor === 'number'
+        ? iterator.data.accessors?.[indicesAccessor]
+        : indicesAccessor;
+    if (!accessor) {
+        throw new Error(`${name}: primitive references missing indices accessor ${primitive.indices}`);
+    }
+    const restartIndex = getRestartIndex(accessor);
+    const indices = iterator.getTypedArrayForAccessor(primitive.indices);
+    const containsRestart = Array.prototype.includes.call(indices, restartIndex);
+    if (!SUPPORTED_MODES.has(primitive.mode ?? 4)) {
+        if (containsRestart) {
+            throw new Error(`${name}: primitive restart is not valid for mode ${primitive.mode ?? 4}`);
+        }
+        return;
+    }
+    Object.defineProperty(primitive, 'primitiveRestart', {
+        configurable: true,
+        enumerable: false,
+        writable: true,
+        value: {
+            restartIndex,
+            ranges: getPrimitiveRestartRanges(indices, restartIndex)
+        }
+    });
+}
+/** Return the restart value for a valid unsigned scalar index accessor. */
+function getRestartIndex(accessor) {
+    if (accessor.type !== 'SCALAR') {
+        throw new Error(`${name}: indices accessor must have SCALAR type`);
+    }
+    switch (accessor.componentType) {
+        case 5121:
+            return 0xff;
+        case 5123:
+            return 0xffff;
+        case 5125:
+            return 0xffffffff;
+        default:
+            throw new Error(`${name}: indices accessor must use an unsigned integer component type`);
+    }
+}
+/** Split an index accessor into non-empty source ranges without copying index data. */
+export function getPrimitiveRestartRanges(indices, restartIndex) {
+    const ranges = [];
+    let rangeStart = 0;
+    for (let index = 0; index <= indices.length; index++) {
+        if (index === indices.length || indices[index] === restartIndex) {
+            if (index > rangeStart) {
+                ranges.push({ offset: rangeStart, count: index - rangeStart });
+            }
+            rangeStart = index + 1;
+        }
+    }
+    return ranges;
+}
+//# sourceMappingURL=KHR_mesh_primitive_restart.js.map

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

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

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

@@ -0,0 +1,37 @@
+"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_meshopt_compression.ts
+var KHR_meshopt_compression_exports = {};
+__export(KHR_meshopt_compression_exports, {
+  decode: () => decode,
+  name: () => name
+});
+module.exports = __toCommonJS(KHR_meshopt_compression_exports);
+var import_meshopt_compression = require("./meshopt-compression.cjs");
+var name = "KHR_meshopt_compression";
+async function decode(gltfData, options) {
+  await (0, import_meshopt_compression.decodeMeshoptCompression)(gltfData, options, name);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  decode,
+  name
+});
+//# sourceMappingURL=KHR_meshopt_compression.cjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/gltf/lib/extensions/KHR_meshopt_compression.ts"],
+  "sourcesContent": ["// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\nimport type {GLTFLoaderOptions} from '../../gltf-loader-types';\nimport type {GLTFWithBuffers} from '../types/gltf-types';\nimport {decodeMeshoptCompression} from './meshopt-compression';\n\n/**\n * Exact glTF identifier for the Khronos meshopt buffer-view compression extension.\n *\n * Extension capability negotiation uses this exact name; `KHR_meshopt_compression` is not an alias\n * for the earlier `EXT_meshopt_compression` identifier.\n */\nexport const name = 'KHR_meshopt_compression';\n\n/**\n * Decodes all `KHR_meshopt_compression` buffer views in a loaded glTF document.\n *\n * Processing is a no-op unless both `options.gltf.loadBuffers` and\n * `options.gltf.decompressMeshes` are enabled. The shared decoder supports version 0 and version 1\n * attribute streams and every KHR post-decode filter, including `COLOR`.\n *\n * @param gltfData Parsed glTF JSON together with its resolved source and destination buffers.\n * @param options glTF loader options controlling buffer loading and mesh decompression.\n * @returns A promise that resolves after all KHR meshopt buffer views have been decoded.\n * @throws If KHR and EXT meshopt declarations are mixed on the same buffer view or buffer, or if a\n * compressed stream is malformed.\n */\nexport async function decode(gltfData: GLTFWithBuffers, options: GLTFLoaderOptions): Promise<void> {\n  await decodeMeshoptCompression(gltfData, options, name);\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,iCAAuC;AAQhC,IAAM,OAAO;AAepB,eAAsB,OAAO,UAA2B,SAA2C;AACjG,YAAM,qDAAyB,UAAU,SAAS,IAAI;AACxD;",
+  "names": []
+}

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

@@ -0,0 +1,24 @@
+import type { GLTFLoaderOptions } from "../../gltf-loader-types.js";
+import type { GLTFWithBuffers } from "../types/gltf-types.js";
+/**
+ * Exact glTF identifier for the Khronos meshopt buffer-view compression extension.
+ *
+ * Extension capability negotiation uses this exact name; `KHR_meshopt_compression` is not an alias
+ * for the earlier `EXT_meshopt_compression` identifier.
+ */
+export declare const name = "KHR_meshopt_compression";
+/**
+ * Decodes all `KHR_meshopt_compression` buffer views in a loaded glTF document.
+ *
+ * Processing is a no-op unless both `options.gltf.loadBuffers` and
+ * `options.gltf.decompressMeshes` are enabled. The shared decoder supports version 0 and version 1
+ * attribute streams and every KHR post-decode filter, including `COLOR`.
+ *
+ * @param gltfData Parsed glTF JSON together with its resolved source and destination buffers.
+ * @param options glTF loader options controlling buffer loading and mesh decompression.
+ * @returns A promise that resolves after all KHR meshopt buffer views have been decoded.
+ * @throws If KHR and EXT meshopt declarations are mixed on the same buffer view or buffer, or if a
+ * compressed stream is malformed.
+ */
+export declare function decode(gltfData: GLTFWithBuffers, options: GLTFLoaderOptions): Promise<void>;
+//# sourceMappingURL=KHR_meshopt_compression.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"KHR_meshopt_compression.d.ts","sourceRoot":"","sources":["../../../../src/gltf/lib/extensions/KHR_meshopt_compression.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,iBAAiB,EAAC,mCAAgC;AAC/D,OAAO,KAAK,EAAC,eAAe,EAAC,+BAA4B;AAGzD;;;;;GAKG;AACH,eAAO,MAAM,IAAI,4BAA4B,CAAC;AAE9C;;;;;;;;;;;;GAYG;AACH,wBAAsB,MAAM,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjG"}

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

@@ -0,0 +1,28 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { decodeMeshoptCompression } from "./meshopt-compression.js";
+/**
+ * Exact glTF identifier for the Khronos meshopt buffer-view compression extension.
+ *
+ * Extension capability negotiation uses this exact name; `KHR_meshopt_compression` is not an alias
+ * for the earlier `EXT_meshopt_compression` identifier.
+ */
+export const name = 'KHR_meshopt_compression';
+/**
+ * Decodes all `KHR_meshopt_compression` buffer views in a loaded glTF document.
+ *
+ * Processing is a no-op unless both `options.gltf.loadBuffers` and
+ * `options.gltf.decompressMeshes` are enabled. The shared decoder supports version 0 and version 1
+ * attribute streams and every KHR post-decode filter, including `COLOR`.
+ *
+ * @param gltfData Parsed glTF JSON together with its resolved source and destination buffers.
+ * @param options glTF loader options controlling buffer loading and mesh decompression.
+ * @returns A promise that resolves after all KHR meshopt buffer views have been decoded.
+ * @throws If KHR and EXT meshopt declarations are mixed on the same buffer view or buffer, or if a
+ * compressed stream is malformed.
+ */
+export async function decode(gltfData, options) {
+    await decodeMeshoptCompression(gltfData, options, name);
+}
+//# sourceMappingURL=KHR_meshopt_compression.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"KHR_meshopt_compression.js","sourceRoot":"","sources":["../../../../src/gltf/lib/extensions/KHR_meshopt_compression.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAIpC,OAAO,EAAC,wBAAwB,EAAC,iCAA8B;AAE/D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,yBAAyB,CAAC;AAE9C;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAyB,EAAE,OAA0B;IAChF,MAAM,wBAAwB,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;AAC1D,CAAC"}

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

@@ -0,0 +1,47 @@
+"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_texture_basisu.ts
+var KHR_texture_basisu_exports = {};
+__export(KHR_texture_basisu_exports, {
+  name: () => name,
+  preprocess: () => preprocess
+});
+module.exports = __toCommonJS(KHR_texture_basisu_exports);
+var import_gltf_iterator = require("../api/gltf-iterator.cjs");
+var KHR_TEXTURE_BASISU = "KHR_texture_basisu";
+var name = KHR_TEXTURE_BASISU;
+function preprocess(gltfData, options) {
+  void options;
+  const iterator = new import_gltf_iterator.GLTFIterator(gltfData);
+  for (const texture of iterator.textures) {
+    const extension = iterator.getExtension(texture, KHR_TEXTURE_BASISU);
+    if (extension) {
+      texture.source = extension.source;
+      iterator.removeExtension(texture, KHR_TEXTURE_BASISU);
+    }
+  }
+  iterator.removeExtension(KHR_TEXTURE_BASISU);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  name,
+  preprocess
+});
+//# sourceMappingURL=KHR_texture_basisu.cjs.map