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

package/dist/gltf/lib/api/bake-gltf-v1-bind-shapes.cjs

@@ -0,0 +1,133 @@
+"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/bake-gltf-v1-bind-shapes.ts
+var bake_gltf_v1_bind_shapes_exports = {};
+__export(bake_gltf_v1_bind_shapes_exports, {
+  bakeGLTFV1BindShapes: () => bakeGLTFV1BindShapes
+});
+module.exports = __toCommonJS(bake_gltf_v1_bind_shapes_exports);
+var import_append_gltf_v1_buffer_data = require("./append-gltf-v1-buffer-data.cjs");
+function bakeGLTFV1BindShapes(gltf, reportUnsupported) {
+  const plannedBindings = /* @__PURE__ */ new Map();
+  for (const [skinIndex, skin] of (gltf.json.skins || []).entries()) {
+    if (skin.bindShapeMatrix === void 0) continue;
+    const bindShapeMatrix = skin.bindShapeMatrix;
+    if (!isFiniteAffineMatrix(bindShapeMatrix)) {
+      reportUnsupported(
+        `skin ${skinIndex} non-identity bindShapeMatrix requires a finite affine matrix`
+      );
+      continue;
+    }
+    const bindingKey = `${skin.inverseBindMatrices}:${bindShapeMatrix.join(",")}`;
+    const existingPlan = plannedBindings.get(bindingKey);
+    if (existingPlan) {
+      if ((skin.joints || skin.jointNames || []).length > existingPlan.count) {
+        reportUnsupported(
+          `skin ${skinIndex} non-identity bindShapeMatrix has too few inverse-bind matrices`
+        );
+        continue;
+      }
+      existingPlan.skins.push(skin);
+      continue;
+    }
+    const plan = prepareBindShapeBake(gltf, skin, bindShapeMatrix);
+    if (typeof plan === "string") {
+      reportUnsupported(`skin ${skinIndex} non-identity bindShapeMatrix ${plan}`);
+      continue;
+    }
+    plannedBindings.set(bindingKey, plan);
+  }
+  (0, import_append_gltf_v1_buffer_data.appendGLTFV1BufferData)(
+    gltf,
+    Array.from(plannedBindings.values(), (plan) => ({
+      bufferIndex: plan.bufferIndex,
+      bytes: plan.matrixBytes,
+      apply: (bufferViewIndex) => {
+        gltf.json.accessors ||= [];
+        const accessorIndex = gltf.json.accessors.length;
+        gltf.json.accessors.push({
+          bufferView: bufferViewIndex,
+          byteOffset: 0,
+          componentType: 5126,
+          count: plan.count,
+          type: "MAT4"
+        });
+        for (const skin of plan.skins) {
+          skin.inverseBindMatrices = accessorIndex;
+          delete skin.bindShapeMatrix;
+        }
+      }
+    }))
+  );
+}
+function prepareBindShapeBake(gltf, skin, bindShapeMatrix) {
+  const accessor = gltf.json.accessors?.[skin.inverseBindMatrices];
+  const jointCount = (skin.joints || skin.jointNames || []).length;
+  if (!accessor || accessor.componentType !== 5126 || accessor.type !== "MAT4" || accessor.normalized || accessor.sparse || accessor.extensions || Object.hasOwn(accessor, "byteStride") || !Number.isSafeInteger(accessor.count) || accessor.count < 1)
+    return "requires packed FLOAT MAT4 inverse-bind matrices";
+  if (accessor.count < jointCount) return "has too few inverse-bind matrices";
+  const bufferView = gltf.json.bufferViews?.[accessor.bufferView];
+  const bufferIndex = bufferView?.buffer;
+  const bufferDefinition = gltf.json.buffers?.[bufferIndex];
+  const loadedBuffer = gltf.buffers[bufferIndex];
+  if (!bufferView || bufferIndex === void 0 || !bufferDefinition || !loadedBuffer)
+    return "requires a loaded inverse-bind buffer";
+  if (bufferView.extensions) return "does not support inverse-bind buffer-view extensions";
+  const bufferViewByteOffset = bufferView.byteOffset ?? 0;
+  const accessorByteOffset = accessor.byteOffset ?? 0;
+  const matrixByteLength = accessor.count * 64;
+  if (!(loadedBuffer.arrayBuffer instanceof ArrayBuffer) || !Number.isSafeInteger(bufferDefinition.byteLength) || bufferDefinition.byteLength < 1 || !Number.isSafeInteger(loadedBuffer.byteOffset) || loadedBuffer.byteOffset < 0 || !Number.isSafeInteger(loadedBuffer.byteLength) || loadedBuffer.byteLength < bufferDefinition.byteLength || loadedBuffer.byteOffset + loadedBuffer.byteLength > loadedBuffer.arrayBuffer.byteLength || !Number.isSafeInteger(bufferViewByteOffset) || bufferViewByteOffset < 0 || bufferViewByteOffset % 4 !== 0 || !Number.isSafeInteger(bufferView.byteLength) || bufferView.byteLength < 1 || bufferView.byteStride !== void 0 || bufferViewByteOffset + bufferView.byteLength > bufferDefinition.byteLength || !Number.isSafeInteger(accessorByteOffset) || accessorByteOffset < 0 || accessorByteOffset % 4 !== 0 || accessorByteOffset + matrixByteLength > bufferView.byteLength)
+    return "has an invalid inverse-bind buffer layout";
+  const sourceData = new DataView(loadedBuffer.arrayBuffer);
+  const sourceByteOffset = loadedBuffer.byteOffset + bufferViewByteOffset + accessorByteOffset;
+  const matrixBytes = new ArrayBuffer(matrixByteLength);
+  const outputData = new DataView(matrixBytes);
+  for (let matrixIndex = 0; matrixIndex < accessor.count; matrixIndex++) {
+    const inverseBindMatrix = Array.from(
+      { length: 16 },
+      (_, componentIndex) => sourceData.getFloat32(sourceByteOffset + matrixIndex * 64 + componentIndex * 4, true)
+    );
+    if (!isFiniteAffineMatrix(inverseBindMatrix))
+      return "requires finite affine inverse-bind matrices";
+    for (let columnIndex = 0; columnIndex < 4; columnIndex++) {
+      for (let rowIndex = 0; rowIndex < 4; rowIndex++) {
+        let value = 0;
+        for (let innerIndex = 0; innerIndex < 4; innerIndex++) {
+          value += inverseBindMatrix[innerIndex * 4 + rowIndex] * bindShapeMatrix[columnIndex * 4 + innerIndex];
+        }
+        if (!Number.isFinite(Math.fround(value))) return "produces non-finite FLOAT matrix values";
+        outputData.setFloat32(matrixIndex * 64 + (columnIndex * 4 + rowIndex) * 4, value, true);
+      }
+    }
+  }
+  return { bufferIndex, count: accessor.count, matrixBytes, skins: [skin] };
+}
+function isFiniteAffineMatrix(matrix) {
+  if (!Array.isArray(matrix) || matrix.length !== 16) return false;
+  for (let componentIndex = 0; componentIndex < 16; componentIndex++) {
+    if (!Number.isFinite(matrix[componentIndex])) return false;
+  }
+  return matrix[3] === 0 && matrix[7] === 0 && matrix[11] === 0 && matrix[15] === 1;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  bakeGLTFV1BindShapes
+});
+//# sourceMappingURL=bake-gltf-v1-bind-shapes.cjs.map

package/dist/gltf/lib/api/bake-gltf-v1-bind-shapes.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/gltf/lib/api/bake-gltf-v1-bind-shapes.ts"],
+  "sourcesContent": ["// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\nimport {appendGLTFV1BufferData} from './append-gltf-v1-buffer-data';\nimport type {GLTFWithBuffers, GLTFSkin} from '../types/gltf-types';\n\n/** Skin metadata retained until its legacy transform has been baked. */\ntype BindShapeSkin = GLTFSkin & {\n  /** Column-major transform applied before inverse-bind matrices. */\n  bindShapeMatrix?: number[];\n  /** Joint names retained on an unresolved best-effort binding. */\n  jointNames?: string[];\n};\n\n/** Validated matrix data to append without overwriting shared source accessors. */\ntype BindShapeBake = {\n  /** Source buffer receiving this appended payload. */\n  bufferIndex: number;\n  /** Number of matrices, preserving source accessor order. */\n  count: number;\n  /** Packed little-endian FLOAT MAT4 values. */\n  matrixBytes: ArrayBuffer;\n  /** Equivalent skin instances sharing this baked accessor. */\n  skins: BindShapeSkin[];\n};\n\n/**\n * Bake affine bind shapes as `inverseBindMatrix * bindShapeMatrix`.\n * New matrices are appended to copied source buffers, leaving shared accessors and caller bytes\n * unchanged. Each changed buffer is copied once; URI-backed buffers receive updated data URIs.\n */\nexport function bakeGLTFV1BindShapes(\n  gltf: GLTFWithBuffers,\n  reportUnsupported: (feature: string) => void\n): void {\n  const plannedBindings = new Map<string, BindShapeBake>();\n\n  for (const [skinIndex, skin] of ((gltf.json.skins || []) as BindShapeSkin[]).entries()) {\n    if (skin.bindShapeMatrix === undefined) continue;\n    const bindShapeMatrix = skin.bindShapeMatrix;\n    if (!isFiniteAffineMatrix(bindShapeMatrix)) {\n      reportUnsupported(\n        `skin ${skinIndex} non-identity bindShapeMatrix requires a finite affine matrix`\n      );\n      continue;\n    }\n    const bindingKey = `${skin.inverseBindMatrices}:${bindShapeMatrix.join(',')}`;\n    const existingPlan = plannedBindings.get(bindingKey);\n    if (existingPlan) {\n      if ((skin.joints || skin.jointNames || []).length > existingPlan.count) {\n        reportUnsupported(\n          `skin ${skinIndex} non-identity bindShapeMatrix has too few inverse-bind matrices`\n        );\n        continue;\n      }\n      existingPlan.skins.push(skin);\n      continue;\n    }\n    const plan = prepareBindShapeBake(gltf, skin, bindShapeMatrix);\n    if (typeof plan === 'string') {\n      reportUnsupported(`skin ${skinIndex} non-identity bindShapeMatrix ${plan}`);\n      continue;\n    }\n    plannedBindings.set(bindingKey, plan);\n  }\n  appendGLTFV1BufferData(\n    gltf,\n    Array.from(plannedBindings.values(), plan => ({\n      bufferIndex: plan.bufferIndex,\n      bytes: plan.matrixBytes,\n      apply: bufferViewIndex => {\n        gltf.json.accessors ||= [];\n        const accessorIndex = gltf.json.accessors.length;\n        gltf.json.accessors.push({\n          bufferView: bufferViewIndex,\n          byteOffset: 0,\n          componentType: 5126,\n          count: plan.count,\n          type: 'MAT4'\n        });\n        for (const skin of plan.skins) {\n          skin.inverseBindMatrices = accessorIndex;\n          delete skin.bindShapeMatrix;\n        }\n      }\n    }))\n  );\n}\n\n/** Validate the source and calculate a complete payload before committing any buffer changes. */\nfunction prepareBindShapeBake(\n  gltf: GLTFWithBuffers,\n  skin: BindShapeSkin,\n  bindShapeMatrix: number[]\n): BindShapeBake | string {\n  const accessor = gltf.json.accessors?.[skin.inverseBindMatrices as number];\n  const jointCount = (skin.joints || skin.jointNames || []).length;\n  if (\n    !accessor ||\n    accessor.componentType !== 5126 ||\n    accessor.type !== 'MAT4' ||\n    accessor.normalized ||\n    accessor.sparse ||\n    accessor.extensions ||\n    Object.hasOwn(accessor, 'byteStride') ||\n    !Number.isSafeInteger(accessor.count) ||\n    accessor.count < 1\n  )\n    return 'requires packed FLOAT MAT4 inverse-bind matrices';\n  if (accessor.count < jointCount) return 'has too few inverse-bind matrices';\n  const bufferView = gltf.json.bufferViews?.[accessor.bufferView as number];\n  const bufferIndex = bufferView?.buffer;\n  const bufferDefinition = gltf.json.buffers?.[bufferIndex as number];\n  const loadedBuffer = gltf.buffers[bufferIndex as number];\n  if (!bufferView || bufferIndex === undefined || !bufferDefinition || !loadedBuffer)\n    return 'requires a loaded inverse-bind buffer';\n  if (bufferView.extensions) return 'does not support inverse-bind buffer-view extensions';\n  const bufferViewByteOffset = bufferView.byteOffset ?? 0;\n  const accessorByteOffset = accessor.byteOffset ?? 0;\n  const matrixByteLength = accessor.count * 64;\n  if (\n    !(loadedBuffer.arrayBuffer instanceof ArrayBuffer) ||\n    !Number.isSafeInteger(bufferDefinition.byteLength) ||\n    bufferDefinition.byteLength < 1 ||\n    !Number.isSafeInteger(loadedBuffer.byteOffset) ||\n    loadedBuffer.byteOffset < 0 ||\n    !Number.isSafeInteger(loadedBuffer.byteLength) ||\n    loadedBuffer.byteLength < bufferDefinition.byteLength ||\n    loadedBuffer.byteOffset + loadedBuffer.byteLength > loadedBuffer.arrayBuffer.byteLength ||\n    !Number.isSafeInteger(bufferViewByteOffset) ||\n    bufferViewByteOffset < 0 ||\n    bufferViewByteOffset % 4 !== 0 ||\n    !Number.isSafeInteger(bufferView.byteLength) ||\n    bufferView.byteLength < 1 ||\n    bufferView.byteStride !== undefined ||\n    bufferViewByteOffset + bufferView.byteLength > bufferDefinition.byteLength ||\n    !Number.isSafeInteger(accessorByteOffset) ||\n    accessorByteOffset < 0 ||\n    accessorByteOffset % 4 !== 0 ||\n    accessorByteOffset + matrixByteLength > bufferView.byteLength\n  )\n    return 'has an invalid inverse-bind buffer layout';\n\n  const sourceData = new DataView(loadedBuffer.arrayBuffer);\n  const sourceByteOffset = loadedBuffer.byteOffset + bufferViewByteOffset + accessorByteOffset;\n  const matrixBytes = new ArrayBuffer(matrixByteLength);\n  const outputData = new DataView(matrixBytes);\n  for (let matrixIndex = 0; matrixIndex < accessor.count; matrixIndex++) {\n    const inverseBindMatrix = Array.from({length: 16}, (_, componentIndex) =>\n      sourceData.getFloat32(sourceByteOffset + matrixIndex * 64 + componentIndex * 4, true)\n    );\n    if (!isFiniteAffineMatrix(inverseBindMatrix))\n      return 'requires finite affine inverse-bind matrices';\n    for (let columnIndex = 0; columnIndex < 4; columnIndex++) {\n      for (let rowIndex = 0; rowIndex < 4; rowIndex++) {\n        let value = 0;\n        for (let innerIndex = 0; innerIndex < 4; innerIndex++) {\n          value +=\n            inverseBindMatrix[innerIndex * 4 + rowIndex] *\n            bindShapeMatrix[columnIndex * 4 + innerIndex];\n        }\n        if (!Number.isFinite(Math.fround(value))) return 'produces non-finite FLOAT matrix values';\n        outputData.setFloat32(matrixIndex * 64 + (columnIndex * 4 + rowIndex) * 4, value, true);\n      }\n    }\n  }\n  return {bufferIndex, count: accessor.count, matrixBytes, skins: [skin]};\n}\n\n/** Check glTF 2's finite values and required affine fourth row, including sparse JS arrays. */\nfunction isFiniteAffineMatrix(matrix: unknown): matrix is number[] {\n  if (!Array.isArray(matrix) || matrix.length !== 16) return false;\n  for (let componentIndex = 0; componentIndex < 16; componentIndex++) {\n    if (!Number.isFinite(matrix[componentIndex])) return false;\n  }\n  return matrix[3] === 0 && matrix[7] === 0 && matrix[11] === 0 && matrix[15] === 1;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/gltf/lib/api/bake-gltf-v1-bind-shapes.d.ts

@@ -0,0 +1,8 @@
+import type { GLTFWithBuffers } from "../types/gltf-types.js";
+/**
+ * Bake affine bind shapes as `inverseBindMatrix * bindShapeMatrix`.
+ * New matrices are appended to copied source buffers, leaving shared accessors and caller bytes
+ * unchanged. Each changed buffer is copied once; URI-backed buffers receive updated data URIs.
+ */
+export declare function bakeGLTFV1BindShapes(gltf: GLTFWithBuffers, reportUnsupported: (feature: string) => void): void;
+//# sourceMappingURL=bake-gltf-v1-bind-shapes.d.ts.map

package/dist/gltf/lib/api/bake-gltf-v1-bind-shapes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bake-gltf-v1-bind-shapes.d.ts","sourceRoot":"","sources":["../../../../src/gltf/lib/api/bake-gltf-v1-bind-shapes.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,eAAe,EAAW,+BAA4B;AAsBnE;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,eAAe,EACrB,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAC3C,IAAI,CAqDN"}

package/dist/gltf/lib/api/bake-gltf-v1-bind-shapes.js

@@ -0,0 +1,138 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { appendGLTFV1BufferData } from "./append-gltf-v1-buffer-data.js";
+/**
+ * Bake affine bind shapes as `inverseBindMatrix * bindShapeMatrix`.
+ * New matrices are appended to copied source buffers, leaving shared accessors and caller bytes
+ * unchanged. Each changed buffer is copied once; URI-backed buffers receive updated data URIs.
+ */
+export function bakeGLTFV1BindShapes(gltf, reportUnsupported) {
+    const plannedBindings = new Map();
+    for (const [skinIndex, skin] of (gltf.json.skins || []).entries()) {
+        if (skin.bindShapeMatrix === undefined)
+            continue;
+        const bindShapeMatrix = skin.bindShapeMatrix;
+        if (!isFiniteAffineMatrix(bindShapeMatrix)) {
+            reportUnsupported(`skin ${skinIndex} non-identity bindShapeMatrix requires a finite affine matrix`);
+            continue;
+        }
+        const bindingKey = `${skin.inverseBindMatrices}:${bindShapeMatrix.join(',')}`;
+        const existingPlan = plannedBindings.get(bindingKey);
+        if (existingPlan) {
+            if ((skin.joints || skin.jointNames || []).length > existingPlan.count) {
+                reportUnsupported(`skin ${skinIndex} non-identity bindShapeMatrix has too few inverse-bind matrices`);
+                continue;
+            }
+            existingPlan.skins.push(skin);
+            continue;
+        }
+        const plan = prepareBindShapeBake(gltf, skin, bindShapeMatrix);
+        if (typeof plan === 'string') {
+            reportUnsupported(`skin ${skinIndex} non-identity bindShapeMatrix ${plan}`);
+            continue;
+        }
+        plannedBindings.set(bindingKey, plan);
+    }
+    appendGLTFV1BufferData(gltf, Array.from(plannedBindings.values(), plan => ({
+        bufferIndex: plan.bufferIndex,
+        bytes: plan.matrixBytes,
+        apply: bufferViewIndex => {
+            gltf.json.accessors ||= [];
+            const accessorIndex = gltf.json.accessors.length;
+            gltf.json.accessors.push({
+                bufferView: bufferViewIndex,
+                byteOffset: 0,
+                componentType: 5126,
+                count: plan.count,
+                type: 'MAT4'
+            });
+            for (const skin of plan.skins) {
+                skin.inverseBindMatrices = accessorIndex;
+                delete skin.bindShapeMatrix;
+            }
+        }
+    })));
+}
+/** Validate the source and calculate a complete payload before committing any buffer changes. */
+function prepareBindShapeBake(gltf, skin, bindShapeMatrix) {
+    const accessor = gltf.json.accessors?.[skin.inverseBindMatrices];
+    const jointCount = (skin.joints || skin.jointNames || []).length;
+    if (!accessor ||
+        accessor.componentType !== 5126 ||
+        accessor.type !== 'MAT4' ||
+        accessor.normalized ||
+        accessor.sparse ||
+        accessor.extensions ||
+        Object.hasOwn(accessor, 'byteStride') ||
+        !Number.isSafeInteger(accessor.count) ||
+        accessor.count < 1)
+        return 'requires packed FLOAT MAT4 inverse-bind matrices';
+    if (accessor.count < jointCount)
+        return 'has too few inverse-bind matrices';
+    const bufferView = gltf.json.bufferViews?.[accessor.bufferView];
+    const bufferIndex = bufferView?.buffer;
+    const bufferDefinition = gltf.json.buffers?.[bufferIndex];
+    const loadedBuffer = gltf.buffers[bufferIndex];
+    if (!bufferView || bufferIndex === undefined || !bufferDefinition || !loadedBuffer)
+        return 'requires a loaded inverse-bind buffer';
+    if (bufferView.extensions)
+        return 'does not support inverse-bind buffer-view extensions';
+    const bufferViewByteOffset = bufferView.byteOffset ?? 0;
+    const accessorByteOffset = accessor.byteOffset ?? 0;
+    const matrixByteLength = accessor.count * 64;
+    if (!(loadedBuffer.arrayBuffer instanceof ArrayBuffer) ||
+        !Number.isSafeInteger(bufferDefinition.byteLength) ||
+        bufferDefinition.byteLength < 1 ||
+        !Number.isSafeInteger(loadedBuffer.byteOffset) ||
+        loadedBuffer.byteOffset < 0 ||
+        !Number.isSafeInteger(loadedBuffer.byteLength) ||
+        loadedBuffer.byteLength < bufferDefinition.byteLength ||
+        loadedBuffer.byteOffset + loadedBuffer.byteLength > loadedBuffer.arrayBuffer.byteLength ||
+        !Number.isSafeInteger(bufferViewByteOffset) ||
+        bufferViewByteOffset < 0 ||
+        bufferViewByteOffset % 4 !== 0 ||
+        !Number.isSafeInteger(bufferView.byteLength) ||
+        bufferView.byteLength < 1 ||
+        bufferView.byteStride !== undefined ||
+        bufferViewByteOffset + bufferView.byteLength > bufferDefinition.byteLength ||
+        !Number.isSafeInteger(accessorByteOffset) ||
+        accessorByteOffset < 0 ||
+        accessorByteOffset % 4 !== 0 ||
+        accessorByteOffset + matrixByteLength > bufferView.byteLength)
+        return 'has an invalid inverse-bind buffer layout';
+    const sourceData = new DataView(loadedBuffer.arrayBuffer);
+    const sourceByteOffset = loadedBuffer.byteOffset + bufferViewByteOffset + accessorByteOffset;
+    const matrixBytes = new ArrayBuffer(matrixByteLength);
+    const outputData = new DataView(matrixBytes);
+    for (let matrixIndex = 0; matrixIndex < accessor.count; matrixIndex++) {
+        const inverseBindMatrix = Array.from({ length: 16 }, (_, componentIndex) => sourceData.getFloat32(sourceByteOffset + matrixIndex * 64 + componentIndex * 4, true));
+        if (!isFiniteAffineMatrix(inverseBindMatrix))
+            return 'requires finite affine inverse-bind matrices';
+        for (let columnIndex = 0; columnIndex < 4; columnIndex++) {
+            for (let rowIndex = 0; rowIndex < 4; rowIndex++) {
+                let value = 0;
+                for (let innerIndex = 0; innerIndex < 4; innerIndex++) {
+                    value +=
+                        inverseBindMatrix[innerIndex * 4 + rowIndex] *
+                            bindShapeMatrix[columnIndex * 4 + innerIndex];
+                }
+                if (!Number.isFinite(Math.fround(value)))
+                    return 'produces non-finite FLOAT matrix values';
+                outputData.setFloat32(matrixIndex * 64 + (columnIndex * 4 + rowIndex) * 4, value, true);
+            }
+        }
+    }
+    return { bufferIndex, count: accessor.count, matrixBytes, skins: [skin] };
+}
+/** Check glTF 2's finite values and required affine fourth row, including sparse JS arrays. */
+function isFiniteAffineMatrix(matrix) {
+    if (!Array.isArray(matrix) || matrix.length !== 16)
+        return false;
+    for (let componentIndex = 0; componentIndex < 16; componentIndex++) {
+        if (!Number.isFinite(matrix[componentIndex]))
+            return false;
+    }
+    return matrix[3] === 0 && matrix[7] === 0 && matrix[11] === 0 && matrix[15] === 1;
+}
+//# sourceMappingURL=bake-gltf-v1-bind-shapes.js.map

package/dist/gltf/lib/api/bake-gltf-v1-bind-shapes.js.map

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

package/dist/gltf/lib/api/clean-gltf-v1-fields.cjs

@@ -0,0 +1,93 @@
+"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/clean-gltf-v1-fields.ts
+var clean_gltf_v1_fields_exports = {};
+__export(clean_gltf_v1_fields_exports, {
+  cleanGLTFV1Fields: () => cleanGLTFV1Fields,
+  convertGLTFV1AttributeName: () => convertGLTFV1AttributeName
+});
+module.exports = __toCommonJS(clean_gltf_v1_fields_exports);
+function cleanGLTFV1Fields(json, reportUnsupported) {
+  const asset = json.asset;
+  if (asset.premultipliedAlpha) reportUnsupported("asset premultipliedAlpha rendering");
+  preserveLegacyFields(asset, ["profile", "premultipliedAlpha"]);
+  for (const [textureIndex, texture] of (json.textures || []).entries()) {
+    const legacyTexture = texture;
+    for (const [field, defaultValue] of Object.entries({
+      format: 6408,
+      internalFormat: 6408,
+      target: 3553,
+      type: 5121
+    })) {
+      if (legacyTexture[field] !== void 0 && legacyTexture[field] !== defaultValue) {
+        reportUnsupported(`texture ${textureIndex} non-default ${field} rendering`);
+      }
+    }
+    preserveLegacyFields(legacyTexture, ["format", "internalFormat", "target", "type"]);
+  }
+}
+function preserveLegacyFields(object, fields) {
+  const legacyFields = {};
+  for (const field of fields)
+    if (Object.hasOwn(object, field)) {
+      legacyFields[field] = object[field];
+      delete object[field];
+    }
+  if (!Object.keys(legacyFields).length) return;
+  const extras = isRecord(object.extras) ? object.extras : object.extras === void 0 ? {} : { originalExtras: object.extras };
+  const provenance = isRecord(extras.gltf1) ? extras.gltf1 : extras.gltf1 === void 0 ? {} : { originalExtras: extras.gltf1 };
+  const previousFields = isRecord(provenance.legacyFields) ? provenance.legacyFields : provenance.legacyFields === void 0 ? {} : { originalExtras: provenance.legacyFields };
+  const conflictingFields = Object.keys(legacyFields).some(
+    (field) => Object.hasOwn(previousFields, field)
+  );
+  object.extras = {
+    ...extras,
+    gltf1: {
+      ...provenance,
+      legacyFields: {
+        ...previousFields,
+        ...legacyFields,
+        ...conflictingFields ? { originalExtras: previousFields } : {}
+      }
+    }
+  };
+}
+function isRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function convertGLTFV1AttributeName(name) {
+  const indexed = /^(JOINTS?|WEIGHTS?|TEXCOORD|COLOR)(?:_(\d+))?$/.exec(name);
+  if (indexed) {
+    const semantic = indexed[1].startsWith("JOINT") ? "JOINTS" : indexed[1].startsWith("WEIGHT") ? "WEIGHTS" : indexed[1];
+    const index = Number(indexed[2] || 0);
+    if (!Number.isSafeInteger(index) || index > 999999999)
+      throw new Error(`glTF v1: invalid attribute set index ${name}`);
+    return `${semantic}_${index}`;
+  }
+  if (["POSITION", "NORMAL", "TANGENT"].includes(name) || name.startsWith("_") || name.includes(":"))
+    return name;
+  return `_${name}`;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  cleanGLTFV1Fields,
+  convertGLTFV1AttributeName
+});
+//# sourceMappingURL=clean-gltf-v1-fields.cjs.map

package/dist/gltf/lib/api/clean-gltf-v1-fields.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/gltf/lib/api/clean-gltf-v1-fields.ts"],
+  "sourcesContent": ["// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\nimport type {GLTF} from '../types/gltf-types';\n\n/** Preserve obsolete fields under extras, reporting rendering semantics that cannot be removed safely. */\nexport function cleanGLTFV1Fields(json: GLTF, reportUnsupported: (feature: string) => void): void {\n  const asset = json.asset as unknown as Record<string, unknown>;\n  if (asset.premultipliedAlpha) reportUnsupported('asset premultipliedAlpha rendering');\n  preserveLegacyFields(asset, ['profile', 'premultipliedAlpha']);\n  for (const [textureIndex, texture] of (json.textures || []).entries()) {\n    const legacyTexture = texture as unknown as Record<string, unknown>;\n    for (const [field, defaultValue] of Object.entries({\n      format: 6408,\n      internalFormat: 6408,\n      target: 3553,\n      type: 5121\n    })) {\n      if (legacyTexture[field] !== undefined && legacyTexture[field] !== defaultValue) {\n        reportUnsupported(`texture ${textureIndex} non-default ${field} rendering`);\n      }\n    }\n    preserveLegacyFields(legacyTexture, ['format', 'internalFormat', 'target', 'type']);\n  }\n}\n\n/** Move specified source properties without discarding application extras or existing provenance. */\nfunction preserveLegacyFields(object: Record<string, unknown>, fields: string[]): void {\n  const legacyFields: Record<string, unknown> = {};\n  for (const field of fields)\n    if (Object.hasOwn(object, field)) {\n      legacyFields[field] = object[field];\n      delete object[field];\n    }\n  if (!Object.keys(legacyFields).length) return;\n  const extras = isRecord(object.extras)\n    ? object.extras\n    : object.extras === undefined\n      ? {}\n      : {originalExtras: object.extras};\n  const provenance = isRecord(extras.gltf1)\n    ? extras.gltf1\n    : extras.gltf1 === undefined\n      ? {}\n      : {originalExtras: extras.gltf1};\n  const previousFields = isRecord(provenance.legacyFields)\n    ? provenance.legacyFields\n    : provenance.legacyFields === undefined\n      ? {}\n      : {originalExtras: provenance.legacyFields};\n  const conflictingFields = Object.keys(legacyFields).some(field =>\n    Object.hasOwn(previousFields, field)\n  );\n  object.extras = {\n    ...extras,\n    gltf1: {\n      ...provenance,\n      legacyFields: {\n        ...previousFields,\n        ...legacyFields,\n        ...(conflictingFields ? {originalExtras: previousFields} : {})\n      }\n    }\n  };\n}\n\n/** JSON extras may be scalar or array values, rather than mergeable objects. */\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\n\n/** Rename conventional indexed semantics and put application-specific names in their glTF 2 namespace. */\nexport function convertGLTFV1AttributeName(name: string): string {\n  const indexed = /^(JOINTS?|WEIGHTS?|TEXCOORD|COLOR)(?:_(\\d+))?$/.exec(name);\n  if (indexed) {\n    const semantic = indexed[1].startsWith('JOINT')\n      ? 'JOINTS'\n      : indexed[1].startsWith('WEIGHT')\n        ? 'WEIGHTS'\n        : indexed[1];\n    const index = Number(indexed[2] || 0);\n    if (!Number.isSafeInteger(index) || index > 999999999)\n      throw new Error(`glTF v1: invalid attribute set index ${name}`);\n    return `${semantic}_${index}`;\n  }\n  if (\n    ['POSITION', 'NORMAL', 'TANGENT'].includes(name) ||\n    name.startsWith('_') ||\n    name.includes(':')\n  )\n    return name;\n  return `_${name}`;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAOO,SAAS,kBAAkB,MAAY,mBAAoD;AAChG,QAAM,QAAQ,KAAK;AACnB,MAAI,MAAM,mBAAoB,mBAAkB,oCAAoC;AACpF,uBAAqB,OAAO,CAAC,WAAW,oBAAoB,CAAC;AAC7D,aAAW,CAAC,cAAc,OAAO,MAAM,KAAK,YAAY,CAAC,GAAG,QAAQ,GAAG;AACrE,UAAM,gBAAgB;AACtB,eAAW,CAAC,OAAO,YAAY,KAAK,OAAO,QAAQ;AAAA,MACjD,QAAQ;AAAA,MACR,gBAAgB;AAAA,MAChB,QAAQ;AAAA,MACR,MAAM;AAAA,IACR,CAAC,GAAG;AACF,UAAI,cAAc,KAAK,MAAM,UAAa,cAAc,KAAK,MAAM,cAAc;AAC/E,0BAAkB,WAAW,YAAY,gBAAgB,KAAK,YAAY;AAAA,MAC5E;AAAA,IACF;AACA,yBAAqB,eAAe,CAAC,UAAU,kBAAkB,UAAU,MAAM,CAAC;AAAA,EACpF;AACF;AAGA,SAAS,qBAAqB,QAAiC,QAAwB;AACrF,QAAM,eAAwC,CAAC;AAC/C,aAAW,SAAS;AAClB,QAAI,OAAO,OAAO,QAAQ,KAAK,GAAG;AAChC,mBAAa,KAAK,IAAI,OAAO,KAAK;AAClC,aAAO,OAAO,KAAK;AAAA,IACrB;AACF,MAAI,CAAC,OAAO,KAAK,YAAY,EAAE,OAAQ;AACvC,QAAM,SAAS,SAAS,OAAO,MAAM,IACjC,OAAO,SACP,OAAO,WAAW,SAChB,CAAC,IACD,EAAC,gBAAgB,OAAO,OAAM;AACpC,QAAM,aAAa,SAAS,OAAO,KAAK,IACpC,OAAO,QACP,OAAO,UAAU,SACf,CAAC,IACD,EAAC,gBAAgB,OAAO,MAAK;AACnC,QAAM,iBAAiB,SAAS,WAAW,YAAY,IACnD,WAAW,eACX,WAAW,iBAAiB,SAC1B,CAAC,IACD,EAAC,gBAAgB,WAAW,aAAY;AAC9C,QAAM,oBAAoB,OAAO,KAAK,YAAY,EAAE;AAAA,IAAK,WACvD,OAAO,OAAO,gBAAgB,KAAK;AAAA,EACrC;AACA,SAAO,SAAS;AAAA,IACd,GAAG;AAAA,IACH,OAAO;AAAA,MACL,GAAG;AAAA,MACH,cAAc;AAAA,QACZ,GAAG;AAAA,QACH,GAAG;AAAA,QACH,GAAI,oBAAoB,EAAC,gBAAgB,eAAc,IAAI,CAAC;AAAA,MAC9D;AAAA,IACF;AAAA,EACF;AACF;AAGA,SAAS,SAAS,OAAkD;AAClE,SAAO,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAGO,SAAS,2BAA2B,MAAsB;AAC/D,QAAM,UAAU,iDAAiD,KAAK,IAAI;AAC1E,MAAI,SAAS;AACX,UAAM,WAAW,QAAQ,CAAC,EAAE,WAAW,OAAO,IAC1C,WACA,QAAQ,CAAC,EAAE,WAAW,QAAQ,IAC5B,YACA,QAAQ,CAAC;AACf,UAAM,QAAQ,OAAO,QAAQ,CAAC,KAAK,CAAC;AACpC,QAAI,CAAC,OAAO,cAAc,KAAK,KAAK,QAAQ;AAC1C,YAAM,IAAI,MAAM,wCAAwC,IAAI,EAAE;AAChE,WAAO,GAAG,QAAQ,IAAI,KAAK;AAAA,EAC7B;AACA,MACE,CAAC,YAAY,UAAU,SAAS,EAAE,SAAS,IAAI,KAC/C,KAAK,WAAW,GAAG,KACnB,KAAK,SAAS,GAAG;AAEjB,WAAO;AACT,SAAO,IAAI,IAAI;AACjB;",
+  "names": []
+}

package/dist/gltf/lib/api/clean-gltf-v1-fields.d.ts

@@ -0,0 +1,6 @@
+import type { GLTF } from "../types/gltf-types.js";
+/** Preserve obsolete fields under extras, reporting rendering semantics that cannot be removed safely. */
+export declare function cleanGLTFV1Fields(json: GLTF, reportUnsupported: (feature: string) => void): void;
+/** Rename conventional indexed semantics and put application-specific names in their glTF 2 namespace. */
+export declare function convertGLTFV1AttributeName(name: string): string;
+//# sourceMappingURL=clean-gltf-v1-fields.d.ts.map

package/dist/gltf/lib/api/clean-gltf-v1-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean-gltf-v1-fields.d.ts","sourceRoot":"","sources":["../../../../src/gltf/lib/api/clean-gltf-v1-fields.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,IAAI,EAAC,+BAA4B;AAE9C,0GAA0G;AAC1G,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAkBhG;AA+CD,0GAA0G;AAC1G,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoB/D"}

package/dist/gltf/lib/api/clean-gltf-v1-fields.js

@@ -0,0 +1,87 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/** Preserve obsolete fields under extras, reporting rendering semantics that cannot be removed safely. */
+export function cleanGLTFV1Fields(json, reportUnsupported) {
+    const asset = json.asset;
+    if (asset.premultipliedAlpha)
+        reportUnsupported('asset premultipliedAlpha rendering');
+    preserveLegacyFields(asset, ['profile', 'premultipliedAlpha']);
+    for (const [textureIndex, texture] of (json.textures || []).entries()) {
+        const legacyTexture = texture;
+        for (const [field, defaultValue] of Object.entries({
+            format: 6408,
+            internalFormat: 6408,
+            target: 3553,
+            type: 5121
+        })) {
+            if (legacyTexture[field] !== undefined && legacyTexture[field] !== defaultValue) {
+                reportUnsupported(`texture ${textureIndex} non-default ${field} rendering`);
+            }
+        }
+        preserveLegacyFields(legacyTexture, ['format', 'internalFormat', 'target', 'type']);
+    }
+}
+/** Move specified source properties without discarding application extras or existing provenance. */
+function preserveLegacyFields(object, fields) {
+    const legacyFields = {};
+    for (const field of fields)
+        if (Object.hasOwn(object, field)) {
+            legacyFields[field] = object[field];
+            delete object[field];
+        }
+    if (!Object.keys(legacyFields).length)
+        return;
+    const extras = isRecord(object.extras)
+        ? object.extras
+        : object.extras === undefined
+            ? {}
+            : { originalExtras: object.extras };
+    const provenance = isRecord(extras.gltf1)
+        ? extras.gltf1
+        : extras.gltf1 === undefined
+            ? {}
+            : { originalExtras: extras.gltf1 };
+    const previousFields = isRecord(provenance.legacyFields)
+        ? provenance.legacyFields
+        : provenance.legacyFields === undefined
+            ? {}
+            : { originalExtras: provenance.legacyFields };
+    const conflictingFields = Object.keys(legacyFields).some(field => Object.hasOwn(previousFields, field));
+    object.extras = {
+        ...extras,
+        gltf1: {
+            ...provenance,
+            legacyFields: {
+                ...previousFields,
+                ...legacyFields,
+                ...(conflictingFields ? { originalExtras: previousFields } : {})
+            }
+        }
+    };
+}
+/** JSON extras may be scalar or array values, rather than mergeable objects. */
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+/** Rename conventional indexed semantics and put application-specific names in their glTF 2 namespace. */
+export function convertGLTFV1AttributeName(name) {
+    const indexed = /^(JOINTS?|WEIGHTS?|TEXCOORD|COLOR)(?:_(\d+))?$/.exec(name);
+    if (indexed) {
+        const semantic = indexed[1].startsWith('JOINT')
+            ? 'JOINTS'
+            : indexed[1].startsWith('WEIGHT')
+                ? 'WEIGHTS'
+                : indexed[1];
+        const index = Number(indexed[2] || 0);
+        if (!Number.isSafeInteger(index) || index > 999999999)
+            throw new Error(`glTF v1: invalid attribute set index ${name}`);
+        return `${semantic}_${index}`;
+    }
+    if (['POSITION', 'NORMAL', 'TANGENT'].includes(name) ||
+        name.startsWith('_') ||
+        name.includes(':'))
+        return name;
+    return `_${name}`;
+}
+//# sourceMappingURL=clean-gltf-v1-fields.js.map

package/dist/gltf/lib/api/clean-gltf-v1-fields.js.map

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