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

package/dist/gltf/lib/api/normalize-gltf-v1.cjs

@@ -0,0 +1,479 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/gltf/lib/api/normalize-gltf-v1.ts
+var normalize_gltf_v1_exports = {};
+__export(normalize_gltf_v1_exports, {
+  convertGLTFV1ToGLTF2: () => convertGLTFV1ToGLTF2,
+  normalizeGLTFV1: () => normalizeGLTFV1,
+  normalizeGLTFV1WithDeferredBuffers: () => normalizeGLTFV1WithDeferredBuffers
+});
+module.exports = __toCommonJS(normalize_gltf_v1_exports);
+var KHR_binary_glTF = __toESM(require("../extensions/KHR_binary_gltf.cjs"), 1);
+var import_convert_gltf_v1_accessors = require("./convert-gltf-v1-accessors.cjs");
+var import_convert_gltf_v1_skins = require("./convert-gltf-v1-skins.cjs");
+var import_bake_gltf_v1_bind_shapes = require("./bake-gltf-v1-bind-shapes.cjs");
+var import_repack_gltf_v1_accessors = require("./repack-gltf-v1-accessors.cjs");
+var import_clean_gltf_v1_fields = require("./clean-gltf-v1-fields.cjs");
+var import_convert_gltf_v1_animations = require("./convert-gltf-v1-animations.cjs");
+var import_convert_gltf_v1_skin_scenes = require("./convert-gltf-v1-skin-scenes.cjs");
+var import_validate_gltf_v1_cameras = require("./validate-gltf-v1-cameras.cjs");
+var import_validate_gltf_v1_payloads = require("./validate-gltf-v1-payloads.cjs");
+var import_validate_gltf_v1_buffers = require("./validate-gltf-v1-buffers.cjs");
+var import_convert_gltf_v1_matrix_nodes = require("./convert-gltf-v1-matrix-nodes.cjs");
+var import_convert_gltf_v1_materials = require("./convert-gltf-v1-materials.cjs");
+var GLTF_ARRAYS = {
+  accessors: "accessor",
+  animations: "animation",
+  buffers: "buffer",
+  bufferViews: "bufferView",
+  cameras: "camera",
+  images: "image",
+  materials: "material",
+  meshes: "mesh",
+  nodes: "node",
+  samplers: "sampler",
+  scenes: "scene",
+  skins: "skin",
+  textures: "texture"
+};
+var GLTF_KEYS = {
+  accessor: "accessors",
+  animations: "animation",
+  buffer: "buffers",
+  bufferView: "bufferViews",
+  camera: "cameras",
+  inverseBindMatrices: "accessors",
+  image: "images",
+  material: "materials",
+  mesh: "meshes",
+  node: "nodes",
+  sampler: "samplers",
+  scene: "scenes",
+  skin: "skins",
+  texture: "textures"
+};
+var GLTFV1Normalizer = class _GLTFV1Normalizer {
+  idToIndexMap = {
+    animations: {},
+    accessors: {},
+    buffers: {},
+    bufferViews: {},
+    cameras: {},
+    images: {},
+    materials: {},
+    meshes: {},
+    nodes: {},
+    samplers: {},
+    scenes: {},
+    skins: {},
+    textures: {}
+  };
+  json;
+  /** Diagnostics collected during this normalization pass. */
+  report = {
+    converted: false,
+    mutated: false,
+    unsupported: [],
+    warnings: []
+  };
+  /** Whether unsupported legacy features should abort conversion. */
+  strict = false;
+  /** Caller-owned logger receiving conversion notes and unsupported-feature warnings. */
+  log;
+  /** Whether binary baking and final diagnostics have already completed. */
+  finished = false;
+  /** Accessors whose loaded payload needs alignment or stride repair. */
+  pendingAccessors = /* @__PURE__ */ new Set();
+  /** Separated consumer interpretations, captured before legacy strides are consumed. */
+  accessorConversions = /* @__PURE__ */ new Map();
+  /** URI origins retained because the loader removes fetched URIs before binary completion. */
+  uriBufferIndices = /* @__PURE__ */ new Set();
+  // constructor() {}
+  /**
+   * Convert (normalize) glTF < 2.0 to glTF 2.0
+   * @param gltf - object with json and binChunks
+   * @param options
+   * @param options normalize Whether to actually normalize
+   * @param deferBinaryBaking Complete matrix baking after the loader resolves linked buffers.
+   */
+  normalize(gltf, options = {}, deferBinaryBaking = false) {
+    if (options.mutate === false) {
+      const converted = { ...gltf, json: JSON.parse(JSON.stringify(gltf.json)) };
+      const report = new _GLTFV1Normalizer().normalize(converted, { ...options, mutate: true });
+      report.mutated = false;
+      return report;
+    }
+    this.strict = options.normalize === "strict";
+    this.log = options.log;
+    this.json = gltf.json;
+    const json = gltf.json;
+    switch (json.asset && json.asset.version) {
+      // We are converting to v2 format. Return if there is nothing to do
+      case "2.0":
+      case "2.1":
+        return this.report;
+      // This class is written to convert 1.0
+      case void 0:
+      case "1.0":
+        break;
+      default:
+        this._warning(`Unknown glTF version ${json.asset.version}`);
+        return this.report;
+    }
+    if (!options.normalize) {
+      throw new Error("glTF v1 is not supported.");
+    }
+    this.report.converted = true;
+    this.report.mutated = true;
+    this.log?.log(1, "glTF: Converting glTF v1 to glTF v2 using experimental normalization.")();
+    this._addAsset(json);
+    this._orderBinaryBufferPayloads(gltf);
+    this._convertTopLevelObjectsToArrays(json);
+    KHR_binary_glTF.preprocess(gltf);
+    this._convertObjectIdsToArrayIndices(json);
+    this._updateObjects(json);
+    for (const [bufferIndex, buffer] of (json.buffers || []).entries())
+      if (typeof buffer.uri === "string") this.uriBufferIndices.add(bufferIndex);
+    const commonMaterialFallbacks = (0, import_convert_gltf_v1_materials.convertGLTFV1Materials)(
+      json,
+      (feature) => this._unsupported(feature),
+      (message) => this._warning(message)
+    );
+    (0, import_convert_gltf_v1_animations.convertGLTFV1Animations)(
+      json,
+      (reference, collection) => this._convertIdToIndex(reference, collection),
+      (feature) => this._unsupported(feature)
+    );
+    (0, import_validate_gltf_v1_cameras.validateGLTFV1Cameras)(json, (feature) => this._unsupported(feature));
+    (0, import_convert_gltf_v1_matrix_nodes.convertGLTFV1MatrixNodes)(
+      json,
+      (feature) => this._unsupported(feature),
+      (message) => this._warning(message)
+    );
+    (0, import_clean_gltf_v1_fields.cleanGLTFV1Fields)(json, (feature) => this._unsupported(feature));
+    this.accessorConversions = (0, import_repack_gltf_v1_accessors.prepareGLTFV1AccessorConversions)(json);
+    (0, import_convert_gltf_v1_accessors.convertGLTFV1AccessorStrides)(json, (accessorIndex) => this.pendingAccessors.add(accessorIndex));
+    (0, import_convert_gltf_v1_skins.convertGLTFV1Skins)(
+      json,
+      (nodeId) => this._convertIdToIndex(nodeId, "node"),
+      (feature) => this._unsupported(feature)
+    );
+    this._updateNodes(json);
+    (0, import_convert_gltf_v1_skin_scenes.convertGLTFV1SkinScenes)(
+      json,
+      (feature) => this._unsupported(feature),
+      (message) => this._warning(message)
+    );
+    this._preserveLegacyResources(json, commonMaterialFallbacks);
+    this._removeEmptyCollections(json);
+    return deferBinaryBaking ? this.report : this.finishNormalization(gltf);
+  }
+  /** Complete binary baking once linked buffers are available; repeated calls are harmless. */
+  finishNormalization(gltf) {
+    if (this.report.converted && !this.finished) {
+      (0, import_validate_gltf_v1_buffers.validateGLTFV1Buffers)(
+        gltf,
+        this.uriBufferIndices,
+        (feature) => this._unsupported(feature),
+        (message) => this._warning(message)
+      );
+      (0, import_repack_gltf_v1_accessors.repackGLTFV1Accessors)(
+        gltf,
+        this.accessorConversions,
+        this.pendingAccessors,
+        (feature) => this._unsupported(feature),
+        (message) => this._warning(message)
+      );
+      (0, import_bake_gltf_v1_bind_shapes.bakeGLTFV1BindShapes)(gltf, (feature) => this._unsupported(feature));
+      (0, import_validate_gltf_v1_payloads.validateGLTFV1Payloads)(
+        gltf,
+        (feature) => this._unsupported(feature),
+        (message) => this._warning(message)
+      );
+      this._finishReport();
+      this.log?.log(
+        1,
+        `glTF: Completed glTF v1 normalization (${this.report.unsupported.length} unsupported features).`
+      )();
+      this.finished = true;
+    }
+    return this.report;
+  }
+  /** Record a feature that requires a lossy best-effort conversion. */
+  _unsupported(feature) {
+    this.report.unsupported.push(feature);
+    this.log?.warn(`glTF v1 normalization does not support ${feature}`)();
+    if (this.strict) {
+      throw new Error(`glTF v1 normalization does not support ${feature}`);
+    }
+  }
+  /** Add a diagnostic without rejecting conversion. */
+  _warning(message) {
+    this.report.warnings.push(message);
+    this.log?.warn(`glTF: ${message}`)();
+  }
+  // asset is now required, #642 https://github.com/KhronosGroup/glTF/issues/639
+  _addAsset(json) {
+    json.asset = json.asset || {};
+    json.asset.version = "2.0";
+    json.asset.generator = json.asset.generator || "Normalized to glTF 2.0 by loaders.gl";
+  }
+  /** Keep loaded buffer payloads aligned when the GLB 1 body is moved to index zero. */
+  _orderBinaryBufferPayloads(gltf) {
+    const buffers = this.json.buffers;
+    if (!buffers || Array.isArray(buffers) || !buffers.binary_glTF) {
+      return;
+    }
+    const bufferIds = Object.keys(buffers);
+    const binaryBufferIndex = bufferIds.indexOf("binary_glTF");
+    if (binaryBufferIndex > 0) {
+      if (gltf.buffers?.length) {
+        gltf.buffers = [
+          gltf.buffers[binaryBufferIndex],
+          ...gltf.buffers.filter((buffer, bufferIndex) => bufferIndex !== binaryBufferIndex)
+        ];
+      }
+    }
+  }
+  _convertTopLevelObjectsToArrays(json) {
+    for (const arrayName in GLTF_ARRAYS) {
+      this._convertTopLevelObjectToArray(json, arrayName);
+    }
+  }
+  /** Convert one top level object to array */
+  _convertTopLevelObjectToArray(json, mapName) {
+    const objectMap = json[mapName];
+    if (!objectMap || Array.isArray(objectMap)) {
+      return;
+    }
+    json[mapName] = [];
+    const objectIds = Object.keys(objectMap);
+    const orderedIds = mapName === "buffers" && objectIds.includes("binary_glTF") ? ["binary_glTF", ...objectIds.filter((id) => id !== "binary_glTF")] : objectIds;
+    for (const id of orderedIds) {
+      const object = objectMap[id];
+      object.id = object.id || id;
+      const index = json[mapName].length;
+      json[mapName].push(object);
+      this.idToIndexMap[mapName][id] = index;
+    }
+  }
+  /** Go through all objects in all top-level arrays and replace ids with indices */
+  _convertObjectIdsToArrayIndices(json) {
+    for (const arrayName in GLTF_ARRAYS) {
+      this._convertIdsToIndices(json, arrayName);
+    }
+    if ("scene" in json) {
+      json.scene = this._convertIdToIndex(json.scene, "scene");
+    }
+    for (const texture of json.textures) {
+      this._convertTextureIds(texture);
+    }
+    for (const mesh of json.meshes) {
+      this._convertMeshIds(mesh);
+    }
+    for (const node of json.nodes) {
+      this._convertNodeIds(node);
+    }
+    for (const node of json.scenes) {
+      this._convertSceneIds(node);
+    }
+  }
+  _convertTextureIds(texture) {
+    if (texture.source) {
+      texture.source = this._convertIdToIndex(texture.source, "image");
+    }
+  }
+  _convertMeshIds(mesh) {
+    for (const primitive of mesh.primitives) {
+      const { attributes, indices, material } = primitive;
+      const convertedNames = /* @__PURE__ */ new Map();
+      for (const attributeName in attributes) {
+        const convertedName = (0, import_clean_gltf_v1_fields.convertGLTFV1AttributeName)(attributeName);
+        const previousName = convertedNames.get(convertedName);
+        if (previousName !== void 0 && attributes[previousName] !== attributes[attributeName]) {
+          throw new Error(
+            `glTF v1: conflicting attribute aliases ${previousName} and ${attributeName}`
+          );
+        }
+        convertedNames.set(convertedName, attributeName);
+      }
+      primitive.attributes = Object.fromEntries(
+        Object.entries(attributes).map(([attributeName, accessorId]) => [
+          (0, import_clean_gltf_v1_fields.convertGLTFV1AttributeName)(attributeName),
+          this._convertIdToIndex(accessorId, "accessor")
+        ])
+      );
+      if (indices) {
+        primitive.indices = this._convertIdToIndex(indices, "accessor");
+      }
+      if (material) {
+        primitive.material = this._convertIdToIndex(material, "material");
+      }
+    }
+  }
+  _convertNodeIds(node) {
+    if (node.children) {
+      node.children = node.children.map((child) => this._convertIdToIndex(child, "node"));
+    }
+    if (node.meshes) {
+      node.meshes = node.meshes.map((mesh) => this._convertIdToIndex(mesh, "mesh"));
+    }
+  }
+  _convertSceneIds(scene) {
+    if (scene.nodes) {
+      scene.nodes = scene.nodes.map((node) => this._convertIdToIndex(node, "node"));
+    }
+  }
+  /** Go through all objects in a top-level array and replace ids with indices */
+  _convertIdsToIndices(json, topLevelArrayName) {
+    if (!json[topLevelArrayName]) {
+      json[topLevelArrayName] = [];
+    }
+    for (const object of json[topLevelArrayName]) {
+      for (const key in object) {
+        const id = object[key];
+        const index = this._convertIdToIndex(id, key);
+        object[key] = index;
+      }
+    }
+  }
+  _convertIdToIndex(id, key) {
+    const arrayName = GLTF_KEYS[key];
+    if (arrayName in this.idToIndexMap) {
+      const index = this.idToIndexMap[arrayName][id];
+      if (!Number.isFinite(index)) {
+        throw new Error(`gltf v1: failed to resolve ${key} with id ${id}`);
+      }
+      return index;
+    }
+    return id;
+  }
+  /**
+   *
+   * @param {*} json
+   */
+  _updateObjects(json) {
+    for (const buffer of this.json.buffers) {
+      delete buffer.type;
+    }
+  }
+  /** Split glTF 1 nodes that reference multiple meshes into glTF 2-compatible nodes. */
+  _updateNodes(json) {
+    const nodes = json.nodes || [];
+    for (let nodeIndex = 0; nodeIndex < nodes.length; nodeIndex++) {
+      const node = nodes[nodeIndex];
+      if (!Array.isArray(node.meshes)) {
+        continue;
+      }
+      const meshIndices = node.meshes;
+      delete node.meshes;
+      node.mesh = meshIndices.shift();
+      for (const meshIndex of meshIndices) {
+        const extraNode = { ...node, mesh: meshIndex, children: void 0 };
+        delete extraNode.id;
+        delete extraNode.matrix;
+        delete extraNode.translation;
+        delete extraNode.rotation;
+        delete extraNode.scale;
+        nodes.push(extraNode);
+        node.children ||= [];
+        node.children.push(nodes.length - 1);
+      }
+    }
+  }
+  /** Preserve v1 techniques, programs, and shaders without pretending they are PBR materials. */
+  _preserveLegacyResources(json, commonMaterialFallbacks) {
+    const coveredFallbacks = (0, import_convert_gltf_v1_materials.canPreserveGLTFV1MaterialFallbacks)(json, commonMaterialFallbacks);
+    const resources = {};
+    for (const resourceName of ["techniques", "programs", "shaders"]) {
+      if (json[resourceName]) {
+        resources[resourceName] = json[resourceName];
+        delete json[resourceName];
+        if (!coveredFallbacks) this._unsupported(`legacy ${resourceName}`);
+      }
+    }
+    if (Object.keys(resources).length) {
+      json.extras = { ...json.extras, gltf1Resources: resources };
+      if (coveredFallbacks)
+        this._warning("Preserved shader resources overridden by converted common materials.");
+    }
+  }
+  /** Omit optional empty root collections, child lists, and scene roots rejected by glTF 2. */
+  _removeEmptyCollections(json) {
+    for (const node of json.nodes || []) {
+      if (Array.isArray(node.children) && node.children.length === 0) delete node.children;
+    }
+    for (const scene of json.scenes || []) {
+      if (Array.isArray(scene.nodes) && scene.nodes.length === 0) delete scene.nodes;
+    }
+    for (const collectionName of [
+      ...Object.keys(GLTF_ARRAYS),
+      "extensionsUsed",
+      "extensionsRequired"
+    ]) {
+      if (Array.isArray(json[collectionName]) && json[collectionName].length === 0) {
+        delete json[collectionName];
+      }
+    }
+  }
+  /** Finalize report diagnostics. */
+  _finishReport() {
+    if (this.report.unsupported.length) {
+      this.report.warnings.push(
+        `Converted glTF v1 with unsupported features: ${this.report.unsupported.join(", ")}`
+      );
+    }
+  }
+};
+function normalizeGLTFV1(gltf, options = {}) {
+  return new GLTFV1Normalizer().normalize(gltf, options);
+}
+function normalizeGLTFV1WithDeferredBuffers(gltf, options = {}) {
+  const normalizer = new GLTFV1Normalizer();
+  normalizer.normalize(gltf, options, true);
+  return () => normalizer.finishNormalization(gltf);
+}
+function convertGLTFV1ToGLTF2(gltf, options = {}) {
+  const converted = { ...gltf, json: JSON.parse(JSON.stringify(gltf.json)) };
+  const normalizationReport = normalizeGLTFV1(converted, {
+    normalize: options.normalize || "best-effort",
+    mutate: true,
+    log: options.log
+  });
+  normalizationReport.mutated = false;
+  return { ...converted, normalizationReport };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  convertGLTFV1ToGLTF2,
+  normalizeGLTFV1,
+  normalizeGLTFV1WithDeferredBuffers
+});
+//# sourceMappingURL=normalize-gltf-v1.cjs.map

package/dist/gltf/lib/api/normalize-gltf-v1.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/gltf/lib/api/normalize-gltf-v1.ts"],
+  "sourcesContent": ["// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\n/* eslint-disable camelcase */\nimport * as KHR_binary_glTF from '../extensions/KHR_binary_gltf';\nimport type {GLTFWithBuffers} from '../types/gltf-types';\nimport {convertGLTFV1AccessorStrides} from './convert-gltf-v1-accessors';\nimport {convertGLTFV1Skins} from './convert-gltf-v1-skins';\nimport {bakeGLTFV1BindShapes} from './bake-gltf-v1-bind-shapes';\nimport {\n  prepareGLTFV1AccessorConversions,\n  repackGLTFV1Accessors,\n  type GLTFV1AccessorConversion\n} from './repack-gltf-v1-accessors';\nimport {cleanGLTFV1Fields, convertGLTFV1AttributeName} from './clean-gltf-v1-fields';\nimport {convertGLTFV1Animations} from './convert-gltf-v1-animations';\nimport {convertGLTFV1SkinScenes} from './convert-gltf-v1-skin-scenes';\nimport {validateGLTFV1Cameras} from './validate-gltf-v1-cameras';\nimport {validateGLTFV1Payloads} from './validate-gltf-v1-payloads';\nimport {validateGLTFV1Buffers} from './validate-gltf-v1-buffers';\nimport {convertGLTFV1MatrixNodes} from './convert-gltf-v1-matrix-nodes';\nimport {\n  convertGLTFV1Materials,\n  canPreserveGLTFV1MaterialFallbacks\n} from './convert-gltf-v1-materials';\n\n// Binary format changes (mainly implemented by GLBLoader)\n// https://github.com/KhronosGroup/glTF/tree/master/extensions/1.0/Khronos/KHR_binary_glTF\n\n// JSON format changes:\n// https://github.com/khronosgroup/gltf/issues/605\n\n// - [x] Top-level JSON objects are arrays now\n// - [ ] Removed indirection from animation: sampler now refers directly to accessors, #712\n// - [ ] material.parameter.value and technique.parameter.value must be an array, #690\n// - [ ] Node can have only one mesh #821\n// - [ ] Added reqs on JSON encoding\n// - [ ] Added reqs on binary data alignment #802 (comment)\n\n// Additions:\n// - [ ] Added accessor.normalized, #691, #706\n// - [ ] Added glExtensionsUsed property and 5125 (UNSIGNED_INT) accessor.componentType value, #619\n// - [ ] Added extensionsRequired property, #720, #721\n// - [ ] Added \"STEP\" as valid animation.sampler.interpolation value, #712\n\n// Removals:\n// - [x] Removed buffer.type, #786, #629\n// - [ ] Removed revision number from profile.version, #709\n// - [ ] Removed technique.functions.scissor and removed 3089 (SCISSOR_TEST) as a valid value for technique.states.enable, #681\n// - [ ] Techniques, programs, and shaders were moved out to KHR_technique_webgl extension.\n\n// Other edits:\n// - [x] asset is now required, #642\n// - [ ] buffer.byteLength and bufferView.byteLength are now required, #560.\n// - [ ] accessor.min and accessor.max are now required, #593, and clarified that the JSON value and binary data must be the same, #628.\n// - [ ] Clarified animation.sampler and animation.channel restrictions, #712\n// - [ ] skin.inverseBindMatrices is now optional, #461.\n// - [ ] Attribute parameters can't have a value defined in the technique or parameter, #563 (comment).\n// - [ ] Only TEXCOORD and COLOR attribute semantics can be written in the form [semantic]_[set_index], #563 (comment).\n// - [ ] TEXCOORD and COLOR attribute semantics must be written in the form [semantic]_[set_index], e.g., just TEXCOORD should be TEXCOORD_0, and just COLOR should be COLOR_0, #649\n// - [ ] camera.perspective.aspectRatio and camera.perspective.yfov must now be > 0, not >= 0, #563 (comment).\n// - [ ] Application-specific parameter semantics must start with an underscore, e.g., _TEMPERATURE and _SIMULATION_TIME, #563 (comment).\n// - [ ] Properties in technique.parameters must be defined in technique.uniforms or technique.attributes,\n\n// #563 (comment).\n// - [ ] technique.parameter.count can only be defined when the semantic is JOINTMATRIX or an application-specific semantic is used. It can never be defined for attribute parameters; only uniforms, d2f6945\n// - [ ] technique.parameter.semantic is required when the parameter is an attribute, 28e113d\n// - [ ] Mesh-only models are allowed, e.g., without materials, #642\n// - [ ] Skeleton hierarchies (nodes containing jointName) must be separated from non-skeleton hierarchies., #647\n// - [ ] technique.states.functions.blendColor and technique.states.functions.depthRange parameters now must match WebGL function min/max, #707\n\nconst GLTF_ARRAYS = {\n  accessors: 'accessor',\n  animations: 'animation',\n  buffers: 'buffer',\n  bufferViews: 'bufferView',\n  cameras: 'camera',\n  images: 'image',\n  materials: 'material',\n  meshes: 'mesh',\n  nodes: 'node',\n  samplers: 'sampler',\n  scenes: 'scene',\n  skins: 'skin',\n  textures: 'texture'\n};\n\nconst GLTF_KEYS = {\n  accessor: 'accessors',\n  animations: 'animation',\n  buffer: 'buffers',\n  bufferView: 'bufferViews',\n  camera: 'cameras',\n  inverseBindMatrices: 'accessors',\n  image: 'images',\n  material: 'materials',\n  mesh: 'meshes',\n  node: 'nodes',\n  sampler: 'samplers',\n  scene: 'scenes',\n  skin: 'skins',\n  texture: 'textures'\n};\n\n/** Diagnostics emitted while converting a glTF 1 asset to glTF 2. */\nexport type GLTFV1NormalizationReport = {\n  /** Whether a glTF 1 asset was detected and converted. */\n  converted: boolean;\n  /** Whether the input JSON was mutated in place. */\n  mutated: boolean;\n  /** Features that could not be represented without loss. */\n  unsupported: string[];\n  /** Non-fatal conversion notes. */\n  warnings: string[];\n};\n\n/** Lazy logging methods compatible with probe.gl and loaders.gl core loggers. */\nexport type GLTFV1NormalizationLog = {\n  /** Create a level-controlled informational callback. */\n  log(priority: number, message: string): () => void;\n  /** Create a warning callback. */\n  warn(message: string): () => void;\n};\n\n/** Options for glTF 1 to glTF 2 conversion. */\nexport type GLTFV1NormalizationOptions = {\n  /** Enable conversion. `'strict'` rejects unsupported features; other values are best effort. */\n  normalize?: boolean | 'best-effort' | 'strict';\n  /** Mutate the supplied JSON. Defaults to true for backwards compatibility. */\n  mutate?: boolean;\n  /** Optional probe.gl-compatible logger; absent or null leaves diagnostics in the report only. */\n  log?: GLTFV1NormalizationLog | null;\n};\n\n/**\n * Converts (normalizes) glTF v1 to v2\n */\nclass GLTFV1Normalizer {\n  idToIndexMap = {\n    animations: {},\n    accessors: {},\n    buffers: {},\n    bufferViews: {},\n    cameras: {},\n    images: {},\n    materials: {},\n    meshes: {},\n    nodes: {},\n    samplers: {},\n    scenes: {},\n    skins: {},\n    textures: {}\n  };\n\n  json;\n  /** Diagnostics collected during this normalization pass. */\n  report: GLTFV1NormalizationReport = {\n    converted: false,\n    mutated: false,\n    unsupported: [],\n    warnings: []\n  };\n  /** Whether unsupported legacy features should abort conversion. */\n  strict = false;\n  /** Caller-owned logger receiving conversion notes and unsupported-feature warnings. */\n  log?: GLTFV1NormalizationLog | null;\n  /** Whether binary baking and final diagnostics have already completed. */\n  finished = false;\n  /** Accessors whose loaded payload needs alignment or stride repair. */\n  pendingAccessors = new Set<number>();\n  /** Separated consumer interpretations, captured before legacy strides are consumed. */\n  accessorConversions = new Map<number, GLTFV1AccessorConversion>();\n  /** URI origins retained because the loader removes fetched URIs before binary completion. */\n  uriBufferIndices = new Set<number>();\n\n  // constructor() {}\n\n  /**\n   * Convert (normalize) glTF < 2.0 to glTF 2.0\n   * @param gltf - object with json and binChunks\n   * @param options\n   * @param options normalize Whether to actually normalize\n   * @param deferBinaryBaking Complete matrix baking after the loader resolves linked buffers.\n   */\n  normalize(\n    gltf,\n    options: GLTFV1NormalizationOptions = {},\n    deferBinaryBaking = false\n  ): GLTFV1NormalizationReport {\n    if (options.mutate === false) {\n      const converted = {...gltf, json: JSON.parse(JSON.stringify(gltf.json))};\n      const report = new GLTFV1Normalizer().normalize(converted, {...options, mutate: true});\n      report.mutated = false;\n      return report;\n    }\n    this.strict = options.normalize === 'strict';\n    this.log = options.log;\n    this.json = gltf.json;\n    const json = gltf.json;\n\n    // Check version\n    switch (json.asset && json.asset.version) {\n      // We are converting to v2 format. Return if there is nothing to do\n      case '2.0':\n      case '2.1':\n        return this.report;\n\n      // This class is written to convert 1.0\n      case undefined:\n      case '1.0':\n        break;\n\n      default:\n        this._warning(`Unknown glTF version ${json.asset.version}`);\n        return this.report;\n    }\n\n    if (!options.normalize) {\n      // We are still missing a few conversion tricks, remove once addressed\n      throw new Error('glTF v1 is not supported.');\n    }\n\n    this.report.converted = true;\n    this.report.mutated = true;\n\n    this.log?.log(1, 'glTF: Converting glTF v1 to glTF v2 using experimental normalization.')();\n\n    this._addAsset(json);\n    this._orderBinaryBufferPayloads(gltf);\n\n    // In glTF2 top-level fields are Arrays not Object maps\n    this._convertTopLevelObjectsToArrays(json);\n\n    // Extract bufferView indices for images\n    // (this extension needs to be invoked early in the normalization process)\n    // TODO can this be handled by standard extension processing instead of called explicitly?\n    KHR_binary_glTF.preprocess(gltf);\n\n    // Convert object references from ids to indices\n    this._convertObjectIdsToArrayIndices(json);\n\n    this._updateObjects(json);\n    for (const [bufferIndex, buffer] of (json.buffers || []).entries())\n      if (typeof buffer.uri === 'string') this.uriBufferIndices.add(bufferIndex);\n\n    const commonMaterialFallbacks = convertGLTFV1Materials(\n      json,\n      feature => this._unsupported(feature),\n      message => this._warning(message)\n    );\n    convertGLTFV1Animations(\n      json,\n      (reference, collection) => this._convertIdToIndex(reference, collection),\n      feature => this._unsupported(feature)\n    );\n    validateGLTFV1Cameras(json, feature => this._unsupported(feature));\n    convertGLTFV1MatrixNodes(\n      json,\n      feature => this._unsupported(feature),\n      message => this._warning(message)\n    );\n    cleanGLTFV1Fields(json, feature => this._unsupported(feature));\n    this.accessorConversions = prepareGLTFV1AccessorConversions(json);\n    convertGLTFV1AccessorStrides(json, accessorIndex => this.pendingAccessors.add(accessorIndex));\n    convertGLTFV1Skins(\n      json,\n      nodeId => this._convertIdToIndex(nodeId, 'node'),\n      feature => this._unsupported(feature)\n    );\n    this._updateNodes(json);\n    convertGLTFV1SkinScenes(\n      json,\n      feature => this._unsupported(feature),\n      message => this._warning(message)\n    );\n    this._preserveLegacyResources(json, commonMaterialFallbacks);\n    this._removeEmptyCollections(json);\n    return deferBinaryBaking ? this.report : this.finishNormalization(gltf);\n  }\n\n  /** Complete binary baking once linked buffers are available; repeated calls are harmless. */\n  finishNormalization(gltf: GLTFWithBuffers): GLTFV1NormalizationReport {\n    if (this.report.converted && !this.finished) {\n      validateGLTFV1Buffers(\n        gltf,\n        this.uriBufferIndices,\n        feature => this._unsupported(feature),\n        message => this._warning(message)\n      );\n      repackGLTFV1Accessors(\n        gltf,\n        this.accessorConversions,\n        this.pendingAccessors,\n        feature => this._unsupported(feature),\n        message => this._warning(message)\n      );\n      bakeGLTFV1BindShapes(gltf, feature => this._unsupported(feature));\n      validateGLTFV1Payloads(\n        gltf,\n        feature => this._unsupported(feature),\n        message => this._warning(message)\n      );\n      this._finishReport();\n      this.log?.log(\n        1,\n        `glTF: Completed glTF v1 normalization (${this.report.unsupported.length} unsupported features).`\n      )();\n      this.finished = true;\n    }\n    return this.report;\n  }\n\n  /** Record a feature that requires a lossy best-effort conversion. */\n  _unsupported(feature: string): void {\n    this.report.unsupported.push(feature);\n    this.log?.warn(`glTF v1 normalization does not support ${feature}`)();\n    if (this.strict) {\n      throw new Error(`glTF v1 normalization does not support ${feature}`);\n    }\n  }\n\n  /** Add a diagnostic without rejecting conversion. */\n  _warning(message: string): void {\n    this.report.warnings.push(message);\n    this.log?.warn(`glTF: ${message}`)();\n  }\n\n  // asset is now required, #642 https://github.com/KhronosGroup/glTF/issues/639\n  _addAsset(json) {\n    json.asset = json.asset || {};\n    // We are normalizing to glTF v2, so change version to \"2.0\"\n    json.asset.version = '2.0';\n    json.asset.generator = json.asset.generator || 'Normalized to glTF 2.0 by loaders.gl';\n  }\n\n  /** Keep loaded buffer payloads aligned when the GLB 1 body is moved to index zero. */\n  _orderBinaryBufferPayloads(gltf: GLTFWithBuffers): void {\n    const buffers = this.json.buffers;\n    if (!buffers || Array.isArray(buffers) || !buffers.binary_glTF) {\n      return;\n    }\n    const bufferIds = Object.keys(buffers);\n    const binaryBufferIndex = bufferIds.indexOf('binary_glTF');\n    if (binaryBufferIndex > 0) {\n      if (gltf.buffers?.length) {\n        gltf.buffers = [\n          gltf.buffers[binaryBufferIndex],\n          ...gltf.buffers.filter((buffer, bufferIndex) => bufferIndex !== binaryBufferIndex)\n        ];\n      }\n    }\n  }\n\n  _convertTopLevelObjectsToArrays(json) {\n    // TODO check that all arrays are covered\n    for (const arrayName in GLTF_ARRAYS) {\n      this._convertTopLevelObjectToArray(json, arrayName);\n    }\n  }\n\n  /** Convert one top level object to array */\n  _convertTopLevelObjectToArray(json, mapName) {\n    const objectMap = json[mapName];\n    if (!objectMap || Array.isArray(objectMap)) {\n      return;\n    }\n\n    // Rewrite the top-level field as an array\n    json[mapName] = [];\n    // Copy the map key into object.id\n    const objectIds = Object.keys(objectMap);\n    const orderedIds =\n      mapName === 'buffers' && objectIds.includes('binary_glTF')\n        ? ['binary_glTF', ...objectIds.filter(id => id !== 'binary_glTF')]\n        : objectIds;\n    for (const id of orderedIds) {\n      const object = objectMap[id];\n      object.id = object.id || id; // Mutates the loaded object\n      const index = json[mapName].length;\n      json[mapName].push(object);\n      this.idToIndexMap[mapName][id] = index;\n    }\n  }\n\n  /** Go through all objects in all top-level arrays and replace ids with indices */\n  _convertObjectIdsToArrayIndices(json) {\n    for (const arrayName in GLTF_ARRAYS) {\n      this._convertIdsToIndices(json, arrayName);\n    }\n    if ('scene' in json) {\n      json.scene = this._convertIdToIndex(json.scene, 'scene');\n    }\n\n    // Convert any index references that are not using array names\n\n    // texture.source (image)\n    for (const texture of json.textures) {\n      this._convertTextureIds(texture);\n    }\n    for (const mesh of json.meshes) {\n      this._convertMeshIds(mesh);\n    }\n    for (const node of json.nodes) {\n      this._convertNodeIds(node);\n    }\n    for (const node of json.scenes) {\n      this._convertSceneIds(node);\n    }\n  }\n\n  _convertTextureIds(texture) {\n    if (texture.source) {\n      texture.source = this._convertIdToIndex(texture.source, 'image');\n    }\n  }\n\n  _convertMeshIds(mesh) {\n    for (const primitive of mesh.primitives) {\n      const {attributes, indices, material} = primitive;\n      const convertedNames = new Map<string, string>();\n      for (const attributeName in attributes) {\n        const convertedName = convertGLTFV1AttributeName(attributeName);\n        const previousName = convertedNames.get(convertedName);\n        if (previousName !== undefined && attributes[previousName] !== attributes[attributeName]) {\n          throw new Error(\n            `glTF v1: conflicting attribute aliases ${previousName} and ${attributeName}`\n          );\n        }\n        convertedNames.set(convertedName, attributeName);\n      }\n      primitive.attributes = Object.fromEntries(\n        Object.entries(attributes).map(([attributeName, accessorId]) => [\n          convertGLTFV1AttributeName(attributeName),\n          this._convertIdToIndex(accessorId, 'accessor')\n        ])\n      );\n      if (indices) {\n        primitive.indices = this._convertIdToIndex(indices, 'accessor');\n      }\n      if (material) {\n        primitive.material = this._convertIdToIndex(material, 'material');\n      }\n    }\n  }\n\n  _convertNodeIds(node) {\n    if (node.children) {\n      node.children = node.children.map(child => this._convertIdToIndex(child, 'node'));\n    }\n    if (node.meshes) {\n      node.meshes = node.meshes.map(mesh => this._convertIdToIndex(mesh, 'mesh'));\n    }\n  }\n\n  _convertSceneIds(scene) {\n    if (scene.nodes) {\n      scene.nodes = scene.nodes.map(node => this._convertIdToIndex(node, 'node'));\n    }\n  }\n\n  /** Go through all objects in a top-level array and replace ids with indices */\n  _convertIdsToIndices(json, topLevelArrayName) {\n    if (!json[topLevelArrayName]) {\n      // Optional absent collections need no assumption or warning.\n      json[topLevelArrayName] = [];\n    }\n    for (const object of json[topLevelArrayName]) {\n      for (const key in object) {\n        const id = object[key];\n        const index = this._convertIdToIndex(id, key);\n        object[key] = index;\n      }\n    }\n  }\n\n  _convertIdToIndex(id, key) {\n    const arrayName = GLTF_KEYS[key];\n    if (arrayName in this.idToIndexMap) {\n      const index = this.idToIndexMap[arrayName][id];\n      if (!Number.isFinite(index)) {\n        throw new Error(`gltf v1: failed to resolve ${key} with id ${id}`);\n      }\n      return index;\n    }\n    return id;\n  }\n\n  /**\n   *\n   * @param {*} json\n   */\n  _updateObjects(json) {\n    for (const buffer of this.json.buffers) {\n      // - [x] Removed buffer.type, #786, #629\n      delete buffer.type;\n    }\n  }\n\n  /** Split glTF 1 nodes that reference multiple meshes into glTF 2-compatible nodes. */\n  _updateNodes(json): void {\n    const nodes = json.nodes || [];\n    for (let nodeIndex = 0; nodeIndex < nodes.length; nodeIndex++) {\n      const node = nodes[nodeIndex];\n      if (!Array.isArray(node.meshes)) {\n        continue;\n      }\n      const meshIndices = node.meshes;\n      delete node.meshes;\n      node.mesh = meshIndices.shift();\n      for (const meshIndex of meshIndices) {\n        const extraNode = {...node, mesh: meshIndex, children: undefined};\n        delete extraNode.id;\n        delete extraNode.matrix;\n        delete extraNode.translation;\n        delete extraNode.rotation;\n        delete extraNode.scale;\n        nodes.push(extraNode);\n        node.children ||= [];\n        node.children.push(nodes.length - 1);\n      }\n    }\n  }\n\n  /** Preserve v1 techniques, programs, and shaders without pretending they are PBR materials. */\n  _preserveLegacyResources(json, commonMaterialFallbacks: Set<string>): void {\n    const coveredFallbacks = canPreserveGLTFV1MaterialFallbacks(json, commonMaterialFallbacks);\n    const resources = {};\n    for (const resourceName of ['techniques', 'programs', 'shaders']) {\n      if (json[resourceName]) {\n        resources[resourceName] = json[resourceName];\n        delete json[resourceName];\n        if (!coveredFallbacks) this._unsupported(`legacy ${resourceName}`);\n      }\n    }\n    if (Object.keys(resources).length) {\n      json.extras = {...json.extras, gltf1Resources: resources};\n      if (coveredFallbacks)\n        this._warning('Preserved shader resources overridden by converted common materials.');\n    }\n  }\n\n  /** Omit optional empty root collections, child lists, and scene roots rejected by glTF 2. */\n  _removeEmptyCollections(json): void {\n    for (const node of json.nodes || []) {\n      if (Array.isArray(node.children) && node.children.length === 0) delete node.children;\n    }\n    for (const scene of json.scenes || []) {\n      if (Array.isArray(scene.nodes) && scene.nodes.length === 0) delete scene.nodes;\n    }\n    for (const collectionName of [\n      ...Object.keys(GLTF_ARRAYS),\n      'extensionsUsed',\n      'extensionsRequired'\n    ]) {\n      if (Array.isArray(json[collectionName]) && json[collectionName].length === 0) {\n        delete json[collectionName];\n      }\n    }\n  }\n\n  /** Finalize report diagnostics. */\n  _finishReport(): void {\n    if (this.report.unsupported.length) {\n      this.report.warnings.push(\n        `Converted glTF v1 with unsupported features: ${this.report.unsupported.join(', ')}`\n      );\n    }\n  }\n}\n\n/** Normalize a glTF 1 asset in place, preserving the historical loader behavior. */\nexport function normalizeGLTFV1(\n  gltf: GLTFWithBuffers,\n  options: GLTFV1NormalizationOptions = {}\n): GLTFV1NormalizationReport {\n  return new GLTFV1Normalizer().normalize(gltf, options);\n}\n\n/** Normalize parser JSON now, returning an internal completion step for linked-buffer baking. */\nexport function normalizeGLTFV1WithDeferredBuffers(\n  gltf: GLTFWithBuffers,\n  options: Pick<GLTFV1NormalizationOptions, 'normalize' | 'log'> = {}\n): () => GLTFV1NormalizationReport {\n  const normalizer = new GLTFV1Normalizer();\n  normalizer.normalize(gltf, options, true);\n  return () => normalizer.finishNormalization(gltf);\n}\n\n/** Convert glTF 1 JSON without mutating the caller-owned asset or its binary buffers. */\nexport function convertGLTFV1ToGLTF2(\n  gltf: GLTFWithBuffers,\n  options: Omit<GLTFV1NormalizationOptions, 'mutate'> = {}\n): GLTFWithBuffers & {normalizationReport: GLTFV1NormalizationReport} {\n  const converted = {...gltf, json: JSON.parse(JSON.stringify(gltf.json))};\n  const normalizationReport = normalizeGLTFV1(converted, {\n    normalize: options.normalize || 'best-effort',\n    mutate: true,\n    log: options.log\n  });\n  normalizationReport.mutated = false;\n  return {...converted, normalizationReport};\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/gltf/lib/api/normalize-gltf-v1.d.ts

@@ -0,0 +1,37 @@
+import type { GLTFWithBuffers } from "../types/gltf-types.js";
+/** Diagnostics emitted while converting a glTF 1 asset to glTF 2. */
+export type GLTFV1NormalizationReport = {
+    /** Whether a glTF 1 asset was detected and converted. */
+    converted: boolean;
+    /** Whether the input JSON was mutated in place. */
+    mutated: boolean;
+    /** Features that could not be represented without loss. */
+    unsupported: string[];
+    /** Non-fatal conversion notes. */
+    warnings: string[];
+};
+/** Lazy logging methods compatible with probe.gl and loaders.gl core loggers. */
+export type GLTFV1NormalizationLog = {
+    /** Create a level-controlled informational callback. */
+    log(priority: number, message: string): () => void;
+    /** Create a warning callback. */
+    warn(message: string): () => void;
+};
+/** Options for glTF 1 to glTF 2 conversion. */
+export type GLTFV1NormalizationOptions = {
+    /** Enable conversion. `'strict'` rejects unsupported features; other values are best effort. */
+    normalize?: boolean | 'best-effort' | 'strict';
+    /** Mutate the supplied JSON. Defaults to true for backwards compatibility. */
+    mutate?: boolean;
+    /** Optional probe.gl-compatible logger; absent or null leaves diagnostics in the report only. */
+    log?: GLTFV1NormalizationLog | null;
+};
+/** Normalize a glTF 1 asset in place, preserving the historical loader behavior. */
+export declare function normalizeGLTFV1(gltf: GLTFWithBuffers, options?: GLTFV1NormalizationOptions): GLTFV1NormalizationReport;
+/** Normalize parser JSON now, returning an internal completion step for linked-buffer baking. */
+export declare function normalizeGLTFV1WithDeferredBuffers(gltf: GLTFWithBuffers, options?: Pick<GLTFV1NormalizationOptions, 'normalize' | 'log'>): () => GLTFV1NormalizationReport;
+/** Convert glTF 1 JSON without mutating the caller-owned asset or its binary buffers. */
+export declare function convertGLTFV1ToGLTF2(gltf: GLTFWithBuffers, options?: Omit<GLTFV1NormalizationOptions, 'mutate'>): GLTFWithBuffers & {
+    normalizationReport: GLTFV1NormalizationReport;
+};
+//# sourceMappingURL=normalize-gltf-v1.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-gltf-v1.d.ts","sourceRoot":"","sources":["../../../../src/gltf/lib/api/normalize-gltf-v1.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAC,eAAe,EAAC,+BAA4B;AAmGzD,qEAAqE;AACrE,MAAM,MAAM,yBAAyB,GAAG;IACtC,yDAAyD;IACzD,SAAS,EAAE,OAAO,CAAC;IACnB,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,iFAAiF;AACjF,MAAM,MAAM,sBAAsB,GAAG;IACnC,wDAAwD;IACxD,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;IACnD,iCAAiC;IACjC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;CACnC,CAAC;AAEF,+CAA+C;AAC/C,MAAM,MAAM,0BAA0B,GAAG;IACvC,gGAAgG;IAChG,SAAS,CAAC,EAAE,OAAO,GAAG,aAAa,GAAG,QAAQ,CAAC;IAC/C,8EAA8E;IAC9E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iGAAiG;IACjG,GAAG,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;CACrC,CAAC;AAsbF,oFAAoF;AACpF,wBAAgB,eAAe,CAC7B,IAAI,EAAE,eAAe,EACrB,OAAO,GAAE,0BAA+B,GACvC,yBAAyB,CAE3B;AAED,iGAAiG;AACjG,wBAAgB,kCAAkC,CAChD,IAAI,EAAE,eAAe,EACrB,OAAO,GAAE,IAAI,CAAC,0BAA0B,EAAE,WAAW,GAAG,KAAK,CAAM,GAClE,MAAM,yBAAyB,CAIjC;AAED,yFAAyF;AACzF,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,eAAe,EACrB,OAAO,GAAE,IAAI,CAAC,0BAA0B,EAAE,QAAQ,CAAM,GACvD,eAAe,GAAG;IAAC,mBAAmB,EAAE,yBAAyB,CAAA;CAAC,CASpE"}