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

package/dist/gltf/lib/api/convert-gltf-v1-skins.js

@@ -0,0 +1,161 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/**
+ * Resolve glTF 1 joint names inside each instance's skeleton hierarchy.
+ * Shared skins are cloned when instances use different joint nodes. Non-identity bind shapes
+ * remain available for binary baking. Multiple explicit roots are supported when their
+ * disjoint subtrees resolve every joint uniquely and share an unambiguous common ancestor.
+ */
+export function convertGLTFV1Skins(json, resolveNodeId, reportUnsupported) {
+    const nodes = (json.nodes || []);
+    const skins = (json.skins || []);
+    const originalSkinCount = skins.length;
+    let hasUnconvertedSkin = false;
+    for (let skinIndex = 0; skinIndex < originalSkinCount; skinIndex++) {
+        const skin = skins[skinIndex];
+        const jointNames = skin.jointNames;
+        if (!Array.isArray(jointNames) ||
+            jointNames.length === 0 ||
+            jointNames.some(name => typeof name !== 'string' || !name) ||
+            new Set(jointNames).size !== jointNames.length) {
+            reportUnsupported(`skin ${skinIndex} has invalid joint names`);
+            hasUnconvertedSkin = true;
+            continue;
+        }
+        const instanceIndices = nodes.flatMap((node, nodeIndex) => node.skin === skinIndex ? [nodeIndex] : []);
+        const plans = (instanceIndices.length ? instanceIndices : [undefined]).map(nodeIndex => resolveSkinInstance(nodes, jointNames, nodeIndex, resolveNodeId, feature => reportUnsupported(`skin ${skinIndex} ${feature}`)));
+        const hasFailedPlan = plans.some(plan => !plan);
+        hasUnconvertedSkin ||= hasFailedPlan;
+        const convertedBindings = new Map();
+        for (const plan of plans) {
+            if (!plan)
+                continue;
+            const bindingKey = `${plan.skeletonIndex}:${plan.jointIndices.join(',')}`;
+            let convertedSkinIndex = convertedBindings.get(bindingKey);
+            if (convertedSkinIndex === undefined) {
+                const convertedSkin = {
+                    ...skin,
+                    joints: plan.jointIndices,
+                    skeleton: plan.skeletonIndex
+                };
+                delete convertedSkin.jointNames;
+                if (skin.bindShapeMatrix !== undefined && isIdentityBindShape(skin.bindShapeMatrix)) {
+                    delete convertedSkin.bindShapeMatrix;
+                }
+                if (!hasFailedPlan && convertedBindings.size === 0) {
+                    convertedSkinIndex = skinIndex;
+                    skins[skinIndex] = convertedSkin;
+                }
+                else {
+                    delete convertedSkin.id;
+                    convertedSkinIndex = skins.length;
+                    skins.push(convertedSkin);
+                }
+                convertedBindings.set(bindingKey, convertedSkinIndex);
+            }
+            if (plan.nodeIndex !== undefined) {
+                nodes[plan.nodeIndex].skin = convertedSkinIndex;
+                delete nodes[plan.nodeIndex].skeletons;
+            }
+        }
+    }
+    // Keep symbolic names available when a best-effort result contains an unresolved legacy skin.
+    if (!hasUnconvertedSkin) {
+        for (const node of nodes)
+            delete node.jointName;
+    }
+}
+/** Resolve ordered names within explicit subtrees, or uniquely across the document. */
+function resolveSkinInstance(nodes, jointNames, nodeIndex, resolveNodeId, reportUnsupported) {
+    const skeletonIds = nodeIndex === undefined ? undefined : nodes[nodeIndex].skeletons;
+    if (skeletonIds !== undefined &&
+        (!Array.isArray(skeletonIds) ||
+            skeletonIds.some(id => typeof id !== 'string' || !id) ||
+            new Set(skeletonIds).size !== skeletonIds.length)) {
+        reportUnsupported('has invalid skeleton roots');
+        return null;
+    }
+    const explicitRoots = (skeletonIds || []).map(resolveNodeId);
+    const candidates = !explicitRoots.length
+        ? nodes.map((node, candidateIndex) => candidateIndex)
+        : collectSkeletonNodes(nodes, explicitRoots);
+    if (!candidates) {
+        reportUnsupported('has invalid or overlapping skeleton subtrees');
+        return null;
+    }
+    const jointIndices = [];
+    const namedCandidates = new Map();
+    for (const candidateIndex of candidates) {
+        const jointName = nodes[candidateIndex].jointName;
+        if (jointName === undefined)
+            continue;
+        const matches = namedCandidates.get(jointName) || [];
+        matches.push(candidateIndex);
+        namedCandidates.set(jointName, matches);
+    }
+    for (const jointName of jointNames) {
+        const matches = namedCandidates.get(jointName) || [];
+        if (matches.length !== 1) {
+            reportUnsupported(`cannot uniquely resolve joint ${jointName}`);
+            return null;
+        }
+        jointIndices.push(matches[0]);
+    }
+    const commonRoot = findCommonJointRoot(nodes, [...jointIndices, ...explicitRoots]);
+    if (commonRoot === undefined) {
+        reportUnsupported('joints have no unambiguous common hierarchy root');
+        return null;
+    }
+    return {
+        nodeIndex,
+        jointIndices,
+        skeletonIndex: explicitRoots.length === 1 ? explicitRoots[0] : commonRoot
+    };
+}
+/** Collect disjoint subtrees, rejecting missing nodes, cycles, and overlapping paths. */
+function collectSkeletonNodes(nodes, rootIndices) {
+    const visited = new Set();
+    const pending = [...rootIndices];
+    while (pending.length) {
+        const nodeIndex = pending.pop();
+        if (!Number.isSafeInteger(nodeIndex) || !nodes[nodeIndex] || visited.has(nodeIndex))
+            return null;
+        visited.add(nodeIndex);
+        pending.push(...(nodes[nodeIndex].children || []));
+    }
+    return Array.from(visited);
+}
+/** Find the closest common ancestor, rejecting cycles and multiply-parented node graphs. */
+function findCommonJointRoot(nodes, jointIndices) {
+    const parents = new Map();
+    for (const [nodeIndex, node] of nodes.entries()) {
+        for (const childIndex of node.children || []) {
+            if (!Number.isSafeInteger(childIndex) || !nodes[childIndex] || parents.has(childIndex))
+                return undefined;
+            parents.set(childIndex, nodeIndex);
+        }
+    }
+    const ancestorPaths = jointIndices.map(jointIndex => {
+        const path = [];
+        const visited = new Set();
+        let ancestorIndex = jointIndex;
+        while (ancestorIndex !== undefined) {
+            if (visited.has(ancestorIndex))
+                return [];
+            visited.add(ancestorIndex);
+            path.push(ancestorIndex);
+            ancestorIndex = parents.get(ancestorIndex);
+        }
+        return path;
+    });
+    const ancestorSets = ancestorPaths.map(path => new Set(path));
+    return ancestorPaths[0].find(ancestorIndex => ancestorSets.every(ancestors => ancestors.has(ancestorIndex)));
+}
+/** Check exact identity; even small non-identity values require actual matrix baking. */
+function isIdentityBindShape(matrix) {
+    return (Array.isArray(matrix) &&
+        matrix.length === 16 &&
+        Array.from(matrix).every((value, index) => value === (index % 5 === 0 ? 1 : 0)));
+}
+//# sourceMappingURL=convert-gltf-v1-skins.js.map

package/dist/gltf/lib/api/convert-gltf-v1-skins.js.map

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

package/dist/gltf/lib/api/gltf-accessors.cjs

@@ -0,0 +1,83 @@
+"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/api/gltf-accessors.ts
+var gltf_accessors_exports = {};
+__export(gltf_accessors_exports, {
+  getGLTFAccessor: () => getGLTFAccessor,
+  getGLTFAccessorValue: () => getGLTFAccessorValue,
+  setGLTFAccessorValue: () => setGLTFAccessorValue
+});
+module.exports = __toCommonJS(gltf_accessors_exports);
+var import_get_typed_array = require("../gltf-utils/get-typed-array.cjs");
+var import_gltf_utils = require("../gltf-utils/gltf-utils.cjs");
+var import_assert = require("../utils/assert.cjs");
+var import_loader_utils = require("@loaders.gl/core/loader-utils");
+function getGLTFAccessor(gltf, reference) {
+  const accessor = typeof reference === "number" ? gltf.json.accessors?.[reference] : reference;
+  (0, import_assert.assert)(accessor);
+  return accessor;
+}
+function getGLTFAccessorValue(gltf, reference) {
+  return (0, import_get_typed_array.getTypedArrayForAccessor)(gltf.json, gltf.buffers, reference);
+}
+function setGLTFAccessorValue(gltf, reference, value) {
+  const accessor = getGLTFAccessor(gltf, reference);
+  const componentType = (0, import_gltf_utils.getComponentTypeFromArray)(value);
+  const components = accessor.type.startsWith("MAT") ? Number(accessor.type.slice(3)) ** 2 : accessor.type === "SCALAR" ? 1 : Number(accessor.type.slice(3));
+  (0, import_assert.assert)(value.length === accessor.count * components);
+  const columns = accessor.type.startsWith("MAT") ? Number(accessor.type.slice(3)) : 1;
+  const columnByteLength = columns * value.BYTES_PER_ELEMENT;
+  const columnByteStride = (0, import_loader_utils.padToNBytes)(columnByteLength, 4);
+  let storage = {
+    arrayBuffer: value.buffer,
+    byteOffset: value.byteOffset,
+    byteLength: value.byteLength
+  };
+  if (columns > 1 && columnByteStride !== columnByteLength) {
+    const bytes = new Uint8Array(accessor.count * columns * columnByteStride);
+    const source = new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
+    for (let columnIndex = 0; columnIndex < accessor.count * columns; columnIndex++) {
+      bytes.set(
+        source.subarray(columnIndex * columnByteLength, (columnIndex + 1) * columnByteLength),
+        columnIndex * columnByteStride
+      );
+    }
+    storage = { arrayBuffer: bytes.buffer, byteOffset: 0, byteLength: bytes.byteLength };
+  }
+  const bufferIndex = Math.max(gltf.buffers.length, gltf.json.buffers?.length || 0);
+  gltf.json.buffers ||= [];
+  gltf.json.buffers[bufferIndex] = { byteLength: storage.byteLength };
+  gltf.buffers[bufferIndex] = storage;
+  gltf.json.bufferViews ||= [];
+  const bufferViews = gltf.json.bufferViews;
+  accessor.bufferView = bufferViews.length;
+  bufferViews.push({ buffer: bufferIndex, byteOffset: 0, byteLength: storage.byteLength });
+  accessor.byteOffset = 0;
+  accessor.componentType = componentType;
+  delete accessor.sparse;
+  delete accessor.value;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getGLTFAccessor,
+  getGLTFAccessorValue,
+  setGLTFAccessorValue
+});
+//# sourceMappingURL=gltf-accessors.cjs.map

package/dist/gltf/lib/api/gltf-accessors.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/gltf/lib/api/gltf-accessors.ts"],
+  "sourcesContent": ["// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\nimport type {BigTypedArray} from '@loaders.gl/core/schema';\nimport type {GLTFWithBuffers, GLTFAccessor} from '../types/gltf-types';\nimport {getTypedArrayForAccessor} from '../gltf-utils/get-typed-array';\nimport {getComponentTypeFromArray} from '../gltf-utils/gltf-utils';\nimport {assert} from '../utils/assert';\nimport {padToNBytes} from '@loaders.gl/core/loader-utils';\n\n/** Indexed or inline accessor, including optional values supplied by mesh decoders. */\nexport type GLTFAccessorReference = number | (GLTFAccessor & {value?: BigTypedArray});\n\n/** Resolve an indexed or decoder-provided inline accessor without linking the scene graph. */\nexport function getGLTFAccessor(\n  gltf: GLTFWithBuffers,\n  reference: GLTFAccessorReference\n): GLTFAccessor {\n  const accessor = typeof reference === 'number' ? gltf.json.accessors?.[reference] : reference;\n  assert(accessor);\n  return accessor!;\n}\n\n/**\n * Read packed accessor values without replacing JSON indices. Packed dense values borrow storage;\n * interleaved, unaligned, padded matrix and sparse values are materialized. Normalized integers\n * retain their stored values. Accessors without a buffer view start at zero; decoder values are\n * preserved. Sparse substitutions never modify input storage.\n */\nexport function getGLTFAccessorValue(\n  gltf: GLTFWithBuffers,\n  reference: GLTFAccessorReference\n): BigTypedArray {\n  return getTypedArrayForAccessor(gltf.json, gltf.buffers, reference);\n}\n\n/**\n * Replace accessor storage with a packed value, preserving index references and other accessors.\n * Packed storage borrows the supplied array; padded matrix columns are copied. Sparse and decoder overrides are cleared so reads,\n * encoders and writers observe the replacement. Bounds metadata remains caller-owned.\n */\nexport function setGLTFAccessorValue(\n  gltf: GLTFWithBuffers,\n  reference: GLTFAccessorReference,\n  value: BigTypedArray\n): void {\n  const accessor = getGLTFAccessor(gltf, reference);\n  const componentType = getComponentTypeFromArray(value);\n  const components = accessor.type.startsWith('MAT')\n    ? Number(accessor.type.slice(3)) ** 2\n    : accessor.type === 'SCALAR'\n      ? 1\n      : Number(accessor.type.slice(3));\n  assert(value.length === accessor.count * components);\n  const columns = accessor.type.startsWith('MAT') ? Number(accessor.type.slice(3)) : 1;\n  const columnByteLength = columns * value.BYTES_PER_ELEMENT;\n  const columnByteStride = padToNBytes(columnByteLength, 4);\n  let storage = {\n    arrayBuffer: value.buffer as ArrayBuffer,\n    byteOffset: value.byteOffset,\n    byteLength: value.byteLength\n  };\n  if (columns > 1 && columnByteStride !== columnByteLength) {\n    const bytes = new Uint8Array(accessor.count * columns * columnByteStride);\n    const source = new Uint8Array(value.buffer, value.byteOffset, value.byteLength);\n    for (let columnIndex = 0; columnIndex < accessor.count * columns; columnIndex++) {\n      bytes.set(\n        source.subarray(columnIndex * columnByteLength, (columnIndex + 1) * columnByteLength),\n        columnIndex * columnByteStride\n      );\n    }\n    storage = {arrayBuffer: bytes.buffer, byteOffset: 0, byteLength: bytes.byteLength};\n  }\n  const bufferIndex = Math.max(gltf.buffers.length, gltf.json.buffers?.length || 0);\n  gltf.json.buffers ||= [];\n  gltf.json.buffers[bufferIndex] = {byteLength: storage.byteLength};\n  gltf.buffers[bufferIndex] = storage;\n  gltf.json.bufferViews ||= [];\n  const bufferViews = gltf.json.bufferViews;\n  accessor.bufferView = bufferViews.length;\n  bufferViews.push({buffer: bufferIndex, byteOffset: 0, byteLength: storage.byteLength});\n  accessor.byteOffset = 0;\n  accessor.componentType = componentType;\n  delete accessor.sparse;\n  delete (accessor as GLTFAccessor & {value?: BigTypedArray}).value;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,6BAAuC;AACvC,wBAAwC;AACxC,oBAAqB;AACrB,0BAA0B;AAMnB,SAAS,gBACd,MACA,WACc;AACd,QAAM,WAAW,OAAO,cAAc,WAAW,KAAK,KAAK,YAAY,SAAS,IAAI;AACpF,4BAAO,QAAQ;AACf,SAAO;AACT;AAQO,SAAS,qBACd,MACA,WACe;AACf,aAAO,iDAAyB,KAAK,MAAM,KAAK,SAAS,SAAS;AACpE;AAOO,SAAS,qBACd,MACA,WACA,OACM;AACN,QAAM,WAAW,gBAAgB,MAAM,SAAS;AAChD,QAAM,oBAAgB,6CAA0B,KAAK;AACrD,QAAM,aAAa,SAAS,KAAK,WAAW,KAAK,IAC7C,OAAO,SAAS,KAAK,MAAM,CAAC,CAAC,KAAK,IAClC,SAAS,SAAS,WAChB,IACA,OAAO,SAAS,KAAK,MAAM,CAAC,CAAC;AACnC,4BAAO,MAAM,WAAW,SAAS,QAAQ,UAAU;AACnD,QAAM,UAAU,SAAS,KAAK,WAAW,KAAK,IAAI,OAAO,SAAS,KAAK,MAAM,CAAC,CAAC,IAAI;AACnF,QAAM,mBAAmB,UAAU,MAAM;AACzC,QAAM,uBAAmB,iCAAY,kBAAkB,CAAC;AACxD,MAAI,UAAU;AAAA,IACZ,aAAa,MAAM;AAAA,IACnB,YAAY,MAAM;AAAA,IAClB,YAAY,MAAM;AAAA,EACpB;AACA,MAAI,UAAU,KAAK,qBAAqB,kBAAkB;AACxD,UAAM,QAAQ,IAAI,WAAW,SAAS,QAAQ,UAAU,gBAAgB;AACxE,UAAM,SAAS,IAAI,WAAW,MAAM,QAAQ,MAAM,YAAY,MAAM,UAAU;AAC9E,aAAS,cAAc,GAAG,cAAc,SAAS,QAAQ,SAAS,eAAe;AAC/E,YAAM;AAAA,QACJ,OAAO,SAAS,cAAc,mBAAmB,cAAc,KAAK,gBAAgB;AAAA,QACpF,cAAc;AAAA,MAChB;AAAA,IACF;AACA,cAAU,EAAC,aAAa,MAAM,QAAQ,YAAY,GAAG,YAAY,MAAM,WAAU;AAAA,EACnF;AACA,QAAM,cAAc,KAAK,IAAI,KAAK,QAAQ,QAAQ,KAAK,KAAK,SAAS,UAAU,CAAC;AAChF,OAAK,KAAK,YAAY,CAAC;AACvB,OAAK,KAAK,QAAQ,WAAW,IAAI,EAAC,YAAY,QAAQ,WAAU;AAChE,OAAK,QAAQ,WAAW,IAAI;AAC5B,OAAK,KAAK,gBAAgB,CAAC;AAC3B,QAAM,cAAc,KAAK,KAAK;AAC9B,WAAS,aAAa,YAAY;AAClC,cAAY,KAAK,EAAC,QAAQ,aAAa,YAAY,GAAG,YAAY,QAAQ,WAAU,CAAC;AACrF,WAAS,aAAa;AACtB,WAAS,gBAAgB;AACzB,SAAO,SAAS;AAChB,SAAQ,SAAoD;AAC9D;",
+  "names": []
+}

package/dist/gltf/lib/api/gltf-accessors.d.ts

@@ -0,0 +1,22 @@
+import type { BigTypedArray } from '@loaders.gl/core/schema';
+import type { GLTFWithBuffers, GLTFAccessor } from "../types/gltf-types.js";
+/** Indexed or inline accessor, including optional values supplied by mesh decoders. */
+export type GLTFAccessorReference = number | (GLTFAccessor & {
+    value?: BigTypedArray;
+});
+/** Resolve an indexed or decoder-provided inline accessor without linking the scene graph. */
+export declare function getGLTFAccessor(gltf: GLTFWithBuffers, reference: GLTFAccessorReference): GLTFAccessor;
+/**
+ * Read packed accessor values without replacing JSON indices. Packed dense values borrow storage;
+ * interleaved, unaligned, padded matrix and sparse values are materialized. Normalized integers
+ * retain their stored values. Accessors without a buffer view start at zero; decoder values are
+ * preserved. Sparse substitutions never modify input storage.
+ */
+export declare function getGLTFAccessorValue(gltf: GLTFWithBuffers, reference: GLTFAccessorReference): BigTypedArray;
+/**
+ * Replace accessor storage with a packed value, preserving index references and other accessors.
+ * Packed storage borrows the supplied array; padded matrix columns are copied. Sparse and decoder overrides are cleared so reads,
+ * encoders and writers observe the replacement. Bounds metadata remains caller-owned.
+ */
+export declare function setGLTFAccessorValue(gltf: GLTFWithBuffers, reference: GLTFAccessorReference, value: BigTypedArray): void;
+//# sourceMappingURL=gltf-accessors.d.ts.map

package/dist/gltf/lib/api/gltf-accessors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gltf-accessors.d.ts","sourceRoot":"","sources":["../../../../src/gltf/lib/api/gltf-accessors.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAC,eAAe,EAAE,YAAY,EAAC,+BAA4B;AAMvE,uFAAuF;AACvF,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,CAAC,YAAY,GAAG;IAAC,KAAK,CAAC,EAAE,aAAa,CAAA;CAAC,CAAC,CAAC;AAEtF,8FAA8F;AAC9F,wBAAgB,eAAe,CAC7B,IAAI,EAAE,eAAe,EACrB,SAAS,EAAE,qBAAqB,GAC/B,YAAY,CAId;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,eAAe,EACrB,SAAS,EAAE,qBAAqB,GAC/B,aAAa,CAEf;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,eAAe,EACrB,SAAS,EAAE,qBAAqB,EAChC,KAAK,EAAE,aAAa,GACnB,IAAI,CAwCN"}

package/dist/gltf/lib/api/gltf-accessors.js

@@ -0,0 +1,66 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { getTypedArrayForAccessor } from "../gltf-utils/get-typed-array.js";
+import { getComponentTypeFromArray } from "../gltf-utils/gltf-utils.js";
+import { assert } from "../utils/assert.js";
+import { padToNBytes } from '@loaders.gl/core/loader-utils';
+/** Resolve an indexed or decoder-provided inline accessor without linking the scene graph. */
+export function getGLTFAccessor(gltf, reference) {
+    const accessor = typeof reference === 'number' ? gltf.json.accessors?.[reference] : reference;
+    assert(accessor);
+    return accessor;
+}
+/**
+ * Read packed accessor values without replacing JSON indices. Packed dense values borrow storage;
+ * interleaved, unaligned, padded matrix and sparse values are materialized. Normalized integers
+ * retain their stored values. Accessors without a buffer view start at zero; decoder values are
+ * preserved. Sparse substitutions never modify input storage.
+ */
+export function getGLTFAccessorValue(gltf, reference) {
+    return getTypedArrayForAccessor(gltf.json, gltf.buffers, reference);
+}
+/**
+ * Replace accessor storage with a packed value, preserving index references and other accessors.
+ * Packed storage borrows the supplied array; padded matrix columns are copied. Sparse and decoder overrides are cleared so reads,
+ * encoders and writers observe the replacement. Bounds metadata remains caller-owned.
+ */
+export function setGLTFAccessorValue(gltf, reference, value) {
+    const accessor = getGLTFAccessor(gltf, reference);
+    const componentType = getComponentTypeFromArray(value);
+    const components = accessor.type.startsWith('MAT')
+        ? Number(accessor.type.slice(3)) ** 2
+        : accessor.type === 'SCALAR'
+            ? 1
+            : Number(accessor.type.slice(3));
+    assert(value.length === accessor.count * components);
+    const columns = accessor.type.startsWith('MAT') ? Number(accessor.type.slice(3)) : 1;
+    const columnByteLength = columns * value.BYTES_PER_ELEMENT;
+    const columnByteStride = padToNBytes(columnByteLength, 4);
+    let storage = {
+        arrayBuffer: value.buffer,
+        byteOffset: value.byteOffset,
+        byteLength: value.byteLength
+    };
+    if (columns > 1 && columnByteStride !== columnByteLength) {
+        const bytes = new Uint8Array(accessor.count * columns * columnByteStride);
+        const source = new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
+        for (let columnIndex = 0; columnIndex < accessor.count * columns; columnIndex++) {
+            bytes.set(source.subarray(columnIndex * columnByteLength, (columnIndex + 1) * columnByteLength), columnIndex * columnByteStride);
+        }
+        storage = { arrayBuffer: bytes.buffer, byteOffset: 0, byteLength: bytes.byteLength };
+    }
+    const bufferIndex = Math.max(gltf.buffers.length, gltf.json.buffers?.length || 0);
+    gltf.json.buffers ||= [];
+    gltf.json.buffers[bufferIndex] = { byteLength: storage.byteLength };
+    gltf.buffers[bufferIndex] = storage;
+    gltf.json.bufferViews ||= [];
+    const bufferViews = gltf.json.bufferViews;
+    accessor.bufferView = bufferViews.length;
+    bufferViews.push({ buffer: bufferIndex, byteOffset: 0, byteLength: storage.byteLength });
+    accessor.byteOffset = 0;
+    accessor.componentType = componentType;
+    delete accessor.sparse;
+    delete accessor.value;
+}
+//# sourceMappingURL=gltf-accessors.js.map

package/dist/gltf/lib/api/gltf-accessors.js.map

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

package/dist/gltf/lib/api/gltf-culling.cjs

@@ -0,0 +1,73 @@
+"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/api/gltf-culling.ts
+var gltf_culling_exports = {};
+__export(gltf_culling_exports, {
+  getGLTFCullingShape: () => getGLTFCullingShape,
+  getGLTFNodeCullingShape: () => getGLTFNodeCullingShape
+});
+module.exports = __toCommonJS(gltf_culling_exports);
+var import_culling = require("@math.gl/geometry/culling");
+var import_core = require("@math.gl/core");
+function getGLTFCullingShape(gltf, shapeIndex, options = {}) {
+  const shape = gltf.json.shapes?.[shapeIndex];
+  if (!shape) throw new Error(`Invalid glTF shape reference: /shapes/${shapeIndex}`);
+  switch (shape.type) {
+    case "box":
+      return new import_culling.BoxShape({ size: shape.box?.size, matrix: options.matrix });
+    case "capsule":
+      return new import_culling.CapsuleShape({ ...shape.capsule, matrix: options.matrix });
+    case "cylinder":
+      return new import_culling.CylinderShape({ ...shape.cylinder, matrix: options.matrix });
+    case "plane":
+      return new import_culling.PlaneShape({ ...shape.plane, matrix: options.matrix });
+    case "sphere":
+      return new import_culling.SphereShape({ ...shape.sphere, matrix: options.matrix });
+    default:
+      return void 0;
+  }
+}
+function getGLTFNodeCullingShape(gltf, nodeIndex, options = {}) {
+  const node = gltf.json.nodes?.[nodeIndex];
+  if (!node) throw new Error(`Invalid glTF node reference: /nodes/${nodeIndex}`);
+  const boundingVolume = node.boundingVolume;
+  if (!boundingVolume) return void 0;
+  const shape = getGLTFCullingShape(gltf, boundingVolume.shape, {
+    matrix: getBoundingVolumeMatrix(boundingVolume)
+  });
+  if (shape && options.matrix) shape.transform(options.matrix);
+  return shape;
+}
+function getBoundingVolumeMatrix(boundingVolume) {
+  if (boundingVolume.matrix) {
+    return boundingVolume.matrix;
+  }
+  if (!boundingVolume.translation && !boundingVolume.rotation && !boundingVolume.scale) {
+    return void 0;
+  }
+  const rotationMatrix = new import_core.Matrix4().fromQuaternion(boundingVolume.rotation || [0, 0, 0, 1]);
+  return new import_core.Matrix4().translate(boundingVolume.translation || [0, 0, 0]).multiplyRight(rotationMatrix).scale(boundingVolume.scale || [1, 1, 1]);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getGLTFCullingShape,
+  getGLTFNodeCullingShape
+});
+//# sourceMappingURL=gltf-culling.cjs.map

package/dist/gltf/lib/api/gltf-culling.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/gltf/lib/api/gltf-culling.ts"],
+  "sourcesContent": ["// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\nimport {\n  BoxShape,\n  CapsuleShape,\n  CylinderShape,\n  PlaneShape,\n  SphereShape\n} from '@math.gl/geometry/culling';\nimport type {ImplicitShape} from '@math.gl/geometry/culling';\nimport type {GLTFBoundingVolume, GLTFShape} from '../types/gltf-shape-schema';\nimport type {GLTFWithBuffers} from '../types/gltf-types';\nimport {Matrix4} from '@math.gl/core';\n\n/** Options for resolving a glTF 2.1 shape. */\nexport type GLTFCullingShapeOptions = {\n  /** Optional transform applied after the shape's own local transform. */\n  matrix?: readonly number[];\n};\n\n/** Resolve a draft glTF 2.1 shape into the corresponding math.gl analytic shape. */\nexport function getGLTFCullingShape(\n  gltf: GLTFWithBuffers,\n  shapeIndex: number,\n  options: GLTFCullingShapeOptions = {}\n): ImplicitShape | undefined {\n  const shape = gltf.json.shapes?.[shapeIndex] as GLTFShape | undefined;\n  if (!shape) throw new Error(`Invalid glTF shape reference: /shapes/${shapeIndex}`);\n\n  switch (shape.type) {\n    case 'box':\n      return new BoxShape({size: shape.box?.size, matrix: options.matrix});\n    case 'capsule':\n      return new CapsuleShape({...shape.capsule, matrix: options.matrix});\n    case 'cylinder':\n      return new CylinderShape({...shape.cylinder, matrix: options.matrix});\n    case 'plane':\n      return new PlaneShape({...shape.plane, matrix: options.matrix});\n    case 'sphere':\n      return new SphereShape({...shape.sphere, matrix: options.matrix});\n    default:\n      return undefined;\n  }\n}\n\n/** Resolve a node's draft glTF 2.1 bounding volume, including its local matrix. */\nexport function getGLTFNodeCullingShape(\n  gltf: GLTFWithBuffers,\n  nodeIndex: number,\n  options: GLTFCullingShapeOptions = {}\n): ImplicitShape | undefined {\n  const node = gltf.json.nodes?.[nodeIndex];\n  if (!node) throw new Error(`Invalid glTF node reference: /nodes/${nodeIndex}`);\n  const boundingVolume = node.boundingVolume as GLTFBoundingVolume | undefined;\n  if (!boundingVolume) return undefined;\n  const shape = getGLTFCullingShape(gltf, boundingVolume.shape, {\n    matrix: getBoundingVolumeMatrix(boundingVolume)\n  });\n  if (shape && options.matrix) shape.transform(options.matrix);\n  return shape;\n}\n\n/** Compose a bounding-volume matrix from its matrix or TRS representation. */\nfunction getBoundingVolumeMatrix(\n  boundingVolume: GLTFBoundingVolume\n): readonly number[] | undefined {\n  if (boundingVolume.matrix) {\n    return boundingVolume.matrix;\n  }\n  if (!boundingVolume.translation && !boundingVolume.rotation && !boundingVolume.scale) {\n    return undefined;\n  }\n  const rotationMatrix = new Matrix4().fromQuaternion(boundingVolume.rotation || [0, 0, 0, 1]);\n  return new Matrix4()\n    .translate(boundingVolume.translation || [0, 0, 0])\n    .multiplyRight(rotationMatrix)\n    .scale(boundingVolume.scale || [1, 1, 1]);\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,qBAMO;AAIP,kBAAsB;AASf,SAAS,oBACd,MACA,YACA,UAAmC,CAAC,GACT;AAC3B,QAAM,QAAQ,KAAK,KAAK,SAAS,UAAU;AAC3C,MAAI,CAAC,MAAO,OAAM,IAAI,MAAM,yCAAyC,UAAU,EAAE;AAEjF,UAAQ,MAAM,MAAM;AAAA,IAClB,KAAK;AACH,aAAO,IAAI,wBAAS,EAAC,MAAM,MAAM,KAAK,MAAM,QAAQ,QAAQ,OAAM,CAAC;AAAA,IACrE,KAAK;AACH,aAAO,IAAI,4BAAa,EAAC,GAAG,MAAM,SAAS,QAAQ,QAAQ,OAAM,CAAC;AAAA,IACpE,KAAK;AACH,aAAO,IAAI,6BAAc,EAAC,GAAG,MAAM,UAAU,QAAQ,QAAQ,OAAM,CAAC;AAAA,IACtE,KAAK;AACH,aAAO,IAAI,0BAAW,EAAC,GAAG,MAAM,OAAO,QAAQ,QAAQ,OAAM,CAAC;AAAA,IAChE,KAAK;AACH,aAAO,IAAI,2BAAY,EAAC,GAAG,MAAM,QAAQ,QAAQ,QAAQ,OAAM,CAAC;AAAA,IAClE;AACE,aAAO;AAAA,EACX;AACF;AAGO,SAAS,wBACd,MACA,WACA,UAAmC,CAAC,GACT;AAC3B,QAAM,OAAO,KAAK,KAAK,QAAQ,SAAS;AACxC,MAAI,CAAC,KAAM,OAAM,IAAI,MAAM,uCAAuC,SAAS,EAAE;AAC7E,QAAM,iBAAiB,KAAK;AAC5B,MAAI,CAAC,eAAgB,QAAO;AAC5B,QAAM,QAAQ,oBAAoB,MAAM,eAAe,OAAO;AAAA,IAC5D,QAAQ,wBAAwB,cAAc;AAAA,EAChD,CAAC;AACD,MAAI,SAAS,QAAQ,OAAQ,OAAM,UAAU,QAAQ,MAAM;AAC3D,SAAO;AACT;AAGA,SAAS,wBACP,gBAC+B;AAC/B,MAAI,eAAe,QAAQ;AACzB,WAAO,eAAe;AAAA,EACxB;AACA,MAAI,CAAC,eAAe,eAAe,CAAC,eAAe,YAAY,CAAC,eAAe,OAAO;AACpF,WAAO;AAAA,EACT;AACA,QAAM,iBAAiB,IAAI,oBAAQ,EAAE,eAAe,eAAe,YAAY,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;AAC3F,SAAO,IAAI,oBAAQ,EAChB,UAAU,eAAe,eAAe,CAAC,GAAG,GAAG,CAAC,CAAC,EACjD,cAAc,cAAc,EAC5B,MAAM,eAAe,SAAS,CAAC,GAAG,GAAG,CAAC,CAAC;AAC5C;",
+  "names": []
+}

package/dist/gltf/lib/api/gltf-culling.d.ts

@@ -0,0 +1,12 @@
+import type { ImplicitShape } from '@math.gl/geometry/culling';
+import type { GLTFWithBuffers } from "../types/gltf-types.js";
+/** Options for resolving a glTF 2.1 shape. */
+export type GLTFCullingShapeOptions = {
+    /** Optional transform applied after the shape's own local transform. */
+    matrix?: readonly number[];
+};
+/** Resolve a draft glTF 2.1 shape into the corresponding math.gl analytic shape. */
+export declare function getGLTFCullingShape(gltf: GLTFWithBuffers, shapeIndex: number, options?: GLTFCullingShapeOptions): ImplicitShape | undefined;
+/** Resolve a node's draft glTF 2.1 bounding volume, including its local matrix. */
+export declare function getGLTFNodeCullingShape(gltf: GLTFWithBuffers, nodeIndex: number, options?: GLTFCullingShapeOptions): ImplicitShape | undefined;
+//# sourceMappingURL=gltf-culling.d.ts.map

package/dist/gltf/lib/api/gltf-culling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gltf-culling.d.ts","sourceRoot":"","sources":["../../../../src/gltf/lib/api/gltf-culling.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,2BAA2B,CAAC;AAE7D,OAAO,KAAK,EAAC,eAAe,EAAC,+BAA4B;AAGzD,8CAA8C;AAC9C,MAAM,MAAM,uBAAuB,GAAG;IACpC,wEAAwE;IACxE,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B,CAAC;AAEF,oFAAoF;AACpF,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,eAAe,EACrB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,uBAA4B,GACpC,aAAa,GAAG,SAAS,CAkB3B;AAED,mFAAmF;AACnF,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,eAAe,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,uBAA4B,GACpC,aAAa,GAAG,SAAS,CAU3B"}

package/dist/gltf/lib/api/gltf-culling.js

@@ -0,0 +1,55 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { BoxShape, CapsuleShape, CylinderShape, PlaneShape, SphereShape } from '@math.gl/geometry/culling';
+import { Matrix4 } from '@math.gl/core';
+/** Resolve a draft glTF 2.1 shape into the corresponding math.gl analytic shape. */
+export function getGLTFCullingShape(gltf, shapeIndex, options = {}) {
+    const shape = gltf.json.shapes?.[shapeIndex];
+    if (!shape)
+        throw new Error(`Invalid glTF shape reference: /shapes/${shapeIndex}`);
+    switch (shape.type) {
+        case 'box':
+            return new BoxShape({ size: shape.box?.size, matrix: options.matrix });
+        case 'capsule':
+            return new CapsuleShape({ ...shape.capsule, matrix: options.matrix });
+        case 'cylinder':
+            return new CylinderShape({ ...shape.cylinder, matrix: options.matrix });
+        case 'plane':
+            return new PlaneShape({ ...shape.plane, matrix: options.matrix });
+        case 'sphere':
+            return new SphereShape({ ...shape.sphere, matrix: options.matrix });
+        default:
+            return undefined;
+    }
+}
+/** Resolve a node's draft glTF 2.1 bounding volume, including its local matrix. */
+export function getGLTFNodeCullingShape(gltf, nodeIndex, options = {}) {
+    const node = gltf.json.nodes?.[nodeIndex];
+    if (!node)
+        throw new Error(`Invalid glTF node reference: /nodes/${nodeIndex}`);
+    const boundingVolume = node.boundingVolume;
+    if (!boundingVolume)
+        return undefined;
+    const shape = getGLTFCullingShape(gltf, boundingVolume.shape, {
+        matrix: getBoundingVolumeMatrix(boundingVolume)
+    });
+    if (shape && options.matrix)
+        shape.transform(options.matrix);
+    return shape;
+}
+/** Compose a bounding-volume matrix from its matrix or TRS representation. */
+function getBoundingVolumeMatrix(boundingVolume) {
+    if (boundingVolume.matrix) {
+        return boundingVolume.matrix;
+    }
+    if (!boundingVolume.translation && !boundingVolume.rotation && !boundingVolume.scale) {
+        return undefined;
+    }
+    const rotationMatrix = new Matrix4().fromQuaternion(boundingVolume.rotation || [0, 0, 0, 1]);
+    return new Matrix4()
+        .translate(boundingVolume.translation || [0, 0, 0])
+        .multiplyRight(rotationMatrix)
+        .scale(boundingVolume.scale || [1, 1, 1]);
+}
+//# sourceMappingURL=gltf-culling.js.map

package/dist/gltf/lib/api/gltf-culling.js.map

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